autodev-cli 1.4.0 → 1.4.3

package/out/openCodeHooksManager.js

@@ -0,0 +1,511 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOpenCodeHooksInstalled = isOpenCodeHooksInstalled;
+exports.installOpenCodeHooks = installOpenCodeHooks;
+exports.isOpenCodeCliActive = isOpenCodeCliActive;
+exports.openCodeExitedCleanly = openCodeExitedCleanly;
+exports.getOpenCodeSessionIdFromHooks = getOpenCodeSessionIdFromHooks;
+exports.uninstallOpenCodeHooks = uninstallOpenCodeHooks;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ---------------------------------------------------------------------------
+// OpenCode hooks manager — installs/removes an OpenCode plugin that appends
+// hook events to <workspaceRoot>/.autodev/hooks-events.jsonl in the same
+// format as the Claude Code hooks, so the task loop can stream them to
+// Pixel Office.
+//
+// The plugin is placed at <workspaceRoot>/.opencode/plugins/autodev-hooks.ts
+// OpenCode discovers plugins in that directory automatically.
+// ---------------------------------------------------------------------------
+const PLUGIN_FILENAME = 'autodev-hooks.ts';
+const PLUGIN_MARKER = '// __autodev_opencode_hooks__';
+function pluginDir(workspaceRoot) {
+    return path.join(workspaceRoot, '.opencode', 'plugins');
+}
+function pluginPath(workspaceRoot) {
+    return path.join(pluginDir(workspaceRoot), PLUGIN_FILENAME);
+}
+// ---------------------------------------------------------------------------
+// Plugin content — TypeScript executed by OpenCode/Bun at runtime.
+// The JSONL path is baked in at install time (workspace-scoped, forward
+// slashes only so Bun/Windows path handling doesn't break the string).
+// ---------------------------------------------------------------------------
+function buildPluginContent(workspaceRoot) {
+    // Bake in the workspace-scoped JSONL dir with forward slashes so the
+    // plugin always writes to the right place regardless of the process cwd.
+    const autodevDir = JSON.stringify(path.join(workspaceRoot, '.autodev').replace(/\\/g, '/'));
+    return `${PLUGIN_MARKER}
+// AutoDev hooks plugin for OpenCode — auto-generated, do not edit.
+// Streams tool/session events to Pixel Office via <workspaceRoot>/.autodev/
+import { appendFileSync, mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+
+// Dir is baked in at install time (workspace-scoped, always forward slashes)
+const AUTODEV_DIR: string = ${autodevDir};
+// Global file for session-ID discovery; per-session files for state tracking
+const GLOBAL_JSONL = join(AUTODEV_DIR, 'hooks-events.jsonl');
+
+function sessionJsonlPath(sessionId: string | null): string | null {
+  if (!sessionId) { return null; }
+  // Replace chars that are unsafe in filenames but keep the ID readable
+  const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+  return join(AUTODEV_DIR, \`hooks-events-\${safe}.jsonl\`);
+}
+
+// High-frequency / large-payload events we intentionally skip in the generic catch-all
+// (tool events have dedicated hooks; these are too noisy or already handled explicitly)
+const SKIP_EVENTS = new Set([
+  'message.part.delta',
+  'message.part.removed',
+  'message.part.updated', // replaced by session.next.text.ended (simpler, same data)
+  'message.updated',      // role-tracking no longer needed
+  'message.removed',
+  'session.diff',
+  // Explicit named hooks — don't double-log
+  'tool.execute.before',
+  'tool.execute.after',
+  'permission.asked',
+  'permission.replied',
+  'tui.prompt.append',
+  'tui.command.execute',
+  'tui.toast.show',
+  'command.executed',
+  'file.edited',
+  // session.next.* lifecycle markers with no payload — skip the noisy ones
+  'session.next.step.started',
+  'session.next.reasoning.started',
+  'session.next.text.started',
+  'session.next.tool.input.started',
+  'session.next.tool.input.ended',
+  'session.next.tool.called',
+  'session.next.tool.success',
+  // session.next.tool.failed is NOT skipped — captures error message for failed tool calls
+]);
+
+const SESSION_MAP: Record<string, string> = {
+  'session.created':    'SessionStart',
+  'session.idle':       'Stop',
+  'session.error':      'StopFailure',
+  'session.deleted':    'SessionEnd',
+  'session.compacted':  'PostCompact',
+  'session.updated':    'SessionStatus',
+  'session.status':     'SessionStatus',
+  'message.removed':    'MessageRemoved',
+  'todo.updated':       'TaskCreated',
+  'command.executed':   'CommandExecuted',
+  'file.edited':        'FileEdited',
+  'file.watcher.updated': 'FileWatcherUpdated',
+  'permission.asked':   'PermissionAsked',
+  'permission.replied': 'PermissionReplied',
+  'server.connected':   'ServerConnected',
+  'lsp.updated':        'LspUpdated',
+  'installation.updated': 'InstallationUpdated',
+  'tui.prompt.append':  'TuiPromptAppend',
+  'tui.command.execute':'TuiCommandExecute',
+  'tui.toast.show':     'TuiToastShow',
+  // session.next.* meaningful events
+  'session.next.prompted':       'UserMessage',
+  'session.next.step.ended':     'StepEnded',
+  'session.next.model.switched': 'ModelSwitched',
+  'session.next.agent.switched': 'AgentSwitched',
+  'session.next.reasoning.ended':'Reasoning',
+};
+
+function appendEvent(ev: Record<string, unknown>): void {
+  try {
+    if (!existsSync(AUTODEV_DIR)) { mkdirSync(AUTODEV_DIR, { recursive: true }); }
+    ev['timestamp'] = new Date().toISOString();
+    const line = JSON.stringify(ev) + '\\n';
+    // Always write to global file (used for session-ID discovery)
+    appendFileSync(GLOBAL_JSONL, line, 'utf8');
+    // Also write to per-session file when we know the session ID
+    const sid = typeof ev['session_id'] === 'string' ? ev['session_id'] as string : null;
+    const perFile = sessionJsonlPath(sid);
+    if (perFile) { appendFileSync(perFile, line, 'utf8'); }
+  } catch { }
+}
+
+// Helper to extract session ID from various event shapes
+function extractSessionId(input: any): string | null {
+  return input?.sessionID ?? input?.session_id ?? input?.properties?.sessionID ?? null;
+}
+
+// Accumulated assistant text per session.
+// session.next.text.ended fires once per step with the complete generated text.
+// Multi-step sessions accumulate across steps and flush as AgentMessage on session.idle.
+const sessionText = new Map<string, string>();
+
+export const AutodevHooksPlugin = async () => ({
+  // -------------------------------------------------------------------------
+  // Tool lifecycle — explicit named hooks (these do NOT fire via generic 'event')
+  // -------------------------------------------------------------------------
+  'tool.execute.before': async (input: any, output?: any) => {
+    appendEvent({
+      hook_event_name: 'PreToolUse',
+      provider:        'opencode',
+      tool_name:       input?.tool ?? 'unknown',
+      tool_input:      output?.args ?? input?.args ?? null,
+      session_id:      extractSessionId(input),
+    });
+  },
+
+  'tool.execute.after': async (input: any, output?: any) => {
+    const rawOut = output?.output ?? output?.result ?? output?.text;
+    const outText = typeof rawOut === 'string' ? rawOut.slice(0, 400) : null;
+    appendEvent({
+      hook_event_name: 'PostToolUse',
+      provider:        'opencode',
+      tool_name:       input?.tool ?? 'unknown',
+      tool_input:      input?.args ?? null,
+      tool_output:     outText != null ? { title: output?.title ?? null, text: outText } : null,
+      session_id:      extractSessionId(input),
+    });
+  },
+
+  // -------------------------------------------------------------------------
+  // Permission hooks — explicit so we always capture even if generic 'event'
+  // doesn't fire for them. Critical for detecting blocked/waiting states.
+  // -------------------------------------------------------------------------
+  'permission.asked': async (input: any, output?: any) => {
+    appendEvent({
+      hook_event_name: 'PermissionAsked',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      tool_name:       input?.tool ?? null,
+      tool_input:      input?.args ?? null,
+      message:         input?.message ?? input?.description ?? null,
+    });
+  },
+
+  'permission.replied': async (input: any, output?: any) => {
+    appendEvent({
+      hook_event_name: 'PermissionReplied',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      tool_name:       input?.tool ?? null,
+      granted:         input?.granted ?? output?.granted ?? null,
+    });
+  },
+
+  // -------------------------------------------------------------------------
+  // TUI events — explicit named hooks
+  // -------------------------------------------------------------------------
+  'tui.prompt.append': async (input: any) => {
+    appendEvent({
+      hook_event_name: 'TuiPromptAppend',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      message:         input?.text ?? null,
+    });
+  },
+
+  'tui.command.execute': async (input: any) => {
+    appendEvent({
+      hook_event_name: 'TuiCommandExecute',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      message:         input?.command ?? input?.name ?? null,
+    });
+  },
+
+  'tui.toast.show': async (input: any) => {
+    appendEvent({
+      hook_event_name: 'TuiToastShow',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      message:         input?.message ?? input?.text ?? null,
+    });
+  },
+
+  // -------------------------------------------------------------------------
+  // Command + file events — explicit named hooks
+  // -------------------------------------------------------------------------
+  'command.executed': async (input: any) => {
+    appendEvent({
+      hook_event_name: 'CommandExecuted',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      message:         input?.command ?? input?.name ?? null,
+    });
+  },
+
+  'file.edited': async (input: any) => {
+    appendEvent({
+      hook_event_name: 'FileEdited',
+      provider:        'opencode',
+      session_id:      extractSessionId(input),
+      message:         input?.file ?? input?.path ?? null,
+    });
+  },
+
+  // -------------------------------------------------------------------------
+  // Generic catch-all for remaining events (session/message/todo/lsp/server…)
+  // SKIP_EVENTS excludes high-noise events and events already handled above.
+  // message.part.updated (type:'text') is handled here to accumulate the AI's
+  // response text; it's flushed as a single AgentMessage on session.idle.
+  // -------------------------------------------------------------------------
+  'event': async (ctx: any) => {
+    const evt   = ctx?.event ?? ctx ?? {};
+    const t: string = evt?.type ?? '';
+
+    if (!t || SKIP_EVENTS.has(t)) { return; }
+
+    const props     = evt?.properties ?? {};
+    const sessionId = props?.sessionID ?? props?.id ?? null;
+    const errMsg    = props?.error?.message ?? null;
+
+    // --- session.next.text.ended: accumulate assistant response text per session ---
+    // Fires once per step with the complete generated text. Flushed on session.idle.
+    if (t === 'session.next.text.ended') {
+      const text = props?.text ?? null;
+      if (sessionId && typeof text === 'string' && text.trim()) {
+        const prev = sessionText.get(sessionId) ?? '';
+        sessionText.set(sessionId, prev ? prev + '\\n\\n' + text : text);
+      }
+      return; // never emit directly — flushed as AgentMessage on session.idle
+    }
+
+    // --- session.next.prompted: the user's prompt text sent to the model ---
+    if (t === 'session.next.prompted') {
+      const promptText = props?.prompt?.text ?? null;
+      appendEvent({
+        hook_event_name: 'UserMessage',
+        provider:        'opencode',
+        session_id:      sessionId,
+        message:         typeof promptText === 'string' ? promptText.slice(0, 2000) : null,
+      });
+      return;
+    }
+
+    // --- session.idle: flush accumulated assistant text as AgentMessage ---
+    if (t === 'session.idle' && sessionId && sessionText.has(sessionId)) {
+      const text = sessionText.get(sessionId)!;
+      sessionText.delete(sessionId);
+      if (text.trim()) {
+        appendEvent({
+          hook_event_name: 'AgentMessage',
+          provider:        'opencode',
+          session_id:      sessionId,
+          message:         text.slice(0, 3000),
+        });
+      }
+    }
+
+    // --- session.next.step.ended: token usage + cost ---
+    if (t === 'session.next.step.ended') {
+      const tokens = props?.tokens ?? null;
+      const cost   = props?.cost   ?? null;
+      appendEvent({
+        hook_event_name: 'StepEnded',
+        provider:        'opencode',
+        session_id:      sessionId,
+        message:         props?.finish ?? null,
+        tokens:          tokens,
+        cost:            cost,
+      });
+      return;
+    }
+
+    // Generic catch-all — extract message from known session.next.* fields
+    const agentName  = props?.agent ?? null;
+    const modelId    = props?.model?.id ?? props?.model?.modelID ?? null;
+    const reasonText = props?.text ?? null; // session.next.reasoning.ended
+    const promptText = props?.prompt?.text ?? null; // fallback
+    const message    = errMsg
+      ?? reasonText
+      ?? promptText
+      ?? (agentName && modelId ? \`\${agentName} (\${modelId})\`
+         : agentName ? agentName
+         : modelId  ? modelId
+         : null);
+
+    appendEvent({
+      hook_event_name: SESSION_MAP[t] ?? t,
+      provider:        'opencode',
+      session_id:      sessionId,
+      message:         message,
+    });
+  },
+});
+`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+function isOpenCodeHooksInstalled(workspaceRoot) {
+    try {
+        const content = fs.readFileSync(pluginPath(workspaceRoot), 'utf8');
+        // Check both the marker AND that the dir is workspace-scoped (not a stale install).
+        const expectedDir = path.join(workspaceRoot, '.autodev').replace(/\\/g, '/');
+        return content.includes(PLUGIN_MARKER) && content.includes(expectedDir);
+    }
+    catch {
+        return false;
+    }
+}
+function installOpenCodeHooks(workspaceRoot) {
+    const dir = pluginDir(workspaceRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(pluginPath(workspaceRoot), buildPluginContent(workspaceRoot), 'utf8');
+}
+/**
+ * Return true if an opencode process is actively writing to the hooks JSONL.
+ * Prefers the per-session file when sessionId is known; falls back to the global file.
+ */
+function isOpenCodeCliActive(workspaceRoot, windowMs = 90_000, sessionId) {
+    const safeId = sessionId ? sessionId.replace(/[^a-zA-Z0-9_-]/g, '_') : undefined;
+    const perFile = safeId ? path.join(workspaceRoot, '.autodev', `hooks-events-${safeId}.jsonl`) : undefined;
+    const jsonlFile = (perFile && fs.existsSync(perFile))
+        ? perFile
+        : path.join(workspaceRoot, '.autodev', 'hooks-events.jsonl');
+    try {
+        const stat = fs.statSync(jsonlFile);
+        if (Date.now() - stat.mtimeMs > windowMs) {
+            return false;
+        } // stale file
+        const lines = fs.readFileSync(jsonlFile, 'utf8').split('\n').filter(Boolean);
+        for (let i = lines.length - 1; i >= 0; i--) {
+            try {
+                const ev = JSON.parse(lines[i]);
+                if (ev.provider !== 'opencode') {
+                    continue;
+                }
+                // If reading global file, filter to the requested session
+                if (!perFile && sessionId && ev.session_id && ev.session_id !== sessionId) {
+                    continue;
+                }
+                const name = ev.hook_event_name ?? '';
+                if (name === 'Stop' || name === 'StopFailure' || name === 'SessionEnd' || name === 'server.instance.disposed') {
+                    return false;
+                }
+                return true;
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Return true if the most recent opencode session exited cleanly (Stop event present).
+ * Prefers the per-session file when sessionId is known.
+ */
+function openCodeExitedCleanly(workspaceRoot, sessionId) {
+    const safeId = sessionId ? sessionId.replace(/[^a-zA-Z0-9_-]/g, '_') : undefined;
+    const perFile = safeId ? path.join(workspaceRoot, '.autodev', `hooks-events-${safeId}.jsonl`) : undefined;
+    const jsonlFile = (perFile && fs.existsSync(perFile))
+        ? perFile
+        : path.join(workspaceRoot, '.autodev', 'hooks-events.jsonl');
+    try {
+        const lines = fs.readFileSync(jsonlFile, 'utf8').split('\n').filter(Boolean);
+        for (let i = lines.length - 1; i >= 0; i--) {
+            try {
+                const ev = JSON.parse(lines[i]);
+                if (ev.provider !== 'opencode') {
+                    continue;
+                }
+                if (!perFile && sessionId && ev.session_id && ev.session_id !== sessionId) {
+                    continue;
+                }
+                const name = ev.hook_event_name ?? '';
+                if (name === 'Stop' || name === 'StopFailure' || name === 'SessionEnd' || name === 'server.instance.disposed') {
+                    return true;
+                }
+                return false;
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    catch { /* file absent */ }
+    return false;
+}
+/**
+ * Read the workspace-scoped hooks-events.jsonl and return the session ID from
+ * the most recent OpenCode session event.
+ * Returns undefined if the file is absent or no session event has been seen yet.
+ *
+ * @param notBefore  Only consider events with a timestamp >= this ISO string or
+ *                   epoch-ms number.  Pass the task-start time to avoid picking
+ *                   up stale/foreign sessions from before this dispatch.
+ */
+function getOpenCodeSessionIdFromHooks(workspaceRoot, notBefore) {
+    const jsonlFile = path.join(workspaceRoot, '.autodev', 'hooks-events.jsonl');
+    const cutoff = notBefore
+        ? (typeof notBefore === 'number' ? new Date(notBefore).toISOString() : notBefore)
+        : undefined;
+    try {
+        const lines = fs.readFileSync(jsonlFile, 'utf8').split('\n').filter(Boolean);
+        // Walk backwards — most recent event first
+        for (let i = lines.length - 1; i >= 0; i--) {
+            try {
+                const ev = JSON.parse(lines[i]);
+                if (ev.provider !== 'opencode') {
+                    continue;
+                }
+                if (cutoff && ev.timestamp && ev.timestamp < cutoff) {
+                    break;
+                } // events are chronological
+                const sid = ev.session_id ?? undefined;
+                if (sid) {
+                    return sid;
+                }
+            }
+            catch { /* malformed line */ }
+        }
+    }
+    catch { /* file absent */ }
+    return undefined;
+}
+function uninstallOpenCodeHooks(workspaceRoot) {
+    const p = pluginPath(workspaceRoot);
+    if (!fs.existsSync(p)) {
+        return;
+    }
+    try {
+        const content = fs.readFileSync(p, 'utf8');
+        if (content.includes(PLUGIN_MARKER)) {
+            fs.unlinkSync(p);
+        }
+    }
+    catch { /* ignore */ }
+}
+//# sourceMappingURL=openCodeHooksManager.js.map

package/out/openCodeHooksManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openCodeHooksManager.js","sourceRoot":"","sources":["../src/openCodeHooksManager.ts"],"names":[],"mappings":"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"}

package/out/periodicActions.d.ts

@@ -0,0 +1,63 @@
+import { AutodevSettings } from './core/settingsLoader';
+export interface PeriodicActionDef {
+    /** Unique stable ID. Used as HTML element id prefix and counter key. */
+    id: string;
+    /** Sidebar label shown to the user. */
+    label: string;
+    /** Key in AutodevSettings that holds the interval (0 = disabled). */
+    settingKey: keyof AutodevSettings;
+    /** Log icon (emoji) used in the extension host log. */
+    icon: string;
+    /**
+     * How the action is executed when due:
+     * - 'prompt'     — send `prompt` text to the AI via sendToAi (default)
+     * - 'compact'    — run provider-specific /compact tool (no AI prompt sent)
+     * - 'pruneTodo'  — move completed [x] tasks from TODO.md into DONE.md
+     */
+    type?: 'prompt' | 'compact' | 'pruneTodo';
+    /** Prompt text sent to the agent (only used when type === 'prompt'). */
+    prompt: string;
+}
+export declare const PERIODIC_ACTIONS: PeriodicActionDef[];
+interface ActionState {
+    /** Tasks completed since this action was last triggered (or since loop start). */
+    counter: number;
+    /** Loop iteration number when this action was last triggered (0 = never). */
+    lastTriggeredAt: number;
+    /** Wall-clock ISO string when last triggered. */
+    lastTriggeredTime: string | null;
+}
+export declare class PeriodicActionManager {
+    private readonly _state;
+    private _ensureState;
+    /** Reset all counters (call at loop start). */
+    reset(): void;
+    /**
+     * Reset all counters and persist the cleared state to .autodev/loop-state.json.
+     * Call at loop start.
+     */
+    resetAndPersist(workspaceRoot?: string): void;
+    /**
+     * Increment all action counters by 1.
+     * @param iteration Current loop iteration number (used for debug state).
+     * @param workspaceRoot If provided, persists loop-state.json to .autodev/.
+     */
+    increment(iteration: number, workspaceRoot?: string): void;
+    /** Returns the actions whose counter has reached or exceeded the configured interval. */
+    getDue(settings: AutodevSettings): PeriodicActionDef[];
+    /**
+     * Reset the counter for a specific action after it has been handled.
+     * Records the iteration + timestamp it was triggered at.
+     */
+    markHandled(id: string, iteration: number, workspaceRoot?: string): void;
+    /** Returns the current counter value for an action (for debug / display). */
+    getCount(id: string): number;
+    /** Snapshot of all action states — used for debug persistence. */
+    snapshot(): Record<string, ActionState>;
+    /**
+     * Write .autodev/loop-state.json with current iteration + per-action counters.
+     * Safe — silently ignores write errors.
+     */
+    private _persist;
+}
+export {};