@iamu-dev/iamu 0.8.0-beta.8 → 0.8.0-beta.9

package/dist/bin.js

@@ -17766,7 +17766,7 @@ function buildScenarioFrontmatter(row, personaSlug, outlineSlug, localFrontmatte
   };
   return { frontmatter, body: resolveBody(row, row.brief ?? ""), slug };
 }
-function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId) {
+function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId, localFrontmatter) {
   const descriptionParts = [];
   if (row.description)
     descriptionParts.push(row.description);
@@ -17790,7 +17790,7 @@ function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId) {
     ...dismissReason(row),
     ...present(row, "suppressedByGuidance", "suppressed_by_guidance"),
     fix_status: row.fixStatus ?? "open",
-    lens: row.lens ?? "persona",
+    lens: "lens" in row ? row.lens ?? "persona" : localFrontmatter?.lens ?? "persona",
     // The designer's fields, when the server has them.
     ...present(row, "source", "source"),
     ...present(row, "basis", "basis"),
@@ -17826,6 +17826,20 @@ function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId) {
     citations: row.citations ?? [],
     ...timestamps(row)
   };
+  if (localFrontmatter) {
+    for (const [field2, key] of LOCAL_WHEN_ABSENT) {
+      if (field2 in row || !(key in localFrontmatter))
+        continue;
+      if (localFrontmatter[key] === void 0)
+        continue;
+      frontmatter[key] = localFrontmatter[key];
+    }
+    for (const key of LOCAL_ONLY) {
+      if (localFrontmatter[key] !== void 0 && !(key in frontmatter)) {
+        frontmatter[key] = localFrontmatter[key];
+      }
+    }
+  }
   return { frontmatter, body: resolveBody(row, descriptionParts.join("\n")) };
 }
 function present(row, field2, key) {
@@ -17875,12 +17889,33 @@ function buildGuidanceFrontmatter(row, slug, capabilityIdToSlug, outlineIdToSlug
     body: resolveBody(row, composeGuidanceBody(row.rule, row.reason))
   };
 }
+var LOCAL_WHEN_ABSENT, LOCAL_ONLY;
 var init_frontmatter2 = __esm({
   "../../packages/local-store/dist/pull/frontmatter.js"() {
     "use strict";
     init_dist();
     init_paths();
     init_types2();
+    LOCAL_WHEN_ABSENT = [
+      ["source", "source"],
+      ["basis", "basis"],
+      ["category", "category"],
+      ["screen", "screen"],
+      ["steps", "steps"],
+      ["evidence", "evidence"],
+      ["what", "what"],
+      ["why", "why"],
+      ["breaksRule", "breaks"],
+      ["breaksFile", "breaks_file"],
+      ["designCauseOf", "design_cause_of"],
+      ["seenIn", "seen_in"],
+      ["generatedBy", "generated_by"],
+      ["dispatch", "dispatch"],
+      ["uiFact", "ui_fact"],
+      ["consequence", "consequence"],
+      ["walkthroughStepNumber", "walkthrough_step_id"]
+    ];
+    LOCAL_ONLY = ["canonical_id", "design_cause_of"];
   }
 });
 
@@ -18413,7 +18448,7 @@ async function pullFindings(projectRoot, cloud, projectId, personaIdToSlug, poli
     const existingSlug = localIndex.byId.get(row.id);
     const base = row.title ? slugify(row.title) : `finding-${row.id.slice(0, 8)}`;
     const slug = existingSlug ?? deriveUniqueSlug(base || "finding", usedSlugs, row.id);
-    const { frontmatter, body } = buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId);
+    const { frontmatter, body } = buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId, localIndex.frontmatterById.get(row.id));
     await applyEntityPullOutcome(projectRoot, "finding", row, slug, frontmatter, body, localIndex, policy, result.pulls.finding, batch);
   }
   await finalizePullBatch(projectRoot, batch);
@@ -19712,6 +19747,13 @@ async function migrateFindings(projectRoot, apply, plan) {
   } catch {
     return;
   }
