@aiti-ai/aiti-claude-code-agent 0.0.0-stage → 0.1.7

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@aiti-ai/aiti-claude-code-agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.7",
+  "description": "Drive Claude Code CLI sessions — resume historical rows from All Sessions (agentKey: claude)",
+  "soul": "历史会话不是化石——点一下就活过来。",
+  "scripts": {
+    "build:client": "node -e \"const fs=require('fs');fs.mkdirSync('dist',{recursive:true});for(const f of fs.readdirSync('client/src'))if(f.endsWith('.mjs'))fs.copyFileSync('client/src/'+f,'dist/'+f)\""
+  },
+  "aitiConfigs": {
+    "configFiles": [
+      "zcode-api-key.json",
+      "controlled-login.json"
+    ]
+  },
+  "aitiExtProtocol": "1.0",
+  "dependencies": {
+    "@aiti-ai/ext-shared": "^0.1.3"
+  },
+  "license": "MIT",
+  "contentHash": "cdf0b8c7a747f509",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aiti-ai/aiti-ai.git",
+    "directory": "extensions/aiti-claude-code-agent"
+  },
+  "homepage": "https://github.com/aiti-ai/aiti-ai#readme",
+  "bugs": {
+    "url": "https://github.com/aiti-ai/aiti-ai/issues"
+  }
+}

package/reconcile-deps.mjs

@@ -0,0 +1,41 @@
+/**
+ * _shared/reconcile-deps.mjs · 通知 pi-web 双实例对齐扩展共享依赖（各扩展 deploy.mjs 共用）
+ *
+ * 背景：扩展运行时依赖统一装进共享根 <webRoot>/node_modules（jiti 从扩展目录向上解析
+ * 自动命中；机制仿 pi 本体 npm: 包安装）。共享根的唯一写入方是 aiti-extman 的
+ * shared-deps reconcile——deploy.mjs 拷完文件后 POST 本通知即可，不在部署脚本里跑 npm。
+ *
+ * 用法（与 reload-instances 同款：允许失败，永不 throw、不影响 deploy 退出码）：
+ *   import { notifyReconcile } from "../../_shared/reconcile-deps.mjs";
+ *   await notifyReconcile();               // 默认 "[deploy] " 前缀；建议在 reloadInstances() 之前调
+ *
+ * 失败无害：extman 在下一次 install/remove/reconcile-deps 时会自愈对齐；双实例各自
+ * reconcile 各自的 webRoot（~/.pi/web 与 ~/.pi/web-dev），互不相干。
+ */
+import { buildInstances } from "./reload-instances.mjs";
+
+export async function notifyReconcile(prefix = "[deploy] ") {
+  for (const inst of buildInstances()) {
+    if (inst.base === null) {
+      console.log(`${prefix}reconcile ${inst.name} 跳过：basePath 非法`);
+      continue;
+    }
+    try {
+      const r = await fetch(inst.base + "/api/extensions/aiti-extman/ops", {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ action: "reconcile-deps", source: "deploy" }),
+      });
+      const body = await r.json().catch(() => null);
+      const err = body && body.deps && body.deps.error;
+      if (r.ok && body && body.ok) {
+        console.log(`${prefix}reconcile ${inst.name} → ✓（${Object.keys(body.deps?.deps || {}).length} 个共享依赖）`);
+      } else {
+        console.log(`${prefix}reconcile ${inst.name} → HTTP ${r.status} ⚠${err ? " " + err : "（extman 未就绪？下次安装时自动对齐）"}`);
+      }
+    } catch (e) {
+      const cause = e && e.cause ? String(e.cause.code || e.cause.message || e.cause) : String((e && e.message) || e);
+      console.log(`${prefix}reconcile ${inst.name} 不可达（${cause}）— 下次安装时自动对齐`);
+    }
+  }
+}

package/reload-instances.mjs

