ctxr-cli 0.4.1 → 0.6.0

package/dist/core/agents-doc.d.ts

@@ -45,28 +45,79 @@ export declare function buildAgentsPlacementSection(root: string, config: StoreC
     changed: boolean;
 }>;
 /**
- * harness-portability spec (task 8.5): the canonical template's four
- * required pieces — root-resolution rule, frontmatter schema pointer,
- * write-path rule, and a skill index — so an agent that has read only
- * this file, with no harness-specific context, has everything it needs
- * (the spec's own "Reading only AGENTS.md is sufficient" scenario).
+ * harness-portability spec (inline-conventions-and-mission): the canonical
+ * template's required pieces — root-resolution rule, frontmatter schema
+ * pointer, write-path rule, and the harness/store identity boundary — so an
+ * agent that has read only this file, with no harness-specific context, has
+ * everything it needs (the spec's own "Reading only AGENTS.md is
+ * sufficient" scenario). The skill index this section used to carry is gone
+ * (see the REMOVED "The skill index reflects the files on disk" requirement)
+ * — on a harness with native skill auto-discovery it duplicated content
+ * already in context; a harness without one still reaches every skill by
+ * path at the configured skills path.
  */
 export declare const AGENTS_MD_CANONICAL_FENCE: import("./markers.js").Fence;
-export declare function renderCanonicalSection(config: StoreConfig, skills: readonly ScannedDoc[]): string[];
+export declare function renderCanonicalSection(config: StoreConfig): string[];
 export declare function buildAgentsCanonicalSection(root: string, config: StoreConfig): Promise<{
     changed: boolean;
 }>;
 /**
- * entry-doc-generation spec: operator conventions as referenced documents.
- * The index lists what is actually on disk at the configured conventions
- * path; contexture ships no seeds here — conventions are definitionally
- * operator-authored, so an empty store gets its own template explaining the
- * mechanism. Both templates end with the same harness-specific-note
- * paragraph; a test asserts they stay byte-identical.
+ * inline-conventions-and-mission: the store's current mission, inlined as
+ * its own fenced section — replacing the pointer-only rendering this used to
+ * get. `missionRaw` is the mission note's raw file content, read by the
+ * caller (`buildAgentsMissionSection`) so this stays a pure, synchronous
+ * renderer like every other section in this file; `null` means unconfigured
+ * or the note doesn't exist, either of which renders nothing at all.
+ */
+export declare const AGENTS_MD_MISSION_FENCE: import("./markers.js").Fence;
+export declare function renderMissionSection(config: StoreConfig, missionRaw: string | null): string[];
+export declare function buildAgentsMissionSection(root: string, config: StoreConfig): Promise<{
+    changed: boolean;
+}>;
+/**
+ * harness-portability spec (inline-conventions-and-mission, folded into one
+ * template by compose-store-guidance-documents): operator conventions
+ * inlined in full. What's on disk at the configured conventions path is
+ * inlined body-and-all — heading-demoted under a heading naming its title,
+ * with a provenance line naming its source path — never referenced by a
+ * link alone; contexture ships no seeds here — conventions are
+ * definitionally operator-authored, so an empty store gets an explanation of
+ * the mechanism instead. One template (`conventions.md`) carries both: the
+ * empty-vs-populated difference is entirely in the lines `renderConventionsSection`
+ * computes for its one `__CONVENTION_BODY__` slot, so the surrounding frame
+ * (heading, harness-specific-note paragraph) exists in exactly one place and
+ * cannot drift between two copies the way it could when it shipped as two
+ * separate template files.
  */
 export declare const AGENTS_MD_CONVENTIONS_FENCE: import("./markers.js").Fence;
+/** Exported so doctor/verify can check a specific convention file's inlined block for drift without re-deriving the format. */
+export declare function renderConventionBlock(doc: ScannedDoc): string[];
 export declare function renderConventionsSection(config: StoreConfig, conventions: readonly ScannedDoc[]): string[];
 export declare function buildAgentsConventionsSection(root: string, config: StoreConfig): Promise<{
     changed: boolean;
 }>;
