greprag 5.56.0 → 5.58.0

package/dist/commands/codex-chip/git.d.ts

@@ -0,0 +1,30 @@
+import { ChipManifest } from './model';
+export declare function gitRoot(cwd: string): string;
+export declare function resolveCommit(cwd: string, ref: string): string;
+export declare function isDirty(cwd: string): boolean;
+export declare function createWorktree(root: string, worktree: string, branch: string, baseSha: string): void;
+export declare function removeWorktree(root: string, worktree: string, force?: boolean, managedRoot?: string): void;
+export declare function deleteBranch(root: string, branch: string): void;
+export declare function createBranch(root: string, branch: string, baseSha: string): void;
+export declare function changedFiles(cwd: string, baseSha: string): string[];
+export declare function headCommit(cwd: string): string;
+export declare function branchName(cwd: string): string;
+export declare function importBranch(parent: string, checkout: string, branch: string, commit: string): void;
+export declare function chipReceiptPath(cwd: string): string;
+export interface ChipMarker {
+    id: string;
+    branch: string;
+    baseSha: string;
+    mode: 'read' | 'write';
+    owns: string[];
+    detachedAllowed?: boolean;
+}
+export declare function chipMarkerPath(cwd: string): string;
+export declare function writeChipMarker(cwd: string, marker: ChipMarker): void;
+export declare function readChipMarker(cwd: string): ChipMarker | null;
+export declare function isCommitAncestor(cwd: string, ancestor: string, descendant?: string): boolean;
+export declare function slugify(value: string): string;
+export declare function validateLeases(leases: string[]): void;
+export declare function leasesOverlap(left: string, right: string): boolean;
+export declare function assertNoLeaseConflicts(owns: string[], active: ChipManifest[]): void;
+export declare function outsideLease(files: string[], owns: string[]): string[];

package/dist/commands/codex-chip/git.js