@@ -0,0 +1,60 @@
+/**
+ * _shared/reload-instances.mjs · pi-web 双实例热重载（各扩展 deploy.mjs 共用）
+ *
+ * dev 3001 / 生产 3002；端口可经 AITI_DEV_PORT / AITI_PROD_PORT 覆盖；
+ * basePath 双 env（AITI_DEV_BASE_PATH / AITI_PROD_BASE_PATH）按机器设值，
+ *   推荐值不带斜杠（48：dev 与 空；155：系统级 wdev 与 win）——git-bash 启动
+ *   原生程序时会把 / 开头的 env 值做 MSYS 路径转换（/wdev → D:/apps/Git/wdev）
+ *   致 URL 非法；不带斜杠则不触发转换。此处自动补 /（旧 /xxx 格式仍兼容），
+ *   兼容不了时提示 MSYS_NO_PATHCONV=1。
+ * 避免「server 端代码改了、实例没 reload 导致跑旧逻辑」。
+ *
+ * 用法（静态 import 或顶层 await import 均可）：
+ *   import { reloadInstances } from "../../_shared/reload-instances.mjs";
+ *   await reloadInstances();              // 默认 "[deploy] " 前缀
+ */
+const BASE_PATH_RE = /^\/[A-Za-z0-9._-]*$/;
+
+function buildInstance(name, portEnv, portDefault, pathEnv, pathDefault) {
+  const origin = `http://127.0.0.1:${process.env[portEnv] || portDefault}`;
+  const raw = process.env[pathEnv];
+  if (raw === undefined || raw === null || String(raw).trim() === "") return { name, base: origin + pathDefault };
+  // 自动补 /：wdev → /wdev（推荐无斜杠格式，MSYS 不转换）；/wdev → /wdev（旧格式兼容）
+  const p = "/" + String(raw).trim().replace(/^\/+|\/+$/g, "");
+  if (BASE_PATH_RE.test(p)) return { name, base: origin + p };
+  return { name, base: null, raw };
+}
+
+/** 双实例清单（dev/prod 各 {name, base}）；reload-instances 与 reconcile-deps 等共用。 */
+export function buildInstances() {
+  return [
+    buildInstance("dev", "AITI_DEV_PORT", 3001, "AITI_DEV_BASE_PATH", "/dev"),
+    buildInstance("prod", "AITI_PROD_PORT", 3002, "AITI_PROD_BASE_PATH", ""),
+  ];
+}
+
+export async function reloadInstances(prefix = "[deploy] ") {
+  // 批次合并（deploy-all 场景）：子条目部署脚本被注入 PI_WEB_DEFER_RELOAD=1 时不各自 reload，
+  // 由 deploy-all 在全部条目完成后统一执行一轮（N 条目 × 2 实例 → 2 次 POST）。
+  // 避免批量部署时的 reload 风暴（2026-09-15 实测：65 条目逐个 reload 把 dev 实例打满）。
+  // 单独跑某个扩展 deploy.mjs 不带该 env → 行为不变（部署完立即 reload）。
+  if (process.env.PI_WEB_DEFER_RELOAD === "1") {
+    console.log(`${prefix}reload 已 defer（PI_WEB_DEFER_RELOAD=1，由 deploy-all 收尾统一执行）`);
+    return;
+  }
+  // 允许失败：网络异常/非 2xx/服务未启动/env 非法一律只打提示，永不 throw——不影响 deploy 退出码
+  for (const inst of buildInstances()) {
+    if (inst.base === null) {
+      const msysHint = /[\\:]/.test(inst.raw) ? "——疑似 git-bash MSYS 路径转换，用 MSYS_NO_PATHCONV=1 前缀重跑" : "";
+      console.log(`${prefix}reload ${inst.name} 跳过：AITI_${inst.name.toUpperCase()}_BASE_PATH="${inst.raw}" 非法（须形如 /xxx 或留空）${msysHint}`);
+      continue;
+    }
+    try {
+      const r = await fetch(inst.base + "/api/extensions/reload", { method: "POST" });
+      console.log(`${prefix}reload ${inst.name} → HTTP ${r.status} ${r.ok ? "✓" : "⚠ 失败（请手动 POST /api/extensions/reload）"}`);
+    } catch (e) {
+      const cause = e && e.cause ? String(e.cause.code || e.cause.message || e.cause) : String((e && e.message) || e);
+      console.log(`${prefix}reload ${inst.name} 不可达（${cause}）— 需手动 POST /api/extensions/reload`);
+    }
+  }
+}

