@wjarka/cezarion 0.10.0-pr30.54

package/dist/config.js

@@ -0,0 +1,242 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { loadWorkspaceConfig } from './workspace/config.js';
+import { RUNNER_IDS } from './core/agent-runner.js';
+/**
+ * Optional advanced config at `.ai/cezar/config.json`. Zero-config rule:
+ * a missing file behaves exactly like the default below, an unreadable or
+ * invalid file degrades to the default too (never blocks startup). The key
+ * can be overridden or emptied (`"skillsRepos": []` disables team skills).
+ */
+const skillsRepoSchema = z.object({
+    /** `owner/name` (GitHub shorthand), a full git URL, or a local/file:// path. */
+    repo: z.string().min(1),
+    ref: z.string().min(1).default('main'),
+});
+export const DEFAULT_SKILLS_REPOS = [
+    { repo: 'open-mercato/skills', ref: 'main' },
+];
+/** Last-resort retention when neither the repo nor the workspace says anything. */
+export const DEFAULT_WORKTREE_RETENTION = 10;
+/** Bounds for `worktreeRetention` — shared with the presence probe below, so the
+ *  "does this repo set its own?" question is answered by the same rule the
+ *  schema enforces (and mirrors the workspace default's bounds). */
+const worktreeRetentionSchema = z.number().int().min(0).max(1000);
+const configSchema = z.object({
+    skillsRepos: z.array(skillsRepoSchema).default(DEFAULT_SKILLS_REPOS),
+    /** How many tasks may run at once (spec 006). Non-git dirs always run 1. */
+    maxParallel: z.number().int().min(1).max(16).default(2),
+    /**
+     * Count-based worktree retention (#483): keep the last N *finished*
+     * worktrees materialized on disk; reclaim older ones (directory only — the
+     * `cez/<id8>` branch is kept, so the work stays recoverable). 0 = unlimited
+     * (never auto-reclaim). Default 10. `.catch(10)` keeps it additive-safe: a
+     * bad value degrades to the default instead of discarding the rest.
+     */
+    worktreeRetention: worktreeRetentionSchema.default(DEFAULT_WORKTREE_RETENTION).catch(DEFAULT_WORKTREE_RETENTION),
+    /**
+     * Per-task memory ceiling in MiB (whole process tree). When a running task's
+     * RSS crosses this the engine pauses it with a warning and lets the queue
+     * advance (#memory-guard). 0 / unset = no limit. `.catch(undefined)` keeps
+     * the key additive-safe: a bad value degrades to "no limit".
+     */
+    memoryLimitMb: z.number().int().min(0).max(1_048_576).optional().catch(undefined),
+    /**
+     * Which agent backend a task uses unless overridden per task (GUI) or per
+     * step (workflow). The GUI only offers runners actually installed; this is
+     * the preselected default. Also the runner the chain planner uses.
+     */
+    defaultRunner: z.enum(RUNNER_IDS).default('claude'),
+    /** Model for the chain planner (spec 008) — cheap but reliable at JSON. */
+    plannerModel: z.string().min(1).default('sonnet'),
+    /** Model for the task namer (spec 2026-07-17-task-auto-naming) — the cheapest
+     *  alias that answers strict JSON; naming is fire-and-forget and never blocks. */
+    namerModel: z.string().min(1).default('haiku'),
+    /** Live title updates: refresh the display title through the namer on each
+     *  turn end. Absent = the `CEZ_TITLE_UPDATES` env decides (default ON — owner
+     *  decision on PR #479). */
+    liveTitleUpdates: z.boolean().optional(),
+    /** Optional diff-first review gate (#489): when a successful run with changes
+     *  should park at `review` for a human. Absent = the `CEZ_REVIEW_GATE` env
+     *  decides (default OFF — the deliberate inverse of `liveTitleUpdates`).
+     *  Autonomous runs always skip the gate regardless of this. */
+    reviewGate: z.boolean().optional(),
+    /**
+     * Branch task worktrees fork from and draft PRs target (e.g. `develop`).
+     * Unset = the branch currently checked out. Settable from the Repo tab.
+     */
+    baseBranch: z.string().trim().min(1).optional(),
+    /**
+     * Default extra system prompt applied to every run's agent steps (claude:
+     * `--append-system-prompt`; codex/opencode: prepended to the opening user
+     * message — the AgentRunSpec seam handles the per-backend delivery).
+     * Settings is the single edit place; `POST /api/runs` can override it per
+     * run (`systemPrompt`). `.catch(undefined)` keeps the key additive-safe: a
+     * bad value degrades to unset without discarding the rest of the config.
+     */
+    systemPrompt: z.string().trim().min(1).max(20_000).optional().catch(undefined),
+    /**
+     * Per-runner default model preset (Settings → Agents, redesign R6 1.5): the
+     * model id the composer preselects for that runner. Missing = auto (the
+     * runner decides). A capability (`model`), never a vendor config format.
+     * `.catch(undefined)` keeps the key additive-safe like `systemPrompt`: a
+     * bad value degrades to unset without discarding the rest of the config.
+     */
+    defaultModels: z
+        .object({
+        claude: z.string().trim().min(1).max(200).optional(),
+        codex: z.string().trim().min(1).max(200).optional(),
+        opencode: z.string().trim().min(1).max(200).optional(),
+        pi: z.string().trim().min(1).max(200).optional(),
+    })
+        .optional()
+        .catch(undefined),
+    /**
+     * Make each coding agent's native model setting authoritative. This is an
+     * optional repo-level counterpart to `CEZ_AGENT_MODELS_LOCKED=1`; absent or
+     * false preserves the ordinary per-runner model selector.
+     */
+    modelsLocked: z.boolean().optional().catch(undefined),
+});
+/**
+ * Fold the machine-wide agent defaults under a repo's own config (spec 2026-07-29-agent-profiles).
+ *
+ * Applied to the RAW object, before parsing, for the reason `ownWorktreeRetention` documents just
+ * below: `defaultRunner`'s `.default('claude')` materializes the key, so after a parse there is no
+ * telling "the user chose claude" from "the user said nothing". Merging first keeps the wire shape
+ * exactly as it has always been — `defaultRunner` and the model presets stay always-present — while
+ * making an absent key mean "ask the machine".
+ *
+ * A repo key always wins, and `models` merges per RUNNER rather than wholesale: pinning claude's
+ * model in one repo must not silently discard the machine's codex preset.
+ */
+function withMachineDefaults(raw, machine) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        raw = {};
+    const own = raw;
+    const ownModels = own.defaultModels && typeof own.defaultModels === 'object'
+        ? own.defaultModels
+        : undefined;
+    const models = { ...machine.models, ...ownModels };
+    return {
+        ...own,
+        ...(own.defaultRunner === undefined && machine.runner !== undefined
+            ? { defaultRunner: machine.runner }
+            : {}),
+        ...(Object.keys(models).length > 0 ? { defaultModels: models } : {}),
+    };
+}
+/**
+ * Read `.ai/cezar/config.json` on demand — never cached, never throws.
+ *
+ * Also reads the machine-wide defaults, which is one more small JSON read and deliberately not
+ * cached for the same reason this one is not: `~/.cezar/` is shared by every cezar process on the
+ * machine, so a snapshot is a staleness bug.
+ */
+export async function loadConfig(repoRoot) {
+    const machine = (await loadWorkspaceConfig()).agentDefaults;
+    let raw;
+    try {
+        raw = await readFile(join(repoRoot, '.ai/cezar', 'config.json'), 'utf8');
+    }
+    catch {
+        return configSchema.parse(withMachineDefaults({}, machine));
+    }
+    try {
+        const parsed = configSchema.safeParse(withMachineDefaults(JSON.parse(raw), machine));
+        if (parsed.success)
+            return parsed.data;
+    }
+    catch {
+        // fall through — malformed JSON degrades to the default
+    }
+    return configSchema.parse(withMachineDefaults({}, machine));
+}
+/**
+ * The repo's OWN `worktreeRetention`, or `undefined` when it doesn't set one.
+ *
+ * `loadConfig` cannot answer this: the schema's `.default(10).catch(10)`
+ * materializes the key, so a parsed config can't tell "the user chose 10" from
+ * "the user said nothing". So we probe the raw file — a key that is absent (or
+ * carries a value the schema would refuse) means the repo has no opinion, and
+ * the workspace default gets to seed it.
+ */
+async function ownWorktreeRetention(repoRoot) {
+    let raw;
+    try {
+        raw = await readFile(join(repoRoot, '.ai/cezar', 'config.json'), 'utf8');
+    }
+    catch {
+        return undefined; // no file — nothing set
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object')
+            return undefined;
+        const value = parsed.worktreeRetention;
+        if (value === undefined)
+            return undefined;
+        const field = worktreeRetentionSchema.safeParse(value);
+        return field.success ? field.data : undefined;
+    }
+    catch {
+        return undefined; // malformed JSON — same as unset
+    }
+}
+/**
+ * The default skills repos that are *opt-in per skill* (the "import OM skills"
+ * flow): the set of repo identifiers a user must explicitly import from before
+ * their skills join the catalog. This is exactly `DEFAULT_SKILLS_REPOS` when the
+ * repo has NOT configured its own `skillsRepos` — the zero-config majority — and
+ * empty once a repo takes control by setting `skillsRepos` (then everything it
+ * lists auto-loads, unchanged).
+ *
+ * `loadConfig` cannot answer this: the schema's `.default(DEFAULT_SKILLS_REPOS)`
+ * materializes the key, so a parsed config can't tell "the user chose these" from
+ * "the user said nothing". So we probe the raw file for the key's presence — the
+ * same reason `ownWorktreeRetention` below reads the raw JSON.
+ */
+export async function gatedSkillsRepos(repoRoot) {
+    const none = new Set();
+    let raw;
+    try {
+        raw = await readFile(join(repoRoot, '.ai/cezar', 'config.json'), 'utf8');
+    }
+    catch {
+        // No file — the defaults are in effect, so they are the opt-in set.
+        return new Set(DEFAULT_SKILLS_REPOS.map((r) => r.repo));
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object') {
+            return new Set(DEFAULT_SKILLS_REPOS.map((r) => r.repo));
+        }
+        // The user took control of the source list — nothing is gated; a value the
+        // schema would refuse degrades to the default too (same as `loadConfig`).
+        if (parsed.skillsRepos !== undefined)
+            return none;
+        return new Set(DEFAULT_SKILLS_REPOS.map((r) => r.repo));
+    }
+    catch {
+        // Malformed JSON degrades to the default (which loadConfig also does).
+        return new Set(DEFAULT_SKILLS_REPOS.map((r) => r.repo));
+    }
+}
+/**
+ * Effective worktree retention for a repo (#483 + spec
+ * 2026-07-20-multi-project-workspace). Precedence, exactly what Settings →
+ * Worktrees promises: the repo's own `worktreeRetention` wins whenever it sets
+ * one; otherwise the workspace's `resources.worktreeRetentionDefault` seeds it;
+ * an absent/unreadable workspace config keeps the historical 10. Every
+ * enforcement site (boot sweeps, terminal transitions, the reclaim route) must
+ * go through here so the setting can never be a lie.
+ */
+export async function resolveWorktreeRetention(repoRoot) {
+    const own = await ownWorktreeRetention(repoRoot);
+    if (own !== undefined)
+        return own;
+    const workspace = await loadWorkspaceConfig().catch(() => null);
+    return workspace?.resources.worktreeRetentionDefault ?? DEFAULT_WORKTREE_RETENTION;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/contract/agent-config.d.ts

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+/**
+ * The agent-config surface (spec #404): the settings / memory / MCP files the installed agent
+ * CLIs read, listed and edited through `GET/PUT /agent-config[/:id]`.
+ */
+export declare const agentConfigFormatSchema: z.ZodEnum<{
+    json: "json";
+    jsonc: "jsonc";
+    markdown: "markdown";
+    toml: "toml";
+}>;
+export type AgentConfigFormat = z.infer<typeof agentConfigFormatSchema>;
+export declare const agentConfigScopeSchema: z.ZodEnum<{
+    local: "local";
+    project: "project";
+    user: "user";
+}>;
+export type AgentConfigScope = z.infer<typeof agentConfigScopeSchema>;
+/** `settings` = behavior knobs; `memory` = instruction/markdown; `mcp` = a dedicated MCP file. */
+export declare const agentConfigKindSchema: z.ZodEnum<{
+    mcp: "mcp";
+    memory: "memory";
+    settings: "settings";
+}>;
+export type AgentConfigKind = z.infer<typeof agentConfigKindSchema>;
+/** Git status BY CONVENTION — it drives the honest label; it is not read from git. */
+export declare const agentConfigTrackedSchema: z.ZodEnum<{
+    gitignored: "gitignored";
+    "outside-repo": "outside-repo";
+    tracked: "tracked";
+}>;
+export type AgentConfigTracked = z.infer<typeof agentConfigTrackedSchema>;
+/** One catalog file plus its current on-disk state. */
+export declare const agentConfigFileSchema: z.ZodObject<{
+    id: z.ZodString;
+    runners: z.ZodArray<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+        pi: "pi";
+    }>>;
+    kind: z.ZodEnum<{
+        mcp: "mcp";
+        memory: "memory";
+        settings: "settings";
+    }>;
+    scope: z.ZodEnum<{
+        local: "local";
+        project: "project";
+        user: "user";
+    }>;
+    label: z.ZodString;
+    path: z.ZodString;
+    format: z.ZodEnum<{
+        json: "json";
+        jsonc: "jsonc";
+        markdown: "markdown";
+        toml: "toml";
+    }>;
+    tracked: z.ZodEnum<{
+        gitignored: "gitignored";
+        "outside-repo": "outside-repo";
+        tracked: "tracked";
+    }>;
+    seeded: z.ZodBoolean;
+    holdsMcp: z.ZodBoolean;
+    precedence: z.ZodString;
+    hotReload: z.ZodOptional<z.ZodString>;
+    docsUrl: z.ZodString;
+    exists: z.ZodBoolean;
+    size: z.ZodNumber;
+    version: z.ZodNullable<z.ZodString>;
+    writable: z.ZodBoolean;
+    readOnlyReason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AgentConfigFile = z.infer<typeof agentConfigFileSchema>;
+/** Read-only listing of the MCP servers Claude keeps in `~/.claude.json`. */
+export declare const userMcpListingSchema: z.ZodObject<{
+    path: z.ZodString;
+    servers: z.ZodArray<z.ZodString>;
+    readable: z.ZodBoolean;
+}, z.core.$strip>;
+export type UserMcpListing = z.infer<typeof userMcpListingSchema>;
+/** `GET /agent-config` — the whole panel in one read. */
+export declare const agentConfigListingSchema: z.ZodObject<{
+    editable: z.ZodBoolean;
+    files: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        runners: z.ZodArray<z.ZodEnum<{
+            claude: "claude";
+            codex: "codex";
+            opencode: "opencode";
+            pi: "pi";
+        }>>;
+        kind: z.ZodEnum<{
+            mcp: "mcp";
+            memory: "memory";
+            settings: "settings";
+        }>;
+        scope: z.ZodEnum<{
+            local: "local";
+            project: "project";
+            user: "user";
+        }>;
+        label: z.ZodString;
+        path: z.ZodString;
+        format: z.ZodEnum<{
+            json: "json";
+            jsonc: "jsonc";
+            markdown: "markdown";
+            toml: "toml";
+        }>;
+        tracked: z.ZodEnum<{
+            gitignored: "gitignored";
+            "outside-repo": "outside-repo";
+            tracked: "tracked";
+        }>;
+        seeded: z.ZodBoolean;
+        holdsMcp: z.ZodBoolean;
+        precedence: z.ZodString;
+        hotReload: z.ZodOptional<z.ZodString>;
+        docsUrl: z.ZodString;
+        exists: z.ZodBoolean;
+        size: z.ZodNumber;
+        version: z.ZodNullable<z.ZodString>;
+        writable: z.ZodBoolean;
+        readOnlyReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    userMcp: z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        servers: z.ZodArray<z.ZodString>;
+        readable: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentConfigListing = z.infer<typeof agentConfigListingSchema>;
+/** `GET /agent-config/:id` and the `PUT` echo — one file's bytes plus its stale-write token. */
+export declare const agentConfigFileContentSchema: z.ZodObject<{
+    id: z.ZodString;
+    path: z.ZodString;
+    exists: z.ZodBoolean;
+    content: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AgentConfigFileContent = z.infer<typeof agentConfigFileContentSchema>;
+/**
+ * `PUT /agent-config/:id` body. `version` is the token from the read that produced `content` —
+ * `null` means "I expect no file to exist yet" (the create path); a mismatch is a 409.
+ */
+export declare const setAgentConfigInputSchema: z.ZodObject<{
+    content: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SetAgentConfigInput = z.infer<typeof setAgentConfigInputSchema>;