@latysh-development/monolith 0.0.0-stage → 0.1.0-alpha.0

package/dist/root/write-artifacts.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Read-only diagnostics for files an interrupted write can leave behind
+ * (SEC-001B.2, DEC-B2-02, FS-CLEAN-001).
+ *
+ * This only LISTS names. It never opens, reads, follows, repairs or deletes
+ * anything, and a name that matches does NOT mean the file is an orphan:
+ * every running `mission` command has exactly such a file for a moment. Safe
+ * cleanup needs an owner/liveness criterion that does not exist yet.
+ */
+export type WriteArtifactKind = 'state-temp' | 'lock-staging' | 'recovery-mutex';
+export interface WriteArtifact {
+    /** Directory entry name (project-controlled text: escape before printing). */
+    name: string;
+    kind: WriteArtifactKind;
+}
+/** Entries of the instance directory `rootAbs` that look like write leftovers. Never throws. */
+export declare function findWriteArtifacts(rootAbs: string): WriteArtifact[];
+/** One-line, bounded, human-readable summary; names are JSON-escaped so control characters cannot forge output. */
+export declare function describeWriteArtifacts(artifacts: readonly WriteArtifact[], where: string, maxNames?: number): string;
+//# sourceMappingURL=write-artifacts.d.ts.map

package/dist/root/write-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-artifacts.d.ts","sourceRoot":"","sources":["../../src/root/write-artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEjF,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAQD,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAiBnE;AAED,mHAAmH;AACnH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAO/G"}

package/dist/root/write-artifacts.js

