@wazir-dev/cli 1.0.0

package/exports/hosts/codex/export.manifest.json

@@ -0,0 +1,38 @@
+{
+  "host": "codex",
+  "source_hashes": {
+    "wazir.manifest.yaml": "2a57e262d071283504311ead7daaa8444c0c1895243f048036f79c501dfa4356",
+    "roles/clarifier.md": "1135b98d548937b5009bd77d292ceee29f806acc9cae245e5e18ccb8be05173e",
+    "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
+    "roles/designer.md": "8a0a9846965aa03ac00d0d71cde58f529aa8fb79908a481cb8ca3ff09d5af8df",
+    "roles/executor.md": "0de6cff7284d0bdf5fd3995e6cd5f66ad9479853829e4586fa6f793a4cb189c7",
+    "roles/learner.md": "4a7e4635c0fbd2def794f017ca6ef5d47b6ea8dfaa5e85eeeecece61256f21a1",
+    "roles/planner.md": "a8714eceaeb73ee1f0bb22030a00243881326b77d88b34b0bdd01fcba567aa69",
+    "roles/researcher.md": "1f521aecbb65680dd7c9747483acf8c34febb2159300dd4a39dc11fa857a3782",
+    "roles/reviewer.md": "a5d3ca44b6be2c432df02d8ce7889bdadf954582f5559ae7f4e24b05806a766b",
+    "roles/specifier.md": "9eb2dbe5319a87b2332c7d13601dcb70ca1a655adf947f473687e268dcd92fea",
+    "roles/verifier.md": "ce8e200439190643a02ffe31f72e4b4ec319ccff9f0841cc3138eb517af5fed3",
+    "workflows/author.md": "81844443743540b21dd990fa93e59d8898216e498acde920e7007f8b81cef107",
+    "workflows/clarify.md": "06354f7624ba2819fe10678eee05676bc737473194f444f7f7a9b0be1a9f036f",
+    "workflows/design-review.md": "0e48be715e11c719dee6d207970544eaaa86d755c9813b358e2b6d79afaeff90",
+    "workflows/design.md": "c68e78d3d078f9bba7a7b58b2c606ee1a2dd7b15f16567abab31adf3925e261e",
+    "workflows/discover.md": "af21ff43a57cce34ce37fbc84e82961d24968a2b95692d081b1697011f559ad8",
+    "workflows/execute.md": "49f4b4b22e50aac17c501d4b2d81b51acb82a7938f4a89f076552686cff7795d",
+    "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
+    "workflows/plan-review.md": "fe6193122f7026dd92ced8ee1ae07279520d34b22a242260419cbb1d8bf7f99e",
+    "workflows/plan.md": "6e3a376b85c30e1887b5f667d28b51635a4332e05f892e49a17ae710c6ef247b",
+    "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
+    "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
+    "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
+    "workflows/spec-challenge.md": "69c4114579a210bfe1333e92c382c771a6507ce71c4aecdff40f50c1818e06e2",
+    "workflows/specify.md": "477f7b651112383ea681d31d1fcecba7f3107946829f5660afbce9d97b7af4bd",
+    "workflows/verify.md": "3a568f1b32f6ece7a3d1382b0c75700337016cbee5d24ad8229a57339dc0ee98",
+    "hooks/definitions/loop_cap_guard.yaml": "143ecda8f47dd299182dfe9cea2fb3f15a82a8d1f179b100a9e539d83f639b57",
+    "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
+    "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
+    "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
+    "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
+    "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+  }
+}

package/exports/hosts/codex/host-package.json

@@ -0,0 +1,41 @@
+{
+  "host": "codex",
+  "sources": [
+    "wazir.manifest.yaml",
+    "roles/clarifier.md",
+    "roles/content-author.md",
+    "roles/designer.md",
+    "roles/executor.md",
+    "roles/learner.md",
+    "roles/planner.md",
+    "roles/researcher.md",
+    "roles/reviewer.md",
+    "roles/specifier.md",
+    "roles/verifier.md",
+    "workflows/author.md",
+    "workflows/clarify.md",
+    "workflows/design-review.md",
+    "workflows/design.md",
+    "workflows/discover.md",
+    "workflows/execute.md",
+    "workflows/learn.md",
+    "workflows/plan-review.md",
+    "workflows/plan.md",
+    "workflows/prepare-next.md",
+    "workflows/review.md",
+    "workflows/run-audit.md",
+    "workflows/spec-challenge.md",
+    "workflows/specify.md",
+    "workflows/verify.md",
+    "hooks/definitions/loop_cap_guard.yaml",
+    "hooks/definitions/post_tool_capture.yaml",
+    "hooks/definitions/pre_compact_summary.yaml",
+    "hooks/definitions/pre_tool_capture_route.yaml",
+    "hooks/definitions/protected_path_write_guard.yaml",
+    "hooks/definitions/session_start.yaml",
+    "hooks/definitions/stop_handoff_harvest.yaml"
+  ],
+  "files": [
+    "AGENTS.md"
+  ]
+}

package/exports/hosts/cursor/.cursor/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": [
+    {
+      "name": "protected-path-write-guard",
+      "command": "./hooks/protected-path-write-guard"
+    },
+    {
+      "name": "loop-cap-guard",
+      "command": "./hooks/loop-cap-guard"
+    },
+    {
+      "name": "session-start",
+      "command": "./hooks/session-start"
+    }
+  ]
+}

