@poetics/cli 0.1.2 → 0.2.1

package/dist/change.d.ts

@@ -0,0 +1,18 @@
+import type { Scope } from "@poetics/store";
+export type ChangeFindingKind = "untracked" | "stale" | "orphaned" | "duplicate" | "rewritten-history" | "changed-rehash" | "deleted-unit" | "missing-lineage" | "no-links" | "unverified" | "callers-not-updated" | "repeated-rationale";
+export interface ChangeFinding {
+    severity: "error" | "warning";
+    kind: ChangeFindingKind;
+    file: string;
+    message: string;
+}
+export interface ChangeReport {
+    base: string;
+    changedCodeFiles: string[];
+    changedUnits: number;
+    findings: ChangeFinding[];
+}
+export declare function checkChange(root: string, since: string, scope: Scope & {
+    adapters?: readonly string[];
+}): Promise<ChangeReport>;
+//# sourceMappingURL=change.d.ts.map

package/dist/change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.d.ts","sourceRoot":"","sources":["../src/change.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAQ5C,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,OAAO,GACP,UAAU,GACV,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,iBAAiB,GACjB,UAAU,GACV,YAAY,GACZ,qBAAqB,GACrB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAgJrI"}

package/dist/change.js

@@ -0,0 +1,155 @@
+// The per-change check: did this commit, branch or working tree record its
+// code changes in .poetics/ properly? A day-one stand-in for the part of
+// `poetics verify` and the GitHub Action that review a diff.
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { createMatcher, extendsPrehistory, parseUnit, readUnitFiles, storePaths } from "@poetics/store";
+import { declarationsIn } from "./declarations.js";
+import { pluginsFor } from "./frameworks.js";
+import { DRIFT_SEVERITY, compareCodeWithStore } from "./drift.js";
+import { changesSince, showAt } from "./git.js";
+const PARSEABLE = /\.(ts|tsx|mts|cts)$/;
+export async function checkChange(root, since, scope) {
+    const plugins = pluginsFor(scope);
+    const { base, changes } = changesSince(root, since);
+    const inScope = createMatcher(scope.include, scope.exclude ?? []);
+    const changedPaths = new Set(changes.flatMap((c) => (c.from ? [c.path, c.from] : [c.path])));
+    const findings = [];
+    // 1. Code that changed must match the store.
+    const codeFiles = [...changedPaths].filter((path) => inScope(path) && PARSEABLE.test(path) && !path.endsWith(".d.ts")).sort();
+    const declarations = [];
+    for (const file of codeFiles) {
+        const text = await readFile(join(root, file), "utf8").catch(() => undefined);
+        if (text !== undefined)
+            declarations.push(...declarationsIn(file, text, plugins));
+    }
+    const paths = storePaths(root);
+    const units = (await readUnitFiles(paths)).map(parseUnit);
+    const covered = new Set(codeFiles);
+    for (const finding of compareCodeWithStore(declarations, units, (file) => covered.has(file)).findings) {
+        findings.push({ severity: DRIFT_SEVERITY[finding.kind], kind: finding.kind, file: finding.file, message: finding.message });
+    }
+    // 2. Unit files that changed must only append, and say why.
+    const unitChanges = changes.filter((c) => c.path.startsWith(".poetics/units/") && c.path.endsWith(".json"));
+    const newVersions = [];
+    for (const change of unitChanges) {
+        if (change.status === "D") {
+            findings.push({
+                severity: "error",
+                kind: "deleted-unit",
+                file: change.path,
+                message: `unit files are never deleted; restore it and append a "removed" version saying why the code went (ADR 0010)`,
+            });
+            continue;
+        }
+        const head = parseUnit({ path: join(root, change.path), relativePath: change.path, raw: await readFile(join(root, change.path), "utf8") });
+        const baseRaw = change.status === "A" ? undefined : showAt(root, base, change.from ?? change.path);
+        const before = baseRaw === undefined ? undefined : JSON.parse(baseRaw);
+        if (before) {
+            const kept = head.versions.slice(0, before.versions.length);
+            if (head.versions.length < before.versions.length || !isDeepStrictEqual(kept, before.versions)) {
+                findings.push({
+                    severity: "error",
+                    kind: "rewritten-history",
+                    file: change.path,
+                    message: `${head.name}: earlier versions were edited or removed; versions are append-only`,
+                });
+            }
+            // Prehistory is write-once: a later backfill may only reach further back, so what was there stays its tail.
+            const was = before.prehistory ?? [];
+            const now = head.prehistory ?? [];
+            if (!extendsPrehistory(was, now)) {
+                findings.push({
+                    severity: "error",
+                    kind: "rewritten-history",
+                    file: change.path,
+                    message: `${head.name}: recorded prehistory was edited or removed; it may only be extended further back`,
+                });
+            }
+            const moved = before.location.file !== head.location.file || before.name !== head.name;
+            if (moved && (head.lineage?.length ?? 0) <= (before.lineage?.length ?? 0)) {
+                findings.push({
+                    severity: "error",
+                    kind: "missing-lineage",
+                    file: change.path,
+                    message: `${head.name}: name or location changed (${before.name} in ${before.location.file}) without a lineage entry`,
+                });
+            }
+        }
+        for (const version of head.versions.slice(before?.versions.length ?? 0))
+            newVersions.push({ unit: head, file: change.path, version });
+    }
+    const rationaleCounts = new Map();
+    for (const { version } of newVersions)
+        rationaleCounts.set(version.rationale, (rationaleCounts.get(version.rationale) ?? 0) + 1);
+    const dependents = (uid) => units.filter((u) => Object.hasOwn(u.versions.at(-1)?.deps ?? {}, uid));
+    const versioned = new Set(newVersions.map(({ unit }) => unit.uid));
+    // Declarations of the files new rehash versions sit in, which need not be among the changed code files.
+    const declarationCache = new Map();
+    const declarationsOf = async (file) => {
+        if (!declarationCache.has(file)) {
+            const text = await readFile(join(root, file), "utf8").catch(() => undefined);
+            declarationCache.set(file, text === undefined ? [] : declarationsIn(file, text, plugins));
+        }
+        return declarationCache.get(file);
+    };
+    for (const { unit, file, version } of newVersions) {
+        // A rehash claims the code did not change: it must sit on the code's own provisional hash (ADR 0014).
+        if (version.change === "rehash" && version === unit.versions.at(-1)) {
+            const name = unit.location.export ?? unit.name;
+            const decl = (await declarationsOf(unit.location.file)).find((d) => d.name === name && (d.kind === "type") === (unit.kind === "type"));
+            if (decl && (decl.hash !== version.parent || decl.contentHash !== version.contentHash)) {
+                findings.push({
+                    severity: "error",
+                    kind: "changed-rehash",
+                    file,
+                    message: decl.hash !== version.parent
+                        ? `${unit.name}: rehash recorded, but the code changed since ${version.parent ?? "its parent"}; record a behaviour, interface or cosmetic version instead`
+                        : `${unit.name}: rehash contentHash ${version.contentHash} is not the code's ${decl.contentHash}`,
+                });
+            }
+        }
+        if (!version.links || version.links.length === 0) {
+            findings.push({ severity: "warning", kind: "no-links", file, message: `${unit.name}: new version cites no issue, task, decision or plan section` });
+        }
+        // Rehash rationale is the same for every unit by design.
+        if (version.change !== "rehash" && (rationaleCounts.get(version.rationale) ?? 0) >= 3) {
+            findings.push({
+                severity: "warning",
+                kind: "repeated-rationale",
+                file,
+                message: `${unit.name}: the same rationale is used for ${rationaleCounts.get(version.rationale)} units; say what changed for this one`,
+            });
+        }
+        if (version.change === "behaviour" || version.change === "interface") {
+            const tests = unit.tests ?? [];
+            if (tests.length === 0) {
+                findings.push({ severity: "warning", kind: "unverified", file, message: `${unit.name}: ${version.change} change but the unit has no linked tests` });
+            }
+            else if (!tests.some((test) => changedPaths.has(test.file))) {
+                findings.push({
+                    severity: "warning",
+                    kind: "unverified",
+                    file,
+                    message: `${unit.name}: ${version.change} change but none of its linked tests changed (${tests.map((t) => t.file).join(", ")})`,
+                });
+            }
+        }
+        // A removal breaks callers at least as surely as an interface change.
+        if (version.change === "interface" || version.change === "removed") {
+            for (const caller of dependents(unit.uid)) {
+                if (versioned.has(caller.uid))
+                    continue;
+                findings.push({
+                    severity: "warning",
+                    kind: "callers-not-updated",
+                    file,
+                    message: `${unit.name}: ${version.change === "removed" ? "removed" : "interface changed"} but its dependent ${caller.name} got no version`,
+                });
+            }
+        }
+    }
+    return { base, changedCodeFiles: codeFiles, changedUnits: unitChanges.length, findings };
+}
+//# sourceMappingURL=change.js.map

