@wazir-dev/cli 1.0.0

package/wazir.manifest.yaml

@@ -0,0 +1,135 @@
+manifest_version: 2
+project:
+  name: wazir
+  display_name: Wazir
+  version: 0.0.0
+  description: Host-native engineering OS kit for disciplined software work inside Claude, Codex, Gemini, and Cursor.
+  license: MIT
+versioning_policy:
+  strategy: semver
+  stability: pre-1.0-alpha
+  compatibility: additive_changes_only_until_manifest_bump
+paths:
+  input: input
+  roles: roles
+  workflows: workflows
+  skills: skills
+  agents: agents
+  hooks: hooks
+  templates: templates
+  schemas: schemas
+  expertise: expertise
+  docs: docs
+  exports: exports
+  tooling: tooling
+  examples: examples
+  memory: memory
+  state_root_default: ~/.wazir/projects/{project_slug}
+hosts:
+  - claude
+  - codex
+  - gemini
+  - cursor
+workflows:
+  - clarify
+  - discover
+  - specify
+  - spec_challenge
+  - author
+  - design
+  - design_review
+  - plan
+  - plan_review
+  - execute
+  - verify
+  - review
+  - learn
+  - prepare_next
+  - run_audit
+phases:
+  - clarify
+  - discover
+  - specify
+  - spec_challenge
+  - author
+  - design
+  - design_review
+  - plan
+  - plan_review
+  - execute
+  - verify
+  - review
+  - learn
+  - prepare_next
+roles:
+  - clarifier
+  - researcher
+  - specifier
+  - content-author
+  - designer
+  - planner
+  - executor
+  - verifier
+  - reviewer
+  - learner
+export_targets:
+  - claude
+  - codex
+  - gemini
+  - cursor
+required_hooks:
+  - session_start
+  - pre_tool_capture_route
+  - post_tool_capture
+  - pre_compact_summary
+  - stop_handoff_harvest
+  - protected_path_write_guard
+  - loop_cap_guard
+protected_paths:
+  - input
+  - roles
+  - workflows
+  - schemas
+  - exports/hosts
+prohibited_terms:
+  - Agent OS
+  - daemon
+  - HTTP control plane
+  - web UI
+  - OpenAI Symphony
+  - Elixir
+adapters:
+  context_mode:
+    enabled_by_default: false
+    required: false
+    install_mode: external
+    package_presence: optional
+  open_pencil:
+    enabled_by_default: false
+    required: false
+    install_mode: external
+    package_presence: optional
+index:
+  core_parsers:
+    - builtin-heuristic-javascript
+    - builtin-heuristic-typescript
+    - builtin-heuristic-python
+    - builtin-heuristic-go
+    - builtin-heuristic-rust
+    - builtin-heuristic-java
+    - builtin-heuristic-sql
+    - builtin-heuristic-json
+    - builtin-heuristic-yaml
+    - builtin-heuristic-markdown
+  optional_language_plugins: []
+validation_checks:
+  - docs-truth
+  - brand-truth
+  - export-drift
+  - artifact-schema
+  - review-loop
+  - verification-proof
+  - docs-required
+  - protected-paths
+  - state-hygiene
+  - runtime-surface

package/workflows/README.md

@@ -0,0 +1,19 @@
+# workflows/
+
+This directory holds canonical phase entrypoints and workflow contracts.
+
+Allowed:
+
+- phase workflows
+- approval gate instructions
+- canonical sequencing rules
+
+Not allowed:
+
+- host-specific command wrappers
+- persisted orchestration state
+
+Rules:
+
+- Keep workflows semantically host-neutral.
+- Export host-native wrappers from canonical workflow content.

package/workflows/author.md

@@ -0,0 +1,42 @@
+# author
+
+## Purpose
+
+Write and package all non-code content artifacts before visual design begins.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- approved spec artifact (post spec-challenge)
+- research artifacts
+- existing locale/glossary sources
+- brand/style guidelines (if available)
+
+## Primary Role
+
+- `content-author`
+
+## Outputs
+
+- author artifact (microcopy, i18n keys, seed data, glossary, asset metadata, state coverage, notification templates, content coverage matrix)
+
+## Approval Gate
+
+Hard — human approval required. Content informs design; errors here cascade downstream.
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- incomplete state coverage
+- missing locale entries
+- placeholder/dummy text
+- untraceable copy (no screen-to-key mapping)
+- layout-breaking copy not flagged

