@eir-labs/coltrane 0.4.0

package/dist/src/player_to_claude_code.js

@@ -0,0 +1,141 @@
+// player → claude-code agent compile.
+//
+// A Player is a public-facing role-definition that wraps an existing
+// coltrane agent_profile. This module parses a Player from a markdown file
+// with YAML frontmatter and emits a Claude Code agent .md file with the
+// required frontmatter fields (name, description, tools, model) and the
+// player's charter as the body, prefixed with an orientation line.
+//
+// The compile is pure: a parsed Player in, a string out. The CLI script
+// (scripts/compile_players.ts) handles the file I/O.
+//
+// Tool name mapping: coltrane MCP tool slugs (e.g. "agent_define") become
+// claude-code MCP refs (e.g. "mcp__coltrane__agent_define") in the
+// compiled agent's `tools` frontmatter field. The MCP server name in the
+// downstream consumer's .mcp.json must be "coltrane" for the refs to bind.
+const MCP_SERVER_NAME = "coltrane";
+function mapToolToClaudeRef(coltraneSlug) {
+    return `mcp__${MCP_SERVER_NAME}__${coltraneSlug}`;
+}
+/** Parse a player .md file body (frontmatter + body) into a Player record.
+ * Throws if required fields are missing or the frontmatter delimiters are
+ * malformed. Minimal YAML — we only support the exact shape we ship. */
+export function parsePlayer(fileContents) {
+    const m = fileContents.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (!m)
+        throw new Error("player file missing YAML frontmatter");
+    const fm = m[1] ?? "";
+    const lines = fm.split(/\r?\n/);
+    const fields = {};
+    const lists = {};
+    let currentList = null;
+    let currentBlockKey = null;
+    let currentBlockLines = [];
+    let currentBlockIndent = 0;
+    const flushBlock = () => {
+        if (currentBlockKey) {
+            fields[currentBlockKey] = currentBlockLines.join("\n").replace(/\s+$/, "");
+            currentBlockKey = null;
+            currentBlockLines = [];
+        }
+    };
+    for (const raw of lines) {
+        if (currentBlockKey !== null) {
+            // inside a |-block; consume indented lines, end on dedent or new key
+            const indentMatch = raw.match(/^(\s*)(.*)$/);
+            const indent = indentMatch ? (indentMatch[1] ?? "").length : 0;
+            const rest = indentMatch ? (indentMatch[2] ?? "") : "";
+            if (raw.trim() === "") {
+                currentBlockLines.push("");
+                continue;
+            }
+            if (indent >= currentBlockIndent) {
+                currentBlockLines.push(raw.slice(currentBlockIndent));
+                continue;
+            }
+            // dedent — close block, fall through to normal parsing
+            flushBlock();
+            // and reprocess this line below
+            // (so do NOT continue; fall into the parse below)
+            // however we already consumed raw; just re-handle synthetically
+            if (rest === "")
+                continue;
+        }
+        const line = raw;
+        const blockMatch = line.match(/^([a-z_]+):\s*\|\s*$/);
+        if (blockMatch) {
+            currentList = null;
+            currentBlockKey = blockMatch[1] ?? null;
+            currentBlockLines = [];
+            // detect indent from next non-empty line
+            currentBlockIndent = 2;
+            continue;
+        }
+        const listStart = line.match(/^([a-z_]+):\s*$/);
+        if (listStart) {
+            currentList = listStart[1] ?? null;
+            if (currentList)
+                lists[currentList] = [];
+            continue;
+        }
+        if (currentList) {
+            const item = line.match(/^\s+-\s+(.+)$/);
+            if (item) {
+                const v = (item[1] ?? "").trim();
+                lists[currentList]?.push(v);
+                continue;
+            }
+            currentList = null;
+        }
+        const kv = line.match(/^([a-z_]+):\s*(.*)$/);
+        if (kv) {
+            const key = kv[1] ?? "";
+            const value = (kv[2] ?? "").trim();
+            fields[key] = value;
+        }
+    }
+    flushBlock();
+    const required = ["slug", "display_name", "description", "agent_profile_ref", "lane", "charter"];
+    for (const r of required) {
+        if (!(r in fields) || !fields[r]) {
+            throw new Error(`player frontmatter missing required field: ${r}`);
+        }
+    }
+    const toolsAllowlist = lists["tools_allowlist"] ?? [];
+    if (toolsAllowlist.length === 0) {
+        throw new Error("player frontmatter must list at least one tool in tools_allowlist");
+    }
+    return {
+        slug: fields["slug"],
+        display_name: fields["display_name"],
+        description: fields["description"],
+        agent_profile_ref: fields["agent_profile_ref"],
+        lane: fields["lane"],
+        tools_allowlist: toolsAllowlist,
+        charter: fields["charter"],
+    };
+}
+/** Compile a Player into a Claude Code agent .md string.
+ * Output shape: YAML frontmatter (name, description, tools, model) + a body
+ * with the orientation line and the player's charter. */
+export function compilePlayerToClaudeAgent(player) {
+    const name = `coltrane-${player.slug}`;
+    const tools = player.tools_allowlist.map(mapToolToClaudeRef).join(", ");
+    const toolsList = player.tools_allowlist.map((t) => `- ${mapToolToClaudeRef(t)}`).join("\n");
+    const orientation = `You are operating as a coltrane player in the ${player.lane} lane. ` +
+        `Your role is: ${player.description} ` +
+        `You have access to the following coltrane MCP tools and only these tools:\n\n${toolsList}\n\n` +
+        `Use these tools to fulfill the user's request. Do not attempt to use tools outside this allowlist.`;
+    const frontmatter = [
+        "---",
+        `name: ${name}`,
+        `description: ${player.description}`,
+        `tools: ${tools}`,
+        `model: sonnet`,
+        `lane: ${player.lane}`,
+        `agent_profile_ref: ${player.agent_profile_ref}`,
+        "---",
+    ].join("\n");
+    return `${frontmatter}\n\n${orientation}\n\n${player.charter}\n`;
+}
+//# sourceMappingURL=player_to_claude_code.js.map

