contextgit 0.0.2 → 0.0.3

package/dist/bootstrap.d.ts

@@ -0,0 +1,10 @@
+import { ContextEngine } from '@contextgit/core';
+import type { ContextStore } from '@contextgit/store';
+export interface CliContext {
+    engine: ContextEngine;
+    store: ContextStore;
+    projectId: string;
+    branchId: string;
+}
+export declare function bootstrap(): Promise<CliContext>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AA4BD,wBAAsB,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAwBrD"}

package/dist/bootstrap.js

@@ -0,0 +1,43 @@
+// bootstrap.ts — shared setup for commit/context commands.
+// Loads config, opens LocalStore, detects git branch, initializes ContextEngine.
+import os from 'os';
+import { simpleGit } from 'simple-git';
+import { ContextEngine } from '@contextgit/core';
+import { LocalStore, RemoteStore } from '@contextgit/store';
+import { loadConfig } from './config.js';
+async function detectGitBranch() {
+    try {
+        const git = simpleGit(process.cwd());
+        const result = await git.revparse(['--abbrev-ref', 'HEAD']);
+        return result.trim();
+    }
+    catch {
+        return 'main';
+    }
+}
+async function resolveContextBranch(store, projectId, gitBranch) {
+    const existing = await store.getBranchByGitName(projectId, gitBranch);
+    if (existing)
+        return existing.id;
+    const created = await store.createBranch({
+        projectId,
+        name: `Context: ${gitBranch}`,
+        gitBranch,
+    });
+    return created.id;
+}
+export async function bootstrap() {
+    const config = loadConfig();
+    const { projectId } = config;
+    const store = config.store && config.store !== 'local'
+        ? new RemoteStore(config.store)
+        : new LocalStore(projectId);
+    const gitBranch = await detectGitBranch();
+    const branchId = await resolveContextBranch(store, projectId, gitBranch);
+    const hostname = os.hostname();
+    const agentId = `${hostname}-cli-interactive`;
+    const engine = new ContextEngine(store, agentId, config.agentRole ?? 'solo', 'contextgit-cli', config.workflowType ?? 'interactive');
+    await engine.init(projectId, branchId);
+    return { engine, store, projectId, branchId };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,iFAAiF;AAEjF,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AASxC,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAA;QAC3D,OAAO,MAAM,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAA;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,KAAmB,EACnB,SAAiB,EACjB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IACrE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,EAAE,CAAA;IAEhC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC;QACvC,SAAS;QACT,IAAI,EAAE,YAAY,SAAS,EAAE;QAC7B,SAAS;KACV,CAAC,CAAA;IACF,OAAO,OAAO,CAAC,EAAE,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAA;IAE5B,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO;QACtC,CAAC,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/B,CAAC,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,CAAA;IAC/B,MAAM,SAAS,GAAG,MAAM,eAAe,EAAE,CAAA;IACzC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;IAExE,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;IAC9B,MAAM,OAAO,GAAG,GAAG,QAAQ,kBAAkB,CAAA;IAE7C,MAAM,MAAM,GAAG,IAAI,aAAa,CAC9B,KAAK,EACL,OAAO,EACP,MAAM,CAAC,SAAS,IAAI,MAAM,EAC1B,gBAAgB,EAChB,MAAM,CAAC,YAAY,IAAI,aAAa,CACrC,CAAA;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAEtC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AAC/C,CAAC"}

package/dist/commands/branch.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class BranchCmd extends Command {
+    static description: string;
+    static args: {
+        name: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        git: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        parent: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=branch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/commands/branch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAe,MAAM,aAAa,CAAA;AAalD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAAgC;IAElD,MAAM,CAAC,IAAI;;MAKV;IAED,MAAM,CAAC,KAAK;;;MASX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB3B"}

package/dist/commands/branch.js

@@ -0,0 +1,52 @@
+// branch — create a new context branch.
+import { Command, Args, Flags } from '@oclif/core';
+import { simpleGit } from 'simple-git';
+import { LocalStore } from '@contextgit/store';
+import { loadConfig } from '../config.js';
+async function currentGitBranch(cwd) {
+    try {
+        return (await simpleGit(cwd).revparse(['--abbrev-ref', 'HEAD'])).trim();
+    }
+    catch {
+        return 'main';
+    }
+}
+export default class BranchCmd extends Command {
+    static description = 'Create a new context branch';
+    static args = {
+        name: Args.string({
+            description: 'Branch name (human-readable label)',
+            required: true,
+        }),
+    };
+    static flags = {
+        git: Flags.string({
+            description: 'Git branch name to associate (defaults to current git branch)',
+            required: false,
+        }),
+        parent: Flags.string({
+            description: 'Parent branch ID',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BranchCmd);
+        const config = loadConfig();
+        const store = new LocalStore(config.projectId);
+        const cwd = process.cwd();
+        const gitBranch = flags.git ?? (await currentGitBranch(cwd));
+        const branch = await store.createBranch({
+            projectId: config.projectId,
+            name: args.name,
+            gitBranch,
+            parentBranchId: flags.parent,
+        });
+        this.log(`Branch created.`);
+        this.log(`ID:      ${branch.id}`);
+        this.log(`Name:    ${branch.name}`);
+        this.log(`Git:     ${branch.gitBranch}`);
+        if (branch.parentBranchId)
+            this.log(`Parent:  ${branch.parentBranchId}`);
+    }
+}
+//# sourceMappingURL=branch.js.map

package/dist/commands/branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../src/commands/branch.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAA;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,GAAG,6BAA6B,CAAA;IAElD,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,+DAA+D;YAC5E,QAAQ,EAAE,KAAK;SAChB,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,kBAAkB;YAC/B,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAEzB,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;QAE5D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC;YACtC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS;YACT,cAAc,EAAE,KAAK,CAAC,MAAM;SAC7B,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QAC3B,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;QACxC,IAAI,MAAM,CAAC,cAAc;YAAE,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,cAAc,EAAE,CAAC,CAAA;IAC1E,CAAC"}

package/dist/commands/claim.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class ClaimCmd extends Command {
+    static description: string;
+    static args: {
+        task: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        ttl: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        status: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=claim.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../src/commands/claim.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAe,MAAM,aAAa,CAAA;AAIlD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC3C,MAAM,CAAC,WAAW,SAA2E;IAE7F,MAAM,CAAC,IAAI;;MAKV;IAED,MAAM,CAAC,KAAK;;;MAUX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B3B"}

package/dist/commands/claim.js

@@ -0,0 +1,50 @@
+// claim — create a task claim to prevent concurrent agent work.
+import { Command, Args, Flags } from '@oclif/core';
+import { LocalStore } from '@contextgit/store';
+import { loadConfig } from '../config.js';
+export default class ClaimCmd extends Command {
+    static description = 'Claim a task to prevent other agents from picking it up simultaneously';
+    static args = {
+        task: Args.string({
+            description: 'Short description of the task being claimed',
+            required: true,
+        }),
+    };
+    static flags = {
+        ttl: Flags.integer({
+            description: 'Time-to-live in hours before the claim auto-expires',
+            default: 2,
+        }),
+        status: Flags.string({
+            description: "Claim status: 'proposed' (plan mode) or 'active' (approved, work in progress)",
+            default: 'proposed',
+            options: ['proposed', 'active'],
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ClaimCmd);
+        const config = loadConfig();
+        const store = new LocalStore(config.projectId);
+        // Resolve current branch
+        const branch = await store.getBranchByGitName(config.projectId, 'main');
+        const branches = await store.listBranches(config.projectId);
+        const activeBranch = branches.find((b) => b.status === 'active') ?? branches[0];
+        if (!activeBranch) {
+            this.error('No branch found. Run contextgit init first.');
+        }
+        const claim = await store.claimTask(config.projectId, activeBranch.id, {
+            task: args.task,
+            agentId: `cli-${process.env.USER ?? 'unknown'}`,
+            role: config.agentRole ?? 'solo',
+            status: flags.status,
+            ttl: flags.ttl * 3_600_000,
+        });
+        this.log(`Claimed.`);
+        this.log(`ID:     ${claim.id}`);
+        this.log(`Task:   ${claim.task}`);
+        this.log(`Status: ${claim.status}`);
+        this.log(`TTL:    ${flags.ttl}h`);
+        store.close();
+    }
+}
+//# sourceMappingURL=claim.js.map

package/dist/commands/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../src/commands/claim.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC3C,MAAM,CAAC,WAAW,GAAG,wEAAwE,CAAA;IAE7F,MAAM,CAAC,IAAI,GAAG;QACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;YAChB,WAAW,EAAE,6CAA6C;YAC1D,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAED,MAAM,CAAC,KAAK,GAAG;QACb,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC;YACjB,WAAW,EAAE,qDAAqD;YAClE,OAAO,EAAE,CAAC;SACX,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,+EAA+E;YAC5F,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;SAChC,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAClD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAE9C,yBAAyB;QACzB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QACvE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC3D,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC/E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,EAAE;YACrE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,SAAS,EAAE;YAC/C,IAAI,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;YAChC,MAAM,EAAE,KAAK,CAAC,MAA+B;YAC7C,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,SAAS;SAC3B,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACpB,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;QAC/B,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,GAAG,GAAG,CAAC,CAAA;QAEjC,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC"}

package/dist/commands/commit.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+export default class CommitCmd extends Command {
+    static description: string;
+    static flags: {
+        message: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        content: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        thread: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        close: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'ci-run-id': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        pipeline: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=commit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/commands/commit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAY5C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAA4B;IAE9C,MAAM,CAAC,KAAK;;;;;;;MAgCX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2B3B"}

package/dist/commands/commit.js

@@ -0,0 +1,71 @@
+// commit — record a context commit via engine.commit().
+import { Command, Flags } from '@oclif/core';
+import { simpleGit } from 'simple-git';
+import { bootstrap } from '../bootstrap.js';
+async function captureGitSha(cwd) {
+    try {
+        return (await simpleGit(cwd).revparse(['HEAD'])).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+export default class CommitCmd extends Command {
+    static description = 'Record a context commit';
+    static flags = {
+        message: Flags.string({
+            char: 'm',
+            description: 'Short commit message (what was accomplished)',
+            required: true,
+        }),
+        content: Flags.string({
+            char: 'c',
+            description: 'Detailed commit content. Defaults to the message if omitted.',
+            required: false,
+        }),
+        thread: Flags.string({
+            char: 't',
+            description: 'Open a new thread (can be repeated)',
+            multiple: true,
+            required: false,
+        }),
+        close: Flags.string({
+            description: 'Close a thread by ID (can be repeated)',
+            multiple: true,
+            required: false,
+        }),
+        'ci-run-id': Flags.string({
+            description: 'CI run ID (e.g. GitHub Actions run ID)',
+            required: false,
+            env: 'GITHUB_RUN_ID',
+        }),
+        pipeline: Flags.string({
+            description: 'CI pipeline / workflow name',
+            required: false,
+            env: 'GITHUB_WORKFLOW',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(CommitCmd);
+        const ctx = await bootstrap();
+        const threads = {};
+        if (flags.thread?.length)
+            threads.open = flags.thread;
+        if (flags.close?.length) {
+            threads.close = flags.close.map(id => ({ id, note: 'Closed via CLI' }));
+        }
+        const gitCommitSha = await captureGitSha(process.cwd());
+        const commit = await ctx.engine.commit({
+            message: flags.message,
+            content: flags.content ?? flags.message,
+            gitCommitSha,
+            ciRunId: flags['ci-run-id'],
+            pipelineName: flags.pipeline,
+            ...(Object.keys(threads).length > 0 ? { threads } : {}),
+        });
+        this.log(`Commit recorded.`);
+        this.log(`ID:      ${commit.id}`);
+        this.log(`Message: ${commit.message}`);
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/commands/commit.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class ContextCmd extends Command {
+    static description: string;
+    static flags: {
+        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAM5C,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAC,WAAW,SAA+C;IAEjE,MAAM,CAAC,KAAK;;MAOX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB3B"}

package/dist/commands/context.js

@@ -0,0 +1,38 @@
+// context — print the current project snapshot to stdout.
+import { Command, Flags } from '@oclif/core';
+import { simpleGit } from 'simple-git';
+import { LocalStore } from '@contextgit/store';
+import { loadConfig } from '../config.js';
+export default class ContextCmd extends Command {
+    static description = 'Print the current project context snapshot';
+    static flags = {
+        format: Flags.string({
+            char: 'f',
+            description: 'Output format',
+            options: ['agents-md', 'json', 'text'],
+            default: 'text',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ContextCmd);
+        const config = loadConfig();
+        const store = new LocalStore(config.projectId);
+        // Detect current git branch
+        let gitBranch = 'main';
+        try {
+            const git = simpleGit(process.cwd());
+            gitBranch = (await git.revparse(['--abbrev-ref', 'HEAD'])).trim();
+        }
+        catch {
+            // fallback to 'main'
+        }
+        const branch = await store.getBranchByGitName(config.projectId, gitBranch);
+        if (!branch) {
+            this.error(`No context branch found for git branch '${gitBranch}'. Run 'contextgit init' first.`);
+        }
+        const format = (flags.format ?? 'text');
+        const snapshot = await store.getFormattedSnapshot(config.projectId, branch.id, format);
+        this.log(snapshot);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,MAAM,CAAC,WAAW,GAAG,4CAA4C,CAAA;IAEjE,MAAM,CAAC,KAAK,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC;YACtC,OAAO,EAAE,MAAM;SAChB,CAAC;KACH,CAAA;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAE9C,4BAA4B;QAC5B,IAAI,SAAS,GAAG,MAAM,CAAA;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;YACpC,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CACR,2CAA2C,SAAS,iCAAiC,CACtF,CAAA;QACH,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM,CAAmB,CAAA;QACzD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QACtF,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACpB,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class DoctorCmd extends Command {
+    static description: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAMrC,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAA+C;IAE3D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoF3B"}

package/dist/commands/doctor.js

@@ -0,0 +1,84 @@
+// doctor — diagnose the ContextGit installation and report issues.
+import os from 'os';
+import { join, resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { Command } from '@oclif/core';
+import { LocalStore } from '@contextgit/store';
+import { findConfigPath } from '../config.js';
+const SENTINEL = '# contextgit';
+export default class DoctorCmd extends Command {
+    static description = 'Check ContextGit setup and diagnose issues';
+    async run() {
+        this.log('ContextGit Doctor\n');
+        let passed = 0;
+        let failed = 0;
+        const check = (label, ok, hint) => {
+            const icon = ok ? '✓' : '✗';
+            this.log(`  [${icon}] ${label}`);
+            if (!ok && hint)
+                this.log(`        → ${hint}`);
+            ok ? passed++ : failed++;
+        };
+        // ── 1. Config file ────────────────────────────────────────────────────────
+        let configPath = null;
+        let config = null;
+        try {
+            configPath = findConfigPath(process.cwd());
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            check('Config file found and valid JSON', true);
+        }
+        catch {
+            check('Config file found and valid JSON', false, 'Run: contextgit init');
+        }
+        // ── 2. DB reachable ───────────────────────────────────────────────────────
+        if (config?.projectId) {
+            try {
+                const store = new LocalStore(config.projectId);
+                await store.getProject(config.projectId);
+                check('Local DB reachable', true);
+            }
+            catch {
+                check('Local DB reachable', false, 'DB file may be corrupted — try: contextgit init');
+            }
+        }
+        else {
+            check('Local DB reachable', false, 'No config to check DB against');
+        }
+        // ── 3. Git hooks installed ────────────────────────────────────────────────
+        const gitHooksDir = resolve(process.cwd(), '.git', 'hooks');
+        const postCommitPath = join(gitHooksDir, 'post-commit');
+        const hooksInstalled = existsSync(postCommitPath) &&
+            readFileSync(postCommitPath, 'utf-8').includes(SENTINEL);
+        check('Git hooks installed', hooksInstalled, 'Run: contextgit init --hooks');
+        // ── 4. API key configured (only relevant if remote is set) ────────────────
+        const remote = config?.remote;
+        if (remote) {
+            const serverCfgPath = join(os.homedir(), '.contextgit', 'server.json');
+            let hasKey = false;
+            try {
+                const cfg = JSON.parse(readFileSync(serverCfgPath, 'utf-8'));
+                hasKey = typeof cfg['keyHash'] === 'string' && cfg['keyHash'].length > 0;
+            }
+            catch { /* not configured */ }
+            check(`API key configured (remote: ${remote})`, hasKey, 'Run: contextgit keygen --save');
+        }
+        else {
+            check('API key (no remote configured — skipped)', true);
+        }
+        // ── 5. MCP registered in ~/.claude.json ───────────────────────────────────
+        const claudeJsonPath = join(os.homedir(), '.claude.json');
+        let mcpRegistered = false;
+        try {
+            const raw = readFileSync(claudeJsonPath, 'utf-8');
+            mcpRegistered = raw.includes('contextgit');
+        }
+        catch { /* file missing */ }
+        check('MCP server registered in ~/.claude.json', mcpRegistered, 'Add contextgit to mcpServers in ~/.claude.json');
+        // ── Summary ───────────────────────────────────────────────────────────────
+        this.log('');
+        this.log(`${passed} passed, ${failed} failed`);
+        if (failed > 0)
+            process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class Init extends Command {
+    static description: string;
+    static flags: {
+        name: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        hooks: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAA;AAgB5C,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,OAAO;IACvC,MAAM,CAAC,WAAW,SAA0C;IAE5D,MAAM,CAAC,KAAK;;;MAUX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4F3B"}

package/dist/commands/init.js

@@ -0,0 +1,126 @@
+// init — create .contextgit/config.json + project + branch in LocalStore.
+import { Command, Flags } from '@oclif/core';
+import { writeFileSync, mkdirSync, existsSync, readFileSync } from 'fs';
+import { join, basename } from 'path';
+import { nanoid } from 'nanoid';
+import { simpleGit } from 'simple-git';
+import { LocalStore } from '@contextgit/store';
+import { installGitHooks } from '../git-hooks.js';
+const SYSTEM_PROMPT_FRAGMENT = `\
+You have access to ContextGit memory tools. At the start of every session, call
+context_get with scope=global to load project state. After completing significant
+work, call context_commit with a message describing what was done and any open
+threads. Use context_branch before exploring risky changes.
+`;
+export default class Init extends Command {
+    static description = 'Initialize ContextGit in this project';
+    static flags = {
+        name: Flags.string({
+            char: 'n',
+            description: 'Project name (defaults to current directory name)',
+            required: false,
+        }),
+        hooks: Flags.boolean({
+            description: 'Install git hooks to auto-capture context on every git commit',
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Init);
+        const cwd = process.cwd();
+        const configDir = join(cwd, '.contextgit');
+        const configPath = join(configDir, 'config.json');
+        const promptPath = join(configDir, 'system-prompt.md');
+        // ── Self-heal: config exists but DB may be empty ───────────────────────────
+        if (existsSync(configPath)) {
+            let existing;
+            try {
+                existing = JSON.parse(readFileSync(configPath, 'utf8'));
+            }
+            catch {
+                this.error('Found .contextgit/config.json but could not parse it. Delete it and re-run init.');
+            }
+            const store = new LocalStore(existing.projectId);
+            const gitBranch = await detectGitBranch(cwd);
+            const branch = await store.getBranchByGitName(existing.projectId, gitBranch);
+            if (branch) {
+                this.log('ContextGit already initialized. Config found at .contextgit/config.json');
+                return;
+            }
+            // DB missing or empty — recreate project + branch
+            this.log('Config found but DB is empty — recreating project and branch in DB.');
+            await store.createProject({ id: existing.projectId, name: existing.project });
+            await store.createBranch({
+                projectId: existing.projectId,
+                name: `Context: ${gitBranch}`,
+                gitBranch,
+            });
+            writeSystemPrompt(promptPath);
+            this.log(`Recreated project "${existing.project}" (${existing.projectId}) for branch: ${gitBranch}`);
+            this.log(`System prompt: .contextgit/system-prompt.md`);
+            this.log(SYSTEM_PROMPT_FRAGMENT);
+            if (flags.hooks) {
+                installGitHooks(cwd);
+                this.log('Git hooks installed (.git/hooks/post-commit, post-checkout, post-merge)');
+            }
+            return;
+        }
+        // ── Fresh init ─────────────────────────────────────────────────────────────
+        const projectName = flags.name ?? basename(cwd);
+        const projectId = nanoid();
+        // Open store (creates DB + runs migrations).
+        const store = new LocalStore(projectId);
+        await store.createProject({ id: projectId, name: projectName });
+        const gitBranch = await detectGitBranch(cwd);
+        await store.createBranch({
+            projectId,
+            name: `Context: ${gitBranch}`,
+            gitBranch,
+        });
+        // Write config
+        mkdirSync(configDir, { recursive: true });
+        const config = {
+            project: projectName,
+            projectId,
+            store: 'local',
+            agentRole: 'solo',
+            workflowType: 'interactive',
+            autoSnapshot: false,
+            snapshotInterval: 10,
+            embeddingModel: 'local',
+        };
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        writeSystemPrompt(promptPath);
+        this.log(`Initialized ContextGit for project: ${projectName}`);
+        this.log(`Project ID:  ${projectId}`);
+        this.log(`Branch:      ${gitBranch}`);
+        this.log(`Config:      .contextgit/config.json`);
+        this.log(`DB:          ~/.contextgit/projects/${projectId}.db`);
+        this.log(``);
+        if (flags.hooks) {
+            installGitHooks(cwd);
+            this.log(`Git hooks installed (.git/hooks/post-commit, post-checkout, post-merge)`);
+        }
+        else {
+            this.log(`Tip: run "contextgit init --hooks" to auto-capture context on every git commit`);
+        }
+        this.log(``);
+        this.log(`Add the following to your MCP system prompt (.contextgit/system-prompt.md):`);
+        this.log(``);
+        this.log(SYSTEM_PROMPT_FRAGMENT);
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+async function detectGitBranch(cwd) {
+    try {
+        const git = simpleGit(cwd);
+        return (await git.revparse(['--abbrev-ref', 'HEAD'])).trim();
+    }
+    catch {
+        return 'main';
+    }
+}
+function writeSystemPrompt(promptPath) {
+    writeFileSync(promptPath, SYSTEM_PROMPT_FRAGMENT);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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