opencode-hive 1.3.4 → 1.3.5

package/README.md

@@ -108,6 +108,32 @@ When using Dynamic Context Pruning (DCP), use a Hive-safe config in `~/.config/o
 
 For local plugin testing, keep OpenCode plugin entry as `"opencode-hive"` (not `"opencode-hive@latest"`).
 
+#### Compaction recovery and session re-anchoring
+
+OpenCode can compact long sessions. When that happens mid-orchestration or mid-task, Hive needs the session to recover its role and task boundaries without re-reading the whole repository.
+
+The plugin now persists durable session metadata and uses it during `experimental.session.compacting` to rebuild a compact re-anchor prompt.
+
+Where:
+
+- Global session state is written to `.hive/sessions.json`.
+- Feature-local mirrors are written to `.hive/features/<feature>/sessions.json`.
+- Session classification distinguishes `primary`, `subagent`, `task-worker`, and `unknown`.
+- Primary and subagent recovery can replay the stored user directive once after compaction.
+- For task workers, the re-anchor context can include `.hive/features/<feature>/tasks/<task>/worker-prompt.md`.
+
+Task-worker recovery is intentionally strict:
+
+- keep the same role
+- do not delegate
+- do not re-read the full codebase
+- re-read `worker-prompt.md`
+- continue from the last known point
+
+This split is deliberate: post-compaction replay is for primary/subagent intent, while task-worker recovery comes from durable worktree context plus `worker-prompt.md` so implementation sessions stay attached to the exact task contract.
+
+This matters most for `forager-worker` and forager-derived custom agents, because they are the sessions most likely to be compacted mid-implementation.
+
 ## Prompt Budgeting & Observability
 
 Hive automatically bounds worker prompt sizes to prevent context overflow and tool output truncation.
@@ -136,6 +162,8 @@ When limits are exceeded, content is truncated with `...[truncated]` markers and
 
 Large prompts are written to `.hive/features/<feature>/tasks/<task>/worker-prompt.md` and passed by file reference (`workerPromptPath`) rather than inlined in tool output. This prevents truncation of large prompts.
 
+That same `worker-prompt.md` path is also reused during compaction recovery so task workers can re-anchor to the exact task assignment after a compacted session resumes.
+
 ## Plan Format
 
 ```markdown
@@ -359,6 +387,13 @@ ID guardrails:
 - plugin-reserved aliases are blocked (`hive`, `architect`, `swarm`, `scout`, `forager`, `hygienic`, `receiver`)
 - operational IDs are blocked (`build`, `plan`, `code`)
 
+Compaction classification follows the base agent:
+
+- `forager-worker` derivatives are treated as `task-worker`
+- `hygienic-reviewer` derivatives are treated as `subagent`
+
+This ensures custom workers recover with the same execution constraints as their base role.
+
 ### Custom Models
 
 Override models for specific agents:

package/dist/hive-core/src/services/sessionService.d.ts

@@ -1,10 +1,17 @@
-import { SessionInfo } from '../types.js';
+import type { SessionInfo } from '../types.js';
 export declare class SessionService {
     private projectRoot;
     constructor(projectRoot: string);
+    private applySessionPatch;
     private getSessionsPath;
     private getSessions;
     private saveSessions;
+    private getGlobalSessions;
+    private saveGlobalSessions;
+    private updateGlobalSessions;
+    trackGlobal(sessionId: string, patch?: Partial<SessionInfo>): SessionInfo;
+    bindFeature(sessionId: string, featureName: string, patch?: Partial<SessionInfo>): SessionInfo;
+    getGlobal(sessionId: string): SessionInfo | undefined;
     track(featureName: string, sessionId: string, taskFolder?: string): SessionInfo;
     setMaster(featureName: string, sessionId: string): void;
     getMaster(featureName: string): string | undefined;

package/dist/hive-core/src/types.d.ts

@@ -120,9 +120,17 @@ export interface ContextFile {
     content: string;
     updatedAt: string;
 }
+export type SessionKind = 'primary' | 'subagent' | 'task-worker' | 'unknown';
 export interface SessionInfo {
     sessionId: string;
+    featureName?: string;
     taskFolder?: string;
+    agent?: string;
+    baseAgent?: string;
+    sessionKind?: SessionKind;
+    workerPromptPath?: string;
+    directivePrompt?: string;
+    replayDirectivePending?: boolean;
     startedAt: string;
     lastActiveAt: string;
     messageCount?: number;

package/dist/hive-core/src/utils/paths.d.ts

@@ -3,6 +3,7 @@ export declare function normalizePath(filePath: string): string;
 export declare function getHivePath(projectRoot: string): string;
 export declare function getFeaturesPath(projectRoot: string): string;
 export declare function getActiveFeaturePath(projectRoot: string): string;
+export declare function getGlobalSessionsPath(projectRoot: string): string;
 export declare function listFeatureDirectories(projectRoot: string): FeatureDirectoryInfo[];
 export declare function resolveFeatureDirectoryName(projectRoot: string, featureName: string): string;
 export declare function getNextIndexedFeatureDirectoryName(projectRoot: string, featureName: string): string;