@davidbalzan/groundwork-console 0.1.0

package/dist/skills.js

@@ -0,0 +1,48 @@
+/* Supplement to the CLIs' `list --json`: byte-compare installed SKILL.md with the kit source (in-sync signal the CLIs do not report). */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import path from "node:path";
+const sha = (p) => (existsSync(p) ? createHash("sha1").update(readFileSync(p)).digest("hex").slice(0, 10) : null);
+const dirs = (p) => (existsSync(p) ? readdirSync(p, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name) : []);
+const front = (p) => { if (!existsSync(p))
+    return {}; const m = readFileSync(p, "utf8").match(/^---\n([\s\S]*?)\n---/); const o = {}; m?.[1].split("\n").forEach((l) => { const i = l.indexOf(":"); if (i > 0)
+    o[l.slice(0, i).trim()] = l.slice(i + 1).trim(); }); return o; };
+export function groundworkSkills(kitPath, projectPath) {
+    const payload = path.join(kitPath, "packages/groundwork/payload/skills");
+    const pathsMjs = path.join(kitPath, "packages/groundwork/src/lib/paths.mjs");
+    const minimal = existsSync(pathsMjs) ? [...(readFileSync(pathsMjs, "utf8").match(/MINIMAL_SKILLS = \[([\s\S]*?)\]/)?.[1] ?? "").matchAll(/"([^"]+)"/g)].map((m) => m[1]) : [];
+    const versionMarker = existsSync(path.join(projectPath, "docs/.groundwork/VERSION")) ? readFileSync(path.join(projectPath, "docs/.groundwork/VERSION"), "utf8").trim() : null;
+    const kitVersion = JSON.parse(readFileSync(path.join(kitPath, "packages/groundwork/package.json"), "utf8")).version;
+    return {
+        versionMarker, kitVersion, driftedVersion: !!versionMarker && versionMarker !== kitVersion,
+        skills: dirs(payload).map((name) => {
+            const src = path.join(payload, name, "SKILL.md");
+            const inst = path.join(projectPath, ".claude/skills", name, "SKILL.md");
+            const installed = existsSync(inst);
+            const fm = front(src);
+            return {
+                name, tier: minimal.includes(name) ? "min" : "opt", installed, inSync: installed ? sha(src) === sha(inst) : null,
+                description: fm.description ?? "", readOnly: /read-only|ask/i.test(fm["allowed-tools"] ?? "") ? true : undefined,
+                mirrors: { cursor: existsSync(path.join(projectPath, ".cursor/commands", `${name}.md`)), vscode: existsSync(path.join(projectPath, ".vscode/prompts", `${name}.prompt.md`)) },
+            };
+        }),
+    };
+}
+/* Global playbook cards live in more than one harness home: Claude → ~/.claude/skills, Grok → ~/.grok/skills (+ ~/.grok/groundwork-playbook). Measure each. */
+const HARNESS_HOMES = [["claude", path.join(homedir(), ".claude/skills")], ["grok", path.join(homedir(), ".grok/skills")]];
+export function playbookCards(kitPath) {
+    const srcRoot = path.join(kitPath, "packages/coord-playbook/skills");
+    const kitVersion = JSON.parse(readFileSync(path.join(kitPath, "packages/coord-playbook/package.json"), "utf8")).version;
+    const homes = HARNESS_HOMES.filter(([, d]) => existsSync(d));
+    return {
+        kitVersion, globalDir: HARNESS_HOMES[0][1], homes: homes.map(([h, d]) => ({ harness: h, dir: d })),
+        cards: dirs(srcRoot).filter((n) => n !== "references").map((name) => {
+            const src = path.join(srcRoot, name, "SKILL.md");
+            const per = Object.fromEntries(homes.map(([h, d]) => { const inst = path.join(d, name, "SKILL.md"); const installed = existsSync(inst); const slices = existsSync(path.join(d, name, "references")) ? readdirSync(path.join(d, name, "references")).filter((f) => f.endsWith(".md")) : []; return [h, { installed, inSync: installed ? sha(src) === sha(inst) : null, slices: slices.length, legacyEssay: slices.includes("playbook.md") }]; }));
+            const claude = per.claude ?? { installed: false, inSync: null, slices: 0, legacyEssay: false };
+            return { name, installed: claude.installed, inSync: claude.inSync, slices: claude.slices, legacyEssay: claude.legacyEssay, homes: per, description: front(src).description ?? "", mirrors: { opencode: existsSync(path.join(homedir(), ".config/opencode/skills", name)), cursor: existsSync(path.join(homedir(), ".cursor/commands", `${name}.md`)), vscode: existsSync(path.join(homedir(), ".vscode/prompts", `${name}.prompt.md`)) } };
+        }),
+        legacyDirs: homes.flatMap(([h, d]) => ["coord-curator", "coord-liaison"].filter((n) => existsSync(path.join(d, n))).map((n) => `${h}:${n}`)),
+    };
+}

