@webship.co/workspace-graph 0.0.0-stage → 1.0.0-beta1

package/README.md

@@ -1,3 +1,25 @@
-# Temporary Holding Version
+# @webship.co/workspace-graph
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The **Graphs** workspace and the knowledge-graph feature of the [Webship Workspace](https://github.com/webship/workspace) dashboard:
+the `graphs/` folder (type `code`), its settings file (`core/config/workspace.graphs.settings.yml`),
+its commands and its docs, as a plugin — plus the **Graph** menu on every project row that has a graphify command (build with graphify, open the graph, read its report, download it, serve it over MCP, delete it) and the Obsidian vault made from a graph (build, read the notes in the browser, open the map, download), with the `/graph/…` and `/obsidian/…` pages.
+
+## Use it
+
+```bash
+cd ~/workspace
+bash core/scripts/plugins.sh --require github:webship/workspace-graph
+bash core/scripts/plugins.sh --activate graph     # puts `graphs` on the workspaces list of settings.yml
+bash core/scripts/plugins.sh --install graph      # the folder, its settings file (once), its commands, its docs (once)
+```
+
+The settings file and the docs are placed once and never overwritten: they hold what you put there.
+`--deactivate` takes the workspace off the list; the folder and its content stay.
+
+## The commands
+
+| Command |
+| --- |
+| `cmd-tools-graphs.sh` |
+
+The bash functions these commands call live in the dashboard's `core/scripts/functions`.

package/commands/cmd-tools-graphify.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# Map a project in this workspace into a queryable knowledge graph with
+# graphify (https://github.com/Graphify-Labs/graphify), or ask an existing
+# graph a question.
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.__WORKSPACE__.settings.yml);
+
+ARGPARSE_DESCRIPTION="Build or query the knowledge graph of a project in the __WORKSPACE__ workspace"
+source ${WORKSPACE_SCRIPTS}/plugins/graph/args/arg-graphify.sh || exit 1 ;
+
+shift $#;
+
+if [ ! "${STORE}" == '_none_' ] ; then
+  ensure_graphify || exit 1 ;
+  graphify_store_url "${WORKSPACE_ROOT}/${doc_name}/${PROJECT_NAME}" "${STORE}" ;
+elif [ -n "${QUERY}" ] ; then
+  graphify_query_project ;
+else
+  graphify_project ;
+fi

package/commands/cmd-tools-graphs.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+# workspace-name: Graphs (list, collect, serve over MCP)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.graphs.settings.yml);
+
+ARGPARSE_DESCRIPTION="Work with the project knowledge graphs kept in ~/workspace/graphs/"
+source ${WORKSPACE_SCRIPTS}/plugins/graph/args/arg-graphs.sh || exit 1 ;
+
+shift $#;
+
+graphs_command ;

package/commands/cmd-tools-obsidian.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Turn a project's knowledge graph into an Obsidian vault — one note per entity,
+# a [[wikilink]] per relation, and a JSON Canvas of the map. Written next to the
+# graph in graphs/dev/<project>/obsidian/.
+#
+# Build the graph first with cmd-tools-graphify.sh: this reads what that wrote
+# rather than parsing the project a second time.
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.__WORKSPACE__.settings.yml);
+
+ARGPARSE_DESCRIPTION="Build an Obsidian vault from the knowledge graph of a project in the __WORKSPACE__ workspace"
+source ${WORKSPACE_SCRIPTS}/plugins/graph/args/arg-obsidian.sh || exit 1 ;
+
+shift $#;
+
+export MAX_CANVAS_NODES="${MAX_CANVAS_NODES}";
+
+if [ "${REMOVE}" == 'yes' ] ; then
+  obsidian_remove ;
+elif [ "${STATUS}" == 'yes' ] ; then
+  obsidian_status ;
+else
+  obsidian_project ;
+fi

package/config/workspace.graphs.settings.yml