package/dist/change.js.map

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

package/dist/changes.d.ts

@@ -0,0 +1,4 @@
+import type { ChangeSet } from "@poetics/store";
+/** Renders a change set for a terminal: each commit's units with change class and rationale. */
+export declare function formatChanges(set: ChangeSet): string;
+//# sourceMappingURL=changes.d.ts.map

package/dist/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../src/changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,gBAAgB,CAAC;AAI5D,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CA4BpD"}

package/dist/changes.js

@@ -0,0 +1,38 @@
+const MARK = { added: "+", changed: "~", removed: "-" };
+/** Renders a change set for a terminal: each commit's units with change class and rationale. */
+export function formatChanges(set) {
+    const units = set.commits.reduce((n, commit) => n + commit.units.length, 0);
+    const lines = [`Changes from ${short(set.from)} to ${short(set.to)}: ${set.commits.length} commit(s), ${units} unit change(s)`];
+    for (const commit of set.commits) {
+        lines.push("", `${short(commit.commit)} ${commit.subject}`);
+        for (const unit of commit.units) {
+            const classes = unit.versions.map((v) => v.change).join(", ");
+            lines.push(`  ${MARK[unit.status]} ${unit.name} (${unit.kind}, ${unit.file})${classes ? ` ${classes}` : ""}`);
+            for (const entry of unit.lineage) {
+                lines.push(`      ${entry.kind}${entry.from ? ` from ${entry.from}` : ""}${entry.uids ? ` with ${entry.uids.join(", ")}` : ""}`);
+            }
+            for (const version of unit.versions) {
+                lines.push(`      ${version.rationale}`);
+                const links = (version.links ?? []).map((link) => (typeof link === "string" ? link : link.url ?? link.ref));
+                if (links.length > 0)
+                    lines.push(`      links: ${links.join(", ")}`);
+            }
+            if (unit.status === "removed" && unit.versions.length === 0)
+                lines.push("      unit file deleted; no rationale recorded");
+        }
+    }
+    if (set.unrecorded.length > 0) {
+        lines.push("", "Commits that recorded no unit change:");
+        for (const commit of set.unrecorded)
+            lines.push(`  ${short(commit.commit)} ${commit.subject}`);
+    }
+    if (set.decisions.length > 0)
+        lines.push("", `Decisions: ${set.decisions.join(", ")}`);
+    if (set.notes.length > 0)
+        lines.push("", `Notes: ${set.notes.join(", ")}`);
+    return lines.join("\n");
+}
+function short(ref) {
+    return /^[0-9a-f]{40}$/.test(ref) ? ref.slice(0, 7) : ref;
+}
+//# sourceMappingURL=changes.js.map