+  const records = /* @__PURE__ */ new Map();
+  const issuesOf = async (runId) => {
+    if (!records.has(runId)) {
+      records.set(runId, (await readDesignerRecord(projectRoot, runId))?.issues ?? null);
+    }
+    return records.get(runId) ?? null;
+  };
   for (const name of names2) {
     const file = path35.join(dir, name);
     const slug = name.slice(0, -3);
@@ -19744,18 +19786,72 @@ async function migrateFindings(projectRoot, apply, plan) {
       });
       continue;
     }
-    if (fm.lens === "designer" && fm.source == null) {
-      text = setFrontmatterScalar(text, "source", "designer");
-      fm.source = "designer";
-      changes.push("source: designer (from lens)");
-    }
-    const designer2 = findingSource({
-      source: typeof fm.source === "string" ? fm.source : null,
-      lens: typeof fm.lens === "string" ? fm.lens : null
-    }) === "designer";
-    if (designer2 && !fm.design_cause_of && !fm.canonical_id && typeof fm.id === "string" && fm.id) {
-      text = setFrontmatterScalar(text, "canonical_id", yamlScalar(fm.id));
-      changes.push("canonical_id: its own id");
+    const set2 = (key, value) => {
+      text = setFrontmatterScalar(text, key, yamlValue(value));
+      fm[key] = value;
+    };
+    const blank = (v) => v == null || typeof v === "string" && v.trim() === "" || Array.isArray(v) && v.length === 0;
+    const designer2 = fm.lens === "designer" || fm.source === "designer";
+    if (designer2) {
+      const runId = designerRunOf(fm);
+      const issues = runId ? await issuesOf(runId) : null;
+      const issue = issues ? issues.find((i) => i.finding_id === fm.id) ?? issues.find((i) => typeof fm.title === "string" && fm.title && i.title === fm.title) : void 0;
+      if (issue) {
+        const restored = [];
+        const fields = [
+          ["basis", issue.basis],
+          ["category", issue.kind],
+          ["screen", issue.screen],
+          ["what", issue.what],
+          ["why", issue.why],
+          ["steps", issue.steps],
+          ["evidence", issue.evidence],
+          ["title", issue.title],
+          ["breaks", issue.breaks]
+        ];
+        for (const [key, value] of fields) {
+          if (!blank(fm[key]) || blank(value))
+            continue;
+          set2(key, value);
+          restored.push(key);
+        }
+        if (issue.design_cause_of) {
+          if (fm.design_cause_of !== issue.design_cause_of) {
+            set2("design_cause_of", issue.design_cause_of);
+            restored.push("design_cause_of");
+          }
+          if (fm.canonical_id) {
+            set2("canonical_id", null);
+            restored.push("canonical_id: none (a design cause)");
+          }
+        } else if (typeof issue.canonical_id === "string" && issue.canonical_id && issue.canonical_id !== fm.canonical_id && (!fm.canonical_id || fm.canonical_id === fm.id)) {
+          set2("canonical_id", issue.canonical_id);
+          restored.push(fm.id === issue.canonical_id ? "canonical_id: its own id" : "canonical_id: the one the record shares");
+        }
+        if (restored.length > 0) {
+          changes.push(`from the run's designer.json: ${restored.join(", ")}`);
+        }
+      }
+      const missing = findingSourceErrors({
+        ...fm,
+        source: "designer"
+      }).map((e) => e.split(" ")[0]).filter((f) => ["what", "why", "basis", "screen"].includes(f));
+      if (missing.length > 0) {
+        plan.notices.push({
+          target: `iamu/findings/${name}`,
+          what: `a designer finding missing ${missing.join(", ")}${runId ? `, and iamu/.runs/${runId}/designer.json has no record of it` : ", and no run to restore it from"}`,
+          fix: "fill them in from the run's designer.json, or delete the file and pull it again once the cloud sends the designer's fields"
+        });
+        continue;
+      }
+      if (fm.source == null) {
+        set2("source", "designer");
+        changes.push("source: designer (from lens)");
+      }
+      if (!fm.design_cause_of && !fm.canonical_id && typeof fm.id === "string" && fm.id) {
+        set2("canonical_id", fm.id);
+        changes.push("canonical_id: its own id");
+      }
     }
     if (changes.length === 0)
       continue;
@@ -19776,6 +19872,19 @@ async function migrateFindings(projectRoot, apply, plan) {
     });
   }
 }
