@lumenflow/cli 1.0.0

package/dist/spawn-list.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+/**
+ * Spawn List Command (WU-1950)
+ *
+ * Displays spawn trees for WUs or initiatives.
+ * Shows parent-child relationships with status indicators.
+ *
+ * Usage:
+ *   pnpm spawn:list --wu WU-XXX          # Spawns for a specific WU
+ *   pnpm spawn:list --initiative INIT-XXX # All spawns in an initiative
+ *   pnpm spawn:list --json               # JSON output
+ *
+ * @see {@link tools/lib/spawn-tree.mjs} - Tree builder
+ * @see {@link tools/__tests__/spawn-list.test.mjs} - Tests
+ */
+import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
+import { die } from '@lumenflow/core/dist/error-handler.js';
+import { PATTERNS } from '@lumenflow/core/dist/wu-constants.js';
+/** Local EMOJI constants for spawn-list output */
+const EMOJI = {
+    WARNING: '⚠️',
+    ERROR: '❌',
+};
+/** Custom options for spawn-list command */
+const SPAWN_LIST_OPTIONS = {
+    initiative: {
+        name: 'initiative',
+        flags: '--initiative <initId>',
+        description: 'Initiative ID to show all spawns for (e.g., INIT-001)',
+    },
+    json: {
+        name: 'json',
+        flags: '--json',
+        description: 'Output as JSON',
+        default: false,
+    },
+};
+import { buildSpawnTree, formatSpawnTree, getSpawnsByWU, getSpawnsByInitiative, treeToJSON, STATUS_INDICATORS, } from '@lumenflow/core/dist/spawn-tree.js';
+import { SpawnStatus } from '@lumenflow/core/dist/spawn-registry-schema.js';
+const LOG_PREFIX = '[spawn:list]';
+/** Default paths for spawn registry and WU files */
+const DEFAULT_PATHS = Object.freeze({
+    REGISTRY_DIR: '.beacon/state',
+    WU_DIR: 'docs/04-operations/tasks/wu',
+});
+/** Initiative ID pattern */
+const INIT_PATTERN = /^INIT-\d+$/;
+/**
+ * Prints the legend for status indicators
+ */
+function printLegend() {
+    console.log('\nLegend:');
+    console.log(`  ${STATUS_INDICATORS[SpawnStatus.PENDING]} pending`);
+    console.log(`  ${STATUS_INDICATORS[SpawnStatus.COMPLETED]} completed`);
+    console.log(`  ${STATUS_INDICATORS[SpawnStatus.TIMEOUT]} timeout`);
+    console.log(`  ${STATUS_INDICATORS[SpawnStatus.CRASHED]} crashed`);
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    const args = createWUParser({
+        name: 'spawn-list',
+        description: 'Display spawn trees for WUs or initiatives',
+        options: [WU_OPTIONS.wu, SPAWN_LIST_OPTIONS.initiative, SPAWN_LIST_OPTIONS.json],
+        required: [],
+        allowPositionalId: false,
+    });
+    const { wu, initiative, json } = args;
+    // Validate: exactly one of --wu or --initiative required
+    if (!wu && !initiative) {
+        die('Either --wu or --initiative is required.\n\nUsage:\n  pnpm spawn:list --wu WU-XXX\n  pnpm spawn:list --initiative INIT-XXX');
+    }
+    if (wu && initiative) {
+        die('Cannot specify both --wu and --initiative. Choose one.');
+    }
+    // Handle --wu
+    if (wu) {
+        const wuId = wu.toUpperCase();
+        if (!PATTERNS.WU_ID.test(wuId)) {
+            die(`Invalid WU ID format: ${wu}. Expected format: WU-XXX`);
+        }
+        const spawns = await getSpawnsByWU(wuId, DEFAULT_PATHS.REGISTRY_DIR);
+        if (json) {
+            const tree = buildSpawnTree(spawns, wuId);
+            console.log(JSON.stringify(treeToJSON(tree), null, 2));
+            return;
+        }
+        if (spawns.length === 0) {
+            console.log(`${LOG_PREFIX} ${EMOJI.WARNING} No spawns found for ${wuId}`);
+            console.log(`\n${wuId} (root)`);
+            console.log('  (no spawns)');
+            return;
+        }
+        console.log(`${LOG_PREFIX} Spawn tree for ${wuId}:\n`);
+        const tree = buildSpawnTree(spawns, wuId);
+        console.log(formatSpawnTree(tree));
+        printLegend();
+        console.log(`\nTotal: ${spawns.length} spawn(s)`);
+        return;
+    }
+    // Handle --initiative
+    if (initiative) {
+        const initId = initiative.toUpperCase();
+        if (!INIT_PATTERN.test(initId)) {
+            die(`Invalid initiative ID format: ${initiative}. Expected format: INIT-XXX`);
+        }
+        const spawns = await getSpawnsByInitiative(initId, DEFAULT_PATHS.REGISTRY_DIR, DEFAULT_PATHS.WU_DIR);
+        if (json) {
+            // For initiative, output flat list since there may be multiple root WUs
+            console.log(JSON.stringify(spawns, null, 2));
+            return;
+        }
+        if (spawns.length === 0) {
+            console.log(`${LOG_PREFIX} ${EMOJI.WARNING} No spawns found for ${initId}`);
+            return;
+        }
+        // Group spawns by parent WU and display trees
+        console.log(`${LOG_PREFIX} Spawns for ${initId}:\n`);
+        // Find unique root WUs (parents that are not targets of other spawns)
+        const typedSpawns = spawns;
+        const targetWuIds = new Set(typedSpawns.map((s) => s.targetWuId));
+        const rootWuIds = [...new Set(typedSpawns.map((s) => s.parentWuId))].filter((id) => !targetWuIds.has(id));
+        for (const rootWuId of rootWuIds) {
+            const tree = buildSpawnTree(spawns, rootWuId);
+            console.log(formatSpawnTree(tree));
+            console.log('');
+        }
+        printLegend();
+        console.log(`\nTotal: ${spawns.length} spawn(s) across ${rootWuIds.length} root WU(s)`);
+    }
+}
+// Guard main() for testability
+import { fileURLToPath } from 'node:url';
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    main().catch((err) => {
+        console.error(`${LOG_PREFIX} ${EMOJI.ERROR} ${err.message}`);
+        process.exit(1);
+    });
+}