package/tools/deploy.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/** 部署 aiti-claude-code-agent 到 ~/.pi/web{,-dev}/extensions/（默认双写；--prod 仅 prod、--dev 仅 dev；文件集须与部署树一致）。 */
+import { cpSync, mkdirSync, existsSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { notifyReconcile } from "../../_shared/reconcile-deps.mjs";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+// 目标：默认双写 web + web-dev；--prod 仅 prod、--dev 仅 dev（向后兼容旧单边用法）
+const prod = process.argv.includes("--prod");
+const devOnly = process.argv.includes("--dev");
+const home = process.env.HOME || process.env.USERPROFILE;
+const bases = [
+  ...(prod ? [] : [join(home, ".pi", process.env.PI_WEB_DEV_DIR ? `web-${process.env.PI_WEB_DEV_DIR}` : "web-dev", "extensions")]),
+  ...(devOnly ? [] : [join(home, ".pi", "web", "extensions")]),
+];
+for (const base of bases) {
+  const dest = join(base, "aiti-claude-code-agent");
+  mkdirSync(dest, { recursive: true });
+  for (const f of ["index.ts","package.json","external-governance.ts", "claude-quota.ts"]) {
+    if (existsSync(join(root, f))) cpSync(join(root, f), join(dest, f));
+  }
+  // 登录 UI 已统一到 aiti-agent-manager（2026-09-13）：受控登录 client/弹窗不再部署
+  //（服务端 /login/* 与 .agent 描述符保留，manager 代理消费）。
+  console.log(`[deploy] aiti-claude-code-agent → ${dest}`);
+}
+
+// ── 共享依赖 reconcile 通知（依赖进 <webRoot>/node_modules；允许失败，永不 throw）──
+await notifyReconcile();
+
+// ── 双实例热重载（basePath 双 env 按机器设值）——允许失败：服务未启动/共享模块缺失仅提示，不影响 deploy 退出码 ──
+try {
+  const { reloadInstances } = await import("../../_shared/reload-instances.mjs");
+  await reloadInstances();
+} catch (e) {
+  console.log("[deploy] 自动 reload 未执行（" + String((e && e.message) || e) + "）— 需手动 POST /api/extensions/reload");
+}
+
+// ── dev-pack（方案 §3.2：源码+构建工具+AGENTS.md 直达部署目录，AI 可现场直改）——允许失败，不影响 deploy 退出码 ──
+try {
+  const { packDevPack } = await import("../../_shared/dev-pack.mjs");
+  packDevPack({ extRoot: resolve(import.meta.dirname, ".."), log: (m) => console.log("[deploy] " + m) });
+} catch (e) {
+  console.log("[deploy] dev-pack 未执行（" + String((e && e.message) || e) + "）");
+}

package/tools/turn-ack-probe.mjs

@@ -0,0 +1,106 @@
+/**
+ * claude-code turn-ack 探针（债务 D11）——stream-json 长连接「result 后 0ms 写入」是否被吞。
+ *
+ * 方法（对齐 codebuddy turn-ack 方案 §1.2 裸 CLI 复现链）：
+ *   spawn `claude -p --output-format=stream-json --input-format=stream-json
+ *          --include-partial-messages --verbose --dangerously-skip-permissions`
+ *   轮 1: "Reply with exactly: ONE" → 等 result 帧
+ *   轮 2: result 后 **0ms** 立即写 "Reply with exactly: TWO" → 45s 等第二个 result
+ *   判定：第二个 result 到达且文本含 TWO → 健康（followUp 可开）；
+ *         超时 / result 复读 ONE（无 assistant 帧） → 吞输入（同 cbc 病）。
+ *
+ * Run: node pi-web-ext/aiti-claude-code-agent/tools/turn-ack-probe.mjs [--delay <ms>]
+ * 输出：JSON 一行结论 { healthy, delayMs, turn2, evidence }
+ */
+
+import { spawn } from "node:child_process";
+
+const delayMs = Number(process.argv[process.argv.indexOf("--delay") + 1] ?? 0) || 0;
+const bin = process.env.CLAUDE_CLI_PATH || "claude";
+
+const child = spawn(bin, [
+	"-p",
+	"--output-format", "stream-json",
+	"--input-format", "stream-json",
+	"--include-partial-messages",
+	"--verbose",
+	"--dangerously-skip-permissions",
+], { cwd: process.cwd(), stdio: ["pipe", "pipe", "pipe"] });
+
+const frames = [];
+let buffer = "";
+let turn = 0;
+let resultCount = 0;
+let assistantTexts = ["", ""];
+
+child.stdout.on("data", (chunk) => {
+	buffer += chunk.toString("utf8");
+	for (;;) {
+		const idx = buffer.indexOf("\n");
+		if (idx === -1) break;
+		const line = buffer.slice(0, idx);
+		buffer = buffer.slice(idx + 1);
+		if (!line.trim()) continue;
+		let msg;
+		try { msg = JSON.parse(line); } catch { continue; }
+		const type = String(msg.type ?? "");
+		if (type === "assistant") {
+			const c = msg.message?.content ?? [];
+			for (const b of c) if (b.type === "text" && b.text) assistantTexts[turn] += b.text;
+		}
+		if (type === "result") {
+			resultCount++;
+			frames.push({ t: Date.now(), type, subtype: msg.subtype, result: String(msg.result ?? "").slice(0, 120) });
+			if (resultCount === 1) {
+				// result 后 0ms（可调 --delay）写入第二轮
+				setTimeout(() => {
+					child.stdin.write(JSON.stringify({
+						type: "user",
+						message: { role: "user", content: [{ type: "text", text: "Reply with exactly: TWO" }] },
+					}) + "\n");
+					turn = 1;
+					frames.push({ t: Date.now(), type: "PROBE_WRITE_TURN2", delayAfterResultMs: delayMs });
+				}, delayMs);
+			} else if (resultCount === 2) {
+				finish(true);
+			}
+		}
+		if (type === "system" && msg.subtype === "init") frames.push({ t: Date.now(), type: "init", session_id: msg.session_id });
+	}
+});
+
+child.stderr.on("data", (c) => process.stderr.write(`[stderr] ${c}`));
+child.on("exit", (code) => {
+	if (resultCount < 2) finish(false, `process exited (code=${code}) before turn2 result`);
+});
+
+const timer = setTimeout(() => finish(false, "timeout 120s waiting for turn2 result"), 120_000);
+
+function finish(turned, why) {
+	clearTimeout(timer);
+	try { child.kill("SIGKILL"); } catch { /* already dead */ }
+	const t2 = (assistantTexts[1] || "").trim();
+	const r2 = frames.filter((f) => f.type === "result")[1];
+	const replayed = r2 && !t2 && String(r2.result ?? "").includes("ONE");
+	const out = {
+		healthy: Boolean(turned && t2.includes("TWO")),
+		delayMs,
+		turn2AssistantText: t2.slice(0, 200) || null,
+		turn2Result: r2 ? String(r2.result ?? "").slice(0, 200) : null,
+		replaySuspect: replayed || undefined,
+		why: why || undefined,
+		frames: frames.map((f) => ({ ...f, t: undefined })),
+	};
+	console.log(JSON.stringify(out, null, 2));
+	process.exit(0);
+}
+
+// 启动：stream-json 输入模式下 CLI 懒初始化——init 帧在首条消息后才出现（扩展实测），
+// 所以不等 init，spawn 后直接写第一轮。
+setTimeout(() => {
+	child.stdin.write(JSON.stringify({
+		type: "user",
+		message: { role: "user", content: [{ type: "text", text: "Reply with exactly: ONE" }] },
+	}) + "\n");
+	turn = 0;
+}, 500);

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.