@ludecker/aaac 1.1.1 → 1.1.3

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
- * Verify website static assets + production build.
- * Used by advance-phase on create/update/fix verify completion.
+ * 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]
@@ -9,23 +9,42 @@
 import fs from "fs";
 import path from "path";
 import { spawnSync } from "child_process";
-import { fileURLToPath } from "url";
-import { REPO_ROOT, runDir, isoNow, writeJson } from "./lib.mjs";
+import { runDir, isoNow, writeJson, readJson } from "./lib.mjs";
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const WEBSITE_ROOT = path.join(REPO_ROOT, "apps/website");
-const INDEX_HTML = path.join(WEBSITE_ROOT, "index.html");
+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: "pnpm --filter @ludecker/website build" },
+  build: {
+    status: skipBuild ? "skipped" : "pending",
+    command: null,
+  },
+  verify_config: verifyConfig.enabled ? "enabled" : "disabled",
 };
 
 function fail(section, detail) {
@@ -40,11 +59,11 @@ function fail(section, detail) {
   console.error(`[verify-website-build] FAIL ${section}: ${detail}`);
 }
 
-function resolveRootAsset(assetPath) {
+function resolveRootAsset(assetPath, websiteRoot, appRootRel) {
   const rel = assetPath.replace(/^\//, "");
   const candidates = [
-    path.join(WEBSITE_ROOT, "public", rel),
-    path.join(WEBSITE_ROOT, rel),
+    path.join(websiteRoot, "public", rel),
+    path.join(websiteRoot, rel),
   ];
   for (const candidate of candidates) {
     if (fs.existsSync(candidate)) {
@@ -54,13 +73,13 @@ function resolveRootAsset(assetPath) {
   return null;
 }
 
-function checkStaticAssets() {
-  if (!fs.existsSync(INDEX_HTML)) {
-    fail("static_assets", `missing index.html at ${INDEX_HTML}`);
+function checkStaticAssets(indexHtml, websiteRoot, appRootRel) {
+  if (!fs.existsSync(indexHtml)) {
+    fail("static_assets", `missing index.html at ${indexHtml}`);
     return;
   }
 
-  const html = fs.readFileSync(INDEX_HTML, "utf8");
+  const html = fs.readFileSync(indexHtml, "utf8");
   const rootRefs = [
     ...html.matchAll(/\b(?:href|src)="(\/[^"#?]+)"/g),
   ].map((match) => match[1]);
@@ -70,28 +89,28 @@ function checkStaticAssets() {
     if (seen.has(ref) || ref.startsWith("//")) continue;
     seen.add(ref);
 
-    const resolved = resolveRootAsset(ref);
+    const resolved = resolveRootAsset(ref, websiteRoot, appRootRel);
     if (!resolved) {
       fail(
         "static_assets",
-        `${ref} not found under apps/website/public/ or apps/website/ (Vite dev resolves root paths to project root)`,
+        `${ref} not found under ${appRootRel}/public/ or ${appRootRel}/`,
       );
     }
   }
 }
 
-function runBuild() {
+function runBuild(build) {
   if (skipBuild) return;
 
-  const proc = spawnSync(
-    "pnpm",
-    ["--filter", "@ludecker/website", "build"],
-    {
-      cwd: REPO_ROOT,
-      encoding: "utf8",
-      env: { ...process.env, CI: "1" },
-    },
-  );
+  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();
@@ -114,12 +133,13 @@ function writeArtifact() {
   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}`,
-    `  command: ${JSON.stringify(results.build.command)}`,
+    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,
   ]
@@ -140,8 +160,25 @@ function writeArtifact() {
   }
 }
 
-checkStaticAssets();
-runBuild();
+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 }));

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
 

package/templates/cursor/rules/aaac-enforcement.mdc

@@ -11,8 +11,8 @@ Every AAAC slash command (`/fix-module`, `/update-module`, `/write-article`, …
 
 ## Prerequisites
 
-1. **Cursor Hooks enabled** — Settings → Hooks; restart Cursor after `.cursor/hooks.json` changes
-2. **Registry current** — `node .cursor/aaac/generate-graph.mjs`
+1. **Project opened in Cursor** — `.cursor/hooks.json` is installed by `init`; hooks run when the project is open
+2. **Registry current** — after ontology edits: `npx @ludecker/aaac@latest generate`
 
 ## Hook behavior (automatic)