c0de-agent 0.0.0 → 1.1.0

package/dist/update/updater.js

@@ -0,0 +1,83 @@
+import { spawn } from 'node:child_process';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const DEFAULT_PACKAGE = 'c0de-agent';
+/** 默认自更新：npm install -g <pkg>。 */
+function defaultInstall(pkg) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('npm', ['install', '-g', pkg], { stdio: 'ignore' });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`npm install -g ${pkg} exited with ${code}`));
+        });
+    });
+}
+/** 默认启动新实例：detached spawn，argv 全部透传给新进程。 */
+function defaultSpawn(_snapshotPath, argv) {
+    return new Promise((resolve, reject) => {
+        try {
+            const child = spawn(process.argv0, [process.argv[1] ?? '', ...argv], {
+                detached: true,
+                stdio: 'ignore',
+            });
+            child.unref();
+            resolve();
+        }
+        catch (error) {
+            reject(error instanceof Error ? error : new Error(String(error)));
+        }
+    });
+}
+/**
+ * 执行热更新（spec §18.1-18.2 流程）：
+ *   1. 序列化当前会话状态到快照文件
+ *   2. 全局自更新（npm install -g）
+ *   3. detached 启动新版本实例，传入快照路径（新实例 restore + 端口接管）
+ *
+ * 注：旧实例的 graceful shutdown / 端口让渡由新实例启动后通过 IPC 协调
+ * （见 ipc.ts），本函数只负责"序列化 + 安装 + 接力"。若提供 handoffPort，
+ * argv 会带上 --handoff-port，新实例据此 requestHandoff 通知旧实例退出。
+ */
+async function performHotUpdate(snapshot, opts = {}) {
+    const pkg = opts.packageName ?? DEFAULT_PACKAGE;
+    const dir = await mkdtemp(join(tmpdir(), 'c0de-update-'));
+    const snapshotPath = opts.snapshotPath ?? join(dir, 'snapshot.json');
+    await writeFile(snapshotPath, JSON.stringify(snapshot), 'utf8');
+    const install = opts.installFn ?? defaultInstall;
+    try {
+        await install(pkg);
+    }
+    catch (error) {
+        return {
+            _tag: 'install_failed',
+            error: error instanceof Error ? error.message : String(error),
+            snapshotPath,
+        };
+    }
+    const restoreFlag = opts.restoreFlag ?? '--restore';
+    const argv = [restoreFlag, snapshotPath];
+    if (opts.handoffPort !== undefined) {
+        argv.push('--handoff-port', String(opts.handoffPort));
+    }
+    const spawnNew = opts.spawnNewInstanceFn ?? defaultSpawn;
+    try {
+        await spawnNew(snapshotPath, argv);
+    }
+    catch (error) {
+        return {
+            _tag: 'spawn_failed',
+            error: error instanceof Error ? error.message : String(error),
+            snapshotPath,
+        };
+    }
+    return { _tag: 'success', snapshotPath };
+}
+/** 清理快照临时目录（热更新完成或放弃后调用）。 */
+async function cleanupSnapshot(snapshotPath) {
+    await rm(join(snapshotPath, '..'), { recursive: true, force: true }).catch(() => { });
+}
+export { cleanupSnapshot, performHotUpdate };

package/dist/update/version.d.ts

@@ -0,0 +1,18 @@
+type UpdateCheckResult = {
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string;
+    releaseNotes?: string;
+};
+type CheckOptions = {
+    fetchImpl?: typeof fetch;
+    packageName?: string;
+    currentVersion?: string;
+    registryUrl?: string;
+};
+/** 语义化版本比较：a < b → -1，a == b → 0，a > b → 1。忽略前导 v 和 prerelease。 */
+declare function compareSemver(a: string, b: string): number;
+/** 查询 npm registry 判断是否有新版本。网络/解析失败时返回 hasUpdate:false，绝不抛错。 */
+declare function checkForUpdate(opts?: CheckOptions): Promise<UpdateCheckResult>;
+export type { CheckOptions, UpdateCheckResult };
+export { checkForUpdate, compareSemver };

package/dist/update/version.js