package/dist/tmux.js

@@ -0,0 +1,36 @@
+/* Read-only tmux views: pane activity (for liveness + activity indicators) and pane capture (for the pane viewer). Never sends keys. */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const run = promisify(execFile);
+let cache = { at: 0, panes: [] };
+export async function listPanes(ttlMs = 3_000) {
+    if (Date.now() - cache.at < ttlMs)
+        return cache.panes;
+    try {
+        const { stdout } = await run("tmux", ["list-panes", "-a", "-F", "#{pane_id}\t#{session_name}:#{window_index}.#{pane_index}\t#{window_activity}\t#{pane_current_command}\t#{pane_dead}"], { timeout: 3_000 });
+        cache = { at: Date.now(), panes: stdout.split("\n").filter(Boolean).map((l) => { const [paneId, target, act, command, dead] = l.split("\t"); return { paneId, target, activityTs: Number(act) * 1000, command, dead: dead === "1" }; }) };
+    }
+    catch {
+        cache = { at: Date.now(), panes: [] };
+    }
+    return cache.panes;
+}
+export async function paneActivity(paneId) { if (!paneId)
+    return null; return (await listPanes()).find((p) => p.paneId === paneId || p.target === paneId) ?? null; }
+const ANSI = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
+export async function capturePane(paneId, lines = 200, colors = false) {
+    const panes = await listPanes(0);
+    const p = panes.find((x) => x.paneId === paneId || x.target === paneId);
+    if (!p)
+        return null;
+    try {
+        const args = ["capture-pane", "-p", "-t", p.paneId, "-S", `-${Math.min(Math.max(lines, 20), 2000)}`, "-J", ...(colors ? ["-e"] : [])];
+        const { stdout } = await run("tmux", args, { timeout: 3_000, maxBuffer: 4 << 20 });
+        const raw = stdout.replace(/\s+$/gm, "").replace(/\n{3,}/g, "\n\n").trimEnd();
+        const text = raw.replace(ANSI, "");
+        return { text, ...(colors ? { ansi: raw } : {}), lines: text.split("\n").length, capturedAt: Date.now() };
+    }
+    catch {
+        return null;
+    }
+}

package/dist/uploads.js

