ctxjev-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x96x64
+
+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,22 @@
+# ctxjev-cli
+
+Analyze an AI agent transcript and see what [Jev](https://typesafe.ai) would keep, drop, or
+summarize — plain-text report or `--json`.
+
+```bash
+npm install -g ctxjev-cli
+export TYPESAFE_API_KEY=...   # console.typesafe.ai/settings/keys — no waitlist
+
+ctxjev analyze transcript.jsonl --goal "Fix the checkout double-charge bug."
+```
+
+Accepts two formats, auto-detected: ctxjev's own `{ goal?, entries }` JSON, or a real Claude Code
+session `.jsonl` transcript (goal inferred from your most recent chat message unless `--goal`
+overrides it).
+
+Full docs, design notes, and example transcripts live in the main repo:
+**[github.com/x96x64/ctxjev](https://github.com/x96x64/ctxjev)**.
+
+## License
+
+MIT

package/dist/cost.d.ts

@@ -0,0 +1,2 @@
+import type { JevUsage } from 'ctxjev-core';
+export declare function estimateCostUsd(usage: JevUsage): number;

package/dist/cost.js

@@ -0,0 +1,6 @@
+/** Jev's published pricing: $0.042 per million input tokens, output free. */
+const USD_PER_MILLION_INPUT_TOKENS = 0.042;
+export function estimateCostUsd(usage) {
+    return (usage.inputTokens / 1_000_000) * USD_PER_MILLION_INPUT_TOKENS;
+}
+//# sourceMappingURL=cost.js.map

package/dist/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../src/cost.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,4BAA4B,GAAG,KAAK,CAAA;AAE1C,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,4BAA4B,CAAA;AACvE,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import { parseArgs } from 'node:util';
+import pc from 'picocolors';
+import { DEFAULT_POLICY, pruneContext, summarizeSavings } from 'ctxjev-core';
+import { formatReport } from './report.js';
+import { parseTranscript } from './transcript.js';
+const VERSION = '0.0.0';
+const HELP = `${pc.bold('ctxjev')} — score and prune AI agent context with Jev
+
+${pc.bold('Usage')}
+  ctxjev analyze <transcript> --goal "<current task>" [options]
+
+${pc.bold('Options')}
+  --goal <text>              Overrides the transcript's own goal (or the inferred one), if any.
+  --drop-below <0-1>         Relevance floor below which an entry is dropped.      (default ${DEFAULT_POLICY.dropBelow})
+  --summarize-below <0-1>    Relevance floor below which an entry is summarized.   (default ${DEFAULT_POLICY.summarizeBelow})
+  --json                     Print machine-readable JSON instead of the report.
+  --help                     Show this help.
+  --version                  Print the installed version.
+
+${pc.bold('Transcript formats (auto-detected)')}
+  ctxjev's own:  { "goal": "...", "entries": [{ "id", "role", "toolName"?, "content", "timestamp" }] }
+  Claude Code:   a real session .jsonl (transcript_path, or ~/.claude/projects/*/*.jsonl) — the
+                 goal is inferred from your most recent chat message unless --goal overrides it.
+  See examples/sample-transcripts in the ctxjev repo for one of each.
+`;
+function fail(message) {
+    console.error(`${pc.red('✖')} ${message}`);
+    process.exit(1);
+}
+async function runAnalyze(argv) {
+    const { positionals, values } = parseArgs({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            goal: { type: 'string' },
+            'drop-below': { type: 'string' },
+            'summarize-below': { type: 'string' },
+            json: { type: 'boolean', default: false },
+        },
+    });
+    const [file] = positionals;
+    if (!file)
+        fail('missing <transcript.json> — see `ctxjev --help`');
+    if (!process.env.TYPESAFE_API_KEY) {
+        fail('TYPESAFE_API_KEY is not set — get one at console.typesafe.ai/settings/keys');
+    }
+    let raw;
+    try {
+        raw = await readFile(file, 'utf8');
+    }
+    catch {
+        fail(`couldn't read ${file}`);
+    }
+    const transcript = parseTranscript(raw);
+    const goal = values.goal ?? transcript.goal;
+    if (!goal)
+        fail('no goal — pass --goal or set "goal" in the transcript file');
+    const policy = {
+        dropBelow: values['drop-below'] ? Number(values['drop-below']) : DEFAULT_POLICY.dropBelow,
+        summarizeBelow: values['summarize-below'] ? Number(values['summarize-below']) : DEFAULT_POLICY.summarizeBelow,
+        recencyWeight: DEFAULT_POLICY.recencyWeight,
+    };
+    const usage = { inputTokens: 0, outputTokens: 0 };
+    const decisions = await pruneContext(transcript.entries, goal, policy, {
+        onUsage: (chunkUsage) => {
+            usage.inputTokens += chunkUsage.inputTokens;
+            usage.outputTokens += chunkUsage.outputTokens;
+        },
+    });
+    const savings = summarizeSavings(transcript.entries, decisions);
+    if (values.json) {
+        console.log(JSON.stringify({ decisions, savings, usage }, null, 2));
+        return;
+    }
+    console.log(formatReport(transcript.entries, decisions, savings, usage));
+}
+async function main() {
+    const [command, ...rest] = process.argv.slice(2);
+    if (!command || command === '--help' || command === '-h') {
+        console.log(HELP);
+        return;
+    }
+    if (command === '--version' || command === '-v') {
+        console.log(VERSION);
+        return;
+    }
+    if (command === 'analyze') {
+        await runAnalyze(rest);
+        return;
+    }
+    fail(`unknown command "${command}" — see \`ctxjev --help\``);
+}
+main().catch((err) => {
+    fail(err instanceof Error ? err.message : String(err));
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,2 @@
+import type { Entry, JevUsage, PruneDecision, SavingsReport } from 'ctxjev-core';
+export declare function formatReport(entries: Entry[], decisions: PruneDecision[], savings: SavingsReport, usage: JevUsage): string;

package/dist/report.js

@@ -0,0 +1,39 @@
+import pc from 'picocolors';
+import { estimateCostUsd } from './cost.js';
+const ACTION_COLOR = {
+    keep: pc.green,
+    summarize: pc.yellow,
+    drop: pc.red,
+};
+const ACTION_WIDTH = Math.max(...Object.keys(ACTION_COLOR).map((a) => a.length));
+function truncate(text, max = 60) {
+    const oneLine = text.replace(/\s+/g, ' ').trim();
+    return oneLine.length > max ? `${oneLine.slice(0, max - 1)}…` : oneLine;
+}
+export function formatReport(entries, decisions, savings, usage) {
+    const decisionByEntryId = new Map(decisions.map((d) => [d.entryId, d]));
+    const lines = [];
+    const idWidth = Math.max(2, ...entries.map((e) => e.id.length));
+    const roleWidth = Math.max(4, ...entries.map((e) => (e.toolName ?? e.role).length));
+    for (const entry of entries) {
+        const decision = decisionByEntryId.get(entry.id);
+        if (!decision)
+            continue;
+        const id = entry.id.padEnd(idWidth);
+        const role = (entry.toolName ?? entry.role).padEnd(roleWidth);
+        const score = decision.combinedScore.toFixed(2);
+        const action = ACTION_COLOR[decision.action](decision.action.padEnd(ACTION_WIDTH));
+        lines.push(`  ${pc.dim(id)}  ${role}  ${action}  ${pc.dim(`score ${score}`)}  ${truncate(entry.content)}`);
+    }
+    lines.push('');
+    lines.push(`${pc.bold(String(savings.keptEntries))} kept, ` +
+        `${pc.bold(String(savings.summarizedEntries))} summarized, ` +
+        `${pc.bold(String(savings.droppedEntries))} dropped ` +
+        `${pc.dim(`(of ${savings.totalEntries} entries)`)}`);
+    const savedPct = savings.totalTokens === 0 ? 0 : Math.round((savings.savedTokens / savings.totalTokens) * 100);
+    lines.push(pc.dim(`~${savings.savedTokens.toLocaleString()} / ${savings.totalTokens.toLocaleString()} tokens saved (${savedPct}%)`));
+    const costUsd = estimateCostUsd(usage);
+    lines.push(pc.dim(`Jev cost: ${usage.inputTokens.toLocaleString()} input tokens, ${usage.outputTokens.toLocaleString()} output tokens (free) — ~$${costUsd.toFixed(6)}`));
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/transcript.d.ts

@@ -0,0 +1,15 @@
+import { type Entry } from 'ctxjev-core';
+export type TranscriptFile = {
+    /** Optional — omit to require --goal on the command line instead. */
+    goal?: string;
+    entries: Entry[];
+};
+/**
+ * Accepts two formats, auto-detected: ctxjev's own `{ goal?, entries }` (a single JSON document
+ * — see examples/sample-transcripts) or a real Claude Code session transcript (`.jsonl`, one
+ * record per line, from `transcript_path` or `~/.claude/projects/*​/*.jsonl`). ctxjev's own format
+ * parses as one JSON value across the whole file; a `.jsonl` file does not (multiple top-level
+ * values, one per line), so a `JSON.parse` failure is what triggers the Claude Code path rather
+ * than needing a file extension or an explicit flag.
+ */
+export declare function parseTranscript(raw: string): TranscriptFile;

package/dist/transcript.js

@@ -0,0 +1,40 @@
+import { inferGoalFromEntries, parseClaudeCodeTranscript } from 'ctxjev-core';
+/**
+ * Accepts two formats, auto-detected: ctxjev's own `{ goal?, entries }` (a single JSON document
+ * — see examples/sample-transcripts) or a real Claude Code session transcript (`.jsonl`, one
+ * record per line, from `transcript_path` or `~/.claude/projects/*​/*.jsonl`). ctxjev's own format
+ * parses as one JSON value across the whole file; a `.jsonl` file does not (multiple top-level
+ * values, one per line), so a `JSON.parse` failure is what triggers the Claude Code path rather
+ * than needing a file extension or an explicit flag.
+ */
+export function parseTranscript(raw) {
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(raw);
+    }
+    catch {
+        // Not a single JSON document at all — most likely a Claude Code .jsonl transcript instead.
+        // A genuinely malformed ctxjev-format file (valid JSON, wrong shape) never reaches this
+        // branch; parseCtxjevFormat below throws its own specific error for that case.
+        const entries = parseClaudeCodeTranscript(raw);
+        if (entries.length === 0) {
+            throw new Error('could not parse this file as either a ctxjev transcript (a single JSON document with an "entries" array) or a Claude Code session .jsonl');
+        }
+        return { goal: inferGoalFromEntries(entries), entries };
+    }
+    return parseCtxjevFormat(parsedJson);
+}
+function parseCtxjevFormat(parsed) {
+    if (typeof parsed !== 'object' || parsed === null || !('entries' in parsed)) {
+        throw new Error('transcript file must be a JSON object with an "entries" array — see examples/sample-transcripts');
+    }
+    const { entries, goal } = parsed;
+    if (!Array.isArray(entries)) {
+        throw new Error('"entries" must be an array');
+    }
+    if (goal !== undefined && typeof goal !== 'string') {
+        throw new Error('"goal" must be a string when present');
+    }
+    return { goal, entries: entries };
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAc,MAAM,aAAa,CAAA;AAQzF;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,UAAmB,CAAA;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,2FAA2F;QAC3F,wFAAwF;QACxF,+EAA+E;QAC/E,MAAM,OAAO,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAA;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,0IAA0I,CAC3I,CAAA;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACzD,CAAC;IAED,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAA;AACtC,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAe;IACxC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,iGAAiG,CAAC,CAAA;IACpH,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAA8C,CAAA;IAExE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAkB,EAAE,CAAA;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "ctxjev-cli",
+  "version": "0.1.0",
+  "description": "CLI for ctxjev — analyze an agent transcript and report what Jev would keep, drop, or summarize.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x96x64/ctxjev.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/x96x64/ctxjev/tree/main/packages/cli#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "ctxjev": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "picocolors": "^1.1.1",
+    "ctxjev-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run"
+  }
+}