create-agdf 0.9.1 → 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.
Files changed (24) hide show
  1. package/README.md +22 -3
  2. package/bin/create-agdf.js +2 -3333
  3. package/generated/.agdf/control/templates/MASTER_BACKLOG.md +3 -3
  4. package/generated/plugins/agdf/.codex-plugin/plugin.json +1 -1
  5. package/generated/plugins/agdf/control/templates/MASTER_BACKLOG.md +3 -3
  6. package/generated/plugins/agdf/meta/agdf-plugin.definition.json +1 -1
  7. package/lib/cli/application.js +191 -0
  8. package/lib/cli/command-registry.js +101 -0
  9. package/lib/cli/delivery-path-search-command.js +75 -0
  10. package/lib/cli/parse-args.js +142 -0
  11. package/lib/cli/runtime-context.js +83 -0
  12. package/lib/control-evaluation/delivery-map.js +291 -0
  13. package/lib/control-evaluation/doctor.js +265 -0
  14. package/lib/control-evaluation/gate-check.js +404 -0
  15. package/lib/control-evaluation/gate-policy.js +283 -0
  16. package/lib/control-evaluation/run-state.js +217 -0
  17. package/lib/control-evaluation/shared.js +344 -0
  18. package/lib/control-evaluation/verified-change.js +156 -0
  19. package/lib/installers/opencode.js +419 -0
  20. package/lib/installers/plugin-installers.js +70 -0
  21. package/lib/scaffold/plan.js +278 -0
  22. package/lib/scaffold/presentation.js +74 -0
  23. package/lib/scaffold/write.js +45 -0
  24. package/package.json +3 -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
- ## Full command reference
29
+ ## Command overview
30
30
 
31
- The commands below are the complete package reference. The Quick Start above is the recommended entry point; these commands cover the remaining surfaces, repository-local variants and validation paths.
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 <de|en>` or `--lang <de|en>` persist the preferred AGDF artefact and chat 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