@esneiderbravo/speclaw 0.1.6 → 0.1.8

package/README.md

@@ -35,7 +35,7 @@ One command. No cloud, no LLM, no API keys — <b>everything runs on your machin
 
 <br/>
 
-## ◆ Quick start
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; Quick start
 
 Install speclaw globally (once), then run `init` in your project root:
 
@@ -67,7 +67,7 @@ too (also `pnpm dlx` / `yarn dlx`) — but installing globally means you can run
 
 <br/>
 
-## ◆ It looks like this
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; It looks like this
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/terminal-init.png" width="800" alt="speclaw init — terminal output">
@@ -77,7 +77,7 @@ too (also `pnpm dlx` / `yarn dlx`) — but installing globally means you can run
 
 <br/>
 
-## ◆ The suite — four modules
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; The suite — four modules
 
 | Module | What it does |
 | :-- | :-- |
@@ -90,7 +90,7 @@ Compass is inspired by [CodeGraph](https://github.com/colbymchenry/codegraph) an
 
 <br/>
 
-## ◆ Two ways to use it
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; Two ways to use it
 
 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**
@@ -105,7 +105,7 @@ still use Compass and the lawbook engine by calling the CLI from its shell.
 
 <br/>
 
-## ◆ What lands in your project
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; What lands in your project
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/terminal-tree.png" width="800" alt="what speclaw writes into your project">
@@ -113,7 +113,7 @@ still use Compass and the lawbook engine by calling the CLI from its shell.
 
 <br/>
 
-## ◆ Philosophy — why "laws"?
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; Philosophy — why "laws"?
 
 > [!NOTE]
 > A guideline is a suggestion. A **law** is enforced. The most common failure mode
@@ -124,7 +124,7 @@ still use Compass and the lawbook engine by calling the CLI from its shell.
 
 <br/>
 
-## ◆ Staying up to date
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; Staying up to date
 
 speclaw checks for new releases in the background (at most once a day) and nudges
 you when one lands. To upgrade:
@@ -143,7 +143,7 @@ packs this project already uses.
 
 <br/>
 
-## ◆ Requirements
+## <img src="https://raw.githubusercontent.com/esneiderbravo/speclaw/main/brand/diamond.png" height="20" alt="◆" align="absmiddle">&nbsp; Requirements
 
 - **Node.js ≥ 22** — uses the built-in `node:sqlite`.
 - **No native builds, no services, no API keys, no LLM download.** Tree-sitter

package/dist/cli/commands/init.js

@@ -8,6 +8,7 @@ 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 } from "../lib/ui.js";
+import { checkForUpdates } from "../lib/update-check.js";
 const PACK_LABELS = {
     agents: "dev-agents (backend · frontend · product)",
 };
@@ -36,6 +37,15 @@ export async function runInit(flags) {
     let agents;
     let packs;
     banner();
+    // Scaffolding with a stale version writes yesterday's foundation, so recommend
+    // upgrading first — prominently, before any prompts, so there's time to cancel.
+    // Best-effort and cache-backed (no added latency); the command still proceeds.
+    const upd = await checkForUpdates();
+    if (upd.updateAvailable && upd.latest) {
+        ui.warn(`You're on ${c.muted(upd.current)} — latest is ${c.bold(c.cyan(upd.latest))}.`);
+        ui.info(`Recommended: run ${ui.code("speclaw update")} first, then ${ui.code("speclaw init")} again.`);
+        ui.plain();
+    }
     if (interactive) {
         const answers = await clack.group({
             agents: () => clack.multiselect({

package/dist/cli/lib/update-check.js

@@ -105,7 +105,9 @@ export async function maybeNotifyUpdate(cmd) {
             return;
         if (!process.stderr.isTTY)
             return;
-        if (!cmd || ["mcp", "update", "help", "--help", "-h"].includes(cmd))
+        // `init` shows its own prominent up-front warning and ends on the clean
+        // copy-paste prompt — don't append a second notice after it.
+        if (!cmd || ["mcp", "update", "init", "help", "--help", "-h"].includes(cmd))
             return;
         const { current, latest, updateAvailable } = await checkForUpdates();
         if (!updateAvailable || !latest)

package/dist/shared/agents.js

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { ensureGitignore } from "./install.js";
 /** The agents speclaw can configure. Add one here and the CLI picks it up. */
 export const AGENTS = [
     { id: "claude", label: "Claude Code", ideDir: ".claude", linkTargets: ["skills", "commands", "agents"], mcpFile: ".mcp.json" },
@@ -30,6 +31,10 @@ function isSymlink(p) {
 }
 /** Register the speclaw stdio MCP server in an agent's config file, merging into any existing config and skipping if already present. */
 function writeMcpConfig(projectPath, mcpFile, report) {
+    // The agent MCP config is per-developer wiring — regenerated by `speclaw init`
+    // / `agent add`, points at a local runner — not shared source. Keep it out of
+    // version control (done regardless of whether we write or skip the file below).
+    ensureGitignore(projectPath, mcpFile, "speclaw agent MCP config (per-developer; regenerated by init)", report);
     const mcpPath = path.join(projectPath, mcpFile);
     let config = {};
     if (fs.existsSync(mcpPath))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esneiderbravo/speclaw",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "publishConfig": {
     "access": "public"
   },