@doingdev/opencode-claude-manager-plugin 0.1.10 → 0.1.12

package/dist/state/transcript-store.d.ts

@@ -0,0 +1,15 @@
+import type { ClaudeSessionEvent } from '../types/contracts.js';
+export declare class TranscriptStore {
+    private readonly baseDirectoryName;
+    constructor(baseDirectoryName?: string);
+    /**
+     * Append new events to the transcript file for the given session.
+     * Creates the file if it does not exist. Strips trailing partials before persisting.
+     */
+    appendEvents(cwd: string, sessionId: string, newEvents: ClaudeSessionEvent[]): Promise<void>;
+    /**
+     * Read all persisted transcript events for a session.
+     */
+    readEvents(cwd: string, sessionId: string): Promise<ClaudeSessionEvent[]>;
+    private getTranscriptPath;
+}

package/dist/state/transcript-store.js

@@ -0,0 +1,44 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { appendTranscriptEvents, stripTrailingPartials, } from '../util/transcript-append.js';
+import { isFileNotFoundError, writeJsonAtomically, } from '../util/fs-helpers.js';
+export class TranscriptStore {
+    baseDirectoryName;
+    constructor(baseDirectoryName = '.claude-manager') {
+        this.baseDirectoryName = baseDirectoryName;
+    }
+    /**
+     * Append new events to the transcript file for the given session.
+     * Creates the file if it does not exist. Strips trailing partials before persisting.
+     */
+    async appendEvents(cwd, sessionId, newEvents) {
+        if (newEvents.length === 0) {
+            return;
+        }
+        const filePath = this.getTranscriptPath(cwd, sessionId);
+        const existing = await this.readEvents(cwd, sessionId);
+        const merged = appendTranscriptEvents(existing, newEvents);
+        const cleaned = stripTrailingPartials(merged);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await writeJsonAtomically(filePath, cleaned);
+    }
+    /**
+     * Read all persisted transcript events for a session.
+     */
+    async readEvents(cwd, sessionId) {
+        const filePath = this.getTranscriptPath(cwd, sessionId);
+        try {
+            const content = await fs.readFile(filePath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            if (isFileNotFoundError(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    getTranscriptPath(cwd, sessionId) {
+        return path.join(cwd, this.baseDirectoryName, 'transcripts', `${sessionId}.json`);
+    }
+}

package/dist/types/contracts.d.ts

@@ -1,6 +1,11 @@
 export interface ManagerPromptRegistry {
     managerSystemPrompt: string;
-    subagentSystemPrompt: string;
+    claudeCodeSessionPrompt: string;
+    contextWarnings: {
+        moderate: string;
+        high: string;
+        critical: string;
+    };
 }
 export type ClaudeSettingSource = 'user' | 'project' | 'local';
 export interface ClaudeCommandMetadata {
@@ -39,12 +44,13 @@ export interface ClaudeMetadataSnapshot {
     settingsPaths: string[];
 }
 export interface ClaudeSessionEvent {
-    type: 'init' | 'assistant' | 'partial' | 'status' | 'system' | 'result' | 'error';
+    type: 'init' | 'assistant' | 'partial' | 'user' | 'tool_call' | 'status' | 'system' | 'result' | 'error';
     sessionId?: string;
     text: string;
     turns?: number;
     totalCostUsd?: number;
-    rawType: string;
+    /** Present on live SDK-normalized events; omitted when compact-persisted to save space. */
+    rawType?: string;
 }
 export interface RunClaudeSessionInput {
     cwd: string;
@@ -68,6 +74,9 @@ export interface ClaudeSessionRunResult {
     finalText: string;
     turns?: number;
     totalCostUsd?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    contextWindowSize?: number;
 }
 export interface ClaudeSessionSummary {
     sessionId: string;
@@ -88,58 +97,72 @@ export interface ClaudeCapabilitySnapshot {
     agents: ClaudeAgentMetadata[];
     models: string[];
 }
-export type ManagerRunMode = 'auto' | 'single' | 'split';
-export type ManagerRunStatus = 'pending' | 'running' | 'completed' | 'failed';
-export type WorktreeMode = 'shared-root' | 'git-worktree';
-export interface ManagedSubtaskPlan {
-    id: string;
-    title: string;
-    prompt: string;
-}
-export interface WorktreeAssignment {
-    mode: WorktreeMode;
-    cwd: string;
-    rootCwd: string;
-    branchName?: string;
+export type ContextWarningLevel = 'ok' | 'moderate' | 'high' | 'critical';
+export interface SessionContextSnapshot {
+    sessionId: string | null;
+    totalTurns: number;
+    totalCostUsd: number;
+    latestInputTokens: number | null;
+    latestOutputTokens: number | null;
+    contextWindowSize: number | null;
+    estimatedContextPercent: number | null;
+    warningLevel: ContextWarningLevel;
+    compactionCount: number;
+}
+export interface GitDiffResult {
+    hasDiff: boolean;
+    diffText: string;
+    stats: {
+        filesChanged: number;
+        insertions: number;
+        deletions: number;
+    };
+}
+export interface GitOperationResult {
+    success: boolean;
+    output: string;
+    error?: string;
 }
-export interface ManagedSessionRecord {
-    id: string;
-    title: string;
-    prompt: string;
-    status: ManagerRunStatus;
+export interface ActiveSessionState {
+    sessionId: string;
     cwd: string;
-    worktreeMode: WorktreeMode;
-    branchName?: string;
-    claudeSessionId?: string;
-    finalText?: string;
+    startedAt: string;
+    totalTurns: number;
+    totalCostUsd: number;
+    estimatedContextPercent: number | null;
+    contextWindowSize: number | null;
+    latestInputTokens: number | null;
+}
+export type PersistentRunStatus = 'running' | 'completed' | 'failed';
+export interface PersistentRunMessageRecord {
+    timestamp: string;
+    direction: 'sent' | 'received';
+    text: string;
     turns?: number;
     totalCostUsd?: number;
-    error?: string;
-    events: ClaudeSessionEvent[];
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface PersistentRunActionRecord {
+    timestamp: string;
+    type: 'git_diff' | 'git_commit' | 'git_reset' | 'compact' | 'clear';
+    result: string;
 }
-export interface ManagerRunRecord {
+export interface PersistentRunRecord {
     id: string;
     cwd: string;
     task: string;
-    mode: ManagerRunMode;
-    useWorktrees: boolean;
-    includeProjectSettings: boolean;
-    status: ManagerRunStatus;
+    status: PersistentRunStatus;
     createdAt: string;
     updatedAt: string;
-    metadata: ClaudeMetadataSnapshot;
-    sessions: ManagedSessionRecord[];
+    sessionId: string | null;
+    sessionHistory: string[];
+    messages: PersistentRunMessageRecord[];
+    actions: PersistentRunActionRecord[];
+    commits: string[];
+    context: SessionContextSnapshot;
     finalSummary?: string;
 }
-export interface ManagerTaskRequest {
-    cwd: string;
-    task: string;
-    mode?: ManagerRunMode;
-    maxSubagents?: number;
-    useWorktrees?: boolean;
-    includeProjectSettings?: boolean;
-    model?: string;
-}
-export interface ManagerRunResult {
-    run: ManagerRunRecord;
+export interface PersistentRunResult {
+    run: PersistentRunRecord;
 }

package/dist/util/fs-helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function writeJsonAtomically(filePath: string, data: unknown): Promise<void>;
+export declare function isFileNotFoundError(error: unknown): error is NodeJS.ErrnoException;

package/dist/util/fs-helpers.js

@@ -0,0 +1,12 @@
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+export async function writeJsonAtomically(filePath, data) {
+    const tempPath = `${filePath}.${randomUUID()}.tmp`;
+    await fs.writeFile(tempPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+    await fs.rename(tempPath, filePath);
+}
+export function isFileNotFoundError(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}

package/dist/util/transcript-append.d.ts

@@ -0,0 +1,7 @@
+import type { ClaudeSessionEvent } from '../types/contracts.js';
+export declare function stripTrailingPartials(events: ClaudeSessionEvent[]): ClaudeSessionEvent[];
+/**
+ * Append transcript events for run-state persistence: at most one trailing
+ * `partial`, dropped whenever a non-partial event is appended.
+ */
+export declare function appendTranscriptEvents(events: ClaudeSessionEvent[], incoming: ClaudeSessionEvent[]): ClaudeSessionEvent[];

package/dist/util/transcript-append.js

@@ -0,0 +1,29 @@
+export function stripTrailingPartials(events) {
+    let end = events.length;
+    while (end > 0 && events[end - 1].type === 'partial') {
+        end -= 1;
+    }
+    return end === events.length ? events : events.slice(0, end);
+}
+/**
+ * Append transcript events for run-state persistence: at most one trailing
+ * `partial`, dropped whenever a non-partial event is appended.
+ */
+export function appendTranscriptEvents(events, incoming) {
+    let next = events;
+    for (const event of incoming) {
+        if (event.type === 'partial') {
+            if (next.length > 0 && next[next.length - 1].type === 'partial') {
+                next = [...next.slice(0, -1), event];
+            }
+            else {
+                next = [...next, event];
+            }
+        }
+        else {
+            next = stripTrailingPartials(next);
+            next = [...next, event];
+        }
+    }
+    return next;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doingdev/opencode-claude-manager-plugin",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "OpenCode plugin that orchestrates Claude Code sessions.",
   "keywords": [
     "opencode",
@@ -25,14 +25,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "eslint .",
-    "format": "prettier --write .",
-    "test": "vitest run",
-    "release": "npm run build && npm version patch && npm publish"
-  },
   "engines": {
     "node": ">=22.0.0"
   },
@@ -48,9 +40,19 @@
     "@vitest/coverage-v8": "^4.1.0",
     "eslint": "^9.22.0",
     "globals": "^15.15.0",
+    "knip": "^6.0.2",
     "prettier": "^3.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.57.1",
     "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "test": "vitest run",
+    "knip": "knip",
+    "release": "pnpm run build && pnpm version patch && pnpm publish"
   }
-}
+}