package/dist/spawn-list.js.map

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

package/dist/wu-block.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * WU Block Helper
+ *
+ * Sequence (micro-worktree pattern):
+ * 1) Create micro-worktree from main
+ * 2) Auto-update WU YAML/backlog/status to Blocked in micro-worktree
+ * 3) Commit in micro-worktree, push directly to origin/main
+ * 4) Optionally remove work worktree (default: keep)
+ *
+ * Uses micro-worktree pattern to avoid pre-commit hook blocking commits to main.
+ *
+ * Usage:
+ *   pnpm wu:block --id WU-334 [--reason "Waiting on policy"] [--worktree ...] [--remove-worktree] [--no-auto]
+ */
+export {};

package/dist/wu-block.d.ts.map

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

package/dist/wu-block.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+/**
+ * WU Block Helper
+ *
+ * Sequence (micro-worktree pattern):
+ * 1) Create micro-worktree from main
+ * 2) Auto-update WU YAML/backlog/status to Blocked in micro-worktree
+ * 3) Commit in micro-worktree, push directly to origin/main
+ * 4) Optionally remove work worktree (default: keep)
+ *
+ * Uses micro-worktree pattern to avoid pre-commit hook blocking commits to main.
+ *
+ * Usage:
+ *   pnpm wu:block --id WU-334 [--reason "Waiting on policy"] [--worktree ...] [--remove-worktree] [--no-auto]
+ */
+import { readFile, writeFile, access } from 'node:fs/promises';
+import path from 'node:path';
+import { assertTransition } from '@lumenflow/core/dist/state-machine.js';
+// WU-1574: Removed parseBacklogFrontmatter, getSectionHeadings (no longer needed with generator)
+import { getGitForCwd } from '@lumenflow/core/dist/git-adapter.js';
+import { die } from '@lumenflow/core/dist/error-handler.js';
+// WU-1574: Import backlog generator to replace BacklogManager
+import { generateBacklog } from '@lumenflow/core/dist/backlog-generator.js';
+import { todayISO } from '@lumenflow/core/dist/date-utils.js';
+import { createWUParser, WU_OPTIONS } from '@lumenflow/core/dist/arg-parser.js';
+import { WU_PATHS, defaultWorktreeFrom, getStateStoreDirFromBacklog, } from '@lumenflow/core/dist/wu-paths.js';
+import { readWU, writeWU, appendNote } from '@lumenflow/core/dist/wu-yaml.js';
+import { BRANCHES, REMOTES, WU_STATUS, STATUS_SECTIONS, PATTERNS, LOG_PREFIX, FILE_SYSTEM, EXIT_CODES, STRING_LITERALS, MICRO_WORKTREE_OPERATIONS, } from '@lumenflow/core/dist/wu-constants.js';
+import { ensureOnMain } from '@lumenflow/core/dist/wu-helpers.js';
+import { ensureStaged } from '@lumenflow/core/dist/git-staged-validator.js';
+import { withMicroWorktree } from '@lumenflow/core/dist/micro-worktree.js';
+import { WUStateStore } from '@lumenflow/core/dist/wu-state-store.js';
+// WU-1603: Atomic lane locking - release lock when WU is blocked
+import { releaseLaneLock } from '@lumenflow/core/dist/lane-lock.js';
+// ensureOnMain() moved to wu-helpers.mjs (WU-1256)
+// ensureStaged() moved to git-staged-validator.mjs (WU-1341)
+// defaultWorktreeFrom() moved to wu-paths.mjs (WU-1341)
+/**
+ * Remove WU entry from in-progress section of lines array
+ */
+function removeFromInProgressSection(lines, inProgIdx, rel, id) {
+    if (inProgIdx === -1)
+        return;
+    let endIdx = lines.slice(inProgIdx + 1).findIndex((l) => l.startsWith('## '));
+    endIdx = endIdx === -1 ? lines.length : inProgIdx + 1 + endIdx;
+    for (let i = inProgIdx + 1; i < endIdx; i++) {
+        // eslint-disable-next-line security/detect-object-injection -- array index loop
+        if (lines[i] && (lines[i].includes(rel) || lines[i].includes(`[${id}`))) {
+            lines.splice(i, 1);
+            endIdx--;
+            i--; // adjust
+        }
+    }
+    const section = lines.slice(inProgIdx + 1, endIdx).filter((l) => l.trim() !== '');
+    if (section.length === 0)
+        lines.splice(endIdx, 0, '', '(No items currently in progress)', '');
+}
+async function moveFromInProgressToBlocked(statusPath, id, title, reason) {
+    // Check file exists
+    const fileExists = await access(statusPath)
+        .then(() => true)
+        .catch(() => false);
+    if (!fileExists)
+        die(`Missing ${statusPath}`);
+    const rel = `wu/${id}.yaml`;
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool validates status file
+    const content = await readFile(statusPath, { encoding: FILE_SYSTEM.UTF8 });
+    const lines = content.split(/\r?\n/);
+    const findHeader = (h) => lines.findIndex((l) => l.trim().toLowerCase() === h.toLowerCase());
+    const inProgIdx = findHeader(STATUS_SECTIONS.IN_PROGRESS);
+    const blockedIdx = findHeader(STATUS_SECTIONS.BLOCKED);
+    if (blockedIdx === -1)
+        die(`Could not find "${STATUS_SECTIONS.BLOCKED}" in status.md`);
+    removeFromInProgressSection(lines, inProgIdx, rel, id);
+    // Add bullet to blocked
+    const reasonSuffix = reason ? ` — ${reason}` : '';
+    const bullet = `- [${id} — ${title}](${rel})${reasonSuffix}`;
+    const sectionStart = blockedIdx + 1;
+    if (lines.slice(sectionStart).some((l) => l.includes(rel)))
+        return; // already listed
+    lines.splice(sectionStart, 0, '', bullet);
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- CLI tool writes status file
+    await writeFile(statusPath, lines.join(STRING_LITERALS.NEWLINE), {
+        encoding: FILE_SYSTEM.UTF8,
+    });
+}
+// WU-1574: Regenerate backlog.md from state store (replaces BacklogManager manipulation)
+async function regenerateBacklogFromState(backlogPath) {
+    const stateDir = getStateStoreDirFromBacklog(backlogPath);
+    const store = new WUStateStore(stateDir);
+    await store.load();
+    const content = await generateBacklog(store);
+    await writeFile(backlogPath, content, { encoding: FILE_SYSTEM.UTF8 });
+}
+/**
+ * Handle worktree removal if requested
+ */
+async function handleWorktreeRemoval(args, doc) {
+    if (!args.removeWorktree)
+        return;
+    const wt = args.worktree || defaultWorktreeFrom(doc);
+    // Check if worktree exists
+    const wtExists = wt &&
+        (await access(wt)
+            .then(() => true)
+            .catch(() => false));
+    if (wtExists) {
+        try {
+            await getGitForCwd().worktreeRemove(wt);
+        }
+        catch (e) {
+            console.warn(`${LOG_PREFIX.BLOCK} Could not remove worktree ${wt}: ${e.message}`);
+        }
+    }
+    else if (wt) {
+        console.warn(`${LOG_PREFIX.BLOCK} Worktree path not found; skipping removal`);
+    }
+    else {
+        console.warn(`${LOG_PREFIX.BLOCK} No worktree path specified; skipping removal`);
+    }
+}
+async function main() {
+    const args = createWUParser({
+        name: 'wu-block',
+        description: 'Block a work unit and move it from in-progress to blocked status',
+        options: [
+            WU_OPTIONS.id,
+            WU_OPTIONS.reason,
+            WU_OPTIONS.worktree,
+            WU_OPTIONS.removeWorktree,
+            WU_OPTIONS.noAuto,
+        ],
+        required: ['id'],
+        allowPositionalId: true,
+    });
+    const id = args.id.toUpperCase();
+    if (!PATTERNS.WU_ID.test(id))
+        die(`Invalid WU id '${args.id}'. Expected format WU-123`);
+    await ensureOnMain(getGitForCwd());
+    // Read WU doc from main to get title and validate state transition
+    const mainWUPath = WU_PATHS.WU(id);
+    let doc;
+    try {
+        doc = readWU(mainWUPath, id);
+    }
+    catch (error) {
+        die(`Failed to read WU ${id}: ${error.message}\n\n` +
+            `Options:\n` +
+            `  1. Check if WU file exists: ls -la ${mainWUPath}\n` +
+            `  2. Validate YAML syntax: pnpm wu:validate --id ${id}\n` +
+            `  3. Create WU if missing: pnpm wu:create --id ${id} --lane "<lane>" --title "..."`);
+    }
+    const title = doc.title || '';
+    // Validate state transition before micro-worktree
+    const currentStatus = doc.status || WU_STATUS.IN_PROGRESS;
+    try {
+        assertTransition(currentStatus, WU_STATUS.BLOCKED, id);
+    }
+    catch (error) {
+        die(`State transition validation failed: ${error.message}\n\n` +
+            `Options:\n` +
+            `  1. Check WU current status: grep status ${mainWUPath}\n` +
+            `  2. Only in_progress or waiting WUs can be blocked\n` +
+            `  3. If WU is done, it cannot be blocked`);
+    }
+    const baseMsg = `wu(${id.toLowerCase()}): block`;
+    const commitMsg = args.reason ? `${baseMsg} — ${args.reason}` : baseMsg;
+    if (!args.noAuto) {
+        // Use micro-worktree pattern to avoid pre-commit hook blocking commits to main
+        await withMicroWorktree({
+            operation: MICRO_WORKTREE_OPERATIONS.WU_BLOCK,
+            id,
+            logPrefix: LOG_PREFIX.BLOCK,
+            pushOnly: true, // Push directly to origin/main without touching local main
+            execute: async ({ worktreePath }) => {
+                // Build paths relative to micro-worktree
+                const microWUPath = path.join(worktreePath, WU_PATHS.WU(id));
+                const microStatusPath = path.join(worktreePath, WU_PATHS.STATUS());
+                const microBacklogPath = path.join(worktreePath, WU_PATHS.BACKLOG());
+                // Update WU YAML in micro-worktree
+                const microDoc = readWU(microWUPath, id);
+                microDoc.status = WU_STATUS.BLOCKED;
+                const noteLine = args.reason
+                    ? `Blocked (${todayISO()}): ${args.reason}`
+                    : `Blocked (${todayISO()})`;
+                appendNote(microDoc, noteLine);
+                writeWU(microWUPath, microDoc);
+                // Update status.md in micro-worktree
+                await moveFromInProgressToBlocked(microStatusPath, id, title, args.reason);
+                // Update backlog.md in micro-worktree (WU-1574: regenerate from state store)
+                await regenerateBacklogFromState(microBacklogPath);
+                // Append block event to WUStateStore (WU-1573)
+                const stateDir = path.join(worktreePath, '.beacon', 'state');
+                const store = new WUStateStore(stateDir);
+                await store.load();
+                await store.block(id, args.reason || 'No reason provided');
+                return {
+                    commitMessage: commitMsg,
+                    files: [
+                        WU_PATHS.WU(id),
+                        WU_PATHS.STATUS(),
+                        WU_PATHS.BACKLOG(),
+                        '.beacon/state/wu-events.jsonl',
+                    ],
+                };
+            },
+        });
+        // Fetch to update local main tracking
+        await getGitForCwd().fetch(REMOTES.ORIGIN, BRANCHES.MAIN);
+    }
+    else {
+        // Manual mode: expect files already staged
+        ensureStaged([mainWUPath, WU_PATHS.STATUS(), WU_PATHS.BACKLOG()]);
+        await getGitForCwd().commit(commitMsg);
+        await getGitForCwd().push(REMOTES.ORIGIN, BRANCHES.MAIN);
+    }
+    await handleWorktreeRemoval(args, doc);
+    // WU-1603: Release lane lock when WU is blocked
+    // This allows another WU to be claimed in the same lane
+    try {
+        const lane = doc.lane;
+        if (lane) {
+            const releaseResult = releaseLaneLock(lane, { wuId: id });
+            if (releaseResult.released && !releaseResult.notFound) {
+                console.log(`${LOG_PREFIX.BLOCK} Lane lock released for "${lane}"`);
+            }
+        }
+    }
+    catch (err) {
+        // Non-blocking: lock release failure should not block the blocking operation
+        console.warn(`${LOG_PREFIX.BLOCK} Warning: Could not release lane lock: ${err.message}`);
+    }
+    console.log(`${STRING_LITERALS.NEWLINE}${LOG_PREFIX.BLOCK} Marked blocked and pushed.`);
+    console.log(`- WU: ${id} — ${title}`);
+    if (args.reason)
+        console.log(`- Reason: ${args.reason}`);
+}
+main().catch((e) => {
+    console.error(e.message);
+    process.exit(EXIT_CODES.ERROR);
+});

