@lumenflow/cli 2.4.0 → 2.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -8
- package/dist/__tests__/init-config-lanes.test.js +131 -0
- package/dist/__tests__/init-docs-structure.test.js +119 -0
- package/dist/__tests__/init-lane-inference.test.js +125 -0
- package/dist/__tests__/init-onboarding-docs.test.js +132 -0
- package/dist/__tests__/init-quick-ref.test.js +145 -0
- package/dist/__tests__/init-scripts.test.js +207 -0
- package/dist/__tests__/init-template-portability.test.js +97 -0
- package/dist/__tests__/init.test.js +7 -2
- package/dist/__tests__/initiative-add-wu.test.js +420 -0
- package/dist/__tests__/initiative-plan-replacement.test.js +162 -0
- package/dist/__tests__/initiative-remove-wu.test.js +458 -0
- package/dist/__tests__/onboarding-smoke-test.test.js +211 -0
- package/dist/__tests__/path-centralization-cli.test.js +234 -0
- package/dist/__tests__/plan-create.test.js +126 -0
- package/dist/__tests__/plan-edit.test.js +157 -0
- package/dist/__tests__/plan-link.test.js +239 -0
- package/dist/__tests__/plan-promote.test.js +181 -0
- package/dist/__tests__/templates-sync.test.js +219 -0
- package/dist/__tests__/wu-create-strict.test.js +118 -0
- package/dist/__tests__/wu-edit-strict.test.js +109 -0
- package/dist/__tests__/wu-validate-strict.test.js +113 -0
- package/dist/flow-bottlenecks.js +4 -2
- package/dist/gates.js +22 -0
- package/dist/init.js +670 -87
- package/dist/initiative-add-wu.js +112 -16
- package/dist/initiative-remove-wu.js +248 -0
- package/dist/onboarding-smoke-test.js +400 -0
- package/dist/orchestrate-init-status.js +37 -9
- package/dist/orchestrate-initiative.js +10 -4
- package/dist/plan-create.js +199 -0
- package/dist/plan-edit.js +235 -0
- package/dist/plan-link.js +233 -0
- package/dist/plan-promote.js +231 -0
- package/dist/sync-templates.js +137 -5
- package/dist/wu-block.js +16 -5
- package/dist/wu-claim.js +15 -9
- package/dist/wu-create.js +50 -2
- package/dist/wu-deps.js +3 -1
- package/dist/wu-done.js +14 -5
- package/dist/wu-edit.js +35 -0
- package/dist/wu-prep.js +131 -8
- package/dist/wu-spawn.js +14 -1
- package/dist/wu-unblock.js +34 -2
- package/dist/wu-validate.js +25 -17
- package/package.json +11 -7
- package/templates/core/.lumenflow/constraints.md.template +61 -3
- package/templates/core/AGENTS.md.template +2 -2
- package/templates/core/LUMENFLOW.md.template +85 -23
- package/templates/core/ai/onboarding/agent-invocation-guide.md.template +157 -0
- package/templates/core/ai/onboarding/agent-safety-card.md.template +227 -0
- package/templates/core/ai/onboarding/docs-generation.md.template +277 -0
- package/templates/core/ai/onboarding/first-wu-mistakes.md.template +49 -7
- package/templates/core/ai/onboarding/quick-ref-commands.md.template +343 -110
- package/templates/core/ai/onboarding/release-process.md.template +8 -2
- package/templates/core/ai/onboarding/starting-prompt.md.template +407 -0
- package/templates/core/ai/onboarding/test-ratchet.md.template +131 -0
- package/templates/core/ai/onboarding/troubleshooting-wu-done.md.template +91 -38
- package/templates/core/ai/onboarding/vendor-support.md.template +219 -0
- package/templates/vendors/claude/.claude/skills/context-management/SKILL.md.template +13 -1
- package/templates/vendors/claude/.claude/skills/execution-memory/SKILL.md.template +14 -16
- package/templates/vendors/claude/.claude/skills/orchestration/SKILL.md.template +48 -4
- package/templates/vendors/claude/.claude/skills/worktree-discipline/SKILL.md.template +5 -1
- package/templates/vendors/claude/.claude/skills/wu-lifecycle/SKILL.md.template +19 -8
- package/dist/__tests__/init-plan.test.js +0 -340
- package/dist/agent-issues-query.d.ts +0 -16
- package/dist/agent-log-issue.d.ts +0 -10
- package/dist/agent-session-end.d.ts +0 -10
- package/dist/agent-session.d.ts +0 -10
- package/dist/backlog-prune.d.ts +0 -84
- package/dist/cli-entry-point.d.ts +0 -8
- package/dist/deps-add.d.ts +0 -91
- package/dist/deps-remove.d.ts +0 -17
- package/dist/docs-sync.d.ts +0 -50
- package/dist/file-delete.d.ts +0 -84
- package/dist/file-edit.d.ts +0 -82
- package/dist/file-read.d.ts +0 -92
- package/dist/file-write.d.ts +0 -90
- package/dist/flow-bottlenecks.d.ts +0 -16
- package/dist/flow-report.d.ts +0 -16
- package/dist/gates.d.ts +0 -94
- package/dist/git-branch.d.ts +0 -65
- package/dist/git-diff.d.ts +0 -58
- package/dist/git-log.d.ts +0 -69
- package/dist/git-status.d.ts +0 -58
- package/dist/guard-locked.d.ts +0 -62
- package/dist/guard-main-branch.d.ts +0 -50
- package/dist/guard-worktree-commit.d.ts +0 -59
- package/dist/index.d.ts +0 -10
- package/dist/init-plan.d.ts +0 -80
- package/dist/init-plan.js +0 -337
- package/dist/init.d.ts +0 -46
- package/dist/initiative-add-wu.d.ts +0 -22
- package/dist/initiative-bulk-assign-wus.d.ts +0 -16
- package/dist/initiative-create.d.ts +0 -28
- package/dist/initiative-edit.d.ts +0 -34
- package/dist/initiative-list.d.ts +0 -12
- package/dist/initiative-status.d.ts +0 -11
- package/dist/lumenflow-upgrade.d.ts +0 -103
- package/dist/mem-checkpoint.d.ts +0 -16
- package/dist/mem-cleanup.d.ts +0 -29
- package/dist/mem-create.d.ts +0 -17
- package/dist/mem-export.d.ts +0 -10
- package/dist/mem-inbox.d.ts +0 -35
- package/dist/mem-init.d.ts +0 -15
- package/dist/mem-ready.d.ts +0 -16
- package/dist/mem-signal.d.ts +0 -16
- package/dist/mem-start.d.ts +0 -16
- package/dist/mem-summarize.d.ts +0 -22
- package/dist/mem-triage.d.ts +0 -22
- package/dist/metrics-cli.d.ts +0 -90
- package/dist/metrics-snapshot.d.ts +0 -18
- package/dist/orchestrate-init-status.d.ts +0 -11
- package/dist/orchestrate-initiative.d.ts +0 -12
- package/dist/orchestrate-monitor.d.ts +0 -11
- package/dist/release.d.ts +0 -117
- package/dist/rotate-progress.d.ts +0 -48
- package/dist/session-coordinator.d.ts +0 -74
- package/dist/spawn-list.d.ts +0 -16
- package/dist/state-bootstrap.d.ts +0 -92
- package/dist/sync-templates.d.ts +0 -52
- package/dist/trace-gen.d.ts +0 -84
- package/dist/validate-agent-skills.d.ts +0 -50
- package/dist/validate-agent-sync.d.ts +0 -36
- package/dist/validate-backlog-sync.d.ts +0 -37
- package/dist/validate-skills-spec.d.ts +0 -40
- package/dist/validate.d.ts +0 -60
- package/dist/wu-block.d.ts +0 -16
- package/dist/wu-claim.d.ts +0 -74
- package/dist/wu-cleanup.d.ts +0 -35
- package/dist/wu-create.d.ts +0 -69
- package/dist/wu-delete.d.ts +0 -21
- package/dist/wu-deps.d.ts +0 -13
- package/dist/wu-done.d.ts +0 -225
- package/dist/wu-edit.d.ts +0 -63
- package/dist/wu-infer-lane.d.ts +0 -17
- package/dist/wu-preflight.d.ts +0 -47
- package/dist/wu-prune.d.ts +0 -16
- package/dist/wu-recover.d.ts +0 -37
- package/dist/wu-release.d.ts +0 -19
- package/dist/wu-repair.d.ts +0 -60
- package/dist/wu-spawn-completion.d.ts +0 -10
- package/dist/wu-spawn.d.ts +0 -192
- package/dist/wu-status.d.ts +0 -25
- package/dist/wu-unblock.d.ts +0 -16
- package/dist/wu-unlock-lane.d.ts +0 -19
- package/dist/wu-validate.d.ts +0 -16
package/dist/validate.d.ts
DELETED
|
@@ -1,60 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* @file validate.ts
|
|
4
|
-
* @description Main WU YAML validator CLI (WU-1111)
|
|
5
|
-
*
|
|
6
|
-
* Validates WU tasks and status consistency. This is the replacement for
|
|
7
|
-
* tools/validate.js that was previously a stub.
|
|
8
|
-
*
|
|
9
|
-
* Usage:
|
|
10
|
-
* validate # Validate all WUs
|
|
11
|
-
* validate --id WU-123 # Validate specific WU
|
|
12
|
-
* validate --strict # Fail on warnings too
|
|
13
|
-
* validate --done-only # Only validate done WUs
|
|
14
|
-
*
|
|
15
|
-
* Exit codes:
|
|
16
|
-
* 0 - All validations passed
|
|
17
|
-
* 1 - Validation errors found
|
|
18
|
-
*
|
|
19
|
-
* @see {@link wu-validate.ts} - Detailed WU validation with schema
|
|
20
|
-
* @see {@link docs/04-operations/_frameworks/lumenflow/lumenflow-complete.md} - WU lifecycle
|
|
21
|
-
*/
|
|
22
|
-
/**
|
|
23
|
-
* Validation result for a single WU
|
|
24
|
-
*/
|
|
25
|
-
export interface ValidationResult {
|
|
26
|
-
valid: boolean;
|
|
27
|
-
warnings: string[];
|
|
28
|
-
errors: string[];
|
|
29
|
-
}
|
|
30
|
-
/**
|
|
31
|
-
* Validation summary for multiple WUs
|
|
32
|
-
*/
|
|
33
|
-
export interface ValidationSummary {
|
|
34
|
-
totalValid: number;
|
|
35
|
-
totalInvalid: number;
|
|
36
|
-
totalWarnings: number;
|
|
37
|
-
results: Array<{
|
|
38
|
-
wuId: string;
|
|
39
|
-
} & ValidationResult>;
|
|
40
|
-
}
|
|
41
|
-
/**
|
|
42
|
-
* Validate a single WU file
|
|
43
|
-
*
|
|
44
|
-
* @param wuPath - Path to WU YAML file
|
|
45
|
-
* @param options - Validation options
|
|
46
|
-
* @returns Validation result
|
|
47
|
-
*/
|
|
48
|
-
export declare function validateSingleWU(wuPath: string, options?: {
|
|
49
|
-
strict?: boolean;
|
|
50
|
-
}): ValidationResult;
|
|
51
|
-
/**
|
|
52
|
-
* Validate all WU files in the WU directory
|
|
53
|
-
*
|
|
54
|
-
* @param options - Validation options
|
|
55
|
-
* @returns Summary of all validations
|
|
56
|
-
*/
|
|
57
|
-
export declare function validateAllWUs(options?: {
|
|
58
|
-
strict?: boolean;
|
|
59
|
-
doneOnly?: boolean;
|
|
60
|
-
}): ValidationSummary;
|
package/dist/wu-block.d.ts
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Block Helper
|
|
4
|
-
*
|
|
5
|
-
* Sequence (micro-worktree pattern):
|
|
6
|
-
* 1) Create micro-worktree from main
|
|
7
|
-
* 2) Auto-update WU YAML/backlog/status to Blocked in micro-worktree
|
|
8
|
-
* 3) Commit in micro-worktree, push directly to origin/main
|
|
9
|
-
* 4) Optionally remove work worktree (default: keep)
|
|
10
|
-
*
|
|
11
|
-
* Uses micro-worktree pattern to avoid pre-commit hook blocking commits to main.
|
|
12
|
-
*
|
|
13
|
-
* Usage:
|
|
14
|
-
* pnpm wu:block --id WU-334 [--reason "Waiting on policy"] [--worktree ...] [--remove-worktree] [--no-auto]
|
|
15
|
-
*/
|
|
16
|
-
export {};
|
package/dist/wu-claim.d.ts
DELETED
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Claim Helper
|
|
4
|
-
*
|
|
5
|
-
* Canonical sequence:
|
|
6
|
-
* 1) Auto-update backlog/status/WU YAML (safe parsing) unless `--no-auto`
|
|
7
|
-
* 2) Commit and push to `main`
|
|
8
|
-
* 3) Create a dedicated worktree+branch for the WU
|
|
9
|
-
*
|
|
10
|
-
* Usage:
|
|
11
|
-
* node tools/wu-claim.mjs --id WU-334 --lane Intelligence \
|
|
12
|
-
* [--worktree worktrees/intelligence-wu-334] [--branch lane/intelligence/wu-334]
|
|
13
|
-
*
|
|
14
|
-
* WU-2542: This script imports utilities from @lumenflow/core package.
|
|
15
|
-
* Full migration to thin shim pending @lumenflow/core CLI export implementation.
|
|
16
|
-
*/
|
|
17
|
-
/**
|
|
18
|
-
* WU-1746: Get list of files to commit in worktree mode
|
|
19
|
-
* Excludes backlog.md and status.md to prevent merge conflicts.
|
|
20
|
-
* These generated files should only be updated on main during wu:done.
|
|
21
|
-
*
|
|
22
|
-
* @param {string} wuId - WU ID (e.g., 'WU-1746')
|
|
23
|
-
* @returns {string[]} List of files to commit
|
|
24
|
-
*/
|
|
25
|
-
export declare function getWorktreeCommitFiles(wuId: any): string[];
|
|
26
|
-
/**
|
|
27
|
-
* WU-1047: Format Project Defaults section (agent-only).
|
|
28
|
-
*
|
|
29
|
-
* @param {object} methodology - Methodology defaults config
|
|
30
|
-
* @returns {string} Formatted output or empty string if disabled
|
|
31
|
-
*/
|
|
32
|
-
export declare function formatProjectDefaults(methodology: any): string;
|
|
33
|
-
/**
|
|
34
|
-
* WU-1047: Print Project Defaults section (agent-only).
|
|
35
|
-
*
|
|
36
|
-
* @param {object} methodology - Methodology defaults config
|
|
37
|
-
*/
|
|
38
|
-
export declare function printProjectDefaults(methodology: any): void;
|
|
39
|
-
/**
|
|
40
|
-
* WU-1763: Print a single concise tips line to improve tool adoption.
|
|
41
|
-
* Non-blocking, single-line output to avoid flooding the console.
|
|
42
|
-
*
|
|
43
|
-
* @param {string} _id - WU ID being claimed (unused, kept for future use)
|
|
44
|
-
*/
|
|
45
|
-
export declare function printLifecycleNudge(_id: any): void;
|
|
46
|
-
/**
|
|
47
|
-
* WU-1029: Apply symlink fallback (root + nested node_modules) after install failure.
|
|
48
|
-
*
|
|
49
|
-
* @param {string} worktreePath - Worktree path
|
|
50
|
-
* @param {string} mainRepoPath - Main repo path
|
|
51
|
-
* @param {Console} logger - Logger (console-compatible)
|
|
52
|
-
*/
|
|
53
|
-
export declare function applyFallbackSymlinks(worktreePath: any, mainRepoPath: any, logger?: Console): {
|
|
54
|
-
symlinkResult: {
|
|
55
|
-
created: boolean;
|
|
56
|
-
skipped: boolean;
|
|
57
|
-
refused?: undefined;
|
|
58
|
-
reason?: undefined;
|
|
59
|
-
error?: undefined;
|
|
60
|
-
} | {
|
|
61
|
-
created: boolean;
|
|
62
|
-
skipped: boolean;
|
|
63
|
-
refused: boolean;
|
|
64
|
-
reason: string;
|
|
65
|
-
error?: undefined;
|
|
66
|
-
} | {
|
|
67
|
-
created: boolean;
|
|
68
|
-
skipped: boolean;
|
|
69
|
-
error: any;
|
|
70
|
-
refused?: undefined;
|
|
71
|
-
reason?: undefined;
|
|
72
|
-
};
|
|
73
|
-
nestedResult: any;
|
|
74
|
-
};
|
package/dist/wu-cleanup.d.ts
DELETED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Cleanup Helper
|
|
4
|
-
*
|
|
5
|
-
* Cleans up worktree and branch after PR merge (PR-based completion workflow).
|
|
6
|
-
*
|
|
7
|
-
* Sequence:
|
|
8
|
-
* 1) Verify PR is merged (via gh API; no merge-base fallback)
|
|
9
|
-
* 2) Remove worktree (if exists)
|
|
10
|
-
* 3) Delete lane branch (local + remote)
|
|
11
|
-
*
|
|
12
|
-
* Idempotent: Safe no-op if already cleaned.
|
|
13
|
-
*
|
|
14
|
-
* Usage:
|
|
15
|
-
* pnpm wu:cleanup --id WU-703
|
|
16
|
-
* pnpm wu:cleanup --artifacts
|
|
17
|
-
*/
|
|
18
|
-
export declare const CLEANUP_GUARD_REASONS: {
|
|
19
|
-
UNCOMMITTED_CHANGES: string;
|
|
20
|
-
UNPUSHED_COMMITS: string;
|
|
21
|
-
STATUS_NOT_DONE: string;
|
|
22
|
-
MISSING_STAMP: string;
|
|
23
|
-
PR_NOT_MERGED: string;
|
|
24
|
-
};
|
|
25
|
-
export declare function evaluateCleanupGuards({ hasUncommittedChanges, hasUnpushedCommits, hasStamp, yamlStatus, ghAvailable, prMerged, }: {
|
|
26
|
-
hasUncommittedChanges: any;
|
|
27
|
-
hasUnpushedCommits: any;
|
|
28
|
-
hasStamp: any;
|
|
29
|
-
yamlStatus: any;
|
|
30
|
-
ghAvailable: any;
|
|
31
|
-
prMerged: any;
|
|
32
|
-
}): {
|
|
33
|
-
allowed: boolean;
|
|
34
|
-
reason: string;
|
|
35
|
-
};
|
package/dist/wu-create.d.ts
DELETED
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Create Helper (WU-1262, WU-1439)
|
|
4
|
-
*
|
|
5
|
-
* Race-safe WU creation using shared micro-worktree isolation.
|
|
6
|
-
*
|
|
7
|
-
* Canonical sequence:
|
|
8
|
-
* 1) Validate inputs (id, lane, title)
|
|
9
|
-
* 2) Ensure on main branch
|
|
10
|
-
* 3) Use withMicroWorktree() to atomically:
|
|
11
|
-
* a) Create temp branch without switching main checkout
|
|
12
|
-
* b) Create WU-{id}.yaml and update backlog.md in micro-worktree
|
|
13
|
-
* c) Commit with "docs: create wu-{id} for <title>" message
|
|
14
|
-
* d) Merge to main with ff-only (retry with rebase if needed)
|
|
15
|
-
* e) Push to origin/main
|
|
16
|
-
* f) Cleanup temp branch and micro-worktree
|
|
17
|
-
*
|
|
18
|
-
* Benefits:
|
|
19
|
-
* - Main checkout never switches branches (no impact on other agents)
|
|
20
|
-
* - Race conditions handled via rebase+retry (up to 3 attempts)
|
|
21
|
-
* - Cleanup guaranteed even on failure
|
|
22
|
-
*
|
|
23
|
-
* Usage:
|
|
24
|
-
* pnpm wu:create --id WU-706 --lane Intelligence --title "Fix XYZ issue"
|
|
25
|
-
*
|
|
26
|
-
* Context: WU-705 (fix agent coordination failures), WU-1262 (micro-worktree isolation),
|
|
27
|
-
* WU-1439 (refactor to shared helper)
|
|
28
|
-
*/
|
|
29
|
-
/**
|
|
30
|
-
* WU-2330: Check if a more specific sub-lane matches the provided inputs.
|
|
31
|
-
* Non-blocking - just logs a warning if a better lane is suggested.
|
|
32
|
-
*
|
|
33
|
-
* @param {string} providedLane - Lane provided by the user
|
|
34
|
-
* @param {string|undefined} codePathsRaw - Comma-separated code paths
|
|
35
|
-
* @param {string} title - WU title (used as fallback description)
|
|
36
|
-
* @param {string|undefined} description - WU description
|
|
37
|
-
*/
|
|
38
|
-
export declare function warnIfBetterLaneExists(providedLane: any, codePathsRaw: any, title: any, description: any): void;
|
|
39
|
-
/** Options for creating WU YAML */
|
|
40
|
-
interface CreateWUOptions {
|
|
41
|
-
initiative?: string;
|
|
42
|
-
phase?: string;
|
|
43
|
-
blockedBy?: string;
|
|
44
|
-
blocks?: string;
|
|
45
|
-
labels?: string;
|
|
46
|
-
assignedTo?: string;
|
|
47
|
-
description?: string;
|
|
48
|
-
acceptance?: string[];
|
|
49
|
-
codePaths?: string;
|
|
50
|
-
testPathsManual?: string;
|
|
51
|
-
testPathsUnit?: string;
|
|
52
|
-
testPathsE2e?: string;
|
|
53
|
-
exposure?: string;
|
|
54
|
-
userJourney?: string;
|
|
55
|
-
uiPairingWus?: string;
|
|
56
|
-
specRefs?: string;
|
|
57
|
-
}
|
|
58
|
-
export declare function validateCreateSpec({ id, lane, title, priority, type, opts, }: {
|
|
59
|
-
id: string;
|
|
60
|
-
lane: string;
|
|
61
|
-
title: string;
|
|
62
|
-
priority: string;
|
|
63
|
-
type: string;
|
|
64
|
-
opts: CreateWUOptions;
|
|
65
|
-
}): {
|
|
66
|
-
valid: boolean;
|
|
67
|
-
errors: any[];
|
|
68
|
-
};
|
|
69
|
-
export {};
|
package/dist/wu-delete.d.ts
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Delete Helper
|
|
4
|
-
*
|
|
5
|
-
* Race-safe WU deletion using micro-worktree isolation.
|
|
6
|
-
*
|
|
7
|
-
* Uses micro-worktree pattern:
|
|
8
|
-
* 1) Validate inputs (WU exists, status is not in_progress)
|
|
9
|
-
* 2) Ensure main is clean and up-to-date with origin
|
|
10
|
-
* 3) Create temp branch WITHOUT switching (main checkout stays on main)
|
|
11
|
-
* 4) Create micro-worktree in /tmp pointing to temp branch
|
|
12
|
-
* 5) Delete WU file and update backlog.md in micro-worktree
|
|
13
|
-
* 6) Commit, ff-only merge, push
|
|
14
|
-
* 7) Cleanup temp branch and micro-worktree
|
|
15
|
-
*
|
|
16
|
-
* Usage:
|
|
17
|
-
* pnpm wu:delete --id WU-123 # Single WU deletion
|
|
18
|
-
* pnpm wu:delete --id WU-123 --dry-run # Dry run
|
|
19
|
-
* pnpm wu:delete --batch WU-1,WU-2,WU-3 # Batch deletion
|
|
20
|
-
*/
|
|
21
|
-
export {};
|
package/dist/wu-deps.d.ts
DELETED
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Dependency Visualization (WU-1247)
|
|
4
|
-
*
|
|
5
|
-
* Shows dependency graph for a WU in ASCII or Mermaid format.
|
|
6
|
-
*
|
|
7
|
-
* Usage:
|
|
8
|
-
* pnpm wu:deps WU-1247 # ASCII format
|
|
9
|
-
* pnpm wu:deps WU-1247 --format mermaid # Mermaid diagram
|
|
10
|
-
* pnpm wu:deps WU-1247 --depth 5 # Deeper traversal
|
|
11
|
-
* pnpm wu:deps WU-1247 --direction up # Only upstream deps
|
|
12
|
-
*/
|
|
13
|
-
export {};
|
package/dist/wu-done.d.ts
DELETED
|
@@ -1,225 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Done Helper
|
|
4
|
-
*
|
|
5
|
-
* Canonical sequence (Worktree mode - DEFAULT):
|
|
6
|
-
* 1) Run gates in lane worktree (validates the change, not just main)
|
|
7
|
-
* 2) Pre-flight validation: run ALL pre-commit hooks before merge (prevents partial completion)
|
|
8
|
-
* 3) cd into worktree
|
|
9
|
-
* 4) Auto-update WU YAML/backlog/status to Done in worktree (unless --no-auto)
|
|
10
|
-
* 5) Create `.lumenflow/stamps/WU-{id}.done` in worktree
|
|
11
|
-
* 6) Validate staged files against whitelist
|
|
12
|
-
* 7) Commit metadata changes in worktree (on lane branch)
|
|
13
|
-
* 8) cd back to main
|
|
14
|
-
* 9) Merge lane branch to main with --ff-only (metadata + code merged atomically)
|
|
15
|
-
* 10) Push to `main`
|
|
16
|
-
* 11) Remove the associated worktree (unless --no-remove)
|
|
17
|
-
* 12) Optionally delete the lane branch (with --delete-branch)
|
|
18
|
-
* 13) Emit telemetry to .lumenflow/flow.log
|
|
19
|
-
*
|
|
20
|
-
* Canonical sequence (Branch-Only mode - LEGACY):
|
|
21
|
-
* 1) Run gates on lane branch (in main checkout)
|
|
22
|
-
* 2) Pre-flight validation
|
|
23
|
-
* 3) Merge lane branch to main
|
|
24
|
-
* 4) Update metadata on main
|
|
25
|
-
* 5) Commit and push
|
|
26
|
-
* 6) Delete lane branch
|
|
27
|
-
*
|
|
28
|
-
* Usage:
|
|
29
|
-
* pnpm wu:done --id WU-334 [--worktree worktrees/intelligence-wu-334] [--no-auto] [--no-remove] [--no-merge] [--delete-branch]
|
|
30
|
-
*
|
|
31
|
-
* WU-2542: This script imports utilities from @lumenflow/core package.
|
|
32
|
-
* Full migration to thin shim pending @lumenflow/core CLI export implementation.
|
|
33
|
-
*/
|
|
34
|
-
/**
|
|
35
|
-
* WU-1999: Print exposure validation warnings.
|
|
36
|
-
*
|
|
37
|
-
* Validates exposure field and UI pairing for user-facing WUs.
|
|
38
|
-
* Non-blocking - logs warnings but doesn't prevent completion.
|
|
39
|
-
*
|
|
40
|
-
* Checks:
|
|
41
|
-
* - exposure field is present (warn if missing)
|
|
42
|
-
* - If exposure=api, warns if no ui_pairing_wus specified
|
|
43
|
-
* - If exposure=api, checks acceptance criteria for UI verification mention
|
|
44
|
-
* - If exposure=ui, recommends user_journey field if not present
|
|
45
|
-
*
|
|
46
|
-
* @param {object} wu - WU YAML document
|
|
47
|
-
* @param {object} options - Validation options
|
|
48
|
-
* @param {boolean} [options.skipExposureCheck=false] - Skip all exposure validation
|
|
49
|
-
* @returns {void}
|
|
50
|
-
*/
|
|
51
|
-
interface ExposureOptions {
|
|
52
|
-
skipExposureCheck?: boolean;
|
|
53
|
-
}
|
|
54
|
-
export declare function printExposureWarnings(wu: Record<string, unknown>, options?: ExposureOptions): void;
|
|
55
|
-
/**
|
|
56
|
-
* WU-2022: Validate feature accessibility for UI-exposed WUs.
|
|
57
|
-
*
|
|
58
|
-
* BLOCKING validation - prevents wu:done if exposure=ui but feature is not accessible.
|
|
59
|
-
* This prevents "orphaned code" where UI features exist but users cannot navigate to them.
|
|
60
|
-
*
|
|
61
|
-
* Accessibility is verified by ANY of:
|
|
62
|
-
* 1. navigation_path field is specified (explicit route)
|
|
63
|
-
* 2. code_paths includes a page.tsx file (Next.js page)
|
|
64
|
-
* 3. tests.manual includes navigation/accessibility verification
|
|
65
|
-
*
|
|
66
|
-
* @param {object} wu - WU YAML document
|
|
67
|
-
* @param {object} options - Validation options
|
|
68
|
-
* @param {boolean} [options.skipAccessibilityCheck=false] - Skip accessibility validation
|
|
69
|
-
* @returns {void} Calls die() if validation fails
|
|
70
|
-
*/
|
|
71
|
-
interface AccessibilityOptions {
|
|
72
|
-
skipAccessibilityCheck?: boolean;
|
|
73
|
-
}
|
|
74
|
-
export declare function validateAccessibilityOrDie(wu: Record<string, unknown>, options?: AccessibilityOptions): void;
|
|
75
|
-
/**
|
|
76
|
-
* WU-1012: Validate --docs-only flag usage.
|
|
77
|
-
*
|
|
78
|
-
* The --docs-only flag can only be used when the WU is documentation-focused:
|
|
79
|
-
* 1. exposure field is 'documentation'
|
|
80
|
-
* 2. OR all code_paths are documentation paths (docs/, ai/, .claude/, *.md)
|
|
81
|
-
* 3. OR type is 'documentation'
|
|
82
|
-
*
|
|
83
|
-
* @param {object} wu - WU YAML document
|
|
84
|
-
* @param {object} args - Parsed CLI arguments
|
|
85
|
-
* @param {boolean} args.docsOnly - Whether --docs-only flag was passed
|
|
86
|
-
* @returns {{ valid: boolean, errors: string[] }} Validation result
|
|
87
|
-
*/
|
|
88
|
-
interface DocsOnlyArgs {
|
|
89
|
-
docsOnly?: boolean;
|
|
90
|
-
}
|
|
91
|
-
export declare function validateDocsOnlyFlag(wu: Record<string, unknown>, args: DocsOnlyArgs): {
|
|
92
|
-
valid: boolean;
|
|
93
|
-
errors: string[];
|
|
94
|
-
};
|
|
95
|
-
/**
|
|
96
|
-
* WU-1012: Build gates command with --docs-only flag support.
|
|
97
|
-
*
|
|
98
|
-
* Returns the appropriate gates command based on:
|
|
99
|
-
* - Explicit --docs-only flag from CLI
|
|
100
|
-
* - Auto-detected isDocsOnly from code_paths analysis
|
|
101
|
-
*
|
|
102
|
-
* @param {object} options - Build options
|
|
103
|
-
* @param {boolean} options.docsOnly - Explicit --docs-only flag from CLI
|
|
104
|
-
* @param {boolean} options.isDocsOnly - Auto-detected docs-only from code_paths
|
|
105
|
-
* @returns {string} Gates command string
|
|
106
|
-
*/
|
|
107
|
-
interface BuildGatesOptions {
|
|
108
|
-
docsOnly?: boolean;
|
|
109
|
-
isDocsOnly?: boolean;
|
|
110
|
-
}
|
|
111
|
-
export declare function buildGatesCommand(options: BuildGatesOptions): string;
|
|
112
|
-
/**
|
|
113
|
-
* WU-1946: Update spawn registry on WU completion.
|
|
114
|
-
* Non-blocking wrapper - failures logged as warnings.
|
|
115
|
-
*
|
|
116
|
-
* When a WU is completed via wu:done, this function updates the spawn registry
|
|
117
|
-
* to mark the spawned entry as completed (if one exists). This allows orchestrators
|
|
118
|
-
* to track sub-agent spawn completion status.
|
|
119
|
-
*
|
|
120
|
-
* Gracefully skips if:
|
|
121
|
-
* - No spawn entry found for this WU (legacy WU created before registry)
|
|
122
|
-
* - Registry file doesn't exist
|
|
123
|
-
* - Any error during update
|
|
124
|
-
*
|
|
125
|
-
* @param {string} id - WU ID being completed
|
|
126
|
-
* @param {string} baseDir - Base directory containing .lumenflow/state/
|
|
127
|
-
* @returns {Promise<void>}
|
|
128
|
-
*/
|
|
129
|
-
export declare function updateSpawnRegistryOnCompletion(id: any, baseDir?: string): Promise<void>;
|
|
130
|
-
/**
|
|
131
|
-
* WU-1234: Normalize username for ownership comparison
|
|
132
|
-
* Extracts username from email address for comparison.
|
|
133
|
-
* This allows tom@hellm.ai to match 'tom' assigned_to field.
|
|
134
|
-
*
|
|
135
|
-
* @param {string|null|undefined} value - Email address or username
|
|
136
|
-
* @returns {string} Normalized username (lowercase)
|
|
137
|
-
*/
|
|
138
|
-
export declare function normalizeUsername(value: any): string;
|
|
139
|
-
/**
|
|
140
|
-
* WU-1234: Detect if branch is already merged to main
|
|
141
|
-
* Checks if branch tip is an ancestor of main HEAD (i.e., already merged).
|
|
142
|
-
* This prevents merge loops when code was merged via emergency fix or manual merge.
|
|
143
|
-
*
|
|
144
|
-
* @param {string} branch - Lane branch name
|
|
145
|
-
* @returns {Promise<boolean>} True if branch is already merged to main
|
|
146
|
-
*/
|
|
147
|
-
export declare function isBranchAlreadyMerged(branch: any): Promise<boolean>;
|
|
148
|
-
export { shouldSkipWebTests as isDocsOnlyByPaths } from '@lumenflow/core/dist/path-classifiers.js';
|
|
149
|
-
/**
|
|
150
|
-
* WU-1234: Pre-flight check for backlog state consistency
|
|
151
|
-
* Fails fast if the WU appears in both Done and In Progress sections.
|
|
152
|
-
*
|
|
153
|
-
* @param {string} id - WU ID to check
|
|
154
|
-
* @param {string} backlogPath - Path to backlog.md
|
|
155
|
-
* @returns {{ valid: boolean, error: string|null }}
|
|
156
|
-
*/
|
|
157
|
-
export declare function checkBacklogConsistencyForWU(id: any, backlogPath: any): {
|
|
158
|
-
valid: boolean;
|
|
159
|
-
error: string;
|
|
160
|
-
};
|
|
161
|
-
/**
|
|
162
|
-
* WU-1084: Check for uncommitted changes on main after merge completes.
|
|
163
|
-
*
|
|
164
|
-
* This catches cases where pnpm format (or other tooling) touched files
|
|
165
|
-
* outside the WU's code_paths during worktree work. These changes survive
|
|
166
|
-
* the merge and would be silently left behind when the worktree is removed.
|
|
167
|
-
*
|
|
168
|
-
* @param gitStatus - Output from git status (porcelain format)
|
|
169
|
-
* @param wuId - The WU ID for error messaging
|
|
170
|
-
* @returns Object with isDirty flag and optional error message
|
|
171
|
-
*/
|
|
172
|
-
export declare function checkPostMergeDirtyState(gitStatus: string, wuId: string): {
|
|
173
|
-
isDirty: boolean;
|
|
174
|
-
error?: string;
|
|
175
|
-
};
|
|
176
|
-
export declare function emitTelemetry(event: any): void;
|
|
177
|
-
/**
|
|
178
|
-
* Print State HUD for visibility
|
|
179
|
-
* Extracted from main() to reduce complexity (WU-1215 Phase 2 Extraction #4)
|
|
180
|
-
* @param {object} params - Parameters
|
|
181
|
-
* @param {string} params.id - WU ID
|
|
182
|
-
* @param {object} params.docMain - Main WU YAML document
|
|
183
|
-
* @param {boolean} params.isBranchOnly - Whether in branch-only mode
|
|
184
|
-
* @param {boolean} params.isDocsOnly - Whether this is a docs-only WU
|
|
185
|
-
* @param {string|null} params.derivedWorktree - Derived worktree path
|
|
186
|
-
* @param {string} params.STAMPS_DIR - Stamps directory path
|
|
187
|
-
*/
|
|
188
|
-
export declare function computeBranchOnlyFallback({ isBranchOnly, branchOnlyRequested, worktreeExists, derivedWorktree, }: {
|
|
189
|
-
isBranchOnly: boolean;
|
|
190
|
-
branchOnlyRequested: boolean | undefined;
|
|
191
|
-
worktreeExists: boolean;
|
|
192
|
-
derivedWorktree: string | null;
|
|
193
|
-
}): {
|
|
194
|
-
allowFallback: boolean;
|
|
195
|
-
effectiveBranchOnly: boolean;
|
|
196
|
-
};
|
|
197
|
-
/**
|
|
198
|
-
* WU-1983: Print migration deployment nudge when WU includes supabase changes.
|
|
199
|
-
* Notifies agent to deploy new migrations to production via MCP tools.
|
|
200
|
-
* Conditional output - only prints when migrations are in scope and new migrations exist.
|
|
201
|
-
*
|
|
202
|
-
* @param {string[]} codePaths - WU code_paths array
|
|
203
|
-
* @param {string} baseDir - Base directory for migration discovery
|
|
204
|
-
* @returns {Promise<void>}
|
|
205
|
-
*/
|
|
206
|
-
export declare function printMigrationDeploymentNudge(codePaths: any, baseDir: any): Promise<void>;
|
|
207
|
-
/**
|
|
208
|
-
* WU-1763: Print discovery summary nudge when discoveries exist for this WU.
|
|
209
|
-
* Conditional output - only prints when discoveryCount > 0.
|
|
210
|
-
* Non-blocking, single-line output to avoid flooding the console.
|
|
211
|
-
*
|
|
212
|
-
* @param {string} id - WU ID being completed
|
|
213
|
-
* @param {number} discoveryCount - Number of open discoveries for this WU
|
|
214
|
-
* @param {string[]} discoveryIds - List of discovery IDs (limited to 5 in output)
|
|
215
|
-
*/
|
|
216
|
-
export declare function printDiscoveryNudge(id: any, discoveryCount: any, discoveryIds: any): void;
|
|
217
|
-
/**
|
|
218
|
-
* WU-1763: Print documentation validation nudge when docs changed.
|
|
219
|
-
* Conditional output - only prints when changedDocPaths.length > 0.
|
|
220
|
-
* Non-blocking, single-line output to avoid flooding the console.
|
|
221
|
-
*
|
|
222
|
-
* @param {string} id - WU ID being completed
|
|
223
|
-
* @param {string[]} changedDocPaths - List of documentation paths that changed
|
|
224
|
-
*/
|
|
225
|
-
export declare function printDocValidationNudge(id: any, changedDocPaths: any): void;
|
package/dist/wu-edit.d.ts
DELETED
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Edit Helper
|
|
4
|
-
*
|
|
5
|
-
* Race-safe WU spec editing using micro-worktree isolation (WU-1274).
|
|
6
|
-
*
|
|
7
|
-
* Enables editing WU YAML files without claiming the WU, perfect for:
|
|
8
|
-
* - Filling in placeholder content after wu:create
|
|
9
|
-
* - Updating description/acceptance criteria
|
|
10
|
-
* - Adding code_paths, notes, or other spec fields
|
|
11
|
-
*
|
|
12
|
-
* Uses the same micro-worktree pattern as wu:create (WU-1262):
|
|
13
|
-
* 1) Validate inputs (WU exists, status is ready)
|
|
14
|
-
* 2) Ensure main is clean and up-to-date with origin
|
|
15
|
-
* 3) Create temp branch WITHOUT switching (main checkout stays on main)
|
|
16
|
-
* 4) Create micro-worktree in /tmp pointing to temp branch
|
|
17
|
-
* 5) Apply edits in micro-worktree
|
|
18
|
-
* 6) Commit, ff-only merge, push
|
|
19
|
-
* 7) Cleanup temp branch and micro-worktree
|
|
20
|
-
*
|
|
21
|
-
* Usage:
|
|
22
|
-
* pnpm wu:edit --id WU-123 --spec-file /path/to/spec.yaml
|
|
23
|
-
* pnpm wu:edit --id WU-123 --description "New description text"
|
|
24
|
-
* pnpm wu:edit --id WU-123 --acceptance "Criterion 1" --acceptance "Criterion 2"
|
|
25
|
-
*
|
|
26
|
-
* Part of WU-1274: Add wu:edit command for spec-only changes
|
|
27
|
-
* @see {@link tools/lib/micro-worktree.mjs} - Shared micro-worktree logic
|
|
28
|
-
*/
|
|
29
|
-
/**
|
|
30
|
-
* WU-1039: Validate which edits are allowed on done WUs
|
|
31
|
-
*
|
|
32
|
-
* Done WUs only allow metadata reassignment: initiative, phase, and exposure.
|
|
33
|
-
* All other edits are blocked to preserve WU immutability after completion.
|
|
34
|
-
*
|
|
35
|
-
* @param opts - Parsed CLI options
|
|
36
|
-
* @returns { valid: boolean, disallowedEdits: string[] }
|
|
37
|
-
*/
|
|
38
|
-
export declare function validateDoneWUEdits(opts: Record<string, unknown>): {
|
|
39
|
-
valid: boolean;
|
|
40
|
-
disallowedEdits: string[];
|
|
41
|
-
};
|
|
42
|
-
/**
|
|
43
|
-
* WU-1039: Validate exposure value against schema
|
|
44
|
-
*
|
|
45
|
-
* Uses WU_EXPOSURE_VALUES from core constants (Library-First, no magic strings).
|
|
46
|
-
*
|
|
47
|
-
* @param exposure - Exposure value to validate
|
|
48
|
-
* @returns { valid: boolean, error?: string }
|
|
49
|
-
*/
|
|
50
|
-
export declare function validateExposureValue(exposure: string): {
|
|
51
|
-
valid: boolean;
|
|
52
|
-
error?: string;
|
|
53
|
-
};
|
|
54
|
-
/**
|
|
55
|
-
* WU-1039: Apply exposure edit to WU object
|
|
56
|
-
*
|
|
57
|
-
* Returns a new WU object with updated exposure (immutable pattern).
|
|
58
|
-
*
|
|
59
|
-
* @param wu - Original WU object
|
|
60
|
-
* @param exposure - New exposure value
|
|
61
|
-
* @returns Updated WU object (does not mutate original)
|
|
62
|
-
*/
|
|
63
|
-
export declare function applyExposureEdit(wu: Record<string, unknown>, exposure: string): Record<string, unknown>;
|
package/dist/wu-infer-lane.d.ts
DELETED
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Lane Inference CLI (WU-908)
|
|
4
|
-
*
|
|
5
|
-
* Suggests sub-lane for a WU based on code paths and description.
|
|
6
|
-
* Wrapper around lib/lane-inference.mjs for standalone CLI usage.
|
|
7
|
-
*
|
|
8
|
-
* Usage:
|
|
9
|
-
* # Infer from existing WU
|
|
10
|
-
* node tools/wu-infer-lane.mjs --id WU-123
|
|
11
|
-
*
|
|
12
|
-
* # Infer from manual inputs
|
|
13
|
-
* node tools/wu-infer-lane.mjs --paths "tools/**" "docs/**" --desc "Tooling improvements"
|
|
14
|
-
*
|
|
15
|
-
* Returns suggested lane and confidence score (0-100).
|
|
16
|
-
*/
|
|
17
|
-
export {};
|
package/dist/wu-preflight.d.ts
DELETED
|
@@ -1,47 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Preflight Validation
|
|
4
|
-
*
|
|
5
|
-
* WU-1803: Fast validation of code_paths and test paths before gates run.
|
|
6
|
-
* Completes in under 5 seconds vs 2+ minutes for full gates.
|
|
7
|
-
*
|
|
8
|
-
* This catches YAML mismatches early, preventing wasted time running full
|
|
9
|
-
* gates only to fail on code_paths validation at the end of wu:done.
|
|
10
|
-
*
|
|
11
|
-
* Usage:
|
|
12
|
-
* pnpm wu:preflight --id WU-1803 # Validate from main checkout
|
|
13
|
-
* pnpm wu:preflight --id WU-1803 --worktree worktrees/operations-gates-wu-1803
|
|
14
|
-
*
|
|
15
|
-
* Validates:
|
|
16
|
-
* - code_paths files exist
|
|
17
|
-
* - test file paths exist (unit, e2e, integration)
|
|
18
|
-
* - WU YAML schema is valid
|
|
19
|
-
*/
|
|
20
|
-
/**
|
|
21
|
-
* Parse command-line arguments
|
|
22
|
-
* @param {string[]} argv - Process arguments
|
|
23
|
-
* @returns {object} Parsed arguments
|
|
24
|
-
*/
|
|
25
|
-
declare function parseArgs(argv: any): {
|
|
26
|
-
help: boolean;
|
|
27
|
-
error?: undefined;
|
|
28
|
-
id?: undefined;
|
|
29
|
-
worktree?: undefined;
|
|
30
|
-
} | {
|
|
31
|
-
error: string;
|
|
32
|
-
help?: undefined;
|
|
33
|
-
id?: undefined;
|
|
34
|
-
worktree?: undefined;
|
|
35
|
-
} | {
|
|
36
|
-
id: any;
|
|
37
|
-
worktree: any;
|
|
38
|
-
help: boolean;
|
|
39
|
-
error?: undefined;
|
|
40
|
-
};
|
|
41
|
-
/**
|
|
42
|
-
* Detect worktree path from WU YAML or calculate from lane
|
|
43
|
-
* @param {string} id - WU ID
|
|
44
|
-
* @returns {string|null} Worktree path or null if not found
|
|
45
|
-
*/
|
|
46
|
-
declare function detectWorktreePath(id: any): string;
|
|
47
|
-
export { parseArgs, detectWorktreePath };
|
package/dist/wu-prune.d.ts
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
/**
|
|
3
|
-
* WU Prune Utility
|
|
4
|
-
*
|
|
5
|
-
* Maintains worktree hygiene by:
|
|
6
|
-
* - Running git worktree prune to clean stale metadata
|
|
7
|
-
* - Validating worktree ↔ WU ↔ lane mappings
|
|
8
|
-
* - Warning on orphaned worktrees (no matching WU YAML)
|
|
9
|
-
* - Warning on stale worktrees (WU status is done/blocked)
|
|
10
|
-
* - Warning on invalid branch naming conventions
|
|
11
|
-
*
|
|
12
|
-
* Usage:
|
|
13
|
-
* pnpm wu:prune # Dry-run mode (shows what would be done)
|
|
14
|
-
* pnpm wu:prune --execute # Actually run cleanup
|
|
15
|
-
*/
|
|
16
|
-
export {};
|