@aperant/framework 0.6.2

package/dist/cli/features/registry-audit.mjs

@@ -0,0 +1,264 @@
+/**
+ * @internal
+ * registry-audit.mjs — features-registry audit + stub emitter (C33).
+ *
+ * Shared module used by:
+ *   - `apt-execute` post-step (`apt-tools features-audit --apply-stubs`) —
+ *     auto-registers new UI/core/hook/IPC files the subtask added.
+ *   - `apt-reviewer` Pass 6 (`apt-tools features-audit` without `--apply-stubs`)
+ *     — reports anything the executor missed.
+ *
+ * Feature kinds (spec §D-4):
+ *   - `ui-component`  — packages/ui/src/sections/** /*.tsx
+ *   - `core-service`  — packages/core/src/{services,pipeline}/**\/*.ts
+ *   - `hook`          — packages/ui/src/hooks/use-*.ts
+ *   - `ipc-channel`   — apps/desktop/src/main/ipc-handlers/*.ts
+ *
+ * Non-matching paths → null, not included in the audit.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { atomicWriteJson } from '../util/io.mjs';
+/**
+ * Map a file path to a feature kind, or null if it doesn't qualify.
+ */
+export function detectFeatureKind(filepath) {
+    if (!filepath || typeof filepath !== 'string')
+        return null;
+    const norm = filepath.replace(/\\/g, '/').replace(/^\.\//, '');
+    // Exclude test files up-front so they never match a feature kind.
+    if (/\.(test|spec)\.(ts|tsx)$/.test(norm))
+        return null;
+    if (/\/__tests__\//.test(norm))
+        return null;
+    // ui-component: packages/ui/src/sections/**/*.tsx
+    if (/^packages\/ui\/src\/sections\/.+\.tsx$/.test(norm))
+        return 'ui-component';
+    // core-service: packages/core/src/{services,pipeline}/**/*.ts
+    if (/^packages\/core\/src\/(services|pipeline)\/.+\.ts$/.test(norm))
+        return 'core-service';
+    // hook: packages/ui/src/hooks/use-*.ts (also use-*.tsx allowed for hook factories)
+    if (/^packages\/ui\/src\/hooks\/use-[A-Za-z0-9-]+\.tsx?$/.test(norm))
+        return 'hook';
+    // ipc-channel: apps/desktop/src/main/ipc-handlers/*.ts
+    if (/^apps\/desktop\/src\/main\/ipc-handlers\/[^/]+\.ts$/.test(norm))
+        return 'ipc-channel';
+    return null;
+}
+/**
+ * Infer the features-registry "area" that should own a given path. The area
+ * is the leaf folder under `sections/`, or a kind-specific pseudo-area when
+ * the file isn't under sections/.
+ */
+export function inferArea(filepath) {
+    const norm = filepath.replace(/\\/g, '/').replace(/^\.\//, '');
+    const m = /^packages\/ui\/src\/sections\/([^/]+)\//.exec(norm);
+    if (m)
+        return m[1];
+    if (/^packages\/core\/src\/pipeline\//.test(norm))
+        return 'pipeline';
+    if (/^packages\/core\/src\/services\//.test(norm))
+        return 'services';
+    if (/^packages\/ui\/src\/hooks\//.test(norm))
+        return 'hooks';
+    if (/^apps\/desktop\/src\/main\/ipc-handlers\//.test(norm))
+        return 'ipc';
+    return null;
+}
+/**
+ * Audit a set of diff files against the features registry.
+ *
+ * @param {object} opts
+ * @param {string} opts.projectDir
+ * @param {Array<string>} opts.diffFiles  — project-relative file paths
+ *
+ * @returns {{
+ *   new_components: Array<{file, kind, area}>,
+ *   unregistered: Array<{file, kind, area}>,
+ *   stub_patches: Array<StubPatch>,
+ * }}
+ *
+ * StubPatch shape:
+ *   { target: string, area: string, add_components: string[], create_area?: boolean, kind: string }
+ */
+export function auditFeatureRegistry({ projectDir, diffFiles }) {
+    const root = resolve(projectDir);
+    const featuresDir = join(root, '.aperant', 'features');
+    const existing = existsSync(featuresDir) ? readFeatureArea(featuresDir) : new Map();
+    const new_components = [];
+    const unregistered = [];
+    for (const rawFile of diffFiles || []) {
+        const file = String(rawFile).replace(/\\/g, '/').replace(/^\.\//, '');
+        const kind = detectFeatureKind(file);
+        if (!kind)
+            continue;
+        const area = inferArea(file);
+        if (!area)
+            continue;
+        const entry = { file, kind, area };
+        new_components.push(entry);
+        const areaData = existing.get(area);
+        const components = Array.isArray(areaData?.components) ? areaData.components : null;
+        if (!components || !components.includes(file)) {
+            unregistered.push(entry);
+        }
+    }
+    // Group unregistered by area → one stub_patch per area.
+    const byArea = new Map();
+    for (const u of unregistered) {
+        if (!byArea.has(u.area))
+            byArea.set(u.area, []);
+        byArea.get(u.area).push(u);
+    }
+    const stub_patches = [];
+    for (const [area, entries] of byArea) {
+        const target = `.aperant/features/${area}.json`;
+        const existingAreaData = existing.get(area);
+        stub_patches.push({
+            target,
+            area,
+            add_components: entries.map((e) => e.file),
+            create_area: !existingAreaData,
+            kind: entries[0].kind, // representative kind for new-area stubs
+        });
+    }
+    return { new_components, unregistered, stub_patches };
+}
+/**
+ * Read each `<area>.json` under `.aperant/features/`. Skips REGISTRY.md and
+ * malformed files silently (best-effort — the audit should still run).
+ *
+ * @returns Map<area, { area, route?, components, p4_sub_features?, last_scanned?, kind? }>
+ */
+function readFeatureArea(featuresDir) {
+    const out = new Map();
+    let names;
+    try {
+        names = readdirSync(featuresDir);
+    }
+    catch {
+        return out;
+    }
+    for (const name of names) {
+        if (!name.endsWith('.json'))
+            continue;
+        try {
+            const data = JSON.parse(readFileSync(join(featuresDir, name), 'utf-8'));
+            const area = data?.area || basename(name, '.json');
+            out.set(area, data);
+        }
+        catch {
+            // malformed area file — skip
+        }
+    }
+    return out;
+}
+/**
+ * Apply stub patches from `auditFeatureRegistry`. Creates new area files when
+ * `create_area: true` and appends new components to existing area files
+ * otherwise. Updates REGISTRY.md's total row so the summary reflects the
+ * latest counts.
+ *
+ * @returns Array<{target, applied: boolean, reason?: string}>
+ */
+export function applyStubPatches(projectDir, stubPatches) {
+    const root = resolve(projectDir);
+    const featuresDir = join(root, '.aperant', 'features');
+    mkdirSync(featuresDir, { recursive: true });
+    const applied = [];
+    for (const patch of stubPatches) {
+        const absTarget = join(root, patch.target);
+        if (patch.create_area) {
+            const stub = {
+                area: patch.area,
+                route: null,
+                components: patch.add_components,
+                kind: patch.kind,
+                last_scanned: new Date().toISOString().slice(0, 10),
+                p4_sub_features: [],
+                auto_generated: true,
+            };
+            atomicWriteJson(absTarget, stub);
+            applied.push({ target: patch.target, applied: true, reason: 'created-new-area' });
+            continue;
+        }
+        // Append to existing area.
+        try {
+            const data = JSON.parse(readFileSync(absTarget, 'utf-8'));
+            const existing = Array.isArray(data.components) ? data.components : [];
+            const seen = new Set(existing);
+            let added = 0;
+            for (const f of patch.add_components) {
+                if (!seen.has(f)) {
+                    existing.push(f);
+                    seen.add(f);
+                    added += 1;
+                }
+            }
+            data.components = existing;
+            data.last_scanned = new Date().toISOString().slice(0, 10);
+            atomicWriteJson(absTarget, data);
+            applied.push({
+                target: patch.target,
+                applied: true,
+                reason: `appended ${added} component${added === 1 ? '' : 's'}`,
+            });
+        }
+        catch (err) {
+            applied.push({ target: patch.target, applied: false, reason: err.message });
+        }
+    }
+    // Touch REGISTRY.md — rewrite the TOTAL row to reflect new counts.
+    try {
+        refreshRegistryTotals(featuresDir);
+    }
+    catch {
+        // best-effort — a malformed REGISTRY.md shouldn't fail the whole audit.
+    }
+    return applied;
+}
+/**
+ * Best-effort REGISTRY.md refresher. Scans every `<area>.json`, computes total
+ * components count, and rewrites the `| **TOTAL** | ...` row if it exists.
+ *
+ * Intentionally narrow — we do NOT touch individual area rows (which carry
+ * manually curated metrics like "Wired %"). The spec says auto-update should
+ * "re-compute counts"; we treat the TOTAL row as the safe proxy.
+ */
+function refreshRegistryTotals(featuresDir) {
+    const regPath = join(featuresDir, 'REGISTRY.md');
+    if (!existsSync(regPath))
+        return;
+    const text = readFileSync(regPath, 'utf-8');
+    const totalComponents = tallyAllComponents(featuresDir);
+    const lines = text.split(/\r?\n/);
+    let rewrote = false;
+    for (let i = 0; i < lines.length; i++) {
+        if (/^\|\s*\*\*TOTAL\*\*\s*\|/.test(lines[i])) {
+            // Rewrite as a minimal diagnostic row — preserve the shape but update
+            // the leading count columns. We don't re-derive wired %.
+            lines[i] = `| **TOTAL** | | | **${totalComponents}** | | | | auto-refreshed |`;
+            rewrote = true;
+            break;
+        }
+    }
+    if (rewrote) {
+        writeFileSync(regPath, lines.join('\n'));
+    }
+}
+function tallyAllComponents(featuresDir) {
+    let count = 0;
+    for (const name of readdirSync(featuresDir)) {
+        if (!name.endsWith('.json'))
+            continue;
+        try {
+            const data = JSON.parse(readFileSync(join(featuresDir, name), 'utf-8'));
+            count += Array.isArray(data.components) ? data.components.length : 0;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=registry-audit.mjs.map

package/dist/cli/features/registry-audit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-audit.mjs","sourceRoot":"","sources":["../../../src/cli/features/registry-audit.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACzF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAQ;IACzC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAC1D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC9D,kEAAkE;IAClE,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACtD,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3C,kDAAkD;IAClD,IAAI,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,cAAc,CAAA;IAC9E,8DAA8D;IAC9D,IAAI,oDAAoD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,cAAc,CAAA;IAC1F,mFAAmF;IACnF,IAAI,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAA;IACnF,uDAAuD;IACvD,IAAI,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,aAAa,CAAA;IAC1F,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,QAAQ;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC9D,MAAM,CAAC,GAAG,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9D,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IAClB,IAAI,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAA;IACpE,IAAI,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAA;IACpE,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAA;IAC5D,IAAI,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACxE,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE;IAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAA;IAEnF,MAAM,cAAc,GAAG,EAAE,CAAA;IACzB,MAAM,YAAY,GAAG,EAAE,CAAA;IACvB,KAAK,MAAM,OAAO,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QACrE,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI;YAAE,SAAQ;QACnB,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QAClC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;QACnF,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC;IACF,CAAC;IAED,wDAAwD;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAE,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IACD,MAAM,YAAY,GAAG,EAAE,CAAA;IACvB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,qBAAqB,IAAI,OAAO,CAAA;QAC/C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC3C,YAAY,CAAC,IAAI,CAAC;YACjB,MAAM;YACN,IAAI;YACJ,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1C,WAAW,EAAE,CAAC,gBAAgB;YAC9B,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,yCAAyC;SAChE,CAAC,CAAA;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,CAAA;AACtD,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,WAAW;IACnC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,IAAI,KAAK,CAAA;IACT,IAAI,CAAC;QACJ,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,GAAG,CAAA;IACX,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;YACvE,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAClD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACpB,CAAC;QAAC,MAAM,CAAC;YACR,6BAA6B;QAC9B,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAU,EAAE,WAAW;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;IACtD,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,EAAE,CAAA;IAElB,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,KAAK,CAAC,cAAc;gBAChC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACnD,eAAe,EAAE,EAAE;gBACnB,cAAc,EAAE,IAAI;aACpB,CAAA;YACD,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAChC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAA;YACjF,SAAQ;QACT,CAAC;QACD,2BAA2B;QAC3B,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;YACtE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC9B,IAAI,KAAK,GAAG,CAAC,CAAA;YACb,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBAChB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;oBACX,KAAK,IAAI,CAAC,CAAA;gBACX,CAAC;YACF,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAA;YAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACzD,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAChC,OAAO,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,YAAY,KAAK,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;aAC9D,CAAC,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5E,CAAC;IACF,CAAC;IAED,mEAAmE;IACnE,IAAI,CAAC;QACJ,qBAAqB,CAAC,WAAW,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACR,wEAAwE;IACzE,CAAC;IAED,OAAO,OAAO,CAAA;AACf,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,WAAW;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;IAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAM;IAChC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3C,MAAM,eAAe,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACjC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,sEAAsE;YACtE,yDAAyD;YACzD,KAAK,CAAC,CAAC,CAAC,GAAG,uBAAuB,eAAe,6BAA6B,CAAA;YAC9E,OAAO,GAAG,IAAI,CAAA;YACd,MAAK;QACN,CAAC;IACF,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACb,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACzC,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAW;IACtC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;YACvE,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACrE,CAAC;QAAC,MAAM,CAAC;YACR,YAAY;QACb,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/cli/gate/cache.d.mts

@@ -0,0 +1,31 @@
+/**
+ * Read and return the entire cache map for a task directory. Returns an
+ * empty object when the cache file is missing or malformed (the caller
+ * treats every miss as a cache miss — no error, no throw).
+ *
+ * @internal
+ */
+export function readCache(taskDir: any): any;
+/**
+ * Persist a single gate verdict to the per-task cache file. Reads the
+ * existing file, splices the new entry in, and atomic-writes back.
+ *
+ * @internal
+ */
+export function writeCache(taskDir: any, gateId: any, key: any, verdict: any): void;
+/**
+ * Drop a single gate's entry from the cache (used by explicit invalidations).
+ * Silently no-ops when the cache or the entry is missing.
+ *
+ * @internal
+ */
+export function invalidateCache(taskDir: any, gateId: any): void;
+/**
+ * Compute a deterministic SHA-256 over {gate_id, inputs}. Inputs may be
+ * either already-described records `{path, size, mtime_ns, ...}` or raw
+ * path strings (gates return raw paths; we describe them here).
+ *
+ * @internal
+ */
+export function computeInputHash(gateId: any, inputs: any): string;
+//# sourceMappingURL=cache.d.mts.map

package/dist/cli/gate/cache.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.mts","sourceRoot":"","sources":["../../../src/cli/gate/cache.mjs"],"names":[],"mappings":"AAmCA;;;;;;GAMG;AACH,6CASC;AAED;;;;;GAKG;AACH,oFASC;AAED;;;;;GAKG;AACH,iEAMC;AAuCD;;;;;;GAMG;AACH,mEAMC"}

package/dist/cli/gate/cache.mjs

@@ -0,0 +1,130 @@
+/**
+ * @internal
+ * gate/cache.mjs — per-task gate result cache with input hashing (C2).
+ *
+ * Stored at .aperant/tasks/{task-id}/.gate-cache.json as:
+ *
+ *   {
+ *     "<gate_id>": {
+ *       "key":    "<sha256 of {gate_id, inputs[{path, mtime_ns, size, content_hash?}]}>",
+ *       "verdict": { status, reason, evidence?, inputs? },
+ *       "ts":     "<ISO timestamp>"
+ *     }
+ *   }
+ *
+ * Input hashing prefers (path, mtime_ns, size) for speed. When mtime is
+ * clamped to low resolution (some filesystems return only second precision,
+ * so a sub-second edit can be invisible), we fall back to a SHA-256 of the
+ * file contents via `content_hash`. The fallback fires when either:
+ *   - `APT_GATE_CACHE_CONTENT_HASH=1` is set (test-only full content mode), or
+ *   - the underlying platform reports 0 for the fs.Stats.mtimeNs field.
+ *
+ * Atomic writes via the shared atomicWriteJson helper — no partial state
+ * ever visible to a concurrent reader.
+ *
+ * Force overrides NEVER write cache entries (that contract is enforced in
+ * commands/gate.mjs, not here — this module only stores what it's asked to).
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWriteJson } from '../util/io.mjs';
+const CACHE_FILENAME = '.gate-cache.json';
+/**
+ * Read and return the entire cache map for a task directory. Returns an
+ * empty object when the cache file is missing or malformed (the caller
+ * treats every miss as a cache miss — no error, no throw).
+ *
+ * @internal
+ */
+export function readCache(taskDir) {
+    const path = join(taskDir, CACHE_FILENAME);
+    if (!existsSync(path))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Persist a single gate verdict to the per-task cache file. Reads the
+ * existing file, splices the new entry in, and atomic-writes back.
+ *
+ * @internal
+ */
+export function writeCache(taskDir, gateId, key, verdict) {
+    const path = join(taskDir, CACHE_FILENAME);
+    const existing = readCache(taskDir);
+    existing[gateId] = {
+        key,
+        verdict,
+        ts: new Date().toISOString(),
+    };
+    atomicWriteJson(path, existing);
+}
+/**
+ * Drop a single gate's entry from the cache (used by explicit invalidations).
+ * Silently no-ops when the cache or the entry is missing.
+ *
+ * @internal
+ */
+export function invalidateCache(taskDir, gateId) {
+    const path = join(taskDir, CACHE_FILENAME);
+    const existing = readCache(taskDir);
+    if (!(gateId in existing))
+        return;
+    delete existing[gateId];
+    atomicWriteJson(path, existing);
+}
+/**
+ * Describe an input file in a way that detects both coarse (path/size) and
+ * fine-grained (mtime or content-hash) changes. Returns null for paths that
+ * do not exist on disk (gates that read non-existent files — e.g. a missing
+ * spec.md — should still be cacheable, so we record a sentinel instead of
+ * skipping the input).
+ */
+function describeInput(path) {
+    try {
+        const st = statSync(path);
+        const descriptor = {
+            path,
+            size: st.size,
+            mtime_ns: typeof st.mtimeNs === 'bigint'
+                ? st.mtimeNs.toString()
+                : // Round to ns to avoid "1.71e21"-style exponent strings from floating
+                    // multiplication — the stable integer form stays stable under JSON.
+                    String(Math.round(st.mtimeMs * 1_000_000)),
+        };
+        const useContentHash = process.env.APT_GATE_CACHE_CONTENT_HASH === '1' ||
+            descriptor.mtime_ns === '0' ||
+            descriptor.mtime_ns === 'NaN';
+        if (useContentHash) {
+            try {
+                descriptor.content_hash = createHash('sha256').update(readFileSync(path)).digest('hex');
+            }
+            catch {
+                /* leave mtime_ns as the only signal */
+            }
+        }
+        return descriptor;
+    }
+    catch {
+        return { path, missing: true };
+    }
+}
+/**
+ * Compute a deterministic SHA-256 over {gate_id, inputs}. Inputs may be
+ * either already-described records `{path, size, mtime_ns, ...}` or raw
+ * path strings (gates return raw paths; we describe them here).
+ *
+ * @internal
+ */
+export function computeInputHash(gateId, inputs) {
+    const described = inputs.map((input) => typeof input === 'string' ? describeInput(input) : input);
+    const payload = JSON.stringify({ gate_id: gateId, inputs: described });
+    return createHash('sha256').update(payload).digest('hex');
+}
+//# sourceMappingURL=cache.mjs.map

package/dist/cli/gate/cache.mjs.map

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

package/dist/cli/gate/context.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Build a GateContext for the given task. Throws if the task directory does
+ * not exist — callers should catch and surface the "task not found" error as
+ * a CLI-level failure envelope.
+ *
+ * @internal
+ */
+export function buildGateContext(projectRoot: any, taskId: any): {
+    projectRoot: string;
+    sharedRoot: any;
+    taskId: string;
+    taskDir: string;
+    taskRecord: any;
+    config: {};
+};
+//# sourceMappingURL=context.d.mts.map

package/dist/cli/gate/context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","sourceRoot":"","sources":["../../../src/cli/gate/context.mjs"],"names":[],"mappings":"AAmCA;;;;;;GAMG;AACH;;;;;;;EAiDC"}

package/dist/cli/gate/context.mjs

@@ -0,0 +1,85 @@
+/**
+ * @internal
+ * gate/context.mjs — GateContext builder (C2).
+ *
+ * Gates receive a shared, cheap-to-build context object so they don't have to
+ * re-derive paths, task records, and config. The context carries:
+ *
+ *   {
+ *     projectRoot:  string,          // absolute caller cwd (may be worktree)
+ *     sharedRoot:   string,          // main repo root via CoordinationStore
+ *     taskId:       string,
+ *     taskDir:      string,          // <sharedRoot>/.aperant/tasks/<taskId>/
+ *     taskRecord:   object | null,   // state.active_tasks[taskId] (or null)
+ *     config:       object           // .aperant/config.json (empty {} if none)
+ *   }
+ *
+ * The builder is side-effect-free — it never writes state, never mutates the
+ * task record, never touches the event log.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { createCoordinationStore } from '../coordination/store.mjs';
+const SAFE_TASK_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
+function readJsonIfExists(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build a GateContext for the given task. Throws if the task directory does
+ * not exist — callers should catch and surface the "task not found" error as
+ * a CLI-level failure envelope.
+ *
+ * @internal
+ */
+export function buildGateContext(projectRoot, taskId) {
+    if (!taskId || typeof taskId !== 'string') {
+        throw new Error('buildGateContext: taskId is required');
+    }
+    if (!SAFE_TASK_ID_PATTERN.test(taskId)) {
+        const err = new Error(`invalid task id: ${taskId}`);
+        err.code = 'ETASKINVALID';
+        throw err;
+    }
+    const absRoot = resolve(projectRoot);
+    const store = createCoordinationStore(absRoot);
+    const sharedRoot = store.resolveSharedRoot();
+    const sharedTaskDir = join(sharedRoot, '.aperant', 'tasks', taskId);
+    const localTaskDir = join(absRoot, '.aperant', 'tasks', taskId);
+    const taskDir = existsSync(sharedTaskDir)
+        ? sharedTaskDir
+        : sharedRoot !== absRoot && existsSync(localTaskDir)
+            ? localTaskDir
+            : null;
+    if (!taskDir) {
+        const err = new Error(`task not found: ${taskId}`);
+        err.code = 'ETASKNOTFOUND';
+        throw err;
+    }
+    const state = store.readState();
+    const localState = sharedRoot !== absRoot ? readJsonIfExists(join(absRoot, '.aperant', 'state.json')) : null;
+    const taskRecord = state?.active_tasks?.[taskId] ?? localState?.active_tasks?.[taskId] ?? null;
+    let config = {};
+    const configPath = join(sharedRoot, '.aperant', 'config.json');
+    config = readJsonIfExists(configPath) ?? {};
+    if (sharedRoot !== absRoot &&
+        Object.keys(config).length === 0 &&
+        existsSync(join(absRoot, '.aperant', 'config.json'))) {
+        config = readJsonIfExists(join(absRoot, '.aperant', 'config.json')) ?? {};
+    }
+    return {
+        projectRoot: absRoot,
+        sharedRoot,
+        taskId,
+        taskDir,
+        taskRecord,
+        config,
+    };
+}
+//# sourceMappingURL=context.mjs.map

package/dist/cli/gate/context.mjs.map

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

package/dist/cli/gate/gates/all-subtasks-complete.d.mts

@@ -0,0 +1,21 @@
+export default gate;
+declare namespace gate {
+    let id: string;
+    let description: string;
+    let severity: string;
+    let skills: string[];
+    function check(ctx: any): Promise<{
+        status: string;
+        reason: string;
+        inputs: string[];
+        evidence?: undefined;
+    } | {
+        status: string;
+        reason: string;
+        evidence: {
+            incomplete: any;
+        };
+        inputs: string[];
+    }>;
+}
+//# sourceMappingURL=all-subtasks-complete.d.mts.map

package/dist/cli/gate/gates/all-subtasks-complete.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-subtasks-complete.d.mts","sourceRoot":"","sources":["../../../../src/cli/gate/gates/all-subtasks-complete.mjs"],"names":[],"mappings":";;;;;;IAkBC;;;;;;;;;;;;OAqCC"}

package/dist/cli/gate/gates/all-subtasks-complete.mjs

@@ -0,0 +1,59 @@
+/**
+ * @internal
+ * G3 all-subtasks-complete — blocking gate for `apt:verify`.
+ *
+ * Parses {task_dir}/implementation_plan.json and fails when any subtask's
+ * status is not the literal string "completed". A missing/malformed plan is
+ * also treated as a fail (the verifier cannot score what it cannot read).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { registerGate } from '../registry.mjs';
+const gate = {
+    id: 'all-subtasks-complete',
+    description: 'every subtask in implementation_plan.json has status === "completed"',
+    severity: 'blocking',
+    skills: ['verify'],
+    async check(ctx) {
+        const planPath = join(ctx.taskDir, 'implementation_plan.json');
+        const inputs = [planPath];
+        if (!existsSync(planPath)) {
+            return {
+                status: 'fail',
+                reason: `implementation_plan.json missing at ${planPath}`,
+                inputs,
+            };
+        }
+        let plan;
+        try {
+            plan = JSON.parse(readFileSync(planPath, 'utf-8'));
+        }
+        catch (err) {
+            return {
+                status: 'fail',
+                reason: `implementation_plan.json does not parse: ${err.message}`,
+                inputs,
+            };
+        }
+        const subtasks = Array.isArray(plan.subtasks) ? plan.subtasks : [];
+        const incomplete = subtasks.filter((s) => s?.status !== 'completed');
+        if (incomplete.length > 0) {
+            return {
+                status: 'fail',
+                reason: `${incomplete.length} subtask(s) not completed: ${incomplete
+                    .map((s) => `${s.id ?? '?'}(${s.status ?? 'unknown'})`)
+                    .join(', ')}`,
+                evidence: { incomplete: incomplete.map((s) => ({ id: s.id, status: s.status })) },
+                inputs,
+            };
+        }
+        return {
+            status: 'pass',
+            reason: `${subtasks.length} subtask(s) completed`,
+            inputs,
+        };
+    },
+};
+registerGate(gate);
+export default gate;
+//# sourceMappingURL=all-subtasks-complete.mjs.map

package/dist/cli/gate/gates/all-subtasks-complete.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"all-subtasks-complete.mjs","sourceRoot":"","sources":["../../../../src/cli/gate/gates/all-subtasks-complete.mjs"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,IAAI,GAAG;IACZ,EAAE,EAAE,uBAAuB;IAC3B,WAAW,EAAE,sEAAsE;IACnF,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,KAAK,CAAC,KAAK,CAAC,GAAG;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAA;QAC9D,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAA;QACzB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACN,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,uCAAuC,QAAQ,EAAE;gBACzD,MAAM;aACN,CAAA;QACF,CAAC;QACD,IAAI,IAAI,CAAA;QACR,IAAI,CAAC;YACJ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,OAAO;gBACN,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,4CAA4C,GAAG,CAAC,OAAO,EAAE;gBACjE,MAAM;aACN,CAAA;QACF,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;QAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,WAAW,CAAC,CAAA;QACpE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACN,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,8BAA8B,UAAU;qBAClE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,IAAI,SAAS,GAAG,CAAC;qBACtD,IAAI,CAAC,IAAI,CAAC,EAAE;gBACd,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE;gBACjF,MAAM;aACN,CAAA;QACF,CAAC;QACD,OAAO;YACN,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,uBAAuB;YACjD,MAAM;SACN,CAAA;IACF,CAAC;CACD,CAAA;AAED,YAAY,CAAC,IAAI,CAAC,CAAA;AAClB,eAAe,IAAI,CAAA"}