@bf-meishijian/aip 0.0.5 → 0.0.7

package/dist/qa-contract.d.ts

@@ -0,0 +1,2 @@
+export { parseQaContract, parseQaEvidenceReferences, parseQaHttpExchange, parseQaManifest, parseQaSelection, validateTestCatalog, validateTestGroup, } from "@ai-platform/api-contracts";
+//# sourceMappingURL=qa-contract.d.ts.map

package/dist/qa-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-contract.d.ts","sourceRoot":"","sources":["../src/qa-contract.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC"}

package/dist/qa-contract.js

@@ -0,0 +1,165 @@
+import { Ajv } from "ajv";
+                                                                             
+export const qaTestGroupsSchema = {
+  type: "array",
+  minItems: 1,
+  items: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      id: { type: "string", minLength: 1 },
+      name: { type: "string", minLength: 1 },
+      environments: {
+        type: "array",
+        minItems: 1,
+        uniqueItems: true,
+        items: { type: "string", minLength: 1 },
+      },
+    },
+    required: ["id", "name", "environments"],
+  },
+}         ;
+export const qaContractSchema = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    contractVersion: { const: 1 },
+    language: { type: "string", minLength: 1 },
+    groups: qaTestGroupsSchema,
+    doctor: { type: "array", minItems: 1, items: { type: "string" } },
+    collect: { type: "array", minItems: 1, items: { type: "string" } },
+    check: { type: "array", minItems: 1, items: { type: "string" } },
+    run: { type: "array", minItems: 1, items: { type: "string" } },
+    reportDir: { type: "string", minLength: 1 },
+  },
+  required: [
+    "groups",
+    "contractVersion",
+    "language",
+    "doctor",
+    "collect",
+    "check",
+    "run",
+    "reportDir",
+  ],
+}         ;
+export const qaManifestSchema = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    contractVersion: { const: 1 },
+    language: { type: "string", minLength: 1 },
+    cases: {
+      type: "array",
+      items: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          caseId: {
+            type: "string",
+            pattern: "^[a-zA-Z][\\w-]*\\.[a-zA-Z][\\w-]*\\.[a-zA-Z][\\w.-]*$",
+          },
+          tags: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true },
+          suites: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true },
+          name: { type: "string", minLength: 1 },
+          kind: { enum: ["CASE", "FLOW"] },
+          domain: { type: "string", minLength: 1 },
+          file: { type: "string", minLength: 1 },
+          selector: { type: "string", minLength: 1 },
+          endpoint: { type: "string" },
+          stubs: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true },
+          covers: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true },
+        },
+        required: ["caseId", "kind", "domain", "file", "selector", "stubs"],
+      },
+      minItems: 1,
+    },
+  },
+  required: ["contractVersion", "language", "cases"],
+}         ;
+export const qaSelectionSchema = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    runId: { type: "string", minLength: 1 },
+    caseIds: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true },
+    domains: { type: "array", items: { type: "string", minLength: 1 }, uniqueItems: true },
+  },
+  required: ["runId", "caseIds", "domains"],
+}         ;
+
+const ajv = new Ajv({ allErrors: true });
+const contractValidator = ajv.compile(qaContractSchema);
+const manifestValidator = ajv.compile(qaManifestSchema);
+const selectionValidator = ajv.compile(qaSelectionSchema);
+export function parseQaContract(value         )                       {
+  if (!contractValidator(value))
+    throw new Error(`QA_CONTRACT_INVALID: ${ajv.errorsText(contractValidator.errors)}`);
+  const result = value                        ;
+  if (new Set(result.groups.map((g) => g.id)).size !== result.groups.length)
+    throw new Error("QA_GROUP_ID_DUPLICATE");
+  for (const key of ["doctor", "collect", "check", "run"]         ) {
+    if (
+      result[key].some((v) => /[\n\r\0]/u.test(v)) ||
+      /^(?:.*[\\/])?(?:sh|bash|zsh|cmd(?:\.exe)?|powershell(?:\.exe)?)$/iu.test(result[key][0] ) ||
+      result[key].some((v) => ["&&", "||", ";", "|", ">", "<"].includes(v))
+    )
+      throw new Error("QA_COMMAND_SHELL_FORBIDDEN");
+  }
+  if (
+    /^(?:[\\/]|[a-z]:)/iu.test(result.reportDir) ||
+    result.reportDir.split(/[\\/]/u).includes("..")
+  )
+    throw new Error("QA_REPORT_DIRECTORY_INVALID");
+  return result;
+}
+export function parseQaManifest(value         )             {
+  if (!manifestValidator(value))
+    throw new Error(`QA_MANIFEST_INVALID: ${ajv.errorsText(manifestValidator.errors)}`);
+  const result = value              ;
+  const ids = new Set(result.cases.map((c) => c.caseId));
+  if (ids.size !== result.cases.length) throw new Error("QA_CASE_ID_DUPLICATE");
+  for (const c of result.cases)
+    if (c.covers?.some((id) => !ids.has(id))) throw new Error("QA_COVERS_UNKNOWN");
+  return result;
+}
+export function parseQaSelection(value         )              {
+  if (!selectionValidator(value))
+    throw new Error(`QA_SELECTION_INVALID: ${ajv.errorsText(selectionValidator.errors)}`);
+  return value               ;
+}
+
+export function validateTestGroup(
+  groups                                 ,
+  manifest            ,
+  groupId        ,
+  environment        ,
+  caseIds          ,
+) {
+  const group = groups.find((g) => g.id === groupId);
+  if (!group) throw new Error("测试分组不存在，请刷新目录");
+  if (!group.environments.includes(environment)) throw new Error("所选环境不属于测试分组");
+  if (!caseIds.length) throw new Error("请选择用例后运行");
+  const invalid = caseIds.filter(
+    (id) => !manifest.cases.some((c) => c.caseId === id && c.domain === groupId),
+  );
+  if (invalid.length)
+    throw new Error(`用例不存在或不属于所选测试分组，请刷新目录：${invalid.join("、")}`);
+}
+export function validateTestCatalog(groups                                 , manifest            ) {
+  if (!new Ajv().validate(qaTestGroupsSchema, groups)) throw new Error("QA_GROUPS_INVALID");
+  if (new Set(groups.map((g) => g.id)).size !== groups.length)
+    throw new Error("QA_GROUP_ID_DUPLICATE");
+  const suites = new Map                ();
+  for (const c of manifest.cases) {
+    if (!groups.some((g) => g.id === c.domain))
+      throw new Error(`用例 ${c.caseId} 的测试分组未声明`);
+    for (const suite of c.suites ?? []) {
+      if (suites.has(suite) && suites.get(suite) !== c.domain)
+        throw new Error(`套件 ${suite} 跨测试分组`);
+      suites.set(suite, c.domain);
+    }
+  }
+}
+
+export { parseQaHttpExchange, parseQaEvidenceReferences } from "./qa-http-validation.js";

