@imix-js/taproot 0.2.0

package/dist/core/configuration.js

@@ -0,0 +1,112 @@
+/**
+ * CONFIGURATION.md generator.
+ *
+ * Produces the content installed at .taproot/CONFIGURATION.md — the primary
+ * discoverability surface for agents completing configuration tasks.
+ */
+import { supportedLanguages } from './language.js';
+export function buildConfigurationMd() {
+    const langs = supportedLanguages().join(', ');
+    return `# Taproot Configuration Reference
+
+Edit \`.taproot/settings.yaml\` to configure taproot.
+
+**After changing \`language\` or \`vocabulary\`:** run \`taproot update\` to regenerate skill files and adapters.
+**After changing \`definitionOfDone\` or \`definitionOfReady\`:** no \`taproot update\` needed — these are read at runtime.
+
+---
+
+## language
+
+Language pack for section headers, Gherkin keywords, and status values in skill files.
+
+\`\`\`yaml
+language: de
+\`\`\`
+
+**Supported values:** ${langs}
+
+**Default:** English (omit the field)
+
+**Requires \`taproot update\`:** yes — skill files and adapter descriptions are regenerated with translated terminology.
+
+---
+
+## vocabulary
+
+Domain-specific term substitutions applied to all skill file output. Use this to replace taproot's default terminology with words native to your project's domain.
+
+\`\`\`yaml
+vocabulary:
+  feature: story
+  behaviour: acceptance criterion
+  intent: epic
+\`\`\`
+
+**Format:** a YAML map of \`original: replacement\` string pairs. Keys are matched case-insensitively on whole words. Declaration order governs overlap — declare longer keys before their prefixes.
+
+**Default:** no substitutions (omit the field)
+
+**Requires \`taproot update\`:** yes — skill files are regenerated with the substituted terminology.
+
+---
+
+## definitionOfDone
+
+Shell commands run as gates before implementation commits. Each command must exit 0 for the commit to proceed.
+
+\`\`\`yaml
+definitionOfDone:
+  - condition: tests-passing
+    run: npm test
+  - condition: lint-clean
+    run: npm run lint
+\`\`\`
+
+**Format:** a list of objects with \`condition\` (name shown in output) and \`run\` (shell command).
+
+**Default:** baseline checks only (validate-format, validate-structure, tests-passing)
+
+**Requires \`taproot update\`:** no — read at runtime by \`taproot dod\`.
+
+---
+
+## definitionOfReady
+
+Shell commands run as gates before declaration commits (new impl.md). Each command must exit 0 for the commit to proceed.
+
+\`\`\`yaml
+definitionOfReady:
+  - condition: spec-reviewed
+    run: echo "Spec reviewed"
+\`\`\`
+
+**Format:** same as \`definitionOfDone\`.
+
+**Default:** baseline checks only
+
+**Requires \`taproot update\`:** no — read at runtime by the pre-commit hook.
+
+---
+
+## Full example
+
+\`\`\`yaml
+version: 1
+language: de
+vocabulary:
+  feature: story
+  behaviour: acceptance criterion
+definitionOfDone:
+  - condition: tests-passing
+    run: npm test
+  - condition: lint-clean
+    run: npm run lint
+\`\`\`
+
+---
+
+*Generated by taproot. Run \`taproot update\` to refresh this file after upgrading.*
+`;
+}
+//# sourceMappingURL=configuration.js.map

package/dist/core/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../src/core/configuration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9C,OAAO;;;;;;;;;;;;;;;;;wBAiBe,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF5B,CAAC;AACF,CAAC"}

package/dist/core/dod-runner.d.ts

@@ -0,0 +1,20 @@
+import type { DodConditionEntry } from '../validators/types.js';
+export interface DodResult {
+    name: string;
+    passed: boolean;
+    output: string;
+    correction: string;
+}
+export interface DodReport {
+    configured: boolean;
+    results: DodResult[];
+    allPassed: boolean;
+    usecaseCascade?: string;
+}
+/** Read agent-check resolutions recorded in impl.md's ## DoD Resolutions section.
+ *  Returns an empty set if impl.md has been modified after the resolutions were written
+ *  (indicating more implementation work happened since the agent resolved the checks). */
+export declare function readResolutions(implPath: string, cwd: string): Set<string>;
+export declare function runDodChecks(conditions: DodConditionEntry[] | undefined, cwd: string, options?: {
+    implPath?: string;
+}): DodReport;

