npm - @lumenflow/cli - Versions diffs - 3.6.4 → 3.6.5 - Mend

@lumenflow/cli 3.6.4 → 3.6.5

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.

Files changed (7) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "3.6.4",
+  "version": "3.6.5",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -177,13 +177,13 @@
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/agent": "3.6.4",
-    "@lumenflow/initiatives": "3.6.4",
-    "@lumenflow/memory": "3.6.4",
-    "@lumenflow/core": "3.6.4",
-    "@lumenflow/kernel": "3.6.4",
-    "@lumenflow/metrics": "3.6.4",
-    "@lumenflow/control-plane-sdk": "3.6.4"
+    "@lumenflow/agent": "3.6.5",
+    "@lumenflow/memory": "3.6.5",
+    "@lumenflow/initiatives": "3.6.5",
+    "@lumenflow/kernel": "3.6.5",
+    "@lumenflow/metrics": "3.6.5",
+    "@lumenflow/control-plane-sdk": "3.6.5",
+    "@lumenflow/core": "3.6.5"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

package/templates/core/AGENTS.md.template CHANGED Viewed

@@ -33,6 +33,27 @@ This is the single most forgotten step. See [LUMENFLOW.md](LUMENFLOW.md) for det
 ---
+## Essential Commands
+| Command                   | Description                                           |
+| ------------------------- | ----------------------------------------------------- |
+| `pnpm wu:create`          | Create new WU spec (ID auto-generated)                |
+| `pnpm wu:claim`           | Claim WU and create worktree (or `--cloud`)           |
+| `pnpm wu:prep`            | Run gates in worktree, prep for wu:done               |
+| `pnpm wu:done`            | Complete WU (merge or PR, stamp, cleanup)             |
+| `pnpm wu:status`          | Show WU status, location, valid commands              |
+| `pnpm wu:brief`           | Generate handoff prompt + record evidence             |
+| `pnpm wu:delegate`        | Generate prompt + record delegation lineage           |
+| `pnpm wu:recover`         | Analyze and fix WU state inconsistencies              |
+| `pnpm wu:escalate`        | Show or resolve WU escalation status                  |
+| `pnpm wu:delete`          | Delete WU spec and cleanup                            |
+| `pnpm gates`              | Run all quality gates (`--docs-only` for docs)        |
+| `pnpm lumenflow:commands` | List all public commands (primary + aliases + legacy) |
+| `pnpm mem:checkpoint`     | Save progress checkpoint                              |
+| `pnpm mem:recover`        | Generate recovery context                             |
+---
 ## Core Principles
 1. **TDD**: Write tests first, then implementation

package/templates/core/LUMENFLOW.md.template CHANGED Viewed

