studiograph 1.3.46 → 1.3.48-beta.0

package/dist/agent/tools/web-tools.js

@@ -0,0 +1,283 @@
+/**
+ * Web Tools for the Studiograph Agent
+ *
+ * Provides web search and page fetching capabilities.
+ * Supports multiple search providers: Brave, Google, Tavily.
+ * Provider is configured via workspace config or env vars.
+ */
+import { Type as T } from 'typebox';
+import { tryResolve } from '../../core/secrets/read-flip.js';
+function wrapToolResult(result) {
+    const text = JSON.stringify(result, null, 2);
+    return {
+        content: [{ type: 'text', text }],
+        details: result,
+    };
+}
+// ── Provider: Brave Search ─────────────────────────────────────
+class BraveSearchProvider {
+    apiKey;
+    name = 'brave';
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async search(query, maxResults) {
+        const params = new URLSearchParams({ q: query, count: String(maxResults) });
+        const res = await fetch(`https://api.search.brave.com/res/v1/web/search?${params}`, {
+            headers: { 'X-Subscription-Token': this.apiKey, 'Accept': 'application/json' },
+        });
+        if (!res.ok)
+            throw new Error(`Brave search failed: ${res.status}`);
+        const data = await res.json();
+        return (data.web?.results ?? []).slice(0, maxResults).map((r) => ({
+            title: r.title ?? '',
+            url: r.url ?? '',
+            snippet: r.description ?? '',
+        }));
+    }
+}
+// ── Provider: Google Custom Search ─────────────────────────────
+class GoogleSearchProvider {
+    apiKey;
+    cx;
+    name = 'google';
+    constructor(apiKey, cx) {
+        this.apiKey = apiKey;
+        this.cx = cx;
+    }
+    async search(query, maxResults) {
+        const num = Math.min(maxResults, 10);
+        const params = new URLSearchParams({ key: this.apiKey, cx: this.cx, q: query, num: String(num) });
+        const res = await fetch(`https://www.googleapis.com/customsearch/v1?${params}`);
+        if (!res.ok)
+            throw new Error(`Google search failed: ${res.status}`);
+        const data = await res.json();
+        return (data.items ?? []).slice(0, maxResults).map((r) => ({
+            title: r.title ?? '',
+            url: r.link ?? '',
+            snippet: r.snippet ?? '',
+        }));
+    }
+}
+// ── Provider: Tavily ───────────────────────────────────────────
+class TavilySearchProvider {
+    apiKey;
+    name = 'tavily';
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async search(query, maxResults) {
+        const res = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: this.apiKey,
+                query,
+                max_results: maxResults,
+                search_depth: 'basic',
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`Tavily search failed: ${res.status}`);
+        const data = await res.json();
+        return (data.results ?? []).slice(0, maxResults).map((r) => ({
+            title: r.title ?? '',
+            url: r.url ?? '',
+            snippet: r.content ?? '',
+        }));
+    }
+}
+/**
+ * Resolve a search provider from config + env vars.
+ *
+ * Phase 6 read-flip: the encrypted store wins via the resolver. We
+ * check the store for each provider's api_key + (for Google)
+ * `search.google.cx`, then fall back to the workspace config and
+ * env-var chain. The resolver itself bakes in env > store > default
+ * precedence, so calling tryResolve() is the right way to consult
+ * either source without duplicating precedence logic.
+ *
+ * Env vars checked (legacy fallback only):
+ *   BRAVE_SEARCH_API_KEY
+ *   GOOGLE_SEARCH_API_KEY + GOOGLE_SEARCH_CX
+ *   TAVILY_API_KEY
+ */
+function resolveSearchProvider(config) {
+    // Three-tier resolution, in order of precedence:
+    //   1. `search.provider` setting in the new store — explicit, picker-driven.
+    //      Uses ONLY that provider's key. Other keys, even if stored, are
+    //      ignored (no silent cascade-overrides-my-pick).
+    //   2. Legacy workspace-config `search.provider` — same explicit behavior,
+    //      kept for back-compat with old workspace.json files.
+    //   3. Auto-detect cascade (brave → tavily → google) for any setup that
+    //      predates the picker. First key found wins.
+    const storeProvider = tryResolve('search.provider');
+    const storeBrave = tryResolve('search.brave.api_key');
+    const storeTavily = tryResolve('search.tavily.api_key');
+    const storeGoogle = tryResolve('search.google.api_key');
+    const storeGoogleCx = tryResolve('search.google.cx');
+    // 1. Explicit picker via the new store. When the user has chosen a
+    //    provider in the settings UI, that choice is authoritative — no
+    //    cascade. If the chosen provider's key isn't set, we return null
+    //    rather than silently fall through to a different provider.
+    if (storeProvider === 'brave' || storeProvider === 'tavily' || storeProvider === 'google') {
+        switch (storeProvider) {
+            case 'brave': {
+                const key = storeBrave || process.env.BRAVE_SEARCH_API_KEY;
+                return key ? new BraveSearchProvider(key) : null;
+            }
+            case 'tavily': {
+                const key = storeTavily || process.env.TAVILY_API_KEY;
+                return key ? new TavilySearchProvider(key) : null;
+            }
+            case 'google': {
+                const key = storeGoogle || process.env.GOOGLE_SEARCH_API_KEY;
+                const cx = storeGoogleCx || process.env.GOOGLE_SEARCH_CX;
+                return key && cx ? new GoogleSearchProvider(key, cx) : null;
+            }
+        }
+    }
+    // 2. Legacy workspace-config preference.
+    if (config?.provider && config?.api_key) {
+        const key = resolveEnvValue(config.api_key);
+        switch (config.provider) {
+            case 'brave':
+                return new BraveSearchProvider(storeBrave || key);
+            case 'google': {
+                const cx = storeGoogleCx || resolveEnvValue(config.google_cx ?? '');
+                if (!cx)
+                    return null;
+                return new GoogleSearchProvider(storeGoogle || key, cx);
+            }
+            case 'tavily':
+                return new TavilySearchProvider(storeTavily || key);
+        }
+    }
+    // 3. Auto-detect cascade (back-compat for installs without an explicit
+    //    picker setting). Brave wins if any of its surfaces are set.
+    if (storeBrave)
+        return new BraveSearchProvider(storeBrave);
+    if (process.env.BRAVE_SEARCH_API_KEY) {
+        return new BraveSearchProvider(process.env.BRAVE_SEARCH_API_KEY);
+    }
+    if (storeTavily)
+        return new TavilySearchProvider(storeTavily);
+    if (process.env.TAVILY_API_KEY) {
+        return new TavilySearchProvider(process.env.TAVILY_API_KEY);
+    }
+    if (storeGoogle && storeGoogleCx) {
+        return new GoogleSearchProvider(storeGoogle, storeGoogleCx);
+    }
+    if (process.env.GOOGLE_SEARCH_API_KEY && process.env.GOOGLE_SEARCH_CX) {
+        return new GoogleSearchProvider(process.env.GOOGLE_SEARCH_API_KEY, process.env.GOOGLE_SEARCH_CX);
+    }
+    return null;
+}
+/** Resolve $ENV_VAR references in config values */
+function resolveEnvValue(value) {
+    if (value.startsWith('$')) {
+        return process.env[value.slice(1)] ?? '';
+    }
+    return value;
+}
+// ── Tool creation ──────────────────────────────────────────────
+/**
+ * Create web tools for the agent.
+ * @param searchConfig Optional search provider config from workspace settings
+ */
+export function createWebTools(searchConfig) {
+    const provider = resolveSearchProvider(searchConfig);
+    const tools = [];
+    // Only add web_search if a provider is available
+    if (provider) {
+        tools.push({
+            name: 'web_search',
+            label: 'Web Search',
+            description: `Search the web for information (via ${provider.name}). Use this when the user asks about topics outside the knowledge graph — general knowledge, how-to questions, current events, external resources, etc.`,
+            parameters: T.Object({
+                query: T.String({ description: 'Search query' }),
+                maxResults: T.Optional(T.Number({ description: 'Maximum results to return (default 5, max 10)' })),
+            }),
+            execute: async (_toolCallId, params) => {
+                try {
+                    const maxResults = Math.min(params.maxResults ?? 5, 10);
+                    const results = await provider.search(params.query, maxResults);
+                    if (results.length === 0) {
+                        return wrapToolResult({ success: true, results: [], message: 'No results found.' });
+                    }
+                    return wrapToolResult({ success: true, provider: provider.name, results });
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err.message ?? 'Web search failed' });
+                }
+            },
+        });
+    }
+    // web_fetch is always available (no API key needed)
+    tools.push({
+        name: 'web_fetch',
+        label: 'Fetch Web Page',
+        description: 'Fetch a web page and extract its readable text content. Use this to read articles, documentation, or any URL the user provides or that appears in search results.',
+        parameters: T.Object({
+            url: T.String({ description: 'URL to fetch' }),
+            maxLength: T.Optional(T.Number({ description: 'Maximum characters to return (default 8000)' })),
+        }),
+        execute: async (_toolCallId, params) => {
+            try {
+                const maxLength = params.maxLength ?? 8000;
+                const content = await fetchPage(params.url, maxLength);
+                return wrapToolResult({ success: true, url: params.url, content });
+            }
+            catch (err) {
+                return wrapToolResult({ success: false, error: err.message ?? 'Failed to fetch page' });
+            }
+        },
+    });
+    return tools;
+}
+// ── Page fetch implementation ──────────────────────────────────
+async function fetchPage(url, maxLength) {
+    const res = await fetch(url, {
+        headers: {
+            'User-Agent': 'Mozilla/5.0 (compatible; Studiograph/1.0)',
+            'Accept': 'text/html,application/xhtml+xml,text/plain',
+        },
+        redirect: 'follow',
+        signal: AbortSignal.timeout(10000),
+    });
+    if (!res.ok) {
+        throw new Error(`Fetch failed with status ${res.status}`);
+    }
+    const contentType = res.headers.get('content-type') ?? '';
+    if (contentType.includes('text/plain') || contentType.includes('application/json')) {
+        const text = await res.text();
+        return text.slice(0, maxLength);
+    }
+    const html = await res.text();
+    return extractReadableText(html).slice(0, maxLength);
+}
+function extractReadableText(html) {
+    let text = html
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        .replace(/<nav[\s\S]*?<\/nav>/gi, '')
+        .replace(/<header[\s\S]*?<\/header>/gi, '')
+        .replace(/<footer[\s\S]*?<\/footer>/gi, '')
+        .replace(/<aside[\s\S]*?<\/aside>/gi, '');
+    text = text.replace(/<\/?(p|div|br|h[1-6]|li|tr|blockquote|section|article)[^>]*>/gi, '\n');
+    text = text.replace(/<[^>]+>/g, '');
+    text = text
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ');
+    text = text
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line.length > 0)
+        .join('\n');
+    return text;
+}
+//# sourceMappingURL=web-tools.js.map