package/dist/changes.js.map

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

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAU1C,CAAC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,EAAE,SAAS,WAAW,EAc1C,CAAC"}

package/dist/commands.js

@@ -1,13 +1,17 @@
 /** The CLI surface from docs/plan.md, "Developer workflow and tooling". */
 export const COMMANDS = [
-    { name: "init", usage: "poetics init [--agents]", summary: "Detect React and Svelte, write config, index the repo and backfill history from git" },
-    { name: "index", usage: "poetics index", summary: "Incremental re-index of changed files; run by the git hook" },
+    { name: "init", usage: "poetics init [--write] [--agents]", summary: "Adopt Poetics: detect React and Svelte, write config, and create units with a snapshot backfill; a dry run without --write. --agents is planned" },
+    { name: "backfill", usage: "poetics backfill --snapshot [--write] | --history [<from>] [<to>] [--include-removed] [--write]", summary: "Create units for code with none (--snapshot), or reconstruct each unit's history before it was recorded (--history, over the first-parent commits after <from> up to <to>; --include-removed also recovers exports deleted before they were recorded), rationale inferred from the repository's own evidence (ADR 0011); a dry run without --write" },
+    { name: "index", usage: "poetics index [--since <ref>] [--write] [--rationale <text>] [--agent <tool> [--model <id>]]", summary: "Record what changed in the code since a ref: versions, moves and renames with lineage, new and removed units, test links to renamed test files; a dry run without --write" },
     { name: "log", usage: "poetics log <unit>", summary: "Version history of one unit, with rationale and commits" },
     { name: "why", usage: "poetics why <unit>", summary: "The rationale chain that led to the current version" },
+    { name: "changes", usage: "poetics changes [from] [to] [--impact]", summary: "Every recorded change between two refs and why, grouped by commit, removals included" },
     { name: "impact", usage: "poetics impact [ref]", summary: "Components whose closure changed since a branch or commit" },
     { name: "diff", usage: "poetics diff <unit> <a> <b>", summary: "Semantic diff between two versions of a unit" },
     { name: "verify", usage: "poetics verify [--since <ref>]", summary: "List unverified units, stale docs and unresolved edges, and unrecorded changes since a ref; non-zero exit for CI" },
     { name: "coverage", usage: "poetics coverage", summary: "How much of the codebase .poetics/ covers, against policy thresholds" },
+    { name: "hash", usage: "poetics hash <file>[#name]", summary: "The indexer's content and interface hashes for the units in a file, for recording a version" },
+    { name: "rehash", usage: "poetics rehash [--write] [--agent <tool> [--model <id>]]", summary: "Replace provisional git: hashes with b3: ones by appending rehash versions (ADR 0014); a dry run without --write" },
     { name: "docs", usage: "poetics docs sync", summary: "Write stored docs into TSDoc and @component comments" },
 ];
 //# sourceMappingURL=commands.js.map

