@sun-asterisk/sungen 3.1.2-beta.121 → 3.1.2-beta.123

package/src/cli/commands/repair.ts

@@ -0,0 +1,57 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { planRepair } from '../../harness/repair';
+
+/**
+ * `sungen repair` (#343) — turn a unit's audit findings + Playwright failures into a concrete fix
+ * plan, using the unit-capability's fix catalog (the `repair` SPI). Deterministic; the `/sungen:design`
+ * + `/sungen:run-test` repair loops apply the same proposals. Run `sungen audit`/the tests first.
+ */
+export function registerRepairCommand(program: Command): void {
+  program
+    .command('repair')
+    .description('Propose concrete fixes for a unit from its audit findings + test failures (capability fix catalog)')
+    .option('-s, --screen <name>', 'Screen or flow name')
+    .option('--api <name>', 'API-first area or api flow (qa/api/<name>)')
+    .option('--area <name>', 'Alias of --api — an API-first area (qa/api/<name>)')
+    .option('--json', 'Output raw JSON')
+    .action((o: { screen?: string; api?: string; area?: string; json?: boolean }) => {
+      try {
+        const name = o.screen || o.api || o.area;
+        if (!name) throw new Error('Provide --screen <name> (or --api <area>)');
+        const cwd = process.cwd();
+        // Capability-resolution id + the generated dir, per kind.
+        const kind = fs.existsSync(path.join(cwd, 'qa', 'api', name)) || o.api ? 'api'
+          : fs.existsSync(path.join(cwd, 'qa', 'flows', name)) ? 'flow' : 'screen';
+        const unitId = kind === 'api' ? `api/${name}` : kind === 'flow' ? `flows/${name}` : name;
+        const generatedDir = path.join(cwd, 'specs', 'generated', kind === 'api' ? path.join('api', name) : kind === 'flow' ? path.join('flows', name) : name);
+
+        const plan = planRepair(unitId, name, cwd, generatedDir);
+        if (o.json) { console.log(JSON.stringify(plan, null, 2)); return; }
+
+        const L = console.log;
+        L(`\n━━━ Repair plan: ${name} (capability: ${plan.capability ?? 'none'}) ━━━`);
+        if (!plan.rulesAvailable) L(`  (this capability ships no repair rules)`);
+        if (!plan.proposals.length && !plan.unmatched.length) {
+          L(`  ✓ Nothing to repair — run \`sungen audit --${kind === 'api' ? 'api' : 'screen'} ${name}\` + the tests first, or the unit is clean.\n`);
+          return;
+        }
+        if (plan.proposals.length) {
+          L(`\n  Proposed fixes (${plan.proposals.length}):`);
+          for (const p of plan.proposals) {
+            L(`    • [${p.ruleId}] ${p.source === 'runtime' ? '(test) ' : ''}${p.signal}`);
+            L(`        → ${p.fix}`);
+          }
+        }
+        if (plan.unmatched.length) {
+          L(`\n  No known rule (review manually):`);
+          for (const u of plan.unmatched.slice(0, 10)) L(`    - ${u}`);
+        }
+        L('');
+      } catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/commands/script-check.ts

@@ -9,10 +9,11 @@ export function registerScriptCheckCommand(program: Command): void {
     .description('Verify the generated Playwright spec is a faithful 1:1 of the Gherkin feature (no hand-edit / stale drift)')
     .option('-s, --screen <name>', 'Screen or flow name')
     .option('--api <name>', 'API-first area or api flow (qa/api/<name>)')
+    .option('--area <name>', 'Alias of --api — an API-first area (qa/api/<name>)')
     .option('--json', 'Output raw JSON')
     .action(async (options) => {
       try {
-        const name = options.screen || options.api;
+        const name = options.screen || options.api || options.area;
         if (!name) throw new Error('Provide --screen <name> (or --api <area>)');
         const screen = path.join(process.cwd(), 'qa', 'screens', name);
         const flow = path.join(process.cwd(), 'qa', 'flows', name);

package/src/cli/commands/trace.ts

@@ -9,11 +9,12 @@ export function registerTraceCommand(program: Command): void {
     .description('Visualise the executed test-design process (workflow/skill steps, repair loops), find bottlenecks, and show where to focus human review')
     .option('-s, --screen <name>', 'Screen or flow name')
     .option('--api <name>', 'API-first area or api flow (qa/api/<name>)')
+    .option('--area <name>', 'Alias of --api — an API-first area (qa/api/<name>)')
     .option('--json', 'Output raw JSON')
     .option('--mermaid', 'Print only the Mermaid flowchart')
     .action((options) => {
       try {
-        const name = options.screen || options.api;
+        const name = options.screen || options.api || options.area;
         if (!name) throw new Error('Provide --screen <name> (or --api <area>)');
         const screen = path.join(process.cwd(), 'qa', 'screens', name);
         const flow = path.join(process.cwd(), 'qa', 'flows', name);

package/src/cli/index.ts

@@ -27,6 +27,7 @@ import { registerBlindspotCommand } from './commands/blindspot';
 import { registerCapabilityCommand } from './commands/capability';
 import { registerFlowCheckCommand } from './commands/flow-check';
 import { registerContextCommand } from './commands/context';
+import { registerRepairCommand } from './commands/repair';
 import { capabilityRegistry } from '../capabilities/registry';
 import { discoverAndRegisterCapabilities } from '../capabilities/discover';
 
@@ -66,6 +67,7 @@ async function main() {
   registerCapabilityCommand(program);
   registerFlowCheckCommand(program);
   registerContextCommand(program);
+  registerRepairCommand(program);
   registerIngestCommand(program);
   registerEvalCommand(program);
 

package/src/harness/repair.ts

@@ -0,0 +1,75 @@
+/**
+ * Repair planner (#343) — the consumer of the `repair` capability SPI.
+ *
+ * Gathers the unit-capability's fix rules and matches them against the audit findings (always) and
+ * the latest Playwright failures (best-effort), turning them into a concrete fix plan. Deterministic:
+ * the AI repair loop and a human get the same proposals. Backs `sungen repair`.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { capabilityRegistry } from '../capabilities/registry';
+import { discoverAndRegisterCapabilities } from '../capabilities/discover';
+import { scoringCapabilityFor } from './audit';
+
+export interface RepairProposal { source: 'audit' | 'runtime'; signal: string; ruleId: string; fix: string }
+export interface RepairPlan {
+  capability: string | undefined;
+  rulesAvailable: number;
+  proposals: RepairProposal[];
+  unmatched: string[];     // findings/failures with no matching rule (need a human)
+}
+
+/** Collect failure messages from a Playwright JSON result file (best-effort, defensive). */
+function failuresFromResult(file: string): string[] {
+  const out: string[] = [];
+  try {
+    const r = JSON.parse(fs.readFileSync(file, 'utf8'));
+    const visit = (suite: any) => {
+      for (const sp of suite.specs ?? []) {
+        for (const t of sp.tests ?? []) {
+          for (const res of t.results ?? []) {
+            if (res.status === 'failed' || res.status === 'timedOut') {
+              const msg = res.error?.message || res.errors?.[0]?.message || res.status;
+              out.push(`${sp.title}: ${String(msg).split('\n')[0].slice(0, 200)}`);
+            }
+          }
+        }
+      }
+      for (const s of suite.suites ?? []) visit(s);
+    };
+    for (const s of r.suites ?? []) visit(s);
+  } catch { /* missing/!json → no runtime signals */ }
+  return out;
+}
+
+/**
+ * Build the repair plan for a unit.
+ * @param unitId      capability-resolution id (`api/<area>`, `flows/<flow>`, or a screen)
+ * @param reportName  the bare name used for `.sungen/reports/<name>-audit.json` (+ test-result)
+ * @param generatedDir the unit's specs/generated dir (for runtime failures); optional
+ */
+export function planRepair(unitId: string, reportName: string, cwd: string, generatedDir?: string): RepairPlan {
+  discoverAndRegisterCapabilities();
+  const capId = scoringCapabilityFor(unitId, capabilityRegistry.defaultCapabilityId());
+  const rules = (capId ? capabilityRegistry.get(capId)?.repair?.rules : undefined) ?? [];
+
+  const signals: { source: 'audit' | 'runtime'; text: string }[] = [];
+  const auditPath = path.join(cwd, '.sungen', 'reports', `${reportName}-audit.json`);
+  if (fs.existsSync(auditPath)) {
+    try { for (const f of JSON.parse(fs.readFileSync(auditPath, 'utf8')).findings ?? []) signals.push({ source: 'audit', text: String(f) }); } catch { /* ignore */ }
+  }
+  if (generatedDir && fs.existsSync(generatedDir)) {
+    for (const f of fs.readdirSync(generatedDir)) {
+      if (/test-result.*\.json$/.test(f)) for (const msg of failuresFromResult(path.join(generatedDir, f))) signals.push({ source: 'runtime', text: msg });
+    }
+  }
+
+  const proposals: RepairProposal[] = [];
+  const unmatched: string[] = [];
+  for (const s of signals) {
+    const rule = rules.find((r) => r.match.test(s.text));
+    if (rule) proposals.push({ source: s.source, signal: s.text, ruleId: rule.id, fix: rule.fix });
+    else unmatched.push(s.text);
+  }
+  return { capability: capId, rulesAvailable: rules.length, proposals, unmatched };
+}

package/src/index.ts

@@ -8,7 +8,7 @@
 export { capabilityRegistry, CapabilityRegistry } from './capabilities/registry';
 export type { CapabilityDescriptor } from './capabilities/registry';
 export type { Sensor, SensorFinding, AdvisoryScanInput, GateInput } from './capabilities/sensor';
-export type { Context, DiscoveryProvider, ContextMapper, GenerationUnit } from './capabilities/context';
+export type { Context, DiscoveryProvider, ContextMapper, GenerationUnit, RepairProvider, RepairRule } from './capabilities/context';
 export { discoverUnitContext } from './orchestrator/context-discovery';
 export type { DiscoveredContext } from './orchestrator/context-discovery';
 

package/src/orchestrator/templates/ai-instructions/claude-cmd-create-test.md

@@ -27,7 +27,7 @@ Parse **name** from `$ARGUMENTS`. If missing, ask the user.
 
 ## API unit mode (driver-api)
 
-If the unit is **api-first** (`qa/api/<name>/` or `qa/api/flows/<name>/`), the design loop differs — **no visual capture, no selectors**; the contract is the named-endpoint catalog. **Follow the `sungen-api-design` skill end-to-end** instead of the screen/flow steps below: `sungen context --api <name>` (discover) → API viewpoint overview → generate `@api`/`@cases`/flow/`@concurrent`/`@query` scenarios → **`sungen audit --api <name>` gate + the `sungen-reviewer` sub-agent + repair loop to businessDepth ≥ 0.7** → record + trace. Then jump to the "Converge" next-step options (recommend `/sungen:run-test <name>`). The capture / viewpoint-group / selector steps do **not** apply.
+If the unit is **api-first** (`qa/api/<name>/` or `qa/api/flows/<name>/`), the design loop differs — **no visual capture, no selectors**; the contract is the named-endpoint catalog. **Follow the `sungen-api-design` skill end-to-end** instead of the screen/flow steps below: `sungen context --area <name>` (discover) → API viewpoint overview → generate `@api`/`@cases`/flow/`@concurrent`/`@query` scenarios → **`sungen audit --area <name>` gate + the `sungen-reviewer` sub-agent + repair loop to businessDepth ≥ 0.7** → record + trace. Then jump to the "Converge" next-step options (recommend `/sungen:run-test <name>`). The capture / viewpoint-group / selector steps do **not** apply.
 
 ## Steps
 

package/src/orchestrator/templates/ai-instructions/claude-cmd-run-test.md

@@ -37,15 +37,15 @@ Skip this pre-flight when `--env` matches the base locale (no overlay needed in
 If the unit is **api-first**, skip every selector/capture phase (an API test has no DOM). Instead:
 
 1. **Resolve the datasource** — ensure the `kind: api` datasource's `base_url` + auth are wired in `qa/datasources.yaml` + `.env.qa` (the `${X_URL}` key from `sungen api init`). A `production` datasource is refused unless `SUNGEN_ALLOW_PROD=1`.
-2. **Compile**: `[ -x ./bin/sungen.js ] && ./bin/sungen.js generate --api <name> || npx sungen generate --api <name>` → `specs/generated/api/<name>/`.
+2. **Compile**: `[ -x ./bin/sungen.js ] && ./bin/sungen.js generate --area <name> || npx sungen generate --area <name>` → `specs/generated/api/<name>/`.
 3. **Run**: `npx playwright test specs/generated/api/<name>/<name>.spec.ts` (per-spec JSON results, as below).
 4. **Auto-fix** (no selectors — the failure classes differ): use `sungen-error-mapping`.
    - **401/403** → wire `@hybrid` + `@auth:<role>` (reuse the UI session) or the catalog `Bearer :token` header; suggest `sungen makeauth <role>`.
    - **datasource/base_url unresolved** → set the `${X_URL}` key in `.env.qa`.
    - **missing/empty bound param** → trace `{{var}}` to test-data or a prior `@api` response; fill it.
-   - **`expect.status` mismatch** → reconcile against `apis.yaml`/spec (the catalog is the oracle); **never hand-edit the generated spec** (re-`generate --api` instead).
+   - **`expect.status` mismatch** → reconcile against `apis.yaml`/spec (the catalog is the oracle); **never hand-edit the generated spec** (re-`generate --area` instead).
    - **flaky** → enforce self-cleaning flows, per-row isolation (`@cases`), `@concurrent` caps.
-5. **Integrity + trace** — `sungen script-check --api <name>` (verify the spec is a 1:1 of the Gherkin; on DRIFT re-`generate --api`, never hand-edit) and `sungen trace --api <name>` (process map + HUMAN-LOOP FOCUS). Then report + offer next steps.
+5. **Integrity + trace** — `sungen script-check --area <name>` (verify the spec is a 1:1 of the Gherkin; on DRIFT re-`generate --area`, never hand-edit) and `sungen trace --area <name>` (process map + HUMAN-LOOP FOCUS). Then report + offer next steps.
 
 ## Pre-run (phased — per `sungen-selector-fix` skill)
 

package/src/orchestrator/templates/ai-instructions/claude-skill-api-design.md

@@ -1,6 +1,6 @@
 ---
 name: sungen-api-design
-description: The API-first design loop for an api unit (qa/api/<area> or qa/api/flows/<flow>) — discover the catalog, lay out the API viewpoints, generate @api/@cases/flow/@concurrent scenarios, then drive the sungen audit --api gate + reviewer + repair to a high businessDepth (≥0.7). Use when create-test/run-test detects an api unit (no selectors, no visual capture).
+description: The API-first design loop for an api unit (qa/api/<area> or qa/api/flows/<flow>) — discover the catalog, lay out the API viewpoints, generate @api/@cases/flow/@concurrent scenarios, then drive the sungen audit --area gate + reviewer + repair to a high businessDepth (≥0.7). Use when create-test/run-test detects an api unit (no selectors, no visual capture).
 ---
 
 # API design loop (driver-api · Orchestration + Harness)
@@ -10,7 +10,7 @@ Use this when the unit is **api-first** — `qa/api/<area>/` or `qa/api/flows/<f
 ## The loop (mirror of /sungen:design, API-native)
 
 ### 1. Discover (no capture)
-Run `sungen context --api <name>` — it reads the catalog and prints the **endpoints** + the **generation units** (one `matrix` unit per endpoint, an `async` unit per mutating endpoint, a `flow` unit for an api flow). Read `qa/api/<name>/requirements/spec.md` if present. No `apis.yaml` yet? → `sungen api import <openapi|csv>` or `sungen api add --area <name>` first.
+Run `sungen context --area <name>` — it reads the catalog and prints the **endpoints** + the **generation units** (one `matrix` unit per endpoint, an `async` unit per mutating endpoint, a `flow` unit for an api flow). Read `qa/api/<name>/requirements/spec.md` if present. No `apis.yaml` yet? → `sungen api import <openapi|csv>` or `sungen api add --area <name>` first.
 
 ### 2. API viewpoint overview (by method-profile)
 For each endpoint, cover its viewpoints — severity-weighted by method:
@@ -29,7 +29,7 @@ Bands: **~70%** success+failure matrix · **~20%** flows (auth/CRUD chains) · *
 - **Idempotency**: `@api:<name> @concurrent:N` + `expect {{name.ok_count}} is 1`, cross-checked with `@query` (the DB is the oracle).
 
 ### 4. Gate + repair (always — businessDepth ≥ 0.7 is the bar)
-Run `sungen audit --api <name>`; read `gateStatus` + `findings`. Then the **semantic reviewer** (sungen-reviewer sub-agent, API criteria). Repair **both** (budget 3 rounds), re-audit until PASS:
+Run `sungen audit --area <name>`; read `gateStatus` + `findings`. Then the **semantic reviewer** (sungen-reviewer sub-agent, API criteria). Repair **both** (budget 3 rounds), re-audit until PASS:
 
 | Finding | Repair |
 |---|---|
@@ -41,7 +41,7 @@ Run `sungen audit --api <name>`; read `gateStatus` + `findings`. Then the **sema
 Stop when the gate PASSes + businessDepth ≥ 0.7, or the budget is exhausted → report residual gaps honestly (mark genuinely-unautomatable cases `@manual` with an oracle). Never fake a pass.
 
 ### 5. Record + converge
-`sungen manifest --api <name>` (reuse) and ledger each phase; show the trace + the HUMAN-LOOP FOCUS. (Integrity `script-check`/`trace` for api: see run-test.)
+`sungen manifest --area <name>` (reuse) and ledger each phase; show the trace + the HUMAN-LOOP FOCUS. (Integrity `script-check`/`trace` for api: see run-test.)
 
 ## Rules
 - **No HTTP, no selectors** — only `.feature` + the reviewed `apis.yaml` + `test-data`.

package/src/orchestrator/templates/ai-instructions/copilot-cmd-create-test.md

@@ -22,7 +22,7 @@ You are a **Senior QA Engineer**. You structure test cases by viewpoint categori
 
 ## API unit mode (driver-api)
 
-If the unit is **api-first** (`qa/api/<name>/` or `qa/api/flows/<name>/`), the design loop differs — **no visual capture, no selectors**; the contract is the named-endpoint catalog. **Follow the `sungen-api-design` skill end-to-end** instead of the screen/flow steps: `sungen context --api <name>` (discover) → API viewpoint overview → generate `@api`/`@cases`/flow/`@concurrent`/`@query` scenarios → **`sungen audit --api <name>` gate + reviewer + repair loop to businessDepth ≥ 0.7** → record + trace. Then recommend `/sungen-run-test <name>`. The capture / viewpoint-group / selector steps do **not** apply.
+If the unit is **api-first** (`qa/api/<name>/` or `qa/api/flows/<name>/`), the design loop differs — **no visual capture, no selectors**; the contract is the named-endpoint catalog. **Follow the `sungen-api-design` skill end-to-end** instead of the screen/flow steps: `sungen context --area <name>` (discover) → API viewpoint overview → generate `@api`/`@cases`/flow/`@concurrent`/`@query` scenarios → **`sungen audit --area <name>` gate + reviewer + repair loop to businessDepth ≥ 0.7** → record + trace. Then recommend `/sungen-run-test <name>`. The capture / viewpoint-group / selector steps do **not** apply.
 
 ## Steps
 

package/src/orchestrator/templates/ai-instructions/copilot-cmd-run-test.md

@@ -36,10 +36,10 @@ Skip when `--env` matches the base locale.
 
 If the unit is **api-first**, skip every selector/capture phase (an API test has no DOM):
 1. **Resolve the datasource** — `base_url` + auth wired in `qa/datasources.yaml` + `.env.qa` (`${X_URL}` from `sungen api init`); a `production` datasource is refused unless `SUNGEN_ALLOW_PROD=1`.
-2. **Compile**: `npx sungen generate --api <name>` → `specs/generated/api/<name>/`.
+2. **Compile**: `npx sungen generate --area <name>` → `specs/generated/api/<name>/`.
 3. **Run**: `npx playwright test specs/generated/api/<name>/<name>.spec.ts`.
-4. **Auto-fix** (use `sungen-error-mapping`): 401/403 → `@hybrid`+`@auth` or `Bearer :token` header (`sungen makeauth`); base_url unresolved → set `${X_URL}`; missing param → trace `{{var}}` to test-data/a prior `@api` response; `expect.status` mismatch → reconcile against `apis.yaml` (re-`generate --api`, never hand-edit the spec); flaky → self-clean + `@concurrent` caps.
-5. **Integrity + trace** — `sungen script-check --api <name>` (1:1; on DRIFT re-`generate --api`, never hand-edit the spec) + `sungen trace --api <name>` (process map + HUMAN-LOOP FOCUS). Report + offer next steps.
+4. **Auto-fix** (use `sungen-error-mapping`): 401/403 → `@hybrid`+`@auth` or `Bearer :token` header (`sungen makeauth`); base_url unresolved → set `${X_URL}`; missing param → trace `{{var}}` to test-data/a prior `@api` response; `expect.status` mismatch → reconcile against `apis.yaml` (re-`generate --area`, never hand-edit the spec); flaky → self-clean + `@concurrent` caps.
+5. **Integrity + trace** — `sungen script-check --area <name>` (1:1; on DRIFT re-`generate --area`, never hand-edit the spec) + `sungen trace --area <name>` (process map + HUMAN-LOOP FOCUS). Report + offer next steps.
 
 ## Pre-run (phased — per `sungen-selector-fix` skill)
 

package/src/orchestrator/templates/ai-instructions/github-skill-sungen-api-design.md

@@ -1,6 +1,6 @@
 ---
 name: sungen-api-design
-description: The API-first design loop for an api unit (qa/api/<area> or qa/api/flows/<flow>) — discover the catalog, lay out the API viewpoints, generate @api/@cases/flow/@concurrent scenarios, then drive the sungen audit --api gate + reviewer + repair to a high businessDepth (≥0.7). Use when create-test/run-test detects an api unit (no selectors, no visual capture).
+description: The API-first design loop for an api unit (qa/api/<area> or qa/api/flows/<flow>) — discover the catalog, lay out the API viewpoints, generate @api/@cases/flow/@concurrent scenarios, then drive the sungen audit --area gate + reviewer + repair to a high businessDepth (≥0.7). Use when create-test/run-test detects an api unit (no selectors, no visual capture).
 ---
 
 # API design loop (driver-api · Orchestration + Harness)
@@ -10,7 +10,7 @@ Use this when the unit is **api-first** — `qa/api/<area>/` or `qa/api/flows/<f
 ## The loop (mirror of /sungen:design, API-native)
 
 ### 1. Discover (no capture)
-Run `sungen context --api <name>` — it reads the catalog and prints the **endpoints** + the **generation units** (one `matrix` unit per endpoint, an `async` unit per mutating endpoint, a `flow` unit for an api flow). Read `qa/api/<name>/requirements/spec.md` if present. No `apis.yaml` yet? → `sungen api import <openapi|csv>` or `sungen api add --area <name>` first.
+Run `sungen context --area <name>` — it reads the catalog and prints the **endpoints** + the **generation units** (one `matrix` unit per endpoint, an `async` unit per mutating endpoint, a `flow` unit for an api flow). Read `qa/api/<name>/requirements/spec.md` if present. No `apis.yaml` yet? → `sungen api import <openapi|csv>` or `sungen api add --area <name>` first.
 
 ### 2. API viewpoint overview (by method-profile)
 For each endpoint, cover its viewpoints — severity-weighted by method:
@@ -29,7 +29,7 @@ Bands: **~70%** success+failure matrix · **~20%** flows (auth/CRUD chains) · *
 - **Idempotency**: `@api:<name> @concurrent:N` + `expect {{name.ok_count}} is 1`, cross-checked with `@query` (the DB is the oracle).
 
 ### 4. Gate + repair (always — businessDepth ≥ 0.7 is the bar)
-Run `sungen audit --api <name>`; read `gateStatus` + `findings`. Then the **semantic reviewer** (sungen-reviewer sub-agent, API criteria). Repair **both** (budget 3 rounds), re-audit until PASS:
+Run `sungen audit --area <name>`; read `gateStatus` + `findings`. Then the **semantic reviewer** (sungen-reviewer sub-agent, API criteria). Repair **both** (budget 3 rounds), re-audit until PASS:
 
 | Finding | Repair |
 |---|---|
@@ -41,7 +41,7 @@ Run `sungen audit --api <name>`; read `gateStatus` + `findings`. Then the **sema
 Stop when the gate PASSes + businessDepth ≥ 0.7, or the budget is exhausted → report residual gaps honestly (mark genuinely-unautomatable cases `@manual` with an oracle). Never fake a pass.
 
 ### 5. Record + converge
-`sungen manifest --api <name>` (reuse) and ledger each phase; show the trace + the HUMAN-LOOP FOCUS. (Integrity `script-check`/`trace` for api: see run-test.)
+`sungen manifest --area <name>` (reuse) and ledger each phase; show the trace + the HUMAN-LOOP FOCUS. (Integrity `script-check`/`trace` for api: see run-test.)
 
 ## Rules
 - **No HTTP, no selectors** — only `.feature` + the reviewed `apis.yaml` + `test-data`.