@@ -0,0 +1,25 @@
+doc:
+  name: graphs
+
+# Knowledge graphs built by cmd-tools-graphify.sh, one directory per project:
+#   graphs/<workspace>/<project>/{graph.json,GRAPH_REPORT.md,graph.html}
+# They live HERE rather than inside the project on purpose: graphify writes tens of MB, Leiden
+# clustering is not bit-stable so every rebuild diffs in full, and half the projects worth mapping
+# are git repositories we ship — a recipe like products/website_starter must not gain a graphify-out/ or a
+# CLAUDE.md block just because someone mapped it.
+presentation:
+  icon: tabler:hierarchy-2
+  subtitle: Project Knowledge Graphs
+  noun: graph
+  kind: files
+
+# What this folder's projects are, and which actions their rows offer:
+# sites | code | files | media | ai-items — see core/workspace-app/WORKSPACES.md.
+type: code
+
+# What the assistant is called on THIS workspace's page, and what its composer says when empty.
+# `default` in either means "whatever settings.yml says" — the global value, so a rename there
+# still reaches this page. Set a value here to override it for this workspace alone.
+assistant:
+  name: default
+  placeholder: default

package/dist/src/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The knowledge graphs for Webship Workspace: the graphs workspace (`graphs/`) as a plugin, and the
+ * Graph menu on every project row that has a graphify command — build the graph, open it, read its
+ * report, download it, serve it over MCP, delete it — with the Obsidian vault made from it (build,
+ * read the notes, open the map, download, delete), the `/graph/…` and `/obsidian/…` pages, and the
+ * graphs list the workspace page shows.
+ *
+ * Everything the dashboard is asked for goes through `api`; the store lives in the graphs workspace,
+ * never inside a project.
+ */
+import type { PluginApi } from '@webship.co/workspace-plugin-api';
+declare const graphs: any;
+declare const obsidian: any;
+export declare const WORKSPACE_KEY = "graphs";
+export { graphs, obsidian };
+export declare function register(api: PluginApi): void;

package/dist/src/index.js