package/dist/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,qFAAqF,EAAE;IAClJ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,4DAA4D,EAAE;IAChH,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,yDAAyD,EAAE;IAChH,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,qDAAqD,EAAE;IAC5G,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,2DAA2D,EAAE;IACvH,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,8CAA8C,EAAE;IAC/G,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gCAAgC,EAAE,OAAO,EAAE,kHAAkH,EAAE;IACxL,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,sEAAsE,EAAE;IAChI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,sDAAsD,EAAE;CAC9G,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mCAAmC,EAAE,OAAO,EAAE,iJAAiJ,EAAE;IACxN,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iGAAiG,EAAE,OAAO,EAAE,oVAAoV,EAAE;IAC7d,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,8FAA8F,EAAE,OAAO,EAAE,2KAA2K,EAAE;IAC9S,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,yDAAyD,EAAE;IAChH,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,qDAAqD,EAAE;IAC5G,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,wCAAwC,EAAE,OAAO,EAAE,sFAAsF,EAAE;IACrK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,2DAA2D,EAAE;IACvH,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,8CAA8C,EAAE;IAC/G,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gCAAgC,EAAE,OAAO,EAAE,kHAAkH,EAAE;IACxL,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,sEAAsE,EAAE;IAChI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,4BAA4B,EAAE,OAAO,EAAE,6FAA6F,EAAE;IAC7J,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,0DAA0D,EAAE,OAAO,EAAE,kHAAkH,EAAE;IAClN,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,sDAAsD,EAAE;CAC9G,CAAC"}

package/dist/coverage.d.ts

