create-agdf 0.9.0 → 0.9.3
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 +26 -3
- package/bin/create-agdf.js +2 -3333
- package/generated/.agdf/control/templates/MASTER_BACKLOG.md +3 -3
- package/generated/plugins/agdf/.codex-plugin/plugin.json +1 -1
- package/generated/plugins/agdf/control/templates/MASTER_BACKLOG.md +3 -3
- package/generated/plugins/agdf/meta/agdf-plugin.definition.json +1 -1
- package/lib/cli/application.js +191 -0
- package/lib/cli/command-registry.js +101 -0
- package/lib/cli/delivery-path-search-command.js +75 -0
- package/lib/cli/parse-args.js +142 -0
- package/lib/cli/runtime-context.js +83 -0
- package/lib/control-evaluation/delivery-map.js +291 -0
- package/lib/control-evaluation/doctor.js +265 -0
- package/lib/control-evaluation/gate-check.js +404 -0
- package/lib/control-evaluation/gate-policy.js +283 -0
- package/lib/control-evaluation/run-state.js +217 -0
- package/lib/control-evaluation/shared.js +344 -0
- package/lib/control-evaluation/verified-change.js +156 -0
- package/lib/installers/opencode.js +419 -0
- package/lib/installers/plugin-installers.js +70 -0
- package/lib/scaffold/plan.js +278 -0
- package/lib/scaffold/presentation.js +74 -0
- package/lib/scaffold/write.js +45 -0
- package/lib/skill-evals/artefact-quality.js +36 -0
- package/lib/skill-evals/index.js +105 -0
- package/lib/skill-evals/live-recorder.js +108 -0
- package/lib/skill-evals/workspace.js +97 -0
- package/package.json +7 -2
package/README.md
CHANGED
|
@@ -26,9 +26,9 @@ Use a different target when Codex is not your agent surface:
|
|
|
26
26
|
|
|
27
27
|
For prerequisites, all surface-specific flows and operational boundaries, use the authoritative [installation guide](../INSTALL.md). Do not run `init` merely to ask a fresh question: an agent can first clarify the request and ask for `Approval: UR` when durable control state is needed.
|
|
28
28
|
|
|
29
|
-
##
|
|
29
|
+
## Command overview
|
|
30
30
|
|
|
31
|
-
The
|
|
31
|
+
The Quick Start above is the recommended entry point. For the exact current command and option reference, run `npx --yes @agdf/cli@latest --help`; the groups below explain the supported surfaces, validation paths and canonical run lifecycle.
|
|
32
32
|
|
|
33
33
|
Preferred long-term CLI shape:
|
|
34
34
|
|
|
@@ -46,6 +46,22 @@ npx --yes @agdf/cli@latest gate-check --status-card
|
|
|
46
46
|
npx --yes @agdf/cli@latest gate-check --json
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
+
Operational validation and bounded planning:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
npx --yes @agdf/cli@latest delivery-map --json
|
|
53
|
+
npx --yes @agdf/cli@latest delivery-path-search --surface codex --json
|
|
54
|
+
npx --yes @agdf/cli@latest delivery-path-search --surface claude --json
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Canonical run lifecycle:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
npx --yes @agdf/cli@latest run-create --run <run_id>
|
|
61
|
+
npx --yes @agdf/cli@latest run-migrate [--run <run_id>]
|
|
62
|
+
npx --yes @agdf/cli@latest run-render-legacy --run <run_id>
|
|
63
|
+
```
|
|
64
|
+
|
|
49
65
|
Backward-compatible scaffold usage:
|
|
50
66
|
|
|
51
67
|
```bash
|
|
@@ -61,13 +77,16 @@ npm create agdf@latest -- init
|
|
|
61
77
|
npm create agdf@latest -- config --language en
|
|
62
78
|
npm create agdf@latest -- doctor
|
|
63
79
|
npm create agdf@latest -- gate-check
|
|
80
|
+
npm create agdf@latest -- delivery-map
|
|
81
|
+
npm create agdf@latest -- delivery-path-search --surface codex
|
|
82
|
+
npm create agdf@latest -- delivery-path-search --surface claude
|
|
64
83
|
```
|
|
65
84
|
|
|
66
85
|
Optional flags:
|
|
67
86
|
|
|
68
87
|
- `--dir <path>` write into a specific directory
|
|
69
88
|
- `--force` overwrite existing generated files
|
|
70
|
-
- `--language <
|
|
89
|
+
- `--language <tag>` or `--lang <tag>` persist a BCP 47 language tag such as `de`, `en` or `fr-CA`
|
|
71
90
|
|
|
72
91
|
If no language is provided, `create-agdf` derives the preference from the local system locale (`LC_ALL`, `LC_MESSAGES`, `LANG`, `LANGUAGE` or the Node.js runtime locale) and falls back to `en`.
|
|
73
92
|
|
|
@@ -237,8 +256,12 @@ Non-sensitive feedback, examples and contributions are welcome through [GitHub I
|
|
|
237
256
|
|
|
238
257
|
```bash
|
|
239
258
|
npm --prefix create-agdf run smoke-test
|
|
259
|
+
npm --prefix create-agdf run eval:skills
|
|
260
|
+
npm --prefix create-agdf run eval:skills:record -- --surface codex --case gate-check-normal
|
|
240
261
|
```
|
|
241
262
|
|
|
263
|
+
`eval:skills` is the credential-free deterministic CI lane. The recorder is an explicit supporting-evidence lane; it uses a disposable repository, records live provenance and refuses to persist a failing or mutation-violating result.
|
|
264
|
+
|
|
242
265
|
The repository is licensed under [Apache-2.0](../LICENSE). No separate public `CONTRIBUTING.md`, `SECURITY.md` or private security-reporting channel is currently published. Do not treat a public issue as a private vulnerability disclosure.
|
|
243
266
|
|
|
244
267
|
## Publishing
|