@aperant/framework 0.6.2

package/dist/cli/docs/structure-planner.d.mts

@@ -0,0 +1,117 @@
+/**
+ * Slugify a human name into a kebab-case id. Used as a deterministic fallback
+ * when a persona lacks an explicit id field.
+ *
+ * @param {string} name
+ * @returns {string}
+ */
+export function slugify(name: string): string;
+/**
+ * Plan the output tree.
+ *
+ * @param {Object} inputs
+ * @param {Array<unknown>} inputs.personas
+ * @param {FeatureArea[]} inputs.areas
+ * @param {string} [inputs.outputDirRelative]
+ * @returns {StructurePlan}
+ */
+export function planStructure({ personas, areas, outputDirRelative }: {
+    personas: Array<unknown>;
+    areas: FeatureArea[];
+    outputDirRelative?: string | undefined;
+}): StructurePlan;
+/**
+ * Compact marker that the LLM agent will consume to make the D-04
+ * variant-vs-shared decision per feature. Pure data — we do NOT call the
+ * LLM here; the rubric prompt composition lives in the SKILL.md body.
+ *
+ * @param {PlannedFeatureDoc} feature
+ * @param {PlannedPersona[]} personas
+ * @returns {{ feature_id: string, candidate_personas: PlannedPersona[], shared_path: string, variant_paths: Record<string, string> }}
+ */
+export function buildVariantDecisionInput(feature: PlannedFeatureDoc, personas: PlannedPersona[]): {
+    feature_id: string;
+    candidate_personas: PlannedPersona[];
+    shared_path: string;
+    variant_paths: Record<string, string>;
+};
+export type FeatureArea = import("./features-reader.mjs").FeatureArea;
+export type FeatureGroup = import("./features-reader.mjs").FeatureGroup;
+export type PersonaTier = "primary" | "secondary" | "tertiary";
+export type PlannedPersona = {
+    id: string;
+    name: string;
+    tier: PersonaTier;
+    /**
+     * relative path: `{persona}/README.md`
+     */
+    landing_path: string;
+};
+export type PlannedFeatureDoc = {
+    area: string;
+    /**
+     * group id when feature-as-group; area when area-level leaf
+     */
+    feature_id: string;
+    feature_name: string;
+    wiring: "wired" | "stubbed";
+    /**
+     * D-03 "Coming soon" marker
+     */
+    is_stub: boolean;
+    /**
+     * relative path when rendered as shared: `_shared/{area}/{feature}.md`
+     */
+    shared_path: string;
+    /**
+     * persona-id → relative path for variant rendering
+     */
+    variant_paths: Record<string, string>;
+    /**
+     * persona ids this doc belongs to (primary+secondary wired; primary-only stub)
+     */
+    included_personas: string[];
+    /**
+     * persona ids that reference this doc via their skeleton (no dedicated page)
+     */
+    tertiary_personas: string[];
+};
+export type PlannedArea = {
+    /**
+     * area id (e.g. "terminals")
+     */
+    area: string;
+    route?: string | undefined;
+    feature_count_wired: number;
+    feature_count_stubbed: number;
+    feature_count_unwired_omitted: number;
+    features: PlannedFeatureDoc[];
+};
+export type StructurePlan = {
+    /**
+     * always `docs/product` unless overridden
+     */
+    output_dir_relative: string;
+    personas: PlannedPersona[];
+    areas: PlannedArea[];
+    tertiary_skeletons: Array<{
+        persona_id: string;
+        area: string;
+        path: string;
+    }>;
+    persona_landings: Array<{
+        persona_id: string;
+        path: string;
+    }>;
+    /**
+     * `docs/product/README.md`
+     */
+    nav_index_path: string;
+    totals: {
+        areas: number;
+        features_documented: number;
+        stubs_included: number;
+        features_omitted_unwired: number;
+    };
+};
+//# sourceMappingURL=structure-planner.d.mts.map