@@ -0,0 +1,39 @@
+import type { Note, Unit } from "@poetics/core";
+import type { CoverageThresholds } from "@poetics/store";
+import type { Declaration } from "./declarations.ts";
+export interface Ratio {
+    covered: number;
+    total: number;
+    /** covered / total, or 1 when there is nothing to cover. */
+    ratio: number;
+}
+export interface CoverageMetrics {
+    tracked: Ratio;
+    fresh: Ratio;
+    linkedRationale: Ratio;
+    reviewed: Ratio;
+    tested: Ratio;
+    documented: Ratio;
+}
+export interface CoverageReport {
+    overall: CoverageMetrics;
+    /** Keyed by area: `packages/<name>` or the top-level folder. */
+    byArea: Record<string, CoverageMetrics>;
+    notes: {
+        active: number;
+        withCheck: number;
+        retired: number;
+    };
+    unsupportedFiles: string[];
+    failures: Array<{
+        metric: keyof CoverageMetrics;
+        ratio: number;
+        threshold: number;
+    }>;
+}
+export declare const METRICS: ReadonlyArray<readonly [keyof CoverageMetrics, string]>;
+export declare function areaOf(file: string): string;
+export declare function computeCoverage(declarations: readonly Declaration[], units: readonly Unit[], notes: readonly Note[], scanned: ReadonlySet<string>, unsupportedFiles: readonly string[], thresholds?: CoverageThresholds): CoverageReport;
+export declare function formatCoverage(report: CoverageReport): string;
+export declare function coverageFor(root: string): Promise<CoverageReport>;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../src/coverage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,EAAE,KAAK,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,eAAe,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,eAAO,MAAM,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,eAAe,EAAE,MAAM,CAAC,CAO3E,CAAC;AAIF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3C;AAiBD,wBAAgB,eAAe,CAC7B,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,UAAU,GAAE,kBAAuB,GAClC,cAAc,CA6BhB;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAe7D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQvE"}

package/dist/coverage.js

