@rasensio/aidlc 1.16.0 → 1.17.0

package/dist/constitution/extract.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Read a vision document and hand back plain text.
+ *
+ * The check order is load-bearing, not stylistic: **parse → bounds → existence →
+ * size → decompress**. Checking existence before bounds turns an out-of-bounds
+ * path into a "file not found" and makes the command an existence oracle for
+ * files outside the project — this repo has shipped that exact defect once
+ * (`cost-capture-noise`, 2026-08-22).
+ *
+ * Requirements: project-constitution/AC-1, project-constitution/AC-4,
+ * project-constitution/AC-5, project-constitution/AC-6
+ *
+ * @module
+ */
+import type { ExtractResult } from './types.js';
+/** Largest vision document accepted, before anything is read (AC-5). */
+export declare const MAX_SOURCE_BYTES: number;
+/** Largest single archive entry accepted, declared or actual (AC-5). */
+export declare const MAX_INFLATED_BYTES: number;
+/** Every extension `import` accepts, for the AC-4 message. */
+export declare const SUPPORTED_EXTENSIONS: readonly [".docx", ".md", ".markdown", ".txt"];
+/**
+ * Extract the text of a vision document.
+ *
+ * @param projectRoot - Absolute project root; the source must live inside it.
+ * @param rawPath - The path as the user typed it, absolute or relative to cwd.
+ */
+export declare function extractVision(projectRoot: string, rawPath: string): ExtractResult;
+/**
+ * The message an unsupported format gets. Says what is accepted and what to do
+ * about a PDF, because "unsupported" on its own leaves the user stuck (AC-4).
+ */
+export declare function unsupportedFormatHelp(detail: string): string;
+//# sourceMappingURL=extract.d.ts.map

package/dist/constitution/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/constitution/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AAE3D,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAKnD,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,gDAAiD,CAAC;AAEnF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CA8EjF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/constitution/extract.js