package/dist/wu-block.js.map

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

package/dist/wu-claim.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * WU Claim Helper
+ *
+ * Canonical sequence:
+ * 1) Auto-update backlog/status/WU YAML (safe parsing) unless `--no-auto`
+ * 2) Commit and push to `main`
+ * 3) Create a dedicated worktree+branch for the WU
+ *
+ * Usage:
+ *   node tools/wu-claim.mjs --id WU-334 --lane Intelligence \
+ *     [--worktree worktrees/intelligence-wu-334] [--branch lane/intelligence/wu-334]
+ *
+ * WU-2542: This script imports utilities from @lumenflow/core package.
+ * Full migration to thin shim pending @lumenflow/core CLI export implementation.
+ */
+/**
+ * WU-1746: Get list of files to commit in worktree mode
+ * Excludes backlog.md and status.md to prevent merge conflicts.
+ * These generated files should only be updated on main during wu:done.
+ *
+ * @param {string} wuId - WU ID (e.g., 'WU-1746')
+ * @returns {string[]} List of files to commit
+ */
+export declare function getWorktreeCommitFiles(wuId: any): string[];
+/**
+ * WU-1763: Print a single concise tips line to improve tool adoption.
+ * Non-blocking, single-line output to avoid flooding the console.
+ *
+ * @param {string} _id - WU ID being claimed (unused, kept for future use)
+ */
+export declare function printLifecycleNudge(_id: any): void;

package/dist/wu-claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wu-claim.d.ts","sourceRoot":"","sources":["../src/wu-claim.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AA0ZH;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,KAAA,YAS1C;AA6hBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,KAAA,QAKtC"}