@colin4k1024/tsp 2.5.0 → 2.5.2

package/hooks/strategic-compact/README.md

@@ -4,11 +4,11 @@
 
 ## 当前状态
 
-✅ **已实现** - 通过 `scripts/hooks/pre_compact.py` 和 `scripts/hooks/suggest_compact.py` 提供完整功能。
+✅ **已实现** - 通过 `scripts/hooks/pre-compact.js` 和 `scripts/hooks/suggest-compact.js` 提供完整功能。
 
 ## 实现细节
 
-### pre_compact.py
+### pre-compact.js
 
 **触发时机**: 上下文压缩前自动调用
 
@@ -25,12 +25,14 @@
 - 总是丢弃的类型：`tool_result`, `search_result`, `exploration_trace`（超过 500 字符时）
 - 其他根据上下文大小决定
 
-### suggest_compact.py
+### suggest-compact.js
 
-**触发时机**: 上下文使用超过 70% 时自动调用
+**触发时机**: `hooks/hooks.json` 的 `pre:all:strategic-compact` 在工具调用前运行；当真实上下文使用超过 70% 时注入 `/compact` 建议。
 
 **功能**:
-- 计算上下文使用率
+- 优先读取 Claude hook 输入里的 `context_window.used_percentage` / `context_window.remaining_percentage`
+- 其次读取 `CLAUDE_CONTEXT_SIZE` / `CLAUDE_CONTEXT_LIMIT`
+- 最后读取 `harness-statusline.js` 写入的 `/tmp/harness-ctx-{session_id}.json`
 - 评估紧迫度：`low` (< 70%) | `medium` (70-85%) | `high` (85-95%) | `critical` (> 95%)
 - 估算可节省的 token
 - 提供具体压缩建议：

package/hooks/strategic-compact/suggest-compact.js

@@ -1,100 +1,14 @@
 #!/usr/bin/env node
-// suggest-compact.js — SuggestCompact hook
-// JS equivalent of scripts/hooks/suggest_compact.py
-//
-// Called when context is getting large. Analyses usage ratio and outputs
-// compact suggestions + reorganisation plan.
-//
-// Reads context metrics from:
-//   1. stdin JSON ({ context_window: { used_percentage, remaining_percentage } })
-//   2. env vars  (CLAUDE_CONTEXT_SIZE, CLAUDE_CONTEXT_LIMIT)
-//   3. bridge file /tmp/harness-ctx-{session_id}.json (written by harness-statusline.js)
-//
-// Silent-fail: any error → process.exit(0)
+/**
+ * Compatibility entry for older strategic-compact hook paths.
+ *
+ * The canonical implementation lives in scripts/hooks/suggest-compact.js so
+ * hooks.json, installers, tests, and audits share one behavior.
+ */
 
 'use strict';
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Urgency thresholds (context usage %)
-const URGENCY = [
-  [95, 'critical'],
-  [85, 'high'],
-  [70, 'medium'],
-  [ 0, 'low'],
-];
-
-function getUrgency(usagePct) {
-  for (const [threshold, label] of URGENCY) {
-    if (usagePct > threshold) return label;
-  }
-  return 'low';
-}
-
-function buildSuggestions(usagePct, contextSize) {
-  const suggestions = [];
-  let savings = 0;
-
-  if (usagePct > 85) {
-    const s = Math.round(contextSize * 0.15);
-    suggestions.push({
-      action: 'summarize',
-      target: 'early conversation history',
-      reason: 'Preserve decisions and conclusions, compress exploration traces',
-      estimated_tokens_saved: s,
-    });
-    savings += s;
-  }
-
-  if (usagePct > 70) {
-    const s = Math.round(contextSize * 0.10);
-    suggestions.push({
-      action: 'discard',
-      target: 'tool results and search outputs',
-      reason: 'These are reference-only, not critical for continuity',
-      estimated_tokens_saved: s,
-    });
-    savings += s;
-  }
-
-  if (usagePct > 60) {
-    const s = Math.round(contextSize * 0.08);
-    suggestions.push({
-      action: 'reorganize',
-      target: 'specialist outputs',
-      reason: 'Move key conclusions to session summary, keep full outputs in memory store',
-      estimated_tokens_saved: s,
-    });
-    savings += s;
-  }
-
-  return { suggestions, savings };
-}
-
-function buildReorganizationPlan() {
-  return {
-    phase_1: {
-      action: 'save_decisions_to_memory',
-      description: 'Extract all decisions and save to ~/.claude/memory/error_experience/decisions/',
-    },
-    phase_2: {
-      action: 'save_pending_items',
-      description: 'Extract pending items and next hints to session summary',
-    },
-    phase_3: {
-      action: 'compress_conversation',
-      description: 'Keep system prompts and last 20 exchanges, summarize middle',
-    },
-    phase_4: {
-      action: 'compact_tool_results',
-      description: 'Replace long tool outputs with summaries: [File X read, Y lines]',
-    },
-  };
-}
-
-// ─── main ───────────────────────────────────────────────────────────────────
+const { buildHookOutput } = require('../../scripts/hooks/suggest-compact');
 
 let input = '';
 const stdinTimeout = setTimeout(() => process.exit(0), 8000);