package/dist/agent/tools/web-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-tools.js","sourceRoot":"","sources":["../../../src/agent/tools/web-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,SAAS,cAAc,CAAC,MAAW;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC;AAeD,kEAAkE;AAElE,MAAM,mBAAmB;IAEH;IADpB,IAAI,GAAG,OAAO,CAAC;IACf,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAkB;QAC5C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,kDAAkD,MAAM,EAAE,EAAE;YAClF,OAAO,EAAE,EAAE,sBAAsB,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SAC/E,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACrE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;SAC7B,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,kEAAkE;AAElE,MAAM,oBAAoB;IAEJ;IAAwB;IAD5C,IAAI,GAAG,QAAQ,CAAC;IAChB,YAAoB,MAAc,EAAU,EAAU;QAAlC,WAAM,GAAN,MAAM,CAAQ;QAAU,OAAE,GAAF,EAAE,CAAQ;IAAG,CAAC;IAE1D,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAkB;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClG,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YAC9D,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;YACjB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,kEAAkE;AAElE,MAAM,oBAAoB;IAEJ;IADpB,IAAI,GAAG,QAAQ,CAAC;IAChB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAkB;QAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,+BAA+B,EAAE;YACvD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,IAAI,CAAC,MAAM;gBACpB,KAAK;gBACL,WAAW,EAAE,UAAU;gBACvB,YAAY,EAAE,OAAO;aACtB,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YAChE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAWD;;;;;;;;;;;;;;GAcG;AACH,SAAS,qBAAqB,CAAC,MAAqB;IAClD,iDAAiD;IACjD,6EAA6E;IAC7E,sEAAsE;IACtE,sDAAsD;IACtD,2EAA2E;IAC3E,2DAA2D;IAC3D,wEAAwE;IACxE,kDAAkD;IAClD,MAAM,aAAa,GAAG,UAAU,CAAS,iBAAiB,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,UAAU,CAAS,sBAAsB,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,UAAU,CAAS,uBAAuB,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,UAAU,CAAS,uBAAuB,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,UAAU,CAAS,kBAAkB,CAAC,CAAC;IAE7D,mEAAmE;IACnE,oEAAoE;IACpE,qEAAqE;IACrE,gEAAgE;IAChE,IAAI,aAAa,KAAK,OAAO,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC1F,QAAQ,aAAa,EAAE,CAAC;YACtB,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,GAAG,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;gBAC3D,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnD,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBACtD,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACpD,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;gBAC7D,MAAM,EAAE,GAAG,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBACzD,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,oBAAoB,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM,EAAE,QAAQ,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,OAAO;gBACV,OAAO,IAAI,mBAAmB,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;YACpD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,EAAE,GAAG,aAAa,IAAI,eAAe,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;gBACpE,IAAI,CAAC,EAAE;oBAAE,OAAO,IAAI,CAAC;gBACrB,OAAO,IAAI,oBAAoB,CAAC,WAAW,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,KAAK,QAAQ;gBACX,OAAO,IAAI,oBAAoB,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,iEAAiE;IACjE,IAAI,UAAU;QAAE,OAAO,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;QACrC,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,WAAW;QAAE,OAAO,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;QACjC,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtE,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACnG,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kEAAkE;AAElE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,YAA2B;IACxD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAErD,MAAM,KAAK,GAAU,EAAE,CAAC;IAExB,iDAAiD;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,uCAAuC,QAAQ,CAAC,IAAI,yJAAyJ;YAC1N,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;gBAChD,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC,CAAC;aACnG,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA8C,EAAE,EAAE;gBACrF,IAAI,CAAC;oBACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;oBAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACzB,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;oBACtF,CAAC;oBACD,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC7E,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,mBAAmB,EAAE,CAAC,CAAC;gBACvF,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,mKAAmK;QAChL,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;YAC9C,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC,CAAC;SAChG,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA2C,EAAE,EAAE;YAClF,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;gBAC3C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACvD,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,sBAAsB,EAAE,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kEAAkE;AAElE,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,SAAiB;IACrD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE;YACP,YAAY,EAAE,2CAA2C;YACzD,QAAQ,EAAE,4CAA4C;SACvD;QACD,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAE1D,IAAI,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,IAAI,IAAI,GAAG,IAAI;SACZ,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;SACxC,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC;SACpC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC;SAC1C,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;IAE5C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gEAAgE,EAAE,IAAI,CAAC,CAAC;IAC5F,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEpC,IAAI,GAAG,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAE3B,IAAI,GAAG,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/commands/about.d.ts

