micode 0.9.0 → 0.10.0

package/src/index.ts

@@ -12,6 +12,7 @@ import { createCommentCheckerHook } from "./hooks/comment-checker";
 import { createConstraintReviewerHook } from "./hooks/constraint-reviewer";
 import { createContextInjectorHook } from "./hooks/context-injector";
 import { createContextWindowMonitorHook } from "./hooks/context-window-monitor";
+import { createFetchTrackerHook } from "./hooks/fetch-tracker";
 import { createFileOpsTrackerHook, getFileOps } from "./hooks/file-ops-tracker";
 import { createFragmentInjectorHook, warnUnknownAgents } from "./hooks/fragment-injector";
 import { createLedgerLoaderHook } from "./hooks/ledger-loader";
@@ -28,7 +29,7 @@ import { milestone_artifact_search } from "./tools/milestone-artifact-search";
 import { createMindmodelLookupTool } from "./tools/mindmodel-lookup";
 import { createOcttoTools, createSessionStore } from "./tools/octto";
 // PTY System
-import { createPtyTools, PTYManager } from "./tools/pty";
+import { createPtyTools, loadBunPty, PTYManager } from "./tools/pty";
 import { createSpawnAgentTool } from "./tools/spawn-agent";
 import { log } from "./utils/logger";
 
@@ -101,6 +102,7 @@ const OpenCodeConfigPlugin: Plugin = async (ctx) => {
   const commentCheckerHook = createCommentCheckerHook(ctx);
   const artifactAutoIndexHook = createArtifactAutoIndexHook(ctx);
   const fileOpsTrackerHook = createFileOpsTrackerHook(ctx);
+  const fetchTrackerHook = createFetchTrackerHook(ctx);
 
   // Fragment injector hook - injects user-defined prompt fragments
   const fragmentInjectorHook = createFragmentInjectorHook(ctx, userConfig);
@@ -174,9 +176,15 @@ const OpenCodeConfigPlugin: Plugin = async (ctx) => {
     }
   });
 
-  // PTY System
+  // PTY System - load bun-pty with graceful degradation
+  // Sets BUN_PTY_LIB env var to fix path resolution in OpenCode plugin environments
+  // See: https://github.com/vtemian/micode/issues/20
   const ptyManager = new PTYManager();
-  const ptyTools = createPtyTools(ptyManager);
+  const bunPty = await loadBunPty();
+  if (bunPty) {
+    ptyManager.init(bunPty.spawn);
+  }
+  const ptyTools = ptyManager.available ? createPtyTools(ptyManager) : {};
 
   // Spawn agent tool (for subagents to spawn other subagents)
   const spawn_agent = createSpawnAgentTool(ctx);
@@ -229,7 +237,6 @@ const OpenCodeConfigPlugin: Plugin = async (ctx) => {
         edit: "allow",
         bash: "allow",
         webfetch: "allow",
-        doom_loop: "allow",
         external_directory: "allow",
       };
 
@@ -313,7 +320,7 @@ const OpenCodeConfigPlugin: Plugin = async (ctx) => {
           ...output.options,
           thinking: {
             type: "enabled",
-            budget_tokens: 32000,
+            budgetTokens: 128000,
           },
         };
       }
@@ -398,6 +405,12 @@ IMPORTANT:
         output,
       );
 
+      // Track fetch operations and cache results
+      await fetchTrackerHook["tool.execute.after"](
+        { tool: input.tool, sessionID: input.sessionID, args: input.args },
+        output,
+      );
+
       // Constraint review for Edit/Write
       await constraintReviewerHook["tool.execute.after"](
         { tool: input.tool, sessionID: input.sessionID, args: input.args },
@@ -444,6 +457,7 @@ IMPORTANT:
           thinkModeState.delete(sessionId);
           ptyManager.cleanupBySession(sessionId);
           constraintReviewerHook.cleanupSession(sessionId);
+          fetchTrackerHook.cleanupSession(sessionId);
 
           // Cleanup octto sessions
           const octtoSessions = octtoSessionsMap.get(sessionId);
@@ -464,6 +478,9 @@ IMPORTANT:
 
       // File ops tracker cleanup
       await fileOpsTrackerHook.event({ event });
+
+      // Fetch tracker cleanup
+      await fetchTrackerHook.event({ event });
     },
   };
 };