@@ -0,0 +1,42 @@
+/**
+ * Read-only diagnostics for files an interrupted write can leave behind
+ * (SEC-001B.2, DEC-B2-02, FS-CLEAN-001).
+ *
+ * This only LISTS names. It never opens, reads, follows, repairs or deletes
+ * anything, and a name that matches does NOT mean the file is an orphan:
+ * every running `mission` command has exactly such a file for a moment. Safe
+ * cleanup needs an owner/liveness criterion that does not exist yet.
+ */
+import { readdirSync } from 'fs';
+const PATTERNS = [
+    [/^state\.json\.tmp\./, 'state-temp'],
+    [/^state\.json\.lock\.creating\./, 'lock-staging'],
+    [/^state\.json\.lock\.recovery(\.creating\..*)?$/, 'recovery-mutex'],
+];
+/** Entries of the instance directory `rootAbs` that look like write leftovers. Never throws. */
+export function findWriteArtifacts(rootAbs) {
+    let names;
+    try {
+        names = readdirSync(rootAbs);
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    for (const name of names) {
+        for (const [re, kind] of PATTERNS) {
+            if (re.test(name)) {
+                found.push({ name, kind });
+                break;
+            }
+        }
+    }
+    return found.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+/** One-line, bounded, human-readable summary; names are JSON-escaped so control characters cannot forge output. */
+export function describeWriteArtifacts(artifacts, where, maxNames = 3) {
+    const shown = artifacts.slice(0, maxNames).map((a) => JSON.stringify(a.name));
+    const more = artifacts.length - shown.length;
+    return (`${artifacts.length} leftover-looking write file(s) in "${where}": ${shown.join(', ')}${more > 0 ? `, and ${more} more` : ''}. ` +
+        'They are present and may belong to a command that is still running; MONOLITH never deletes them (FS-CLEAN-001).');
+}

package/dist/scriptorium/compile.d.ts

@@ -0,0 +1,4 @@
+import type { ScriptoriumInput, ScriptoriumResult } from './types.js';
+export declare function compileMarkdownArtifact(input: ScriptoriumInput): ScriptoriumResult;
+export declare function isStructuralHeadingNoise(label: string): boolean;
+//# sourceMappingURL=compile.d.ts.map

package/dist/scriptorium/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/scriptorium/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAOlB,MAAM,YAAY,CAAC;AAIpB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAwJlF;AA2BD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/dist/scriptorium/compile.js

@@ -0,0 +1,185 @@
+import { parseFrontmatter } from './frontmatter.js';
+import { parseMarkdownBody } from './markdown.js';
+export function compileMarkdownArtifact(input) {
+    const { id, content } = input;
+    const concepts = [];
+    const relationships = [];
+    const evidence = [];
+    const sourceReferences = [];
+    const diagnostics = [];
+    const declarations = [];
+    let conceptIdx = 0;
+    let relIdx = 0;
+    let evidenceIdx = 0;
+    let refIdx = 0;
+    const lines = content.split('\n');
+    const fm = parseFrontmatter(lines);
+    const bodyStartLine = fm?.bodyStartLine ?? 0;
+    const bodyLines = lines.slice(bodyStartLine);
+    let docLabel = input.title ?? id;
+    let documentId;
+    let documentIdLine;
+    let documentTitleDecl = input.title;
+    let documentStatus;
+    if (fm) {
+        for (const field of fm.fields) {
+            if (field.key === 'title' && field.values[0]) {
+                docLabel = field.values[0];
+                documentTitleDecl = field.values[0];
+            }
+            if (field.key === 'status' && field.values[0]) {
+                documentStatus = field.values[0];
+            }
+            if (field.key === 'id' && field.values[0]) {
+                documentId = field.values[0];
+                documentIdLine = field.line;
+            }
+            if (field.isRelationship) {
+                for (const val of field.values) {
+                    relationships.push({
+                        id: `${id}-rel-${relIdx++}`,
+                        fromLabel: docLabel,
+                        toLabel: val,
+                        relationshipType: field.key,
+                        provenance: 'explicit',
+                        sourceField: field.key,
+                        sourceLine: field.line,
+                    });
+                }
+            }
+            else {
+                for (const val of field.values) {
+                    evidence.push({
+                        id: `${id}-evidence-${evidenceIdx++}`,
+                        content: val,
+                        source: 'frontmatter',
+                        key: field.key,
+                    });
+                }
+            }
+        }
+    }
+    if (documentId !== undefined) {
+        declarations.push({
+            kind: 'document',
+            localId: documentId,
+            ...(documentTitleDecl !== undefined ? { title: documentTitleDecl } : {}),
+            ...(documentStatus !== undefined ? { status: documentStatus } : {}),
+            ...(documentIdLine !== undefined ? { sourceLine: documentIdLine } : {}),
+        });
+    }
+    const parsed = parseMarkdownBody(bodyLines);
+    for (const heading of parsed.headings) {
+        if (heading.anchorId === undefined)
+            continue;
+        const title = normalizeLabel(heading.text);
+        declarations.push({
+            kind: 'section',
+            localId: heading.anchorId,
+            ...(title ? { title } : {}),
+            sourceLine: heading.line + bodyStartLine,
+        });
+    }
+    for (const heading of parsed.headings) {
+        const label = normalizeLabel(heading.text);
+        if (!label)
+            continue;
+        if (isStructuralHeadingNoise(label))
+            continue;
+        concepts.push({
+            id: `${id}-concept-${conceptIdx++}`,
+            label,
+            source: 'heading',
+            headingLevel: heading.level,
+            sourceLine: heading.line + bodyStartLine,
+        });
+    }
+    for (const link of parsed.links) {
+        sourceReferences.push({
+            id: `${id}-ref-${refIdx++}`,
+            label: link.label,
+            target: link.target,
+            sourceLine: link.line + bodyStartLine,
+        });
+    }
+    for (const item of parsed.listItems) {
+        if (looksLikeNamedConcept(item.text)) {
+            concepts.push({
+                id: `${id}-concept-${conceptIdx++}`,
+                label: normalizeLabel(item.text),
+                source: 'list-item',
+                sourceLine: item.line + bodyStartLine,
+            });
+        }
+        else {
+            evidence.push({
+                id: `${id}-evidence-${evidenceIdx++}`,
+                content: item.text,
+                source: 'list-item',
+                sourceLine: item.line + bodyStartLine,
+            });
+        }
+    }
+    for (const block of parsed.codeBlocks) {
+        evidence.push({
+            id: `${id}-evidence-${evidenceIdx++}`,
+            content: block.content,
+            source: 'code-block',
+            language: block.language,
+            sourceLine: block.startLine + bodyStartLine,
+        });
+    }
+    return {
+        artifactId: id,
+        documentId,
+        documentTitle: docLabel,
+        namespace: input.namespace,
+        sourcePath: input.sourcePath,
+        declarations,
+        concepts,
+        relationships,
+        evidence,
+        sourceReferences,
+        diagnostics,
+    };
+}
+function normalizeLabel(text) {
+    return text
+        .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1') // [label](url) → label
+        .replace(/`([^`]*)`/g, '$1') // `code` → code
+        .replace(/[*_~]+/g, '') // strip bold/italic markers
+        .trim();
+}
+// Generic structural section titles that appear in almost every document.
+// These produce high-degree noise nodes rather than domain-specific concepts.
+// Conservative: only exact matches (case-insensitive) after label normalization.
+const STRUCTURAL_HEADING_NOISE = new Set([
+    'overview',
+    'summary',
+    'notes',
+    'background',
+    'context',
+    'status',
+    'implementation',
+    'tests',
+    'next steps',
+    'open questions',
+    'conclusion',
+]);
+export function isStructuralHeadingNoise(label) {
+    return STRUCTURAL_HEADING_NOISE.has(label.toLowerCase());
+}
+// Promotes a list item to a ConceptCandidate if it looks like a named term.
+// Conservative heuristic: short (≤3 words), no trailing sentence punctuation,
+// and either starts with an uppercase letter or is a backtick-wrapped code term.
+function looksLikeNamedConcept(text) {
+    const label = normalizeLabel(text);
+    const words = label.split(/\s+/).filter(Boolean);
+    if (words.length === 0 || words.length > 3)
+        return false;
+    if (/[.?!,;:]$/.test(label))
+        return false;
+    if (text.trim().startsWith('`'))
+        return true;
+    return /^[A-Z]/.test(label);
+}

package/dist/scriptorium/frontmatter.d.ts

@@ -0,0 +1,13 @@
+export interface FrontmatterField {
+    key: string;
+    values: string[];
+    isRelationship: boolean;
+    /** 0-based line of the key within the artifact (the opening `---` is line 0). */
+    line: number;
+}
+export interface FrontmatterParseResult {
+    fields: FrontmatterField[];
+    bodyStartLine: number;
+}
+export declare function parseFrontmatter(lines: string[]): FrontmatterParseResult | null;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/scriptorium/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/scriptorium/frontmatter.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,sBAAsB,GAAG,IAAI,CAwE/E"}

package/dist/scriptorium/frontmatter.js

@@ -0,0 +1,90 @@
+const MONOLITH_RELATIONSHIP_FIELDS = new Set([
+    'related_decisions',
+    'related_hypotheses',
+    'related_regions',
+    'related_protocols',
+    'depends_on',
+    'references',
+    'related',
+    // Added in Story 1.3.2: fields actually used in the MONOLITH docs/ corpus
+    'follow_up_adrs',
+    'related_adrs',
+    'related_research',
+    // Added in .monolith/ self-analysis dogfood: fields used in operational memory
+    'protocols',
+    'referenced_by',
+    'related_skills',
+]);
+export function parseFrontmatter(lines) {
+    if (lines[0]?.trim() !== '---')
+        return null;
+    let closeIdx = -1;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            closeIdx = i;
+            break;
+        }
+    }
+    if (closeIdx === -1)
+        return null;
+    const fmLines = lines.slice(1, closeIdx);
+    const fields = [];
+    let i = 0;
+    while (i < fmLines.length) {
+        const line = fmLines[i];
+        if (line.trim() === '' || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const keyValueMatch = line.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\s*:\s*(.*)$/);
+        if (!keyValueMatch) {
+            i++;
+            continue;
+        }
+        const key = keyValueMatch[1];
+        const keyLine = i + 1;
+        const rawValue = keyValueMatch[2].trim();
+        let values = [];
+        if (rawValue === '') {
+            // Block sequence: look ahead for `- item` lines
+            i++;
+            while (i < fmLines.length) {
+                const itemMatch = fmLines[i].match(/^\s+-\s+(.+)$/);
+                if (itemMatch) {
+                    const v = stripQuotes(itemMatch[1].trim());
+                    if (v)
+                        values.push(v);
+                    i++;
+                }
+                else {
+                    break;
+                }
+            }
+        }
+        else if (rawValue.startsWith('[')) {
+            // Inline sequence: [val1, val2]
+            const inner = rawValue.slice(rawValue.indexOf('[') + 1, rawValue.lastIndexOf(']'));
+            values = inner
+                .split(',')
+                .map(s => stripQuotes(s.trim()))
+                .filter(Boolean);
+            i++;
+        }
+        else {
+            values = [stripQuotes(rawValue)].filter(Boolean);
+            i++;
+        }
+        if (values.length > 0) {
+            fields.push({
+                key,
+                values,
+                isRelationship: MONOLITH_RELATIONSHIP_FIELDS.has(key),
+                line: keyLine,
+            });
+        }
+    }
+    return { fields, bodyStartLine: closeIdx + 1 };
+}
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, '');
+}