+function designerRunOf(fm) {
+  if (typeof fm.run === "string" && fm.run)
+    return fm.run;
+  const m = /^(?:designer|ux):(.+)$/.exec(typeof fm.seen_in === "string" ? fm.seen_in : "");
+  return m ? m[1] : null;
+}
+function yamlValue(value) {
+  if (value === null)
+    return "null";
+  if (typeof value === "string")
+    return yamlScalar(value);
+  return JSON.stringify(value);
+}
 function yamlScalar(value) {
   try {
     if (jsYaml.load(value, { schema: jsYaml.JSON_SCHEMA }) === value)
@@ -22113,7 +22222,7 @@ function rolesOf(personas, outlines, names2) {
   return out2;
 }
 function situationFacts(texts, roles) {
-  const roleWords = new Set(roles.flatMap((r) => r.split(/[^\p{L}]+/u)).filter(Boolean));
+  const roleWords = new Set(roles.flatMap((r) => [...r.split(/[^\p{L}'’-]+/u), ...r.split(/[^\p{L}]+/u)]).map((w) => w.replace(/['’]s?$/, "")).filter(Boolean));
   const out2 = /* @__PURE__ */ new Set();
   for (const text of texts) {
     const dates = [...text.matchAll(new RegExp(DATE2.source, "g"))].map((m) => m[0]);
@@ -22151,7 +22260,8 @@ async function readDraftContext(projectRoot, opts = {}) {
   const outlines = (await listEntities(projectRoot, "outline")).entities.map((e) => e.frontmatter);
   const names2 = personas.map((p) => p.name);
   const roles = rolesOf(personas, outlines, names2);
-  const doNotQuote = situationFacts(outlines.flatMap((o) => [o.title, o.description, o.narrative, o.tension].filter((t) => Boolean(t))), roles.map((r) => r.role));
+  const contextText = await fs47.readFile(path42.join(projectRoot, "iamu", "context.yml"), "utf8").catch(() => "");
+  const doNotQuote = situationFacts(outlines.flatMap((o) => [o.title, o.description, o.narrative, o.tension].filter((t) => Boolean(t))), [...roles.map((r) => r.role), contextText]);
   const situations = outlines.map((o) => o.title.trim()).filter((t) => t && !namesPersona(t, names2) && !doNotQuote.some((f) => quotes(t, f)));
   const urlPrefixes = files.flatMap((f) => dir && (f.applies_to ?? []).includes(dir) ? (f.applies_to ?? []).filter(isUrlPrefix2) : []);
   return {
@@ -22514,6 +22624,8 @@ function checkFrontmatter(text, front, ctx, errors) {
     });
     return;
   }
+  if (ctx.tokenFiles.length === 0)
+    return;
   const defined = definedValues(ctx);
   const lines = text.replace(/\r\n?/g, "\n").split("\n");
   for (const [key, value] of leaves(parsed)) {
@@ -22523,7 +22635,7 @@ function checkFrontmatter(text, front, ctx, errors) {
     const at = lines.findIndex((l, i) => i >= front.first - 1 && i < front.last && l.includes(value));
     errors.push({
       code: "value_not_a_token",
-      message: `${key}: ${value} is not a value the token sources define${ctx.tokenFiles.length === 0 ? " (no token source is recorded or found)" : ""}`,
+      message: `${key}: ${value} is not a value the token sources define`,
       line: at === -1 ? null : at + 1
     });
   }
@@ -25435,8 +25547,8 @@ import { dirname as dirname3, join as join5, relative, resolve as resolve2 } fro
 import { fileURLToPath as fileURLToPath2 } from "url";
 import chalk6 from "chalk";
 function getVersion() {
-  if ("0.8.0-beta.8") {
-    return "0.8.0-beta.8";
+  if ("0.8.0-beta.9") {
+    return "0.8.0-beta.9";
   }
   try {
     const thisDir = dirname3(fileURLToPath2(import.meta.url));

package/dist/build-hash.txt

@@ -1 +1 @@
-eb30eaadd356dc88c43923cfcedb8242b496521ce2a8618863d9a180267cdc11
+6189ae317dafbd552e3bbc0664b1a3ff5a5845d05f9a606c2114466469d5ab65

package/dist/index.js

@@ -17765,7 +17765,7 @@ function buildScenarioFrontmatter(row, personaSlug, outlineSlug, localFrontmatte
   };
   return { frontmatter, body: resolveBody(row, row.brief ?? ""), slug };
 }
-function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId) {
+function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId, localFrontmatter) {
   const descriptionParts = [];
   if (row.description)
     descriptionParts.push(row.description);
@@ -17789,7 +17789,7 @@ function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId) {
     ...dismissReason(row),
     ...present(row, "suppressedByGuidance", "suppressed_by_guidance"),
     fix_status: row.fixStatus ?? "open",
-    lens: row.lens ?? "persona",
+    lens: "lens" in row ? row.lens ?? "persona" : localFrontmatter?.lens ?? "persona",
     // The designer's fields, when the server has them.
     ...present(row, "source", "source"),
     ...present(row, "basis", "basis"),
@@ -17825,6 +17825,20 @@ function buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId) {
     citations: row.citations ?? [],
     ...timestamps(row)
   };
+  if (localFrontmatter) {
+    for (const [field2, key] of LOCAL_WHEN_ABSENT) {
+      if (field2 in row || !(key in localFrontmatter))
+        continue;
+      if (localFrontmatter[key] === void 0)
+        continue;
+      frontmatter[key] = localFrontmatter[key];
+    }
+    for (const key of LOCAL_ONLY) {
+      if (localFrontmatter[key] !== void 0 && !(key in frontmatter)) {
+        frontmatter[key] = localFrontmatter[key];
+      }
+    }
+  }
   return { frontmatter, body: resolveBody(row, descriptionParts.join("\n")) };
 }
 function present(row, field2, key) {
@@ -17874,12 +17888,33 @@ function buildGuidanceFrontmatter(row, slug, capabilityIdToSlug, outlineIdToSlug
     body: resolveBody(row, composeGuidanceBody(row.rule, row.reason))
   };
 }
+var LOCAL_WHEN_ABSENT, LOCAL_ONLY;
 var init_frontmatter2 = __esm({
   "../../packages/local-store/dist/pull/frontmatter.js"() {
     "use strict";
     init_dist();
     init_paths();
     init_types2();
+    LOCAL_WHEN_ABSENT = [
+      ["source", "source"],
+      ["basis", "basis"],
+      ["category", "category"],
+      ["screen", "screen"],
+      ["steps", "steps"],
+      ["evidence", "evidence"],
+      ["what", "what"],
+      ["why", "why"],
+      ["breaksRule", "breaks"],
+      ["breaksFile", "breaks_file"],
+      ["designCauseOf", "design_cause_of"],
+      ["seenIn", "seen_in"],
+      ["generatedBy", "generated_by"],
+      ["dispatch", "dispatch"],
+      ["uiFact", "ui_fact"],
+      ["consequence", "consequence"],
+      ["walkthroughStepNumber", "walkthrough_step_id"]
+    ];
+    LOCAL_ONLY = ["canonical_id", "design_cause_of"];
   }
 });
 
@@ -18412,7 +18447,7 @@ async function pullFindings(projectRoot, cloud, projectId, personaIdToSlug, poli
     const existingSlug = localIndex.byId.get(row.id);
     const base = row.title ? slugify(row.title) : `finding-${row.id.slice(0, 8)}`;
     const slug = existingSlug ?? deriveUniqueSlug(base || "finding", usedSlugs, row.id);
-    const { frontmatter, body } = buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId);
+    const { frontmatter, body } = buildFindingFrontmatter(row, slug, personaSlug, scenarioSlug, runId, localIndex.frontmatterById.get(row.id));
     await applyEntityPullOutcome(projectRoot, "finding", row, slug, frontmatter, body, localIndex, policy, result.pulls.finding, batch);
   }
   await finalizePullBatch(projectRoot, batch);
@@ -19711,6 +19746,13 @@ async function migrateFindings(projectRoot, apply, plan) {
   } catch {
     return;
   }
+  const records = /* @__PURE__ */ new Map();
+  const issuesOf = async (runId) => {
+    if (!records.has(runId)) {
+      records.set(runId, (await readDesignerRecord(projectRoot, runId))?.issues ?? null);
+    }
+    return records.get(runId) ?? null;
+  };
   for (const name of names2) {
     const file = path35.join(dir, name);
     const slug = name.slice(0, -3);
@@ -19743,18 +19785,72 @@ async function migrateFindings(projectRoot, apply, plan) {
       });
       continue;
     }
-    if (fm.lens === "designer" && fm.source == null) {
-      text = setFrontmatterScalar(text, "source", "designer");
-      fm.source = "designer";
-      changes.push("source: designer (from lens)");
-    }
-    const designer2 = findingSource({
-      source: typeof fm.source === "string" ? fm.source : null,
-      lens: typeof fm.lens === "string" ? fm.lens : null
-    }) === "designer";
-    if (designer2 && !fm.design_cause_of && !fm.canonical_id && typeof fm.id === "string" && fm.id) {
-      text = setFrontmatterScalar(text, "canonical_id", yamlScalar(fm.id));
-      changes.push("canonical_id: its own id");
+    const set2 = (key, value) => {
+      text = setFrontmatterScalar(text, key, yamlValue(value));
+      fm[key] = value;
+    };
+    const blank = (v) => v == null || typeof v === "string" && v.trim() === "" || Array.isArray(v) && v.length === 0;
+    const designer2 = fm.lens === "designer" || fm.source === "designer";
+    if (designer2) {
+      const runId = designerRunOf(fm);
+      const issues = runId ? await issuesOf(runId) : null;
+      const issue = issues ? issues.find((i) => i.finding_id === fm.id) ?? issues.find((i) => typeof fm.title === "string" && fm.title && i.title === fm.title) : void 0;
+      if (issue) {
+        const restored = [];
+        const fields = [
+          ["basis", issue.basis],
+          ["category", issue.kind],
+          ["screen", issue.screen],
+          ["what", issue.what],
+          ["why", issue.why],
+          ["steps", issue.steps],
+          ["evidence", issue.evidence],
+          ["title", issue.title],
+          ["breaks", issue.breaks]
+        ];
+        for (const [key, value] of fields) {
+          if (!blank(fm[key]) || blank(value))
+            continue;
+          set2(key, value);
+          restored.push(key);
+        }
+        if (issue.design_cause_of) {
+          if (fm.design_cause_of !== issue.design_cause_of) {
+            set2("design_cause_of", issue.design_cause_of);
+            restored.push("design_cause_of");
+          }
+          if (fm.canonical_id) {
+            set2("canonical_id", null);
+            restored.push("canonical_id: none (a design cause)");
+          }
+        } else if (typeof issue.canonical_id === "string" && issue.canonical_id && issue.canonical_id !== fm.canonical_id && (!fm.canonical_id || fm.canonical_id === fm.id)) {
+          set2("canonical_id", issue.canonical_id);
+          restored.push(fm.id === issue.canonical_id ? "canonical_id: its own id" : "canonical_id: the one the record shares");
+        }
+        if (restored.length > 0) {
+          changes.push(`from the run's designer.json: ${restored.join(", ")}`);
+        }
+      }
+      const missing = findingSourceErrors({
+        ...fm,
+        source: "designer"
+      }).map((e) => e.split(" ")[0]).filter((f) => ["what", "why", "basis", "screen"].includes(f));
+      if (missing.length > 0) {
+        plan.notices.push({
+          target: `iamu/findings/${name}`,
+          what: `a designer finding missing ${missing.join(", ")}${runId ? `, and iamu/.runs/${runId}/designer.json has no record of it` : ", and no run to restore it from"}`,
+          fix: "fill them in from the run's designer.json, or delete the file and pull it again once the cloud sends the designer's fields"
+        });
+        continue;
+      }
+      if (fm.source == null) {
+        set2("source", "designer");
+        changes.push("source: designer (from lens)");
+      }
+      if (!fm.design_cause_of && !fm.canonical_id && typeof fm.id === "string" && fm.id) {
+        set2("canonical_id", fm.id);
+        changes.push("canonical_id: its own id");
+      }
     }
     if (changes.length === 0)
       continue;
@@ -19775,6 +19871,19 @@ async function migrateFindings(projectRoot, apply, plan) {
     });
   }
 }
+function designerRunOf(fm) {
+  if (typeof fm.run === "string" && fm.run)
+    return fm.run;
+  const m = /^(?:designer|ux):(.+)$/.exec(typeof fm.seen_in === "string" ? fm.seen_in : "");
+  return m ? m[1] : null;
+}
+function yamlValue(value) {
+  if (value === null)
+    return "null";
+  if (typeof value === "string")
+    return yamlScalar(value);
+  return JSON.stringify(value);
+}
 function yamlScalar(value) {
   try {
     if (jsYaml.load(value, { schema: jsYaml.JSON_SCHEMA }) === value)
@@ -22112,7 +22221,7 @@ function rolesOf(personas, outlines, names2) {
   return out2;
 }
 function situationFacts(texts, roles) {
-  const roleWords = new Set(roles.flatMap((r) => r.split(/[^\p{L}]+/u)).filter(Boolean));
+  const roleWords = new Set(roles.flatMap((r) => [...r.split(/[^\p{L}'’-]+/u), ...r.split(/[^\p{L}]+/u)]).map((w) => w.replace(/['’]s?$/, "")).filter(Boolean));
   const out2 = /* @__PURE__ */ new Set();
   for (const text of texts) {
     const dates = [...text.matchAll(new RegExp(DATE2.source, "g"))].map((m) => m[0]);
@@ -22150,7 +22259,8 @@ async function readDraftContext(projectRoot, opts = {}) {
   const outlines = (await listEntities(projectRoot, "outline")).entities.map((e) => e.frontmatter);
   const names2 = personas.map((p) => p.name);
   const roles = rolesOf(personas, outlines, names2);
-  const doNotQuote = situationFacts(outlines.flatMap((o) => [o.title, o.description, o.narrative, o.tension].filter((t) => Boolean(t))), roles.map((r) => r.role));
+  const contextText = await fs47.readFile(path42.join(projectRoot, "iamu", "context.yml"), "utf8").catch(() => "");
+  const doNotQuote = situationFacts(outlines.flatMap((o) => [o.title, o.description, o.narrative, o.tension].filter((t) => Boolean(t))), [...roles.map((r) => r.role), contextText]);
   const situations = outlines.map((o) => o.title.trim()).filter((t) => t && !namesPersona(t, names2) && !doNotQuote.some((f) => quotes(t, f)));
   const urlPrefixes = files.flatMap((f) => dir && (f.applies_to ?? []).includes(dir) ? (f.applies_to ?? []).filter(isUrlPrefix2) : []);
   return {
@@ -22513,6 +22623,8 @@ function checkFrontmatter(text, front, ctx, errors) {
     });
     return;
   }
+  if (ctx.tokenFiles.length === 0)
+    return;
   const defined = definedValues(ctx);
   const lines = text.replace(/\r\n?/g, "\n").split("\n");
   for (const [key, value] of leaves(parsed)) {
@@ -22522,7 +22634,7 @@ function checkFrontmatter(text, front, ctx, errors) {
     const at = lines.findIndex((l, i) => i >= front.first - 1 && i < front.last && l.includes(value));
     errors.push({
       code: "value_not_a_token",
-      message: `${key}: ${value} is not a value the token sources define${ctx.tokenFiles.length === 0 ? " (no token source is recorded or found)" : ""}`,
+      message: `${key}: ${value} is not a value the token sources define`,
       line: at === -1 ? null : at + 1
     });
   }
@@ -25434,8 +25546,8 @@ import { dirname as dirname3, join as join5, relative, resolve as resolve2 } fro
 import { fileURLToPath as fileURLToPath2 } from "url";
 import chalk6 from "chalk";
 function getVersion() {
-  if ("0.8.0-beta.8") {
-    return "0.8.0-beta.8";
+  if ("0.8.0-beta.9") {
+    return "0.8.0-beta.9";
   }
   try {
     const thisDir = dirname3(fileURLToPath2(import.meta.url));

package/dist/templates/skills/iamu-design.md

@@ -93,7 +93,7 @@ Fix by looking, not by hoping:
 Only when no design doc is recorded: `iamu design template` refuses otherwise, and a recorded doc changes only through proposals (**C**). The template is filled in from the code, never by a model: the token values in the frontmatter (light theme), the token groups by name, the contrast clashes the tokens have, each component with the props it takes, and the roles people come in (from the personas and situations, never their names). Everything else starts as a `<placeholder>`. Auto-extract what the code and `iamu/context.yml` already answer, ask the user only for the qualitative intent and clash decisions that code cannot answer, and the result becomes the team's doc.
 
 1. **Template & Auto-Extraction (0 questions to the user).** Run `iamu design template --out iamu/.analysis/design-draft.md --json`. It is for the app the recorded tokens and components apply to, else the root; add `--dir <app>` when the user names another app, and pass the same `--dir` to the later commands. If it answers `out_exists`, a draft is in progress: ask whether to continue it (step 2 with that file) or start over (delete the file and run it again). Tell the user in two lines what came from the code (`sources`, the components, `roles`, `clashes`) and where the doc will go (`target`).
-   Before asking the user anything, read the actual token files (`sources.tokens`), UI components (`sources.components`), page code, and `iamu/context.yml` (plus live rendered screens or recent runs if available), and pre-fill the code-evidenced placeholders in `iamu/.analysis/design-draft.md`:
+   Before asking the user anything, read the actual token files (`sources.tokens`), UI components (`sources.components`), page code, and `iamu/context.yml`—or, **when there is no local code (a remote site / URL-only project)**, fetch the live target URL's stylesheets and rendered HTML from `iamu/testability.md` (plus any parent/reference brand URL the user names) to extract CSS custom properties, colour/radius tokens (written into the YAML frontmatter), typography, recurring component patterns, and contrast ratios—and pre-fill the code/site-evidenced placeholders in `iamu/.analysis/design-draft.md`:
    - **Overview — Who it is for:** Synthesize who uses the product and what they come to do from `iamu/context.yml` and the roles and situations the Overview lists, then replace that list with the synthesized role-based words (roles only, never a persona's name or a single-scenario situation number).
    - **Look — Token roles:** Fill in `<what each is for>` for each extracted token group from how stylesheets and components actually apply those tokens (always name tokens in backticks, never raw hex or px values in prose).
    - **Interaction and States:** Extract how `Forms` (error reporting), `Loading`, `Failure`, and `Empty` states are actually implemented in `sources.components` and screens. Describe only the states the product has; missing state patterns go under `Not in the library yet` / `Open Questions`.

package/dist/templates/skills/iamu-setup.md

@@ -284,15 +284,16 @@ Iamu reads design docs wherever they are and never edits them on its own. Run `i
 - **Found docs** (a `DESIGN.md` in any format, design-system, brand, voice or interaction docs, design sections of `CLAUDE.md` or `AGENTS.md` shown as `CLAUDE.md#<heading>`, a `PRODUCT.md`, token files, a component library): list them once, one line each (kind, path). Show a candidate with a `note` (anything in a sample, export, fixture or spike folder) with its note, unticked. Ask once whether to record them; the user may drop some or add others. On yes, `iamu design sources <paths…>` (in a monorepo, `--applies-to` with the URL prefix or the app's folder each doc covers).
 - **A legacy `iamu/design.md`** (`iamu design status --json` shows `legacy.doc` and no `legacy.migrated_at`): fold it into the same single question. Run `iamu design migrate --json` first, and offer three answers next to the files: **move it** to a plain `DESIGN.md` the team owns (`iamu design migrate --move-to DESIGN.md --apply`), **keep** `iamu/design.md` as it is (`iamu design migrate --apply`, which records the choice so it is not offered again), or **not now** (run nothing; it is offered again next time). Only an explicit "keep" runs `--apply` without a move.
 - **Nothing found:** say so in one line: "No design docs found. The designer reviews each run by general craft until you record some (`iamu-design`) — strongly recommended so runs check your own tokens, components, and rules."
-- **No written design doc** (detection found only tokens or components, or nothing, and no design doc is recorded): after the question above, or in its place when there was nothing to record, explain in one sentence why a design doc makes Iamu much stronger (*"With a `DESIGN.md`, Iamu's designer checks your own tokens, components, states, and rules on every run instead of only general craft"*), and ask one question the user may skip:
+- **No written design doc** (detection found only tokens or components, or nothing, and no design doc is recorded): after the question above, or in its place when there was nothing to record, explain in one sentence why a design doc makes Iamu much stronger (*"With a `DESIGN.md`, Iamu's designer checks your own tokens, components, states, and rules on every run instead of only general craft"*), and ask one standalone question the user may skip.
+  - **CRITICAL (Local Code AND Remote Sites):** Mode E works both when local source code exists AND when testing a remote site with no local code (on a remote site, Mode E extracts tokens, typography, component patterns, states, and contrast ratios directly from the live target URL's stylesheets/DOM or a reference brand URL). **NEVER omit Option 1 (`Yes — start DESIGN.md now`), NEVER mark `Not now` as `(Recommended)`, and NEVER batch this question into the same `ask_question` call as Step 3a**—wait for the user's answer to Step 4b first so Mode E can run if they choose Yes:
   - If interactive user-prompt tools exist (`ask_question`, `ask_followup_question`), invoke it:
-    - **Question:** "There is no `DESIGN.md` yet. Iamu gets much sharper with one (every run checks your own tokens, components, states, and rules instead of generic craft). Start one from your code now?"
+    - **Question:** "There is no `DESIGN.md` yet. Iamu gets much sharper with one (every run checks your own tokens, components, states, and rules instead of generic craft). Start one now?"
     - **Options:**
-      1. "(Recommended) Yes — start `DESIGN.md` from my code now (auto-extracts tokens, components, states & formats, then asks 2–3 quick intent questions)"
+      1. "(Recommended) Yes — start `DESIGN.md` now (auto-extracts tokens, components, states & formats from your code or live site, then asks 2–3 quick intent questions)"
       2. "Not now — finish setup first (keep reminding me to run `iamu-design`)"
       3. "No — review by general craft only and stop offering `DESIGN.md`"
   - Otherwise (text-only/CLI):
-    "There is no design doc yet, and Iamu gets much sharper with one (checking your own tokens, components, and rules on every run). Shall I start one from your code? I auto-extract your tokens, components, states, formats and contrast clashes from code, then ask 2–3 quick questions on feel and clash rules. **Yes** (recommended) / **not now** (keep recommending `iamu-design`) / **no**."
+    "There is no design doc yet, and Iamu gets much sharper with one (checking your own tokens, components, and rules on every run). Shall I start one now? I auto-extract your tokens, components, states, formats and contrast clashes from your code or live site, then ask 2–3 quick questions on feel and clash rules. **Yes** (recommended) / **not now** (keep recommending `iamu-design`) / **no**."
   - **Yes:** follow the `iamu-design` skill, mode E, then carry on with setup.
   - **Not now:** run nothing; it stays recommended at the end of setup, in `iamu status`, and after runs until a design doc is recorded.
   - **No:** run `iamu design template --decline`, so runs stop offering it.
@@ -442,7 +443,7 @@ Next step:
     iamu-run <persona-slug>--<outline-slug>
 
 Other commands when you're ready:
-• iamu-design   Create or record DESIGN.md from your code (strongly recommended if not set yet: makes every run check your own tokens, components, and rules instead of general craft)
+• iamu-design   Create or record DESIGN.md from your code or live site (strongly recommended if not set yet: makes every run check your own tokens, components, and rules instead of general craft)
 • iamu-new      Draft a scenario for a different product flow
 • iamu-propose  Brainstorm high-risk workflows and blind spots
 • iamu doctor   Diagnose test environment and target health

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamu-dev/iamu",
-  "version": "0.8.0-beta.8",
+  "version": "0.8.0-beta.9",
   "type": "module",
   "description": "Test your product as realistic personas — scenario-driven development CLI",
   "license": "MIT",
@@ -58,9 +58,9 @@
     "tsup": "^8.5.1",
     "typescript": "^5.8.0",
     "vitest": "^4.1.11",
-    "@iamu-dev/local-store": "0.1.0",
     "@iamu/tsconfig": "0.1.0",
-    "@iamu-dev/protocol": "0.1.0"
+    "@iamu-dev/protocol": "0.1.0",
+    "@iamu-dev/local-store": "0.1.0"
   },
   "scripts": {
     "build": "tsup && tsc -b --force tsconfig.build.json --emitDeclarationOnly && node scripts/copy-assets.mjs",