ctxpool 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ContextPool contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# ContextPool
+
+ContextPool is a local-first context builder for AI-assisted engineering work.
+
+It captures handoff packets from Codex and Claude sessions, preserves repo state and provenance, then lets you drag reusable context blocks into agent-ready prompt packs for Codex, Claude, Cursor, or any MCP-capable tool.
+
+## Why
+
+AI coding sessions often lose the useful parts of prior work: task intent, decisions, constraints, files changed, verification state, blockers, and the next best action. ContextPool keeps that engineering memory local, structured, and reusable.
+
+The wedge is not generic long-term memory. It is provenance-backed engineering continuity:
+
+- Capture what changed, why it changed, what was verified, what failed, and what should happen next.
+- Preserve local-first trust by default.
+- Let users curate exactly which context goes into the next agent prompt.
+- Export sync-ready packets only when the user chooses.
+
+## Features
+
+- Local handoff capture from Codex and Claude JSONL sessions.
+- Git snapshot capture: branch, commit, dirty files, diff stats, patches, and recent commits.
+- Drag-and-drop context pack builder UI.
+- Reusable context blocks for intent, instructions, decisions, constraints, verification, risks, next actions, files, and transcript snippets.
+- Markdown and JSON prompt-pack export.
+- Local SQL.js storage under `~/.ctxpool` by default.
+- MCP tools for agents to read handoffs and curated context packs.
+- Redacted team timeline export with raw transcripts excluded by default.
+
+## Install
+
+Requires Node.js `>=22.5.0`.
+
+```sh
+npm install
+npm run build
+node dist/cli.js init
+```
+
+For a global npm install after publishing:
+
+```sh
+npm install -g ctxpool
+ctxpool init
+```
+
+## Quick Start
+
+Capture a handoff from the current workspace:
+
+```sh
+node dist/cli.js handoff --from codex --no-ollama
+```
+
+Open the local context builder UI:
+
+```sh
+node dist/cli.js ui
+```
+
+Then open:
+
+```text
+http://127.0.0.1:4377
+```
+
+If the default port is busy, `ctxpool ui` tries the next few ports automatically unless a fixed `--port` is provided.
+
+## Context Packs
+
+The UI turns saved handoffs into draggable context blocks. Add the useful blocks to a context pack, reorder them, disable noisy entries, and copy the generated markdown or JSON into another agent.
+
+Raw transcript text is redacted by default in context packs. Enable raw transcript export only when the destination is trusted.
+
+Saved packs stay local in the ContextPool store.
+
+## CLI
+
+```sh
+node dist/cli.js init
+node dist/cli.js handoff --from codex --no-ollama
+node dist/cli.js capture --from claude --task billing-flow
+node dist/cli.js ui
+node dist/cli.js tasks
+node dist/cli.js show latest --task billing-flow
+node dist/cli.js team export --task billing-flow
+node dist/cli.js mcp start
+```
+
+`ctxpool team export` writes a sync-ready JSON packet under the local ContextPool home directory. Raw transcript entries are excluded by default:
+
+```sh
+ctxpool team export --task my-task
+ctxpool team export --task my-task --include-transcript
+```
+
+## MCP Tools
+
+ContextPool exposes local MCP tools for agents:
+
+- `get_latest_handoff`
+- `get_handoff_by_task`
+- `list_tasks`
+- `get_task_status`
+- `get_latest_agent_context`
+- `get_handoff_files`
+- `get_team_timeline_packet`
+- `list_context_packs`
+- `get_context_pack`
+
+`get_team_timeline_packet` returns a sync-ready packet with raw transcripts excluded unless explicitly requested. `get_context_pack` returns a curated prompt pack as markdown by default or JSON when requested.
+
+## Privacy and Security
+
+- ContextPool is local-first. It stores data under `~/.ctxpool` unless `CTXPOOL_HOME` is set.
+- Handoff packets can include repo paths, diffs, transcript excerpts, and command output. Review exports before sharing.
+- Raw transcripts are excluded from team exports by default.
+- Context pack transcript blocks are redacted by default.
+- The UI binds to `127.0.0.1` by default. Avoid binding to public interfaces unless you understand the local-file exposure risk.
+- File preview/open APIs are restricted to repositories already captured in saved handoffs.
+
+Security issues should be reported privately; see `SECURITY.md`.
+
+## Development
+
+```sh
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+Use fixture data for local UI testing:
+
+```sh
+CTXPOOL_HOME=.ctxpool-test node dist/cli.js ui
+```
+
+## Release Checks
+
+Before publishing:
+
+```sh
+npm test
+npm run typecheck
+npm run build
+npm audit --omit=dev
+npm pack --dry-run
+```
+
+Confirm the package contents include only intentional release files and no local stores, databases, logs, transcripts, or secrets.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { Command } from "commander";
+import { copyToClipboard } from "./clipboard.js";
+import { buildTeamTimelineExport, createHandoff } from "./handoff.js";
+import { discoverAgentSignals } from "./logs.js";
+import { ensureCtxDirs } from "./paths.js";
+import { startMcpServer } from "./mcp.js";
+import { openStore } from "./store.js";
+import { startUi } from "./ui.js";
+const program = new Command();
+program
+    .name("ctxpool")
+    .description("Local-first handoff packets for AI coding agents.")
+    .version("0.1.0");
+program.command("init").description("Create the local ContextPool store.").action(async () => {
+    const paths = ensureCtxDirs();
+    if (!existsSync(paths.configPath)) {
+        writeFileSync(paths.configPath, JSON.stringify({
+            version: 1,
+            ui: { host: "127.0.0.1", port: 4377 },
+            ollama: { model: process.env.CTXPOOL_OLLAMA_MODEL || "llama3.1" }
+        }, null, 2));
+    }
+    const store = await openStore();
+    store.close();
+    console.log(`ContextPool initialized at ${paths.home}`);
+});
+program
+    .command("handoff")
+    .description("Capture repo/task state and create a handoff packet.")
+    .option("--task <task>", "Task name. Defaults to git branch or repo name.")
+    .option("--from <agent>", "Source agent to export from: auto, codex, claude.", "auto")
+    .option("--session <id-or-path>", "Specific source session id or JSONL path.")
+    .option("--no-transcript", "Do not include the transcript excerpt in the markdown.")
+    .option("--to <agent>", "Target agent label, e.g. claude, codex, cursor.")
+    .option("--budget <tokens>", "Reserved for future token budgeting.", parseInt)
+    .option("--open", "Start the local observability UI after creating the handoff.")
+    .option("--no-ollama", "Skip optional Ollama enhancement.")
+    .action(async (options) => {
+    ensureCtxDirs();
+    const packet = await createHandoff({
+        task: options.task,
+        from: options.from,
+        session: options.session,
+        includeTranscript: options.transcript,
+        to: options.to,
+        budget: options.budget,
+        useOllama: options.ollama
+    });
+    const store = await openStore();
+    store.saveHandoff(packet);
+    store.close();
+    const copied = copyToClipboard(packet.markdown);
+    printHandoffResult(packet.task, packet.markdownPath, copied, packet.sections.nextBestAction);
+    if (options.open) {
+        await startUi();
+    }
+});
+program
+    .command("ui")
+    .description("Start the local context builder UI.")
+    .option("--host <host>", "Host to bind.", "127.0.0.1")
+    .option("--port <port>", "Port to bind.", (value) => parseInt(value, 10))
+    .action(async (options) => {
+    await startUi(options);
+});
+program
+    .command("capture")
+    .description("Capture current repo/task state without copying to clipboard.")
+    .option("--task <task>", "Task name. Defaults to git branch or repo name.")
+    .option("--from <agent>", "Source agent to export from: auto, codex, claude.", "auto")
+    .option("--session <id-or-path>", "Specific source session id or JSONL path.")
+    .option("--no-transcript", "Do not include the transcript excerpt in the markdown.")
+    .option("--no-ollama", "Skip optional Ollama enhancement.")
+    .action(async (options) => {
+    const packet = await createHandoff({
+        task: options.task,
+        from: options.from,
+        session: options.session,
+        includeTranscript: options.transcript,
+        useOllama: options.ollama
+    });
+    const store = await openStore();
+    store.saveHandoff(packet);
+    store.close();
+    console.log(`Captured ${packet.task}`);
+    console.log(`Saved: ${packet.markdownPath}`);
+});
+const importCommand = program.command("import").description("Inspect local agent logs.");
+importCommand
+    .command("codex")
+    .description("Inspect recent Codex logs.")
+    .option("--path <path>", "Codex sessions directory.")
+    .option("--latest", "Only inspect the latest files.", true)
+    .action((options) => {
+    const signals = discoverAgentSignals({ codexPath: options.path, claudePath: "/__ctxpool_skip_claude__", latest: options.latest });
+    printSignals(signals);
+});
+importCommand
+    .command("claude")
+    .description("Inspect recent Claude Code logs.")
+    .option("--path <path>", "Claude projects directory.")
+    .option("--latest", "Only inspect the latest files.", true)
+    .action((options) => {
+    const signals = discoverAgentSignals({ codexPath: "/__ctxpool_skip_codex__", claudePath: options.path, latest: options.latest });
+    printSignals(signals);
+});
+program.command("tasks").description("List known handoff tasks.").action(async () => {
+    const store = await openStore();
+    try {
+        const tasks = store.listTasks();
+        if (tasks.length === 0) {
+            console.log("No handoff tasks found. Run `ctxpool handoff` first.");
+            return;
+        }
+        for (const task of tasks) {
+            console.log(`${task.task}\t${task.handoffCount} handoff(s)\tlatest ${task.latestAt}`);
+        }
+    }
+    finally {
+        store.close();
+    }
+});
+program.command("status").description("Show local ContextPool status.").action(async () => {
+    const store = await openStore();
+    try {
+        const status = store.getStatus();
+        console.log(`Home: ${status.home}`);
+        console.log(`Database: ${status.dbPath}`);
+        console.log(`Team exports: ${status.teamExportsDir}`);
+        console.log(`Tasks: ${status.taskCount}`);
+        console.log(`Handoffs: ${status.handoffCount}`);
+    }
+    finally {
+        store.close();
+    }
+});
+const show = program.command("show").description("Show saved handoffs.");
+show.command("latest").description("Print the latest handoff packet.").option("--task <task>", "Task name.").action(async (options) => {
+    const store = await openStore();
+    try {
+        const handoff = store.getLatestHandoff(options.task);
+        if (!handoff) {
+            console.error("No handoff found. Run `ctxpool handoff` first.");
+            process.exitCode = 1;
+            return;
+        }
+        console.log(handoff.markdown);
+    }
+    finally {
+        store.close();
+    }
+});
+const team = program.command("team").description("Prepare local handoffs for a future ContextPool Team Timeline.");
+team
+    .command("export")
+    .description("Export the latest handoff as a redacted, sync-ready team timeline packet.")
+    .option("--task <task>", "Task name.")
+    .option("--out <path>", "Output JSON path.")
+    .option("--include-transcript", "Include raw transcript entries in the export.", false)
+    .action(async (options) => {
+    const paths = ensureCtxDirs();
+    const store = await openStore();
+    try {
+        const handoff = store.getLatestHandoff(options.task);
+        if (!handoff) {
+            console.error("No handoff found. Run `ctxpool handoff` first.");
+            process.exitCode = 1;
+            return;
+        }
+        const exported = buildTeamTimelineExport(handoff, { includeRawTranscript: options.includeTranscript });
+        const outPath = options.out || join(paths.teamExportsDir, exported.task, `${exported.id}.json`);
+        mkdirSync(dirname(outPath), { recursive: true });
+        writeFileSync(outPath, JSON.stringify(exported, null, 2), "utf8");
+        console.log("ContextPool team timeline export created");
+        console.log("");
+        console.log(`Task: ${exported.task}`);
+        console.log(`Saved: ${outPath}`);
+        console.log(`Raw transcript: ${exported.engineeringMemory?.teamSync.rawTranscript || "excluded"}`);
+        console.log(`Sync mode: ${exported.engineeringMemory?.teamSync.mode || "sync-ready"}`);
+    }
+    finally {
+        store.close();
+    }
+});
+const mcp = program.command("mcp").description("Run the ContextPool MCP server.");
+mcp.command("start").description("Start the stdio MCP server.").action(async () => {
+    await startMcpServer();
+});
+program.parseAsync(process.argv).catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+function printHandoffResult(task, markdownPath, copied, nextBestAction) {
+    console.log("ContextPool handoff created");
+    console.log("");
+    console.log(`Task: ${task}`);
+    console.log(`Copied: ${copied ? "yes" : "no"}`);
+    console.log(`Saved: ${markdownPath}`);
+    console.log("");
+    console.log("Next best action:");
+    console.log(nextBestAction);
+}
+function printSignals(signals) {
+    if (signals.length === 0) {
+        console.log("No relevant agent log signals found.");
+        return;
+    }
+    for (const signal of signals) {
+        console.log(`${signal.source}: ${signal.path}`);
+        for (const snippet of signal.snippets.slice(0, 8))
+            console.log(`  - ${snippet}`);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/clipboard.d.ts

@@ -0,0 +1 @@
+export declare function copyToClipboard(text: string): boolean;

package/dist/clipboard.js

@@ -0,0 +1,18 @@
+import { spawnSync } from "node:child_process";
+export function copyToClipboard(text) {
+    const platform = process.platform;
+    if (platform === "darwin")
+        return pipe("pbcopy", [], text);
+    if (platform === "win32")
+        return pipe("clip", [], text);
+    return pipe("wl-copy", [], text) || pipe("xclip", ["-selection", "clipboard"], text) || pipe("xsel", ["--clipboard", "--input"], text);
+}
+function pipe(command, args, input) {
+    const result = spawnSync(command, args, {
+        input,
+        encoding: "utf8",
+        stdio: ["pipe", "ignore", "ignore"]
+    });
+    return result.status === 0;
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;AACzI,CAAC;AAED,SAAS,IAAI,CAAC,OAAe,EAAE,IAAc,EAAE,KAAa;IAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,KAAK;QACL,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;KACpC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/handoff.d.ts

@@ -0,0 +1,36 @@
+import type { AgentSignal, ContextBlock, ContextPack, ContextPackOutput, EngineeringMemory, GitSnapshot, HandoffContinuitySummary, HandoffPacket, HandoffSections, SourceSession } from "./types.js";
+import { type SessionFrom } from "./session.js";
+export type CreateHandoffOptions = {
+    cwd?: string;
+    task?: string;
+    to?: string;
+    from?: SessionFrom;
+    session?: string;
+    includeTranscript?: boolean;
+    budget?: number;
+    useOllama?: boolean;
+};
+export declare function createHandoff(options?: CreateHandoffOptions): Promise<HandoffPacket>;
+export declare function buildSections(task: string, filesTouched: string[], diffStat: string, sourceSessionOrSources: SourceSession | AgentSignal[]): HandoffSections;
+export declare function renderHandoffMarkdown(packet: Omit<HandoffPacket, "markdownPath"> & {
+    markdownPath: string;
+}, includeTranscript?: boolean): string;
+export declare function normalizeHandoffPacket(packet: HandoffPacket): HandoffPacket;
+export declare function buildHandoffSummary(task: string, repo: GitSnapshot, sourceSession: SourceSession | undefined, sections: HandoffSections): HandoffContinuitySummary;
+export declare function renderAgentContextMarkdown(packet: HandoffPacket): string;
+export declare function buildAgentContext(packet: HandoffPacket): {
+    markdown: string;
+    summary: HandoffContinuitySummary;
+    engineeringMemory: EngineeringMemory;
+    packet: HandoffPacket;
+};
+export declare function deriveContextBlocks(packet: HandoffPacket): ContextBlock[];
+export declare function createContextPack(name: string, blocks?: ContextBlock[], options?: {
+    includeRawTranscript?: boolean;
+}): ContextPack;
+export declare function renderContextPackOutput(pack: ContextPack): ContextPackOutput;
+export declare function normalizeContextPack(pack: ContextPack): ContextPack;
+export declare function buildTeamTimelineExport(packet: HandoffPacket, options?: {
+    includeRawTranscript?: boolean;
+}): HandoffPacket;
+export declare function buildEngineeringMemory(task: string, repo: GitSnapshot, sourceSession: SourceSession | undefined, handoffId: string, summary: HandoffContinuitySummary): EngineeringMemory;