unitbob 0.1.9 → 0.1.10

package/README.md

@@ -31,13 +31,20 @@ Restart the session so the commands load.
 
 ## Full cycle
 
-| Step | With a prompt (just type in chat) | With a command |
-|------|-----------------------------------|----------------|
-| 1. Build the map | `Build my Unitbob map` | `/unitbob:map` |
-| 2. Generate tests | `Generate the guardrail tests` | `/unitbob:suite` |
-| 3. Run the checks | `Run the checks` | `/unitbob:check` |
-| 4. Fix a red lamp | `Fix guardrail <id>` | `/unitbob:fix <id>` |
-| 5. Open the map | `Open my Unitbob map` | `/unitbob:show` |
+Just type it in the chat. There is nothing to memorise and no command to get right.
+
+| Step | Say this |
+|------|----------|
+| 1. Build the map | `Build my Unitbob map` |
+| 2. Generate tests | `Generate the guardrail tests` |
+| 3. Run the checks | `Run the checks` |
+| 4. Fix a red lamp | `Fix guardrail <id>` |
+| 5. Open the map | `Open my Unitbob map` |
+
+There are also `/unitbob:map`, `/unitbob:suite` and friends, but they work only
+inside a Claude Code terminal, and only in a session started after the plugin was
+installed — in a browser or desktop window they are not recognised at all. The
+phrasings above work everywhere, so they are the ones documented here.
 
 ---
 

package/dist/proc.js

@@ -56,20 +56,70 @@ export async function requireGraphify() {
             `"graphify", needs Python 3.10+), then retry (${err.message}).`);
     }
 }
+// Paths that hold no business logic in the stacks unitbob supports — Rails,
+// JS/TS, Python — and that graphify does not already skip (it drops
+// node_modules, venv, dist, build, target, out, __pycache__, and the framework
+// cache and report dirs on its own).
+//
+// Every entry earns its place, because an over-broad pattern fails silently: a
+// subsystem simply never appears on the map and nobody learns why. Measured on
+// one real Rails app (2943 nodes), vendor/ was 1337 of them, app/assets/ 414,
+// db/migrate/ 314 — 70% of the graph, and the busiest nodes in it were `_()`
+// and `$()`. Everything else in that project was already clean: bin/, tmp/,
+// log/ and storage/ produced zero nodes, so they are deliberately not listed.
+//
+// The list stays language-neutral: one project is often Rails and Python at
+// once. Gitignore syntax; graphify merges it with .gitignore, and it can only
+// ever exclude more, never re-include.
+export const GRAPH_NOISE_PATTERNS = [
+    '# unitbob: keep the graph about your own business code',
+    '.unitbob/',
+    // Third-party code committed into the repo. In Rails, `vendor/` is the
+    // convention for it, and `app/assets/javascripts/` is where sprockets-era
+    // apps dumped libraries — on the measured app that folder was moment.js,
+    // datatables.js and jquery.inputmask, against a single node of own code. A
+    // modern Rails app keeps its own JS in `app/javascript/`, which stays.
+    'vendor/',
+    'app/assets/javascripts/',
+    'app/assets/builds/',
+    'app/assets/config/',
+    'public/assets/',
+    'public/packs/',
+    '*.min.js',
+    '*.min.css',
+    '*.bundle.js',
+    // Generated code: schema history and codegen output. Describes the shape of
+    // data, never the behaviour a guardrail could protect.
+    'db/migrate/',
+    'db/schema.rb',
+    'db/structure.sql',
+    'migrations/',
+    '__generated__/',
+    '*_pb2.py',
+    '*_pb2_grpc.py',
+    '*_pb.js',
+    // Type declarations — a contract for a compiler, with no runtime behaviour.
+    '*.d.ts',
+    '*.pyi',
+];
 export function ensureUnitbobIgnored(projectRoot) {
-    ensureLine(join(projectRoot, '.gitignore'), '.unitbob/');
-    ensureLine(join(projectRoot, '.gitignore'), 'graphify-out/');
-    ensureLine(join(projectRoot, '.graphifyignore'), '.unitbob/');
+    // `.graphifyignore` is unitbob's own bookkeeping, like the other two entries —
+    // the user never edits it, so it stays out of their commits.
+    ensureLines(join(projectRoot, '.gitignore'), ['.unitbob/', 'graphify-out/', '.graphifyignore']);
+    ensureLines(join(projectRoot, '.graphifyignore'), GRAPH_NOISE_PATTERNS);
 }
-function ensureLine(path, line) {
+// Appends whichever lines are missing, in one write, leaving the user's own
+// entries (and their order) untouched. Idempotent: a second run adds nothing.
+function ensureLines(path, lines) {
     let current = '';
-    if (existsSync(path)) {
+    if (existsSync(path))
         current = readFileSync(path, 'utf8');
-        if (current.split('\n').some((existing) => existing.trim() === line))
-            return;
-    }
+    const present = new Set(current.split('\n').map((line) => line.trim()));
+    const missing = lines.filter((line) => !present.has(line));
+    if (missing.length === 0)
+        return;
     const prefix = current.length > 0 && !current.endsWith('\n') ? '\n' : '';
-    writeFileSync(path, `${current}${prefix}${line}\n`);
+    writeFileSync(path, `${current}${prefix}${missing.join('\n')}\n`);
 }
 export async function runGraphifyExtractKeyless(projectRoot) {
     // Deterministic AST-only graph; no LLM, no API key. `update --force` re-extracts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unitbob",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Unitbob connector — thin local hands for the Unitbob Rails brain. Owns no domain logic: it runs tools, relays bytes over the wire, and prints what the server returns.",
   "type": "module",
   "bin": {