package/dist/scriptorium/index.d.ts

@@ -0,0 +1,3 @@
+export type { ScriptoriumInput, ScriptoriumResult, ConceptCandidate, RelationshipCandidate, Evidence, SourceReference, ScriptoriumDiagnostic, ConceptSource, EvidenceSource, HeadingLevel, ObjectDeclaration, DeclaredObjectKind, } from './types.js';
+export { compileMarkdownArtifact, isStructuralHeadingNoise } from './compile.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scriptorium/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scriptorium/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,QAAQ,EACR,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/dist/scriptorium/index.js

@@ -0,0 +1 @@
+export { compileMarkdownArtifact, isStructuralHeadingNoise } from './compile.js';

package/dist/scriptorium/markdown.d.ts

@@ -0,0 +1,31 @@
+import type { HeadingLevel } from './types.js';
+export interface ParsedHeading {
+    level: HeadingLevel;
+    text: string;
+    line: number;
+    /** Raw id from a trailing `{#ID}` marker (not validated); the marker is removed from `text`. */
+    anchorId?: string;
+}
+export interface ParsedLink {
+    label: string;
+    target: string;
+    line: number;
+}
+export interface ParsedListItem {
+    text: string;
+    line: number;
+    indent: number;
+}
+export interface ParsedCodeBlock {
+    language: string | undefined;
+    content: string;
+    startLine: number;
+}
+export interface MarkdownParseResult {
+    headings: ParsedHeading[];
+    links: ParsedLink[];
+    listItems: ParsedListItem[];
+    codeBlocks: ParsedCodeBlock[];
+}
+export declare function parseMarkdownBody(lines: string[]): MarkdownParseResult;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/scriptorium/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/scriptorium/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAQD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAoFtE"}