@@ -103,87 +17,8 @@ process.stdin.on('data', chunk => { input += chunk; });
 process.stdin.on('end', () => {
   clearTimeout(stdinTimeout);
   try {
-    let data = {};
-    try { data = JSON.parse(input || '{}'); } catch (_) { /* ignore */ }
-
-    const sessionId = data.session_id || '';
-
-    // ── Resolve context metrics (3 sources, first wins) ──
-    let usagePct  = null;
-    let contextSize  = 0;
-    let contextLimit = 200000;
-
-    // Source 1: stdin context_window
-    const cw = data.context_window;
-    if (cw && cw.used_percentage != null) {
-      usagePct  = cw.used_percentage;
-      contextSize = Math.round((usagePct / 100) * contextLimit);
-    }
-
-    // Source 2: env vars
-    if (usagePct == null) {
-      const envSize  = parseInt(process.env.CLAUDE_CONTEXT_SIZE  || '0', 10);
-      const envLimit = parseInt(process.env.CLAUDE_CONTEXT_LIMIT || '200000', 10);
-      if (envSize > 0) {
-        contextSize  = envSize;
-        contextLimit = envLimit;
-        usagePct     = Math.round((envSize / envLimit) * 100);
-      }
-    }
-
-    // Source 3: bridge file from harness-statusline.js
-    if (usagePct == null && sessionId) {
-      const bridgePath = path.join(os.tmpdir(), `harness-ctx-${sessionId}.json`);
-      if (fs.existsSync(bridgePath)) {
-        try {
-          const bridge = JSON.parse(fs.readFileSync(bridgePath, 'utf8'));
-          usagePct  = bridge.used_pct ?? null;
-          contextSize = usagePct != null ? Math.round((usagePct / 100) * contextLimit) : 0;
-        } catch (_) { /* ignore */ }
-      }
-    }
-
-    if (usagePct == null) {
-      process.exit(0); // No metrics available — nothing to suggest
-    }
-
-    const urgency       = getUrgency(usagePct);
-    const shouldCompact = usagePct > 70;
-
-    const { suggestions, savings } = buildSuggestions(usagePct, contextSize);
-    const reorganizationPlan = shouldCompact ? buildReorganizationPlan() : null;
-
-    const payload = {
-      should_compact: shouldCompact,
-      urgency,
-      context_usage_ratio: usagePct,
-      estimated_token_savings: savings,
-      suggestions,
-      reorganization_plan: reorganizationPlan,
-    };
-
-    const _msg = `Compact suggestion: ${urgency} urgency, ~${savings} tokens could be saved`;
-
-    // Build context advisory (only inject if compact is warranted)
-    if (!shouldCompact) {
-      process.exit(0);
-    }
-
-    const urgencyEmoji = { critical: '🔴', high: '🟠', medium: '🟡', low: '🟢' }[urgency] ?? '⚪';
-    const ctx = [
-      `## 上下文压缩建议 ${urgencyEmoji} (strategic-compact)`,
-      `- 使用率: ${usagePct}% | 紧迫度: ${urgency} | 可节省: ~${savings} tokens`,
-      ...suggestions.map(s => `- [${s.action}] ${s.target}: ${s.reason}`),
-    ].join('\n');
-
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'SuggestCompact',
-        additionalContext: ctx,
-      },
-      compactSuggestion: payload,
-    }));
-
+    const output = buildHookOutput(input);
+    if (output) process.stdout.write(JSON.stringify(output));
   } catch (_) {
     process.exit(0);
   }

