@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/agent-config/account-identity.js

@@ -0,0 +1,132 @@
+import { productName } from '../home/display.js';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { claudeStateFilePath } from '../paths.js';
+/** `.claude.json` can carry per-project history; cap the read like `readUserMcpServers` does. */
+const READ_CAP = 2 * 1024 * 1024;
+const NOT_SIGNED_IN = 'Not signed in on this account yet — use Connect.';
+const UNREADABLE = 'Could not read this account’s details.';
+/** Read a JSON file under the cap. `null` for absent, unreadable, oversized or malformed. */
+async function readJsonCapped(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        if (raw.length > READ_CAP)
+            return null;
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** A non-empty display string, or undefined — so a blank vendor value never renders as an empty row. */
+function text(value) {
+    if (typeof value === 'string' && value.trim() !== '')
+        return value.trim();
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return undefined;
+}
+/** Push a row only when the value is really there. */
+function push(fields, label, value) {
+    const shown = text(value);
+    if (shown !== undefined)
+        fields.push({ label, value: shown });
+}
+/**
+ * Claude Code keeps its login in `.claude.json`'s `oauthAccount` — a *sibling* of `~/.claude` by
+ * default, but INSIDE an overridden config dir (`claudeStateFilePath` owns that rule, and getting
+ * it wrong is how one account reports another's email).
+ */
+async function readClaudeIdentity(configDir) {
+    const state = await readJsonCapped(claudeStateFilePath(configDir));
+    if (state === null)
+        return { available: false, reason: NOT_SIGNED_IN, fields: [] };
+    const account = state.oauthAccount;
+    if (!account || typeof account !== 'object') {
+        return { available: false, reason: NOT_SIGNED_IN, fields: [] };
+    }
+    const a = account;
+    const fields = [];
+    push(fields, 'Email', a.emailAddress);
+    push(fields, 'Name', a.displayName);
+    push(fields, 'Organization', a.organizationName);
+    push(fields, 'Role', a.organizationRole);
+    // `seatTier`/`billingType` are the closest thing to a plan the file states; neither is
+    // documented, so they are shown under a label that promises no more than they are.
+    push(fields, 'Seat', a.seatTier);
+    push(fields, 'Billing', a.billingType);
+    return fields.length > 0
+        ? { available: true, fields }
+        : { available: false, reason: UNREADABLE, fields: [] };
+}
+/**
+ * Codex keeps its login in `auth.json`'s `id_token` — a JWT whose payload carries the identity
+ * claims. Read for its claims only: the same file holds `OPENAI_API_KEY`, `access_token` and
+ * `refresh_token`, none of which this function so much as names.
+ *
+ * The signature is NOT verified, and that is correct here: this is a local file the user's own CLI
+ * wrote, read to display who they are — not a token cezar is accepting as proof of anything.
+ */
+async function readCodexIdentity(configDir) {
+    const auth = await readJsonCapped(join(configDir, 'auth.json'));
+    if (auth === null)
+        return { available: false, reason: NOT_SIGNED_IN, fields: [] };
+    const tokens = auth.tokens;
+    const idToken = tokens && typeof tokens === 'object'
+        ? tokens.id_token
+        : undefined;
+    const fields = [];
+    const claims = typeof idToken === 'string' ? decodeJwtClaims(idToken) : null;
+    if (claims !== null) {
+        push(fields, 'Email', claims.email);
+        push(fields, 'Name', claims.name);
+        const openai = claims['https://api.openai.com/auth'];
+        if (openai && typeof openai === 'object') {
+            push(fields, 'Plan', openai.chatgpt_plan_type);
+        }
+    }
+    // An API-key login has no id_token at all — say which kind of login this is rather than
+    // reporting "not signed in" for an account that is perfectly usable.
+    if (fields.length === 0 && typeof auth.OPENAI_API_KEY === 'string' && auth.OPENAI_API_KEY !== '') {
+        return { available: true, fields: [{ label: 'Login', value: 'API key' }] };
+    }
+    return fields.length > 0
+        ? { available: true, fields }
+        : { available: false, reason: NOT_SIGNED_IN, fields: [] };
+}
+/** A JWT's payload claims, or null when it is not a readable three-part token. */
+function decodeJwtClaims(token) {
+    const parts = token.split('.');
+    if (parts.length !== 3 || !parts[1])
+        return null;
+    try {
+        const parsed = JSON.parse(Buffer.from(parts[1], 'base64url').toString('utf8'));
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * What this account is logged in as, or an honest reason there is nothing to show.
+ *
+ * Never throws. OpenCode answers "unsupported": its credentials live in a SQLite DB outside the
+ * config dir (see `core/agent-profiles.ts`), so there is nothing in a config folder to read — and
+ * guessing from the default login would attribute one account's identity to another.
+ */
+export async function readAccountIdentity(provider, configDir) {
+    if (provider === 'claude')
+        return readClaudeIdentity(configDir);
+    if (provider === 'codex')
+        return readCodexIdentity(configDir);
+    return { available: false, reason: UNREADABLE_IDENTITY[provider], fields: [] };
+}
+/** Why "Show details" has nothing for the agents whose identity is not read here. */
+const UNREADABLE_IDENTITY = {
+    opencode: `OpenCode keeps its login outside its config folder, so ${productName('cezar')} cannot read it.`,
+    pi: `${productName('cezar')} does not read which login a pi account is signed in as.`,
+    omp: `${productName('cezar')} does not read which login an omp account is signed in as.`,
+    cursor: `${productName('cezar')} does not read which login a Cursor account is signed in as.`,
+};
+//# sourceMappingURL=account-identity.js.map

package/dist/agent-config/account-identity.js.map

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

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

@@ -0,0 +1,70 @@
+import type { RunnerId } from '../core/agent-runner.ts';
+/**
+ * Maintained catalog of native config-file paths, formats, precedence descriptions and
+ * documentation URLs. Unknown files are not guessed. Account relocation and identity readers own
+ * their separate native-file knowledge.
+ */
+export type ConfigFormat = 'json' | 'jsonc' | 'toml' | 'yaml' | 'markdown';
+export type ConfigScope = 'user' | 'project' | 'local';
+/** `settings` = behavior knobs; `memory` = instruction/markdown; `mcp` = a dedicated MCP file. */
+export type ConfigKind = 'settings' | 'memory' | 'mcp';
+/**
+ * Git status *by convention* — it drives the honest label, it is not read from
+ * git. The seed path re-checks with `git check-ignore` before trusting it.
+ */
+export type ConfigTracked = 'tracked' | 'gitignored' | 'outside-repo';
+/** Resolved home directories per agent, injected so the catalog stays pure and testable. */
+export interface AgentHomePaths {
+    /** `~/.claude` */
+    claude: string;
+    /** `$CODEX_HOME` or `~/.codex` */
+    codex: string;
+    /** `$XDG_CONFIG_HOME/opencode` or `~/.config/opencode` */
+    opencodeConfig: string;
+    /** `$PI_CODING_AGENT_DIR` or `~/.pi/agent` */
+    pi: string;
+    /** Cursor CLI configuration directory; not an account home. */
+    cursor: string;
+    /** `$PI_CODING_AGENT_DIR` or `~/${PI_CONFIG_DIR || '.omp'}/agent` — OMP's default profile. */
+    omp: string;
+}
+export interface ConfigFileDef {
+    /** Stable, opaque, URL-safe. The ONLY thing a client may name (traversal-proof). */
+    id: string;
+    /** Every runner that reads this file. `<repo>/AGENTS.md` is one file, two readers. */
+    runners: RunnerId[];
+    kind: ConfigKind;
+    scope: ConfigScope;
+    /** Absolute path, resolved per request so `$CODEX_HOME`/`$XDG_CONFIG_HOME` are honoured. */
+    resolve: (repoRoot: string, home: AgentHomePaths) => string;
+    /** What the user sees, e.g. `~/.claude/settings.json`, `.claude/settings.local.json`. */
+    label: string;
+    format: ConfigFormat;
+    tracked: ConfigTracked;
+    /** True only for Claude's gitignored personal layer — the files seeded into a run's worktree. */
+    seeded?: boolean;
+    /** True when this file holds MCP server definitions (drives the MCP section's filter). */
+    holdsMcp?: boolean;
+    /** Top-level native setting that supplies the agent's new-session model, when present. */
+    modelKey?: string;
+    /** Native model keys checked in precedence order, including nested `env.*` settings. */
+    modelKeys?: readonly string[];
+    /** Native provider key paired with the model, when the vendor separates the two. */
+    modelProviderKey?: string;
+    /** Higher values win when resolving a native default model across config scopes. */
+    modelPriority?: number;
+    /** VERBATIM from the vendor docs. Never computed, never generic. */
+    precedence: string;
+    /** Documented mid-run reload behaviour, or undefined when the vendor is silent. */
+    hotReload?: string;
+    docsUrl: string;
+}
+/**
+ * The table. Order is presentation order: per runner, then user → project →
+ * local so each scope ladder reads top (broad) to bottom (specific).
+ */
+export declare const CONFIG_FILES: ConfigFileDef[];
+/** The whole catalog. */
+export declare function listConfigFiles(): ConfigFileDef[];
+/** Look up one entry by its stable id, or undefined when the id is unknown. */
+export declare function findConfigFile(id: string): ConfigFileDef | undefined;

package/dist/agent-config/catalog.js

@@ -0,0 +1,384 @@
+import { productName } from '../home/display.js';
+import { join } from 'node:path';
+const CLAUDE_SETTINGS_DOCS = 'https://code.claude.com/docs/en/settings';
+const CLAUDE_MEMORY_DOCS = 'https://code.claude.com/docs/en/memory';
+const CLAUDE_MCP_DOCS = 'https://code.claude.com/docs/en/mcp';
+const CODEX_CONFIG_DOCS = 'https://developers.openai.com/codex/config-reference';
+const CODEX_AGENTS_DOCS = 'https://developers.openai.com/codex/guides/agents-md';
+const OPENCODE_CONFIG_DOCS = 'https://opencode.ai/docs/config/';
+const OPENCODE_RULES_DOCS = 'https://opencode.ai/docs/rules/';
+const PI_SETTINGS_DOCS = 'https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/settings.md';
+const PI_CONTEXT_FILES_DOCS = 'https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/README.md#context-files';
+const OMP_CONFIG_DOCS = 'https://github.com/can1357/oh-my-pi/blob/main/docs/config-usage.md';
+const OMP_MCP_DOCS = 'https://github.com/can1357/oh-my-pi/blob/main/docs/mcp-config.md';
+/**
+ * The table. Order is presentation order: per runner, then user → project →
+ * local so each scope ladder reads top (broad) to bottom (specific).
+ */
+export const CONFIG_FILES = [
+    // ---- Claude Code ----
+    {
+        id: 'claude.user.settings',
+        runners: ['claude'],
+        kind: 'settings',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.claude, 'settings.json'),
+        label: '~/.claude/settings.json',
+        format: 'json',
+        tracked: 'outside-repo',
+        modelKey: 'model',
+        modelKeys: ['env.ANTHROPIC_MODEL', 'model'],
+        modelPriority: 1,
+        precedence: 'Lowest priority. Project and local settings override it key by key — except permission rules, which merge across all scopes.',
+        hotReload: 'Edits to most keys — including permissions and hooks — apply to a running session without a restart.',
+        docsUrl: CLAUDE_SETTINGS_DOCS,
+    },
+    {
+        id: 'claude.project.settings',
+        runners: ['claude'],
+        kind: 'settings',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.claude', 'settings.json'),
+        label: '.claude/settings.json',
+        format: 'json',
+        tracked: 'tracked',
+        modelKey: 'model',
+        modelKeys: ['env.ANTHROPIC_MODEL', 'model'],
+        modelPriority: 2,
+        precedence: 'Overrides user settings key by key (permission rules merge). Local settings override this.',
+        hotReload: 'Edits to most keys — including permissions and hooks — apply to a running session without a restart.',
+        docsUrl: CLAUDE_SETTINGS_DOCS,
+    },
+    {
+        id: 'claude.local.settings',
+        runners: ['claude'],
+        kind: 'settings',
+        scope: 'local',
+        resolve: (repo) => join(repo, '.claude', 'settings.local.json'),
+        label: '.claude/settings.local.json',
+        format: 'json',
+        tracked: 'gitignored',
+        seeded: true,
+        modelKey: 'model',
+        modelKeys: ['env.ANTHROPIC_MODEL', 'model'],
+        modelPriority: 3,
+        precedence: 'Highest of the file scopes — overrides project and user (permission rules merge). Git-ignored; copied into each run’s worktree so it takes effect immediately.',
+        hotReload: 'Edits to most keys — including permissions and hooks — apply to a running session without a restart.',
+        docsUrl: CLAUDE_SETTINGS_DOCS,
+    },
+    {
+        id: 'claude.project.mcp',
+        runners: ['claude'],
+        kind: 'mcp',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.mcp.json'),
+        label: '.mcp.json',
+        format: 'json',
+        tracked: 'tracked',
+        holdsMcp: true,
+        precedence: `Project-scoped MCP servers (key: mcpServers), shared via version control. Each requires approval before use; user- and local-scoped servers live in ~/.claude.json, which ${productName('cezar')} does not edit.`,
+        docsUrl: CLAUDE_MCP_DOCS,
+    },
+    {
+        id: 'claude.user.memory',
+        runners: ['claude'],
+        kind: 'memory',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.claude, 'CLAUDE.md'),
+        label: '~/.claude/CLAUDE.md',
+        format: 'markdown',
+        tracked: 'outside-repo',
+        precedence: 'Not overridden — every CLAUDE.md that loads is concatenated, this user file first.',
+        docsUrl: CLAUDE_MEMORY_DOCS,
+    },
+    {
+        id: 'claude.project.memory',
+        runners: ['claude'],
+        kind: 'memory',
+        scope: 'project',
+        resolve: (repo) => join(repo, 'CLAUDE.md'),
+        label: 'CLAUDE.md',
+        format: 'markdown',
+        tracked: 'tracked',
+        precedence: 'Concatenated after the user file, not replacing it. Claude does not read AGENTS.md — import it here with @AGENTS.md. Runs read the committed copy.',
+        docsUrl: CLAUDE_MEMORY_DOCS,
+    },
+    {
+        id: 'claude.local.memory',
+        runners: ['claude'],
+        kind: 'memory',
+        scope: 'local',
+        resolve: (repo) => join(repo, 'CLAUDE.local.md'),
+        label: 'CLAUDE.local.md',
+        format: 'markdown',
+        tracked: 'gitignored',
+        seeded: true,
+        precedence: 'Loads alongside CLAUDE.md, concatenated last. Git-ignored; copied into each run’s worktree so it takes effect immediately.',
+        docsUrl: CLAUDE_MEMORY_DOCS,
+    },
+    // ---- Codex ----
+    {
+        id: 'codex.user.config',
+        runners: ['codex'],
+        kind: 'settings',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.codex, 'config.toml'),
+        label: '~/.codex/config.toml',
+        format: 'toml',
+        tracked: 'outside-repo',
+        holdsMcp: true,
+        modelKey: 'model',
+        modelProviderKey: 'model_provider',
+        modelPriority: 1,
+        precedence: 'User-level defaults. A trusted project’s .codex/config.toml overrides these; some keys (provider, auth, telemetry) cannot be overridden at project scope. MCP servers live here under [mcp_servers.<id>].',
+        docsUrl: CODEX_CONFIG_DOCS,
+    },
+    {
+        id: 'codex.project.config',
+        runners: ['codex'],
+        kind: 'settings',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.codex', 'config.toml'),
+        label: '.codex/config.toml',
+        format: 'toml',
+        tracked: 'tracked',
+        modelKey: 'model',
+        modelPriority: 2,
+        holdsMcp: true,
+        precedence: 'Applies only in projects you have trusted. Some keys (provider, auth, telemetry) cannot be overridden here. MCP servers go under [mcp_servers.<id>]. Runs read the committed copy.',
+        docsUrl: CODEX_CONFIG_DOCS,
+    },
+    {
+        id: 'codex.user.memory',
+        runners: ['codex'],
+        kind: 'memory',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.codex, 'AGENTS.md'),
+        label: '~/.codex/AGENTS.md',
+        format: 'markdown',
+        tracked: 'outside-repo',
+        precedence: 'Global instructions, read first (an AGENTS.override.md beside it wins if present). Project AGENTS.md files are concatenated after and override it.',
+        docsUrl: CODEX_AGENTS_DOCS,
+    },
+    // ---- OpenCode ----
+    {
+        id: 'opencode.user.config',
+        runners: ['opencode'],
+        kind: 'settings',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.opencodeConfig, 'opencode.json'),
+        label: '~/.config/opencode/opencode.json',
+        format: 'jsonc',
+        tracked: 'outside-repo',
+        holdsMcp: true,
+        modelKey: 'model',
+        modelPriority: 1,
+        precedence: 'Global config. Merged with the project config, not replaced — later configs override earlier ones only for conflicting keys. MCP servers live under the "mcp" key.',
+        docsUrl: OPENCODE_CONFIG_DOCS,
+    },
+    {
+        id: 'opencode.project.config',
+        runners: ['opencode'],
+        kind: 'settings',
+        scope: 'project',
+        resolve: (repo) => join(repo, 'opencode.json'),
+        label: 'opencode.json',
+        format: 'jsonc',
+        tracked: 'tracked',
+        holdsMcp: true,
+        modelKey: 'model',
+        modelPriority: 2,
+        precedence: 'Merged over the global config per conflicting key (not a wholesale replace). MCP servers live under the "mcp" key. Runs read the committed copy.',
+        docsUrl: OPENCODE_CONFIG_DOCS,
+    },
+    {
+        id: 'opencode.user.memory',
+        runners: ['opencode'],
+        kind: 'memory',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.opencodeConfig, 'AGENTS.md'),
+        label: '~/.config/opencode/AGENTS.md',
+        format: 'markdown',
+        tracked: 'outside-repo',
+        precedence: 'Global rules. First match wins across scopes: if a project AGENTS.md exists, this global file is not read at all.',
+        docsUrl: OPENCODE_RULES_DOCS,
+    },
+    // ---- Pi ----
+    // Pi has no MCP file of its own: its README says "No MCP." — servers arrive only through a Pi
+    // extension, so nothing here carries `holdsMcp` and the cockpit's MCP group states that instead.
+    {
+        id: 'pi.user.settings',
+        runners: ['pi'],
+        kind: 'settings',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.pi, 'settings.json'),
+        label: '~/.pi/agent/settings.json',
+        format: 'json',
+        tracked: 'outside-repo',
+        modelKey: 'defaultModel',
+        modelProviderKey: 'defaultProvider',
+        modelPriority: 1,
+        precedence: 'Global (all projects). Project settings override global settings — the two merge recursively, so nested objects combine rather than replace. Startup model: defaultProvider + defaultModel.',
+        docsUrl: PI_SETTINGS_DOCS,
+    },
+    {
+        id: 'pi.project.settings',
+        runners: ['pi'],
+        kind: 'settings',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.pi', 'settings.json'),
+        label: '.pi/settings.json',
+        format: 'json',
+        tracked: 'tracked',
+        modelKey: 'defaultModel',
+        modelProviderKey: 'defaultProvider',
+        modelPriority: 2,
+        precedence: `Overrides global settings (merged recursively). Loaded only once the project folder is trusted; non-interactive modes such as --mode rpc fall back to defaultProjectTrust in the global settings and ignore it under "ask" or "never" — ${productName('cezar')} reads a native default model from it only when that value is "always". Runs read the committed copy.`,
+        docsUrl: PI_SETTINGS_DOCS,
+    },
+    {
+        id: 'pi.user.memory',
+        runners: ['pi'],
+        kind: 'memory',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.pi, 'AGENTS.md'),
+        label: '~/.pi/agent/AGENTS.md',
+        format: 'markdown',
+        tracked: 'outside-repo',
+        precedence: 'Global context file, loaded first. Every AGENTS.md (or CLAUDE.md) from the parent directories down to the current one is concatenated after it; an AGENTS.override.md replaces that directory’s file only.',
+        docsUrl: PI_CONTEXT_FILES_DOCS,
+    },
+    // ---- OMP: verified 2026-10-02 against v18.4.11 ----
+    // Oh My Pi (`can1357/oh-my-pi`, docs at main @ 7318a70cf4ed). The user layer lives in
+    // `AgentHomePaths.omp` (`$PI_CODING_AGENT_DIR` or `~/${PI_CONFIG_DIR || '.omp'}/agent`, the default
+    // profile; a named profile relocates it and is not modelled). Project files always live in
+    // `<repo>/.omp/`. Settings are YAML (`config.yml`); no `modelKey`, because OMP has no native-default
+    // strategy cezar reads (spec § Model selection). Precedence strings quote the docs in doc order;
+    // a numbered doc list is joined with "; ", its wording untouched. Not listed, by the spec's
+    // scope: `.omp/AGENTS.md` (OMP's native project context file; project memory is the shared root
+    // `AGENTS.md` row) and the `.omp/.mcp.json` / user `.mcp.json` compatibility spellings.
+    {
+        id: 'omp.user.settings',
+        runners: ['omp'],
+        kind: 'settings',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.omp, 'config.yml'),
+        label: '~/.omp/agent/config.yml',
+        format: 'yaml',
+        tracked: 'outside-repo',
+        precedence: 
+        // config-usage.md § Layers, the six-tier list.
+        'Effective precedence, highest first: 1. Environment variable declared on the definition (`env: "NAME"`), parsed by the setting\'s type; unparseable text counts as unset. Booleans follow `parseFlag`: empty is unset, `1`/`y`/`true`/`yes`/`on` (lower or upper case) is true, any other text is false; 2. Runtime overrides: in-memory, non-persistent; 3. Config overlays: `PI_CONFIG_FILES` (platform path-list), followed by repeated `omp --config <path>` files; all are loaded as `config.yml`-style YAML for this process only; 4. Project settings: discovered via the settings capability (`settings.json` and `config.yml` from providers); 5. Global settings: the first present file among `~/.omp/agent/config.yml` and `config.yaml`; 6. Definition default',
+        docsUrl: OMP_CONFIG_DOCS,
+    },
+    {
+        id: 'omp.project.settings',
+        runners: ['omp'],
+        kind: 'settings',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.omp', 'config.yml'),
+        label: '.omp/config.yml',
+        format: 'yaml',
+        tracked: 'tracked',
+        precedence: 'Project settings: discovered via the settings capability (`settings.json` and `config.yml` from providers). Within the native provider, project `config.yml` follows and overrides `settings.json`. Runs read the committed copy.',
+        docsUrl: OMP_CONFIG_DOCS,
+    },
+    {
+        id: 'omp.user.mcp',
+        runners: ['omp'],
+        kind: 'mcp',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.omp, 'mcp.json'),
+        label: '~/.omp/agent/mcp.json',
+        format: 'json',
+        tracked: 'outside-repo',
+        holdsMcp: true,
+        precedence: 'Across providers, the first definition wins. Duplicate names are not merged; OpenCode\'s internal config layers are the exception described above. Within OMP native config, project `.omp/mcp.json` precedes `.omp/.mcp.json`, then the active profile\'s user `mcp.json` and `.mcp.json`.',
+        docsUrl: OMP_MCP_DOCS,
+    },
+    {
+        id: 'omp.project.mcp',
+        runners: ['omp'],
+        kind: 'mcp',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.omp', 'mcp.json'),
+        label: '.omp/mcp.json',
+        format: 'json',
+        tracked: 'tracked',
+        holdsMcp: true,
+        precedence: 'Across providers, the first definition wins. Duplicate names are not merged; OpenCode\'s internal config layers are the exception described above. Within OMP native config, project `.omp/mcp.json` precedes `.omp/.mcp.json`, then the active profile\'s user `mcp.json` and `.mcp.json`. Runs read the committed copy.',
+        docsUrl: OMP_MCP_DOCS,
+    },
+    {
+        id: 'omp.user.memory',
+        runners: ['omp'],
+        kind: 'memory',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.omp, 'AGENTS.md'),
+        label: '~/.omp/agent/AGENTS.md',
+        format: 'markdown',
+        tracked: 'outside-repo',
+        precedence: '`SYSTEM.md`, `SYSTEM_TEMPLATE.md`, `RULES.md`, and `.omp/AGENTS.md` read user-level files directly and use the nearest non-empty ancestor `.omp` directory for project files. Context files: `.omp/AGENTS.md`; standalone ancestor `AGENTS.md` files are loaded separately by the low-priority `agents-md` provider',
+        docsUrl: OMP_CONFIG_DOCS,
+    },
+    // ---- Cursor — verified against vendor docs 2026-09-16 ----
+    {
+        id: 'cursor.user.settings',
+        runners: ['cursor'],
+        kind: 'settings',
+        scope: 'user',
+        resolve: (_repo, home) => join(home.cursor, 'cli-config.json'),
+        label: '~/.cursor/cli-config.json',
+        format: 'json',
+        tracked: 'outside-repo',
+        precedence: 'Global CLI settings. Only permissions can be configured at the project level.',
+        docsUrl: 'https://cursor.com/docs/cli/reference/configuration',
+    },
+    {
+        id: 'cursor.project.settings',
+        runners: ['cursor'],
+        kind: 'settings',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.cursor', 'cli.json'),
+        label: '.cursor/cli.json',
+        format: 'json',
+        tracked: 'tracked',
+        precedence: 'Project permissions only. All other CLI settings must be set globally.',
+        docsUrl: 'https://cursor.com/docs/cli/reference/configuration',
+    },
+    {
+        id: 'cursor.project.mcp',
+        runners: ['cursor'],
+        kind: 'mcp',
+        scope: 'project',
+        resolve: (repo) => join(repo, '.cursor', 'mcp.json'),
+        label: '.cursor/mcp.json',
+        format: 'json',
+        tracked: 'tracked',
+        holdsMcp: true,
+        precedence: 'MCP in the CLI uses the same configuration as the editor.',
+        docsUrl: 'https://cursor.com/docs/cli/mcp',
+    },
+    // ---- Shared: <repo>/AGENTS.md is read by Codex, OpenCode, Pi, Cursor AND OMP ----
+    {
+        id: 'project.agents',
+        runners: ['codex', 'opencode', 'pi', 'cursor', 'omp'],
+        kind: 'memory',
+        scope: 'project',
+        resolve: (repo) => join(repo, 'AGENTS.md'),
+        label: 'AGENTS.md',
+        format: 'markdown',
+        tracked: 'tracked',
+        precedence: 'Read by Codex, OpenCode, Pi, Cursor and OMP (Claude ignores it). Codex concatenates it root-down; OpenCode uses the first match and prefers it over CLAUDE.md; Pi concatenates every AGENTS.md (or CLAUDE.md) from the parent directories down, after its global file; OMP loads standalone ancestor AGENTS.md files through its low-priority `agents-md` provider. Runs read the committed copy.',
+        docsUrl: OPENCODE_RULES_DOCS,
+    },
+];
+/** The whole catalog. */
+export function listConfigFiles() {
+    return CONFIG_FILES;
+}
+/** Look up one entry by its stable id, or undefined when the id is unknown. */
+export function findConfigFile(id) {
+    return CONFIG_FILES.find((f) => f.id === id);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/agent-config/catalog.js.map

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

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

@@ -0,0 +1,42 @@
+import { type ConfigFileDef } from './catalog.ts';
+/**
+ * Read and write native config by catalog id. Validate syntax and content version; write exact
+ * bytes atomically through symlinks. Missing files are absent; other failures return errors.
+ */
+/** sha256 of the exact file bytes. mtime is coarse and lies across filesystems. */
+declare function hashBytes(content: string): string;
+export interface ReadResult {
+    id: string;
+    path: string;
+    exists: boolean;
+    content: string;
+    /** sha256 of the bytes, or null when the file does not exist. */
+    version: string | null;
+}
+export type WriteOutcome = {
+    ok: true;
+    read: ReadResult;
+} | {
+    ok: false;
+    status: 400 | 409 | 500;
+    error: string;
+};
+declare function resolvePath(def: ConfigFileDef, repoRoot: string, env: NodeJS.ProcessEnv): string;
+/** Read a config file by id. Unknown id → null; absent file → exists:false; unreadable → thrown-free error string via `error`. */
+export declare function readConfigFile(id: string, repoRoot: string, env?: NodeJS.ProcessEnv): Promise<ReadResult | {
+    error: string;
+} | null>;
+/**
+ * Write a config file by id. Validates the content against the file's format,
+ * refuses when `version` does not match what is on disk (stale / lost-update),
+ * creates the parent dir on demand, and writes atomically through any symlink
+ * rather than replacing the link. `version: null` means "I expect no file to
+ * exist yet" — the create path.
+ */
+export declare function writeConfigFile(id: string, content: string, version: string | null, repoRoot: string, env?: NodeJS.ProcessEnv): Promise<WriteOutcome | null>;
+/** Whether a path currently exists (used by the listing to report `exists`/`size`). */
+export declare function statConfigPath(path: string): Promise<{
+    exists: boolean;
+    size: number;
+}>;
+export { resolvePath, hashBytes };