ctxr-cli 0.1.0

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

@@ -0,0 +1,21 @@
+import type { CommandOutcome, CommandRequires } from '../core/command.js';
+import type { RunEnv } from '../core/env.js';
+import { type SourceCheckResult } from '../core/ingest/model.js';
+import type { Store } from '../core/store.js';
+export declare const requires: CommandRequires;
+export interface SourceCheckFlags {
+    path: string;
+    sourceId: string;
+}
+export type SourceCheckData = SourceCheckResult & {
+    path: string;
+};
+/**
+ * context-ingest spec: evaluate, in order, source-id match then content-
+ * hash match, never proceeding past a stage with more than one match. Only
+ * `multiple_matches` is a failure (CheckFailed) — `already_ingested`,
+ * `alternate_source_match`, and `new` are all legitimate, non-error
+ * verdicts the caller decides what to do with.
+ */
+export declare function execute(env: RunEnv, store: Store, flags: SourceCheckFlags): Promise<CommandOutcome<SourceCheckData>>;
+//# sourceMappingURL=source-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-check.d.ts","sourceRoot":"","sources":["../../src/commands/source-check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAOnE;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAoC1C"}

package/dist/commands/source-check.js

@@ -0,0 +1,54 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { contentHash } from '../core/content/canonicalize.js';
+import { NoteNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.js';
+import { evaluateSourceCheck } from '../core/ingest/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-ingest spec: evaluate, in order, source-id match then content-
+ * hash match, never proceeding past a stage with more than one match. Only
+ * `multiple_matches` is a failure (CheckFailed) — `already_ingested`,
+ * `alternate_source_match`, and `new` are all legitimate, non-error
+ * verdicts the caller decides what to do with.
+ */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.path);
+    const absolutePath = path.join(store.root, relativePath);
+    let raw;
+    try {
+        raw = await readFile(absolutePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            throw new NoteNotFoundError(relativePath);
+        throw err;
+    }
+    const hash = contentHash(raw, relativePath);
+    const notes = await listNotes(store.root, store.config);
+    const result = evaluateSourceCheck(notes, hash, flags.sourceId);
+    const findings = result.verdict === 'multiple_matches'
+        ? [
+            {
+                code: 'ingest.source_check.multiple_matches',
+                severity: 'error',
+                message: `More than one existing note matches at the ${result.stage} stage: ${result.matches.join(', ')}.`,
+                details: { stage: result.stage, matches: result.matches },
+            },
+        ]
+        : [];
+    return {
+        exitCode: result.verdict === 'multiple_matches' ? ExitCode.CheckFailed : ExitCode.Ok,
+        data: { path: relativePath, ...result },
+        findings,
+        humanSummary: `${relativePath}: ${result.verdict}${result.matches.length > 0 ? ` (${result.matches.join(', ')})` : ''}`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=source-check.js.map

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

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

package/dist/commands/source-hash.d.ts

@@ -0,0 +1,14 @@
+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 SourceHashFlags {
+    path: string;
+}
+export interface SourceHashData {
+    path: string;
+    hash: string;
+}
+/** context-ingest spec: the canonicalized-content hash, via the one shared primitive — never reimplemented per caller. */
+export declare function execute(env: RunEnv, store: Store, flags: SourceHashFlags): Promise<CommandOutcome<SourceHashData>>;
+//# sourceMappingURL=source-hash.d.ts.map

package/dist/commands/source-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-hash.d.ts","sourceRoot":"","sources":["../../src/commands/source-hash.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAOD,0HAA0H;AAC1H,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAqBxH"}

package/dist/commands/source-hash.js

@@ -0,0 +1,34 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { contentHash } from '../core/content/canonicalize.js';
+import { NoteNotFoundError } from '../core/errors.js';
+import { ExitCode } from '../core/exit-codes.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-ingest spec: the canonicalized-content hash, via the one shared primitive — never reimplemented per caller. */
+export async function execute(env, store, flags) {
+    const relativePath = toStoreRelativePath(env, store, flags.path);
+    const absolutePath = path.join(store.root, relativePath);
+    let raw;
+    try {
+        raw = await readFile(absolutePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            throw new NoteNotFoundError(relativePath);
+        throw err;
+    }
+    const hash = contentHash(raw, relativePath);
+    return {
+        exitCode: ExitCode.Ok,
+        data: { path: relativePath, hash },
+        findings: [],
+        humanSummary: `${relativePath}: ${hash}`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=source-hash.js.map

package/dist/commands/source-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-hash.js","sourceRoot":"","sources":["../../src/commands/source-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAW/D,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,0HAA0H;AAC1H,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY,EAAE,KAAsB;IAC7E,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,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7C,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,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC5C,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;QAClC,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,YAAY,KAAK,IAAI,EAAE;QACxC,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/update.d.ts

@@ -0,0 +1,17 @@
+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 UpdateData {
+    /** Every store-relative path this run rewrote to the installed version; empty when already current. */
+    changed: string[];
+}
+/**
+ * entry-doc-generation spec (D5): after upgrading contexture, bring every
+ * contexture-owned file in the store to the installed version — generated
+ * AGENTS.md sections, .gitignore blocks, hooks, the contexture-owned skill
+ * copies, and each configured adapter's outputs. Operator content is never
+ * touched. Idempotent: a current store reports nothing changed.
+ */
+export declare function execute(env: RunEnv, store: Store): Promise<CommandOutcome<UpdateData>>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,uGAAuG;IACvG,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAa5F"}

package/dist/commands/update.js

@@ -0,0 +1,25 @@
+import { ExitCode } from '../core/exit-codes.js';
+import { reconcileStore } from '../core/reconcile.js';
+import { generateAdapterOutputs } from './adapters-generate.js';
+export const requires = { store: 'required' };
+/**
+ * entry-doc-generation spec (D5): after upgrading contexture, bring every
+ * contexture-owned file in the store to the installed version — generated
+ * AGENTS.md sections, .gitignore blocks, hooks, the contexture-owned skill
+ * copies, and each configured adapter's outputs. Operator content is never
+ * touched. Idempotent: a current store reports nothing changed.
+ */
+export async function execute(env, store) {
+    const { changed } = await reconcileStore(env, store.root, store.config);
+    const adapterFiles = await generateAdapterOutputs(store);
+    const all = [...new Set([...changed, ...adapterFiles.filter((f) => f.changed).map((f) => f.path)])];
+    return {
+        exitCode: ExitCode.Ok,
+        data: { changed: all },
+        findings: [],
+        humanSummary: all.length === 0 ? 'Store is already up to date.' : `Updated ${all.length} contexture-owned file(s).`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,CAAC,MAAM,QAAQ,GAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAO/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,KAAY;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpG,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;QACtB,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,MAAM,4BAA4B;QACnH,SAAS,EAAE,KAAK,CAAC,IAAI;QACrB,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;KAC3C,CAAC;AACJ,CAAC"}

package/dist/commands/verify.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 VerifyFlags {
+    portable?: boolean;
+}
+export interface VerifyStepResult {
+    operation: string;
+    status: 'pass' | 'fail';
+    detail?: string;
+}
+export interface VerifyData {
+    steps: VerifyStepResult[];
+}
+/**
+ * harness-portability spec: exercises core store operations "from an
+ * environment with no harness-specific state present" — nothing here reads
+ * any harness-specific file or env var, so the property under test holds
+ * by construction; this command just runs the three named operations in
+ * order and stops at the first failure, naming it (never running the rest).
+ */
+export declare function execute(store: Store, _flags?: VerifyFlags): Promise<CommandOutcome<VerifyData>>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/commands/verify.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAU1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,QAAQ,EAAE,eAAuC,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAMD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAkFzG"}

package/dist/commands/verify.js

@@ -0,0 +1,126 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { agentsMdPath } from '../core/agents-doc.js';
+import { readCatalogSection } from '../core/catalog/build.js';
+import { catalogSectionsFor } from '../core/catalog/model.js';
+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 { scanProcedures } from '../core/procedures.js';
+export const requires = { store: 'required' };
+function procedureIndexEntry(name, relativePath) {
+    return `[${name}](${relativePath})`;
+}
+/**
+ * harness-portability spec: exercises core store operations "from an
+ * environment with no harness-specific state present" — nothing here reads
+ * any harness-specific file or env var, so the property under test holds
+ * by construction; this command just runs the three named operations in
+ * order and stops at the first failure, naming it (never running the rest).
+ */
+export async function execute(store, _flags = {}) {
+    const steps = [];
+    // 1. A retrieval query — reading a catalog section works even before any
+    // build has ever run (an empty, valid section), so this genuinely proves
+    // the retrieval leg is reachable from nothing.
+    try {
+        const [firstSection] = catalogSectionsFor(store.config);
+        await readCatalogSection(store, firstSection.id);
+        steps.push({ operation: 'retrieval query (catalog show)', status: 'pass' });
+    }
+    catch (err) {
+        steps.push({
+            operation: 'retrieval query (catalog show)',
+            status: 'fail',
+            detail: err instanceof Error ? err.message : String(err),
+        });
+        return finish(store, steps);
+    }
+    // 2. A derived-artifact build.
+    try {
+        const notes = await listNotes(store.root, store.config);
+        await writeGraph(store, buildGraphFromNotes(notes));
+        steps.push({ operation: 'derived-artifact build (graph build)', status: 'pass' });
+    }
+    catch (err) {
+        steps.push({
+            operation: 'derived-artifact build (graph build)',
+            status: 'fail',
+            detail: err instanceof Error ? err.message : String(err),
+        });
+        return finish(store, steps);
+    }
+    // 3. Follow one procedure via the AGENTS.md index: every canonical
+    // procedure must have an index entry, and at least one must be readable.
+    let agentsMdContent;
+    try {
+        agentsMdContent = await readFile(agentsMdPath(store.root), 'utf8');
+    }
+    catch (err) {
+        steps.push({
+            operation: 'procedure index (AGENTS.md)',
+            status: 'fail',
+            detail: err instanceof Error ? err.message : String(err),
+        });
+        return finish(store, steps);
+    }
+    // entry-doc-generation spec: the index must cover every procedure actually
+    // on disk — shipped seeds and operator-added files alike.
+    const procedures = await scanProcedures(store.root, store.config);
+    for (const procedure of procedures) {
+        if (!agentsMdContent.includes(procedureIndexEntry(procedure.title, procedure.path))) {
+            steps.push({
+                operation: `procedure index entry for "${procedure.title}"`,
+                status: 'fail',
+                detail: `AGENTS.md's procedure index has no entry for "${procedure.title}".`,
+            });
+            return finish(store, steps);
+        }
+    }
+    const first = procedures[0];
+    if (!first) {
+        steps.push({
+            operation: 'follow a procedure',
+            status: 'fail',
+            detail: `No procedure files exist at "${store.config.harness.procedures_path}".`,
+        });
+        return finish(store, steps);
+    }
+    try {
+        await readFile(path.join(store.root, first.path), 'utf8');
+        steps.push({ operation: `follow procedure "${first.title}"`, status: 'pass' });
+    }
+    catch (err) {
+        steps.push({
+            operation: `follow procedure "${first.title}"`,
+            status: 'fail',
+            detail: err instanceof Error ? err.message : String(err),
+        });
+    }
+    return finish(store, steps);
+}
+function finish(store, steps) {
+    const failed = steps.find((s) => s.status === 'fail');
+    const findings = failed
+        ? [
+            {
+                code: 'verify.portable.failed',
+                severity: 'error',
+                message: `"${failed.operation}" failed: ${failed.detail ?? '(no detail)'}`,
+                subject: failed.operation,
+            },
+        ]
+        : [];
+    return {
+        exitCode: failed ? ExitCode.CheckFailed : ExitCode.Ok,
+        data: { steps },
+        findings,
+        humanSummary: failed
+            ? `verify --portable failed at: ${failed.operation}`
+            : `verify --portable: all ${steps.length} operation(s) succeeded.`,
+        storeRoot: store.root,
+        schemaVersion: store.config.schema_version,
+    };
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/verify.js.map

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

package/dist/config/defaults.d.ts

@@ -0,0 +1,69 @@
+import type { AdapterDeclaration, HardWallConfig } from './schema.js';
+/**
+ * context-store spec: "The visibility field's frontmatter key is configurable
+ * with a shipped default... No specification other than this one SHALL
+ * assert the literal key name." This module is that one place, in code —
+ * enforced by test/unit/single-source-literals.test.ts. Every other module
+ * reads the key via StoreConfig.fields.visibility, never this constant
+ * directly, and never the literal "scope" string.
+ *
+ * "scope" is provisional (design.md D7 / openspec/config.yaml): renaming it
+ * is meant to be a config-default change plus a migration, never a spec or
+ * code rewrite. Do not let this constant's value leak into any other file.
+ */
+export declare const DEFAULT_VISIBILITY_FIELD_KEY = "lens";
+/**
+ * The visibility field key every store created before schema_version 2
+ * used. Named here, once, purely as history for the rename migration
+ * (core/migrations/rename-visibility-field.ts) to read from — this is the
+ * one sanctioned place a superseded key value is allowed to live once it's
+ * no longer the shipped default.
+ */
+export declare const SCHEMA_V1_VISIBILITY_FIELD_KEY = "scope";
+/** context-visibility spec rung 3: what a note's visibility fails closed to. */
+export declare const DEFAULT_VISIBILITY_CONTEXT = "private";
+/**
+ * context-store spec (contexture-home-layout): `.contexture/` is the tool's
+ * home directory. Only its cache subpath is derived/gitignored — the
+ * catalog, identity, and procedure subdirectories are authored-but-tool-
+ * owned and stay tracked.
+ */
+export declare const DEFAULT_DERIVED_PATHS: readonly ['.contexture/cache/'];
+/** agent-identity spec: canonical identity files live here, excluded from every retrieval leg. */
+export declare const DEFAULT_IDENTITY_PATH = ".contexture/identity/";
+/**
+ * harness-portability spec (entry-doc-generation D5): contexture-owned
+ * skills are copied here (`<slug>/SKILL.md`), defaulting to the directory
+ * harnesses with skill auto-discovery read — one file, one hop. A store
+ * driven by another harness points this at that harness's skills directory.
+ */
+export declare const DEFAULT_PROCEDURES_PATH = ".claude/skills/";
+/** harness-portability spec (entry-doc-generation): operator-authored convention docs, indexed by AGENTS.md. */
+export declare const DEFAULT_CONVENTIONS_PATH = ".contexture/conventions/";
+/** Paths excluded from every retrieval leg by default. */
+export declare const DEFAULT_EXCLUDE_PATHS: readonly ['.contexture/'];
+/** write-lifecycle spec: session worktrees live under a configured, gitignored path. */
+export declare const DEFAULT_WORKTREES_PATH = ".worktrees/";
+/** Branch names for session worktrees are prefixed so they're recognizable and sweep-safe. */
+export declare const DEFAULT_SESSION_BRANCH_PREFIX = "session/";
+/** write-lifecycle spec: pre-commit's diff-size ceiling, in total changed lines. */
+export declare const DEFAULT_DIFF_SIZE_CEILING_LINES = 2000;
+/** context-catalog spec: where per-section catalog files live — tracked (never gitignored), since glosses are authored. */
+export declare const DEFAULT_CATALOG_PATH = ".contexture/catalog/";
+/** context-catalog spec: a section exceeding this triggers a failing doctor check, not a silent slowdown. */
+export declare const DEFAULT_CATALOG_SECTION_MAX_BYTES: number;
+/** disclosure-policy spec: v1 ships with no audiences pre-declared internal, and no hard walls — an explicit, empty starting point the operator opts into. */
+export declare const DEFAULT_INTERNAL_AUDIENCES: readonly string[];
+export declare const DEFAULT_HARD_WALLS: readonly HardWallConfig[];
+/** context-ingest spec: capture's landing zone — a normal, retrievable directory, not an exclusion. */
+export declare const DEFAULT_INBOX_PATH = "inbox/";
+/** context-organize spec: archive's destination, decoupled from any taxonomy layer name. */
+export declare const DEFAULT_ARCHIVE_PATH = "archive/";
+/**
+ * adapters spec: init registers both shipped builtins by default, so
+ * out-of-the-box UX (a PR opened on session submit, a generated CLAUDE.md)
+ * keeps working without the operator hand-writing config — each is just as
+ * removable from this list as it was addable.
+ */
+export declare const DEFAULT_ADAPTERS: readonly AdapterDeclaration[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,UAAU,CAAC;AAEtD,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,YAAY,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,YAAI,oBAAoB,CAAU,CAAC;AAErE,kGAAkG;AAClG,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAEzD,gHAAgH;AAChH,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,YAAI,cAAc,CAAU,CAAC;AAE/D,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,6GAA6G;AAC7G,eAAO,MAAM,iCAAiC,QAAY,CAAC;AAE3D,8JAA8J;AAC9J,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAO,CAAC;AAChE,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAAO,CAAC;AAEhE,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,4FAA4F;AAC5F,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAGzD,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,71 @@
+/**
+ * context-store spec: "The visibility field's frontmatter key is configurable
+ * with a shipped default... No specification other than this one SHALL
+ * assert the literal key name." This module is that one place, in code —
+ * enforced by test/unit/single-source-literals.test.ts. Every other module
+ * reads the key via StoreConfig.fields.visibility, never this constant
+ * directly, and never the literal "scope" string.
+ *
+ * "scope" is provisional (design.md D7 / openspec/config.yaml): renaming it
+ * is meant to be a config-default change plus a migration, never a spec or
+ * code rewrite. Do not let this constant's value leak into any other file.
+ */
+export const DEFAULT_VISIBILITY_FIELD_KEY = 'lens';
+/**
+ * The visibility field key every store created before schema_version 2
+ * used. Named here, once, purely as history for the rename migration
+ * (core/migrations/rename-visibility-field.ts) to read from — this is the
+ * one sanctioned place a superseded key value is allowed to live once it's
+ * no longer the shipped default.
+ */
+export const SCHEMA_V1_VISIBILITY_FIELD_KEY = 'scope';
+/** context-visibility spec rung 3: what a note's visibility fails closed to. */
+export const DEFAULT_VISIBILITY_CONTEXT = 'private';
+/**
+ * context-store spec (contexture-home-layout): `.contexture/` is the tool's
+ * home directory. Only its cache subpath is derived/gitignored — the
+ * catalog, identity, and procedure subdirectories are authored-but-tool-
+ * owned and stay tracked.
+ */
+export const DEFAULT_DERIVED_PATHS = ['.contexture/cache/'];
+/** agent-identity spec: canonical identity files live here, excluded from every retrieval leg. */
+export const DEFAULT_IDENTITY_PATH = '.contexture/identity/';
+/**
+ * harness-portability spec (entry-doc-generation D5): contexture-owned
+ * skills are copied here (`<slug>/SKILL.md`), defaulting to the directory
+ * harnesses with skill auto-discovery read — one file, one hop. A store
+ * driven by another harness points this at that harness's skills directory.
+ */
+export const DEFAULT_PROCEDURES_PATH = '.claude/skills/';
+/** harness-portability spec (entry-doc-generation): operator-authored convention docs, indexed by AGENTS.md. */
+export const DEFAULT_CONVENTIONS_PATH = '.contexture/conventions/';
+/** Paths excluded from every retrieval leg by default. */
+export const DEFAULT_EXCLUDE_PATHS = ['.contexture/'];
+/** write-lifecycle spec: session worktrees live under a configured, gitignored path. */
+export const DEFAULT_WORKTREES_PATH = '.worktrees/';
+/** Branch names for session worktrees are prefixed so they're recognizable and sweep-safe. */
+export const DEFAULT_SESSION_BRANCH_PREFIX = 'session/';
+/** write-lifecycle spec: pre-commit's diff-size ceiling, in total changed lines. */
+export const DEFAULT_DIFF_SIZE_CEILING_LINES = 2000;
+/** context-catalog spec: where per-section catalog files live — tracked (never gitignored), since glosses are authored. */
+export const DEFAULT_CATALOG_PATH = '.contexture/catalog/';
+/** context-catalog spec: a section exceeding this triggers a failing doctor check, not a silent slowdown. */
+export const DEFAULT_CATALOG_SECTION_MAX_BYTES = 32 * 1024;
+/** disclosure-policy spec: v1 ships with no audiences pre-declared internal, and no hard walls — an explicit, empty starting point the operator opts into. */
+export const DEFAULT_INTERNAL_AUDIENCES = [];
+export const DEFAULT_HARD_WALLS = [];
+/** context-ingest spec: capture's landing zone — a normal, retrievable directory, not an exclusion. */
+export const DEFAULT_INBOX_PATH = 'inbox/';
+/** context-organize spec: archive's destination, decoupled from any taxonomy layer name. */
+export const DEFAULT_ARCHIVE_PATH = 'archive/';
+/**
+ * adapters spec: init registers both shipped builtins by default, so
+ * out-of-the-box UX (a PR opened on session submit, a generated CLAUDE.md)
+ * keeps working without the operator hand-writing config — each is just as
+ * removable from this list as it was addable.
+ */
+export const DEFAULT_ADAPTERS = [
+    { id: 'github', kind: 'forge' },
+    { id: 'claude-code', kind: 'harness-generation' },
+];
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAEtD,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,oBAAoB,CAAU,CAAC;AAErE,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAEzD,gHAAgH;AAChH,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,cAAc,CAAU,CAAC;AAE/D,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AAExD,oFAAoF;AACpF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAEpD,2HAA2H;AAC3H,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D,6GAA6G;AAC7G,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3D,8JAA8J;AAC9J,MAAM,CAAC,MAAM,0BAA0B,GAAsB,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAA8B,EAAE,CAAC;AAEhE,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,4FAA4F;AAC5F,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/B,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,oBAAoB,EAAE;CAClD,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,11 @@
+import { type StoreConfig } from './schema.js';
+export declare function configPathFor(root: string): string;
+/**
+ * store-lifecycle spec: "Schema version is recorded and gated" — every
+ * command reads schema_version before operating. This peeks at it loosely,
+ * BEFORE full validation, so a store with a genuinely newer/incompatible
+ * shape reports "your version is newer" rather than a confusing generic
+ * shape-validation error the full schema would otherwise produce.
+ */
+export declare function readConfig(root: string): Promise<StoreConfig>;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AASA,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE5F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAiCnE"}

package/dist/config/load.js

@@ -0,0 +1,49 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { CONFIG_FILE_NAME } from '../core/root.js';
+import { InvalidConfigError, SchemaVersionMissingError, SchemaVersionNewerError, } from '../core/errors.js';
+import { StoreConfigSchema, SUPPORTED_SCHEMA_VERSION } from './schema.js';
+export function configPathFor(root) {
+    return path.join(root, CONFIG_FILE_NAME);
+}
+/**
+ * store-lifecycle spec: "Schema version is recorded and gated" — every
+ * command reads schema_version before operating. This peeks at it loosely,
+ * BEFORE full validation, so a store with a genuinely newer/incompatible
+ * shape reports "your version is newer" rather than a confusing generic
+ * shape-validation error the full schema would otherwise produce.
+ */
+export async function readConfig(root) {
+    const configPath = configPathFor(root);
+    const text = await readFile(configPath, 'utf8');
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (err) {
+        throw new InvalidConfigError(configPath, [
+            { path: '(root)', message: err instanceof Error ? err.message : String(err) },
+        ]);
+    }
+    const rawVersion = raw?.schema_version;
+    if (rawVersion === undefined || rawVersion === null) {
+        throw new SchemaVersionMissingError(configPath);
+    }
+    if (typeof rawVersion !== 'number' || !Number.isInteger(rawVersion)) {
+        throw new InvalidConfigError(configPath, [{ path: 'schema_version', message: 'must be an integer' }]);
+    }
+    if (rawVersion > SUPPORTED_SCHEMA_VERSION) {
+        throw new SchemaVersionNewerError(rawVersion, SUPPORTED_SCHEMA_VERSION);
+    }
+    const result = StoreConfigSchema.safeParse(raw);
+    if (!result.success) {
+        const issues = result.error.issues.map((issue) => ({
+            path: issue.path.join('.') || '(root)',
+            message: issue.message,
+        }));
+        throw new InvalidConfigError(configPath, issues);
+    }
+    return result.data;
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAoB,MAAM,aAAa,CAAC;AAE5F,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE;YACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAI,GAA2C,EAAE,cAAc,CAAC;IAChF,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,IAAI,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;IACxG,CAAC;IACD,IAAI,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAC1C,MAAM,IAAI,uBAAuB,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ;YACtC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/config/render.d.ts

@@ -0,0 +1,9 @@
+import { type StoreConfig } from './schema.js';
+/**
+ * Renders a StoreConfig to YAML text and round-trips it back through the
+ * schema before returning — a render that doesn't round-trip is a bug caught
+ * here, before any byte reaches disk, rather than discovered later as a
+ * corrupted store.
+ */
+export declare function renderStoreConfig(config: StoreConfig): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/config/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/config/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIlE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAI7D"}

package/dist/config/render.js

@@ -0,0 +1,15 @@
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { StoreConfigSchema } from './schema.js';
+const HEADER = '# contexture store configuration\n\n';
+/**
+ * Renders a StoreConfig to YAML text and round-trips it back through the
+ * schema before returning — a render that doesn't round-trip is a bug caught
+ * here, before any byte reaches disk, rather than discovered later as a
+ * corrupted store.
+ */
+export function renderStoreConfig(config) {
+    const text = HEADER + stringifyYaml(config, { indent: 2 });
+    StoreConfigSchema.parse(parseYaml(text)); // throws on mismatch; that IS the check
+    return text;
+}
+//# sourceMappingURL=render.js.map

package/dist/config/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/config/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAElE,MAAM,MAAM,GAAG,sCAAsC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB;IACnD,MAAM,IAAI,GAAG,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3D,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,wCAAwC;IAClF,OAAO,IAAI,CAAC;AACd,CAAC"}