@telora/daemon 0.19.43 → 0.19.74

package/dist/cli/connect/cline.js

@@ -0,0 +1,115 @@
+/**
+ * Cline harness config writers: the project-level Cline rules file and the
+ * Telora MCP registration in the Cline CLI settings. Extracted verbatim from
+ * `../connect.ts` and re-exported from there for import stability.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { resolveMcpServerPath } from '../../mcp-resolution.js';
+import { SEED_BODY, SEED_MCP_REGISTRATION_SENTENCE } from '../../templates/claude-md.js';
+const CLINE_MCP_REGISTRATION_SENTENCE = 'The Telora MCP server is registered in `~/.cline/data/settings/cline_mcp_settings.json`.';
+/**
+ * Render a project-level Cline rules file carrying the same Telora seed
+ * discipline as CLAUDE.md / AGENTS.md. Cline CLI reads project rules from
+ * `.cline/rules/`, so this is the operator-facing context equivalent for the
+ * Cline harness.
+ */
+export function renderClineRules(inv) {
+    const productLabel = inv.productName ? `${inv.productName} (${inv.productId})` : inv.productId;
+    const body = SEED_BODY.replace(SEED_MCP_REGISTRATION_SENTENCE, CLINE_MCP_REGISTRATION_SENTENCE);
+    return (`# Telora Workstation\n\n` +
+        `This workstation is connected to Telora. The connection invariant is recorded here for Cline CLI sessions:\n\n` +
+        `- Telora URL: ${inv.teloraUrl}\n` +
+        `- Organization: ${inv.organizationId}\n` +
+        `- Product: ${productLabel}\n\n` +
+        body);
+}
+/**
+ * Write the Telora Cline project rules file. The file is owned by the connect
+ * flow, so re-runs replace it wholesale; user-authored Cline rules live beside
+ * it under `.cline/rules/`.
+ */
+export function writeClineProjectRules(repoPath, inv, io) {
+    const dir = resolve(repoPath, '.cline', 'rules');
+    const path = resolve(dir, 'telora.md');
+    const content = renderClineRules(inv);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    if (existsSync(path) && readFileSync(path, 'utf-8') === content)
+        return;
+    writeFileSync(path, content);
+    io.out(`Wrote ${path}.\n`);
+}
+/**
+ * Render the Cline CLI MCP config object. Current Cline CLI documentation
+ * stores MCP settings under `~/.cline/data/settings/cline_mcp_settings.json`
+ * with a top-level `mcpServers` map.
+ *
+ * Carries the MCP profile ONLY -- never workstation identity. Like the
+ * `.mcp.json` and Codex builders, identity (`TELORA_URL` / `TELORA_TRACKER_ID`)
+ * resolves from the single source `~/.telora/daemon.json` via the MCP server's
+ * `loadCredentials()` fallback; a persisted copy here would only drift.
+ */
+export function renderClineMcpSettings(params) {
+    return {
+        mcpServers: {
+            telora: {
+                command: 'node',
+                args: [params.mcpServerPath],
+                env: {
+                    TELORA_MCP_PROFILE: 'human',
+                },
+                disabled: false,
+                autoApprove: [],
+            },
+        },
+    };
+}
+export function writeOrMergeClineMcpSettings(io, params = {}) {
+    let mcpServerPath;
+    try {
+        mcpServerPath = resolveMcpServerPath();
+    }
+    catch (err) {
+        io.err(`Warning: could not resolve @telora/mcp-products; skipping Cline MCP registration: ${err instanceof Error ? err.message : String(err)}\n`);
+        return;
+    }
+    const home = params.homeOverride ?? homedir();
+    const dir = resolve(home, '.cline', 'data', 'settings');
+    const path = resolve(dir, 'cline_mcp_settings.json');
+    const desired = renderClineMcpSettings({ mcpServerPath });
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    let parsed = {};
+    if (existsSync(path)) {
+        try {
+            const raw = readFileSync(path, 'utf-8');
+            const candidate = JSON.parse(raw);
+            if (candidate && typeof candidate === 'object' && !Array.isArray(candidate)) {
+                parsed = candidate;
+            }
+        }
+        catch (err) {
+            io.err(`Warning: ${path} is not valid JSON; leaving it alone: ${err instanceof Error ? err.message : String(err)}\n`);
+            return;
+        }
+    }
+    const existingServers = parsed.mcpServers && typeof parsed.mcpServers === 'object' && !Array.isArray(parsed.mcpServers)
+        ? parsed.mcpServers
+        : {};
+    const desiredServers = desired.mcpServers;
+    const next = {
+        ...parsed,
+        mcpServers: {
+            ...existingServers,
+            telora: desiredServers.telora,
+        },
+    };
+    const content = JSON.stringify(next, null, 2) + '\n';
+    if (existsSync(path) && readFileSync(path, 'utf-8') === content)
+        return;
+    writeFileSync(path, content, { mode: 0o600 });
+    io.out(`Registered Telora MCP server in ${path}.\n`);
+}
+//# sourceMappingURL=cline.js.map

