devharness 0.8.0

package/build/helpers/paths.js

@@ -0,0 +1,168 @@
+/**
+ * Centralized path configuration for cdp-tools output directories
+ *
+ * All data defaults to working directory (<cwd>/.cdp-tools/).
+ * Use global: true to save to ~/.cdp-tools/ instead.
+ * If cwd is invalid (e.g., "/"), falls back to global automatically.
+ */
+import { join } from 'path';
+import { homedir, tmpdir } from 'os';
+import { existsSync, accessSync, constants } from 'fs';
+import { z } from 'zod';
+const OUTPUT_DIR = '.cdp-tools';
+const pathOptionsSchema = z.object({
+    global: z.boolean().optional(),
+}).strict();
+let pathConfig = null;
+/**
+ * Check if directory is a valid, writable working directory
+ */
+function isValidWorkingDirectory(dir) {
+    // Reject root directories (Unix: /, Windows: \, C:\, D:\, etc.)
+    if (dir === '/' || dir === '\\')
+        return false;
+    if (/^[A-Za-z]:\\?$/.test(dir))
+        return false; // Windows drive root like C: or C:\
+    // Check if directory exists and is writable
+    try {
+        if (!existsSync(dir))
+            return false;
+        accessSync(dir, constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize path configuration at startup.
+ * Called automatically on first path request, but can be called explicitly for early initialization.
+ */
+export function initializePaths() {
+    const envOverride = process.env.CDP_TOOLS_DIR;
+    const globalBase = envOverride || join(homedir(), OUTPUT_DIR);
+    const cwd = process.cwd();
+    const workingDirBase = isValidWorkingDirectory(cwd)
+        ? join(cwd, OUTPUT_DIR)
+        : null;
+    const tempBase = join(tmpdir(), 'cdp-tools');
+    pathConfig = { globalBase, workingDirBase, tempBase };
+    return pathConfig;
+}
+/**
+ * Override the working-directory base at runtime.
+ * Needed because MCP clients (e.g. Claude Desktop) spawn one long-lived
+ * server process shared across projects — process.cwd() reflects wherever
+ * the client happened to launch from, not the project the user is in.
+ *
+ * @throws if dir does not exist or is not writable
+ */
+export function setWorkingDirOverride(dir) {
+    if (!isValidWorkingDirectory(dir)) {
+        throw new Error(`Not a valid, writable directory: ${dir}`);
+    }
+    if (!pathConfig)
+        initializePaths();
+    pathConfig.workingDirBase = join(dir, OUTPUT_DIR);
+}
+/**
+ * Get path for cdp-tools data.
+ * Defaults to working directory, use global: true for ~/.cdp-tools/
+ *
+ * @param segments - Path segments to join (e.g., 'logs', 'debug.log')
+ * @param options - { global: true } to use ~/.cdp-tools/ instead of cwd
+ * @returns Full path like /project/.cdp-tools/logs/debug.log
+ */
+export function getOutputPath(...args) {
+    if (!pathConfig)
+        initializePaths();
+    // Parse arguments - last arg might be options object
+    let segments;
+    let global = false;
+    const lastArg = args[args.length - 1];
+    if (lastArg && typeof lastArg === 'object' && !Array.isArray(lastArg)) {
+        // Validate options with Zod - throws on invalid/unknown properties
+        const options = pathOptionsSchema.parse(lastArg);
+        segments = args.slice(0, -1);
+        global = options.global ?? false;
+    }
+    else {
+        segments = args;
+    }
+    // Determine base path
+    let base;
+    if (global) {
+        base = pathConfig.globalBase;
+    }
+    else {
+        base = pathConfig.workingDirBase ?? pathConfig.globalBase;
+    }
+    return join(base, ...segments);
+}
+/**
+ * Get config path with backwards compatibility.
+ * Checks cwd first (if valid and config exists there), then global.
+ *
+ * @returns Path to config.json
+ */
+export function getConfigPath() {
+    if (!pathConfig)
+        initializePaths();
+    // Check working directory first for backwards compatibility
+    if (pathConfig.workingDirBase) {
+        const wdConfig = join(pathConfig.workingDirBase, 'config.json');
+        if (existsSync(wdConfig)) {
+            return wdConfig;
+        }
+    }
+    // Fall back to global
+    return join(pathConfig.globalBase, 'config.json');
+}
+/**
+ * Get path for saving new config.
+ *
+ * @param options - { global: true } to save to ~/.cdp-tools/ (default: working directory)
+ * @returns Path to config.json
+ */
+export function getConfigSavePath(options) {
+    if (!pathConfig)
+        initializePaths();
+    const global = options?.global ?? false;
+    if (global) {
+        return join(pathConfig.globalBase, 'config.json');
+    }
+    const base = pathConfig.workingDirBase ?? pathConfig.globalBase;
+    return join(base, 'config.json');
+}
+/**
+ * Get path for temporary/ephemeral data.
+ * Uses system temp directory.
+ *
+ * @param segments - Path segments to join (e.g., 'a4-page.css')
+ * @returns Full path like /tmp/cdp-tools/a4-page.css
+ */
+export function getTempPath(...segments) {
+    if (!pathConfig)
+        initializePaths();
+    return join(pathConfig.tempBase, ...segments);
+}
+/**
+ * Check if working directory storage is available (cwd is valid).
+ */
+export function hasWorkingDirStorage() {
+    if (!pathConfig)
+        initializePaths();
+    return pathConfig.workingDirBase !== null;
+}
+// Deprecated aliases for backwards compatibility
+/** @deprecated Use getOutputPath() */
+export function getWorkingDirPath(...segments) {
+    return getOutputPath(...segments);
+}
+/** @deprecated Use getOutputPath(...segments, { global: true }) */
+export function getGlobalPath(...segments) {
+    return getOutputPath(...segments, { global: true });
+}
+/** @deprecated Use getOutputPath() */
+export const getHomeOutputPath = getGlobalPath;
+//# sourceMappingURL=paths.js.map

package/build/helpers/paths.js.map

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

package/build/helpers/process-liveness.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Process liveness, for pid lists that outlive the processes in them.
+ *
+ * The dashboard hub only removes a pid when its websocket closes cleanly, so a
+ * killed or crashed process stays registered. Anything deciding behaviour from
+ * a pid list has to check the pids are real first.
+ */
+/**
+ * Whether a pid names a running process.
+ *
+ * Signal 0 performs the permission and existence checks without delivering
+ * anything. EPERM means the process exists and belongs to another user, which
+ * is still alive; ESRCH means it is gone.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * The live members of a pid list, order preserved.
+ *
+ * `keep` is always retained even if the check says otherwise — it is normally
+ * the caller's own pid, and a self-check that fails should not erase the caller
+ * from its own list.
+ */
+export declare function livePids(pids: number[], keep?: number): number[];
+//# sourceMappingURL=process-liveness.d.ts.map

package/build/helpers/process-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.d.ts","sourceRoot":"","sources":["../../src/helpers/process-liveness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE"}

package/build/helpers/process-liveness.js

@@ -0,0 +1,36 @@
+/**
+ * Process liveness, for pid lists that outlive the processes in them.
+ *
+ * The dashboard hub only removes a pid when its websocket closes cleanly, so a
+ * killed or crashed process stays registered. Anything deciding behaviour from
+ * a pid list has to check the pids are real first.
+ */
+/**
+ * Whether a pid names a running process.
+ *
+ * Signal 0 performs the permission and existence checks without delivering
+ * anything. EPERM means the process exists and belongs to another user, which
+ * is still alive; ESRCH means it is gone.
+ */
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err?.code === 'EPERM';
+    }
+}
+/**
+ * The live members of a pid list, order preserved.
+ *
+ * `keep` is always retained even if the check says otherwise — it is normally
+ * the caller's own pid, and a self-check that fails should not erase the caller
+ * from its own list.
+ */
+export function livePids(pids, keep) {
+    return pids.filter(pid => pid === keep || isProcessAlive(pid));
+}
+//# sourceMappingURL=process-liveness.js.map

package/build/helpers/process-liveness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.js","sourceRoot":"","sources":["../../src/helpers/process-liveness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,IAAa;IACpD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/build/helpers/process-liveness.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process-liveness.test.d.ts.map

package/build/helpers/process-liveness.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.test.d.ts","sourceRoot":"","sources":["../../src/helpers/process-liveness.test.ts"],"names":[],"mappings":""}

package/build/helpers/process-liveness.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest';
+import { isProcessAlive, livePids } from './process-liveness.js';
+/** A pid that cannot be running: above the platform maximum. */
+const DEAD_PID = 4194304;
+describe('isProcessAlive', () => {
+    it('sees this process', () => {
+        expect(isProcessAlive(process.pid)).toBe(true);
+    });
+    it('does not see a pid that cannot exist', () => {
+        expect(isProcessAlive(DEAD_PID)).toBe(false);
+    });
+    it('rejects nonsense rather than throwing', () => {
+        // pid 0 and negatives address process GROUPS in kill(2); treating them as
+        // live would keep a bogus entry in the list forever.
+        expect(isProcessAlive(0)).toBe(false);
+        expect(isProcessAlive(-1)).toBe(false);
+        expect(isProcessAlive(NaN)).toBe(false);
+        expect(isProcessAlive(1.5)).toBe(false);
+    });
+});
+describe('livePids', () => {
+    it('drops the dead and keeps the living, in order', () => {
+        expect(livePids([DEAD_PID, process.pid])).toEqual([process.pid]);
+    });
+    it('keeps the caller even when the check would drop it', () => {
+        // The caller's own pid is definitionally alive; a self-check that failed
+        // must not erase it from its own list.
+        expect(livePids([DEAD_PID], DEAD_PID)).toEqual([DEAD_PID]);
+    });
+    it('empties a list of entirely dead pids', () => {
+        expect(livePids([DEAD_PID, DEAD_PID + 1])).toEqual([]);
+    });
+    it('collapses a stale duplicate down to one live pid', () => {
+        // The case that blocks a healthy session: a restarted MCP leaves its old
+        // pid behind, the list reads as two, and the guard calls it a duplicate.
+        const pids = [DEAD_PID, process.pid];
+        expect(livePids(pids, process.pid).length).toBe(1);
+    });
+});
+//# sourceMappingURL=process-liveness.test.js.map

package/build/helpers/process-liveness.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.test.js","sourceRoot":"","sources":["../../src/helpers/process-liveness.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,gEAAgE;AAChE,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,0EAA0E;QAC1E,qDAAqD;QACrD,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,yEAAyE;QACzE,uCAAuC;QACvC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/helpers/sequence-tree.d.ts

@@ -0,0 +1,27 @@
+/** Folders whose name starts with '_' hold sequences that only make sense when
+ *  another sequence calls them by name — preamble guards, forEach bodies. They
+ *  are always LOADED (so those name references resolve) but never run on their
+ *  own, where they would fail on unbound variables or an unmet precondition. */
+export declare const HELPER_FOLDER_PREFIX = "_";
+/**
+ * Every .json file under `dir`, recursively, as paths relative to `dir`, sorted.
+ * Returns [] when the directory does not exist — an absent sequences dir is a
+ * normal state, not an error.
+ */
+export declare function walkSequenceFiles(dir: string): Promise<string[]>;
+/** True when any folder segment of a relative path is a helper folder. */
+export declare function isHelperPath(filename: string): boolean;
+/**
+ * Which sequences a `runAll` should execute.
+ *
+ * With a folder: everything beneath it (helper folders nested inside are still
+ * skipped — asking for spine/ should not run spine/_helpers/). Without one:
+ * every sequence except those in helper folders.
+ *
+ * Selection is deliberately separate from loading: the caller loads the whole
+ * tree first so cross-folder name references resolve, then runs only this.
+ */
+export declare function selectSuiteFiles(filenames: string[], folder?: string): string[];
+/** Distinct folder paths present in a set of relative filenames. */
+export declare function sequenceFolders(filenames: string[]): string[];
+//# sourceMappingURL=sequence-tree.d.ts.map

package/build/helpers/sequence-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-tree.d.ts","sourceRoot":"","sources":["../../src/helpers/sequence-tree.ts"],"names":[],"mappings":"AAWA;;;gFAGgF;AAChF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBtE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAe/E;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI7D"}

package/build/helpers/sequence-tree.js

@@ -0,0 +1,80 @@
+/**
+ * Sequence folder support.
+ *
+ * Sequences may be grouped into folders (spine/, story/, _helpers/). The on-disk
+ * scan recurses and every filename it reports stays RELATIVE to the sequences
+ * root ('spine/spine-01.json') — the form `load` accepts back, so a file keeps
+ * working when it moves into a folder.
+ */
+import { promises as fs } from 'fs';
+import { join } from 'path';
+/** Folders whose name starts with '_' hold sequences that only make sense when
+ *  another sequence calls them by name — preamble guards, forEach bodies. They
+ *  are always LOADED (so those name references resolve) but never run on their
+ *  own, where they would fail on unbound variables or an unmet precondition. */
+export const HELPER_FOLDER_PREFIX = '_';
+/**
+ * Every .json file under `dir`, recursively, as paths relative to `dir`, sorted.
+ * Returns [] when the directory does not exist — an absent sequences dir is a
+ * normal state, not an error.
+ */
+export async function walkSequenceFiles(dir) {
+    const walk = async (rel) => {
+        let entries;
+        try {
+            entries = await fs.readdir(join(dir, rel), { withFileTypes: true });
+        }
+        catch (err) {
+            if (err.code === 'ENOENT')
+                return [];
+            throw err;
+        }
+        const out = [];
+        for (const entry of entries) {
+            const child = rel ? `${rel}/${entry.name}` : entry.name;
+            if (entry.isDirectory())
+                out.push(...await walk(child));
+            else if (entry.name.endsWith('.json'))
+                out.push(child);
+        }
+        return out;
+    };
+    return (await walk('')).sort();
+}
+/** True when any folder segment of a relative path is a helper folder. */
+export function isHelperPath(filename) {
+    return filename.split('/').slice(0, -1).some(seg => seg.startsWith(HELPER_FOLDER_PREFIX));
+}
+/**
+ * Which sequences a `runAll` should execute.
+ *
+ * With a folder: everything beneath it (helper folders nested inside are still
+ * skipped — asking for spine/ should not run spine/_helpers/). Without one:
+ * every sequence except those in helper folders.
+ *
+ * Selection is deliberately separate from loading: the caller loads the whole
+ * tree first so cross-folder name references resolve, then runs only this.
+ */
+export function selectSuiteFiles(filenames, folder) {
+    const scope = (folder || '').replace(/^\/+|\/+$/g, '');
+    // Naming a helper folder explicitly is a deliberate act — honour it. The
+    // skip only applies when the caller did NOT ask for it, which is what makes
+    // a bare runAll leave preamble sequences alone.
+    const scopeIsHelper = scope !== '' && isHelperPath(`${scope}/x.json`);
+    return filenames
+        .filter(f => {
+        if (!scope)
+            return !isHelperPath(f);
+        const inScope = f === `${scope}.json` || f.startsWith(`${scope}/`);
+        if (!inScope)
+            return false;
+        // Within a requested non-helper folder, still skip nested helper folders.
+        return scopeIsHelper ? true : !isHelperPath(f);
+    })
+        .sort((a, b) => a.localeCompare(b));
+}
+/** Distinct folder paths present in a set of relative filenames. */
+export function sequenceFolders(filenames) {
+    return [...new Set(filenames.map(f => f.split('/').slice(0, -1).join('/')).filter(Boolean))].sort();
+}
+//# sourceMappingURL=sequence-tree.js.map

package/build/helpers/sequence-tree.js.map

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

package/build/helpers/sequence-tree.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sequence-tree.test.d.ts.map

package/build/helpers/sequence-tree.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-tree.test.d.ts","sourceRoot":"","sources":["../../src/helpers/sequence-tree.test.ts"],"names":[],"mappings":""}

package/build/helpers/sequence-tree.test.js

@@ -0,0 +1,122 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+import { walkSequenceFiles, isHelperPath, selectSuiteFiles, sequenceFolders } from './sequence-tree.js';
+describe('walkSequenceFiles', () => {
+    let dir;
+    beforeAll(async () => {
+        dir = await fs.mkdtemp(join(tmpdir(), 'cdp-seq-tree-'));
+        await fs.mkdir(join(dir, 'spine'), { recursive: true });
+        await fs.mkdir(join(dir, '_helpers'), { recursive: true });
+        await fs.mkdir(join(dir, 'story', 'nested'), { recursive: true });
+        await fs.writeFile(join(dir, 'top.json'), '{}');
+        await fs.writeFile(join(dir, 'spine', 'spine-01.json'), '{}');
+        await fs.writeFile(join(dir, '_helpers', 'unlock.json'), '{}');
+        await fs.writeFile(join(dir, 'story', 'nested', 'deep.json'), '{}');
+        // Non-JSON must be ignored — backup files live beside sequences.
+        await fs.writeFile(join(dir, 'spine', 'spine-01.json.pre-migration-backup'), '{}');
+        await fs.writeFile(join(dir, 'notes.md'), 'x');
+    });
+    afterAll(async () => {
+        await fs.rm(dir, { recursive: true, force: true });
+    });
+    it('finds sequences in subfolders, not just the top level', async () => {
+        const files = await walkSequenceFiles(dir);
+        expect(files).toContain('spine/spine-01.json');
+        expect(files).toContain('story/nested/deep.json');
+        expect(files).toContain('_helpers/unlock.json');
+        expect(files).toContain('top.json');
+    });
+    it('reports paths relative to the root so they round-trip through load', async () => {
+        const files = await walkSequenceFiles(dir);
+        expect(files.every(f => !f.startsWith('/'))).toBe(true);
+        expect(files.every(f => !f.startsWith(dir))).toBe(true);
+    });
+    it('ignores files that are not .json', async () => {
+        const files = await walkSequenceFiles(dir);
+        expect(files).not.toContain('notes.md');
+        expect(files.some(f => f.endsWith('.pre-migration-backup'))).toBe(false);
+    });
+    it('returns sorted output so a suite runs in a predictable order', async () => {
+        const files = await walkSequenceFiles(dir);
+        expect(files).toEqual([...files].sort());
+    });
+    it('treats a missing directory as empty rather than an error', async () => {
+        await expect(walkSequenceFiles(join(dir, 'does-not-exist'))).resolves.toEqual([]);
+    });
+});
+describe('isHelperPath', () => {
+    it('flags any folder segment starting with underscore', () => {
+        expect(isHelperPath('_helpers/unlock.json')).toBe(true);
+        expect(isHelperPath('spine/_shared/guard.json')).toBe(true);
+    });
+    it('does not flag a top-level file whose NAME starts with underscore', () => {
+        // Only folders mark helpers; a bare file is still runnable.
+        expect(isHelperPath('_scratch.json')).toBe(false);
+    });
+    it('leaves ordinary paths alone', () => {
+        expect(isHelperPath('spine/spine-01.json')).toBe(false);
+        expect(isHelperPath('top.json')).toBe(false);
+    });
+});
+describe('selectSuiteFiles', () => {
+    const all = [
+        'top.json',
+        '_helpers/unlock.json',
+        'spine/spine-02.json',
+        'spine/spine-01.json',
+        'spine/_local/body.json',
+        'story/story-a1.json',
+    ];
+    it('runs everything except helper folders when no folder is given', () => {
+        expect(selectSuiteFiles(all)).toEqual([
+            'spine/spine-01.json',
+            'spine/spine-02.json',
+            'story/story-a1.json',
+            'top.json',
+        ]);
+    });
+    it('scopes to one folder when asked', () => {
+        expect(selectSuiteFiles(all, 'spine')).toEqual([
+            'spine/spine-01.json',
+            'spine/spine-02.json',
+        ]);
+    });
+    it('still skips helper folders nested inside the requested folder', () => {
+        // Asking for spine/ must not execute spine/_local/, whose sequences only
+        // make sense when another sequence calls them.
+        expect(selectSuiteFiles(all, 'spine')).not.toContain('spine/_local/body.json');
+    });
+    it('tolerates surrounding slashes on the folder argument', () => {
+        expect(selectSuiteFiles(all, '/spine/')).toEqual(selectSuiteFiles(all, 'spine'));
+    });
+    it('returns nothing for a folder that does not exist', () => {
+        expect(selectSuiteFiles(all, 'nope')).toEqual([]);
+    });
+    it('does not match a folder name by prefix alone', () => {
+        // 'spin' must not sweep in 'spine/...'.
+        expect(selectSuiteFiles(all, 'spin')).toEqual([]);
+    });
+    it('sorts so a suite runs in a predictable order', () => {
+        const out = selectSuiteFiles(all, 'spine');
+        expect(out).toEqual([...out].sort());
+    });
+    it('runs a helper folder when it is asked for by name', () => {
+        // Skipping helpers is a default for the bare case, not a prohibition:
+        // naming _helpers explicitly is deliberate, and refusing it while listing
+        // it as an available folder is a dead end.
+        expect(selectSuiteFiles(all, '_helpers')).toEqual(['_helpers/unlock.json']);
+        expect(selectSuiteFiles(all, 'spine/_local')).toEqual(['spine/_local/body.json']);
+    });
+});
+describe('sequenceFolders', () => {
+    it('lists distinct folders for an error message', () => {
+        expect(sequenceFolders(['a.json', 'spine/x.json', 'spine/y.json', 'story/nested/z.json']))
+            .toEqual(['spine', 'story/nested']);
+    });
+    it('is empty when everything is top level', () => {
+        expect(sequenceFolders(['a.json', 'b.json'])).toEqual([]);
+    });
+});
+//# sourceMappingURL=sequence-tree.test.js.map

package/build/helpers/sequence-tree.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-tree.test.js","sourceRoot":"","sources":["../../src/helpers/sequence-tree.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExG,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,GAAW,CAAC;IAEhB,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;QACxD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;QACpE,iEAAiE;QACjE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,oCAAoC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QAClB,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,4DAA4D;QAC5D,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,GAAG,GAAG;QACV,UAAU;QACV,sBAAsB;QACtB,qBAAqB;QACrB,qBAAqB;QACrB,wBAAwB;QACxB,qBAAqB;KACtB,CAAC;IAEF,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,qBAAqB;YACrB,qBAAqB;YACrB,qBAAqB;YACrB,UAAU;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,qBAAqB;YACrB,qBAAqB;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,yEAAyE;QACzE,+CAA+C;QAC/C,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,wCAAwC;QACxC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,sEAAsE;QACtE,0EAA0E;QAC1E,2CAA2C;QAC3C,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC,CAAC;aACvF,OAAO,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}