package/workflows/clarify.md

@@ -0,0 +1,38 @@
+# clarify
+
+## Purpose
+
+Convert operator input into clarified scope, explicit questions, and a usable problem frame.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- `input/` briefing files
+- active research where required
+
+## Primary Role
+
+- `clarifier`
+
+## Outputs
+
+- clarification artifact
+- unresolved questions list
+- scope summary
+
+## Approval Gate
+
+- no formal approval gate, but unresolved material ambiguity must be escalated
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- unresolved ambiguity hidden as certainty

package/workflows/design-review.md

@@ -0,0 +1,46 @@
+# design-review
+
+## Purpose
+
+Validate the design artifact and author artifact against the approved spec, checking visual consistency, accessibility, and completeness before planning.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- design artifact
+- author artifact
+- approved spec artifact
+- accessibility guidelines
+
+## Primary Role
+
+- `reviewer`
+
+## Outputs
+
+- design review findings with severity
+- no-findings verdict when applicable
+
+## Approval Gate
+
+- unresolved blocking findings must stop progression to planning
+
+## Gate decision
+
+On approval: `wazir capture event --run <run-id> --event gate_approved --phase <phase-name>`
+On rejection: `wazir capture event --run <run-id> --event gate_rejected --phase <phase-name> --message "<reason>"`
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- vague findings without visual evidence
+- rubber-stamp approval without checking accessibility
+- design drift from spec not flagged

package/workflows/design.md

@@ -0,0 +1,44 @@
+# design
+
+## Purpose
+
+Transform the approved spec into visual designs using open-pencil MCP tools.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- approved spec artifact
+- research artifacts
+- brand/style guidelines (if available)
+- author artifact
+
+## Primary Role
+
+- `designer`
+
+## Outputs
+
+- design artifact (`.fig` + exported code + tokens + screenshots)
+
+## Skip Conditions
+
+- project has no visual design needs
+- open-pencil MCP server is not available (proceed to planning with text-only design specs)
+
+## Approval Gate
+
+- explicit human approval required before design-review
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- design does not address spec requirements
+- missing exported code scaffolds or tokens

package/workflows/discover.md

@@ -0,0 +1,37 @@
+# discover
+
+## Purpose
+
+Gather source-backed research that reduces planning and implementation risk.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- clarified scope
+- explicit research questions
+
+## Primary Role
+
+- `researcher`
+
+## Outputs
+
+- research artifact
+- cited findings
+
+## Approval Gate
+
+- no formal approval gate, but unsupported research cannot flow forward
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- missing citations

package/workflows/execute.md

@@ -0,0 +1,48 @@
+# execute
+
+## Purpose
+
+Implement the approved plan in ordered, verified batches.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Pre-execution validation
+
+Before implementing, run these checks to ensure the repo is in a valid state:
+- `wazir validate manifest` — confirm the manifest schema is still valid
+- `wazir validate hooks` — confirm hook contracts are intact
+
+If either check fails:
+1. Surface the failure to the user
+2. Do NOT proceed with implementation until the issue is resolved
+
+## Inputs
+
+- approved implementation plan
+- current branch state
+- author artifact (i18n keys, seed data, notification templates)
+
+## Primary Role
+
+- `executor`
+
+## Outputs
+
+- code and docs changes
+- execution notes
+
+## Approval Gate
+
+- no new scope without explicit approval
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- plan drift

package/workflows/learn.md

@@ -0,0 +1,38 @@
+# learn
+
+## Purpose
+
+Extract durable scoped learnings and experiments from the completed run.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- run artifacts
+- review findings
+- verification proof
+
+## Primary Role
+
+- `learner`
+
+## Outputs
+
+- proposed learning artifacts
+- experiment summaries
+
+## Approval Gate
+
+- accepted learnings require explicit review and scope tags
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- auto-applied learning drift

package/workflows/plan-review.md

