@furkankoykiran/contextify-cli 0.4.0

package/dist/shipper.d.ts

@@ -0,0 +1,49 @@
+import { type ResolvedCredentials } from './credentials.js';
+export interface Batch {
+    readonly projectId: string;
+    readonly projectName?: string;
+    readonly sessionId: string;
+    readonly payload: string;
+    /**
+     * Origin discriminator. Omitted by the legacy wrap path; the API
+     * defaults missing values to 'terminal' so old callers keep working.
+     */
+    readonly source?: 'terminal' | 'claude-code';
+}
+export interface ShipOptions {
+    readonly serverUrl: string;
+    readonly cwd: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly timeoutMs?: number;
+    /** When true, skip the network attempt entirely and spool. Useful for tests. */
+    readonly forceSpool?: boolean;
+    /**
+     * Optional explicit credentials. Defaults to resolving via env then
+     * `~/.contextify/credentials.json`. When null, the request goes
+     * unauthenticated (server falls back to LEGACY_TENANT_ID in dev).
+     * Tests can override this to assert the auth header is present.
+     */
+    readonly credentials?: ResolvedCredentials | null;
+}
+export interface ShipResult {
+    readonly status: 'sent' | 'spooled' | 'error';
+    readonly statusCode?: number;
+    readonly spoolPath?: string;
+    readonly error?: string;
+}
+export declare const SPOOL_DIR = ".contextify/spool";
+export declare function shipBatch(batch: Batch, opts: ShipOptions): Promise<ShipResult>;
+export declare function spoolBatch(batch: Batch, cwd: string, reason: string): Promise<ShipResult>;
+export interface FlushOptions {
+    readonly serverUrl: string;
+    readonly cwd: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly timeoutMs?: number;
+}
+export interface FlushResult {
+    readonly attempted: number;
+    readonly sent: number;
+    readonly remaining: number;
+}
+export declare function flushSpool(opts: FlushOptions): Promise<FlushResult>;
+//# sourceMappingURL=shipper.d.ts.map

package/dist/shipper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipper.d.ts","sourceRoot":"","sources":["../src/shipper.ts"],"names":[],"mappings":"AAeA,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,SAAS,sBAAsB,CAAC;AAE7C,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqCpF;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAc/F;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAiCzE"}

package/dist/shipper.js

