feat: complete TASK-WP2-04 credit ledger

2026-08-02 23:27:10 +08:00
parent 9b4860cfc2
commit 4551d73e76
24 changed files with 3002 additions and 6 deletions
@@ -0,0 +1,111 @@
+import { createHash } from "node:crypto";
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+const phaseIndex = process.argv.indexOf("--phase");
+const phase = phaseIndex >= 0 ? process.argv[phaseIndex + 1] : "green";
+if (!['red', 'green'].includes(phase)) throw new Error(`Unsupported phase: ${phase}`);
+const runId = process.env.DADA_TDD_RUN_ID ?? `wp2-04-${phase}-${new Date().toISOString().replace(/[^0-9]/g, "")}`;
+const runDirectory = resolve("artifacts", "tdd", runId);
+const casesDirectory = resolve(runDirectory, "cases");
+if (existsSync(runDirectory)) throw new Error(`Evidence run already exists: ${runId}`);
+mkdirSync(casesDirectory, { recursive: true });
+
+const cases = [
+  {
+    acceptance: ["AC-03"],
+    evidence: ["request.json", "response.json", "db-diff.json"],
+    id: "TDD-WP2-CRED-001-reserve",
+    requirements: ["CREDIT-01", "CREDIT-02", "CREDIT-03", "CREDIT-05"],
+  },
+  {
+    acceptance: ["AC-28"],
+    evidence: ["response.json", "db-diff.json", "external-calls.json", "screenshots/insufficient.png"],
+    id: "TDD-WP2-CRED-001-insufficient",
+    requirements: ["CREDIT-04"],
+  },
+  {
+    acceptance: ["AC-03", "AC-04", "AC-29"],
+    evidence: ["worker-events.json", "db-diff.json", "fs-before.json", "fs-after.json"],
+    id: "TDD-WP2-CRED-001-finalize-once",
+    requirements: ["CREDIT-03", "CREDIT-05", "GEN-09", "GEN-10"],
+  },
+  {
+    acceptance: ["AC-29", "AC-50"],
+    evidence: ["response.json", "db-diff.json", "screenshots/negative-balance.png"],
+    id: "TDD-WP2-CRED-002-admin-adjustment",
+    requirements: ["CREDIT-05", "CREDIT-06", "ADMIN-01", "ADMIN-09"],
+  },
+];
+for (const item of cases) mkdirSync(resolve(casesDirectory, item.id), { recursive: true });
+
+const commands = phase === "red"
+  ? [
+      ["integration", ["exec", "vitest", "run", "tests/integration/wp2-04-credits.test.ts"]],
+      ["api", ["exec", "vitest", "run", "tests/api/wp2-04-credits.test.ts"]],
+      ["worker", ["exec", "vitest", "run", "tests/worker/wp2-04-credit-settlement.test.ts"]],
+      ["e2e", ["exec", "playwright", "test", "tests/e2e/credits.spec.ts", "--config", "playwright.config.ts"]],
+    ]
+  : [
+      ["integration", ["test:integration"]], ["api", ["test:api"]],
+      ["worker", ["test:worker"]], ["e2e", ["test:e2e"]], ["tdd-trace", ["validate:tdd-trace"]],
+    ];
+const environment = { ...process.env, DADA_EVIDENCE_DIR_CREDITS: casesDirectory };
+const commandResults = [];
+for (const [name, args] of commands) {
+  const command = `pnpm ${args.join(" ")}`;
+  const started_at = new Date().toISOString();
+  const result = spawnSync(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", command], { encoding: "utf8", env: environment });
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  commandResults.push({ command, exit_code: result.status ?? 1, finished_at: new Date().toISOString(), name, started_at });
+}
+const commandState = phase === "red"
+  ? commandResults.every((result) => result.exit_code !== 0)
+  : commandResults.every((result) => result.exit_code === 0);
+const manifest = {
+  path: "tasks.manifest.json",
+  sha256: createHash("sha256").update(readFileSync("tasks.manifest.json")).digest("hex").toUpperCase(),
+};
+const commit = spawnSync("git", ["rev-parse", "--short", "HEAD"], { encoding: "utf8" }).stdout.trim();
+const dirty = spawnSync("git", ["status", "--porcelain"], { encoding: "utf8" }).stdout.trim().length > 0;
+const summaries = [];
+for (const item of cases) {
+  const directory = resolve(casesDirectory, item.id);
+  writeFileSync(resolve(directory, "commands.json"), `${JSON.stringify({ commands: commandResults, phase, run_id: runId }, null, 2)}\n`);
+  if (phase === "red") {
+    writeFileSync(resolve(directory, "red-observation.json"), `${JSON.stringify({
+      expected_failure: "Credit service, immutable detailed ledger, settlement worker, credit APIs and credit/admin UI are absent",
+      status: commandState ? "red_confirmed" : "failed",
+    }, null, 2)}\n`);
+  }
+  const evidenceRefs = phase === "red" ? ["red-observation.json"] : item.evidence;
+  const missingEvidence = evidenceRefs.filter((file) => !existsSync(resolve(directory, file)));
+  const targetStatus = phase === "red" ? "red_confirmed" : "passed";
+  const status = commandState && missingEvidence.length === 0 ? targetStatus : "failed";
+  writeFileSync(resolve(directory, "result.json"), `${JSON.stringify({
+    acceptance_criteria: item.acceptance,
+    automation: ["automated"],
+    commit,
+    evidence_refs: evidenceRefs,
+    layer: ["DB", "API", "WRK", "E2E"],
+    manifest,
+    missing_evidence: missingEvidence,
+    phase,
+    requirements: item.requirements,
+    run_id: runId,
+    status,
+    task_id: "TASK-WP2-04",
+    test_id: item.id,
+    work_package: "WP-2",
+    worktree_under_test: dirty ? "uncommitted implementation" : "clean committed implementation",
+  }, null, 2)}\n`);
+  summaries.push({ missing_evidence: missingEvidence, status, test_id: item.id });
+}
+const targetStatus = phase === "red" ? "red_confirmed" : "passed";
+const status = summaries.every((item) => item.status === targetStatus) ? targetStatus : "failed";
+const summary = { cases: summaries, phase, run_id: runId, status };
+writeFileSync(resolve(runDirectory, "evidence.json"), `${JSON.stringify(summary, null, 2)}\n`);
+console.log(JSON.stringify(summary, null, 2));
+if (status !== targetStatus) process.exit(1);