package/dist/src/player_to_claude_code.js.map

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

package/dist/src/playwright_cage.d.ts

@@ -0,0 +1,28 @@
+export interface PlaywrightCageOptions {
+    /** The nav allowlist — host/origin patterns the browser may reach. Deny-by-default: an empty
+     *  list means the agent may browse nothing (a browser grant without origins is inert). */
+    allowedOrigins: readonly string[];
+    /** Origins to explicitly block even if otherwise allowed. */
+    blockedOrigins?: readonly string[];
+    /** Where Playwright writes its saved session (provenance). Omit to skip session capture. */
+    traceDir?: string;
+    /** Ephemeral in-memory profile (no persistence). Default true. */
+    isolated?: boolean;
+    /** Run headless. Default true. */
+    headless?: boolean;
+    /** Override the package spec (tests/pinning). Default "@playwright/mcp@latest". */
+    packageSpec?: string;
+}
+export interface McpServerConfig {
+    command: string;
+    args: string[];
+}
+/** Build the @playwright/mcp server config for a caged browser. The allowlist + isolation +
+ *  trace flags are enforced by the server itself, so the cage holds even though the browser runs
+ *  out-of-process. Deny-by-default: origins not on `allowedOrigins` are refused at navigation. */
+export declare function buildPlaywrightCage(opts: PlaywrightCageOptions): McpServerConfig;
+export type { BrowserGrant } from "./genome_schema.js";
+import type { BrowserGrant } from "./genome_schema.js";
+/** Resolve an agent's declared browser grant into a caged playwright server config (server slug →
+ *  config). Returns null when the agent declares no browser grant (no caged browser is wired). */
+export declare function playwrightServerFor(grant: BrowserGrant | undefined): McpServerConfig | null;

package/dist/src/playwright_cage.js