package/src/mindmodel/loader.ts

@@ -3,6 +3,7 @@ import { access, readFile } from "node:fs/promises";
 import { join } from "node:path";
 
 import { config } from "../utils/config";
+import { log } from "../utils/logger";
 import { type MindmodelManifest, parseManifest } from "./types";
 
 export interface LoadedMindmodel {
@@ -36,7 +37,7 @@ export async function loadMindmodel(projectDir: string): Promise<LoadedMindmodel
       manifest,
     };
   } catch (error) {
-    console.warn(`[micode] Failed to load mindmodel manifest: ${error}`);
+    log.warn("mindmodel", `Failed to load manifest: ${error}`);
     return null;
   }
 }
@@ -58,7 +59,7 @@ export async function loadExamples(mindmodel: LoadedMindmodel, categoryPaths: st
         content,
       });
     } catch {
-      console.warn(`[micode] Failed to load mindmodel example: ${categoryPath}`);
+      log.warn("mindmodel", `Failed to load example: ${categoryPath}`);
     }
   }
 

package/src/tools/mindmodel-lookup.ts

@@ -64,7 +64,7 @@ Returns relevant code examples and patterns to follow.`,
           return "No specific patterns found for this task. Proceed using general best practices.";
         }
 
-        log.info("mindmodel", `Matched categories: ${categories.join(", ")}`);
+        log.debug("mindmodel", `Matched categories: ${categories.join(", ")}`);
 
         // Load examples
         const examples = await loadExamples(mindmodel, categories);
@@ -73,7 +73,7 @@ Returns relevant code examples and patterns to follow.`,
         }
 
         const formatted = formatExamplesForInjection(examples);
