opencodekit 0.16.10 → 0.16.12

package/dist/index.js

@@ -759,7 +759,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "opencodekit",
-  version: "0.16.10",
+  version: "0.16.12",
   description: "CLI tool for bootstrapping and managing OpenCodeKit projects",
   keywords: ["agents", "cli", "mcp", "opencode", "opencodekit", "template"],
   license: "MIT",

package/dist/template/.opencode/AGENTS.md

@@ -206,6 +206,8 @@ skill({ name: "context-management" });
 | Task tracking                | `beads`                          |
 | Before claiming done         | `verification-before-completion` |
 | Context growing large        | `context-management`             |
+| Context compaction/handoff   | `compaction`                     |
+| Multi-agent team work        | `agent-teams`                    |
 | Writing tests                | `test-driven-development`        |
 | Debugging                    | `systematic-debugging`           |
 | Parallel work (3+ tasks)     | `swarm-coordination`             |

package/dist/template/.opencode/command/handoff.md

@@ -14,6 +14,7 @@ You're pausing work on a task. Save state so the next session can pick up cleanl
 skill({ name: "beads" });
 skill({ name: "session-management" });
 skill({ name: "memory-system" });
+skill({ name: "compaction" }); // Context compaction strategies before handoff
 ```
 
 ## Check Memory for Context
@@ -40,6 +41,42 @@ Review findings to include relevant context in the handoff.
 
 Don't grind past diminishing returns. A clean handoff beats degraded output.
 
+## Context Compaction (Before Handoff)
+
+Before creating the handoff document, compact context to preserve maximum signal:
+
+```typescript
+// Assess current context health using compaction skill thresholds
+// 🟢 0-50%: No action needed
+// 🟡 50-75%: Distill completed tool outputs
+// 🟠 75-90%: Compress completed phases
+// 🔴 90-95%: Aggressive prune + compress
+// ⛔ 95%+: Emergency handoff (skip to handoff creation)
+
+// Step 1: Distill valuable tool outputs you've already processed
+distill({
+  targets: [
+    // Distill any read/grep/lsp outputs that contain findings worth preserving
+    { id: "<tool-id>", distillation: "<high-fidelity technical summary>" },
+  ],
+});
+
+// Step 2: Compress completed conversation phases
+compress({
+  topic: "<phase name>",
+  content: {
+    startString: "<unique start>",
+    endString: "<unique end>",
+    summary: "<exhaustive technical summary of what transpired>",
+  },
+});
+
+// Step 3: Prune noise (failed attempts, irrelevant outputs)
+prune({ ids: ["<noise-tool-ids>"] });
+```
+
+This ensures the handoff document captures the distilled understanding, not raw noise.
+
 ## Gather State
 
 Get current task status:

package/dist/template/.opencode/command/start.md

@@ -31,6 +31,12 @@ skill({ name: "beads-bridge" }); // For cross-session todo coordination
 skill({ name: "prd" }); // PRD creation workflow
 skill({ name: "prd-task" }); // PRD to executable tasks conversion
 skill({ name: "memory-system" });
+
+// Load conditionally based on flags
+if (flags.includes("--parallel")) {
+  skill({ name: "swarm-coordination" }); // Parallel work orchestration
+  skill({ name: "agent-teams" }); // Team patterns and coordination
+}
 ```
 
 ## Ensure Git Hooks Installed

package/dist/template/.opencode/command/status.md

@@ -177,9 +177,16 @@ CONTEXT STATUS
 ━━━━━━━━━━━━━━
 Current Session: ses_xyz999
 Token Usage:     ~85,000 (estimated)
-Status:          🟡 Consider pruning soon
+Context Zone:    🟠 ORANGE (50-75%)
+Status:          Distill completed tool outputs
 
-Recommendation: Prune completed tool outputs before next major task
+Compaction Strategy:
+→ distill: Condense valuable tool outputs into summaries
+→ compress: Squash completed conversation phases
+→ prune: Remove noise and irrelevant outputs
+→ /handoff: Full session handoff when near limit
+
+Recommendation: Distill large tool outputs from completed exploration
 
 
 REQUIRED ACTIONS
@@ -243,20 +250,39 @@ Recent learnings:
 ### Context Health
 
 ```typescript
-// Estimate current context usage
+// Load compaction skill for threshold-aware context assessment
+skill({ name: "compaction" });
+
+// Assess context health using compaction thresholds
+// These thresholds match the compaction skill's zones:
+const contextZone = (usage) => {
+  if (usage < 50) return { zone: "🟢 GREEN", action: "No action needed" };
+  if (usage < 75) return { zone: "🟡 YELLOW", action: "Distill completed tool outputs" };
+  if (usage < 90) return { zone: "🟠 ORANGE", action: "Compress completed phases" };
+  if (usage < 95) return { zone: "🔴 RED", action: "Aggressive prune + compress" };
+  return { zone: "⛔ CRITICAL", action: "Emergency /handoff now" };
+};
+
+// Context health warnings
 const contextWarnings = [];
 
-if (estimatedTokens > 120000) {
-  contextWarnings.push("⚠️ High token usage - consider new session");
+if (estimatedTokens > 150000) {
+  contextWarnings.push("⛔ CRITICAL: Near context limit - run /handoff immediately");
+} else if (estimatedTokens > 120000) {
+  contextWarnings.push("🔴 HIGH: Compress completed phases, prune noise");
+} else if (estimatedTokens > 80000) {
+  contextWarnings.push("🟠 ELEVATED: Distill completed tool outputs");
+} else if (estimatedTokens > 50000) {
+  contextWarnings.push("🟡 MODERATE: Consider distilling large tool outputs");
 }
 
 if (sessionDuration > 3 * 60 * 60 * 1000) {
   // 3 hours
-  contextWarnings.push("⚠️ Long session - context may be degraded");
+  contextWarnings.push("⚠️ Long session - context quality may be degraded");
 }
 
 if (toolCallCount > 200) {
-  contextWarnings.push("⚠️ Many tool calls - prune old outputs");
+  contextWarnings.push("⚠️ Many tool calls - prune completed outputs");
 }
 ```
 