package/dist/cli/connect/cline.js.map

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

package/dist/cli/connect/codex.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Codex harness config writer: registration of the Telora MCP server in the
+ * operator's personal `~/.codex/config.toml`. Extracted verbatim from
+ * `../connect.ts` and re-exported from there for import stability.
+ */
+import type { ConnectIO } from './shared.js';
+/**
+ * Render the delimited Telora MCP block for the operator's personal
+ * `~/.codex/config.toml`. Mirrors the `.mcp.json` shape (command=node + the
+ * resolved abs path to @telora/mcp-products) but as a TOML `[mcp_servers.telora]`
+ * table, the form Codex reads. Profile is `human` (operator-interactive),
+ * matching the `.mcp.json` the Claude path writes.
+ *
+ * Carries the MCP profile ONLY -- never workstation identity. Identity
+ * (`TELORA_URL` / `TELORA_TRACKER_ID`) resolves from the single source
+ * `~/.telora/daemon.json` via the MCP server's `loadCredentials()` fallback,
+ * so a persisted copy here would only be a drift hazard. Keeping it out is the
+ * single-source invariant (the `.mcp.json` builder omits it for the same
+ * reason).
+ *
+ * Values are emitted as JSON-encoded TOML string literals, which is valid TOML
+ * for the path value we control here.
+ */
+export declare function renderCodexMcpBlock(params: {
+    mcpServerPath: string;
+}): string;
+/**
+ * Register the Telora MCP server in the operator's personal
+ * `~/.codex/config.toml` (NOT the per-product execution CODEX_HOME -- that is
+ * `codex-provision.ts`, a separate concern). This is what makes the Telora
+ * tool surface reachable from the operator's interactive Codex chat.
+ *
+ * Idempotent delimited merge, mirroring `writeOrMergeClaudeMd`: replace the
+ * `# BEGIN/END TELORA MCP` block in place if present, append it if absent,
+ * never duplicate. When the computed content equals what is on disk, NO write
+ * occurs. `homeOverride` lets tests target a temp HOME.
+ *
+ * Best-effort: if the MCP package cannot be resolved, prints a warning and
+ * returns without touching the file (the connect flow must not abort).
+ */
+export declare function writeOrMergeCodexMcpToml(io: ConnectIO, params?: {
+    homeOverride?: string;
+}): void;
+//# sourceMappingURL=codex.d.ts.map

package/dist/cli/connect/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/cli/connect/codex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAWT;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,SAAS,EACb,MAAM,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,IAAI,CA0DN"}

package/dist/cli/connect/codex.js

