MCP Server Reference

LumenFlow serves the stable MCP 2026-07-28 revision over strict stdio and authenticated stateless Streamable HTTP. Owned clients pin that revision and reject downgrade; explicit SDK legacy compatibility is non-certifying.

Modern requests use server/discover, per-request _meta, and the current HTTP headers. There is no initialize or Mcp-Session-Id. LumenFlow task_* names are ordinary tools; the io.modelcontextprotocol/tasks extension is not advertised.

MCP discovery is capability- and authority-aware. A client sees a tool or resource only when the same transport and authorization mode can invoke or read it.

Legacy selector fields, where retained for compatibility, are non-authoritative and never define protocol capability or execution authority.

Tip

The inventory below is generated from the effective static + installed-pack catalog. Rows marked runtime_migration_pending are typed exclusions and are not advertised as callable tools.

Registry Summary

The effective catalog currently contains 123 declared handlers. Counts are descriptive only; parity is evaluated from the semantic rows below.

Category	Count	Description
Core WU Operations	7	Context and primary WU lifecycle operations.
Extended WU Lifecycle	21	WU maintenance, recovery, prep, and cleanup flows.
Initiatives	8	Initiative planning, assignment, and status operations.
Memory	15	Session memory, checkpoints, recovery, and coordination flows.
Agent	5	Agent session lifecycle and issue capture operations.
Orchestration & Delegation	4	Initiative orchestration, monitoring, and delegation helpers.
Flow & Metrics	5	Flow analysis and metrics tooling.
Validation	5	Validation and health-check operations.
Setup & Bootstrap	15	Initialization, onboarding, and environment setup flows.
Parity & Utilities	31	File, git, plan, state, config, and parity helpers.
Runtime Task Tools	7	Kernel runtime task lifecycle tools.

Effective Semantic Catalog

Tool	Source	Tier	Permission	Selector	stdio	HTTP	Typed exclusion
agent_issues_query	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
agent_log_issue	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
agent_resolve	static	pure_read	task:read	No	Callable	Callable when scoped	—
agent_session	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
agent_session_end	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
backlog_prune	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
cert_verify	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
cloud_connect	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
config_get	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
config_set	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
config_unset	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
context_get	static	pure_read	discovery:read	No	Callable	Callable when scoped	—
delegation_list	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
docs_sync	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
eval_run	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
eval_suite	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
file_delete	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
file_edit	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
file_read	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
file_write	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
flow_bottlenecks	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
flow_report	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
gates	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
gates_docs	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
gates_run	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
git_branch	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
git_diff	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
git_log	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
git_status	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
git_sync_main	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
init_plan	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_add_wu	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_bulk_assign	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_create	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_edit	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_list	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_plan	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_remove_wu	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
initiative_status	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lane_health	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lane_suggest	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_commands	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_docs_sync	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_doctor	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_gates	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_init	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_integrate	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_metrics	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_onboard	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_release	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_sync_templates	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_upgrade	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
lumenflow_validate	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_checkpoint	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_cleanup	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_context	pack:software-delivery	pure_read	task:read	No	Hidden	Hidden	runtime_migration_pending
mem_converged	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_create	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_delete	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_export	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_inbox	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_init	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_ready	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_recover	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_signal	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_start	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_summarize	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
mem_triage	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
metrics	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
metrics_snapshot	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
onboard	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
orchestrate_init_status	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
orchestrate_initiative	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
orchestrate_monitor	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
plan_create	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
plan_edit	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
plan_link	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
plan_promote	pack:software-delivery	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
signal_cleanup	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
state_bootstrap	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
state_cleanup	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
state_doctor	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
sync_templates	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
task_block	static	governed_mutation	task:write	No	Hidden	Hidden	runtime_migration_pending
task_claim	static	governed_mutation	task:write	No	Hidden	Callable when scoped	—
task_complete	static	governed_mutation	task:write	No	Hidden	Callable when scoped	—
task_create	static	governed_mutation	task:write	No	Hidden	Callable when scoped	—
task_inspect	static	pure_read	task:read	No	Hidden	Callable when scoped	—
task_unblock	static	governed_mutation	task:write	No	Hidden	Hidden	runtime_migration_pending
tool_execute	static	governed_mutation	tool:invoke	No	Hidden	Callable when scoped	—
validate	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
validate_agent_skills	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
validate_agent_sync	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
validate_backlog_sync	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
validate_skills_spec	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
workspace_init	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_amend	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_block	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_brief	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_claim	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_cleanup	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_create	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_delegate	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_delete	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_deps	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_done	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_edit	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_infer_lane	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_list	static	pure_read	task:read	No	Callable	Callable when scoped	—
wu_preflight	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_prep	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_proto	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_prune	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_rebase	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_recover	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_release	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_repair	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_sandbox	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_status	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_unblock	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_unlock_lane	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending
wu_validate	static	governed_mutation	tool:invoke	Yes	Hidden	Hidden	runtime_migration_pending

Resource Authority

