@lumenflow/cli 5.0.3 → 5.2.0

package/packs/software-delivery/src/domain/orchestration.constants.ts

@@ -47,8 +47,12 @@ export type Lane = (typeof LANES)[number];
  * Known agent names in the orchestration system.
  * Includes both mandatory (Tier 1) and suggested (Tier 2) agents.
  *
- * Note: These are LumenFlow framework agents defined in .claude/agents/.
- * Application-specific agents should be configured separately.
+ * Note: These are the framework's vendor-neutral default aliases. Vendor
+ * overlays may materialize them in different native surfaces, and
+ * application-specific agents should still be configured separately.
+ *
+ * v2 roster refresh: the default set removes `lumenflow-doc-sync` and adds
+ * `initiative-architect`.
  */
 export const AGENT_NAMES = [
   'general-purpose',
@@ -57,12 +61,9 @@ export const AGENT_NAMES = [
   'code-reviewer',
   'bug-triage',
   'lumenflow-enforcer',
-  'lumenflow-doc-sync',
+  'initiative-architect',
 ] as const;
 
-/** Type for agent names */
-export type AgentName = (typeof AGENT_NAMES)[number];
-
 /**
  * Alert severity levels for dashboard display.
  * HIGH = action required immediately
@@ -127,9 +128,6 @@ export type UserChoiceOption = (typeof USER_CHOICE_OPTIONS)[number];
  */
 export const MANDATORY_AGENT_NAMES = [] as const;
 
-/** Type for mandatory agent names */
-export type MandatoryAgentName = (typeof MANDATORY_AGENT_NAMES)[number];
-
 /**
  * Mandatory agent triggers - glob patterns that indicate when agents must be invoked.
  * Uses minimatch patterns (NOT regex) for file path matching.

package/packs/software-delivery/src/domain/orchestration.schemas.ts

@@ -15,7 +15,6 @@
 import { z } from 'zod';
 import {
   LANES,
-  AGENT_NAMES,
   SEVERITY_LEVELS,
   AGENT_RESULT_STATUSES,
   TIMELINE_EVENT_TYPES,
@@ -38,7 +37,7 @@ const LongestRunningSchema = z.object({
  */
 const PendingMandatorySchema = z.object({
   wuId: z.string().min(1),
-  agent: z.enum(AGENT_NAMES),
+  agent: z.string().min(1),
 });
 
 /**

package/packs/software-delivery/src/domain/orchestration.types.ts

@@ -28,13 +28,11 @@ import type {
 // Re-export constant-derived types for convenience
 export type {
   Lane,
-  AgentName,
   SeverityLevel,
   AgentResultStatus,
   TimelineEventType,
   EventSeverityLevel,
   UserChoiceOption,
-  MandatoryAgentName,
 } from './orchestration.constants.js';
 
 // Re-export const values as well

package/packs/software-delivery/src/state/wu-paths.ts

@@ -67,7 +67,7 @@ const FALLBACK_DIRECTORIES: WorkspaceDirectories = {
   initiativesDir: 'docs/operations/tasks/initiatives',
   backlogPath: 'docs/operations/tasks/backlog.md',
   statusPath: 'docs/operations/tasks/status.md',
-  skillsDir: '.claude/skills',
+  skillsDir: '.lumenflow/skills',
   agentsDir: '.claude/agents',
   adrDir: 'docs/adr',
   plansDir: 'docs/operations/plans',

package/packs/software-delivery/tool-impl/wu-lifecycle-tools.ts

@@ -698,6 +698,36 @@ export async function wuRepairTool(input: unknown): Promise<ToolOutput> {
   return executeLifecycleTool(LIFECYCLE_TOOLS.WU_REPAIR, args);
 }
 
+/**
+ * WU-2833 (INIT-062 WU-G): privileged wu:repair variant registered as a
+ * distinct pack tool (wu:repair:admin) so cloud-team phone UX can expose
+ * admin recovery behind a remote_mutation approval gate without widening
+ * the default wu:repair surface. Forces `--admin` on every invocation.
+ */
+export async function wuRepairAdminTool(input: unknown): Promise<ToolOutput> {
+  const parsed = toRecord(input);
+
+  const args: string[] = ['--admin'];
+  const id = toStringValue(parsed.id);
+  if (id) {
+    args.push('--id', id);
+  }
+  if (parsed.check === true) {
+    args.push('--check');
+  }
+  if (parsed.all === true) {
+    args.push('--all');
+  }
+  if (parsed.claim === true) {
+    args.push('--claim');
+  }
+  if (parsed.repair_state === true) {
+    args.push('--repair-state');
+  }
+
+  return executeLifecycleTool(LIFECYCLE_TOOLS.WU_REPAIR, args);
+}
+
 export async function wuStatusTool(input: unknown): Promise<ToolOutput> {
   const parsed = toRecord(input);
   const id = toStringValue(parsed.id);

package/templates/core/AGENTS.md.template

@@ -204,14 +204,18 @@ LumenFlow enforces safety at the repository level via git wrappers and hooks. Fo
 
 This file provides universal guidance for all AI agents. LumenFlow skills live in `.lumenflow/skills/` as `SKILL.md` files and are projected to each vendor via `pnpm lumenflow:integrate --client <x>`.
 
-| Vendor       | Skill / rules surface                   | Invocation                                               |
-| ------------ | --------------------------------------- | -------------------------------------------------------- |
-| Claude Code  | `.claude/skills/` + `.claude/CLAUDE.md` | `Skill` tool call, or `/skill <name>` in interactive CLI |
-| OpenAI Codex | `.codex/skills/` or repo `skills/`      | `/skills`, `$<name>` mention, or implicit                |
-| Cursor       | `.cursor/rules/` + agent skills         | `/skills` or auto-discovery                              |
-| Windsurf     | `.windsurf/rules/` + Cascade skills     | Auto-discovery; workflows via `/<workflow-name>`         |
-| Aider        | `CONVENTIONS.md`                        | `/read CONVENTIONS.md` or `aider --read CONVENTIONS.md`  |
-| Cline        | `.clinerules`                           | Auto-loaded                                              |
+| Vendor       | Skill / rules surface                               | Invocation                                                             |
+| ------------ | --------------------------------------------------- | ---------------------------------------------------------------------- |
+| Claude Code  | `.claude/skills/` + `.claude/CLAUDE.md`             | `Skill` tool call, or `/skill <name>` in interactive CLI               |
+| OpenAI Codex | `AGENTS.md` + `.agents/skills/` + `.codex/agents/` | `/skills`, `$<name>` mention, implicit skills, explicit subagent usage |
+| Cursor       | `.cursor/rules/` + `.agents/skills/`                | `/skills` or auto-discovery                                            |
+| Windsurf     | `.windsurf/rules/` + `.agents/skills/`              | Auto-discovery; workflows via `/<workflow-name>`                       |
+| Aider        | `CONVENTIONS.md`                                    | `/read CONVENTIONS.md` or `aider --read CONVENTIONS.md`                |
+| Cline        | `.clinerules`                                       | Auto-loaded                                                            |
+
+Shared cross-vendor surfaces: `AGENTS.md` and `.agents/skills/`.
+Vendor-specific overlays: `.claude/agents/`, `.codex/agents/`, `.cursor/rules/`, and `.windsurf/rules/`.
+For Codex specifically, `.codex/agents/*.toml` are explicit-only subagent overlays; Codex will not auto-match them by description.
 
 A skill named in prose does nothing — load it through the vendor's invocation before the work it covers. See [LUMENFLOW.md "Skills & Agents"](LUMENFLOW.md#skills--agents) for the canonical skill list.
 

package/templates/core/LUMENFLOW.md.template

@@ -761,15 +761,20 @@ For vendor-specific setup details and per-vendor quirks, see:
 
 ### Agents
 
-Pre-configured agent definitions in `.claude/agents/`:
+Recommended framework roster (vendor-neutral aliases):
 
-| Agent             | Purpose                    |
-| ----------------- | -------------------------- |
-| `general-purpose` | Standard WU implementation |
-| `lumenflow-pm`    | Backlog & lifecycle        |
-| `test-engineer`   | TDD, coverage              |
-| `code-reviewer`   | Quality checks             |
-| `bug-triage`      | Bug classification         |
+| Agent                  | Purpose                               |
+| ---------------------- | ------------------------------------- |
+| `general-purpose`      | Standard WU implementation            |
+| `lumenflow-pm`         | Backlog & lifecycle                   |
+| `test-engineer`        | TDD, coverage                         |
+| `code-reviewer`        | Quality checks                        |
+| `bug-triage`           | Bug classification                    |
+| `lumenflow-enforcer`   | Workflow compliance and gates         |
+| `initiative-architect` | Initiative planning and decomposition |
+
+Client-specific overlays may implement these aliases in different native surfaces such as
+`.claude/agents/`, `.codex/agents/`, or vendor rule/config directories.
 
 Generate handoff prompts (prompt-only, execution is a separate step): `pnpm wu:brief --id WU-XXX --client <client>`
 Record explicit delegation lineage when needed: `pnpm wu:delegate --id WU-XXX --parent-wu WU-YYY --client <client>`
@@ -797,5 +802,5 @@ Durable artifacts carry `requested_role` (from the orchestrator) and `actual_rol
 - [.lumenflow/constraints.md](.lumenflow/constraints.md) -- Non-negotiable rules and forbidden commands
 - [WU Sizing Guide]({{DOCS_OPERATIONS_PATH}}/_frameworks/lumenflow/wu-sizing-guide.md) -- Scoping work without needless fragmentation
 - [ADR-014: Typed Agent-Role Contract](docs/09-architecture-decisions/ADR-014-typed-agent-role-contract.md) — Canonical orchestration role vocabulary
-- [Skills Index](.claude/skills/INDEX.md)
+- [Skills Index](.lumenflow/skills/INDEX.md)
 - [Agents README](.claude/agents/README.md)

package/templates/core/ai/onboarding/agent-invocation-guide.md.template

@@ -146,6 +146,10 @@ These surfaces already assemble the objective, scope, code paths, tests, recover
 constraints block, and evidence metadata. Do not prepend or append a second wrapper block around
 them.
 
+The role aliases referenced by these handoffs are vendor-neutral framework names (`general-purpose`,
+`lumenflow-pm`, `initiative-architect`, and so on). Client-specific overlays may implement those
+aliases differently, but the orchestration brief should keep the shared alias vocabulary intact.
+
 If you are building a fully custom or experimental prompt outside those canonical surfaces, use
 this structure:
 
@@ -214,6 +218,7 @@ Before spawning:
 
 - Confirm WU status and lane availability
 - Ensure worktree exists (or claim first)
+- Use the shared framework alias vocabulary in the brief, not vendor-specific display names
 - Provide explicit code_paths and tests
 - Require `mem:checkpoint` at 50+ tool calls
 - Require `mem:signal` for milestones