codedeck 0.2.0 → 0.3.0

package/dist/open/launchers/claude.js

@@ -0,0 +1,212 @@
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import { DISPATCHER_PRESET } from "../../config/orchestrator-mode.js";
+import { detectBinary } from "../../drivers/helpers.js";
+import { getRegistry } from "../../drivers/registry.js";
+import { getCachedOrDiscoverModels } from "../../core/models.js";
+import { catalogWarning, judgeModelIn, readUltra } from "../contract.js";
+import { composeOrchestratorProse } from "../orchestrator-prose.js";
+import { errorDetails, sanitizeEnv, shellQuote, spinnerTips, SPINNER_VERBS, } from "../runtime.js";
+export const DEFAULT_MODEL = "claude-opus-4-8";
+export const DEFAULT_EFFORT = "xhigh";
+const PLUGIN_NAME = "codedeck";
+const THEME_REF = `custom:${PLUGIN_NAME}:codedeck-ultra`;
+/**
+ * There is no startup text slot worth using, and the two that exist were tried.
+ *
+ * `companyAnnouncements` renders our string, but Claude Code puts its own dim
+ * "Message from <organization>:" above it whenever the account belongs to one,
+ * with no way to suppress that from settings. On an account with an org it
+ * therefore reads as a message from the employer, which is false.
+ *
+ * A SessionStart hook can print, but every hook message renders as
+ * "<hook> says: <text>", so it cannot draw a clean line either.
+ *
+ * Nothing is lost by leaving both alone. Claude Code's own opening header
+ * already names the model, the effort and the agent, and the footer already
+ * says whether permissions are bypassed.
+ */
+export const CLAUDE_NOT_FOUND = "Claude Code was not found on PATH. Install Claude Code and ensure `claude` is available.";
+const execFileAsync = promisify(execFile);
+/**
+ * The settings are built here, at launch, rather than shipped as a file, and
+ * the reason is the status line.
+ *
+ * `${CLAUDE_PLUGIN_ROOT}` is expanded only for hooks declared in a plugin's
+ * hooks/hooks.json. It is never expanded for statusLine.command: the runner
+ * calls its executor with nine arguments where the plugin root sits in the
+ * fourteenth, so the check reads undefined and throws "This variable is only
+ * available in hooks defined in a plugin's hooks/hooks.json file". The runner
+ * swallows that, so the shipped settings.json produced no status line and no
+ * error, in any version. `open` knows the real directory, so it writes the
+ * resolved path instead of a placeholder nothing will substitute.
+ *
+ * Building it here also means one definition rather than two: the file that
+ * shipped alongside this code was never exercised by a launch, which is exactly
+ * how a broken command sat in it unnoticed.
+ */
+export function buildSettings(pluginDir, flags) {
+    const statusLine = {
+        type: "command",
+        command: `bash ${shellQuote(path.join(pluginDir, "statusline.sh"))}`,
+        refreshInterval: 2,
+    };
+    // --no-theme means "do not restyle my session", so it drops the whole look,
+    // renderer included, and not just the palette. The status line is the one
+    // thing it keeps, because that is what the flag has always promised.
+    if (flags.theme === false)
+        return { statusLine };
+    return {
+        theme: THEME_REF,
+        tui: "fullscreen",
+        spinnerVerbs: { mode: "replace", verbs: SPINNER_VERBS },
+        spinnerTipsOverride: { excludeDefault: true, label: "ULTRA", tips: spinnerTips() },
+        statusLine,
+    };
+}
+/**
+ * The session name is what Claude shows on the ruler above the input, in
+ * `/resume` and in the window title, so it carries the project folder along
+ * with the role. With three terminals open on the same role, the role alone
+ * leaves them indistinguishable. The role stays last because the status line
+ * reads it off the tail of this same string.
+ */
+export function sessionName(role, cwd) {
+    const project = cwd?.split("/").filter(Boolean).at(-1)?.replace(/[\t\r\n]/g, " ").trim();
+    if (!project)
+        return `CodeDeck · ${role}`;
+    return `CodeDeck · ${project} · ${role}`;
+}
+export function buildOpenArgs(role, flags, pluginDir, passthrough, cwd, mode = DISPATCHER_PRESET) {
+    const orchestratorProse = role === "orchestrator" ? composeOrchestratorProse(mode) : "";
+    const agent = role !== "orchestrator"
+        ? `${PLUGIN_NAME}:${role}`
+        : `${PLUGIN_NAME}:orchestrator${mode.tools === "dispatch" ? "" : `-${mode.tools}`}`;
+    const args = [
+        "--model",
+        flags.model ?? DEFAULT_MODEL,
+        "--effort",
+        flags.effort ?? DEFAULT_EFFORT,
+        // Remote Control is interactive-only. It requires a subscribed Claude
+        // account and a prior workspace-trust dialog.
+        ...(flags.remoteControl !== false ? ["--remote-control"] : []),
+        ...(flags.bypass !== false ? ["--dangerously-skip-permissions"] : []),
+        "--plugin-dir",
+        pluginDir,
+        ...appendSystemPromptArgs(pluginDir, orchestratorProse),
+        "--settings",
+        JSON.stringify(buildSettings(pluginDir, flags)),
+        // `--agent` layers on top of Claude's own system prompt rather than
+        // replacing it, and an agent file with no `tools:` key inherits the whole
+        // toolset. So `general` carries its contract the same way the others do,
+        // with nothing taken away.
+        "--agent",
+        agent,
+        "-n",
+        sessionName(role, cwd),
+        ...(flags.resume ? ["--resume", flags.resume] : []),
+        ...(flags.worktree ? ["-w"] : []),
+        ...passthrough,
+    ];
+    return args;
+}
+/**
+ * Ultra ships as a file, but Claude Code refuses --append-system-prompt-file
+ * together with --append-system-prompt, and an orchestrator preset needs its
+ * dynamic prose appended too. With prose the two are merged and handed over
+ * inline as the single source Claude allows; without it the file keeps the
+ * original, cheaper contract.
+ */
+function appendSystemPromptArgs(pluginDir, prose) {
+    if (!prose)
+        return ["--append-system-prompt-file", path.join(pluginDir, "ultra.md")];
+    return ["--append-system-prompt", `${readUltra(pluginDir).trimEnd()}\n\n${prose}`];
+}
+/**
+ * The claude half of the split: find this harness's catalog, judge it with
+ * the shared pure verdict. Kept while the suite pins this shape.
+ */
+export function judgeModel(model, catalogs, fromConfig) {
+    return judgeModelIn(catalogs?.find((item) => item.agent === "claude"), model, fromConfig, "Claude");
+}
+export async function preflightModel(model, fromConfig) {
+    let catalogs;
+    try {
+        catalogs = await getCachedOrDiscoverModels(getRegistry(), { agent: "claude" });
+    }
+    catch (error) {
+        // A catalog that cannot be reached is not evidence against the model, so
+        // this warns and lets the launch decide.
+        const details = errorDetails(error);
+        console.warn(catalogWarning("Claude", model, `unavailable (${details.text})`));
+        return;
+    }
+    const verdict = judgeModel(model, catalogs, fromConfig);
+    if (verdict.kind === "ok")
+        return;
+    if (verdict.kind === "unknown-catalog") {
+        console.warn(verdict.warning);
+        return;
+    }
+    throw new Error(verdict.error);
+}
+/**
+ * Returns the resolved path rather than a boolean so everything downstream
+ * launches the exact binary that was checked, instead of asking PATH again and
+ * hoping it answers the same way.
+ */
+export async function resolveBinary() {
+    // detectBinary reports failure in its result and never rejects, so there is
+    // nothing here to catch.
+    const installation = await detectBinary("claude");
+    if (!installation.installed || !installation.path) {
+        throw new Error(CLAUDE_NOT_FOUND);
+    }
+    return installation.path;
+}
+export async function assertSupport(claudeBin, cwd) {
+    try {
+        await execFileAsync(claudeBin, ["--append-system-prompt-file"], {
+            cwd,
+            env: sanitizeEnv(process.env),
+            timeout: 5000,
+            maxBuffer: 1024 * 1024,
+        });
+    }
+    catch (error) {
+        const details = errorDetails(error);
+        if (details.code === "ENOENT") {
+            throw new Error(CLAUDE_NOT_FOUND);
+        }
+        if (/unknown option|unknown argument|unrecognized option|invalid option/i.test(details.text)) {
+            throw new Error("This Claude Code version does not support --append-system-prompt-file. Upgrade Claude Code and retry.");
+        }
+        // A supported Commander option reports a missing argument for this probe.
+        // Other probe failures are left to the real launch, which can provide the
+        // harness-specific diagnostic without blocking a valid installation.
+    }
+}
+/**
+ * The catalog knows which models exist, not which ones this account may use, so
+ * an entitlement problem can only be read off the launch itself. Claude Code
+ * reports it as a tagged error rather than a distinct exit code.
+ */
+export function entitlementError(model, output) {
+    const tag = /\[claude-code:unrecognized_model\]\s*(\{.*\})?/i.exec(output);
+    if (!tag)
+        return undefined;
+    // The passthrough can carry its own --model, which wins over the one CodeDeck
+    // resolved, so the name in the payload is the one that was actually rejected.
+    let rejected = model;
+    if (tag[1]) {
+        try {
+            const payload = JSON.parse(tag[1]);
+            if (typeof payload.model === "string" && payload.model)
+                rejected = payload.model;
+        }
+        catch { }
+    }
+    return `Claude Code rejected model "${rejected}" because this account is not entitled to it. Check the Claude plan or model access for the account.`;
+}
+//# sourceMappingURL=claude.js.map

