@bf-meishijian/aip 0.0.9 → 0.0.11

package/README.md

@@ -110,6 +110,8 @@ PLATFORM_WEB_URL=http://10.254.208.127:4173
 
 ## 上线准备与 GitLab MR
 
+Host 管理的开发、部署及 QA 仓库使用 SSH 拉取和推送。平台根据已配置 GitLab 返回的真实 SSH 地址下发，支持独立 SSH 主机名及端口；无需设置全局 Git URL 映射。运行 Host 的系统用户须有可用 SSH 密钥和仓库权限，并完成正常的 SSH 主机身份验证。已有 Host 仓库在核对项目后更新 origin 与显式推送地址，保留分支和修改；失败不会退回 HTTPS。平台 API 与云端源码同步仍使用各自的现有认证。
+
 开发阶段产出 `release_checklist.md`，测试期间随修复维护。人工验收通过后恢复原开发会话，先读取测试交接和最新分支代码，核实清单后提交 MR。Runtime 负责 Git 推送和 MR 写操作；平台仅用自己的读取权限核实、登记和查询状态。
 
 Runtime 的 MR 提交能力复用 [GitLab CLI glab](https://docs.gitlab.com/cli/api/)。运行 Runtime 的系统用户需要已安装 `glab`、能从 Runtime 的 `PATH` 找到它，并已通过 [glab auth login](https://docs.gitlab.com/cli/auth/login/) 登录对应 GitLab（或使用 glab 官方支持的凭证环境变量）。该身份需具备项目 MR 创建权限，Git 推送仍使用本机 Git 凭证。不读取平台全局 Token，也不把 Token 传入 Agent 参数。缺少 glab、登录失效、权限不足或网络失败时会返回中文处理提示，不降级使用平台写权限。
@@ -141,3 +143,19 @@ MR 创建成功但平台登记失败时，Runtime 保存待登记结果。重试
 仓库 manifest 只描述可复用用例，不声明 `ac`。工单的 AC 与 `caseId` 通过本工单测试计划中的 `ac`、`automationCaseIds` 建立关联；正式执行绑定计划版本。独立回归没有工单 AC 关联。旧执行原始证据保留，但目录中的旧 AC 不再参与覆盖或验收判断。
 
 移除 AC 契约须与测试仓库、平台 API 和 Host 一起更新。旧格式目录会被新契约拒绝；仍使用旧分支的工单应先将测试资产更新到新契约，再执行，不由平台猜测或补写关联。
+
+## 命令并发与准备排障（0.0.10）
+
+心跳领取与命令执行分离，最多同时处理 4 条任务命令；同一 Run / QA 会话仍按顺序领取。诊断、模型刷新、供应商登录独立于任务槽位，各类型自身串行。多个 Run 使用同一 Git 镜像时，仅该仓库的准备操作串行，避免并发修改镜像缓存。任务命令完成表示已处理命令，不表示后台 Agent 会话已经结束。
+
+准备请求排队超过 30 秒不再判失败。请求仍受原有 24 小时命令有效期约束；Host 已接收后失联或重启则显示中断，不自动重放。消息发送的 30 秒领取期限不受此修改影响。API 发布过程中执行结果回执失败会记录 `command_result_unknown`，不能当作命令执行失败，也不会自动重执行。
+
+Windows 计划任务将标准输出和错误追加到 `$HOME\.aip\profiles\default\logs\host.log`；使用 `--local` 时目录为 `profiles\local`，设置 `AIP_HOME` 时基址随之改变。PowerShell 实时查看：
+
+```powershell
+Get-Content "$HOME\.aip\profiles\default\logs\host.log" -Tail 100 -Wait
+```
+
+按 `commandId` / `runId` 定位；`command_started`、`command_input_loaded`、`workspace_preparation_started`、`repository_preparation_started/completed`、`workspace_materials_ready`、`command_completed` 标识执行进度。停在仓库开始阶段通常需要检查本机 Git 网络和凭证；`heartbeat_failed` / `command_result_unknown` 表明平台通信或回执失败，结合相同标识查询 API 日志。日志不包含命令正文、凭证和环境变量。
+
+需要重新安装新 Runtime 才能获得并发执行与 Windows 日志；仅部署 API/Web 或重启旧 Host 不会更新本地代码。重新运行平台账户页的安装命令会保留本机身份、凭证与工作目录，无需解绑重新注册。

package/dist/coding-run-manager.d.ts

@@ -96,6 +96,7 @@ interface RunInput {
         id: string;
         name: string;
         repositoryUrl: string;
+        sshRepositoryUrl?: string | null;
         baselineCommit: string;
         baselineBranch: string;
         devBranch: string;
@@ -139,7 +140,7 @@ export declare function openPiSession(options: {
     session: AgentSession;
     sessionId: string;
 }>;
-export declare function prepareDeploymentProjects(runRoot: string, projects: Array<Pick<RunInput["projects"][number], "id" | "name" | "repositoryUrl" | "testBranch">>, configuration?: DeploymentConfigurationSnapshot): Promise<string>;
+export declare function prepareDeploymentProjects(runRoot: string, projects: Array<Pick<RunInput["projects"][number], "id" | "name" | "repositoryUrl" | "sshRepositoryUrl" | "testBranch">>, configuration?: DeploymentConfigurationSnapshot): Promise<string>;
 export declare function prepareProjects(cacheRoot: string, runRoot: string, workItemKey: string, projects: RunInput["projects"], resume: boolean, verifyRemote?: boolean, uninitializedProjectIds?: string[]): Promise<string>;
 export declare function initialPrompt(input: RunInput, runRoot: string, _responsible?: boolean, materialRoot?: string): string;
 export declare function redactHostText(value: string, roots?: string[]): string;

package/dist/coding-run-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coding-run-manager.d.ts","sourceRoot":"","sources":["../src/coding-run-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coding-run-manager.d.ts","sourceRoot":"","sources":["../src/coding-run-manager.ts"],"names":[],"mappings":"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"}

package/dist/coding-run-manager.js

@@ -5,6 +5,8 @@ import { basename, dirname, join, resolve } from "node:path";
 import { promisify } from "node:util";
 import { createAgentSession, DefaultResourceLoader, SessionManager, } from "@earendil-works/pi-coding-agent";
 import { deliveryTools } from "./delivery-tools.js";
+import { ensureSshOrigin, gitTransportUrl, matchesRepository, SSH_ACCESS_HINT, } from "./git-transport.js";
+import { logHostEvent } from "./host-log.js";
 import { inspectHandoffWorkspace, synchronizeLocalIntake, synchronizeRemoteWorkspace, } from "./local-handoff-workspace.js";
 import { localModelUsage } from "./local-model-usage.js";
 import { collectProjectFacts, worktreeTreeHash } from "./project-facts.js";
@@ -315,6 +317,7 @@ export class CodingRunManager {
         const transferNotes = input.transferContinuation && !storedState?.prepared
             ? await inspectPriorTransferWorkspaces(local.runWorktrees, input.transferWorkspaces?.priorRunIds ?? [], input.projects)
             : [];
+        logHostEvent("workspace_preparation_started", { runId, turnId, phase: input.phase });
         const cwd = input.discussionTurn
             ? input.projects.length === 1
                 ? join(runRoot, safeName(input.projects[0].name))
@@ -341,7 +344,9 @@ export class CodingRunManager {
                 })).stdout.trim();
             await writeSecureJson(stateFile, { ...storedState, preparationBaselines });
         }
+        logHostEvent("workspace_repositories_ready", { runId, turnId });
         await initializeDeliveryFiles(runRoot, input, Boolean(storedState?.prepared), readMaterial);
+        logHostEvent("workspace_materials_ready", { runId, turnId });
         const deliveryInputHash = createHash("sha256")
             .update(JSON.stringify([
             input.primaryProjectId,
@@ -1122,10 +1127,10 @@ export async function prepareDeploymentProjects(runRoot, projects, configuration
                 "--branch",
                 branch,
                 "--",
-                project.repositoryUrl,
+                gitTransportUrl(project.repositoryUrl, project.sshRepositoryUrl),
                 target,
             ]).catch(() => {
-                throw new Error("DEPLOYMENT_REPOSITORY_PREPARE_FAILED");
+                throw new Error(`DEPLOYMENT_REPOSITORY_PREPARE_FAILED：${SSH_ACCESS_HINT}`);
             });
         }
         // Reuse the interrupted deployment as-is; the employee resolves its Git state.
@@ -1133,119 +1138,143 @@ export async function prepareDeploymentProjects(runRoot, projects, configuration
             execFileAsync("git", ["config", "--get", "remote.origin.url"], { cwd: target }),
             execFileAsync("git", ["rev-parse", "--git-common-dir"], { cwd: target }),
         ]);
-        if ((await canonicalRepository(origin.trim())) !==
-            (await canonicalRepository(project.repositoryUrl)))
+        if (!(await matchesRepository(origin.trim(), project.repositoryUrl, project.sshRepositoryUrl)))
             throw new Error("CODING_REPOSITORY_ORIGIN_MISMATCH");
         if ((await realpath(resolve(target, common.trim()))) !== (await realpath(join(target, ".git"))))
             throw new Error("DEPLOYMENT_REPOSITORY_NOT_ISOLATED");
+        await ensureSshOrigin(target, project.repositoryUrl, project.sshRepositoryUrl);
     }
     return projects.length === 1 ? join(runRoot, safeName(projects[0].name)) : runRoot;
 }