@@ -0,0 +1,111 @@
+/**
+ * Codex harness config writer: registration of the Telora MCP server in the
+ * operator's personal `~/.codex/config.toml`. Extracted verbatim from
+ * `../connect.ts` and re-exported from there for import stability.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { resolveMcpServerPath } from '../../mcp-resolution.js';
+// Delimiter comments wrapping the Telora MCP block in the operator's
+// ~/.codex/config.toml. TOML comments start with '#', so these are inert to
+// the parser yet let us replace exactly our block on re-runs.
+const TELORA_CODEX_MCP_BEGIN = '# BEGIN TELORA MCP';
+const TELORA_CODEX_MCP_END = '# END TELORA MCP';
+/**
+ * Render the delimited Telora MCP block for the operator's personal
+ * `~/.codex/config.toml`. Mirrors the `.mcp.json` shape (command=node + the
+ * resolved abs path to @telora/mcp-products) but as a TOML `[mcp_servers.telora]`
+ * table, the form Codex reads. Profile is `human` (operator-interactive),
+ * matching the `.mcp.json` the Claude path writes.
+ *
+ * Carries the MCP profile ONLY -- never workstation identity. Identity
+ * (`TELORA_URL` / `TELORA_TRACKER_ID`) resolves from the single source
+ * `~/.telora/daemon.json` via the MCP server's `loadCredentials()` fallback,
+ * so a persisted copy here would only be a drift hazard. Keeping it out is the
+ * single-source invariant (the `.mcp.json` builder omits it for the same
+ * reason).
+ *
+ * Values are emitted as JSON-encoded TOML string literals, which is valid TOML
+ * for the path value we control here.
+ */
+export function renderCodexMcpBlock(params) {
+    const lines = [
+        TELORA_CODEX_MCP_BEGIN,
+        `[mcp_servers.telora]`,
+        `command = "node"`,
+        `args = [${JSON.stringify(params.mcpServerPath)}]`,
+        `[mcp_servers.telora.env]`,
+        `TELORA_MCP_PROFILE = "human"`,
+        TELORA_CODEX_MCP_END,
+    ];
+    return lines.join('\n') + '\n';
+}
+/**
+ * Register the Telora MCP server in the operator's personal
+ * `~/.codex/config.toml` (NOT the per-product execution CODEX_HOME -- that is
+ * `codex-provision.ts`, a separate concern). This is what makes the Telora
+ * tool surface reachable from the operator's interactive Codex chat.
+ *
+ * Idempotent delimited merge, mirroring `writeOrMergeClaudeMd`: replace the
+ * `# BEGIN/END TELORA MCP` block in place if present, append it if absent,
+ * never duplicate. When the computed content equals what is on disk, NO write
+ * occurs. `homeOverride` lets tests target a temp HOME.
+ *
+ * Best-effort: if the MCP package cannot be resolved, prints a warning and
+ * returns without touching the file (the connect flow must not abort).
+ */
+export function writeOrMergeCodexMcpToml(io, params = {}) {
+    let mcpServerPath;
+    try {
+        mcpServerPath = resolveMcpServerPath();
+    }
+    catch (err) {
+        io.err(`Warning: could not resolve @telora/mcp-products; skipping Codex MCP registration: ${err instanceof Error ? err.message : String(err)}\n`);
+        return;
+    }
+    const home = params.homeOverride ?? homedir();
+    const dir = resolve(home, '.codex');
+    const path = resolve(dir, 'config.toml');
+    const block = renderCodexMcpBlock({ mcpServerPath });
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    if (!existsSync(path)) {
+        writeFileSync(path, block, { mode: 0o600 });
+        io.out(`Wrote ${path}.\n`);
+        return;
+    }
+    const existing = readFileSync(path, 'utf-8');
+    const beginIdx = existing.indexOf(TELORA_CODEX_MCP_BEGIN);
+    let newContent;
+    let message;
+    if (beginIdx === -1) {
+        const sep = existing.endsWith('\n') ? '\n' : '\n\n';
+        newContent = existing.trimEnd().length === 0 ? block : existing + sep + block;
+        message = `Registered Telora MCP server in ${path}.\n`;
+    }
+    else {
+        const endIdx = existing.indexOf(TELORA_CODEX_MCP_END, beginIdx);
+        if (endIdx === -1) {
+            const sep = existing.endsWith('\n') ? '\n' : '\n\n';
+            newContent = existing + sep + block;
+            message = `Registered Telora MCP server in ${path} (prior block was malformed).\n`;
+        }
+        else {
+            const after = endIdx + TELORA_CODEX_MCP_END.length;
+            const trailingNewline = existing[after] === '\n' ? 1 : 0;
+            newContent =
+                existing.slice(0, beginIdx) +
+                    block.trimEnd() +
+                    '\n' +
+                    existing.slice(after + trailingNewline);
+            message = `Refreshed Telora MCP server registration in ${path}.\n`;
+        }
+    }
+    // Idempotency guard: skip the write when nothing would change.
+    if (newContent === existing)
+        return;
+    writeFileSync(path, newContent, { mode: 0o600 });
+    io.out(message);
+}
+//# sourceMappingURL=codex.js.map

