ctxr-cli 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { realEnv } from './core/env.js';
+import { run } from './run.js';
+const exitCode = await run(process.argv.slice(2), realEnv());
+process.exitCode = exitCode;
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7D,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/dist/commands/adapters-generate.d.ts

@@ -0,0 +1,23 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface AdaptersGenerateFileResult {
+    path: string;
+    changed: boolean;
+}
+export interface AdaptersGenerateData {
+    files: AdaptersGenerateFileResult[];
+}
+/**
+ * adapters spec / task 8.3-8.4: every configured harness-generation adapter
+ * gets its entry file's fenced region (re)written from `render()`, and,
+ * for a harness that supports it, its permission config merged in; every
+ * configured identity-injection adapter gets its own, separately-removable
+ * fenced region in whatever file it targets. Two adapters targeting the
+ * same physical file (the common case: one harness's own entry file) never
+ * collide, because each owns a distinctly-named fence.
+ */
+/** The generation itself, shared with `ctxr update`. */
+export declare function generateAdapterOutputs(store: Store): Promise<AdaptersGenerateFileResult[]>;
+export declare function execute(store: Store): Promise<CommandOutcome<AdaptersGenerateData>>;
+//# sourceMappingURL=adapters-generate.d.ts.map

package/dist/commands/adapters-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters-generate.d.ts","sourceRoot":"","sources":["../../src/commands/adapters-generate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC;AAUD;;;;;;;;GAQG;AACH,wDAAwD;AACxD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAoChG;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAWzF"}

package/dist/commands/adapters-generate.js