+/**
+ * harness-portability spec: "Generated sections render in a fixed order" —
+ * hard rules and current state first, operating mechanics next, the long
+ * operator reference last. `reconcileStore` passes this straight to
+ * `reorderFencedRegionsInFile`; a mission-less store simply never has the
+ * mission fence present, which the reorder primitive already treats as
+ * "skip it," not an error.
+ */
+export declare const AGENTS_MD_SECTION_ORDER: import("./markers.js").Fence[];
+export interface AgentsMdDrift {
+    /** Store-relative paths of convention files whose inlined block no longer matches the source. */
+    driftedConventions: string[];
+    /** The configured mission path, when its inlined section no longer matches the source; null otherwise. */
+    driftedMission: string | null;
+}
+/**
+ * harness-portability spec: "The entry document's inlined content matches
+ * its sources" — shared by `ctxr doctor` (reports every drifted file) and
+ * `ctxr verify --portable` (stops at the first one), per design.md's
+ * "Drift detection reuses render, not a hash": re-runs the same renderers
+ * `buildAgents*Section` uses and diffs against what is currently inside each
+ * fence, rather than storing a separate content hash anywhere.
+ */
+export declare function checkAgentsMdDrift(root: string, config: StoreConfig): Promise<AgentsMdDrift>;
 //# sourceMappingURL=agents-doc.d.ts.map