@@ -10,4 +10,5 @@
  *   studiograph about --set <file> # set from a file
  */
 import { Command } from 'commander';
+export declare function parseEditorCommand(editor: string): string[];
 export declare const aboutCommand: Command;

package/dist/cli/commands/about.js

@@ -12,11 +12,54 @@
 import { Command } from 'commander';
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
-import { execSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { text, log, outro, isCancel } from '@clack/prompts';
 import { Workspace } from '../../core/workspace.js';
 const SECTIONS = ['Vision', 'Mission', 'Profile', 'Capabilities', 'Values'];
 const TEMPLATE = SECTIONS.map(s => `## ${s}\n`).join('\n');
+export function parseEditorCommand(editor) {
+    const args = [];
+    let current = '';
+    let quote = null;
+    let escaping = false;
+    for (const ch of editor.trim()) {
+        if (escaping) {
+            current += ch;
+            escaping = false;
+            continue;
+        }
+        if (ch === '\\') {
+            escaping = true;
+            continue;
+        }
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+            else
+                current += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            if (current) {
+                args.push(current);
+                current = '';
+            }
+            continue;
+        }
+        current += ch;
+    }
+    if (escaping)
+        current += '\\';
+    if (quote)
+        throw new Error('Unclosed quote in editor command');
+    if (current)
+        args.push(current);
+    return args;
+}
 export const aboutCommand = new Command('about')
     .description('Display or edit workspace ABOUT.md')
     .option('-e, --edit', 'Open ABOUT.md in $EDITOR')