@@ -0,0 +1,49 @@
+// 版本检查（spec §18.1）：查询 npm registry 比对当前版本。
+const DEFAULT_PACKAGE = 'c0de-agent';
+const DEFAULT_VERSION = '0.1.0';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+/** 取 semver 的数值核心（去前导 v 与 prerelease）。 */
+function semverCore(v) {
+    return (v.replace(/^v/, '').split('-')[0] ?? '').split('.').map(Number);
+}
+/** 语义化版本比较：a < b → -1，a == b → 0，a > b → 1。忽略前导 v 和 prerelease。 */
+function compareSemver(a, b) {
+    const pa = semverCore(a);
+    const pb = semverCore(b);
+    for (let i = 0; i < 3; i++) {
+        const x = pa[i] ?? 0;
+        const y = pb[i] ?? 0;
+        if (x < y)
+            return -1;
+        if (x > y)
+            return 1;
+    }
+    return 0;
+}
+/** 查询 npm registry 判断是否有新版本。网络/解析失败时返回 hasUpdate:false，绝不抛错。 */
+async function checkForUpdate(opts = {}) {
+    const pkg = opts.packageName ?? DEFAULT_PACKAGE;
+    const current = opts.currentVersion ?? DEFAULT_VERSION;
+    const registry = opts.registryUrl ?? DEFAULT_REGISTRY;
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const result = {
+        hasUpdate: false,
+        currentVersion: current,
+        latestVersion: current,
+    };
+    try {
+        const res = await fetchImpl(`${registry}/${pkg}/latest`);
+        if (!res.ok)
+            return result;
+        const data = (await res.json());
+        if (!data.version)
+            return result;
+        result.latestVersion = data.version;
+        result.hasUpdate = compareSemver(current, data.version) < 0;
+    }
+    catch {
+        // 离线/网络错误：保守地报告无更新
+    }
+    return result;
+}
+export { checkForUpdate, compareSemver };

package/drizzle/0000_magical_nightshade.sql

@@ -0,0 +1,55 @@
+CREATE TABLE "compaction_archives" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"session_id" uuid NOT NULL,
+	"compaction_id" uuid NOT NULL,
+	"archive_type" text NOT NULL,
+	"original_entries" jsonb NOT NULL,
+	"file_snapshots" jsonb DEFAULT '[]'::jsonb,
+	"summary" text NOT NULL,
+	"token_count" integer,
+	"searchable_text" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "file_snapshots" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"session_id" uuid NOT NULL,
+	"entry_id" uuid,
+	"file_path" text NOT NULL,
+	"content" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"token_count" integer DEFAULT 0,
+	"version" integer DEFAULT 1,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "session_entries" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"session_id" uuid NOT NULL,
+	"tag" text NOT NULL,
+	"role" text,
+	"content" jsonb NOT NULL,
+	"tool_name" text,
+	"token_count" integer DEFAULT 0,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "sessions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"title" text NOT NULL,
+	"parent_id" uuid,
+	"branch_point" integer,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "compaction_archives" ADD CONSTRAINT "compaction_archives_session_id_sessions_id_fk" FOREIGN KEY ("session_id") REFERENCES "public"."sessions"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "file_snapshots" ADD CONSTRAINT "file_snapshots_session_id_sessions_id_fk" FOREIGN KEY ("session_id") REFERENCES "public"."sessions"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "session_entries" ADD CONSTRAINT "session_entries_session_id_sessions_id_fk" FOREIGN KEY ("session_id") REFERENCES "public"."sessions"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "sessions" ADD CONSTRAINT "sessions_parent_id_sessions_id_fk" FOREIGN KEY ("parent_id") REFERENCES "public"."sessions"("id") ON DELETE no action ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "idx_archives_session" ON "compaction_archives" USING btree ("session_id");--> statement-breakpoint
+CREATE INDEX "idx_snapshots_session_path" ON "file_snapshots" USING btree ("session_id","file_path");--> statement-breakpoint
+CREATE UNIQUE INDEX "idx_snapshots_latest" ON "file_snapshots" USING btree ("session_id","file_path","version");--> statement-breakpoint
+CREATE INDEX "idx_entries_session" ON "session_entries" USING btree ("session_id","created_at");--> statement-breakpoint
+CREATE INDEX "idx_sessions_parent" ON "sessions" USING btree ("parent_id");

package/drizzle/0001_chemical_doctor_faustus.sql

