FE-1090: Data-model legibility reference substrate#266
Open
lunelson wants to merge 54 commits into
Open
Conversation
Remove the stale future-tense "M5 input" classification/ranking tables and the dead `INTENT_GRAPH_SEMANTICS.md` pointer from both axis READMEs; replace with a short Heuristic provenance note. The heuristics are authored and locked into each `<axis>/<name>/SKILL.md` body in distilled form (D97-L cite/distill), and graph vocabulary is owned by `src/graph/schema/kinds.ts`; the READMEs now own axis/lens membership only. Discharges the final residue of the skill-substrate arc. Co-authored-by: Cursor <cursoragent@cursor.com>
Introduce a thin in-PLAN.md `## Initiatives` index so multi-frontier architectural through-lines stay legible without a new tracker/branch altitude (frontiers remain flat). Seed three arcs: skill-substrate (done), elicitor-capability-spine, context-pipeline. Close the "standing obligation rides the triggering frontier = never" hole: an arc's done-definition must include topology-README reconciliation and residue discharge, and arc completion is itself a trigger. Govern the lifecycle across ln-plan (create/update + sanctioned-exception carve-out), ln-build (fire the done-definition when the last member frontier lands), and ln-sync (reconcile rosters, close only when the done-definition holds). Co-authored-by: Cursor <cursoragent@cursor.com>
First materialization of the `_generated/` mechanism (SPEC D87-L clause d): `src/graph/schema/generate-ontology-ref.ts` projects `NODE_KINDS` + `bandsForKind` into a read-only `src/graph/schema/_generated/ontology.md` table. `npm run generate:ontology` writes it; `npm run check:data-model` (wired into `npm run check`) fails on drift from the typed sources (D73-L). The `capture` method now cites the table instead of restating band membership (D97-L). Planning capture (foundation work; branch to be named later): - memory/PLAN.md — data-model-legibility frontier recorded: design verdict (Shape C), first tracer landed, remaining slices (edge/detail tables, authored judgment layer, subtypes→detail remodel) named. - memory/SPEC.md — D87-L (d) flipped deferred → materialized. Co-authored-by: Cursor <cursoragent@cursor.com>
…hema topology Retire validated A30-L (structured-exchange request-side collapse; residue in D84-L/D86-L/I23-L) into the SPEC sync ledger. Reconcile src/graph/README.md to name the generate-ontology-ref.ts projector and _generated/ontology.md reference added this session, with the check:data-model drift guard. Co-authored-by: Cursor <cursoragent@cursor.com>
Refresh stale prompt-shape assertions and preserve the Gherkin then field without triggering thenable lint warnings. Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
Author
This stack of pull requests is managed by Graphite. Learn more about stacking. |
This was referenced Jun 26, 2026
lunelson
changed the title
PR SummaryLow Risk Overview Planning workflow gains in- Contributor / architecture docs ( Lint topology ( Reviewed by Cursor Bugbot for commit 73a7023. Bugbot is set up for automated code reviews on this repo. Configure here. |
There was a problem hiding this comment.
Pull request overview
This PR relocates Brunch’s model-facing “renderer” surfaces and runtime prompt policy into a new src/agents/ substrate (contexts, prompts, skills, runtime policy), updates Pi extension adapters to consume that substrate, and refreshes topology/readme guidance while deleting stale/retired src/renderers/ and session-projection affordance helpers.
Changes:
- Move reusable model-facing text formatting from
renderers/intoagents/contexts/, and introduce shared formatting helpers undersrc/agents/shared/. - Centralize agent prompt-body and prompt-resource paths in
src/agents/registry.ts, and move runtime roster/tool policy intosrc/agents/runtime/*. - Update
.piextension registrars, probes, session/app call sites, and tests to point at the newagents/*+ renamed.pi/extensions/*structure.
Reviewed changes
Copilot reviewed 208 out of 263 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| src/workspace/README.md | Updates workspace dependency direction guidance. |
| src/session/workspace-overview-context.ts | Repoints workspace context rendering to agents/contexts. |
| src/session/transcript-markdown.ts | Fixes projection import path for transcript formatting. |
| src/session/specification-overview-context.ts | Repoints specification context types to agents/contexts. |
| src/session/session-transcript.ts | Uses new session/transcript-markdown formatter. |
| src/session/schema/README.md | Updates ownership pointer for runtime extension path. |
| src/session/originate-assistant-turn.ts | Repoints context-seed composition to agents/contexts/seeds. |
| src/session/tests/transcript-markdown.test.ts | Adds coverage for transcript markdown formatting. |
| src/session/tests/runtime-affordances-coverage.test.ts | Updates coverage ledger to runtime policy derivation API. |
| src/scripts/README.md | Updates scripts boundary guidance (agents/contexts vs renderers). |
| src/renderers/graph/reconciliation-needs.ts | Deletes retired topology stub. |
| src/renderers/graph/commit-result.ts | Deletes retired topology stub. |
| src/renderers/exchanges/present-review-set.ts | Moves present-review-set formatting out of renderers/. |
| src/projections/session/transcript-context.ts | Updates doc “used by” pointer to new transcript formatter. |
| src/projections/session/runtime-state.ts | Re-exports runtime policy symbols from agents/runtime. |
| src/projections/session/affordances.ts | Removes affordances helper (now owned by runtime policy). |
| src/projections/session/tests/readiness-estimate.test.ts | Updates “no coupling” assertions to new runtime policy locations. |
| src/projections/graph/reconciliation-needs.ts | Updates doc “future users” pointer to agents/contexts. |
| src/projections/graph/overview.ts | Updates doc pointers to new .pi/extensions/brunch-data/*. |
| src/projections/graph/commit-result.ts | Updates doc pointers to agents/contexts + new .pi paths. |
| src/projections/tests/topology-boundaries.test.ts | Updates topology boundary assertions for new layers. |
| src/probes/propose-graph-commit-proof.ts | Repoints runtime switch adapter path. |
| src/probes/project-graph-review-cycle-proof.ts | Repoints runtime switch adapter path. |
| src/probes/fixture-curation-loop.ts | Repoints runtime switch adapter path. |
| src/probes/deterministic-exchange-script.ts | Repoints present-question formatter to agents/contexts. |
| src/graph/schema/nodes.ts | Introduces computed then field key in gherkin JSON schema. |
| src/graph/index.ts | Re-exports RoleNamedEdgeDraftOf type. |
| src/graph/command-executor.ts | Re-exports RoleNamedEdgeDraftOf type. |
| src/graph/tests/spec-ownership.test.ts | Updates tool schema import path to brunch-data extensions. |
| src/graph/tests/observed-shapes-coverage.test.ts | Updates .pi extension import paths. |
| src/graph/tests/mutate-graph-edge-schema.test.ts | Updates .pi extension import paths. |
| src/graph/tests/capture-commitment-gradient-gate.test.ts | Updates .pi extension registrar imports to brunch-data. |
| src/dev/README.md | Updates introspection registrar path to dev-mode/introspection. |
| src/dev/tests/generate-fan-out-witness.test.ts | Updates skill path references from .pi/skills to agents/skills. |
| src/app/README.md | Updates app ownership/dependency guidance; adds print-mode renderer note. |
| src/app/print-workspace-state.ts | Fixes import path to src/projections/... and keeps print renderer app-local. |
| src/app/pi-subagents.ts | Repoints GraphReaders + seed types to new homes. |
| src/app/pi-settings.ts | Adds audited getter and TODO note in settings policy. |
| src/app/pi-session-options.ts | Adds a small projection layer for Pi session hardening options. |
| src/app/brunch.ts | Switches print-mode workspace rendering to app-local module. |
| src/app/brunch-tui.ts | Projects session options via new helper; updates runtime/tool imports. |
| src/app/tests/print-workspace-state.test.ts | Updates print-workspace-state test imports. |
| src/app/tests/pi-session-options.test.ts | Adds tests for session option projection behavior. |
| src/agents/skills/strategies/step-wise-disambiguate/SKILL.md | Adds strategy prompt resource. |
| src/agents/skills/strategies/step-wise-decision-tree/SKILL.md | Adds strategy prompt resource. |
| src/agents/skills/strategies/README.md | Adds strategies index + provenance notes. |
| src/agents/skills/strategies/freestyle/SKILL.md | Adds strategy prompt resource. |
| src/agents/skills/methods/run-structured-exchange/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/review-for-gaps/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/read-referenced-documents/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/read-context/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/ingest-paste/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/generate-proposal/references/oracle.md | Updates oracle reference guidance. |
| src/agents/skills/methods/generate-proposal/references/intent.md | Adds intent-plane reference material. |
| src/agents/skills/methods/generate-proposal/references/design.md | Adds design-plane reference material. |
| src/agents/skills/methods/explore-and-characterize/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/elicit-by-question/SKILL.md | Adds method prompt resource. |
| src/agents/skills/methods/commit-graph/SKILL.md | Adds method prompt resource (migrated from .pi/skills). |
| src/agents/skills/methods/capture/SKILL.md | Updates capture method to cite generated ontology + authored heuristics. |
| src/agents/skills/lenses/README.md | Adds lenses index + provenance notes. |
| src/agents/skills/lenses/oracle/SKILL.md | Adds lens prompt resource. |
| src/agents/skills/lenses/intent/SKILL.md | Adds lens prompt resource. |
| src/agents/skills/lenses/design/SKILL.md | Adds lens prompt resource. |
| src/agents/skills/fixtures/unlisted-fixture/SKILL.md | Updates fixture location to new skills tree. |
| src/agents/shared/tree.ts | Adds shared tree formatting helpers. |
| src/agents/shared/toon.ts | Adds shared TOON formatting helpers. |
| src/agents/shared/section.ts | Adds XML-style section wrapper helper. |
| src/agents/shared/README.md | Documents shared formatting helpers (title currently mismatched). |
| src/agents/shared/markdown.ts | Adds shared markdown primitives over md-pen. |
| src/agents/shared/tests/tree.test.ts | Adds tests for tree wrapper behavior. |
| src/agents/shared/tests/toon.test.ts | Adds tests for TOON wrapper behavior. |
| src/agents/shared/tests/section.test.ts | Adds tests for section wrapper behavior. |
| src/agents/shared/tests/markdown.test.ts | Adds tests for markdown primitives behavior. |
| src/agents/runtime/state.ts | Moves runtime state projection into agents/runtime. |
| src/agents/runtime/README.md | Documents new runtime policy module layout and boundaries. |
| src/agents/runtime/prompt-skills.ts | Centralizes prompt resource loading via registry helpers. |
| src/agents/runtime/policy.ts | Centralizes roster + policy and uses registry for body locations. |
| src/agents/runtime/compose.ts | Repoints prompt composition to agents/contexts renders. |
| src/agents/runtime/capability-readiness.ts | Adds capability readiness evaluation policy. |
| src/agents/runtime/tests/state.test.ts | Updates tests for new runtime policy and registry wiring. |
| src/agents/registry.ts | Adds central path registry for bodies + prompt resource skills. |
| src/agents/README.md | Documents the new agents/ subtree ownership and boundaries. |
| src/agents/prompts/reviewer/SYSTEM.md | Adds reviewer agent body under new prompt topology. |
| src/agents/prompts/researcher/SYSTEM.md | Adds researcher agent body under new prompt topology. |
| src/agents/prompts/README.md | Documents prompts topology and adoption decisions. |
| src/agents/prompts/projector/SYSTEM.md | Adds projector agent body under new prompt topology. |
| src/agents/prompts/pi-coder/SYSTEM.md | Adds pi-coder agent body under new prompt topology. |
| src/agents/prompts/orchestrator/SYSTEM.md | Adds orchestrator agent body under new prompt topology. |
| src/agents/prompts/explorer/SYSTEM.md | Adds explorer agent body under new prompt topology. |
| src/agents/prompts/elicitor/SYSTEM.md | Adds elicitor agent body under new prompt topology. |
| src/agents/prompts/tests/prompt-bodies.test.ts | Adds tests to enforce new prompt body topology. |
| src/agents/docs/README.md | Adds backstage curation-notes home for agent resources. |
| src/agents/contexts/workspace/workspace-context.ts | Repoints workspace context formatting to shared primitives. |
| src/agents/contexts/workspace/README.md | Documents workspace context ownership. |
| src/agents/contexts/workspace/tests/workspace-context.test.ts | Updates workspace context snapshots path/convention. |
| src/agents/contexts/workspace/snapshots/workspace-overview-context.md | Adds golden snapshot for overview context. |
| src/agents/contexts/workspace/snapshots/workspace-cwd-context.md | Adds golden snapshot for cwd context. |
| src/agents/contexts/specification/specification-context.ts | Repoints formatting to shared primitives and TOON wrapper. |
| src/agents/contexts/specification/README.md | Documents specification context ownership. |
| src/agents/contexts/specification/tests/specification-context.test.ts | Updates snapshots and improves assertions for spec context output. |
| src/agents/contexts/specification/snapshots/specification-context.md | Adds golden snapshot for spec context output. |
| src/agents/contexts/session/runtime-frame.ts | Repoints runtime-frame types import path. |
| src/agents/contexts/session/README.md | Documents session context ownership. |
| src/agents/contexts/session/readiness-estimate.ts | Repoints readiness render to new import locations. |
| src/agents/contexts/session/tests/runtime-frame.test.ts | Updates runtime-frame snapshot path/convention. |
| src/agents/contexts/session/snapshots/runtime-frame-ready.md | Adds golden snapshot for runtime-frame output. |
| src/agents/contexts/seeds/README.md | Documents seed ownership/boundaries. |
| src/agents/contexts/seeds/origination.ts | Moves origination seed composition into seeds module. |
| src/agents/contexts/seeds/tests/turn-context.test.ts | Updates seed tests for new module + output wording. |
| src/agents/contexts/seeds/tests/origination.test.ts | Updates origination test to new module location. |
| src/agents/contexts/references/graph-authoring-heuristics.md | Adds authored shared reference for graph-writing judgment. |
| src/agents/contexts/README.md | Adds contexts topology README (currently references non-existent primitives/). |
| src/agents/contexts/graph/reconciliation-needs.ts | Adds model-facing reconciliation agenda/update formatting. |
| src/agents/contexts/graph/README.md | Documents graph context ownership. |
| src/agents/contexts/graph/node-neighborhood.ts | Repoints graph neighborhood formatter imports. |
| src/agents/contexts/graph/graph-slice.ts | Repoints graph overview formatter imports; uses shared markdown helpers. |
| src/agents/contexts/graph/commit-result.ts | Adds model-facing mutate-graph result formatting. |
| src/agents/contexts/graph/tests/related-nodes.test.ts | Adds tests and snapshots for related-nodes formatting. |
| src/agents/contexts/graph/tests/graph-slice.test.ts | Updates snapshot convention for graph overview tests. |
| src/agents/contexts/graph/snapshots/related-hub-REQ1.md | Adds golden snapshot. |
| src/agents/contexts/graph/snapshots/neighborhood-hub-REQ1.md | Adds golden snapshot. |
| src/agents/contexts/graph/snapshots/neighborhood-hub-REQ1-hops2.md | Adds golden snapshot. |
| src/agents/contexts/graph/snapshots/neighborhood-hub-REQ1-compact.md | Adds golden snapshot. |
| src/agents/contexts/graph/snapshots/neighborhood-code-health-REQ1.md | Adds golden snapshot. |
| src/agents/contexts/graph/snapshots/neighborhood-brunch-self-REQ1.md | Adds golden snapshot. |
| src/agents/contexts/graph/snapshots/neighborhood-brunch-self-MOD1-hops2.md | Adds golden snapshot. |
| src/agents/contexts/exchanges/request-review.ts | Repoints exchange request renderer to new projection import paths. |
| src/agents/contexts/exchanges/request-response.ts | Adds formatter for request-response diagnostic content. |
| src/agents/contexts/exchanges/request-choices.ts | Repoints request-choices formatter imports. |
| src/agents/contexts/exchanges/request-choice.ts | Repoints request-choice formatter imports. |
| src/agents/contexts/exchanges/request-answer.ts | Repoints request-answer formatter imports. |
| src/agents/contexts/exchanges/README.md | Documents exchange result-text ownership. |
| src/agents/contexts/exchanges/present-review-set.ts | Adds model-facing present-review-set formatting with relation labels. |
| src/agents/contexts/exchanges/present-question.ts | Repoints present-question formatter imports. |
| src/agents/contexts/exchanges/present-candidates.ts | Repoints present-candidates formatter imports. |
| src/agents/contexts/exchanges/tests/present-review-set.test.ts | Adds tests for review-set presentation text. |
| src/agents/contexts/exchanges/tests/present-candidates.test.ts | Updates test imports to new projection path. |
| src/agents/contexts/elicitation.ts | Adds model-facing elicitation agenda/update formatting. |
| src/agents/tests/registry.test.ts | Adds tests for the central registry helpers. |
| src/.pi/skills/strategies/README.md | Deletes old prompt-resource README under .pi/skills. |
| src/.pi/skills/methods/commit-graph/SKILL.md | Deletes old method skill under .pi/skills. |
| src/.pi/skills/lenses/README.md | Deletes old lenses README under .pi/skills. |
| src/.pi/settings.json | Updates local Pi settings extension list (new extension groupings). |
| src/.pi/README.md | Updates .pi ownership now that prompts/skills moved to src/agents/. |
| src/.pi/extensions/web-tools/web/index.ts | Adds web tools registrar under new web-tools extension. |
| src/.pi/extensions/web-tools/index.ts | Adds barrel export for web tools extension. |
| src/.pi/extensions/subagents/session.ts | Repoints web + graph tool imports to new extension paths. |
| src/.pi/extensions/subagents/prompt-assembly.ts | Repoints prompt assembly to agents/runtime + agents/contexts/seeds. |
| src/.pi/extensions/subagents/agents.ts | Repoints body home to src/agents/prompts via registry. |
| src/.pi/extensions/session-hooks/session/lifecycle.ts | Adds centralized session-boundary pipeline helpers. |
| src/.pi/extensions/session-hooks/index.ts | Adds barrel export for session-hooks extension. |
| src/.pi/extensions/exchanges/shared/review-source.ts | Repoints review request formatting to agents/contexts. |
| src/.pi/extensions/exchanges/shared/choices-editor.ts | Repoints choices formatting to agents/contexts. |
| src/.pi/extensions/exchanges/shared/choice-source.ts | Repoints choice formatting to agents/contexts. |
| src/.pi/extensions/exchanges/shared/answer-source.ts | Repoints answer formatting to agents/contexts. |
| src/.pi/extensions/exchanges/schemas/README.md | Updates docs to reference agents/contexts/exchanges. |
| src/.pi/extensions/exchanges/request-response.ts | Uses agents/contexts diagnostic formatter for tool output. |
| src/.pi/extensions/exchanges/README.md | Updates dependency rule doc to reference agents/contexts/exchanges. |
| src/.pi/extensions/exchanges/present-review-set.ts | Uses agents/contexts for durable output + structural illegal formatting. |
| src/.pi/extensions/exchanges/present-question.ts | Uses agents/contexts present-question formatter. |
| src/.pi/extensions/exchanges/present-candidates.ts | Uses agents/contexts present-candidates formatter. |
| src/.pi/extensions/dev-mode/session-query/README.md | Renames doc + updates ownership pointers for new agents/* homes. |
| src/.pi/extensions/dev-mode/session-query/index.ts | Fixes shared import paths after reparenting under dev-mode/. |
| src/.pi/extensions/dev-mode/introspection/README.md | Adds dev-mode introspection README. |
| src/.pi/extensions/dev-mode/introspect-query/README.md | Adds dev-mode introspect-query README. |
| src/.pi/extensions/dev-mode/introspect-query/index.ts | Adjusts imports for reparented dev-mode query tooling. |
| src/.pi/extensions/dev-mode/index.ts | Adds dev-mode barrel export. |
| src/.pi/extensions/commands/index.ts | Repoints axis options + runtime state helpers to new locations. |
| src/.pi/extensions/brunch-data/reconciliation/index.ts | Uses agents/contexts reconciliation formatters; fixes imports. |
| src/.pi/extensions/brunch-data/index.ts | Adds brunch-data barrel export. |
| src/.pi/extensions/brunch-data/graph/tool-schemas.ts | Uses RoleNamedEdgeDraftOf to simplify edge op typing. |
| src/.pi/extensions/brunch-data/graph/index.ts | Uses agents/contexts/graph formatters; keeps adapter translation in extension. |
| src/.pi/extensions/brunch-data/elicitation/index.ts | Uses agents/contexts elicitation formatters; fixes imports. |
| src/.pi/extensions/brunch-data/context/session-binding.ts | Fixes import paths after moving under brunch-data. |
| src/.pi/extensions/brunch-data/context/index.ts | Uses agents/contexts/session runtime-frame formatter; updates prompt snippets. |
| src/.pi/extensions/brunch-data/context/get-specification.ts | Uses agents/contexts/specification renderer. |
| src/.pi/extensions/brunch-data/context/get-cwd.ts | Uses agents/contexts/workspace renderer. |
| src/.pi/extensions/agent-runtime/system-prompts/world-reads.ts | Fixes graph reader import path after brunch-data move. |
| src/.pi/extensions/agent-runtime/system-prompts/index.ts | Uses agents/runtime/compose for prompt assembly; fixes imports. |
| src/.pi/extensions/agent-runtime/system-prompts/tests/world-reads.test.ts | Fixes test import paths after extension moves. |
| src/.pi/extensions/agent-runtime/runtime/index.ts | Repoints runtime policy + exports to agents/runtime + projections/session. |
| src/.pi/extensions/agent-runtime/orchestrator-stub/index.ts | Fixes tool name import path. |
| src/.pi/extensions/agent-runtime/index.ts | Adds agent-runtime barrel export. |
| src/.pi/extensions/tests/web-tools.test.ts | Updates web tools test import path. |
| src/.pi/extensions/tests/tui-lab.test.ts | Fixes relative imports after extension/component reparenting. |
| src/.pi/extensions/tests/subagents.test.ts | Fixes imports after extension reparenting. |
| src/.pi/extensions/tests/session-hooks-lifecycle.test.ts | Adds tests for session boundary pipeline. |
| src/.pi/extensions/tests/mentions.test.ts | Fixes mentions test import path. |
| src/.pi/extensions/tests/exchanges-schemas.test.ts | Fixes exchanges schema test import paths. |
| src/.pi/extensions/tests/exchanges-present-request.test.ts | Fixes exchanges tests import paths. |
| src/.pi/extensions/tests/exchanges-extension.test.ts | Fixes exchanges extension test import paths. |
| src/.pi/extensions/tests/exchanges-editor-envelope.test.ts | Fixes editor-envelope test import paths. |
| src/.pi/extensions/tests/dev-mode-session-query.test.ts | Fixes dev-mode session-query test import paths. |
| src/.pi/extensions/tests/dev-mode-introspection.test.ts | Fixes dev-mode introspection test import paths. |
| src/.pi/extensions/tests/dev-mode-introspect-query.test.ts | Fixes dev-mode introspect-query test import paths. |
| src/.pi/extensions/tests/commands-runtime-switch.test.ts | Fixes commands runtime-switch test import paths. |
| src/.pi/extensions/tests/chrome.test.ts | Fixes chrome test import paths. |
| src/.pi/extensions/tests/brunch-data-reconciliation.test.ts | Fixes brunch-data reconciliation test import paths. |
| src/.pi/extensions/tests/brunch-data-graph.test.ts | Uses agents/contexts/graph formatters in brunch-data graph tests. |
| src/.pi/extensions/tests/brunch-data-elicitation.test.ts | Fixes brunch-data elicitation test import paths. |
| src/.pi/extensions/tests/brunch-data-context.test.ts | Fixes brunch-data context test import paths. |
| src/.pi/extensions/tests/agent-runtime-runtime.test.ts | Fixes agent-runtime runtime test import paths. |
| src/.pi/extensions/tests/agent-runtime-authority-matrix.test.ts | Repoints policy import to agents/runtime/policy. |
| src/.pi/components/README.md | Updates components boundary guidance (agents/contexts vs renderers). |
| src/.pi/components/tests/workspace-dialog.test.ts | Fixes component test import paths + package.json relative URL. |
| src/.pi/components/tests/workspace-dialog-preflight.harness.test.ts | Fixes harness imports after reparenting. |
| src/.pi/components/tests/tui-lab-cycle.test.ts | Fixes lab-cycle test import paths. |
| src/.pi/components/tests/runtime-posture-axis-picker.test.ts | Fixes picker test imports after reparenting. |
| src/.pi/components/tests/runtime-posture-axis-picker.harness.test.ts | Fixes picker harness imports after reparenting. |
| src/.pi/tests/prompt-shape-readmes.test.ts | Deletes obsolete prompt-shape README assertions under .pi. |
| knip.jsonc | Adds Knip schema stub config. |
| docs/design/STRUCTURED_EXCHANGE_COLLAPSE.md | Updates design doc path from renderers/ to agents/contexts/. |
| docs/design/ONTOLOGY_REVIEW_PROTOCOL.md | Updates design doc pointer for commit-graph skill path. |
| .oxlintrc.json | Updates no-restricted-imports boundaries (workspace leaf + agents/contexts). |
| .agents/skills/ln-sync/SKILL.md | Tightens arc completion/done-definition guidance. |
| .agents/skills/ln-build/SKILL.md | Adds arc completion check to build workflow guidance. |
Comments suppressed due to low confidence (1)
src/agents/contexts/seeds/origination.ts:22
- This import path is unnecessarily indirect (it walks back to
src/and re-entersagents/contexts/...). Using a local relative import makes the module’s dependencies easier to read and less brittle to future moves.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| @@ -0,0 +1,3 @@ | |||
| # agents/contexts/primitives/ — context formatting helpers | |||
Comment on lines
+9
to
+15
| ```text | ||
| contexts/ | ||
| ├── primitives/ markdown, TOON, tree, and section formatting helpers | ||
| ├── references/ runtime-eligible shared context references cited by skills/prompts | ||
| ├── seeds/ per-turn pushed context blocks and origination seed payloads | ||
| ├── graph/ graph overview/neighborhood, related-node, mutation, reconciliation text | ||
| ├── elicitation.ts elicitation agenda/update text |
| readonly statement: string; | ||
| } | ||
|
|
||
| const GHERKIN_THEN_FIELD = `${'the'}n`; |
| given: { type: 'array', items: { type: 'string' }, description: 'Given preconditions.' }, | ||
| when: { type: 'array', items: { type: 'string' }, description: 'When actions.' }, | ||
| then: { | ||
| [GHERKIN_THEN_FIELD]: { |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Makes the project’s internal graph vocabulary easier to understand and keep up to date. It adds generated reference docs from the typed graph definitions, updates related guidance, and removes stale notes that no longer describe how the system works.
Why it matters
People and agents now have one clearer place to look when writing or reviewing graph-backed context, and checks will catch the reference docs if they drift from the source definitions.