@wairon/cli 5.1.1-dev.102 → 5.1.1-dev.104
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/README.md +18 -12
- package/dist/cli/index.js +3420 -1650
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +786 -342
- package/dist/index.js +2575 -1110
- package/dist/index.js.map +1 -1
- package/dist/templates/skills/sdd-architect.md +3 -1
- package/dist/templates/skills/sdd-delegate.md +1 -1
- package/dist/templates/skills/sdd-implement.md +3 -1
- package/docs/architecture.md +83 -0
- package/docs/cli.md +814 -0
- package/docs/design-export.md +308 -0
- package/docs/extending-wairon.md +615 -0
- package/docs/requirements.md +65 -0
- package/docs/roadmap.md +133 -0
- package/docs/standards/INDEX.md +23 -0
- package/docs/standards/architecture.md +953 -0
- package/docs/standards/language-bindings.md +120 -0
- package/docs/templates.md +61 -0
- package/docs/vision.md +59 -0
- package/docs/wairon-feature-requests-hosted-mcp.md +74 -0
- package/package.json +4 -2
package/README.md
CHANGED
|
@@ -176,8 +176,14 @@ wairon lock # records the approval in .wai/lock.json
|
|
|
176
176
|
git add .wai && git commit -m "Approve the design"
|
|
177
177
|
|
|
178
178
|
# 3. Gate: in CI, check that what merges is the approved design
|
|
179
|
-
# (or use the reusable workflow — see docs/cli.md
|
|
180
|
-
|
|
179
|
+
# (or use the reusable workflow with strict: true — see docs/cli.md).
|
|
180
|
+
# --strict also fails when .wai/lock.json is missing or a member project was
|
|
181
|
+
# never approved; plain lock-check only fails an approval that no longer matches.
|
|
182
|
+
wairon lock-check --strict
|
|
183
|
+
wairon validate --ci # the conformance gate; externals are judged against their pins
|
|
184
|
+
# Optional: gate on the LIVE producers of your externals as well
|
|
185
|
+
# (exit 1 when one is incompatible, 2 when one could not be compared).
|
|
186
|
+
wairon externals status
|
|
181
187
|
|
|
182
188
|
# 4. Implement: your AI tool delegates each component with the sdd-delegate
|
|
183
189
|
# skill, from its live brief (sdd_get_agent_brief).
|
|
@@ -213,11 +219,11 @@ See [docs/cli.md](docs/cli.md). Summary:
|
|
|
213
219
|
| `wairon rules list` | The conformance rule registry (the architecture linter) |
|
|
214
220
|
| `wairon pack init \| build \| install \| use \| unuse \| impact \| sync \| bundle \| which \| list \| add \| remove` | Extension packs: injected profiles, language tables, and rules |
|
|
215
221
|
| `wairon member …` / `wairon subsystem externalize` / `wairon project rename` | Members (parts and projects) and the family migrations |
|
|
216
|
-
| `wairon externals pin \| status \| list` |
|
|
222
|
+
| `wairon externals add \| pin \| status \| list` | Declare, pin and check the externals a project consumes (`status` is the opt-in live gate) |
|
|
217
223
|
| `wairon domains list \| scan \| add \| remove` | Domains (subsystem-derived + free-standing) |
|
|
218
224
|
| `wairon skills list \| install` | Manage the SDD skills installed into your tools |
|
|
219
225
|
| `wairon lock [-y]` | Validate the design as complete and record its approval in `.wai/lock.json`, code findings beside it; no spec file is rewritten |
|
|
220
|
-
| `wairon lock-check [--strict]` | Merge gate: is the design in this tree the design that was approved? Importable as a [reusable workflow](.github/workflows/lock-check.yml) |
|
|
226
|
+
| `wairon lock-check [--strict]` | Merge gate: is the design in this tree the design that was approved? Importable as a [reusable workflow](https://github.com/SYW-Apps/Waffle-AIron/blob/main/.github/workflows/lock-check.yml) |
|
|
221
227
|
| `wairon mcp serve \| install \| status` | The wairon MCP server (`sdd_*` tools) |
|
|
222
228
|
| `wairon serve [--port] [--data-dir] [--no-auth]` | Self-host: HTTP MCP for many isolated projects + admin plane |
|
|
223
229
|
| `wairon host unit \| project \| permission \| key \| lock \| doctor \| packs \| git \| producer \| secret \| demo` | Administer the hosting server (units, projects, permissions, keys, the state-scoped lock) |
|
|
@@ -235,13 +241,13 @@ See [docs/cli.md](docs/cli.md). Summary:
|
|
|
235
241
|
- [Vision](docs/vision.md) — long-term direction
|
|
236
242
|
- [CLI Reference](docs/cli.md) — all commands and MCP tools
|
|
237
243
|
- [Design export](docs/design-export.md) — the `wairon export` JSON format for generators and translators
|
|
238
|
-
- [Supervisor doctrine](docs/design/supervisor-doctrine.md) — how Supervisors and Actors may depend on data and effects
|
|
239
|
-
- [Hosted server](docs/design/hosted-mcp-server.md) — self-host wairon over HTTP (Docker, auth, sizing)
|
|
240
|
-
- [Pack scoping](docs/design/pack-scoping.md) — the pack store, per-project selection, and reproducibility (design)
|
|
241
|
-
- [Connecting-agent entrypoint](docs/design/connecting-agent-entrypoint.md) — MCP `instructions`, prompts, and skill composition
|
|
242
|
-
- [Execution budgets](docs/design/execution-budgets.md) — what each agent's work costs to do, derived alongside what it owns (design)
|
|
243
|
-
- [Approval baselines](docs/design/approval-baseline.md) — what `lock` approves, and why it stopped rewriting your spec tree (design)
|
|
244
|
-
- [Extending wairon](docs/extending-wairon.md) — extension packs & wrapper products (with a [working example](examples/wrapper/))
|
|
244
|
+
- [Supervisor doctrine](https://github.com/SYW-Apps/Waffle-AIron/blob/main/docs/design/supervisor-doctrine.md) — how Supervisors and Actors may depend on data and effects
|
|
245
|
+
- [Hosted server](https://github.com/SYW-Apps/Waffle-AIron/blob/main/docs/design/hosted-mcp-server.md) — self-host wairon over HTTP (Docker, auth, sizing)
|
|
246
|
+
- [Pack scoping](https://github.com/SYW-Apps/Waffle-AIron/blob/main/docs/design/pack-scoping.md) — the pack store, per-project selection, and reproducibility (design)
|
|
247
|
+
- [Connecting-agent entrypoint](https://github.com/SYW-Apps/Waffle-AIron/blob/main/docs/design/connecting-agent-entrypoint.md) — MCP `instructions`, prompts, and skill composition
|
|
248
|
+
- [Execution budgets](https://github.com/SYW-Apps/Waffle-AIron/blob/main/docs/design/execution-budgets.md) — what each agent's work costs to do, derived alongside what it owns (design)
|
|
249
|
+
- [Approval baselines](https://github.com/SYW-Apps/Waffle-AIron/blob/main/docs/design/approval-baseline.md) — what `lock` approves, and why it stopped rewriting your spec tree (design)
|
|
250
|
+
- [Extending wairon](docs/extending-wairon.md) — extension packs & wrapper products (with a [working example](https://github.com/SYW-Apps/Waffle-AIron/blob/main/examples/wrapper/))
|
|
245
251
|
- [Templates](docs/templates.md) — agent rendering templates
|
|
246
252
|
- [Standards](docs/standards/INDEX.md) — the architecture standards the SDD model is built on
|
|
247
253
|
|
|
@@ -259,7 +265,7 @@ validation), js-yaml, the MCP SDK, and Vitest. Bundled with tsup.
|
|
|
259
265
|
Actively developed. For bugs or questions, open an issue.
|
|
260
266
|
|
|
261
267
|
Working on this repo (or delegating work in it) — see
|
|
262
|
-
[CONTRIBUTING.md](CONTRIBUTING.md) for what this checkout does differently: line
|
|
268
|
+
[CONTRIBUTING.md](https://github.com/SYW-Apps/Waffle-AIron/blob/main/CONTRIBUTING.md) for what this checkout does differently: line
|
|
263
269
|
endings, the gate commands and their baselines, and the stale-MCP-server tell.
|
|
264
270
|
The conventions that hold for *any* wairon project ship in the `sdd-implement`
|
|
265
271
|
and `sdd-delegate` skills.
|