@@ -0,0 +1,88 @@
+// How well Poetics covers a codebase: tracked and fresh units, and the quality
+// of what is recorded about them.
+import { isRemoved } from "@poetics/core";
+import { filesInScope, parseNote, parseUnit, readConfig, readNoteFiles, readUnitFiles, storePaths } from "@poetics/store";
+import { discoverDeclarations } from "./declarations.js";
+import { compareCodeWithStore } from "./drift.js";
+export const METRICS = [
+    ["tracked", "Exports with a unit"],
+    ["fresh", "Units matching their code"],
+    ["linkedRationale", "Versions citing a source"],
+    ["reviewed", "Agent versions reviewed"],
+    ["tested", "Units with linked tests"],
+    ["documented", "Units with docs"],
+];
+const ratio = (covered, total) => ({ covered, total, ratio: total === 0 ? 1 : covered / total });
+export function areaOf(file) {
+    const parts = file.split("/");
+    return parts[0] === "packages" && parts.length > 2 ? `packages/${parts[1]}` : parts[0];
+}
+function metricsFor(declarations, units, covers) {
+    const drift = compareCodeWithStore(declarations, units, covers);
+    const tracked = units.filter((unit) => !isRemoved(unit) && covers(unit.location.file));
+    const versions = tracked.flatMap((unit) => unit.versions);
+    const agentVersions = versions.filter((v) => v.actor.kind === "agent");
+    return {
+        tracked: ratio(drift.tracked, drift.declarations),
+        fresh: ratio(drift.fresh, drift.tracked),
+        linkedRationale: ratio(versions.filter((v) => (v.links?.length ?? 0) > 0).length, versions.length),
+        reviewed: ratio(agentVersions.filter((v) => v.actor.kind === "agent" && v.actor.reviewed).length, agentVersions.length),
+        tested: ratio(tracked.filter((unit) => (unit.tests?.length ?? 0) > 0).length, tracked.length),
+        documented: ratio(tracked.filter((unit) => (unit.docs ?? "").trim() !== "").length, tracked.length),
+    };
+}
+export function computeCoverage(declarations, units, notes, scanned, unsupportedFiles, thresholds = {}) {
+    const covers = (file) => scanned.has(file);
+    const overall = metricsFor(declarations, units, covers);
+    const areas = new Set([...scanned].map(areaOf));
+    const byArea = {};
+    for (const area of [...areas].sort()) {
+        const inArea = (file) => covers(file) && areaOf(file) === area;
+        byArea[area] = metricsFor(declarations.filter((d) => inArea(d.file)), units.filter((u) => inArea(u.location.file)), inArea);
+    }
+    const failures = METRICS.flatMap(([metric]) => {
+        const threshold = thresholds[metric];
+        const value = overall[metric].ratio;
+        return threshold !== undefined && value < threshold ? [{ metric, ratio: value, threshold }] : [];
+    });
+    return {
+        overall,
+        byArea,
+        notes: {
+            active: notes.filter((n) => n.status === "active").length,
+            withCheck: notes.filter((n) => n.status === "active" && n.check !== undefined).length,
+            retired: notes.filter((n) => n.status !== "active").length,
+        },
+        unsupportedFiles: [...unsupportedFiles],
+        failures,
+    };
+}
+const pct = (r) => (r.total === 0 ? "—" : `${Math.floor(r.ratio * 1000) / 10}%`).padStart(6);
+export function formatCoverage(report) {
+    const areas = Object.keys(report.byArea);
+    const header = ["Metric".padEnd(28), "Overall".padStart(16), ...areas.map((a) => a.padStart(Math.max(a.length, 8)))].join("  ");
+    const rows = METRICS.map(([metric, label]) => {
+        const overall = report.overall[metric];
+        return [
+            label.padEnd(28),
+            `${pct(overall)} ${`(${overall.covered}/${overall.total})`.padStart(9)}`,
+            ...areas.map((a) => pct(report.byArea[a][metric]).padStart(Math.max(a.length, 8))),
+        ].join("  ");
+    });
+    const lines = [header, ...rows, "", `Notes: ${report.notes.active} active (${report.notes.withCheck} with a check), ${report.notes.retired} retired.`];
+    if (report.unsupportedFiles.length > 0)
+        lines.push(`Not yet indexable: ${report.unsupportedFiles.length} file(s) (e.g. ${report.unsupportedFiles[0]}).`);
+    for (const f of report.failures)
+        lines.push(`Below threshold: ${f.metric} ${(f.ratio * 100).toFixed(1)}% < ${(f.threshold * 100).toFixed(1)}%`);
+    return lines.join("\n");
+}
+export async function coverageFor(root) {
+    const config = await readConfig(root);
+    const paths = storePaths(root);
+    const { declarations, unsupported } = await discoverDeclarations(root, config);
+    const { parseable } = await filesInScope(root, config);
+    const units = (await readUnitFiles(paths)).map(parseUnit);
+    const notes = (await readNoteFiles(paths)).map(parseNote);
+    return computeCoverage(declarations, units, notes, new Set(parseable), unsupported, config.policy?.coverage);
+}
+//# sourceMappingURL=coverage.js.map

package/dist/coverage.js.map

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

package/dist/declarations.d.ts

@@ -0,0 +1,26 @@
+import type { Hash, UnitKind } from "@poetics/core";
+import type { Scope } from "@poetics/store";
+import type { FrameworkPlugin } from "@poetics/adapter-typescript";
+export interface Declaration {
+    /** Repo-relative POSIX path. */
+    file: string;
+    name: string;
+    kind: UnitKind;
+    /** Provisional hash of the declaration text, from `export` to its end, without leading TSDoc. */
+    hash: Hash;
+    /** The indexer's hash of the normalised syntax tree, which ignores formatting and comments (ADR 0014). */
+    contentHash: Hash;
+    /** 1-based, inclusive. */
+    startLine: number;
+    endLine: number;
+}
+/** The units the TypeScript indexer detects in one source text: exported functions, hooks and types. */
+export declare function declarationsIn(file: string, text: string, plugins?: readonly FrameworkPlugin[]): Declaration[];
+/** Every tracked-shape declaration in scope. */
+export declare function discoverDeclarations(root: string, scope: Scope & {
+    adapters?: readonly string[];
+}): Promise<{
+    declarations: Declaration[];
+    unsupported: string[];
+}>;
+//# sourceMappingURL=declarations.d.ts.map