@@ -0,0 +1,59 @@
+import path from 'node:path';
+import { configuredAdapters } from '../adapters/registry.js';
+import { agentsMdPath } from '../core/agents-doc.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { upsertFencedRegionInFile } from '../core/fs/fenced-region.js';
+import { identityFilePaths } from '../core/identity.js';
+import { mergeJsonArrayLists } from '../core/json-config-merge.js';
+import { htmlCommentFence } from '../core/markers.js';
+export const requires = { store: 'required' };
+function harnessEntryFence(adapterId) {
+    return htmlCommentFence(`adapter:${adapterId}:harness-entry`);
+}
+function identityInjectionFence(adapterId) {
+    return htmlCommentFence(`adapter:${adapterId}:identity`);
+}
+/**
+ * adapters spec / task 8.3-8.4: every configured harness-generation adapter
+ * gets its entry file's fenced region (re)written from `render()`, and,
+ * for a harness that supports it, its permission config merged in; every
+ * configured identity-injection adapter gets its own, separately-removable
+ * fenced region in whatever file it targets. Two adapters targeting the
+ * same physical file (the common case: one harness's own entry file) never
+ * collide, because each owns a distinctly-named fence.
+ */
+/** The generation itself, shared with `ctxr update`. */
+export async function generateAdapterOutputs(store) {
+    const files = [];
+    for (const adapter of configuredAdapters(store.config, 'harness-generation')) {
+        const entryPath = path.join(store.root, adapter.entryFileName);
+        const { changed } = await upsertFencedRegionInFile(entryPath, harnessEntryFence(adapter.id), adapter.render(agentsMdPath(store.root)));
+        files.push({ path: adapter.entryFileName, changed });
+        if (adapter.permissionConfig) {
+            const permPath = path.join(store.root, adapter.permissionConfig.path);
+            const rules = adapter.permissionConfig.render({ worktreesPath: store.config.session.worktrees_path });
+            const { changed: permChanged } = await mergeJsonArrayLists(permPath, rules);
+            files.push({ path: adapter.permissionConfig.path, changed: permChanged });
+        }
+    }
+    const identityPaths = identityFilePaths(store.config);
+    for (const adapter of configuredAdapters(store.config, 'identity-injection')) {
+        const entryPath = path.join(store.root, adapter.entryFileName);
+        const { changed } = await upsertFencedRegionInFile(entryPath, identityInjectionFence(adapter.id), adapter.render(identityPaths));
+        files.push({ path: adapter.entryFileName, changed });
+    }
+    return files;
+}
+export async function execute(store) {
+    const files = await generateAdapterOutputs(store);
+    const changedCount = files.filter((f) => f.changed).length;
+    return {
+        exitCode: ExitCode.Ok,
+        data: { files },
+        findings: [],
+        humanSummary: `adapters generate: ${changedCount} file(s) changed, ${files.length - changedCount} already up to date.`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=adapters-generate.js.map

package/dist/commands/adapters-generate.js.map

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

package/dist/commands/archive.d.ts

@@ -0,0 +1,28 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface ArchiveFlags {
+    path: string;
+}
+export interface ArchiveData {
+    path: string;
+    newPath: string;
+    linkingNotes: string[];
+}
+/**
+ * context-organize spec: archiving is a single tracked rename (via
+ * core/git/repo.ts's movePath, the Phase 1.5 primitive) — never a
+ * read+delete+rewrite — so the note's frontmatter (including its
+ * visibility field) is untouched by construction, and `git log --follow`
+ * on the new path returns its full prior history. The destination lives
+ * under `organize.archive_path`, independent of taxonomy layer names, so
+ * this works identically under any configured taxonomy (task 7.1).
+ *
+ * Wikilinks resolve by filename stem (context-retrieval spec), and archive
+ * never changes a note's filename — only its directory — so no other
+ * note's link actually breaks. `linkingNotes` is reported purely so the
+ * operator is aware those notes now point at the archived location.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: ArchiveFlags): Promise<CommandOutcome<ArchiveData>>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/commands/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAM7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CA0ClH"}

package/dist/commands/archive.js

@@ -0,0 +1,66 @@
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { ArchiveDestinationExistsError, NoteNotFoundError, NoteNotTrackedError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { isTracked, movePath } from '../core/git/repo.js';
+import { extractLinkTargets } from '../core/graph/model.js';
+import { listNotes } from '../core/notes/list.js';
+export const requires = { store: 'required' };
+function toStoreRelativePath(env, store, givenPath) {
+    const absolute = path.isAbsolute(givenPath) ? givenPath : path.resolve(env.cwd, givenPath);
+    return path.relative(store.root, absolute).split(path.sep).join('/');
+}
+/**
+ * context-organize spec: archiving is a single tracked rename (via
+ * core/git/repo.ts's movePath, the Phase 1.5 primitive) — never a
+ * read+delete+rewrite — so the note's frontmatter (including its
+ * visibility field) is untouched by construction, and `git log --follow`
+ * on the new path returns its full prior history. The destination lives
+ * under `organize.archive_path`, independent of taxonomy layer names, so
+ * this works identically under any configured taxonomy (task 7.1).
+ *
+ * Wikilinks resolve by filename stem (context-retrieval spec), and archive
+ * never changes a note's filename — only its directory — so no other
+ * note's link actually breaks. `linkingNotes` is reported purely so the
+ * operator is aware those notes now point at the archived location.
+ */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.path);
+    const absolutePath = path.join(store.root, relativePath);
+    if (!existsSync(absolutePath))
+        throw new NoteNotFoundError(relativePath);
+    const stem = path.basename(relativePath, '.md');
+    const newRelativePath = path
+        .join(store.config.organize.archive_path, path.basename(relativePath))
+        .split(path.sep)
+        .join('/');
+    const newAbsolutePath = path.join(store.root, newRelativePath);
+    if (newRelativePath !== relativePath && existsSync(newAbsolutePath)) {
+        throw new ArchiveDestinationExistsError(newRelativePath);
+    }
+    const notes = await listNotes(store.root, store.config);
+    const linkingNotes = notes
+        .filter((note) => note.path !== relativePath)
+        .filter((note) => extractLinkTargets(note.body).includes(stem))
+        .map((note) => note.path)
+        .sort();
+    if (newRelativePath !== relativePath) {
+        if (!(await isTracked(env.git, store.root, relativePath))) {
+            throw new NoteNotTrackedError(relativePath);
+        }
+        await mkdir(path.dirname(newAbsolutePath), { recursive: true });
+        await movePath(env.git, store.root, relativePath, newRelativePath);
+    }
+    return {
+        exitCode: ExitCode.Ok,
+        data: { path: relativePath, newPath: newRelativePath, linkingNotes },
+        findings: [],
+        humanSummary: newRelativePath === relativePath
+            ? `"${relativePath}" is already archived.`
+            : `Archived "${relativePath}" to "${newRelativePath}"${linkingNotes.length > 0 ? ` (${linkingNotes.length} note(s) link to it)` : ''}.`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

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

package/dist/commands/catalog-build.d.ts

@@ -0,0 +1,7 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import { type CatalogBuildResult } from '../core/catalog/build.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export type CatalogBuildData = CatalogBuildResult;
+export declare function execute(store: Store): Promise<CommandOutcome<CatalogBuildData>>;
+//# sourceMappingURL=catalog-build.d.ts.map

package/dist/commands/catalog-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-build.d.ts","sourceRoot":"","sources":["../../src/commands/catalog-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAElD,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAUrF"}

package/dist/commands/catalog-build.js

@@ -0,0 +1,15 @@
+import { buildCatalog } from '../core/catalog/build.js';
+import { ExitCode } from '../core/exit-codes.js';
+export const requires = { store: 'required' };
+export async function execute(store) {
+    const result = await buildCatalog(store);
+    return {
+        exitCode: ExitCode.Ok,
+        data: result,
+        findings: [],
+        humanSummary: `Catalog built: ${result.totalNotes} note(s) across ${result.sections.length} section(s).`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=catalog-build.js.map

package/dist/commands/catalog-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-build.js","sourceRoot":"","sources":["../../src/commands/catalog-build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAA2B,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAI/D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY;IACxC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,kBAAkB,MAAM,CAAC,UAAU,mBAAmB,MAAM,CAAC,QAAQ,CAAC,MAAM,cAAc;QACxG,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/catalog-check.d.ts

@@ -0,0 +1,22 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import { type CatalogStaleEntry } from '../core/catalog/build.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface CatalogCheckFlags {
+    stale?: boolean;
+}
+export interface CatalogCheckData {
+    missing: string[];
+    dangling: string[];
+    stale?: CatalogStaleEntry[];
+}
+/**
+ * context-catalog spec: coverage is a hard invariant in both directions —
+ * this exits non-zero if any retrievable note lacks an entry (missing) OR
+ * any entry references a note that no longer exists (dangling, e.g.
+ * deleted). Staleness (--stale) is a review prompt, not a coverage
+ * violation, so it's reported but never fails the exit code on its own —
+ * the same doctor/lint severity split applied elsewhere in this codebase.
+ */
+export declare function execute(store: Store, flags: CatalogCheckFlags): Promise<CommandOutcome<CatalogCheckData>>;
+//# sourceMappingURL=catalog-check.d.ts.map

package/dist/commands/catalog-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-check.d.ts","sourceRoot":"","sources":["../../src/commands/catalog-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAA2C,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG3G,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAwC/G"}

package/dist/commands/catalog-check.js

@@ -0,0 +1,49 @@
+import { checkCatalogCoverage, checkCatalogStale } from '../core/catalog/build.js';
+import { ExitCode } from '../core/exit-codes.js';
+export const requires = { store: 'required' };
+/**
+ * context-catalog spec: coverage is a hard invariant in both directions —
+ * this exits non-zero if any retrievable note lacks an entry (missing) OR
+ * any entry references a note that no longer exists (dangling, e.g.
+ * deleted). Staleness (--stale) is a review prompt, not a coverage
+ * violation, so it's reported but never fails the exit code on its own —
+ * the same doctor/lint severity split applied elsewhere in this codebase.
+ */
+export async function execute(store, flags) {
+    const { missing, dangling } = await checkCatalogCoverage(store);
+    const stale = flags.stale ? await checkCatalogStale(store) : undefined;
+    const findings = [
+        ...missing.map((notePath) => ({
+            code: 'catalog.coverage.missing',
+            severity: 'error',
+            message: `"${notePath}" is retrievable but has no catalog entry.`,
+            subject: notePath,
+        })),
+        ...dangling.map((notePath) => ({
+            code: 'catalog.coverage.dangling',
+            severity: 'error',
+            message: `A catalog entry references "${notePath}", which no longer exists.`,
+            subject: notePath,
+        })),
+    ];
+    if (stale) {
+        findings.push(...stale.map((entry) => ({
+            code: 'catalog.stale',
+            severity: 'warning',
+            message: `"${entry.path}" in section "${entry.section}" has changed since its gloss was last confirmed.`,
+            subject: entry.path,
+        })));
+    }
+    const failed = missing.length > 0 || dangling.length > 0;
+    return {
+        exitCode: failed ? ExitCode.CheckFailed : ExitCode.Ok,
+        data: { missing, dangling, stale },
+        findings,
+        humanSummary: failed
+            ? `${missing.length} missing, ${dangling.length} dangling catalog entr(y/ies).`
+            : `Catalog coverage is complete.${stale ? ` ${stale.length} entr(y/ies) may need gloss review.` : ''}`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=catalog-check.js.map

package/dist/commands/catalog-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-check.js","sourceRoot":"","sources":["../../src/commands/catalog-check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAA0B,MAAM,0BAA0B,CAAC;AAE3G,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAY/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,KAAwB;IAClE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvE,MAAM,QAAQ,GAAc;QAC1B,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,OAAgB;YAC1B,OAAO,EAAE,IAAI,QAAQ,4CAA4C;YACjE,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,2BAA2B;YACjC,QAAQ,EAAE,OAAgB;YAC1B,OAAO,EAAE,+BAA+B,QAAQ,4BAA4B;YAC5E,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;KACJ,CAAC;IACF,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CACX,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,SAAkB;YAC5B,OAAO,EAAE,IAAI,KAAK,CAAC,IAAI,iBAAiB,KAAK,CAAC,OAAO,mDAAmD;YACxG,OAAO,EAAE,KAAK,CAAC,IAAI;SACpB,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACzD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE;QACrD,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE;QAClC,QAAQ;QACR,YAAY,EAAE,MAAM;YAClB,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,aAAa,QAAQ,CAAC,MAAM,gCAAgC;YAC/E,CAAC,CAAC,gCAAgC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,qCAAqC,CAAC,CAAC,CAAC,EAAE,EAAE;QACxG,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/catalog-show.d.ts

@@ -0,0 +1,13 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface CatalogShowFlags {
+    section: string;
+    as?: string;
+}
+export interface CatalogShowData {
+    section: string;
+    content: string;
+}
+export declare function execute(store: Store, flags: CatalogShowFlags): Promise<CommandOutcome<CatalogShowData>>;
+//# sourceMappingURL=catalog-show.d.ts.map

package/dist/commands/catalog-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-show.d.ts","sourceRoot":"","sources":["../../src/commands/catalog-show.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAa7G"}

package/dist/commands/catalog-show.js

@@ -0,0 +1,19 @@
+import { readCatalogSection } from '../core/catalog/build.js';
+import { CatalogSectionNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+export const requires = { store: 'required' };
+export async function execute(store, flags) {
+    const content = await readCatalogSection(store, flags.section, flags.as);
+    if (content === null) {
+        throw new CatalogSectionNotFoundError(flags.section);
+    }
+    return {
+        exitCode: ExitCode.Ok,
+        data: { section: flags.section, content },
+        findings: [],
+        humanSummary: content,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=catalog-show.js.map

package/dist/commands/catalog-show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-show.js","sourceRoot":"","sources":["../../src/commands/catalog-show.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAY/D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,KAAuB;IACjE,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE;QACzC,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,OAAO;QACrB,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/check.d.ts

@@ -0,0 +1,22 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { DisclosureRung, DisclosureVerdict } from '../core/disclosure/model.js';
+import type { RunEnv } from '../core/env.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface CheckFlags {
+    path: string;
+    audience: string;
+}
+export interface CheckData {
+    path: string;
+    audience: string;
+    verdict: DisclosureVerdict;
+    rung: DisclosureRung;
+}
+/**
+ * disclosure-policy spec: the tri-state ALLOW/DENY/ASK verdict, each with
+ * its own documented exit code (cli-contract's reserved 4/5), printing the
+ * rung that produced it so a script or a human can see WHY, not just WHAT.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: CheckFlags): Promise<CommandOutcome<CheckData>>;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC;CACtB;AAaD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAsB9G"}

package/dist/commands/check.js

@@ -0,0 +1,43 @@
+import path from 'node:path';
+import { evaluateDisclosure } from '../core/disclosure/model.js';
+import { NoteNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { parseNote } from '../core/notes/parse.js';
+export const requires = { store: 'required' };
+const VERDICT_EXIT_CODE = {
+    allow: ExitCode.Ok,
+    deny: ExitCode.DisclosureDeny,
+    ask: ExitCode.DisclosureAsk,
+};
+function toStoreRelativePath(env, store, givenPath) {
+    const absolute = path.isAbsolute(givenPath) ? givenPath : path.resolve(env.cwd, givenPath);
+    return path.relative(store.root, absolute).split(path.sep).join('/');
+}
+/**
+ * disclosure-policy spec: the tri-state ALLOW/DENY/ASK verdict, each with
+ * its own documented exit code (cli-contract's reserved 4/5), printing the
+ * rung that produced it so a script or a human can see WHY, not just WHAT.
+ */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.path);
+    const absolutePath = path.join(store.root, relativePath);
+    let note;
+    try {
+        note = await parseNote(absolutePath, relativePath);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            throw new NoteNotFoundError(relativePath);
+        throw err;
+    }
+    const { verdict, rung } = evaluateDisclosure(store.config, note, flags.audience);
+    return {
+        exitCode: VERDICT_EXIT_CODE[verdict],
+        data: { path: relativePath, audience: flags.audience, verdict, rung },
+        findings: [],
+        humanSummary: `${relativePath} for audience "${flags.audience}": ${verdict.toUpperCase()} (rung: ${rung})`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAc/D,MAAM,iBAAiB,GAAsC;IAC3D,KAAK,EAAE,QAAQ,CAAC,EAAE;IAClB,IAAI,EAAE,QAAQ,CAAC,cAAc;IAC7B,GAAG,EAAE,QAAQ,CAAC,aAAa;CAC5B,CAAC;AAEF,SAAS,mBAAmB,CAAC,GAAW,EAAE,KAAY,EAAE,SAAiB;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC3F,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY,EAAE,KAAiB;IACxE,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEzD,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAChG,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEjF,OAAO;QACL,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAa;QAChD,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;QACrE,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,YAAY,kBAAkB,KAAK,CAAC,QAAQ,MAAM,OAAO,CAAC,WAAW,EAAE,WAAW,IAAI,GAAG;QAC1G,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,27 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { CheckScope, CheckStatus } from '../core/checks/types.js';
+import type { RunEnv } from '../core/env.js';
+import type { Finding } from '../core/envelope.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface DoctorFlags {
+    staged?: boolean;
+}
+export interface DoctorCheckSummary {
+    id: string;
+    title: string;
+    result: CheckStatus;
+    reason?: string;
+    findings?: Finding[];
+}
+export interface DoctorData {
+    scope: CheckScope;
+    checks: DoctorCheckSummary[];
+    summary: {
+        pass: number;
+        fail: number;
+        skip: number;
+    };
+}
+export declare function execute(env: RunEnv, store: Store, flags?: DoctorFlags): Promise<CommandOutcome<DoctorData>>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,KAAK,EAAgB,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAiDrH"}

package/dist/commands/doctor.js

@@ -0,0 +1,53 @@
+import { CHECKS } from '../core/checks/manifest.js';
+import { overallStatus, runChecks } from '../core/checks/registry.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { getStagedFiles } from '../core/git/staged.js';
+import { readGraph } from '../core/graph/persist.js';
+import { listNotes } from '../core/notes/list.js';
+export const requires = { store: 'required' };
+export async function execute(env, store, flags = {}) {
+    const scope = flags.staged ? 'staged' : 'store';
+    const staged = scope === 'staged' ? await getStagedFiles(env.git, store.root) : undefined;
+    const ctx = {
+        storeRoot: store.root,
+        config: store.config,
+        scope,
+        git: env.git,
+        staged,
+        notes: () => listNotes(store.root, store.config),
+        graph: () => readGraph(store),
+        catalog: async () => undefined,
+    };
+    // doctor runs only `invariant` checks — `observation` checks (lint's,
+    // Phase 7) are registered in the same manifest but never affect doctor's
+    // exit code. This is what makes "no condition double-counted as both a
+    // lint finding and a doctor failure" (task 9.4) a type-level fact instead
+    // of a later audit.
+    const reports = await runChecks(CHECKS, ctx, { scope, severity: 'invariant' });
+    const summary = {
+        pass: reports.filter((r) => r.result.status === 'pass').length,
+        fail: reports.filter((r) => r.result.status === 'fail').length,
+        skip: reports.filter((r) => r.result.status === 'skip').length,
+    };
+    const status = overallStatus(reports);
+    const data = {
+        scope,
+        checks: reports.map((r) => ({
+            id: r.id,
+            title: r.title,
+            result: r.result.status,
+            reason: r.result.skipReason,
+            findings: r.result.findings.length > 0 ? r.result.findings : undefined,
+        })),
+        summary,
+    };
+    return {
+        exitCode: status === 'fail' ? ExitCode.CheckFailed : ExitCode.Ok,
+        data,
+        findings: reports.flatMap((r) => r.result.findings),
+        humanSummary: `doctor (${scope}): ${summary.pass} passed, ${summary.fail} failed, ${summary.skip} skipped`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/graph-build.d.ts

@@ -0,0 +1,24 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import { type GraphBuildResult } from '../core/graph/model.js';
+import { type PerNoteRecord } from '../core/records.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface GraphBuildFlags {
+    emitRecords?: boolean;
+}
+export interface GraphBuildData {
+    nodeCount: number;
+    edgeCount: number;
+    dangling: GraphBuildResult['dangling'];
+    records?: PerNoteRecord[];
+}
+/**
+ * context-retrieval spec: node identity is path-based, so a genuine identity
+ * collision is structurally unreachable through a real note listing —
+ * `buildGraphFromNotes` throwing here is a defensive invariant, not a
+ * scenario this command tries to recover from. A dangling link (unresolved
+ * or ambiguous wikilink target) is the opposite: expected, non-fatal, and
+ * reported as a finding rather than failing the build.
+ */
+export declare function execute(store: Store, flags?: GraphBuildFlags): Promise<CommandOutcome<GraphBuildData>>;
+//# sourceMappingURL=graph-build.d.ts.map

package/dist/commands/graph-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-build.d.ts","sourceRoot":"","sources":["../../src/commands/graph-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGpF,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAuBhH"}

package/dist/commands/graph-build.js

@@ -0,0 +1,36 @@
+import { ExitCode } from '../core/exit-codes.js';
+import { buildGraphFromNotes } from '../core/graph/model.js';
+import { writeGraph } from '../core/graph/persist.js';
+import { listNotes } from '../core/notes/list.js';
+import { buildPerNoteRecords } from '../core/records.js';
+export const requires = { store: 'required' };
+/**
+ * context-retrieval spec: node identity is path-based, so a genuine identity
+ * collision is structurally unreachable through a real note listing —
+ * `buildGraphFromNotes` throwing here is a defensive invariant, not a
+ * scenario this command tries to recover from. A dangling link (unresolved
+ * or ambiguous wikilink target) is the opposite: expected, non-fatal, and
+ * reported as a finding rather than failing the build.
+ */
+export async function execute(store, flags = {}) {
+    const notes = await listNotes(store.root, store.config);
+    const graph = buildGraphFromNotes(notes);
+    await writeGraph(store, graph);
+    const records = flags.emitRecords ? await buildPerNoteRecords(store) : undefined;
+    const findings = graph.dangling.map((d) => ({
+        code: 'graph.dangling_link',
+        severity: 'warning',
+        message: `"${d.from}" links to "${d.target}", which is ${d.reason === 'ambiguous' ? 'ambiguous (multiple notes share that name)' : 'not found'}.`,
+        subject: d.from,
+        details: { target: d.target, reason: d.reason },
+    }));
+    return {
+        exitCode: ExitCode.Ok,
+        data: { nodeCount: graph.nodes.length, edgeCount: graph.edges.length, dangling: graph.dangling, records },
+        findings,
+        humanSummary: `Graph built: ${graph.nodes.length} node(s), ${graph.edges.length} edge(s), ${graph.dangling.length} dangling link(s).`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=graph-build.js.map