@lumenflow/cli 2.18.2 → 2.19.0

package/dist/wu-claim-output.js

@@ -0,0 +1,83 @@
+/**
+ * @file wu-claim-output.ts
+ * @description Output formatting and display helpers for wu:claim.
+ *
+ * WU-1649: Extracted from wu-claim.ts to reduce orchestration complexity.
+ * All functions are mechanical extractions preserving original behavior.
+ */
+import { getErrorMessage } from '@lumenflow/core/error-handler';
+import { LOG_PREFIX } from '@lumenflow/core/wu-constants';
+// WU-1473: Surface unread signals on claim for agent awareness
+import { surfaceUnreadSignals } from './hooks/enforcement-generator.js';
+const PREFIX = LOG_PREFIX.CLAIM;
+/**
+ * WU-1473: Surface unread coordination signals and display them.
+ * Fail-open: any error is logged as a warning, never blocks claim.
+ *
+ * @param baseDir - Project base directory for memory layer
+ */
+export async function surfaceUnreadSignalsForDisplay(baseDir) {
+    try {
+        const result = await surfaceUnreadSignals(baseDir);
+        if (result.count > 0) {
+            const MAX_DISPLAY = 5;
+            console.log(`\n${PREFIX} Unread coordination signals (${result.count}):`);
+            for (const signal of result.signals.slice(0, MAX_DISPLAY)) {
+                const timestamp = new Date(signal.created_at).toLocaleTimeString();
+                const scope = signal.wu_id ? ` [${signal.wu_id}]` : '';
+                console.log(`  - [${timestamp}]${scope} ${signal.message}`);
+            }
+            if (result.count > MAX_DISPLAY) {
+                console.log(`  ... and ${result.count - MAX_DISPLAY} more`);
+            }
+            console.log(`  Run 'pnpm mem:inbox' for full list`);
+        }
+    }
+    catch (err) {
+        // WU-1473 AC4: Fail-open - never block claim on memory errors
+        console.warn(`${PREFIX} Warning: Could not surface unread signals: ${getErrorMessage(err)}`);
+    }
+}
+/**
+ * WU-1047: Format Project Defaults section (agent-only).
+ *
+ * @param {object} methodology - Methodology defaults config
+ * @returns {string} Formatted output or empty string if disabled
+ */
+export function formatProjectDefaults(methodology) {
+    if (!methodology || methodology.enabled === false)
+        return '';
+    const enforcement = methodology.enforcement || 'required';
+    const principles = Array.isArray(methodology.principles) ? methodology.principles : [];
+    const lines = [
+        `${PREFIX} 🧭 Project Defaults (agent-only)`,
+        `  Enforcement: ${enforcement}`,
+        `  Principles: ${principles.length > 0 ? principles.join(', ') : 'None'}`,
+    ];
+    if (methodology.notes) {
+        lines.push(`  Notes: ${methodology.notes}`);
+    }
+    return `\n${lines.join('\n')}`;
+}
+/**
+ * WU-1047: Print Project Defaults section (agent-only).
+ *
+ * @param {object} methodology - Methodology defaults config
+ */
+export function printProjectDefaults(methodology) {
+    const output = formatProjectDefaults(methodology);
+    if (output) {
+        console.log(output);
+    }
+}
+/**
+ * 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 function printLifecycleNudge(_id) {
+    // Single line, concise, actionable
+    console.log(`\n${PREFIX} 💡 Tip: pnpm session:recommend for context tier, mem:ready for pending work, pnpm file:*/git:* for audited wrappers`);
+}
+//# sourceMappingURL=wu-claim-output.js.map

package/dist/wu-claim-output.js.map

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

package/dist/wu-claim-resume-handler.js

@@ -0,0 +1,85 @@
+/**
+ * @file wu-claim-resume-handler.ts
+ * @description Resume/handoff mode handler for wu:claim --resume.
+ *
+ * WU-1649: Extracted from wu-claim.ts to reduce orchestration complexity.
+ * All functions are mechanical extractions preserving original behavior.
+ */
+import path from 'node:path';
+import { createGitForPath } from '@lumenflow/core/git-adapter';
+import { die } from '@lumenflow/core/error-handler';
+import { toKebab, LOG_PREFIX, EMOJI } from '@lumenflow/core/wu-constants';
+import { emitWUFlowEvent } from '@lumenflow/core/telemetry';
+import { resumeClaimForHandoff, getWorktreeUncommittedChanges, formatUncommittedChanges, createHandoffCheckpoint, } from '@lumenflow/core/wu-claim-resume';
+const PREFIX = LOG_PREFIX.CLAIM;
+/**
+ * WU-2411: Handle --resume flag for agent handoff
+ *
+ * When an agent crashes or is killed, the --resume flag allows a new agent
+ * to take over by:
+ * 1. Verifying the old PID is dead (safety check)
+ * 2. Updating the lock file with the new PID
+ * 3. Preserving the existing worktree
+ * 4. Printing uncommitted changes summary
+ * 5. Creating a checkpoint in the memory layer
+ *
+ * @param {Object} args - CLI arguments
+ * @param {string} id - WU ID
+ */
+export async function handleResumeMode(args, id) {
+    const laneK = toKebab(args.lane);
+    const idK = id.toLowerCase();
+    const worktree = args.worktree || `worktrees/${laneK}-${idK}`;
+    const worktreePath = path.resolve(worktree);
+    console.log(`${PREFIX} Attempting to resume ${id} in lane "${args.lane}"...`);
+    // Attempt the resume/handoff
+    const result = await resumeClaimForHandoff({
+        wuId: id,
+        lane: args.lane,
+        worktreePath,
+        agentSession: null, // Will be populated by session system
+    });
+    if (!result.success) {
+        die(`Cannot resume ${id}: ${result.error}\n\n` +
+            `If you need to start a fresh claim, use: pnpm wu:claim --id ${id} --lane "${args.lane}"`);
+    }
+    console.log(`${PREFIX} ${EMOJI.SUCCESS} Handoff successful`);
+    console.log(`${PREFIX} Previous PID: ${result.previousPid}`);
+    console.log(`${PREFIX} New PID: ${process.pid}`);
+    // Get and display uncommitted changes in the worktree
+    const wtGit = createGitForPath(worktreePath);
+    const uncommittedStatus = await getWorktreeUncommittedChanges(wtGit);
+    if (uncommittedStatus) {
+        const formatted = formatUncommittedChanges(uncommittedStatus);
+        console.log(`\n${PREFIX} ${formatted}`);
+    }
+    else {
+        console.log(`\n${PREFIX} No uncommitted changes in worktree.`);
+    }
+    // Create handoff checkpoint in memory layer
+    const checkpointResult = await createHandoffCheckpoint({
+        wuId: id,
+        previousPid: result.previousPid,
+        newPid: process.pid,
+        previousSession: result.previousSession,
+        uncommittedSummary: uncommittedStatus,
+    });
+    if (checkpointResult.success && checkpointResult.checkpointId) {
+        console.log(`${PREFIX} ${EMOJI.SUCCESS} Handoff checkpoint created: ${checkpointResult.checkpointId}`);
+    }
+    // Emit telemetry event for handoff
+    emitWUFlowEvent({
+        script: 'wu-claim',
+        wu_id: id,
+        lane: args.lane,
+        step: 'resume_handoff',
+        previousPid: result.previousPid,
+        newPid: process.pid,
+        uncommittedChanges: uncommittedStatus ? 'present' : 'none',
+    });
+    // Print summary
+    console.log(`\n${PREFIX} Resume complete. Worktree preserved at: ${worktree}`);
+    console.log(`${PREFIX} Next: cd ${worktree} and continue work.`);
+    console.log(`\n${PREFIX} Tip: Run 'pnpm mem:ready --wu ${id}' to check for pending context from previous session.`);
+}
+//# sourceMappingURL=wu-claim-resume-handler.js.map

package/dist/wu-claim-resume-handler.js.map

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