Skip to content

[doctrine-platform-pillars] Fleet conformance gaps #13

Description

@shtse8

Align repository with Sylphx platform pillars (ADR-167)

Repository: SylphxAI/codec
Lifecycle/Layer: active / foundation
Doctrine: https://github.com/SylphxAI/doctrine
Decision: SylphxAI/doctrine ADR-167-boundary-contract-stack-and-platform-pillars

This issue is machine-generated from a fleet conformance audit. Work in verified slices — one boundary or pillar at a time. Full-repo rewrite in one PR is not required; incremental migration with green CI is.

Findings

  • [medium] project-manifest — Project manifest status is PARTIAL; expose PROJECT.md, .doctrine/project.json, and a root agent adapter.
  • [medium] project-manifest — boundaries.publicSurfaces[2].type has unknown value 'package'
  • [medium] project-manifest — boundaries.publicSurfaces[3].type has unknown value 'package'
  • [medium] project-manifest — boundaries.publicSurfaces[5].type has unknown value 'package'
  • [medium] project-manifest — boundaries.publicSurfaces[6].type has unknown value 'package'
  • [medium] project-manifest — boundaries.publicSurfaces[11].type has unknown value 'test'
  • [medium] project-manifest — boundaries.allowedDependencies[1].direction has unknown value 'upstream-shared'
  • [medium] project-manifest — delivery.ciModel has unknown value 'repo-ci-with-groundatlas'
  • [medium] project-manifest — adoption.status has unknown value 'adopted'
  • [high] boundary-contract — No Protobuf+Buf contract SSOT detected (buf.yaml, buf.gen.yaml, or .proto tree). Cross-boundary APIs should use Protobuf+Buf per SylphxAI/doctrine ADR-167-boundary-contract-stack-and-platform-pillars.

Target state (ADR-167)

  • Rust backends/services; TypeScript web UI; Dart/Flutter mobile UI.
  • Protobuf + Buf as cross-boundary contract SSOT.
  • Connect/gRPC for app↔service; OpenAPI-derived REST for public edge.
  • PROJECT.md, .doctrine/project.json, and root AGENTS.md/CLAUDE.md.

Suggested slice order

  1. Add or fix project manifest + agent adapter (zero-knowledge handoff).
  2. Introduce .proto + Buf; derive clients; keep existing API as compatibility shim.
  3. Migrate backend paths to Rust in boundary-sized slices.
  4. Point web/mobile clients at generated Connect/gRPC clients.
  5. Remove hand-maintained duplicate contracts once codegen gates are green.

Validation

python3 <doctrine>/scripts/project-control-plane-audit.py --repo SylphxAI/codec --fail-on-drift --json
python3 <doctrine>/scripts/platform-pillars-fleet-audit.py --repo SylphxAI/codec --json

Agent claim protocol

Comment AGENT-CLAIM with agent role, branch prefix, and lease expiry before opening PRs. On completion, comment AGENT-WORK-COMPLETE with PR URL and readback command output.

Do not edit this issue body by hand for scope changes — regenerate from the doctrine audit when the fleet policy changes.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions