@imix-js/taproot 0.2.0

package/dist/commands/update.js

@@ -0,0 +1,309 @@
+import { existsSync, rmSync, readdirSync, readFileSync, writeFileSync, unlinkSync, mkdirSync, renameSync } from 'fs';
+import { join, dirname, relative, resolve } from 'path';
+import { buildConfigurationMd } from '../core/configuration.js';
+import { generateAdapters } from '../adapters/index.js';
+import { installSkills, installDocs, SKILL_FILES } from './init.js';
+import { runOverview } from './overview.js';
+import { DEFAULT_CONFIG, loadConfig } from '../core/config.js';
+import { loadLanguagePack, supportedLanguages } from '../core/language.js';
+import { walkHierarchy, flattenTree } from '../core/fs-walker.js';
+const TAPROOT_START = '<!-- TAPROOT:START -->';
+// Stale paths left behind by older taproot versions
+const STALE_PATHS = [
+    '.claude/skills/taproot', // pre-tr- layout: skills were in a subdirectory
+    // tr- files that lived in skills/ before moving to commands/
+    // resolved dynamically for globbing — see removeStale()
+];
+function detectInstalledAgents(cwd) {
+    const installed = [];
+    // claude: tr-*.md files in .claude/commands/ (current), .claude/skills/ (old), or taproot/ subdir (oldest)
+    const claudeCommandsDir = join(cwd, '.claude', 'commands');
+    const claudeSkillsDir = join(cwd, '.claude', 'skills');
+    const oldClaudeSubdir = join(cwd, '.claude', 'skills', 'taproot');
+    if ((existsSync(claudeCommandsDir) && readdirSync(claudeCommandsDir).some(f => f.startsWith('tr-'))) ||
+        existsSync(oldClaudeSubdir) ||
+        (existsSync(claudeSkillsDir) && readdirSync(claudeSkillsDir).some(f => f.startsWith('tr-')))) {
+        installed.push('claude');
+    }
+    // cursor: .cursor/rules/taproot.md
+    if (existsSync(join(cwd, '.cursor', 'rules', 'taproot.md'))) {
+        installed.push('cursor');
+    }
+    // copilot: .github/copilot-instructions.md containing taproot section
+    const copilotPath = join(cwd, '.github', 'copilot-instructions.md');
+    if (existsSync(copilotPath) && readFileSync(copilotPath, 'utf-8').includes(TAPROOT_START)) {
+        installed.push('copilot');
+    }
+    // windsurf: .windsurfrules containing taproot section
+    const windsurfPath = join(cwd, '.windsurfrules');
+    if (existsSync(windsurfPath) && readFileSync(windsurfPath, 'utf-8').includes(TAPROOT_START)) {
+        installed.push('windsurf');
+    }
+    // generic: AGENTS.md containing taproot section
+    const agentsPath = join(cwd, 'AGENTS.md');
+    if (existsSync(agentsPath) && readFileSync(agentsPath, 'utf-8').includes(TAPROOT_START)) {
+        installed.push('generic');
+    }
+    return installed;
+}
+function removeStale(cwd) {
+    const messages = [];
+    // Remove old taproot/ subdirectory
+    const oldSubdir = join(cwd, '.claude', 'skills', 'taproot');
+    if (existsSync(oldSubdir)) {
+        rmSync(oldSubdir, { recursive: true, force: true });
+        messages.push(`removed  .claude/skills/taproot`);
+    }
+    // Remove tr-*.md files that were placed in .claude/skills/ (before commands/ layout)
+    const claudeSkillsDir = join(cwd, '.claude', 'skills');
+    if (existsSync(claudeSkillsDir)) {
+        for (const f of readdirSync(claudeSkillsDir)) {
+            if (f.startsWith('tr-') && f.endsWith('.md')) {
+                unlinkSync(join(claudeSkillsDir, f));
+                messages.push(`removed  .claude/skills/${f}`);
+            }
+        }
+    }
+    // Migrate taproot/skills/ → .taproot/skills/
+    const oldSkillsDir = join(cwd, DEFAULT_CONFIG.root, 'skills');
+    const newSkillsDir = join(cwd, '.taproot', 'skills');
+    if (existsSync(oldSkillsDir) && !existsSync(newSkillsDir)) {
+        mkdirSync(join(cwd, '.taproot'), { recursive: true });
+        renameSync(oldSkillsDir, newSkillsDir);
+        messages.push(`migrated taproot/skills/ → .taproot/skills/`);
+    }
+    else if (existsSync(oldSkillsDir)) {
+        rmSync(oldSkillsDir, { recursive: true, force: true });
+        messages.push(`removed  taproot/skills/ (already migrated to .taproot/skills/)`);
+    }
+    // Remove taproot/_brainstorms/
+    const brainsDir = join(cwd, DEFAULT_CONFIG.root, '_brainstorms');
+    if (existsSync(brainsDir)) {
+        rmSync(brainsDir, { recursive: true, force: true });
+        messages.push(`removed  taproot/_brainstorms/`);
+    }
+    // Migrate old pre-commit hook content to taproot commithook
+    const hookPath = join(cwd, '.git', 'hooks', 'pre-commit');
+    if (existsSync(hookPath)) {
+        const hookContent = readFileSync(hookPath, 'utf-8');
+        if (hookContent.includes('validate-structure') || hookContent.includes('validate-format')) {
+            writeFileSync(hookPath, '#!/bin/sh\ntaproot commithook\n', { mode: 0o755 });
+            messages.push(`migrated .git/hooks/pre-commit → taproot commithook`);
+        }
+    }
+    return messages;
+}
+function extractTitle(content, fallback) {
+    const m = content.match(/^# (?:[^:\n]+: )?(.+)$/m);
+    return m?.[1]?.trim() ?? fallback;
+}
+function upsertLinkSection(content, docPath, sectionTitle, childNodes, childDoc) {
+    const managedHeader = `## ${sectionTitle} <!-- taproot-managed -->`;
+    // Build desired links: rel path → title
+    const desiredLinks = [];
+    for (const child of childNodes) {
+        const childDocPath = join(child.absolutePath, childDoc);
+        if (!existsSync(childDocPath))
+            continue;
+        const rel = './' + relative(dirname(docPath), childDocPath).replace(/\\/g, '/');
+        const childContent = readFileSync(childDocPath, 'utf-8');
+        desiredLinks.push({ rel, title: extractTitle(childContent, child.name) });
+    }
+    const lines = content.split('\n');
+    // Find section start: any "## <Title>" line (with or without managed comment)
+    const sectionPattern = new RegExp(`^## ${sectionTitle}(\\s|$)`);
+    const sectionStartIdx = lines.findIndex(l => sectionPattern.test(l));
+    if (sectionStartIdx === -1) {
+        if (desiredLinks.length === 0)
+            return content;
+        // Insert before ## Status or append at end
+        const statusIdx = lines.findIndex(l => /^## Status(\s|$)/.test(l));
+        const newBlock = [managedHeader, ...desiredLinks.map(l => `- [${l.title}](${l.rel})`), ''];
+        if (statusIdx !== -1) {
+            lines.splice(statusIdx, 0, ...newBlock, '');
+        }
+        else {
+            if (lines[lines.length - 1] !== '')
+                lines.push('');
+            lines.push(...newBlock);
+        }
+        return lines.join('\n');
+    }
+    // Find section end: next "## " heading or EOF
+    let sectionEndIdx = lines.length;
+    for (let i = sectionStartIdx + 1; i < lines.length; i++) {
+        if (/^## /.test(lines[i])) {
+            sectionEndIdx = i;
+            break;
+        }
+    }
+    // Process body lines: prune stale links, collect existing
+    const bodyLines = lines.slice(sectionStartIdx + 1, sectionEndIdx);
+    const existingRels = new Set();
+    const prunedBody = [];
+    for (const line of bodyLines) {
+        const linkMatch = line.match(/\[.*?\]\((.+?)\)/);
+        if (linkMatch) {
+            const rel = linkMatch[1];
+            const resolved = resolve(dirname(docPath), rel);
+            if (!existsSync(resolved))
+                continue; // prune stale
+            existingRels.add(rel);
+        }
+        prunedBody.push(line);
+    }
+    // Append missing links
+    for (const { rel, title } of desiredLinks) {
+        if (!existingRels.has(rel)) {
+            prunedBody.push(`- [${title}](${rel})`);
+        }
+    }
+    // Replace the section (update header to managed form, replace body)
+    lines.splice(sectionStartIdx, sectionEndIdx - sectionStartIdx, managedHeader, ...prunedBody);
+    return lines.join('\n');
+}
+export function refreshLinks(cwd, taprootDir) {
+    const messages = [];
+    if (!existsSync(taprootDir))
+        return messages;
+    const tree = walkHierarchy(taprootDir);
+    const nodes = flattenTree(tree).filter(n => n.marker === 'intent' || n.marker === 'behaviour');
+    for (const node of nodes) {
+        const markerFile = node.marker === 'intent' ? 'intent.md' : 'usecase.md';
+        const docPath = join(node.absolutePath, markerFile);
+        if (!existsSync(docPath))
+            continue;
+        const childMarker = node.marker === 'intent' ? 'behaviour' : 'impl';
+        const childDoc = childMarker === 'behaviour' ? 'usecase.md' : 'impl.md';
+        const sectionTitle = node.marker === 'intent' ? 'Behaviours' : 'Implementations';
+        const childNodes = node.children.filter(c => c.marker === childMarker);
+        const content = readFileSync(docPath, 'utf-8');
+        const updated = upsertLinkSection(content, docPath, sectionTitle, childNodes, childDoc);
+        if (updated !== content) {
+            writeFileSync(docPath, updated, 'utf-8');
+            messages.push(`updated  ${relative(cwd, docPath)}`);
+        }
+    }
+    return messages;
+}
+export async function runUpdate(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const messages = [];
+    // Validate language pack before modifying any files (AC-4)
+    const { config } = loadConfig(cwd);
+    let pack = null;
+    if (config.language) {
+        pack = loadLanguagePack(config.language);
+        if (!pack) {
+            messages.push(`error    Unknown language pack '${config.language}'. ` +
+                `Supported: ${supportedLanguages().join(', ')}. ` +
+                `No files modified.`);
+            return messages;
+        }
+        messages.push(`language ${config.language} (${Object.keys(pack).length} tokens)`);
+    }
+    // Validate vocabulary overrides before modifying any files
+    const vocab = config.vocabulary ?? null;
+    if (vocab && Object.keys(vocab).length > 0) {
+        const emptyKeys = Object.entries(vocab)
+            .filter(([, v]) => v === '')
+            .map(([k]) => k);
+        if (emptyKeys.length > 0) {
+            for (const key of emptyKeys) {
+                messages.push(`error    Vocabulary override '${key}' maps to an empty string — ` +
+                    `this would silently delete the term from skill files. ` +
+                    `Provide a non-empty replacement or remove the key.`);
+            }
+            messages.push('No files modified.');
+            return messages;
+        }
+        messages.push(`vocabulary ${Object.keys(vocab).length} overrides`);
+    }
+    const agents = detectInstalledAgents(cwd);
+    if (agents.length === 0) {
+        messages.push('No taproot agent adapters detected — nothing to update.');
+        messages.push('Run `taproot init --agent <name>` to install adapters.');
+        return Promise.resolve(messages);
+    }
+    messages.push(`Detected adapters: ${agents.join(', ')}`);
+    messages.push('');
+    // Remove stale paths from old versions
+    messages.push(...removeStale(cwd));
+    // Regenerate detected adapters
+    for (const agent of agents) {
+        const results = generateAdapters(agent, cwd);
+        for (const result of results) {
+            for (const file of result.files) {
+                const rel = file.path.replace(cwd + '/', '').replace(cwd + '\\', '');
+                const verb = file.status === 'created' ? 'created' : file.status === 'updated' ? 'updated' : 'exists  ';
+                messages.push(`${verb}  ${rel}`);
+            }
+        }
+    }
+    // Refresh/install skills — always when claude adapter is present, otherwise only if already installed
+    const skillsDir = join(cwd, '.taproot', 'skills');
+    const hasInstalledSkills = existsSync(skillsDir) &&
+        SKILL_FILES.some(f => existsSync(join(skillsDir, f)));
+    if (agents.includes('claude') || hasInstalledSkills) {
+        messages.push('');
+        messages.push(...installSkills(skillsDir, true, pack, vocab));
+        messages.push(...installDocs(join(cwd, '.taproot', 'docs'), true));
+    }
+    // Install or refresh .taproot/CONFIGURATION.md (AC-6/AC-7 of update-adapters-and-skills)
+    const taprootConfigDir = join(cwd, '.taproot');
+    const configMdPath = join(taprootConfigDir, 'CONFIGURATION.md');
+    try {
+        mkdirSync(taprootConfigDir, { recursive: true });
+        const content = buildConfigurationMd();
+        const existed = existsSync(configMdPath);
+        writeFileSync(configMdPath, content, 'utf-8');
+        messages.push('');
+        messages.push(`${existed ? 'updated' : 'created'}  .taproot/CONFIGURATION.md`);
+    }
+    catch (err) {
+        messages.push(`warning  Could not write .taproot/CONFIGURATION.md: ${err.message}`);
+    }
+    // Refresh cross-links (## Behaviours / ## Implementations sections)
+    const taprootDir = join(cwd, DEFAULT_CONFIG.root);
+    const linkMsgs = refreshLinks(cwd, taprootDir);
+    if (linkMsgs.length > 0) {
+        messages.push('');
+        messages.push(...linkMsgs);
+    }
+    // Regenerate OVERVIEW.md
+    const overviewMsgs = await runOverview({ taprootDir, cwd });
+    if (overviewMsgs.length > 0) {
+        messages.push('');
+        messages.push(...overviewMsgs);
+    }
+    // Install hook if --with-hooks and none exists
+    if (options.withHooks) {
+        const hookDir = join(cwd, '.git', 'hooks');
+        const hookPath = join(hookDir, 'pre-commit');
+        if (existsSync(join(cwd, '.git')) && !existsSync(hookPath)) {
+            mkdirSync(hookDir, { recursive: true });
+            writeFileSync(hookPath, '#!/bin/sh\ntaproot commithook\n', { mode: 0o755 });
+            messages.push(`created  .git/hooks/pre-commit`);
+        }
+        else if (existsSync(hookPath)) {
+            messages.push(`exists   .git/hooks/pre-commit`);
+        }
+    }
+    messages.push('');
+    messages.push('Update complete.');
+    return messages;
+}
+export function registerUpdate(program) {
+    program
+        .command('update')
+        .description('Regenerate agent adapters and refresh installed skills')
+        .option('--path <path>', 'Project directory to update', process.cwd())
+        .option('--with-hooks', 'Install pre-commit hook if not already present')
+        .action(async (options) => {
+        const msgs = await runUpdate({ cwd: options.path, withHooks: options.withHooks });
+        for (const msg of msgs) {
+            process.stdout.write(msg + '\n');
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/commands/validate-format.d.ts

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

package/dist/commands/validate-format.js

@@ -0,0 +1,93 @@
+import { resolve, join } from 'path';
+import { readFileSync, writeFileSync } from 'fs';
+import { loadConfig } from '../core/config.js';
+import { loadLanguagePack, supportedLanguages } from '../core/language.js';
+import { walkHierarchy, flattenTree } from '../core/fs-walker.js';
+import { parseMarkdown } from '../core/markdown-parser.js';
+import { validateFormat } from '../validators/format-rules.js';
+import { renderViolations, exitCode } from '../core/reporter.js';
+import { SECTION_PLACEHOLDERS } from '../templates/index.js';
+const MARKER_FILE = {
+    intent: 'intent.md',
+    behaviour: 'usecase.md',
+    impl: 'impl.md',
+};
+export function registerValidateFormat(program) {
+    program
+        .command('validate-format')
+        .description('Validate marker file contents against their schemas')
+        .option('--path <path>', 'Root path to validate (overrides config)')
+        .option('--fix', 'Add missing section headers with placeholder content')
+        .action(async (options) => {
+        const violations = await runValidateFormat({
+            path: options.path,
+            fix: options.fix ?? false,
+        });
+        process.stdout.write(renderViolations(violations));
+        process.exit(exitCode(violations));
+    });
+}
+export async function runValidateFormat(options) {
+    const { config, configDir } = loadConfig(options.cwd);
+    const rootPath = options.path
+        ? resolve(options.path)
+        : config.root.startsWith('/') ? config.root : resolve(configDir, config.root);
+    // Load language pack if configured
+    let pack = null;
+    if (config.language) {
+        pack = loadLanguagePack(config.language);
+        if (!pack) {
+            process.stderr.write(`Warning: Language pack '${config.language}' could not be loaded — falling back to English. ` +
+                `Supported: ${supportedLanguages().join(', ')}. Check your taproot installation.\n`);
+        }
+    }
+    const tree = walkHierarchy(rootPath);
+    const nodes = flattenTree(tree).filter((n) => n.marker !== null);
+    const violations = [];
+    for (const node of nodes) {
+        const markerFile = MARKER_FILE[node.marker];
+        const filePath = join(node.absolutePath, markerFile);
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            violations.push({
+                type: 'error',
+                filePath,
+                code: 'UNREADABLE_FILE',
+                message: `Could not read file: ${filePath}`,
+            });
+            continue;
+        }
+        const parsed = parseMarkdown(filePath, content);
+        const nodeViolations = validateFormat(parsed, node.marker, config, node, pack);
+        if (options.fix && nodeViolations.some(v => v.code === 'MISSING_SECTION')) {
+            const fixed = applyFix(content, parsed, node.marker);
+            writeFileSync(filePath, fixed, 'utf-8');
+            // Re-parse and re-validate after fix
+            const reparsed = parseMarkdown(filePath, fixed);
+            violations.push(...validateFormat(reparsed, node.marker, config, node));
+        }
+        else {
+            violations.push(...nodeViolations);
+        }
+    }
+    return violations;
+}
+function applyFix(content, parsed, markerType) {
+    const placeholders = SECTION_PLACEHOLDERS[markerType] ?? {};
+    const required = markerType === 'intent' ? ['stakeholders', 'goal', 'success criteria', 'status'] :
+        markerType === 'behaviour' ? ['actor', 'preconditions', 'main flow', 'postconditions', 'status'] :
+            ['behaviour', 'commits', 'tests', 'status'];
+    const missing = required.filter(s => !parsed.sections.has(s));
+    if (missing.length === 0)
+        return content;
+    const additions = missing.map(section => {
+        const placeholder = placeholders[section] ?? '<placeholder>';
+        const heading = section.replace(/\b\w/g, c => c.toUpperCase());
+        return `\n## ${heading}\n${placeholder}\n`;
+    });
+    return content.trimEnd() + '\n' + additions.join('');
+}
+//# sourceMappingURL=validate-format.js.map

package/dist/commands/validate-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-format.js","sourceRoot":"","sources":["../../src/commands/validate-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D,MAAM,WAAW,GAA+B;IAC9C,MAAM,EAAE,WAAW;IACnB,SAAS,EAAE,YAAY;IACvB,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,OAAO,EAAE,sDAAsD,CAAC;SACvE,MAAM,CAAC,KAAK,EAAE,OAAyC,EAAE,EAAE;QAC1D,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC;YACzC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;SAC1B,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAIvC;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI;QAC3B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhF,mCAAmC;IACnC,IAAI,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,MAAM,CAAC,QAAQ,mDAAmD;gBAC7F,cAAc,kBAAkB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAA4C,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IAE3G,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACrD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,QAAQ;gBACR,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,wBAAwB,QAAQ,EAAE;aAC5C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE/E,IAAI,OAAO,CAAC,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,EAAE,CAAC;YAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACrD,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACxC,qCAAqC;YACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAChD,UAAU,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,MAAwC,EAAE,UAAsB;IACjG,MAAM,YAAY,GAAG,oBAAoB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC5D,MAAM,QAAQ,GACZ,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClF,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC;YAClG,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QACtC,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,OAAO,QAAQ,OAAO,KAAK,WAAW,IAAI,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/commands/validate-structure.d.ts

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

package/dist/commands/validate-structure.js

@@ -0,0 +1,29 @@
+import { resolve } from 'path';
+import { loadConfig } from '../core/config.js';
+import { walkHierarchy } from '../core/fs-walker.js';
+import { validateStructure } from '../validators/structure-rules.js';
+import { renderViolations, exitCode } from '../core/reporter.js';
+export function registerValidateStructure(program) {
+    program
+        .command('validate-structure')
+        .description('Validate folder hierarchy nesting rules')
+        .option('--path <path>', 'Root path to validate (overrides config)')
+        .option('--strict', 'Also warn on empty folders and missing optional fields')
+        .action(async (options) => {
+        const violations = await runValidateStructure({
+            path: options.path,
+            strict: options.strict ?? false,
+        });
+        process.stdout.write(renderViolations(violations));
+        process.exit(exitCode(violations));
+    });
+}
+export async function runValidateStructure(options) {
+    const { config, configDir } = loadConfig(options.cwd);
+    const rootPath = options.path
+        ? resolve(options.path)
+        : config.root.startsWith('/') ? config.root : resolve(configDir, config.root);
+    const tree = walkHierarchy(rootPath);
+    return validateStructure(tree, { strict: options.strict ?? false });
+}
+//# sourceMappingURL=validate-structure.js.map

package/dist/commands/validate-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure.js","sourceRoot":"","sources":["../../src/commands/validate-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGjE,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,UAAU,EAAE,wDAAwD,CAAC;SAC5E,MAAM,CAAC,KAAK,EAAE,OAA4C,EAAE,EAAE;QAC7D,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC;YAC5C,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;SAChC,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAI1C;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI;QAC3B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhF,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,iBAAiB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,6 @@
+import type { TaprootConfig } from '../validators/types.js';
+export declare const DEFAULT_CONFIG: TaprootConfig;
+export declare function loadConfig(cwd?: string): {
+    config: TaprootConfig;
+    configDir: string;
+};

package/dist/core/config.js

@@ -0,0 +1,86 @@
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import yaml from 'js-yaml';
+export const DEFAULT_CONFIG = {
+    version: 1,
+    root: 'taproot/',
+    commitPattern: 'taproot\\(([^)]+)\\):',
+    commitTrailer: 'Taproot',
+    agents: ['claude', 'cursor', 'generic'],
+    validation: {
+        requireDates: true,
+        requireStatus: true,
+        allowedIntentStates: ['draft', 'active', 'achieved', 'deprecated'],
+        allowedBehaviourStates: ['proposed', 'specified', 'implemented', 'tested', 'deprecated', 'deferred'],
+        allowedImplStates: ['planned', 'in-progress', 'complete', 'needs-rework', 'deferred'],
+    },
+    hooks: {
+        preCommit: ['taproot validate-structure', 'taproot validate-format'],
+    },
+    ci: {
+        onPr: [
+            'taproot validate-structure',
+            'taproot validate-format',
+            'taproot check-orphans',
+            'taproot sync-check',
+        ],
+        onMerge: [
+            'taproot link-commits',
+            'taproot coverage --format markdown >> pr-comment',
+            'taproot coverage --format context',
+        ],
+    },
+};
+function findConfigFile(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        const candidate = join(current, '.taproot', 'settings.yaml');
+        if (existsSync(candidate))
+            return { configFile: candidate, projectRoot: current };
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+function deepMerge(defaults, overrides) {
+    const result = { ...defaults };
+    for (const key of Object.keys(overrides)) {
+        const override = overrides[key];
+        const def = defaults[key];
+        if (override !== undefined && override !== null) {
+            if (typeof override === 'object' &&
+                !Array.isArray(override) &&
+                typeof def === 'object' &&
+                !Array.isArray(def) &&
+                def !== null) {
+                result[key] = deepMerge(def, override);
+            }
+            else {
+                result[key] = override;
+            }
+        }
+    }
+    return result;
+}
+export function loadConfig(cwd = process.cwd()) {
+    const found = findConfigFile(cwd);
+    if (!found) {
+        return {
+            config: { ...DEFAULT_CONFIG, root: resolve(cwd, DEFAULT_CONFIG.root) },
+            configDir: cwd,
+        };
+    }
+    const { configFile, projectRoot } = found;
+    let raw;
+    try {
+        raw = yaml.load(readFileSync(configFile, 'utf-8'));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${configFile}: ${err.message}`);
+    }
+    const merged = deepMerge(DEFAULT_CONFIG, (raw ?? {}));
+    merged.root = resolve(projectRoot, merged.root);
+    return { config: merged, configDir: projectRoot };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/configuration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CONFIGURATION.md generator.
+ *
+ * Produces the content installed at .taproot/CONFIGURATION.md — the primary
+ * discoverability surface for agents completing configuration tasks.
+ */
+export declare function buildConfigurationMd(): string;