package/dist/cli/connect/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/cli/connect/codex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,qEAAqE;AACrE,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AACpD,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAEnC;IACC,MAAM,KAAK,GAAG;QACZ,sBAAsB;QACtB,sBAAsB;QACtB,kBAAkB;QAClB,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG;QAClD,0BAA0B;QAC1B,8BAA8B;QAC9B,oBAAoB;KACrB,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAAa,EACb,SAAoC,EAAE;IAEtC,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,oBAAoB,EAAE,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,GAAG,CACJ,qFACE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,IAAI,CACL,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC;IAErD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,EAAE,CAAC,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE1D,IAAI,UAAkB,CAAC;IACvB,IAAI,OAAe,CAAC;IACpB,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACpD,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC;QAC9E,OAAO,GAAG,mCAAmC,IAAI,KAAK,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;QAChE,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YACpD,UAAU,GAAG,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC;YACpC,OAAO,GAAG,mCAAmC,IAAI,iCAAiC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC;YACnD,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzD,UAAU;gBACR,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;oBAC3B,KAAK,CAAC,OAAO,EAAE;oBACf,IAAI;oBACJ,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,eAAe,CAAC,CAAC;YAC1C,OAAO,GAAG,+CAA+C,IAAI,KAAK,CAAC;QACrE,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO;IAEpC,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAClB,CAAC"}

package/dist/cli/connect/ide.d.ts

@@ -0,0 +1,69 @@
+/**
+ * IDE (cursor / vscode) harness config writers: the project MCP config and the
+ * combined AGENTS.md + MCP scaffolding. Extracted verbatim from `../connect.ts`
+ * and re-exported from there for import stability.
+ */
+import type { AgentsMdConnectionInvariant } from '../../templates/agents-md.js';
+import type { ConnectIO } from './shared.js';
+/**
+ * Default `TELORA_MCP_PRELOAD` for the IDE harnesses (cursor / vscode).
+ *
+ * Static-surface clients ignore `tools/list_changed`, so `telora_discover`
+ * lazy-loading never becomes callable mid-session -- they need the domains
+ * they will actually use registered at startup. This modest set (escalations,
+ * wiki, reality-tree planning) covers inspection + light-operator work while
+ * keeping the active tool surface under the ~40-tool ceiling those clients
+ * impose. Operators can widen it by editing the generated MCP config.
+ */
+export declare const DEFAULT_IDE_HARNESS_PRELOAD = "agent,wiki,reality_trees";
+/** IDE (cursor / vscode) harness kinds -- the subset that writes a project MCP config. */
+export type IdeHarness = 'cursor' | 'vscode';
+/**
+ * The MCP-registration sentence spliced into the AGENTS.md seed body for each
+ * IDE harness. Both Cursor and VS Code read AGENTS.md natively, but they load
+ * MCP from different project files, so the seeded discipline must name the
+ * right one. (`renderAgentsMd` defaults to the Codex `~/.codex/config.toml`
+ * location; these override it.)
+ */
+export declare const IDE_MCP_REGISTRATION_SENTENCE: Record<IdeHarness, string>;
+/** Project-relative path of the MCP config file for each IDE harness. */
+export declare const IDE_MCP_CONFIG_PATH: Record<IdeHarness, string>;
+/**
+ * Build the project-level MCP config object for an IDE harness.
+ *
+ * Cursor reads `.cursor/mcp.json` with a top-level `mcpServers` map (the same
+ * shape as `.mcp.json`). VS Code reads `.vscode/mcp.json` with a top-level
+ * `servers` map whose entries declare `type: "stdio"`.
+ *
+ * Both carry the MCP profile + domain-preload env ONLY -- never workstation
+ * identity. Identity (`TELORA_URL` / `TELORA_TRACKER_ID`) resolves from the
+ * single source `~/.telora/daemon.json` via the MCP server's
+ * `loadCredentials()` fallback, so a persisted copy here would only drift --
+ * the same single-source invariant the `.mcp.json` / Codex / Cline builders
+ * hold. The preload env is what makes these static-surface clients usable:
+ * it registers the named domains at startup rather than via `telora_discover`.
+ */
+export declare function renderIdeMcpConfig(kind: IdeHarness, params: {
+    mcpServerPath: string;
+    preload: string;
+}): Record<string, unknown>;
+/**
+ * Write the Telora project MCP config for an IDE harness (`.cursor/mcp.json`
+ * or `.vscode/mcp.json`).
+ *
+ * Idempotent JSON merge, mirroring `writeOrMergeClineMcpSettings`: preserve any
+ * user-authored server entries, replace only the `telora` key, and skip the
+ * write when nothing would change. Best-effort: if the MCP package cannot be
+ * resolved, prints a warning and returns without touching the file (the connect
+ * flow must not abort). `params.preload` defaults to `DEFAULT_IDE_HARNESS_PRELOAD`.
+ */
+export declare function writeIdeMcpConfig(repoPath: string, kind: IdeHarness, io: ConnectIO, params?: {
+    preload?: string;
+}): void;
+/**
+ * Write the full IDE-harness scaffolding (AGENTS.md seed + project MCP config)
+ * for `cursor` or `vscode`. Extracted so both `connect --harness <ide>` and the
+ * token-free `harness add <ide>` verb write byte-identical output.
+ */
+export declare function writeIdeHarnessScaffolding(repoPath: string, kind: IdeHarness, inv: AgentsMdConnectionInvariant, io: ConnectIO): void;
+//# sourceMappingURL=ide.d.ts.map

