@wazir-dev/cli 1.0.0

package/templates/examples/accepted-learning.example.json

@@ -0,0 +1,14 @@
+{
+  "phase": "learn",
+  "role": "learner",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:55:00Z",
+  "sources": [
+    "artifacts/run-2026-03-11/review.json"
+  ],
+  "status": "accepted",
+  "loop_number": 1,
+  "scope": "cleanup-execution",
+  "confidence": 0.91,
+  "review_date": "2026-03-11"
+}

package/templates/examples/author.example.json

@@ -0,0 +1,152 @@
+{
+  "phase": "author",
+  "role": "author",
+  "run_id": "run-2026-03-14-user-settings",
+  "created_at": "2026-03-14T10:00:00Z",
+  "sources": [
+    "artifacts/run-2026-03-14/spec.json"
+  ],
+  "status": "complete",
+  "loop_number": 1,
+  "microcopy": [
+    {
+      "key": "settings.title",
+      "text": "Settings",
+      "context": "Page heading for the user settings screen.",
+      "max_length": 30
+    },
+    {
+      "key": "settings.save_button",
+      "text": "Save changes",
+      "context": "Primary action button at the bottom of the settings form.",
+      "max_length": 20
+    },
+    {
+      "key": "settings.cancel_button",
+      "text": "Cancel",
+      "context": "Secondary action to discard unsaved changes.",
+      "max_length": 15
+    },
+    {
+      "key": "settings.unsaved_warning",
+      "text": "You have unsaved changes. Are you sure you want to leave?",
+      "context": "Confirmation dialog shown when navigating away with pending edits."
+    }
+  ],
+  "i18n_keys": [
+    {
+      "key": "settings.title",
+      "en": "Settings",
+      "description": "Page title for user settings."
+    },
+    {
+      "key": "settings.profile_section",
+      "en": "Profile",
+      "description": "Section heading for profile-related settings."
+    },
+    {
+      "key": "settings.notifications_section",
+      "en": "Notifications",
+      "description": "Section heading for notification preferences."
+    },
+    {
+      "key": "settings.save_success",
+      "en": "Your settings have been saved.",
+      "description": "Toast message after successful save."
+    }
+  ],
+  "seed_data": [
+    {
+      "entity": "notification_preference",
+      "records": [
+        { "key": "email_digest", "label": "Email digest", "default_enabled": true },
+        { "key": "push_alerts", "label": "Push alerts", "default_enabled": false },
+        { "key": "weekly_summary", "label": "Weekly summary", "default_enabled": true }
+      ]
+    },
+    {
+      "entity": "timezone",
+      "records": [
+        { "value": "UTC", "label": "UTC (Coordinated Universal Time)" },
+        { "value": "America/New_York", "label": "Eastern Time (US & Canada)" },
+        { "value": "Europe/London", "label": "London (GMT/BST)" }
+      ]
+    }
+  ],
+  "terminology": [
+    {
+      "term": "settings",
+      "definition": "User-configurable preferences that control application behavior.",
+      "avoid": ["preferences", "options", "configuration"]
+    },
+    {
+      "term": "profile",
+      "definition": "The subset of settings related to the user's identity and display name.",
+      "avoid": ["account details", "user info"]
+    },
+    {
+      "term": "notification preference",
+      "definition": "A toggleable channel through which the user can receive alerts.",
+      "avoid": ["notification setting", "alert config"]
+    }
+  ],
+  "asset_metadata": [
+    {
+      "asset": "icons/settings-gear.svg",
+      "alt_text": "Settings",
+      "purpose": "Navigation icon for the settings page."
+    },
+    {
+      "asset": "icons/profile-avatar-placeholder.svg",
+      "alt_text": "Default profile picture",
+      "purpose": "Placeholder shown when the user has not uploaded an avatar."
+    }
+  ],
+  "state_coverage": {
+    "empty": "No settings configured yet. Update your profile to get started.",
+    "loading": "Loading your settings...",
+    "error": "We could not load your settings. Please try again.",
+    "success": "Your settings have been saved.",
+    "partial": "Some settings could not be saved. Review the highlighted fields."
+  },
+  "notifications": [
+    {
+      "trigger": "settings_saved",
+      "message": "Your settings have been saved.",
+      "channel": "toast"
+    },
+    {
+      "trigger": "settings_save_failed",
+      "message": "We could not save your settings. Please try again.",
+      "channel": "toast"
+    },
+    {
+      "trigger": "email_changed",
+      "message": "A verification link has been sent to your new email address.",
+      "channel": "toast"
+    }
+  ],
+  "editorial_constraints": {
+    "tone": "Helpful and straightforward",
+    "voice": "Second person (you/your)",
+    "reading_level": "Grade 8",
+    "banned_words": ["please note", "kindly", "click here", "obviously"]
+  },
+  "coverage_matrix": [
+    {
+      "screen": "settings/profile",
+      "states_covered": ["empty", "loading", "error", "success"],
+      "notes": "Profile photo upload has its own loading state."
+    },
+    {
+      "screen": "settings/notifications",
+      "states_covered": ["loading", "error", "success"],
+      "notes": "Empty state not applicable; defaults are always present via seed data."
+    },
+    {
+      "screen": "settings/unsaved-dialog",
+      "states_covered": ["partial"],
+      "notes": "Modal shown only when navigating away with pending changes."
+    }
+  ]
+}

