eidosmd 0.1.0 → 0.2.0

package/standard/seeds/software/roles/README.md

@@ -1,8 +1,8 @@
 # Roles
 
-Default **roles** for this framework — who is in the seat, and how the agent should respond to them. A role is a **response contract**: it sets the vocabulary, the level of technical depth, what to surface vs. fold away, and who holds which decisions. The agent reads it **before acting** (see the Eidos standard's `EIDOS.md`, "The actor").
+Default **roles** for this framework — who is in the seat, and how the agent should respond to them. A role is a **response contract**: it sets the vocabulary, the level of technical depth, what to surface vs. fold away, and who holds which decisions. The agent reads it **before acting** (see the Eidos standard's `EIDOS.md`, "Roles").
 
-These are the opinionated baseline, browsable here and installed into a root's `_eidos/roles/` by `install` (committed, so a team can tune how a role is treated for their product). Each person who works on the folder picks one in their personal, gitignored `_eidos/me.md` and **calibrates** it — what they own on this folder, their experience with the scope, and their technical capacity — with the `whoami` skill. Role sets the baseline; calibration tunes it per person.
+These are the opinionated baseline, browsable here and installed into a root's `.eidos/roles/` by `eidos init` (committed, so a team can tune how a role is treated for their product). Each person who works on the folder picks one in their personal, gitignored `.eidos/me.md` and **calibrates** it — what they own on this folder, their experience with the scope, and their technical capacity — with `eidos whoami`. Role sets the baseline; calibration tunes it per person.
 
 - [Framework Owner](framework-owner.md) — holds intent, scope, and decisions.
 - [Developer](developer.md) — builds from the blueprints.
@@ -10,4 +10,4 @@ These are the opinionated baseline, browsable here and installed into a root's `
 - [Designer](designer.md) — shapes the experience.
 - [Project Manager](project-manager.md) — tracks scope and progress.
 
-A role is a baseline, not a cage: an actor can write a custom role in their `me.md`, and a framework can add or reshape role files here. The human-first principle holds for every role — the human authors and decides; the role only changes _how_ the agent helps.
+A role is a baseline, not a cage: anyone can write a custom role in their `me.md`, and a framework can add or reshape role files here. The human-first principle holds for every role — the human authors and decides; the role only changes _how_ the agent helps.

package/standard/seeds/software/roles/framework-owner.md

@@ -2,11 +2,11 @@
 
 ## Who they are
 
-Holds the **intent, scope, and decisions** — true ownership of whatever it defines, be it a product, a body of research, a methodology, or any other form of thought or effort. The person Eidos is built for — they think through what the thing is, and they own the calls. Everything else serves their clarity.
+Holds the **intent, scope, and decisions** — true ownership of the product, whatever kind it is: an app, a body of research, a methodology, any other form of thought or effort. The person Eidos is built for — they think through what the product is, and they own the calls. Everything else serves their clarity.
 
 ## How to respond
 
-- **Vocabulary & depth:** lead with the terms of the thing itself and the decision at hand. But many Framework Owners are also technical — don't assume otherwise; follow their **technical capacity** calibration and go as deep as they want, rather than withholding mechanism by default.
+- **Vocabulary & depth:** lead with the product's own terms and the decision at hand. But many Framework Owners are also technical — don't assume otherwise; follow their **technical capacity** calibration and go as deep as they want, rather than withholding mechanism by default.
 - **Decisions:** theirs. Bring choices and trade-offs for them to decide; never decide direction or resolve an Open Question on their behalf. Press hardest on **Out of Scope**.
 - **Surface / hide:** surface intent, scope, audience, criteria, and the consequences of a choice; fold mechanism into a link they can follow.
 - **Focus:** Intent, Out of Scope, Audience, Criteria, and whether each blueprint still says what they mean.

package/standard/seeds/software/roles/project-manager.md

@@ -11,8 +11,8 @@ Tracks **scope and progress**, not product direction or implementation. Wants to
 - **Surface / hide:** surface **Out of Scope** (the in/out line), each unit's `status` (its lifecycle stage), `depends_on` and other dependencies, and the Decisions log with the `created`/`modified` dates that show movement. Fold away mechanism and prose rationale.
 - **Focus:** what's in vs. out, what stage each unit is at, what blocks what, and where scope is drifting from Criteria.
 
-Remember Eidos captures **state and intent, not work** — there are no sprint, estimate, or assignee fields, on purpose. So for this actor: read **progress** from `status` and git history (the Decisions log, `created`/`modified`), not a burn-down; infer **level of effort** from a unit's shape — its acceptance criteria, dependencies, and open questions — not a stored estimate; and for sprint-level tracking, point to the tracker a unit links to rather than adding work fields to a blueprint.
+Remember Eidos captures **state and intent, not work** — there are no sprint, estimate, or assignee fields, on purpose. So for this role: read **progress** from `status` and git history (the Decisions log, `created`/`modified`), not a burn-down; infer **level of effort** from a unit's shape — its acceptance criteria, dependencies, and open questions — not a stored estimate; and for sprint-level tracking, point to the tracker a unit links to rather than adding work fields to a blueprint.
 
 ## Calibration
 
-Usually moderate **technical capacity**, and broad-but-shallow **experience with the scope** — they span the whole thing rather than living in one unit. Lean on `status`, dependencies, and the in/out line.
+Usually moderate **technical capacity**, and broad-but-shallow **experience with the scope** — they span the whole product rather than living in one unit. Lean on `status`, dependencies, and the in/out line.

package/standard/seeds/software/roles/stakeholder.md

@@ -9,7 +9,7 @@ Reviews direction and outcomes — a sponsor, a partner, a lead from another tea
 - **Vocabulary & depth:** plain, outcome-oriented language. No implementation detail unless asked; translate everything into impact, scope, and risk.
 - **Decisions:** advisory. They weigh in on direction; the Framework Owner holds the call. Don't ask them to make build decisions.
 - **Surface / hide:** surface summaries, scope, trade-offs, and risk; hide mechanism entirely.
-- **Focus:** Market, Criteria, Roadmap, and the shape of scope — what's in, what's out, what it costs.
+- **Focus:** Market, Criteria, and the shape of scope — what's in, what's out, what it costs.
 
 ## Calibration
 

package/standard/seeds/software/{shapes → templates}/frame.architecture.md

@@ -1,10 +1,3 @@
-<!--
-The Frame shape — architecture flavor. The overarching shape of the product as a built system, one
-per product. Suggestive, not prescriptive: keep the sections that serve the product, drop what doesn't
-yet apply, add what's missing. A Frame's frontmatter is generated from the framework's Schema (in Framework.md), so it is not
-written here. Keep the order and headings; delete the italic prompts as you fill each section in.
--->
-
 # {{title}}
 
 _The overarching shape of the product as a built system. When the detail outgrows a single file, expand into an optional `Arch/` folder and keep this doc as the map that points into it._

package/standard/seeds/software/{shapes → templates}/frame.audience.md

@@ -1,10 +1,3 @@
-<!--
-The Frame shape — audience flavor. Who the product is for, and how each kind of person interacts with
-it differently. This frame and criteria are the two that decide scope. Keep it to simple blocks of
-prose — no tables, no headshot-and-demographics cards. Suggestive, not prescriptive. A Frame's frontmatter is
-generated from the framework's Schema (in Framework.md), so it is not written here. Delete the italic prompts as you fill in.
--->
-
 # {{title}}
 
 _Who the product is for, and how each kind of person interacts with it differently. This frame and Criteria are the two that decide scope: a spec that serves no one here, or serves a persona that doesn't exist here, is a spec to question._
@@ -15,7 +8,7 @@ _Who uses this product, in a paragraph or two. The whole population it is built
 
 ## Personas
 
-_How each kind of person interacts differently. One short block of prose per persona. The point is the difference: what this persona comes for, how they reach for the product, what they ignore. A persona earns its place here only when it interacts in a way the others do not._
+_How each kind of person interacts differently. One short block of prose per persona, never a table or a headshot-and-demographics card. The point is the difference: what this persona comes for, how they reach for the product, what they ignore. A persona earns its place here only when it interacts in a way the others do not._
 
 ### Persona name
 

package/standard/seeds/software/{shapes → templates}/frame.criteria.md

@@ -1,11 +1,3 @@
-<!--
-The Frame shape — criteria flavor. The frame that decides and audits scope: what the product can
-afford, what it is trying to be, and by when. Paired with Audience, this is what a spec is measured
-against. A point-in-time snapshot — record what's true now, revise when it changes. Suggestive, not
-prescriptive. A Frame's frontmatter is generated from the framework's Schema (in Framework.md), so it is not written here.
-Delete the italic prompts as you fill each section in.
--->
-
 # {{title}}
 
 _The frame that decides and audits scope: what the product can afford, what it is trying to be, and by when. When scope creeps, it creeps past this doc._

package/standard/seeds/software/{shapes → templates}/frame.market.md

@@ -1,11 +1,3 @@
-<!--
-The Frame shape — market flavor. Where the product sits in its marketplace, why it is not just another
-one of many, and how it is intended to make money. Answers the two questions a product must survive:
-why would anyone pick this, and how does it earn. A point-in-time snapshot — markets move, revise when
-they do. Suggestive, not prescriptive. A Frame's frontmatter is generated from the framework's Schema (in Framework.md), so it
-is not written here. Delete the italic prompts as you fill each section in.
--->
-
 # {{title}}
 
 _Where the product sits in its marketplace, why it is not just another one of many, and how it is intended to make money._

package/standard/seeds/software/{shapes → templates}/spec.full.md

@@ -1,11 +1,3 @@
-<!--
-The Spec shape — the body of a spec, and the documentation of each section. A spec's
-frontmatter is generated from the framework's Schema (in Framework.md), so it is not written here. Keep the sections
-that apply and delete the rest, but leave the order and headings as they are — a reader should
-know what to expect from any spec in this folder. The italic prompts are guidance; delete
-them as you fill each section in.
--->
-
 # {{title}}
 
 ## Intent

package/standard/seeds/software/{shapes → templates}/spec.micro.md

@@ -1,12 +1,3 @@
-<!--
-The Spec shape — micro flavor. The smallest spec worth writing: why it exists, what you're getting,
-and what it will not do. A starting point that grows into the full flavor (spec.full.md) as the unit
-firms up — add the full flavor's sections (Implementation Notes, Dependencies, Testing, Constraints &
-Decisions, …) when they earn their place, and set `flavor: full` (or drop `flavor`) once it has.
-A spec's frontmatter is generated from the framework's Schema (in Framework.md), so it is not written here. Keep the order and
-headings; the italic prompts are guidance — delete them as you fill each section in.
--->
-
 # {{title}}
 
 ## Intent

package/browser/index.html

@@ -1,268 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Eidos</title>
-<style>
-  :root {
-    color-scheme: light dark;
-    --bg: #fbfaf7; --panel: #f3f1ec; --line: #ddd8cf; --text: #1f1d1a; --muted: #6b665e;
-    --accent: #7a4a1f; --accent-soft: #f1e4d6; --error: #b23a2a; --warn: #9a6a12; --ok: #2f6b3a;
-    --mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
-    --sans: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
-  }
-  @media (prefers-color-scheme: dark) {
-    :root { --bg: #1b1916; --panel: #232019; --line: #3a352c; --text: #ebe6dc; --muted: #a39d92; --accent: #d9a56b; --accent-soft: #3a2d1f; --error: #e2705f; --warn: #d8a437; --ok: #7bc48a; }
-  }
-  * { box-sizing: border-box; }
-  body { margin: 0; font: 15px/1.5 var(--sans); color: var(--text); background: var(--bg); }
-  a { color: var(--accent); }
-  button, select, input, textarea { font: inherit; color: inherit; }
-  button { background: var(--panel); border: 1px solid var(--line); border-radius: 6px; padding: 4px 10px; cursor: pointer; }
-  button:hover { border-color: var(--accent); }
-  button.primary { background: var(--accent); color: var(--bg); border-color: var(--accent); }
-  input, select, textarea { background: var(--bg); border: 1px solid var(--line); border-radius: 6px; padding: 5px 8px; width: 100%; }
-  code, pre { font-family: var(--mono); font-size: 0.92em; }
-  pre { background: var(--panel); padding: 10px 12px; border-radius: 6px; overflow-x: auto; }
-  .layout { display: grid; grid-template-columns: 290px 1fr; min-height: 100vh; }
-  aside { background: var(--panel); border-right: 1px solid var(--line); padding: 14px; overflow-y: auto; position: sticky; top: 0; height: 100vh; }
-  main { padding: 20px 32px 60px; max-width: 980px; }
-  .brand { display: flex; align-items: baseline; gap: 8px; margin-bottom: 10px; }
-  .brand strong { font-size: 18px; }
-  .brand small { color: var(--muted); }
-  .nav a { display: block; padding: 3px 6px; border-radius: 4px; color: inherit; text-decoration: none; }
-  .nav a.active, .nav a:hover { background: var(--accent-soft); }
-  .nav h3 { margin: 14px 0 4px; font-size: 12px; text-transform: uppercase; letter-spacing: .06em; color: var(--muted); display: flex; justify-content: space-between; align-items: center; }
-  .nav h3 button { font-size: 12px; padding: 1px 7px; }
-  .nav h4 { margin: 8px 0 2px 6px; font-size: 12px; color: var(--muted); font-weight: 600; }
-  .nav .bp { font-size: 14px; padding-left: 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
-  .nav .bp.flagged::after { content: " •"; color: var(--warn); }
-  .search { margin: 6px 0 4px; }
-  .toolbar { display: flex; gap: 8px; flex-wrap: wrap; margin-bottom: 18px; align-items: center; }
-  .toolbar .spacer { flex: 1; }
-  .meta { color: var(--muted); font-size: 13px; margin: 0 0 6px; }
-  .meta code { color: var(--text); }
-  h1.title { margin: 0 0 6px; font-size: 26px; }
-  table.props { border-collapse: collapse; margin: 14px 0 22px; font-size: 14px; }
-  table.props td { padding: 3px 12px 3px 0; vertical-align: top; }
-  table.props td:first-child { color: var(--muted); font-family: var(--mono); font-size: 13px; white-space: nowrap; }
-  .body { border-top: 1px solid var(--line); padding-top: 12px; }
-  .body h1 { font-size: 24px; } .body h2 { font-size: 20px; margin-top: 28px; border-bottom: 1px solid var(--line); padding-bottom: 4px; } .body h3 { font-size: 16px; }
-  .body table { border-collapse: collapse; } .body th, .body td { border: 1px solid var(--line); padding: 4px 8px; }
-  .body em:only-child { color: var(--muted); }
-  .findings { margin: 10px 0 16px; padding: 0; list-style: none; font-size: 14px; }
-  .findings li { padding: 4px 8px; border-left: 3px solid var(--warn); background: var(--panel); margin-bottom: 4px; border-radius: 0 4px 4px 0; }
-  .findings li.error { border-left-color: var(--error); }
-  .findings code { color: var(--muted); }
-  .badge { display: inline-block; font-size: 12px; padding: 1px 8px; border-radius: 10px; background: var(--panel); border: 1px solid var(--line); color: var(--muted); margin-left: 6px; }
-  .badge.error { color: var(--error); border-color: var(--error); } .badge.warn { color: var(--warn); border-color: var(--warn); } .badge.ok { color: var(--ok); border-color: var(--ok); }
-  textarea.editor { min-height: 60vh; font-family: var(--mono); font-size: 13px; line-height: 1.45; white-space: pre; }
-  .form { display: grid; grid-template-columns: 140px 1fr; gap: 10px 14px; max-width: 640px; align-items: center; margin: 16px 0; }
-  .form label { color: var(--muted); font-size: 14px; }
-  .toast { position: fixed; right: 20px; bottom: 20px; background: var(--text); color: var(--bg); padding: 10px 16px; border-radius: 8px; max-width: 420px; font-size: 14px; white-space: pre-wrap; box-shadow: 0 6px 24px rgba(0,0,0,.25); }
-  .file-group { margin: 18px 0 6px; font-family: var(--mono); font-size: 14px; }
-  .file-group a { text-decoration: none; }
-  .hint { color: var(--muted); font-size: 13px; }
-  .empty { color: var(--muted); padding: 40px 0; }
-  .fw h2 { margin-top: 26px; }
-  .fw dl { display: grid; grid-template-columns: max-content 1fr; gap: 4px 14px; }
-  .fw dt { color: var(--muted); }
-  @media (max-width: 760px) { .layout { grid-template-columns: 1fr; } aside { position: static; height: auto; } main { padding: 16px; } }
-</style>
-</head>
-<body>
-<div class="layout">
-  <aside>
-    <div class="brand"><strong id="rootName">Eidos</strong><small id="rootVersion"></small></div>
-    <input class="search" id="search" type="search" placeholder="Find a blueprint…" autocomplete="off">
-    <nav class="nav" id="nav"></nav>
-  </aside>
-  <main id="main"><div class="empty">Loading…</div></main>
-</div>
-<script>
-(() => {
-  const $ = (sel, el = document) => el.querySelector(sel);
-  const esc = (s) => String(s ?? '').replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
-  const api = async (method, url, body) => {
-    const res = await fetch(url, { method, headers: body ? { 'content-type': 'application/json' } : {}, body: body ? JSON.stringify(body) : undefined });
-    const data = await res.json().catch(() => ({}));
-    if (!res.ok) throw new Error(data.error || res.statusText);
-    return data;
-  };
-  let state = { root: null, filter: '', flagged: new Set() };
-  let toastTimer;
-  const toast = (msg, ms = 4200) => {
-    let el = $('.toast'); if (!el) { el = document.createElement('div'); el.className = 'toast'; document.body.appendChild(el); }
-    el.textContent = msg; clearTimeout(toastTimer); toastTimer = setTimeout(() => el.remove(), ms);
-  };
-  const route = () => { const h = location.hash.replace(/^#\/?/, ''); const [view, ...rest] = h.split('/'); return { view: view || 'framework', arg: rest.join('/') }; };
-  const go = (path) => { location.hash = '#/' + path; };
-  const bpHref = (p) => '#/blueprint/' + p.split('/').map(encodeURIComponent).join('/');
-
-  async function loadRoot() {
-    state.root = await api('GET', '/api/root');
-    $('#rootName').textContent = state.root.name;
-    $('#rootVersion').textContent = `Eidos ${state.root.framework.eidos_version ?? '?'} · ${state.root.framework.file}`;
-    document.title = `${state.root.name} · Eidos`;
-    renderNav();
-  }
-
-  function renderNav() {
-    const { framework, blueprints } = state.root;
-    const q = state.filter.toLowerCase();
-    const cur = route();
-    const active = (h) => location.hash === h ? ' active' : '';
-    let html = `<a href="#/framework" class="${active('#/framework') || (cur.view === 'framework' ? 'active' : '')}">Framework</a>
-      <a href="#/check" class="${cur.view === 'check' ? 'active' : ''}">Check</a>
-      <a href="#/standard" class="${cur.view === 'standard' ? 'active' : ''}">The standard</a>
-      <a href="#/instructions/overview" class="${cur.view === 'instructions' ? 'active' : ''}">Agent instructions</a>`;
-    for (const c of framework.collections) {
-      const own = blueprints.filter((b) => b.collection === c.name && (!q || [b.title, b.id, b.summary, b.path].some((v) => (v || '').toLowerCase().includes(q))));
-      html += `<h3><span>${esc(c.name)}</span><button data-new="${esc(c.name)}" title="New blueprint in ${esc(c.name)}">+ new</button></h3>`;
-      const groups = [...new Set(own.map((b) => b.group).filter(Boolean))].sort();
-      const item = (b) => `<a class="bp${state.flagged.has(b.path) ? ' flagged' : ''}${cur.view === 'blueprint' && decodeURIComponent(cur.arg) === b.path ? ' active' : ''}" href="${bpHref(b.path)}" title="${esc(b.summary || b.path)}">${esc(b.title)}</a>`;
-      html += own.filter((b) => !b.group).map(item).join('');
-      for (const g of groups) html += `<h4>${esc(g)}</h4>` + own.filter((b) => b.group === g).map(item).join('');
-      if (own.length === 0) html += `<div class="hint" style="padding-left:12px">${q ? 'no match' : 'empty'}</div>`;
-    }
-    $('#nav').innerHTML = html;
-  }
-
-  const findingsHtml = (findings) => findings.length ? `<ul class="findings">${findings.map((f) => `<li class="${f.level}"><code>${esc(f.code)}</code> ${esc(f.message)}</li>`).join('')}</ul>` : '';
-
-  async function viewBlueprint(pathArg) {
-    const p = decodeURIComponent(pathArg);
-    const main = $('#main');
-    let b;
-    try { b = await api('GET', '/api/blueprints/' + p.split('/').map(encodeURIComponent).join('/')); }
-    catch (e) { main.innerHTML = `<div class="empty">${esc(e.message)}</div>`; return; }
-    const errors = b.findings.filter((f) => f.level === 'error').length, warns = b.findings.length - errors;
-    const badge = errors ? `<span class="badge error">${errors} error${errors > 1 ? 's' : ''}</span>` : '';
-    const wbadge = warns ? `<span class="badge warn">${warns} warning${warns > 1 ? 's' : ''}</span>` : '';
-    // a property value that is a markdown link opens the blueprint it points at
-    const val = (x) => { const m = typeof x === 'string' && /^\s*\[([^\]]*)\]\(([^)]+)\)\s*$/.exec(x); if (!m) return `<code>${esc(x)}</code>`; const hit = state.root.blueprints.find((y) => y.path === resolveRel(p, m[2].split('#')[0])); return hit ? `<a href="${bpHref(hit.path)}">${esc(m[1])}</a>` : `<span title="not a blueprint in this root: ${esc(m[2])}">${esc(m[1])}</span> <span class="badge error">broken</span>`; };
-    const props = Object.entries(b.properties).map(([k, v]) => `<tr><td>${esc(k)}</td><td>${Array.isArray(v) ? (v.length ? v.map(val).join(', ') : '<span class="hint">[]</span>') : (v === null || v === '' ? '<span class="hint">—</span>' : esc(v))}</td></tr>`).join('');
-    const missing = b.shape_sections.filter((s) => !b.sections.map((x) => x.toLowerCase()).includes(s.toLowerCase()));
-    main.innerHTML = `
-      <div class="toolbar"><span class="meta">${esc(b.collection)}${b.group ? ' / ' + esc(b.group) : ''} · <code>${esc(b.path)}</code> · ${esc(b.flavor || '')}</span><span class="spacer"></span>
-        <button id="edit">Edit</button></div>
-      <h1 class="title">${esc(b.title)}${badge}${wbadge}</h1>
-      <p class="meta">id <code>${esc(b.id || '(none)')}</code>${b.summary ? ' · ' + esc(b.summary) : ' · <span class="hint">no summary yet</span>'}</p>
-      ${findingsHtml(b.findings)}
-      ${missing.length ? `<p class="hint">Sections the ${esc(b.flavor)} shape declares and this blueprint lacks: ${missing.map((s) => `<code>${esc(s)}</code>`).join(', ')}</p>` : ''}
-      <table class="props">${props}</table>
-      <div class="body" id="body">${b.html}</div>
-      <div id="editor" hidden><textarea class="editor" id="text"></textarea>
-        <div class="toolbar" style="margin-top:10px"><button class="primary" id="save">Save</button><button id="cancel">Cancel</button><span class="hint">Saving runs the check on this file; the result shows above.</span></div></div>`;
-    if (b.findings.length) state.flagged.add(p); else state.flagged.delete(p);
-    renderNav();
-    // relative .md links open the blueprint they point at
-    for (const a of main.querySelectorAll('#body a[href]')) {
-      const href = a.getAttribute('href');
-      if (/^[a-z]+:/i.test(href) || href.startsWith('#')) continue;
-      const target = resolveRel(p, href.split('#')[0]);
-      const hit = state.root.blueprints.find((x) => x.path === target);
-      if (hit) { a.href = bpHref(hit.path); } else { a.title = 'not a blueprint in this root: ' + target; a.addEventListener('click', (e) => { e.preventDefault(); toast('Not a blueprint in this root: ' + target); }); }
-    }
-    $('#edit').onclick = () => { $('#body').hidden = true; $('#editor').hidden = false; $('#text').value = b.raw; $('#edit').hidden = true; $('#text').focus(); };
-    $('#cancel').onclick = () => viewBlueprint(pathArg);
-    $('#save').onclick = async () => {
-      try { const r = await api('PUT', '/api/blueprints/' + p.split('/').map(encodeURIComponent).join('/'), { text: $('#text').value }); toast(r.findings.length ? `Saved. ${r.findings.length} finding${r.findings.length > 1 ? 's' : ''} on this file.` : 'Saved. No findings.'); await loadRoot(); viewBlueprint(pathArg); }
-      catch (e) { toast('Save failed: ' + e.message); }
-    };
-  }
-  function resolveRel(from, href) {
-    const parts = from.split('/').slice(0, -1);
-    for (const seg of decodeURIComponent(href).split('/')) { if (seg === '..') parts.pop(); else if (seg !== '.' && seg !== '') parts.push(seg); }
-    return parts.join('/');
-  }
-
-  function viewFramework() {
-    const f = state.root.framework, a = state.root.actor;
-    const flav = (c) => c.flavors.map((x) => `<code>${esc(x.name)}</code>${x.default ? ' (default)' : ''}${x.description ? ' — ' + esc(x.description) : ''}`).join('<br>');
-    const canvas = (c) => !c.canvas ? '' : typeof c.canvas === 'string' ? c.canvas : `card from ## ${esc(c.canvas.section)}`;
-    $('#main').innerHTML = `<div class="fw">
-      <h1 class="title">${esc(state.root.name)}</h1>
-      <p class="meta">Eidos ${esc(f.eidos_version ?? 'unversioned')} · naming <code>${esc(f.naming)}</code> · <code>${esc(f.file)}</code> · CLI ${esc(state.root.cli_version)} (standard ${esc(state.root.standard_version)})</p>
-      ${f.problems.length ? findingsHtml(f.problems.map((m) => ({ level: 'error', code: 'framework-invalid', message: m }))) : ''}
-      <div class="toolbar"><button id="reindex">Rebuild index</button><button id="runcheck">Run check</button><span class="hint">Both run exactly what <code>eidos index</code> and <code>eidos check</code> run.</span></div>
-      <h2>Actor</h2><p>${a.exists && a.role ? `<strong>${esc(a.role)}</strong> · ownership: ${esc(a.ownership || '—')} · experience: ${esc(a.experience || '—')} · capacity: ${esc(a.capacity || '—')}` : `<span class="hint">unset (full facilitation) — set it with <code>eidos whoami --role &lt;name&gt;</code></span>`}</p>
-      <p class="hint">Roles installed: ${state.root.roles.map((r) => `<code>${esc(r.name)}</code>`).join(', ') || 'none'}</p>
-      <h2>Collections</h2>
-      ${f.collections.map((c, i) => `<h3>${esc(c.name)}${i === 0 ? ' <span class="badge">framing</span>' : ''}${c.grouping ? ` <span class="badge">grouped by ${esc(c.grouping.label)}${c.grouping.property ? ' (' + esc(c.grouping.property) + ')' : ''}</span>` : ''}</h3>
-        ${c.description ? `<p>${esc(c.description)}</p>` : ''}
-        <dl><dt>flavors</dt><dd>${flav(c)}</dd>${c.canvas ? `<dt>canvas</dt><dd>${canvas(c)}</dd>` : ''}${c.grouping && c.grouping.groups ? `<dt>groups</dt><dd>${c.grouping.groups.map((g) => `<code>${esc(g.name)}</code>${g.description ? ' — ' + esc(g.description) : ''}`).join('<br>')}</dd>` : ''}</dl>`).join('')}
-      <h2>Schema</h2>
-      <table class="props"><tr><td>core</td><td>${f.schema.core.map((p) => `<code>${esc(p.name)}</code>`).join(' ')}</td></tr>
-      ${f.schema.custom.map((p) => `<tr><td>${esc(p.name)}</td><td><span class="badge">${esc(p.type)}</span> <span class="badge">${Array.isArray(p.applies_to) ? esc(p.applies_to.join(', ')) : 'all'}</span> ${esc(p.meaning)}</td></tr>`).join('')}</table>
-      ${f.top_level && f.top_level.length ? `<h2>Top-level docs</h2><ul>${f.top_level.map((d) => `<li><strong>${esc(d.title)}</strong> <code>${esc(d.path)}</code>${d.description ? ' — ' + esc(d.description) : ''}</li>`).join('')}</ul>` : ''}
-    </div>`;
-    $('#reindex').onclick = async () => { try { const r = await api('POST', '/api/index'); toast(r.indexes.map((i) => `${i.collection}: ${i.status} (${i.blueprints})`).join('\n') + (r.missing_summary.length ? `\n${r.missing_summary.length} blueprint(s) still need a summary` : '')); } catch (e) { toast(e.message); } };
-    $('#runcheck').onclick = () => go('check');
-  }
-
-  async function viewCheck() {
-    const main = $('#main'); main.innerHTML = '<div class="empty">Checking…</div>';
-    const r = await api('GET', '/api/check');
-    state.flagged = new Set(r.findings.map((f) => f.path).filter(Boolean));
-    renderNav();
-    const byFile = new Map();
-    for (const f of r.findings) { const k = f.path || '(root)'; if (!byFile.has(k)) byFile.set(k, []); byFile.get(k).push(f); }
-    const isBp = (k) => state.root.blueprints.some((b) => b.path === k);
-    main.innerHTML = `<h1 class="title">Check <span class="badge ${r.errors ? 'error' : r.warnings ? 'warn' : 'ok'}">${r.errors} error${r.errors === 1 ? '' : 's'}, ${r.warnings} warning${r.warnings === 1 ? '' : 's'}</span></h1>
-      <p class="meta">${r.blueprints} blueprints in ${r.collections} collections · Eidos ${esc(r.eidos_version ?? '?')} · ${esc(r.naming)} · the same report as <code>eidos check</code></p>
-      ${r.findings.length === 0 ? '<p class="empty">No findings.</p>' : ''}
-      ${[...byFile.entries()].map(([k, fs]) => `<div class="file-group">${isBp(k) ? `<a href="${bpHref(k)}">${esc(k)}</a>` : esc(k)}</div>${findingsHtml(fs)}`).join('')}`;
-  }
-
-  async function viewDoc(url, title) {
-    const main = $('#main'); main.innerHTML = '<div class="empty">Loading…</div>';
-    const r = await api('GET', url);
-    main.innerHTML = `<div class="body" style="border:0">${r.html}</div>`;
-  }
-
-  function viewNew(collectionName) {
-    const f = state.root.framework;
-    const c = f.collections.find((x) => x.name === collectionName) || f.collections[0];
-    const groups = (c.grouping && c.grouping.groups) ? c.grouping.groups.map((g) => g.name) : [];
-    $('#main').innerHTML = `<h1 class="title">New blueprint</h1>
-      <p class="hint">Runs <code>eidos new</code>: frontmatter from the Schema, body from the flavor's shape, filename in the naming convention. You fill the prose afterwards.</p>
-      <div class="form">
-        <label>Collection</label><select id="n-col">${f.collections.map((x) => `<option ${x.name === c.name ? 'selected' : ''}>${esc(x.name)}</option>`).join('')}</select>
-        <label>Title</label><input id="n-title" placeholder="Session Management" autofocus>
-        <label>Flavor</label><select id="n-flavor">${c.flavors.map((x) => `<option ${x.default ? 'selected' : ''}>${esc(x.name)}</option>`).join('')}</select>
-        <label>Group</label><input id="n-group" list="n-groups" placeholder="${groups.length ? 'one of the declared groups, or a new one' : c.grouping ? c.grouping.label : 'optional sub-folder'}"><datalist id="n-groups">${groups.map((g) => `<option value="${esc(g)}">`).join('')}</datalist>
-        <label>Summary</label><input id="n-summary" placeholder="One plain line: what this blueprint is.">
-        <span></span><div class="toolbar"><button class="primary" id="n-create">Create</button><button id="n-cancel">Cancel</button></div>
-      </div>`;
-    $('#n-col').onchange = () => viewNew($('#n-col').value);
-    $('#n-cancel').onclick = () => history.back();
-    $('#n-create').onclick = async () => {
-      try {
-        const r = await api('POST', '/api/blueprints', { collection: $('#n-col').value, title: $('#n-title').value, flavor: $('#n-flavor').value, group: $('#n-group').value, summary: $('#n-summary').value });
-        toast(`Created ${r.path}` + (r.notes.length ? '\n' + r.notes.join('\n') : ''), 6000);
-        await loadRoot(); go('blueprint/' + r.path.split('/').map(encodeURIComponent).join('/'));
-      } catch (e) { toast(e.message, 6000); }
-    };
-  }
-
-  async function render() {
-    const { view, arg } = route();
-    renderNav();
-    if (view === 'blueprint') return viewBlueprint(arg);
-    if (view === 'check') return viewCheck();
-    if (view === 'standard') return viewDoc('/api/standard');
-    if (view === 'instructions') return viewDoc('/api/instructions/' + (arg || 'overview'));
-    if (view === 'new') return viewNew(decodeURIComponent(arg));
-    return viewFramework();
-  }
-
-  $('#search').addEventListener('input', (e) => { state.filter = e.target.value; renderNav(); });
-  $('#nav').addEventListener('click', (e) => { const b = e.target.closest('button[data-new]'); if (b) go('new/' + encodeURIComponent(b.dataset.new)); });
-  window.addEventListener('hashchange', render);
-  loadRoot().then(render).catch((e) => { $('#main').innerHTML = `<div class="empty">${esc(e.message)}</div>`; });
-})();
-</script>
-</body>
-</html>

package/dist/src/commands/convert.js

@@ -1,30 +0,0 @@
-// `eidos convert`: move a markdown root to Framework.yaml, the form the CLI works in.
-import path from 'node:path';
-import { loadRoot } from '../context.js';
-import { convertToYaml } from '../core/convert.js';
-import { EXIT_OK, print, printJson } from '../output.js';
-export function runConvert(globals, options, cwd = process.cwd()) {
-    const context = loadRoot(globals, cwd, { allowMarkdown: true });
-    const display = (file) => path.relative(cwd, file) || file;
-    if (context.framework.format === 'yaml') {
-        if (options.json) {
-            printJson({ converted: false, framework_file: display(context.framework.file), reason: 'already YAML' });
-        }
-        else {
-            print(`${display(context.framework.file)} is already the YAML form; nothing to convert`);
-        }
-        return EXIT_OK;
-    }
-    const result = convertToYaml(context.framework, options.dryRun);
-    if (options.json) {
-        printJson({ converted: !options.dryRun, dry_run: options.dryRun, framework_file: display(result.written), removed: result.removed.map(display), actions: result.actions.map(display) });
-        return EXIT_OK;
-    }
-    print(...result.actions.map(display));
-    print('', `${options.dryRun ? 'would convert' : 'converted'}: ${display(context.framework.file)} → ${display(result.written)}, index inside it`);
-    print("  left behind: the markdown form's prose (section intros, comments); each collection's description travelled. Keep anything that matters in the root's README.");
-    if (!options.dryRun) {
-        print('  next: eidos check');
-    }
-    return EXIT_OK;
-}

package/dist/src/core/shape.js

@@ -1,26 +0,0 @@
-// A shape file: one body template in `_eidos/shapes/`, read for the sections
-// it declares (to validate a blueprint against) and as the template a new
-// blueprint's body is rendered from.
-import { existsSync, readFileSync } from 'node:fs';
-import { headings } from './markdown.js';
-import { shapePath } from './framework.js';
-export function loadShape(framework, flavor) {
-    const file = shapePath(framework, flavor);
-    if (!existsSync(file)) {
-        return null;
-    }
-    const template = readFileSync(file, 'utf8');
-    const all = headings(template);
-    return {
-        path: file,
-        flavor,
-        template,
-        sections: all.filter((heading) => heading.level === 2).map((heading) => heading.text),
-        headings: all,
-    };
-}
-// The body a scaffolded blueprint starts from: the template with its title
-// filled in and any leading blank lines dropped.
-export function renderShape(template, title) {
-    return template.replace(/\r\n?/g, '\n').replace(/\{\{title\}\}/g, title).replace(/^\n+/, '');
-}

package/standard/seeds/book/Framework.md

@@ -1,87 +0,0 @@
----
-# The Eidos version this framework targets; migrate reads and bumps it.
-eidos_version: 4.5.0
-# How files, folders, and links are named: kebab-case | TitleCase | Title Case. Absent = kebab-case.
-naming: kebab-case
----
-
-# Framework
-
-The framework's index and config, in one place: the version and naming convention above, and below the
-Top-Level documents, the Collections (with their flavors and grouping), and the property Schema. The
-visible `README.md` at the root is the friendly door to it; keep it current with the
-`configure` skill.
-
-## Top-Level
-
-<!-- configure: top-level index (regenerated) -->
-- [README](../README.md) — the root's front door: what this book is, and pointers in.
-<!-- One bullet per top-level document. README is the door and comes first; add your own below (an
-     Outline, a Synopsis, the generated Blueprint Map canvas), each a link and a one-line description.
-     The framing docs live in the Frames collection, not here. configure refreshes this list. -->
-
-## Collections
-
-A collection is a top-level folder of repeated blueprints that share a body shape. `Frames` holds the
-framing docs — the most primary thing the folder says about itself — and `Chapters` the book's
-units. Add more with `configure`. Each lists its flavors (the default marked), how it draws on
-the canvas, and its grouping, and points at its generated `index.md` leaf.
-
-### Frames
-
-The framing docs that set what every chapter is judged against — what the book argues, who it is for,
-how it sounds, and where it sits. This framework's framing collection; each frame follows the flavor
-of its kind, and one left unwritten is a gap to surface, not a failure.
-
-- **Leaf:** [Frames/index.md](../Frames/index.md)
-- **Flavors:**
-  - [premise](shapes/frame.premise.md) — what the book says, and why it has to exist (default).
-  - [reader](shapes/frame.reader.md) — who it is for, and what changes for them.
-  - [voice](shapes/frame.voice.md) — person, tense, register, and the rules the prose keeps.
-  - [market](shapes/frame.market.md) — shelf, comparables, and how it reaches readers.
-- **Canvas:** file
-
-### Chapters
-
-The book's units, one per chapter, grouped by part.
-
-- **Leaf:** [Chapters/index.md](../Chapters/index.md)
-- **Flavors:**
-  - [full](shapes/chapter.full.md) — the complete chapter shape (default).
-  - [sketch](shapes/chapter.sketch.md) — Intent, Open Questions, What Happens, Out of Scope; grow into full.
-- **Canvas:** card from `## Intent`
-- **Parts:** _(add one bullet per part — a name and a short description — as parts accrue)_
-
-## Schema
-
-The property contract — what a blueprint's frontmatter may carry, across every collection. Two parts: the
-**core** properties Eidos's own machinery uses, and the **custom** ones you (or the seed) add. Every
-custom property declares which collections it **applies to** — `all`, or a list — so a property never
-lands where it makes no sense (`part` is Chapters-only). A property's type comes from the Obsidian set
-(Text, List, Number, Checkbox, Date, Date & time), so frontmatter renders natively in an Obsidian
-vault. The `configure` skill edits this section.
-
-### Eidos Core
-
-_Present on every blueprint. Managed by the standard (Eidos 4.5.0); `migrate` rewrites this block on a version change — don't hand-edit it. (`flavor` absent = the collection's default; `connects_to` absent = no canvas edges; a missing `summary` is flagged by the index.)_
-
-| Name        | Type | Meaning                                                                                        |
-| ----------- | ---- | ---------------------------------------------------------------------------------------------- |
-| id          | Text | Stable, unique, kebab-case identity. Assigned once, never renamed. References point at it.      |
-| title       | Text | Human-readable name.                                                                           |
-| summary     | Text | One plain line — what this blueprint is, in a sentence, distilled from Intent. Source for the collection index.md listing; absent, the index flags it. |
-| flavor      | Text | Which body flavor this blueprint follows, from its collection's declared flavors. Absent = the collection's default flavor. |
-| connects_to | List | Blueprints this one connects to on the canvas, each a markdown link; drawn as a directed edge (this → target). The intentional map, distinct from depends_on. |
-
-### Custom Properties
-
-_Yours to shape with the `configure` skill. The seed ships a few useful defaults below — keep, scope, or drop any of them; Eidos doesn't depend on them. Absence where a property applies is a soft gap the validator notes, never refuses._
-
-| Name          | Type | Applies To | Meaning                                                                                    |
-| ------------- | ---- | ---------- | ------------------------------------------------------------------------------------------ |
-| status        | Text | all        | Lifecycle value: Draft / Outlined / Drafted / Revised / Final / Cut. An off-list value warns. |
-| date_created  | Date | all        | YYYY-MM-DD. The day the blueprint was first written. Set once.                                   |
-| date_modified | Date | all        | YYYY-MM-DD. The day the blueprint was last changed.                                              |
-| tags          | List | all        | Free tags.                                                                                  |
-| part          | Text | Chapters   | The grouping, matching the blueprint's sub-folder under its collection in the naming convention. An unknown value warns, never fails. |
-| depends_on    | List | Chapters   | Chapters a reader must have read first, each a markdown link. A reading dependency, not a canvas edge. |

package/standard/seeds/book/shapes/frame.premise.md

@@ -1,24 +0,0 @@
-<!--
-The Premise frame — what the book says and why it has to exist. Loose, point-in-time prose: record
-what is true now and revise when it changes. Suggestive, not prescriptive. A Frame's frontmatter is
-generated from the framework's Schema (in Framework.md), so it is not written here. Delete the italic
-prompts as you fill in.
--->
-
-# Premise
-
-## The Argument
-
-_In a few sentences: what this book claims, or what story it tells. If you can't say it without a list, it isn't a premise yet._
-
-## Why It Has To Exist
-
-_What is wrong, missing, or misunderstood in the world without this book. The problem the reader has._
-
-## The Shape of It
-
-_How the whole thing is built — parts, arc, the movement from the first page to the last. Not a table of contents; the logic behind one._
-
-## What It Is Not
-
-_The adjacent book you are deliberately not writing. This is where a book's scope is held._