@@ -0,0 +1,47 @@
+// The caged browser — coltrane's deny-by-default wrapper over @playwright/mcp. Raw browser
+// automation is powerful and dangerous: an agent with a browser can reach anywhere, persist
+// state, and exfiltrate. This cage hardens it into a safe, declared capability:
+//   - nav allowlist  (--allowed-origins): the browser can ONLY reach the origins the agent
+//     declares — deny-by-default. An off-list navigation is refused by the server itself, not
+//     merely discouraged in the prompt.
+//   - ephemeral      (--isolated): the profile is in-memory, disposed at session end — no cookie
+//     or storage bleed across gigs.
+//   - headless       (--headless): no UI, no human-session hijack.
+//   - provenance     (--save-session + --output-dir): the MCP session (every navigation + tool
+//     call) is written to disk, so "the browser actually went to ppubs.uspto.gov" is an artifact.
+// An agent grants browser tools (mcp__playwright__*) AND declares its allowed origins; coltrane
+// builds the server config from that declaration, so each agent's browser is scoped to exactly
+// what it asked for. Ships default with the repo — the deny-by-default browser is the substrate.
+/** Build the @playwright/mcp server config for a caged browser. The allowlist + isolation +
+ *  trace flags are enforced by the server itself, so the cage holds even though the browser runs
+ *  out-of-process. Deny-by-default: origins not on `allowedOrigins` are refused at navigation. */
+export function buildPlaywrightCage(opts) {
+    const args = ["-y", opts.packageSpec ?? "@playwright/mcp@latest"];
+    if (opts.headless !== false)
+        args.push("--headless");
+    if (opts.isolated !== false)
+        args.push("--isolated");
+    // --allowed-origins is the deny-by-default boundary: only these origins load. Always pass it
+    // (even empty) so a misconfigured grant fails closed (browses nothing) rather than open.
+    args.push("--allowed-origins", opts.allowedOrigins.join(";"));
+    if (opts.blockedOrigins && opts.blockedOrigins.length > 0) {
+        args.push("--blocked-origins", opts.blockedOrigins.join(";"));
+    }
+    if (opts.traceDir)
+        args.push("--save-session", "--output-dir", opts.traceDir);
+    return { command: "npx", args };
+}
+/** Resolve an agent's declared browser grant into a caged playwright server config (server slug →
+ *  config). Returns null when the agent declares no browser grant (no caged browser is wired). */
+export function playwrightServerFor(grant) {
+    if (!grant || !Array.isArray(grant.allowed_origins))
+        return null;
+    return buildPlaywrightCage({
+        allowedOrigins: grant.allowed_origins,
+        ...(grant.blocked_origins ? { blockedOrigins: grant.blocked_origins } : {}),
+        ...(grant.trace_dir ? { traceDir: grant.trace_dir } : {}),
+        ...(grant.isolated !== undefined ? { isolated: grant.isolated } : {}),
+        ...(grant.headless !== undefined ? { headless: grant.headless } : {}),
+    });
+}
+//# sourceMappingURL=playwright_cage.js.map

package/dist/src/playwright_cage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright_cage.js","sourceRoot":"","sources":["../../src/playwright_cage.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,4FAA4F;AAC5F,gFAAgF;AAChF,2FAA2F;AAC3F,8FAA8F;AAC9F,wCAAwC;AACxC,iGAAiG;AACjG,oCAAoC;AACpC,mEAAmE;AACnE,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,+FAA+F;AAC/F,iGAAiG;AAuBjG;;kGAEkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,IAA2B;IAC7D,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,wBAAwB,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,6FAA6F;IAC7F,yFAAyF;IACzF,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AASD;kGACkG;AAClG,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,OAAO,mBAAmB,CAAC;QACzB,cAAc,EAAE,KAAK,CAAC,eAAe;QACrC,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC,CAAC;AACL,CAAC"}

package/dist/src/polyphony.d.ts