package/dist/core/dod-runner.js

@@ -0,0 +1,233 @@
+import { existsSync, readFileSync, statSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { spawnSync } from 'child_process';
+import { parseMarkdown } from './markdown-parser.js';
+import { validateFormat } from '../validators/format-rules.js';
+import { loadConfig } from './config.js';
+const BUILTINS = {
+    'tests-passing': {
+        run: 'npm test',
+        correction: 'Fix failing tests and re-run.',
+    },
+    'linter-clean': {
+        run: 'npm run lint',
+        correction: 'Fix lint errors reported above and re-run.',
+    },
+    'commit-conventions': {
+        run: 'npm run check:commits',
+        correction: 'Ensure your commits follow the project commit convention.',
+    },
+};
+const TIMEOUT_MS = 30_000;
+function resolveCondition(entry) {
+    if (typeof entry === 'object' && 'document-current' in entry) {
+        const description = entry['document-current'];
+        return {
+            name: 'document-current',
+            correction: description,
+            agentCheck: true,
+            description,
+        };
+    }
+    if (typeof entry === 'object' && 'check-if-affected' in entry) {
+        const target = entry['check-if-affected'];
+        return {
+            name: `check-if-affected: ${target}`,
+            agentCheck: true,
+            description: target,
+            correction: `Review whether this change requires updating ${target} and apply updates if needed.`,
+        };
+    }
+    if (typeof entry === 'object' && 'check-if-affected-by' in entry) {
+        const behaviourPath = entry['check-if-affected-by'];
+        return {
+            name: `check-if-affected-by: ${behaviourPath}`,
+            agentCheck: true,
+            description: behaviourPath,
+            correction: `Read the behaviour spec at ${behaviourPath}/usecase.md. Determine whether it applies to this implementation and verify compliance. If it applies, ensure this implementation satisfies it; if not, record why it does not apply.`,
+        };
+    }
+    if (typeof entry === 'object' && 'check' in entry) {
+        const question = entry['check'];
+        return {
+            name: `check: ${question}`,
+            agentCheck: true,
+            description: question,
+            correction: question,
+        };
+    }
+    if (typeof entry === 'string') {
+        const builtin = BUILTINS[entry];
+        if (!builtin) {
+            return {
+                name: entry,
+                run: entry,
+                correction: `Unknown built-in condition "${entry}". Use a known built-in or specify a "run:" command.`,
+            };
+        }
+        return { name: entry, run: builtin.run, correction: builtin.correction };
+    }
+    return {
+        name: entry.name ?? entry.run,
+        run: entry.run,
+        correction: entry.correction ?? 'Fix the issue reported above, then re-run.',
+    };
+}
+function runCondition(name, command, cwd, correction) {
+    let result;
+    try {
+        result = spawnSync(command, {
+            shell: true,
+            cwd,
+            encoding: 'utf-8',
+            timeout: TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        return {
+            name,
+            passed: false,
+            output: err.message,
+            correction: 'Ensure the command exists and is executable from the project root.',
+        };
+    }
+    if (result.error) {
+        const isTimeout = result.error.message.includes('ETIMEDOUT') || result.error.message.includes('timeout');
+        return {
+            name,
+            passed: false,
+            output: result.error.message,
+            correction: isTimeout
+                ? 'Check for hanging processes or increase the timeout.'
+                : 'Ensure the command exists and is executable from the project root.',
+        };
+    }
+    const output = [result.stdout ?? '', result.stderr ?? ''].filter(Boolean).join('\n').trim();
+    const passed = result.status === 0;
+    // Exit code 127 = shell "command not found"
+    if (result.status === 127) {
+        return {
+            name,
+            passed: false,
+            output,
+            correction: 'Ensure the command exists and is executable from the project root.',
+        };
+    }
+    return { name, passed, output, correction: passed ? '' : correction };
+}
+/** Run the always-on DoD baseline: usecase.md exists, state=specified, format-valid. */
+function runDodBaseline(implPath, cwd) {
+    const absImpl = resolve(cwd, implPath);
+    const behaviourDir = dirname(dirname(absImpl));
+    const usecasePath = join(behaviourDir, 'usecase.md');
+    const results = [];
+    if (!existsSync(usecasePath)) {
+        results.push({
+            name: 'baseline-usecase-exists',
+            passed: false,
+            output: `No usecase.md at ${usecasePath}`,
+            correction: 'The behaviour spec this implementation references is missing. Restore it before marking complete.',
+        });
+        return results; // cannot check further without usecase
+    }
+    const content = readFileSync(usecasePath, 'utf-8');
+    const parsed = parseMarkdown(usecasePath, content);
+    // state: specified or more advanced (implemented/tested) — must not have regressed to proposed/deprecated
+    const statusSection = parsed.sections.get('status');
+    const stateMatch = statusSection?.rawBody.match(/\*\*State:\*\*\s*(\S+)/);
+    const state = stateMatch?.[1] ?? 'unknown';
+    const acceptedStates = new Set(['specified', 'implemented', 'tested']);
+    const isReady = acceptedStates.has(state);
+    results.push({
+        name: 'baseline-state-specified',
+        passed: isReady,
+        output: isReady ? '' : `usecase.md state is '${state}'`,
+        correction: "Restore usecase.md to 'specified' (or more advanced) before marking implementation complete.",
+    });
+    // validate-format
+    const { config } = loadConfig(cwd);
+    const violations = validateFormat(parsed, 'behaviour', config).filter(v => v.type === 'error');
+    const formatPassed = violations.length === 0;
+    results.push({
+        name: 'baseline-validate-format',
+        passed: formatPassed,
+        output: formatPassed ? '' : violations.map(v => v.message).join('\n'),
+        correction: 'Fix format violations in usecase.md and re-run.',
+    });
+    return results;
+}
+// Buffer to account for the time between Date.now() and the writeFileSync mtime.
+// Resolutions written within this window of impl.md's mtime are considered current.
+const RESOLUTION_STALE_BUFFER_MS = 2_000;
+/** Read agent-check resolutions recorded in impl.md's ## DoD Resolutions section.
+ *  Returns an empty set if impl.md has been modified after the resolutions were written
+ *  (indicating more implementation work happened since the agent resolved the checks). */
+export function readResolutions(implPath, cwd) {
+    const absPath = resolve(cwd, implPath);
+    if (!existsSync(absPath))
+        return new Set();
+    const content = readFileSync(absPath, 'utf-8');
+    const parsed = parseMarkdown(absPath, content);
+    const section = parsed.sections.get('dod resolutions');
+    if (!section)
+        return new Set();
+    const entries = [];
+    for (const line of section.rawBody.split('\n')) {
+        const m = line.match(/^-\s+condition:\s+(.+?)\s+\|.*\|\s+resolved:\s+(.+)$/);
+        if (m) {
+            const ts = Date.parse(m[2].trim());
+            if (!isNaN(ts))
+                entries.push({ condition: m[1].trim(), timestampMs: ts });
+        }
+    }
+    if (entries.length === 0)
+        return new Set();
+    // If impl.md is already complete, resolutions are always valid — DoD already passed.
+    // Only check staleness for in-progress impls, where the developer may have changed
+    // implementation code after the agent recorded resolutions.
+    const isComplete = /\*\*State:\*\*\s*complete/.test(content);
+    if (!isComplete) {
+        const implMtimeMs = statSync(absPath).mtimeMs;
+        const latestResolutionMs = Math.max(...entries.map(e => e.timestampMs));
+        if (implMtimeMs > latestResolutionMs + RESOLUTION_STALE_BUFFER_MS) {
+            return new Set(); // stale — impl.md changed after resolutions were recorded
+        }
+    }
+    return new Set(entries.map(e => e.condition));
+}
+export function runDodChecks(conditions, cwd, options) {
+    const results = [];
+    // Always run baseline when implPath is provided
+    if (options?.implPath) {
+        results.push(...runDodBaseline(options.implPath, cwd));
+    }
+    if (!conditions || conditions.length === 0) {
+        const configured = results.length > 0;
+        return { configured, results, allPassed: results.every(r => r.passed) };
+    }
+    // Read any agent-check resolutions recorded in impl.md
+    const resolvedChecks = options?.implPath
+        ? readResolutions(options.implPath, cwd)
+        : new Set();
+    for (const entry of conditions) {
+        const resolved = resolveCondition(entry);
+        if (resolved.agentCheck) {
+            const isResolved = resolvedChecks.has(resolved.name);
+            results.push({
+                name: resolved.name,
+                passed: isResolved,
+                output: isResolved ? '' : `Agent check required: ${resolved.description}`,
+                correction: resolved.correction,
+            });
+        }
+        else {
+            results.push(runCondition(resolved.name, resolved.run, cwd, resolved.correction));
+        }
+    }
+    return {
+        configured: true,
+        results,
+        allPassed: results.every(r => r.passed),
+    };
+}
+//# sourceMappingURL=dod-runner.js.map

package/dist/core/dod-runner.js.map

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

package/dist/core/dor-runner.d.ts

@@ -0,0 +1,18 @@
+/** Read agent-check resolutions from impl.md's ## DoR Resolutions section. */
+export declare function readDorResolutions(implMdPath: string, cwd: string): Set<string>;
+export interface DorResult {
+    name: string;
+    passed: boolean;
+    output: string;
+    correction: string;
+}
+export interface DorReport {
+    results: DorResult[];
+    allPassed: boolean;
+}
+/** Resolve the parent usecase.md from an impl.md path.
+ *  impl.md lives at taproot/<intent>/<behaviour>/<impl>/impl.md
+ *  usecase.md lives at taproot/<intent>/<behaviour>/usecase.md
+ */
+export declare function resolveUsecasePath(implMdPath: string, cwd: string): string;
+export declare function runDorChecks(implMdPath: string, cwd: string): DorReport;

package/dist/core/dor-runner.js

@@ -0,0 +1,156 @@
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { spawnSync } from 'child_process';
+import { parseMarkdown } from './markdown-parser.js';
+import { loadConfig } from './config.js';
+import { loadLanguagePack } from './language.js';
+/** Resolve an English section key to its localised lowercase equivalent via the pack. */
+function localizedSectionKey(englishKey, pack) {
+    if (!pack)
+        return englishKey;
+    const packKey = Object.keys(pack).find(k => k.toLowerCase() === englishKey);
+    if (!packKey)
+        return englishKey;
+    return pack[packKey].toLowerCase();
+}
+/** Read agent-check resolutions from impl.md's ## DoR Resolutions section. */
+export function readDorResolutions(implMdPath, cwd) {
+    const absPath = resolve(cwd, implMdPath);
+    if (!existsSync(absPath))
+        return new Set();
+    const content = readFileSync(absPath, 'utf-8');
+    const parsed = parseMarkdown(absPath, content);
+    const section = parsed.sections.get('dor resolutions');
+    if (!section)
+        return new Set();
+    const conditions = new Set();
+    for (const line of section.rawBody.split('\n')) {
+        const m = line.match(/^-\s+condition:\s+(.+?)\s+\|/);
+        if (m)
+            conditions.add(m[1].trim());
+    }
+    return conditions;
+}
+/** Resolve the parent usecase.md from an impl.md path.
+ *  impl.md lives at taproot/<intent>/<behaviour>/<impl>/impl.md
+ *  usecase.md lives at taproot/<intent>/<behaviour>/usecase.md
+ */
+export function resolveUsecasePath(implMdPath, cwd) {
+    const absImpl = resolve(cwd, implMdPath);
+    const implDir = dirname(absImpl); // <impl>/
+    const behaviourDir = dirname(implDir); // <behaviour>/
+    return join(behaviourDir, 'usecase.md');
+}
+export function runDorChecks(implMdPath, cwd) {
+    const results = [];
+    const usecasePath = resolveUsecasePath(implMdPath, cwd);
+    // 1. usecase.md exists
+    if (!existsSync(usecasePath)) {
+        results.push({
+            name: 'usecase-exists',
+            passed: false,
+            output: `No usecase.md found at ${usecasePath}`,
+            correction: 'Create a behaviour spec with /tr-behaviour before committing an impl.md',
+        });
+        return { results, allPassed: false };
+    }
+    const content = readFileSync(usecasePath, 'utf-8');
+    const parsed = parseMarkdown(usecasePath, content);
+    // 2. state: specified
+    const statusSection = parsed.sections.get('status');
+    const stateMatch = statusSection?.rawBody.match(/\*\*State:\*\*\s*(\S+)/);
+    const state = stateMatch?.[1] ?? 'unknown';
+    const isSpecified = state === 'specified';
+    results.push({
+        name: 'state-specified',
+        passed: isSpecified,
+        output: isSpecified ? '' : `usecase.md state is '${state}'`,
+        correction: "Bring the spec to 'specified' (run /tr-review then /tr-refine) before starting implementation",
+    });
+    // 3. Required sections (localised via language pack)
+    const { config } = loadConfig(cwd);
+    const pack = config.language ? loadLanguagePack(config.language) : null;
+    const required = [
+        ['actor', 'Actor'],
+        ['preconditions', 'Preconditions'],
+        ['main flow', 'Main Flow'],
+        ['postconditions', 'Postconditions'],
+    ];
+    for (const [englishKey, label] of required) {
+        const key = localizedSectionKey(englishKey, pack);
+        const present = parsed.sections.has(key);
+        results.push({
+            name: `section-${key.replace(' ', '-')}`,
+            passed: present,
+            output: present ? '' : `Missing ## ${label} section`,
+            correction: `Add a ## ${label} section to usecase.md`,
+        });
+    }
+    // 4. Flow (Mermaid diagram)
+    const hasFlow = parsed.sections.has('flow');
+    results.push({
+        name: 'flow-diagram',
+        passed: hasFlow,
+        output: hasFlow ? '' : 'Missing ## Flow section with Mermaid diagram',
+        correction: 'Add a ## Flow section with a mermaid diagram to usecase.md',
+    });
+    // 5. Related behaviours
+    const hasRelated = parsed.sections.has('related');
+    results.push({
+        name: 'related-behaviours',
+        passed: hasRelated,
+        output: hasRelated ? '' : 'Missing ## Related section',
+        correction: 'Add a ## Related section documenting related behaviours to usecase.md',
+    });
+    // 6. Configured definitionOfReady conditions
+    const dorConditions = config.definitionOfReady;
+    if (dorConditions && dorConditions.length > 0) {
+        const resolvedChecks = readDorResolutions(implMdPath, cwd);
+        for (const entry of dorConditions) {
+            if (typeof entry === 'object' && 'check' in entry) {
+                const question = entry['check'];
+                const name = `check: ${question}`;
+                const isResolved = resolvedChecks.has(name);
+                results.push({
+                    name,
+                    passed: isResolved,
+                    output: isResolved ? '' : `Agent check required: ${question}`,
+                    correction: `Reason about the question and record a resolution in impl.md under ## DoR Resolutions: "- condition: ${name} | note: <reasoning> | resolved: <ISO-timestamp>"`,
+                });
+            }
+            else if (typeof entry === 'object' && ('document-current' in entry || 'check-if-affected' in entry || 'check-if-affected-by' in entry)) {
+                // Other agent-check types — treat as unresolvable shell-side, report as agent check
+                const key = 'document-current' in entry ? 'document-current' : 'check-if-affected' in entry ? 'check-if-affected' : 'check-if-affected-by';
+                const value = entry[key];
+                const name = `${key}: ${value}`;
+                const isResolved = resolvedChecks.has(name);
+                results.push({
+                    name,
+                    passed: isResolved,
+                    output: isResolved ? '' : `Agent check required: ${value}`,
+                    correction: `Resolve this agent check and record it in impl.md under ## DoR Resolutions.`,
+                });
+            }
+            else if (typeof entry === 'string') {
+                const r = spawnSync(entry, { shell: true, cwd, encoding: 'utf-8', timeout: 30_000 });
+                results.push({
+                    name: entry,
+                    passed: r.status === 0,
+                    output: [r.stdout, r.stderr].filter(Boolean).join('\n').trim(),
+                    correction: 'Fix the issue reported above, then re-commit',
+                });
+            }
+            else if ('run' in entry) {
+                const r = spawnSync(entry.run, { shell: true, cwd, encoding: 'utf-8', timeout: 30_000 });
+                results.push({
+                    name: entry.name ?? entry.run,
+                    passed: r.status === 0,
+                    output: [r.stdout, r.stderr].filter(Boolean).join('\n').trim(),
+                    correction: entry.correction ?? 'Fix the issue reported above, then re-commit',
+                });
+            }
+        }
+    }
+    return { results, allPassed: results.every(r => r.passed) };
+}
+//# sourceMappingURL=dor-runner.js.map

package/dist/core/dor-runner.js.map

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

package/dist/core/fs-walker.d.ts

@@ -0,0 +1,5 @@
+import type { FolderNode } from '../validators/types.js';
+export declare function walkHierarchy(rootPath: string, options?: {
+    excludeDirs?: Set<string>;
+}): FolderNode;
+export declare function flattenTree(root: FolderNode): FolderNode[];

package/dist/core/fs-walker.js

@@ -0,0 +1,74 @@
+import { readdirSync, statSync } from 'fs';
+import { join, relative, basename } from 'path';
+const MARKER_FILES = {
+    'intent.md': 'intent',
+    'usecase.md': 'behaviour',
+    'impl.md': 'impl',
+};
+const DEFAULT_EXCLUDE = new Set(['_brainstorms', 'skills', '.git', 'node_modules', 'dist']);
+export function walkHierarchy(rootPath, options = {}) {
+    const excludeDirs = options.excludeDirs ?? DEFAULT_EXCLUDE;
+    return walkDir(rootPath, rootPath, null, 0, excludeDirs);
+}
+function walkDir(dirPath, rootPath, parent, depth, excludeDirs) {
+    let entries;
+    try {
+        entries = readdirSync(dirPath);
+    }
+    catch {
+        entries = [];
+    }
+    const markerFiles = [];
+    const subdirs = [];
+    for (const entry of entries) {
+        if (MARKER_FILES[entry]) {
+            markerFiles.push(entry);
+        }
+        try {
+            const fullPath = join(dirPath, entry);
+            if (statSync(fullPath).isDirectory() && !excludeDirs.has(entry)) {
+                subdirs.push(entry);
+            }
+        }
+        catch {
+            // skip unreadable entries
+        }
+    }
+    const node = {
+        absolutePath: dirPath,
+        relativePath: relative(rootPath, dirPath) || '.',
+        name: basename(dirPath),
+        marker: null,
+        markerFiles,
+        children: [],
+        parent,
+        depth,
+        hasDescendantWithMarker: false,
+    };
+    // Determine marker (first found wins; duplicates are reported as violations)
+    if (markerFiles.length > 0) {
+        node.marker = MARKER_FILES[markerFiles[0] ?? ''] ?? null;
+    }
+    // Recurse into subdirectories (post-order: children first)
+    for (const subdir of subdirs.sort()) {
+        const child = walkDir(join(dirPath, subdir), rootPath, node, depth + 1, excludeDirs);
+        node.children.push(child);
+        if (child.marker !== null || child.hasDescendantWithMarker) {
+            node.hasDescendantWithMarker = true;
+        }
+    }
+    return node;
+}
+export function flattenTree(root) {
+    const result = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        result.push(node);
+        for (const child of [...node.children].reverse()) {
+            stack.push(child);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=fs-walker.js.map

package/dist/core/fs-walker.js.map

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