@@ -238,6 +238,10 @@ For the full worktree lifecycle (parallel execution, bootstrap, isolation guaran
 | `pnpm wu:block`           | Block WU (transitions to blocked, frees lane)          |
 | `pnpm wu:unblock`         | Unblock WU (transitions to in_progress)                |
 | `pnpm wu:release`         | Release orphaned WU (in_progress to ready for reclaim) |
+| `pnpm wu:brief`           | Generate handoff prompt + record evidence              |
+| `pnpm wu:delegate`        | Generate prompt + record delegation lineage            |
+| `pnpm wu:escalate`        | Show or resolve WU escalation status                   |
+| `pnpm wu:delete`          | Delete WU spec and cleanup                             |
 | `pnpm gates`              | Run quality gates (`--docs-only` for docs WUs)         |
 | `pnpm lumenflow:commands` | List all public commands (primary + alias + legacy)    |
 | `pnpm docs:generate`      | Regenerate CLI/config reference docs from source       |

package/templates/core/ai/onboarding/quick-ref-commands.md.template CHANGED Viewed

@@ -4,14 +4,19 @@
 Reference for CLI commands. Organized by category for quick discovery.
-> **Rule (WU-1358, WU-1530):** Always run `<command> --help` before first use of any unfamiliar command.
-> This document may not include all available options or may contain outdated examples.
+> **Rule (WU-1358, WU-1530, WU-2228):** This document is a quick reference, not the complete list.
+> LumenFlow has 100+ commands. To see ALL available commands:
+>
+> ```bash
+> pnpm lumenflow:commands    # List ALL CLI commands — the authoritative source
+> ```
+>
+> Before using any unfamiliar command, run `--help` first:
 >
 > ```bash
-> # Examples
 > pnpm wu:edit --help      # See all wu:edit options
-> npm run wu:claim -- --help
-> yarn wu:create --help
+> pnpm wu:delete --help    # See wu:delete options
+> pnpm wu:escalate --help  # See wu:escalate options
 > ```
 ## Help-First Usage Examples By Category
@@ -94,6 +99,8 @@ pnpm exec lumenflow --client all      # All clients
 | `pnpm wu:brief --id WU-XXX --evidence-only`     | Record wu:brief evidence only (self-implementation path)     |
 | `pnpm wu:brief --id WU-XXX --no-context`        | Generate prompt without memory context injection             |
 | `pnpm wu:delegate --id WU-XXX --parent-wu <P>`  | Generate prompt and record delegation lineage                |
+| `pnpm wu:escalate --id WU-XXX`                  | Show escalation status for a WU                              |
+| `pnpm wu:escalate --resolve --id WU-XXX`        | Resolve escalation (sets resolved_by/resolved_at)            |
 ### WU Maintenance

package/templates/core/ai/onboarding/starting-prompt.md.template CHANGED Viewed

@@ -6,7 +6,19 @@ This is the complete onboarding document for AI agents working with LumenFlow. R
 ---
-## Mandatory: Help-First CLI Usage
+## Mandatory: Command Discovery and Help-First CLI Usage
+### Discover Available Commands
+Before concluding a command doesn't exist, **always check what's available**:
+```bash
+pnpm lumenflow:commands    # List ALL available CLI commands (100+)
+```
+LumenFlow has commands for WU lifecycle, maintenance, memory, initiatives, orchestration, metrics, packs, and more. Never guess or assume — run `pnpm lumenflow:commands` first.
+### Help-First Rule
 Before using any LumenFlow CLI command for the first time in a session, run `--help` first.
@@ -18,9 +30,10 @@ pnpm initiative:status --help
 Rules:
-1. Run `<command> --help` before first use of that command.
-2. Copy exact flags from help output; do not guess option names.
-3. If you hit an argument/flag error, rerun `--help` before retrying.
+1. Run `pnpm lumenflow:commands` to discover what commands exist.
+2. Run `<command> --help` before first use of that command.
+3. Copy exact flags from help output; do not guess option names.
+4. If you hit an argument/flag error, rerun `--help` before retrying.
 Optional Claude Code enforcement layer (recommended for teams):
@@ -473,6 +486,9 @@ pnpm wu:delegate --id WU-XXXX --parent-wu WU-YYYY --client <client-type>
 | `pnpm gates --docs-only`                       | Run docs-only gates                      | For documentation WUs       |
 | `pnpm wu:done --id WU-XXX`                     | Complete WU (merge or PR, cleanup)       | After gates pass            |
 | `pnpm wu:cleanup --id WU-XXX`                  | Post-merge cleanup (branch-pr)           | After PR merge (cloud only) |
+| `pnpm wu:escalate --id WU-XXX`                 | Show or resolve escalation status        | Escalation-triggered WUs    |
+| `pnpm wu:escalate --resolve --id WU-XXX`       | Resolve human escalation                 | Before wu:done (escalation) |
+| `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup               | Cancel stale/throwaway WUs  |
 | `pnpm wu:recover --id WU-XXX`                  | Fix inconsistent WU state                | When state is broken        |
 ---

package/templates/vendors/cursor/.cursor/rules/lumenflow.md.template CHANGED Viewed

@@ -32,3 +32,28 @@ pnpm wu:done --id WU-XXX
 ```
 > **Complete CLI reference (60+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
+## CLI Commands
+### WU Lifecycle
+| Command                                        | Description                                 |
+| ---------------------------------------------- | ------------------------------------------- |
+| `pnpm wu:status --id WU-XXX`                   | Show WU status, location, valid commands    |
+| `pnpm wu:claim --id WU-XXX --lane <Lane>`      | Claim WU and create worktree                |
+| `pnpm wu:prep --id WU-XXX`                     | Run gates in worktree                       |
+| `pnpm wu:done --id WU-XXX`                     | Complete WU (from main)                     |
+| `pnpm wu:brief --id WU-XXX --client <client>`  | Generate handoff prompt (no execution)      |
+| `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
+| `pnpm wu:recover --id WU-XXX`                  | Fix WU state inconsistencies                |
+| `pnpm wu:escalate --id WU-XXX`                 | Show or resolve WU escalation status        |
+| `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                  |
+### Gates & Orchestration
+| Command                                    | Description                                        |
+| ------------------------------------------ | -------------------------------------------------- |
+| `pnpm gates`                               | Run all quality gates                              |
+| `pnpm lumenflow:commands`                  | List all public commands (primary + alias + legacy) |
+| `pnpm mem:checkpoint --wu WU-XXX`          | Save progress checkpoint                           |
+| `pnpm mem:recover --wu WU-XXX`             | Generate recovery context                          |

package/templates/vendors/windsurf/.windsurf/rules/lumenflow.md.template CHANGED Viewed

@@ -32,3 +32,28 @@ pnpm wu:done --id WU-XXX
 ```
 > **Complete CLI reference (60+ commands):** See [quick-ref-commands.md](../../ai/onboarding/quick-ref-commands.md)
+## CLI Commands
+### WU Lifecycle
+| Command                                        | Description                                 |
+| ---------------------------------------------- | ------------------------------------------- |
+| `pnpm wu:status --id WU-XXX`                   | Show WU status, location, valid commands    |
+| `pnpm wu:claim --id WU-XXX --lane <Lane>`      | Claim WU and create worktree                |
+| `pnpm wu:prep --id WU-XXX`                     | Run gates in worktree                       |
+| `pnpm wu:done --id WU-XXX`                     | Complete WU (from main)                     |
+| `pnpm wu:brief --id WU-XXX --client <client>`  | Generate handoff prompt (no execution)      |
+| `pnpm wu:delegate --id WU-XXX --parent-wu <P>` | Generate prompt + record delegation lineage |
+| `pnpm wu:recover --id WU-XXX`                  | Fix WU state inconsistencies                |
+| `pnpm wu:escalate --id WU-XXX`                 | Show or resolve WU escalation status        |
+| `pnpm wu:delete --id WU-XXX`                   | Delete WU spec and cleanup                  |
+### Gates & Orchestration
+| Command                                    | Description                                        |
+| ------------------------------------------ | -------------------------------------------------- |
+| `pnpm gates`                               | Run all quality gates                              |
+| `pnpm lumenflow:commands`                  | List all public commands (primary + alias + legacy) |
+| `pnpm mem:checkpoint --wu WU-XXX`          | Save progress checkpoint                           |
+| `pnpm mem:recover --wu WU-XXX`             | Generate recovery context                          |