@@ -0,0 +1,46 @@
+import { type Key } from "./circle_of_fifths.js";
+import type { ModulationPath } from "./modulation_path.js";
+export interface Voice {
+    agent_slug: string;
+    path: ModulationPath;
+}
+export interface ChordAtPhase {
+    phase: string;
+    voices: ReadonlyMap<string, Key>;
+    pairwise: ReadonlyArray<{
+        voice_a: string;
+        voice_b: string;
+        distance: number;
+    }>;
+}
+export interface Polyphony {
+    voices: readonly Voice[];
+    chords: readonly ChordAtPhase[];
+}
+export declare class PolyphonyError extends Error {
+}
+export declare function composeVoices(voices: readonly Voice[]): Polyphony;
+/**
+ * Number of voices sounding at a given phase. Feature, not verdict.
+ */
+export declare function voiceCountAtPhase(poly: Polyphony, phase: string): number;
+/**
+ * Tonic-density: the n-tonic shape of the chord at a given phase.
+ * monotonic (1 voice) · bitonic (2) · tritonic (3) · pentatonic (5) · polyphonic (≥6).
+ * Names match Eugene's morning spec.
+ */
+export type TonicDensity = "silence" | "monotonic" | "bitonic" | "tritonic" | "tetratonic" | "pentatonic" | "hexatonic" | "polyphonic";
+export declare function tonicDensity(poly: Polyphony, phase: string): TonicDensity;
+/**
+ * Per-phase tonic-density profile across the whole polyphonic structure.
+ * Returned as an array of (phase, density) — feature data for a tensor channel.
+ */
+export declare function densityProfile(poly: Polyphony): ReadonlyArray<{
+    phase: string;
+    density: TonicDensity;
+}>;
+/**
+ * Maximum pairwise distance at a given phase. Surfaces "how dissonant" the
+ * chord is in circle-of-fifths terms. A NUMBER (0..6), not a pass/fail.
+ */
+export declare function maxDissonanceAtPhase(poly: Polyphony, phase: string): number;

package/dist/src/polyphony.js

@@ -0,0 +1,91 @@
+// Multi-voice composition: when multiple agents play together in the sim, they
+// form polyphony. Each agent emits its own modulation_path (its voice). This
+// module composes N voices into a polyphonic read WITHOUT collapsing them into
+// one melodic line — voice independence is preserved; cross-voice coupling is
+// surfaced as feature-data, never as a single verdict.
+import { circleOfFifthsDistance, } from "./circle_of_fifths.js";
+export class PolyphonyError extends Error {
+}
+export function composeVoices(voices) {
+    if (voices.length === 0) {
+        throw new PolyphonyError("polyphony requires at least one voice");
+    }
+    // Collect every phase name that any voice visits.
+    const phaseOrder = [];
+    const seen = new Set();
+    for (const v of voices) {
+        for (const step of v.path.steps) {
+            if (!seen.has(step.phase)) {
+                seen.add(step.phase);
+                phaseOrder.push(step.phase);
+            }
+        }
+    }
+    // For each phase, gather which voices are playing + their pairwise distances.
+    const chords = phaseOrder.map((phase) => {
+        const voicesAtPhase = new Map();
+        for (const v of voices) {
+            const step = v.path.steps.find((s) => s.phase === phase);
+            if (step)
+                voicesAtPhase.set(v.agent_slug, step.key);
+        }
+        const slugs = [...voicesAtPhase.keys()];
+        const pairwise = [];
+        for (let i = 0; i < slugs.length; i++) {
+            for (let j = i + 1; j < slugs.length; j++) {
+                const a = slugs[i];
+                const b = slugs[j];
+                pairwise.push({
+                    voice_a: a,
+                    voice_b: b,
+                    distance: circleOfFifthsDistance(voicesAtPhase.get(a), voicesAtPhase.get(b)),
+                });
+            }
+        }
+        return { phase, voices: voicesAtPhase, pairwise };
+    });
+    return { voices, chords };
+}
+/**
+ * Number of voices sounding at a given phase. Feature, not verdict.
+ */
+export function voiceCountAtPhase(poly, phase) {
+    const chord = poly.chords.find((c) => c.phase === phase);
+    return chord ? chord.voices.size : 0;
+}
+export function tonicDensity(poly, phase) {
+    const n = voiceCountAtPhase(poly, phase);
+    if (n === 0)
+        return "silence";
+    if (n === 1)
+        return "monotonic";
+    if (n === 2)
+        return "bitonic";
+    if (n === 3)
+        return "tritonic";
+    if (n === 4)
+        return "tetratonic";
+    if (n === 5)
+        return "pentatonic";
+    if (n === 6)
+        return "hexatonic";
+    return "polyphonic";
+}
+/**
+ * Per-phase tonic-density profile across the whole polyphonic structure.
+ * Returned as an array of (phase, density) — feature data for a tensor channel.
+ */
+export function densityProfile(poly) {
+    return poly.chords.map((c) => ({ phase: c.phase, density: tonicDensity(poly, c.phase) }));
+}
+/**
+ * Maximum pairwise distance at a given phase. Surfaces "how dissonant" the
+ * chord is in circle-of-fifths terms. A NUMBER (0..6), not a pass/fail.
+ */
+export function maxDissonanceAtPhase(poly, phase) {
+    const chord = poly.chords.find((c) => c.phase === phase);
+    if (!chord || chord.pairwise.length === 0)
+        return 0;
+    return Math.max(...chord.pairwise.map((p) => p.distance));
+}
+//# sourceMappingURL=polyphony.js.map