@@ -78,10 +121,19 @@ export const aboutCommand = new Command('about')
         }
         const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
         try {
-            execSync(`${editor} "${aboutPath}"`, { stdio: 'inherit' });
+            const [cmd, ...editorArgs] = parseEditorCommand(editor);
+            if (!cmd)
+                throw new Error('Editor command is empty');
+            const result = spawnSync(cmd, [...editorArgs, aboutPath], { stdio: 'inherit', shell: false });
+            if (result.error)
+                throw result.error;
+            if (result.status !== 0)
+                throw new Error(`Editor exited with status ${result.status ?? 'unknown'}`);
         }
-        catch {
+        catch (err) {
             console.error(`Failed to open editor: ${editor}`);
+            if (err?.message)
+                console.error(err.message);
             process.exit(1);
         }
         return;

package/dist/cli/commands/about.js.map

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

package/dist/cli/commands/admin/audit-workspace.d.ts

@@ -0,0 +1,23 @@
+/**
+ * studiograph admin audit-workspace — read-only health aggregator.
+ *
+ * Wraps `analyzeGraphHealth()` from src/services/graph-maintenance.ts —
+ * the same service that powers the dashboard's health digest — and
+ * emits a markdown report. The point isn't to surface anything new; it's
+ * to give the owner a single command for the periodic sweep, instead of
+ * running `studiograph lint`, `studiograph orphans`, and chasing broken
+ * wikilinks by hand.
+ *
+ * Output is stdout by default (so it can be piped to `pbcopy`, `glow`,
+ * or `tee somewhere.md`). `--out <path>` writes to disk and prints just
+ * the summary table.
+ */
+import { Command } from 'commander';
+import { type GraphHealthReport } from '../../../services/graph-maintenance.js';
+export declare const adminAuditWorkspaceCommand: Command;
+/**
+ * Render the report as a markdown document. Sections are emitted only
+ * when they have content — an empty workspace produces a tight one-page
+ * doc, a full audit produces a long one.
+ */
+export declare function renderMarkdown(report: GraphHealthReport, workspaceName: string): string;

package/dist/cli/commands/admin/audit-workspace.js

@@ -0,0 +1,133 @@
+/**
+ * studiograph admin audit-workspace — read-only health aggregator.
+ *
+ * Wraps `analyzeGraphHealth()` from src/services/graph-maintenance.ts —
+ * the same service that powers the dashboard's health digest — and
+ * emits a markdown report. The point isn't to surface anything new; it's
+ * to give the owner a single command for the periodic sweep, instead of
+ * running `studiograph lint`, `studiograph orphans`, and chasing broken
+ * wikilinks by hand.
+ *
+ * Output is stdout by default (so it can be piped to `pbcopy`, `glow`,
+ * or `tee somewhere.md`). `--out <path>` writes to disk and prints just
+ * the summary table.
+ */
+import { Command } from 'commander';
+import { intro, outro, log, spinner } from '@clack/prompts';
+import { writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { Workspace } from '../../../core/workspace.js';
+import { WorkspaceManager } from '../../../core/workspace-manager.js';
+import { analyzeGraphHealth, } from '../../../services/graph-maintenance.js';
+export const adminAuditWorkspaceCommand = new Command('audit-workspace')
+    .description('Read-only workspace health report (lint + orphans + stale + broken wikilinks)')
+    .option('--out <path>', 'Write the markdown report to <path> instead of stdout')
+    .option('--quiet', 'Suppress the intro/outro decorations (useful in pipes)')
+    .action(async (opts) => {
+    if (!opts.quiet)
+        intro('Studiograph workspace audit');
+    const workspace = new Workspace();
+    if (!workspace.isWorkspace()) {
+        if (!opts.quiet)
+            outro('Not a Studiograph workspace. Run from your workspace root.');
+        else
+            console.error('Not a Studiograph workspace.');
+        process.exit(1);
+        return;
+    }
+    const config = await workspace.loadConfig();
+    const gitUser = { id: 'system', name: 'system', email: 'system@local' };
+    const manager = new WorkspaceManager(process.cwd(), config, gitUser);
+    const spin = opts.quiet ? null : spinner();
+    spin?.start('Aggregating health metrics');
+    const report = await analyzeGraphHealth(manager);
+    spin?.stop('Done');
+    const markdown = renderMarkdown(report, config.team_name ?? 'workspace');
+    if (opts.out) {
+        const path = resolve(opts.out);
+        writeFileSync(path, markdown, 'utf-8');
+        if (!opts.quiet)
+            log.success(`Wrote ${path}`);
+        printSummary(report);
+    }
+    else {
+        // Stdout path. clack's log helpers add prefixes that fight pipes, so
+        // use plain console.log for the report and reserve clack for the
+        // intro/outro framing (skipped under --quiet).
+        console.log(markdown);
+    }
+    if (!opts.quiet)
+        outro(`${report.summary.totalIssues} issue(s) across ${report.summary.totalEntities} entities.`);
+});
+function printSummary(report) {
+    const s = report.summary;
+    log.message(`Summary:\n` +
+        `  entities:        ${s.totalEntities}\n` +
+        `  missing fields:  ${s.missingFields}\n` +
+        `  orphans:         ${s.orphanEntities}\n` +
+        `  stale:           ${s.staleEntities}\n` +
+        `  broken wikilinks: ${s.brokenWikilinks}\n` +
+        `  total issues:    ${s.totalIssues}`);
+}
+/**
+ * Render the report as a markdown document. Sections are emitted only
+ * when they have content — an empty workspace produces a tight one-page
+ * doc, a full audit produces a long one.
+ */
+export function renderMarkdown(report, workspaceName) {
+    const s = report.summary;
+    const lines = [];
+    lines.push(`# Workspace audit — ${workspaceName}`);
+    lines.push('');
+    lines.push(`_Generated ${report.generatedAt}_`);
+    lines.push('');
+    lines.push('## Summary');
+    lines.push('');
+    lines.push('| Metric | Count |');
+    lines.push('| --- | ---: |');
+    lines.push(`| Entities | ${s.totalEntities} |`);
+    lines.push(`| Total issues | ${s.totalIssues} |`);
+    lines.push(`| Missing-field issues | ${s.missingFields} |`);
+    lines.push(`| Orphan entities | ${s.orphanEntities} |`);
+    lines.push(`| Stale entities (>30d) | ${s.staleEntities} |`);
+    lines.push(`| Broken wikilinks | ${s.brokenWikilinks} |`);
+    lines.push('');
+    if (s.totalIssues === 0) {
+        lines.push('No issues found.');
+        return lines.join('\n') + '\n';
+    }
+    if (report.missingFields.length > 0) {
+        lines.push('## Missing fields');
+        lines.push('');
+        for (const issue of report.missingFields) {
+            lines.push(`- **${issue.entityType}** \`${issue.entityId}\` (${issue.repo}) — ${issue.missingFields.join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (report.orphans.length > 0) {
+        lines.push('## Orphans (zero inbound references)');
+        lines.push('');
+        for (const o of report.orphans) {
+            lines.push(`- **${o.entityType}** \`${o.entityId}\` (${o.repo}) — ${o.name}`);
+        }
+        lines.push('');
+    }
+    if (report.stale.length > 0) {
+        lines.push('## Stale entities (no edits in >30 days)');
+        lines.push('');
+        for (const st of report.stale) {
+            lines.push(`- **${st.entityType}** \`${st.entityId}\` (${st.repo}) — ${st.name}, last touched ${st.lastUpdated} (${st.daysSinceUpdate}d ago)`);
+        }
+        lines.push('');
+    }
+    if (report.brokenLinks.length > 0) {
+        lines.push('## Broken wikilinks');
+        lines.push('');
+        for (const bl of report.brokenLinks) {
+            lines.push(`- **${bl.entityType}** \`${bl.entityId}\` (${bl.repo}) — ${bl.name} → \`[[${bl.brokenLink}]]\``);
+        }
+        lines.push('');
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=audit-workspace.js.map

package/dist/cli/commands/admin/audit-workspace.js.map

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

package/dist/cli/commands/admin/audit.d.ts

@@ -0,0 +1,21 @@
+/**
+ * studiograph audit — read-only operator view of the append-only audit log.
+ *
+ *   studiograph audit list [filters]
+ *     --key <pattern>            Filter by key name (exact match)
+ *     --actor <user-id>          Filter by actor user-id
+ *     --action <action>          Filter by action type
+ *                                (set|delete|test|describe|migrate|...)
+ *     --since <iso-date>         Only events at-or-after this time
+ *     --until <iso-date>         Only events at-or-before this time
+ *     --limit <n>                Page size (default 50, max 500)
+ *     --offset <n>               Pagination offset
+ *     --format <table|json>      Output format (default table)
+ *
+ * Audit reads aren't audited themselves (append-only log; reading
+ * doesn't change state). The UI used to surface this as a Settings →
+ * Audit Log tab; removed because filtering and exporting are much
+ * better in a terminal.
+ */
+import { Command } from 'commander';
+export declare const auditCommand: Command;