intentdna 1.9.0-rc.2 → 1.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +134 -124
- package/package.json +1 -1
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
{
|
|
10
10
|
"name": "intentdna",
|
|
11
11
|
"description": "Declarative policy layer for AI agent behavior with plugin-managed hook runtime for Claude Code.",
|
|
12
|
-
"version": "1.9.0
|
|
12
|
+
"version": "1.9.0",
|
|
13
13
|
"author": {
|
|
14
14
|
"name": "Samuel"
|
|
15
15
|
},
|
|
@@ -25,5 +25,5 @@
|
|
|
25
25
|
]
|
|
26
26
|
}
|
|
27
27
|
],
|
|
28
|
-
"version": "1.9.0
|
|
28
|
+
"version": "1.9.0"
|
|
29
29
|
}
|
package/README.md
CHANGED
|
@@ -1,58 +1,44 @@
|
|
|
1
1
|
# IntentDNA
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
**把真实、重复、可验证的 AI 工作方法，做成可独立运行的工作流 CLI。**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[English](#english) | [路线转换文章](https://wanglushan.cn/blog/intentdna-route-reset-from-platform-to-workflow-cli) | [历史 Online 看板](https://online-plum-one.vercel.app)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## 当前路线
|
|
8
|
+
|
|
9
|
+
IntentDNA 的目标没有变：让个人和团队完成工作的专业方法能够被复用、验证、分发和持续改进。改变的是交付顺序。
|
|
10
|
+
|
|
11
|
+
过去我们优先建设跨 Harness 声明、编译器、Adapter、Hooks、资产市场、组织治理和 Online 控制面。工程证明了这些机制可以成立，但没有证明团队应先采用一套平台。现在的路线是：
|
|
8
12
|
|
|
9
13
|
```text
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
14
|
+
真实研发任务
|
|
15
|
+
-> 专用工作流 CLI
|
|
16
|
+
-> 真实使用、测试与评估
|
|
17
|
+
-> 一批有效的工作流资产
|
|
18
|
+
-> 从已经出现的重复问题中提炼公共协议和治理能力
|
|
13
19
|
```
|
|
14
20
|
|
|
15
|
-
IntentDNA
|
|
21
|
+
因此，IntentDNA 现在是一个 **workflow CLI foundation**，而不是通用 Agent 平台、统一工作流 DSL 或 SaaS 执行器。优先级是先结束一个具体任务，再考虑跨工具抽象。
|
|
22
|
+
|
|
23
|
+
完整背景见《[IntentDNA 路线重置：从平台优先到工作流 CLI](https://wanglushan.cn/blog/intentdna-route-reset-from-platform-to-workflow-cli)》。此前的 [IntentDNA Online 看板](https://online-plum-one.vercel.app) 作为历史产品证据继续保留；它展示了资产选择、安装指引和证据投影，但不是当前运行时，也不执行工作流。
|
|
16
24
|
|
|
17
|
-
##
|
|
25
|
+
## 安装
|
|
18
26
|
|
|
19
27
|
```bash
|
|
20
|
-
npm install --global intentdna@
|
|
28
|
+
npm install --global intentdna@latest
|
|
21
29
|
dna --version
|
|
22
30
|
```
|
|
23
31
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
## Product Shape
|
|
27
|
-
|
|
28
|
-
IntentDNA has three connected products:
|
|
29
|
-
|
|
30
|
-
| Surface | What it owns | What it must not become |
|
|
31
|
-
| --- | --- | --- |
|
|
32
|
-
| Local npm foundation | `dna`, `dna-hook`, compiler, adapters, sync, reports, local runtime evidence | A thin demo wrapper or optional afterthought |
|
|
33
|
-
| Workflow asset marketplace | Public, personal, `internal_ready`, and later SaaS-backed `org_private` workflow assets | Runtime execution, approval, or policy authority |
|
|
34
|
-
| Online/SaaS console | Accounts, organization evidence, receipts, audit, publication lifecycle, readiness projection | A workflow runner or `allow` / `warn` / `block` / `validate` engine |
|
|
32
|
+
Claude Code 用户还可以安装随 npm 同版本发布的插件：
|
|
35
33
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
dogfood evidence
|
|
40
|
-
-> workflow asset
|
|
41
|
-
-> marketplace listing
|
|
42
|
-
-> local install/sync
|
|
43
|
-
-> harness execution
|
|
44
|
-
-> local runtime evidence
|
|
45
|
-
-> signed report upload
|
|
46
|
-
-> cloud receipt/audit
|
|
47
|
-
-> manager review
|
|
48
|
-
-> asset improvement
|
|
34
|
+
```bash
|
|
35
|
+
claude plugin marketplace add lushan1314/intentdna-repo
|
|
36
|
+
claude plugin install intentdna@intentdna
|
|
49
37
|
```
|
|
50
38
|
|
|
51
|
-
##
|
|
39
|
+
## 快速开始
|
|
52
40
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
Use this when you want one governed workflow running locally without waiting for cloud setup:
|
|
41
|
+
从一个真实任务和一个现有资产开始：
|
|
56
42
|
|
|
57
43
|
```bash
|
|
58
44
|
dna quickstart --asset flutter-rewrite --sync-target codex
|
|
@@ -61,75 +47,106 @@ dna templates show flutter-rewrite
|
|
|
61
47
|
dna init --template flutter-rewrite
|
|
62
48
|
dna sync --codex --dry-run
|
|
63
49
|
dna sync --codex
|
|
64
|
-
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
在 Codex CLI 或 Claude Code 中运行同步后的工作流。执行后可在本地打包、签名并验证证据：
|
|
53
|
+
|
|
54
|
+
```bash
|
|
65
55
|
dna report package --json
|
|
66
56
|
dna report sign --json
|
|
67
57
|
dna report verify <envelope-path> --json
|
|
68
58
|
```
|
|
69
59
|
|
|
70
|
-
`dna quickstart`
|
|
60
|
+
`dna quickstart` 只打印指引；`dna sync` 只安装和同步资产。真正的执行、权限判断和验证仍发生在本地项目与所选 Harness 中。
|
|
71
61
|
|
|
72
|
-
|
|
62
|
+
## 能力边界
|
|
73
63
|
|
|
74
|
-
|
|
64
|
+
IntentDNA 当前保留并继续验证这些能力：
|
|
75
65
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
66
|
+
- 将任务边界、输入输出、工具、人工确认点和验证器封装为版本化工作流资产；
|
|
67
|
+
- 把资产同步到 Codex CLI 和 Claude Code 等执行环境；
|
|
68
|
+
- 用 Controller、检查点、审查和恢复机制完成可持续运行；
|
|
69
|
+
- 记录本地运行事实，签名并验证证据；
|
|
70
|
+
- 从真实 Skills、脚本和源码中提炼候选资产，并保留来源和许可证信息。
|
|
71
|
+
|
|
72
|
+
IntentDNA 不做这些事情：
|
|
73
|
+
|
|
74
|
+
- 不重造通用模型循环或 Agent runtime；
|
|
75
|
+
- 不要求所有工作流先进入统一 DSL；
|
|
76
|
+
- 不把 Online、市场或 Supabase 当作本地运行权限的来源；
|
|
77
|
+
- 不用模型的“已完成”声明替代确定性验证。
|
|
78
|
+
|
|
79
|
+
## Online 与历史资产
|
|
80
|
+
|
|
81
|
+
当前权威关系是：
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
本地 workflow CLI / dna = 运行事实
|
|
85
|
+
Harness = 实际执行环境
|
|
86
|
+
Online = 历史看板与可选的资产/证据投影
|
|
87
|
+
archive = 路线演进证据，不是当前产品承诺
|
|
81
88
|
```
|
|
82
89
|
|
|
83
|
-
|
|
90
|
+
仓库只保留两类文档：少量当前权威文档，以及带日期和索引的历史档案。会话状态、临时提示词、执行日志、IDE workspace 和 `.omx/.omc/.claude/.codex` 运行期文件不进入版本控制。
|
|
84
91
|
|
|
85
|
-
|
|
92
|
+
## 文档
|
|
86
93
|
|
|
87
|
-
|
|
94
|
+
- [快速开始](docs/quickstart.md)
|
|
95
|
+
- [工作流运行时清单](docs/architecture/workflow-runtime-manifest.md)
|
|
96
|
+
- [产品重置 ADR](docs/decisions/ADR-001-product-reset.md)
|
|
97
|
+
- [历史档案索引](docs/archive/2026H1/INDEX.md)
|
|
98
|
+
- [2026 H2 路线分享](docs/archive/2026H2/sharing/2026-08-01-build-your-workflow-cli.md)
|
|
99
|
+
- [v1.9.0 发布说明](docs/archive/2026H2/release-notes/v1.9.0.md)
|
|
88
100
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
101
|
+
## License
|
|
102
|
+
|
|
103
|
+
Apache-2.0
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
<a id="english"></a>
|
|
108
|
+
|
|
109
|
+
## English
|
|
110
|
+
|
|
111
|
+
**Turn real, repeated, verifiable AI work methods into independently executable workflow CLIs.**
|
|
112
|
+
|
|
113
|
+
[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)
|
|
114
|
+
|
|
115
|
+
### Current Direction
|
|
116
|
+
|
|
117
|
+
IntentDNA still exists to make professional work methods reusable, testable, distributable, and improvable. What changed is the delivery order.
|
|
118
|
+
|
|
119
|
+
The project previously led with cross-harness declarations, a compiler, adapters, hooks, a marketplace, organization governance, and an Online control plane. That work proved the mechanisms could be built, but it did not prove that teams should adopt a platform first. The current route is:
|
|
120
|
+
|
|
121
|
+
```text
|
|
122
|
+
real engineering task
|
|
123
|
+
-> task-specific workflow CLI
|
|
124
|
+
-> real use, tests, and evaluation
|
|
125
|
+
-> a portfolio of useful workflow assets
|
|
126
|
+
-> shared protocols and governance extracted from observed repetition
|
|
111
127
|
```
|
|
112
128
|
|
|
113
|
-
|
|
129
|
+
IntentDNA is therefore a **workflow CLI foundation**, not a generic agent platform, universal workflow DSL, or SaaS executor. Finish one concrete task first; abstract across tools only when real repetition justifies it.
|
|
114
130
|
|
|
115
|
-
|
|
131
|
+
The full 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 previous [IntentDNA Online dashboard](https://online-plum-one.vercel.app) remains available as historical product evidence. It demonstrates asset selection, setup guidance, and evidence projection, but it is not the current runtime and does not execute workflows.
|
|
116
132
|
|
|
117
|
-
|
|
133
|
+
### Install
|
|
118
134
|
|
|
119
135
|
```bash
|
|
120
|
-
|
|
121
|
-
dna
|
|
122
|
-
dna cloud edge-check --json
|
|
123
|
-
dna cloud deploy-plan --json
|
|
136
|
+
npm install --global intentdna@latest
|
|
137
|
+
dna --version
|
|
124
138
|
```
|
|
125
139
|
|
|
126
|
-
|
|
140
|
+
Claude Code users can install the plugin released at the same version as npm:
|
|
127
141
|
|
|
128
|
-
|
|
142
|
+
```bash
|
|
143
|
+
claude plugin marketplace add lushan1314/intentdna-repo
|
|
144
|
+
claude plugin install intentdna@intentdna
|
|
145
|
+
```
|
|
129
146
|
|
|
130
|
-
|
|
147
|
+
### Quick Start
|
|
131
148
|
|
|
132
|
-
|
|
149
|
+
Start with a real task and an existing asset:
|
|
133
150
|
|
|
134
151
|
```bash
|
|
135
152
|
dna quickstart --asset flutter-rewrite --sync-target codex
|
|
@@ -138,64 +155,57 @@ dna templates show flutter-rewrite
|
|
|
138
155
|
dna init --template flutter-rewrite
|
|
139
156
|
dna sync --codex --dry-run
|
|
140
157
|
dna sync --codex
|
|
141
|
-
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
Run the synced workflow in Codex CLI or Claude Code. Then package, sign, and verify local evidence:
|
|
161
|
+
|
|
162
|
+
```bash
|
|
142
163
|
dna report package --json
|
|
143
164
|
dna report sign --json
|
|
144
165
|
dna report verify <envelope-path> --json
|
|
145
166
|
```
|
|
146
167
|
|
|
147
|
-
|
|
168
|
+
`dna quickstart` only prints guidance. `dna sync` only installs and synchronizes assets. Execution, permission decisions, and verification remain in the local project and selected harness.
|
|
148
169
|
|
|
149
|
-
|
|
150
|
-
dna cloud credential-check --json
|
|
151
|
-
dna cloud deploy-plan --json
|
|
152
|
-
dna report upload <envelope-path> --json
|
|
153
|
-
```
|
|
170
|
+
### Boundaries
|
|
154
171
|
|
|
155
|
-
|
|
172
|
+
IntentDNA continues to validate these capabilities:
|
|
156
173
|
|
|
157
|
-
-
|
|
158
|
-
-
|
|
159
|
-
-
|
|
160
|
-
-
|
|
161
|
-
-
|
|
162
|
-
- Browser-local imports and Online demo states are projection only until trusted upload verifies them.
|
|
163
|
-
- MCP is hidden transport, not a product page or auth surface.
|
|
164
|
-
- `org_private` must not appear in the static marketplace catalog before SaaS auth/RLS/storage/permission/audit gates exist.
|
|
174
|
+
- package task boundaries, inputs, outputs, tools, human gates, and verifiers as versioned workflow assets;
|
|
175
|
+
- synchronize assets into execution environments such as Codex CLI and Claude Code;
|
|
176
|
+
- support durable runs with controllers, checkpoints, reviews, and recovery;
|
|
177
|
+
- capture local run facts and produce signed, verifiable evidence;
|
|
178
|
+
- refine candidate assets from real skills, scripts, and source while retaining provenance and license data.
|
|
165
179
|
|
|
166
|
-
|
|
180
|
+
IntentDNA does not:
|
|
167
181
|
|
|
168
|
-
|
|
182
|
+
- rebuild the generic model loop or agent runtime;
|
|
183
|
+
- require every workflow to enter a universal DSL first;
|
|
184
|
+
- make Online, a marketplace, or Supabase the authority for local execution;
|
|
185
|
+
- accept a model's completion claim as a substitute for deterministic verification.
|
|
169
186
|
|
|
170
|
-
|
|
171
|
-
| --- | --- |
|
|
172
|
-
| Local report package | Runtime evidence gathered locally from harness and verifier outputs |
|
|
173
|
-
| Signed envelope | Local package hash/signature can be checked before upload |
|
|
174
|
-
| Local org review receipt | Manager review and publication readiness handoff; not cloud membership proof |
|
|
175
|
-
| Cloud ingest receipt | Trusted upload evidence after Supabase function/storage/audit accepts it |
|
|
176
|
-
| Online projection | Human-readable status and lifecycle view; not runtime truth |
|
|
187
|
+
### Online And History
|
|
177
188
|
|
|
178
|
-
|
|
189
|
+
The current authority model is:
|
|
179
190
|
|
|
180
|
-
|
|
191
|
+
```text
|
|
192
|
+
local workflow CLI / dna = runtime truth
|
|
193
|
+
harness = execution environment
|
|
194
|
+
Online = historical dashboard and optional asset/evidence projection
|
|
195
|
+
archive = route-evolution evidence, not current product commitment
|
|
196
|
+
```
|
|
181
197
|
|
|
182
|
-
|
|
183
|
-
- [docs/quickstart.md](docs/quickstart.md) - local developer quickstart.
|
|
184
|
-
- [docs/foundation-runtime.md](docs/foundation-runtime.md) - durable `dna run` Controller, lifecycle, handoff, isolation, and recovery guide.
|
|
185
|
-
- [docs/product/milestone-review-protocol.md](docs/product/milestone-review-protocol.md) - lightweight P-stage review protocol.
|
|
186
|
-
- [docs/product/online-product-spec.md](docs/product/online-product-spec.md) - Online IA, K5 boundary, forbidden copy, and acceptance.
|
|
187
|
-
- [docs/decisions/ADR-001-product-reset.md](docs/decisions/ADR-001-product-reset.md) - product reset decision record.
|
|
188
|
-
- [spec/README.md](spec/README.md) - retained technical spec index.
|
|
189
|
-
- [docs/archive/2026H1/INDEX.md](docs/archive/2026H1/INDEX.md) - archived references, insights, historical specs, runbooks, and one-time materials.
|
|
198
|
+
The repository keeps only a small living documentation set and dated, indexed historical archives. Session state, temporary prompts, execution logs, IDE workspace data, and runtime files under `.omx/.omc/.claude/.codex` do not belong in version control.
|
|
190
199
|
|
|
191
|
-
|
|
200
|
+
### Documentation
|
|
192
201
|
|
|
193
|
-
-
|
|
194
|
-
-
|
|
195
|
-
-
|
|
196
|
-
-
|
|
197
|
-
-
|
|
202
|
+
- [Quickstart](docs/quickstart.md)
|
|
203
|
+
- [Workflow runtime manifest](docs/architecture/workflow-runtime-manifest.md)
|
|
204
|
+
- [Product reset ADR](docs/decisions/ADR-001-product-reset.md)
|
|
205
|
+
- [Historical archive index](docs/archive/2026H1/INDEX.md)
|
|
206
|
+
- [2026 H2 route-sharing note](docs/archive/2026H2/sharing/2026-08-01-build-your-workflow-cli.md)
|
|
207
|
+
- [v1.9.0 release notes](docs/archive/2026H2/release-notes/v1.9.0.md)
|
|
198
208
|
|
|
199
|
-
|
|
209
|
+
### License
|
|
200
210
|
|
|
201
211
|
Apache-2.0
|