package/dist/core/agents-doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-doc.d.ts","sourceRoot":"","sources":["../../src/core/agents-doc.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAsBpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,8BAA4C,CAAC;AAErF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAOrE;AAED,mHAAmH;AACnH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAEnH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,8BAAyC,CAAC;AAE9E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAElE;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAEhH;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,8BAAgC,CAAC;AAEvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAapE;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAElH;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,8BAAgC,CAAC;AAsBvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAWnG;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAGlH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,8BAAwC,CAAC;AAEjF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAW1G;AAED,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAGpH"}
+{"version":3,"file":"agents-doc.d.ts","sourceRoot":"","sources":["../../src/core/agents-doc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,EAAsD,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgBvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,8BAA4C,CAAC;AAgCrF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAOrE;AAED,mHAAmH;AACnH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAEnH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,8BAAyC,CAAC;AAE9E,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAElE;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAEhH;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,8BAAgC,CAAC;AAEvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAapE;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAElH;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,8BAAgC,CAAC;AAuBvE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAUpE;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAElH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAS7F;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAoBhH;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,8BAAkC,CAAC;AAE3E,+HAA+H;AAC/H,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,EAAE,CAE/D;AAeD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAE1G;AAED,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAGpH;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,gCAOnC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,0GAA0G;IAC1G,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAoClG"}

package/dist/core/agents-doc.js

@@ -1,10 +1,10 @@
+import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { GRAPH_DOCUMENT_RELATIVE_PATH } from './graph/persist.js';
 import { CONFIG_FILE_NAME } from './root.js';
 import { excludedPrefixesFor } from './notes/list.js';
-import { scanConventions } from './conventions.js';
-import { scanSkills } from './skills.js';
-import { upsertFencedRegionInFile } from './fs/fenced-region.js';
+import { extractDocMetadata, inlineDocBody, scanConventions } from './conventions.js';
+import { readFencedRegionFromFile, removeFencedRegionFromFile, upsertFencedRegionInFile } from './fs/fenced-region.js';
 import { htmlCommentFence } from './markers.js';
 import { packagedTemplate, substituteBlock } from './templates.js';
 /**
@@ -17,10 +17,6 @@ import { packagedTemplate, substituteBlock } from './templates.js';
 function agentsTemplate(name) {
     return packagedTemplate('agents', name);
 }
-/** The one index-entry format both the skill and convention indexes use. */
-function docIndexEntry(doc) {
-    return `- [${doc.title}](${doc.path})${doc.description ? ` — ${doc.description}` : ''}`;
-}
 export function agentsMdPath(root) {
     return path.join(root, 'AGENTS.md');
 }
@@ -34,9 +30,38 @@ export function agentsMdPath(root) {
  * index) as sibling regions in the same file, never touching this one.
  */
 export const AGENTS_MD_LEG_ROUTING_FENCE = htmlCommentFence('retrieval-leg-routing');
+function trimTrailingSlash(prefix) {
+    return prefix.replace(/\/+$/, '');
+}
+/**
+ * inline-conventions-and-mission: `excludedPrefixesFor` deliberately includes
+ * both a parent path (e.g. `.contexture/`) and paths nested under it (e.g.
+ * `.contexture/cache/`) — each has its own reason to be there, and the note
+ * walker (`notes/list.ts`) needs the full, unfiltered set to skip directories
+ * early rather than descend and filter every file. Rendering that list
+ * verbatim produces a dozen-plus redundant bullets, so this collapses any
+ * prefix already covered by an ancestor prefix for display only — the
+ * exclusion logic itself is untouched.
+ */
+function collapseNestedPrefixes(prefixes) {
+    // Original (possibly trailing-slash) form preserved per trimmed key, since
+    // this list mixes directory prefixes and bare file exclusions (AGENTS.md,
+    // log.md) — the collapse test itself compares on the trimmed form only.
+    const originalByTrimmed = new Map();
+    for (const prefix of prefixes) {
+        const trimmed = trimTrailingSlash(prefix);
+        if (!originalByTrimmed.has(trimmed))
+            originalByTrimmed.set(trimmed, prefix);
+    }
+    const trimmed = [...originalByTrimmed.keys()];
+    return trimmed
+        .filter((path) => !trimmed.some((other) => other !== path && path.startsWith(`${other}/`)))
+        .sort()
+        .map((path) => originalByTrimmed.get(path));
+}
 export function renderLegRoutingSection(config) {
-    const exclusions = [...new Set(excludedPrefixesFor(config))];
-    return substituteBlock(agentsTemplate('retrieval-leg-routing').replaceAll('__GRAPH_DOCUMENT_PATH__', GRAPH_DOCUMENT_RELATIVE_PATH), '__EXCLUSION_PATHS__', exclusions.map((prefix) => `- \`${prefix}\``)).split('\n');
+    const exclusions = collapseNestedPrefixes(excludedPrefixesFor(config));
+    return substituteBlock(agentsTemplate('retrieval-leg-routing').replaceAll('__GRAPH_DOCUMENT_PATH__', GRAPH_DOCUMENT_RELATIVE_PATH), '__EXCLUSION_PATHS__', [exclusions.map((prefix) => `\`${prefix}\``).join(', ')]).split('\n');
 }
 /** Idempotently reconciles AGENTS.md's leg-routing section from current config — called at init and on re-init. */
 export async function buildAgentsLegRoutingSection(root, config) {
@@ -82,22 +107,28 @@ export async function buildAgentsPlacementSection(root, config) {
     return upsertFencedRegionInFile(agentsMdPath(root), AGENTS_MD_PLACEMENT_FENCE, renderPlacementSection(config));
 }
 /**
- * harness-portability spec (task 8.5): the canonical template's four
- * required pieces — root-resolution rule, frontmatter schema pointer,
- * write-path rule, and a skill index — so an agent that has read only
- * this file, with no harness-specific context, has everything it needs
- * (the spec's own "Reading only AGENTS.md is sufficient" scenario).
+ * harness-portability spec (inline-conventions-and-mission): the canonical
+ * template's required pieces — root-resolution rule, frontmatter schema
+ * pointer, write-path rule, and the harness/store identity boundary — so an
+ * agent that has read only this file, with no harness-specific context, has
+ * everything it needs (the spec's own "Reading only AGENTS.md is
+ * sufficient" scenario). The skill index this section used to carry is gone
+ * (see the REMOVED "The skill index reflects the files on disk" requirement)
+ * — on a harness with native skill auto-discovery it duplicated content
+ * already in context; a harness without one still reaches every skill by
+ * path at the configured skills path.
  */
 export const AGENTS_MD_CANONICAL_FENCE = htmlCommentFence('canonical');
 /**
- * context-organize spec: when `organize.mission_path` is configured, the
- * canonical section names it as a document to load at session start,
- * immediately after the identity-boundary paragraph. Content is written and
- * its staleness reported through the existing rollup mechanism (`ctxr
- * rollup write` / `ctxr rollup stale`) — this pointer only names the path,
- * it names no mechanism of its own. Nothing is rendered when unset: the
- * `__MISSION_POINTER__` template line disappears entirely (via
- * `substituteBlock`'s empty-list case), not a placeholder.
+ * context-organize spec, kept through inline-conventions-and-mission's
+ * design decision "the identity/mission pointer coexists with the inlined
+ * Mission section": when `organize.mission_path` is configured, the
+ * canonical section still names it as a document to load at session start,
+ * immediately followed (as its own fenced section — see
+ * `renderMissionSection` below) by that document's full inlined body.
+ * Nothing is rendered when unset: the `__MISSION_POINTER__` template line
+ * disappears entirely (via `substituteBlock`'s empty-list case), not a
+ * placeholder.
  */
 function renderMissionPointer(config) {
     const { mission_path: missionPath } = config.organize;
@@ -106,40 +137,159 @@ function renderMissionPointer(config) {
     return [
         '',
         `Load \`${missionPath}\` at the start of every session — this store's standing current-state document, ` +
-            'kept current by the mission skill (see the skill index below) and written through `ctxr rollup write`.',
+            'kept current by the mission skill and written through `ctxr rollup write`; its full content follows in the "Mission" section below.',
     ];
 }
-export function renderCanonicalSection(config, skills) {
-    const text = substituteBlock(agentsTemplate('canonical')
+export function renderCanonicalSection(config) {
+    return substituteBlock(agentsTemplate('canonical')
         .replaceAll('__CONFIG_FILE_NAME__', CONFIG_FILE_NAME)
         .replaceAll('__VISIBILITY_FIELD__', config.fields.visibility)
         .replaceAll('__DEFAULT_CONTEXT__', config.visibility.default_context)
-        .replaceAll('__SKILLS_PATH__', config.harness.skills_path), '__MISSION_POINTER__', renderMissionPointer(config));
-    return substituteBlock(text, '__SKILL_INDEX__', skills.map(docIndexEntry)).split('\n');
+        .replaceAll('__SKILLS_PATH__', config.harness.skills_path), '__MISSION_POINTER__', renderMissionPointer(config)).split('\n');
 }
 export async function buildAgentsCanonicalSection(root, config) {
-    const skills = await scanSkills(root, config);
-    return upsertFencedRegionInFile(agentsMdPath(root), AGENTS_MD_CANONICAL_FENCE, renderCanonicalSection(config, skills));
+    return upsertFencedRegionInFile(agentsMdPath(root), AGENTS_MD_CANONICAL_FENCE, renderCanonicalSection(config));
 }
 /**
- * entry-doc-generation spec: operator conventions as referenced documents.
- * The index lists what is actually on disk at the configured conventions
- * path; contexture ships no seeds here — conventions are definitionally
- * operator-authored, so an empty store gets its own template explaining the
- * mechanism. Both templates end with the same harness-specific-note
- * paragraph; a test asserts they stay byte-identical.
+ * inline-conventions-and-mission: the store's current mission, inlined as
+ * its own fenced section — replacing the pointer-only rendering this used to
+ * get. `missionRaw` is the mission note's raw file content, read by the
+ * caller (`buildAgentsMissionSection`) so this stays a pure, synchronous
+ * renderer like every other section in this file; `null` means unconfigured
+ * or the note doesn't exist, either of which renders nothing at all.
  */
-export const AGENTS_MD_CONVENTIONS_FENCE = htmlCommentFence('store-conventions');
-export function renderConventionsSection(config, conventions) {
+export const AGENTS_MD_MISSION_FENCE = htmlCommentFence('mission');
+export function renderMissionSection(config, missionRaw) {
+    const { mission_path: missionPath } = config.organize;
+    if (!missionPath || missionRaw === null)
+        return [];
+    const doc = extractDocMetadata(missionRaw, missionPath);
+    return substituteBlock(agentsTemplate('mission').replaceAll('__MISSION_PATH__', missionPath), '__MISSION_BODY__', inlineDocBody(doc, 1)).split('\n');
+}
+export async function buildAgentsMissionSection(root, config) {
+    const { mission_path: missionPath } = config.organize;
+    let missionRaw = null;
+    if (missionPath) {
+        try {
+            missionRaw = await readFile(path.join(root, missionPath), 'utf8');
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+    }
+    const body = renderMissionSection(config, missionRaw);
+    // `upsertFencedRegionInFile` appends a fence pair unconditionally when it's
+    // absent, even with an empty body — wrong here, where "unconfigured" must
+    // mean the section is absent entirely, never an empty fence pair. Removal
+    // is idempotent (a no-op when the fence isn't there), so this also cleans
+    // up correctly if a store had a mission configured and then unset it.
+    if (body.length === 0) {
+        return removeFencedRegionFromFile(agentsMdPath(root), AGENTS_MD_MISSION_FENCE);
+    }
+    return upsertFencedRegionInFile(agentsMdPath(root), AGENTS_MD_MISSION_FENCE, body);
+}
+/**
+ * harness-portability spec (inline-conventions-and-mission, folded into one
+ * template by compose-store-guidance-documents): operator conventions
+ * inlined in full. What's on disk at the configured conventions path is
+ * inlined body-and-all — heading-demoted under a heading naming its title,
+ * with a provenance line naming its source path — never referenced by a
+ * link alone; contexture ships no seeds here — conventions are
+ * definitionally operator-authored, so an empty store gets an explanation of
+ * the mechanism instead. One template (`conventions.md`) carries both: the
+ * empty-vs-populated difference is entirely in the lines `renderConventionsSection`
+ * computes for its one `__CONVENTION_BODY__` slot, so the surrounding frame
+ * (heading, harness-specific-note paragraph) exists in exactly one place and
+ * cannot drift between two copies the way it could when it shipped as two
+ * separate template files.
+ */
+export const AGENTS_MD_CONVENTIONS_FENCE = htmlCommentFence('conventions');
+/** Exported so doctor/verify can check a specific convention file's inlined block for drift without re-deriving the format. */
+export function renderConventionBlock(doc) {
+    return [`### ${doc.title}`, '', ...inlineDocBody(doc, 2), '', `_Source: ${doc.path}_`];
+}
+function conventionsBody(config, conventions) {
     if (conventions.length === 0) {
-        return agentsTemplate('store-conventions-empty')
-            .replaceAll('__CONVENTIONS_PATH__', config.harness.conventions_path)
-            .split('\n');
+        return [
+            'This store declares no convention documents yet. Operator-authored conventions (content style, field',
+            `semantics, house rules) belong as markdown files under \`${config.harness.guidance_path}\` — each is`,
+            'inlined here in full on regeneration.',
+        ];
     }
-    return substituteBlock(agentsTemplate('store-conventions'), '__CONVENTION_INDEX__', conventions.map(docIndexEntry)).split('\n');
+    const blocks = conventions.map(renderConventionBlock);
+    const bodies = blocks.flatMap((block, i) => (i === blocks.length - 1 ? block : [...block, '']));
+    return ['Operator-authored conventions for this store, inlined in full:', '', ...bodies];
+}
+export function renderConventionsSection(config, conventions) {
+    return substituteBlock(agentsTemplate('conventions'), '__CONVENTION_BODY__', conventionsBody(config, conventions)).split('\n');
 }
 export async function buildAgentsConventionsSection(root, config) {
     const conventions = await scanConventions(root, config);
     return upsertFencedRegionInFile(agentsMdPath(root), AGENTS_MD_CONVENTIONS_FENCE, renderConventionsSection(config, conventions));
 }
+/**
+ * harness-portability spec: "Generated sections render in a fixed order" —
+ * hard rules and current state first, operating mechanics next, the long
+ * operator reference last. `reconcileStore` passes this straight to
+ * `reorderFencedRegionsInFile`; a mission-less store simply never has the
+ * mission fence present, which the reorder primitive already treats as
+ * "skip it," not an error.
+ */
+export const AGENTS_MD_SECTION_ORDER = [
+    AGENTS_MD_CANONICAL_FENCE,
+    AGENTS_MD_MISSION_FENCE,
+    AGENTS_MD_LEG_ROUTING_FENCE,
+    AGENTS_MD_CAPTURE_FENCE,
+    AGENTS_MD_PLACEMENT_FENCE,
+    AGENTS_MD_CONVENTIONS_FENCE,
+];
+/**
+ * harness-portability spec: "The entry document's inlined content matches
+ * its sources" — shared by `ctxr doctor` (reports every drifted file) and
+ * `ctxr verify --portable` (stops at the first one), per design.md's
+ * "Drift detection reuses render, not a hash": re-runs the same renderers
+ * `buildAgents*Section` uses and diffs against what is currently inside each
+ * fence, rather than storing a separate content hash anywhere.
+ */
+export async function checkAgentsMdDrift(root, config) {
+    const filePath = agentsMdPath(root);
+    const conventions = await scanConventions(root, config);
+    const conventionsRegion = (await readFencedRegionFromFile(filePath, AGENTS_MD_CONVENTIONS_FENCE)).join('\n');
+    const freshConventionsSection = renderConventionsSection(config, conventions).join('\n');
+    const driftedConventions = [];
+    if (freshConventionsSection !== conventionsRegion) {
+        if (conventions.length === 0) {
+            driftedConventions.push(config.harness.guidance_path);
+        }
+        else {
+            for (const doc of conventions) {
+                if (!conventionsRegion.includes(renderConventionBlock(doc).join('\n')))
+                    driftedConventions.push(doc.path);
+            }
+            // Every individual block present, yet the whole section still differs
+            // (a reordering, an added/removed file, a template change): still real
+            // drift, just not attributable to one file — report the whole set.
+            if (driftedConventions.length === 0)
+                driftedConventions.push(...conventions.map((doc) => doc.path));
+        }
+    }
+    let driftedMission = null;
+    const missionPath = config.organize.mission_path;
+    if (missionPath) {
+        let missionRaw = null;
+        try {
+            missionRaw = await readFile(path.join(root, missionPath), 'utf8');
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT')
+                throw err;
+        }
+        const missionRegion = (await readFencedRegionFromFile(filePath, AGENTS_MD_MISSION_FENCE)).join('\n');
+        const freshMissionSection = renderMissionSection(config, missionRaw).join('\n');
+        if (freshMissionSection !== missionRegion)
+            driftedMission = missionPath;
+    }
+    return { driftedConventions, driftedMission };
+}
 //# sourceMappingURL=agents-doc.js.map

package/dist/core/agents-doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-doc.js","sourceRoot":"","sources":["../../src/core/agents-doc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents-doc.js","sourceRoot":"","sources":["../../src/core/agents-doc.ts"],"names":[],"mappings":"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"}

package/dist/core/browse/link-resolver.d.ts

@@ -0,0 +1,12 @@
+import { type StemResolution } from '../graph/model.js';
+import type { Note } from '../notes/list.js';
+/** A wikilink target -> a resolved note path, or a reason it didn't resolve to exactly one note. */
+export type LinkResolver = (target: string) => StemResolution;
+/**
+ * local-browsing-surface design.md D3: backed by the exact same stem index
+ * `ctxr graph build` resolves wikilinks against, so a note that renders
+ * cleanly in the browser view is, by construction, a note the graph build
+ * also resolves cleanly — never a second, potentially divergent resolver.
+ */
+export declare function buildLinkResolver(notes: readonly Note[]): LinkResolver;
+//# sourceMappingURL=link-resolver.d.ts.map

package/dist/core/browse/link-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/browse/link-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,YAAY,CAGtE"}

package/dist/core/browse/link-resolver.js

@@ -0,0 +1,12 @@
+import { buildStemIndex, resolveStem } from '../graph/model.js';
+/**
+ * local-browsing-surface design.md D3: backed by the exact same stem index
+ * `ctxr graph build` resolves wikilinks against, so a note that renders
+ * cleanly in the browser view is, by construction, a note the graph build
+ * also resolves cleanly — never a second, potentially divergent resolver.
+ */
+export function buildLinkResolver(notes) {
+    const stemIndex = buildStemIndex(notes);
+    return (target) => resolveStem(stemIndex, target);
+}
+//# sourceMappingURL=link-resolver.js.map

package/dist/core/browse/link-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-resolver.js","sourceRoot":"","sources":["../../../src/core/browse/link-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAuB,MAAM,mBAAmB,CAAC;AAMrF;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,CAAC,MAAc,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/core/browse/render.d.ts

@@ -0,0 +1,5 @@
+import type { LinkResolver } from './link-resolver.js';
+export declare function escapeHtml(text: string): string;
+/** Renders a note's markdown body to HTML, with wikilinks resolved via `resolveLink` (design.md D3). */
+export declare function renderNoteBody(body: string, resolveLink: LinkResolver): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/browse/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/core/browse/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA+CvD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAuBD,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,GAAG,MAAM,CAE9E"}

package/dist/core/browse/render.js

@@ -0,0 +1,66 @@
+import MarkdownIt from 'markdown-it';
+const OPEN = 0x5b; // '['
+/**
+ * local-browsing-surface design.md D3: a resolvable `[[Target]]` becomes a
+ * real link to that note's route; an unresolved or ambiguous one becomes
+ * visibly-marked, non-clickable markup naming the reason — never a link to
+ * an arbitrary or wrong target. Target extraction (up to the first `]`,
+ * `|`, or `#`) mirrors `extractLinks`' `WIKILINK_RE` in
+ * `src/core/graph/model.ts`, so a link this parses is a link the graph
+ * build parses identically.
+ */
+function wikilinkRule(state, silent) {
+    const start = state.pos;
+    const max = state.posMax;
+    if (start + 3 >= max)
+        return false;
+    if (state.src.charCodeAt(start) !== OPEN || state.src.charCodeAt(start + 1) !== OPEN)
+        return false;
+    const end = state.src.indexOf(']]', start + 2);
+    if (end === -1 || end > max)
+        return false;
+    const rawInner = state.src.slice(start + 2, end);
+    const targetMatch = /^([^\]|#]+)/.exec(rawInner);
+    const target = targetMatch?.[1]?.trim();
+    if (!target)
+        return false;
+    const pipeIdx = rawInner.indexOf('|');
+    const label = (pipeIdx !== -1 ? rawInner.slice(pipeIdx + 1).trim() : '') || target;
+    if (!silent) {
+        const token = state.push('wikilink', '', 0);
+        token.meta = { target, label };
+    }
+    state.pos = end + 2;
+    return true;
+}
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+function renderWikilink(resolveLink) {
+    return (tokens, idx) => {
+        const { target, label } = tokens[idx].meta;
+        const resolution = resolveLink(target);
+        const safeLabel = escapeHtml(label);
+        if ('path' in resolution) {
+            return `<a href="/notes/${encodeURI(resolution.path)}">${safeLabel}</a>`;
+        }
+        const reasonText = resolution.reason === 'ambiguous' ? 'ambiguous' : 'unresolved';
+        const title = `${reasonText} wikilink target: ${target}`;
+        return `<span class="ctxr-broken-link" data-reason="${resolution.reason}" title="${escapeHtml(title)}">${safeLabel}</span>`;
+    };
+}
+function buildRenderer(resolveLink) {
+    const md = new MarkdownIt({ html: false, linkify: true });
+    md.inline.ruler.before('link', 'wikilink', wikilinkRule);
+    md.renderer.rules.wikilink = renderWikilink(resolveLink);
+    return md;
+}
+/** Renders a note's markdown body to HTML, with wikilinks resolved via `resolveLink` (design.md D3). */
+export function renderNoteBody(body, resolveLink) {
+    return buildRenderer(resolveLink).render(body);
+}
+//# sourceMappingURL=render.js.map

package/dist/core/browse/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/core/browse/render.ts"],"names":[],"mappings":"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"}

package/dist/core/browse/routes.d.ts

@@ -0,0 +1,31 @@
+import { type Note } from '../notes/list.js';
+import type { Store } from '../store.js';
+export interface CatalogRoute {
+    id: string;
+    absolutePath: string;
+}
+export interface PublishFileRoute {
+    /** URL-relative path under /publish/, e.g. "my-page/index.html". */
+    urlPath: string;
+    absolutePath: string;
+}
+export interface RouteTable {
+    /** Keyed by store-relative note path (the same string used as the note's URL and its graph node id). */
+    notes: ReadonlyMap<string, Note>;
+    /** Keyed by catalog section id. */
+    catalog: ReadonlyMap<string, CatalogRoute>;
+    graphDocumentPath: string;
+    /** Keyed by the exact URL-relative path under /publish/ — a lookup miss is the only traversal guard needed (design.md D2). */
+    publishFiles: ReadonlyMap<string, PublishFileRoute>;
+}
+/**
+ * local-browsing-surface design.md D2: built fresh from the store's own
+ * enumeration on every call, never cached — so a path outside every
+ * configured location is absent from the table by construction, and a
+ * request for it is an ordinary lookup miss rather than a check that could
+ * be forgotten on one route and not another.
+ */
+export declare function buildRouteTable(store: Store): Promise<RouteTable>;
+/** The distinct top-level page folders under the publish route, for the index page. */
+export declare function publishSlugs(table: RouteTable): string[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/core/browse/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/core/browse/routes.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,wGAAwG;IACxG,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,mCAAmC;IACnC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8HAA8H;IAC9H,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACrD;AAuBD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAevE;AAED,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAOxD"}