@oldboydev/sheldon-darwin-arm64 0.2.0 → 0.2.2

package/node_modules/@sheldon/cli/dist/commands/agents.js

@@ -2,7 +2,7 @@ import { spawn } from 'node:child_process';
 import { access } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { listAgentProfiles, requireAgentProfile } from '@sheldon/agent-runtime';
+import { buildChildEnvironment, listAgentProfiles, requireAgentProfile } from '@sheldon/agent-runtime';
 export async function doctorAgents(agent, context, probe = new LocalAgentHealthProbe()) {
     const profiles = agent === undefined ? listAgentProfiles() : [
         requireAgentProfile(agent)
@@ -18,9 +18,15 @@ export async function doctorAgents(agent, context, probe = new LocalAgentHealthP
             continue;
         }
         context.write(`${profile.label}: available${health.version === undefined ? '' : ` (${health.version})`}`);
-        context.write(`  Authentication: ${health.authenticated ? 'usable' : 'unavailable'}${health.authenticated ? '' : `; sign in with ${profile.executable} and retry.`}`);
+        context.write(`  Authentication: ${health.authenticated ? 'usable' : 'unavailable'}${health.authenticated ? '' : `; ${authenticationRecovery(profile)}`}`);
     }
 }
+function authenticationRecovery(profile) {
+    if (profile.health.authentication === 'grok-auth-store') {
+        return 'sign in with grok login or set XAI_API_KEY and retry.';
+    }
+    return `sign in with ${profile.executable} and retry.`;
+}
 function missingBinaryRecovery(profile) {
     const install = `install ${profile.executable}`;
     const pathHint = profile.id === 'grok' && process.platform === 'win32' ? ' and ensure %USERPROFILE%\\.grok\\bin is on PATH' : '';
@@ -30,9 +36,13 @@ function missingBinaryRecovery(profile) {
  * Checks only process exit status and a short version string. Authentication command output is
  * intentionally discarded so credentials and tokens cannot reach CLI output.
  */ export class LocalAgentHealthProbe {
+    executables;
+    constructor(options = {}){
+        this.executables = options.executables;
+    }
     async check(agent, environment) {
         const profile = requireAgentProfile(agent);
-        const version = await invoke(profile.executable, profile.health.versionArguments, environment, true);
+        const version = await this.invoke(profile, profile.health.versionArguments, environment, true);
         if (version.exitCode !== 0) return {
             available: false,
             authenticated: false
@@ -42,35 +52,81 @@ function missingBinaryRecovery(profile) {
             ...version.output === undefined ? {} : {
                 version: version.output
             },
-            authenticated: await checkAuthentication(profile, environment)
+            authenticated: await this.checkAuthentication(profile, environment)
         };
     }
-}
-async function checkAuthentication(profile, environment) {
-    switch(profile.health.authentication){
-        case 'codex-login-status':
-            {
-                const authentication = await invoke(profile.executable, [
-                    'login',
-                    'status'
-                ], environment, false);
-                return authentication.exitCode === 0;
-            }
-        case 'claude-auth-status':
-            {
-                const authentication = await invoke(profile.executable, [
-                    'auth',
-                    'status'
-                ], environment, false);
-                return authentication.exitCode === 0;
-            }
-        case 'grok-auth-store':
-            {
-                const grokHome = environment.GROK_HOME ?? join(homedir(), '.grok');
-                const hasKey = (environment.XAI_API_KEY ?? '').trim().length > 0;
-                const hasStore = await pathExists(join(grokHome, 'auth.json'));
-                return hasKey || hasStore;
+    async checkAuthentication(profile, environment) {
+        switch(profile.health.authentication){
+            case 'codex-login-status':
+                {
+                    const authentication = await this.invoke(profile, [
+                        'login',
+                        'status'
+                    ], environment, false);
+                    return authentication.exitCode === 0;
+                }
+            case 'claude-auth-status':
+                {
+                    const authentication = await this.invoke(profile, [
+                        'auth',
+                        'status'
+                    ], environment, false);
+                    return authentication.exitCode === 0;
+                }
+            case 'grok-auth-store':
+                {
+                    const grokHome = environment.GROK_HOME ?? join(homedir(), '.grok');
+                    const hasKey = (environment.XAI_API_KEY ?? '').trim().length > 0;
+                    const hasStore = await pathExists(join(grokHome, 'auth.json'));
+                    return hasKey || hasStore;
+                }
+        }
+    }
+    invoke(profile, arguments_, environment, captureOutput) {
+        const override = this.executables?.[profile.id];
+        const executable = override?.executable ?? profile.executable;
+        const argv = [
+            ...override?.arguments ?? [],
+            ...arguments_
+        ];
+        return new Promise((resolve)=>{
+            let output = '';
+            let finished = false;
+            const child = spawn(executable, argv, {
+                shell: false,
+                env: buildChildEnvironment(environment, profile.envAllowlist),
+                stdio: [
+                    'ignore',
+                    captureOutput ? 'pipe' : 'ignore',
+                    'ignore'
+                ],
+                windowsHide: true
+            });
+            const timeout = setTimeout(()=>child.kill(), 5_000);
+            const finish = (result)=>{
+                if (finished) return;
+                finished = true;
+                clearTimeout(timeout);
+                resolve(result);
+            };
+            if (captureOutput) {
+                child.stdout?.on('data', (chunk)=>{
+                    if (output.length < 256) output += chunk.toString('utf8').slice(0, 256 - output.length);
+                });
             }
+            child.once('error', ()=>finish({
+                    exitCode: null
+                }));
+            child.once('close', (exitCode)=>{
+                const version = output.trim().replace(/\s+/g, ' ');
+                finish({
+                    exitCode,
+                    ...version === '' ? {} : {
+                        output: version
+                    }
+                });
+            });
+        });
     }
 }
 async function pathExists(path) {
@@ -81,43 +137,3 @@ async function pathExists(path) {
         return false;
     }
 }
-async function invoke(executable, arguments_, environment, captureOutput) {
-    return new Promise((resolve)=>{
-        let output = '';
-        let finished = false;
-        const child = spawn(executable, arguments_, {
-            shell: false,
-            env: environment,
-            stdio: [
-                'ignore',
-                captureOutput ? 'pipe' : 'ignore',
-                'ignore'
-            ],
-            windowsHide: true
-        });
-        const timeout = setTimeout(()=>child.kill(), 5_000);
-        const finish = (result)=>{
-            if (finished) return;
-            finished = true;
-            clearTimeout(timeout);
-            resolve(result);
-        };
-        if (captureOutput) {
-            child.stdout?.on('data', (chunk)=>{
-                if (output.length < 256) output += chunk.toString('utf8').slice(0, 256 - output.length);
-            });
-        }
-        child.once('error', ()=>finish({
-                exitCode: null
-            }));
-        child.once('close', (exitCode)=>{
-            const version = output.trim().replace(/\s+/g, ' ');
-            finish({
-                exitCode,
-                ...version === '' ? {} : {
-                    output: version
-                }
-            });
-        });
-    });
-}

package/node_modules/@sheldon/cli/dist/commands/mcp.js

@@ -132,7 +132,7 @@ export async function doctorMcp(consumer, context) {
     context.write(`Claude skill: ${skillClaude ? 'installed' : 'not installed (warning)'}`);
     context.write(`Grok skill: ${skillGrok ? 'installed' : 'not installed (warning)'}`);
 }
-/** Starts the local-only stdio server used by Codex and Claude configurations. */ export async function serveMcp(consumerConfig) {
+/** Starts the local-only stdio server used by Codex, Claude, and Grok configurations. */ export async function serveMcp(consumerConfig) {
     const configuration = await readConsumerMcpConfiguration(consumerConfig);
     const scopes = await preferredScopes(configuration);
     const vault = await VaultService.discover(configuration.vault);

package/node_modules/@sheldon/cli/dist/commands/memory.js

@@ -301,6 +301,35 @@ export async function compileMemory(kind, slug, proposalId, options, context, de
     options.signal?.throwIfAborted();
     context.write(JSON.stringify(result, null, 2));
 }
+export async function listPendingReviews(options, context) {
+    const root = await resolveVaultPath(context, options.vault);
+    const vault = await VaultService.discover(root);
+    const topics = [];
+    for (const entity of (await vault.listEntities('topic'))){
+        if (entity.status !== 'active') continue;
+        const store = new ProposalStore(entityDirectory(root, 'topic', entity.slug));
+        const proposals = [];
+        for (const metadata of (await store.list())){
+            if (metadata.status !== 'pending') continue;
+            const stored = await store.load(metadata.id);
+            if (stored.proposal === undefined) continue;
+            proposals.push({
+                id: metadata.id,
+                agent: metadata.agent,
+                createdAt: metadata.createdAt
+            });
+        }
+        if (proposals.length === 0) continue;
+        topics.push({
+            slug: entity.slug,
+            title: entity.title,
+            proposals
+        });
+    }
+    context.write(JSON.stringify({
+        topics
+    }));
+}
 export async function previewProposal(kind, slug, proposalId, options, context) {
     const entity = await resolveEntity(kind, slug, options.vault, context);
     const proposal = new ProposalStore(entity).assertPromotable(await new ProposalStore(entity).load(proposalId));

package/node_modules/@sheldon/cli/dist/help/index.html

@@ -0,0 +1,97 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Sheldon help</title>
+<link rel="stylesheet" href="styles.css">
+</head>
+<body>
+<div class="win">
+<header class="titlebar">
+  <div class="titlebar__brand">
+    <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
+    <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
+    <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
+    <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
+    <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
+    <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
+  </svg>
+    <span class="titlebar__title">sheldon</span>
+  </div>
+  <span class="titlebar__sep"></span>
+  <span class="titlebar__meta">Ajuda offline</span>
+</header>
+<div class="appbody">
+<aside class="sidebar">
+  <p class="sidebar__label">Início</p>
+  <nav class="sidebar__nav">
+    <a class="navitem is-active" href="index.html" aria-current="page">Ajuda</a>
+  </nav>
+  <p class="sidebar__label">Fluxos</p>
+  <nav class="sidebar__nav">
+    <a class="navitem" href="pages/flow-first-vault.html">First vault</a>
+    <a class="navitem" href="pages/flow-compile-review.html">Compile then review</a>
+    <a class="navitem" href="pages/flow-end-to-end.html">End-to-end</a>
+  </nav>
+  <p class="sidebar__label">Comandos</p>
+  <nav class="sidebar__nav">
+    <a class="navitem" href="pages/init.html">init</a>
+    <a class="navitem" href="pages/doctor.html">doctor</a>
+    <a class="navitem" href="pages/migrate-state.html">migrate-state</a>
+    <a class="navitem" href="pages/web.html">web</a>
+    <a class="navitem" href="pages/topic.html">topic</a>
+    <a class="navitem" href="pages/project.html">project</a>
+    <a class="navitem" href="pages/ingest.html">ingest</a>
+    <a class="navitem" href="pages/compile.html">compile</a>
+    <a class="navitem" href="pages/review.html">review</a>
+    <a class="navitem" href="pages/bundle.html">bundle</a>
+    <a class="navitem" href="pages/search.html">search</a>
+    <a class="navitem" href="pages/query.html">query</a>
+    <a class="navitem" href="pages/answer.html">answer</a>
+    <a class="navitem" href="pages/agent.html">agent</a>
+    <a class="navitem" href="pages/mcp.html">mcp</a>
+    <a class="navitem" href="pages/plugin.html">plugin</a>
+    <a class="navitem" href="pages/image.html">image</a>
+  </nav>
+</aside>
+<div class="content">
+<div class="content__inner">
+<article class="card card__pad prose">
+<h1>Sheldon help</h1>
+<p>Offline HTML help for the Sheldon CLI. Terminal <code>--help</code> stays short; these pages add examples and flows.</p>
+<h2>Flows</h2>
+<ul>
+<li><a href="pages/flow-first-vault.html">First vault</a> — create a vault and save it as the local default</li>
+<li><a href="pages/flow-compile-review.html">Compile then review</a> — raw capture → compile → preview → approve</li>
+<li><a href="pages/flow-end-to-end.html">End-to-end</a> — init → ingest → compile → approve → search / query</li>
+</ul>
+<h2>Commands</h2>
+<ul>
+<li><a href="pages/init.html">init</a> — create a vault</li>
+<li><a href="pages/doctor.html">doctor</a> — check vault, plugins, and agents</li>
+<li><a href="pages/migrate-state.html">migrate-state</a> — copy legacy application state</li>
+<li><a href="pages/web.html">web</a> — local loopback web UI</li>
+<li><a href="pages/topic.html">topic</a> — create and manage topics</li>
+<li><a href="pages/project.html">project</a> — create and manage projects</li>
+<li><a href="pages/ingest.html">ingest</a> — capture sources into immutable raws</li>
+<li><a href="pages/compile.html">compile</a> — turn raws into reviewable proposals (<code>compile</code> / <code>compile-retry</code>)</li>
+<li><a href="pages/review.html">review</a> — preview, approve, reject, and lint proposals</li>
+<li><a href="pages/bundle.html">bundle</a> — portable OKF bundles from approved concepts</li>
+<li><a href="pages/search.html">search</a> — search approved wiki concepts</li>
+<li><a href="pages/query.html">query</a> — ask an agent a cited question from the index</li>
+<li><a href="pages/answer.html">answer</a> — promote a saved answer into a proposal</li>
+<li><a href="pages/agent.html">agent</a> — check Codex, Claude, and Grok CLIs</li>
+<li><a href="pages/mcp.html">mcp</a> — scoped MCP access for consumer projects</li>
+<li><a href="pages/plugin.html">plugin</a> — discover and install source plugins</li>
+<li><a href="pages/image.html">image</a> — manage OCR language data</li>
+</ul>
+<h2>Vault paths</h2>
+<p>Sheldon does <strong>not</strong> list vaults. Use the default saved by <code>init</code>, or pass <code>--vault &lt;path&gt;</code> on each command.</p>
+</article>
+</div>
+</div>
+</div>
+</div>
+</body>
+</html>

package/node_modules/@sheldon/cli/dist/help/manifest.json

@@ -0,0 +1,121 @@
+{
+  "schemaVersion": 1,
+  "pages": [
+    { "id": "index", "title": "Sheldon help", "file": "pages/index.md", "commands": [] },
+    { "id": "init", "title": "init", "file": "pages/init.md", "commands": ["init"] },
+    {
+      "id": "flow-first-vault",
+      "title": "First vault",
+      "file": "pages/flow-first-vault.md",
+      "commands": ["init"]
+    },
+    {
+      "id": "doctor",
+      "title": "doctor",
+      "file": "pages/doctor.md",
+      "commands": ["doctor"]
+    },
+    {
+      "id": "migrate-state",
+      "title": "migrate-state",
+      "file": "pages/migrate-state.md",
+      "commands": ["migrate-state"]
+    },
+    {
+      "id": "web",
+      "title": "web",
+      "file": "pages/web.md",
+      "commands": ["web"]
+    },
+    {
+      "id": "topic",
+      "title": "topic",
+      "file": "pages/topic.md",
+      "commands": ["topic"]
+    },
+    {
+      "id": "project",
+      "title": "project",
+      "file": "pages/project.md",
+      "commands": ["project"]
+    },
+    {
+      "id": "ingest",
+      "title": "ingest",
+      "file": "pages/ingest.md",
+      "commands": ["ingest"]
+    },
+    {
+      "id": "compile",
+      "title": "compile",
+      "file": "pages/compile.md",
+      "commands": ["compile", "compile-retry"]
+    },
+    {
+      "id": "review",
+      "title": "review",
+      "file": "pages/review.md",
+      "commands": ["review"]
+    },
+    {
+      "id": "bundle",
+      "title": "bundle",
+      "file": "pages/bundle.md",
+      "commands": ["bundle"]
+    },
+    {
+      "id": "search",
+      "title": "search",
+      "file": "pages/search.md",
+      "commands": ["search"]
+    },
+    {
+      "id": "query",
+      "title": "query",
+      "file": "pages/query.md",
+      "commands": ["query"]
+    },
+    {
+      "id": "answer",
+      "title": "answer",
+      "file": "pages/answer.md",
+      "commands": ["answer"]
+    },
+    {
+      "id": "agent",
+      "title": "agent",
+      "file": "pages/agent.md",
+      "commands": ["agent"]
+    },
+    {
+      "id": "mcp",
+      "title": "mcp",
+      "file": "pages/mcp.md",
+      "commands": ["mcp"]
+    },
+    {
+      "id": "plugin",
+      "title": "plugin",
+      "file": "pages/plugin.md",
+      "commands": ["plugin"]
+    },
+    {
+      "id": "image",
+      "title": "image",
+      "file": "pages/image.md",
+      "commands": ["image"]
+    },
+    {
+      "id": "flow-compile-review",
+      "title": "Compile then review",
+      "file": "pages/flow-compile-review.md",
+      "commands": ["ingest", "compile", "compile-retry", "review"]
+    },
+    {
+      "id": "flow-end-to-end",
+      "title": "End-to-end",
+      "file": "pages/flow-end-to-end.md",
+      "commands": ["init", "ingest", "compile", "review", "search", "query"]
+    }
+  ]
+}

package/node_modules/@sheldon/cli/dist/help/pages/agent.html

@@ -0,0 +1,101 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>agent</title>
+<link rel="stylesheet" href="../styles.css">
+</head>
+<body>
+<div class="win">
+<header class="titlebar">
+  <div class="titlebar__brand">
+    <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
+    <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
+    <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
+    <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
+    <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
+    <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
+  </svg>
+    <span class="titlebar__title">sheldon</span>
+  </div>
+  <span class="titlebar__sep"></span>
+  <span class="titlebar__meta">Ajuda offline</span>
+</header>
+<div class="appbody">
+<aside class="sidebar">
+  <p class="sidebar__label">Início</p>
+  <nav class="sidebar__nav">
+    <a class="navitem" href="../index.html">Ajuda</a>
+  </nav>
+  <p class="sidebar__label">Fluxos</p>
+  <nav class="sidebar__nav">
+    <a class="navitem" href="flow-first-vault.html">First vault</a>
+    <a class="navitem" href="flow-compile-review.html">Compile then review</a>
+    <a class="navitem" href="flow-end-to-end.html">End-to-end</a>
+  </nav>
+  <p class="sidebar__label">Comandos</p>
+  <nav class="sidebar__nav">
+    <a class="navitem" href="init.html">init</a>
+    <a class="navitem" href="doctor.html">doctor</a>
+    <a class="navitem" href="migrate-state.html">migrate-state</a>
+    <a class="navitem" href="web.html">web</a>
+    <a class="navitem" href="topic.html">topic</a>
+    <a class="navitem" href="project.html">project</a>
+    <a class="navitem" href="ingest.html">ingest</a>
+    <a class="navitem" href="compile.html">compile</a>
+    <a class="navitem" href="review.html">review</a>
+    <a class="navitem" href="bundle.html">bundle</a>
+    <a class="navitem" href="search.html">search</a>
+    <a class="navitem" href="query.html">query</a>
+    <a class="navitem" href="answer.html">answer</a>
+    <a class="navitem is-active" href="agent.html" aria-current="page">agent</a>
+    <a class="navitem" href="mcp.html">mcp</a>
+    <a class="navitem" href="plugin.html">plugin</a>
+    <a class="navitem" href="image.html">image</a>
+  </nav>
+</aside>
+<div class="content">
+<div class="content__inner">
+<article class="card card__pad prose">
+<h1>agent</h1>
+<p>Check whether locally installed agent CLIs (Codex, Claude, and/or Grok) are present and usable. Sheldon never calls model APIs directly; compile and query invoke these optional agent tools on your machine.</p>
+<h2>Synopsis</h2>
+<pre><code class="language-text">sheldon agent doctor [agent]
+</code></pre>
+<p><code>agent</code> is optional: <code>codex</code>, <code>claude</code>, or <code>grok</code>. Omit it to check all supported agents.</p>
+<h2>Important flags / arguments</h2>
+<ul>
+<li><code>agent</code> — optional single agent kind to probe. Must be one of the supported kinds when provided.</li>
+</ul>
+<h2>Examples</h2>
+<p>Check every supported agent (portable):</p>
+<pre><code class="language-sh">sheldon agent doctor
+</code></pre>
+<p>Check one agent (portable):</p>
+<pre><code class="language-sh">sheldon agent doctor codex
+sheldon agent doctor claude
+sheldon agent doctor grok
+</code></pre>
+<h2>Expected outputs / artifacts</h2>
+<ul>
+<li>Prints a report for each probed agent: <code>not found</code> (with recovery) or <code>available</code> (version when known), plus Authentication <code>usable</code> or <code>unavailable</code>.</li>
+<li>Doctor is a report: exit status stays zero even when an agent is missing or unusable.</li>
+<li><code>compile</code> and <code>query</code> still need <code>--agent</code> plus a usable CLI; a green or empty doctor line does not substitute for that.</li>
+<li>Does not install agents or write vault files.</li>
+</ul>
+<h2>Common failures</h2>
+<ul>
+<li>Unknown agent name — use <code>codex</code>, <code>claude</code>, or <code>grok</code>.</li>
+<li>Agent binary missing from <code>PATH</code> — install that vendor’s CLI and re-run.</li>
+<li>Installed but not logged in — complete the agent’s own authentication flow, then retry <code>agent doctor</code>.</li>
+<li>Compile/query still failing after a green doctor — confirm you passed the same <code>--agent</code> value and that the vault path is correct (<code>--vault</code> or the saved default; Sheldon does <strong>not</strong> list vaults).</li>
+</ul>
+<p>Related: <a href="compile.html">compile</a>, <a href="query.html">query</a>, <a href="doctor.html">doctor</a>.</p>
+</article>
+</div>
+</div>
+</div>
+</div>
+</body>
+</html>