opencode-team-memory 1.0.2 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.2.0
+
+- Add `omo-resume` CLI — auto-restore team context on opencode launch
+- Three modes: `--always`, `--ask` (default), `--never`
+- Reads latest role state from `.omo/team-memory/`
+- Generates continuation prompt and passes to `opencode run`
+
+## 1.1.0
+
+- Add `formatContinuation()` — generates role-aware continuation prompt
+- Add `experimental.chat.system.transform` hook — injects role context at session start
+- Add Context-Mode compatible JSON metadata to compaction snapshots
+- Sessions now auto-restore role context on restart
+
+## 1.0.2
+
+- Fix `scripts/preflight.sh` inclusion in npm tarball
+
 ## 1.0.1
 
 - Add `scripts/preflight.sh` — automated installation check

package/README.md

@@ -3,6 +3,8 @@
 Persistent role-based memory for OpenCode + Oh-My-OpenCode(OmO) Team Mode.  
 Context survives across sessions, Team Mode runs, and compaction.
 
+**v1.1.0**: Auto-role restoration on session start — Agent recognizes its role without manual reload.
+
 ## Problem
 
 OmO Team Mode members are ephemeral — they die when the run ends (default: 120 min).  
@@ -24,6 +26,39 @@ Override with `OPENCODE_TEAM_MEMORY_DIR` env var.
 
 Compaction hook injects compact summaries automatically — long sessions keep context.
 
+## Auto-Role Restoration (v1.1.0)
+
+When opencode starts, the plugin checks saved role memory and injects a continuation prompt into the system prompt. The Agent automatically:
+
+1. Recognizes its role (engineer / tester / designer / director)
+2. Reads handoff state (who passed work and where it goes next)
+3. Sees recent NG items and critical decisions
+4. Knows confirmed and excluded scope
+
+**No manual `role_memory_load` required.** The session starts with full context.
+
+Output looks like:
+
+```
+## Team Continuation (opencode-team-memory)
+
+### Your Role: engineer
+### Handoff → tester
+### Status: ng_count=2
+### Critical Context
+use postgres; adopt JWT; add rate limit
+### Recent NG Items
+login redirect broken
+token expiry too short
+### Confirmed Scope
+- auth module
+
+### Instructions
+1. role_memory_load(role="engineer") before starting
+2. Handoff target is 'tester' — prepare output accordingly
+3. Address NG items first
+```
+
 ## Enable / Disable
 
 Toggle without editing config files. Restart `opencode` after switching.

package/bin/omo-resume

