@lumenflow/cli 3.22.0 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/cli",
-  "version": "3.22.0",
+  "version": "4.0.0",
   "description": "Command-line interface for LumenFlow workflow framework",
   "keywords": [
     "lumenflow",
@@ -9,16 +9,16 @@
     "wu",
     "work-unit"
   ],
-  "homepage": "https://github.com/hellmai/lumenflow-dev",
+  "homepage": "https://github.com/hellmai/lumenflow",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hellmai/lumenflow-dev.git",
+    "url": "https://github.com/hellmai/lumenflow.git",
     "directory": "packages/@lumenflow/cli"
   },
   "license": "AGPL-3.0-only",
   "author": {
-    "name": "HellmAI",
-    "url": "https://hellm.ai"
+    "name": "LumenFlow Contributors",
+    "url": "https://lumenflow.dev"
   },
   "type": "module",
   "main": "./dist/index.js",
@@ -186,13 +186,13 @@
     "xstate": "^5.28.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@lumenflow/agent": "3.22.0",
-    "@lumenflow/control-plane-sdk": "3.22.0",
-    "@lumenflow/core": "3.22.0",
-    "@lumenflow/initiatives": "3.22.0",
-    "@lumenflow/memory": "3.22.0",
-    "@lumenflow/metrics": "3.22.0",
-    "@lumenflow/kernel": "3.22.0"
+    "@lumenflow/agent": "4.0.0",
+    "@lumenflow/initiatives": "4.0.0",
+    "@lumenflow/kernel": "4.0.0",
+    "@lumenflow/memory": "4.0.0",
+    "@lumenflow/core": "4.0.0",
+    "@lumenflow/metrics": "4.0.0",
+    "@lumenflow/control-plane-sdk": "4.0.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",

package/packs/agent-runtime/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-agent-runtime@3.21.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/agent-runtime
+> @lumenflow/packs-agent-runtime@3.22.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/agent-runtime
 > tsc
 

package/packs/agent-runtime/.turbo/turbo-test.log

@@ -0,0 +1,21 @@
+
+> @lumenflow/packs-agent-runtime@3.22.0 test /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/agent-runtime
+> vitest run
+
+
+ RUN  v4.0.18 /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/agent-runtime
+
+ ✓ __tests__/capability-factory.test.ts (2 tests) 6ms
+ ✓ __tests__/workflow-dag.test.ts (2 tests) 154ms
+ ✓ __tests__/manifest.test.ts (3 tests) 96ms
+ ✓ __tests__/policy-factory.test.ts (3 tests) 41ms
+ ✓ __tests__/orchestration.test.ts (4 tests) 95ms
+ ✓ __tests__/workflow-state.test.ts (1 test) 228ms
+ ✓ __tests__/resume.test.ts (2 tests) 554ms
+     ✓ suspends a linear session after the invocation turn budget and resumes with preserved metadata  371ms
+
+ Test Files  7 passed (7)
+      Tests  17 passed (17)
+   Start at  12:26:52
+   Duration  7.15s (transform 15.25s, setup 0ms, import 28.14s, tests 1.17s, environment 1ms)
+

package/packs/agent-runtime/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-agent-runtime@3.20.0 typecheck /home/tom/source/hellmai/lumenflow-dev/worktrees/operations-tooling-wu-2491/packages/@lumenflow/packs/agent-runtime
+> @lumenflow/packs-agent-runtime@3.22.0 typecheck /home/tom/source/hellmai/lumenflow-dev/worktrees/operations-tooling-wu-2519/packages/@lumenflow/packs/agent-runtime
 > tsc --noEmit
 

package/packs/agent-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-agent-runtime",
-  "version": "3.22.0",
+  "version": "4.0.0",
   "description": "Agent runtime pack scaffold for LumenFlow — governed model-turn execution, pack config, and provider capability baselines",
   "keywords": [
     "lumenflow",
@@ -9,16 +9,16 @@
     "orchestration",
     "policy"
   ],