package/dist/declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,iGAAiG;IACjG,IAAI,EAAE,IAAI,CAAC;IACX,0GAA0G;IAC1G,WAAW,EAAE,IAAI,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,eAAe,EAAO,GAAG,WAAW,EAAE,CAWlH;AAED,gDAAgD;AAChD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,WAAW,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAMzK"}

package/dist/declarations.js

@@ -0,0 +1,34 @@
+// Finds the declarations Poetics tracks as units, with both hashes a version may
+// carry: the provisional git: hash of the text, which history recorded before
+// the rehash, and the indexer's b3: content hash. Both are syntactic, so this
+// needs no type checker.
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import ts from "typescript";
+import { contentTree, detectUnits } from "@poetics/adapter-typescript";
+import { contentHash, gitBlobHash } from "@poetics/core";
+import { filesInScope } from "@poetics/store";
+import { pluginsFor } from "./frameworks.js";
+/** The units the TypeScript indexer detects in one source text: exported functions, hooks and types. */
+export function declarationsIn(file, text, plugins = []) {
+    const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
+    return detectUnits(source, file, plugins).map((unit) => ({
+        file,
+        name: unit.name,
+        kind: unit.kind,
+        hash: gitBlobHash(text.slice(unit.span.start, unit.span.end)),
+        contentHash: contentHash(contentTree(unit)),
+        startLine: source.getLineAndCharacterOfPosition(unit.span.start).line + 1,
+        endLine: source.getLineAndCharacterOfPosition(unit.span.end).line + 1,
+    }));
+}
+/** Every tracked-shape declaration in scope. */
+export async function discoverDeclarations(root, scope) {
+    const { parseable, unsupported } = await filesInScope(root, scope);
+    const declarations = [];
+    const plugins = pluginsFor(scope);
+    for (const file of parseable)
+        declarations.push(...declarationsIn(file, await readFile(join(root, file), "utf8"), plugins));
+    return { declarations, unsupported };
+}
+//# sourceMappingURL=declarations.js.map

package/dist/declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../src/declarations.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8EAA8E;AAC9E,8EAA8E;AAC9E,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgB7C,wGAAwG;AACxG,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAY,EAAE,UAAsC,EAAE;IACjG,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7E,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3C,SAAS,EAAE,MAAM,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;QACzE,OAAO,EAAE,MAAM,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;KACtE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAA+C;IACtG,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnE,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,SAAS;QAAE,YAAY,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5H,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AACvC,CAAC"}

package/dist/drift.d.ts

@@ -0,0 +1,29 @@
+import type { Unit } from "@poetics/core";
+import type { Declaration } from "./declarations.ts";
+export type DriftKind = "untracked" | "stale" | "orphaned" | "duplicate";
+export interface DriftFinding {
+    kind: DriftKind;
+    file: string;
+    name: string;
+    uid?: string;
+    message: string;
+}
+export interface Drift {
+    findings: DriftFinding[];
+    /** Declarations that have a unit (fresh or not). */
+    tracked: number;
+    /** Tracked units whose latest version matches the code. */
+    fresh: number;
+    declarations: number;
+}
+export declare const DRIFT_SEVERITY: Record<DriftKind, "error" | "warning">;
+/**
+ * Matches declarations to units by file and name (lineage keeps these current
+ * across renames and moves). Only units whose file satisfies `covers` can be
+ * orphaned: pass the set of files that were scanned, so units for files outside
+ * the scan (or that the parser cannot read yet, like .svelte) are left alone.
+ * Removed units are history, not code, so they never match: an export that
+ * reappears under a removed unit's name gets a new unit.
+ */
+export declare function compareCodeWithStore(declarations: readonly Declaration[], units: readonly Unit[], covers: (file: string) => boolean): Drift;
+//# sourceMappingURL=drift.d.ts.map

package/dist/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../src/drift.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAKjE,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAChC,KAAK,CAgEP"}