@@ -0,0 +1,110 @@
+/**
+ * Webhook shipper with disk-spool fallback.
+ *
+ * The shipper takes a batch envelope and POSTs it gzip-compressed to the
+ * server's /api/telemetry/ingest endpoint. If the server is unreachable
+ * or returns a non-2xx, the batch is written to `<cwd>/.contextify/spool/`
+ * so a later `contextify ship --once` can flush it.
+ *
+ * The CLI must never block the user's terminal — so all error handling
+ * is silent (logs go to stderr only with --verbose, not implemented yet).
+ */
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { gzipSync } from 'node:zlib';
+import { resolveApiKey } from './credentials.js';
+export const SPOOL_DIR = '.contextify/spool';
+export async function shipBatch(batch, opts) {
+    if (opts.forceSpool) {
+        return spoolBatch(batch, opts.cwd, 'forceSpool');
+    }
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const url = new URL('/api/telemetry/ingest', opts.serverUrl).toString();
+    const body = gzipSync(Buffer.from(JSON.stringify(batch), 'utf8'));
+    const ctrl = new AbortController();
+    const timeout = setTimeout(() => ctrl.abort(), opts.timeoutMs ?? 10_000);
+    try {
+        // Resolve credentials lazily so call sites can inject test fixtures
+        // via `opts.credentials`. `undefined` triggers the default lookup;
+        // `null` means "send no Authorization header" (explicit unauth).
+        const creds = opts.credentials === undefined ? resolveApiKey() : opts.credentials;
+        const headers = {
+            'content-type': 'application/json',
+            'content-encoding': 'gzip',
+        };
+        if (creds) {
+            headers.authorization = `Bearer ${creds.apiKey}`;
+        }
+        const res = await fetchImpl(url, {
+            method: 'POST',
+            headers,
+            body,
+            signal: ctrl.signal,
+        });
+        if (!res.ok) {
+            return spoolBatch(batch, opts.cwd, `HTTP ${res.status}`);
+        }
+        return { status: 'sent', statusCode: res.status };
+    }
+    catch (err) {
+        return spoolBatch(batch, opts.cwd, err.message);
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export async function spoolBatch(batch, cwd, reason) {
+    try {
+        const dir = join(cwd, SPOOL_DIR);
+        if (!existsSync(dir))
+            await mkdir(dir, { recursive: true });
+        const stamp = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const tmp = join(dir, `${stamp}.json.gz.tmp`);
+        const final = join(dir, `${stamp}.json.gz`);
+        const body = gzipSync(Buffer.from(JSON.stringify(batch), 'utf8'));
+        await writeFile(tmp, body);
+        await rename(tmp, final);
+        return { status: 'spooled', spoolPath: final, error: reason };
+    }
+    catch (err) {
+        return { status: 'error', error: err.message };
+    }
+}
+export async function flushSpool(opts) {
+    const dir = join(opts.cwd, SPOOL_DIR);
+    if (!existsSync(dir))
+        return { attempted: 0, sent: 0, remaining: 0 };
+    const files = (await readdir(dir)).filter((f) => f.endsWith('.json.gz'));
+    let sent = 0;
+    for (const file of files) {
+        const full = join(dir, file);
+        const raw = await readFile(full);
+        let batch;
+        try {
+            // The spool stores gzipped JSON. We could re-ship the raw gzip body
+            // directly but that complicates the request — decompress and let
+            // shipBatch re-compress so the wire shape stays consistent.
+            const { gunzipSync } = await import('node:zlib');
+            batch = JSON.parse(gunzipSync(raw).toString('utf8'));
+        }
+        catch {
+            // Corrupt spool entry — drop it so we don't loop forever.
+            await unlink(full).catch(() => { });
+            continue;
+        }
+        const result = await shipBatch(batch, {
+            serverUrl: opts.serverUrl,
+            cwd: opts.cwd,
+            fetchImpl: opts.fetchImpl,
+            timeoutMs: opts.timeoutMs,
+        });
+        if (result.status === 'sent') {
+            await unlink(full).catch(() => { });
+            sent += 1;
+        }
+    }
+    const remaining = (await readdir(dir)).filter((f) => f.endsWith('.json.gz')).length;
+    return { attempted: files.length, sent, remaining };
+}
+//# sourceMappingURL=shipper.js.map

package/dist/shipper.js.map

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

package/dist/transcript.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Transcript parser.
+ *
+ * Reads a Claude Code session JSONL (one JSON object per line) and extracts
+ * the most recent completed user → assistant turn, including:
+ *   - the user's text prompt
+ *   - the assistant's final text response
+ *   - the sequence of *actions* the assistant executed between them
+ *     (Bash commands, file Writes/Edits/MultiEdits, WebFetches)
+ *
+ * Read-only tool calls (Read, Grep, Glob, LS, etc.) are dropped — they're
+ * introspection, not durable insight, and they explode payload size for no
+ * extraction value. tool_result blocks are likewise dropped (the *action*
+ * is what's durable; the output is noise the LLM doesn't need).
+ *
+ * Pure with respect to I/O: takes the raw JSONL text, returns a turn or null.
+ */
+/** Kinds of actions worth shipping to the worker. */
+export type ActionKind = 'bash' | 'write' | 'edit' | 'multiedit' | 'webfetch';
+export interface DialogAction {
+    readonly kind: ActionKind;
+    /** Single-line summary of the action (command string, file path, URL, etc.). */
+    readonly detail: string;
+}
+export interface DialogTurn {
+    readonly userText: string;
+    readonly assistantText: string;
+    readonly actions: ReadonlyArray<DialogAction>;
+    readonly userAt: string | null;
+    readonly assistantAt: string | null;
+    readonly cwd: string | null;
+    readonly transcriptUuid: string;
+}
+export interface ParseOptions {
+    /** Cap the assistant text at this many chars (head+tail). */
+    readonly maxAssistantChars?: number;
+    /** Cap the actions array length. Default 50. */
+    readonly maxActions?: number;
+}
+/**
+ * Find the latest completed user → assistant text turn in the transcript.
+ *
+ * Strategy:
+ *   1. Walk lines in order, indexing every text-bearing user message.
+ *   2. Track the latest assistant message that contains text.
+ *   3. Pair the latest-assistant with the closest preceding user-text.
+ *   4. Collect every action (Bash / Write / Edit / MultiEdit / WebFetch)
+ *      from every line *between* those two anchors (inclusive of the
+ *      assistant message's own tool_use blocks).
+ */
+export declare function parseLatestTurn(jsonl: string, options?: ParseOptions): DialogTurn | null;
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAmGD,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,UAAU,GAAG,IAAI,CAgG5F"}

package/dist/transcript.js

@@ -0,0 +1,216 @@
+/**
+ * Transcript parser.
+ *
+ * Reads a Claude Code session JSONL (one JSON object per line) and extracts
+ * the most recent completed user → assistant turn, including:
+ *   - the user's text prompt
+ *   - the assistant's final text response
+ *   - the sequence of *actions* the assistant executed between them
+ *     (Bash commands, file Writes/Edits/MultiEdits, WebFetches)
+ *
+ * Read-only tool calls (Read, Grep, Glob, LS, etc.) are dropped — they're
+ * introspection, not durable insight, and they explode payload size for no
+ * extraction value. tool_result blocks are likewise dropped (the *action*
+ * is what's durable; the output is noise the LLM doesn't need).
+ *
+ * Pure with respect to I/O: takes the raw JSONL text, returns a turn or null.
+ */
+/** Concatenate all `type:text` blocks; ignore tool_use/tool_result/etc. */
+function extractText(message) {
+    if (!message)
+        return '';
+    const c = message.content;
+    if (typeof c === 'string')
+        return c;
+    if (!Array.isArray(c))
+        return '';
+    const parts = [];
+    for (const block of c) {
+        if (!block || typeof block !== 'object')
+            continue;
+        const b = block;
+        if (b.type === 'text' && typeof b.text === 'string' && b.text.trim().length > 0) {
+            parts.push(b.text);
+        }
+    }
+    return parts.join('\n\n');
+}
+const MAX_DETAIL_CHARS = 400;
+/**
+ * Map a tool_use block to a DialogAction, or null if it's a read-only
+ * inspection tool we want to drop on the floor.
+ */
+function classifyToolUse(block) {
+    const name = typeof block.name === 'string' ? block.name : '';
+    const input = (block.input ?? {});
+    switch (name) {
+        case 'Bash': {
+            const cmd = typeof input.command === 'string' ? input.command : '';
+            if (cmd.trim().length === 0)
+                return null;
+            return { kind: 'bash', detail: truncateDetail(cmd) };
+        }
+        case 'Write': {
+            const fp = typeof input.file_path === 'string' ? input.file_path : '';
+            if (!fp)
+                return null;
+            return { kind: 'write', detail: truncateDetail(fp) };
+        }
+        case 'Edit': {
+            const fp = typeof input.file_path === 'string' ? input.file_path : '';
+            if (!fp)
+                return null;
+            return { kind: 'edit', detail: truncateDetail(fp) };
+        }
+        case 'MultiEdit': {
+            const fp = typeof input.file_path === 'string' ? input.file_path : '';
+            if (!fp)
+                return null;
+            return { kind: 'multiedit', detail: truncateDetail(fp) };
+        }
+        case 'WebFetch': {
+            const url = typeof input.url === 'string' ? input.url : '';
+            if (!url)
+                return null;
+            return { kind: 'webfetch', detail: truncateDetail(url) };
+        }
+        // Read-only inspections (Read, Grep, Glob, LS, NotebookRead, etc.) are
+        // skipped intentionally — high frequency, low signal.
+        default:
+            return null;
+    }
+}
+function truncateDetail(text) {
+    if (text.length <= MAX_DETAIL_CHARS)
+        return text;
+    return `${text.slice(0, MAX_DETAIL_CHARS - 3)}...`;
+}
+/** Collect tool_use actions from a single message body. */
+function extractActions(message) {
+    if (!message)
+        return [];
+    const c = message.content;
+    if (!Array.isArray(c))
+        return [];
+    const out = [];
+    for (const block of c) {
+        if (!block || typeof block !== 'object')
+            continue;
+        const b = block;
+        if (b.type !== 'tool_use')
+            continue;
+        const action = classifyToolUse(b);
+        if (action)
+            out.push(action);
+    }
+    return out;
+}
+const DEFAULT_ASSISTANT_CAP = 50_000;
+const DEFAULT_ACTIONS_CAP = 50;
+/**
+ * Find the latest completed user → assistant text turn in the transcript.
+ *
+ * Strategy:
+ *   1. Walk lines in order, indexing every text-bearing user message.
+ *   2. Track the latest assistant message that contains text.
+ *   3. Pair the latest-assistant with the closest preceding user-text.
+ *   4. Collect every action (Bash / Write / Edit / MultiEdit / WebFetch)
+ *      from every line *between* those two anchors (inclusive of the
+ *      assistant message's own tool_use blocks).
+ */
+export function parseLatestTurn(jsonl, options = {}) {
+    const cap = options.maxAssistantChars ?? DEFAULT_ASSISTANT_CAP;
+    const actionsCap = options.maxActions ?? DEFAULT_ACTIONS_CAP;
+    const lines = jsonl.split(/\r?\n/);
+    const userTextAt = [];
+    let latestAssistant = null;
+    // First pass: find the turn anchors.
+    const parsedLines = new Array(lines.length).fill(null);
+    for (let index = 0; index < lines.length; index += 1) {
+        const raw = lines[index];
+        if (!raw)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        if (!parsed || typeof parsed !== 'object')
+            continue;
+        parsedLines[index] = parsed;
+        const role = parsed.message?.role;
+        if (parsed.type === 'user' && role === 'user') {
+            const text = extractText(parsed.message);
+            if (text.trim().length > 0) {
+                userTextAt.push({ index, user: { text, ts: parsed.timestamp ?? null } });
+            }
+            continue;
+        }
+        if (parsed.type === 'assistant' && role === 'assistant') {
+            const text = extractText(parsed.message);
+            if (text.trim().length === 0)
+                continue;
+            const uuid = typeof parsed.uuid === 'string' ? parsed.uuid : '';
+            if (!uuid)
+                continue;
+            latestAssistant = {
+                uuid,
+                text,
+                ts: parsed.timestamp ?? null,
+                cwd: typeof parsed.cwd === 'string' ? parsed.cwd : null,
+                index,
+            };
+        }
+    }
+    if (!latestAssistant)
+        return null;
+    const finalAssistant = latestAssistant;
+    // Find the closest preceding user-text by file order.
+    let pairedUser = null;
+    let pairedUserIndex = -1;
+    for (let i = userTextAt.length - 1; i >= 0; i -= 1) {
+        if (userTextAt[i].index < finalAssistant.index) {
+            pairedUser = userTextAt[i].user;
+            pairedUserIndex = userTextAt[i].index;
+            break;
+        }
+    }
+    if (!pairedUser)
+        return null;
+    // Second pass: collect actions in the [pairedUserIndex+1, finalAssistant.index] window.
+    // We include the assistant line itself because tool_use can live alongside text
+    // in the same assistant message.
+    const actions = [];
+    for (let i = pairedUserIndex + 1; i <= finalAssistant.index; i += 1) {
+        const parsed = parsedLines[i];
+        if (!parsed)
+            continue;
+        if (parsed.message?.role !== 'assistant')
+            continue;
+        for (const action of extractActions(parsed.message)) {
+            if (actions.length >= actionsCap)
+                break;
+            actions.push(action);
+        }
+        if (actions.length >= actionsCap)
+            break;
+    }
+    return {
+        userText: pairedUser.text,
+        assistantText: truncate(finalAssistant.text, cap),
+        actions,
+        userAt: pairedUser.ts,
+        assistantAt: finalAssistant.ts,
+        cwd: finalAssistant.cwd,
+        transcriptUuid: finalAssistant.uuid,
+    };
+}
+function truncate(text, cap) {
+    if (text.length <= cap)
+        return text;
+    const half = Math.floor((cap - 64) / 2);
+    return `${text.slice(0, half)}\n... [truncated ${text.length - cap} chars] ...\n${text.slice(-half)}`;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@furkankoykiran/contextify-cli",
+  "version": "0.4.0",
+  "description": "Contextify telemetry CLI — shadows terminal sessions, ships logs to the webhook",
+  "homepage": "https://contextify.live",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "contextify": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/commands/hooks.d.ts",
+      "import": "./dist/commands/hooks.js"
+    },
+    "./transcript": {
+      "types": "./dist/transcript.d.ts",
+      "import": "./dist/transcript.js"
+    },
+    "./identity": {
+      "types": "./dist/identity.d.ts",
+      "import": "./dist/identity.js"
+    },
+    "./install-hooks": {
+      "types": "./dist/commands/install-hooks.d.ts",
+      "import": "./dist/commands/install-hooks.js"
+    },
+    "./install": {
+      "types": "./dist/commands/install.d.ts",
+      "import": "./dist/commands/install.js"
+    },
+    "./prompt": {
+      "types": "./dist/commands/prompt.d.ts",
+      "import": "./dist/commands/prompt.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/hooks"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
+    "start": "node ./dist/index.js",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo",
+    "lint": "eslint src --max-warnings=0",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@contextify/eslint-config": "workspace:*",
+    "@contextify/tsconfig": "workspace:*",
+    "@types/node": "20.14.10",
+    "@typescript-eslint/eslint-plugin": "8.18.2",
+    "@typescript-eslint/parser": "8.18.2",
+    "eslint": "8.57.1",
+    "eslint-config-prettier": "9.1.0",
+    "typescript": "5.5.4",
+    "vitest": "2.1.8"
+  }
+}

package/src/hooks/session-end.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Contextify hook — SessionEnd.
+# Pipes the Claude Code hook stdin into `contextify hooks session-end`.
+# Silent on success, never blocks.
+exec contextify hooks session-end

package/src/hooks/session-start.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Contextify hook — SessionStart.
+# Pipes the Claude Code hook stdin into `contextify hooks session-start`.
+# Silent on success, never blocks.
+exec contextify hooks session-start

package/src/hooks/stop.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Contextify hook — Stop.
+# Pipes the Claude Code hook stdin into `contextify hooks stop`.
+# Silent on success, never blocks.
+exec contextify hooks stop