@@ -0,0 +1,147 @@
+#!/bin/sh
+# omo-resume — 前回のチーム状態を復元して opencode を起動
+# Usage: omo-resume [--always|--ask|--never]
+
+set -eu
+
+MEMORY_DIR="${OPENCODE_TEAM_MEMORY_DIR:-$(pwd)/.omo/team-memory}"
+MODE="${OPENCODE_TEAM_CONTINUE:-ask}"
+ROLES="engineer tester designer director"
+
+# CLI引数でモード上書き
+case "${1:-}" in
+  --always) MODE=always ;;
+  --ask)    MODE=ask ;;
+  --never)  MODE=never ;;
+  "")       ;;
+  *)        echo "Usage: omo-resume [--always|--ask|--never]" >&2; exit 1 ;;
+esac
+
+# never モード: 通常起動
+if [ "$MODE" = "never" ]; then
+  echo "Team continuation disabled. Starting opencode normally." >&2
+  exec opencode
+fi
+
+# メモリ読み取り
+latest_role=""
+latest_time=""
+found=0
+for role in $ROLES; do
+  file="$MEMORY_DIR/$role/context.json"
+  [ -f "$file" ] || continue
+  found=1
+  last_updated=$(python3 -c "
+import json,sys
+try:
+  d=json.load(open('$file'))
+  print(d.get('last_updated',''))
+except: pass
+" 2>/dev/null)
+  [ -n "$last_updated" ] || continue
+  if [ -z "$latest_time" ] || [ "$last_updated" \> "$latest_time" ]; then
+    latest_time="$last_updated"
+    latest_role="$role"
+  fi
+done
+
+# メモリがない場合: 通常起動
+if [ "$found" -eq 0 ] || [ -z "$latest_role" ]; then
+  echo "No previous team context found. Starting opencode normally." >&2
+  exec opencode
+fi
+
+# 復元プロンプト生成
+prompt=$(python3 -c "
+import json, sys
+
+file = '$MEMORY_DIR/$latest_role/context.json'
+with open(file) as f:
+    d = json.load(f)
+
+decisions = '; '.join(d.get('previous_decisions', [])[-3:]) or 'none'
+ng = d.get('ng_history', [])[-2:]
+handoff = d.get('handoff_to', '')
+confirmed = d.get('confirmed_scope', [])
+excluded = d.get('excluded_scope', [])
+
+lines = [
+    'Resume team work as $latest_role.',
+    '',
+    '## Team Continuation (omo-resume)',
+    '',
+    '### Your Role: $latest_role',
+]
+
+if handoff:
+    lines.append('### Handoff \u2192 ' + handoff)
+
+lines.extend([
+    '### Status: ng_count=' + str(len(d.get('ng_history', []))),
+    '',
+    '### Critical Context',
+    decisions,
+])
+
+if ng:
+    lines.append('')
+    lines.append('### Recent NG Items')
+    for item in ng:
+        lines.append('- ' + item)
+
+if confirmed:
+    lines.append('')
+    lines.append('### Confirmed Scope')
+    for s in confirmed:
+        lines.append('- ' + s)
+
+if excluded:
+    lines.append('')
+    lines.append('### Excluded (DO NOT TOUCH)')
+    for s in excluded:
+        lines.append('- ' + s)
+
+lines.extend([
+    '',
+    '### Instructions',
+    '1. role_memory_load(role=\"$latest_role\") to restore full context',
+])
+
+if handoff:
+    lines.append(\"2. Handoff target is '\" + handoff + \"'. Prepare accordingly.\")
+    if len(d.get('ng_history', [])) > 0:
+        lines.append('3. Address NG items before handoff.')
+elif len(d.get('ng_history', [])) > 0:
+    lines.append('2. Address NG items first.')
+
+lines.append('')
+print('\n'.join(lines))
+" 2>/dev/null)
+
+if [ -z "$prompt" ]; then
+  echo "Failed to generate continuation prompt. Starting opencode normally." >&2
+  exec opencode
+fi
+
+# 復元プロンプトを表示
+echo "" >&2
+echo "========================================" >&2
+echo " Team Continuation" >&2
+echo "========================================" >&2
+echo " Role:     $latest_role" >&2
+echo " Updated:  $latest_time" >&2
+echo " Mode:     $MODE" >&2
+echo "========================================" >&2
+echo "" >&2
+
+# ask モード: 確認
+if [ "$MODE" = "ask" ]; then
+  printf "Resume with this context? [Y/n] " >&2
+  read -r answer
+  case "$answer" in
+    [Nn]*) echo "Starting fresh session." >&2; exec opencode ;;
+  esac
+fi
+
+# always / ask(確認済み): opencode を起動
+exec opencode run "$prompt"

package/index.ts

@@ -2,7 +2,7 @@ import { type Plugin, tool } from "@opencode-ai/plugin"
 import { readFile, writeFile, mkdir, access } from "node:fs/promises"
 import { join } from "node:path"
 import { ALL_ROLES, EMPTY_MEMORY, type MemoryEntry, type Role, type SaveInput } from "./types"
-import { merge, format, formatCompact, formatSaveResult } from "./memory"
+import { merge, format, formatCompact, formatSaveResult, formatContinuation } from "./memory"
 
 function getMemoryBase(directory: string): string {
   return process.env.OPENCODE_TEAM_MEMORY_DIR || join(directory, ".omo", "team-memory")
@@ -95,13 +95,43 @@ export const TeamMemoryPlugin: Plugin = async ({ directory }) => {
       for (const role of ALL_ROLES) {
         try {
           const entry = await load(role)
-          if (entry) {
-            output.context.push(formatCompact(entry))
-          }
+          if (!entry) continue
+
+          // Human-readable compact summary
+          output.context.push(formatCompact(entry))
+
+          // Context-Mode compatible: structured metadata for FTS5 indexing
+          output.context.push(
+            JSON.stringify({
+              source: "opencode-team-memory",
+              role: entry.role,
+              handoff_to: entry.handoff_to,
+              ng_count: entry.ng_history.length,
+              decisions: entry.previous_decisions.slice(-3),
+              last_updated: entry.last_updated,
+            })
+          )
         } catch {
           // skip roles with no saved memory
         }
       }
     },
+
+    "experimental.chat.system.transform": async (_input, output) => {
+      const blocks: string[] = []
+      for (const role of ALL_ROLES) {
+        try {
+          const entry = await load(role)
+          if (!entry) continue
+          const block = formatContinuation(entry, role)
+          if (block) blocks.push(block)
+        } catch {
+          // skip corrupted files
+        }
+      }
+      if (blocks.length > 0) {
+        output.context.push(blocks.join("\n\n"))
+      }
+    },
   }
 }

package/memory.ts

@@ -97,3 +97,50 @@ export function formatSaveResult(entry: MemoryEntry): string {
     entry.handoff_to ? `  Next: → ${entry.handoff_to}` : "",
   ].join("\n")
 }
