@ludecker/aaac 1.1.0 → 1.1.2

package/templates/cursor/aaac/scripts/run-engine/verify-website-build.mjs

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+/**
+ * Verify app static assets + production build (project overlay).
+ * Skips when `.cursor/aaac/project.config.json` has `verify.enabled: false`.
+ *
+ * Usage:
+ *   node verify-website-build.mjs [--run-id <run_id>] [--skip-build]
+ */
+import fs from "fs";
+import path from "path";
+import { spawnSync } from "child_process";
+import { runDir, isoNow, writeJson, readJson } from "./lib.mjs";
+
+const PROJECT_ROOT = process.cwd();
+
+const args = process.argv.slice(2);
+const runIdIdx = args.indexOf("--run-id");
+const runId = runIdIdx >= 0 ? args[runIdIdx + 1] : null;
+const skipBuild = args.includes("--skip-build");
+
+function loadVerifyConfig() {
+  const configPath = path.join(PROJECT_ROOT, ".cursor/aaac/project.config.json");
+  const config = readJson(configPath, { verify: { enabled: false } });
+  const verify = config.verify ?? { enabled: false };
+  if (!verify.enabled) {
+    return { enabled: false };
+  }
+  const appRootRel = verify.app_root ?? "apps/website";
+  const indexRel =
+    verify.index_html ?? path.join(appRootRel, "index.html").replace(/\\/g, "/");
+  const appRoot = path.join(PROJECT_ROOT, appRootRel);
+  const indexHtml = path.join(PROJECT_ROOT, indexRel);
+  const build = verify.build ?? { command: "pnpm", args: ["run", "build"] };
+  return { enabled: true, appRoot, indexHtml, build, appRootRel };
+}
+
+const verifyConfig = loadVerifyConfig();
+
+const results = {
+  status: "pass",
+  checked_at: isoNow(),
+  static_assets: { status: "pass", missing: [] },
+  build: {
+    status: skipBuild ? "skipped" : "pending",
+    command: null,
+  },
+  verify_config: verifyConfig.enabled ? "enabled" : "disabled",
+};
+
+function fail(section, detail) {
+  results.status = "fail";
+  if (section === "static_assets") {
+    results.static_assets.status = "fail";
+    results.static_assets.missing.push(detail);
+  } else if (section === "build") {
+    results.build.status = "fail";
+    results.build.detail = detail;
+  }
+  console.error(`[verify-website-build] FAIL ${section}: ${detail}`);
+}
+
+function resolveRootAsset(assetPath, websiteRoot, appRootRel) {
+  const rel = assetPath.replace(/^\//, "");
+  const candidates = [
+    path.join(websiteRoot, "public", rel),
+    path.join(websiteRoot, rel),
+  ];
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+function checkStaticAssets(indexHtml, websiteRoot, appRootRel) {
+  if (!fs.existsSync(indexHtml)) {
+    fail("static_assets", `missing index.html at ${indexHtml}`);
+    return;
+  }
+
+  const html = fs.readFileSync(indexHtml, "utf8");
+  const rootRefs = [
+    ...html.matchAll(/\b(?:href|src)="(\/[^"#?]+)"/g),
+  ].map((match) => match[1]);
+
+  const seen = new Set();
+  for (const ref of rootRefs) {
+    if (seen.has(ref) || ref.startsWith("//")) continue;
+    seen.add(ref);
+
+    const resolved = resolveRootAsset(ref, websiteRoot, appRootRel);
+    if (!resolved) {
+      fail(
+        "static_assets",
+        `${ref} not found under ${appRootRel}/public/ or ${appRootRel}/`,
+      );
+    }
+  }
+}
+
+function runBuild(build) {
+  if (skipBuild) return;
+
+  const command = build.command ?? "pnpm";
+  const buildArgs = build.args ?? ["run", "build"];
+  results.build.command = [command, ...buildArgs].join(" ");
+
+  const proc = spawnSync(command, buildArgs, {
+    cwd: build.cwd ? path.join(PROJECT_ROOT, build.cwd) : PROJECT_ROOT,
+    encoding: "utf8",
+    env: { ...process.env, CI: "1" },
+  });
+
+  if (proc.status !== 0) {
+    const detail = [proc.stderr, proc.stdout].filter(Boolean).join("\n").trim();
+    results.build.status = "fail";
+    results.build.exit_code = proc.status ?? 1;
+    fail("build", detail || `exit ${proc.status}`);
+    return;
+  }
+
+  results.build.status = "pass";
+  results.build.exit_code = 0;
+}
+
+function writeArtifact() {
+  if (!runId) return;
+
+  const artifactDir = path.join(runDir(runId), "artifacts");
+  fs.mkdirSync(artifactDir, { recursive: true });
+
+  const yaml = [
+    `status: ${results.status}`,
+    `checked_at: ${results.checked_at}`,
+    `verify_config: ${results.verify_config}`,
+    "static_assets:",
+    `  status: ${results.static_assets.status}`,
+    `  missing: ${JSON.stringify(results.static_assets.missing)}`,
+    "build:",
+    `  status: ${results.build.status}`,
+    results.build.command ? `  command: ${JSON.stringify(results.build.command)}` : null,
+    results.build.exit_code != null ? `  exit_code: ${results.build.exit_code}` : null,
+    results.build.detail ? `  detail: ${JSON.stringify(results.build.detail)}` : null,
+  ]
+    .filter(Boolean)
+    .join("\n");
+
+  fs.writeFileSync(path.join(artifactDir, "verify.yaml"), `${yaml}\n`);
+
+  const manifestPath = path.join(runDir(runId), "run.json");
+  try {
+    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    manifest.artifacts = manifest.artifacts ?? {};
+    manifest.artifacts.verify = results;
+    manifest.updated_at = isoNow();
+    writeJson(manifestPath, manifest);
+  } catch {
+    // run.json may not exist in standalone invocations
+  }
+}
+
+if (!verifyConfig.enabled) {
+  results.static_assets.status = "skipped";
+  results.build.status = "skipped";
+  results.build.command = null;
+  writeArtifact();
+  console.log(JSON.stringify({ ok: true, skipped: true, reason: "verify.disabled", ...results }));
+  process.exit(0);
+}
+
+results.build.command = skipBuild
+  ? null
+  : [verifyConfig.build.command, ...(verifyConfig.build.args ?? [])].join(" ");
+
+checkStaticAssets(
+  verifyConfig.indexHtml,
+  verifyConfig.appRoot,
+  verifyConfig.appRootRel,
+);
+runBuild(verifyConfig.build);
+writeArtifact();
+
+console.log(JSON.stringify({ ok: results.status === "pass", ...results }));
+process.exit(results.status === "pass" ? 0 : 1);

package/templates/cursor/aaac/state/capability-stats.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "updated_at": null,
+  "capabilities": {}
+}

package/templates/cursor/agents/playwright-check-run.md

@@ -2,43 +2,25 @@
 
 ## Role
 
-Run AAAC verb contract Playwright checks and optional public-site smoke during verify.
+Run Playwright E2E checks from domain inventory during verify.
 
 ## When
 
-**Verify phase** for commands whose verb is `create`, `update`, or `fix` (including aliases such as `fix-module`, `create-component`, `update-module`).
+**Verify phase** for `create`, `update`, or `fix` verbs when inventory lists Playwright targets.
 
-**Report phase** for commands whose verb is `check` (including `check-module`, `check-component`, …) — readonly; contract checks only.
+**Report phase** for `check` verbs when project defines contract E2E specs.
 
-Contract checks always run. Browser smoke runs only when `PLAYWRIGHT_BASE_URL` is set.
+Browser smoke runs only when `PLAYWRIGHT_BASE_URL` is set.
 
 ## Commands
 
-From repo root:
+Use the command from domain inventory. Example:
 
 ```bash
-pnpm --filter @ludecker/aaac test:e2e
+pnpm exec playwright test
+PLAYWRIGHT_BASE_URL=http://localhost:3000 pnpm exec playwright test
 ```
 
-Optional website smoke (dev server or deployed URL):
-
-```bash
-PLAYWRIGHT_BASE_URL=http://localhost:3000 pnpm --filter @ludecker/aaac test:e2e
-```
-
-Interactive debugging:
-
-```bash
-pnpm --filter @ludecker/aaac test:e2e:ui
-```
-
-## What passes
-
-- `runtime-registry.json` command entries match `graph.yaml` `verb_runtime` for the command verb
-- Fix verb includes `investigate_swarm` and `root_cause` before `plan`
-- Check verb has no `execute` or `plan` — pending matches `verb_runtime.check`
-- Skipped browser tests when `PLAYWRIGHT_BASE_URL` is unset (CI default)
-
 ## Return
 
-Exit code, failing spec file names, contract mismatch details (command vs `verb_runtime`), browser smoke failures with route and status.
+Exit code, failing spec file names, browser smoke failures with route and status.

package/templates/cursor/agents/release-git.md

@@ -4,7 +4,7 @@
 
 ## Role
 
-Commit and push all pending work to `main` for the Lüdecker monorepo.
+Commit and push all pending work to the default branch for this repository.
 
 ## Inputs (from orchestrator)
 
@@ -16,7 +16,7 @@ Commit and push all pending work to `main` for the Lüdecker monorepo.
 
 Follow [ship-procedure.md § Git](../skills/shared/platform-release/ship-procedure.md).
 
-**Repo check:** `git rev-parse --show-toplevel` must be the ludecker monorepo.
+**Repo check:** `git rev-parse --show-toplevel` must be the project root (not a subdirectory).
 
 ## Return
 

package/templates/cursor/agents/unit-test-run.md

@@ -4,15 +4,11 @@
 
 Run targeted tests for paths from domain inventory. Report pass/fail with test names.
 
-## Lüdecker defaults
+## Defaults
 
-From repo root:
+From repo root, use the test command in domain inventory when listed (e.g. `pnpm test`, `npm test`, `cargo test`).
 
-```bash
-pnpm typecheck
-```
-
-If domain inventory lists vitest/jest targets, run those instead.
+If no inventory entry, run the project's root `package.json` `test` or `typecheck` script when present.
 
 ## Return