@@ -0,0 +1,42 @@
+# plan-review
+
+## Purpose
+
+Adversarially review the implementation plan before execution starts.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- draft implementation plan
+- approved spec
+
+## Primary Role
+
+- `reviewer`
+
+## Outputs
+
+- plan review findings
+- revised tasks when needed
+
+## Approval Gate
+
+- execution cannot begin until blocking findings are closed or explicitly accepted
+
+## Gate decision
+
+On approval: `wazir capture event --run <run-id> --event gate_approved --phase <phase-name>`
+On rejection: `wazir capture event --run <run-id> --event gate_rejected --phase <phase-name> --message "<reason>"`
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- sequence gaps survive review

package/workflows/plan.md

@@ -0,0 +1,39 @@
+# plan
+
+## Purpose
+
+Translate the approved spec into an execution-grade implementation plan.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- approved spec
+- repo state
+- research artifacts
+- author artifact
+
+## Primary Role
+
+- `planner`
+
+## Outputs
+
+- implementation plan artifact
+- ordered tasks and verification steps
+
+## Approval Gate
+
+- explicit human approval required before execution
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- missing dependencies or unverifiable steps

package/workflows/prepare-next.md

@@ -0,0 +1,37 @@
+# prepare-next
+
+## Purpose
+
+Prepare the next run or next execution slice without silently carrying stale context forward.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- current run summary
+- accepted learnings where explicitly enabled
+
+## Primary Role
+
+- `planner`
+
+## Outputs
+
+- next-step handoff
+- scoped context summary
+
+## Approval Gate
+
+- no implicit carry-forward of unapproved learnings
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- stale context treated as current truth

package/workflows/review.md

@@ -0,0 +1,40 @@
+# review
+
+## Purpose
+
+Run adversarial review against the changed implementation and its evidence.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- changed files
+- verification proof
+- approved spec and plan
+- design artifact (when design phase was used)
+
+## Primary Role
+
+- `reviewer`
+
+## Outputs
+
+- findings
+- no-findings verdict when applicable
+
+## Approval Gate
+
+- unresolved blocking findings must stop completion
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- vague review or uncited findings
+- design-implementation mismatch not flagged (when design artifact exists)

package/workflows/run-audit.md

@@ -0,0 +1,41 @@
+# run-audit
+
+## Purpose
+
+Perform a structured audit on the codebase, branch, or scoped paths and produce source-backed findings with severity, evidence, citations, and remediation.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- audit type (security, code-quality, architecture, performance, dependencies, custom)
+- audit scope (whole-project, branch, paths)
+- output mode (report, plan)
+
+## Primary Role
+
+- `researcher` (composed with audit-specific expertise from `audit-*` concerns)
+
+## Outputs
+
+- structured audit report with artifact metadata (report mode)
+- approved design doc in `docs/plans/` for `wz:writing-plans` handoff (plan mode)
+
+## Approval Gate
+
+- no finding without source-backed evidence (file path, line, snippet, citation)
+- no severity rating without justification
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- superficial findings without verification
+- unsupported claims or missing citations
+- skipping files within declared scope

package/workflows/spec-challenge.md

@@ -0,0 +1,41 @@
+# spec-challenge
+
+## Purpose
+
+Adversarially test the proposed spec for contradictions, omissions, and fake completeness.
+
+## Phase entry
+
+On entering this phase, run:
+`wazir capture event --run <run-id> --event phase_enter --phase <phase-name> --status in_progress`
+
+## Inputs
+
+- draft spec
+- research artifacts
+
+## Primary Role
+
+- `reviewer`
+
+## Outputs
+
+- spec challenge findings
+
+## Approval Gate
+
+- spec cannot be treated as approved until challenge findings are resolved or explicitly accepted
+
+## Gate decision
+
+On approval: `wazir capture event --run <run-id> --event gate_approved --phase <phase-name>`
+On rejection: `wazir capture event --run <run-id> --event gate_rejected --phase <phase-name> --message "<reason>"`
+
+## Phase exit
+
+On completing this phase, run:
+`wazir capture event --run <run-id> --event phase_exit --phase <phase-name> --status completed`
+
+## Failure Conditions
+
+- rubber-stamp review