package/templates/examples/clarification.example.json

@@ -0,0 +1,15 @@
+{
+  "phase": "clarify",
+  "role": "clarifier",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:00:00Z",
+  "sources": [
+    "input/brief.md"
+  ],
+  "status": "complete",
+  "loop_number": 0,
+  "questions": [
+    "Which host should be treated as the primary export target?"
+  ],
+  "scope_summary": "Verify canonical scaffolding and resolve structural drift in ordered batches."
+}

package/templates/examples/docs-claim.example.json

@@ -0,0 +1,8 @@
+{
+  "id": "install-codex-cli",
+  "file": "docs/install.md",
+  "claim_type": "command",
+  "subject": "wazir export --host codex",
+  "verifier": "wazir export --help",
+  "required": true
+}

package/templates/examples/export-manifest.example.json

@@ -0,0 +1,7 @@
+{
+  "host": "claude",
+  "source_hashes": {
+    "wazir.manifest.yaml": "abc123",
+    "roles/clarifier.md": "def456"
+  }
+}

package/templates/examples/host-export-package.example.json

@@ -0,0 +1,11 @@
+{
+  "host": "claude",
+  "sources": [
+    "wazir.manifest.yaml",
+    "roles/clarifier.md"
+  ],
+  "files": [
+    "CLAUDE.md",
+    ".claude/settings.json"
+  ]
+}

package/templates/examples/implementation-plan.example.json

@@ -0,0 +1,17 @@
+{
+  "phase": "plan",
+  "role": "planner",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:30:00Z",
+  "sources": [
+    "artifacts/run-2026-03-11/spec.json"
+  ],
+  "status": "approved",
+  "loop_number": 1,
+  "sections": [
+    "Execution controls",
+    "Canonical skeleton",
+    "Manifest and schemas"
+  ],
+  "approval": "approved-by-operator"
+}

package/templates/examples/proposed-learning.example.json

@@ -0,0 +1,13 @@
+{
+  "phase": "learn",
+  "role": "learner",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:50:00Z",
+  "sources": [
+    "artifacts/run-2026-03-11/review.json"
+  ],
+  "status": "proposed",
+  "loop_number": 0,
+  "scope": "cleanup-planning",
+  "confidence": 0.82
+}

package/templates/examples/research.example.json

@@ -0,0 +1,15 @@
+{
+  "phase": "discover",
+  "role": "researcher",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:10:00Z",
+  "sources": [
+    "docs/research/2026-03-11-open-source-best-practices-and-anti-patterns.md"
+  ],
+  "status": "complete",
+  "loop_number": 1,
+  "findings": [
+    "Outdated documentation must be treated as a release blocker.",
+    "Generated host exports need deterministic drift checks in CI."
+  ]
+}

package/templates/examples/research.example.md

@@ -0,0 +1,6 @@
+# Research Example
+
+- Phase: discover
+- Role: researcher
+- Source: docs/research/example-source.md
+- Finding: Example research findings should cite their source and stay phase-scoped.

package/templates/examples/review.example.json

@@ -0,0 +1,17 @@
+{
+  "phase": "review",
+  "role": "reviewer",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:45:00Z",
+  "sources": [
+    "artifacts/run-2026-03-11/verification-proof.json"
+  ],
+  "status": "complete",
+  "loop_number": 1,
+  "findings": [
+    {
+      "severity": "medium",
+      "title": "Generated host exports must be regenerated after manifest changes."
+    }
+  ]
+}

package/templates/examples/run-manifest.example.json

@@ -0,0 +1,9 @@
+{
+  "run_id": "run-2026-03-11-example",
+  "project_root": "/repo",
+  "created_at": "2026-03-11T12:00:00Z",
+  "status": "created",
+  "sources": [
+    "input/brief.md"
+  ]
+}

package/templates/examples/spec-challenge.example.json