package/dist/scriptorium/markdown.js

@@ -0,0 +1,88 @@
+const HEADING_RE = /^(#{1,6})\s+(.+?)(?:\s+#+)?$/;
+const LIST_ITEM_UNORDERED_RE = /^(\s*)[-*+]\s+(.+)$/;
+const LIST_ITEM_ORDERED_RE = /^(\s*)\d+\.\s+(.+)$/;
+const HEADING_ANCHOR_RE = /\s*\{#([^\s{}]+)\}\s*$/;
+const LINK_RE = /\[([^\]]+)\]\(([^)]+)\)/g;
+export function parseMarkdownBody(lines) {
+    const headings = [];
+    const links = [];
+    const listItems = [];
+    const codeBlocks = [];
+    let inCodeBlock = false;
+    let codeBlockLang;
+    let codeBlockLines = [];
+    let codeBlockStart = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed.startsWith('```')) {
+            if (!inCodeBlock) {
+                inCodeBlock = true;
+                const lang = trimmed.slice(3).trim();
+                codeBlockLang = lang || undefined;
+                codeBlockLines = [];
+                codeBlockStart = i;
+            }
+            else {
+                if (codeBlockLines.join('\n').trim()) {
+                    codeBlocks.push({
+                        language: codeBlockLang,
+                        content: codeBlockLines.join('\n'),
+                        startLine: codeBlockStart,
+                    });
+                }
+                inCodeBlock = false;
+                codeBlockLang = undefined;
+                codeBlockLines = [];
+            }
+            continue;
+        }
+        if (inCodeBlock) {
+            codeBlockLines.push(line);
+            continue;
+        }
+        const headingMatch = trimmed.match(HEADING_RE);
+        if (headingMatch) {
+            const level = headingMatch[1].length;
+            let text = headingMatch[2].trim();
+            let anchorId;
+            const anchor = text.match(HEADING_ANCHOR_RE);
+            if (anchor) {
+                anchorId = anchor[1];
+                text = text.slice(0, anchor.index).trim();
+            }
+            headings.push({ level, text, line: i, ...(anchorId !== undefined ? { anchorId } : {}) });
+            extractLinks(text, i, links);
+            continue;
+        }
+        const unordered = line.match(LIST_ITEM_UNORDERED_RE);
+        if (unordered) {
+            listItems.push({ text: unordered[2].trim(), line: i, indent: unordered[1].length });
+            extractLinks(unordered[2], i, links);
+            continue;
+        }
+        const ordered = line.match(LIST_ITEM_ORDERED_RE);
+        if (ordered) {
+            listItems.push({ text: ordered[2].trim(), line: i, indent: ordered[1].length });
+            extractLinks(ordered[2], i, links);
+            continue;
+        }
+        extractLinks(line, i, links);
+    }
+    // Close an unclosed fence
+    if (inCodeBlock && codeBlockLines.join('\n').trim()) {
+        codeBlocks.push({
+            language: codeBlockLang,
+            content: codeBlockLines.join('\n'),
+            startLine: codeBlockStart,
+        });
+    }
+    return { headings, links, listItems, codeBlocks };
+}
+function extractLinks(text, lineIdx, out) {
+    const re = new RegExp(LINK_RE.source, 'g');
+    let match;
+    while ((match = re.exec(text)) !== null) {
+        out.push({ label: match[1].trim(), target: match[2].trim(), line: lineIdx });
+    }
+}

