@cohortapp/agent-sdk 2.17.0 → 2.18.4

package/lib/design/fixtures/foundation.json

@@ -1,133 +0,0 @@
-{
-  "v": 2,
-  "colors": [
-    { "name": "Ink", "value": "#0d0d0d", "dark": "#f5f5f4" },
-    { "name": "Paper", "value": "#ffffff", "dark": "#0b0b0c" },
-    { "name": "Primary · Moss", "value": "#2d5be3", "dark": "#7ea0ff" },
-    { "name": "Muted", "value": "#6b7280" },
-    { "name": "Accent · Amber", "value": "#c9851f" },
-    { "name": "Line", "value": "#e7e5e4", "dark": "#26262a" }
-  ],
-  "fonts": { "display": "Outfit", "body": "Inter", "mono": "JetBrains Mono" },
-  "type": [
-    { "role": "Display", "size": 76, "weight": 600 },
-    { "role": "Heading", "size": 38, "weight": 600 },
-    { "role": "Body", "size": 14, "weight": 400 },
-    { "role": "Small", "size": 11.5, "weight": 500 }
-  ],
-  "space": [
-    { "name": "xs", "value": 4 },
-    { "name": "sm", "value": 8 },
-    { "name": "md", "value": 12 },
-    { "name": "lg", "value": 16 },
-    { "name": "xl", "value": 22 }
-  ],
-  "radii": [
-    { "name": "chip", "value": 8 },
-    { "name": "field", "value": 9 },
-    { "name": "card", "value": 13 },
-    { "name": "modal", "value": 14 },
-    { "name": "pill", "value": 999 }
-  ],
-  "shadow": [
-    { "name": "sm", "value": "0 1px 2px rgba(13,13,13,0.06)" },
-    { "name": "md", "value": "0 18px 50px rgba(13,13,13,0.13)" }
-  ],
-  "border": [
-    { "name": "hairline", "value": "1px solid #e7e5e4" },
-    { "name": "strong", "value": "1px solid #d6d3d1" }
-  ],
-  "voice": "Concise, specific, accountable. Write like a capable peer — no hype, no emoji, no hedging.",
-  "positioning": "The operating system for companies that run on agents as well as people.",
-  "taglines": ["Work that runs itself.", "One company, many hands."],
-  "toneTraits": ["Plain", "Exact", "Unhurried"],
-  "logos": {
-    "brandIcon": "https://assets.example.test/icon.png",
-    "wordmark": "https://assets.example.test/wordmark.svg",
-    "favicon": null
-  },
-  "examples": { "hero": "A crew at first light.", "cta": "Start the walkthrough" },
-  "visualLanguage": {
-    "v": 2,
-    "source": "generated",
-    "imagery": {
-      "needsImagery": true,
-      "medium": "photography",
-      "secondaryMedia": ["diagram"],
-      "colorGrade": "natural",
-      "grain": "fine",
-      "crop": "wide",
-      "aspectRatios": ["16/9", "1/1"],
-      "subjects": ["hands at work", "quiet rooms"],
-      "mood": ["calm", "considered"],
-      "composition": "off-centre, generous negative space",
-      "duotone": { "shadow": "#12213f", "highlight": "#f3ede1" }
-    },
-    "iconography": { "style": "line", "weight": "1.5px", "corner": "rounded", "grid": 24 },
-    "motion": {
-      "character": "settled",
-      "easing": "cubic-bezier(0.2, 0, 0, 1)",
-      "durationMs": 220,
-      "principles": ["Move once, arrive.", "Never animate what a person is reading."]
-    },
-    "texture": { "surfaces": ["paper", "frosted glass"], "background": "flat", "notes": "No gradients behind text." },
-    "guardrails": {
-      "dos": ["Let type carry the page.", "Use one accent per view."],
-      "donts": ["No stock handshakes.", "No drop shadows on text."]
-    },
-    "promptSeed": "quiet rooms, natural light, fine grain",
-    "seedLocked": true,
-    "negativeSeed": "neon, lens flare",
-    "references": ["moodboard/2026-03"]
-  },
-  "system": {
-    "typography": {
-      "families": {
-        "display": { "family": "Outfit", "category": "sans", "weights": [500, 600] },
-        "heading": { "family": "Outfit", "category": "sans", "weights": [600] },
-        "body": { "family": "Inter", "category": "sans", "weights": [400, 500] },
-        "mono": { "family": "JetBrains Mono", "category": "mono", "weights": [400] }
-      },
-      "scale": [
-        { "role": "Display", "size": 76, "weight": 600, "leading": 1.05, "tracking": -0.02 },
-        { "role": "Heading", "size": 38, "weight": 600, "leading": 1.15, "tracking": -0.01 },
-        { "role": "Body", "size": 14, "weight": 400, "leading": 1.5 },
-        { "role": "Caption", "size": 11, "weight": 500, "leading": 1.4, "tracking": 0.04 }
-      ],
-      "pairingRationale": "One geometric face for structure, one humanist face for reading.",
-      "usageRules": ["Display only above 32px.", "Never set body copy below 13px."]
-    },
-    "color": {
-      "roles": {
-        "primary": { "name": "Signal Blue", "value": "#2d5be3", "dark": "#7ea0ff" },
-        "accent": { "name": "Amber", "value": "#c9851f" }
-      },
-      "neutralRamp": [
-        { "step": 100, "value": "#f5f5f4" },
-        { "step": 500, "value": "#78716c" },
-        { "step": 900, "value": "#1c1917" }
-      ],
-      "semantic": { "success": "#177245", "warning": "#c9851f", "danger": "#a11d1d" },
-      "usageRules": ["One primary per view.", "Semantic colour is for state, never decoration."]
-    },
-    "imagery": {
-      "medium": "documentary photography",
-      "style": "unstaged",
-      "treatment": "warm highlights, cool shadows",
-      "mood": "assured",
-      "subjects": ["workshops", "field crews"],
-      "donts": ["stock handshakes", "isolated laptops"]
-    },
-    "motifs": ["A single hairline rule.", "Numbers set in the mono face."],
-    "iconography": "Line icons on a 24px grid, 1.5px stroke.",
-    "layoutPrinciples": ["Left-align everything that reads.", "One idea per band."],
-    "voice": {
-      "voice": "Concise, specific, accountable.",
-      "toneTraits": ["Plain", "Direct"],
-      "lexicon": { "use": ["decide", "ship", "owe"], "avoid": ["leverage", "synergy", "unlock"] },
-      "exampleCopy": "Two invoices need a decision today. Both are under £5,000."
-    }
-  },
-  "elevationCurve": { "0": "none", "1": "0 1px 2px rgba(0,0,0,0.05)" },
-  "gridUnit": 4
-}

