@supersession/sup 0.1.1

package/dist/parsers/chat-export.js.map

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

package/dist/parsers/claude-code.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude Code parser: JSONL transcript -> NSF.
+ *
+ * Grounded in the REAL on-disk schema (verified 2026-07-14 against live
+ * sessions), not a guess:
+ *   - Each line is a JSON record with a top-level `type`.
+ *   - Message-bearing types: "user", "assistant". Others (system, mode,
+ *     file-history-snapshot, attachment, last-prompt, ai-title, summary) carry
+ *     no conversational turn and are counted as gaps, not dropped silently.
+ *   - `message.content` is EITHER a string OR an array of blocks.
+ *   - Block types seen: "text", "thinking", "tool_use", "tool_result".
+ *   - Records carry: cwd, gitBranch, sessionId, timestamp, isSidechain, isMeta.
+ *
+ * Compaction note (per SPEC §4d): Claude Code writes compaction as an added
+ * summary record, not by deleting turns — so reading the file survives it. We
+ * treat a summary record as a gap (it's a vendor artifact, not a user turn).
+ */
+import type { NsfSession } from "../nsf.js";
+export declare const CLAUDE_CODE_TOOL_ID = "claude-code";
+/**
+ * Parse a Claude Code JSONL session file into NSF.
+ * @param filePath absolute path to the `.jsonl` transcript.
+ */
+export declare function parseClaudeCode(filePath: string): NsfSession;

package/dist/parsers/claude-code.js

@@ -0,0 +1,193 @@
+/**
+ * Claude Code parser: JSONL transcript -> NSF.
+ *
+ * Grounded in the REAL on-disk schema (verified 2026-07-14 against live
+ * sessions), not a guess:
+ *   - Each line is a JSON record with a top-level `type`.
+ *   - Message-bearing types: "user", "assistant". Others (system, mode,
+ *     file-history-snapshot, attachment, last-prompt, ai-title, summary) carry
+ *     no conversational turn and are counted as gaps, not dropped silently.
+ *   - `message.content` is EITHER a string OR an array of blocks.
+ *   - Block types seen: "text", "thinking", "tool_use", "tool_result".
+ *   - Records carry: cwd, gitBranch, sessionId, timestamp, isSidechain, isMeta.
+ *
+ * Compaction note (per SPEC §4d): Claude Code writes compaction as an added
+ * summary record, not by deleting turns — so reading the file survives it. We
+ * treat a summary record as a gap (it's a vendor artifact, not a user turn).
+ */
+import { readFileSync } from "node:fs";
+import { NSF_VERSION } from "../nsf.js";
+export const CLAUDE_CODE_TOOL_ID = "claude-code";
+/** Map a Claude Code tool name to a normalized NSF action kind. */
+function normalizeActionKind(name) {
+    switch (name) {
+        case "Edit":
+        case "MultiEdit":
+            return "edit";
+        case "Write":
+        case "NotebookEdit":
+            return "write";
+        case "Read":
+        case "NotebookRead":
+            return "read";
+        case "Bash":
+        case "BashOutput":
+            return "run";
+        case "Grep":
+        case "Glob":
+            return "search";
+        default:
+            return "other";
+    }
+}
+/** Extract the file path an action touched, from the tool's input object. */
+function extractPath(input) {
+    if (!input || typeof input !== "object")
+        return undefined;
+    const o = input;
+    const p = o.file_path ?? o.notebook_path ?? o.path;
+    return typeof p === "string" ? p : undefined;
+}
+function extractCommand(input) {
+    if (!input || typeof input !== "object")
+        return undefined;
+    const c = input.command;
+    return typeof c === "string" ? c : undefined;
+}
+/** Pull prose text + actions out of one message's content (string or blocks). */
+function readContent(content) {
+    if (typeof content === "string") {
+        return { text: content.trim(), actions: [] };
+    }
+    if (!Array.isArray(content))
+        return { text: "", actions: [] };
+    const textParts = [];
+    const actions = [];
+    for (const block of content) {
+        if (!block || typeof block !== "object")
+            continue;
+        switch (block.type) {
+            case "text":
+                if (typeof block.text === "string")
+                    textParts.push(block.text.trim());
+                break;
+            case "thinking":
+                // Deliberately dropped: private reasoning, not portable context.
+                break;
+            case "tool_use": {
+                const rawName = typeof block.name === "string" ? block.name : "unknown";
+                actions.push({
+                    kind: normalizeActionKind(rawName),
+                    rawName,
+                    path: extractPath(block.input),
+                    command: extractCommand(block.input),
+                });
+                break;
+            }
+            case "tool_result": {
+                // Mark the matching action as failed if the tool reported an error.
+                // Results are otherwise dropped (noise); the action itself is the signal.
+                if (block.is_error && actions.length > 0) {
+                    actions[actions.length - 1].failed = true;
+                }
+                break;
+            }
+        }
+    }
+    return { text: textParts.join("\n\n").trim(), actions };
+}
+/**
+ * Parse a Claude Code JSONL session file into NSF.
+ * @param filePath absolute path to the `.jsonl` transcript.
+ */
+export function parseClaudeCode(filePath) {
+    const raw = readFileSync(filePath, "utf8");
+    const lines = raw.split("\n");
+    const turns = [];
+    const filesSeen = new Set();
+    const filesOrdered = [];
+    const gapCounts = new Map();
+    const provenance = {
+        tool: CLAUDE_CODE_TOOL_ID,
+        rawBytes: Buffer.byteLength(raw, "utf8"),
+    };
+    let compactions = 0;
+    const addGap = (reason) => gapCounts.set(reason, (gapCounts.get(reason) ?? 0) + 1);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(trimmed);
+        }
+        catch {
+            addGap("unparseable line");
+            continue;
+        }
+        // Capture provenance from the first record that carries it.
+        provenance.cwd ??= rec.cwd;
+        provenance.gitBranch ??= rec.gitBranch;
+        provenance.sessionId ??= rec.sessionId;
+        const type = rec.type;
+        // Compaction/summary events: a "scar" — a lossy in-place summarization.
+        // Detected best-effort by type or an isCompactSummary marker.
+        if (type === "summary" ||
+            (typeof type === "string" && /compact/i.test(type)) ||
+            rec.isCompactSummary === true) {
+            compactions++;
+            addGap("compaction/summary event");
+            continue;
+        }
+        if (type !== "user" && type !== "assistant") {
+            addGap(`non-message record (${type ?? "unknown"})`);
+            continue;
+        }
+        // Sidechains are subagent conversations — real work, but not the main
+        // thread the user is handing off. Fold as a gap so the report is honest.
+        if (rec.isSidechain) {
+            addGap("subagent sidechain turn");
+            continue;
+        }
+        const role = rec.message?.role;
+        if (role !== "user" && role !== "assistant") {
+            addGap("message with no role");
+            continue;
+        }
+        const { text, actions } = readContent(rec.message?.content);
+        for (const a of actions) {
+            if (a.path && !filesSeen.has(a.path)) {
+                filesSeen.add(a.path);
+                filesOrdered.push(a.path);
+            }
+        }
+        // A turn with neither prose nor actions is pure noise (e.g. a lone
+        // tool_result echo). Skip it rather than emit an empty turn.
+        if (!text && actions.length === 0) {
+            if (!rec.isMeta)
+                addGap("empty turn");
+            continue;
+        }
+        // Meta turns (local-command caveats, system-injected notes) aren't the
+        // user actually talking — mark as gap but keep the text, it can carry
+        // useful signal like slash-command output.
+        if (rec.isMeta)
+            addGap("meta/system-injected turn");
+        turns.push({
+            role,
+            text,
+            actions,
+            timestamp: rec.timestamp ? Date.parse(rec.timestamp) : undefined,
+        });
+    }
+    const gaps = [...gapCounts.entries()].map(([reason, count]) => ({ reason, count }));
+    provenance.compactions = compactions;
+    return {
+        nsfVersion: NSF_VERSION,
+        provenance,
+        turns,
+        filesTouched: filesOrdered,
+        gaps,
+    };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/parsers/claude-code.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Secret redaction. Runs on NSF text + commands before a brief is written or
+ * uploaded. Local-first: this is the last line of defense before your keys
+ * could leak into another tool's context or our cloud.
+ *
+ * Philosophy: false positives (over-redacting) are acceptable; false negatives
+ * (a leaked key) are not. When unsure, redact. Every hit is counted so the
+ * fidelity report can tell the user "3 secrets redacted".
+ */
+import type { NsfSession } from "./nsf.js";
+export interface RedactionResult {
+    text: string;
+    hits: number;
+}
+/** Redact a single string. Returns the cleaned text and how many hits fired. */
+export declare function redactText(input: string): RedactionResult;
+/**
+ * Redact an entire NSF session in place-safe manner (returns a new session).
+ * Cleans turn text and shell commands — the two places secrets actually land.
+ */
+export declare function redactSession(session: NsfSession): {
+    session: NsfSession;
+    hits: number;
+};