@@ -0,0 +1,14 @@
+{
+  "phase": "spec_challenge",
+  "role": "reviewer",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:25:00Z",
+  "sources": [
+    "artifacts/run-2026-03-11/spec.json"
+  ],
+  "status": "complete",
+  "loop_number": 1,
+  "findings": [
+    "The spec must define archive behavior explicitly so deletions stay reproducible."
+  ]
+}

package/templates/examples/spec.example.json

@@ -0,0 +1,21 @@
+{
+  "phase": "specify",
+  "role": "specifier",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:20:00Z",
+  "sources": [
+    "input/brief.md",
+    "artifacts/run-2026-03-11/clarification.json"
+  ],
+  "status": "approved",
+  "loop_number": 1,
+  "requirements": [
+    "Keep Wazir host-native with no long-running processes or control plane.",
+    "Use one canonical source of truth with generated host exports."
+  ],
+  "acceptance_criteria": [
+    "Canonical docs, roles, workflows, and exports stay consistent across supported hosts.",
+    "Inactive runtime surfaces are not described as active product behavior."
+  ],
+  "approval": "approved-by-operator"
+}

package/templates/examples/verification-proof.example.json

@@ -0,0 +1,21 @@
+{
+  "phase": "verify",
+  "role": "verifier",
+  "run_id": "run-2026-03-11-example",
+  "created_at": "2026-03-11T12:40:00Z",
+  "sources": [
+    "artifacts/run-2026-03-11/implementation-plan.json"
+  ],
+  "status": "pass",
+  "loop_number": 0,
+  "commands": [
+    {
+      "command": "npm test",
+      "exit_code": 0
+    },
+    {
+      "command": "node tooling/src/cli.js validate manifest",
+      "exit_code": 0
+    }
+  ]
+}

package/templates/examples/wazir-manifest.example.yaml

@@ -0,0 +1,65 @@
+manifest_version: 2
+project:
+  name: wazir-example
+  display_name: Wazir Example
+  version: 0.1.0
+  description: Example canonical manifest for schema validation.
+  license: MIT
+versioning_policy:
+  strategy: semver
+  stability: pre-1.0-alpha
+  compatibility: additive_changes_only_until_manifest_bump
+paths:
+  input: input
+  artifacts_repo: artifacts
+  roles: roles
+  workflows: workflows
+  skills: skills
+  hooks: hooks
+  templates: templates
+  schemas: schemas
+  expertise: expertise
+  docs: docs
+  exports: exports
+  tooling: tooling
+  memory: memory
+  examples: examples
+  state_root_default: ~/.wazir/projects/{project_slug}
+hosts:
+  - claude
+  - codex
+workflows:
+  - clarify
+  - plan
+  - execute
+phases:
+  - clarify
+  - plan
+  - execute
+roles:
+  - clarifier
+  - planner
+  - executor
+export_targets:
+  - claude
+  - codex
+required_hooks:
+  - session_start
+protected_paths:
+  - input
+  - exports/hosts
+prohibited_terms:
+  - agent-os
+adapters:
+  context_mode:
+    enabled_by_default: false
+    required: false
+    install_mode: external
+    package_presence: optional
+index:
+  core_parsers:
+    - builtin-heuristic-markdown
+  optional_language_plugins: []
+validation_checks:
+  - docs-truth
+  - export-drift

package/templates/task-definition-schema.md