+
+export function formatContinuation(entry: MemoryEntry | null, role: Role): string {
+  if (!entry) return ""
+
+  const decisions = entry.previous_decisions.slice(-3).join("; ")
+  const ng = entry.ng_history.slice(-2)
+
+  const lines: string[] = [
+    "## Team Continuation (opencode-team-memory)",
+    "",
+    `### Your Role: ${role}`,
+  ]
+
+  if (entry.handoff_to) {
+    lines.push(`### Handoff → ${entry.handoff_to}`)
+  }
+
+  lines.push(`### Status: ng_count=${entry.ng_history.length}`)
+
+  if (decisions) {
+    lines.push(`### Critical Context\n${decisions}`)
+  }
+
+  if (ng.length > 0) {
+    lines.push(`### Recent NG Items\n${ng.join("\n")}`)
+  }
+
+  if (entry.confirmed_scope.length > 0) {
+    lines.push(`### Confirmed Scope\n${entry.confirmed_scope.map(s => `- ${s}`).join("\n")}`)
+  }
+
+  if (entry.excluded_scope.length > 0) {
+    lines.push(`### Excluded (DO NOT TOUCH)\n${entry.excluded_scope.map(s => `- ${s}`).join("\n")}`)
+  }
+
+  lines.push(
+    "",
+    "### Instructions",
+    `1. role_memory_load(role="${role}") before starting`,
+    entry.handoff_to ? `2. Handoff target is '${entry.handoff_to}' — prepare output accordingly` : "",
+    entry.ng_history.length > 0 ? `${entry.handoff_to ? "3" : "2"}. Address NG items first` : "",
+    "0. Resume work based on context above",
+    ""
+  )
+
+  return lines.filter(Boolean).join("\n")
+}

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "opencode-team-memory",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Persistent role-based memory for OpenCode/OmO Team Mode — survives across sessions and runs",
   "type": "module",
   "main": "index.ts",
+  "bin": {
+    "omo-resume": "bin/omo-resume"
+  },
   "files": [
     "index.ts",
     "types.ts",
     "memory.ts",
+    "bin/",
     "scripts/",
     "README.md",
     "LICENSE",

package/types.ts

@@ -42,3 +42,14 @@ export interface SaveInput {
   handoff_to?: string
   raw?: string
 }
+
+export interface ContinueState {
+  role: Role
+  handoff_to: string
+  last_action: string
+  ng_count: number
+  confirmed_scope: string[]
+  excluded_scope: string[]
+  decisions_summary: string
+  ng_summary: string
+}