@@ -0,0 +1,117 @@
+/**
+ * Read a vision document and hand back plain text.
+ *
+ * The check order is load-bearing, not stylistic: **parse → bounds → existence →
+ * size → decompress**. Checking existence before bounds turns an out-of-bounds
+ * path into a "file not found" and makes the command an existence oracle for
+ * files outside the project — this repo has shipped that exact defect once
+ * (`cost-capture-noise`, 2026-08-22).
+ *
+ * Requirements: project-constitution/AC-1, project-constitution/AC-4,
+ * project-constitution/AC-5, project-constitution/AC-6
+ *
+ * @module
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { extname, relative, resolve } from 'node:path';
+import { isWithin } from '../core/paths.js';
+import { DOCX_MAIN_PART, ZipReadError, docxToText, readZipEntry } from './docx.js';
+/** Largest vision document accepted, before anything is read (AC-5). */
+export const MAX_SOURCE_BYTES = 25 * 1024 * 1024;
+/** Largest single archive entry accepted, declared or actual (AC-5). */
+export const MAX_INFLATED_BYTES = 10 * 1024 * 1024;
+/** Extensions read directly as UTF-8 text. */
+const TEXT_EXTENSIONS = new Set(['.md', '.markdown', '.txt']);
+/** Every extension `import` accepts, for the AC-4 message. */
+export const SUPPORTED_EXTENSIONS = ['.docx', '.md', '.markdown', '.txt'];
+/**
+ * Extract the text of a vision document.
+ *
+ * @param projectRoot - Absolute project root; the source must live inside it.
+ * @param rawPath - The path as the user typed it, absolute or relative to cwd.
+ */
+export function extractVision(projectRoot, rawPath) {
+    const absolute = resolve(rawPath);
+    // Bounds BEFORE existence — see the module docblock (AC-6).
+    if (!isWithin(projectRoot, absolute)) {
+        return {
+            ok: false,
+            reason: 'out-of-bounds',
+            detail: `${rawPath} resolves outside the project root ${projectRoot}`,
+        };
+    }
+    if (!existsSync(absolute)) {
+        return { ok: false, reason: 'missing', detail: `${rawPath} does not exist` };
+    }
+    const extension = extname(absolute).toLowerCase();
+    const isDocx = extension === '.docx';
+    if (!isDocx && !TEXT_EXTENSIONS.has(extension)) {
+        return {
+            ok: false,
+            reason: 'unsupported-format',
+            detail: `${extension === '' ? '(no extension)' : extension} is not supported`,
+        };
+    }
+    const size = statSync(absolute).size;
+    if (size > MAX_SOURCE_BYTES) {
+        return {
+            ok: false,
+            reason: 'too-large',
+            detail: `${rawPath} is ${size} bytes, over the ${MAX_SOURCE_BYTES}-byte limit`,
+        };
+    }
+    const bytes = readFileSync(absolute);
+    const sha256 = createHash('sha256').update(bytes).digest('hex');
+    const relativePath = relative(projectRoot, absolute);
+    if (!isDocx) {
+        return {
+            ok: true,
+            text: bytes.toString('utf8'),
+            extractor: 'text',
+            sha256,
+            relativePath,
+        };
+    }
+    let part;
+    try {
+        part = readZipEntry(bytes, DOCX_MAIN_PART, MAX_INFLATED_BYTES);
+    }
+    catch (err) {
+        if (err instanceof ZipReadError) {
+            return {
+                ok: false,
+                reason: err.code === 'entry-too-large' ? 'entry-too-large' : 'not-a-docx',
+                detail: err.message,
+            };
+        }
+        throw err;
+    }
+    if (part === null) {
+        return {
+            ok: false,
+            reason: 'not-a-docx',
+            detail: `${rawPath} is a ZIP archive but has no ${DOCX_MAIN_PART}`,
+        };
+    }
+    return {
+        ok: true,
+        text: docxToText(part.toString('utf8')),
+        extractor: 'docx',
+        sha256,
+        relativePath,
+    };
+}
+/**
+ * The message an unsupported format gets. Says what is accepted and what to do
+ * about a PDF, because "unsupported" on its own leaves the user stuck (AC-4).
+ */
+export function unsupportedFormatHelp(detail) {
+    return [
+        `Cannot read this vision document: ${detail}.`,
+        `Supported: ${SUPPORTED_EXTENSIONS.join(', ')}.`,
+        'For a PDF, Google Doc, or anything else: read it and save a markdown copy',
+        'alongside it, then import that. The snapshot records whichever file you pass.',
+    ].join('\n');
+}
+//# sourceMappingURL=extract.js.map

package/dist/constitution/extract.js.map

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

package/dist/constitution/snapshot.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The vision snapshot: `.aidlc/context/vision-source.md`.
+ *
+ * What gets committed is the *extracted text*, never the `.docx` (design D8) —
+ * a binary is not reviewable in a diff, and the source document often should not
+ * be in the repository at all. `source_sha256` is the digest of the source bytes,
+ * which is how `check` notices the document was touched even when the text is
+ * unchanged.
+ *
+ * The file is rendered by hand rather than through a YAML serializer. A
+ * round-trip through `Document.toString()` reflows to whatever `lineWidth` is in
+ * force and rewrites lines it was only meant to preserve
+ * (`knowledge-rebuild-readonly`, 2026-09-02); rendering deterministically avoids
+ * the class. Reading uses the YAML parser, which does not have that problem.
+ *
+ * Requirements: project-constitution/AC-10, project-constitution/AC-11
+ *
+ * @module
+ */
+import type { Snapshot } from './types.js';
+/** Where the snapshot lives, relative to the project root. */
+export declare const SNAPSHOT_RELATIVE: string;
+export declare function snapshotPath(projectRoot: string): string;
+/**
+ * Render the snapshot deterministically. Same input, same bytes, always — which
+ * is what lets `writeSnapshot` compare rather than guess (AC-11).
+ */
+export declare function renderSnapshot(snapshot: Snapshot): string;
+/** Read the snapshot, or null when it is absent or unparseable. */
+export declare function readSnapshot(projectRoot: string): Snapshot | null;
+/**
+ * Write the snapshot, but only when it would differ.
+ *
+ * Returns `'unchanged'` when the recorded source digest and the statement id set
+ * both match, leaving the file — `extracted_at` included — byte-identical. A
+ * re-import that finds nothing new must not produce a git diff (AC-11).
+ */
+export declare function writeSnapshot(projectRoot: string, next: Snapshot): 'written' | 'unchanged';
+/** Build a snapshot from freshly extracted text. */
+export declare function buildSnapshot(input: {
+    relativePath: string;
+    sha256: string;
+    extractor: Snapshot['extractor'];
+    text: string;
+    now: Date;
+}): Snapshot;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/constitution/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/constitution/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,YAAY,CAAC;AAEtD,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,QAAgD,CAAC;AAK/E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAuBzD;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAmCjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAW1F;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,IAAI,CAAC;CACX,GAAG,QAAQ,CAQX"}

