instar 0.28.96 → 0.28.97

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.28.96",
+  "version": "0.28.97",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",

package/src/data/builtin-manifest.json

@@ -1,8 +1,8 @@
 {
   "$schema": "./builtin-manifest.schema.json",
   "schemaVersion": 1,
-  "generatedAt": "2026-05-12T13:08:51.877Z",
-  "instarVersion": "0.28.96",
+  "generatedAt": "2026-05-12T19:22:01.542Z",
+  "instarVersion": "0.28.97",
   "entryCount": 188,
   "entries": {
     "hook:session-start": {
@@ -368,7 +368,7 @@
       "type": "skill",
       "domain": "skills",
       "sourcePath": ".claude/skills/instar-project/SKILL.md",
-      "contentHash": "8c8a924740d8afedeb5e0b4bea7a3760c9654dc6b49a9a415429fe0366ff8429",
+      "contentHash": "d35b3aeb1bd4ab1a416db1d7ede4203a447eacb6381e05ff4d7de405488fd2f6",
       "since": "2025-01-01"
     },
     "skill:secret-setup": {
@@ -392,7 +392,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:agents": {
@@ -400,7 +400,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:backups": {
@@ -408,7 +408,7 @@
       "type": "route-group",
       "domain": "operations",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:git": {
@@ -416,7 +416,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:memory": {
@@ -424,7 +424,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:semantic": {
@@ -432,7 +432,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:status": {
@@ -440,7 +440,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:capabilities": {
@@ -448,7 +448,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:project-map": {
@@ -456,7 +456,7 @@
       "type": "route-group",
       "domain": "mapping",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:coherence": {
@@ -464,7 +464,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:topic-bindings": {
@@ -472,7 +472,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:context": {
@@ -480,7 +480,7 @@
       "type": "route-group",
       "domain": "context",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:scope-coherence": {
@@ -488,7 +488,7 @@
       "type": "route-group",
       "domain": "coherence",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:canonical-state": {
@@ -496,7 +496,7 @@
       "type": "route-group",
       "domain": "state",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:ci": {
@@ -504,7 +504,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:sessions": {
@@ -512,7 +512,7 @@
       "type": "route-group",
       "domain": "sessions",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:jobs": {
@@ -520,7 +520,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:skip-ledger": {
@@ -528,7 +528,7 @@
       "type": "route-group",
       "domain": "scheduling",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:telegram": {
@@ -536,7 +536,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:attention": {
@@ -544,7 +544,7 @@
       "type": "route-group",
       "domain": "communication",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:relationships": {
@@ -552,7 +552,7 @@
       "type": "route-group",
       "domain": "relationships",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:feedback": {
@@ -560,7 +560,7 @@
       "type": "route-group",
       "domain": "feedback",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:updates": {
@@ -568,7 +568,7 @@
       "type": "route-group",
       "domain": "updates",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:dispatches": {
@@ -576,7 +576,7 @@
       "type": "route-group",
       "domain": "dispatches",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:quota": {
@@ -584,7 +584,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:publishing": {
@@ -592,7 +592,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:private-views": {
@@ -600,7 +600,7 @@
       "type": "route-group",
       "domain": "publishing",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:tunnel": {
@@ -608,7 +608,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:events": {
@@ -616,7 +616,7 @@
       "type": "route-group",
       "domain": "networking",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:evolution": {
@@ -624,7 +624,7 @@
       "type": "route-group",
       "domain": "evolution",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:watchdog": {
@@ -632,7 +632,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:topic-memory": {
@@ -640,7 +640,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:state-sync": {
@@ -648,7 +648,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:intent": {
@@ -656,7 +656,7 @@
       "type": "route-group",
       "domain": "intent",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:triage": {
@@ -664,7 +664,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:operations": {
@@ -672,7 +672,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:sentinel": {
@@ -680,7 +680,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:trust": {
@@ -688,7 +688,7 @@
       "type": "route-group",
       "domain": "safety",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:monitoring": {
@@ -696,7 +696,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:commitments": {
@@ -704,7 +704,7 @@
       "type": "route-group",
       "domain": "commitments",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:episodes": {
@@ -712,7 +712,7 @@
       "type": "route-group",
       "domain": "memory",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:messages": {
@@ -720,7 +720,7 @@
       "type": "route-group",
       "domain": "coordination",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:system-reviews": {
@@ -728,7 +728,7 @@
       "type": "route-group",
       "domain": "monitoring",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "route-group:machine-mesh": {
@@ -744,7 +744,7 @@
       "type": "route-group",
       "domain": "security",
       "sourcePath": "src/server/routes.ts",
-      "contentHash": "5c65a20204fc03ffcf514a764df6a1a2c6ec5f5071717400912c08bc94eaa975",
+      "contentHash": "78fb3f989c8f3a16e40ba72a5cc1bab18d38d78b985d5cdeb5c7c2b84a80688b",
       "since": "2025-01-01"
     },
     "cli:init": {

package/upgrades/0.28.97.md

@@ -0,0 +1,146 @@
+# Upgrade Guide — vNEXT
+
+<!-- bump: minor -->
+<!-- Valid values: patch, minor, major -->
+<!-- patch = bug fixes, refactors, test additions, doc updates -->
+<!-- minor = new features, new APIs, new capabilities (backwards-compatible) -->
+<!-- major = breaking changes to existing APIs or behavior -->
+
+## What Changed
+
+### Project-scope Phase 1.7 — `/project` skill surface (full command set)
+
+Final code piece of project-scope Phase 1: the user-invocable
+`/project` skill, the conversational interface spec § Phase 1.7
+specifies as twelve canonical commands. Phase 1a shipped read-only
+commands (`create`, `status`, plus a placeholder `next`); this PR
+fleshes out the full mutating surface and adds the three small HTTP
+routes the spec named but hadn't materialized yet.
+
+- **`.claude/skills/instar-project/SKILL.md` rewritten end-to-end.**
+  Documents every spec § 1.7 command with its backing endpoint, body
+  schema, expected response codes, and a one-line conversational
+  rendering rule. The Phase 1a "next is a 501 placeholder" language
+  is gone — the structured `{action, params, skillCommand}` payload
+  shipped in the connect-the-dots PR is now the documented contract.
+- **`POST /projects/:id/run-round`** — manual round-start trigger.
+  Calls `ProjectRoundRunner.preflight()` for the deterministic gate
+  checks and, on accept, sets `autoAdvanceAt = now` so the existing
+  auto-advance poller fires the executor on its next tick (≤60s).
+  Does NOT spawn the autonomous child directly — keeps one fire path
+  through one lock. Body: `{roundIndex}`. Returns 200 with
+  `{id, roundIndex, scheduledAt, version}` on accept, 409 with the
+  preflight verdict's `code` + `reason` on reject (surface those
+  verbatim — they're written for users).
+- **`POST /projects/:id/resume`** — resume a halted or failed round.
+  Clears `haltedAt`/`haltReason`, schedules the round for the poller,
+  re-actives `project.status` from `'halted'`/`'abandoned'` back to
+  `'active'`. For rounds at `status: 'failed'` with
+  `resumeAttempts >= 3` (the spec's three-attempt cap), `{force: true}`
+  is required and the counter resets to zero on accept. Returns 409
+  when the round is neither halted nor failed.
+- **`POST /projects/:id/abandon`** — archive a halted project.
+  Sets `project.status = 'abandoned'` and clears any future
+  `autoAdvanceAt` on remaining rounds so the poller stops considering
+  them. Children's `pipelineStage` is left untouched (per spec).
+  Idempotent. Refuses (409) if a round is currently `in-progress` —
+  halt first.
+- **`skillCommandForAction()` realigned to canonical command names.**
+  The connect-the-dots PR added a mapping that returned
+  `/project approve` and `/project drift-check` for the
+  `await-user-approval` and `run-drift-check` actions. Spec § 1.7
+  uses `/project ack` and `/project drift` as the canonical command
+  names; the mapping now matches the spec so dashboard hints and
+  skill invocations stay in sync.
+
+Tests added:
+
+- `tests/unit/instar-project-skill.test.ts` — structural coverage of
+  SKILL.md (28 assertions). Pins the frontmatter contract, asserts
+  every spec § 1.7 command has a section header, and asserts each
+  documented endpoint actually exists in `src/server/routes.ts`.
+  Catches skill drift — if a route is renamed or removed without
+  updating the skill, the test fails on the next push.
+- `tests/integration/projects-api.test.ts` — 10 new cases (44 total)
+  for the three new endpoints: preflight reject (409), happy path
+  (200 + autoAdvanceAt landed), out-of-range round (404),
+  haltedAt-clear on resume (200), neither-halted-nor-failed reject
+  (409), failed-at-cap-without-force reject (409),
+  failed-at-cap-with-force happy path (counter zeroed), abandon
+  happy path (autoAdvanceAt cleared + status='abandoned'),
+  abandon-while-in-progress reject (409), abandon idempotent
+  (`alreadyAbandoned: true`).
+
+## What to Tell Your User
+
+- **You can now drive any project end-to-end through /project.**
+  Twelve commands, one skill: register a project from a plan doc,
+  read its state, advance a child item to its next stage, run a
+  drift check, fire a round, halt the active round, record your
+  acknowledgment, resume from halted or failed, abandon a project
+  permanently, close out a partially-complete round, claim ownership
+  on another machine. The skill walks me through each one with the
+  right API call and the right error handling — I don't have to
+  improvise the curl invocations.
+
+- **The "what should I do next" answer is now actionable.**
+  Asking /project next returns a structured action — "approval
+  pending," "drift check needed," "round ready to start" — plus the
+  exact follow-up command. I'll surface the suggested next step to
+  you in plain English rather than dumping the JSON.
+
+- **Halted projects can come back.** If a round halted because of a
+  spec drift, a halted child, or a runtime failure, /project resume
+  re-schedules it for the poller and re-actives the project. Rounds
+  that hit the three-attempt failure cap need an explicit force flag
+  before resuming, and the counter resets so the runner gets a fresh
+  budget.
+
+- **Permanently shelving a project is a single command.**
+  /project abandon clears all pending auto-advance scheduling and
+  marks the project as abandoned. Children stay where they were —
+  you don't lose any pipeline progress; you just stop the auto-loop.
+
+## Summary of New Capabilities
+
+- `.claude/skills/instar-project/SKILL.md` — twelve-command skill body
+  with frontmatter `user_invocable: true`. Each command section
+  documents its backing endpoint, body schema, response shape, and
+  expected error codes. Final "Conversational rendering" section pins
+  the don't-paste-curl rule.
+- `POST /projects/:id/run-round` — body `{roundIndex: number}`.
+  Returns 200 `{id, roundIndex, scheduledAt, version}` on accept,
+  409 `{error, code, reason}` on preflight reject, 404 on out-of-range
+  round, 503 if `ProjectRoundRunner` is not wired. OCC-protected via
+  `tracker.update(... ifMatch: project.version)`.
+- `POST /projects/:id/resume` — body `{roundIndex?: number,
+  force?: boolean}`. Returns 200 `{id, roundIndex, scheduledAt,
+  forced, version}` on accept, 409 when the round is neither halted
+  nor failed, 409 when failed-at-cap without `force`. Restores
+  `project.status` from `'halted'`/`'abandoned'` to `'active'` and
+  zeroes `resumeAttempts` on forced accept.
+- `POST /projects/:id/abandon` — no body required. Returns 200
+  `{id, status: 'abandoned', version}` on accept, 200
+  `{... alreadyAbandoned: true}` on idempotent repeat, 409 with
+  `activeRound` set when a round is in-progress. Clears
+  `autoAdvanceAt` on every remaining round.
+- `skillCommandForAction()` now emits `/project ack` for both
+  `await-user-approval` and `ack-required` action verbs, and
+  `/project drift` for `run-drift-check`. Aligns the dashboard hint
+  strings with the spec § 1.7 canonical command set.
+
+## Evidence
+
+Not reproducible in dev — this release is a feature addition, not a
+regression fix. The words "halted", "failed", "regression repair",
+and "skill drift" in What Changed describe design properties of the
+state machine and the structural test the PR introduces:
+
+- "halted" / "failed" (resume route): these are valid round states
+  in the existing `RoundStatus` union; the new endpoint's job is to
+  transition out of them. Not a fix for an observed halt incident.
+- "skill drift" (structural test): the new
+  `instar-project-skill.test.ts` asserts every endpoint documented
+  in SKILL.md exists in `routes.ts`. The "drift" is the test's
+  failure mode if a future PR renames a route without updating the
+  skill — a preventive guard, not the patching of a prior incident.