package/dist/cli/connect/ide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide.d.ts","sourceRoot":"","sources":["../../../src/cli/connect/ide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,6BAA6B,CAAC;AAEtE,0FAA0F;AAC1F,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAGpE,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAG1D,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,SAAS,EACb,MAAM,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,IAAI,CAsDN;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,2BAA2B,EAChC,EAAE,EAAE,SAAS,GACZ,IAAI,CAON"}

package/dist/cli/connect/ide.js

@@ -0,0 +1,134 @@
+/**
+ * IDE (cursor / vscode) harness config writers: the project MCP config and the
+ * combined AGENTS.md + MCP scaffolding. Extracted verbatim from `../connect.ts`
+ * and re-exported from there for import stability.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { resolveMcpServerPath } from '../../mcp-resolution.js';
+import { writeOrMergeAgentsMd } from './agents.js';
+/**
+ * Default `TELORA_MCP_PRELOAD` for the IDE harnesses (cursor / vscode).
+ *
+ * Static-surface clients ignore `tools/list_changed`, so `telora_discover`
+ * lazy-loading never becomes callable mid-session -- they need the domains
+ * they will actually use registered at startup. This modest set (escalations,
+ * wiki, reality-tree planning) covers inspection + light-operator work while
+ * keeping the active tool surface under the ~40-tool ceiling those clients
+ * impose. Operators can widen it by editing the generated MCP config.
+ */
+export const DEFAULT_IDE_HARNESS_PRELOAD = 'agent,wiki,reality_trees';
+/**
+ * The MCP-registration sentence spliced into the AGENTS.md seed body for each
+ * IDE harness. Both Cursor and VS Code read AGENTS.md natively, but they load
+ * MCP from different project files, so the seeded discipline must name the
+ * right one. (`renderAgentsMd` defaults to the Codex `~/.codex/config.toml`
+ * location; these override it.)
+ */
+export const IDE_MCP_REGISTRATION_SENTENCE = {
+    cursor: 'The Telora MCP server is registered in `.cursor/mcp.json`.',
+    vscode: 'The Telora MCP server is registered in `.vscode/mcp.json`.',
+};
+/** Project-relative path of the MCP config file for each IDE harness. */
+export const IDE_MCP_CONFIG_PATH = {
+    cursor: '.cursor/mcp.json',
+    vscode: '.vscode/mcp.json',
+};
+/**
+ * Build the project-level MCP config object for an IDE harness.
+ *
+ * Cursor reads `.cursor/mcp.json` with a top-level `mcpServers` map (the same
+ * shape as `.mcp.json`). VS Code reads `.vscode/mcp.json` with a top-level
+ * `servers` map whose entries declare `type: "stdio"`.
+ *
+ * Both carry the MCP profile + domain-preload env ONLY -- never workstation
+ * identity. Identity (`TELORA_URL` / `TELORA_TRACKER_ID`) resolves from the
+ * single source `~/.telora/daemon.json` via the MCP server's
+ * `loadCredentials()` fallback, so a persisted copy here would only drift --
+ * the same single-source invariant the `.mcp.json` / Codex / Cline builders
+ * hold. The preload env is what makes these static-surface clients usable:
+ * it registers the named domains at startup rather than via `telora_discover`.
+ */
+export function renderIdeMcpConfig(kind, params) {
+    const env = {
+        TELORA_MCP_PROFILE: 'human',
+        TELORA_MCP_PRELOAD: params.preload,
+    };
+    if (kind === 'cursor') {
+        return {
+            mcpServers: {
+                telora: { command: 'node', args: [params.mcpServerPath], env },
+            },
+        };
+    }
+    return {
+        servers: {
+            telora: { type: 'stdio', command: 'node', args: [params.mcpServerPath], env },
+        },
+    };
+}
+/**
+ * Write the Telora project MCP config for an IDE harness (`.cursor/mcp.json`
+ * or `.vscode/mcp.json`).
+ *
+ * Idempotent JSON merge, mirroring `writeOrMergeClineMcpSettings`: preserve any
+ * user-authored server entries, replace only the `telora` key, and skip the
+ * write when nothing would change. Best-effort: if the MCP package cannot be
+ * resolved, prints a warning and returns without touching the file (the connect
+ * flow must not abort). `params.preload` defaults to `DEFAULT_IDE_HARNESS_PRELOAD`.
+ */
+export function writeIdeMcpConfig(repoPath, kind, io, params = {}) {
+    let mcpServerPath;
+    try {
+        mcpServerPath = resolveMcpServerPath();
+    }
+    catch (err) {
+        io.err(`Warning: could not resolve @telora/mcp-products; skipping ${kind} MCP registration: ${err instanceof Error ? err.message : String(err)}\n`);
+        return;
+    }
+    const dir = resolve(repoPath, kind === 'cursor' ? '.cursor' : '.vscode');
+    const path = resolve(dir, 'mcp.json');
+    const mapKey = kind === 'cursor' ? 'mcpServers' : 'servers';
+    const desired = renderIdeMcpConfig(kind, {
+        mcpServerPath,
+        preload: params.preload ?? DEFAULT_IDE_HARNESS_PRELOAD,
+    });
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    let parsed = {};
+    if (existsSync(path)) {
+        try {
+            const candidate = JSON.parse(readFileSync(path, 'utf-8'));
+            if (candidate && typeof candidate === 'object' && !Array.isArray(candidate)) {
+                parsed = candidate;
+            }
+        }
+        catch (err) {
+            io.err(`Warning: ${path} is not valid JSON; leaving it alone: ${err instanceof Error ? err.message : String(err)}\n`);
+            return;
+        }
+    }
+    const existingServers = parsed[mapKey] && typeof parsed[mapKey] === 'object' && !Array.isArray(parsed[mapKey])
+        ? parsed[mapKey]
+        : {};
+    const desiredServers = desired[mapKey];
+    const next = {
+        ...parsed,
+        [mapKey]: { ...existingServers, telora: desiredServers.telora },
+    };
+    const content = JSON.stringify(next, null, 2) + '\n';
+    if (existsSync(path) && readFileSync(path, 'utf-8') === content)
+        return;
+    writeFileSync(path, content);
+    io.out(`Registered Telora MCP server in ${path}.\n`);
+}
+/**
+ * Write the full IDE-harness scaffolding (AGENTS.md seed + project MCP config)
+ * for `cursor` or `vscode`. Extracted so both `connect --harness <ide>` and the
+ * token-free `harness add <ide>` verb write byte-identical output.
+ */
+export function writeIdeHarnessScaffolding(repoPath, kind, inv, io) {
+    writeOrMergeAgentsMd(repoPath, { ...inv, mcpRegistrationSentence: IDE_MCP_REGISTRATION_SENTENCE[kind] }, io);
+    writeIdeMcpConfig(repoPath, kind, io);
+}
+//# sourceMappingURL=ide.js.map