package/lib/design/refresh-gate.test.mjs

@@ -1,144 +0,0 @@
-/**
- * refresh-gate.test.mjs — WHEN a seat re-syncs its brand foundation
- * (WP-M7 mechanic 4). The gate is pure, so every case here is a table row.
- *
- * The two rules worth stating in prose because they are the ones a reader
- * would get wrong:
- *
- *   · An UNKNOWN current version is not a change. The daemon asks the gate
- *     twice per tick — before the read (version unknown) and after it — and if
- *     "unknown" counted as a new version, the pre-read call would say yes on
- *     every tick and the interval would mean nothing.
- *   · A `lastAt` in the FUTURE refreshes. A clock that jumped backwards (or a
- *     state file copied from another box) must not be able to freeze DESIGN.md
- *     on disk until the wall clock catches up.
- */
-
-import { test } from "node:test";
-import assert from "node:assert/strict";
-
-import {
-  isUnversionedFoundation,
-  shouldRefreshDesign,
-  foundationVersion,
-  foundationVersionLabel,
-  DESIGN_REFRESH_INTERVAL_MS,
-  DESIGN_STATE_REL,
-  DESIGN_FILES,
-} from "./refresh-gate.mjs";
-
-const NOW = Date.parse("2026-09-08T12:00:00Z");
-
-test("the interval is 15 minutes and the paths are the ones the CLI and daemon write", () => {
-  assert.equal(DESIGN_REFRESH_INTERVAL_MS, 15 * 60_000);
-  assert.equal(DESIGN_STATE_REL, "state/design/foundation.json");
-  assert.deepEqual(DESIGN_FILES, ["DESIGN.md", "PRODUCT.md"]);
-});
-
-test("never synced → refresh", () => {
-  assert.deepEqual(shouldRefreshDesign({ now: NOW }), { refresh: true, reason: "never" });
-  assert.deepEqual(shouldRefreshDesign({ lastAt: null, now: NOW }), { refresh: true, reason: "never" });
-  assert.deepEqual(shouldRefreshDesign({ lastAt: "not a date", now: NOW }), { refresh: true, reason: "never" });
-});
-
-test("inside the interval with an unchanged version → no refresh", () => {
-  assert.deepEqual(
-    shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: NOW - 60_000, now: NOW }),
-    { refresh: false, reason: "fresh" },
-  );
-});
-
-test("a changed version refreshes immediately, however recent the last sync", () => {
-  assert.deepEqual(
-    shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_2", lastAt: NOW - 1_000, now: NOW }),
-    { refresh: true, reason: "version-changed" },
-  );
-  // First-ever version on a seat that had synced an unversioned org.
-  assert.deepEqual(
-    shouldRefreshDesign({ lastVersion: null, currentVersion: "bv_1", lastAt: NOW - 1_000, now: NOW }),
-    { refresh: true, reason: "version-changed" },
-  );
-});
-
-test("an UNKNOWN current version is not a change — the pre-read call must not always say yes", () => {
-  for (const currentVersion of [null, undefined, "", 7, {}]) {
-    assert.deepEqual(
-      shouldRefreshDesign({ lastVersion: "bv_1", currentVersion, lastAt: NOW - 60_000, now: NOW }),
-      { refresh: false, reason: "fresh" },
-      `currentVersion=${JSON.stringify(currentVersion)}`,
-    );
-  }
-});
-
-test("the interval fires at the boundary and after it, not before", () => {
-  const at = (dt) => shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: NOW - dt, now: NOW });
-  assert.equal(at(DESIGN_REFRESH_INTERVAL_MS - 1).refresh, false);
-  assert.deepEqual(at(DESIGN_REFRESH_INTERVAL_MS), { refresh: true, reason: "interval" });
-  assert.deepEqual(at(DESIGN_REFRESH_INTERVAL_MS * 10), { refresh: true, reason: "interval" });
-});
-
-test("a lastAt in the future refreshes rather than freezing the seat", () => {
-  assert.deepEqual(
-    shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: NOW + 86_400_000, now: NOW }),
-    { refresh: true, reason: "clock-skew" },
-  );
-});
-
-test("lastAt is accepted as an ISO string or epoch ms", () => {
-  const iso = shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: "2026-09-08T11:59:00Z", now: NOW });
-  const ms = shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: NOW - 60_000, now: NOW });
-  assert.deepEqual(iso, ms);
-});
-
-test("a bad or absent intervalMs falls back to the 15-minute default", () => {
-  for (const intervalMs of [undefined, null, 0, -5, NaN, "soon"]) {
-    const r = shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: NOW - 14 * 60_000, now: NOW, intervalMs });
-    assert.equal(r.refresh, false, `intervalMs=${String(intervalMs)}`);
-  }
-  assert.equal(
-    shouldRefreshDesign({ lastVersion: "bv_1", currentVersion: "bv_1", lastAt: NOW - 60_000, now: NOW, intervalMs: 30_000 }).reason,
-    "interval",
-    "an explicit shorter interval is honoured",
-  );
-});
-
-test("foundationVersion prefers headVersionId, then version.id, then a stable 'unversioned'", () => {
-  assert.equal(foundationVersion({ headVersionId: "bv_1", version: { id: "bv_0" }, foundation: {} }), "bv_1");
-  assert.equal(foundationVersion({ headVersionId: null, version: { id: "bv_0" }, foundation: {} }), "bv_0");
-  assert.equal(foundationVersion({ headVersionId: null, version: null, foundation: {} }), "unversioned");
-  assert.equal(foundationVersion({}), null, "a frame with no foundation has no version identity");
-  assert.equal(foundationVersion(null), null);
-  assert.equal(foundationVersion("nope"), null);
-});
-
-test("'unversioned' is STABLE, so an org that never saved a foundation does not re-render every poll", () => {
-  const frame = { headVersionId: null, version: null, foundation: { colors: [] } };
-  const v = foundationVersion(frame);
-  assert.equal(shouldRefreshDesign({ lastVersion: v, currentVersion: foundationVersion(frame), lastAt: NOW - 60_000, now: NOW }).refresh, false);
-});
-
-test("foundationVersionLabel reads the label, falls back to V2.<seq>, and never invents", () => {
-  assert.equal(foundationVersionLabel({ version: { label: "Palette refresh", seq: 7 } }), "Palette refresh");
-  assert.equal(foundationVersionLabel({ version: { seq: 7 } }), "V2.7");
-  assert.equal(foundationVersionLabel({ version: { label: "   " } }), "");
-  assert.equal(foundationVersionLabel({ version: null }), "");
-  assert.equal(foundationVersionLabel(null), "");
-});
-
-test("isUnversionedFoundation catches the frame hq ACTUALLY sends for a workspace with no brand", () => {
-  // hq's `loadSavedFoundation` falls back to `dsDefaults()`, so the foundation
-  // is never null. `unversioned` is the only truthful signal, and an older hq
-  // that omits it is judged by having no version identity at all.
-  const stock = { foundation: { colors: [] }, version: null, headVersionId: null, unversioned: true };
-  assert.equal(isUnversionedFoundation(stock), true);
-  assert.equal(isUnversionedFoundation({ ...stock, unversioned: undefined }), true, "older hq: no version identity of any kind");
-
-  const saved = { foundation: { colors: [] }, version: { id: "bv_1", seq: 3 }, headVersionId: "bv_1", unversioned: false };
-  assert.equal(isUnversionedFoundation(saved), false);
-  // hq is trusted when it states the field, even where retention pruned the
-  // snapshot row and only the etag survives.
-  assert.equal(isUnversionedFoundation({ foundation: {}, version: null, headVersionId: "bv_9", unversioned: false }), false);
-
-  assert.equal(isUnversionedFoundation(null), false, "an absent frame is a read failure, not an unversioned workspace");
-  assert.equal(isUnversionedFoundation({}), false);
-});