@@ -0,0 +1,13 @@
+CREATE TABLE "projects" (
+	"id" text PRIMARY KEY NOT NULL,
+	"worktree" text NOT NULL,
+	"vcs" text,
+	"name" text,
+	"git_remote" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "sessions" ADD COLUMN "project_id" text;--> statement-breakpoint
+ALTER TABLE "sessions" ADD CONSTRAINT "sessions_project_id_projects_id_fk" FOREIGN KEY ("project_id") REFERENCES "public"."projects"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "idx_sessions_project" ON "sessions" USING btree ("project_id");

package/drizzle/0002_amusing_micromacro.sql

@@ -0,0 +1,12 @@
+CREATE TABLE "tool_metrics" (
+	"model" text NOT NULL,
+	"tool" text NOT NULL,
+	"mode" text NOT NULL,
+	"attempts" integer DEFAULT 0 NOT NULL,
+	"successes" integer DEFAULT 0 NOT NULL,
+	"failures" integer DEFAULT 0 NOT NULL,
+	"avg_latency_ms" real DEFAULT 0 NOT NULL,
+	"last_used" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX "uq_tool_metrics_model_tool_mode" ON "tool_metrics" USING btree ("model","tool","mode");

package/drizzle/0003_regular_purifiers.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "sessions" ADD COLUMN "agent_type" text;--> statement-breakpoint
+ALTER TABLE "sessions" ADD COLUMN "worktree_path" text;

package/drizzle/meta/0000_snapshot.json

@@ -0,0 +1,448 @@
+{
+  "id": "50d91e70-a998-4243-a3b3-b60f79e7bbd2",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.compaction_archives": {
+      "name": "compaction_archives",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "session_id": {
+          "name": "session_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "compaction_id": {
+          "name": "compaction_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "archive_type": {
+          "name": "archive_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "original_entries": {
+          "name": "original_entries",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "file_snapshots": {
+          "name": "file_snapshots",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false,
+          "default": "'[]'::jsonb"
+        },
+        "summary": {
+          "name": "summary",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "token_count": {
+          "name": "token_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "searchable_text": {
+          "name": "searchable_text",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_archives_session": {
+          "name": "idx_archives_session",
+          "columns": [
+            {
+              "expression": "session_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "compaction_archives_session_id_sessions_id_fk": {
+          "name": "compaction_archives_session_id_sessions_id_fk",
+          "tableFrom": "compaction_archives",
+          "tableTo": "sessions",
+          "columnsFrom": [
+            "session_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.file_snapshots": {
+      "name": "file_snapshots",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "session_id": {
+          "name": "session_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "entry_id": {
+          "name": "entry_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "file_path": {
+          "name": "file_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "content": {
+          "name": "content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "content_hash": {
+          "name": "content_hash",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "token_count": {
+          "name": "token_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "default": 0
+        },
+        "version": {
+          "name": "version",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "default": 1
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_snapshots_session_path": {
+          "name": "idx_snapshots_session_path",
+          "columns": [
+            {
+              "expression": "session_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "file_path",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "idx_snapshots_latest": {
+          "name": "idx_snapshots_latest",
+          "columns": [
+            {
+              "expression": "session_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "file_path",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "version",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": true,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "file_snapshots_session_id_sessions_id_fk": {
+          "name": "file_snapshots_session_id_sessions_id_fk",
+          "tableFrom": "file_snapshots",
+          "tableTo": "sessions",
+          "columnsFrom": [
+            "session_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.session_entries": {
+      "name": "session_entries",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "session_id": {
+          "name": "session_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "tag": {
+          "name": "tag",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "role": {
+          "name": "role",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "content": {
+          "name": "content",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "tool_name": {
+          "name": "tool_name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "token_count": {
+          "name": "token_count",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "default": 0
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_entries_session": {
+          "name": "idx_entries_session",
+          "columns": [
+            {
+              "expression": "session_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "created_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "session_entries_session_id_sessions_id_fk": {
+          "name": "session_entries_session_id_sessions_id_fk",
+          "tableFrom": "session_entries",
+          "tableTo": "sessions",
+          "columnsFrom": [
+            "session_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.sessions": {
+      "name": "sessions",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "parent_id": {
+          "name": "parent_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "branch_point": {
+          "name": "branch_point",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "metadata": {
+          "name": "metadata",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "'{}'::jsonb"
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "idx_sessions_parent": {
+          "name": "idx_sessions_parent",
+          "columns": [
+            {
+              "expression": "parent_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {
+        "sessions_parent_id_sessions_id_fk": {
+          "name": "sessions_parent_id_sessions_id_fk",
+          "tableFrom": "sessions",
+          "tableTo": "sessions",
+          "columnsFrom": [
+            "parent_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}