package/dist/qa-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-contract.js","sourceRoot":"","sources":["../src/qa-contract.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,4BAA4B,CAAC"}

package/dist/qa-http-validation.js

@@ -0,0 +1,145 @@
+import { Ajv } from "ajv";
+                                              
+export const qaHttpExchangeSchema = {
+  type: "object",
+  additionalProperties: false,
+  properties: {
+    step: { type: "string", minLength: 1 },
+    id: {
+      type: "string",
+    },
+    sequence: {
+      type: "integer",
+      minimum: 1,
+    },
+    startedAt: {
+      type: "string",
+    },
+    durationMs: {
+      type: "integer",
+      minimum: 0,
+    },
+    request: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        method: {
+          type: "string",
+        },
+        url: {
+          type: "string",
+        },
+        headers: {
+          type: "object",
+          additionalProperties: {
+            type: "array",
+            items: {
+              type: "string",
+            },
+          },
+        },
+        body: {
+          anyOf: [
+            {
+              type: "string",
+            },
+            {
+              type: "null",
+            },
+          ],
+        },
+        bodyAttachment: {
+          type: "string",
+        },
+      },
+      required: ["method", "url", "headers", "body"],
+    },
+    response: {
+      anyOf: [
+        {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            status: {
+              type: "integer",
+              minimum: 100,
+              maximum: 599,
+            },
+            headers: {
+              type: "object",
+              additionalProperties: {
+                type: "array",
+                items: {
+                  type: "string",
+                },
+              },
+            },
+            body: {
+              anyOf: [
+                {
+                  type: "string",
+                },
+                {
+                  type: "null",
+                },
+              ],
+            },
+            bodyAttachment: {
+              type: "string",
+            },
+          },
+          required: ["status", "headers", "body"],
+        },
+        {
+          type: "null",
+        },
+      ],
+    },
+    error: {
+      type: "string",
+    },
+  },
+  required: ["id", "sequence", "startedAt", "durationMs", "request", "response"],
+}         ;
+const ajv = new Ajv({ allErrors: true, strict: false });
+const validate = ajv.compile(qaHttpExchangeSchema);
+export function parseQaHttpExchange(value         )                 {
+  if (!validate(value))
+    throw new Error(`QA_HTTP_EXCHANGE_INVALID: ${ajv.errorsText(validate.errors)}`);
+  return value                  ;
+}
+
+export const qaEvidenceReferencesSchema = {
+  type: "array",
+  items: {
+    oneOf: [
+      {
+        type: "object",
+        additionalProperties: false,
+        required: ["kind", "exchangeId", "side", "label"],
+        properties: {
+          kind: { const: "http" },
+          exchangeId: { type: "string", minLength: 1 },
+          side: { enum: ["request", "response"] },
+          label: { type: "string" },
+        },
+      },
+      {
+        type: "object",
+        additionalProperties: false,
+        required: ["kind", "filename", "label"],
+        properties: {
+          kind: { const: "attachment" },
+          filename: { type: "string", minLength: 1 },
+          label: { type: "string" },
+        },
+      },
+    ],
+  },
+}         ;
+
+const validateReferences = new Ajv({ strict: false }).compile(qaEvidenceReferencesSchema);
+export function parseQaEvidenceReferences(value         )                                          {
+  if (!validateReferences(value)) throw new Error("QA_EVIDENCE_REFERENCES_INVALID");
+  return value                                           ;
+}

