Skip to content

context: capabilities.json links 31 module pages that do not exist #592

Closed as not planned

Description

@Ancienttwo

.ai/context/capabilities.json links 31 module pages under docs/architecture/modules/ that do not exist.

Observed (main 5804c21)

  • All 31 docs/architecture/modules/*.md paths in .ai/context/capabilities.json are missing. Examples: docs/architecture/modules/capability-architecture-context.md and docs/architecture/modules/component-architecture-context-projection-renderer.md.
  • The projection writes this repository's module page as docs/architecture/modules/architecture/context.md, under the repo-harness/v1 layout. Nothing writes the flat capability-*.md or component-*.md names.
  • The file was last changed in abf84ad (chore(context): register module-architecture-context-tooling owner for scripts/** (#526) #531). The links predate the repo-harness/v1 module layout.

Found during the review of #590 (advisor t12). It is not caused by #590.

Requirement

Decide which authority owns these links: the repo-harness context generator or a hand-maintained file. Then make the links point at pages that the projection writes, through that authority. If the links are generated, fix the generator instead of hand-editing the output. A check that fails on a dangling link should come with the fix, at the layer that owns the file.

Seat: orchestrator t7

Activity

  1. Ancienttwo commented on Nov 13, 2026

    @Ancienttwo
    OwnerAuthor

    Joint decision (orchestrator + advisor), 2026-11-13, on parallelizing the remaining issues. The owner asked in pane t12: "近7个issues,还有多久才能收完?能不能并行".

    1. 0.14.1 (0.14.1: unblock the repo-harness archctx 0.14 pin (#579, #580) #583, release: prepare archctx 0.14.1 #582) is in flight and finishes first. main stays frozen until the release candidate chore(release): prepare archctx 0.14.1 (#582) #591 merges. codegraph-adapter: read the index only through the in-process read-only handle #574 S1 (feat(codegraph-adapter): one in-process read-only read session (#574 S1) #589) merges after 0.14.1 is published.
    2. Started now, in parallel, in files codegraph-adapter: read the index only through the in-process read-only handle #574 does not touch:
    3. codegraph-adapter: read the index only through the in-process read-only handle #574 split. Right after S1 merges, a move-only slice S1b (Medium, one GPT review) splits codegraph-adapter/src/index.ts by responsibility: readiness and status, import population, projection handshake, snapshot, CLI provider. Behavior does not change. Then S2+S3, S4 and S5 run in parallel, each in its own module, and S6 comes last.
    4. complete: codegraph sync runs twice per complete #584 and codegraph-adapter: the 50 000 import-node read limit is reached at about 8x repo-harness #585 fold into codegraph-adapter: read the index only through the in-process read-only handle #574 S2+S3.

    Seat: orchestrator t7

  2. Ancienttwo commented on Nov 13, 2026

    @Ancienttwo
    OwnerAuthor

    Claim: writer and head owner is Pi seat t2kh (worker-light), on branch fix/592-capability-links from main 27c68b2. Tier Low. The merge waits for the 0.14.1 freeze to lift.

    Seat: orchestrator t7

  3. Ancienttwo commented on Nov 13, 2026

    @Ancienttwo
    OwnerAuthor

    Boundary. .ai/context/capabilities.json is written only by repo-harness 0.32.0 (aimpact-inc/repo-harness: scripts/capability-config.ts, src/effects/architecture/capability-resolver.ts, src/core/capabilities/registry.ts). It cannot be driven from this repository to fix the links:

    • add is append-only;
    • sync never touches architecture_module;
    • init writes only when the file is missing.

    Under repo-harness/v1, this repository projects one module page (docs/architecture/modules/architecture/context.md) for 31 registry entries, so no regeneration can produce only links to existing pages. repo-harness run capability-resolver validate already reports the reverse problem here, 'orphan architecture module: docs/architecture/modules/architecture/context.md'.

    Joint decision (orchestrator + advisor): the fix belongs to repo-harness, where the authority for architecture_module lives. The advisor routed it to the repo-harness orchestrator t1fh with this evidence. This issue closes as a boundary, with a link to their issue once it exists. Nothing is hand-edited here.

    Seat: orchestrator t7

  4. Ancienttwo commented on Nov 13, 2026

    @Ancienttwo
    OwnerAuthor

    Closed as a boundary. The fix is tracked upstream in aimpact-inc/repo-harness#2707 (under #2624): under an archctx projection, the module page path comes from the projection manifest, or architecture_module is omitted. Nothing is hand-edited here; .ai/context/capabilities.json changes when repo-harness regenerates it.

    Seat: orchestrator t7

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions