@imix-js/taproot 0.2.0

package/dist/commands/acceptance-check.js

@@ -0,0 +1,213 @@
+import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
+import { join, resolve } from 'path';
+import { loadConfig } from '../core/config.js';
+import { walkHierarchy, flattenTree } from '../core/fs-walker.js';
+import { parseMarkdown } from '../core/markdown-parser.js';
+const DEFAULT_TEST_DIRS = ['test', 'tests', 'spec'];
+const AC_ID_IN_SPEC = /^\*\*AC-(\d+):/gm;
+const DEPRECATED_AC_LINE = /^~~\*\*AC-\d+.*$/gm;
+const AC_ID_IN_TEST = /AC-(\d+)/g;
+export function registerAcceptanceCheck(program) {
+    program
+        .command('acceptance-check')
+        .description('Verify acceptance criteria coverage: every AC-N in specs must appear in a test file')
+        .option('--path <path>', 'Root path to collect criteria from (overrides config)')
+        .option('--tests <dir>', 'Test directory to scan (repeatable; defaults to test/, tests/, spec/)', collect, [])
+        .option('--format <fmt>', 'Output format: text or json (default: text)')
+        .action(async (options) => {
+        const cwd = process.cwd();
+        const { config, configDir } = loadConfig(cwd);
+        const rootPath = options.path
+            ? resolve(options.path)
+            : config.root.startsWith('/') ? config.root : resolve(configDir, config.root);
+        const testDirs = options.tests.length > 0
+            ? options.tests.map(d => resolve(d))
+            : DEFAULT_TEST_DIRS.map(d => resolve(cwd, d)).filter(existsSync);
+        if (testDirs.length === 0) {
+            process.stderr.write('No test directory found — checked test/, tests/, spec/. Use --tests <dir> to specify.\n');
+            process.exitCode = 1;
+            return;
+        }
+        const report = runAcceptanceCheck(rootPath, testDirs);
+        if (options.format === 'json') {
+            process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+        }
+        else {
+            printReport(report);
+        }
+        if (report.uncovered.length > 0 || report.orphaned.length > 0) {
+            process.exitCode = 1;
+        }
+    });
+}
+function collect(val, acc) {
+    acc.push(val);
+    return acc;
+}
+export function runAcceptanceCheck(rootPath, testDirs) {
+    const specCriteria = collectCriteria(rootPath);
+    const testRefs = scanTestFiles(testDirs);
+    const missingSections = collectMissingSections(rootPath);
+    const specIds = new Set(specCriteria.map(c => c.id));
+    const testIds = new Set(testRefs.map(t => t.id));
+    const covered = [...specIds].filter(id => testIds.has(id));
+    const uncovered = specCriteria.filter(c => !testIds.has(c.id));
+    const orphaned = testRefs.filter(t => !specIds.has(t.id));
+    return { specCriteria, covered, uncovered, orphaned, missingSections };
+}
+/** Walk the hierarchy and extract AC-N IDs from ## Acceptance Criteria sections. */
+export function collectCriteria(rootPath) {
+    if (!existsSync(rootPath))
+        return [];
+    const tree = walkHierarchy(rootPath);
+    const nodes = flattenTree(tree).filter(n => n.marker === 'behaviour');
+    const refs = [];
+    for (const node of nodes) {
+        const filePath = join(node.absolutePath, 'usecase.md');
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const doc = parseMarkdown(filePath, content);
+        const acSection = doc.sections.get('acceptance criteria');
+        if (!acSection)
+            continue;
+        // Strip deprecated criteria lines (~~**AC-N: ...) before matching
+        const body = acSection.rawBody.replace(DEPRECATED_AC_LINE, '');
+        AC_ID_IN_SPEC.lastIndex = 0;
+        let m;
+        while ((m = AC_ID_IN_SPEC.exec(body)) !== null) {
+            refs.push({ id: `AC-${m[1]}`, usecasePath: filePath });
+        }
+    }
+    return refs;
+}
+/** Collect usecase.md files that have impl children but no ## Acceptance Criteria section. */
+export function collectMissingSections(rootPath) {
+    if (!existsSync(rootPath))
+        return [];
+    const tree = walkHierarchy(rootPath);
+    const nodes = flattenTree(tree).filter(n => n.marker === 'behaviour');
+    const missing = [];
+    for (const node of nodes) {
+        const hasImpl = node.children.some(c => c.marker === 'impl');
+        if (!hasImpl)
+            continue;
+        const filePath = join(node.absolutePath, 'usecase.md');
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const doc = parseMarkdown(filePath, content);
+        if (!doc.sections.has('acceptance criteria')) {
+            missing.push(filePath);
+        }
+    }
+    return missing;
+}
+/** Walk test directories and collect all AC-N references with file+line. */
+export function scanTestFiles(testDirs) {
+    const refs = [];
+    for (const dir of testDirs) {
+        if (existsSync(dir))
+            walkTestDir(dir, refs);
+    }
+    return refs;
+}
+function walkTestDir(dir, refs) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry);
+        try {
+            if (statSync(full).isDirectory()) {
+                walkTestDir(full, refs);
+            }
+            else if (isTestFile(entry)) {
+                scanFile(full, refs);
+            }
+        }
+        catch {
+            // skip unreadable entries
+        }
+    }
+}
+function isTestFile(name) {
+    return /\.(test|spec)\.[jt]sx?$/.test(name) || /\.(test|spec)\.py$/.test(name);
+}
+function scanFile(filePath, refs) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        AC_ID_IN_TEST.lastIndex = 0;
+        let m;
+        while ((m = AC_ID_IN_TEST.exec(line)) !== null) {
+            if (m[1])
+                refs.push({ id: `AC-${m[1]}`, file: filePath, line: i + 1 });
+        }
+    }
+}
+function printReport(report) {
+    const behaviourCount = new Set(report.specCriteria.map(c => c.usecasePath)).size;
+    const totalSpec = report.specCriteria.length;
+    if (report.uncovered.length === 0 && report.orphaned.length === 0 && report.missingSections.length === 0) {
+        process.stdout.write(`✓ ${totalSpec} criteria covered across ${behaviourCount} behaviours\n`);
+        return;
+    }
+    if (report.covered.length > 0) {
+        process.stdout.write(`✓ ${report.covered.length} criteria covered\n\n`);
+    }
+    if (report.uncovered.length > 0) {
+        process.stdout.write(`✗ Uncovered criteria (defined in spec, missing from tests):\n`);
+        for (const c of report.uncovered) {
+            process.stdout.write(`  ${c.id}  ${c.usecasePath}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    if (report.orphaned.length > 0) {
+        const seen = new Set();
+        process.stdout.write(`✗ Orphaned references (in tests, not defined in any spec):\n`);
+        for (const t of report.orphaned) {
+            const key = `${t.id}:${t.file}:${t.line}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            process.stdout.write(`  ${t.id}  ${t.file}:${t.line}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    if (report.missingSections.length > 0) {
+        process.stdout.write(`⚠ Missing ## Acceptance Criteria sections:\n`);
+        for (const p of report.missingSections) {
+            process.stdout.write(`  ${p}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    const parts = [];
+    if (report.uncovered.length > 0)
+        parts.push(`${report.uncovered.length} uncovered`);
+    if (report.orphaned.length > 0)
+        parts.push(`${report.orphaned.length} orphaned`);
+    if (report.missingSections.length > 0)
+        parts.push(`${report.missingSections.length} missing section`);
+    process.stdout.write(parts.join(', ') + '\n');
+}
+//# sourceMappingURL=acceptance-check.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+import type { Violation } from '../validators/types.js';
+export declare function registerCheckOrphans(program: Command): void;
+export declare function runCheckOrphans(options: {
+    path?: string;
+    includeUnimplemented?: boolean;
+    cwd?: string;
+}): Promise<Violation[]>;

package/dist/commands/check-orphans.js

@@ -0,0 +1,157 @@
+import { readFileSync, existsSync } from 'fs';
+import { join, resolve, dirname } from 'path';
+import { loadConfig } from '../core/config.js';
+import { walkHierarchy, flattenTree } from '../core/fs-walker.js';
+import { parseMarkdown } from '../core/markdown-parser.js';
+import { parseImplData } from '../core/impl-reader.js';
+import { commitExists, isGitRepo, getRepoRoot } from '../core/git.js';
+import { renderViolations, exitCode } from '../core/reporter.js';
+export function registerCheckOrphans(program) {
+    program
+        .command('check-orphans')
+        .description('Find disconnected nodes and broken references in the hierarchy')
+        .option('--path <path>', 'Root path (overrides config)')
+        .option('--include-unimplemented', 'Also report behaviours with no implementations')
+        .action(async (options) => {
+        const violations = await runCheckOrphans({
+            path: options.path,
+            includeUnimplemented: options.includeUnimplemented ?? false,
+        });
+        process.stdout.write(renderViolations(violations));
+        process.exit(exitCode(violations));
+    });
+}
+export async function runCheckOrphans(options) {
+    const { config, configDir } = loadConfig(options.cwd);
+    const rootPath = options.path ? resolve(options.path) : config.root;
+    const cwd = options.cwd ?? process.cwd();
+    const repoRoot = isGitRepo(cwd) ? (getRepoRoot(cwd) ?? cwd) : null;
+    const tree = walkHierarchy(rootPath);
+    const nodes = flattenTree(tree);
+    const violations = [];
+    for (const node of nodes) {
+        if (node.marker === 'impl') {
+            violations.push(...checkImplReferences(node, repoRoot));
+        }
+        if (node.marker === 'behaviour' && options.includeUnimplemented) {
+            violations.push(...checkUnimplementedBehaviour(node));
+        }
+    }
+    return violations;
+}
+function checkImplReferences(node, repoRoot) {
+    const filePath = join(node.absolutePath, 'impl.md');
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [{
+                type: 'error',
+                filePath,
+                code: 'UNREADABLE_IMPL',
+                message: `Could not read impl.md`,
+            }];
+    }
+    const doc = parseMarkdown(filePath, content);
+    const data = parseImplData(doc);
+    const violations = [];
+    // Skip all reference checks for deferred impls
+    const statusSection = doc.sections.get('status');
+    const stateMatch = statusSection ? /\*\*State:\*\*\s*(\S+)/.exec(statusSection.rawBody) : null;
+    if (stateMatch?.[1]?.trim() === 'deferred')
+        return [];
+    // Check behaviour reference
+    if (data.behaviourRef) {
+        const resolvedRef = resolve(dirname(filePath), data.behaviourRef);
+        if (!existsSync(resolvedRef)) {
+            const behaviourSection = doc.sections.get('behaviour');
+            violations.push({
+                type: 'error',
+                filePath,
+                line: behaviourSection?.startLine,
+                code: 'BROKEN_BEHAVIOUR_REF',
+                message: `Behaviour reference "${data.behaviourRef}" does not exist`,
+            });
+        }
+    }
+    // Check source files exist
+    for (const srcFile of data.sourceFiles) {
+        const resolved = resolveProjectPath(srcFile, repoRoot, node.absolutePath);
+        if (resolved && !existsSync(resolved)) {
+            violations.push({
+                type: 'error',
+                filePath,
+                code: 'MISSING_SOURCE_FILE',
+                message: `Source file "${srcFile}" does not exist on disk`,
+            });
+        }
+    }
+    // Check test files exist
+    for (const testFile of data.testFiles) {
+        const resolved = resolveProjectPath(testFile, repoRoot, node.absolutePath);
+        if (resolved && !existsSync(resolved)) {
+            violations.push({
+                type: 'warning',
+                filePath,
+                code: 'MISSING_TEST_FILE',
+                message: `Test file "${testFile}" does not exist on disk`,
+            });
+        }
+    }
+    // Check commit hashes exist in git history
+    if (repoRoot) {
+        for (const hash of data.commits) {
+            if (!commitExists(hash, repoRoot)) {
+                violations.push({
+                    type: 'warning',
+                    filePath,
+                    code: 'COMMIT_NOT_FOUND',
+                    message: `Commit "${hash}" does not exist in git history`,
+                });
+            }
+        }
+    }
+    return violations;
+}
+function readBehaviourState(node) {
+    try {
+        const content = readFileSync(join(node.absolutePath, 'usecase.md'), 'utf-8');
+        const doc = parseMarkdown(join(node.absolutePath, 'usecase.md'), content);
+        const match = /\*\*State:\*\*\s*(\S+)/.exec(doc.sections.get('status')?.rawBody ?? '');
+        return match?.[1]?.trim() ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function checkUnimplementedBehaviour(node) {
+    const hasImplChild = node.children.some(c => c.marker === 'impl');
+    if (hasImplChild)
+        return [];
+    if (readBehaviourState(node) === 'deferred')
+        return [];
+    return [{
+            type: 'warning',
+            filePath: join(node.absolutePath, 'usecase.md'),
+            code: 'UNIMPLEMENTED_BEHAVIOUR',
+            message: `Behaviour "${node.name}" has no implementation folders`,
+        }];
+}
+/**
+ * Try to resolve a project-relative path.
+ * Paths starting with src/, test/, etc. are resolved from repo root.
+ * Relative paths (../foo) are resolved from the impl folder.
+ */
+/**
+ * Try to resolve a project-relative path.
+ * Relative paths (../foo, ./foo) resolve from the impl folder.
+ * Other paths (src/foo.ts) resolve from repo root, falling back to cwd.
+ */
+function resolveProjectPath(filePath, repoRoot, implDir) {
+    if (filePath.startsWith('./') || filePath.startsWith('../')) {
+        return resolve(implDir, filePath);
+    }
+    return resolve(repoRoot ?? process.cwd(), filePath);
+}
+//# sourceMappingURL=check-orphans.js.map

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

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

package/dist/commands/commithook.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from 'commander';
+import { type LanguagePack } from '../core/language.js';
+/** Walk all impl.md files on disk and build a map of source file path → impl.md path. */
+export declare function buildSourceToImplMap(cwd: string): Map<string, string>;
+export interface SpecFailure {
+    file: string;
+    message: string;
+    hint: string;
+}
+export declare function checkUsecaseQuality(filePath: string, content: string, pack?: LanguagePack | null): SpecFailure[];
+export declare function checkIntentQuality(filePath: string, content: string, pack?: LanguagePack | null): SpecFailure[];
+export declare function runCommithook(options: {
+    cwd: string;
+}): Promise<number>;
+export declare function registerCommithook(program: Command): void;