package/dist/cli/connect/ide.js.map

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

package/dist/cli/connect/scaffolding.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-harness scaffolding dispatcher + the harness-specific `.gitignore`
+ * entries. This is the ONE place the per-harness writer set is dispatched.
+ * Extracted verbatim from `../connect.ts` and re-exported from there for import
+ * stability.
+ */
+import type { AgentsMdConnectionInvariant } from '../../templates/agents-md.js';
+import type { ConnectIO, OperatorHarness } from './shared.js';
+/**
+ * The `.gitignore` entries a harness's scaffolding requires beyond the always-
+ * added `.telora/` + `.mcp.json`. Only the IDE harnesses add a project MCP
+ * config (per-user-machine, absolute path -> not shared).
+ */
+export declare function harnessGitignoreEntries(harness: OperatorHarness): string[];
+/**
+ * Write the harness-specific agent scaffolding for the chosen operator harness.
+ * This is the ONE place the per-harness writer set is dispatched, so both
+ * `connect --harness <h>` and the token-free `harness add <h>` verb produce
+ * byte-identical output for a given identity.
+ *
+ *  - claude: CLAUDE.md + .claude/settings.json
+ *  - codex:  AGENTS.md + Telora MCP in ~/.codex/config.toml
+ *  - cline:  .cline/rules/telora.md + Telora MCP in ~/.cline settings
+ *  - cursor: AGENTS.md + .cursor/mcp.json (preload env)
+ *  - vscode: AGENTS.md + .vscode/mcp.json (preload env)
+ *
+ * Does NOT touch `.gitignore` -- callers pair this with
+ * `ensureGitignoreEntries(repoPath, io, harnessGitignoreEntries(harness))`.
+ */
+export declare function writeHarnessScaffolding(repoPath: string, harness: OperatorHarness, inv: AgentsMdConnectionInvariant, io: ConnectIO): void;
+//# sourceMappingURL=scaffolding.d.ts.map