package/dist/constitution/snapshot.js

@@ -0,0 +1,159 @@
+/**
+ * The vision snapshot: `.aidlc/context/vision-source.md`.
+ *
+ * What gets committed is the *extracted text*, never the `.docx` (design D8) —
+ * a binary is not reviewable in a diff, and the source document often should not
+ * be in the repository at all. `source_sha256` is the digest of the source bytes,
+ * which is how `check` notices the document was touched even when the text is
+ * unchanged.
+ *
+ * The file is rendered by hand rather than through a YAML serializer. A
+ * round-trip through `Document.toString()` reflows to whatever `lineWidth` is in
+ * force and rewrites lines it was only meant to preserve
+ * (`knowledge-rebuild-readonly`, 2026-09-02); rendering deterministically avoids
+ * the class. Reading uses the YAML parser, which does not have that problem.
+ *
+ * Requirements: project-constitution/AC-10, project-constitution/AC-11
+ *
+ * @module
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { splitStatements } from './statements.js';
+/** Where the snapshot lives, relative to the project root. */
+export const SNAPSHOT_RELATIVE = join('.aidlc', 'context', 'vision-source.md');
+/** Statement lines look like `- V-a1b2c3d4: text` (with an optional ×n suffix). */
+const STATEMENT_RE = /^- (V-[0-9a-f]{8}): (.*?)(?: ×(\d+))?$/;
+export function snapshotPath(projectRoot) {
+    return join(projectRoot, SNAPSHOT_RELATIVE);
+}
+/**
+ * Render the snapshot deterministically. Same input, same bytes, always — which
+ * is what lets `writeSnapshot` compare rather than guess (AC-11).
+ */
+export function renderSnapshot(snapshot) {
+    const lines = [
+        '---',
+        `source_path: ${yamlScalar(snapshot.sourcePath)}`,
+        `source_sha256: ${snapshot.sourceSha256}`,
+        `extracted_at: ${snapshot.extractedAt}`,
+        `extractor: ${snapshot.extractor}`,
+        `statement_count: ${snapshot.statements.length}`,
+        '---',
+        '# Vision source (extracted)',
+        '',
+        'Generated by `aidlc constitution import`. Each statement is identified by a hash',
+        'of its own text, so inserting a paragraph never renumbers the others and editing',
+        'one changes only its own id. Do not hand-edit: re-run the import instead.',
+        '',
+        '## Statements',
+        '',
+    ];
+    for (const statement of snapshot.statements) {
+        const suffix = statement.occurrences > 1 ? ` ×${statement.occurrences}` : '';
+        lines.push(`- ${statement.id}: ${statement.text}${suffix}`);
+    }
+    return lines.join('\n') + '\n';
+}
+/** Read the snapshot, or null when it is absent or unparseable. */
+export function readSnapshot(projectRoot) {
+    const file = snapshotPath(projectRoot);
+    let raw;
+    try {
+        raw = readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    if (!raw.startsWith('---\n'))
+        return null;
+    const close = raw.indexOf('\n---\n', 4);
+    if (close === -1)
+        return null;
+    let data;
+    try {
+        const parsed = parseYaml(raw.slice(4, close + 1));
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        data = parsed;
+    }
+    catch {
+        return null;
+    }
+    const sourcePath = str(data['source_path']);
+    const sourceSha256 = str(data['source_sha256']);
+    const extractedAt = str(data['extracted_at']);
+    const extractor = str(data['extractor']);
+    if (sourcePath === null || sourceSha256 === null || extractedAt === null)
+        return null;
+    if (extractor !== 'docx' && extractor !== 'text')
+        return null;
+    return {
+        sourcePath,
+        sourceSha256,
+        extractedAt,
+        extractor,
+        statements: parseStatements(raw.slice(close + 5)),
+    };
+}
+/**
+ * Write the snapshot, but only when it would differ.
+ *
+ * Returns `'unchanged'` when the recorded source digest and the statement id set
+ * both match, leaving the file — `extracted_at` included — byte-identical. A
+ * re-import that finds nothing new must not produce a git diff (AC-11).
+ */
+export function writeSnapshot(projectRoot, next) {
+    const file = snapshotPath(projectRoot);
+    const current = readSnapshot(projectRoot);
+    if (current !== null && current.sourceSha256 === next.sourceSha256 && sameIds(current, next)) {
+        return 'unchanged';
+    }
+    if (!existsSync(dirname(file)))
+        mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, renderSnapshot(next), 'utf8');
+    return 'written';
+}
+/** Build a snapshot from freshly extracted text. */
+export function buildSnapshot(input) {
+    return {
+        sourcePath: input.relativePath,
+        sourceSha256: input.sha256,
+        extractedAt: input.now.toISOString(),
+        extractor: input.extractor,
+        statements: splitStatements(input.text),
+    };
+}
+function sameIds(a, b) {
+    if (a.statements.length !== b.statements.length)
+        return false;
+    const seen = new Set(a.statements.map((s) => s.id));
+    return b.statements.every((s) => seen.has(s.id));
+}
+function parseStatements(body) {
+    const statements = [];
+    for (const line of body.split('\n')) {
+        const match = STATEMENT_RE.exec(line);
+        if (!match)
+            continue;
+        statements.push({
+            id: match[1],
+            text: match[2],
+            occurrences: match[3] === undefined ? 1 : Number(match[3]),
+        });
+    }
+    return statements;
+}
+function str(value) {
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+/**
+ * Quote a scalar only when a plain one would not round-trip. A path containing a
+ * colon or leading indicator character is the case that matters — this project
+ * lost five roadmap items to an unquoted backtick-initial title.
+ */
+function yamlScalar(value) {
+    return /^[A-Za-z0-9._/-]+$/.test(value) ? value : JSON.stringify(value);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/constitution/snapshot.js.map

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

package/dist/constitution/statements.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Content-addressed vision statements (design D1).
+ *
+ * A statement's id is derived from its own text, never from its position. That
+ * one choice is what makes a re-run usable: inserting a paragraph leaves every
+ * other id alone, editing one changes only its own id, and drift reduces to a
+ * set difference. Positional numbering would renumber everything below an
+ * insertion and invalidate every citation in `constitution.md`.
+ *
+ * Requirements: project-constitution/AC-7, project-constitution/AC-8,
+ * project-constitution/AC-9
+ *
+ * @module
+ */
+import type { Statement } from './types.js';
+/**
+ * Collapse a text block to its comparable form: trimmed, every run of
+ * whitespace (including newlines inside a wrapped paragraph) one space.
+ *
+ * This is what makes re-wrapping a paragraph in Word a no-op for its id.
+ */
+export declare function normalize(block: string): string;
+/** `V-` plus the first 8 hex characters of sha256 over the normalized text. */
+export declare function statementId(normalized: string): string;
+/**
+ * Split extracted text into statements.
+ *
+ * A statement is a block separated by one or more blank lines — which is what a
+ * paragraph, a heading and a list item each become after extraction. Identical
+ * normalized blocks collapse to one statement carrying an occurrence count, so
+ * a repeated heading cannot produce two entries sharing an id (AC-9).
+ *
+ * Order follows first appearance in the source, so the snapshot reads like the
+ * document even though ids do not depend on order.
+ */
+export declare function splitStatements(text: string): Statement[];
+//# sourceMappingURL=statements.d.ts.map

package/dist/constitution/statements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statements.d.ts","sourceRoot":"","sources":["../../src/constitution/statements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAqBzD"}

package/dist/constitution/statements.js

@@ -0,0 +1,64 @@
+/**
+ * Content-addressed vision statements (design D1).
+ *
+ * A statement's id is derived from its own text, never from its position. That
+ * one choice is what makes a re-run usable: inserting a paragraph leaves every
+ * other id alone, editing one changes only its own id, and drift reduces to a
+ * set difference. Positional numbering would renumber everything below an
+ * insertion and invalidate every citation in `constitution.md`.
+ *
+ * Requirements: project-constitution/AC-7, project-constitution/AC-8,
+ * project-constitution/AC-9
+ *
+ * @module
+ */
+import { createHash } from 'node:crypto';
+/** Hex characters of the digest kept in an id. */
+const ID_HEX_LENGTH = 8;
+/**
+ * Collapse a text block to its comparable form: trimmed, every run of
+ * whitespace (including newlines inside a wrapped paragraph) one space.
+ *
+ * This is what makes re-wrapping a paragraph in Word a no-op for its id.
+ */
+export function normalize(block) {
+    return block.replace(/\s+/g, ' ').trim();
+}
+/** `V-` plus the first 8 hex characters of sha256 over the normalized text. */
+export function statementId(normalized) {
+    const digest = createHash('sha256').update(normalized, 'utf8').digest('hex');
+    return `V-${digest.slice(0, ID_HEX_LENGTH)}`;
+}
+/**
+ * Split extracted text into statements.
+ *
+ * A statement is a block separated by one or more blank lines — which is what a
+ * paragraph, a heading and a list item each become after extraction. Identical
+ * normalized blocks collapse to one statement carrying an occurrence count, so
+ * a repeated heading cannot produce two entries sharing an id (AC-9).
+ *
+ * Order follows first appearance in the source, so the snapshot reads like the
+ * document even though ids do not depend on order.
+ */
+export function splitStatements(text) {
+    const seen = new Map();
+    const order = [];
+    for (const raw of text.split(/\n[ \t]*\n+/)) {
+        const normalized = normalize(raw);
+        if (normalized === '')
+            continue;
+        const id = statementId(normalized);
+        const existing = seen.get(id);
+        if (existing) {
+            existing.occurrences += 1;
+            continue;
+        }
+        seen.set(id, { text: normalized, occurrences: 1 });
+        order.push(id);
+    }
+    return order.map((id) => {
+        const found = seen.get(id);
+        return { id, text: found.text, occurrences: found.occurrences };
+    });
+}
+//# sourceMappingURL=statements.js.map

package/dist/constitution/statements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statements.js","sourceRoot":"","sources":["../../src/constitution/statements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,kDAAkD;AAClD,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7E,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAiD,CAAC;IACtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,UAAU,KAAK,EAAE;YAAE,SAAS;QAChC,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,WAAW,IAAI,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/constitution/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared types for the constitution module.
+ *
+ * Requirements: project-constitution/AC-7, project-constitution/AC-10
+ *
+ * @module
+ */
+/** One vision statement, identified by its own content (design D1). */
+export interface Statement {
+    /** `V-` followed by the first 8 hex characters of sha256(normalized text). */
+    readonly id: string;
+    /** The statement as extracted, normalized (trimmed, whitespace collapsed). */
+    readonly text: string;
+    /** How many times this exact normalized text appeared in the source (AC-9). */
+    readonly occurrences: number;
+}
+/** The committed record of what the vision document said when last imported. */
+export interface Snapshot {
+    /** Source location, relative to the project root so the file stays portable. */
+    readonly sourcePath: string;
+    /** sha256 of the source *bytes*, not of the extracted text. */
+    readonly sourceSha256: string;
+    /** ISO 8601 UTC. */
+    readonly extractedAt: string;
+    /** Which reader produced the text. */
+    readonly extractor: Extractor;
+    readonly statements: readonly Statement[];
+}
+export type Extractor = 'docx' | 'text';
+/** Why an extraction could not happen. Ordered as the checks run (NFR-3). */
+export type ExtractFailure = 'out-of-bounds' | 'missing' | 'unsupported-format' | 'too-large' | 'not-a-docx' | 'entry-too-large';
+export type ExtractResult = {
+    readonly ok: true;
+    readonly text: string;
+    readonly extractor: Extractor;
+    /** sha256 of the source bytes. */
+    readonly sha256: string;
+    /** Path relative to the project root. */
+    readonly relativePath: string;
+} | {
+    readonly ok: false;
+    readonly reason: ExtractFailure;
+    readonly detail: string;
+};
+/** One `IN-<n>` or `NOT-<n>` line parsed out of `constitution.md`. */
+export interface Entry {
+    /** `IN-3`, `NOT-1`. */
+    readonly id: string;
+    readonly kind: 'in-scope' | 'prohibition';
+    /** Every `V-…` id the line cites, in order of appearance. */
+    readonly cites: readonly string[];
+    /** 1-indexed line in `constitution.md`. */
+    readonly line: number;
+}
+/**
+ * What `aidlc constitution check` found.
+ *
+ * `state` distinguishes "evaluated, no drift" from the two situations where no
+ * comparison was possible — reporting those explicitly is the point (AC-15).
+ */
+export interface CheckReport {
+    readonly state: 'ok' | 'no-snapshot' | 'source-missing' | 'source-unreadable';
+    readonly source_path: string | null;
+    /** Statement ids in the source now and not in the snapshot. */
+    readonly added: readonly string[];
+    /** Statement ids in the snapshot and no longer in the source. */
+    readonly removed: readonly string[];
+    /** Constitution entries citing a removed id (AC-13). */
+    readonly affected_entries: readonly AffectedEntry[];
+    /** Present only when `state` is not `ok`. */
+    readonly detail?: string;
+}
+export interface AffectedEntry {
+    /** `NOT-2`. */
+    readonly entry: string;
+    /** The removed statement id it cites. */
+    readonly cites: string;
+    readonly line: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/constitution/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/constitution/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,SAAS,GACT,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,CAAC;AAEtB,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,sEAAsE;AACtE,MAAM,WAAW,KAAK;IACpB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,aAAa,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,EAAE,SAAS,aAAa,EAAE,CAAC;IACpD,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/constitution/types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types for the constitution module.
+ *
+ * Requirements: project-constitution/AC-7, project-constitution/AC-10
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/constitution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/constitution/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/core/gate.d.ts

@@ -10,6 +10,7 @@
 import type { PhaseState, WorkflowTemplate, TemplatePhase } from './types.js';
 import type { TraceabilityResult } from '../traceability/types.js';
 import type { TasksResult } from '../tasks/types.js';
+import type { ComplianceResult } from '../compliance/gate-criterion.js';
 /**
  * Gate check result for CI/CD integration.
  */
@@ -35,6 +36,15 @@ export interface GateCheckResult {
      * AC-19).
      */
     tasks?: TasksResult;
+    /**
+     * Compliance control coverage — present only when a compliance pack is installed.
+     * Attached at the command layer; `evaluateGate` never sets it.
+     *
+     * Conditionally assigned, following the two fields above, so a project with no
+     * pack produces a `--json` payload byte-identical to the pre-feature one
+     * (compliance-packs/AC-55).
+     */
+    compliance?: ComplianceResult;
 }
 /**
  * Evaluate whether a phase passes its gate check.

package/dist/core/gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,eAAe,CAiCjB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,aAAa,CAAC,oBAAoB,CAAC,CAKrC"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAMxE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,OAAO,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACpC,QAAQ,EAAE,gBAAgB,GACzB,eAAe,CAiCjB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,GAAG,SAAS,GACjC,aAAa,CAAC,oBAAoB,CAAC,CAKrC"}

package/dist/core/gate.js.map

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