@furkankoykiran/contextify-cli 0.4.0

package/dist/commands/install-hooks.js

@@ -0,0 +1,162 @@
+/**
+ * `contextify init --install-hooks` implementation.
+ *
+ * 1. Materialize the three hook scripts into <state>/hooks/ with executable bit.
+ * 2. Snapshot ~/.claude/settings.json to <state>/backups/settings.<UTC>.json.
+ * 3. Merge a SessionStart / Stop / SessionEnd entry into settings.json,
+ *    skipping any event that already references our hook command.
+ *
+ * Idempotent: rerunning is a no-op (modulo the harmless backup).
+ *
+ * See docs/DESIGN-claude-code-hooks.md §5.
+ */
+import { existsSync } from 'node:fs';
+import { chmod, copyFile, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+export const HOOK_EVENTS = ['SessionStart', 'Stop', 'SessionEnd'];
+const SCRIPT_FILES = {
+    SessionStart: 'session-start.sh',
+    Stop: 'stop.sh',
+    SessionEnd: 'session-end.sh',
+};
+const SCRIPT_BODIES = {
+    SessionStart: `#!/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
+`,
+    Stop: `#!/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
+`,
+    SessionEnd: `#!/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
+`,
+};
+export function defaultStateRoot(env = process.env) {
+    return env.CONTEXTIFY_STATE_DIR ?? join(homedir(), '.contextify');
+}
+export function defaultClaudeSettingsPath(env = process.env) {
+    return env.CLAUDE_SETTINGS_PATH ?? join(homedir(), '.claude', 'settings.json');
+}
+function hookCommandFor(stateRoot, event) {
+    return join(stateRoot, 'hooks', SCRIPT_FILES[event]);
+}
+async function ensureDir(path) {
+    if (!existsSync(path))
+        await mkdir(path, { recursive: true });
+}
+async function atomicWrite(path, content) {
+    await ensureDir(dirname(path));
+    const tmp = `${path}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(tmp, content, 'utf8');
+    await rename(tmp, path);
+}
+async function readSettings(path) {
+    if (!existsSync(path))
+        return {};
+    const raw = await readFile(path, 'utf8');
+    if (raw.trim().length === 0)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        throw new Error('settings.json root must be an object');
+    }
+    catch (err) {
+        throw new Error(`failed to parse ${path}: ${err.message}`);
+    }
+}
+function eventHasCommand(groups, command) {
+    if (!groups)
+        return false;
+    for (const g of groups) {
+        if (!g || !Array.isArray(g.hooks))
+            continue;
+        for (const h of g.hooks) {
+            if (h && h.type === 'command' && h.command === command)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Append `command` under `hooks.<event>` without disturbing other groups.
+ * Returns true if a new entry was appended, false if already present.
+ */
+export function appendHookCommand(settings, event, command) {
+    const hooks = settings.hooks ?? {};
+    const existing = hooks[event];
+    if (eventHasCommand(existing, command))
+        return false;
+    const groups = Array.isArray(existing) ? [...existing] : [];
+    groups.push({ hooks: [{ type: 'command', command }] });
+    hooks[event] = groups;
+    settings.hooks = hooks;
+    return true;
+}
+async function materializeScripts(stateRoot, bodies) {
+    const hooksDir = join(stateRoot, 'hooks');
+    await ensureDir(hooksDir);
+    for (const event of HOOK_EVENTS) {
+        const target = join(hooksDir, SCRIPT_FILES[event]);
+        await atomicWrite(target, bodies[event]);
+        await chmod(target, 0o755);
+    }
+    return hooksDir;
+}
+async function snapshotSettings(stateRoot, settingsPath) {
+    if (!existsSync(settingsPath))
+        return null;
+    const backupDir = join(stateRoot, 'backups');
+    await ensureDir(backupDir);
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = join(backupDir, `settings.${stamp}.json`);
+    await copyFile(settingsPath, backupPath);
+    return backupPath;
+}
+export async function installHooks(opts = {}) {
+    const env = opts.env ?? process.env;
+    const stateRoot = opts.stateRoot ?? defaultStateRoot(env);
+    const settingsPath = opts.claudeSettingsPath ?? defaultClaudeSettingsPath(env);
+    const bodies = {
+        SessionStart: opts.scriptBodies?.SessionStart ?? SCRIPT_BODIES.SessionStart,
+        Stop: opts.scriptBodies?.Stop ?? SCRIPT_BODIES.Stop,
+        SessionEnd: opts.scriptBodies?.SessionEnd ?? SCRIPT_BODIES.SessionEnd,
+    };
+    const hooksDir = await materializeScripts(stateRoot, bodies);
+    const backupPath = await snapshotSettings(stateRoot, settingsPath);
+    const settings = await readSettings(settingsPath);
+    const appended = [];
+    const present = [];
+    for (const event of HOOK_EVENTS) {
+        const command = hookCommandFor(stateRoot, event);
+        if (appendHookCommand(settings, event, command)) {
+            appended.push(event);
+        }
+        else {
+            present.push(event);
+        }
+    }
+    // Even when nothing changed, write settings back so the file always
+    // exists when we get to this point (rare edge case: empty default).
+    await atomicWrite(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+    return {
+        stateRoot,
+        hooksDir,
+        settingsPath,
+        backupPath,
+        appendedEvents: appended,
+        alreadyPresentEvents: present,
+    };
+}
+//# sourceMappingURL=install-hooks.js.map

package/dist/commands/install-hooks.js.map

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

package/dist/commands/install.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `contextify install` — zero-config global install.
+ *
+ * Materializes the three hook scripts under ~/.contextify/hooks/ and
+ * merges hook entries into ~/.claude/settings.json. Idempotent. Does
+ * NOT write .contextify.json into the cwd — that's `init`'s job.
+ *
+ * Also persists API credentials when --key (or CONTEXTIFY_API_KEY) is
+ * available, so IDE-spawned hook subprocesses (which do not inherit the
+ * operator's shell env) can authenticate against the SaaS via the
+ * on-disk ~/.contextify/credentials.json. Without this step, hooks ship
+ * unauthenticated and the server routes the data to LEGACY_TENANT_ID.
+ *
+ * Designed for users who want one-time global wiring: run once anywhere,
+ * and every Claude Code session in any directory gets captured. The hook
+ * scripts resolve project_id dynamically from each session's cwd at
+ * fire-time via identity.ts, so no per-project setup is required.
+ *
+ * Flags:
+ *   --key <ctx_live_...>   Persist this API key (chmod 600).
+ *   --server <url>         Persist server URL alongside the key.
+ *   --name <label>         Optional label stored next to the key.
+ *   --dry-run              Print what would change without modifying anything.
+ *
+ * Env auto-detect (when flags absent):
+ *   CONTEXTIFY_API_KEY     Used as --key.
+ *   CONTEXTIFY_SERVER_URL  Used as --server.
+ */
+import { saveCredentials } from '../credentials.js';
+import { type InstallHooksResult } from './install-hooks.js';
+export interface InstallArgs {
+    readonly dryRun?: boolean;
+    readonly apiKey?: string;
+    readonly serverUrl?: string;
+    readonly name?: string;
+}
+export interface InstallOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly stdout?: NodeJS.WriteStream;
+    readonly stderr?: NodeJS.WriteStream;
+    /** For tests: bypass the real ~/.claude / ~/.contextify dirs. */
+    readonly stateRoot?: string;
+    readonly claudeSettingsPath?: string;
+    /** For tests / dry-run preview. */
+    readonly runner?: (opts: {
+        stateRoot?: string;
+        claudeSettingsPath?: string;
+    }) => Promise<InstallHooksResult>;
+    /** For tests: override credentials persistence. */
+    readonly saveCredentialsImpl?: typeof saveCredentials;
+}
+export declare function runInstall(args: InstallArgs, opts?: InstallOptions): Promise<number>;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACrC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,mCAAmC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,eAAe,CAAC;CACvD;AA+BD,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0F9F"}

package/dist/commands/install.js

@@ -0,0 +1,129 @@
+/**
+ * `contextify install` — zero-config global install.
+ *
+ * Materializes the three hook scripts under ~/.contextify/hooks/ and
+ * merges hook entries into ~/.claude/settings.json. Idempotent. Does
+ * NOT write .contextify.json into the cwd — that's `init`'s job.
+ *
+ * Also persists API credentials when --key (or CONTEXTIFY_API_KEY) is
+ * available, so IDE-spawned hook subprocesses (which do not inherit the
+ * operator's shell env) can authenticate against the SaaS via the
+ * on-disk ~/.contextify/credentials.json. Without this step, hooks ship
+ * unauthenticated and the server routes the data to LEGACY_TENANT_ID.
+ *
+ * Designed for users who want one-time global wiring: run once anywhere,
+ * and every Claude Code session in any directory gets captured. The hook
+ * scripts resolve project_id dynamically from each session's cwd at
+ * fire-time via identity.ts, so no per-project setup is required.
+ *
+ * Flags:
+ *   --key <ctx_live_...>   Persist this API key (chmod 600).
+ *   --server <url>         Persist server URL alongside the key.
+ *   --name <label>         Optional label stored next to the key.
+ *   --dry-run              Print what would change without modifying anything.
+ *
+ * Env auto-detect (when flags absent):
+ *   CONTEXTIFY_API_KEY     Used as --key.
+ *   CONTEXTIFY_SERVER_URL  Used as --server.
+ */
+import { saveCredentials } from '../credentials.js';
+import { KEY_RE } from './login.js';
+import { installHooks } from './install-hooks.js';
+function resolveInstallCreds(args, env) {
+    const flagKey = args.apiKey?.trim();
+    if (flagKey) {
+        return {
+            apiKey: flagKey,
+            serverUrl: args.serverUrl?.trim() || env.CONTEXTIFY_SERVER_URL?.trim() || undefined,
+            name: args.name?.trim() || undefined,
+            source: 'flag',
+        };
+    }
+    const envKey = env.CONTEXTIFY_API_KEY?.trim();
+    if (envKey) {
+        return {
+            apiKey: envKey,
+            serverUrl: args.serverUrl?.trim() || env.CONTEXTIFY_SERVER_URL?.trim() || undefined,
+            name: args.name?.trim() || undefined,
+            source: 'env',
+        };
+    }
+    return null;
+}
+export async function runInstall(args, opts = {}) {
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    const runner = opts.runner ?? installHooks;
+    const env = opts.env ?? process.env;
+    const persist = opts.saveCredentialsImpl ?? saveCredentials;
+    const creds = resolveInstallCreds(args, env);
+    if (creds && !KEY_RE.test(creds.apiKey)) {
+        stderr.write(`contextify install: API key from ${creds.source === 'flag' ? '--key' : 'CONTEXTIFY_API_KEY'} does not look like a contextify api key.\n` +
+            `Expected format: ctx_live_<8>_<32>\n`);
+        return 2;
+    }
+    if (args.dryRun) {
+        const { defaultStateRoot, defaultClaudeSettingsPath } = await import('./install-hooks.js');
+        const stateRoot = opts.stateRoot ?? defaultStateRoot(env);
+        const settingsPath = opts.claudeSettingsPath ?? defaultClaudeSettingsPath(env);
+        stdout.write(`${JSON.stringify({
+            dryRun: true,
+            wouldWriteHooks: ['SessionStart', 'Stop', 'SessionEnd'],
+            hooksDir: `${stateRoot}/hooks`,
+            settingsPath,
+            backupDir: `${stateRoot}/backups`,
+            wouldPersistCredentials: creds
+                ? { source: creds.source, serverUrl: creds.serverUrl ?? null }
+                : null,
+        }, null, 2)}\n`);
+        return 0;
+    }
+    let result;
+    try {
+        result = await runner({
+            stateRoot: opts.stateRoot,
+            claudeSettingsPath: opts.claudeSettingsPath,
+        });
+    }
+    catch (err) {
+        stderr.write(`contextify install: ${err.message}\n`);
+        return 1;
+    }
+    let credentialsPath = null;
+    if (creds) {
+        try {
+            credentialsPath = persist({
+                apiKey: creds.apiKey,
+                name: creds.name,
+                serverUrl: creds.serverUrl,
+            });
+        }
+        catch (err) {
+            stderr.write(`contextify install: failed to persist credentials: ${err.message}\n`);
+            return 1;
+        }
+    }
+    const allPresent = result.appendedEvents.length === 0 && result.alreadyPresentEvents.length === 3;
+    stdout.write(`${allPresent ? 'Hooks already installed' : 'Installed Contextify hooks'} (`);
+    stdout.write(`appended=${JSON.stringify(result.appendedEvents)}, `);
+    stdout.write(`alreadyPresent=${JSON.stringify(result.alreadyPresentEvents)})\n`);
+    stdout.write(`  hooks dir:     ${result.hooksDir}\n`);
+    stdout.write(`  settings:      ${result.settingsPath}\n`);
+    if (result.backupPath) {
+        stdout.write(`  backup:        ${result.backupPath}\n`);
+    }
+    if (credentialsPath) {
+        stdout.write(`  credentials:   ${credentialsPath} (chmod 600, source=${creds.source})\n`);
+    }
+    else {
+        stdout.write(`  credentials:   NOT PERSISTED — hooks will ship unauthenticated and the server\n` +
+            `                 will route data to LEGACY_TENANT_ID. Re-run with --key or set\n` +
+            `                 CONTEXTIFY_API_KEY before invoking install.\n`);
+    }
+    stdout.write(`\n`);
+    stdout.write(`Hooks fire automatically on every Claude Code session. project_id\n`);
+    stdout.write(`is derived from each session's cwd at fire-time via the identity stack\n`);
+    stdout.write(`(env override → .contextify.json → git remote → folder realpath).\n`);
+    return 0;
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAA2B,MAAM,oBAAoB,CAAC;AAgC3E,SAAS,mBAAmB,CAAC,IAAiB,EAAE,GAAsB;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;YACL,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,SAAS;YACnF,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS;YACpC,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,SAAS;YACnF,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS;YACpC,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAiB,EAAE,OAAuB,EAAE;IAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,IAAI,eAAe,CAAC;IAE5D,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CACV,oCAAoC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,6CAA6C;YACvI,sCAAsC,CACzC,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC3F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,IAAI,yBAAyB,CAAC,GAAG,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,SAAS,CACf;YACE,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC;YACvD,QAAQ,EAAE,GAAG,SAAS,QAAQ;YAC9B,YAAY;YACZ,SAAS,EAAE,GAAG,SAAS,UAAU;YACjC,uBAAuB,EAAE,KAAK;gBAC5B,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE;gBAC9D,CAAC,CAAC,IAAI;SACT,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC;YACpB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,uBAAwB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC;YACH,eAAe,GAAG,OAAO,CAAC;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACV,sDAAuD,GAAa,CAAC,OAAO,IAAI,CACjF,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,oBAAoB,CAAC,MAAM,KAAK,CAAC,CAAC;IAElG,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,4BAA4B,IAAI,CAAC,CAAC;IAC3F,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACjF,MAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,CAAC,oBAAoB,eAAe,uBAAuB,KAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CACV,mFAAmF;YACjF,kFAAkF;YAClF,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACpF,MAAM,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;IACzF,MAAM,CAAC,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/login.d.ts

@@ -0,0 +1,9 @@
+export interface LoginArgs {
+    readonly apiKey?: string;
+    readonly serverUrl?: string;
+    readonly name?: string;
+}
+export declare const KEY_RE: RegExp;
+export declare function runLogin(args: LoginArgs): Promise<number>;
+export declare function logoutPath(): string;
+//# sourceMappingURL=login.d.ts.map

package/dist/commands/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,MAAM,QAAwC,CAAC;AAE5D,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB/D;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/commands/login.js

@@ -0,0 +1,36 @@
+/**
+ * `contextify login --key <ctx_live_...> [--server <url>] [--name <label>]`
+ *
+ * Writes ~/.contextify/credentials.json (chmod 600) so subsequent
+ * `contextify wrap`, `contextify prompt`, and `contextify ship` calls
+ * send `Authorization: Bearer <key>`.
+ *
+ * Per the P3.5 codex consult, env var still takes precedence over the
+ * file at request time, so this command can be safely run on machines
+ * that ALSO set CONTEXTIFY_API_KEY — the env wins.
+ */
+import { saveCredentials, credentialsPath } from '../credentials.js';
+export const KEY_RE = /^ctx_live_[a-z2-9]{8}_[a-z2-9]{32}$/;
+export async function runLogin(args) {
+    if (!args.apiKey) {
+        process.stderr.write('contextify login: --key <ctx_live_...> required.\n' +
+            'Get a key from /dashboard/keys on your contextify server.\n');
+        return 2;
+    }
+    if (!KEY_RE.test(args.apiKey)) {
+        process.stderr.write('contextify login: --key does not look like a contextify api key.\n' +
+            'Expected format: ctx_live_<8>_<32>\n');
+        return 2;
+    }
+    const path = saveCredentials({
+        apiKey: args.apiKey,
+        name: args.name,
+        serverUrl: args.serverUrl,
+    });
+    process.stdout.write(`saved credentials to ${path} (chmod 600)\n`);
+    return 0;
+}
+export function logoutPath() {
+    return credentialsPath();
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQrE,MAAM,CAAC,MAAM,MAAM,GAAG,qCAAqC,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAe;IAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oDAAoD;YAClD,6DAA6D,CAChE,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oEAAoE;YAClE,sCAAsC,CACzC,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,gBAAgB,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC"}

package/dist/commands/prompt.d.ts

@@ -0,0 +1,17 @@
+export interface PromptArgs {
+    /** The draft text. Use null to read from stdin. */
+    readonly draft: string | null;
+    readonly topK?: number;
+    readonly showMemories?: boolean;
+    readonly json?: boolean;
+}
+export interface PromptOptions {
+    readonly cwd: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly fetchImpl?: typeof fetch;
+    readonly readStdin?: () => Promise<string>;
+    readonly stdout?: NodeJS.WriteStream;
+    readonly stderr?: NodeJS.WriteStream;
+}
+export declare function runPrompt(args: PromptArgs, opts: PromptOptions): Promise<number>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/commands/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;CACtC;AAkCD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGtF"}

package/dist/commands/prompt.js

@@ -0,0 +1,141 @@
+/**
+ * `contextify prompt <draft|->`
+ *
+ * The Active Loop CLI — pipes a rough draft to /api/prompt/generate,
+ * receives an XML prompt with project memories + GStack directives baked
+ * in, and prints it to stdout so it can be redirected/piped.
+ *
+ * Unix-y by design:
+ *   contextify prompt "build a date picker"   | pbcopy
+ *   echo "draft from stdin" | contextify prompt -
+ *   contextify prompt "draft" --json | jq '.retrievedMemories'
+ *
+ * stderr is reserved for diagnostics (--show-memories) and errors so
+ * stdout stays a single clean artifact.
+ */
+import { resolveConfig } from '../config.js';
+import { resolveApiKey } from '../credentials.js';
+const MAX_DRAFT_CHARS = 20_000;
+async function defaultReadStdin() {
+    if (process.stdin.isTTY)
+        return '';
+    return new Promise((resolve, reject) => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => {
+            buf += chunk;
+        });
+        process.stdin.on('end', () => resolve(buf));
+        process.stdin.on('error', reject);
+    });
+}
+export async function runPrompt(args, opts) {
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    // Resolve config (project + server) — same path as `wrap` / `ship`.
+    let config;
+    try {
+        config = await resolveConfig(opts.cwd, opts.env);
+    }
+    catch (err) {
+        stderr.write(`contextify: ${err.message}\n`);
+        return 2;
+    }
+    // Resolve draft: positional arg, or stdin if "-".
+    let draft;
+    if (args.draft === null) {
+        const readStdin = opts.readStdin ?? defaultReadStdin;
+        draft = (await readStdin()).trim();
+        if (draft.length === 0) {
+            stderr.write('contextify: prompt: no draft provided (stdin was empty)\n');
+            return 2;
+        }
+    }
+    else {
+        draft = args.draft.trim();
+        if (draft.length === 0) {
+            stderr.write('contextify: prompt: draft cannot be empty\n');
+            return 2;
+        }
+    }
+    if (draft.length > MAX_DRAFT_CHARS) {
+        stderr.write(`contextify: prompt: draft exceeds ${MAX_DRAFT_CHARS} chars (got ${draft.length})\n`);
+        return 2;
+    }
+    // Validate flags.
+    if (args.topK !== undefined &&
+        (!Number.isInteger(args.topK) || args.topK < 1 || args.topK > 25)) {
+        stderr.write(`contextify: prompt: --top-k must be an integer in [1, 25]\n`);
+        return 2;
+    }
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const url = new URL('/api/prompt/generate', config.serverUrl).toString();
+    const body = {
+        projectId: config.projectId,
+        projectName: config.projectName,
+        draft,
+        topK: args.topK,
+    };
+    // Attach the same Bearer key the hook ships with so /api/prompt/generate
+    // accepts the request. Without this the route 401s on fail-closed deploys.
+    const creds = resolveApiKey(opts.env);
+    const headers = { 'content-type': 'application/json' };
+    if (creds)
+        headers.authorization = `Bearer ${creds.apiKey}`;
+    let res;
+    try {
+        res = await fetchImpl(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        stderr.write(`contextify: prompt: request failed: ${err.message}\n`);
+        return 1;
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        stderr.write(`contextify: prompt: server returned ${res.status} ${res.statusText}\n`);
+        if (text.length > 0)
+            stderr.write(`${text}\n`);
+        return 1;
+    }
+    let json;
+    try {
+        json = (await res.json());
+    }
+    catch (err) {
+        stderr.write(`contextify: prompt: invalid JSON response: ${err.message}\n`);
+        return 1;
+    }
+    if (args.showMemories) {
+        writeMemoriesSummary(stderr, json);
+    }
+    if (args.json) {
+        stdout.write(`${JSON.stringify(json, null, 2)}\n`);
+    }
+    else {
+        stdout.write(json.xml.endsWith('\n') ? json.xml : `${json.xml}\n`);
+    }
+    return 0;
+}
+function writeMemoriesSummary(stderr, json) {
+    const memCount = json.retrievedMemories.length;
+    const dirCount = json.directives.length;
+    stderr.write(`\n# Retrieved ${memCount} memor${memCount === 1 ? 'y' : 'ies'}`);
+    if (dirCount > 0) {
+        stderr.write(`, ${dirCount} directive${dirCount === 1 ? '' : 's'}`);
+    }
+    stderr.write(`:\n`);
+    for (const m of json.retrievedMemories) {
+        const tag = `[${m.kind}/${m.source}, d=${m.distance.toFixed(3)}]`;
+        const text = m.content.length > 200 ? `${m.content.slice(0, 197)}...` : m.content;
+        stderr.write(`  - ${tag} ${text}\n`);
+    }
+    for (const d of json.directives) {
+        stderr.write(`  > ${d.skill} — ${d.reason}\n`);
+    }
+    stderr.write(`\n`);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/prompt.js.map

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

package/dist/commands/ship.d.ts

@@ -0,0 +1,6 @@
+export interface ShipArgs {
+    readonly cwd: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export declare function runShip(args: ShipArgs): Promise<number>;
+//# sourceMappingURL=ship.d.ts.map

package/dist/commands/ship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.d.ts","sourceRoot":"","sources":["../../src/commands/ship.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB7D"}

package/dist/commands/ship.js

@@ -0,0 +1,20 @@
+import { resolveConfig } from '../config.js';
+import { flushSpool } from '../shipper.js';
+export async function runShip(args) {
+    let config;
+    try {
+        config = await resolveConfig(args.cwd, args.env);
+    }
+    catch (err) {
+        process.stderr.write(`contextify: ${err.message}\n`);
+        return 2;
+    }
+    const result = await flushSpool({ serverUrl: config.serverUrl, cwd: args.cwd });
+    process.stdout.write(`${JSON.stringify({
+        attempted: result.attempted,
+        sent: result.sent,
+        remaining: result.remaining,
+    })}\n`);
+    return result.remaining === 0 ? 0 : 1;
+}
+//# sourceMappingURL=ship.js.map

package/dist/commands/ship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ship.js","sourceRoot":"","sources":["../../src/commands/ship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAO3C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAgB,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,IAAI,CACP,CAAC;IACF,OAAO,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/commands/wrap.d.ts

@@ -0,0 +1,10 @@
+export interface WrapOptions {
+    readonly argv: readonly string[];
+    readonly cwd: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly maxBytes?: number;
+    readonly maxIdleMs?: number;
+    readonly forceSpool?: boolean;
+}
+export declare function runWrap(opts: WrapOptions): Promise<number>;
+//# sourceMappingURL=wrap.d.ts.map

package/dist/commands/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/commands/wrap.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAKD,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAkEhE"}