package/dist/qa-project-checkout.d.ts

@@ -0,0 +1,12 @@
+import type { QaHostCommandPayload } from "@ai-platform/api-contracts";
+type Project = Omit<QaHostCommandPayload["project"], "mainBranch">;
+export declare function qaProjectDirectory(project: Project): string;
+export declare function gitQa(args: string[], cwd?: string): Promise<string>;
+/** 同一 Host 的同项目任务排队；文件锁同时保护 CLI 与 daemon。 */
+export declare function withQaProject<T>(project: Project, work: () => Promise<T>): Promise<T>;
+/** 仅更新 Host 专用检出，不接触开发者工作目录。调用期间必须持有项目锁。 */
+export declare function prepareQaCheckout({ project }: {
+    project: Project;
+}): Promise<string>;
+export {};
+//# sourceMappingURL=qa-project-checkout.d.ts.map

package/dist/qa-project-checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-project-checkout.d.ts","sourceRoot":"","sources":["../src/qa-project-checkout.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,KAAK,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,CAAC;AAGnE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,UAGlD;AACD,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,mBAIvD;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoB3F;AAED,4CAA4C;AAC5C,wBAAsB,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,mBAqBxE"}

package/dist/qa-project-checkout.js

@@ -0,0 +1,68 @@
+import { execFile } from "node:child_process";
+import { access, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import lockfile from "proper-lockfile";
+import { paths } from "./paths.js";
+const exec = promisify(execFile);
+const pending = new Map();
+export function qaProjectDirectory(project) {
+    if (!/^[a-zA-Z0-9_-]+$/u.test(project.id))
+        throw new Error("QA_PROJECT_ID_INVALID");
+    return join(paths().workspaceRoot, "qa-projects", project.id);
+}
+export async function gitQa(args, cwd) {
+    return (await exec("git", args, { cwd, encoding: "utf8", maxBuffer: 1024 * 1024, timeout: 60_000 })).stdout.trim();
+}
+/** 同一 Host 的同项目任务排队；文件锁同时保护 CLI 与 daemon。 */
+export async function withQaProject(project, work) {
+    const directory = qaProjectDirectory(project);
+    const previous = pending.get(directory) ?? Promise.resolve();
+    const task = previous
+        .catch(() => undefined)
+        .then(async () => {
+        await mkdir(directory, { recursive: true, mode: 0o700 });
+        const release = await lockfile.lock(directory);
+        try {
+            return await work();
+        }
+        finally {
+            await release();
+        }
+    });
+    pending.set(directory, task);
+    try {
+        return await task;
+    }
+    finally {
+        if (pending.get(directory) === task)
+            pending.delete(directory);
+    }
+}
+/** 仅更新 Host 专用检出，不接触开发者工作目录。调用期间必须持有项目锁。 */
+export async function prepareQaCheckout({ project }) {
+    if (!project.commitSha || !/^[a-f\d]{40}$/iu.test(project.commitSha))
+        throw new Error("QA_COMMIT_REQUIRED");
+    if (!project.remoteUrl || project.remoteUrl.startsWith("-"))
+        throw new Error("QA_REMOTE_INVALID");
+    await gitQa(["check-ref-format", `refs/heads/${project.branch}`]);
+    const repository = join(qaProjectDirectory(project), "repository");
+    try {
+        await access(join(repository, ".git"));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        await gitQa(["init", repository]);
+        await gitQa(["remote", "add", "origin", project.remoteUrl], repository);
+    }
+    await gitQa(["remote", "set-url", "origin", project.remoteUrl], repository);
+    await gitQa(["fetch", "--no-tags", "origin", project.commitSha], repository);
+    // 上一次报告已独立保存；清理专用仓库内产物，避免将旧结果当成本次结果。
+    await gitQa(["clean", "-ffdx"], repository);
+    await gitQa(["checkout", "--detach", "--force", project.commitSha], repository);
+    if ((await gitQa(["rev-parse", "HEAD"], repository)) !== project.commitSha.toLowerCase())
+        throw new Error("QA_CHECKOUT_MISMATCH");
+    return repository;
+}
+//# sourceMappingURL=qa-project-checkout.js.map

package/dist/qa-project-checkout.js.map

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

package/dist/qa-session-manager.d.ts

@@ -0,0 +1,101 @@
+import type { LocalCodingHostClaimedCommand, QaAttachmentView, QaCheckpoint, QaHostCommandPayload, QaPreparedWorkspace } from "@ai-platform/api-contracts";
+import type { ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import type { PiModelService } from "./pi-model-service.js";
+import type { PlatformClient } from "./platform-client.js";
+import { bindHostTool } from "./tool-dispatch.js";
+type QaSessionInput = Omit<QaHostCommandPayload, "employee">;
+type Identity = {
+    hostId: string;
+    generation: number;
+    turnId: string;
+};
+type SessionEvent = {
+    id: string;
+    kind: string;
+    contentMarkdown: string;
+    payload?: Record<string, unknown>;
+};
+export interface QaSessionClient {
+    qaReadTestPlan: PlatformClient["qaReadTestPlan"];
+    qaSubmitTestPlan: PlatformClient["qaSubmitTestPlan"];
+    qaReadResults: PlatformClient["qaReadResults"];
+    qaReportDefects: PlatformClient["qaReportDefects"];
+    qaRequestRework: PlatformClient["qaRequestRework"];
+    qaResolveDefect: PlatformClient["qaResolveDefect"];
+    qaCompleteReview: PlatformClient["qaCompleteReview"];
+    qaReportAssetMerge: PlatformClient["qaReportAssetMerge"];
+    qaEmployeeConfig: PlatformClient["employeeConfig"];
+    qaEmployeeTool: PlatformClient["employeeTool"];
+    qaSessionEvents(id: string, body: Identity & {
+        events: SessionEvent[];
+    }): Promise<unknown>;
+    qaRequestExecution(id: string, body: Identity & {
+        branch: string;
+        environment: string;
+        caseIds?: string[];
+        domains?: string[];
+        note?: string;
+    }): Promise<unknown>;
+    qaUploadSessionAttachment(id: string, body: Identity & {
+        filename: string;
+        mediaType: string;
+        contentBase64: string;
+    }): Promise<QaAttachmentView>;
+    qaSubmitVerification(id: string, body: Identity & {
+        toolCallId: string;
+        content: string;
+        testItemIds: string[];
+        expected: string;
+        actual: string;
+        checkpoints: QaCheckpoint[];
+        unverifiableReason?: string;
+        steps: string[];
+        conclusion: "PASSED" | "FAILED" | "UNVERIFIABLE";
+        attachmentIds: string[];
+        ac?: string[];
+    }): Promise<unknown>;
+    qaSubmitConclusion(id: string, body: Identity & {
+        toolCallId: string;
+        contentMarkdown: string;
+        recommendation: "READY" | "NOT_READY";
+        unfinishedItems: string[];
+        risks: string[];
+        evidenceRefs: string[];
+    }): Promise<unknown>;
+}
+export declare class QaSessionManager {
+    private readonly pi;
+    private readonly active;
+    private readonly tasks;
+    constructor(pi: PiModelService);
+    isBusy(): boolean;
+    settled(sessionId: string): Promise<void>;
+    execute(client: QaSessionClient, { hostId, generation }: {
+        hostId: string;
+        generation: number;
+    }, command: LocalCodingHostClaimedCommand): Promise<void>;
+    private run;
+}
+export declare function prepareQaProject(input: QaSessionInput): Promise<string>;
+export declare function prepareQaWorkspace(input: QaSessionInput, cwd: string): Promise<QaPreparedWorkspace>;
+export declare function currentQaBranch(cwd: string): Promise<string>;
+/** 只采集 Git 事实；未知状态直接报错，不替 Agent 合并、推送或重试。 */
+export declare function readQaAssetState(cwd: string, remoteUrl: string, expectedBranch: string, mainBranch: string): Promise<{
+    sourceCommitSha: string;
+    mainCommitSha: string;
+    hasChanges: boolean;
+}>;
+export declare function verifyQaAssetMerge(cwd: string, remoteUrl: string, expectedBranch: string, mainBranch: string): Promise<{
+    sourceCommitSha: string;
+    mainCommitSha: string;
+}>;
+/** 对照批准内容及实际合入结果；主分支其他文件的并行改动不属于本次 QA。 */
+export declare function qaAssetContentChanged(cwd: string, approvedSource: string, approvedMain: string, source: string, main: string): Promise<boolean>;
+export declare function readQaScreenshot(cwd: string, filename: string): Promise<{
+    filename: string;
+    mediaType: string;
+    contentBase64: string;
+}>;
+export declare function qaTools(client: QaSessionClient, input: QaSessionInput, binding: Identity, cwd: string, definitions: Parameters<typeof bindHostTool>[0]): ExtensionFactory;
+export {};
+//# sourceMappingURL=qa-session-manager.d.ts.map

package/dist/qa-session-manager.d.ts.map

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