@peterxiaoyang/superspec 0.1.6 → 0.1.8

package/templates/hooks/codex-hooks.json

@@ -0,0 +1,61 @@
+{
+  "superspec": {
+    "managed": true,
+    "adapter_version": "superspec-hook@2",
+    "strict_profile_default": "audit-only-until-r1-provenance-passes"
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash|apply_patch|Edit|Write|mcp__.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "superspec-hook --change \"$SUPERSPEC_CHANGE\"",
+            "timeout": 10,
+            "statusMessage": "SuperSpec hook write policy"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "superspec-hook --change \"$SUPERSPEC_CHANGE\"",
+            "timeout": 30,
+            "statusMessage": "SuperSpec hook runtime evidence"
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "superspec-hook --change \"$SUPERSPEC_CHANGE\"",
+            "timeout": 30,
+            "statusMessage": "SuperSpec hook subagent start"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "superspec-hook --change \"$SUPERSPEC_CHANGE\"",
+            "timeout": 30,
+            "statusMessage": "SuperSpec hook subagent stop"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/workflow/skills/superspec-apply/SKILL.md

@@ -26,6 +26,13 @@ Apply 按 OpenSpec tasks 执行实现，负责 RED/GREEN 证据、任务勾选
 
 ## 第一条必跑命令
 
+先尝试建立当前 change 的 SuperSpec hook session。R-1/provenance 未通过时该命令只会记录 audit-only lease 和降级诊断，不代表 mechanical enforcement 已启用：
+
+```text
+superspec guard hook-session-begin --change "<change>" --workflow superspec-apply --entrypoint-token "<fresh-entrypoint-token>" --format agent
+superspec guard hook-session-status --change "<change>" --format agent
+```
+
 ```text
 superspec guard workflow-packet --change "<change>" --gate apply_ready --format agent
 ```

package/templates/workflow/skills/superspec-archive/SKILL.md

@@ -26,6 +26,13 @@ Archive 在 `review_complete` allowed 后收尾：确认 archive readiness、保
 
 ## 第一条必跑命令
 
+先尝试建立当前 change 的 SuperSpec hook session。R-1/provenance 未通过时该命令只会记录 audit-only lease 和降级诊断，不代表 mechanical enforcement 已启用：
+
+```text
+superspec guard hook-session-begin --change "<change>" --workflow superspec-archive --entrypoint-token "<fresh-entrypoint-token>" --format agent
+superspec guard hook-session-status --change "<change>" --format agent
+```
+
 ```text
 superspec guard workflow-packet --change "<change>" --gate archive_ready --format agent
 ```
@@ -60,6 +67,7 @@ openspec archive -y "<change>"
 
 ```text
 superspec guard check-archived --change "<change>" --format agent
+superspec guard hook-session-end --change "<change>" --reason archived --format agent
 ```
 
 `.superspec/artifacts/business-invariants.md`、`.superspec/artifacts/test-contract.md`、review/verification evidence、RED/GREEN evidence 和 archive evidence 必须能从 preservation manifest 追溯。

package/templates/workflow/skills/superspec-explore/SKILL.md

@@ -26,6 +26,13 @@ Explore 只做需求澄清、代码事实调查、范围边界和风险记录。
 
 ## 第一条必跑命令
 
+先尝试建立当前 change 的 SuperSpec hook session。R-1/provenance 未通过时该命令只会记录 audit-only lease 和降级诊断，不代表 mechanical enforcement 已启用：
+
+```text
+superspec guard hook-session-begin --change "<change>" --workflow superspec-explore --entrypoint-token "<fresh-entrypoint-token>" --format agent
+superspec guard hook-session-status --change "<change>" --format agent
+```
+
 ```text
 superspec init --scope project --format agent
 ```

package/templates/workflow/skills/superspec-propose/SKILL.md

@@ -26,6 +26,13 @@ Propose 把 discovery 转成 OpenSpec proposal package，并补 SuperSpec 业务
 
 ## 第一条必跑命令
 
+先尝试建立当前 change 的 SuperSpec hook session。R-1/provenance 未通过时该命令只会记录 audit-only lease 和降级诊断，不代表 mechanical enforcement 已启用：
+
+```text
+superspec guard hook-session-begin --change "<change>" --workflow superspec-propose --entrypoint-token "<fresh-entrypoint-token>" --format agent
+superspec guard hook-session-status --change "<change>" --format agent
+```
+
 ```text
 superspec guard workflow-packet --change "<change>" --gate explore_complete --format agent
 ```

package/templates/workflow/skills/superspec-review/SKILL.md

@@ -26,6 +26,13 @@ Review 合并实现审查、架构审查、SuperSpec critic、final verification
 
 ## 第一条必跑命令
 
+先尝试建立当前 change 的 SuperSpec hook session。R-1/provenance 未通过时该命令只会记录 audit-only lease 和降级诊断，不代表 mechanical enforcement 已启用：
+
+```text
+superspec guard hook-session-begin --change "<change>" --workflow superspec-review --entrypoint-token "<fresh-entrypoint-token>" --format agent
+superspec guard hook-session-status --change "<change>" --format agent
+```
+
 ```text
 superspec guard check-init --change "<change>" --format agent
 ```