-        log.info("mindmodel", `Returning ${examples.length} examples`);
+        log.debug("mindmodel", `Returning ${examples.length} examples`);
 
         return formatted;
       } catch (error) {

package/src/tools/pty/index.ts

@@ -1,27 +1,29 @@
 // src/tools/pty/index.ts
-export { PTYManager } from "./manager";
+
 export { RingBuffer } from "./buffer";
+export { PTYManager } from "./manager";
+export { getBunPtyLoadError, isBunPtyAvailable, loadBunPty } from "./pty-loader";
+export { createPtyKillTool } from "./tools/kill";
+export { createPtyListTool } from "./tools/list";
+export { createPtyReadTool } from "./tools/read";
 export { createPtySpawnTool } from "./tools/spawn";
 export { createPtyWriteTool } from "./tools/write";
-export { createPtyReadTool } from "./tools/read";
-export { createPtyListTool } from "./tools/list";
-export { createPtyKillTool } from "./tools/kill";
 export type {
   PTYSession,
   PTYSessionInfo,
   PTYStatus,
-  SpawnOptions,
   ReadResult,
   SearchMatch,
   SearchResult,
+  SpawnOptions,
 } from "./types";
 
 import type { PTYManager } from "./manager";
+import { createPtyKillTool } from "./tools/kill";
+import { createPtyListTool } from "./tools/list";
+import { createPtyReadTool } from "./tools/read";
 import { createPtySpawnTool } from "./tools/spawn";
 import { createPtyWriteTool } from "./tools/write";
-import { createPtyReadTool } from "./tools/read";
-import { createPtyListTool } from "./tools/list";
-import { createPtyKillTool } from "./tools/kill";
 
 export function createPtyTools(manager: PTYManager) {
   return {

package/src/tools/pty/manager.ts

@@ -1,7 +1,10 @@
 // src/tools/pty/manager.ts
-import { spawn, type IPty } from "bun-pty";
 import { RingBuffer } from "./buffer";
-import type { PTYSession, PTYSessionInfo, SpawnOptions, ReadResult, SearchResult } from "./types";
+import type { PTYSession, PTYSessionInfo, ReadResult, SearchResult, SpawnOptions } from "./types";
+
+// bun-pty types used locally - the actual module is injected via init()
+type IPty = import("bun-pty").IPty;
+type SpawnFn = typeof import("bun-pty").spawn;
 
 function generateId(): string {
   const hex = Array.from(crypto.getRandomValues(new Uint8Array(4)))
@@ -12,8 +15,35 @@ function generateId(): string {
 
 export class PTYManager {
   private sessions: Map<string, PTYSession> = new Map();
+  private spawnFn: SpawnFn | null = null;
+  private _available = false;
+
+  /**
+   * Initialize the manager with the bun-pty spawn function.
+   * Must be called before spawn(). If not called or called with null,
+   * PTY operations will return errors indicating PTY is unavailable.
+   */
+  init(spawnFn: SpawnFn): void {
+    this.spawnFn = spawnFn;
+    this._available = true;
+  }
+
+  /**
+   * Whether PTY functionality is available (bun-pty loaded successfully).
+   */
+  get available(): boolean {
+    return this._available;
+  }
 
   spawn(opts: SpawnOptions): PTYSessionInfo {
+    if (!this.spawnFn) {
+      throw new Error(
+        "PTY unavailable: bun-pty native library could not be loaded. " +
+          "Set BUN_PTY_LIB environment variable to the path of the native library " +
+          "(e.g., .opencode/node_modules/bun-pty/rust-pty/target/release/librust_pty.dylib)",
+      );
+    }
+
     const id = generateId();
     const args = opts.args ?? [];
     const workdir = opts.workdir ?? process.cwd();
@@ -22,7 +52,7 @@ export class PTYManager {
 
     let ptyProcess: IPty;
     try {
-      ptyProcess = spawn(opts.command, args, {
+      ptyProcess = this.spawnFn(opts.command, args, {
         name: "xterm-256color",
         cols: 120,
         rows: 40,

package/src/tools/pty/pty-loader.ts

@@ -0,0 +1,123 @@
+// src/tools/pty/pty-loader.ts
+// Resolves bun-pty native library path and loads bun-pty with graceful degradation.
+//
+// bun-pty's resolveLibPath() checks BUN_PTY_LIB env var first, then hardcoded paths
+// relative to import.meta.url. When micode is installed as an OpenCode plugin,
+// the library ends up in .opencode/node_modules/bun-pty/... which isn't in the
+// hardcoded search paths. We fix this by probing likely locations and setting
+// BUN_PTY_LIB before the dynamic import.
+//
+// See: https://github.com/vtemian/micode/issues/20
+// See: https://github.com/anomalyco/opencode/issues/10556
+
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+import { log } from "../../utils/logger";
+
+type BunPtyModule = typeof import("bun-pty");
+
+let cachedModule: BunPtyModule | null = null;
+let loadAttempted = false;
+let loadError: string | null = null;
+
+/**
+ * Probe additional paths where the bun-pty native library might live,
+ * beyond what bun-pty checks itself. Sets BUN_PTY_LIB if found.
+ */
+function probeBunPtyLib(): void {
+  // If already set by user, respect it
+  if (process.env.BUN_PTY_LIB) return;
+
+  const platform = process.platform;
+  const arch = process.arch;
+
+  const filenames =
+    platform === "darwin"
+      ? arch === "arm64"
+        ? ["librust_pty_arm64.dylib", "librust_pty.dylib"]
+        : ["librust_pty.dylib"]
+      : platform === "win32"
+        ? ["rust_pty.dll"]
+        : arch === "arm64"
+          ? ["librust_pty_arm64.so", "librust_pty.so"]
+          : ["librust_pty.so"];
+
+  const cwd = process.cwd();
+
+  // Paths that bun-pty does NOT check but where the lib may exist
+  // when installed as an OpenCode plugin dependency
+  const additionalBasePaths = [
+    // .opencode/node_modules/bun-pty/... (plugin installed via .opencode/package.json)
+    join(cwd, ".opencode", "node_modules", "bun-pty", "rust-pty", "target", "release"),
+    // .micode/node_modules/bun-pty/... (if micode has its own node_modules)
+    join(cwd, ".micode", "node_modules", "bun-pty", "rust-pty", "target", "release"),
+  ];
+
+  // Also try resolving from require.resolve if available
+  try {
+    const bunPtyMain = require.resolve("bun-pty");
+    if (bunPtyMain) {
+      // require.resolve gives us something like .../node_modules/bun-pty/src/index.ts
+      // Go up to the bun-pty package root
+      const pkgDir = dirname(dirname(bunPtyMain));
+      additionalBasePaths.unshift(join(pkgDir, "rust-pty", "target", "release"));
+    }
+  } catch {
+    // require.resolve may fail in some environments
+  }
+
+  for (const basePath of additionalBasePaths) {
+    for (const filename of filenames) {
+      const candidate = join(basePath, filename);
+      if (existsSync(candidate)) {
+        process.env.BUN_PTY_LIB = candidate;
+        log.info("pty.loader", `Auto-resolved BUN_PTY_LIB=${candidate}`);
+        return;
+      }
+    }
+  }
+}
+
+/**
+ * Dynamically load bun-pty with graceful degradation.
+ * Sets BUN_PTY_LIB env var before import to fix path resolution
+ * in OpenCode plugin environments.
+ *
+ * Returns null if bun-pty cannot be loaded (native library missing, etc.)
+ */
+export async function loadBunPty(): Promise<BunPtyModule | null> {
+  if (loadAttempted) return cachedModule;
+  loadAttempted = true;
+
+  // Probe and set BUN_PTY_LIB before importing
+  probeBunPtyLib();
+
+  try {
+    cachedModule = await import("bun-pty");
+    log.info("pty.loader", "bun-pty loaded successfully");
+    return cachedModule;
+  } catch (error) {
+    loadError = error instanceof Error ? error.message : String(error);
+    // Extract just the first line for a cleaner warning
+    const firstLine = loadError.split("\n")[0];
+    log.warn("pty.loader", `bun-pty unavailable: ${firstLine}`);
+    log.warn("pty.loader", "PTY tools will be disabled. Set BUN_PTY_LIB env var to the native library path to fix.");
+    cachedModule = null;
+    return null;
+  }
+}
+
+/**
+ * Check if bun-pty is available (must call loadBunPty first).
+ */
+export function isBunPtyAvailable(): boolean {
+  return cachedModule !== null;
+}
+
+/**
+ * Get the load error message, if any.
+ */
+export function getBunPtyLoadError(): string | null {
+  return loadError;
+}

package/src/utils/config.ts

@@ -127,6 +127,14 @@ export const config = {
     allowRemoteBind: false,
   },
 
+  /**
+   * Model settings
+   */
+  model: {
+    /** Plugin fallback model when no opencode.json or micode.json model is configured */
+    default: "openai/gpt-5.2-codex",
+  },
+
   /**
    * Mindmodel v2 settings
    */
@@ -140,4 +148,21 @@ export const config = {
     /** Category groups for v2 structure */
     categoryGroups: ["stack", "architecture", "patterns", "style", "components", "domain", "ops"] as readonly string[],
   },
+
+  /**
+   * Fetch loop prevention settings
+   */
+  fetch: {
+    /** Inject warning after this many calls to the same resource */
+    warnThreshold: 3,
+    /** Hard block after this many calls to the same resource */
+    maxCallsPerResource: 5,
+    /** Cache TTL in milliseconds (5 minutes) */
+    cacheTtlMs: 300_000,
+    /** Max cached entries per session (LRU eviction) */
+    cacheMaxEntries: 50,
+  },
 } as const;
+
+/** Plugin fallback model — single source of truth for the default model string */
+export const DEFAULT_MODEL = config.model.default;