@imix-js/taproot 0.2.0

package/dist/core/git.d.ts

@@ -0,0 +1,24 @@
+export interface GitCommit {
+    hash: string;
+    subject: string;
+    body: string;
+    date: string;
+}
+export declare function isGitRepo(cwd: string): boolean;
+export declare function getRepoRoot(cwd: string): string | null;
+export declare function gitLog(options: {
+    since?: string;
+    cwd: string;
+}): GitCommit[];
+export declare function commitExists(hash: string, cwd: string): boolean;
+/** Returns the date of the last commit that touched this file, or null. */
+export declare function fileLastCommitDate(filePath: string, cwd: string): Date | null;
+/** Returns the filesystem mtime of a file, or null if it doesn't exist. */
+export declare function fileMtime(filePath: string): Date | null;
+/**
+ * Parse a commit looking for a taproot path reference.
+ * Supports:
+ *   Subject: taproot(some/path): message
+ *   Body trailer: Taproot: some/path
+ */
+export declare function extractTaprootPath(commit: GitCommit, commitPattern: string, trailerKey: string): string | null;

package/dist/core/git.js

@@ -0,0 +1,76 @@
+import { spawnSync } from 'child_process';
+import { statSync } from 'fs';
+function git(args, cwd) {
+    const result = spawnSync('git', args, { cwd, encoding: 'utf-8' });
+    return {
+        stdout: result.stdout?.trim() ?? '',
+        ok: result.status === 0,
+    };
+}
+export function isGitRepo(cwd) {
+    return git(['rev-parse', '--git-dir'], cwd).ok;
+}
+export function getRepoRoot(cwd) {
+    const r = git(['rev-parse', '--show-toplevel'], cwd);
+    return r.ok ? r.stdout : null;
+}
+export function gitLog(options) {
+    const args = ['log', '--format=%H%x00%s%x00%b%x00%aI%x00---COMMIT---'];
+    if (options.since)
+        args.push(`--since=${options.since}`);
+    const { stdout, ok } = git(args, options.cwd);
+    if (!ok || !stdout)
+        return [];
+    return stdout
+        .split('---COMMIT---')
+        .map(s => s.trim())
+        .filter(Boolean)
+        .map(block => {
+        const parts = block.split('\x00');
+        return {
+            hash: (parts[0] ?? '').trim(),
+            subject: (parts[1] ?? '').trim(),
+            body: (parts[2] ?? '').trim(),
+            date: (parts[3] ?? '').trim(),
+        };
+    })
+        .filter(c => c.hash.length === 40);
+}
+export function commitExists(hash, cwd) {
+    return git(['cat-file', '-e', `${hash}^{commit}`], cwd).ok;
+}
+/** Returns the date of the last commit that touched this file, or null. */
+export function fileLastCommitDate(filePath, cwd) {
+    const r = git(['log', '-1', '--format=%aI', '--', filePath], cwd);
+    if (!r.ok || !r.stdout)
+        return null;
+    const d = new Date(r.stdout);
+    return isNaN(d.getTime()) ? null : d;
+}
+/** Returns the filesystem mtime of a file, or null if it doesn't exist. */
+export function fileMtime(filePath) {
+    try {
+        return statSync(filePath).mtime;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a commit looking for a taproot path reference.
+ * Supports:
+ *   Subject: taproot(some/path): message
+ *   Body trailer: Taproot: some/path
+ */
+export function extractTaprootPath(commit, commitPattern, trailerKey) {
+    const subjectRegex = new RegExp(commitPattern);
+    const subjectMatch = subjectRegex.exec(commit.subject);
+    if (subjectMatch?.[1])
+        return subjectMatch[1].trim();
+    const trailerRegex = new RegExp(`^${trailerKey}:\\s*(.+)$`, 'm');
+    const trailerMatch = trailerRegex.exec(commit.body);
+    if (trailerMatch?.[1])
+        return trailerMatch[1].trim();
+    return null;
+}
+//# sourceMappingURL=git.js.map

package/dist/core/git.js.map

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

package/dist/core/impl-reader.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedMarkdown } from '../validators/types.js';
+export interface ImplData {
+    behaviourRef: string | null;
+    sourceFiles: string[];
+    commits: string[];
+    testFiles: string[];
+}
+export declare function parseImplData(doc: ParsedMarkdown): ImplData;

package/dist/core/impl-reader.js

@@ -0,0 +1,39 @@
+/** Returns true if a backtick-quoted token looks like a file path (contains '/' or ends with a dotted extension). */
+function isFilePath(token) {
+    return token.includes('/') || /\.\w+$/.test(token);
+}
+/** Extract a backtick-quoted value from a list item line: `- \`value\` — ...` */
+function extractBacktickValues(lines) {
+    const result = [];
+    for (const line of lines) {
+        const match = /`([^`]+)`/.exec(line);
+        if (match?.[1])
+            result.push(match[1]);
+    }
+    return result;
+}
+/** Extract file paths from a list of lines — skips backtick-quoted tokens that are not recognisable as file paths (e.g. function signatures, identifiers). */
+function extractFilePaths(lines) {
+    return extractBacktickValues(lines).filter(isFilePath);
+}
+/** Extract commit hashes — 6-64 hex chars from backtick-quoted items */
+function extractCommitHashes(lines) {
+    return extractBacktickValues(lines).filter(v => /^[0-9a-f]{6,64}$/i.test(v));
+}
+export function parseImplData(doc) {
+    const behaviourSection = doc.sections.get('behaviour');
+    const sourceSection = doc.sections.get('source files');
+    const commitsSection = doc.sections.get('commits');
+    const testsSection = doc.sections.get('tests');
+    // Behaviour ref: first non-empty line of the Behaviour section
+    const behaviourRef = behaviourSection?.bodyLines
+        .map(l => l.trim())
+        .find(l => l.length > 0) ?? null;
+    return {
+        behaviourRef,
+        sourceFiles: extractFilePaths(sourceSection?.bodyLines ?? []),
+        commits: extractCommitHashes(commitsSection?.bodyLines ?? []),
+        testFiles: extractFilePaths(testsSection?.bodyLines ?? []),
+    };
+}
+//# sourceMappingURL=impl-reader.js.map

package/dist/core/impl-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impl-reader.js","sourceRoot":"","sources":["../../src/core/impl-reader.ts"],"names":[],"mappings":"AASA,qHAAqH;AACrH,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,iFAAiF;AACjF,SAAS,qBAAqB,CAAC,KAAe;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8JAA8J;AAC9J,SAAS,gBAAgB,CAAC,KAAe;IACvC,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACzD,CAAC;AAED,wEAAwE;AACxE,SAAS,mBAAmB,CAAC,KAAe;IAC1C,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,MAAM,gBAAgB,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE/C,+DAA+D;IAC/D,MAAM,YAAY,GAAG,gBAAgB,EAAE,SAAS;SAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SAClB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;IAEnC,OAAO;QACL,YAAY;QACZ,WAAW,EAAE,gBAAgB,CAAC,aAAa,EAAE,SAAS,IAAI,EAAE,CAAC;QAC7D,OAAO,EAAE,mBAAmB,CAAC,cAAc,EAAE,SAAS,IAAI,EAAE,CAAC;QAC7D,SAAS,EAAE,gBAAgB,CAAC,YAAY,EAAE,SAAS,IAAI,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/core/language.d.ts

@@ -0,0 +1,39 @@
+import type { MarkerType } from '../validators/types.js';
+export type LanguagePack = Record<string, string>;
+/**
+ * Load a language pack by code. Returns null if unsupported or file not found.
+ * Falls back gracefully on missing keys — returns null only for wholly unknown codes.
+ */
+export declare function loadLanguagePack(code: string): LanguagePack | null;
+/** Returns the list of supported language codes. */
+export declare function supportedLanguages(): string[];
+/**
+ * Return the structural keyword keys for conflict detection.
+ * Uses the provided pack, or falls back to the English pack.
+ * Always returns a non-empty list so structural keywords are always protected.
+ */
+export declare function getStructuralKeys(pack: LanguagePack | null): string[];
+/**
+ * Substitute all language pack tokens in content.
+ * Single-pass, sorted by key length descending (longer keys matched first).
+ * Case-sensitive exact string replacement.
+ */
+export declare function substituteTokens(content: string, pack: LanguagePack): string;
+/**
+ * Apply domain vocabulary overrides to content.
+ * Runs after the language pack substitution pass.
+ *
+ * - Declaration-order: keys processed in the order they appear in the map
+ * - Single-pass via placeholder trick (same mechanism as substituteTokens)
+ * - Structural keys (those present in the language pack) are excluded with a warning
+ * - Returns the substituted content and any conflict warnings
+ */
+export declare function applyVocabulary(content: string, vocab: Record<string, string>, structuralKeys: string[]): {
+    result: string;
+    warnings: string[];
+};
+/**
+ * Return required section keys for a given marker type, localised via the pack.
+ * impl.md sections are always English (excluded from localisation by design).
+ */
+export declare function getLocalizedRequiredSections(markerType: MarkerType, pack: LanguagePack | null): string[];

package/dist/core/language.js

@@ -0,0 +1,159 @@
+import { existsSync, readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Packs live at src/languages/ → compiled to dist/languages/ (two levels up from dist/core/)
+const LANGUAGES_DIR = resolve(__dirname, '..', '..', 'languages');
+const SUPPORTED_LANGUAGES = ['en', 'de', 'fr', 'es', 'ja', 'pt'];
+/** English required section keys per marker type (lowercase, as stored in ParsedMarkdown.sections). */
+const ENGLISH_REQUIRED_SECTIONS = {
+    intent: ['stakeholders', 'goal', 'success criteria', 'status'],
+    behaviour: ['actor', 'preconditions', 'main flow', 'postconditions', 'status'],
+    impl: ['behaviour', 'commits', 'tests', 'status'],
+};
+/**
+ * Load a language pack by code. Returns null if unsupported or file not found.
+ * Falls back gracefully on missing keys — returns null only for wholly unknown codes.
+ */
+export function loadLanguagePack(code) {
+    if (!SUPPORTED_LANGUAGES.includes(code))
+        return null;
+    if (code === 'en')
+        return buildEnglishPack();
+    const packPath = resolve(LANGUAGES_DIR, `${code}.json`);
+    if (!existsSync(packPath))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(packPath, 'utf-8'));
+        // Fill missing keys from English defaults with a warning
+        const english = buildEnglishPack();
+        const result = { ...english };
+        for (const [key, value] of Object.entries(raw)) {
+            if (typeof value === 'string' && value.length > 0) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+/** Returns the list of supported language codes. */
+export function supportedLanguages() {
+    return [...SUPPORTED_LANGUAGES];
+}
+/**
+ * Return the structural keyword keys for conflict detection.
+ * Uses the provided pack, or falls back to the English pack.
+ * Always returns a non-empty list so structural keywords are always protected.
+ */
+export function getStructuralKeys(pack) {
+    if (pack)
+        return Object.keys(pack);
+    const english = buildEnglishPack();
+    return Object.keys(english);
+}
+/**
+ * Substitute all language pack tokens in content.
+ * Single-pass, sorted by key length descending (longer keys matched first).
+ * Case-sensitive exact string replacement.
+ */
+export function substituteTokens(content, pack) {
+    if (!pack || Object.keys(pack).length === 0)
+        return content;
+    // Sort entries by key length descending so "Main Flow" is matched before "Flow"
+    const entries = Object.entries(pack).sort((a, b) => b[0].length - a[0].length);
+    // Single-pass: replace each key with a placeholder, then swap placeholders for values
+    // This prevents double-substitution when a value contains another key
+    const placeholders = [];
+    let result = content;
+    for (let i = 0; i < entries.length; i++) {
+        const [key, value] = entries[i];
+        if (key === value)
+            continue; // English pack — no-op
+        const placeholder = `\x00TAPROOT_LANG_${i}\x00`;
+        placeholders.push([placeholder, value]);
+        result = result.split(key).join(placeholder);
+    }
+    for (const [placeholder, value] of placeholders) {
+        result = result.split(placeholder).join(value);
+    }
+    return result;
+}
+/**
+ * Apply domain vocabulary overrides to content.
+ * Runs after the language pack substitution pass.
+ *
+ * - Declaration-order: keys processed in the order they appear in the map
+ * - Single-pass via placeholder trick (same mechanism as substituteTokens)
+ * - Structural keys (those present in the language pack) are excluded with a warning
+ * - Returns the substituted content and any conflict warnings
+ */
+export function applyVocabulary(content, vocab, structuralKeys) {
+    const warnings = [];
+    const structuralLower = new Set(structuralKeys.map(k => k.toLowerCase()));
+    // Filter entries: skip structural conflicts
+    const entries = [];
+    for (const [key, value] of Object.entries(vocab)) {
+        if (structuralLower.has(key.toLowerCase())) {
+            warnings.push(`Vocabulary override '${key}' conflicts with a structural keyword — structural keywords take precedence; override ignored`);
+        }
+        else {
+            entries.push([key, value]);
+        }
+    }
+    if (entries.length === 0)
+        return { result: content, warnings };
+    // Single-pass substitution in declaration order using placeholders
+    const placeholders = [];
+    let result = content;
+    for (let i = 0; i < entries.length; i++) {
+        const [key, value] = entries[i];
+        const placeholder = `\x00TAPROOT_VOCAB_${i}\x00`;
+        placeholders.push([placeholder, value]);
+        result = result.split(key).join(placeholder);
+    }
+    for (const [placeholder, value] of placeholders) {
+        result = result.split(placeholder).join(value);
+    }
+    return { result, warnings };
+}
+/**
+ * Return required section keys for a given marker type, localised via the pack.
+ * impl.md sections are always English (excluded from localisation by design).
+ */
+export function getLocalizedRequiredSections(markerType, pack) {
+    const english = ENGLISH_REQUIRED_SECTIONS[markerType];
+    if (!pack || markerType === 'impl')
+        return english;
+    return english.map(key => {
+        // Find the matching pack entry: pack keys are Title Case, section keys are lowercase
+        const packKey = Object.keys(pack).find(k => k.toLowerCase() === key);
+        if (!packKey)
+            return key; // fallback to English
+        return pack[packKey].toLowerCase();
+    });
+}
+function buildEnglishPack() {
+    const packPath = resolve(LANGUAGES_DIR, 'en.json');
+    if (existsSync(packPath)) {
+        try {
+            return JSON.parse(readFileSync(packPath, 'utf-8'));
+        }
+        catch {
+            // fall through to hardcoded defaults
+        }
+    }
+    // Hardcoded fallback if en.json not found (should never happen in a valid install)
+    return {
+        Goal: 'Goal', Actor: 'Actor', Preconditions: 'Preconditions',
+        'Main Flow': 'Main Flow', 'Alternate Flows': 'Alternate Flows',
+        Postconditions: 'Postconditions', 'Error Conditions': 'Error Conditions',
+        'Acceptance Criteria': 'Acceptance Criteria', Status: 'Status',
+        Stakeholders: 'Stakeholders', 'Success Criteria': 'Success Criteria',
+        Given: 'Given', When: 'When', Then: 'Then',
+        specified: 'specified', implemented: 'implemented', complete: 'complete', active: 'active',
+    };
+}
+//# sourceMappingURL=language.js.map

package/dist/core/language.js.map

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

package/dist/core/markdown-parser.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedMarkdown } from '../validators/types.js';
+export declare function parseMarkdown(filePath: string, content: string): ParsedMarkdown;
+export declare function getSectionLine(doc: ParsedMarkdown, sectionKey: string): number | undefined;

package/dist/core/markdown-parser.js

@@ -0,0 +1,37 @@
+export function parseMarkdown(filePath, content) {
+    const rawLines = content.split('\n');
+    const sections = new Map();
+    let currentHeading = null;
+    let currentStart = 0;
+    let currentBody = [];
+    const flushSection = (endIndex) => {
+        if (currentHeading === null)
+            return;
+        const rawBody = currentBody.join('\n').trim();
+        sections.set(currentHeading.toLowerCase(), {
+            heading: currentHeading,
+            startLine: currentStart,
+            bodyLines: currentBody,
+            rawBody,
+        });
+    };
+    for (let i = 0; i < rawLines.length; i++) {
+        const line = rawLines[i] ?? '';
+        const match = line.match(/^##\s+(.+)$/);
+        if (match) {
+            flushSection(i);
+            currentHeading = (match[1] ?? '').trim();
+            currentStart = i + 1; // 1-indexed line number of the heading itself
+            currentBody = [];
+        }
+        else if (currentHeading !== null) {
+            currentBody.push(line);
+        }
+    }
+    flushSection(rawLines.length);
+    return { filePath, sections, rawLines };
+}
+export function getSectionLine(doc, sectionKey) {
+    return doc.sections.get(sectionKey.toLowerCase())?.startLine;
+}
+//# sourceMappingURL=markdown-parser.js.map

package/dist/core/markdown-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.js","sourceRoot":"","sources":["../../src/core/markdown-parser.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEnD,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAa,EAAE,CAAC;IAE/B,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,EAAE;QACxC,IAAI,cAAc,KAAK,IAAI;YAAE,OAAO;QACpC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE;YACzC,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,YAAY;YACvB,SAAS,EAAE,WAAW;YACtB,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,cAAc,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACzC,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,8CAA8C;YACpE,WAAW,GAAG,EAAE,CAAC;QACnB,CAAC;aAAM,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;YACnC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAmB,EAAE,UAAkB;IACpE,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,SAAS,CAAC;AAC/D,CAAC"}

package/dist/core/reporter.d.ts

@@ -0,0 +1,3 @@
+import type { Violation } from '../validators/types.js';
+export declare function renderViolations(violations: Violation[]): string;
+export declare function exitCode(violations: Violation[]): number;

package/dist/core/reporter.js

@@ -0,0 +1,33 @@
+import chalk from 'chalk';
+export function renderViolations(violations) {
+    if (violations.length === 0) {
+        return chalk.green('✓ No violations found.\n');
+    }
+    const byFile = new Map();
+    for (const v of violations) {
+        const list = byFile.get(v.filePath) ?? [];
+        list.push(v);
+        byFile.set(v.filePath, list);
+    }
+    const lines = [];
+    for (const [filePath, fileViolations] of byFile) {
+        lines.push('');
+        lines.push(chalk.underline(filePath));
+        for (const v of fileViolations) {
+            const location = v.line !== undefined ? `:${v.line}` : '';
+            const severity = v.type === 'error' ? chalk.red('error') : chalk.yellow('warning');
+            lines.push(`  ${filePath}${location}  ${severity}  ${v.message}  ${chalk.gray(v.code)}`);
+        }
+    }
+    const errors = violations.filter(v => v.type === 'error').length;
+    const warnings = violations.filter(v => v.type === 'warning').length;
+    lines.push('');
+    const summary = `${errors} error${errors !== 1 ? 's' : ''}, ${warnings} warning${warnings !== 1 ? 's' : ''}`;
+    lines.push(errors > 0 ? chalk.red(summary) : chalk.yellow(summary));
+    lines.push('');
+    return lines.join('\n');
+}
+export function exitCode(violations) {
+    return violations.some(v => v.type === 'error') ? 1 : 0;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/core/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/core/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,UAAU,gBAAgB,CAAC,UAAuB;IACtD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,MAAM,EAAE,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,GAAG,QAAQ,KAAK,QAAQ,KAAK,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,MAAM,OAAO,GAAG,GAAG,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,WAAW,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC7G,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAAuB;IAC9C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/templates/index.d.ts

@@ -0,0 +1,4 @@
+export declare function intentTemplate(date: string): string;
+export declare function behaviourTemplate(date: string): string;
+export declare function implTemplate(date: string, behaviourRef?: string): string;
+export declare const SECTION_PLACEHOLDERS: Record<string, Record<string, string>>;

package/dist/templates/index.js

@@ -0,0 +1,126 @@
+export function intentTemplate(date) {
+    return `# Intent: <Title>
+
+## Stakeholders
+- <Role>: <Name or team> — <their interest in this intent>
+
+## Goal
+<1-3 sentences describing the desired outcome from the stakeholder's perspective>
+
+## Success Criteria
+- [ ] <Measurable criterion 1>
+- [ ] <Measurable criterion 2>
+
+## Constraints
+- <Constraint 1 (regulatory, technical, timeline, etc.)>
+
+## Status
+- **State:** draft
+- **Created:** ${date}
+- **Last reviewed:** ${date}
+
+## Notes
+<Free-form context, links to external docs, meeting notes, etc.>
+`;
+}
+export function behaviourTemplate(date) {
+    return `# Behaviour: <Title>
+
+## Actor
+<Who or what initiates this behaviour>
+
+## Preconditions
+- <What must be true before this behaviour can occur>
+
+## Main Flow
+1. <Step 1>
+2. <Step 2>
+3. <Step 3>
+
+## Alternate Flows
+### <Alternate flow name>
+- **Trigger:** <When does this alternate flow occur?>
+- **Steps:**
+  1. <Step>
+  2. <Step>
+
+## Postconditions
+- <What is true after successful completion>
+
+## Error Conditions
+- <Error scenario>: <Expected system response>
+
+## Diagram
+<!-- Optional: sequence, flowchart, or state diagram in Mermaid syntax -->
+\`\`\`mermaid
+sequenceDiagram
+  Actor->>System: <trigger>
+  System-->>Actor: <response>
+\`\`\`
+
+## Status
+- **State:** proposed
+- **Created:** ${date}
+- **Last reviewed:** ${date}
+
+## Notes
+<Edge cases, open questions, links to related behaviours>
+`;
+}
+export function implTemplate(date, behaviourRef = '../usecase.md') {
+    return `# Implementation: <Title>
+
+## Behaviour
+${behaviourRef}
+
+## Design Decisions
+- <Decision 1: what was chosen and why>
+
+## Source Files
+- \`<path/to/file.ts>\` — <brief description of what this file does for this implementation>
+
+## Commits
+- \`<hash>\` — <one-line summary>
+
+## Tests
+- \`<path/to/test-file.test.ts>\` — <what scenarios this test covers>
+
+## Status
+- **State:** planned
+- **Created:** ${date}
+- **Last verified:** ${date}
+
+## Notes
+<Technical debt, known limitations, future improvements>
+`;
+}
+export const SECTION_PLACEHOLDERS = {
+    intent: {
+        'stakeholders': '- <Role>: <Name or team> — <their interest in this intent>',
+        'goal': '<1-3 sentences describing the desired outcome from the stakeholder\'s perspective>',
+        'success criteria': '- [ ] <Measurable criterion 1>',
+        'constraints': '- <Constraint 1>',
+        'status': '- **State:** draft\n- **Created:** <YYYY-MM-DD>\n- **Last reviewed:** <YYYY-MM-DD>',
+        'notes': '<Free-form context>',
+    },
+    behaviour: {
+        'actor': '<Who or what initiates this behaviour>',
+        'preconditions': '- <What must be true before this behaviour can occur>',
+        'main flow': '1. <Step 1>\n2. <Step 2>',
+        'alternate flows': '### <Alternate flow name>\n- **Trigger:** <When?>\n- **Steps:**\n  1. <Step>',
+        'postconditions': '- <What is true after successful completion>',
+        'error conditions': '- <Error scenario>: <Expected system response>',
+        'status': '- **State:** proposed\n- **Created:** <YYYY-MM-DD>\n- **Last reviewed:** <YYYY-MM-DD>',
+        'notes': '<Edge cases, open questions>',
+    },
+    impl: {
+        'behaviour': '../usecase.md',
+        'design decisions': '- <Decision 1: what was chosen and why>',
+        'source files': '- `<path/to/file.ts>` — <description>',
+        'commits': '- `<hash>` — <one-line summary>',
+        'tests': '- `<path/to/test.ts>` — <what this covers>',
+        'status': '- **State:** planned\n- **Created:** <YYYY-MM-DD>\n- **Last verified:** <YYYY-MM-DD>',
+        'notes': '<Technical debt, known limitations>',
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO;;;;;;;;;;;;;;;;;iBAiBQ,IAAI;uBACE,IAAI;;;;CAI1B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCQ,IAAI;uBACE,IAAI;;;;CAI1B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,eAAuB,eAAe;IAC/E,OAAO;;;EAGP,YAAY;;;;;;;;;;;;;;;;iBAgBG,IAAI;uBACE,IAAI;;;;CAI1B,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAA2C;IAC1E,MAAM,EAAE;QACN,cAAc,EAAE,4DAA4D;QAC5E,MAAM,EAAE,oFAAoF;QAC5F,kBAAkB,EAAE,gCAAgC;QACpD,aAAa,EAAE,kBAAkB;QACjC,QAAQ,EAAE,oFAAoF;QAC9F,OAAO,EAAE,qBAAqB;KAC/B;IACD,SAAS,EAAE;QACT,OAAO,EAAE,wCAAwC;QACjD,eAAe,EAAE,uDAAuD;QACxE,WAAW,EAAE,0BAA0B;QACvC,iBAAiB,EAAE,8EAA8E;QACjG,gBAAgB,EAAE,8CAA8C;QAChE,kBAAkB,EAAE,gDAAgD;QACpE,QAAQ,EAAE,uFAAuF;QACjG,OAAO,EAAE,8BAA8B;KACxC;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,eAAe;QAC5B,kBAAkB,EAAE,yCAAyC;QAC7D,cAAc,EAAE,uCAAuC;QACvD,SAAS,EAAE,iCAAiC;QAC5C,OAAO,EAAE,4CAA4C;QACrD,QAAQ,EAAE,sFAAsF;QAChG,OAAO,EAAE,qCAAqC;KAC/C;CACF,CAAC"}

package/dist/validators/format-rules.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedMarkdown, MarkerType, TaprootConfig, Violation, FolderNode } from './types.js';
+import type { LanguagePack } from '../core/language.js';
+export declare function checkRequiredSections(doc: ParsedMarkdown, markerType: MarkerType, pack?: LanguagePack | null): Violation[];
+export declare function checkStatusValue(doc: ParsedMarkdown, markerType: MarkerType, config: TaprootConfig): Violation[];
+export declare function checkDateFormat(doc: ParsedMarkdown, config: TaprootConfig): Violation[];
+export declare function checkBehaviourReference(doc: ParsedMarkdown, implFilePath: string): Violation[];
+export declare function checkDiagramSection(doc: ParsedMarkdown): Violation[];
+export declare function checkLinkSection(doc: ParsedMarkdown, node: FolderNode): Violation[];
+export declare function checkAcceptanceCriteria(doc: ParsedMarkdown, node: FolderNode, pack?: LanguagePack | null): Violation[];
+export declare function validateFormat(doc: ParsedMarkdown, markerType: MarkerType, config: TaprootConfig, node?: FolderNode, pack?: LanguagePack | null): Violation[];