package/marketplace.json

@@ -3,8 +3,8 @@
   "name": "team-skills-platform",
   "description": "Role-based Team Skills platform with an ECC-style harness skeleton, specialist agents, commands, rules, hooks skeleton, contexts, and curated engineering skills.",
   "owner": {
-    "name": "Colin4k1024",
-    "email": "colin4k1024@gmail.com"
+    "name": "Engineering Team",
+    "email": "engineering@example.com"
   },
   "metadata": {
     "description": "Hybrid role platform plus ECC-style harness skeleton"
@@ -14,14 +14,13 @@
       "name": "team-skills-platform",
       "source": "./",
       "description": "Team-oriented workflow plugin with role agents, 27 specialist agents, ECC-inspired commands, layered rules, and hooks skeleton.",
-      "version": "2.5.0",
-      "icon": "./assets/icon.png",
+      "version": "2.3.0",
       "author": {
-        "name": "Colin4k1024",
-        "email": "colin4k1024@gmail.com"
+        "name": "Engineering Team",
+        "email": "engineering@example.com"
       },
-      "homepage": "https://github.com/Colin4k1024/tsp",
-      "repository": "https://github.com/Colin4k1024/tsp",
+      "homepage": "https://github.com/affaan-m/everything-claude-code",
+      "repository": "https://github.com/affaan-m/everything-claude-code",
       "license": "MIT",
       "keywords": [
         "team-skills",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colin4k1024/tsp",
-  "version": "2.5.0",
+  "version": "2.5.2",
   "description": "Open-source Team Skills Platform for role-based AI delivery workflows, shared skills, hooks, commands, and multi-platform installs.",
   "repository": {
     "type": "git",

package/schemas/goal.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ECC Goal Definition",
+  "description": "Schema for goal-oriented autonomous loop with external completion oracle",
+  "type": "object",
+  "properties": {
+    "goalId": {
+      "type": "string",
+      "pattern": "^goal-[a-z0-9]{8}$",
+      "description": "Unique goal identifier"
+    },
+    "objective": {
+      "type": "string",
+      "minLength": 5,
+      "description": "Natural language description of the goal"
+    },
+    "stoppingConditions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["test_pass", "lint_clean", "coverage_threshold", "build_pass", "custom_command"],
+            "description": "Type of stopping condition"
+          },
+          "command": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Shell command to evaluate the condition"
+          },
+          "threshold": {
+            "type": "number",
+            "description": "Numeric threshold for the condition (e.g., coverage percentage)"
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable description of what this condition checks"
+          }
+        },
+        "required": ["type", "command"],
+        "additionalProperties": false
+      }
+    },
+    "budget": {
+      "type": "object",
+      "properties": {
+        "maxIterations": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 15,
+          "description": "Maximum maker iterations before escalation"
+        },
+        "maxDuration": {
+          "type": "string",
+          "pattern": "^[0-9]+(m|h)$",
+          "default": "2h",
+          "description": "Maximum wall-clock time (e.g., '30m', '2h')"
+        },
+        "maxDollars": {
+          "type": "number",
+          "minimum": 0.1,
+          "default": 10,
+          "description": "Maximum cost in USD before pausing"
+        }
+      },
+      "additionalProperties": false
+    },
+    "oracle": {
+      "type": "object",
+      "properties": {
+        "model": {
+          "type": "string",
+          "default": "haiku",
+          "description": "Model to use for completion verification (must differ from maker)"
+        },
+        "allowedTools": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": ["Read", "Bash"],
+          "description": "Tools the oracle can use (read-only by convention)"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Custom oracle prompt override (optional)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "state": {
+      "type": "string",
+      "enum": ["active", "paused", "converged", "escalated", "failed"],
+      "default": "active",
+      "description": "Current goal lifecycle state"
+    },
+    "currentIteration": {
+      "type": "integer",
+      "minimum": 0,
+      "default": 0
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "history": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "iteration": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "makerSummary": {
+            "type": "string",
+            "description": "Brief summary of what the maker did this iteration"
+          },
+          "oracleVerdict": {
+            "type": "string",
+            "enum": ["pass", "fail", "partial"],
+            "description": "Oracle's assessment of stopping conditions"
+          },
+          "failReasons": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Specific reasons for failure"
+          },
+          "nextHint": {
+            "type": "string",
+            "description": "Oracle's guidance for the next iteration"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "costDollars": {
+            "type": "number",
+            "description": "Cost of this iteration"
+          }
+        },
+        "required": ["iteration", "oracleVerdict", "timestamp"],
+        "additionalProperties": false
+      }
+    },
+    "escalation": {
+      "type": "object",
+      "properties": {
+        "reason": {
+          "type": "string",
+          "enum": ["budget_exhausted", "repeated_failure", "oracle_uncertain", "manual"],
+          "description": "Why the goal was escalated"
+        },
+        "details": {
+          "type": "string"
+        },
+        "escalatedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["goalId", "objective", "stoppingConditions", "state"],
+  "additionalProperties": false
+}

package/scripts/harness-audit.js

@@ -203,6 +203,9 @@ function getRepoChecks(rootDir) {
   const commandPrimary = safeRead(rootDir, 'commands/harness-audit.md').trim();
   const commandParity = safeRead(rootDir, '.opencode/commands/harness-audit.md').trim();
   const hooksJson = safeRead(rootDir, 'hooks/hooks.json');
+  const hasStrategicCompactHook =
+    hooksJson.includes('pre:all:strategic-compact') &&
+    hooksJson.includes('scripts/hooks/suggest-compact.js');
 
   return [
     {
@@ -270,10 +273,10 @@ function getRepoChecks(rootDir) {
       category: 'Context Efficiency',
       points: 3,
       scopes: ['repo', 'hooks'],
-      path: 'scripts/hooks/suggest-compact.js',
-      description: 'Suggest-compact automation hook exists',
-      pass: fileExists(rootDir, 'scripts/hooks/suggest-compact.js'),
-      fix: 'Implement scripts/hooks/suggest-compact.js for context pressure hints.',
+      path: 'hooks/hooks.json',
+      description: 'Suggest-compact automation is registered for strategic context pressure hints',
+      pass: fileExists(rootDir, 'scripts/hooks/suggest-compact.js') && hasStrategicCompactHook,
+      fix: 'Register pre:all:strategic-compact in hooks/hooks.json and point it at scripts/hooks/suggest-compact.js.',
     },
     {
       id: 'context-model-route',

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

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * session-start-goal-resume.js
+ *
+ * SessionStart hook that checks for active goals and injects a resume reminder.
+ *
+ * Part of the Loop Engineering upgrade (Phase 1.3: Inter-session state bridge).
+ * When active goals exist from a previous session, this hook adds context to the
+ * 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"
+ *   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');
+}
+
+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'))
+      .sort((a, b) => new Date(b.updatedAt) - new Date(a.updatedAt));
+  } catch {
+    return [];
+  }
+}
+
+function formatGoalSummary(goal) {
+  const stateIcon = goal.state === 'active' ? '▶' : '⏸';
+  const progress = `${goal.currentIteration}/${goal.budget?.maxIterations || 15}`;
+  const lastHint = goal.history?.length > 0
+    ? goal.history[goal.history.length - 1].nextHint || ''
+    : '';
+  return `  ${stateIcon} [${goal.goalId}] "${goal.objective}" (iter ${progress})${lastHint ? `\n    Last hint: ${lastHint.slice(0, 120)}` : ''}`;
+}
+
+function main() {
+  let raw = '';
+  try {
+    raw = fs.readFileSync(0, 'utf8');
+  } catch {
+    // stdin may not be available
+  }
+
+  const activeGoals = scanActiveGoals();
+
+  if (activeGoals.length === 0) {
+    process.stdout.write(raw);
+    return;
+  }
+
+  // Parse the input event and add goal context
+  let event;
+  try {
+    event = JSON.parse(raw);
+  } catch {
+    process.stdout.write(raw);
+    return;
+  }
+
+  const goalSummary = activeGoals.map(formatGoalSummary).join('\n');
+  const message = `\n[Loop Engineering] ${activeGoals.length} active goal(s) from previous session:\n${goalSummary}\n\nResume with: /goal resume\n`;
+
+  // Inject into session context if possible
+  if (event && typeof event === 'object') {
+    if (!event.additionalContext) {
+      event.additionalContext = '';
+    }
+    event.additionalContext += message;
+  }
+
+  process.stdout.write(JSON.stringify(event));
+}
+
+main();