@@ -0,0 +1,99 @@
+# Task Definition Schema
+
+Canonical reference for the YAML front-matter block prepended to each `tasks/clarified/task-NN/spec.md` file. The clarifier produces this block in Phase 8.
+
+## task_definition
+
+| Field | Type | Required | Valid Values | Description |
+|-------|------|----------|-------------|-------------|
+| `id` | string | yes | `"task-NN"` | Unique task identifier |
+| `title` | string | yes | — | Short imperative title |
+| `type` | string | yes | `feature`, `bugfix`, `refactor`, `config`, `docs` | Task category |
+| `platforms` | list | yes | auto-detected | Target platforms from `files_touched` and project scan |
+| `languages` | list | yes | auto-detected | Languages from file extensions in `files_touched` |
+| `files_touched` | list | yes | glob patterns | Paths affected by this task |
+| `complexity` | string | yes | `low`, `medium`, `high` | From Phase 5 assessment |
+| `test_types` | list | yes* | `unit`, `widget`, `integration`, `e2e` | From tagged test sub-tasks. *Empty allowed if `type == docs` |
+| `security_critical` | boolean | yes | `true`, `false` | True if auth, payments, PII, or crypto |
+| `needs_research` | boolean | yes | `true`, `false` | True if research briefs were referenced |
+| `research_topics` | list | yes* | topic identifiers | From matched research briefs. *Non-empty when `needs_research == true` |
+| `acceptance_criteria_count` | integer | yes | — | Must match actual AC count in spec body |
+| `sub_task_count` | integer | yes | — | Must match actual sub-task count in spec body |
+| `model_tier` | string | yes | `opus`, `codex`, `pro`, `flash` | Auto-assigned from tier rules |
+| `required_roles` | list | yes | `executor`, `reviewer`, `verifier` | Per-task roles the orchestrator dispatches |
+
+### required_roles
+
+Controls which roles the orchestrator dispatches for this task. Only per-task roles are valid — upstream roles (clarifier, researcher, specifier, planner) and downstream roles (learner) are batch-level and not included.
+
+**Constraints:**
+- `verifier` must always be present (mandatory QA safety gate)
+- If `security_critical: true`, `reviewer` must be present
+- Default when absent: `[executor, reviewer, verifier]` (all per-task roles)
+
+**Auto-detection rules (first match wins per role inclusion):**
+
+| Task type | Required roles | Rationale |
+|-----------|---------------|-----------|
+| `feature` | `[executor, reviewer, verifier]` | Full pipeline |
+| `bugfix` | `[executor, reviewer, verifier]` | Full pipeline |
+| `refactor` | `[executor, reviewer, verifier]` | Full pipeline |
+| `docs` | `[executor, verifier]` | No adversarial review needed |
+| `config` | `[executor, verifier]` | No adversarial review needed |
+
+If `security_critical: true`, `reviewer` is added regardless of type.
+
+### model_tier
+
+Auto-assigned by the clarifier. First matching rule wins:
+
+| Condition | Tier |
+|-----------|------|
+| `security_critical == true` | `opus` |
+| `complexity == high` | `codex` |
+| `complexity == medium` | `pro` |
+| `complexity == low` and `type == docs` | `flash` |
+| `complexity == low` | `pro` |
+
+The clarifier may override with a comment explaining why.
+
+## composition
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `stack` | list | yes | Technology stacks from `expertise/composition-map.yaml` |
+| `concerns` | list | yes | Cross-cutting concerns from `expertise/composition-map.yaml` |
+
+Populated in Phase 9. Used by the orchestrator's composition engine to resolve expertise modules per role.
+
+## Example
+
+```yaml
+---
+task_definition:
+  id: "task-01"
+  title: "Add user authentication endpoint"
+  type: feature
+  platforms: [node]
+  languages: [typescript]
+  files_touched:
+    - "src/auth/**"
+    - "test/auth/**"
+  complexity: medium
+  test_types: [unit, integration]
+  security_critical: true
+  needs_research: false
+  research_topics: []
+  acceptance_criteria_count: 5
+  sub_task_count: 4
+  model_tier: opus
+  required_roles:
+    - executor
+    - reviewer
+    - verifier
+
+composition:
+  stack: [node]
+  concerns: [security-auth]
+---
+```

package/tooling/README.md

@@ -0,0 +1,20 @@
+# tooling/
+
+This directory holds the minimal local glue that supports the host-native Wazir kit.
+
+Allowed:
+
+- export compiler
+- validators
+- capture/status/doctor commands
+- index and recall tooling
+
+Not allowed:
+
+- long-running servers
+- dashboards
+- runtime control planes
+
+Rules:
+
+- Tooling must stay small, auditable, and justified by the operating model.

package/tooling/src/adapters/context-mode.js

@@ -0,0 +1,50 @@
+export function isEnabled(config) {
+  if (process.env.WAZIR_DISABLE_CONTEXT_MODE === '1') {
+    return false;
+  }
+
+  if (!config || typeof config !== 'object') {
+    return false;
+  }
+
+  return config.context_mode?.enabled === true;
+}
+
+export function bridgeResearcherFetch(config, url, source) {
+  if (!isEnabled(config)) {
+    return null;
+  }
+
+  return {
+    tool: 'mcp__plugin_context-mode_context-mode__fetch_and_index',
+    args: { url, source },
+  };
+}
+
+export function bridgeFileRead(config, filePath, intent) {
+  if (!isEnabled(config)) {
+    return null;
+  }
+
+  return {
+    tool: 'mcp__plugin_context-mode_context-mode__execute_file',
+    args: {
+      path: filePath,
+      language: 'shell',
+      code: 'cat "$FILE_CONTENT_PATH"',
+      intent,
+    },
+  };
+}
+
+export function collectStats(config) {
+  if (!isEnabled(config)) {
+    return null;
+  }
+
+  return {
+    should_collect: true,
+    tool: 'mcp__plugin_context-mode_context-mode__stats',
+    args: {},
+  };
+}