intentdna 1.9.0-rc.2 → 1.9.1

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "intentdna",
       "description": "Declarative policy layer for AI agent behavior with plugin-managed hook runtime for Claude Code.",
-      "version": "1.9.0-rc.2",
+      "version": "1.9.1",
       "author": {
         "name": "Samuel"
       },
@@ -25,5 +25,5 @@
       ]
     }
   ],
-  "version": "1.9.0-rc.2"
+  "version": "1.9.1"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "intentdna",
-  "version": "1.9.0-rc.2",
+  "version": "1.9.1",
   "description": "Declarative policy layer for AI agent behavior",
   "author": {
     "name": "Samuel"

package/README.md

@@ -1,201 +1,351 @@
 # IntentDNA
 
-**Governed AI work system for turning repeated AI work methods into reviewed, distributable, locally executable workflow assets.**
+**面向 Codex CLI、Claude Code 等 AI 编程环境的声明式工作流资产、同步与运行工具。**
 
-IntentDNA helps teams describe how useful AI work should happen, convert that method into a governed workflow asset, install it into local AI harnesses, collect evidence, review rollout, and improve the asset without moving runtime authority into a web dashboard.
+[English](#english) | [路线转换文章](https://wanglushan.cn/blog/intentdna-route-reset-from-platform-to-workflow-cli) | [历史 Online 看板](https://online-plum-one.vercel.app)
 
-The product contract is:
+> **项目状态 / Project status:** 本项目后续不再进行独立扩展；新的研发自动化能力将以独立 CLI 等工具的形式在其他仓库开发。 / This project will not be expanded independently; new engineering automation capabilities will be developed in other repositories as standalone CLIs and related tools.
+
+IntentDNA 把一套可重复的 AI 工作方法描述为版本化的 `.dna.yaml` 资产，并提供确定性的校验、编译、同步、运行和证据能力。你可以用它定义步骤、角色、权限、交接、检查点、重试和验证规则，再把工作流同步到本地 Harness 中执行。
+
+## 它解决什么问题
+
+AI 编程工作流经常散落在 Prompt、对话、个人经验和临时脚本中。IntentDNA 将这些方法变成可以审查和复用的工程资产：
+
+- 用 YAML 明确适用场景、输入、输出、角色、步骤和边界；
+- 在执行前确定性校验结构、引用、权限和工作流约束；
+- 同步为 Codex Skills、Claude agents/skills/hooks 等 Harness 资产；
+- 用 Controller 支持持久运行、并行步骤、检查点、审查、重试和恢复；
+- 打包、签名并验证本地运行证据；
+- 从真实 Skills 和源码提炼候选资产，同时保留来源与许可证信息。
+
+核心边界是：
 
 ```text
-local dna is runtime truth
-marketplace distributes workflow assets
-online/SaaS manages organization evidence and lifecycle
+.dna.yaml 资产 = 工作流定义
+dna validate / compile / sync = 确定性工具链
+Codex CLI / Claude Code / provider = 实际执行环境
+本地运行记录与 verifier = 完成证据
+Online = 历史看板与可选投影，不是运行时
 ```
 
-IntentDNA is not a model company, generic agent framework, prompt library, canvas automation product, or SaaS workflow executor.
+IntentDNA 不重造通用模型循环，不把 Online 或 Supabase 当作本地权限来源，也不接受模型的“已完成”声明替代验证结果。
 
-## Install or update
+## 安装
 
 ```bash
-npm install --global intentdna@1.8.5
+npm install --global intentdna@latest
 dna --version
 ```
 
-Version `1.8.5` keeps Claude plugin Hook delivery in `hooks/hooks.json`: plugin sync does not register project `settings.json` Hooks, retracts exact stale bin-mode `dna-hook` entries once, and leaves user settings untouched in steady state. Online generates copyable local commands only; you still run and review them in your own project.
+Claude Code 插件与 npm 包使用相同版本发布：
+
+```bash
+claude plugin marketplace add lushan1314/intentdna-repo
+claude plugin install intentdna@intentdna
+```
 
-## Product Shape
+## 使用现有工作流
 
-IntentDNA has three connected products:
+先查看内置资产，再在目标项目中初始化和同步：
+
+```bash
+dna templates list
+dna templates show flutter-rewrite
+dna quickstart --asset flutter-rewrite --sync-target codex
+
+dna init --template flutter-rewrite
+dna sync --codex --dry-run
+dna sync --codex
+```
+
+`dna quickstart` 只输出指引；`dna sync --dry-run` 预览文件变更；`dna sync` 才会写入 Harness 资产，但不会自动运行工作流。
+
+同步完成后，在对应项目中使用 Codex CLI 或 Claude Code 调用生成的 Skill、agent 或工作流入口。检查同步状态：
+
+```bash
+dna sync status
+dna sync doctor
+```
+
+## 打造自己的工作流
+
+IntentDNA 将“理解人的意图”和“确定性验证”分开：外部 Agent 负责访谈并编写 YAML，`dna` 负责提供完整创作契约并验证结果，人负责确认是否保存和采用。
+
+### 1. 生成创作包
+
+```bash
+dna workflow authoring-packet "描述要沉淀的重复工作方法" \
+  --project-dir /path/to/project \
+  --json
+```
 
-| Surface | What it owns | What it must not become |
-| --- | --- | --- |
-| Local npm foundation | `dna`, `dna-hook`, compiler, adapters, sync, reports, local runtime evidence | A thin demo wrapper or optional afterthought |
-| Workflow asset marketplace | Public, personal, `internal_ready`, and later SaaS-backed `org_private` workflow assets | Runtime execution, approval, or policy authority |
-| Online/SaaS console | Accounts, organization evidence, receipts, audit, publication lifecycle, readiness projection | A workflow runner or `allow` / `warn` / `block` / `validate` engine |
+创作包包含字段约束、红线、真实示例、访谈问题、校验循环和交接边界。这个命令不调用模型，也不生成或保存 YAML。
 
-The closed loop is:
+### 2. 让 Agent 编写候选资产
+
+候选文件放在：
 
 ```text
-dogfood evidence
-  -> workflow asset
-  -> marketplace listing
-  -> local install/sync
-  -> harness execution
-  -> local runtime evidence
-  -> signed report upload
-  -> cloud receipt/audit
-  -> manager review
-  -> asset improvement
+.dna/authoring/<asset>.candidate.dna.yaml
 ```
 
-## Start By Role
+一个工作流资产通常包括：
 
-### Developer
+- `id`、`name`、`version`、`purpose`、`maturity`；
+- `fit`、`not_for`、`inputs`、`outputs`；
+- `roles` 及其工具权限和读写范围；
+- `workflow` 或 `workflows` 中的步骤、依赖、交接、检查点和重试；
+- `boundaries`、`evidence` 和 `lineage`。
 
-Use this when you want one governed workflow running locally without waiting for cloud setup:
+### 3. 校验并修订
 
 ```bash
-dna quickstart --asset flutter-rewrite --sync-target codex
-dna templates list
-dna templates show flutter-rewrite
-dna init --template flutter-rewrite
-dna sync --codex --dry-run
-dna sync --codex
-# run the synced workflow in Codex CLI or Claude Code
-dna report package --json
-dna report sign --json
-dna report verify <envelope-path> --json
+dna validate .dna/authoring/<asset>.candidate.dna.yaml
 ```
 
-`dna quickstart` is read-only guidance: it prints the local route without initializing, syncing, running a workflow, packaging reports, signing evidence, uploading evidence, or calling Online/Supabase. Local-only use does not require Supabase. `dna sync` installs, distributes, and injects artifacts only; execution happens in the selected harness. `dna-hook` and local runtime evidence remain runtime truth.
+Agent 只根据校验诊断和已确认的人类意图修改 YAML，直到校验通过。`dna` 不推断目标，也不会自动放宽边界。
+
+### 4. 人工确认并加入项目资产库
 
-### Team Lead / Manager
+确认候选内容后，将同一份 YAML 保存为：
 
-Use this when you need to see which workflow assets are active, blocked, stale, or ready to roll out:
+```text
+.dna/templates/<asset>.dna.yaml
+```
+
+然后检查资产并预览同步结果：
 
 ```bash
-dna org intake "<team/project/workflow intent>" --json
-dna org review --json
-dna org rollout --json
-dna org receipt --json
+dna assets show <asset> --project-dir /path/to/project
+dna assets inspect <asset> --project-dir /path/to/project
+dna sync --project-dir /path/to/project --dry-run
+dna sync --project-dir /path/to/project --codex --dry-run
 ```
 
-Manager review is a read-only decision surface until an explicit local command changes project or organization state. `internal_ready` means adoption candidate, not org-private SaaS visibility. A later `org_private` publication requires auth, RLS, storage, permissions, audit, and live tests.
+保存、采用和同步是彼此独立的人工决策。校验通过不代表资产已被采用或执行。
 
-### Template Author
+## 运行与证据
 
-Use this when a repeated work method should become a reusable workflow asset:
+工作流可以在同步后的 Harness 中执行，也可以使用 IntentDNA Controller 的运行入口。可用命令以当前 CLI 帮助为准：
 
 ```bash
-dna workflow authoring-packet "<workflow intent>" --json --project-dir '<local-project-path>'
-# an external agent interviews you and writes .dna/authoring/<asset>.candidate.dna.yaml
-dna validate '<local-project-path>/.dna/authoring/<asset>.candidate.dna.yaml'
-# after explicit human confirmation, save the same YAML under .dna/templates/
-dna assets show '<asset>' --project-dir '<local-project-path>'
-dna assets inspect '<asset>' --project-dir '<local-project-path>'
-dna sync --project-dir '<local-project-path>' --dry-run
-dna sync --project-dir '<local-project-path>' --codex --dry-run
+dna run --help
+dna run status <run-id>
+dna run inspect <run-id>
+dna run resume <run-id>
+```
 
-# after real runs, inspect evidence-backed improvements
-dna workflow suggestions '<asset>' --json
-dna workflow review-suggestion --from-template '<asset>' --workflow '<workflow-id>' --suggestion '<suggestion-id>' --decision accept --json
-dna workflow improve-from-suggestions --from-template '<asset>' --workflow '<workflow-id>' --suggestion '<suggestion-id>' --save-template '<asset-v2>' --json
-dna workflow mine '<asset>' --json
+真实执行后，可打包、签名并验证本地证据：
 
-# legacy/example-assisted entry points remain available
-dna workflow intake "<workflow intent>" --json
-dna workflow route "<workflow intent>" --json
-dna workflow draft "<workflow intent>" --json # optional example-clone scaffold fallback
-dna workflow edit-plan "<change>" --from-template <template> --save-template <template-v2>
-dna assets governance <asset> --json
+```bash
+dna report package --json
+dna report sign --package .dna/reports/latest-report-package.json \
+  --output .dna/reports/ingest/local-envelope.json \
+  --json
+dna report verify .dna/reports/ingest/local-envelope.json --json
 ```
 
-Authoring starts from a work method, fit, inputs, outputs, roles, boundaries, handoffs, verifiers, and evidence posture. The external agent authors YAML; deterministic `dna validate` checks it; a human decides whether to save it. Captured evidence can produce suggestions, but only a matching human review receipt can open the next reviewable draft route. Adoption, organization binding, rollout, and sync remain separate.
+云端上传是可选能力，并且必须先通过凭证和部署检查。本地工作流的运行事实不会因为上传而转移到云端。
+
+## 内置工作流类型
+
+仓库包含多种可直接查看和复用的资产，包括：
+
+- Flutter 重写、行为锁定、诊断与修复审查；
+- 代码审查、TDD、QA、调试、迁移和发布证据；
+- 并行子 Agent、多角色交接和持久执行；
+- 研究改进、工作流创作和资产提炼；
+- 安全开发、事故响应和组织基线。
+
+使用 `dna templates list` 查看当前安装版本中的完整目录。
+
+## 路线转换与历史
+
+IntentDNA 曾优先建设跨 Harness 抽象、组织治理、市场和 Online 控制面。实践表明，这些机制具备工程可行性，但平台优先并不是后续研发自动化最合适的起点。
 
-### Administrator / Security Buyer
+完整反思见《[IntentDNA 路线重置：从平台优先到工作流 CLI](https://wanglushan.cn/blog/intentdna-route-reset-from-platform-to-workflow-cli)》。
 
-Use this when you need to verify authority, secrets, audit, and cloud trust boundaries:
+[IntentDNA Online 看板](https://online-plum-one.vercel.app) 作为历史产品证据继续保留，用于展示当时的资产选择、安装指引和证据投影。它不执行工作流。
+
+仓库中的当前文档和历史证据采用两态管理：少量 living docs 描述当前实现，带日期和索引的 `docs/archive/` 保存路线演进；本地会话状态、临时提示词、运行日志和 IDE workspace 不进入版本控制。
+
+## 文档
+
+- [快速开始](docs/quickstart.md)
+- [工作流资产格式](docs/architecture/c1-asset-format.md)
+- [工作流创作包契约](docs/architecture/c3-authoring-packet.md)
+- [Controller 与 worker 运行时](docs/architecture/controller-worker-runtime.md)
+- [工作流运行时清单](docs/architecture/workflow-runtime-manifest.md)
+- [本地证据捕获](docs/architecture/c5-evidence-capture.md)
+- [产品重置 ADR](docs/decisions/ADR-001-product-reset.md)
+- [文档与历史档案索引](docs/README.md)
+
+## License
+
+Apache-2.0
+
+---
+
+<a id="english"></a>
+
+## English
+
+**Declarative workflow assets, synchronization, and runtime tooling for AI coding harnesses such as Codex CLI and Claude Code.**
+
+[Route reset article (Chinese)](https://wanglushan.cn/blog/intentdna-route-reset-from-platform-to-workflow-cli) | [Historical Online dashboard](https://online-plum-one.vercel.app)
+
+IntentDNA describes repeatable AI work methods as versioned `.dna.yaml` assets and provides deterministic validation, compilation, synchronization, runtime, and evidence tooling. A workflow can define steps, roles, permissions, handoffs, checkpoints, retries, and verifiers before being synchronized into a local harness.
+
+### What It Solves
+
+AI coding workflows often remain scattered across prompts, conversations, personal experience, and temporary scripts. IntentDNA turns those methods into reviewable engineering assets:
+
+- define fit, inputs, outputs, roles, steps, and boundaries in YAML;
+- validate structure, references, permissions, and workflow constraints deterministically;
+- synchronize Codex Skills, Claude agents/skills/hooks, and other harness assets;
+- support durable runs, parallel steps, checkpoints, reviews, retries, and recovery;
+- package, sign, and verify local runtime evidence;
+- refine candidates from real skills and source while retaining provenance and license data.
+
+The authority model is:
+
+```text
+.dna.yaml asset = workflow definition
+dna validate / compile / sync = deterministic toolchain
+Codex CLI / Claude Code / provider = execution environment
+local run records and verifiers = completion evidence
+Online = historical dashboard and optional projection, not runtime
+```
+
+IntentDNA does not rebuild the generic model loop, make Online or Supabase the authority for local execution, or accept a model's completion claim as a substitute for verification.
+
+### Install
 
 ```bash
-dna cloud credential-check --json
-dna cloud contract-check --json
-dna cloud edge-check --json
-dna cloud deploy-plan --json
+npm install --global intentdna@latest
+dna --version
 ```
 
-Supabase is auth, persistence, storage, transport, and audit. It is not runtime governance authority. Cloud receipts must keep `runtime_authority=false`. Service role keys, secret key JSON, token pepper, Supabase access tokens, user JWTs, raw CLI API tokens, and token hashes must never be browser-facing product inputs or committed examples.
+The Claude Code plugin is released at the same version as the npm package:
 
-## Quickstart
+```bash
+claude plugin marketplace add lushan1314/intentdna-repo
+claude plugin install intentdna@intentdna
+```
 
-The current local quickstart is maintained in [docs/quickstart.md](docs/quickstart.md).
+### Use An Existing Workflow
 
-Short version:
+Inspect built-in assets, then initialize and synchronize one inside the target project:
 
 ```bash
-dna quickstart --asset flutter-rewrite --sync-target codex
 dna templates list
 dna templates show flutter-rewrite
+dna quickstart --asset flutter-rewrite --sync-target codex
+
 dna init --template flutter-rewrite
 dna sync --codex --dry-run
 dna sync --codex
-# run in Codex CLI or Claude Code
-dna report package --json
-dna report sign --json
-dna report verify <envelope-path> --json
 ```
 
-Optional cloud upload is credential-gated and happens only after the signed local envelope verifies:
+`dna quickstart` only prints guidance. `dna sync --dry-run` previews file changes. `dna sync` writes harness assets but does not execute the workflow.
+
+Use the generated Skill, agent, or workflow entry point from Codex CLI or Claude Code. Inspect synchronization state with:
+
+```bash
+dna sync status
+dna sync doctor
+```
+
+### Author A Workflow
+
+IntentDNA separates probabilistic intent interpretation from deterministic validation. An external agent interviews the human and authors YAML; `dna` emits the complete authoring contract and validates the result; the human decides whether the candidate is saved and adopted.
+
+Generate an authoring packet:
+
+```bash
+dna workflow authoring-packet "describe the repeated work method" \
+  --project-dir /path/to/project \
+  --json
+```
+
+The packet includes field constraints, red lines, real examples, interview questions, the validation loop, and handoff boundaries. It does not call a model or create YAML.
+
+Have the external agent write the candidate to:
+
+```text
+.dna/authoring/<asset>.candidate.dna.yaml
+```
+
+A workflow asset normally describes metadata, fit, inputs and outputs, roles and permissions, steps and dependencies, handoffs, checkpoints, retries, boundaries, evidence, and lineage.
+
+Validate and revise it:
+
+```bash
+dna validate .dna/authoring/<asset>.candidate.dna.yaml
+```
+
+After explicit human confirmation, save the same YAML under `.dna/templates/<asset>.dna.yaml`, then inspect it and preview synchronization:
 
 ```bash
-dna cloud credential-check --json
-dna cloud deploy-plan --json
-dna report upload <envelope-path> --json
+dna assets show <asset> --project-dir /path/to/project
+dna assets inspect <asset> --project-dir /path/to/project
+dna sync --project-dir /path/to/project --dry-run
+dna sync --project-dir /path/to/project --codex --dry-run
 ```
 
-## Core Boundaries
+Saving, adopting, and synchronizing are separate human decisions. Successful validation does not mean the asset has been adopted or executed.
 
-- Local `dna` and `dna-hook` remain runtime truth.
-- Online never executes workflows and never performs `allow`, `warn`, `block`, or `validate`.
-- `dna sync` installs, distributes, and injects artifacts; it does not execute workflows.
-- Marketplace distributes workflow assets and install plans; it does not approve, install, or execute them.
-- Supabase persists identity, reports, receipts, storage refs, and audit events; it does not enforce runtime policy.
-- Browser-local imports and Online demo states are projection only until trusted upload verifies them.
-- MCP is hidden transport, not a product page or auth surface.
-- `org_private` must not appear in the static marketplace catalog before SaaS auth/RLS/storage/permission/audit gates exist.
+### Runtime And Evidence
 
-## Evidence Model
+Workflows can execute in the synchronized harness or through the IntentDNA Controller. Use the installed CLI help as the command authority:
 
-IntentDNA separates evidence from authority:
+```bash
+dna run --help
+dna run status <run-id>
+dna run inspect <run-id>
+dna run resume <run-id>
+```
 
-| Evidence | Meaning |
-| --- | --- |
-| Local report package | Runtime evidence gathered locally from harness and verifier outputs |
-| Signed envelope | Local package hash/signature can be checked before upload |
-| Local org review receipt | Manager review and publication readiness handoff; not cloud membership proof |
-| Cloud ingest receipt | Trusted upload evidence after Supabase function/storage/audit accepts it |
-| Online projection | Human-readable status and lifecycle view; not runtime truth |
+After a real run, package, sign, and verify local evidence:
 
-Trusted cloud ingestion may increase persistence and visibility, but it does not move runtime authority away from local `dna-hook` and local runtime evidence.
+```bash
+dna report package --json
+dna report sign --package .dna/reports/latest-report-package.json \
+  --output .dna/reports/ingest/local-envelope.json \
+  --json
+dna report verify .dna/reports/ingest/local-envelope.json --json
+```
 
-## Documentation Map
+Cloud upload is optional and credential-gated. Uploading evidence does not move runtime authority away from the local workflow.
 
-- [docs/README.md](docs/README.md) - living docs map and two-state documentation rule.
-- [docs/quickstart.md](docs/quickstart.md) - local developer quickstart.
-- [docs/foundation-runtime.md](docs/foundation-runtime.md) - durable `dna run` Controller, lifecycle, handoff, isolation, and recovery guide.
-- [docs/product/milestone-review-protocol.md](docs/product/milestone-review-protocol.md) - lightweight P-stage review protocol.
-- [docs/product/online-product-spec.md](docs/product/online-product-spec.md) - Online IA, K5 boundary, forbidden copy, and acceptance.
-- [docs/decisions/ADR-001-product-reset.md](docs/decisions/ADR-001-product-reset.md) - product reset decision record.
-- [spec/README.md](spec/README.md) - retained technical spec index.
-- [docs/archive/2026H1/INDEX.md](docs/archive/2026H1/INDEX.md) - archived references, insights, historical specs, runbooks, and one-time materials.
+### Included Workflow Categories
 
-## Current Maturity
+The repository includes assets for Flutter rewrites and repair reviews, code review, TDD, QA, debugging, migrations, release evidence, parallel subagents, multi-role handoffs, durable execution, research improvement, workflow authoring, asset refinement, secure development, incident response, and organization baselines.
 
-- Local foundation: active.
-- Template marketplace: active for public/personal assets; `internal_ready` is a review candidate state.
-- Org-private marketplace: SaaS-gated; requires Supabase auth/RLS/storage/permissions/audit and live tests.
-- Online console: projection/workbench/readiness surface; not workflow runtime.
-- Public release, npm publish, and production SaaS claims require fresh build/test/deploy evidence before being claimed.
+Run `dna templates list` for the complete catalog in the installed version.
 
-## License
+### Route Reset And History
+
+IntentDNA previously led with cross-harness abstraction, organization governance, a marketplace, and an Online control plane. Those experiments demonstrated engineering feasibility, but platform-first development is not the chosen starting point for the next phase of task-specific automation.
+
+The rationale is documented in [IntentDNA Route Reset: From Platform to Workflow CLI](https://wanglushan.cn/blog/intentdna-route-reset-from-platform-to-workflow-cli).
+
+The [IntentDNA Online dashboard](https://online-plum-one.vercel.app) remains available as historical product evidence. It demonstrates the earlier asset selection, setup guidance, and evidence projection work; it does not execute workflows.
+
+Current documentation and historical evidence follow a two-state model: a small living set describes the implementation, while dated, indexed files under `docs/archive/` preserve route history. Local session state, temporary prompts, runtime logs, and IDE workspace data are excluded from version control.
+
+### Documentation
+
+- [Quickstart](docs/quickstart.md)
+- [Workflow asset format](docs/architecture/c1-asset-format.md)
+- [Workflow authoring packet](docs/architecture/c3-authoring-packet.md)
+- [Controller and worker runtime](docs/architecture/controller-worker-runtime.md)
+- [Workflow runtime manifest](docs/architecture/workflow-runtime-manifest.md)
+- [Local evidence capture](docs/architecture/c5-evidence-capture.md)
+- [Product reset ADR](docs/decisions/ADR-001-product-reset.md)
+- [Documentation and archive index](docs/README.md)
+
+### License
 
 Apache-2.0

package/dist/cli/commands/run-lifecycle.d.ts

@@ -1,30 +1,42 @@
-import type { JsonValue, RunId, TaskState } from "../../runtime/run-contracts.js";
-import type { RunController } from "../../runtime/run-controller.js";
-import type { DurableRunStore, RunRecord, RunStatus, RunStoreSnapshot } from "../../runtime/run-store.js";
-export type RunLifecycleAction = "start" | "status" | "inspect" | "resume" | "cancel";
+import type { CanonicalActivationState, JsonValue, RunId, TaskState } from "../../runtime/run-contracts.js";
+import type { RunAuditView, RunView } from "../../runtime/canonical-run-service.js";
+import { type DurableRunStore, type RunRecord, type RunStatus, type RunStoreSnapshot } from "../../runtime/run-store.js";
+export type RunLifecycleAction = "start" | "status" | "inspect" | "resume" | "cancel" | "close";
 interface LifecycleOutputOptions {
     readonly json?: boolean;
 }
-export interface RunLifecycleStartOptions extends LifecycleOutputOptions {
-    readonly controller: RunController;
-    readonly run: RunRecord;
-}
 export interface RunLifecycleStatusOptions extends LifecycleOutputOptions {
     readonly run_store: DurableRunStore;
     readonly run_id: RunId;
+    readonly service?: CanonicalLifecycleService;
+    readonly service_factory?: () => Promise<CanonicalLifecycleService>;
 }
 export interface RunLifecycleInspectOptions extends LifecycleOutputOptions {
     readonly run_store: DurableRunStore;
     readonly run_id: RunId;
+    readonly service?: CanonicalLifecycleService;
+    readonly service_factory?: () => Promise<CanonicalLifecycleService>;
 }
 export interface RunLifecycleResumeOptions extends LifecycleOutputOptions {
-    readonly controller: RunController;
+    readonly run_store: DurableRunStore;
     readonly run_id: RunId;
+    readonly service?: CanonicalLifecycleService;
+    readonly service_factory?: () => Promise<CanonicalLifecycleService>;
+    readonly drive?: (service: CanonicalLifecycleService, run_id: RunId) => Promise<RunView>;
 }
 export interface RunLifecycleCancelOptions extends LifecycleOutputOptions {
-    readonly controller: RunController;
+    readonly run_store: DurableRunStore;
     readonly run_id: RunId;
     readonly reason?: string | null;
+    readonly service?: CanonicalLifecycleService;
+    readonly service_factory?: () => Promise<CanonicalLifecycleService>;
+}
+export type RunLifecycleCloseOptions = RunLifecycleCancelOptions;
+export interface CanonicalLifecycleService {
+    inspect(run_id: RunId): Promise<RunView>;
+    inspectAudit(run_id: RunId): Promise<RunAuditView>;
+    resume(run_id: RunId): Promise<RunView>;
+    cancel(run_id: RunId, reason?: string | null): Promise<RunView>;
 }
 export interface RunStatusProjection {
     readonly schema_version: "intentdna.run_status.v1";
@@ -41,6 +53,24 @@ export interface RunStatusProjection {
     readonly created_at: string;
     readonly updated_at: string;
 }
+export interface CanonicalRunStatusProjection {
+    readonly schema_version: "intentdna.run_status.v2";
+    readonly ledger_schema_version: 2;
+    readonly run_id: RunId;
+    readonly target: RunView["run"]["target"];
+    readonly plan_id: string;
+    readonly binding_id: string;
+    readonly status: RunStatus;
+    readonly record_version: number;
+    readonly activation_counts: Readonly<Record<CanonicalActivationState, number>>;
+    readonly attempt_count: number;
+    readonly result_count: number;
+    readonly cancellation: RunView["run"]["cancellation"];
+    readonly terminal: RunView["run"]["terminal"];
+    readonly created_at: string;
+    readonly updated_at: string;
+}
+export type AnyRunStatusProjection = RunStatusProjection | CanonicalRunStatusProjection;
 export interface DurableHandoffInspection {
     readonly event_id: string;
     readonly sequence: number;
@@ -65,9 +95,29 @@ export interface RunInspectionProjection {
     readonly ledger_created_at: string;
     readonly ledger_updated_at: string;
 }
-export declare function runLifecycleStart(options: RunLifecycleStartOptions): Promise<number>;
+export interface CanonicalRunInspectionProjection {
+    readonly schema_version: "intentdna.run_inspection.v2";
+    readonly ledger_schema_version: 2;
+    readonly record_version: number;
+    readonly run: RunAuditView["run"];
+    readonly activations: RunAuditView["activations"];
+    readonly attempts: RunAuditView["attempts"];
+    readonly claims: RunAuditView["claims"];
+    readonly events: RunAuditView["events"];
+    readonly result_refs: RunAuditView["results"];
+    readonly ledger_created_at: string;
+    readonly ledger_updated_at: string;
+}
+interface LifecycleOperationProjection {
+    readonly schema_version: "intentdna.run_lifecycle_operation.v1";
+    readonly action: Exclude<RunLifecycleAction, "status" | "inspect">;
+    readonly status: AnyRunStatusProjection;
+}
+export declare function canonicalViewStatusProjection(view: RunView): CanonicalRunStatusProjection;
+export declare function writeCanonicalOperation(action: LifecycleOperationProjection["action"], view: RunView, json: boolean): void;
 export declare function runLifecycleStatus(options: RunLifecycleStatusOptions): Promise<number>;
 export declare function runLifecycleInspect(options: RunLifecycleInspectOptions): Promise<number>;
 export declare function runLifecycleResume(options: RunLifecycleResumeOptions): Promise<number>;
 export declare function runLifecycleCancel(options: RunLifecycleCancelOptions): Promise<number>;
+export declare function runLifecycleClose(options: RunLifecycleCloseOptions): Promise<number>;
 export {};