package/dist/src/polyphony.js.map

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

package/dist/src/portfolio.d.ts

@@ -0,0 +1,52 @@
+export interface PortfolioEntry {
+    genome_slug: string;
+    current_phase: string;
+    current_standard_slug: string | null;
+    last_touched_utc: string;
+    sealed_state_hash: string | null;
+    next_natural_action: string;
+    parked_at_utc: string | null;
+}
+export declare class SealMismatchError extends Error {
+    readonly recorded_hash: string;
+    readonly recomputed_hash: string;
+    readonly genome_slug: string;
+    constructor(genome_slug: string, recorded_hash: string, recomputed_hash: string);
+}
+export declare class PortfolioNotFoundError extends Error {
+    readonly genome_slug: string;
+    constructor(genome_slug: string);
+}
+/**
+ * Lists the portfolio as latest-per-slug. Resume rows override prior park rows
+ * for the same slug; park rows override prior resume rows. Order of appearance
+ * in the JSONL is the order of truth (append-only).
+ */
+export declare function listPortfolio(genomes_root?: string): PortfolioEntry[];
+/**
+ * SHA-seals the current state, marks the project as parked, appends a park row.
+ * Returns the parked entry (sealed_state_hash populated, parked_at_utc populated).
+ */
+export declare function parkGenome(genome_slug: string, current_state: object, opts?: {
+    current_phase?: string;
+    current_standard_slug?: string | null;
+    genomes_root?: string;
+}): PortfolioEntry;
+/**
+ * Verifies the seal of the most recent park-row for the slug, restores the state,
+ * appends a resume row, and returns both.
+ *
+ * Throws PortfolioNotFoundError if the slug has no park row.
+ * Throws SealMismatchError if the recorded state's recomputed hash != recorded hash.
+ */
+export declare function resumeGenome(genome_slug: string, opts?: {
+    genomes_root?: string;
+}): {
+    entry: PortfolioEntry;
+    restored_state: object;
+};
+/**
+ * Computes a text description of where the user would naturally pick up.
+ * Pure function over an entry; deterministic.
+ */
+export declare function suggestNextAction(entry: PortfolioEntry): string;

package/dist/src/portfolio.js