package/dist/template/.opencode/dcp.jsonc

@@ -1,81 +1,81 @@
 {
-	"$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
-	"enabled": true,
-	"debug": false,
-	// "minimal" shows prune activity without noise; "detailed" shows token counts
-	"pruneNotification": "off",
-	// "chat" (in-conversation) or "toast" (system notification)
-	"pruneNotificationType": "chat",
-	// Commands: /dcp context, /dcp stats, /dcp sweep
-	"commands": {
-		"enabled": true,
-		// Protect these from /dcp sweep
-		"protectedTools": ["observation", "memory-update", "memory-search"]
-	},
-	"turnProtection": {
-		"enabled": true,
-		"turns": 4
-	},
-	// Protected file patterns - never auto-prune reads of these files
-	"protectedFilePatterns": [
-		"**/.env*",
-		"**/AGENTS.md",
-		"**/.opencode/**",
-		"**/.beads/**",
-		"**/package.json",
-		"**/tsconfig.json",
-		"**/biome.json"
-	],
-	"tools": {
-		"settings": {
-			"nudgeEnabled": true,
-			"nudgeFrequency": 10,
-			// Trigger compression at ~94% of Copilot's 128k context limit
-			"contextLimit": 120000,
-			// Protect state-modifying and critical workflow tools
-			// LSP excluded: ephemeral exploration, prune after understanding
-			"protectedTools": [
-				"write",
-				"edit",
-				"memory-update",
-				"observation",
-				"skill",
-				"skill_mcp",
-				"task",
-				"batch",
-				"todowrite",
-				"todoread"
-			]
-		},
-		// v2.0.0: permission model - "allow", "ask", or "deny"
-		"prune": {
-			"permission": "allow"
-		},
-		"distill": {
-			"permission": "allow",
-			"showDistillation": false
-		},
-		"compress": {
-			"permission": "ask",
-			"showCompression": false
-		}
-	},
-	"strategies": {
-		// Dedup = zero LLM cost, high impact - always enable
-		"deduplication": {
-			"enabled": true,
-			"protectedTools": []
-		},
-		// Supersede writes = zero cost, removes redundant write inputs after read
-		// Note: default changed to false in beta, we explicitly enable
-		"supersedeWrites": {
-			"enabled": true
-		},
-		// Purge error inputs after N turns
-		"purgeErrors": {
-			"enabled": true,
-			"turns": 4,
-			"protectedTools": []
-		}
-	}
+  "$schema": "https://raw.githubusercontent.com/Opencode-DCP/opencode-dynamic-context-pruning/master/dcp.schema.json",
+  "enabled": true,
+  "debug": false,
+  // "minimal" shows prune activity without noise; "detailed" shows token counts
+  "pruneNotification": "off",
+  // "chat" (in-conversation) or "toast" (system notification)
+  "pruneNotificationType": "chat",
+  // Commands: /dcp context, /dcp stats, /dcp sweep
+  "commands": {
+    "enabled": true,
+    // Protect these from /dcp sweep
+    "protectedTools": ["observation", "memory-update", "memory-search"],
+  },
+  "turnProtection": {
+    "enabled": true,
+    "turns": 4,
+  },
+  // Protected file patterns - never auto-prune reads of these files
+  "protectedFilePatterns": [
+    "**/.env*",
+    "**/AGENTS.md",
+    "**/.opencode/**",
+    "**/.beads/**",
+    "**/package.json",
+    "**/tsconfig.json",
+    "**/biome.json",
+  ],
+  "tools": {
+    "settings": {
+      "nudgeEnabled": true,
+      "nudgeFrequency": 10,
+      // Trigger compression at ~94% of Copilot's 128k context limit
+      "contextLimit": 136000,
+      // Protect state-modifying and critical workflow tools
+      // LSP excluded: ephemeral exploration, prune after understanding
+      "protectedTools": [
+        "write",
+        "edit",
+        "memory-update",
+        "observation",
+        "skill",
+        "skill_mcp",
+        "task",
+        "batch",
+        "todowrite",
+        "todoread",
+      ],
+    },
+    // v2.0.0: permission model - "allow", "ask", or "deny"
+    "prune": {
+      "permission": "allow",
+    },
+    "distill": {
+      "permission": "allow",
+      "showDistillation": false,
+    },
+    "compress": {
+      "permission": "ask",
+      "showCompression": false,
+    },
+  },
+  "strategies": {
+    // Dedup = zero LLM cost, high impact - always enable
+    "deduplication": {
+      "enabled": true,
+      "protectedTools": [],
+    },
+    // Supersede writes = zero cost, removes redundant write inputs after read
+    // Note: default changed to false in beta, we explicitly enable
+    "supersedeWrites": {
+      "enabled": true,
+    },
+    // Purge error inputs after N turns
+    "purgeErrors": {
+      "enabled": true,
+      "turns": 4,
+      "protectedTools": [],
+    },
+  },
 }