@@ -0,0 +1,40 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+/* Pasted/dropped images for DMs. Console-owned store: ~/.groundwork-console/uploads/<date>-<sha8>.<ext>.
+   Agents on this machine read the PATH directly (Claude Code `Read`, grok, codex all take image files);
+   the same file is also served at /api/uploads/<name> for HTTP-node agents and for inline thumbnails in the console. */
+export const UPLOAD_DIR = process.env.GROUNDWORK_CONSOLE_UPLOADS ?? path.join(homedir(), ".groundwork-console", "uploads");
+const MAX_BYTES = 8 * 1024 * 1024;
+const EXT = { "image/png": "png", "image/jpeg": "jpg", "image/gif": "gif", "image/webp": "webp", "image/svg+xml": "svg" };
+export const NAME_RE = /^[\w.-]+\.(png|jpe?g|gif|webp|svg)$/i;
+/** Save an image; idempotent by content hash. `ref` is the token to put in the message text. */
+export function saveUpload(buf, mime, apiBase, date) {
+    const ext = EXT[mime];
+    if (!ext)
+        throw new Error(`unsupported type ${mime} (png/jpg/gif/webp/svg)`);
+    if (buf.byteLength > MAX_BYTES)
+        throw new Error(`too large (${Math.round(buf.byteLength / 1024)} KB > ${MAX_BYTES / 1024 / 1024} MB)`);
+    if (buf.byteLength === 0)
+        throw new Error("empty file");
+    mkdirSync(UPLOAD_DIR, { recursive: true });
+    const sha = createHash("sha256").update(buf).digest("hex").slice(0, 8);
+    const existing = readdirSync(UPLOAD_DIR).find((n) => n.endsWith(`-${sha}.${ext}`));
+    const name = existing ?? `${date}-${sha}.${ext}`;
+    const p = path.join(UPLOAD_DIR, name);
+    if (!existing)
+        writeFileSync(p, buf);
+    const url = `${apiBase}/uploads/${name}`;
+    return { name, path: p, url, bytes: buf.byteLength, mime, ref: `[image: ${p} · ${url}]` };
+}
+export function uploadPath(name) {
+    if (!NAME_RE.test(name))
+        return null;
+    const p = path.join(UPLOAD_DIR, name);
+    if (!existsSync(p))
+        return null;
+    const ext = name.split(".").pop().toLowerCase();
+    const mime = Object.entries(EXT).find(([, e]) => e === ext || (e === "jpg" && ext === "jpeg"))?.[0] ?? "application/octet-stream";
+    return { path: p, mime, bytes: statSync(p).size };
+}

package/groundwork-console.rules.json

@@ -0,0 +1,85 @@
+{
+  "$comment": "Event \u2192 action rules. Actions fire ONLY when: bus writes are on (header switch) AND dryRun is false AND the rule is enabled. Every send is a Run as groundwork-console (automation). Dedupe by event key (persisted), rate-limited per rule+project. The console never edits seam files.",
+  "identity": {
+    "roleId": "automation",
+    "displayName": "groundwork-console",
+    "transport": null,
+    "$comment": "AUTOMATION_ROLE_IDS in kit roles.ts/hooks/roles.mjs; not gate-runner, not ci, RECORD_AUTHORITY empty (cannot emit verdict/go/scope). Registers with no transport (send-only)."
+  },
+  "dryRun": true,
+  "rules": [
+    {
+      "id": "phase-complete-audit",
+      "on": "phase.completed",
+      "action": {
+        "type": "send_message",
+        "to": "coordinator",
+        "prefix": "AGENT_ACTION",
+        "text": "phase {phase} complete in {project} ({done}/{total}). Per playbook \u00a7Phase Boundaries: handover snapshots \u2192 /coord-audit \u2192 /clear workers switching lanes, before starting the next phase."
+      },
+      "enabled": false,
+      "key": "{project}:{phase}"
+    },
+    {
+      "id": "phase-started-brief",
+      "on": "phase.started",
+      "action": {
+        "type": "send_message",
+        "room": "{room}",
+        "prefix": "FYI",
+        "text": "phase {phase} started in {project} \u2014 first task checked ({done}/{total})."
+      },
+      "enabled": false,
+      "key": "{project}:{phase}"
+    },
+    {
+      "id": "fact-stale-nudge",
+      "on": "fact.stale",
+      "action": {
+        "type": "send_message",
+        "to": "{owner}",
+        "prefix": "FYI",
+        "text": "fact `{fact}` in {project} is {ageDays} d old (> 14) \u2014 re-verify or delete (set-fact)."
+      },
+      "enabled": false,
+      "key": "{project}:{fact}"
+    },
+    {
+      "id": "malformed-row-alert",
+      "on": "board.malformed",
+      "action": {
+        "type": "send_message",
+        "to": "coordinator",
+        "prefix": "RISK",
+        "text": "docs/WORKSTREAMS.md in {project} has {count} malformed row(s) \u2014 parser refused them; fix the table (line {line})."
+      },
+      "enabled": false,
+      "key": "{project}:{line}"
+    },
+    {
+      "id": "decision-open",
+      "on": "decision.posted",
+      "action": {
+        "type": "none",
+        "note": "surface in Needs David; David answers, not automation"
+      },
+      "enabled": false,
+      "key": "{project}:{id}"
+    },
+    {
+      "id": "done-appended",
+      "on": "done.appended",
+      "action": {
+        "type": "none",
+        "note": "telemetry only"
+      },
+      "enabled": false,
+      "key": "{project}:{count}"
+    }
+  ],
+  "limits": {
+    "maxPerRulePerProjectPerHour": 3,
+    "dedupeTtlHours": 72
+  },
+  "stateFile": "~/.groundwork-console/events-state.json"
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@davidbalzan/groundwork-console",
+  "private": false,
+  "version": "0.1.0",
+  "type": "module",
+  "dependencies": {
+    "@davidbalzan/groundwork-seam": "^0.1.0",
+    "@hono/node-server": "^2.1.1",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "hono": "^4.13.2",
+    "open": "^11.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "tsx": "^4.23.12",
+    "typescript": "^7.0.2"
+  },
+  "description": "Groundwork Console — the cockpit for Groundwork Kit fleets: board, bus, monitor, docs, ops. One local server, token auth, tmux-aware.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davidbalzan/groundwork-console.git"
+  },
+  "bin": {
+    "groundwork-console": "bin/groundwork-console.mjs",
+    "gwc": "bin/groundwork-console.mjs"
+  },
+  "files": [
+    "dist",
+    "public",
+    "bin",
+    "groundwork-console.rules.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc -p tsconfig.json",
+    "build:web": "pnpm --filter @groundwork-console/web build && rm -rf public && cp -R ../web/dist public",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node bin/groundwork-console.mjs",
+    "publish-check": "node scripts/publish-check.mjs"
+  }
+}