@@ -0,0 +1,186 @@
+// portfolio.ts — sprint-portfolio primitive.
+//
+// Models a portfolio of in-flight projects, each at its own phase. Append-only
+// .coltrane/portfolio.jsonl is the durable surface; each park/resume appends
+// a row; listPortfolio reduces to latest-per-slug.
+//
+// Storage path resolution (in order):
+//   1. explicit `genomes_root` arg → <root>/.coltrane/portfolio.jsonl
+//   2. process.env.COLTRANE_PORTFOLIO_ROOT → <env>/.coltrane/portfolio.jsonl
+//   3. process.cwd() → <cwd>/.coltrane/portfolio.jsonl
+//
+// Seal: sha256 over canonical-form JSON of the parked state. Same content → same hash.
+import { existsSync, mkdirSync, readFileSync, appendFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { canonJson, sha256Hex } from "./canonical_form.js";
+export class SealMismatchError extends Error {
+    recorded_hash;
+    recomputed_hash;
+    genome_slug;
+    constructor(genome_slug, recorded_hash, recomputed_hash) {
+        super(`seal mismatch for ${genome_slug}: recorded=${recorded_hash} recomputed=${recomputed_hash}`);
+        this.name = "SealMismatchError";
+        this.genome_slug = genome_slug;
+        this.recorded_hash = recorded_hash;
+        this.recomputed_hash = recomputed_hash;
+    }
+}
+export class PortfolioNotFoundError extends Error {
+    genome_slug;
+    constructor(genome_slug) {
+        super(`no portfolio entry for genome_slug=${genome_slug}`);
+        this.name = "PortfolioNotFoundError";
+        this.genome_slug = genome_slug;
+    }
+}
+function resolvePortfolioPath(genomes_root) {
+    const root = genomes_root ??
+        process.env.COLTRANE_PORTFOLIO_ROOT ??
+        process.cwd();
+    return join(root, ".coltrane", "portfolio.jsonl");
+}
+function ensureParentDir(path) {
+    const parent = dirname(path);
+    if (!existsSync(parent)) {
+        mkdirSync(parent, { recursive: true });
+    }
+}
+function readAllRows(path) {
+    if (!existsSync(path))
+        return [];
+    const raw = readFileSync(path, "utf-8");
+    const rows = [];
+    for (const line of raw.split("\n")) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            rows.push(JSON.parse(t));
+        }
+        catch {
+            // skip malformed lines; honest log-tail tolerance
+        }
+    }
+    return rows;
+}
+function appendRow(path, row) {
+    ensureParentDir(path);
+    appendFileSync(path, JSON.stringify(row) + "\n");
+}
+function nowUtc() {
+    return new Date().toISOString();
+}
+/**
+ * Lists the portfolio as latest-per-slug. Resume rows override prior park rows
+ * for the same slug; park rows override prior resume rows. Order of appearance
+ * in the JSONL is the order of truth (append-only).
+ */
+export function listPortfolio(genomes_root) {
+    const path = resolvePortfolioPath(genomes_root);
+    const rows = readAllRows(path);
+    const latest = new Map();
+    for (const row of rows) {
+        if (!row.entry || typeof row.entry.genome_slug !== "string")
+            continue;
+        latest.set(row.entry.genome_slug, row.entry);
+    }
+    return Array.from(latest.values()).sort((a, b) => a.genome_slug < b.genome_slug ? -1 : a.genome_slug > b.genome_slug ? 1 : 0);
+}
+/**
+ * SHA-seals the current state, marks the project as parked, appends a park row.
+ * Returns the parked entry (sealed_state_hash populated, parked_at_utc populated).
+ */
+export function parkGenome(genome_slug, current_state, opts = {}) {
+    const path = resolvePortfolioPath(opts.genomes_root);
+    const sealed_state_hash = sha256Hex(canonJson(current_state));
+    const now = nowUtc();
+    // pull prior phase/standard if not supplied
+    const prior = listPortfolio(opts.genomes_root).find((e) => e.genome_slug === genome_slug);
+    const current_phase = opts.current_phase ?? prior?.current_phase ?? "voice";
+    const current_standard_slug = opts.current_standard_slug !== undefined
+        ? opts.current_standard_slug
+        : (prior?.current_standard_slug ?? null);
+    const entry = {
+        genome_slug,
+        current_phase,
+        current_standard_slug,
+        last_touched_utc: now,
+        sealed_state_hash,
+        next_natural_action: "",
+        parked_at_utc: now,
+    };
+    entry.next_natural_action = suggestNextAction(entry);
+    appendRow(path, { event: "park", entry, state: current_state });
+    return entry;
+}
+/**
+ * Verifies the seal of the most recent park-row for the slug, restores the state,
+ * appends a resume row, and returns both.
+ *
+ * Throws PortfolioNotFoundError if the slug has no park row.
+ * Throws SealMismatchError if the recorded state's recomputed hash != recorded hash.
+ */
+export function resumeGenome(genome_slug, opts = {}) {
+    const path = resolvePortfolioPath(opts.genomes_root);
+    const rows = readAllRows(path);
+    // find most recent park row for this slug
+    let parkRow = null;
+    for (let i = rows.length - 1; i >= 0; i--) {
+        const row = rows[i];
+        if (row !== undefined &&
+            row.event === "park" &&
+            row.entry &&
+            row.entry.genome_slug === genome_slug) {
+            parkRow = row;
+            break;
+        }
+    }
+    if (parkRow === null) {
+        throw new PortfolioNotFoundError(genome_slug);
+    }
+    const recorded_hash = parkRow.entry.sealed_state_hash;
+    const restored_state = (parkRow.state ?? {});
+    const recomputed_hash = sha256Hex(canonJson(restored_state));
+    if (recorded_hash === null) {
+        // null-sealed park: restore but warn — caller can opt into hard-gate
+    }
+    else if (recorded_hash !== recomputed_hash) {
+        throw new SealMismatchError(genome_slug, recorded_hash, recomputed_hash);
+    }
+    const now = nowUtc();
+    const resumedEntry = {
+        genome_slug,
+        current_phase: parkRow.entry.current_phase,
+        current_standard_slug: parkRow.entry.current_standard_slug,
+        last_touched_utc: now,
+        sealed_state_hash: null, // resume clears the parked-seal — project is live again
+        next_natural_action: "",
+        parked_at_utc: null,
+    };
+    resumedEntry.next_natural_action = suggestNextAction(resumedEntry);
+    appendRow(path, { event: "resume", entry: resumedEntry });
+    return { entry: resumedEntry, restored_state };
+}
+/**
+ * Computes a text description of where the user would naturally pick up.
+ * Pure function over an entry; deterministic.
+ */
+export function suggestNextAction(entry) {
+    const phase = entry.current_phase;
+    const standard = entry.current_standard_slug ?? "no-standard";
+    const parked = entry.parked_at_utc !== null;
+    const verbByPhase = {
+        voice: "Voice the in-flight thought",
+        spin: "Spin up the project genome",
+        discover: "Diverge — survey the problem space",
+        define: "Converge — name the falsifiable",
+        develop: "Generate the files under the sealed charter",
+        deliver: "Ripen the verdict",
+        "context-switch": "Switch to a different project slug",
+        "return-later": "Restore from the sealed park entry",
+    };
+    const verb = verbByPhase[phase] ?? `Continue at phase=${phase}`;
+    const status = parked ? "parked" : "current";
+    return `[${status}] ${verb} (standard=${standard})`;
+}
+//# sourceMappingURL=portfolio.js.map

package/dist/src/portfolio.js.map

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

package/dist/src/pricing.d.ts

@@ -0,0 +1,23 @@
+export declare const DEPTH_MULTIPLIER: {
+    readonly skim: 0.5;
+    readonly quick: 0.75;
+    readonly standard: 1;
+    readonly deep: 2;
+};
+export declare const MODEL_MULTIPLIER: {
+    readonly economy: 0.5;
+    readonly standard: 1;
+    readonly premium: 2;
+};
+export type Depth = keyof typeof DEPTH_MULTIPLIER;
+export type ModelTier = keyof typeof MODEL_MULTIPLIER;
+export declare const DEPTHS: readonly Depth[];
+export declare function isDepth(v: unknown): v is Depth;
+export interface CreditInput {
+    base_cost: number;
+    depth: Depth;
+    model_tier: ModelTier;
+    agents: number;
+    external_tool_calls: number;
+}
+export declare function computeCredits(input: CreditInput): number;