package/dist/cli/docs/structure-planner.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-planner.d.mts","sourceRoot":"","sources":["../../../src/cli/docs/structure-planner.mjs"],"names":[],"mappings":"AA8IA;;;;;;GAMG;AACH,8BAHW,MAAM,GACJ,MAAM,CAOlB;AAiBD;;;;;;;;GAQG;AACH,sEALG;IAA+B,QAAQ,EAA/B,KAAK,CAAC,OAAO,CAAC;IACQ,KAAK,EAA3B,WAAW,EAAE;IACG,iBAAiB;CACzC,GAAU,aAAa,CAmHzB;AAED;;;;;;;;GAQG;AACH,mDAJW,iBAAiB,YACjB,cAAc,EAAE,GACd;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,cAAc,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAapI;0BAxRY,OAAO,uBAAuB,EAAE,WAAW;2BAC3C,OAAO,uBAAuB,EAAE,YAAY;0BAI5C,SAAS,GAAG,WAAW,GAAG,UAAU;;QAKnC,MAAM;UACN,MAAM;UACN,WAAW;;;;kBACX,MAAM;;;UAKN,MAAM;;;;gBACN,MAAM;kBACN,MAAM;YACN,OAAO,GAAG,SAAS;;;;aACnB,OAAO;;;;iBACP,MAAM;;;;mBACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;uBACtB,MAAM,EAAE;;;;uBACR,MAAM,EAAE;;;;;;UAKR,MAAM;;yBAEN,MAAM;2BACN,MAAM;mCACN,MAAM;cACN,iBAAiB,EAAE;;;;;;yBAKnB,MAAM;cACN,cAAc,EAAE;WAChB,WAAW,EAAE;wBACb,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;sBACzD,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;;;;oBAC3C,MAAM;YACN;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,wBAAwB,EAAE,MAAM,CAAA;KAAE"}

package/dist/cli/docs/structure-planner.mjs