package/dist/cli/connect/scaffolding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolding.d.ts","sourceRoot":"","sources":["../../../src/cli/connect/scaffolding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAE1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,2BAA2B,EAChC,EAAE,EAAE,SAAS,GACZ,IAAI,CAaN"}

package/dist/cli/connect/scaffolding.js

@@ -0,0 +1,52 @@
+/**
+ * Per-harness scaffolding dispatcher + the harness-specific `.gitignore`
+ * entries. This is the ONE place the per-harness writer set is dispatched.
+ * Extracted verbatim from `../connect.ts` and re-exported from there for import
+ * stability.
+ */
+import { writeOrMergeClaudeMd, writeOrMergeClaudeSettings } from './claude.js';
+import { writeOrMergeAgentsMd } from './agents.js';
+import { writeOrMergeCodexMcpToml } from './codex.js';
+import { writeClineProjectRules, writeOrMergeClineMcpSettings } from './cline.js';
+import { IDE_MCP_CONFIG_PATH, writeIdeHarnessScaffolding } from './ide.js';
+/**
+ * The `.gitignore` entries a harness's scaffolding requires beyond the always-
+ * added `.telora/` + `.mcp.json`. Only the IDE harnesses add a project MCP
+ * config (per-user-machine, absolute path -> not shared).
+ */
+export function harnessGitignoreEntries(harness) {
+    return harness === 'cursor' || harness === 'vscode' ? [IDE_MCP_CONFIG_PATH[harness]] : [];
+}
+/**
+ * Write the harness-specific agent scaffolding for the chosen operator harness.
+ * This is the ONE place the per-harness writer set is dispatched, so both
+ * `connect --harness <h>` and the token-free `harness add <h>` verb produce
+ * byte-identical output for a given identity.
+ *
+ *  - claude: CLAUDE.md + .claude/settings.json
+ *  - codex:  AGENTS.md + Telora MCP in ~/.codex/config.toml
+ *  - cline:  .cline/rules/telora.md + Telora MCP in ~/.cline settings
+ *  - cursor: AGENTS.md + .cursor/mcp.json (preload env)
+ *  - vscode: AGENTS.md + .vscode/mcp.json (preload env)
+ *
+ * Does NOT touch `.gitignore` -- callers pair this with
+ * `ensureGitignoreEntries(repoPath, io, harnessGitignoreEntries(harness))`.
+ */
+export function writeHarnessScaffolding(repoPath, harness, inv, io) {
+    if (harness === 'codex') {
+        writeOrMergeAgentsMd(repoPath, inv, io);
+        writeOrMergeCodexMcpToml(io);
+    }
+    else if (harness === 'cline') {
+        writeClineProjectRules(repoPath, inv, io);
+        writeOrMergeClineMcpSettings(io);
+    }
+    else if (harness === 'cursor' || harness === 'vscode') {
+        writeIdeHarnessScaffolding(repoPath, harness, inv, io);
+    }
+    else {
+        writeOrMergeClaudeMd(repoPath, inv.productName ?? null, io);
+        writeOrMergeClaudeSettings(repoPath, io);
+    }
+}
+//# sourceMappingURL=scaffolding.js.map