-  "homepage": "https://github.com/hellmai/lumenflow-dev",
+  "homepage": "https://github.com/hellmai/lumenflow",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hellmai/lumenflow-dev.git",
+    "url": "https://github.com/hellmai/lumenflow.git",
     "directory": "packages/@lumenflow/packs/agent-runtime"
   },
   "license": "AGPL-3.0-only",
   "author": {
-    "name": "HellmAI",
-    "url": "https://hellm.ai"
+    "name": "LumenFlow Contributors",
+    "url": "https://lumenflow.dev"
   },
   "type": "module",
   "exports": {

package/packs/sidekick/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-sidekick@3.21.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
+> @lumenflow/packs-sidekick@3.22.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
 > tsc
 

package/packs/sidekick/.turbo/turbo-test.log

@@ -1,12 +1,157 @@
 
-> @lumenflow/packs-sidekick@3.17.6 test /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
+> @lumenflow/packs-sidekick@3.22.0 test /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
 > vitest run
 
 
- RUN  v4.0.18 /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
+ RUN  v4.0.18 /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/sidekick
 
-include: packages/**/__tests__/**/*.test.ts, packages/**/*.spec.ts, apps/**/__tests__/**/*.test.ts, tools/**/__tests__/**/*.test.ts, scripts/__tests__/**/*.test.ts, .husky/hooks/__tests__/**/*.test.ts
-exclude:  **/node_modules/**, **/dist/**
-No test files found, exiting with code 0
+ ✓ __tests__/storage.test.ts (24 tests) 1552ms
+     ✓ concurrent writes under lock produce consistent state  460ms
+ ✓ __tests__/manifest.test.ts (19 tests) 345ms
+ ❯ __tests__/tools.test.ts (123 tests | 1 failed) 16678ms
+     ✓ keeps test storage outside the pack directory so pack validation hashes remain stable 11ms
+     ✓ returns contract-compliant output with success=true and data.task 153ms
+     ✓ persists the task to the store 146ms
+     ✓ appends an audit event on create 194ms
+     ✓ dry_run returns the task but does NOT persist 69ms
+     ✓ rejects missing title 8ms
+     ✓ accepts optional priority, due_at, tags, description 76ms
+     ✓ returns empty items when no tasks exist 56ms
+     ✓ returns all tasks by default 274ms
+     ✓ filters by status 182ms
+     ✓ filters canceled tasks by status 168ms
+     ✓ filters by priority 120ms
+     ✓ filters by tags 144ms
+     ✓ filters by substring search across title and description 32ms
+     ✓ filters by due_before 6ms
+     ✓ respects limit 12ms
+     ✓ marks a task as done and appends audit 29ms
+     ✓ dry_run does NOT persist completion 47ms
+     ✓ returns NOT_FOUND for unknown id 2ms
+     ✓ rejects missing id 1ms
+     ✓ marks a task as canceled and appends audit 6ms
+     ✓ dry_run previews cancellation without persistence 25ms
+     ✓ sets due_at on a task 33ms
+     ✓ sets cron on a task 23ms
+     ✓ appends audit event on schedule 27ms
+     ✓ dry_run does NOT persist schedule changes 110ms
+     ✓ returns NOT_FOUND for unknown id 47ms
+     ✓ updates title, description, priority, tags, due_at, and cron 133ms
+     ✓ dry_run previews changes without persistence 84ms
+     ✓ returns NOT_FOUND for unknown id 53ms
+     ✓ rejects missing id 21ms
+     ✓ returns contract-compliant output with success=true and data.memory 86ms
+     ✓ persists the memory entry 38ms
+     ✓ appends an audit event on store 57ms
+     ✓ dry_run returns entry but does NOT persist 45ms
+     ✓ rejects missing type 8ms
+     ✓ rejects missing content 2ms
+     ✓ accepts tags 96ms
+     ✓ accepts snippet as a persisted memory type 24ms
+     ✓ returns empty items when no memories exist 32ms
+     ✓ returns all memories by default 186ms
+     ✓ filters by substring query 79ms
+     ✓ filters by tag 142ms
+     ✓ filters by type 32ms
+     ✓ respects limit 101ms
+     ✓ removes a memory entry and appends audit 143ms
+     ✓ dry_run does NOT persist deletion 101ms
+     ✓ returns NOT_FOUND for unknown id 42ms
+     ✓ rejects missing id 21ms
+     ✓ updates content, type, and tags in place 159ms
+     ✓ dry_run previews changes without persistence  341ms
+     ✓ creates a channel and returns contract-compliant output 229ms
+     ✓ persists the channel to the store 202ms
+     ✓ updates an existing channel by name  323ms
+     ✓ appends an audit event on configure 197ms
+     ✓ dry_run returns channel but does NOT persist 57ms
+     ✓ rejects missing name 7ms
+     ✓ sends a message and returns contract-compliant output 202ms
+     ✓ persists the message to the outbox 94ms
+     ✓ auto-creates a default channel when none specified 233ms
+     ✓ uses specified channel name 67ms
+     × caps outbox at 100 messages 5113ms
+     ✓ appends an audit event on send 151ms
+     ✓ dry_run returns message but does NOT persist 45ms
+     ✓ rejects missing content 5ms
+     ✓ requires workspace context when provider is specified 41ms
+     ✓ returns deterministic error when provider is unregistered 14ms
+     ✓ routes provider send through registered transport and preserves metadata 63ms
+     ✓ preserves transport retryability fields on provider send failure 33ms
+     ✓ returns empty items when no messages exist 43ms
+     ✓ returns messages from outbox 164ms
+     ✓ filters by channel name 188ms
+     ✓ respects limit 225ms
+     ✓ requires workspace context when provider is specified 32ms
+     ✓ returns deterministic error when receive provider is unregistered 28ms
+     ✓ routes provider receive through registered transport and preserves payload 13ms
+     ✓ preserves transport retryability fields on provider receive failure 8ms
+     ✓ returns local channels with message counts and last_message_at metadata 258ms
+     ✓ removes a local channel and its local message history  900ms
+     ✓ dry_run previews channel deletion without persistence  488ms
+     ✓ creates a routine and returns contract-compliant output 172ms
+     ✓ persists the routine to the store 173ms
+     ✓ persists enabled and cron settings when provided 68ms
+     ✓ appends an audit event on create 165ms
+     ✓ dry_run returns routine but does NOT persist 123ms
+     ✓ rejects missing name 10ms
+     ✓ rejects missing or empty steps 2ms
+     ✓ coerces string step entries to { tool, input: {} } 174ms
+     ✓ handles mixed string and object steps 180ms
+     ✓ returns indexed validation errors for invalid entries 68ms
+     ✓ rejects when all entries are invalid (non-string, non-object) 3ms
+     ✓ returns empty items when no routines exist 54ms
+     ✓ returns all routines by default 128ms
+     ✓ respects limit 119ms
+     ✓ filters by enabled_only using persisted enabled state 118ms
+     ✓ updates name, steps, cron, and enabled state 84ms
+     ✓ dry_run previews the stop flow without persistence 33ms
+     ✓ removes a local routine definition and appends audit 50ms
+     ✓ dry_run previews routine deletion without persistence 15ms
+     ✓ returns plan-only output and does NOT execute tool steps 31ms
+     ✓ appends an audit event on run 49ms
+     ✓ returns NOT_FOUND for unknown id 55ms
+     ✓ rejects missing id 13ms
+     ✓ initializes sidekick directories and returns success 90ms
+     ✓ is idempotent (second call succeeds without error) 62ms
+     ✓ appends an audit event on init 77ms
+     ✓ returns status of all stores 21ms
+     ✓ reflects actual store counts 150ms
+     ✓ appends an audit event on status 29ms
+     ✓ returns all data as JSON bundle 147ms
+     ✓ includes audit events by default 57ms
+     ✓ excludes audit events when include_audit=false 70ms
+     ✓ appends an audit event on export 47ms
+     ✓ is READ-ONLY (no file write, only returns data) 9ms
+     ✓ covers the task create, update, and cancel lifecycle 189ms
+     ✓ covers the memory store, update, and forget lifecycle 149ms
+     ✓ covers the channel configure, list, and delete lifecycle 130ms
+     ✓ covers the routine create, update, disable, and delete lifecycle 105ms
+     ✓ task tools returns UNKNOWN_TOOL for unrecognized tool_name 0ms
+     ✓ memory tools returns UNKNOWN_TOOL for unrecognized tool_name 0ms
+     ✓ channel tools returns UNKNOWN_TOOL for unrecognized tool_name 0ms
+     ✓ routine tools returns UNKNOWN_TOOL for unrecognized tool_name 0ms
+     ✓ system tools returns UNKNOWN_TOOL for unrecognized tool_name 0ms
 
+⎯⎯⎯⎯⎯⎯⎯ Failed Tests 1 ⎯⎯⎯⎯⎯⎯⎯
 
+ FAIL  __tests__/tools.test.ts > channel:send > caps outbox at 100 messages
+Error: Test timed out in 5000ms.
+If this is a long-running test, pass a timeout value as the last argument or configure it globally with "testTimeout".
+ ❯ __tests__/tools.test.ts:937:3
+    935|   });
+    936| 
+    937|   it('caps outbox at 100 messages', async () => {
+       |   ^
+    938|     // Seed 100 messages
+    939|     for (let i = 0; i < 100; i++) {
+
+⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯[1/1]⎯
+
+
+ Test Files  1 failed | 2 passed (3)
+      Tests  1 failed | 165 passed (166)
+   Start at  12:47:33
+   Duration  18.62s (transform 5.52s, setup 0ms, import 7.30s, tests 18.57s, environment 0ms)
+
+ ELIFECYCLE  Test failed. See above for more details.

package/packs/sidekick/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-sidekick@3.20.0 typecheck /home/tom/source/hellmai/lumenflow-dev/worktrees/operations-tooling-wu-2491/packages/@lumenflow/packs/sidekick
+> @lumenflow/packs-sidekick@3.22.0 typecheck /home/tom/source/hellmai/lumenflow-dev/worktrees/operations-tooling-wu-2519/packages/@lumenflow/packs/sidekick
 > tsc --noEmit
 

package/packs/sidekick/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-sidekick",
-  "version": "3.22.0",
+  "version": "4.0.0",
   "description": "Sidekick personal assistant pack for LumenFlow — 16 tools for task management, typed memory, channels, routines, and audit",
   "keywords": [
     "lumenflow",
@@ -10,16 +10,16 @@
     "task-management",
     "memory"
   ],
-  "homepage": "https://github.com/hellmai/lumenflow-dev",
+  "homepage": "https://github.com/hellmai/lumenflow",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hellmai/lumenflow-dev.git",
+    "url": "https://github.com/hellmai/lumenflow.git",
     "directory": "packages/@lumenflow/packs/sidekick"
   },
   "license": "AGPL-3.0-only",
   "author": {
-    "name": "HellmAI",
-    "url": "https://hellm.ai"
+    "name": "LumenFlow Contributors",
+    "url": "https://lumenflow.dev"
   },
   "type": "module",
   "exports": {

package/packs/software-delivery/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-software-delivery@3.21.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
+> @lumenflow/packs-software-delivery@3.22.0 build /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
 > tsc
 

package/packs/software-delivery/.turbo/turbo-test.log

@@ -0,0 +1,32 @@
+
+> @lumenflow/packs-software-delivery@3.22.0 test /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
+> vitest run
+
+
+ RUN  v4.0.18 /home/tom/source/hellmai/lumenflow-dev/packages/@lumenflow/packs/software-delivery
+
+ ✓ __tests__/bridge-regression.test.ts (1 test) 99ms
+ ✓ __tests__/worktree-tools.test.ts (3 tests) 5ms
+ ✓ __tests__/extensions.test.ts (3 tests) 17ms
+ ✓ __tests__/git-runner.test.ts (3 tests) 311ms
+ ✓ __tests__/runtime-native-tools.test.ts (5 tests) 59ms
+ ✓ __tests__/agent-tools.test.ts (7 tests) 79ms
+ ✓ __tests__/flow-metrics-tools.test.ts (17 tests) 33ms
+ ✓ __tests__/runtime-cli-adapter.test.ts (5 tests) 143ms
+ ✓ __tests__/manifest.test.ts (8 tests) 23ms
+ ✓ __tests__/memory-tools.test.ts (18 tests) 76ms
+ ✓ __tests__/initiative-orchestration-tools.test.ts (5 tests) 115ms
+ ✓ __tests__/wu-lifecycle-tools.test.ts (23 tests) 269ms
+ ✓ __tests__/lane-lock.test.ts (6 tests) 298ms
+ ✓ __tests__/gate-policies.test.ts (4 tests) 430ms
+     ✓ resolves state alias and registers pack with integrity hash  386ms
+ ✓ __tests__/git-tools.test.ts (6 tests) 1841ms
+     ✓ runs git tools through tool host and includes artifacts_written for git:commit  549ms
+     ✓ rejects command arrays that try to execute non-git binaries  520ms
+     ✓ returns command output payloads for allowed git command arrays  652ms
+
+ Test Files  15 passed (15)
+      Tests  114 passed (114)
+   Start at  12:26:51
+   Duration  6.22s (transform 19.90s, setup 0ms, import 27.40s, tests 3.80s, environment 36ms)
+

package/packs/software-delivery/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @lumenflow/packs-software-delivery@3.20.0 typecheck /home/tom/source/hellmai/lumenflow-dev/worktrees/operations-tooling-wu-2491/packages/@lumenflow/packs/software-delivery
+> @lumenflow/packs-software-delivery@3.22.0 typecheck /home/tom/source/hellmai/lumenflow-dev/worktrees/operations-tooling-wu-2519/packages/@lumenflow/packs/software-delivery
 > tsc --noEmit
 

package/packs/software-delivery/LICENSE.md

@@ -0,0 +1,18 @@
+Copyright (C) 2026 HellmAI
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, version 3 of the License.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+SPDX-License-Identifier: AGPL-3.0-only
+
+For the full license text, see the LICENSE file in the root of the
+LumenFlow repository: https://github.com/hellmai/lumenflow

package/packs/software-delivery/README.md

@@ -0,0 +1,15 @@
+# @lumenflow/packs-software-delivery
+
+Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination.
+
+## What It Provides
+
+- Work unit lifecycle management (create, claim, prep, done)
+- Quality gates (format, lint, typecheck, test)
+- Lane-based WIP limits and parallel execution
+- Initiative orchestration across multiple work units
+- Agent coordination and handoff protocols
+
+## License
+
+AGPL-3.0-only. See [LICENSE.md](./LICENSE.md).

package/packs/software-delivery/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/packs-software-delivery",
-  "version": "3.22.0",
+  "version": "4.0.0",
   "description": "Software delivery pack for LumenFlow — work units, gates, lanes, initiatives, and agent coordination",
   "keywords": [
     "lumenflow",
@@ -10,16 +10,16 @@
     "gates",
     "lanes"
   ],
-  "homepage": "https://github.com/hellmai/lumenflow-dev",
+  "homepage": "https://github.com/hellmai/lumenflow",
   "repository": {
     "type": "git",
-    "url": "https://github.com/hellmai/lumenflow-dev.git",
+    "url": "https://github.com/hellmai/lumenflow.git",
     "directory": "packages/@lumenflow/packs/software-delivery"
   },
   "license": "AGPL-3.0-only",
   "author": {
-    "name": "HellmAI",
-    "url": "https://hellm.ai"
+    "name": "LumenFlow Contributors",
+    "url": "https://lumenflow.dev"
   },
   "type": "module",
   "exports": {

package/templates/core/AGENTS.md.template

@@ -94,30 +94,7 @@ pnpm wu:cleanup --id WU-XXXX
 
 ## CLI Commands and Lifecycle Reference
 
-For complete CLI command documentation (100+ commands), see [quick-ref-commands.md]({{QUICK_REF_LINK}}).
-
-**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`           | **MANDATORY after wu:claim.** Generate handoff prompt + record evidence |
-| `pnpm wu:delegate`        | Generate prompt + record lineage + brief hash attestation               |
-| `pnpm wu:recover`         | Analyze and fix WU state inconsistencies                                |
-| `pnpm wu:escalate`        | Show or resolve WU escalation status                                    |
-| `pnpm wu:verify`          | Verify WU completion (stamp, commit, clean tree)                        |
-| `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 lane:status`        | Show lane lifecycle status and next step                                |
-| `pnpm lane:setup`         | Create/update draft lane artifacts                                      |
-| `pnpm lane:lock`          | Lock lane lifecycle for delivery WUs                                    |
-| `pnpm mem:checkpoint`     | Save progress checkpoint                                                |
-| `pnpm mem:recover`        | Generate recovery context                                               |
+For the **complete CLI command reference** (130+ commands across all categories), see the [CLI Command Reference in LUMENFLOW.md](LUMENFLOW.md#cli-command-reference).
 
 **Two-step completion (wu:prep then wu:done):**