package/dist/redact.js

@@ -0,0 +1,65 @@
+/**
+ * Secret redaction. Runs on NSF text + commands before a brief is written or
+ * uploaded. Local-first: this is the last line of defense before your keys
+ * could leak into another tool's context or our cloud.
+ *
+ * Philosophy: false positives (over-redacting) are acceptable; false negatives
+ * (a leaked key) are not. When unsure, redact. Every hit is counted so the
+ * fidelity report can tell the user "3 secrets redacted".
+ */
+// Ordered most-specific first. All global + multiline where relevant.
+const RULES = [
+    { name: "openai-key", pattern: /\bsk-[A-Za-z0-9_-]{20,}\b/g },
+    { name: "anthropic-key", pattern: /\bsk-ant-[A-Za-z0-9_-]{20,}\b/g },
+    { name: "aws-access-key", pattern: /\bAKIA[0-9A-Z]{16}\b/g },
+    { name: "github-token", pattern: /\b(?:ghp|gho|ghu|ghs|ghr|github_pat)_[A-Za-z0-9_]{20,}\b/g },
+    { name: "google-key", pattern: /\bAIza[0-9A-Za-z_-]{35}\b/g },
+    { name: "slack-token", pattern: /\bxox[baprs]-[A-Za-z0-9-]{10,}\b/g },
+    { name: "stripe-key", pattern: /\b(?:sk|rk)_(?:live|test)_[A-Za-z0-9]{20,}\b/g },
+    { name: "bearer-token", pattern: /\bBearer\s+[A-Za-z0-9._-]{20,}\b/g },
+    { name: "private-key-block", pattern: /-----BEGIN[A-Z ]*PRIVATE KEY-----[\s\S]*?-----END[A-Z ]*PRIVATE KEY-----/g },
+    { name: "jwt", pattern: /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/g },
+    // Generic KEY=secret assignments (env-file style). Value must look secret-ish.
+    {
+        name: "env-assignment",
+        pattern: /\b([A-Z][A-Z0-9_]*(?:KEY|TOKEN|SECRET|PASSWORD|PASSWD|CREDENTIAL)[A-Z0-9_]*)\s*[=:]\s*["']?([A-Za-z0-9._/+-]{8,})["']?/g,
+    },
+];
+const PLACEHOLDER = (name) => `«redacted:${name}»`;
+/** Redact a single string. Returns the cleaned text and how many hits fired. */
+export function redactText(input) {
+    let text = input;
+    let hits = 0;
+    for (const rule of RULES) {
+        text = text.replace(rule.pattern, (match, ...groups) => {
+            hits++;
+            // For env-assignment keep the key name, mask only the value.
+            if (rule.name === "env-assignment" && typeof groups[0] === "string") {
+                return `${groups[0]}=${PLACEHOLDER("secret")}`;
+            }
+            return PLACEHOLDER(rule.name);
+        });
+    }
+    return { text, hits };
+}
+/**
+ * Redact an entire NSF session in place-safe manner (returns a new session).
+ * Cleans turn text and shell commands — the two places secrets actually land.
+ */
+export function redactSession(session) {
+    let hits = 0;
+    const turns = session.turns.map((turn) => {
+        const t = redactText(turn.text);
+        hits += t.hits;
+        const actions = turn.actions.map((a) => {
+            if (!a.command)
+                return a;
+            const c = redactText(a.command);
+            hits += c.hits;
+            return { ...a, command: c.text };
+        });
+        return { ...turn, text: t.text, actions };
+    });
+    return { session: { ...session, turns }, hits };
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,sEAAsE;AACtE,MAAM,KAAK,GAAoB;IAC7B,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,gCAAgC,EAAE;IACpE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,EAAE;IAC5D,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,2DAA2D,EAAE;IAC9F,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,4BAA4B,EAAE;IAC7D,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACrE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,+CAA+C,EAAE;IAChF,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACtE,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,2EAA2E,EAAE;IACnH,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,oEAAoE,EAAE;IAC9F,+EAA+E;IAC/E;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,yHAAyH;KACnI;CACF,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,aAAa,IAAI,GAAG,CAAC;AAO3D,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,MAAM,EAAE,EAAE;YACrD,IAAI,EAAE,CAAC;YACP,6DAA6D;YAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACpE,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAmB;IAC/C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACrC,IAAI,CAAC,CAAC,CAAC,OAAO;gBAAE,OAAO,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tool registry: the single place that knows, per supported tool, (a) where it
+ * stores sessions on disk, (b) how to parse them, and (c) how to hand a brief
+ * TO it. Adding a tool = adding one entry here + a parser. Everything else in
+ * the CLI is tool-agnostic.
+ *
+ * IMPORTANT (SPEC §4d): only Claude Code's on-disk format is verified. Codex,
+ * Gemini, Cursor, etc. are stubs until confirmed against a live install — they
+ * are declared but marked `verified: false` so the CLI can be honest about it
+ * instead of silently producing garbage.
+ */
+import type { NsfSession } from "./nsf.js";
+import type { Brief } from "./distill/template.js";
+export interface ToolDef {
+    id: string;
+    label: string;
+    /** False until the on-disk format is verified against a real install. */
+    verified: boolean;
+    /** Directory where this tool stores its session files, or undefined if cloud-only. */
+    sessionsDir?: () => string;
+    /** Parse one native session file into NSF. */
+    parse?: (filePath: string) => NsfSession;
+    /**
+     * Turn a brief into what this tool should receive. Returns the file to write
+     * (relative to the target repo) and an optional launch command hint shown to
+     * the user. Kept as data — actually launching subprocesses is a later step.
+     */
+    writeTarget?: (brief: Brief, sourceLabel: string) => {
+        file: string;
+        body: string;
+        launchHint: string;
+    };
+}
+/** Claude Code project-slug directory: /abs/path -> -abs-path form under ~/.claude/projects. */
+export declare function claudeCodeProjectDir(cwd: string): string;
+export declare const TOOLS: Record<string, ToolDef>;
+export declare function resolveTool(id: string): ToolDef | undefined;

package/dist/tools.js

@@ -0,0 +1,67 @@
+/**
+ * Tool registry: the single place that knows, per supported tool, (a) where it
+ * stores sessions on disk, (b) how to parse them, and (c) how to hand a brief
+ * TO it. Adding a tool = adding one entry here + a parser. Everything else in
+ * the CLI is tool-agnostic.
+ *
+ * IMPORTANT (SPEC §4d): only Claude Code's on-disk format is verified. Codex,
+ * Gemini, Cursor, etc. are stubs until confirmed against a live install — they
+ * are declared but marked `verified: false` so the CLI can be honest about it
+ * instead of silently producing garbage.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parseClaudeCode, CLAUDE_CODE_TOOL_ID } from "./parsers/claude-code.js";
+import { renderBriefMarkdown } from "./writers/brief-markdown.js";
+/** Claude Code project-slug directory: /abs/path -> -abs-path form under ~/.claude/projects. */
+export function claudeCodeProjectDir(cwd) {
+    const slug = cwd.replace(/[/.]/g, "-");
+    return join(homedir(), ".claude", "projects", slug);
+}
+export const TOOLS = {
+    "claude-code": {
+        id: CLAUDE_CODE_TOOL_ID,
+        label: "Claude Code",
+        verified: true,
+        sessionsDir: () => join(homedir(), ".claude", "projects"),
+        parse: parseClaudeCode,
+        writeTarget: (brief, sourceLabel) => ({
+            file: "CLAUDE.local.md",
+            body: renderBriefMarkdown(brief, sourceLabel),
+            launchHint: "claude   # then say: read CLAUDE.local.md and continue",
+        }),
+    },
+    codex: {
+        id: "codex",
+        label: "Codex CLI",
+        verified: false,
+        writeTarget: (brief, sourceLabel) => ({
+            file: "AGENTS.md",
+            body: renderBriefMarkdown(brief, sourceLabel),
+            launchHint: "codex   # picks up AGENTS.md automatically",
+        }),
+    },
+    gemini: {
+        id: "gemini",
+        label: "Gemini CLI",
+        verified: false,
+        writeTarget: (brief, sourceLabel) => ({
+            file: "GEMINI.md",
+            body: renderBriefMarkdown(brief, sourceLabel),
+            launchHint: "gemini   # picks up GEMINI.md automatically",
+        }),
+    },
+};
+/** Friendly aliases so `sup claude` == `sup claude-code`, `sup cc`, etc. */
+const ALIASES = {
+    claude: "claude-code",
+    "claude-code": "claude-code",
+    cc: "claude-code",
+    codex: "codex",
+    gemini: "gemini",
+};
+export function resolveTool(id) {
+    const key = id.toLowerCase();
+    return TOOLS[ALIASES[key] ?? key];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAmBlE,gGAAgG;AAChG,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAA4B;IAC5C,aAAa,EAAE;QACb,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;QACzD,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,iBAAiB;YACvB,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC;YAC7C,UAAU,EAAE,wDAAwD;SACrE,CAAC;KACH;IAED,KAAK,EAAE;QACL,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC;YAC7C,UAAU,EAAE,4CAA4C;SACzD,CAAC;KACH;IAED,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC;YAC7C,UAAU,EAAE,6CAA6C;SAC1D,CAAC;KACH;CACF,CAAC;AAEF,4EAA4E;AAC5E,MAAM,OAAO,GAA2B;IACtC,MAAM,EAAE,aAAa;IACrB,aAAa,EAAE,aAAa;IAC5B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/writers/brief-markdown.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Renders a Brief into the canonical markdown that every target tool receives.
+ * Writers wrap this with tool-specific framing (Codex kickoff prompt, Claude
+ * Code CLAUDE.local.md, etc.), but the body is shared so a handoff reads the
+ * same regardless of destination.
+ */
+import type { Brief } from "../distill/template.js";
+/**
+ * @param brief the distilled brief
+ * @param sourceTool human label of where the session came from (e.g. "Claude Code")
+ */
+export declare function renderBriefMarkdown(brief: Brief, sourceTool: string): string;

package/dist/writers/brief-markdown.js

@@ -0,0 +1,83 @@
+/**
+ * Renders a Brief into the canonical markdown that every target tool receives.
+ * Writers wrap this with tool-specific framing (Codex kickoff prompt, Claude
+ * Code CLAUDE.local.md, etc.), but the body is shared so a handoff reads the
+ * same regardless of destination.
+ */
+function fileLine(f) {
+    const marks = [];
+    if (!f.exists)
+        marks.push("MISSING NOW");
+    if (f.git === "M")
+        marks.push("modified");
+    else if (f.git === "A")
+        marks.push("staged");
+    else if (f.git === "??")
+        marks.push("untracked");
+    const suffix = marks.length ? `  — ${marks.join(", ")}` : "";
+    return `- \`${f.path}\`${suffix}`;
+}
+function turnBlock(turn) {
+    const who = turn.role === "user" ? "User" : "Assistant";
+    const actions = turn.actions
+        .filter((a) => a.path || a.command)
+        .map((a) => {
+        if (a.command)
+            return `    · ran: \`${a.command.split("\n")[0]}\`${a.failed ? " (failed)" : ""}`;
+        return `    · ${a.kind}: \`${a.path}\`${a.failed ? " (failed)" : ""}`;
+    });
+    const parts = [`**${who}:** ${turn.text || "(no prose — took actions)"}`];
+    if (actions.length)
+        parts.push(actions.join("\n"));
+    return parts.join("\n");
+}
+/**
+ * @param brief the distilled brief
+ * @param sourceTool human label of where the session came from (e.g. "Claude Code")
+ */
+export function renderBriefMarkdown(brief, sourceTool) {
+    const lines = [];
+    lines.push(`# Session handoff (via Supersession)`);
+    lines.push("");
+    lines.push(`You are picking up a coding session handed off from **${sourceTool}**. ` +
+        `Continue the work below as if it were your own. Do not restart from scratch; ` +
+        `the state described here is real and already on disk.`);
+    lines.push("");
+    lines.push(`## Goal`);
+    lines.push(brief.goal);
+    lines.push("");
+    if (brief.files.length) {
+        lines.push(`## Files touched (verified against the current repo)`);
+        lines.push(...brief.files.map(fileLine));
+        lines.push("");
+    }
+    if (brief.commands.length) {
+        lines.push(`## Key commands run this session`);
+        lines.push(...brief.commands.map((c) => `- \`${c}\``));
+        lines.push("");
+    }
+    if (brief.decisions?.length) {
+        lines.push(`## Decisions made (and why)`);
+        lines.push(...brief.decisions.map((d) => `- ${d}`));
+        lines.push("");
+    }
+    if (brief.deadEnds?.length) {
+        lines.push(`## Dead ends — do NOT retry these`);
+        lines.push(...brief.deadEnds.map((d) => `- ${d}`));
+        lines.push("");
+    }
+    lines.push(`## Where things stand`);
+    lines.push(brief.currentState);
+    lines.push("");
+    lines.push(`## Your next step`);
+    lines.push(brief.nextStep);
+    lines.push("");
+    if (brief.recentTurns.length) {
+        lines.push(`## Recent conversation (verbatim, most recent last)`);
+        lines.push("");
+        lines.push(brief.recentTurns.map(turnBlock).join("\n\n"));
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=brief-markdown.js.map

package/dist/writers/brief-markdown.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@supersession/sup",
+  "version": "0.1.1",
+  "description": "Your AI coding session, superseded — hand it off to any tool and keep going.",
+  "type": "module",
+  "bin": {
+    "sup": "./dist/cli.js",
+    "supersession-mcp": "./dist/mcp.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bench": "tsx bench/harness.ts",
+    "bench:selftest": "tsx bench/harness.ts --selftest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "ai",
+    "claude-code",
+    "codex",
+    "session",
+    "handoff",
+    "context",
+    "cli"
+  ],
+  "license": "MIT"
+}