@@ -0,0 +1,223 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitRoot = gitRoot;
+exports.resolveCommit = resolveCommit;
+exports.isDirty = isDirty;
+exports.createWorktree = createWorktree;
+exports.removeWorktree = removeWorktree;
+exports.deleteBranch = deleteBranch;
+exports.createBranch = createBranch;
+exports.changedFiles = changedFiles;
+exports.headCommit = headCommit;
+exports.branchName = branchName;
+exports.importBranch = importBranch;
+exports.chipReceiptPath = chipReceiptPath;
+exports.chipMarkerPath = chipMarkerPath;
+exports.writeChipMarker = writeChipMarker;
+exports.readChipMarker = readChipMarker;
+exports.isCommitAncestor = isCommitAncestor;
+exports.slugify = slugify;
+exports.validateLeases = validateLeases;
+exports.leasesOverlap = leasesOverlap;
+exports.assertNoLeaseConflicts = assertNoLeaseConflicts;
+exports.outsideLease = outsideLease;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const proc_1 = require("../../proc");
+function git(cwd, args) {
+    return (0, proc_1.safeExecFileSync)('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    }).trim();
+}
+function gitRoot(cwd) {
+    return path.resolve(git(cwd, ['rev-parse', '--show-toplevel']));
+}
+function resolveCommit(cwd, ref) {
+    return git(cwd, ['rev-parse', '--verify', `${ref}^{commit}`]);
+}
+function isDirty(cwd) {
+    return git(cwd, ['status', '--porcelain']).length > 0;
+}
+function createWorktree(root, worktree, branch, baseSha) {
+    fs.mkdirSync(path.dirname(worktree), { recursive: true });
+    // A linked worktree shares the parent's refs, index metadata, and object
+    // database. Codex would need write access to that shared control plane in
+    // order to commit. A local shared clone keeps its own refs/index while
+    // borrowing parent objects read-only through alternates: fast and isolated.
+    git(root, ['clone', '--shared', '--no-checkout', '--', root, worktree]);
+    for (const key of ['user.name', 'user.email']) {
+        try {
+            const value = git(root, ['config', '--get', key]);
+            if (value)
+                git(worktree, ['config', key, value]);
+        }
+        catch { /* Codex will surface ordinary Git identity setup if absent */ }
+    }
+    const parentModules = path.join(root, 'node_modules');
+    const chipModules = path.join(worktree, 'node_modules');
+    if (fs.existsSync(parentModules) && !fs.existsSync(chipModules)) {
+        const exclude = path.join(worktree, '.git', 'info', 'exclude');
+        fs.mkdirSync(path.dirname(exclude), { recursive: true });
+        const current = fs.existsSync(exclude) ? fs.readFileSync(exclude, 'utf-8') : '';
+        if (!current.split(/\r?\n/).includes('/node_modules'))
+            fs.appendFileSync(exclude, '\n/node_modules\n');
+        fs.symlinkSync(parentModules, chipModules, process.platform === 'win32' ? 'junction' : 'dir');
+    }
+    git(worktree, ['switch', '-c', branch, baseSha]);
+}
+function removeWorktree(root, worktree, force = false, managedRoot) {
+    void root;
+    if (!managedRoot)
+        throw new Error('Managed checkout root is required for cleanup.');
+    const safeRoot = path.resolve(managedRoot);
+    const target = path.resolve(worktree);
+    const relative = path.relative(safeRoot, target);
+    if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error(`Refusing checkout cleanup outside ${safeRoot}.`);
+    }
+    if (!force && isDirty(worktree))
+        throw new Error('Chip checkout is dirty.');
+    fs.rmSync(target, { recursive: true, force: false });
+}
+function deleteBranch(root, branch) {
+    git(root, ['branch', '-D', branch]);
+}
+function createBranch(root, branch, baseSha) {
+    git(root, ['branch', branch, baseSha]);
+}
+function changedFiles(cwd, baseSha) {
+    return git(cwd, ['diff', '--name-only', `${baseSha}...HEAD`])
+        .split(/\r?\n/).map(v => v.trim()).filter(Boolean).map(v => v.replace(/\\/g, '/'));
+}
+function headCommit(cwd) {
+    return git(cwd, ['rev-parse', 'HEAD']);
+}
+function branchName(cwd) {
+    return git(cwd, ['branch', '--show-current']);
+}
+function importBranch(parent, checkout, branch, commit) {
+    git(parent, ['fetch', '--force', checkout, `${commit}:refs/heads/${branch}`]);
+}
+function chipReceiptPath(cwd) {
+    const gitDir = git(cwd, ['rev-parse', '--git-dir']);
+    return path.join(path.resolve(cwd, gitDir), 'greprag-chip-receipt.json');
+}
+function chipMarkerPath(cwd) {
+    const gitDir = git(cwd, ['rev-parse', '--git-dir']);
+    return path.join(path.resolve(cwd, gitDir), 'greprag-chip.json');
+}
+function writeChipMarker(cwd, marker) {
+    fs.writeFileSync(chipMarkerPath(cwd), JSON.stringify(marker, null, 2) + '\n', 'utf-8');
+}
+function readChipMarker(cwd) {
+    try {
+        return JSON.parse(fs.readFileSync(chipMarkerPath(cwd), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function isCommitAncestor(cwd, ancestor, descendant = 'HEAD') {
+    try {
+        git(cwd, ['merge-base', '--is-ancestor', ancestor, descendant]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function slugify(value) {
+    const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 40);
+    return slug || 'chip';
+}
+function parseLease(value) {
+    const normalized = value.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/+$/, '');
+    if (!normalized || normalized.startsWith('../') || normalized.includes('/../') ||
+        path.posix.isAbsolute(normalized) || /^[a-z]:\//i.test(normalized)) {
+        throw new Error(`Invalid chip lease: ${value}`);
+    }
+    if (normalized.endsWith('/**')) {
+        const base = normalized.slice(0, -3).replace(/\/+$/, '');
+        if (!base || /[*?\[\]{}]/.test(base))
+            throw new Error(`Invalid directory lease: ${value}`);
+        return { kind: 'directory', path: base };
+    }
+    if (/[*?\[\]{}]/.test(normalized)) {
+        throw new Error(`Unsupported lease glob: ${value}. Use an exact file or a literal directory ending in /**.`);
+    }
+    return { kind: 'file', path: normalized };
+}
+function validateLeases(leases) {
+    for (const lease of leases)
+        parseLease(lease);
+}
+function leasesOverlap(left, right) {
+    const a = parseLease(left);
+    const b = parseLease(right);
+    if (a.kind === 'file' && b.kind === 'file')
+        return a.path === b.path;
+    if (a.kind === 'directory' && b.kind === 'directory') {
+        return a.path === b.path || a.path.startsWith(`${b.path}/`) || b.path.startsWith(`${a.path}/`);
+    }
+    const directory = a.kind === 'directory' ? a.path : b.path;
+    const file = a.kind === 'file' ? a.path : b.path;
+    return file.startsWith(`${directory}/`);
+}
+function assertNoLeaseConflicts(owns, active) {
+    for (const other of active) {
+        if (other.mode !== 'write')
+            continue;
+        for (const requested of owns) {
+            const conflict = other.owns.find(existing => leasesOverlap(requested, existing));
+            if (conflict) {
+                throw new Error(`Write lease collision with chip ${other.id.slice(0, 8)} (${other.name}): ` +
+                    `${requested} overlaps ${conflict}`);
+            }
+        }
+    }
+}
+function outsideLease(files, owns) {
+    const leases = owns.map(parseLease);
+    return files.filter(raw => {
+        const file = raw.replace(/\\/g, '/').replace(/^\.\//, '');
+        return !leases.some(lease => lease.kind === 'file'
+            ? file === lease.path
+            : file.startsWith(`${lease.path}/`));
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/commands/codex-chip/git.js.map

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

package/dist/commands/codex-chip/inbox.d.ts

@@ -0,0 +1,10 @@
+import { ChipManifest } from './model';
+interface ChipEvent {
+    kind: 'spawned' | 'running' | 'reported' | 'blocked' | 'failed' | 'cancelled';
+    summary: string;
+}
+export declare function chipEventBody(manifest: ChipManifest, event: ChipEvent): string;
+/** Typed lifecycle mail with sender identity, HTTP validation, and a durable
+ *  client-side idempotency receipt. The manifest remains authoritative. */
+export declare function sendChipEvent(manifest: ChipManifest, targetSession: string | undefined, event: ChipEvent, fromSession?: string): Promise<void>;
+export {};

package/dist/commands/codex-chip/inbox.js

@@ -0,0 +1,128 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chipEventBody = chipEventBody;
+exports.sendChipEvent = sendChipEvent;
+const crypto = __importStar(require("crypto"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const checkpoint_helpers_1 = require("../checkpoint-helpers");
+const identity_1 = require("../identity");
+const model_1 = require("./model");
+const store_1 = require("./store");
+function chipEventBody(manifest, event) {
+    const lifecycle = event.kind === 'running' ? 'IN-FLIGHT'
+        : event.kind === 'reported' ? 'DONE'
+            : event.kind === 'blocked' ? 'BLOCKED'
+                : event.kind.toUpperCase();
+    return `[codex-chip-announce:${lifecycle}] ${manifest.id.slice(0, 8)} ${event.summary}`;
+}
+async function ownHandle(apiUrl, apiKey) {
+    const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
+    const cachePath = path.join(home, '.greprag', 'identity.json');
+    let identity = (0, identity_1.readCache)(cachePath);
+    if (!identity && apiKey) {
+        identity = await (0, identity_1.fetchIdentity)(apiUrl, apiKey);
+        (0, identity_1.writeCache)(cachePath, identity);
+    }
+    return identity?.handle || identity?.publicHandle || null;
+}
+function optionalInbox() {
+    return process.env.GREPRAG_CODEX_CHIP_INBOX_OPTIONAL === '1';
+}
+/** Typed lifecycle mail with sender identity, HTTP validation, and a durable
+ *  client-side idempotency receipt. The manifest remains authoritative. */
+async function sendChipEvent(manifest, targetSession, event, fromSession) {
+    try {
+        if (!targetSession)
+            throw new Error('Chip lifecycle event has no target parent session.');
+        const cfg = (0, checkpoint_helpers_1.getConfig)();
+        if (!cfg.apiKey)
+            throw new Error('Chip lifecycle inbox delivery has no API key.');
+        const handle = await ownHandle(cfg.apiUrl, cfg.apiKey);
+        if (!handle)
+            throw new Error('Chip lifecycle inbox delivery cannot resolve the sender handle.');
+        const sender = fromSession || manifest.codex.threadId || manifest.parent.sessionId;
+        if (!sender)
+            throw new Error('Chip lifecycle event has no fromSession identity.');
+        const body = chipEventBody(manifest, event);
+        const eventKey = `${event.kind}:${crypto.createHash('sha256').update(body).digest('hex').slice(0, 16)}`;
+        const current = (0, store_1.readManifest)(manifest.id) || manifest;
+        if (current.codex.eventReceipts?.[eventKey])
+            return;
+        const response = await fetch(`${cfg.apiUrl.replace(/\/+$/, '')}/v1/inbox/send`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${cfg.apiKey}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                to: `${handle}/${targetSession}`,
+                body,
+                from_session_id: sender,
+                idempotency_key: `codex-chip:${manifest.id}:${eventKey}`,
+                references: {
+                    chip: {
+                        id: manifest.id,
+                        name: manifest.name,
+                        state: event.kind,
+                        branch: manifest.worktree.branch,
+                        worktree: (0, model_1.chipExecutionPath)(manifest),
+                    },
+                },
+            }),
+        });
+        const payload = await response.json().catch(() => ({}));
+        if (!response.ok || !payload.ok || !payload.id) {
+            throw new Error(`Inbox send failed (${response.status}): ${payload.error || 'missing delivery receipt'}`);
+        }
+        const deliveredSession = payload.delivered_to?.session_id || '';
+        if (payload.fell_back_to_desk || !deliveredSession ||
+            deliveredSession.slice(0, 8).toLowerCase() !== targetSession.slice(0, 8).toLowerCase()) {
+            throw new Error(`Inbox send did not reach parent session ${targetSession}.`);
+        }
+        const latest = (0, store_1.readManifest)(manifest.id);
+        if (latest)
+            (0, store_1.updateManifest)(manifest.id, {
+                codex: {
+                    ...latest.codex,
+                    eventReceipts: { ...(latest.codex.eventReceipts || {}), [eventKey]: payload.id },
+                },
+            });
+    }
+    catch (err) {
+        if (optionalInbox())
+            return;
+        throw err;
+    }
+}
+//# sourceMappingURL=inbox.js.map

package/dist/commands/codex-chip/inbox.js.map

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

package/dist/commands/codex-chip/lifecycle.d.ts

@@ -0,0 +1,5 @@
+import { ChipManifest, ChipReceipt } from './model';
+export declare function prepareCleanup(manifest: ChipManifest, integrated: boolean): ChipManifest;
+export declare function recoverDeliveredTerminalReport(manifest: ChipManifest): boolean;
+export declare function reconcileReportedDelivery(manifest: ChipManifest): Promise<'ready' | 'pending' | 'invalid'>;
+export declare function writeChipReceipt(receipt: ChipReceipt, cwd?: string): void;

package/dist/commands/codex-chip/lifecycle.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareCleanup = prepareCleanup;
+exports.recoverDeliveredTerminalReport = recoverDeliveredTerminalReport;
+exports.reconcileReportedDelivery = reconcileReportedDelivery;
+exports.writeChipReceipt = writeChipReceipt;
+const fs = __importStar(require("fs"));
+const model_1 = require("./model");
+const git_1 = require("./git");
+const store_1 = require("./store");
+const inbox_1 = require("./inbox");
+function removeReceiptIfPresent(manifest) {
+    const executionPath = (0, model_1.chipExecutionPath)(manifest);
+    if (!fs.existsSync(executionPath))
+        return; // Desktop may already have disposed its worktree
+    fs.rmSync((0, git_1.chipReceiptPath)(executionPath), { force: true });
+}
+function prepareCleanup(manifest, integrated) {
+    if (manifest.state !== 'ready' || !manifest.report)
+        return manifest;
+    if ((0, git_1.isCommitAncestor)(manifest.parent.root, manifest.report.commit) || integrated) {
+        return (0, store_1.updateManifest)(manifest.id, { state: 'merged' });
+    }
+    throw new Error('Reported commit is not an ancestor of the parent checkout; after verified squash/cherry-pick integration rerun cleanup with --integrated.');
+}
+function recoverDeliveredTerminalReport(manifest) {
+    if (manifest.state !== 'reported' || !manifest.worker?.settledAt || !manifest.report)
+        return false;
+    const delivered = Object.keys(manifest.codex.eventReceipts || {}).some(key => key.startsWith('reported:'));
+    if (!delivered)
+        return false;
+    (0, store_1.updateManifest)(manifest.id, { state: 'ready', error: undefined });
+    removeReceiptIfPresent(manifest);
+    return true;
+}
+async function reconcileReportedDelivery(manifest) {
+    if (recoverDeliveredTerminalReport(manifest))
+        return 'ready';
+    if (!manifest.report)
+        return 'invalid';
+    try {
+        await (0, inbox_1.sendChipEvent)(manifest, manifest.parent.sessionId, {
+            kind: 'reported',
+            summary: `${manifest.report.summary} Commit ${manifest.report.commit.slice(0, 8)}; checks: ${manifest.report.checks.join(', ') || 'none declared'}.`,
+        }, manifest.codex.threadId);
+        (0, store_1.updateManifest)(manifest.id, { state: 'ready', error: undefined });
+        removeReceiptIfPresent(manifest);
+        return 'ready';
+    }
+    catch (err) {
+        (0, store_1.updateManifest)(manifest.id, { error: `Terminal delivery remains pending: ${err.message}` });
+        return 'pending';
+    }
+}
+function writeChipReceipt(receipt, cwd = process.cwd()) {
+    const file = (0, git_1.chipReceiptPath)(cwd);
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(receipt, null, 2) + '\n', 'utf-8');
+    fs.renameSync(tmp, file);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/commands/codex-chip/lifecycle.js.map

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

package/dist/commands/codex-chip/model.d.ts

@@ -0,0 +1,92 @@
+export declare const CHIP_MANIFEST_VERSION = 1;
+export type ChipMode = 'read' | 'write';
+export type ChipState = 'planned' | 'provisioning' | 'starting' | 'awaiting-native' | 'running' | 'reported' | 'ready' | 'merged' | 'cleaned' | 'complete' | 'blocked' | 'failed' | 'cancelled' | 'orphaned' | 'abandoned';
+export interface ChipReport {
+    summary: string;
+    commit: string;
+    changedFiles: string[];
+    checks: string[];
+    reportedAt: string;
+}
+export type ChipReceipt = {
+    type: 'report';
+    id: string;
+    commit: string;
+    summary: string;
+    checks: string[];
+    at: string;
+} | {
+    type: 'block';
+    id: string;
+    reason: string;
+    at: string;
+};
+export interface ChipManifest {
+    version: 1;
+    revision: number;
+    id: string;
+    name: string;
+    task: string;
+    mode: ChipMode;
+    owns: string[];
+    state: ChipState;
+    project: {
+        id: string;
+        name: string;
+    };
+    parent: {
+        root: string;
+        baseRef: string;
+        baseSha: string;
+        sessionId?: string;
+    };
+    worktree: {
+        path: string;
+        branch: string;
+    };
+    codex: {
+        projectId?: string;
+        clientThreadId?: string;
+        threadId?: string;
+        nativeCwd?: string;
+        role?: 'worker' | 'leader';
+        bindingNonce?: string;
+        bootstrapAck?: string;
+        verifiedTitle?: string;
+        titleReadbacks?: number;
+        titleVerifiedAt?: string;
+        sandbox?: 'workspace-write';
+        nativeModelVerified?: boolean;
+        timeoutMinutes?: number;
+        attachDeadlineAt?: string;
+        eventReceipts?: Record<string, string>;
+        turnId?: string;
+        transport: 'stdio' | 'proxy';
+        runtime?: 'native' | 'cli';
+        cliCommand?: string;
+        profile?: 'standard' | 'complex' | 'custom';
+        model?: string;
+        effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra';
+        selection?: {
+            profile: 'standard' | 'complex' | 'custom';
+            model: string;
+            effort: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra';
+            selectedBy: string;
+            reason: string;
+            complexitySignals: string[];
+        };
+    };
+    worker?: {
+        pid: number;
+        heartbeatAt: string;
+        settledAt?: string;
+        deadlineAt?: string;
+    };
+    createdAt: string;
+    updatedAt: string;
+    report?: ChipReport;
+    error?: string;
+}
+export declare function chipExecutionPath(manifest: ChipManifest): string;
+export declare const ACTIVE_CHIP_STATES: Set<ChipState>;
+export declare function isActiveChip(manifest: ChipManifest): boolean;

package/dist/commands/codex-chip/model.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTIVE_CHIP_STATES = exports.CHIP_MANIFEST_VERSION = void 0;
+exports.chipExecutionPath = chipExecutionPath;
+exports.isActiveChip = isActiveChip;
+exports.CHIP_MANIFEST_VERSION = 1;
+function chipExecutionPath(manifest) {
+    return manifest.codex.nativeCwd || manifest.worktree.path;
+}
+exports.ACTIVE_CHIP_STATES = new Set([
+    'planned', 'provisioning', 'starting', 'awaiting-native', 'running', 'reported', 'ready', 'blocked',
+]);
+function isActiveChip(manifest) {
+    return exports.ACTIVE_CHIP_STATES.has(manifest.state);
+}
+//# sourceMappingURL=model.js.map

package/dist/commands/codex-chip/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/commands/codex-chip/model.ts"],"names":[],"mappings":";;;AAuEA,8CAEC;AAMD,oCAEC;AAjFY,QAAA,qBAAqB,GAAG,CAAC,CAAC;AAuEvC,SAAgB,iBAAiB,CAAC,QAAsB;IACtD,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;AAC5D,CAAC;AAEY,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAY;IACnD,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS;CACpG,CAAC,CAAC;AAEH,SAAgB,YAAY,CAAC,QAAsB;IACjD,OAAO,0BAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}