@@ -0,0 +1,309 @@
+"use strict";
+/**
+ * The knowledge graphs for Webship Workspace: the graphs workspace (`graphs/`) as a plugin, and the
+ * Graph menu on every project row that has a graphify command — build the graph, open it, read its
+ * report, download it, serve it over MCP, delete it — with the Obsidian vault made from it (build,
+ * read the notes, open the map, download, delete), the `/graph/…` and `/obsidian/…` pages, and the
+ * graphs list the workspace page shows.
+ *
+ * Everything the dashboard is asked for goes through `api`; the store lives in the graphs workspace,
+ * never inside a project.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.obsidian = exports.graphs = exports.WORKSPACE_KEY = void 0;
+exports.register = register;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const graphs = require('./lib/graphs');
+exports.graphs = graphs;
+const obsidian = require('./lib/obsidian');
+exports.obsidian = obsidian;
+exports.WORKSPACE_KEY = 'graphs';
+function register(api) {
+    const lib = api.lib;
+    const { esc, workspaceDir, listProjects, isValidWorkspace, NAME_RE, ROOT, iconHtml, humanSize, humanTime, commandBlock, runningJobKey, startJob, jobFragment, startInScreen, screenStartedHtml, findScript, cssVersionNow, lists } = lib;
+    const { graphStoreDir, hasGraph, listGraphs } = graphs;
+    const { vaultDir, indexNote, vaultView, vaultCanvas, vaultFrame, obsidianMenuItems } = obsidian;
+    const post = (name) => `/actions/p/${api.name}/${name}`;
+    const findGraphifyScript = (dir) => findScript(dir, [/^cmd-tools?-graphify\.sh$/]);
+    // ---- The graphs workspace page ------------------------------------------------------------------
+    function graphRowsHtml(state) {
+        const { SORTS, defaultSort, paginate, listControlsHtml, listPagerHtml } = lists;
+        const all = listGraphs();
+        const st = state;
+        const filtered = st.q ? all.filter((g) => g.name.toLowerCase().includes(st.q.toLowerCase())) : all;
+        const sorted = filtered.slice().sort((SORTS[st.sort] || SORTS[defaultSort()] || SORTS.newest).cmp);
+        const p = paginate(sorted, st);
+        const vals = (g, extra = '') => `hx-vals='{"workspace":"${esc(g.workspace)}","projectName":"${esc(g.project)}"${extra}}' hx-target="#webship-workspace-output" hx-swap="innerHTML"`;
+        const rows = p.slice.map((g) => `
+    <div class="uk-card uk-card-default uk-card-small uk-card-body uk-margin-small project-row">
+      <div class="item-row-body">
+        <span class="uk-text-bold">${iconHtml('tabler:hierarchy-2', 0.8)} ${esc(g.project)}
+          <span class="uk-text-meta item-machine" title="The workspace the project lives in">${esc(g.workspace)}</span></span>
+        <div class="item-meta-line">
+          <span class="uk-text-meta item-time">${esc(humanTime(g.mtime))}</span>
+          <span class="uk-text-meta">· ${esc(humanSize(g.size))}</span>
+          ${g.nodes != null ? `<span class="uk-label" title="Nodes and edges, from graphify's own build file">${g.nodes} nodes${g.links != null ? ` · ${g.links} edges` : ''}</span>` : ''}
+          ${g.projectExists ? '' : '<span class="uk-label" title="The project is gone — the graph outlived it, and is safe to delete">project removed</span>'}
+        </div>
+        <div class="project-actions">
+          ${g.hasHtml ? `<a class="uk-button uk-button-default uk-button-small" href="/graph/${esc(g.workspace)}/${esc(g.project)}" target="_blank" title="Loads vis-network from unpkg.com, so it needs internet"><span uk-icon="icon: image; ratio: .7"></span> Open</a>` : ''}
+          ${g.hasReport ? `<a class="uk-button uk-button-default uk-button-small" href="/graph/${esc(g.workspace)}/${esc(g.project)}/report" target="_blank"><span uk-icon="icon: file-text; ratio: .7"></span> Report</a>` : ''}
+          <a class="uk-button uk-button-default uk-button-small" href="/graph/${esc(g.workspace)}/${esc(g.project)}/download"><span uk-icon="icon: download; ratio: .7"></span> Download</a>
+          ${g.projectExists ? `<button class="uk-button uk-button-secondary uk-button-small" hx-post="${post('graphify')}" ${vals(g)} title="Re-extract and re-cluster from the project"><span uk-icon="icon: refresh; ratio: .7"></span> Rebuild</button>` : ''}
+          <button class="uk-button uk-button-danger uk-button-small arm-step" hx-post="${post('graph-remove')}" ${vals(g, ',"confirm":"yes"')} hx-trigger="confirmed-remove"><span uk-icon="icon: trash; ratio: .7"></span> Delete</button>
+        </div>
+      </div>
+    </div>`).join('');
+        // The controls get the BARE URL: htmx appends the included inputs without deduping, and
+        // readPageState reads the FIRST q/sort. The pager keeps the qs form so page links keep the search.
+        const bareUrl = `/fragments/p/${api.name}/list`;
+        const qs = new URLSearchParams();
+        if (st.q)
+            qs.set('q', st.q);
+        if (st.sort !== defaultSort())
+            qs.set('sort', st.sort);
+        const url = `${bareUrl}${qs.toString() ? `?${qs}` : ''}`;
+        const pager = listPagerHtml(url, '#webship-workspace-projects', p, st, 'graphs');
+        return `
+    <h3 class="uk-margin-small-bottom">Graphs <span class="uk-badge">${all.length}</span></h3>
+    <p class="uk-text-meta uk-margin-small-bottom">One directory per project in <code>${esc(path_1.default.join(ROOT, 'graphs'))}/&lt;workspace&gt;/&lt;project&gt;/</code>,
+      built by <code>cmd-tools-graphify.sh</code> from the project's workspace folder. Query one with
+      <code>graphify query "…" --graph ${esc(path_1.default.join(ROOT, 'graphs'))}/&lt;workspace&gt;/&lt;project&gt;/graph.json</code>.</p>
+    ${listControlsHtml(bareUrl, '#webship-workspace-projects', st, 'graphs')}
+    ${pager}
+    ${rows || '<p class="uk-text-meta">No graphs yet — build one from the Graph menu on any project row.</p>'}
+    ${pager}`;
+    }
+    api.addWorkspaceView(exports.WORKSPACE_KEY, {
+        listHtml: (state) => `
+    <div id="webship-workspace-projects" hx-get="/fragments/p/${api.name}/list" hx-trigger="refresh-projects from:body">
+      ${graphRowsHtml(state)}
+    </div>
+`,
+        count: () => listGraphs().length,
+        noFilesActions: true,
+        noNewForm: true,
+    });
+    api.addFragment(({ req, send, rest }) => {
+        if (rest !== 'list')
+            return send('', 404);
+        return send(graphRowsHtml(lists.readPageState(req)));
+    });
+    // ---- The Graph menu on a project row ---------------------------------------------------------
+    api.addRowMenu('graph', { label: 'Graph', row: 1 }, ({ key, project: p, dir, allowed, vals }) => {
+        if (!allowed.has('graphify') || !findGraphifyScript(dir))
+            return null;
+        const built = hasGraph(key, p, 'graph.json') || hasGraph(key, p, 'graph.html');
+        const busy = !!runningJobKey(`graphify:${key}/${p}`);
+        const items = obsidianMenuItems(key, p, vals, busy, post);
+        return `<span class="act-with-status"><div class="uk-inline act-menu act-menu-graph">
+      <button class="uk-button uk-button-default uk-button-small" type="button" title="Knowledge graph"><span uk-icon="icon: git-fork; ratio: .7"></span> Graph <span uk-icon="icon: chevron-down; ratio: .6"></span></button>
+      <div uk-dropdown="mode: click; pos: bottom-right"><ul class="uk-nav uk-dropdown-nav">
+        <li data-entry="build the graph"><a href hx-post="${post('graphify')}" ${vals()} class="${busy ? 'uk-disabled' : ''}"><span uk-icon="icon: play; ratio: .7"></span> ${built ? 'Rebuild the graph' : 'Build the graph'}${busy ? ' (running…)' : ''}</a></li>
+        ${built ? `<li class="uk-nav-divider"></li>
+        ${hasGraph(key, p, 'graph.html') ? `<li><a href="/graph/${esc(key)}/${esc(p)}" target="_blank" title="Loads vis-network from unpkg.com, so it needs internet"><span uk-icon="icon: image; ratio: .7"></span> Open the graph</a></li>` : ''}
+        ${hasGraph(key, p, 'GRAPH_REPORT.md') ? `<li><a href="/graph/${esc(key)}/${esc(p)}/report" target="_blank"><span uk-icon="icon: file-text; ratio: .7"></span> Read the report</a></li>` : ''}
+        <li><a href="/graph/${esc(key)}/${esc(p)}/download" title="The graph as a .tar.gz, to hand to another workspace"><span uk-icon="icon: download; ratio: .7"></span> Download to share</a></li>
+        <li><a href hx-post="${post('graph-mcp-command')}" ${vals()}><span uk-icon="icon: link; ratio: .7"></span> Connect over MCP…</a></li>
+        ${items}
+        <li class="uk-nav-divider"></li>
+        <li><a href class="uk-text-danger arm-step" hx-post="${post('graph-remove')}" ${vals(',"confirm":"yes"')} hx-trigger="confirmed-remove"><span uk-icon="icon: trash; ratio: .7"></span> Delete the graph</a></li>` : ''}
+      </ul></div>
+    </div><span class="act-status uk-text-meta">${built ? 'built' : 'none'}</span></span>`;
+    });
+    // ---- Actions ----------------------------------------------------------------------------------
+    api.addAction('graphify', async ({ form, send, workspace }) => {
+        const dir = workspaceDir(workspace);
+        const script = findGraphifyScript(dir);
+        const projectName = String(form.projectName || '');
+        if (!script)
+            return send('<div class="msg error">No graphify script in this workspace.</div>', 400);
+        if (!NAME_RE.test(projectName) || !listProjects(dir).includes(projectName))
+            return send('<div class="msg error">Unknown project.</div>', 400);
+        // graphify has no cross-process lock: two runs against one graphify-out/ race on its files.
+        if (runningJobKey(`graphify:${workspace}/${projectName}`))
+            return send('<div class="msg error">A graph is already being built for this project.</div>', 409);
+        const started = await startInScreen({ workspace, project: projectName, projectDir: dir, ownerDir: path_1.default.join(dir, projectName), verb: 'graphify',
+            cmdLine: `bash ${JSON.stringify(script)} ${JSON.stringify(projectName)}`, label: 'graphify' });
+        return send(screenStartedHtml(started, 'graphify', projectName), started.ok ? 200 : (started.already ? 409 : 500));
+    });
+    api.addAction('graph-mcp-command', ({ form, send, workspace }) => {
+        const projectName = String(form.projectName || '');
+        if (!NAME_RE.test(projectName))
+            return send('<div class="msg error">Unknown project.</div>', 400);
+        const graph = path_1.default.join(graphStoreDir(workspace, projectName), 'graph.json');
+        if (!fs_1.default.existsSync(graph))
+            return send('<div class="msg error">No graph yet — build it first.</div>', 409);
+        return send(commandBlock(`Serve the ${workspace}/${projectName} graph to the Claude Code CLI`, [`cd ${ROOT}/graphs && bash cmd-tools-graphs.sh ${workspace}/${projectName} -a mcp-register`,
+            `claude mcp add --scope user graph-${workspace}-${projectName} -- graphify-mcp ${graph.replace(ROOT, '~/workspace')}`], 'Run either one <strong>on the host</strong>, in a terminal. The first is the workspace command; '
+            + 'the second is what it runs. stdio, so there is no port and no daemon — the CLI starts the server '
+            + 'when a session needs it. Open a NEW session to see the tools; rebuilding the graph needs no re-registration.'));
+    });
+    api.addAction('graph-remove', ({ form, send, workspace, res }) => {
+        if (form.confirm !== 'yes')
+            return send('<div class="msg error">Deleting requires confirmation.</div>', 400);
+        const projectName = String(form.projectName || '');
+        // The project may be gone — a graph outlives it, and that is exactly a graph worth deleting.
+        if (!NAME_RE.test(projectName))
+            return send('<div class="msg error">Unknown project.</div>', 400);
+        if (runningJobKey(`graphify:${workspace}/${projectName}`))
+            return send('<div class="msg error">A graph run is in progress for this project — wait for it to finish.</div>', 409);
+        let real;
+        try {
+            real = fs_1.default.realpathSync(graphStoreDir(workspace, projectName));
+            const base = fs_1.default.realpathSync(path_1.default.join(ROOT, 'graphs'));
+            if (!real.startsWith(base + path_1.default.sep))
+                throw new Error('outside');
+        }
+        catch (_) {
+            return send('<div class="msg assistant">No graph to delete.</div>');
+        }
+        fs_1.default.rmSync(real, { recursive: true, force: true });
+        res.setHeader('HX-Trigger', 'refresh-projects');
+        return send(`<div class="msg assistant">🗑️ Deleted the graph for <strong>${esc(projectName)}</strong>. Rebuild it any time from the Graph menu.</div>`);
+    });
+    api.addAction('obsidian', ({ form, send, workspace }) => {
+        const dir = workspaceDir(workspace);
+        const script = 'cmd-tools-obsidian.sh';
+        const projectName = String(form.projectName || '');
+        if (!fs_1.default.existsSync(path_1.default.join(dir, script)))
+            return send('<div class="msg error">This workspace has no Obsidian script.</div>', 400);
+        if (!NAME_RE.test(projectName) || !listProjects(dir).includes(projectName))
+            return send('<div class="msg error">Unknown project.</div>', 400);
+        if (!fs_1.default.existsSync(path_1.default.join(graphStoreDir(workspace, projectName), 'graph.json')))
+            return send('<div class="msg error">No graph to convert yet — build the graph first, from the same menu.</div>', 409);
+        const jobKey = `obsidian:${workspace}/${projectName}`;
+        if (runningJobKey(jobKey))
+            return send('<div class="msg error">A vault is already being built for this project.</div>', 409);
+        const id = startJob(`🗂️ Obsidian <strong>${esc(projectName)}</strong>`, 'bash', [script, projectName], dir, { timeoutMs: 10 * 60 * 1000, echoLine: `bash ${script} ${projectName}`, key: jobKey });
+        return send(jobFragment(id).html);
+    });
+    api.addAction('obsidian-remove', ({ form, send, workspace }) => {
+        if (form.confirm !== 'yes')
+            return send('<div class="msg error">Deleting requires confirmation.</div>', 400);
+        const projectName = String(form.projectName || '');
+        if (!NAME_RE.test(projectName))
+            return send('<div class="msg error">Unknown project.</div>', 400);
+        const dir = vaultDir(workspace, projectName);
+        if (!fs_1.default.existsSync(dir))
+            return send('<div class="msg">There was no vault to delete.</div>');
+        try {
+            fs_1.default.rmSync(dir, { recursive: true, force: true });
+        }
+        catch (e) {
+            return send(`<div class="msg error">Could not delete the vault: ${esc(e.message)}</div>`, 500);
+        }
+        return send('<div class="msg">Vault deleted. The graph it was made from is untouched.</div>');
+    });
+    // ---- The pages: the graph, its report, its archive; the vault's notes, map, index, archive --------
+    const tarOut = (res, real, filename) => {
+        res.writeHead(200, { 'Content-Type': 'application/gzip', 'Content-Disposition': `attachment; filename="${filename.replace(/[^A-Za-z0-9._-]/g, '_')}"`, 'X-Content-Type-Options': 'nosniff' });
+        const tar = (0, child_process_1.spawn)('tar', ['-czf', '-', '-C', path_1.default.dirname(real), path_1.default.basename(real)], { stdio: ['ignore', 'pipe', 'pipe'] });
+        tar.stdout.pipe(res);
+        tar.stderr.resume();
+        tar.on('error', () => { try {
+            res.destroy();
+        }
+        catch (_) { /* client gone */ } });
+        res.on('close', () => { try {
+            tar.kill();
+        }
+        catch (_) { /* already exited */ } });
+    };
+    // Resolve symlinks before trusting a path: a project directory that is a link would otherwise read
+    // outside the workspace, and the dashboard container bind-mounts ~/.claude as well as ~/workspace.
+    const insideStore = (p, wantDir) => {
+        try {
+            const base = fs_1.default.realpathSync(path_1.default.join(ROOT, 'graphs'));
+            const real = fs_1.default.realpathSync(p);
+            if (!real.startsWith(base + path_1.default.sep))
+                return null;
+            const st = fs_1.default.statSync(real);
+            return (wantDir ? st.isDirectory() : st.isFile()) ? real : null;
+        }
+        catch (_) {
+            return null;
+        }
+    };
+    api.addPage(/^\/obsidian\/([a-z0-9_-]+)\/([a-zA-Z0-9_.-]+)\/(index|download|view|canvas|frame)$/, ({ req, res, match }) => {
+        const [, wsKey, project, what] = match;
+        if (!isValidWorkspace(wsKey) || project.includes('..')) {
+            res.writeHead(400);
+            return res.end('bad name');
+        }
+        const real = insideStore(vaultDir(wsKey, project), true);
+        if (!real) {
+            res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+            return res.end('No vault yet — build one from the Graph menu on the project row.');
+        }
+        const q = new URL(String(req.url || '/'), 'http://localhost').searchParams;
+        if (what === 'frame') {
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            return res.end(vaultFrame(wsKey, project, String(q.get('what') || 'view')));
+        }
+        if (what === 'view' || what === 'canvas') {
+            let page;
+            try {
+                page = what === 'view' ? vaultView(wsKey, project, String(q.get('note') || ''), cssVersionNow()) : vaultCanvas(wsKey, project, cssVersionNow());
+            }
+            catch (e) {
+                res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
+                return res.end(`Could not read the vault: ${e.message}`);
+            }
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            return res.end(page);
+        }
+        if (what === 'index') {
+            let md;
+            try {
+                md = fs_1.default.readFileSync(path_1.default.join(real, indexNote(project)), 'utf8');
+            }
+            catch (_) {
+                res.writeHead(404, { 'Content-Type': 'text/html; charset=utf-8' });
+                return res.end('<div class="msg error">The vault has no index note. Rebuild it.</div>');
+            }
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            return res.end(`<h3>${esc(project)} <span class="uk-text-meta">Obsidian vault</span></h3>
+        <p class="uk-text-meta">${esc(real)}</p>
+        <p><a class="uk-button uk-button-primary uk-button-small" href="${esc(`obsidian://open?path=${encodeURIComponent(real)}`)}">Open in Obsidian</a>
+           <a class="uk-button uk-button-default uk-button-small" href="/obsidian/${esc(wsKey)}/${esc(project)}/download">Download</a></p>
+        <pre class="uk-background-muted uk-padding-small" style="white-space:pre-wrap">${esc(md)}</pre>`);
+        }
+        return tarOut(res, real, `${wsKey}--${project}--obsidian.tar.gz`);
+    });
+    api.addPage(/^\/graph\/([a-z0-9_-]+)\/([a-zA-Z0-9_.-]+)\/download$/, ({ res, match }) => {
+        const [, wsKey, project] = match;
+        if (!isValidWorkspace(wsKey) || project.includes('..')) {
+            res.writeHead(400);
+            return res.end('bad name');
+        }
+        const real = insideStore(graphStoreDir(wsKey, project), true);
+        if (!real) {
+            res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+            return res.end('No graph yet — build one from the Graph menu on the project row.');
+        }
+        return tarOut(res, real, `${wsKey}--${project}--graph.tar.gz`);
+    });
+    api.addPage(/^\/graph\/([a-z0-9_-]+)\/([a-zA-Z0-9_-]+)(\/report)?$/, ({ res, match }) => {
+        const [, wsKey, project, report] = match;
+        if (!isValidWorkspace(wsKey)) {
+            res.writeHead(404);
+            return res.end();
+        }
+        const real = insideStore(path_1.default.join(graphStoreDir(wsKey, project), report ? 'GRAPH_REPORT.md' : 'graph.html'), false);
+        if (!real) {
+            res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+            return res.end('No graph yet — press Graph on the project row to build one.');
+        }
+        // graph.html is generated from the project's own code: scripts sandboxed away from this origin, streamed.
+        res.writeHead(200, { 'Content-Type': report ? 'text/plain; charset=utf-8' : 'text/html; charset=utf-8', 'X-Content-Type-Options': 'nosniff', 'Content-Security-Policy': 'sandbox allow-scripts allow-popups;' });
+        return fs_1.default.createReadStream(real).pipe(res);
+    });
+    api.addAssistantContext(() => 'The graphs/ workspace holds one knowledge graph per project (built by cmd-tools-graphify.sh, @webship.co/workspace-graph); the Graph menu on a project row builds, opens, downloads, serves over MCP or deletes it, and makes an Obsidian vault from it.');
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/graphs.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/lib/graphs.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Where a project's knowledge graph lives, and what is in it.
+ *
+ * The graph is kept in the graphs workspace rather than inside the project — it is tens of MB, it
+ * re-diffs entirely on every rebuild, and half the projects worth mapping are repositories we ship.
+ * Everything here reads that store; building one is `cmd-tools-graphify.sh`.
+ */
+const fs = require('fs');
+const path = require('path');
+// The workspace root: WORKSPACE_ROOT when set, else the nearest ancestor with core/config/settings.yml
+// (the package sits under core/workspace-app/node_modules).
+function findRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 12; i++) {
+        if (fs.existsSync(path.join(dir, 'core', 'config', 'settings.yml')))
+            return dir;
+        const up = path.dirname(dir);
+        if (up === dir)
+            break;
+        dir = up;
+    }
+    return path.resolve(__dirname, '..', '..', '..', '..', '..', '..', '..');
+}
+const ROOT = process.env.WORKSPACE_ROOT || findRoot();
+// Where a project's graph lives: the graphs workspace, never inside the project. graphify only
+// writes <project>/graphify-out, so cmd-tools-graphify.sh moves the result here — a graph is tens
+// of MB, it re-diffs entirely on every rebuild, and half the projects worth mapping are
+// repositories we ship.
+function graphStoreDir(wsKey, project) {
+    return path.join(ROOT, 'graphs', wsKey, project);
+}
+// Graph lookups per project row, memoised for 2s: projectRowsHtml is
+// re-rendered on every job poll.
+let _graphCache = new Map();
+let _graphCacheAt = 0;
+function hasGraph(wsKey, project, file) {
+    const now = Date.now();
+    if (now - _graphCacheAt > 2000) {
+        _graphCache = new Map();
+        _graphCacheAt = now;
+    }
+    const k = `${wsKey}/${project}/${file}`;
+    if (!_graphCache.has(k))
+        _graphCache.set(k, fs.existsSync(path.join(graphStoreDir(wsKey, project), file)));
+    return _graphCache.get(k);
+}
+// Node and edge counts, memoised on the graph file's identity so paging a long list re-reads
+// nothing. Keyed on mtime+size: a rebuild changes both.
+const _graphCounts = new Map();
+function graphCounts(file, stat) {
+    if (!stat)
+        return { nodes: null, links: null };
+    const key = `${file}:${stat.mtimeMs}:${stat.size}`;
+    if (_graphCounts.has(key))
+        return _graphCounts.get(key);
+    let counts = { nodes: null, links: null };
+    try {
+        const d = JSON.parse(fs.readFileSync(file, 'utf8'));
+        counts = { nodes: (d.nodes || []).length, links: (d.links || d.edges || []).length };
+    }
+    catch (_) { /* unreadable or half-written */ }
+    _graphCounts.set(key, counts);
+    return counts;
+}
+// Every graph in the store, as <workspace>/<project> rows. Reads the two levels the build writes
+// and nothing else, so a stray file in graphs/ cannot become a row.
+function listGraphs() {
+    const base = path.join(ROOT, 'graphs');
+    const rows = [];
+    let workspaces = [];
+    try {
+        workspaces = fs.readdirSync(base, { withFileTypes: true }).filter((e) => e.isDirectory());
+    }
+    catch (_) {
+        return rows;
+    }
+    for (const ws of workspaces) {
+        let projects = [];
+        try {
+            projects = fs.readdirSync(path.join(base, ws.name), { withFileTypes: true }).filter((e) => e.isDirectory());
+        }
+        catch (_) {
+            continue;
+        }
+        for (const pr of projects) {
+            const dir = path.join(base, ws.name, pr.name);
+            const stat = (f) => { try {
+                return fs.statSync(path.join(dir, f));
+            }
+            catch (_) {
+                return null;
+            } };
+            const json = stat('graph.json');
+            // The counts come from graph.json itself — .graphify_build.json carries only the excludes,
+            // so the numbers were rendering empty. Parsing is cheap enough (20ms for a 2,430-node graph)
+            // and the result is memoised on the file's mtime and size, so a re-render costs nothing.
+            const nodes_links = graphCounts(path.join(dir, 'graph.json'), json);
+            const nodes = nodes_links.nodes;
+            const links = nodes_links.links;
+            let size = 0;
+            const walk = (d) => {
+                let entries = [];
+                try {
+                    entries = fs.readdirSync(d, { withFileTypes: true });
+                }
+                catch (_) {
+                    return;
+                }
+                for (const e of entries) {
+                    const full = path.join(d, e.name);
+                    if (e.isDirectory())
+                        walk(full);
+                    else {
+                        try {
+                            size += fs.statSync(full).size;
+                        }
+                        catch (_) { /* gone */ }
+                    }
+                }
+            };
+            walk(dir);
+            rows.push({
+                workspace: ws.name,
+                project: pr.name,
+                name: `${ws.name}/${pr.name}`,
+                mtime: json ? json.mtime : new Date(0),
+                size,
+                nodes,
+                links,
+                hasHtml: !!stat('graph.html'),
+                hasReport: !!stat('GRAPH_REPORT.md'),
+                projectExists: fs.existsSync(path.join(ROOT, ws.name, pr.name)),
+            });
+        }
+    }
+    return rows;
+}
+module.exports = { ROOT, graphStoreDir, hasGraph, graphCounts, listGraphs };
+//# sourceMappingURL=graphs.js.map