@wazir-dev/cli 1.1.0 → 1.3.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/CHANGELOG.md +74 -10
- package/README.md +15 -15
- package/assets/demo.cast +47 -0
- package/assets/demo.gif +0 -0
- package/docs/anti-patterns/AP-23-skipping-enabled-workflows.md +28 -0
- package/docs/anti-patterns/AP-24-clarifier-deciding-scope.md +34 -0
- package/docs/concepts/architecture.md +1 -1
- package/docs/concepts/roles-and-workflows.md +2 -0
- package/docs/concepts/why-wazir.md +59 -0
- package/docs/decisions/2026-03-19-deferred-items.md +564 -0
- package/docs/decisions/2026-03-19-enhancement-decisions.md +300 -0
- package/docs/readmes/INDEX.md +21 -5
- package/docs/readmes/features/expertise/README.md +2 -2
- package/docs/readmes/features/exports/README.md +2 -2
- package/docs/readmes/features/hooks/pre-compact-summary.md +1 -1
- package/docs/readmes/features/schemas/README.md +3 -0
- package/docs/readmes/features/skills/README.md +17 -0
- package/docs/readmes/features/skills/clarifier.md +5 -0
- package/docs/readmes/features/skills/claude-cli.md +5 -0
- package/docs/readmes/features/skills/codex-cli.md +5 -0
- package/docs/readmes/features/skills/dispatching-parallel-agents.md +5 -0
- package/docs/readmes/features/skills/executing-plans.md +5 -0
- package/docs/readmes/features/skills/executor.md +5 -0
- package/docs/readmes/features/skills/finishing-a-development-branch.md +5 -0
- package/docs/readmes/features/skills/gemini-cli.md +5 -0
- package/docs/readmes/features/skills/humanize.md +5 -0
- package/docs/readmes/features/skills/init-pipeline.md +5 -0
- package/docs/readmes/features/skills/receiving-code-review.md +5 -0
- package/docs/readmes/features/skills/requesting-code-review.md +5 -0
- package/docs/readmes/features/skills/reviewer.md +5 -0
- package/docs/readmes/features/skills/subagent-driven-development.md +5 -0
- package/docs/readmes/features/skills/using-git-worktrees.md +5 -0
- package/docs/readmes/features/skills/wazir.md +5 -0
- package/docs/readmes/features/skills/writing-skills.md +5 -0
- package/docs/readmes/features/workflows/prepare-next.md +1 -1
- package/docs/reference/configuration-reference.md +47 -6
- package/docs/reference/hooks.md +1 -0
- package/docs/reference/launch-checklist.md +4 -4
- package/docs/reference/review-loop-pattern.md +119 -9
- package/docs/reference/roles-reference.md +1 -0
- package/docs/reference/skill-tiers.md +147 -0
- package/docs/reference/tooling-cli.md +3 -1
- package/docs/truth-claims.yaml +12 -0
- package/expertise/antipatterns/process/ai-coding-antipatterns.md +214 -1
- package/exports/hosts/claude/.claude/commands/plan-review.md +3 -1
- package/exports/hosts/claude/.claude/commands/verify.md +30 -1
- package/exports/hosts/claude/.claude/settings.json +9 -0
- package/exports/hosts/claude/CLAUDE.md +1 -1
- package/exports/hosts/claude/export.manifest.json +6 -4
- package/exports/hosts/claude/host-package.json +3 -1
- package/exports/hosts/codex/AGENTS.md +1 -1
- package/exports/hosts/codex/export.manifest.json +6 -4
- package/exports/hosts/codex/host-package.json +3 -1
- package/exports/hosts/cursor/.cursor/hooks.json +4 -0
- package/exports/hosts/cursor/.cursor/rules/wazir-core.mdc +1 -1
- package/exports/hosts/cursor/export.manifest.json +6 -4
- package/exports/hosts/cursor/host-package.json +3 -1
- package/exports/hosts/gemini/GEMINI.md +1 -1
- package/exports/hosts/gemini/export.manifest.json +6 -4
- package/exports/hosts/gemini/host-package.json +3 -1
- package/hooks/context-mode-router +191 -0
- package/hooks/definitions/context_mode_router.yaml +19 -0
- package/hooks/hooks.json +31 -6
- package/hooks/protected-path-write-guard +8 -0
- package/hooks/routing-matrix.json +45 -0
- package/hooks/session-start +62 -1
- package/llms-full.txt +937 -134
- package/package.json +2 -4
- package/schemas/hook.schema.json +2 -1
- package/schemas/phase-report.schema.json +89 -0
- package/schemas/usage.schema.json +25 -1
- package/schemas/wazir-manifest.schema.json +19 -0
- package/skills/brainstorming/SKILL.md +32 -157
- package/skills/clarifier/SKILL.md +289 -111
- package/skills/claude-cli/SKILL.md +320 -0
- package/skills/codex-cli/SKILL.md +260 -0
- package/skills/debugging/SKILL.md +13 -0
- package/skills/design/SKILL.md +13 -0
- package/skills/dispatching-parallel-agents/SKILL.md +13 -0
- package/skills/executing-plans/SKILL.md +13 -0
- package/skills/executor/SKILL.md +139 -19
- package/skills/finishing-a-development-branch/SKILL.md +13 -0
- package/skills/gemini-cli/SKILL.md +260 -0
- package/skills/humanize/SKILL.md +13 -0
- package/skills/init-pipeline/SKILL.md +72 -164
- package/skills/prepare-next/SKILL.md +81 -10
- package/skills/receiving-code-review/SKILL.md +13 -0
- package/skills/requesting-code-review/SKILL.md +13 -0
- package/skills/reviewer/SKILL.md +369 -24
- package/skills/run-audit/SKILL.md +13 -0
- package/skills/scan-project/SKILL.md +13 -0
- package/skills/self-audit/SKILL.md +217 -16
- package/skills/skill-research/SKILL.md +188 -0
- package/skills/subagent-driven-development/SKILL.md +13 -0
- package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +2 -0
- package/skills/subagent-driven-development/implementer-prompt.md +8 -0
- package/skills/subagent-driven-development/spec-reviewer-prompt.md +7 -0
- package/skills/tdd/SKILL.md +13 -0
- package/skills/using-git-worktrees/SKILL.md +13 -0
- package/skills/using-skills/SKILL.md +13 -0
- package/skills/verification/SKILL.md +54 -3
- package/skills/wazir/SKILL.md +464 -381
- package/skills/writing-plans/SKILL.md +14 -1
- package/skills/writing-skills/SKILL.md +13 -0
- package/templates/artifacts/implementation-plan.md +3 -0
- package/templates/artifacts/tasks-template.md +133 -0
- package/templates/examples/phase-report.example.json +48 -0
- package/tooling/src/adapters/composition-engine.js +256 -0
- package/tooling/src/adapters/model-router.js +84 -0
- package/tooling/src/capture/command.js +41 -2
- package/tooling/src/capture/run-config.js +3 -1
- package/tooling/src/capture/store.js +56 -0
- package/tooling/src/capture/usage.js +106 -0
- package/tooling/src/capture/user-input.js +66 -0
- package/tooling/src/checks/ac-matrix.js +256 -0
- package/tooling/src/checks/command-registry.js +12 -0
- package/tooling/src/checks/docs-truth.js +1 -1
- package/tooling/src/checks/security-sensitivity.js +69 -0
- package/tooling/src/checks/skills.js +111 -0
- package/tooling/src/cli.js +31 -20
- package/tooling/src/commands/stats.js +161 -0
- package/tooling/src/commands/validate.js +5 -1
- package/tooling/src/export/compiler.js +33 -37
- package/tooling/src/gating/agent.js +145 -0
- package/tooling/src/guards/phase-prerequisite-guard.js +185 -0
- package/tooling/src/hooks/routing-logic.js +69 -0
- package/tooling/src/init/auto-detect.js +258 -0
- package/tooling/src/init/command.js +38 -170
- package/tooling/src/input/scanner.js +46 -0
- package/tooling/src/reports/command.js +103 -0
- package/tooling/src/reports/phase-report.js +323 -0
- package/tooling/src/state/command.js +160 -0
- package/tooling/src/state/db.js +287 -0
- package/tooling/src/status/command.js +58 -1
- package/tooling/src/verify/proof-collector.js +299 -0
- package/wazir.manifest.yaml +26 -14
- package/workflows/plan-review.md +3 -1
- package/workflows/verify.md +30 -1
package/wazir.manifest.yaml
CHANGED
|
@@ -47,20 +47,31 @@ workflows:
|
|
|
47
47
|
- prepare_next
|
|
48
48
|
- run_audit
|
|
49
49
|
phases:
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
50
|
+
- init
|
|
51
|
+
- clarifier
|
|
52
|
+
- executor
|
|
53
|
+
- final_review
|
|
54
|
+
phase_prerequisites:
|
|
55
|
+
init: {}
|
|
56
|
+
clarifier: {}
|
|
57
|
+
executor:
|
|
58
|
+
required_artifacts:
|
|
59
|
+
- clarified/clarification.md
|
|
60
|
+
- clarified/spec-hardened.md
|
|
61
|
+
- clarified/design.md
|
|
62
|
+
- clarified/execution-plan.md
|
|
63
|
+
required_phase_exits:
|
|
64
|
+
- clarifier
|
|
65
|
+
final_review:
|
|
66
|
+
required_artifacts:
|
|
67
|
+
- clarified/clarification.md
|
|
68
|
+
- clarified/spec-hardened.md
|
|
69
|
+
- clarified/design.md
|
|
70
|
+
- clarified/execution-plan.md
|
|
71
|
+
- artifacts/verification-proof.md
|
|
72
|
+
required_phase_exits:
|
|
73
|
+
- clarifier
|
|
74
|
+
- executor
|
|
64
75
|
roles:
|
|
65
76
|
- clarifier
|
|
66
77
|
- researcher
|
|
@@ -85,6 +96,7 @@ required_hooks:
|
|
|
85
96
|
- stop_handoff_harvest
|
|
86
97
|
- protected_path_write_guard
|
|
87
98
|
- loop_cap_guard
|
|
99
|
+
- context_mode_router
|
|
88
100
|
protected_paths:
|
|
89
101
|
- input
|
|
90
102
|
- roles
|
package/workflows/plan-review.md
CHANGED
|
@@ -39,7 +39,9 @@ On completing this phase, run:
|
|
|
39
39
|
|
|
40
40
|
## Loop Structure
|
|
41
41
|
|
|
42
|
-
Follows the review loop pattern in `docs/reference/review-loop-pattern.md` with plan dimensions. The planner role resolves findings. Pass count determined by depth. No extension.
|
|
42
|
+
Follows the review loop pattern in `docs/reference/review-loop-pattern.md` with 8 plan dimensions (including Input Coverage). The planner role resolves findings. Pass count determined by depth. No extension.
|
|
43
|
+
|
|
44
|
+
**Input Coverage dimension:** The reviewer reads the original input/briefing, counts distinct items, and compares against tasks in the plan. If `tasks_in_plan < items_in_input`, this is a HIGH finding listing the missing items. This prevents silent scope reduction where 21 input items become 5 tasks.
|
|
43
45
|
|
|
44
46
|
## Failure Conditions
|
|
45
47
|
|
package/workflows/verify.md
CHANGED
|
@@ -14,6 +14,16 @@ On entering this phase, run:
|
|
|
14
14
|
- changed files
|
|
15
15
|
- claimed outcomes
|
|
16
16
|
- acceptance criteria
|
|
17
|
+
- project type (detected via `detectRunnableType(projectRoot)` → web | api | cli | library, from `tooling/src/verify/proof-collector.js`)
|
|
18
|
+
|
|
19
|
+
## Process
|
|
20
|
+
|
|
21
|
+
1. **Detect project type:** Run `detectRunnableType(projectRoot)` to determine verification strategy
|
|
22
|
+
2. **Collect evidence:** Run `collectProof(taskSpec, runConfig)` with the detected type
|
|
23
|
+
3. **For runnable output (web/api/cli):** Run the application and capture runtime evidence (build output, screenshots, curl responses, CLI output)
|
|
24
|
+
4. **For non-runnable output (library/config/skills):** Run lint, format check, type check, and tests — all must pass
|
|
25
|
+
5. **Save evidence:** Write to `.wazir/runs/<id>/artifacts/proof-<task>.json`
|
|
26
|
+
6. **Validate:** Ensure every acceptance criterion has at least one evidence item mapped to it
|
|
17
27
|
|
|
18
28
|
## Primary Role
|
|
19
29
|
|
|
@@ -21,7 +31,11 @@ On entering this phase, run:
|
|
|
21
31
|
|
|
22
32
|
## Outputs
|
|
23
33
|
|
|
24
|
-
- verification proof artifact
|
|
34
|
+
- verification proof artifact (produced by `collectProof` from `tooling/src/verify/proof-collector.js`)
|
|
35
|
+
|
|
36
|
+
## Proof Collection
|
|
37
|
+
|
|
38
|
+
Use `detectRunnableType` to classify the project, then `collectProof` to gather evidence. The proof-collector runs type-appropriate commands (build, test, lint, type-check) using `execFileSync` and returns structured `{ type, evidence }`.
|
|
25
39
|
|
|
26
40
|
## Approval Gate
|
|
27
41
|
|
|
@@ -32,6 +46,19 @@ On entering this phase, run:
|
|
|
32
46
|
On completing this phase, run:
|
|
33
47
|
`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
|
|
34
48
|
|
|
49
|
+
## Proof of Implementation
|
|
50
|
+
|
|
51
|
+
The verifier detects whether the project output is runnable and collects appropriate evidence:
|
|
52
|
+
|
|
53
|
+
| Project Type | Detection | Evidence Collected |
|
|
54
|
+
|-------------|-----------|-------------------|
|
|
55
|
+
| `web` | next/vite/react-scripts in deps | Build output, Playwright screenshot (if available), curl response |
|
|
56
|
+
| `api` | express/fastify/hono in deps | curl endpoint responses with status codes |
|
|
57
|
+
| `cli` | `bin` field in package.json | `--help` output, test run with sample args |
|
|
58
|
+
| `library` | default (no runnable markers) | npm test, tsc, eslint, prettier — all must pass |
|
|
59
|
+
|
|
60
|
+
Evidence is saved to `.wazir/runs/<id>/artifacts/proof-<task>.json` using `collectProof()` from `tooling/src/verify/proof-collector.js`.
|
|
61
|
+
|
|
35
62
|
## Relationship to Review Loops
|
|
36
63
|
|
|
37
64
|
Verification is invoked per-task during execution, not as a review loop. It produces deterministic proof, not adversarial findings.
|
|
@@ -39,3 +66,5 @@ Verification is invoked per-task during execution, not as a review loop. It prod
|
|
|
39
66
|
## Failure Conditions
|
|
40
67
|
|
|
41
68
|
- stale or partial verification
|
|
69
|
+
- proof-collector reports `status: "fail"` for any evidence item
|
|
70
|
+
- runnable type detected but no evidence collected
|