@lumenflow/cli 3.8.7 → 3.9.0
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 -15
- package/dist/cli-entry-point.js +7 -0
- package/dist/cli-entry-point.js.map +1 -1
- package/dist/gate-defaults.js +5 -0
- package/dist/gate-defaults.js.map +1 -1
- package/dist/gates-runners.js +77 -1
- package/dist/gates-runners.js.map +1 -1
- package/dist/guard-main-branch.js +3 -2
- package/dist/guard-main-branch.js.map +1 -1
- package/dist/hooks/enforcement-checks.js +3 -2
- package/dist/hooks/enforcement-checks.js.map +1 -1
- package/dist/hooks/path-utils.js +2 -1
- package/dist/hooks/path-utils.js.map +1 -1
- package/dist/init-detection.js +3 -3
- package/dist/init-detection.js.map +1 -1
- package/dist/lane-create.js +223 -0
- package/dist/lane-create.js.map +1 -0
- package/dist/mem-signal.js +1 -1
- package/dist/mem-signal.js.map +1 -1
- package/dist/public-manifest.js +7 -0
- package/dist/public-manifest.js.map +1 -1
- package/dist/signal-middleware.js +192 -0
- package/dist/signal-middleware.js.map +1 -0
- package/dist/state-doctor.js +135 -0
- package/dist/state-doctor.js.map +1 -1
- package/dist/state-emit.js +72 -10
- package/dist/state-emit.js.map +1 -1
- package/dist/validate.js +2 -2
- package/dist/validate.js.map +1 -1
- package/dist/wu-claim.js +75 -10
- package/dist/wu-claim.js.map +1 -1
- package/dist/wu-done-already-merged.js +2 -7
- package/dist/wu-done-already-merged.js.map +1 -1
- package/dist/wu-done-gates.js +296 -0
- package/dist/wu-done-gates.js.map +1 -0
- package/dist/wu-done-memory-telemetry.js +145 -0
- package/dist/wu-done-memory-telemetry.js.map +1 -0
- package/dist/wu-done-mode-execution.js +136 -0
- package/dist/wu-done-mode-execution.js.map +1 -0
- package/dist/wu-done-policies.js +206 -1
- package/dist/wu-done-policies.js.map +1 -1
- package/dist/wu-done-preflight.js +207 -0
- package/dist/wu-done-preflight.js.map +1 -0
- package/dist/wu-done.js +48 -888
- package/dist/wu-done.js.map +1 -1
- package/dist/wu-edit-validators.js +30 -1
- package/dist/wu-edit-validators.js.map +1 -1
- package/dist/wu-edit.js +7 -2
- package/dist/wu-edit.js.map +1 -1
- package/dist/wu-prep.js +17 -1
- package/dist/wu-prep.js.map +1 -1
- package/dist/wu-spawn-prompt-builders.js +65 -10
- package/dist/wu-spawn-prompt-builders.js.map +1 -1
- package/package.json +9 -8
- package/packs/sidekick/.turbo/turbo-build.log +1 -1
- package/packs/sidekick/package.json +1 -1
- package/packs/software-delivery/.turbo/turbo-build.log +1 -1
- package/packs/software-delivery/package.json +1 -1
- package/templates/core/.lumenflow/constraints.md.template +12 -14
- package/templates/core/LUMENFLOW.md.template +7 -4
- package/templates/core/ai/onboarding/agent-invocation-guide.md.template +2 -2
- package/templates/core/ai/onboarding/docs-generation.md.template +1 -1
- package/templates/core/ai/onboarding/first-wu-mistakes.md.template +40 -0
- package/templates/core/ai/onboarding/initiative-orchestration.md.template +402 -0
- package/templates/core/ai/onboarding/quick-ref-commands.md.template +129 -56
- package/templates/core/ai/onboarding/release-process.md.template +102 -39
- package/templates/core/ai/onboarding/starting-prompt.md.template +1 -0
- package/templates/core/ai/onboarding/test-ratchet.md.template +2 -8
- package/templates/vendors/claude/.claude/CLAUDE.md.template +1 -1
- package/templates/vendors/claude/.claude/skills/bug-classification/SKILL.md.template +2 -2
- package/templates/vendors/claude/.claude/skills/code-quality/SKILL.md.template +3 -3
- package/templates/vendors/claude/.claude/skills/context-management/SKILL.md.template +1 -1
- package/templates/vendors/claude/.claude/skills/frontend-design/SKILL.md.template +1 -1
- package/templates/vendors/claude/.claude/skills/lumenflow-gates/SKILL.md.template +4 -4
- package/templates/vendors/claude/.claude/skills/tdd-workflow/SKILL.md.template +4 -4
- package/templates/vendors/claude/.claude/skills/worktree-discipline/SKILL.md.template +5 -5
- package/templates/vendors/claude/.claude/skills/wu-lifecycle/SKILL.md.template +4 -4
- package/templates/vendors/cline/.clinerules.template +1 -1
- package/templates/vendors/cursor/.cursor/rules/lumenflow.md.template +22 -2
- package/templates/vendors/windsurf/.windsurf/rules/lumenflow.md.template +22 -2
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
name: worktree-discipline
|
|
3
3
|
description: Prevents the "absolute path trap" in Write/Edit/Read tools. Use when working in worktrees, before file operations, or when changes don't appear in git status.
|
|
4
4
|
version: 2.0.0
|
|
5
|
-
source: docs/04-operations/_frameworks/lumenflow/lumenflow-
|
|
6
|
-
source_sections:
|
|
5
|
+
source: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
|
+
source_sections: Worktree Discipline, Tool Usage
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Bash, Grep
|
|
9
9
|
---
|
|
@@ -12,7 +12,7 @@ allowed-tools: Read, Bash, Grep
|
|
|
12
12
|
|
|
13
13
|
**Purpose**: Prevent AI agents from bypassing worktree isolation via absolute file paths.
|
|
14
14
|
|
|
15
|
-
**For full worktree workflow**: See `wu-lifecycle` skill or `lumenflow-
|
|
15
|
+
**For full worktree workflow**: See `wu-lifecycle` skill or `lumenflow-agent-capsule.md`.
|
|
16
16
|
|
|
17
17
|
## The Absolute Path Trap
|
|
18
18
|
|
|
@@ -134,9 +134,9 @@ About to use Write/Edit/Read?
|
|
|
134
134
|
## Cross-References
|
|
135
135
|
|
|
136
136
|
- **Full worktree workflow**: `wu-lifecycle` skill
|
|
137
|
-
- **Git command restrictions**: `lumenflow-
|
|
137
|
+
- **Git command restrictions**: `lumenflow-agent-capsule.md`
|
|
138
138
|
|
|
139
139
|
## Version History
|
|
140
140
|
|
|
141
141
|
- **v2.0.0** ({{DATE}}): Refactored to focus on absolute path trap (per Anthropic one-capability-per-skill guideline)
|
|
142
|
-
- **v1.0.0** ({{DATE}}): Initial skill from lumenflow-
|
|
142
|
+
- **v1.0.0** ({{DATE}}): Initial skill from lumenflow-agent-capsule.md
|
|
@@ -2,15 +2,15 @@
|
|
|
2
2
|
name: wu-lifecycle
|
|
3
3
|
description: Work Unit claim/block/done workflow automation. Use when claiming WUs, blocking/unblocking, running wu:prep + wu:done, or understanding WU state transitions.
|
|
4
4
|
version: 2.2.0
|
|
5
|
-
source: docs/04-operations/_frameworks/lumenflow/lumenflow-
|
|
6
|
-
source_sections:
|
|
5
|
+
source: docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md
|
|
6
|
+
source_sections: WU Lifecycle
|
|
7
7
|
last_updated: {{DATE}}
|
|
8
8
|
allowed-tools: Read, Bash, Grep
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# WU Lifecycle Skill
|
|
12
12
|
|
|
13
|
-
**Source**: `docs/04-operations/_frameworks/lumenflow/lumenflow-
|
|
13
|
+
**Source**: `docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md` (canonical)
|
|
14
14
|
|
|
15
15
|
## When to Use
|
|
16
16
|
|
|
@@ -116,4 +116,4 @@ pnpm wu:done --id WU-XXX --skip-gates --reason "Pre-existing" --fix-wu WU-YYY
|
|
|
116
116
|
|
|
117
117
|
---
|
|
118
118
|
|
|
119
|
-
**Full spec**: [
|
|
119
|
+
**Full spec**: [LumenFlow Agent Capsule](../../../docs/04-operations/_frameworks/lumenflow/lumenflow-agent-capsule.md)
|
|
@@ -31,7 +31,7 @@ cd {{PROJECT_ROOT}}
|
|
|
31
31
|
pnpm wu:done --id WU-XXX
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
> **Complete CLI reference (
|
|
34
|
+
> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](ai/onboarding/quick-ref-commands.md)
|
|
35
35
|
|
|
36
36
|
---
|
|
37
37
|
|
|
@@ -31,7 +31,7 @@ cd {{PROJECT_ROOT}}
|
|
|
31
31
|
pnpm wu:done --id WU-XXX
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
> **Complete CLI reference (
|
|
34
|
+
> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
|
|
35
35
|
|
|
36
36
|
## CLI Commands
|
|
37
37
|
|
|
@@ -43,7 +43,7 @@ pnpm wu:done --id WU-XXX
|
|
|
43
43
|
| `pnpm wu:claim --id WU-XXX --lane <Lane>` | Claim WU and create worktree |
|
|
44
44
|
| `pnpm wu:prep --id WU-XXX` | Run gates in worktree |
|
|
45
45
|
| `pnpm wu:done --id WU-XXX` | Complete WU (from main) |
|
|
46
|
-
| `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt
|
|
46
|
+
| `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt + record evidence |
|
|
47
47
|
| `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
|
|
48
48
|
| `pnpm wu:recover --id WU-XXX` | Fix WU state inconsistencies |
|
|
49
49
|
| `pnpm wu:escalate --id WU-XXX` | Show or resolve WU escalation status |
|
|
@@ -57,3 +57,23 @@ pnpm wu:done --id WU-XXX
|
|
|
57
57
|
| `pnpm lumenflow:commands` | List all public commands (primary + alias + legacy) |
|
|
58
58
|
| `pnpm mem:checkpoint --wu WU-XXX` | Save progress checkpoint |
|
|
59
59
|
| `pnpm mem:recover --wu WU-XXX` | Generate recovery context |
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Workflow Summary
|
|
64
|
+
|
|
65
|
+
| Step | Command |
|
|
66
|
+
| ------------ | ---------------------------------------------------------------- |
|
|
67
|
+
| 1. Create WU | `pnpm wu:create --lane <Lane> --title "..."` (ID auto-generated) |
|
|
68
|
+
| 2. Claim | `pnpm wu:claim --id WU-XXX --lane <Lane>` |
|
|
69
|
+
| 3. Work | `cd worktrees/<lane>-wu-xxx` |
|
|
70
|
+
| 4. Gates | `pnpm gates` |
|
|
71
|
+
| 5. Prep | `pnpm wu:prep --id WU-XXX` |
|
|
72
|
+
| 6. Complete | `pnpm wu:done --id WU-XXX` |
|
|
73
|
+
|
|
74
|
+
## Safety Reminders
|
|
75
|
+
|
|
76
|
+
- **Worktree Discipline**: After claiming a WU, immediately `cd` to the worktree
|
|
77
|
+
- **Main is read-only**: Do not edit files in the main checkout after claiming
|
|
78
|
+
- **Gates before done**: Always run `pnpm gates` before `wu:done`
|
|
79
|
+
- **Never skip hooks**: The `--no-verify` flag is forbidden
|
|
@@ -31,7 +31,7 @@ cd {{PROJECT_ROOT}}
|
|
|
31
31
|
pnpm wu:done --id WU-XXX
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
> **Complete CLI reference (
|
|
34
|
+
> **Complete CLI reference (100+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
|
|
35
35
|
|
|
36
36
|
## CLI Commands
|
|
37
37
|
|
|
@@ -43,7 +43,7 @@ pnpm wu:done --id WU-XXX
|
|
|
43
43
|
| `pnpm wu:claim --id WU-XXX --lane <Lane>` | Claim WU and create worktree |
|
|
44
44
|
| `pnpm wu:prep --id WU-XXX` | Run gates in worktree |
|
|
45
45
|
| `pnpm wu:done --id WU-XXX` | Complete WU (from main) |
|
|
46
|
-
| `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt
|
|
46
|
+
| `pnpm wu:brief --id WU-XXX --client <client>` | Generate handoff prompt + record evidence |
|
|
47
47
|
| `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
|
|
48
48
|
| `pnpm wu:recover --id WU-XXX` | Fix WU state inconsistencies |
|
|
49
49
|
| `pnpm wu:escalate --id WU-XXX` | Show or resolve WU escalation status |
|
|
@@ -57,3 +57,23 @@ pnpm wu:done --id WU-XXX
|
|
|
57
57
|
| `pnpm lumenflow:commands` | List all public commands (primary + alias + legacy) |
|
|
58
58
|
| `pnpm mem:checkpoint --wu WU-XXX` | Save progress checkpoint |
|
|
59
59
|
| `pnpm mem:recover --wu WU-XXX` | Generate recovery context |
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
## Workflow Summary
|
|
64
|
+
|
|
65
|
+
| Step | Command |
|
|
66
|
+
| ------------ | ---------------------------------------------------------------- |
|
|
67
|
+
| 1. Create WU | `pnpm wu:create --lane <Lane> --title "..."` (ID auto-generated) |
|
|
68
|
+
| 2. Claim | `pnpm wu:claim --id WU-XXX --lane <Lane>` |
|
|
69
|
+
| 3. Work | `cd worktrees/<lane>-wu-xxx` |
|
|
70
|
+
| 4. Gates | `pnpm gates` |
|
|
71
|
+
| 5. Prep | `pnpm wu:prep --id WU-XXX` |
|
|
72
|
+
| 6. Complete | `pnpm wu:done --id WU-XXX` |
|
|
73
|
+
|
|
74
|
+
## Safety Reminders
|
|
75
|
+
|
|
76
|
+
- **Worktree Discipline**: After claiming a WU, immediately `cd` to the worktree
|
|
77
|
+
- **Main is read-only**: Do not edit files in the main checkout after claiming
|
|
78
|
+
- **Gates before done**: Always run `pnpm gates` before `wu:done`
|
|
79
|
+
- **Never skip hooks**: The `--no-verify` flag is forbidden
|