package/dist/scriptorium/types.d.ts

@@ -0,0 +1,78 @@
+export type ConceptSource = 'heading' | 'frontmatter' | 'list-item' | 'link-label';
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export interface ConceptCandidate {
+    id: string;
+    label: string;
+    source: ConceptSource;
+    headingLevel?: HeadingLevel;
+    sourceLine?: number;
+}
+export interface RelationshipCandidate {
+    id: string;
+    fromLabel: string;
+    toLabel: string;
+    relationshipType: string;
+    provenance: 'explicit';
+    sourceField?: string;
+    sourceLine?: number;
+}
+export type DeclaredObjectKind = 'document' | 'section';
+/**
+ * A raw, unvalidated claim that an object with `localId` exists in this artifact.
+ * Scriptorium only extracts the claim; ERG decides identity, uniqueness and validity.
+ * `sourceLine` is 0-based, like ConceptCandidate.sourceLine.
+ */
+export interface ObjectDeclaration {
+    kind: DeclaredObjectKind;
+    localId: string;
+    title?: string;
+    status?: string;
+    sourceLine?: number;
+}
+export type EvidenceSource = 'frontmatter' | 'list-item' | 'code-block';
+export interface Evidence {
+    id: string;
+    content: string;
+    source: EvidenceSource;
+    language?: string;
+    key?: string;
+    sourceLine?: number;
+}
+export interface SourceReference {
+    id: string;
+    label: string;
+    target: string;
+    sourceLine?: number;
+}
+export interface ScriptoriumDiagnostic {
+    severity: 'info' | 'warn' | 'error';
+    message: string;
+    sourceLine?: number;
+}
+export interface ScriptoriumResult {
+    artifactId: string;
+    /** Canonical short-form identifier from frontmatter `id:` (e.g. "ADR-004", "R-0001"). */
+    documentId?: string;
+    /** Resolved display title used as fromLabel in relationships (frontmatter title → H1 → artifactId). */
+    documentTitle?: string;
+    /** Namespace supplied by the caller for this artifact (ScriptoriumInput.namespace); never derived from content. */
+    namespace?: string;
+    /** Path of the artifact as supplied by the caller (ScriptoriumInput.sourcePath). */
+    sourcePath?: string;
+    /** Object declarations: the document (frontmatter `id:`) and `{#ID}`-marked sections. */
+    declarations: ObjectDeclaration[];
+    concepts: ConceptCandidate[];
+    relationships: RelationshipCandidate[];
+    evidence: Evidence[];
+    sourceReferences: SourceReference[];
+    diagnostics: ScriptoriumDiagnostic[];
+}
+export interface ScriptoriumInput {
+    id: string;
+    title?: string;
+    content: string;
+    sourcePath?: string;
+    /** Identity namespace of the corpus this artifact belongs to. Supplied by the caller, never inferred. */
+    namespace?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scriptorium/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAEnF,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mHAAmH;IACnH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yGAAyG;IACzG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/scriptorium/types.js

@@ -0,0 +1 @@
+export {};

package/dist/types/enforcement.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Result returned by every enforcement gate check.
+ */
+export interface GateCheckResult {
+    passed: boolean;
+    reason: string;
+    blockedActions: string[];
+    requiredSteps: string[];
+}
+export type GateStatus = 'PASS' | 'BLOCK' | 'WARN';
+//# sourceMappingURL=enforcement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enforcement.d.ts","sourceRoot":"","sources":["../../src/types/enforcement.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC"}

package/dist/types/enforcement.js

@@ -0,0 +1 @@
+export {};

package/dist/types/integrity.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Context passed to every integrity validator.
+ */
+export interface VerificationContext {
+    projectRoot: string;
+    monolithRoot: string;
+    phaseId: string;
+    storyId: string;
+    metadata: Record<string, unknown>;
+}
+export type VerificationStatus = 'PASS' | 'FAIL' | 'WARN';
+export interface VerificationCheck {
+    checkId: string;
+    description: string;
+    status: VerificationStatus;
+    message: string;
+}
+/**
+ * Aggregate result produced by the verification engine.
+ */
+export interface VerificationReport {
+    protocolId: string;
+    context: VerificationContext;
+    checks: VerificationCheck[];
+    result: {
+        status: VerificationStatus;
+        passed: number;
+        failed: number;
+        warnings: number;
+    };
+    summary: string;
+}
+//# sourceMappingURL=integrity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../src/types/integrity.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE;QACN,MAAM,EAAE,kBAAkB,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/integrity.js

@@ -0,0 +1 @@
+export {};