@colin4k1024/tsp 2.5.2 → 2.5.4

package/manifests/install-modules.json

@@ -14,10 +14,12 @@
         "antigravity",
         "codex",
         "opencode",
+        "cangming",
         "codebuddy",
         "copilot",
         "windsurf",
-        "augment"
+        "augment",
+        "codewhale"
       ],
       "dependencies": [],
       "defaultInstall": true,
@@ -39,7 +41,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [],
       "defaultInstall": true,
@@ -59,7 +63,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [],
       "defaultInstall": true,
@@ -79,7 +85,9 @@
         "claude",
         "cursor",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [],
       "defaultInstall": true,
@@ -104,10 +112,12 @@
         "codex",
         "gemini",
         "opencode",
+        "cangming",
         "codebuddy",
         "copilot",
         "windsurf",
-        "augment"
+        "augment",
+        "codewhale"
       ],
       "dependencies": [],
       "defaultInstall": true,
@@ -162,7 +172,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "rules-core",
@@ -190,7 +202,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -233,7 +247,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -260,7 +276,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "workflow-quality"
@@ -284,7 +302,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -321,7 +341,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -357,7 +379,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -385,7 +409,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -411,7 +437,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -434,7 +462,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "business-content"
@@ -460,7 +490,9 @@
         "cursor",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -484,7 +516,52 @@
       "targets": [
         "claude",
         "codex",
-        "opencode"
+        "opencode",
+        "cangming",
+        "codewhale"
+      ],
+      "dependencies": [
+        "commands-core",
+        "platform-configs"
+      ],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "beta"
+    },
+    {
+      "id": "loop-engineering",
+      "kind": "orchestration",
+      "description": "Loop Engineering command surface, target-neutral state runtime, loop spec schema, heartbeat discovery, and maker/checker loop skills.",
+      "paths": [
+        ".tsp/loop.example.yaml",
+        "commands/goal.md",
+        "commands/heartbeat.md",
+        "commands/triage.md",
+        "commands/loop-start.md",
+        "commands/loop-status.md",
+        "docs/runbooks/loop-engineering-usage.md",
+        "schemas/loop-spec.schema.json",
+        "scripts/lib/loop-state-store.js",
+        "scripts/lib/loop-spec.js",
+        "scripts/lib/loop-oracle.js",
+        "scripts/lib/completion-oracle.js",
+        "scripts/lib/heartbeat-scheduler.js",
+        "scripts/hooks/session-start-goal-resume.js",
+        "skills/loop-heartbeat",
+        "skills/goal-convergence",
+        "skills/rework-loop",
+        "skills/context-engineering",
+        "skills/context-lifecycle",
+        "templates/context-docs"
+      ],
+      "targets": [
+        "claude",
+        "cursor",
+        "codex",
+        "opencode",
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "commands-core",
@@ -511,7 +588,9 @@
         "cursor",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -532,7 +611,9 @@
         "cursor",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "workflow-engine"
@@ -559,7 +640,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -598,7 +681,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -621,7 +706,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -650,7 +737,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -673,7 +762,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs"
@@ -695,7 +786,9 @@
         "claude",
         "cursor",
         "codex",
-        "opencode"
+        "opencode",
+        "cangming",
+        "codewhale"
       ],
       "dependencies": [
         "agents-core",
@@ -720,7 +813,9 @@
         "claude",
         "cursor",
         "codex",
-        "opencode"
+        "opencode",
+        "cangming",
+        "codewhale"
       ],
       "dependencies": [
         "team-workflow"
@@ -760,8 +855,17 @@
         "skills/workflow-forensics",
         "templates/context-docs"
       ],
-      "targets": ["claude", "cursor", "codex", "opencode"],
-      "dependencies": ["team-workflow"],
+      "targets": [
+        "claude",
+        "cursor",
+        "codex",
+        "opencode",
+        "cangming",
+        "codewhale"
+      ],
+      "dependencies": [
+        "team-workflow"
+      ],
       "defaultInstall": false,
       "cost": "heavy",
       "stability": "stable"
@@ -781,7 +885,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "platform-configs",
@@ -808,7 +914,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "hooks-runtime",
@@ -843,7 +951,9 @@
         "antigravity",
         "codex",
         "opencode",
-        "codebuddy"
+        "cangming",
+        "codebuddy",
+        "codewhale"
       ],
       "dependencies": [
         "commands-core",

package/manifests/install-profiles.json

@@ -78,6 +78,7 @@
         "workflow-engine",
         "workflow-defaults",
         "orchestration",
+        "loop-engineering",
         "swift-apple",
         "agentic-patterns",
         "devops-infra",
@@ -105,6 +106,7 @@
         "knowledge-graph",
         "workflow-engine",
         "workflow-defaults",
+        "loop-engineering",
         "design-prototyping",
         "enhanced-workflows",
         "rtk-optimization"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colin4k1024/tsp",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "description": "Open-source Team Skills Platform for role-based AI delivery workflows, shared skills, hooks, commands, and multi-platform installs.",
   "repository": {
     "type": "git",
@@ -62,6 +62,7 @@
     "install:codex": "node scripts/install-apply.js --profile full --target codex",
     "install:cursor": "node scripts/install-apply.js --profile full --target cursor",
     "install:opencode": "node scripts/install-apply.js --profile full --target opencode",
+    "install:cangming": "node scripts/install-apply.js --profile full --target cangming",
     "prepack": "node scripts/validate-prebuilt.js",
     "prepublishOnly": "node scripts/validate-prebuilt.js",
     "test": "node tests/run-all.js",

package/schemas/loop-spec.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://colin4k1024.github.io/tsp/schemas/loop-spec.schema.json",
+  "title": "TSP Loop Engineering Spec",
+  "type": "object",
+  "required": ["loop"],
+  "additionalProperties": false,
+  "properties": {
+    "loop": {
+      "type": "object",
+      "required": [
+        "id",
+        "description",
+        "cadence",
+        "skill",
+        "stateFile",
+        "gates",
+        "maker",
+        "checker",
+        "budget"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "cadence": {
+          "type": "string",
+          "pattern": "^[0-9]+[mhd]$"
+        },
+        "skill": {
+          "type": "string",
+          "minLength": 1
+        },
+        "stateFile": {
+          "type": "string",
+          "minLength": 1
+        },
+        "gates": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["name", "command"],
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1
+              },
+              "command": {
+                "type": "string",
+                "minLength": 1
+              },
+              "description": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "maker": {
+          "$ref": "#/$defs/actor"
+        },
+        "checker": {
+          "$ref": "#/$defs/actor"
+        },
+        "budget": {
+          "type": "object",
+          "required": ["maxIterations", "maxDuration", "maxDollars"],
+          "additionalProperties": false,
+          "properties": {
+            "maxIterations": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "maxDuration": {
+              "type": "string",
+              "pattern": "^[0-9]+[mh]$"
+            },
+            "maxDollars": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          }
+        },
+        "escalation": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "onBudgetExhausted": {
+              "type": "string",
+              "enum": ["triage", "human", "stop"]
+            },
+            "onSecurityFinding": {
+              "type": "string",
+              "enum": ["human", "triage", "stop"]
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "actor": {
+      "type": "object",
+      "required": ["role", "writeAccess"],
+      "additionalProperties": false,
+      "properties": {
+        "role": {
+          "type": "string",
+          "minLength": 1
+        },
+        "writeAccess": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}

package/scripts/hooks/pre-compact.js

@@ -18,8 +18,16 @@ const {
   appendFile,
   log
 } = require('../lib/utils');
+const { recordCompactEvent } = require('../lib/context-window-state');
+
+async function main(rawInput = '{}') {
+  let input = {};
+  try {
+    input = JSON.parse(rawInput || '{}');
+  } catch (_) {
+    input = {};
+  }
 
-async function main() {
   const sessionsDir = getSessionsDir();
   const compactionLog = path.join(sessionsDir, 'compaction-log.txt');
 
@@ -27,7 +35,18 @@ async function main() {
 
   // Log compaction event with timestamp
   const timestamp = getDateTimeString();
-  appendFile(compactionLog, `[${timestamp}] Context compaction triggered\n`);
+  let compactEvent = null;
+  try {
+    compactEvent = recordCompactEvent(input, {
+      cwd: input.cwd || input.workspace?.current_dir || process.cwd(),
+    });
+  } catch (_) {
+    compactEvent = null;
+  }
+  const compactCountSuffix = compactEvent
+    ? ` (session compact #${compactEvent.sessionCompactCount}, total #${compactEvent.totalCompactCount})`
+    : '';
+  appendFile(compactionLog, `[${timestamp}] Context compaction triggered${compactCountSuffix}\n`);
 
   // If there's an active session file, note the compaction
   const sessions = findFiles(sessionsDir, '*-session.tmp');
@@ -35,14 +54,26 @@ async function main() {
   if (sessions.length > 0) {
     const activeSession = sessions[0].path;
     const timeStr = getTimeString();
-    appendFile(activeSession, `\n---\n**[Compaction occurred at ${timeStr}]** - Context was summarized\n`);
+    const countNote = compactEvent ? ` (compact #${compactEvent.sessionCompactCount})` : '';
+    appendFile(activeSession, `\n---\n**[Compaction occurred at ${timeStr}${countNote}]** - Context was summarized\n`);
   }
 
-  log('[PreCompact] State saved before compaction');
+  log(`[PreCompact] State saved before compaction${compactCountSuffix}`);
   process.exit(0);
 }
 
-main().catch(err => {
-  console.error('[PreCompact] Error:', err.message);
-  process.exit(0);
-});
+if (require.main === module) {
+  let input = '';
+  const stdinTimeout = setTimeout(() => main(input), 5000);
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => { input += chunk; });
+  process.stdin.on('end', () => {
+    clearTimeout(stdinTimeout);
+    main(input).catch(err => {
+      console.error('[PreCompact] Error:', err.message);
+      process.exit(0);
+    });
+  });
+}
+
+module.exports = { main };

package/scripts/hooks/session-start-goal-resume.js

@@ -11,34 +11,17 @@
  * session start output so the user knows they can resume with `/goal resume`.
  *
  * Behavior:
- *   1. Scans ~/.claude/goals/ for goal files with state "active" or "paused"
+ *   1. Scans the TSP loop state goals store for active or paused goal files
  *   2. If found, appends a summary to the hook output
  *   3. Non-blocking: failures are silently ignored
  */
 
 const fs = require('fs');
-const path = require('path');
-
-function getGoalsDir() {
-  const home = process.env.HOME || process.env.USERPROFILE || '';
-  return path.join(home, '.claude', 'goals');
-}
+const { listGoals } = require('../lib/loop-state-store');
 
 function scanActiveGoals() {
-  const dir = getGoalsDir();
-  if (!fs.existsSync(dir)) return [];
-
   try {
-    return fs.readdirSync(dir)
-      .filter(f => f.endsWith('.json'))
-      .map(f => {
-        try {
-          return JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'));
-        } catch {
-          return null;
-        }
-      })
-      .filter(g => g && (g.state === 'active' || g.state === 'paused'))
+    return [...listGoals('active'), ...listGoals('paused')]
       .sort((a, b) => new Date(b.updatedAt) - new Date(a.updatedAt));
   } catch {
     return [];