Resource	Kind	Permission	stdio	HTTP	Typed exclusion
lumenflow://methodology/contract	local_in_process	discovery:read	Readable	Readable when scoped	—
lumenflow://methodology/skills	local_in_process	discovery:read	Readable	Readable when scoped	—
lumenflow://lifecycle-enforcement	local_in_process	discovery:read	Readable	Readable when scoped	—
lumenflow://context	pending_runtime_migration	discovery:read	Hidden	Hidden	runtime_migration_pending
lumenflow://backlog	pending_runtime_migration	task:read	Hidden	Hidden	runtime_migration_pending
lumenflow://methodology/skills/{name}{?digest}	local_in_process	discovery:read	Readable	Readable when scoped	—
lumenflow://wu/{id}	authenticated_runtime	task:read	Hidden	Readable when scoped	—

Canonical methodology resources are read from the project filesystem with path confinement and SHA-256 source evidence. Caller memory and synthetic briefs are advisory and cannot elevate execution authority.

lumenflow://lifecycle-enforcement reports the protected-artifact digests, contract version, compliance state, typed unavailability reason, and remediation without granting mutation authority.

Local enforcement cannot defend against a hostile unsandboxed process with the same OS-user authority. That boundary requires an OS sandbox or protected remote/server authority.

Tool Reference

Core WU Operations

Context and primary WU lifecycle operations.

context_get

Get current LumenFlow context including location, git state, and active WU

Authority: stdio callable; HTTP callable with discovery:read

Input: None

gates_run

Run LumenFlow quality gates (lint, typecheck, tests)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
docs_only	boolean	No	Run docs-only gates (skip lint/typecheck/tests)
full_lint	boolean	No	Run full lint instead of incremental
full_tests	boolean	No	Run full test suite instead of incremental
full_coverage	boolean	No	Force full test suite and coverage gate (implies full_tests)
coverage_mode	string	No	Coverage gate mode: “warn” or “block”
verbose	boolean	No	Stream output in agent mode instead of logging to file

wu_claim

Claim a Work Unit and create worktree for implementation

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to claim (e.g., WU-1234)
lane	string	Yes	Lane for the WU
cloud	boolean	No	Use cloud/branch-pr mode (no worktree, PR-based completion for cloud agents)
branch_only	boolean	No	Use branch-only mode without a claimed lane worktree; completion publishes from an isolated temporary worktree
pr_mode	boolean	No	Use PR mode (create PR instead of auto-merge)
sandbox	boolean	No	Launch post-claim session through wu:sandbox (requires sandbox_command in MCP)
sandbox_command	string[]	No	Command argv to run with —sandbox (e.g., [“node”, “-v”])

wu_create