+const repositoryPreparations = new Map();
 export async function prepareProjects(cacheRoot, runRoot, workItemKey, projects, resume, verifyRemote = false, uninitializedProjectIds = []) {
     await mkdir(cacheRoot, { recursive: true, mode: 0o700 });
     for (const project of projects) {
         const mirror = join(cacheRoot, `${project.id}.git`);
-        if (!(await exists(mirror))) {
-            await execFileAsync("git", ["clone", "--bare", project.repositoryUrl, mirror]).catch(() => {
-                throw new Error("CODING_REPOSITORY_ACCESS_FAILED");
-            });
-        }
-        else {
-            const [{ stdout: bare }, { stdout: origin }] = await Promise.all([
-                execFileAsync("git", ["--git-dir", mirror, "rev-parse", "--is-bare-repository"]),
-                execFileAsync("git", ["--git-dir", mirror, "config", "--get", "remote.origin.url"]),
-            ]);
-            if (bare.trim() !== "true")
-                throw new Error("CODING_REPOSITORY_CACHE_NOT_BARE");
-            if ((await canonicalRepository(origin.trim())) !==
-                (await canonicalRepository(project.repositoryUrl)))
-                throw new Error("CODING_REPOSITORY_ORIGIN_MISMATCH");
-        }
-        if (!resume || verifyRemote) {
-            // Never fetch into local branch refs: stopped worktrees may contain unpublished commits.
-            await execFileAsync("git", [
-                "--git-dir",
-                mirror,
-                "config",
-                "--replace-all",
-                "remote.origin.fetch",
-                "+refs/heads/*:refs/remotes/origin/*",
-            ]);
-            await execFileAsync("git", ["--git-dir", mirror, "fetch", "--prune", "origin"]).catch(() => {
-                throw new Error("CODING_REPOSITORY_ACCESS_FAILED");
-            });
-        }
-        const target = join(runRoot, safeName(project.name));
-        const expectedBranch = project.devBranch || `aip/${workItemKey}`;
-        const existingWorktree = await exists(target);
-        if (!existingWorktree) {
-            if (resume)
-                throw new Error("CODING_RUN_WORKTREE_MISSING");
-            const remoteExists = await execFileAsync("git", [
-                "--git-dir",
-                mirror,
-                "show-ref",
-                "--verify",
-                "--quiet",
-                `refs/remotes/origin/${expectedBranch}`,
-            ]).then(() => true, () => false);
-            const localExists = await execFileAsync("git", [
-                "--git-dir",
-                mirror,
-                "show-ref",
-                "--verify",
-                "--quiet",
-                `refs/heads/${expectedBranch}`,
-            ]).then(() => true, () => false);
-            if (remoteExists) {
-                // A new execution owns its branch ref; an old execution keeps its worktree untouched.
+        // 多个 Run 共享镜像仓库：仅串行此仓库的 clone/fetch/worktree 元数据操作。
+        const previous = repositoryPreparations.get(mirror);
+        let release;
+        const pending = new Promise((resolve) => {
+            release = resolve;
+        });
+        repositoryPreparations.set(mirror, pending);
+        logHostEvent("repository_preparation_waiting", { projectId: project.id, workItemKey });
+        await previous;
+        try {
+            logHostEvent("repository_preparation_started", { projectId: project.id, workItemKey });
+            if (!(await exists(mirror))) {
                 await execFileAsync("git", [
                     "clone",
-                    "--single-branch",
-                    "--branch",
-                    expectedBranch,
-                    project.repositoryUrl,
-                    target,
+                    "--bare",
+                    gitTransportUrl(project.repositoryUrl, project.sshRepositoryUrl),
+                    mirror,
                 ]).catch(() => {
-                    throw new Error("CODING_REPOSITORY_ACCESS_FAILED");
+                    throw new Error(`CODING_REPOSITORY_ACCESS_FAILED：${SSH_ACCESS_HINT}`);
                 });
             }
             else {
-                if (localExists || (verifyRemote && !uninitializedProjectIds.includes(project.id)))
-                    throw new Error(localExists
-                        ? "CODING_BRANCH_NOT_PUBLISHED：本机工单分支尚未推送，请检查并同步后再继续。"
-                        : "CODING_BRANCH_INITIALIZATION_UNCONFIRMED：远端尚无工单分支，原工作区初始化状态未确认，请检查后再继续。");
+                const [{ stdout: bare }, { stdout: origin }] = await Promise.all([
+                    execFileAsync("git", ["--git-dir", mirror, "rev-parse", "--is-bare-repository"]),
+                    execFileAsync("git", ["--git-dir", mirror, "config", "--get", "remote.origin.url"]),
+                ]);
+                if (bare.trim() !== "true")
+                    throw new Error("CODING_REPOSITORY_CACHE_NOT_BARE");
+                if (!(await matchesRepository(origin.trim(), project.repositoryUrl, project.sshRepositoryUrl)))
+                    throw new Error("CODING_REPOSITORY_ORIGIN_MISMATCH");
+            }
+            await ensureSshOrigin(mirror, project.repositoryUrl, project.sshRepositoryUrl);
+            if (!resume || verifyRemote) {
+                // Never fetch into local branch refs: stopped worktrees may contain unpublished commits.
                 await execFileAsync("git", [
                     "--git-dir",
                     mirror,
-                    "cat-file",
-                    "-e",
-                    `refs/remotes/origin/${project.baselineBranch}`,
-                ]).catch(() => {
-                    throw new Error("CODING_BASELINE_BRANCH_UNAVAILABLE");
+                    "config",
+                    "--replace-all",
+                    "remote.origin.fetch",
+                    "+refs/heads/*:refs/remotes/origin/*",
+                ]);
+                await execFileAsync("git", ["--git-dir", mirror, "fetch", "--prune", "origin"]).catch(() => {
+                    throw new Error(`CODING_REPOSITORY_ACCESS_FAILED：${SSH_ACCESS_HINT}`);
                 });
-                await execFileAsync("git", [
+            }
+            const target = join(runRoot, safeName(project.name));
+            const expectedBranch = project.devBranch || `aip/${workItemKey}`;
+            const existingWorktree = await exists(target);
+            if (!existingWorktree) {
+                if (resume)
+                    throw new Error("CODING_RUN_WORKTREE_MISSING");
+                const remoteExists = await execFileAsync("git", [
                     "--git-dir",
                     mirror,
-                    "worktree",
-                    "add",
-                    "-b",
-                    expectedBranch,
-                    target,
-                    `refs/remotes/origin/${project.baselineBranch}`,
-                ]).catch(() => {
-                    throw new Error("CODING_WORKTREE_CREATE_FAILED");
-                });
+                    "show-ref",
+                    "--verify",
+                    "--quiet",
+                    `refs/remotes/origin/${expectedBranch}`,
+                ]).then(() => true, () => false);
+                const localExists = await execFileAsync("git", [
+                    "--git-dir",
+                    mirror,
+                    "show-ref",
+                    "--verify",
+                    "--quiet",
+                    `refs/heads/${expectedBranch}`,
+                ]).then(() => true, () => false);
+                if (remoteExists) {
+                    // A new execution owns its branch ref; an old execution keeps its worktree untouched.
+                    await execFileAsync("git", [
+                        "clone",
+                        "--single-branch",
+                        "--branch",
+                        expectedBranch,
+                        gitTransportUrl(project.repositoryUrl, project.sshRepositoryUrl),
+                        target,
+                    ]).catch(() => {
+                        throw new Error(`CODING_REPOSITORY_ACCESS_FAILED：${SSH_ACCESS_HINT}`);
+                    });
+                }
+                else {
+                    if (localExists || (verifyRemote && !uninitializedProjectIds.includes(project.id)))
+                        throw new Error(localExists
+                            ? "CODING_BRANCH_NOT_PUBLISHED：本机工单分支尚未推送，请检查并同步后再继续。"
+                            : "CODING_BRANCH_INITIALIZATION_UNCONFIRMED：远端尚无工单分支，原工作区初始化状态未确认，请检查后再继续。");
+                    await execFileAsync("git", [
+                        "--git-dir",
+                        mirror,
+                        "cat-file",
+                        "-e",
+                        `refs/remotes/origin/${project.baselineBranch}`,
+                    ]).catch(() => {
+                        throw new Error("CODING_BASELINE_BRANCH_UNAVAILABLE");
+                    });
+                    await execFileAsync("git", [
+                        "--git-dir",
+                        mirror,
+                        "worktree",
+                        "add",
+                        "-b",
+                        expectedBranch,
+                        target,
+                        `refs/remotes/origin/${project.baselineBranch}`,
+                    ]).catch(() => {
+                        throw new Error("CODING_WORKTREE_CREATE_FAILED");
+                    });
+                }
             }
+            await validateWorktree(mirror, target, expectedBranch, resume || existingWorktree, project.repositoryUrl, project.sshRepositoryUrl);
+            if (existingWorktree && verifyRemote)
+                await synchronizeRemoteWorkspace(target, expectedBranch);
+            logHostEvent("repository_preparation_completed", { projectId: project.id, workItemKey });
+        }
+        finally {
+            if (repositoryPreparations.get(mirror) === pending)
+                repositoryPreparations.delete(mirror);
+            release();
         }
-        await validateWorktree(mirror, target, expectedBranch, resume || existingWorktree, project.repositoryUrl);
-        if (existingWorktree && verifyRemote)
-            await synchronizeRemoteWorkspace(target, expectedBranch);
     }
     const onlyProject = projects.length === 1 ? projects[0] : null;
     return onlyProject ? join(runRoot, safeName(onlyProject.name)) : runRoot;
 }
-async function validateWorktree(mirror, target, expectedBranch, resume, repositoryUrl) {
+async function validateWorktree(mirror, target, expectedBranch, resume, repositoryUrl, sshRepositoryUrl) {
     const facts = await Promise.all([
         execFileAsync("git", ["rev-parse", "--is-inside-work-tree"], { cwd: target }),
         execFileAsync("git", ["rev-parse", "--git-common-dir"], { cwd: target }),
@@ -1264,14 +1293,15 @@ async function validateWorktree(mirror, target, expectedBranch, resume, reposito
     if (actualCommon !== expectedCommon) {
         if (actualCommon !== (await realpath(join(target, ".git"))))
             throw new Error("CODING_WORKTREE_OWNERSHIP_INVALID");
-        const { stdout: origin } = await execFileAsync("git", ["remote", "get-url", "origin"], {
+        const { stdout: origin } = await execFileAsync("git", ["config", "--get", "remote.origin.url"], {
             cwd: target,
         });
-        if ((await canonicalRepository(origin.trim())) !== (await canonicalRepository(repositoryUrl)))
+        if (!(await matchesRepository(origin.trim(), repositoryUrl, sshRepositoryUrl)))
             throw new Error("CODING_REPOSITORY_ORIGIN_MISMATCH");
     }
     if (branch.trim() !== expectedBranch)
         throw new Error("CODING_WORKTREE_BRANCH_MISMATCH");
+    await ensureSshOrigin(target, repositoryUrl, sshRepositoryUrl);
     if (resume)
         return;
     const { stdout: status } = await execFileAsync("git", ["status", "--porcelain"], {
@@ -1280,15 +1310,6 @@ async function validateWorktree(mirror, target, expectedBranch, resume, reposito
     if (status.trim())
         throw new Error("CODING_WORKTREE_NOT_CLEAN");
 }
-async function canonicalRepository(value) {
-    if (value.startsWith("/"))
-        return realpath(value).catch(() => resolve(value));
-    if (value.startsWith("file://")) {
-        const path = new URL(value);
-        return realpath(path).catch(() => resolve(path.pathname));
-    }
-    return value.replace(/\/$/u, "");
-}
 function executionInstructions(input, runRoot) {
     // 环境事实与授权单独呈现，业务方法由平台 nodeRules 提供。
     return `本轮执行上下文：\n${JSON.stringify({
@@ -1426,10 +1447,10 @@ export async function inspectPriorTransferWorkspaces(root, runIds, projects) {
                 }
                 const origin = (await execFileAsync("git", ["config", "--get", "remote.origin.url"], { cwd })).stdout.trim();
                 const branch = (await execFileAsync("git", ["branch", "--show-current"], { cwd })).stdout.trim();
-                if ((await canonicalRepository(origin)) !==
-                    (await canonicalRepository(project.repositoryUrl)) ||
+                if (!(await matchesRepository(origin, project.repositoryUrl, project.sshRepositoryUrl)) ||
                     branch !== project.devBranch)
                     throw new Error("WORKSPACE_IDENTITY_MISMATCH");
+                await ensureSshOrigin(cwd, project.repositoryUrl, project.sshRepositoryUrl);
                 await execFileAsync("git", ["fetch", "origin", `+refs/heads/${branch}:refs/remotes/origin/${branch}`], { cwd });
                 const counts = (await execFileAsync("git", ["rev-list", "--left-right", "--count", `HEAD...refs/remotes/origin/${branch}`], { cwd })).stdout
                     .trim()