package/dist/open/launchers/claude.js.map

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

package/dist/open/launchers/opencode.js

@@ -0,0 +1,178 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { detectBinary } from "../../drivers/helpers.js";
+import { getRegistry } from "../../drivers/registry.js";
+import { getCachedOrDiscoverModels } from "../../core/models.js";
+import { catalogWarning, judgeModelIn, resolveRoleContract, } from "../contract.js";
+import { DISPATCHER_PRESET } from "../../config/orchestrator-mode.js";
+import { composeOrchestratorProse } from "../orchestrator-prose.js";
+/**
+ * Claude `tools:` becomes opencode `permission:`. Every key below was
+ * resolved live through `opencode debug agent`: `edit: deny` turns off edit
+ * and write, `read: deny` turns off read with bash intact, `task: deny`
+ * turns off dispatch, and `"*": "allow"` turns everything on. No role leans
+ * on user defaults, so `general` stays unrestricted and the restricted three
+ * stay restricted whatever the user configured globally.
+ */
+export function rolePermission(role, mode = DISPATCHER_PRESET) {
+    switch (role) {
+        case "general":
+            return { "*": "allow" };
+        case "orchestrator":
+            switch (mode.tools) {
+                case "dispatch":
+                    return { read: "deny", edit: "deny", write: "deny", task: "deny", bash: "allow" };
+                case "read":
+                    return { read: "allow", edit: "deny", write: "deny", task: "deny", bash: "allow" };
+                case "edit":
+                    return { read: "allow", edit: "allow", write: "allow", task: "deny", bash: "allow" };
+            }
+        case "reviewer":
+            return { edit: "deny", write: "deny", task: "deny", bash: "allow" };
+        case "auditor":
+            return { edit: "deny", write: "deny", task: "allow", bash: "allow" };
+    }
+}
+export function agentName(role) {
+    return `codedeck-${role}`;
+}
+/**
+ * The whole opencode contract as one `OPENCODE_CONFIG_CONTENT` value: global
+ * instructions from ultra plus the role agent carrying its prompt and
+ * permission map. Pure and file-free: nothing lands in `~/.config/opencode`
+ * or tmp, so there is nothing to clean up and concurrent opens share nothing.
+ */
+export function buildInlineConfig(pluginDir, role, mode = DISPATCHER_PRESET) {
+    const { agentBody, ultra } = resolveRoleContract(pluginDir, role);
+    const orchestratorProse = role === "orchestrator" ? composeOrchestratorProse(mode) : "";
+    return JSON.stringify({
+        instructions: [ultra],
+        agent: {
+            [agentName(role)]: {
+                mode: "primary",
+                description: `CodeDeck ${role}`,
+                prompt: orchestratorProse ? `${agentBody}\n\n${orchestratorProse}` : agentBody,
+                permission: rolePermission(role, mode),
+            },
+        },
+    });
+}
+const MODEL_SHAPE = /^[^/\s]+\/[^/\s]+$/;
+export function buildArgs(role, flags, passthrough) {
+    if (!MODEL_SHAPE.test(flags.model)) {
+        throw new Error(`Model "${flags.model}" must be provider/model for opencode (e.g. anthropic/claude-sonnet-4-6).`);
+    }
+    return [
+        "--agent",
+        agentName(role),
+        "--model",
+        flags.model,
+        // --auto mirrors the claude bypass default; --no-bypass drops it. Effort
+        // has no opencode equivalent in this scope and stays unmapped.
+        ...(flags.bypass !== false ? ["--auto"] : []),
+        ...(flags.resume ? ["--session", flags.resume] : []),
+        ...passthrough,
+    ];
+}
+export const OPENCODE_NOT_FOUND = "Opencode was not found on PATH. Install opencode and ensure `opencode` is available.";
+/**
+ * The opencode half of the CodeDeck look. The name answers to the theme file
+ * basename: `codedeck-rage.json` selected as `codedeck-rage`, the same rule
+ * the Claude side pins for its own slug.
+ */
+export const OPENCODE_THEME_NAME = "codedeck-rage";
+const OPENCODE_THEME_FILE = `${OPENCODE_THEME_NAME}.json`;
+/**
+ * Where opencode discovers custom theme files. Project directories come
+ * first at runtime, but a launch must not write into the user's checkout,
+ * so the managed copy lives here, next to the user's own themes.
+ */
+export function userThemesDir(home = os.homedir(), xdgConfigHome = process.env.XDG_CONFIG_HOME) {
+    const configHome = xdgConfigHome && xdgConfigHome.length > 0
+        ? xdgConfigHome
+        : path.join(home, ".config");
+    return path.join(configHome, "opencode", "themes");
+}
+/** The per-session TUI selection, as an ephemeral config dir understands it. */
+export function buildTuiConfig() {
+    return JSON.stringify({
+        $schema: "https://opencode.ai/tui.json",
+        theme: OPENCODE_THEME_NAME,
+    });
+}
+/**
+ * Installs the managed theme file when it is missing or stale. Returns
+ * whether the theme can be selected: a read-only home or a broken plugin
+ * directory falls back to the user's own theme instead of failing the launch.
+ */
+export function ensureOpencodeTheme(pluginDir, themesDir = userThemesDir()) {
+    try {
+        const wanted = fs.readFileSync(path.join(pluginDir, "themes", OPENCODE_THEME_FILE), "utf8");
+        const target = path.join(themesDir, OPENCODE_THEME_FILE);
+        let current;
+        try {
+            current = fs.readFileSync(target, "utf8");
+        }
+        catch {
+            current = undefined;
+        }
+        if (current !== wanted) {
+            fs.mkdirSync(themesDir, { recursive: true });
+            fs.writeFileSync(target, wanted);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * A config dir holding only the TUI selection. The main contract still
+ * travels through OPENCODE_CONFIG_CONTENT, which merges with every config
+ * dir, so this stays a one-file directory with nothing to drift.
+ */
+export function createEphemeralTuiDir() {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "codedeck-opencode-"));
+    fs.writeFileSync(path.join(dir, "tui.json"), buildTuiConfig());
+    return dir;
+}
+export function removeEphemeralTuiDir(dir) {
+    try {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+    catch { }
+}
+/**
+ * Returns the resolved path rather than a boolean so everything downstream
+ * launches the exact binary that was checked.
+ */
+export async function resolveBinary() {
+    const installation = await detectBinary("opencode");
+    if (!installation.installed || !installation.path) {
+        throw new Error(OPENCODE_NOT_FOUND);
+    }
+    return installation.path;
+}
+export async function preflight(model, fromConfig) {
+    let catalogs;
+    try {
+        catalogs = await getCachedOrDiscoverModels(getRegistry(), { agent: "opencode" });
+    }
+    catch (error) {
+        // A catalog that cannot be reached is not evidence against the model, so
+        // this warns and lets the launch decide.
+        const text = error instanceof Error ? error.message : String(error);
+        console.warn(catalogWarning("opencode", model, `unavailable (${text})`));
+        return;
+    }
+    const verdict = judgeModelIn(catalogs?.find((item) => item.agent === "opencode"), model, fromConfig, "opencode");
+    if (verdict.kind === "ok")
+        return;
+    if (verdict.kind === "unknown-catalog") {
+        console.warn(verdict.warning);
+        return;
+    }
+    throw new Error(verdict.error);
+}
+//# sourceMappingURL=opencode.js.map

package/dist/open/launchers/opencode.js.map

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

package/dist/open/orchestrator-prose.js

@@ -0,0 +1,12 @@
+export function composeOrchestratorProse(mode) {
+    const lines = [];
+    if (mode.investigate !== "none" || mode.selfWork !== "none") {
+        lines.push(`Investigation allowance: ${mode.investigate}.`);
+        lines.push(`Self-work allowance: ${mode.selfWork}.`);
+    }
+    if (mode.parallelism !== undefined) {
+        lines.push(`Run at most ${mode.parallelism} workers concurrently.`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=orchestrator-prose.js.map

package/dist/open/orchestrator-prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-prose.js","sourceRoot":"","sources":["../../src/open/orchestrator-prose.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CAAC,IAAsB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,WAAW,wBAAwB,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}