@esneiderbravo/speclaw 0.1.1 → 0.1.3

package/README.md

@@ -37,17 +37,21 @@ One command. No cloud, no LLM, no API keys — <b>everything runs on your machin
 
 ## ◆ Quick start
 
+In your project root:
+
+```bash
+npx @esneiderbravo/speclaw init
+```
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/terminal-quickstart.png" width="800" alt="npx @esneiderbravo/speclaw init">
 </p>
 
-<p align="center">Copy &amp; run in your project root: <code>npx @esneiderbravo/speclaw init</code></p>
-
 `init` will:
 
 1. **Ask which agents you use** (Claude Code, Cursor, Codex, …) — and configure
    only those. Add more later; nothing is forced on you.
-2. Write the **foundation** (constitution + standards) and the **spec workflow**.
+2. Write the **foundation** (constitution + standards) and the **lawbook workflow**.
 3. **Index your code** with a live progress bar and a summary of what it found.
 4. Register the speclaw **MCP server** in each chosen agent's config.
 5. Print a prompt to paste into your agent so it fills the constitution with your
@@ -71,12 +75,12 @@ Works with `npm`, `pnpm` (`pnpm dlx @esneiderbravo/speclaw init`), and `yarn`.
 
 | Module | What it does |
 | :-- | :-- |
-| **Foundation** | The project's constitution: `LAWS.md` binding a set of granular standards under `docs/standards/` (base, architecture, backend, frontend, testing, documentation, conventions, spec-workflow), plus strict `CLAUDE.md` / `AGENTS.md` agent contracts — filled from your real codebase. |
+| **Foundation** | The project's constitution: `LAWS.md` binding a set of granular standards under `docs/standards/` (base, architecture, backend, frontend, testing, documentation, conventions, lawbook), plus strict `CLAUDE.md` / `AGENTS.md` agent contracts — filled from your real codebase. |
 | **Compass** | speclaw's own local code graph. Parses your code (tree-sitter) into nodes + edges plus a local vector store, so an agent finds and understands code with a fraction of the tokens a grep/read loop would cost. No LLM, 100% local, lives in `.speclaw/` (gitignored). |
-| **Spec** | speclaw's own spec-driven workflow: `draft → build → sync → archive` (and `explore`), backed by `spec_*` engine tools. No external CLI. |
+| **Lawbook** | speclaw's own spec-driven workflow: `draft → build → sync → archive` (and `explore`), backed by `lawbook_*` engine tools. No external CLI. |
 | **Tools** | Opt-in packs of skills and subagents (currently the dev-agents) that agents use for specific tasks. |
 