@@ -0,0 +1,295 @@
+/**
+ * docs/structure-planner.mjs — tier-aware output-tree planner (C49).
+ *
+ * Given three inputs — the product-context sidecar (derived from PROJECT.md),
+ * the personas envelope (from C48), and the feature inventory (from
+ * features-reader.mjs) — this module produces the planned output file tree
+ * for `docs/product/`.
+ *
+ * Locked decisions this module enforces DETERMINISTICALLY (no LLM):
+ *
+ *   D-02 — Persona-first outer layer, feature-area inner layer.
+ *          `docs/product/{persona-id}/{area-id}/index.md`.
+ *          - Primary personas: full per-area tree.
+ *          - Secondary personas: shared (non-variant) tree — same content
+ *            shape as primary, but flagged `variant: false`.
+ *          - Tertiary personas: skeleton-only — landing page + area
+ *            placeholders, no per-feature pages.
+ *
+ *   D-03 — Wired features → full docs. Stubbed features → "Coming soon"
+ *          stubs (primary-persona only; tertiary stubs omitted). Unwired
+ *          features are omitted entirely.
+ *
+ *   D-04 — Variant-vs-shared decision PER FEATURE. This planner does NOT
+ *          make the decision itself (that's the LLM's rubric call inside
+ *          the apt-docs-author agent). We emit a `variant_decision_input`
+ *          structure for each feature — the raw signal the LLM consumes.
+ *          The planned output tree reserves file paths for BOTH variant
+ *          and shared shapes so the agent can pick either at write-time.
+ *
+ * The planner is PURE — inputs in, planned tree out, no I/O. All writes
+ * happen in the CLI orchestrator (create-docs.mjs), which consumes this
+ * plan + invokes the agent loop.
+ */
+/**
+ * @typedef {import('./features-reader.mjs').FeatureArea} FeatureArea
+ * @typedef {import('./features-reader.mjs').FeatureGroup} FeatureGroup
+ */
+/**
+ * @typedef {'primary' | 'secondary' | 'tertiary'} PersonaTier
+ */
+/**
+ * @typedef {Object} PlannedPersona
+ * @property {string} id
+ * @property {string} name
+ * @property {PersonaTier} tier
+ * @property {string} landing_path        relative path: `{persona}/README.md`
+ */
+/**
+ * @typedef {Object} PlannedFeatureDoc
+ * @property {string} area
+ * @property {string} feature_id          group id when feature-as-group; area when area-level leaf
+ * @property {string} feature_name
+ * @property {'wired' | 'stubbed'} wiring
+ * @property {boolean} is_stub            D-03 "Coming soon" marker
+ * @property {string} shared_path         relative path when rendered as shared: `_shared/{area}/{feature}.md`
+ * @property {Record<string, string>} variant_paths   persona-id → relative path for variant rendering
+ * @property {string[]} included_personas persona ids this doc belongs to (primary+secondary wired; primary-only stub)
+ * @property {string[]} tertiary_personas persona ids that reference this doc via their skeleton (no dedicated page)
+ */
+/**
+ * @typedef {Object} PlannedArea
+ * @property {string} area                    area id (e.g. "terminals")
+ * @property {string} [route]
+ * @property {number} feature_count_wired
+ * @property {number} feature_count_stubbed
+ * @property {number} feature_count_unwired_omitted
+ * @property {PlannedFeatureDoc[]} features
+ */
+/**
+ * @typedef {Object} StructurePlan
+ * @property {string} output_dir_relative         always `docs/product` unless overridden
+ * @property {PlannedPersona[]} personas
+ * @property {PlannedArea[]} areas
+ * @property {Array<{ persona_id: string, area: string, path: string }>} tertiary_skeletons
+ * @property {Array<{ persona_id: string, path: string }>} persona_landings
+ * @property {string} nav_index_path              `docs/product/README.md`
+ * @property {{ areas: number, features_documented: number, stubs_included: number, features_omitted_unwired: number }} totals
+ */
+/**
+ * Parse a `ui_json` string that the personas CLI wraps around the
+ * structured persona data. Returns null on any parse failure. The CLI
+ * emits personas with `ui_json: '{"name":"Maya","tier":"primary",...}'`
+ * — a stringified JSON blob — so we cannot read it positionally.
+ *
+ * @param {unknown} raw
+ * @returns {Record<string, unknown> | null}
+ */
+function safeParseUiJson(raw) {
+    if (!raw)
+        return null;
+    if (typeof raw === 'object')
+        return /** @type {Record<string, unknown>} */ (raw);
+    if (typeof raw !== 'string')
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object') {
+            return /** @type {Record<string, unknown>} */ (parsed);
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return null;
+}
+/**
+ * Normalize a raw Persona object (from `.aperant/personas.json`) into the
+ * `{ id, name, tier }` shape this planner needs. We accept several shapes
+ * defensively because the persona envelope is written by both the framework
+ * CLI and (eventually) the cloud app wizard.
+ *
+ * @param {unknown} raw
+ * @param {number} index   Fallback slot used to generate stable ids when the
+ *                         persona lacks one.
+ * @returns {{ id: string, name: string, tier: PersonaTier } | null}
+ */
+function normalizePersona(raw, index) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const p = /** @type {Record<string, unknown>} */ (raw);
+    const ui = safeParseUiJson(p.ui_json) ?? {};
+    const rawName = (typeof ui.name === 'string' && ui.name) || (typeof p.name === 'string' && p.name) || null;
+    if (!rawName)
+        return null;
+    const rawTier = (typeof ui.tier === 'string' && ui.tier) || (typeof p.tier === 'string' && p.tier) || null;
+    const tier = rawTier === 'primary' || rawTier === 'secondary' || rawTier === 'tertiary'
+        ? rawTier
+        : 'secondary';
+    const id = (typeof p.id === 'string' && p.id) ||
+        (typeof ui.id === 'string' && ui.id) ||
+        slugify(rawName) ||
+        `persona-${index + 1}`;
+    return { id, name: rawName, tier };
+}
+/**
+ * Slugify a human name into a kebab-case id. Used as a deterministic fallback
+ * when a persona lacks an explicit id field.
+ *
+ * @param {string} name
+ * @returns {string}
+ */
+export function slugify(name) {
+    return String(name)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Compute an area-level wiring projection: only the groups we will actually
+ * document in this persona's tree. Keeps the output plan slim.
+ *
+ * @param {FeatureArea} area
+ * @returns {FeatureGroup[]}
+ */
+function groupsWorthDocumenting(area) {
+    const out = [];
+    for (const g of area.features) {
+        if (g.wiring === 'wired' || g.wiring === 'stubbed')
+            out.push(g);
+    }
+    return out;
+}
+/**
+ * Plan the output tree.
+ *
+ * @param {Object} inputs
+ * @param {Array<unknown>} inputs.personas
+ * @param {FeatureArea[]} inputs.areas
+ * @param {string} [inputs.outputDirRelative]
+ * @returns {StructurePlan}
+ */
+export function planStructure({ personas, areas, outputDirRelative = 'docs/product' }) {
+    const personaRoster = [];
+    for (let i = 0; i < personas.length; i++) {
+        const norm = normalizePersona(personas[i], i);
+        if (norm)
+            personaRoster.push(norm);
+    }
+    const primaryIds = personaRoster.filter((p) => p.tier === 'primary').map((p) => p.id);
+    const secondaryIds = personaRoster.filter((p) => p.tier === 'secondary').map((p) => p.id);
+    const tertiaryIds = personaRoster.filter((p) => p.tier === 'tertiary').map((p) => p.id);
+    const plannedPersonas = personaRoster.map((p) => ({
+        id: p.id,
+        name: p.name,
+        tier: p.tier,
+        landing_path: `${p.id}/README.md`,
+    }));
+    const personaLandings = plannedPersonas.map((p) => ({
+        persona_id: p.id,
+        path: p.landing_path,
+    }));
+    const plannedAreas = [];
+    const tertiarySkeletons = [];
+    let featuresDocumented = 0;
+    let stubsIncluded = 0;
+    let featuresOmittedUnwired = 0;
+    for (const area of areas) {
+        const groups = groupsWorthDocumenting(area);
+        let wiredGroupCount = 0;
+        let stubbedGroupCount = 0;
+        let unwiredOmitted = 0;
+        for (const g of area.features) {
+            if (g.wiring === 'unwired')
+                unwiredOmitted += 1;
+        }
+        featuresOmittedUnwired += unwiredOmitted;
+        const plannedFeatures = [];
+        for (const group of groups) {
+            const isStub = group.wiring === 'stubbed';
+            const shared_path = `_shared/${area.area}/${group.id}.md`;
+            const variantPaths = /** @type {Record<string, string>} */ ({});
+            for (const pid of primaryIds) {
+                variantPaths[pid] = `${pid}/${area.area}/${group.id}.md`;
+            }
+            for (const pid of secondaryIds) {
+                variantPaths[pid] = `${pid}/${area.area}/${group.id}.md`;
+            }
+            // D-03: stubbed features get included for primary personas only.
+            // Wired features get included for primary + secondary.
+            const includedPersonas = isStub ? primaryIds.slice() : primaryIds.concat(secondaryIds);
+            plannedFeatures.push({
+                area: area.area,
+                feature_id: group.id,
+                feature_name: group.name,
+                wiring: isStub ? 'stubbed' : 'wired',
+                is_stub: isStub,
+                shared_path,
+                variant_paths: variantPaths,
+                included_personas: includedPersonas,
+                tertiary_personas: tertiaryIds.slice(),
+            });
+            if (isStub) {
+                stubbedGroupCount += 1;
+                stubsIncluded += 1;
+            }
+            else {
+                wiredGroupCount += 1;
+                featuresDocumented += 1;
+            }
+        }
+        plannedAreas.push({
+            area: area.area,
+            route: area.route,
+            feature_count_wired: wiredGroupCount,
+            feature_count_stubbed: stubbedGroupCount,
+            feature_count_unwired_omitted: unwiredOmitted,
+            features: plannedFeatures,
+        });
+        // D-02: tertiary personas get skeleton-only references — one
+        // placeholder `index.md` per area so the user can see the area
+        // exists without the full per-feature tree.
+        if (plannedFeatures.length > 0) {
+            for (const pid of tertiaryIds) {
+                tertiarySkeletons.push({
+                    persona_id: pid,
+                    area: area.area,
+                    path: `${pid}/${area.area}/index.md`,
+                });
+            }
+        }
+    }
+    return {
+        output_dir_relative: outputDirRelative,
+        personas: plannedPersonas,
+        areas: plannedAreas,
+        tertiary_skeletons: tertiarySkeletons,
+        persona_landings: personaLandings,
+        nav_index_path: `${outputDirRelative}/README.md`,
+        totals: {
+            areas: plannedAreas.length,
+            features_documented: featuresDocumented,
+            stubs_included: stubsIncluded,
+            features_omitted_unwired: featuresOmittedUnwired,
+        },
+    };
+}
+/**
+ * Compact marker that the LLM agent will consume to make the D-04
+ * variant-vs-shared decision per feature. Pure data — we do NOT call the
+ * LLM here; the rubric prompt composition lives in the SKILL.md body.
+ *
+ * @param {PlannedFeatureDoc} feature
+ * @param {PlannedPersona[]} personas
+ * @returns {{ feature_id: string, candidate_personas: PlannedPersona[], shared_path: string, variant_paths: Record<string, string> }}
+ */
+export function buildVariantDecisionInput(feature, personas) {
+    const candidates = personas.filter((p) => feature.included_personas.includes(p.id) && (p.tier === 'primary' || p.tier === 'secondary'));
+    return {
+        feature_id: feature.feature_id,
+        candidate_personas: candidates,
+        shared_path: feature.shared_path,
+        variant_paths: feature.variant_paths,
+    };
+}
+//# sourceMappingURL=structure-planner.mjs.map

package/dist/cli/docs/structure-planner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure-planner.mjs","sourceRoot":"","sources":["../../../src/cli/docs/structure-planner.mjs"],"names":[],"mappings":"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"}

package/dist/cli/docs-audit/audit.d.mts

@@ -0,0 +1,24 @@
+/**
+ * Run the docs-coherence audit.
+ *
+ * @param {object} opts
+ * @param {string} opts.projectDir — absolute project root
+ * @param {Array<string>} [opts.diffFiles] — files changed by the task
+ * @param {object} [opts.diffFacts] — { deletedPaths, renamedPaths, addedExports, removedExports }
+ * @param {object} opts.policy — resolved via loadDocsPolicy(projectDir)
+ * @param {Array<string>} [opts.surfaces] — explicit surface list (testing hook)
+ *
+ * @returns {{findings: Array, patch_plan: Array, dropped: Array}}
+ */
+export function auditDocsDrift(opts?: {
+    projectDir: string;
+    diffFiles?: string[] | undefined;
+    diffFacts?: object | undefined;
+    policy: object;
+    surfaces?: string[] | undefined;
+}): {
+    findings: any[];
+    patch_plan: any[];
+    dropped: any[];
+};
+//# sourceMappingURL=audit.d.mts.map

package/dist/cli/docs-audit/audit.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.mts","sourceRoot":"","sources":["../../../src/cli/docs-audit/audit.mjs"],"names":[],"mappings":"AA2BA;;;;;;;;;;;GAWG;AACH,sCARG;IAAqB,UAAU,EAAvB,MAAM;IACe,SAAS;IAChB,SAAS;IACV,MAAM,EAAnB,MAAM;IACe,QAAQ;CAErC,GAAU;IAAC,QAAQ,QAAQ;IAAC,UAAU,QAAQ;IAAC,OAAO,QAAO;CAAC,CAyDhE"}

package/dist/cli/docs-audit/audit.mjs

@@ -0,0 +1,158 @@
+/**
+ * @internal
+ * audit.mjs — docs-coherence audit orchestrator (C33).
+ *
+ * Walks every candidate documented surface in a project, runs
+ * `findStaleClaimsInMarkdown` against it, and buckets each finding by the
+ * resolved policy:
+ *
+ *   - `auto-update` → enter `patch_plan` (reviewer applies in fix iterations 1-2)
+ *   - `flag-drift`  → enter `findings` (surfaced only, never auto-edited)
+ *   - `skip` or unmatched → dropped
+ *
+ * Surface discovery is driven by the policy map (every key becomes a
+ * candidate) plus glob-walking the markdown surfaces that commonly appear:
+ *   - packages/*\/README.md
+ *   - docs/**\/*.md
+ *   - root-level CLAUDE.md / AGENTS.md / README.md
+ *
+ * The module does not touch git — callers pass in `diffFiles` (for per-surface
+ * stub creation) and the structured `diffFacts` shape. `apt-tools docs-audit`
+ * is the CLI wrapper that actually computes `diffFacts` from git.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+import { matchSurfaceToPolicy } from './policy.mjs';
+/**
+ * Run the docs-coherence audit.
+ *
+ * @param {object} opts
+ * @param {string} opts.projectDir — absolute project root
+ * @param {Array<string>} [opts.diffFiles] — files changed by the task
+ * @param {object} [opts.diffFacts] — { deletedPaths, renamedPaths, addedExports, removedExports }
+ * @param {object} opts.policy — resolved via loadDocsPolicy(projectDir)
+ * @param {Array<string>} [opts.surfaces] — explicit surface list (testing hook)
+ *
+ * @returns {{findings: Array, patch_plan: Array, dropped: Array}}
+ */
+export async function auditDocsDrift(opts = {}) {
+    const { findStaleClaimsInMarkdown } = await import('./grep-claims.mjs');
+    const projectDir = opts.projectDir ? resolve(opts.projectDir) : process.cwd();
+    const policy = opts.policy || {};
+    const diffFacts = {
+        deletedPaths: Array.isArray(opts.diffFacts?.deletedPaths) ? opts.diffFacts.deletedPaths : [],
+        renamedPaths: Array.isArray(opts.diffFacts?.renamedPaths) ? opts.diffFacts.renamedPaths : [],
+        addedExports: Array.isArray(opts.diffFacts?.addedExports) ? opts.diffFacts.addedExports : [],
+        removedExports: Array.isArray(opts.diffFacts?.removedExports)
+            ? opts.diffFacts.removedExports
+            : [],
+    };
+    const findings = [];
+    const patch_plan = [];
+    const dropped = [];
+    // Test-time shortcut: caller provides an explicit surface list.
+    const surfaces = Array.isArray(opts.surfaces)
+        ? opts.surfaces
+        : discoverDocumentedSurfaces(projectDir, policy);
+    // Dedup in case discovery emitted the same path twice.
+    const seen = new Set();
+    for (const relPath of surfaces) {
+        if (seen.has(relPath))
+            continue;
+        seen.add(relPath);
+        const abs = resolve(projectDir, relPath);
+        if (!existsSync(abs))
+            continue;
+        const policyValue = matchSurfaceToPolicy(relPath, policy);
+        if (policyValue === 'skip' || policyValue === null) {
+            // Scan nothing for skipped surfaces; record so callers can report "seen but skipped".
+            dropped.push({ file: relPath, policy: policyValue });
+            continue;
+        }
+        const hits = findStaleClaimsInMarkdown(abs, diffFacts);
+        for (const hit of hits) {
+            // Normalize file to project-relative.
+            const relFile = relative(projectDir, hit.file);
+            const entry = {
+                ...hit,
+                file: relFile,
+                category: 'docs-drift',
+                severity: policyValue === 'flag-drift' ? 'warning' : 'info',
+                policy: policyValue,
+            };
+            if (policyValue === 'auto-update') {
+                patch_plan.push(entry);
+            }
+            else {
+                findings.push(entry);
+            }
+        }
+    }
+    return { findings, patch_plan, dropped };
+}
+/**
+ * Enumerate documented surfaces to scan. Union of:
+ *   - every literal key in `policy` (CLAUDE.md, etc)
+ *   - every `packages/*\/README.md` that exists
+ *   - every `*.md` under `docs/`
+ *   - root README.md (if present)
+ *
+ * Returns project-relative POSIX-separator paths. Duplicates ok — caller dedups.
+ */
+function discoverDocumentedSurfaces(projectDir, policy) {
+    const out = [];
+    // Literal keys in the policy are the primary surface hints.
+    for (const key of Object.keys(policy)) {
+        if (!key.includes('*'))
+            out.push(key);
+    }
+    // Root markdowns commonly authored as claims.
+    for (const name of ['CLAUDE.md', 'AGENTS.md', 'README.md']) {
+        if (existsSync(join(projectDir, name)))
+            out.push(name);
+    }
+    // packages/*/README.md
+    const packagesDir = join(projectDir, 'packages');
+    if (existsSync(packagesDir)) {
+        for (const entry of safeReaddir(packagesDir)) {
+            const pkgReadme = join(packagesDir, entry, 'README.md');
+            if (existsSync(pkgReadme))
+                out.push(`packages/${entry}/README.md`);
+        }
+    }
+    // docs/**/*.md — bounded-depth walk, 5 levels max to avoid runaway recursion.
+    const docsDir = join(projectDir, 'docs');
+    if (existsSync(docsDir)) {
+        walkMarkdown(docsDir, projectDir, 0, 5, out);
+    }
+    return out;
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+function walkMarkdown(dir, projectDir, depth, maxDepth, out) {
+    if (depth > maxDepth)
+        return;
+    for (const entry of safeReaddir(dir)) {
+        const abs = join(dir, entry);
+        let st;
+        try {
+            st = statSync(abs);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            walkMarkdown(abs, projectDir, depth + 1, maxDepth, out);
+        }
+        else if (st.isFile() && /\.md$/i.test(entry)) {
+            out.push(relative(projectDir, abs).replace(/\\/g, '/'));
+        }
+    }
+}
+//# sourceMappingURL=audit.mjs.map

package/dist/cli/docs-audit/audit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.mjs","sourceRoot":"","sources":["../../../src/cli/docs-audit/audit.mjs"],"names":[],"mappings":"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"}

package/dist/cli/docs-audit/grep-claims.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Walk a markdown file line-by-line and collect stale-reference findings.
+ *
+ * @returns {Array<{file, line, column, stale_claim, evidence, confidence, suggested_rewrite?}>}
+ */
+export function findStaleClaimsInMarkdown(filepath: any, diffFacts: any): Array<{
+    file: any;
+    line: any;
+    column: any;
+    stale_claim: any;
+    evidence: any;
+    confidence: any;
+    suggested_rewrite?: any;
+}>;
+//# sourceMappingURL=grep-claims.d.mts.map

package/dist/cli/docs-audit/grep-claims.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep-claims.d.mts","sourceRoot":"","sources":["../../../src/cli/docs-audit/grep-claims.mjs"],"names":[],"mappings":"AAkCA;;;;GAIG;AACH,0EAFa,KAAK,CAAC;IAAC,IAAI,MAAC;IAAC,IAAI,MAAC;IAAC,MAAM,MAAC;IAAC,WAAW,MAAC;IAAC,QAAQ,MAAC;IAAC,UAAU,MAAC;IAAC,iBAAiB,CAAC,MAAA;CAAC,CAAC,CAkF9F"}