package/public/assets/abnfDiagram-N423BO3Z-DPhyKd1N.js

@@ -0,0 +1 @@
+import{m as e,t}from"./mermaid-parser.core-bGhrBY9T.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-Bc2f8joo.js";import"./chunk-I66GZJ75-DyWmv43M.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-B6kTvnZS.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-_OoTZaAK.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/public/assets/arc-DmkLmHHi.js

@@ -0,0 +1 @@
+import{n as e,t}from"./path-fybaL0A-.js";import{a as n,c as r,d as i,f as a,i as o,l as s,m as c,n as l,o as u,p as d,r as f,u as p}from"./dist-DTWyzWtG.js";function m(e){return e.innerRadius}function h(e){return e.outerRadius}function g(e){return e.startAngle}function _(e){return e.endAngle}function v(e){return e&&e.padAngle}function y(e,t,n,r,i,a,o,s){var c=n-e,l=r-t,u=o-i,d=s-a,f=d*c-u*l;if(!(f*f<1e-12))return f=(u*(t-a)-d*(e-i))/f,[e+f*c,t+f*l]}function b(e,t,n,r,i,a,o){var c=e-n,l=t-r,u=(o?a:-a)/d(c*c+l*l),f=u*l,p=-u*c,m=e+f,h=t+p,g=n+f,_=r+p,v=(m+g)/2,y=(h+_)/2,b=g-m,x=_-h,S=b*b+x*x,C=i-a,w=m*_-g*h,T=(x<0?-1:1)*d(s(0,C*C*S-w*w)),E=(w*x-b*T)/S,D=(-w*b-x*T)/S,O=(w*x+b*T)/S,k=(-w*b+x*T)/S,A=E-v,j=D-y,M=O-v,N=k-y;return A*A+j*j>M*M+N*N&&(E=O,D=k),{cx:E,cy:D,x01:-f,y01:-p,x11:E*(i/C-1),y11:D*(i/C-1)}}function x(){var s=m,x=h,S=e(0),C=null,w=g,T=_,E=v,D=null,O=t(k);function k(){var e,t,m=+s.apply(this,arguments),h=+x.apply(this,arguments),g=w.apply(this,arguments)-r,_=T.apply(this,arguments)-r,v=l(_-g),k=_>g;if(D||=e=O(),h<m&&(t=h,h=m,m=t),!(h>1e-12))D.moveTo(0,0);else if(v>c-1e-12)D.moveTo(h*u(g),h*a(g)),D.arc(0,0,h,g,_,!k),m>1e-12&&(D.moveTo(m*u(_),m*a(_)),D.arc(0,0,m,_,g,k));else{var A=g,j=_,M=g,N=_,P=v,F=v,I=E.apply(this,arguments)/2,L=I>1e-12&&(C?+C.apply(this,arguments):d(m*m+h*h)),R=p(l(h-m)/2,+S.apply(this,arguments)),z=R,B=R,V,H;if(L>1e-12){var U=o(L/m*a(I)),W=o(L/h*a(I));(P-=U*2)>1e-12?(U*=k?1:-1,M+=U,N-=U):(P=0,M=N=(g+_)/2),(F-=W*2)>1e-12?(W*=k?1:-1,A+=W,j-=W):(F=0,A=j=(g+_)/2)}var G=h*u(A),K=h*a(A),q=m*u(N),J=m*a(N);if(R>1e-12){var Y=h*u(j),X=h*a(j),Z=m*u(M),Q=m*a(M),$;if(v<i){if($=y(G,K,Z,Q,Y,X,q,J)){var ee=G-$[0],te=K-$[1],ne=Y-$[0],re=X-$[1],ie=1/a(f((ee*ne+te*re)/(d(ee*ee+te*te)*d(ne*ne+re*re)))/2),ae=d($[0]*$[0]+$[1]*$[1]);z=p(R,(m-ae)/(ie-1)),B=p(R,(h-ae)/(ie+1))}else z=B=0}}F>1e-12?B>1e-12?(V=b(Z,Q,G,K,h,B,k),H=b(Y,X,q,J,h,B,k),D.moveTo(V.cx+V.x01,V.cy+V.y01),B<R?D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,h,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),!k),D.arc(H.cx,H.cy,B,n(H.y11,H.x11),n(H.y01,H.x01),!k))):(D.moveTo(G,K),D.arc(0,0,h,A,j,!k)):D.moveTo(G,K),!(m>1e-12)||!(P>1e-12)?D.lineTo(q,J):z>1e-12?(V=b(q,J,Y,X,m,-z,k),H=b(G,K,Z,Q,m,-z,k),D.lineTo(V.cx+V.x01,V.cy+V.y01),z<R?D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,m,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),k),D.arc(H.cx,H.cy,z,n(H.y11,H.x11),n(H.y01,H.x01),!k))):D.arc(0,0,m,N,M,k)}if(D.closePath(),e)return D=null,e+``||null}return k.centroid=function(){var e=(+s.apply(this,arguments)+ +x.apply(this,arguments))/2,t=(+w.apply(this,arguments)+ +T.apply(this,arguments))/2-i/2;return[u(t)*e,a(t)*e]},k.innerRadius=function(t){return arguments.length?(s=typeof t==`function`?t:e(+t),k):s},k.outerRadius=function(t){return arguments.length?(x=typeof t==`function`?t:e(+t),k):x},k.cornerRadius=function(t){return arguments.length?(S=typeof t==`function`?t:e(+t),k):S},k.padRadius=function(t){return arguments.length?(C=t==null?null:typeof t==`function`?t:e(+t),k):C},k.startAngle=function(t){return arguments.length?(w=typeof t==`function`?t:e(+t),k):w},k.endAngle=function(t){return arguments.length?(T=typeof t==`function`?t:e(+t),k):T},k.padAngle=function(t){return arguments.length?(E=typeof t==`function`?t:e(+t),k):E},k.context=function(e){return arguments.length?(D=e??null,k):D},k}export{x as t};

package/public/assets/architecture-TIHT7OUA-MgcjoiPc.js

@@ -0,0 +1 @@
+import"./chunk-KEIR6QF5-BICK3FdT.js";import{M as e}from"./mermaid-parser.core-bGhrBY9T.js";export{e as createArchitectureServices};