oh-my-opencode-slim 2.0.4 → 2.1.0

package/dist/tui.js

@@ -118,14 +118,14 @@ var ALL_AGENT_NAMES = ["orchestrator", ...SUBAGENT_NAMES];
 var PROTECTED_AGENTS = new Set(["orchestrator", "councillor"]);
 var DEFAULT_MODELS = {
   orchestrator: undefined,
-  oracle: "openai/gpt-5.5",
-  librarian: "openai/gpt-5.4-mini",
-  explorer: "openai/gpt-5.4-mini",
-  designer: "openai/gpt-5.4-mini",
-  fixer: "openai/gpt-5.4-mini",
-  observer: "openai/gpt-5.4-mini",
-  council: "openai/gpt-5.4-mini",
-  councillor: "openai/gpt-5.4-mini"
+  oracle: undefined,
+  librarian: undefined,
+  explorer: undefined,
+  designer: undefined,
+  fixer: undefined,
+  observer: undefined,
+  council: undefined,
+  councillor: undefined
 };
 var POLL_INTERVAL_BACKGROUND_MS = 2000;
 var MAX_POLL_TIME_MS = 5 * 60 * 1000;
@@ -232,7 +232,7 @@ var CouncilConfigSchema = z.object({
   default_preset: z.string().default("default"),
   councillor_execution_mode: CouncillorExecutionModeSchema.describe('Execution mode for councillors. "serial" runs them one at a time (required for single-model systems). "parallel" runs them concurrently (default, faster for multi-model systems).'),
   councillor_retries: z.number().int().min(0).max(5).default(3).describe("Number of retry attempts for councillors that return empty responses " + "(e.g. due to provider rate limiting). Default: 3 retries."),
-  master: z.unknown().optional().describe("DEPRECATED — ignored. Council agent synthesizes directly.")
+  master: z.unknown().optional().describe("DEPRECATED - ignored. Council agent synthesizes directly.")
 }).transform((data) => {
   const deprecated = [];
   if (data.master !== undefined)
@@ -298,7 +298,13 @@ var AgentOverrideConfigSchema = z2.object({
   options: z2.record(z2.string(), z2.unknown()).optional(),
   displayName: z2.string().min(1).optional()
 }).strict();
-var MultiplexerTypeSchema = z2.enum(["auto", "tmux", "zellij", "none"]);
+var MultiplexerTypeSchema = z2.enum([
+  "auto",
+  "tmux",
+  "zellij",
+  "herdr",
+  "none"
+]);
 var MultiplexerLayoutSchema = z2.enum([
   "main-horizontal",
   "main-vertical",
@@ -353,6 +359,7 @@ var CompanionConfigSchema = z2.object({
   debug: z2.boolean().optional().describe("Enable verbose native companion debug logs.")
 });
 var AcpAgentPermissionModeSchema = z2.enum(["ask", "allow", "reject"]);
+var MAX_ACP_TIMEOUT_MS = 2147483647;
 var AcpAgentConfigSchema = z2.object({
   command: z2.string().min(1),
   args: z2.array(z2.string()).default([]),
@@ -362,28 +369,17 @@ var AcpAgentConfigSchema = z2.object({
   prompt: z2.string().min(1).optional(),
   orchestratorPrompt: z2.string().min(1).optional(),
   wrapperModel: ProviderModelIdSchema.optional(),
-  timeoutMs: z2.number().int().min(1000).max(900000).default(300000),
+  timeoutMs: z2.number().int().min(0).max(MAX_ACP_TIMEOUT_MS).default(0).describe("Timeout for a single ACP run in milliseconds. Set to 0 to disable the timeout."),
   permissionMode: AcpAgentPermissionModeSchema.default("ask")
 }).strict();
 var AcpAgentsConfigSchema = z2.record(z2.string(), AcpAgentConfigSchema);
-function validateCustomOnlyPromptFields(overrides, ctx, pathPrefix) {
+function rejectOrchestratorPromptOnOrchestrator(overrides, ctx, pathPrefix) {
   for (const [name, override] of Object.entries(overrides)) {
-    const isBuiltInOrAlias = ALL_AGENT_NAMES.includes(name) || AGENT_ALIASES[name] !== undefined;
-    if (!isBuiltInOrAlias) {
-      continue;
-    }
-    if (override.prompt !== undefined) {
-      ctx.addIssue({
-        code: z2.ZodIssueCode.custom,
-        path: [...pathPrefix, name, "prompt"],
-        message: "prompt is only supported for custom agents"
-      });
-    }
-    if (override.orchestratorPrompt !== undefined) {
+    if (name === "orchestrator" && override.orchestratorPrompt !== undefined) {
       ctx.addIssue({
         code: z2.ZodIssueCode.custom,
         path: [...pathPrefix, name, "orchestratorPrompt"],
-        message: "orchestratorPrompt is only supported for custom agents"
+        message: "orchestratorPrompt is not supported for the orchestrator agent"
       });
     }
   }
@@ -391,11 +387,14 @@ function validateCustomOnlyPromptFields(overrides, ctx, pathPrefix) {
 var PluginConfigSchema = z2.object({
   preset: z2.string().optional(),
   setDefaultAgent: z2.boolean().optional(),
+  compactSidebar: z2.boolean().optional().describe("Use the compact TUI sidebar layout when enabled."),
   autoUpdate: z2.boolean().optional().describe("Disable automatic installation of plugin updates when false. Defaults to true."),
   presets: z2.record(z2.string(), PresetSchema).optional(),
   agents: z2.record(z2.string(), AgentOverrideConfigSchema).optional(),
   disabled_agents: z2.array(z2.string()).optional().describe("Agent names to disable completely. " + "Disabled agents are not instantiated and cannot be delegated to. " + "Orchestrator and council internal agents (councillor) cannot be disabled. " + "By default, 'observer' is disabled. Remove it from this list and configure a vision-capable model to enable."),
   disabled_mcps: z2.array(z2.string()).optional(),
+  disabled_tools: z2.array(z2.string()).optional().describe("Tool names to disable completely. Disabled tools are not registered with OpenCode and cannot be used by agents."),
+  disabled_skills: z2.array(z2.string()).optional().describe("Skill names to disable completely. Disabled skills are not granted to agents, even when referenced by presets or agent overrides."),
   multiplexer: MultiplexerConfigSchema.optional(),
   tmux: TmuxConfigSchema.optional(),
   websearch: WebsearchConfigSchema.optional(),
@@ -407,11 +406,14 @@ var PluginConfigSchema = z2.object({
   acpAgents: AcpAgentsConfigSchema.optional()
 }).superRefine((value, ctx) => {
   if (value.agents) {
-    validateCustomOnlyPromptFields(value.agents, ctx, ["agents"]);
+    rejectOrchestratorPromptOnOrchestrator(value.agents, ctx, ["agents"]);
   }
   if (value.presets) {
     for (const [presetName, preset] of Object.entries(value.presets)) {
-      validateCustomOnlyPromptFields(preset, ctx, ["presets", presetName]);
+      rejectOrchestratorPromptOnOrchestrator(preset, ctx, [
+        "presets",
+        presetName
+      ]);
     }
   }
 });
@@ -467,7 +469,7 @@ function getAgentMcpList(agentName, config) {
   return defaultMcps ?? [];
 }
 
-// src/cli/custom-skills.ts
+// src/cli/custom-skills-registry.ts
 var CUSTOM_SKILLS = [
   {
     name: "simplify",
@@ -505,6 +507,12 @@ var CUSTOM_SKILLS = [
     allowedAgents: ["orchestrator"],
     sourcePath: "src/skills/oh-my-opencode-slim"
   },
+  {
+    name: "release-smoke-test",
+    description: "Validate packed release candidates and bugfixes before public publish",
+    allowedAgents: ["orchestrator"],
+    sourcePath: "src/skills/release-smoke-test"
+  },
   {
     name: "worktrees",
     description: "Manage Git worktrees as OMO safe isolated coding lanes for complex/risky/parallel work",
@@ -602,6 +610,7 @@ function mergePluginConfigs(base, override) {
     ...base,
     ...override,
     agents: deepMerge(base.agents, override.agents),
+    presets: deepMerge(base.presets, override.presets),
     tmux: deepMerge(base.tmux, override.tmux),
     multiplexer: deepMerge(base.multiplexer, override.multiplexer),
     interview: deepMerge(base.interview, override.interview),
@@ -673,15 +682,33 @@ function loadPluginConfig(directory, options) {
   }
   return config;
 }
-function loadAgentPrompt(agentName, preset) {
+function loadAgentPrompt(agentName, optionsOrPreset) {
+  let preset;
+  let projectDirectory;
+  if (typeof optionsOrPreset === "string") {
+    preset = optionsOrPreset;
+  } else if (optionsOrPreset && typeof optionsOrPreset === "object") {
+    preset = optionsOrPreset.preset;
+    projectDirectory = optionsOrPreset.projectDirectory;
+  }
   const presetDirName = preset && /^[a-zA-Z0-9_-]+$/.test(preset) ? preset : undefined;
-  const promptSearchDirs = getConfigSearchDirs().flatMap((configDir) => {
-    const promptsDir = path.join(configDir, PROMPTS_DIR_NAME);
-    return presetDirName ? [path.join(promptsDir, presetDirName), promptsDir] : [promptsDir];
-  });
-  const result = {};
+  const searchDirs = [];
+  if (projectDirectory && presetDirName) {
+    searchDirs.push(path.join(projectDirectory, ".opencode", PROMPTS_DIR_NAME, presetDirName));
+  }
+  if (projectDirectory) {
+    searchDirs.push(path.join(projectDirectory, ".opencode", PROMPTS_DIR_NAME));
+  }
+  if (presetDirName) {
+    for (const userDir of getConfigSearchDirs()) {
+      searchDirs.push(path.join(userDir, PROMPTS_DIR_NAME, presetDirName));
+    }
+  }
+  for (const userDir of getConfigSearchDirs()) {
+    searchDirs.push(path.join(userDir, PROMPTS_DIR_NAME));
+  }
   const readFirstPrompt = (fileName, errorPrefix) => {
-    for (const dir of promptSearchDirs) {
+    for (const dir of searchDirs) {
       const promptPath = path.join(dir, fileName);
       if (!fs.existsSync(promptPath)) {
         continue;
@@ -694,6 +721,7 @@ function loadAgentPrompt(agentName, preset) {
     }
     return;
   };
+  const result = {};
   result.prompt = readFirstPrompt(`${agentName}.md`, "Error reading prompt file");
   result.appendPrompt = readFirstPrompt(`${agentName}_append.md`, "Error reading append prompt file");
   return result;
@@ -732,7 +760,8 @@ function emptySnapshot() {
   return {
     version: 1,
     updatedAt: Date.now(),
-    agentModels: {}
+    agentModels: {},
+    agentVariants: {}
   };
 }
 function parseSnapshot(value) {
@@ -742,7 +771,8 @@ function parseSnapshot(value) {
   return {
     version: 1,
     updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : Date.now(),
-    agentModels: parsed.agentModels ?? {}
+    agentModels: parsed.agentModels ?? {},
+    agentVariants: parsed.agentVariants ?? {}
   };
 }
 function readTuiSnapshot() {
@@ -776,14 +806,32 @@ function updateSnapshot(mutator) {
 function recordTuiAgentModels(input) {
   updateSnapshot((snapshot) => {
     snapshot.agentModels = { ...input.agentModels };
+    snapshot.agentVariants = { ...input.agentVariants ?? {} };
   });
 }
 function recordTuiAgentModel(input) {
   updateSnapshot((snapshot) => {
     snapshot.agentModels[input.agentName] = input.model;
+    if (input.variant !== undefined) {
+      if (input.variant === null) {
+        delete snapshot.agentVariants[input.agentName];
+      } else {
+        snapshot.agentVariants[input.agentName] = input.variant;
+      }
+    }
   });
 }
 
+// src/utils/env.ts
+var TRUTHY_ENV_VALUES = new Set(["1", "true", "yes", "on"]);
+var PLUGIN_DISABLE_ENV = "OH_MY_OPENCODE_SLIM_DISABLE";
+function isTruthyEnvValue(value) {
+  return TRUTHY_ENV_VALUES.has(value?.trim().toLowerCase() ?? "");
+}
+function isPluginDisabledByEnv(env = process.env) {
+  return isTruthyEnvValue(env[PLUGIN_DISABLE_ENV]);
+}
+
 // src/tui.ts
 var PLUGIN_NAME = "oh-my-opencode-slim";
 var CONFIG_WARNING_COLOR = "orange";
@@ -816,27 +864,56 @@ function text(props, children) {
 function box(props, children = []) {
   return element("box", props, children);
 }
-function truncate(value, max = 24) {
-  return value.length > max ? `${value.slice(0, max - 1)}…` : value;
-}
 function getTuiDirectory(api) {
   return api.state?.path?.directory ?? process.cwd();
 }
-function formatSidebarModelName(model) {
-  const lastSlash = model.lastIndexOf("/");
-  return lastSlash === -1 ? model : model.slice(lastSlash + 1);
+function splitSidebarModelId(model) {
+  const slashIndex = model.indexOf("/");
+  if (slashIndex === -1) {
+    return { model };
+  }
+  return {
+    provider: model.slice(0, slashIndex),
+    model: model.slice(slashIndex + 1)
+  };
 }
 function getSidebarAgentNames(snapshot) {
   const configuredAgents = Object.keys(snapshot.agentModels);
   return configuredAgents.length > 0 ? configuredAgents : FALLBACK_SIDEBAR_AGENTS;
 }
-function row(label, value, theme, valueColor) {
-  return box({ width: "100%", flexDirection: "row", justifyContent: "space-between" }, [
+function agentRow(label, model, variant, theme) {
+  const modelParts = splitSidebarModelId(model);
+  const detailRows = [];
+  function detailRow(fieldLabel, value) {
+    return box({ width: "100%", flexDirection: "row", paddingLeft: 2 }, [
+      text({ fg: theme.textMuted, width: 9 }, [fieldLabel]),
+      text({ fg: theme.textMuted }, [value])
+    ]);
+  }
+  if (modelParts.provider) {
+    detailRows.push(detailRow("provider", modelParts.provider));
+  }
+  detailRows.push(detailRow("model", modelParts.model));
+  if (variant) {
+    detailRows.push(detailRow("variant", variant));
+  }
+  return box({ width: "100%", flexDirection: "column", marginBottom: 1 }, [
     text({ fg: theme.textMuted }, [label]),
-    text({ fg: valueColor ?? theme.text }, [value])
+    ...detailRows
   ]);
 }
-function renderSidebar(snapshot, version, theme, configInvalid) {
+function compactAgentRow(label, model, variant, theme) {
+  const value = variant ? `${model} (${variant})` : model;
+  return box({
+    width: "100%",
+    flexDirection: "row",
+    justifyContent: "space-between"
+  }, [
+    text({ fg: theme.textMuted, width: 14 }, [label]),
+    text({ fg: theme.textMuted }, [value])
+  ]);
+}
+function renderSidebar(snapshot, version, theme, configInvalid, compactSidebar) {
   const configStatusRow = buildConfigStatusRow(configInvalid, theme);
   return box({
     width: "100%",
@@ -863,7 +940,11 @@ function renderSidebar(snapshot, version, theme, configInvalid) {
     ]),
     ...getSidebarAgentNames(snapshot).map((agentName) => {
       const model = snapshot.agentModels[agentName] ?? "pending";
-      return row(agentName, truncate(formatSidebarModelName(model), 26), theme, theme.textMuted);
+      const variant = snapshot.agentVariants[agentName];
+      if (compactSidebar) {
+        return compactAgentRow(agentName, model, variant, theme);
+      }
+      return agentRow(agentName, model, variant, theme);
     })
   ]);
 }
@@ -880,22 +961,28 @@ function buildConfigStatusRow(configInvalid, theme) {
     text({ fg: theme.textMuted }, ["Run doctor for details"])
   ]);
 }
-function readConfigInvalid(directory) {
+function readConfigState(directory) {
   let configInvalid = false;
-  loadPluginConfig(directory, {
+  const config = loadPluginConfig(directory, {
     silent: true,
     onWarning: () => {
       configInvalid = true;
     }
   });
-  return configInvalid;
+  const compactSidebar = config.compactSidebar ?? false;
+  return { configInvalid, compactSidebar };
+}
+function readConfigInvalid(directory) {
+  return readConfigState(directory).configInvalid;
 }
 var plugin = {
   id: `${PLUGIN_NAME}:tui`,
   tui: async (api, _options, meta) => {
+    if (isPluginDisabledByEnv())
+      return;
     const version = meta.version ?? await readPackageVersion() ?? "dev";
     let configDirectory = getTuiDirectory(api);
-    let configInvalid = readConfigInvalid(configDirectory);
+    let { configInvalid, compactSidebar } = readConfigState(configDirectory);
     let snapshot = readTuiSnapshot();
     const renderTimer = setInterval(async () => {
       try {
@@ -903,7 +990,7 @@ var plugin = {
         const currentDirectory = getTuiDirectory(api);
         if (currentDirectory !== configDirectory) {
           configDirectory = currentDirectory;
-          configInvalid = readConfigInvalid(configDirectory);
+          ({ configInvalid, compactSidebar } = readConfigState(configDirectory));
         }
         api.renderer.requestRender();
       } catch {}
@@ -915,7 +1002,7 @@ var plugin = {
       order: 900,
       slots: {
         sidebar_content() {
-          return renderSidebar(snapshot, version, api.theme.current, configInvalid);
+          return renderSidebar(snapshot, version, api.theme.current, configInvalid, compactSidebar);
         }
       }
     });
@@ -923,8 +1010,8 @@ var plugin = {
 };
 var tui_default = plugin;
 export {
+  splitSidebarModelId,
   readConfigInvalid,
   getSidebarAgentNames,
-  formatSidebarModelName,
   tui_default as default
 };

package/dist/utils/background-job-board.d.ts

@@ -14,6 +14,7 @@ export interface BackgroundJobRecord {
     objective?: string;
     state: BackgroundJobState;
     timedOut: boolean;
+    recoverableAfterLiveBusy: boolean;
     statusUncertain: boolean;
     cancellationRequested: boolean;
     terminalUnreconciled: boolean;
@@ -28,6 +29,9 @@ export interface BackgroundJobRecord {
     lastUsedAt: number;
     terminalState?: TaskOutputState;
     contextFiles: ContextFile[];
+    totalErrors?: number;
+    timeoutCount?: number;
+    lastErrorAt?: number;
 }
 export interface BackgroundJobBoardOptions {
     maxReusablePerAgent?: number;
@@ -51,13 +55,19 @@ export interface BackgroundJobStatusInput {
     lastStatusError?: string;
     now?: number;
 }
+type TerminalStateListener = (taskID: string) => void;
 export declare class BackgroundJobBoard {
     private readonly jobs;
     private readonly counters;
+    private terminalStateListeners;
     private readonly maxReusablePerAgent;
     private readonly readContextMinLines;
     private readonly readContextMaxFiles;
     constructor(options?: BackgroundJobBoardOptions);
+    addTerminalStateListener(listener: TerminalStateListener): void;
+    removeTerminalStateListener(listener: TerminalStateListener): void;
+    setTerminalStateListener(listener?: TerminalStateListener): void;
+    private notifyTerminalStateListeners;
     registerLaunch(input: BackgroundJobLaunchInput): BackgroundJobRecord;
     updateStatus(input: BackgroundJobStatusInput): BackgroundJobRecord | undefined;
     updateFromStatusOutput(output: string): BackgroundJobRecord | undefined;
@@ -67,14 +77,23 @@ export declare class BackgroundJobBoard {
         force?: boolean;
     }): BackgroundJobRecord | undefined;
     get(taskID: string): BackgroundJobRecord | undefined;
+    field<K extends keyof BackgroundJobRecord>(taskID: string, key: K): BackgroundJobRecord[K] | undefined;
+    isRunning(taskID: string): boolean;
+    isTerminalUnreconciled(taskID: string): boolean;
+    getResultSummary(taskID: string): string | undefined;
+    getLastLiveBusyAt(taskID: string): number | undefined;
+    getParentSessionID(taskID: string): string | undefined;
+    getState(taskID: string): BackgroundJobState | undefined;
     resolve(parentSessionID: string, taskIDOrAlias: string): BackgroundJobRecord | undefined;
     resolveReusable(parentSessionID: string, taskIDOrAlias: string, agent?: string): BackgroundJobRecord | undefined;
+    resolveRecoverable(parentSessionID: string, taskIDOrAlias: string, agent?: string): BackgroundJobRecord | undefined;
     markUsed(parentSessionID: string, key: string, now?: number): void;
     taskIDs(): Set<string>;
     addContext(taskID: string, files: ContextFile[]): void;
     list(parentSessionID?: string): BackgroundJobRecord[];
     hasRunning(parentSessionID: string): boolean;
     hasTerminalUnreconciled(parentSessionID: string): boolean;
+    hasConvergenceSignals(taskID: string, threshold?: number): boolean;
     formatForPrompt(parentSessionID: string, now?: number): string | undefined;
     clearParent(parentSessionID: string): void;
     drop(taskID: string): void;
@@ -87,3 +106,4 @@ export declare function deriveTaskSessionLabel(input: {
     prompt?: string;
     agentType: string;
 }): string;
+export {};

package/dist/utils/env.d.ts

@@ -0,0 +1,3 @@
+export declare const PLUGIN_DISABLE_ENV = "OH_MY_OPENCODE_SLIM_DISABLE";
+export declare function isTruthyEnvValue(value: string | undefined): boolean;
+export declare function isPluginDisabledByEnv(env?: NodeJS.ProcessEnv): boolean;

package/dist/utils/session.d.ts

@@ -52,7 +52,7 @@ export declare function parseModelReference(model: string): {
 export declare function promptWithTimeout(client: OpencodeClient, args: Parameters<OpencodeClient['session']['prompt']>[0], timeoutMs: number, signal?: AbortSignal): Promise<void>;
 /**
  * Result of extracting session content.
- * `empty` is true when the assistant produced zero text content —
+ * `empty` is true when the assistant produced zero text content -
  * the provider returned an empty response (e.g. rate-limited silently).
  */
 export interface SessionExtractionResult {

package/oh-my-opencode-slim.schema.json

@@ -8,6 +8,10 @@
     "setDefaultAgent": {
       "type": "boolean"
     },
+    "compactSidebar": {
+      "description": "Use the compact TUI sidebar layout when enabled.",
+      "type": "boolean"
+    },
     "autoUpdate": {
       "description": "Disable automatic installation of plugin updates when false. Defaults to true.",
       "type": "boolean"
@@ -197,6 +201,20 @@
         "type": "string"
       }
     },
+    "disabled_tools": {
+      "description": "Tool names to disable completely. Disabled tools are not registered with OpenCode and cannot be used by agents.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "disabled_skills": {
+      "description": "Skill names to disable completely. Disabled skills are not granted to agents, even when referenced by presets or agent overrides.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
     "multiplexer": {
       "type": "object",
       "properties": {
@@ -207,6 +225,7 @@
             "auto",
             "tmux",
             "zellij",
+            "herdr",
             "none"
           ]
         },
@@ -403,7 +422,7 @@
           "maximum": 5
         },
         "master": {
-          "description": "DEPRECATED — ignored. Council agent synthesizes directly."
+          "description": "DEPRECATED - ignored. Council agent synthesizes directly."
         }
       },
       "required": [
@@ -515,10 +534,11 @@
             "pattern": "^[^/\\s]+\\/[^\\s]+$"
           },
           "timeoutMs": {
-            "default": 300000,
+            "default": 0,
+            "description": "Timeout for a single ACP run in milliseconds. Set to 0 to disable the timeout.",
             "type": "integer",
-            "minimum": 1000,
-            "maximum": 900000
+            "minimum": 0,
+            "maximum": 2147483647
           },
           "permissionMode": {
             "default": "ask",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-opencode-slim",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "description": "Lightweight agent orchestration plugin for OpenCode - a slimmed-down fork of oh-my-opencode",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/skills/clonedeps/SKILL.md

@@ -217,9 +217,9 @@ sentence so future agents do not need an extra read just to know what is there:
 Read-only dependency source repositories are available under
 `.slim/clonedeps/repos/` for inspection. Do not edit these clones.
 
-- `.slim/clonedeps/repos/<safe-name>/` — `<repo>` at `<ref>`; <one sentence on
+- `.slim/clonedeps/repos/<safe-name>/` - `<repo>` at `<ref>`; <one sentence on
   why this source is useful>.
-- `.slim/clonedeps/repos/<safe-name-2>/` — `<repo>` at `<ref>`; <one sentence on
+- `.slim/clonedeps/repos/<safe-name-2>/` - `<repo>` at `<ref>`; <one sentence on
   why this source is useful>.
 ```
 

package/src/skills/clonedeps/codemap.md

@@ -1,41 +1,32 @@
 # src/skills/clonedeps/
 
 ## Responsibility
-
-Workflow-only bundled OpenCode skill for local dependency source mirroring. It
-instructs the orchestrator to use `@librarian` for dependency discovery and
-source URL/ref resolution, then perform approved git/filesystem operations
-directly.
+Manages the cloning and management of read-only dependency source repositories into `.slim/clonedeps/repos/` for offline inspection. This skill provides a workflow (not a command wrapper) that guides the orchestrator and `@librarian` through cloning dependency sources so agents can inspect library internals without requiring network access.
 
 ## Design
-
-- `SKILL.md` is the prompt contract loaded by OpenCode and assigned only to the
-  orchestrator.
-- No helper script is bundled. The skill avoids brittle cross-ecosystem parsing
-  and keeps repo-specific judgment in librarian/orchestrator.
-- State is trackable project metadata stored in `.slim/clonedeps.json`; clone
-  contents live under `.slim/clonedeps/repos/<safe-dependency-name>/` and are
-  ignored by git.
-- The workflow updates `.gitignore`, `.ignore`, and root `AGENTS.md` with
-  concise marker sections so cloned source stays out of git but visible to
-  OpenCode and discoverable by future agents.
+- **Workflow skill, not a command wrapper**: No helper scripts or TypeScript utility functions. The orchestrator owns the decision-making; `@librarian` recommends sources; the orchestrator performs filesystem/git operations directly.
+- **Read-only clones**: Dependencies are cloned into `.slim/clonedeps/repos/` and should not be modified.
+- **Cache strategy**: Existing clones are reused when they satisfy the task. Only fetch when the manifest entry is missing or stale.
+- **Agent-driven**: No runtime TS helpers (no `getClonedDepPath` utility). Agents resolve paths from `.slim/clonedeps.json` if needed.
+- **Configuration**: Uses `.slim/clonedeps.json` in the project root to define which repositories are cloned and their checked-out refs.
 
 ## Flow
-
-1. Orchestrator checks `.slim/clonedeps.json` first and reuses existing clones
-   when they satisfy the current task.
-2. Orchestrator asks librarian for a small source-resolution plan across the
-   repository's actual languages/ecosystems.
-3. Orchestrator verifies refs where possible and asks the user to approve.
-4. Orchestrator clones/fetches each approved source repo once into
-   `.slim/clonedeps/repos/<safe-repo-name>/`.
-5. Orchestrator writes `.slim/clonedeps.json` with paths, refs, and reasons.
-6. Orchestrator updates `.gitignore`, `.ignore`, and root `AGENTS.md`; the
-   AGENTS section lists each read-only clone path directly with a one-sentence
-   purpose.
+1. **Check existing state**: Read `.slim/clonedeps.json` (if it exists). Check whether each listed `path` exists under `.slim/clonedeps/repos/`.
+2. **Ask librarian for plan**: Delegate dependency discovery and source resolution to `@librarian`, who returns a small plan (dependency name, repo URL, ref, package subdirectory, reason).
+3. **Verify and confirm**: Orchestrator verifies refs with `git ls-remote`, avoids unsafe URLs, presents plan to user, and gets approval before cloning.
+4. **Clone sources**: Orchestrator runs git commands directly. Creates one folder per source under `.slim/clonedeps/repos/<safe-repo-name>/`. Prefers shallow clones, pinned tags, HTTPS URLs.
+5. **Write local state**: Writes `.slim/clonedeps.json` with structured manifest (version, updatedAt, dependencies array).
+6. **Update ignore files**: Adds idempotent marker blocks to `.gitignore` and `.ignore`.
+7. **Register in AGENTS.md**: Appends a `## Cloned Dependency Source` section so future agents know what exists.
 
 ## Integration
-
-- Registered in `src/cli/custom-skills.ts` with orchestrator-only permission.
-- Included in release verification via `scripts/verify-release-artifact.ts`.
-- Documented in `docs/skills.md` and included in `src/skills/codemap.md`.
+- **Consumed by**: Agents that need to inspect dependency internals (e.g., `@librarian`, `@explorer`) via the registered paths in AGENTS.md.
+- **Depends on**: Git CLI (for `git clone`, `git ls-remote`), `.slim/clonedeps.json` manifest.
+- **Outputs**: Local filesystem paths under `.slim/clonedeps/repos/` for agent inspection.
+
+## Notes
+- Cloned repositories are read-only and should not be edited.
+- The cache directory (`.slim/clonedeps/repos/`) is in the **project directory**, not the user's home directory.
+- This skill is for development and debugging; it does not affect runtime behavior.
+- `.slim/clonedeps.json` is small structured metadata that can be committed.
+- Only `.slim/clonedeps/repos/` is gitignored.

package/src/skills/codemap/SKILL.md

@@ -87,7 +87,7 @@ Once all specific directories are mapped, the Orchestrator must create or update
 
 **OpenCode auto-loads `AGENTS.md` into agent context on every session.** To ensure agents automatically discover and use the codemap, update (or create) `AGENTS.md` at the repo root:
 
-1. If `AGENTS.md` already exists and already contains a `## Repository Map` section, **skip this step** — the reference is already set up.
+1. If `AGENTS.md` already exists and already contains a `## Repository Map` section, **skip this step** - the reference is already set up.
 2. If `AGENTS.md` exists but has no `## Repository Map` section, **append** the section below.
 3. If `AGENTS.md` doesn't exist, **create** it with the section below.
 
@@ -104,7 +104,7 @@ Before working on any task, read `codemap.md` to understand:
 For deep work on a specific folder, also read that folder's `codemap.md`.
 ```
 
-This is idempotent — repeated codemap runs will detect the existing section and skip. No duplication.
+This is idempotent - repeated codemap runs will detect the existing section and skip. No duplication.
 
 ## Codemap Content