-Compass is inspired by [CodeGraph](https://github.com/colbymchenry/codegraph) and the Spec module by [OpenSpec](https://github.com/Fission-AI/openspec) — both MIT. speclaw reimplements the ideas as its own code and gives full credit; see [ATTRIBUTION.md](ATTRIBUTION.md).
+Compass is inspired by [CodeGraph](https://github.com/colbymchenry/codegraph) and the Lawbook module by [OpenSpec](https://github.com/Fission-AI/openspec) — both MIT. speclaw reimplements the ideas as its own code and gives full credit; see [ATTRIBUTION.md](ATTRIBUTION.md).
 
 <br/>
 
@@ -85,7 +89,7 @@ Compass is inspired by [CodeGraph](https://github.com/colbymchenry/codegraph) an
 speclaw meets you where you are. Everything works through the **CLI** — so no one
 is blocked by MCP setup — and the same capabilities are exposed as **MCP tools**
 for a smoother, integrated experience once configured. An agent without MCP can
-still use Compass and the spec engine by calling the CLI from its shell.
+still use Compass and the lawbook engine by calling the CLI from its shell.
 
 <p align="center"><b>CLI</b> — the installer &amp; operator, runs anywhere <code>node</code> does</p>
 <p align="center"><img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/terminal-cli.png" width="800" alt="speclaw CLI commands"></p>
@@ -110,7 +114,7 @@ still use Compass and the spec engine by calling the CLI from its shell.
 > of AI coding agents isn't lack of capability — it's working without the project's
 > tacit knowledge: the rules the team actually lives by. speclaw makes that
 > knowledge explicit, executable, and binding, and gives agents a local map
-> (Compass) and a disciplined workflow (Spec) to act on it — without burning tokens.
+> (Compass) and a disciplined workflow (Lawbook) to act on it — without burning tokens.
 
 <br/>
 

package/dist/cli/commands/init.js

@@ -2,12 +2,12 @@ import fs from "node:fs";
 import path from "node:path";
 import * as clack from "@clack/prompts";
 import { scaffold } from "../../modules/foundation/scaffold.js";
-import { specInit } from "../../modules/spec/engine.js";
+import { specInit } from "../../modules/lawbook/engine.js";
 import { buildIndex } from "../../modules/compass/indexer.js";
 import { AGENTS, agentById } from "../../shared/agents.js";
 import { loadPacks } from "../../modules/tools/packs.js";
 import { list } from "../lib/args.js";
-import { ui, c, banner, renderProgress, clearProgress, box } from "../lib/ui.js";
+import { ui, c, banner, renderProgress, clearProgress } from "../lib/ui.js";
 const PACK_LABELS = {
     agents: "dev-agents (backend · frontend · product)",
 };
@@ -26,8 +26,7 @@ function detectProjectName(cwd) {
  * Interactive setup: pick agents and packs, scaffold, index, and print the handoff prompt.
  *
  * @param flags - Parsed flags; runs interactively on a TTY unless `--agents`, `--yes`, or
- *   `-y` is set. Honors `--project-name`, `--ticket-prefix`, `--team-language`, `--packs`,
- *   and `--no-index`.
+ *   `-y` is set. Honors `--project-name`, `--packs`, and `--no-index`.
  */
 export async function runInit(flags) {
     const cwd = process.cwd();
@@ -35,8 +34,6 @@ export async function runInit(flags) {
     const interactive = Boolean(process.stdin.isTTY) && !flags.agents && !flags.yes && !flags.y;
     let agents;
     let packs;
-    let ticketPrefix = flags["ticket-prefix"];
-    let teamLanguage = flags["team-language"];
     banner();
     if (interactive) {
         const answers = await clack.group({
@@ -56,13 +53,9 @@ export async function runInit(flags) {
                 initialValues: ["agents"],
                 required: false,
             }),
-            ticketPrefix: () => clack.text({ message: "Ticket prefix (optional, e.g. FAR)", defaultValue: "" }),
-            teamLanguage: () => clack.text({ message: "Team communication language", defaultValue: "English" }),
         }, { onCancel: () => process.exit(1) });
         agents = answers.agents;
         packs = answers.packs;
-        ticketPrefix = answers.ticketPrefix || undefined;
-        teamLanguage = answers.teamLanguage || undefined;
     }
     else {
         agents = list(flags.agents).length ? list(flags.agents) : ["claude"];
@@ -73,20 +66,16 @@ export async function runInit(flags) {
         ui.err(`Unknown agent(s): ${unknownAgents.join(", ")}. Known: ${AGENTS.map((a) => a.id).join(", ")}`);
         process.exit(1);
     }
-    const profile = {
-        project_name: projectName,
-        ...(ticketPrefix ? { ticket_prefix: ticketPrefix } : {}),
-        ...(teamLanguage ? { team_language: teamLanguage } : {}),
-    };
+    const profile = { project_name: projectName };
     // 1. Content + chosen agents, with a check per piece installed
     ui.step(`Setting up ${c.bold(c.cyan(projectName))}`);
     scaffold(cwd, profile, packs, agents);
     ui.ok(`Foundation ${c.muted("— LAWS.md + 8 standards + CLAUDE.md/AGENTS.md")}`);
-    ui.ok(`Spec workflow ${c.muted("— draft · build · sync · archive · explore")}`);
+    ui.ok(`Lawbook workflow ${c.muted("— draft · build · sync · archive · explore")}`);
     for (const p of packs)
         ui.ok(`${PACK_LABELS[p] ?? p + " pack"}`);
     specInit(cwd);
-    ui.ok(`Spec workspace ${c.muted("— spec/")}`);
+    ui.ok(`Lawbook workspace ${c.muted("— lawbook/")}`);
     ui.step("Configuring agents");
     for (const id of agents)
         ui.ok(`${agentById(id).label} ${c.muted("— symlinks + MCP")}`);
@@ -100,19 +89,20 @@ export async function runInit(flags) {
             c.bold(c.cream(String(stats.edges))) + c.muted(" edges · ") +
             c.bold(c.cream(String(stats.embeddings))) + c.muted(" embeddings"));
     }
-    // 3. Handoff prompt for the chosen agent
+    // 3. Handoff prompt for the chosen agent — printed as a single flush-left
+    // line so it copy-pastes cleanly (no borders, no wrapping artifacts).
     const primary = agentById(agents[0]);
     ui.step("You're set — one last step");
-    ui.info(`Paste this into ${c.cyan(primary.label)} to build your constitution:`);
     ui.plain();
-    box([
-        "Complete speclaw's foundation: analyze this repo and fill",
-        "LAWS.md and docs/standards/* with the real architecture,",
-        "quality gates and conventions. Use init_project to start.",
-    ], "prompt");
+    ui.info(`Copy this and paste it into ${c.cyan(primary.label)}:`);
     ui.plain();
-    ui.info(`The dev-agents read those standards for your stack — filling them well`);
-    ui.info(`makes them stack-aware.`);
+    console.log(c.cream("Complete speclaw's foundation: analyze this repo and fill LAWS.md and " +
+        "docs/standards/* with its real architecture, quality gates and conventions. " +
+        "Infer the working language and conventions from the repo itself — docstrings, " +
+        "commit messages, branch names, PR and ticket language — don't assume. " +
+        "Start with init_project."));
+    ui.plain();
+    ui.info(`The dev-agents read those standards for your stack — filling them well makes them stack-aware.`);
     ui.plain();
     ui.info(`Add an agent:   ${ui.code("speclaw agent add cursor")}`);
     ui.info(`Refresh index:  ${ui.code("speclaw index")}`);

package/dist/cli/commands/{spec.js → lawbook.js}

@@ -1,4 +1,4 @@
-import { specInit, specValidate, specSync, specArchive, specList } from "../../modules/spec/engine.js";
+import { specInit, specValidate, specSync, specArchive, specList } from "../../modules/lawbook/engine.js";
 import { ui } from "../lib/ui.js";
 function today() {
     // The MCP path passes the date in; the CLL runs on a real machine, so read it here.
@@ -17,14 +17,14 @@ export async function runSpec(flags) {
         switch (sub) {
             case "init": {
                 const r = specInit(cwd);
-                ui.ok(r.alreadyExisted ? "spec/ already present" : `spec/ created (${r.created.length} entries)`);
+                ui.ok(r.alreadyExisted ? "lawbook/ already present" : `lawbook/ created (${r.created.length} entries)`);
                 return;
             }
             case "list": {
                 const r = specList(cwd);
                 if (!r.initialized)
-                    return ui.warn("No spec/ — run `speclaw spec init`.");
-                ui.heading("Spec workspace");
+                    return ui.warn("No lawbook/ — run `speclaw lawbook init`.");
+                ui.heading("Lawbook workspace");
                 ui.info(`active changes: ${r.activeChanges.join(", ") || "none"}`);
                 ui.info(`archived: ${r.archivedChanges.join(", ") || "none"}`);
                 ui.info(`capabilities: ${r.capabilities.join(", ") || "none"}`);
@@ -52,7 +52,7 @@ export async function runSpec(flags) {
                 return;
             }
             default:
-                ui.err("Usage: speclaw spec <init|list|validate|sync|archive> [change]");
+                ui.err("Usage: speclaw lawbook <init|list|validate|sync|archive> [change]");
                 process.exit(1);
         }
     }

package/dist/cli/commands/visualize.js

@@ -0,0 +1,44 @@
+import { spawn } from "node:child_process";
+import { visualize } from "../../modules/compass/visualize.js";
+import { ui, c } from "../lib/ui.js";
+/** Open a file in the OS default application (browser for .html). */
+function openInBrowser(file) {
+    const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    try {
+        spawn(cmd, [file], { stdio: "ignore", detached: true, shell: process.platform === "win32" }).unref();
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/**
+ * Build an interactive HTML visualization of the Compass graph into
+ * .speclaw/graph.html and open it.
+ *
+ * @param flags - `_[0]` optionally focuses on a node; `--depth`, `--limit`, `--no-open`.
+ * @throws Exits the process with code 1 if the index is missing or generation fails.
+ */
+export async function runVisualize(flags) {
+    const cwd = process.cwd();
+    const focus = flags._[0];
+    try {
+        const r = visualize(cwd, {
+            focus,
+            depth: flags.depth ? Number(flags.depth) : undefined,
+            limit: flags.limit ? Number(flags.limit) : undefined,
+        });
+        ui.step("Compass graph");
+        ui.ok(c.bold(c.cream(String(r.shown))) + c.muted(" nodes · ") +
+            c.bold(c.cream(String(r.links))) + c.muted(" edges") +
+            (focus ? c.muted(` · focused on ${focus}`) : c.muted(` · top of ${r.total}`)));
+        ui.info(`→ ${ui.code(".speclaw/graph.html")}`);
+        if (!flags["no-open"]) {
+            openInBrowser(r.path);
+            ui.info("Opening in your browser…");
+        }
+    }
+    catch (err) {
+        ui.err(err.message);
+        process.exit(1);
+    }
+}

package/dist/cli/index.js

@@ -18,13 +18,14 @@ Compass (code intelligence — the same surface agents use via MCP)
   recall "<query>"         Find code by meaning (semantic)
   impact <node>            Blast radius: everything that (transitively) calls it
   trace <from> <to>        A call path between two nodes
+  visualize [node]         Interactive HTML graph → .speclaw/graph.html
 
-Spec workflow
-  spec init                Create the spec/ workspace
-  spec list                Active/archived changes and capabilities
-  spec validate <change>   Validate a change's artifacts
-  spec sync <change>       Promote delta specs to canonical
-  spec archive <change>    Finalize and archive a change
+Lawbook (spec-driven workflow)
+  lawbook init             Create the lawbook/ workspace
+  lawbook list             Active/archived changes and capabilities
+  lawbook validate <c>     Validate a change's artifacts
+  lawbook sync <c>         Promote delta specs to canonical
+  lawbook archive <c>      Finalize and archive a change
 
 Other
   doctor                   Verify the installation
@@ -61,8 +62,10 @@ async function main() {
         case "impact":
         case "trace":
             return (await import("./commands/query.js")).runQuery(cmd, flags);
-        case "spec":
-            return (await import("./commands/spec.js")).runSpec(flags);
+        case "visualize":
+            return (await import("./commands/visualize.js")).runVisualize(flags);
+        case "lawbook":
+            return (await import("./commands/lawbook.js")).runSpec(flags);
         case "doctor":
             return (await import("./commands/doctor.js")).runDoctor(flags);
         default:

package/dist/modules/compass/register.js

@@ -3,6 +3,7 @@ import { text } from "../../shared/mcp.js";
 import { buildIndex } from "./indexer.js";
 import { explore, search, recall, impact, trace } from "./query.js";
 import { startWatch, stopWatch, watchStatus } from "./watcher.js";
+import { visualize } from "./visualize.js";
 // ─── Compass: speclaw's own code-intelligence engine (no external deps) ───
 // A local graph of the codebase (nodes = definitions, edges = calls/imports)
 // plus a local vector store for semantic recall. Lives in .speclaw/ (gitignored).
@@ -57,6 +58,15 @@ export function registerCompass(server) {
             maxDepth: z.number().optional().describe("Max hops to search (default 8)"),
         },
     }, async ({ projectPath, from, to, maxDepth }) => text(trace(projectPath, from, to, maxDepth ?? 8)));
+    server.registerTool("compass_visualize", {
+        description: "Generate an interactive, offline HTML visualization of the code graph into .speclaw/graph.html (gitignored). Nodes are definitions, edges are calls; drag/zoom/hover to explore. Pass a node to focus on its neighborhood, else the most-connected nodes are shown. Requires compass_index.",
+        inputSchema: {
+            projectPath: z.string().describe("Absolute path to the project"),
+            node: z.string().optional().describe("Focus on this node's neighborhood (optional)"),
+            depth: z.number().optional().describe("BFS depth around the focus node (default 2)"),
+            limit: z.number().optional().describe("Max nodes for the whole-graph view (default 300)"),
+        },
+    }, async ({ projectPath, node, depth, limit }) => text(visualize(projectPath, { focus: node, depth, limit })));
     server.registerTool("compass_watch", {
         description: "Keep the Compass index fresh automatically: start/stop a file watcher that incrementally re-indexes on change (debounced). action=start|stop|status. Optional — the index is also refreshed on demand by compass_index.",
         inputSchema: {

package/dist/modules/compass/visualize.js

@@ -0,0 +1,218 @@
+import fs from "node:fs";
+import path from "node:path";
+import { openDb, indexExists } from "./db.js";
+/**
+ * Build the graph payload from the Compass index: nodes (definitions) and the
+ * resolved call links between them. With a focus node, returns its neighborhood
+ * (BFS both directions); otherwise the most-connected nodes up to `limit`.
+ *
+ * @throws If no index exists yet (run `compass_index` first).
+ */
+export function graphData(projectPath, opts = {}) {
+    if (!indexExists(projectPath)) {
+        throw new Error("No index found. Run the compass_index tool (or `speclaw index`) first.");
+    }
+    const { focus, depth = 2, limit = 300 } = opts;
+    const db = openDb(projectPath);
+    try {
+        const allNodes = db
+            .prepare(`SELECT n.id, n.name, n.kind, f.path AS file, n.start_line AS line
+         FROM nodes n JOIN files f ON f.id = n.file_id`)
+            .all();
+        const allEdges = db
+            .prepare(`SELECT src_node_id AS s, dst_node_id AS t FROM edges
+         WHERE kind = 'call' AND dst_node_id IS NOT NULL AND src_node_id IS NOT NULL`)
+            .all();
+        // adjacency (undirected) + degree
+        const adj = new Map();
+        const deg = new Map();
+        for (const e of allEdges) {
+            if (e.s === e.t)
+                continue;
+            (adj.get(e.s) ?? adj.set(e.s, new Set()).get(e.s)).add(e.t);
+            (adj.get(e.t) ?? adj.set(e.t, new Set()).get(e.t)).add(e.s);
+            deg.set(e.s, (deg.get(e.s) ?? 0) + 1);
+            deg.set(e.t, (deg.get(e.t) ?? 0) + 1);
+        }
+        let included;
+        if (focus) {
+            const starts = allNodes.filter((n) => n.name === focus).map((n) => n.id);
+            included = new Set(starts);
+            let frontier = starts;
+            for (let d = 0; d < depth && frontier.length; d++) {
+                const next = [];
+                for (const id of frontier) {
+                    for (const nb of adj.get(id) ?? []) {
+                        if (!included.has(nb)) {
+                            included.add(nb);
+                            next.push(nb);
+                        }
+                    }
+                }
+                frontier = next;
+            }
+        }
+        else {
+            included = new Set([...allNodes]
+                .sort((a, b) => (deg.get(b.id) ?? 0) - (deg.get(a.id) ?? 0))
+                .slice(0, limit)
+                .map((n) => n.id));
+        }
+        const nodes = allNodes
+            .filter((n) => included.has(n.id))
+            .map((n) => ({ ...n, deg: deg.get(n.id) ?? 0 }));
+        const links = allEdges.filter((e) => included.has(e.s) && included.has(e.t));
+        return { nodes, links, total: allNodes.length, focus: focus ?? null };
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Build the graph and write it as an interactive HTML page to
+ * `<projectPath>/.speclaw/graph.html` (the gitignored index directory).
+ *
+ * @param projectPath - Absolute path to the project root.
+ * @param opts - Focus/depth/limit controlling which nodes are included.
+ * @returns The output path plus the shown/link/total counts for reporting.
+ * @throws If no Compass index exists yet.
+ */
+export function visualize(projectPath, opts = {}) {
+    const data = graphData(projectPath, opts);
+    const dir = path.join(projectPath, ".speclaw");
+    fs.mkdirSync(dir, { recursive: true });
+    const out = path.join(dir, "graph.html");
+    fs.writeFileSync(out, renderHtml(data));
+    return { path: out, shown: data.nodes.length, links: data.links.length, total: data.total };
+}
+/**
+ * Render the graph as a self-contained, offline HTML page: the data is embedded
+ * as JSON and drawn by an inline canvas force-directed renderer (no CDN, no
+ * dependencies).
+ *
+ * @param data - The nodes/links/totals to embed.
+ * @returns A complete HTML document as a string.
+ */
+export function renderHtml(data) {
+    const payload = JSON.stringify(data);
+    return `<!doctype html>
+<html lang="en"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+<title>speclaw · Compass graph</title>
+<style>
+  :root { --cy:#17C1C1; --cr:#F4F1EA; --mu:#6E7B80; --bg:#0B0F10; }
+  * { box-sizing:border-box; }
+  html,body { margin:0; height:100%; background:var(--bg); color:var(--cr);
+    font-family:'SF Mono','JetBrains Mono',Menlo,Consolas,monospace; overflow:hidden; }
+  canvas { display:block; cursor:grab; }
+  canvas:active { cursor:grabbing; }
+  .panel { position:fixed; top:16px; left:16px; padding:12px 14px; border-radius:10px;
+    background:rgba(12,17,19,.82); border:1px solid #232A2D; font-size:12px; line-height:1.5; }
+  .panel b { color:var(--cr); } .panel .sub { color:var(--mu); }
+  .legend { position:fixed; bottom:16px; left:16px; font-size:11px; color:var(--mu);
+    background:rgba(12,17,19,.82); border:1px solid #232A2D; border-radius:10px; padding:10px 12px; }
+  .legend span { display:inline-flex; align-items:center; margin-right:12px; }
+  .legend i { width:9px; height:9px; border-radius:50%; display:inline-block; margin-right:5px; }
+  .tip { position:fixed; padding:6px 9px; border-radius:7px; background:#0E1517; border:1px solid #17C1C1;
+    color:var(--cr); font-size:12px; pointer-events:none; opacity:0; transition:opacity .1s; white-space:nowrap; }
+  .brand { color:var(--cy); font-weight:700; }
+</style></head><body>
+<canvas id="c"></canvas>
+<div class="panel">
+  <div><span class="brand">speclaw</span> · Compass graph</div>
+  <div class="sub" id="meta"></div>
+  <div class="sub">drag to pan · wheel to zoom · drag a node · hover to inspect</div>
+</div>
+<div class="legend" id="legend"></div>
+<div class="tip" id="tip"></div>
+<script>
+const DATA = ${payload};
+const KIND_COLORS = { function:'#17C1C1', method:'#3FB950', class:'#E3B341',
+  interface:'#8B989E', type:'#8B989E', enum:'#8B989E' };
+const colorOf = k => KIND_COLORS[k] || '#6E7B80';
+
+const cv = document.getElementById('c'), ctx = cv.getContext('2d');
+const tip = document.getElementById('tip');
+document.getElementById('meta').textContent =
+  DATA.nodes.length + ' nodes · ' + DATA.links.length + ' edges' +
+  (DATA.focus ? ' · focus: ' + DATA.focus : ' · top ' + DATA.nodes.length + ' of ' + DATA.total);
+{
+  const kinds = [...new Set(DATA.nodes.map(n=>n.kind))];
+  document.getElementById('legend').innerHTML = kinds.map(k =>
+    '<span><i style="background:'+colorOf(k)+'"></i>'+k+'</span>').join('');
+}
+
+const idx = new Map(DATA.nodes.map((n,i)=>[n.id,i]));
+const N = DATA.nodes.map(n => ({...n, x:(Math.random()-.5)*800, y:(Math.random()-.5)*600, vx:0, vy:0,
+  r: 4 + Math.min(10, Math.sqrt(n.deg||0)*2) }));
+const L = DATA.links.map(l => ({s:idx.get(l.s), t:idx.get(l.t)})).filter(l=>l.s!=null&&l.t!=null);
+const neigh = N.map(()=>new Set());
+L.forEach(l => { neigh[l.s].add(l.t); neigh[l.t].add(l.s); });
+
+let scale=1, ox=0, oy=0, W=0, H=0, DPR=Math.min(2,devicePixelRatio||1);
+function resize(){ W=innerWidth; H=innerHeight; cv.width=W*DPR; cv.height=H*DPR; cv.style.width=W+'px'; cv.style.height=H+'px'; ctx.setTransform(DPR,0,0,DPR,0,0); }
+addEventListener('resize', resize); resize(); ox=W/2; oy=H/2;
+
+// force simulation
+function tick(){
+  for(let i=0;i<N.length;i++){ const a=N[i];
+    for(let j=i+1;j<N.length;j++){ const b=N[j];
+      let dx=a.x-b.x, dy=a.y-b.y, d2=dx*dx+dy*dy||0.01, d=Math.sqrt(d2);
+      const f=Math.min(2200/d2, 40); const ux=dx/d, uy=dy/d;
+      a.vx+=ux*f; a.vy+=uy*f; b.vx-=ux*f; b.vy-=uy*f;
+    }
+    a.vx += -a.x*0.0016; a.vy += -a.y*0.0016; // gravity to center
+  }
+  for(const l of L){ const a=N[l.s], b=N[l.t];
+    let dx=b.x-a.x, dy=b.y-a.y, d=Math.sqrt(dx*dx+dy*dy)||0.01;
+    const f=(d-90)*0.02, ux=dx/d, uy=dy/d;
+    a.vx+=ux*f; a.vy+=uy*f; b.vx-=ux*f; b.vy-=uy*f;
+  }
+  for(const n of N){ if(n===dragging) continue; n.vx*=0.82; n.vy*=0.82; n.x+=n.vx; n.y+=n.vy; }
+}
+function toScreen(n){ return { x: n.x*scale+ox, y: n.y*scale+oy }; }
+
+let hover=-1;
+function draw(){
+  ctx.clearRect(0,0,W,H);
+  const hoverSet = hover>=0 ? neigh[hover] : null;
+  ctx.lineWidth = 1;
+  for(const l of L){ const a=toScreen(N[l.s]), b=toScreen(N[l.t]);
+    const on = hover>=0 && (l.s===hover||l.t===hover);
+    ctx.strokeStyle = on ? 'rgba(23,193,193,.7)' : 'rgba(110,123,128,.16)';
+    ctx.beginPath(); ctx.moveTo(a.x,a.y); ctx.lineTo(b.x,b.y); ctx.stroke();
+  }
+  for(let i=0;i<N.length;i++){ const n=N[i], p=toScreen(n);
+    const dim = hover>=0 && i!==hover && !(hoverSet&&hoverSet.has(i));
+    ctx.globalAlpha = dim ? 0.28 : 1;
+    ctx.beginPath(); ctx.arc(p.x,p.y,n.r*Math.sqrt(scale),0,7); ctx.fillStyle=colorOf(n.kind); ctx.fill();
+    if((n.r>7 || i===hover || (hoverSet&&hoverSet.has(i))) && scale>0.5){
+      ctx.globalAlpha = dim?0.4:0.9; ctx.fillStyle='#F4F1EA'; ctx.font='11px monospace';
+      ctx.fillText(n.name, p.x+n.r+3, p.y+3);
+    }
+  }
+  ctx.globalAlpha=1;
+}
+function loop(){ tick(); draw(); requestAnimationFrame(loop); } loop();
+
+// interaction
+let dragging=null, panning=false, lastX=0, lastY=0;
+function pick(mx,my){ let best=-1, bd=1e9;
+  for(let i=0;i<N.length;i++){ const p=toScreen(N[i]); const d=Math.hypot(p.x-mx,p.y-my);
+    if(d < N[i].r*Math.sqrt(scale)+6 && d<bd){ bd=d; best=i; } } return best; }
+cv.addEventListener('mousedown', e=>{ const i=pick(e.clientX,e.clientY);
+  if(i>=0) dragging=N[i]; else { panning=true; } lastX=e.clientX; lastY=e.clientY; });
+addEventListener('mousemove', e=>{
+  if(dragging){ dragging.x += (e.clientX-lastX)/scale; dragging.y += (e.clientY-lastY)/scale; dragging.vx=dragging.vy=0; }
+  else if(panning){ ox+=e.clientX-lastX; oy+=e.clientY-lastY; }
+  lastX=e.clientX; lastY=e.clientY;
+  const i=pick(e.clientX,e.clientY); hover=i;
+  if(i>=0){ const n=N[i]; tip.style.opacity=1; tip.style.left=(e.clientX+12)+'px'; tip.style.top=(e.clientY+12)+'px';
+    tip.innerHTML='<b>'+n.name+'</b> <span style="color:#6E7B80">'+n.kind+' · '+n.file+':'+n.line+'</span>'; }
+  else tip.style.opacity=0;
+});
+addEventListener('mouseup', ()=>{ dragging=null; panning=false; });
+cv.addEventListener('wheel', e=>{ e.preventDefault(); const f=e.deltaY<0?1.1:0.9;
+  const mx=e.clientX, my=e.clientY; ox=mx-(mx-ox)*f; oy=my-(my-oy)*f; scale*=f; }, {passive:false});
+</script></body></html>`;
+}

package/dist/modules/foundation/assets/AGENTS.template.md

@@ -19,9 +19,9 @@ Claude-specific notes: [`CLAUDE.md`](CLAUDE.md). The law: [`LAWS.md`](LAWS.md).
 2. **Use Compass before file scanning** — the `compass_explore` /
    `compass_search` / `compass_recall` tools (run `compass_index` first if the
    graph is missing). Cheat sheet: [`docs/compass.md`](docs/compass.md).
-3. **Follow the spec workflow** for every non-trivial change; archive
+3. **Follow the lawbook workflow** for every non-trivial change; archive
    within the same PR. Rules:
-   [`docs/standards/spec-workflow.md`](docs/standards/spec-workflow.md).
+   [`docs/standards/lawbook.md`](docs/standards/lawbook.md).
 4. **Run the quality gates yourself** before declaring anything done — see
    [`docs/standards/testing-standards.md`](docs/standards/testing-standards.md):
    - Tests: `{{test_commands}}`
@@ -45,7 +45,7 @@ Claude-specific notes: [`CLAUDE.md`](CLAUDE.md). The law: [`LAWS.md`](LAWS.md).
 | [`docs/standards/testing-standards.md`](docs/standards/testing-standards.md) | Quality gates, testing rules |
 | [`docs/standards/documentation.md`](docs/standards/documentation.md) | Docstring/API-comment convention per language |
 | [`docs/standards/conventions.md`](docs/standards/conventions.md) | Branches, PRs, tracker, versioning |
-| [`docs/standards/spec-workflow.md`](docs/standards/spec-workflow.md) | Spec-driven workflow, archiving |
+| [`docs/standards/lawbook.md`](docs/standards/lawbook.md) | Spec-driven workflow, archiving |
 | [`docs/compass.md`](docs/compass.md) | Compass usage |
 
 ## Directory map for agents
@@ -57,5 +57,5 @@ Claude-specific notes: [`CLAUDE.md`](CLAUDE.md). The law: [`LAWS.md`](LAWS.md).
 | `AGENTS.md` / `CLAUDE.md` | Agent entry points (this contract) |
 | `ai-specs/` | Canonical skills, commands, rules, agents |
 | `.claude/` `.cursor/` `.codex/` `.agents/` | IDE mirrors (symlinks into `ai-specs/`) |
-| `spec/` | Spec-driven workflow: specs, changes, archive |
+| `lawbook/` | Spec-driven workflow: specs, changes, archive |
 | `.mcp.json` | MCP wiring (speclaw) |

package/dist/modules/foundation/assets/CLAUDE.template.md

@@ -21,7 +21,7 @@ governs the area you're touching **before** touching it:
 | Tests / gates | [`docs/standards/testing-standards.md`](docs/standards/testing-standards.md) |
 | Docstrings / API comments | [`docs/standards/documentation.md`](docs/standards/documentation.md) |
 | Branches / PRs / tickets | [`docs/standards/conventions.md`](docs/standards/conventions.md) |
-| Any non-trivial change | [`docs/standards/spec-workflow.md`](docs/standards/spec-workflow.md) |
+| Any non-trivial change | [`docs/standards/lawbook.md`](docs/standards/lawbook.md) |
 
 When any instruction conflicts with a standard, **the standard wins** — and if
 you believe it is wrong, propose an amendment via a spec change; never silently
@@ -39,8 +39,8 @@ only when the graph doesn't cover what you need.
 
 No non-trivial change lands without a spec change (propose → implement →
 verify → archive). The rules are in
-[`docs/standards/spec-workflow.md`](docs/standards/spec-workflow.md);
-the workflow skills live in `ai-specs/skills/` and the `/spec` commands wrap
+[`docs/standards/lawbook.md`](docs/standards/lawbook.md);
+the workflow skills live in `ai-specs/skills/` and the `/lawbook` commands wrap
 them. A change is not done until it is archived — archiving belongs in the PR.
 
 ## Rule 3 — Quality gates are non-negotiable

package/dist/modules/foundation/assets/LAWS.template.md

@@ -21,7 +21,7 @@
 | Testing | [`docs/standards/testing-standards.md`](docs/standards/testing-standards.md) | Quality gates, what must be tested, verification |
 | Documentation | [`docs/standards/documentation.md`](docs/standards/documentation.md) | Docstring/API-comment convention per language |
 | Conventions | [`docs/standards/conventions.md`](docs/standards/conventions.md) | Branches, PRs, tracker, versioning |
-| Spec | [`docs/standards/spec-workflow.md`](docs/standards/spec-workflow.md) | Spec-driven workflow, mandatory task steps, archiving |
+| Lawbook | [`docs/standards/lawbook.md`](docs/standards/lawbook.md) | Spec-driven workflow, mandatory task steps, archiving |
 | Compass | [`docs/compass.md`](docs/compass.md) | Using the code knowledge graph before grep |
 
 ## Binding rules
@@ -30,8 +30,8 @@
    the map. Agents open the standard that governs the code they're changing.
 2. **The standards are enforced, not advisory.** A violation is a blocking
    finding in review.
-3. **Amendments go through the spec workflow.** A standard is changed like code — via a
-   reviewed change (see the spec-workflow law). An agent may propose an amendment;
+3. **Amendments go through the lawbook workflow.** A standard is changed like code — via a
+   reviewed change (see the lawbook law). An agent may propose an amendment;
    it may never silently ignore a standard.
 4. **Entry points reference the law.** [`CLAUDE.md`](CLAUDE.md) and
    [`AGENTS.md`](AGENTS.md) point every agent here first.

package/dist/modules/foundation/assets/docs/standards/base-standards.template.md

@@ -5,11 +5,16 @@ of layer or language. This is a law of the project — see [`../../LAWS.md`](../
 
 ## Languages
 
+The working language is **inferred from this repo's own conventions** — the
+language already used in docstrings, commit messages, branch names, and PR/ticket
+bodies. Match what the repo does; do not impose a language it doesn't use.
+
 - **Code, identifiers, comments, docstrings, commit messages, PR titles/bodies,
-  and technical docs**: the repo's artifact language (default English).
+  and technical docs**: the repo's artifact language (English unless the repo
+  clearly uses another).
 - **User-facing product copy**: as the product requires.
-- **Agent ↔ human communication** (review comments, thread replies, ticket
-  bodies): the team's working language ({{team_language}}). Technical terms
+- **Agent ↔ human communication** (review comments, thread replies): the same
+  language the team already uses in the repo's tickets and PRs. Technical terms
   stay in English within that prose — don't force-translate them.
 
 ## Commits & branches
@@ -25,8 +30,8 @@ of layer or language. This is a law of the project — see [`../../LAWS.md`](../
   edge cases, "why"). They never narrate history, restate the next line, or
   address the reviewer.
 - **Never** put ticket IDs, ticket text, or changelog narration
-  ("added for {{ticket_prefix}}-123", "fixed as part of…") in code or
-  docstrings. Traceability lives in the branch name, PR, and git history.
+  ("added for TICKET-123", "fixed as part of…") in code or docstrings.
+  Traceability lives in the branch name, PR, and git history.
 
 ## Dependencies