package/dist/cli/connect/scaffolding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffolding.js","sourceRoot":"","sources":["../../../src/cli/connect/scaffolding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,OAAwB,EACxB,GAAgC,EAChC,EAAa;IAEb,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACxC,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,sBAAsB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;SAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxD,0BAA0B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,oBAAoB,CAAC,QAAQ,EAAE,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5D,0BAA0B,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/cli/connect/shared.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared types + helpers for the connect-flow per-harness config writers.
+ *
+ * These live here (rather than in `../connect.ts`) so the per-harness writer
+ * modules under `connect/` can depend on them WITHOUT importing from
+ * `../connect.ts` -- which itself re-exports the writers, so that would be an
+ * import cycle. `connect.ts` imports these from here too; the dependency edge
+ * only ever points connect.ts -> connect/shared.ts, never back.
+ */
+export interface ConnectIO {
+    /** stdout writer (defaults to process.stdout.write). */
+    out: (msg: string) => void;
+    /** stderr writer (defaults to process.stderr.write). */
+    err: (msg: string) => void;
+    /** Fetch implementation (defaults to globalThis.fetch). */
+    fetch: typeof fetch;
+}
+/**
+ * The operator's chosen INTERACTIVE harness for the declare-intent workflow.
+ * This is independent of the daemon's per-product execution engine (which is
+ * resolved separately, from product config). `claude` is the default and its
+ * scaffolding path is byte-for-byte unchanged from before this option existed.
+ *
+ * `cursor` and `vscode` are inspection-and-light-operator IDE harnesses: both
+ * read AGENTS.md natively and take a project MCP config (`.cursor/mcp.json` /
+ * `.vscode/mcp.json`) carrying the domain-preload env so a static-surface
+ * client lands with a deterministic tool set under its ~40-tool ceiling.
+ */
+export type OperatorHarness = 'claude' | 'codex' | 'cline' | 'cursor' | 'vscode';
+//# sourceMappingURL=shared.d.ts.map

package/dist/cli/connect/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/cli/connect/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,wDAAwD;IACxD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC"}

package/dist/cli/connect/shared.js

@@ -0,0 +1,11 @@
+/**
+ * Shared types + helpers for the connect-flow per-harness config writers.
+ *
+ * These live here (rather than in `../connect.ts`) so the per-harness writer
+ * modules under `connect/` can depend on them WITHOUT importing from
+ * `../connect.ts` -- which itself re-exports the writers, so that would be an
+ * import cycle. `connect.ts` imports these from here too; the dependency edge
+ * only ever points connect.ts -> connect/shared.ts, never back.
+ */
+export {};
+//# sourceMappingURL=shared.js.map