package/exports/hosts/cursor/.cursor/rules/wazir-core.mdc

@@ -0,0 +1,19 @@
+# Wazir for Cursor
+
+This host package is generated from the canonical Wazir sources.
+
+## Canonical facts
+
+- project: Wazir
+- hosts: claude, codex, gemini, cursor
+- 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
+- protected paths: input, roles, workflows, schemas, exports/hosts
+- state root default: ~/.wazir/projects/{project_slug}
+
+## Source of truth
+
+- `wazir.manifest.yaml`
+- `roles/*.md`
+- `workflows/*.md`
+- `hooks/definitions/*.yaml`

package/exports/hosts/cursor/export.manifest.json

@@ -0,0 +1,38 @@
+{
+  "host": "cursor",
+  "source_hashes": {
+    "wazir.manifest.yaml": "2a57e262d071283504311ead7daaa8444c0c1895243f048036f79c501dfa4356",
+    "roles/clarifier.md": "1135b98d548937b5009bd77d292ceee29f806acc9cae245e5e18ccb8be05173e",
+    "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
+    "roles/designer.md": "8a0a9846965aa03ac00d0d71cde58f529aa8fb79908a481cb8ca3ff09d5af8df",
+    "roles/executor.md": "0de6cff7284d0bdf5fd3995e6cd5f66ad9479853829e4586fa6f793a4cb189c7",
+    "roles/learner.md": "4a7e4635c0fbd2def794f017ca6ef5d47b6ea8dfaa5e85eeeecece61256f21a1",
+    "roles/planner.md": "a8714eceaeb73ee1f0bb22030a00243881326b77d88b34b0bdd01fcba567aa69",
+    "roles/researcher.md": "1f521aecbb65680dd7c9747483acf8c34febb2159300dd4a39dc11fa857a3782",
+    "roles/reviewer.md": "a5d3ca44b6be2c432df02d8ce7889bdadf954582f5559ae7f4e24b05806a766b",
+    "roles/specifier.md": "9eb2dbe5319a87b2332c7d13601dcb70ca1a655adf947f473687e268dcd92fea",
+    "roles/verifier.md": "ce8e200439190643a02ffe31f72e4b4ec319ccff9f0841cc3138eb517af5fed3",
+    "workflows/author.md": "81844443743540b21dd990fa93e59d8898216e498acde920e7007f8b81cef107",
+    "workflows/clarify.md": "06354f7624ba2819fe10678eee05676bc737473194f444f7f7a9b0be1a9f036f",
+    "workflows/design-review.md": "0e48be715e11c719dee6d207970544eaaa86d755c9813b358e2b6d79afaeff90",
+    "workflows/design.md": "c68e78d3d078f9bba7a7b58b2c606ee1a2dd7b15f16567abab31adf3925e261e",
+    "workflows/discover.md": "af21ff43a57cce34ce37fbc84e82961d24968a2b95692d081b1697011f559ad8",
+    "workflows/execute.md": "49f4b4b22e50aac17c501d4b2d81b51acb82a7938f4a89f076552686cff7795d",
+    "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
+    "workflows/plan-review.md": "fe6193122f7026dd92ced8ee1ae07279520d34b22a242260419cbb1d8bf7f99e",
+    "workflows/plan.md": "6e3a376b85c30e1887b5f667d28b51635a4332e05f892e49a17ae710c6ef247b",
+    "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
+    "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
+    "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
+    "workflows/spec-challenge.md": "69c4114579a210bfe1333e92c382c771a6507ce71c4aecdff40f50c1818e06e2",
+    "workflows/specify.md": "477f7b651112383ea681d31d1fcecba7f3107946829f5660afbce9d97b7af4bd",
+    "workflows/verify.md": "3a568f1b32f6ece7a3d1382b0c75700337016cbee5d24ad8229a57339dc0ee98",
+    "hooks/definitions/loop_cap_guard.yaml": "143ecda8f47dd299182dfe9cea2fb3f15a82a8d1f179b100a9e539d83f639b57",
+    "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
+    "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
+    "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
+    "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
+    "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+  }
+}

package/exports/hosts/cursor/host-package.json

@@ -0,0 +1,42 @@
+{
+  "host": "cursor",
+  "sources": [
+    "wazir.manifest.yaml",
+    "roles/clarifier.md",
+    "roles/content-author.md",
+    "roles/designer.md",
+    "roles/executor.md",
+    "roles/learner.md",
+    "roles/planner.md",
+    "roles/researcher.md",
+    "roles/reviewer.md",
+    "roles/specifier.md",
+    "roles/verifier.md",
+    "workflows/author.md",
+    "workflows/clarify.md",
+    "workflows/design-review.md",
+    "workflows/design.md",
+    "workflows/discover.md",
+    "workflows/execute.md",
+    "workflows/learn.md",
+    "workflows/plan-review.md",
+    "workflows/plan.md",
+    "workflows/prepare-next.md",
+    "workflows/review.md",
+    "workflows/run-audit.md",
+    "workflows/spec-challenge.md",
+    "workflows/specify.md",
+    "workflows/verify.md",
+    "hooks/definitions/loop_cap_guard.yaml",
+    "hooks/definitions/post_tool_capture.yaml",
+    "hooks/definitions/pre_compact_summary.yaml",
+    "hooks/definitions/pre_tool_capture_route.yaml",
+    "hooks/definitions/protected_path_write_guard.yaml",
+    "hooks/definitions/session_start.yaml",
+    "hooks/definitions/stop_handoff_harvest.yaml"
+  ],
+  "files": [
+    ".cursor/hooks.json",
+    ".cursor/rules/wazir-core.mdc"
+  ]
+}

package/exports/hosts/gemini/GEMINI.md

@@ -0,0 +1,19 @@
+# Wazir for Gemini
+
+This host package is generated from the canonical Wazir sources.
+
+## Canonical facts
+
+- project: Wazir
+- hosts: claude, codex, gemini, cursor
+- 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
+- protected paths: input, roles, workflows, schemas, exports/hosts
+- state root default: ~/.wazir/projects/{project_slug}
+
+## Source of truth
+
+- `wazir.manifest.yaml`
+- `roles/*.md`
+- `workflows/*.md`
+- `hooks/definitions/*.yaml`

package/exports/hosts/gemini/export.manifest.json

@@ -0,0 +1,38 @@
+{
+  "host": "gemini",
+  "source_hashes": {
+    "wazir.manifest.yaml": "2a57e262d071283504311ead7daaa8444c0c1895243f048036f79c501dfa4356",
+    "roles/clarifier.md": "1135b98d548937b5009bd77d292ceee29f806acc9cae245e5e18ccb8be05173e",
+    "roles/content-author.md": "cc20b80bd70ab68b3239a9cf56bf1ffc2c06843d38afc6b190844b35a1d73c3e",
+    "roles/designer.md": "8a0a9846965aa03ac00d0d71cde58f529aa8fb79908a481cb8ca3ff09d5af8df",
+    "roles/executor.md": "0de6cff7284d0bdf5fd3995e6cd5f66ad9479853829e4586fa6f793a4cb189c7",
+    "roles/learner.md": "4a7e4635c0fbd2def794f017ca6ef5d47b6ea8dfaa5e85eeeecece61256f21a1",
+    "roles/planner.md": "a8714eceaeb73ee1f0bb22030a00243881326b77d88b34b0bdd01fcba567aa69",
+    "roles/researcher.md": "1f521aecbb65680dd7c9747483acf8c34febb2159300dd4a39dc11fa857a3782",
+    "roles/reviewer.md": "a5d3ca44b6be2c432df02d8ce7889bdadf954582f5559ae7f4e24b05806a766b",
+    "roles/specifier.md": "9eb2dbe5319a87b2332c7d13601dcb70ca1a655adf947f473687e268dcd92fea",
+    "roles/verifier.md": "ce8e200439190643a02ffe31f72e4b4ec319ccff9f0841cc3138eb517af5fed3",
+    "workflows/author.md": "81844443743540b21dd990fa93e59d8898216e498acde920e7007f8b81cef107",
+    "workflows/clarify.md": "06354f7624ba2819fe10678eee05676bc737473194f444f7f7a9b0be1a9f036f",
+    "workflows/design-review.md": "0e48be715e11c719dee6d207970544eaaa86d755c9813b358e2b6d79afaeff90",
+    "workflows/design.md": "c68e78d3d078f9bba7a7b58b2c606ee1a2dd7b15f16567abab31adf3925e261e",
+    "workflows/discover.md": "af21ff43a57cce34ce37fbc84e82961d24968a2b95692d081b1697011f559ad8",
+    "workflows/execute.md": "49f4b4b22e50aac17c501d4b2d81b51acb82a7938f4a89f076552686cff7795d",
+    "workflows/learn.md": "9b1955a00eb0ea47af08a3639c3cbc2f15b8eab6cc02127e829bc8c83b0a52b5",
+    "workflows/plan-review.md": "fe6193122f7026dd92ced8ee1ae07279520d34b22a242260419cbb1d8bf7f99e",
+    "workflows/plan.md": "6e3a376b85c30e1887b5f667d28b51635a4332e05f892e49a17ae710c6ef247b",
+    "workflows/prepare-next.md": "8769b692be6d9fddf3b3f36fee6888159fb9fb2a5c31360cdbc9402e0f43fc27",
+    "workflows/review.md": "aaeaf7ab4515e325084a77e75e18b325295f8d16799f71f8b7cd0ec67c52c0d6",
+    "workflows/run-audit.md": "e582f767967dc3fb6aaeb938ad1672e7bed18bf044055ce8c45c2114251b787a",
+    "workflows/spec-challenge.md": "69c4114579a210bfe1333e92c382c771a6507ce71c4aecdff40f50c1818e06e2",
+    "workflows/specify.md": "477f7b651112383ea681d31d1fcecba7f3107946829f5660afbce9d97b7af4bd",
+    "workflows/verify.md": "3a568f1b32f6ece7a3d1382b0c75700337016cbee5d24ad8229a57339dc0ee98",
+    "hooks/definitions/loop_cap_guard.yaml": "143ecda8f47dd299182dfe9cea2fb3f15a82a8d1f179b100a9e539d83f639b57",
+    "hooks/definitions/post_tool_capture.yaml": "a773cd6e18972dee8eef3b7cb06fd1d319a71de4588897cebfbe643f6781a3b2",
+    "hooks/definitions/pre_compact_summary.yaml": "daa0175d79f3e0127c5ce86a7a2f8df0be3f58b5c94fe749da715a17c7b2d04e",
+    "hooks/definitions/pre_tool_capture_route.yaml": "3c2663380ff3cd09f09de5b96bcf6123266fa74d8a03dfb2d6fbe40a43fb13cf",
+    "hooks/definitions/protected_path_write_guard.yaml": "6683d41778b823e2a4e606065597569aa04363f091e135e165de9732f1fc2171",
+    "hooks/definitions/session_start.yaml": "9383fcf1f8304c87e57726478a461706c0fc73dc62bcc4d8661f2eeffa43a82d",
+    "hooks/definitions/stop_handoff_harvest.yaml": "67a3c0a8bb7cb66b88e77dc79e748082e964d278c47935662c453922a846482b"
+  }
+}

package/exports/hosts/gemini/host-package.json

@@ -0,0 +1,41 @@
+{
+  "host": "gemini",
+  "sources": [
+    "wazir.manifest.yaml",
+    "roles/clarifier.md",
+    "roles/content-author.md",
+    "roles/designer.md",
+    "roles/executor.md",
+    "roles/learner.md",
+    "roles/planner.md",
+    "roles/researcher.md",
+    "roles/reviewer.md",
+    "roles/specifier.md",
+    "roles/verifier.md",
+    "workflows/author.md",
+    "workflows/clarify.md",
+    "workflows/design-review.md",
+    "workflows/design.md",
+    "workflows/discover.md",
+    "workflows/execute.md",
+    "workflows/learn.md",
+    "workflows/plan-review.md",
+    "workflows/plan.md",
+    "workflows/prepare-next.md",
+    "workflows/review.md",
+    "workflows/run-audit.md",
+    "workflows/spec-challenge.md",
+    "workflows/specify.md",
+    "workflows/verify.md",
+    "hooks/definitions/loop_cap_guard.yaml",
+    "hooks/definitions/post_tool_capture.yaml",
+    "hooks/definitions/pre_compact_summary.yaml",
+    "hooks/definitions/pre_tool_capture_route.yaml",
+    "hooks/definitions/protected_path_write_guard.yaml",
+    "hooks/definitions/session_start.yaml",
+    "hooks/definitions/stop_handoff_harvest.yaml"
+  ],
+  "files": [
+    "GEMINI.md"
+  ]
+}

package/hooks/README.md

@@ -0,0 +1,18 @@
+# hooks/
+
+This directory holds canonical hook definitions and hook-related documentation.
+
+Allowed:
+
+- canonical hook definitions
+- hook guard rules
+- capture and observability behavior
+
+Not allowed:
+
+- host-only ad hoc scripts without canonical definitions
+
+Rules:
+
+- Canonical hook definitions validate against the hook schema.
+- Host exports map from this layer to native hooks or wrapper fallbacks.

package/hooks/definitions/loop_cap_guard.yaml

@@ -0,0 +1,21 @@
+id: loop_cap_guard
+trigger: loop_cap_guard
+description: Stop additional loop iterations after the configured phase cap is reached.
+input_contract:
+  required:
+    - run_id
+    - phase
+allowed_side_effects:
+  - read_status
+  - block_execution
+output_contract:
+  produces:
+    - guard_decision
+failure_behavior:
+  mode: block
+  exit_code: 43
+host_fallback:
+  claude: native_or_wrapper
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: native_or_wrapper

package/hooks/definitions/post_tool_capture.yaml

@@ -0,0 +1,24 @@
+id: post_tool_capture
+trigger: post_tool_capture
+description: Capture command output, append events, update status, and record usage after tool execution.
+input_contract:
+  required:
+    - command
+    - exit_code
+allowed_side_effects:
+  - write_capture_file
+  - append_event
+  - update_status
+  - update_usage
+output_contract:
+  produces:
+    - events.ndjson
+    - usage.json
+failure_behavior:
+  mode: capture
+  exit_code: 0
+host_fallback:
+  claude: native_hook
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: native_or_wrapper

package/hooks/definitions/pre_compact_summary.yaml

@@ -0,0 +1,19 @@
+id: pre_compact_summary
+trigger: pre_compact_summary
+description: Summarize captured output before context compaction or handoff.
+input_contract:
+  required:
+    - run_id
+allowed_side_effects:
+  - write_summary
+output_contract:
+  produces:
+    - summary.md
+failure_behavior:
+  mode: warn
+  exit_code: 0
+host_fallback:
+  claude: native_or_wrapper
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: wrapper_command

package/hooks/definitions/pre_tool_capture_route.yaml

@@ -0,0 +1,19 @@
+id: pre_tool_capture_route
+trigger: pre_tool_capture_route
+description: Route large command output away from model context and into captured artifacts.
+input_contract:
+  required:
+    - command
+allowed_side_effects:
+  - create_capture_target
+output_contract:
+  produces:
+    - capture_path
+failure_behavior:
+  mode: warn
+  exit_code: 0
+host_fallback:
+  claude: native_hook
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: native_or_wrapper

package/hooks/definitions/protected_path_write_guard.yaml

@@ -0,0 +1,19 @@
+id: protected_path_write_guard
+trigger: protected_path_write_guard
+description: Block writes to protected canonical paths outside approved regeneration flows.
+input_contract:
+  required:
+    - target_path
+allowed_side_effects:
+  - block_write
+output_contract:
+  produces:
+    - guard_decision
+failure_behavior:
+  mode: block
+  exit_code: 42
+host_fallback:
+  claude: native_or_wrapper
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: native_or_wrapper

package/hooks/definitions/session_start.yaml

@@ -0,0 +1,19 @@
+id: session_start
+trigger: session_start
+description: Initialize run-local status capture and bootstrap summaries.
+input_contract:
+  required:
+    - project_root
+allowed_side_effects: []
+output_contract:
+  produces:
+    - skill_bootstrap_text
+    - cli_bootstrap_guidance
+failure_behavior:
+  mode: capture
+  exit_code: 0
+host_fallback:
+  claude: native_hook
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: native_or_wrapper

package/hooks/definitions/stop_handoff_harvest.yaml

@@ -0,0 +1,20 @@
+id: stop_handoff_harvest
+trigger: stop_handoff_harvest
+description: Harvest final handoff notes and persist stop-time observability data.
+input_contract:
+  required:
+    - run_id
+allowed_side_effects:
+  - append_event
+  - write_handoff
+output_contract:
+  produces:
+    - summary.md
+failure_behavior:
+  mode: capture
+  exit_code: 0
+host_fallback:
+  claude: native_hook
+  codex: wrapper_command
+  gemini: wrapper_command
+  cursor: native_or_wrapper

package/hooks/loop-cap-guard

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+
+import { evaluateLoopCapGuard } from '../tooling/src/guards/loop-cap-guard.js';
+
+try {
+  const input = readFileSync(0, 'utf8');
+  const payload = input.trim() ? JSON.parse(input) : {};
+  const decision = evaluateLoopCapGuard(payload);
+
+  process.stdout.write(`${JSON.stringify({ guard_decision: decision })}\n`);
+  process.exit(decision.allowed ? 0 : 43);
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exit(1);
+}

package/hooks/post-tool-lint

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+
+function readPayload() {
+  try {
+    const raw = readFileSync(0, 'utf-8').trim();
+    if (raw.length === 0) return null;
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+const payload = readPayload();
+const envFile = process.env.CLAUDE_TOOL_FILE_PATH;
+const filePath = payload?.tool_input?.file_path ?? envFile;
+
+if (!filePath || !filePath.endsWith('.js')) {
+  process.exit(0);
+}
+
+if (!existsSync(filePath)) {
+  process.exit(0);
+}
+
+try {
+  execFileSync('node', ['--check', filePath], { stdio: 'pipe' });
+  process.exit(0);
+} catch (err) {
+  const stderr = err && typeof err === 'object' && 'stderr' in err
+    ? String(err.stderr)
+    : String(err);
+  process.stderr.write(`Syntax error in ${filePath}:\n${stderr}\n`);
+  process.exit(2);
+}

package/hooks/protected-path-write-guard

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+
+import { evaluateProtectedPathWriteGuard } from '../tooling/src/guards/protected-path-write-guard.js';
+
+try {
+  const input = readFileSync(0, 'utf8');
+  const payload = input.trim() ? JSON.parse(input) : {};
+  const decision = evaluateProtectedPathWriteGuard(payload);
+
+  process.stdout.write(`${JSON.stringify({ guard_decision: decision })}\n`);
+  process.exit(decision.allowed ? 0 : 42);
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exit(1);
+}

package/hooks/session-start

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const hooksDir = dirname(fileURLToPath(import.meta.url));
+const projectRoot = dirname(hooksDir);
+const skillFile = join(projectRoot, 'skills', 'using-skills', 'SKILL.md');
+
+if (existsSync(skillFile)) {
+  const content = readFileSync(skillFile, 'utf-8');
+  process.stdout.write(
+    `<EXTREMELY_IMPORTANT>\n` +
+    `You have skills.\n\n` +
+    `**Below is the full content of your 'wz:using-skills' skill:**\n\n` +
+    `${content}\n` +
+    `</EXTREMELY_IMPORTANT>\n`,
+  );
+} else {
+  process.stdout.write(
+    `<system-reminder>\n` +
+    `WARNING: wz:using-skills skill not found at ${skillFile}\n` +
+    `The Wazir skill bootstrap is not available. Skills will not be auto-discovered.\n` +
+    `Run: check that skills/using-skills/SKILL.md exists.\n` +
+    `</system-reminder>\n`,
+  );
+}
+
+process.stdout.write(
+  `<cli-bootstrap-guidance>\n` +
+  `## CLI Bootstrap\n\n` +
+  `Run the following checks at session start:\n\n` +
+  `1. Run \`wazir doctor --json\` to check repo health.\n` +
+  `2. Run \`wazir index refresh\` to update the index.\n` +
+  `   - If no index exists, run \`wazir index build && wazir index summarize --tier all\`.\n` +
+  `3. Check \`<state-root>/runs/latest\` for previous run ID.\n` +
+  `   - If previous run is incomplete, resume it.\n` +
+  `   - Otherwise run \`wazir capture init --run <new-id> --phase clarify --status starting\`.\n` +
+  `</cli-bootstrap-guidance>\n`,
+);
+process.exit(0);