Create a new Work Unit specification

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No	WU ID (e.g., WU-1234). Auto-generated if omitted.
lane	string	Yes	Lane name (e.g., “Framework: Core”)
title	string	Yes	Work Unit title
description	string	No	WU description (Context: … Problem: … Solution: …)
acceptance	string[]	No	Acceptance criteria (array of strings)
code_paths	string[]	No	Code paths affected by this WU
test_paths_unit	string[]	No	Unit test file paths
test_paths_e2e	string[]	No	E2E test file paths
test_paths_manual	string[]	No	Manual test descriptions
exposure	”ui” | “api” | “backend-only” | “documentation”	No	Exposure level (ui, api, backend-only, documentation)
spec_refs	string[]	No	Spec/plan references (lumenflow:// URIs)
initiative	string	No	Parent initiative (INIT-XXX or slug)
initiative_phase	integer	No	Canonical initiative_phase field
priority	string	No	Priority level (P0, P1, P2, P3)
type	string	No	WU type (feature, bug, refactor, documentation)

wu_done

Complete a Work Unit (merge, stamp, cleanup). MUST be run from main checkout. Use skip_gate (array of gate names) for explicit per-gate skip. skip_gates is a removed tombstone and is always rejected.

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to complete
skip_gate	string[]	No	Per-gate skip list. Skip only the named gates (must be skippable). Requires reason and fix_wu.
skip_gates	boolean	No	REMOVED: legacy binary skip-all tombstone. Requests are rejected; use skip_gate with explicit gate names.
reason	string	No	Reason for skipping gates
fix_wu	string	No	WU ID that will fix the skipped issue

wu_list

List all Work Units (WUs) with optional status filter

Authority: stdio callable; HTTP callable with task:read

Input:

Parameter	Type	Required	Description
status	”ready” | “in_progress” | “blocked” | “waiting” | “done”	No
lane	string	No

wu_status

Get detailed status of a specific Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID (e.g., WU-1234)
json	boolean	No	Output as JSON

Extended WU Lifecycle

WU maintenance, recovery, prep, and cleanup flows.

wu_amend

Append an audited correction to a DONE Work Unit record without rewriting the original (ADR-027). Supports adding an omitted code_paths entry (code_paths) or retracting a previously recorded amendment (retract) when it turns out to be wrong.

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to amend (must be status=done; use wu_edit otherwise)
reason	string	No	Why this correction is being recorded (required by the CLI)
code_paths	string[]	No	Code path(s) to append as an audited amendment
retract	string | number	No	1-based ordinal of a previously recorded amendment to retract (see the ”## Amendments” section of wu_status); mutually exclusive with code_paths

wu_block

Block a Work Unit and move it from in_progress to blocked status

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to block
reason	string	Yes	Reason for blocking
remove_worktree	boolean	No	Remove worktree when blocking

wu_brief

Generate handoff prompt for sub-agent WU execution

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to brief or delegate
client	string	No	Target client capability profile identifier
vendor	string	No	Non-authoritative legacy alias for client selection
codex	boolean	No	Non-authoritative legacy boolean alias for client selection
thinking	boolean	No	Enable extended thinking
no_thinking	boolean	No	Explicitly disable extended thinking
budget	integer	No	Positive token budget for thinking
parent_wu	string	No	Parent WU ID for delegation lineage
no_context	boolean	No	Skip advisory memory context injection
strict_sizing	boolean	No	Enforce WU sizing thresholds
report_tokens	boolean	No	Report prompt token metrics
launch_script	boolean	No	Emit a host-neutral launch wrapper

wu_cleanup

Clean up worktree and branch after PR merge (PR-based completion workflow)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to cleanup
artifacts	boolean	No	Remove build artifacts

wu_delegate

Generate delegation prompt and record explicit lineage intent

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to brief or delegate
client	string	No	Target client capability profile identifier
vendor	string	No	Non-authoritative legacy alias for client selection
codex	boolean	No	Non-authoritative legacy boolean alias for client selection
thinking	boolean	No	Enable extended thinking
no_thinking	boolean	No	Explicitly disable extended thinking
budget	integer	No	Positive token budget for thinking
parent_wu	string	No	Parent WU ID for delegation lineage
no_context	boolean	No	Skip advisory memory context injection
strict_sizing	boolean	No	Enforce WU sizing thresholds
report_tokens	boolean	No	Report prompt token metrics
launch_script	boolean	No	Emit a host-neutral launch wrapper

wu_delete

Safely delete WU YAML files with micro-worktree isolation

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to delete
dry_run	boolean	No	Show what would be deleted without making changes
batch	string	No	Delete multiple WUs (comma-separated)

wu_deps

Visualize WU dependency graph

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to analyze
format	”table” | “json” | “ascii” | “mermaid”	No	Output format
depth	number	No	Maximum traversal depth
direction	”up” | “down” | “both”	No	Graph direction

wu_edit

Edit Work Unit spec fields with micro-worktree isolation

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to edit
description	string	No	New description text
acceptance	string[]	No	Acceptance criteria to add
notes	string	No	Notes text to add
code_paths	string[]	No	Code paths to add
lane	string	No	New lane assignment
priority	”P0” | “P1” | “P2” | “P3”	No	New priority
initiative	string	No	Initiative ID
initiative_phase	integer	No	Canonical phase number within parent initiative
estimated_files	integer	No	Sizing estimate: expected modified artifacts, excluding files only read
estimated_tool_calls	integer	No	Sizing estimate: expected whole-WU tool calls; session safety remains separate
sizing_strategy	”single-session” | “checkpoint-resume” | “orchestrator-worker”	No	Executable strategy from the sizing guide; decomposition is plan-only
sizing_exception_type	”docs-only” | “shallow-multi-file” | “review-audit”	No	Bounded exception whose WU type, paths, and strategy must qualify
sizing_exception_reason	string	No	Exception evidence; audit read coverage is separate from modified artifacts
no_strict	boolean	No	Bypass strict validation

wu_infer_lane

Suggest lane for a WU based on code paths and description

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No	WU ID to analyze (reads YAML)
paths	string[]	No	Code paths to analyze
desc	string	No	WU description/title text

wu_preflight

Fast validation of code_paths and test paths before gates run (under 5 seconds vs 2+ minutes)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to preflight
worktree	string	No	Override worktree path

wu_prep

Prepare WU for completion by running gates in worktree. Use skip_gate (array of gate names) for per-gate skip (requires reason and fix_wu).

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to prepare
docs_only	boolean	No	Run docs-only gates
full_tests	boolean	No	Run test_full once instead of tests.unit or incremental execution
skip_gate	string[]	No	Per-gate skip list. Skip only the named gates (must be skippable). Requires reason and fix_wu.
reason	string	No	Reason for skipping gates
fix_wu	string	No	WU ID that will fix the skipped gate

wu_proto

Create and claim a prototype WU with relaxed validation

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
lane	string	No
title	string	No
description	string	No
code_paths	string[]	No
labels	string[]	No
assigned_to	string	No

wu_prune

Lease-aware stale worktree cleanup with quarantine audit evidence (dry-run by default)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
execute	boolean	No	Execute cleanup (default is dry-run)
remote	boolean	No	Prune already-merged remote lane branches instead of local worktrees

wu_rebase

Rebase the claimed Work Unit lane branch onto the integration target (governed); pauses content conflicts for guarded continue or abort and auto-resolves only metadata

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No	WU ID (default: inferred from the lane branch)
dry_run	boolean	No	Report how far behind the branch is, without rebasing
continue	boolean	No	Continue a governed manual content resolution
abort	boolean	No	Abort a governed content-conflict pause
allow_staged	string[]	No	Repo-relative staged path explicitly authorized for this continuation

wu_recover

Recover WU state, including non-destructive reconcile and worktree restore

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to recover
action	”resume” | “restore” | “reconcile” | “reset” | “nuke” | “cleanup”	No	Recovery action to take
force	boolean	No	Required for destructive actions like nuke
json	boolean	No	Output as JSON

wu_release

Release an orphaned WU from in_progress back to ready state for reclaiming

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to release
reason	string	No	Reason for releasing

wu_repair

Unified WU repair tool - detect and fix WU state issues

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No	WU ID to check/repair
check	boolean	No	Audit only, no changes
all	boolean	No	Check/repair all WUs
claim	boolean	No	Claim repair mode
admin	boolean	No	Admin repair mode
repair_state	boolean	No	State repair mode

wu_sandbox

Run a command through the hardened WU sandbox backend

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID (e.g., WU-1234)
worktree	string	No	Optional worktree path override
command	string[]	Yes	Command argv to execute (e.g., [“node”, “-e”, “process.exit(0)”])

wu_unblock

Unblock a Work Unit and move it from blocked to in_progress status

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to unblock
reason	string	No	Reason for unblocking
create_worktree	boolean	No	Create worktree when unblocking

wu_unlock_lane

Safely unlock a lane lock with audit logging

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
lane	string	No	Lane name to unlock
reason	string	No	Reason for unlocking
force	boolean	No	Force operation
list	boolean	No	List all current lane locks
status	boolean	No	Show detailed status for the lane

wu_validate

Validate WU YAML files against schema (strict mode by default)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	WU ID to validate
no_strict	boolean	No	Bypass strict validation

Initiatives

Initiative planning, assignment, and status operations.

initiative_add_wu

Add a Work Unit to an initiative, optionally assigning to a phase

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
initiative	string	Yes	Initiative ID to link WU to
wu	string	Yes	WU ID to add (or array for batch)
phase	number	No	Phase number to assign (1-based)

initiative_bulk_assign

Bulk assign WUs to an initiative based on lane prefix rules

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
config	string	No	Path to lane bucket configuration file
apply	boolean	No	Apply changes (default is dry-run)
sync_from_initiative	string	No	Reconcile WUs from a specific initiative

initiative_create

Create a new initiative for multi-phase project orchestration

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	Initiative ID (e.g., INIT-001)
slug	string	Yes	Initiative slug (kebab-case, e.g., my-initiative)
title	string	Yes	Initiative title
priority	string	No	Priority level (P0, P1, P2, P3)
owner	string	No	Owner email or name
target_date	string	No	Target completion date (YYYY-MM-DD)

initiative_edit

Edit initiative fields

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	Initiative ID to edit
status	”draft” | “open” | “in_progress” | “done” | “archived”	No	New initiative status
blocked_by	string	No	Initiative ID that blocks this initiative
blocked_reason	string	No	Reason for blocking
unblock	boolean	No	Remove blocked_by and blocked_reason fields
add_lane	string[]	No	Lanes to add (repeatable)
remove_lane	string[]	No	Lanes to remove (repeatable)
notes	string	No	Note to append to notes array
description	string	No	Replace the initiative description field
add_phase	string[]	No	Phase titles to add (repeatable)
add_success_metric	string[]	No	Success metrics to add (repeatable, deduplicated)
phase_id	string	No	Phase ID to update (use with phase_status)
phase_status	”pending” | “in_progress” | “done” | “blocked”	No	New phase status
phase_title	string	No	New phase title
created	string	No	Set created date (YYYY-MM-DD format)
phase_execution_order	”sequential” | “parallel”	No	Phase execution order (sequential or parallel)
dependency_model	string	No	Dependency model for the initiative

initiative_list

List all initiatives with optional status filter

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
status	string	No	Filter by initiative status
format	”table” | “json”	No	Output format (table, json)
color	boolean	No	Enable colored output

initiative_plan

Link an existing plan or create a new plan template for an initiative

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
initiative	string	Yes	Initiative ID to link plan to
plan	string	No	Path to existing plan file (markdown)
create	boolean	No	Create a new plan template instead of linking

initiative_remove_wu

Remove a Work Unit from an initiative

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
initiative	string	Yes	Initiative ID to unlink WU from
wu	string	Yes	WU ID to remove

initiative_status

Get detailed status of a specific initiative including WUs and progress

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	Initiative ID or slug
format	”table” | “json”	No	Output format (table, json)
color	boolean	No	Enable colored output

Memory

Session memory, checkpoints, recovery, and coordination flows.

mem_checkpoint

Save a progress checkpoint for a Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	Yes	WU ID to checkpoint
message	string	No	Checkpoint message
session	string	No	Session ID to link checkpoint to (UUID)
progress	string	No	Progress summary
next_steps	string	No	Next steps description
trigger	string	No	Handoff trigger type (e.g., clear, handoff)

mem_cleanup

Clean up stale memory data

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
dry_run	boolean	No	Preview cleanup without making changes
ttl	string	No	Remove nodes older than duration (e.g., 30d, 7d, 24h)
session_id	string	No	Session ID to consider closed

mem_context

Get memory context scoped by Work Unit, lane, or tags

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	No	WU ID to get context for
lane	string	No	Filter by lane
tags	string[]	No	Filter by one or more tags
max_size	number	No	Maximum context size in bytes
max_recent_summaries	number	No	Maximum number of recent summaries
max_project_nodes	number	No	Maximum number of project nodes
format	”json” | “human”	No	Output format
include_roster	boolean	No	Include a coordination roster section cross-linking delegations + sessions
initiative	string	No	Initiative ID to scope roster to

mem_converged

Evaluate whether every recipient on an A2A signal thread has posted AGREE

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
thread	string	Yes	A2A thread ID to evaluate
quiet	boolean	No	Suppress detail output; rely on exit code

mem_create

Create a memory node (e.g., for bug discovery)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
message	string	Yes	Memory node message
wu	string	No	WU ID to associate with
type	string	No	Node type (e.g., discovery, session, checkpoint, note)
tags	string[]	No	Tags for the node
discovered_from	string	No	Parent node ID for provenance tracking
session	string	No	Session ID to link node to (UUID)
priority	string	No	Priority level (P0, P1, P2, P3)

mem_delete

Delete or archive a memory node

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	Yes	Memory node ID to delete
tag	string	No	Delete all nodes matching this tag
older_than	string	No	Delete nodes older than duration (e.g., 30d)
dry_run	boolean	No	Preview deletion without making changes

mem_export

Export memory for a Work Unit as markdown or JSON

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	Yes	WU ID to export
format	”markdown” | “json”	No	Export format
type	string	No	Filter by node type
lifecycle	string	No	Filter by lifecycle (ephemeral, session, wu, project)

mem_inbox

Check coordination signals from other agents

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
since	string	No	Time filter (e.g., “30m”, “1h”)
wu	string	No	Filter by WU ID
lane	string	No	Filter by lane
for	string	No	Reader identity/session to evaluate unread state for
thread	string	No	Filter by A2A thread ID
intent	string	No	Comma-separated A2A intents to include

mem_init

Initialize memory layer for a Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	No	WU ID to initialize memory for

mem_ready

Check pending memory nodes for a Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	Yes	WU ID to check pending nodes for
type	string	No	Filter by node type
format	”json” | “human”	No	Output format

mem_recover

Generate recovery context after compaction for a Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	No
max_size	number	No
format	”json” | “human”	No
quiet	boolean	No
base_dir	string	No

mem_signal

Broadcast a coordination signal to other agents

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
message	string	Yes	Signal message
wu	string	No	WU ID to associate with
lane	string	No	Lane to associate with
type	string	No	Signal type (e.g., handoff, unblock, alert)
sender	string	No	Sender identifier (agent/session)
target_agent	string	No	Target agent identifier
to	string	No	Comma-separated recipient identities or session IDs
origin	string	No	Signal origin context (e.g., cli, mcp, remote)
remote_id	string	No	Remote signal ID for cross-system correlation
thread	string	No	A2A thread ID
reply_to	string	No	Parent signal ID for A2A replies
intent	”INFO” | “PROPOSE” | “COUNTER” | “AGREE” | “REJECT”	No	A2A signal intent
interrupt_class	”advisory” | “priority” | “urgent” | “soon” | “immediate”	No	A2A interrupt class (advisory|priority|urgent canonical; soon|immediate are legacy aliases)
requires_ack	boolean	No	Whether recipients must ACK/REJECT
role	string	No	Sender role descriptor
target_role	string	No	Intended-recipient role descriptor
initiative	string	No	Initiative scope (e.g., INIT-001); valid on its own
delegation_id	string	No	Delegation registry linkage (dlg-XXXX)

mem_start

Start a memory session for a Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	Yes	WU ID to start session for
lane	string	No	Lane name
agent_type	string	No	Agent type (e.g., general-purpose, explore, test-engineer)
context_tier	string	No	Context tier (core, full, minimal)

mem_summarize

Summarize memory context for a Work Unit

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	Yes	WU ID to summarize
dry_run	boolean	No	Preview summary without making changes

mem_triage

Triage discovered bugs for a Work Unit, optionally promoting to WU

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	No	WU ID to triage discoveries for
promote	string	No	Memory node ID to promote to Bug WU
lane	string	No	Lane for promoted Bug WU
archive	string	No	Memory node ID to archive
reason	string	No	Reason for archiving

Agent

Agent session lifecycle and issue capture operations.

agent_issues_query

Query and display logged agent incidents/issues summary

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
since	number	No	Days to include (default: 7)
category	string	No	Filter by category
severity	”blocker” | “major” | “minor” | “trivial”	No	Filter by severity

agent_log_issue

Log a workflow issue or incident during agent execution

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
category	”workflow” | “tooling” | “confusion” | “violation” | “error”	Yes	Issue category
severity	”blocker” | “major” | “minor” | “info”	Yes	Severity level
title	string	Yes	Short description (5-100 chars)
description	string	Yes	Detailed context (10-2000 chars)
resolution	string	No	How the issue was resolved
tags	string[]	No	Tags for categorization
step	string	No	Current workflow step (e.g., wu:done, gates)
files	string[]	No	Related file paths

agent_resolve

Plan effective model routing without claiming that a host applied the requested route

Authority: stdio callable; HTTP callable with task:read

Input:

Parameter	Type	Required	Description
client	string	No	Client capability profile to resolve
wu	string	No	Resolve the canonical route for one WU
json	boolean	No	Request structured output
no_telemetry	boolean	No	Compatibility flag; MCP routing reads never append CLI telemetry

agent_session

Start an agent session for tracking WU execution

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	Yes	WU ID to work on (e.g., WU-1234)
tier	number	Yes	Context tier (1, 2, or 3)
agent_type	string	No	Agent capability profile identifier

agent_session_end

End the current agent session and return summary

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

Orchestration & Delegation

Initiative orchestration, monitoring, and delegation helpers.

delegation_list

Display delegation and launch records for WUs or initiatives

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
wu	string	No	WU ID to show delegation / launch records for (e.g., WU-1234)
initiative	string	No	Initiative ID to show delegation / launch records for (e.g., INIT-001)
json	boolean	No	Output as JSON

orchestrate_init_status

Show compact initiative status including evidence-based orchestration state

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
initiative	string	Yes	Initiative ID or slug (e.g., INIT-001)

orchestrate_initiative

Prepare planner-only initiative handoffs and status artifacts without attesting host execution

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
initiative	string	Yes	Initiative ID to orchestrate (e.g., INIT-001)
dry_run	boolean	No	Show the logical wave plan without writing artifacts
progress	boolean	No	Show current reconciled progress only
checkpoint_per_wave	boolean	No	Prepare the next logical wave then exit without polling
no_checkpoint	boolean	No	Force polling mode
client	string	No	Client capability profile for handoff rendering
print_handoffs	boolean	No	Return stored handoff artifacts for manual copy/paste
strict_preflight	boolean	No	Treat overlap or lane-fit preflight warnings as blocking

orchestrate_monitor

Monitor orchestration progress, stalls, returned workers, and recovery signals

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
threshold	number	No	Stuck detection threshold in minutes (default: 30)
recover	boolean	No	Run recovery actions for stuck spawns
dry_run	boolean	No	Show what would be done without taking action
since	string	No	Show recent signals/checkpoints since (e.g., 30m, 1h)
wu	string	No	Filter by WU ID
signals_only	boolean	No	Only show signal traffic (skip broader orchestration evidence)

Flow & Metrics

Flow analysis and metrics tooling.

flow_bottlenecks

Identify flow bottlenecks in the workflow (WIP violations, stuck WUs, etc.)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
limit	number	No	Number of bottlenecks to show (default: 10)
format	”json” | “table” | “mermaid”	No	Output format for bottleneck diagnostics: json, table, mermaid
json	boolean	No	Output as JSON (shorthand for —format json)

flow_report

Generate flow metrics report with cycle time, throughput, and other DORA metrics

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
start	string	No	Start date (YYYY-MM-DD)
end	string	No	End date (YYYY-MM-DD), defaults to today
days	number	No	Days to report (default: 7)
format	”json” | “table”	No	Output format: json, table
json	boolean	No	Output as JSON (shorthand for —format json)

lumenflow_metrics

View workflow metrics (lumenflow:metrics alias)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
subcommand	”lanes” | “dora” | “flow” | “all”	No	Metrics subcommand (lanes, dora, flow, all)
format	”json” | “table”	No	Output format
days	number	No	Days window for metrics calculation
output	string	No	Custom output file path
dry_run	boolean	No	Preview without writing

metrics

View workflow metrics (lanes, dora, flow, all)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
subcommand	”lanes” | “dora” | “flow” | “all”	No	Metrics subcommand (lanes, dora, flow, all)
format	”json” | “table”	No	Output format
days	number	No	Days window for metrics calculation
output	string	No	Custom output file path
dry_run	boolean	No	Preview without writing

metrics_snapshot

Capture a snapshot of current LumenFlow metrics

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
type	”all” | “dora” | “lanes” | “flow”	No	Snapshot type: all, dora, lanes, flow (default: all)
output	string	No	Output file path
days	number	No	Days window for metrics calculation
dry_run	boolean	No	Preview without writing snapshot file
format	”json” | “table”	No	Output format

Validation

Validation and health-check operations.

validate

Validate WU YAML files and status consistency

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No	Specific WU ID to validate
strict	boolean	No	Fail on warnings too
done_only	boolean	No	Only validate done WUs

validate_agent_skills

Validate canonical LumenFlow skill definitions

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
skill	string	No	Specific skill to validate (e.g., “wu-lifecycle”)

validate_agent_sync

Validate agent synchronization state

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

validate_backlog_sync

Validate backlog synchronization between WU YAMLs and backlog.md

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

validate_skills_spec

Validate skills specification files

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

Setup & Bootstrap

Initialization, onboarding, and environment setup flows.

cloud_connect

Connect workspace.yaml to cloud control plane

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
endpoint	string	No
org_id	string	No
project_id	string	No
token_env	string	No
policy_mode	”authoritative” | “tighten-only” | “dev-override”	No
sync_interval	integer	No
output	string	No
force	boolean	No

lumenflow

Initialize provider-neutral LumenFlow lifecycle enforcement (compatibility alias)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
merge	boolean	No	Merge into existing files using bounded markers
full	boolean	No	Add docs + agent onboarding + task scaffolding
minimal	boolean	No	Skip agent onboarding docs (only core files)
framework	string	No	Add framework hint + overlay docs

lumenflow_commands

List all available LumenFlow CLI commands

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

lumenflow_docs_sync

Sync agent documentation after upgrading LumenFlow packages

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

lumenflow_doctor

Diagnose LumenFlow configuration and safety components

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

lumenflow_gates

Run quality gates (lumenflow-gates alias)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
docs_only	boolean	No	Run docs-only gates (skip lint/typecheck/tests)
full_lint	boolean	No	Run full lint instead of incremental
full_tests	boolean	No	Run full test suite instead of incremental
full_coverage	boolean	No	Force full test suite and coverage gate (implies full_tests)
coverage_mode	string	No	Coverage gate mode: “warn” or “block”
verbose	boolean	No	Stream output in agent mode instead of logging to file

lumenflow_init

Initialize provider-neutral LumenFlow lifecycle enforcement in a project

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
merge	boolean	No	Merge into existing files using bounded markers
full	boolean	No	Add docs + agent onboarding + task scaffolding
minimal	boolean	No	Skip agent onboarding docs (only core files)
framework	string	No	Add framework hint + overlay docs

lumenflow_integrate

Deprecated no-op retained for compatibility; host-native adapters are project-owned and cannot grant lifecycle authority

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

lumenflow_onboard

Interactive setup wizard for LumenFlow workspace (alias)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
yes	boolean	No
domain	”software-delivery” | “infra” | “custom”	No
project_name	string	No
output	string	No
force	boolean	No
skip_pack_install	boolean	No
skip_dashboard	boolean	No

lumenflow_release

Run LumenFlow release workflow (versioning, npm publish)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
dry_run	boolean	No	Preview release without publishing

lumenflow_sync_templates

Sync LumenFlow templates to the project

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

lumenflow_upgrade

Upgrade LumenFlow packages to latest versions

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input: None

lumenflow_validate

Run validation checks (lumenflow-validate alias)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No	Specific WU ID to validate
strict	boolean	No	Fail on warnings too
done_only	boolean	No	Only validate done WUs

onboard

Interactive setup wizard for LumenFlow workspace

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
yes	boolean	No
domain	”software-delivery” | “infra” | “custom”	No
project_name	string	No
output	string	No
force	boolean	No
skip_pack_install	boolean	No
skip_dashboard	boolean	No

workspace_init

Initialize workspace.yaml from interactive prompts

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
yes	boolean	No
output	string	No
force	boolean	No

Parity & Utilities

File, git, plan, state, config, and parity helpers.

backlog_prune

Clean stale backlog entries and archive old completed WUs

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
execute	boolean	No
dry_run	boolean	No
stale_days_in_progress	number	No
stale_days_ready	number	No
archive_days	number	No

cert_verify

Verify an agent promotion-ladder transition against certification evidence

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
agent_id	string	Yes
agent_version	string	Yes
current_state	string	Yes
target_state	string	Yes
evidence_dir	string	No
json	boolean	No

config_get

Read and display a value from workspace.yaml

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
key	string	No

config_set

Safely update workspace.yaml via micro-worktree

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
key	string	No
value	string	No

config_unset

Safely delete a key from workspace.yaml via micro-worktree

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
key	string	No

docs_sync

Sync agent onboarding docs and skills to existing projects

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
force	boolean	No

eval_run

Run a certification scenario suite against an agent evaluation report

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
agent_id	string	Yes
agent_version	string	Yes
report	string	Yes
suite	string	No
evidence_dir	string	No
json	boolean	No

eval_suite

Define, list, and validate agent certification scenario suites

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
suite	string	No
show	string	No
validate	string	No
json	boolean	No

file_delete

Delete files or directories with safety flags

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
path	string	No
recursive	boolean	No
force	boolean	No

file_edit

Edit a file via exact string replacement

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
path	string	No
old_string	string	No
new_string	string	No
encoding	string	No
replace_all	boolean	No

file_read

Read a file with optional line ranges and encoding

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
path	string	No
encoding	string	No
start_line	number	No
end_line	number	No
max_size	number	No

file_write

Write content to a file with audit trail

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
path	string	No
content	string	No
encoding	string	No
no_create_dirs	boolean	No

gates

Run LumenFlow quality gates

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
docs_only	boolean	No	Run docs-only gates (skip lint/typecheck/tests)
full_lint	boolean	No	Run full lint instead of incremental
full_tests	boolean	No	Run full test suite instead of incremental
full_coverage	boolean	No	Force full test suite and coverage gate (implies full_tests)
coverage_mode	string	No	Coverage gate mode: “warn” or “block”
verbose	boolean	No	Stream output in agent mode instead of logging to file

gates_docs

Run docs-only quality gates

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
docs_only	boolean	No	Run docs-only gates (skip lint/typecheck/tests)
full_lint	boolean	No	Run full lint instead of incremental
full_tests	boolean	No	Run full test suite instead of incremental
full_coverage	boolean	No	Force full test suite and coverage gate (implies full_tests)
coverage_mode	string	No	Coverage gate mode: “warn” or “block”
verbose	boolean	No	Stream output in agent mode instead of logging to file

git_branch

Show git branch listing and current branch

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
list	boolean	No
all	boolean	No
remotes	boolean	No
show_current	boolean	No
contains	string	No

git_diff

Show git diff with staged/name-only/stat modes

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
ref	string	No
staged	boolean	No
name_only	boolean	No
stat	boolean	No
path	string	No

git_log

Show git commit log with filters

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
ref	string	No
oneline	boolean	No
max_count	number	No
format	string	No
since	string	No
author	string	No

git_status

Show git status with optional porcelain/short modes

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
path	string	No
porcelain	boolean	No
short	boolean	No

git_sync_main

Fast-forward a clean primary main checkout to origin/main

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
base_dir	string	No

init_plan

Link or create a plan for an initiative

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
initiative	string	Yes	Initiative ID to link plan to
plan	string	No	Path to existing plan file (markdown)
create	boolean	No	Create a new plan template instead of linking

lane_health

Check lane configuration health (overlaps and coverage gaps)

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
json	boolean	No
verbose	boolean	No
no_coverage	boolean	No

lane_suggest

Generate lane suggestions from codebase context

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
dry_run	boolean	No
interactive	boolean	No
output	string	No
json	boolean	No
no_llm	boolean	No
include_git	boolean	No

plan_create

Create a new plan for a WU or initiative

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No
title	string	No

plan_edit

Edit or append content to a plan section

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No
section	string	No
content	string	No
append	string	No

plan_link

Link an existing plan URI to a WU or initiative

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No
plan	string	No

plan_promote

Promote plan from draft to approved status

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
id	string	No
force	boolean	No

signal_cleanup

Cleanup stale signals using TTL policy

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
dry_run	boolean	No
ttl	string	No
unread_ttl	string	No
max_entries	number	No
json	boolean	No
quiet	boolean	No
base_dir	string	No

state_bootstrap

Bootstrap state store from existing WU YAML files

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
execute	boolean	No
dry_run	boolean	No
force	boolean	No
wu_dir	string	No
state_dir	string	No

state_cleanup

Clean stale state, memory, and signal data

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
dry_run	boolean	No
signals_only	boolean	No
memory_only	boolean	No
events_only	boolean	No
json	boolean	No
quiet	boolean	No
base_dir	string	No

state_doctor

Diagnose state store integrity issues

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
fix	boolean	No
dry_run	boolean	No
json	boolean	No
quiet	boolean	No
base_dir	string	No

sync_templates

Sync internal docs to CLI templates

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
dry_run	boolean	No
verbose	boolean	No
check_drift	boolean	No

Runtime Task Tools

Kernel runtime task lifecycle tools.

task_block

Block a task directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
task_id	string	Yes
reason	string	Yes
timestamp	string	No

task_claim

Claim a task directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP callable with task:write

Input:

Parameter	Type	Required	Description
task_id	string	Yes
domain_data	object	No

task_complete

Complete a task directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP callable with task:write

Input:

Parameter	Type	Required	Description
task_id	string	Yes
run_id	string	No
evidence_refs	string[]	No

task_create

Create a task directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP callable with task:write

Input:

Parameter	Type	Required	Description
lane_id	string	Yes
domain	string	Yes
title	string	Yes
description	string	Yes
acceptance	array | object	Yes
expected_artifacts	string[]	No
risk	”low” | “medium” | “high” | “critical”	Yes
blocks	string[]	No
blocked_by	string[]	No
execution_policy_profile	string	No
extensions	object	No
type	string	Yes
priority	”P0” | “P1” | “P2” | “P3”	Yes
labels	string[]	No

task_inspect

Inspect a task directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP callable with task:read

Input:

Parameter	Type	Required	Description
task_id	string	Yes

task_unblock

Unblock a task directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP hidden; typed exclusion runtime_migration_pending

Input:

Parameter	Type	Required	Description
task_id	string	Yes
timestamp	string	No

tool_execute

Execute a tool directly through KernelRuntime (no CLI shell-out).

Authority: stdio hidden; HTTP callable with tool:invoke

Input:

Parameter	Type	Required	Description
tool_name	string	Yes
tool_input	unknown	No
execution_selector	object	Yes

---

Next Steps

• CLI Commands – Public command reference
• Kernel Runtime – Tool execution pipeline
• Tool Execution – Dispatch and sandboxing