package/lib/design/write.test.mjs

@@ -1,241 +0,0 @@
-/**
- * write.test.mjs — the effect edge of the design sync (WP-M7 mechanic 4).
- *
- * Real files in a temp dir, not stubs: the claims worth holding here are about
- * the FILESYSTEM — that an unchanged foundation touches no mtime, and that the
- * two markdown files land at 0644 so any tool on the seat can read them.
- */
-
-import { test } from "node:test";
-import assert from "node:assert/strict";
-import { chmodSync, mkdtempSync, mkdirSync, readFileSync, readdirSync, writeFileSync, statSync, utimesSync, existsSync, rmSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { tmpdir } from "node:os";
-
-import { syncDesign, writeDesignFiles, writeFoundationState, readFoundationState, filesMatch, workspaceName, DESIGN_FILE_MODE } from "./write.mjs";
-import { renderDesignBundle } from "./design-md.mjs";
-import { DESIGN_STATE_REL } from "./refresh-gate.mjs";
-
-const NOW = Date.parse("2026-09-08T12:00:00Z");
-const FIXTURE = JSON.parse(readFileSync(new URL("./fixtures/foundation.json", import.meta.url), "utf8"));
-
-/** A `branding.getFoundation` result frame's `result`. */
-const result = (over = {}) => ({
-  foundation: FIXTURE,
-  version: { id: "bv_01HQZ", seq: 7, label: "V2.7" },
-  headVersionId: "bv_01HQZ",
-  isHead: true,
-  unversioned: false,
-  history: [],
-  ...over,
-});
-
-function tmpRoot(t) {
-  const dir = mkdtempSync(join(tmpdir(), "maestro-design-write-"));
-  t.after(() => rmSync(dir, { recursive: true, force: true }));
-  return dir;
-}
-
-test("a first sync writes both files plus the state snapshot", (t) => {
-  const root = tmpRoot(t);
-  const out = syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-
-  assert.deepEqual(out.written, ["DESIGN.md", "PRODUCT.md"]);
-  assert.deepEqual(out.unchanged, []);
-  assert.equal(out.version, "bv_01HQZ");
-  assert.equal(out.outDir, root);
-
-  const design = readFileSync(join(root, "DESIGN.md"), "utf8");
-  assert.match(design, /^---\nname: "Northwind"\n/);
-  assert.match(design, /\{colors\.primary\}/);
-  assert.match(readFileSync(join(root, "PRODUCT.md"), "utf8"), /# Northwind — product voice/);
-
-  const state = JSON.parse(readFileSync(join(root, DESIGN_STATE_REL), "utf8"));
-  assert.equal(state.version, "bv_01HQZ");
-  assert.equal(state.versionLabel, "V2.7");
-  assert.equal(state.fetchedAt, "2026-09-08T12:00:00.000Z");
-  assert.deepEqual(state.foundation, FIXTURE, "the raw foundation is kept verbatim for the next gate read");
-});
-
-test("both markdown files are 0644", (t) => {
-  const root = tmpRoot(t);
-  syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-  for (const rel of ["DESIGN.md", "PRODUCT.md"]) {
-    assert.equal(statSync(join(root, rel)).mode & 0o777, DESIGN_FILE_MODE, rel);
-  }
-});
-
-test("re-syncing an unchanged foundation rewrites NOTHING — mtimes are untouched", (t) => {
-  const root = tmpRoot(t);
-  syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-
-  // Backdate both files so any rewrite is unmistakable.
-  const old = new Date(NOW - 86_400_000);
-  for (const rel of ["DESIGN.md", "PRODUCT.md"]) utimesSync(join(root, rel), old, old);
-  const before = ["DESIGN.md", "PRODUCT.md"].map((rel) => statSync(join(root, rel)).mtimeMs);
-
-  // A LATER clock, deliberately: the timestamp inside the file must not be what
-  // makes a sync a rewrite, or the interval poll would churn the tree forever.
-  const again = syncDesign({ agentRoot: root, result: result(), now: NOW + 20 * 60_000, name: "Northwind" });
-  assert.deepEqual(again.written, [], "nothing written");
-  assert.deepEqual(again.unchanged, ["DESIGN.md", "PRODUCT.md"]);
-
-  const after = ["DESIGN.md", "PRODUCT.md"].map((rel) => statSync(join(root, rel)).mtimeMs);
-  assert.deepEqual(after, before, "the files were not touched at all");
-
-  const design = readFileSync(join(root, "DESIGN.md"), "utf8");
-  assert.match(design, /\*\*Synced:\*\* 2026-09-08T12:00:00\.000Z/, "the stamp still says when the CONTENT was minted");
-
-  // The snapshot is still refreshed, so the gate knows the seat did check.
-  const state = JSON.parse(readFileSync(join(root, DESIGN_STATE_REL), "utf8"));
-  assert.equal(state.fetchedAt, "2026-09-08T12:20:00.000Z");
-  assert.equal(state.renderedAt, "2026-09-08T12:00:00.000Z");
-});
-
-test("a changed foundation rewrites the affected file and re-stamps it", (t) => {
-  const root = tmpRoot(t);
-  syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-
-  const moved = JSON.parse(JSON.stringify(FIXTURE));
-  moved.colors[2].value = "#111111";
-  const out = syncDesign({
-    agentRoot: root,
-    result: result({ foundation: moved, headVersionId: "bv_02", version: { id: "bv_02", seq: 8, label: "V2.8" } }),
-    now: NOW + 20 * 60_000,
-    name: "Northwind",
-  });
-
-  assert.ok(out.written.includes("DESIGN.md"));
-  assert.equal(out.version, "bv_02");
-  const design = readFileSync(join(root, "DESIGN.md"), "utf8");
-  assert.match(design, /primary-moss: "#111111"/);
-  assert.match(design, /\*\*Synced:\*\* 2026-09-08T12:20:00\.000Z/);
-  assert.match(design, /\*\*Version:\*\* V2\.8/);
-});
-
-test("--out sends the docs elsewhere; the snapshot always stays under the agent root", (t) => {
-  const root = tmpRoot(t);
-  const outDir = join(root, "docs", "brand");
-  const out = syncDesign({ agentRoot: root, outDir, result: result(), now: NOW, name: "Northwind" });
-
-  assert.equal(out.outDir, outDir);
-  assert.ok(existsSync(join(outDir, "DESIGN.md")));
-  assert.ok(!existsSync(join(root, "DESIGN.md")));
-  assert.ok(existsSync(join(root, DESIGN_STATE_REL)));
-});
-
-test("writeDesignFiles skips a file whose bytes already match and rewrites an unreadable one", (t) => {
-  const root = tmpRoot(t);
-  const files = renderDesignBundle(FIXTURE, { name: "Northwind" });
-  assert.deepEqual(writeDesignFiles({ files, outDir: root }).written, ["DESIGN.md", "PRODUCT.md"]);
-  assert.deepEqual(writeDesignFiles({ files, outDir: root }), { written: [], unchanged: ["DESIGN.md", "PRODUCT.md"] });
-
-  writeFileSync(join(root, "DESIGN.md"), "someone edited this by hand\n");
-  assert.deepEqual(writeDesignFiles({ files, outDir: root }).written, ["DESIGN.md"], "a hand edit is overwritten — the file is generated");
-
-  const boom = writeDesignFiles({ files, outDir: root }, { readFileImpl: () => { throw new Error("EIO"); } });
-  assert.deepEqual(boom.written, ["DESIGN.md", "PRODUCT.md"], "unreadable is treated as absent");
-});
-
-test("writeDesignFiles ignores malformed entries rather than throwing", (t) => {
-  const root = tmpRoot(t);
-  const out = writeDesignFiles({ files: [null, { rel: "A.md" }, { content: "x" }, { rel: "ok.md", content: "y" }], outDir: root });
-  assert.deepEqual(out.written, ["ok.md"]);
-  assert.deepEqual(writeDesignFiles({ files: "not a list", outDir: root }), { written: [], unchanged: [] });
-});
-
-test("readFoundationState reads back what writeFoundationState wrote; corrupt reads as never-synced", (t) => {
-  const root = tmpRoot(t);
-  assert.equal(readFoundationState(root), null, "absent → null");
-
-  const path = writeFoundationState(root, { fetchedAt: "2026-09-08T12:00:00.000Z", version: "bv_1", foundation: { colors: [] } });
-  assert.equal(path, join(root, DESIGN_STATE_REL));
-  assert.equal(readFoundationState(root).version, "bv_1");
-
-  writeFileSync(path, "{ not json");
-  assert.equal(readFoundationState(root), null, "corrupt → null → re-sync, never a wedge");
-
-  writeFileSync(path, JSON.stringify([1, 2]));
-  assert.equal(readFoundationState(root), null, "an array is not a snapshot");
-});
-
-test("filesMatch is the idempotence probe the CLI's claim rests on", (t) => {
-  const root = tmpRoot(t);
-  const files = renderDesignBundle(FIXTURE, { name: "Northwind" });
-  assert.equal(filesMatch(files, root), false, "nothing on disk yet");
-  writeDesignFiles({ files, outDir: root });
-  assert.equal(filesMatch(files, root), true);
-  writeFileSync(join(root, "PRODUCT.md"), "drift\n");
-  assert.equal(filesMatch(files, root), false);
-});
-
-test("workspaceName reads the org config and invents nothing", () => {
-  assert.equal(workspaceName({ org: { cohort: { orgName: "Northwind" } } }), "Northwind");
-  assert.equal(workspaceName({ org: { cohort: { workspace: "adaptic-hq" } } }), "adaptic-hq");
-  assert.equal(workspaceName({ org: { cohort: { orgName: "  " } } }), "Workspace");
-  assert.equal(workspaceName({}), "Workspace");
-  assert.equal(workspaceName(null), "Workspace");
-});
-
-test("a state directory that does not exist yet is created", (t) => {
-  const root = join(tmpRoot(t), "not", "made", "yet");
-  mkdirSync(root, { recursive: true });
-  const out = syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-  assert.ok(existsSync(out.statePath));
-});
-
-// ── two output directories, one state file ──────────────────────────────────
-
-test("the daemon's agent dir and a --out directory do not invalidate each other, ever", (t) => {
-  // The scenario: an operator runs `maestro design sync --out docs/brand`
-  // (advertised in the guide) on a seat whose daemon polls the agent dir every
-  // 15 minutes. With one shared render stamp, each lane re-stamped the state
-  // and the other lane then found its own files "stale" — both files rewritten
-  // on every tick, forever, with a foundation that never changed.
-  const root = tmpRoot(t);
-  const brand = join(root, "docs", "brand");
-  let now = NOW;
-  const daemon = () => syncDesign({ agentRoot: root, result: result(), now: (now += 900_000), name: "Northwind" });
-  const cli = () => syncDesign({ agentRoot: root, outDir: brand, result: result(), now: (now += 60_000), name: "Northwind" });
-
-  assert.deepEqual(daemon().written, ["DESIGN.md", "PRODUCT.md"], "first write of the agent dir");
-  assert.deepEqual(cli().written, ["DESIGN.md", "PRODUCT.md"], "first write of docs/brand");
-
-  for (let i = 0; i < 6; i++) {
-    assert.deepEqual(daemon().written, [], `daemon poll ${i + 1} rewrote nothing`);
-    assert.deepEqual(cli().written, [], `--out run ${i + 1} rewrote nothing`);
-  }
-
-  const state = readFoundationState(root);
-  assert.equal(typeof state.rendered, "object");
-  assert.equal(Object.keys(state.rendered).length, 2, "one stamp per output directory");
-  assert.equal(state.renderedAt, state.rendered[resolve(root)], "the top-level stamp still describes the agent dir");
-});
-
-test("a legacy state file with a bare renderedAt migrates without a spurious rewrite", (t) => {
-  const root = tmpRoot(t);
-  syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-  // Rewrite the snapshot in the pre-map shape, as an older SDK left it.
-  const doc = readFoundationState(root);
-  const legacy = { ...doc };
-  delete legacy.rendered;
-  writeFoundationState(root, legacy);
-  assert.equal(readFoundationState(root).rendered, undefined);
-
-  const out = syncDesign({ agentRoot: root, result: result(), now: NOW + 3_600_000, name: "Northwind" });
-  assert.deepEqual(out.written, [], "the old stamp is read as the agent dir's, so the bytes still match");
-  assert.equal(readFoundationState(root).rendered[resolve(root)], legacy.renderedAt);
-});
-
-test("both markdown files are published atomically and forced to 0644 even over a tighter file", (t) => {
-  const root = tmpRoot(t);
-  syncDesign({ agentRoot: root, result: result(), now: NOW, name: "Northwind" });
-  // Some other tool tightens the mode and truncates the content.
-  chmodSync(join(root, "DESIGN.md"), 0o600);
-  writeFileSync(join(root, "DESIGN.md"), "half a file");
-  syncDesign({ agentRoot: root, result: result(), now: NOW + 1000, name: "Northwind" });
-  assert.equal(statSync(join(root, "DESIGN.md")).mode & 0o777, DESIGN_FILE_MODE, "chmod runs on a rewrite, not only on create");
-
-  // No temp file is left behind by the atomic publish.
-  assert.deepEqual(readdirSync(root).filter((f) => f.includes(".tmp.")), []);
-});