@oldboydev/sheldon-darwin-arm64 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/SHA256SUMS +69 -18
  2. package/inventory.json +291 -36
  3. package/node_modules/@sheldon/cli/dist/commands/agents.js +85 -69
  4. package/node_modules/@sheldon/cli/dist/commands/mcp.js +1 -1
  5. package/node_modules/@sheldon/cli/dist/help/fonts/NunitoSans-VariableFont_YTLC_opsz_wdth_wght.ttf +0 -0
  6. package/node_modules/@sheldon/cli/dist/help/index.html +97 -0
  7. package/node_modules/@sheldon/cli/dist/help/manifest.json +121 -0
  8. package/node_modules/@sheldon/cli/dist/help/pages/agent.html +101 -0
  9. package/node_modules/@sheldon/cli/dist/help/pages/answer.html +110 -0
  10. package/node_modules/@sheldon/cli/dist/help/pages/bundle.html +124 -0
  11. package/node_modules/@sheldon/cli/dist/help/pages/compile.html +120 -0
  12. package/node_modules/@sheldon/cli/dist/help/pages/doctor.html +102 -0
  13. package/node_modules/@sheldon/cli/dist/help/pages/flow-compile-review.html +125 -0
  14. package/node_modules/@sheldon/cli/dist/help/pages/flow-end-to-end.html +147 -0
  15. package/node_modules/@sheldon/cli/dist/help/pages/flow-first-vault.html +100 -0
  16. package/node_modules/@sheldon/cli/dist/help/pages/image.html +107 -0
  17. package/node_modules/@sheldon/cli/dist/help/pages/ingest.html +156 -0
  18. package/node_modules/@sheldon/cli/dist/help/pages/init.html +98 -0
  19. package/node_modules/@sheldon/cli/dist/help/pages/mcp.html +135 -0
  20. package/node_modules/@sheldon/cli/dist/help/pages/migrate-state.html +100 -0
  21. package/node_modules/@sheldon/cli/dist/help/pages/plugin.html +120 -0
  22. package/node_modules/@sheldon/cli/dist/help/pages/project.html +110 -0
  23. package/node_modules/@sheldon/cli/dist/help/pages/query.html +110 -0
  24. package/node_modules/@sheldon/cli/dist/help/pages/review.html +114 -0
  25. package/node_modules/@sheldon/cli/dist/help/pages/search.html +103 -0
  26. package/node_modules/@sheldon/cli/dist/help/pages/topic.html +112 -0
  27. package/node_modules/@sheldon/cli/dist/help/pages/web.html +102 -0
  28. package/node_modules/@sheldon/cli/dist/help/styles.css +368 -0
  29. package/node_modules/@sheldon/cli/dist/help.js +84 -0
  30. package/node_modules/@sheldon/cli/dist/main.js +38 -0
  31. package/node_modules/@sheldon/cli/node_modules/@sheldon/agent-runtime/dist/command-executor.js +1 -1
  32. package/node_modules/@sheldon/cli/node_modules/@sheldon/agent-runtime/dist/index.js +1 -1
  33. package/node_modules/@sheldon/cli/node_modules/@sheldon/agent-runtime/dist/profiles.js +1 -5
  34. package/node_modules/@sheldon/cli/node_modules/@sheldon/plugin-host/dist/official-catalog.js +4 -3
  35. package/node_modules/@sheldon/cli/node_modules/@sheldon/plugin-source-image/node_modules/@sheldon/plugin-host/dist/official-catalog.js +4 -3
  36. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/client/assets/index-B8MAXTxb.js +13 -0
  37. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/client/assets/{index-BB6UWWie.css → index-DZRX97IO.css} +1 -1
  38. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/client/index.html +2 -2
  39. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/contract.js +18 -0
  40. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/server.js +26 -0
  41. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/wiki-markdown.js +75 -0
  42. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/wiki.js +175 -0
  43. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel-react-native.d.ts.map +1 -0
  44. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel-react-native.js.map +1 -0
  45. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel.d.ts +5 -0
  46. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/diagnostics-channel.js +7 -0
  47. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/index.d.ts +1400 -0
  48. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/index.d.ts.map +1 -0
  49. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/index.js +1733 -0
  50. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/index.js.map +1 -0
  51. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/perf.d.ts +12 -0
  52. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/perf.d.ts.map +1 -0
  53. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/perf.js +10 -0
  54. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/commonjs/react-native/perf.js.map +1 -0
  55. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel-react-native.d.ts.map +1 -0
  56. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel-react-native.js.map +1 -0
  57. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel.d.ts +5 -0
  58. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/diagnostics-channel.js +4 -0
  59. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/index.d.ts +1400 -0
  60. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/index.d.ts.map +1 -0
  61. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/index.js +1729 -0
  62. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/index.js.map +1 -0
  63. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/perf.d.ts +12 -0
  64. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/perf.d.ts.map +1 -0
  65. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/perf.js +7 -0
  66. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/dist/esm/react-native/perf.js.map +1 -0
  67. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@fastify/static/node_modules/glob/node_modules/path-scurry/node_modules/lru-cache/package.json +17 -1
  68. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@sheldon/agent-runtime/dist/command-executor.js +1 -1
  69. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@sheldon/agent-runtime/dist/index.js +1 -1
  70. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/node_modules/@sheldon/agent-runtime/dist/profiles.js +1 -5
  71. package/package.json +1 -1
  72. package/sbom.spdx.json +1 -1
  73. package/node_modules/@sheldon/cli/node_modules/@sheldon/web/dist/client/assets/index-FrWwJl0U.js +0 -9
package/node_modules/@sheldon/cli/dist/help/pages/plugin.html ADDED
@@ -0,0 +1,120 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>plugin</title>
7
+ <link rel="stylesheet" href="../styles.css">
8
+ </head>
9
+ <body>
10
+ <div class="win">
11
+ <header class="titlebar">
12
+ <div class="titlebar__brand">
13
+ <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
14
+ <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
15
+ <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
16
+ <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
17
+ <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
18
+ <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
19
+ </svg>
20
+ <span class="titlebar__title">sheldon</span>
21
+ </div>
22
+ <span class="titlebar__sep"></span>
23
+ <span class="titlebar__meta">Ajuda offline</span>
24
+ </header>
25
+ <div class="appbody">
26
+ <aside class="sidebar">
27
+ <p class="sidebar__label">Início</p>
28
+ <nav class="sidebar__nav">
29
+ <a class="navitem" href="../index.html">Ajuda</a>
30
+ </nav>
31
+ <p class="sidebar__label">Fluxos</p>
32
+ <nav class="sidebar__nav">
33
+ <a class="navitem" href="flow-first-vault.html">First vault</a>
34
+ <a class="navitem" href="flow-compile-review.html">Compile then review</a>
35
+ <a class="navitem" href="flow-end-to-end.html">End-to-end</a>
36
+ </nav>
37
+ <p class="sidebar__label">Comandos</p>
38
+ <nav class="sidebar__nav">
39
+ <a class="navitem" href="init.html">init</a>
40
+ <a class="navitem" href="doctor.html">doctor</a>
41
+ <a class="navitem" href="migrate-state.html">migrate-state</a>
42
+ <a class="navitem" href="web.html">web</a>
43
+ <a class="navitem" href="topic.html">topic</a>
44
+ <a class="navitem" href="project.html">project</a>
45
+ <a class="navitem" href="ingest.html">ingest</a>
46
+ <a class="navitem" href="compile.html">compile</a>
47
+ <a class="navitem" href="review.html">review</a>
48
+ <a class="navitem" href="bundle.html">bundle</a>
49
+ <a class="navitem" href="search.html">search</a>
50
+ <a class="navitem" href="query.html">query</a>
51
+ <a class="navitem" href="answer.html">answer</a>
52
+ <a class="navitem" href="agent.html">agent</a>
53
+ <a class="navitem" href="mcp.html">mcp</a>
54
+ <a class="navitem is-active" href="plugin.html" aria-current="page">plugin</a>
55
+ <a class="navitem" href="image.html">image</a>
56
+ </nav>
57
+ </aside>
58
+ <div class="content">
59
+ <div class="content__inner">
60
+ <article class="card card__pad prose">
61
+ <h1>plugin</h1>
62
+ <p>Discover, install, test, and diagnose source plugins. Connectors such as <code>source.file</code> and <code>source.url</code> ship as plugins; install what you need before ingesting.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon plugin install &lt;id&gt;
65
+ sheldon plugin remove &lt;id&gt;
66
+ sheldon plugin list [--remote]
67
+ sheldon plugin info &lt;id&gt; [--remote]
68
+ sheldon plugin doctor &lt;id&gt;
69
+ sheldon plugin test &lt;directory&gt;
70
+ </code></pre>
71
+ <h2>Important flags / arguments</h2>
72
+ <ul>
73
+ <li><code>id</code> — plugin id from the local install set or the signed official catalog (for example <code>source.file</code>).</li>
74
+ <li><code>--remote</code> — (<code>list</code> / <code>info</code>) load the signed official catalog instead of only local installs.</li>
75
+ <li><code>directory</code> — (<code>test</code>) path to a local plugin package under contract test.</li>
76
+ <li>Catalog entries may omit a platform. On macOS, <code>source.image</code>, <code>source.youtube</code>, and <code>source.instagram</code> are listed remotely as <code>platform unavailable</code> because they ship native binaries that would require Apple signing and notarization. <code>source.file</code>, <code>source.url</code>, <code>source.linkedin</code>, and <code>source.repository</code> install on Windows, Linux, and macOS.</li>
77
+ </ul>
78
+ <h2>Examples</h2>
79
+ <p>List installed plugins and the remote catalog (portable):</p>
80
+ <pre><code class="language-sh">sheldon plugin list
81
+ sheldon plugin list --remote
82
+ sheldon plugin info source.file --remote
83
+ </code></pre>
84
+ <p>Install and health-check (portable):</p>
85
+ <pre><code class="language-sh">sheldon plugin install source.file
86
+ sheldon plugin doctor source.file
87
+ </code></pre>
88
+ <p>PowerShell — contract-test a local plugin directory:</p>
89
+ <pre><code class="language-powershell">sheldon plugin test C:\src\my-plugin
90
+ </code></pre>
91
+ <p>Unix:</p>
92
+ <pre><code class="language-sh">sheldon plugin test ~/src/my-plugin
93
+ </code></pre>
94
+ <p>Remove when no longer needed (portable):</p>
95
+ <pre><code class="language-sh">sheldon plugin remove source.file
96
+ </code></pre>
97
+ <h2>Expected outputs / artifacts</h2>
98
+ <ul>
99
+ <li><code>list</code> / <code>info</code> — plugin ids, versions, and install status (local and/or catalog).</li>
100
+ <li><code>install</code> — downloads a verified catalog entry into the application plugin store.</li>
101
+ <li><code>doctor</code> — healthcheck result for one installed plugin (exit non-zero when unhealthy).</li>
102
+ <li><code>test</code> — contract-test report for a local plugin directory.</li>
103
+ <li><code>remove</code> — uninstalls an installed plugin id.</li>
104
+ </ul>
105
+ <h2>Common failures</h2>
106
+ <ul>
107
+ <li>Catalog signature or network failure on <code>--remote</code> / <code>install</code> — retry when online; do not bypass signature checks.</li>
108
+ <li><code>platform unavailable</code> / <code>OFFICIAL_CATALOG_PLATFORM_UNSUPPORTED</code> for <code>source.image</code>, <code>source.youtube</code>, or <code>source.instagram</code> on macOS — those official artifacts are Windows x64 and Linux x64 only.</li>
109
+ <li>Plugin not installed when ingesting — <code>plugin list --remote</code>, then <code>plugin install &lt;id&gt;</code>.</li>
110
+ <li>Unhealthy doctor — follow the printed remediation (missing runtime, language pack, etc.).</li>
111
+ <li>Plugin not installed when removing — <code>plugin list</code>, then retry with an installed id.</li>
112
+ </ul>
113
+ <p>Related: <a href="ingest.html">ingest</a>, <a href="image.html">image</a>, <a href="doctor.html">doctor</a>.</p>
114
+ </article>
115
+ </div>
116
+ </div>
117
+ </div>
118
+ </div>
119
+ </body>
120
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/project.html ADDED
@@ -0,0 +1,110 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>project</title>
7
+ <link rel="stylesheet" href="../styles.css">
8
+ </head>
9
+ <body>
10
+ <div class="win">
11
+ <header class="titlebar">
12
+ <div class="titlebar__brand">
13
+ <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
14
+ <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
15
+ <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
16
+ <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
17
+ <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
18
+ <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
19
+ </svg>
20
+ <span class="titlebar__title">sheldon</span>
21
+ </div>
22
+ <span class="titlebar__sep"></span>
23
+ <span class="titlebar__meta">Ajuda offline</span>
24
+ </header>
25
+ <div class="appbody">
26
+ <aside class="sidebar">
27
+ <p class="sidebar__label">Início</p>
28
+ <nav class="sidebar__nav">
29
+ <a class="navitem" href="../index.html">Ajuda</a>
30
+ </nav>
31
+ <p class="sidebar__label">Fluxos</p>
32
+ <nav class="sidebar__nav">
33
+ <a class="navitem" href="flow-first-vault.html">First vault</a>
34
+ <a class="navitem" href="flow-compile-review.html">Compile then review</a>
35
+ <a class="navitem" href="flow-end-to-end.html">End-to-end</a>
36
+ </nav>
37
+ <p class="sidebar__label">Comandos</p>
38
+ <nav class="sidebar__nav">
39
+ <a class="navitem" href="init.html">init</a>
40
+ <a class="navitem" href="doctor.html">doctor</a>
41
+ <a class="navitem" href="migrate-state.html">migrate-state</a>
42
+ <a class="navitem" href="web.html">web</a>
43
+ <a class="navitem" href="topic.html">topic</a>
44
+ <a class="navitem is-active" href="project.html" aria-current="page">project</a>
45
+ <a class="navitem" href="ingest.html">ingest</a>
46
+ <a class="navitem" href="compile.html">compile</a>
47
+ <a class="navitem" href="review.html">review</a>
48
+ <a class="navitem" href="bundle.html">bundle</a>
49
+ <a class="navitem" href="search.html">search</a>
50
+ <a class="navitem" href="query.html">query</a>
51
+ <a class="navitem" href="answer.html">answer</a>
52
+ <a class="navitem" href="agent.html">agent</a>
53
+ <a class="navitem" href="mcp.html">mcp</a>
54
+ <a class="navitem" href="plugin.html">plugin</a>
55
+ <a class="navitem" href="image.html">image</a>
56
+ </nav>
57
+ </aside>
58
+ <div class="content">
59
+ <div class="content__inner">
60
+ <article class="card card__pad prose">
61
+ <h1>project</h1>
62
+ <p>Create and manage project knowledge spaces inside a vault. Projects are the sibling of topics: same CRUD surface, used when knowledge is scoped to a product or effort rather than a subject area. Like topics, project commands never list vaults — only the saved default and <code>--vault</code> select which vault to use.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon project create &lt;title&gt; [--description &lt;text&gt;] [--vault &lt;path&gt;]
65
+ sheldon project list [--vault &lt;path&gt;]
66
+ sheldon project show &lt;slug&gt; [--vault &lt;path&gt;]
67
+ sheldon project rename &lt;slug&gt; &lt;title&gt; [--vault &lt;path&gt;]
68
+ sheldon project archive &lt;slug&gt; [--vault &lt;path&gt;]
69
+ </code></pre>
70
+ <h2>Important flags / arguments</h2>
71
+ <ul>
72
+ <li><code>title</code> — human-readable name; <code>create</code> / <code>rename</code> derive the slug from it.</li>
73
+ <li><code>slug</code> — stable id used by ingest, compile, review, search, and query with <code>kind=project</code>.</li>
74
+ <li><code>--description &lt;text&gt;</code> — optional description on create.</li>
75
+ <li><code>--vault &lt;path&gt;</code> — explicit vault path when needed.</li>
76
+ </ul>
77
+ <h2>Examples</h2>
78
+ <p>PowerShell:</p>
79
+ <pre><code class="language-powershell">sheldon project create &quot;Sheldon CLI&quot; --description &quot;CLI product notes&quot; --vault C:\knowledge\sheldon
80
+ sheldon project list --vault C:\knowledge\sheldon
81
+ </code></pre>
82
+ <p>Unix:</p>
83
+ <pre><code class="language-sh">sheldon project create &quot;Sheldon CLI&quot; --description &quot;CLI product notes&quot; --vault ~/knowledge/sheldon
84
+ sheldon project list --vault ~/knowledge/sheldon
85
+ </code></pre>
86
+ <p>Show, rename, archive (portable):</p>
87
+ <pre><code class="language-sh">sheldon project show sheldon-cli
88
+ sheldon project rename sheldon-cli &quot;Sheldon Desktop&quot;
89
+ sheldon project archive sheldon-desktop
90
+ </code></pre>
91
+ <h2>Expected outputs / artifacts</h2>
92
+ <ul>
93
+ <li><code>create</code> — prints project metadata (including slug) and creates the project directory layout.</li>
94
+ <li><code>list</code> / <code>show</code> — JSON of project metadata.</li>
95
+ <li><code>rename</code> / <code>archive</code> — update metadata without deleting knowledge files.</li>
96
+ </ul>
97
+ <h2>Common failures</h2>
98
+ <ul>
99
+ <li>No configured vault — pass <code>--vault &lt;path&gt;</code> or run <code>sheldon init</code>. Sheldon does <strong>not</strong> list vaults.</li>
100
+ <li>Slug collision or unknown slug — use <code>project list</code> and adjust the title/slug.</li>
101
+ <li>Wrong kind later in ingest/compile — pass <code>project</code> (not <code>topic</code>) with this slug.</li>
102
+ </ul>
103
+ <p>Related: <a href="topic.html">topic</a>, <a href="ingest.html">ingest</a>.</p>
104
+ </article>
105
+ </div>
106
+ </div>
107
+ </div>
108
+ </div>
109
+ </body>
110
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/query.html ADDED
@@ -0,0 +1,110 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>query</title>
7
+ <link rel="stylesheet" href="../styles.css">
8
+ </head>
9
+ <body>
10
+ <div class="win">
11
+ <header class="titlebar">
12
+ <div class="titlebar__brand">
13
+ <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
14
+ <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
15
+ <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
16
+ <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
17
+ <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
18
+ <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
19
+ </svg>
20
+ <span class="titlebar__title">sheldon</span>
21
+ </div>
22
+ <span class="titlebar__sep"></span>
23
+ <span class="titlebar__meta">Ajuda offline</span>
24
+ </header>
25
+ <div class="appbody">
26
+ <aside class="sidebar">
27
+ <p class="sidebar__label">Início</p>
28
+ <nav class="sidebar__nav">
29
+ <a class="navitem" href="../index.html">Ajuda</a>
30
+ </nav>
31
+ <p class="sidebar__label">Fluxos</p>
32
+ <nav class="sidebar__nav">
33
+ <a class="navitem" href="flow-first-vault.html">First vault</a>
34
+ <a class="navitem" href="flow-compile-review.html">Compile then review</a>
35
+ <a class="navitem" href="flow-end-to-end.html">End-to-end</a>
36
+ </nav>
37
+ <p class="sidebar__label">Comandos</p>
38
+ <nav class="sidebar__nav">
39
+ <a class="navitem" href="init.html">init</a>
40
+ <a class="navitem" href="doctor.html">doctor</a>
41
+ <a class="navitem" href="migrate-state.html">migrate-state</a>
42
+ <a class="navitem" href="web.html">web</a>
43
+ <a class="navitem" href="topic.html">topic</a>
44
+ <a class="navitem" href="project.html">project</a>
45
+ <a class="navitem" href="ingest.html">ingest</a>
46
+ <a class="navitem" href="compile.html">compile</a>
47
+ <a class="navitem" href="review.html">review</a>
48
+ <a class="navitem" href="bundle.html">bundle</a>
49
+ <a class="navitem" href="search.html">search</a>
50
+ <a class="navitem is-active" href="query.html" aria-current="page">query</a>
51
+ <a class="navitem" href="answer.html">answer</a>
52
+ <a class="navitem" href="agent.html">agent</a>
53
+ <a class="navitem" href="mcp.html">mcp</a>
54
+ <a class="navitem" href="plugin.html">plugin</a>
55
+ <a class="navitem" href="image.html">image</a>
56
+ </nav>
57
+ </aside>
58
+ <div class="content">
59
+ <div class="content__inner">
60
+ <article class="card card__pad prose">
61
+ <h1>query</h1>
62
+ <p>Ask an agent a cited question using approved indexed knowledge. Query selects context from the local index first, then runs Codex, Claude, or Grok; it saves the answer without modifying wiki files.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon query &lt;kind&gt; &lt;slug&gt; &lt;answer-id&gt; --question &lt;text&gt; --agent &lt;agent&gt; [--link-depth &lt;0-2&gt;] [--max-context-chars &lt;n&gt;] [--rebuild] [--vault &lt;path&gt;]
65
+ </code></pre>
66
+ <p><code>kind</code> is <code>topic</code> or <code>project</code>. Agents: <code>codex</code>, <code>claude</code>, or <code>grok</code>.</p>
67
+ <h2>Important flags / arguments</h2>
68
+ <ul>
69
+ <li><code>answer-id</code> — id used when saving the answer under the entity.</li>
70
+ <li><code>--question &lt;text&gt;</code> — required question answered from indexed wiki context.</li>
71
+ <li><code>--agent &lt;agent&gt;</code> — agent that writes the cited answer.</li>
72
+ <li><code>--link-depth &lt;depth&gt;</code> — maximum local wiki-link expansion (0–2; default 1).</li>
73
+ <li><code>--max-context-chars &lt;n&gt;</code> — maximum characters of selected concept records (1000–200000; default 24000).</li>
74
+ <li><code>--rebuild</code> — rebuild the disposable local index before selecting context.</li>
75
+ <li><code>--vault &lt;path&gt;</code> — explicit vault path when needed.</li>
76
+ </ul>
77
+ <h2>Examples</h2>
78
+ <p>PowerShell:</p>
79
+ <pre><code class="language-powershell">sheldon query topic learning answer-retrieval `
80
+ --question &quot;What does this vault say about retrieval practice?&quot; `
81
+ --agent codex `
82
+ --vault C:\knowledge\sheldon
83
+ </code></pre>
84
+ <p>Unix:</p>
85
+ <pre><code class="language-sh">sheldon query topic learning answer-retrieval \
86
+ --question &quot;What does this vault say about retrieval practice?&quot; \
87
+ --agent codex \
88
+ --vault ~/knowledge/sheldon
89
+ </code></pre>
90
+ <h2>Expected outputs / artifacts</h2>
91
+ <ul>
92
+ <li>Prints the saved answer JSON (question, citations, gaps, final text).</li>
93
+ <li>Writes <code>outputs/answers/&lt;answer-id&gt;/answer.json</code> under the entity.</li>
94
+ <li>Does not change <code>wiki/</code>; durable write-back goes through <a href="answer.html">answer</a> promote → <a href="review.html">review</a>.</li>
95
+ </ul>
96
+ <h2>Common failures</h2>
97
+ <ul>
98
+ <li>Agent not installed or not logged in — run <code>sheldon agent doctor</code> and authenticate the chosen agent.</li>
99
+ <li>Thin or empty index — approve wiki notes first; use <code>--rebuild</code> if needed.</li>
100
+ <li>No configured vault — pass <code>--vault &lt;path&gt;</code> or run <code>sheldon init</code>.</li>
101
+ <li>Explicit coverage gaps — the command may save an uncovered answer with gap notes instead of inventing wiki facts.</li>
102
+ </ul>
103
+ <p>Promote a durable synthesis with <a href="answer.html">answer</a>.</p>
104
+ </article>
105
+ </div>
106
+ </div>
107
+ </div>
108
+ </div>
109
+ </body>
110
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/review.html ADDED
@@ -0,0 +1,114 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>review</title>
7
+ <link rel="stylesheet" href="../styles.css">
8
+ </head>
9
+ <body>
10
+ <div class="win">
11
+ <header class="titlebar">
12
+ <div class="titlebar__brand">
13
+ <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
14
+ <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
15
+ <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
16
+ <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
17
+ <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
18
+ <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
19
+ </svg>
20
+ <span class="titlebar__title">sheldon</span>
21
+ </div>
22
+ <span class="titlebar__sep"></span>
23
+ <span class="titlebar__meta">Ajuda offline</span>
24
+ </header>
25
+ <div class="appbody">
26
+ <aside class="sidebar">
27
+ <p class="sidebar__label">Início</p>
28
+ <nav class="sidebar__nav">
29
+ <a class="navitem" href="../index.html">Ajuda</a>
30
+ </nav>
31
+ <p class="sidebar__label">Fluxos</p>
32
+ <nav class="sidebar__nav">
33
+ <a class="navitem" href="flow-first-vault.html">First vault</a>
34
+ <a class="navitem" href="flow-compile-review.html">Compile then review</a>
35
+ <a class="navitem" href="flow-end-to-end.html">End-to-end</a>
36
+ </nav>
37
+ <p class="sidebar__label">Comandos</p>
38
+ <nav class="sidebar__nav">
39
+ <a class="navitem" href="init.html">init</a>
40
+ <a class="navitem" href="doctor.html">doctor</a>
41
+ <a class="navitem" href="migrate-state.html">migrate-state</a>
42
+ <a class="navitem" href="web.html">web</a>
43
+ <a class="navitem" href="topic.html">topic</a>
44
+ <a class="navitem" href="project.html">project</a>
45
+ <a class="navitem" href="ingest.html">ingest</a>
46
+ <a class="navitem" href="compile.html">compile</a>
47
+ <a class="navitem is-active" href="review.html" aria-current="page">review</a>
48
+ <a class="navitem" href="bundle.html">bundle</a>
49
+ <a class="navitem" href="search.html">search</a>
50
+ <a class="navitem" href="query.html">query</a>
51
+ <a class="navitem" href="answer.html">answer</a>
52
+ <a class="navitem" href="agent.html">agent</a>
53
+ <a class="navitem" href="mcp.html">mcp</a>
54
+ <a class="navitem" href="plugin.html">plugin</a>
55
+ <a class="navitem" href="image.html">image</a>
56
+ </nav>
57
+ </aside>
58
+ <div class="content">
59
+ <div class="content__inner">
60
+ <article class="card card__pad prose">
61
+ <h1>review</h1>
62
+ <p>Preview, approve, reject, and lint proposed wiki changes. Review is the only path that applies selected proposal files into the approved wiki; ingest and compile never publish wiki notes on their own.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon review preview &lt;kind&gt; &lt;slug&gt; &lt;proposal-id&gt; [--vault &lt;path&gt;]
65
+ sheldon review approve &lt;kind&gt; &lt;slug&gt; &lt;proposal-id&gt; &lt;paths...&gt; [--vault &lt;path&gt;]
66
+ sheldon review reject &lt;kind&gt; &lt;slug&gt; &lt;proposal-id&gt; --reason &lt;text&gt; [--vault &lt;path&gt;]
67
+ sheldon review lint &lt;kind&gt; &lt;slug&gt; [--vault &lt;path&gt;]
68
+ </code></pre>
69
+ <p><code>kind</code> is <code>topic</code> or <code>project</code>.</p>
70
+ <h2>Important flags / arguments</h2>
71
+ <ul>
72
+ <li><code>proposal-id</code> — proposal produced by <code>compile</code>, <code>compile-retry</code>, or <code>answer promote</code>.</li>
73
+ <li><code>paths...</code> — (<code>approve</code>) one or more proposal file paths to apply (for example <code>wiki/practical-ideas.md</code>).</li>
74
+ <li><code>--reason &lt;text&gt;</code> — (<code>reject</code>) required non-empty rejection reason.</li>
75
+ <li><code>--vault &lt;path&gt;</code> — explicit vault path when needed.</li>
76
+ </ul>
77
+ <h2>Examples</h2>
78
+ <p>PowerShell:</p>
79
+ <pre><code class="language-powershell">sheldon review preview topic learning proposal-article --vault C:\knowledge\sheldon
80
+ sheldon review approve topic learning proposal-article wiki/practical-ideas.md `
81
+ --vault C:\knowledge\sheldon
82
+ </code></pre>
83
+ <p>Unix:</p>
84
+ <pre><code class="language-sh">sheldon review preview topic learning proposal-article --vault ~/knowledge/sheldon
85
+ sheldon review approve topic learning proposal-article wiki/practical-ideas.md \
86
+ --vault ~/knowledge/sheldon
87
+ </code></pre>
88
+ <p>Reject or lint (portable):</p>
89
+ <pre><code class="language-sh">sheldon review reject topic learning proposal-article --reason &quot;Too broad; retry with a narrower prompt.&quot;
90
+ sheldon review lint topic learning
91
+ </code></pre>
92
+ <h2>Expected outputs / artifacts</h2>
93
+ <ul>
94
+ <li><code>preview</code> — JSON listing proposed file changes without writing wiki.</li>
95
+ <li><code>approve</code> — applies only the selected paths into <code>wiki/</code> and prints the approval result JSON.</li>
96
+ <li><code>reject</code> — records rejection metadata for the proposal; further approve attempts fail.</li>
97
+ <li><code>lint</code> — JSON report of approved wiki structure, links, and sources.</li>
98
+ </ul>
99
+ <p>Proposal files live under <code>outputs/proposals/&lt;proposal-id&gt;/</code>.</p>
100
+ <h2>Common failures</h2>
101
+ <ul>
102
+ <li>Proposal missing or already rejected — compile a new attempt (<code>compile</code> / <code>compile-retry</code>) or pick another id.</li>
103
+ <li>Path not in the proposal — preview first, then approve exact paths from that listing.</li>
104
+ <li>No configured vault — pass <code>--vault &lt;path&gt;</code> or run <code>sheldon init</code>.</li>
105
+ <li>Empty <code>--reason</code> on reject — supply a non-empty reason.</li>
106
+ </ul>
107
+ <p>See <a href="flow-compile-review.html">Compile then review</a> for the end-to-end raw → approve path.</p>
108
+ </article>
109
+ </div>
110
+ </div>
111
+ </div>
112
+ </div>
113
+ </body>
114
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/search.html ADDED
@@ -0,0 +1,103 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>search</title>
7
+ <link rel="stylesheet" href="../styles.css">
8
+ </head>
9
+ <body>
10
+ <div class="win">
11
+ <header class="titlebar">
12
+ <div class="titlebar__brand">
13
+ <svg class="eq-logo" viewBox="0 0 28 18" width="28" height="18" aria-hidden="true">
14
+ <rect x="0" y="6" width="3.2" height="12" rx="1.6" fill="var(--eq-1)"/>
15
+ <rect x="6" y="2" width="3.2" height="16" rx="1.6" fill="var(--eq-2)"/>
16
+ <rect x="12" y="4" width="3.2" height="14" rx="1.6" fill="var(--eq-3)"/>
17
+ <rect x="18" y="0" width="3.2" height="18" rx="1.6" fill="var(--eq-4)"/>
18
+ <rect x="24" y="7" width="3.2" height="11" rx="1.6" fill="var(--eq-5)"/>
19
+ </svg>
20
+ <span class="titlebar__title">sheldon</span>
21
+ </div>
22
+ <span class="titlebar__sep"></span>
23
+ <span class="titlebar__meta">Ajuda offline</span>
24
+ </header>
25
+ <div class="appbody">
26
+ <aside class="sidebar">
27
+ <p class="sidebar__label">Início</p>
28
+ <nav class="sidebar__nav">
29
+ <a class="navitem" href="../index.html">Ajuda</a>
30
+ </nav>
31
+ <p class="sidebar__label">Fluxos</p>
32
+ <nav class="sidebar__nav">
33
+ <a class="navitem" href="flow-first-vault.html">First vault</a>
34
+ <a class="navitem" href="flow-compile-review.html">Compile then review</a>
35
+ <a class="navitem" href="flow-end-to-end.html">End-to-end</a>
36
+ </nav>
37
+ <p class="sidebar__label">Comandos</p>
38
+ <nav class="sidebar__nav">
39
+ <a class="navitem" href="init.html">init</a>
40
+ <a class="navitem" href="doctor.html">doctor</a>
41
+ <a class="navitem" href="migrate-state.html">migrate-state</a>
42
+ <a class="navitem" href="web.html">web</a>
43
+ <a class="navitem" href="topic.html">topic</a>
44
+ <a class="navitem" href="project.html">project</a>
45
+ <a class="navitem" href="ingest.html">ingest</a>
46
+ <a class="navitem" href="compile.html">compile</a>
47
+ <a class="navitem" href="review.html">review</a>
48
+ <a class="navitem" href="bundle.html">bundle</a>
49
+ <a class="navitem is-active" href="search.html" aria-current="page">search</a>
50
+ <a class="navitem" href="query.html">query</a>
51
+ <a class="navitem" href="answer.html">answer</a>
52
+ <a class="navitem" href="agent.html">agent</a>
53
+ <a class="navitem" href="mcp.html">mcp</a>
54
+ <a class="navitem" href="plugin.html">plugin</a>
55
+ <a class="navitem" href="image.html">image</a>
56
+ </nav>
57
+ </aside>
58
+ <div class="content">
59
+ <div class="content__inner">
60
+ <article class="card card__pad prose">
61
+ <h1>search</h1>
62
+ <p>Search approved wiki concepts in the disposable local index. Search is lexical and filterable; it does not call an agent and does not modify the vault.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon search &lt;query&gt; [--topic &lt;slug&gt;] [--project &lt;slug&gt;] [--type &lt;type&gt;] [--tag &lt;tag&gt;] [--status &lt;status&gt;] [--updated-after &lt;timestamp&gt;] [--updated-before &lt;timestamp&gt;] [--rebuild] [--vault &lt;path&gt;]
65
+ </code></pre>
66
+ <h2>Important flags / arguments</h2>
67
+ <ul>
68
+ <li><code>query</code> — search text matched against indexed concept fields.</li>
69
+ <li><code>--topic</code> / <code>--project</code> — restrict results to one knowledge space.</li>
70
+ <li><code>--type</code> / <code>--tag</code> / <code>--status</code> — metadata filters.</li>
71
+ <li><code>--updated-after</code> / <code>--updated-before</code> — ISO-8601 instant bounds on concept updates.</li>
72
+ <li><code>--rebuild</code> — rebuild the disposable local index before searching.</li>
73
+ <li><code>--vault &lt;path&gt;</code> — explicit vault path when needed.</li>
74
+ </ul>
75
+ <h2>Examples</h2>
76
+ <p>PowerShell:</p>
77
+ <pre><code class="language-powershell">sheldon search &quot;retrieval practice&quot; --topic learning --vault C:\knowledge\sheldon
78
+ </code></pre>
79
+ <p>Unix:</p>
80
+ <pre><code class="language-sh">sheldon search &quot;retrieval practice&quot; --topic learning --vault ~/knowledge/sheldon
81
+ </code></pre>
82
+ <p>Rebuild then search (portable):</p>
83
+ <pre><code class="language-sh">sheldon search &quot;spaced repetition&quot; --rebuild
84
+ </code></pre>
85
+ <h2>Expected outputs / artifacts</h2>
86
+ <ul>
87
+ <li>Prints JSON search hits (snippets, scores, related concepts) to stdout.</li>
88
+ <li>May create or refresh the disposable SQLite search index under the vault; that index is rebuildable and is not the source of truth.</li>
89
+ </ul>
90
+ <h2>Common failures</h2>
91
+ <ul>
92
+ <li>Empty or unexpected results — approve wiki content first; try <code>--rebuild</code> if the index is stale.</li>
93
+ <li>No configured vault — pass <code>--vault &lt;path&gt;</code> or run <code>sheldon init</code>.</li>
94
+ <li>Filters too narrow — drop <code>--topic</code> / <code>--tag</code> / date bounds and broaden the query.</li>
95
+ </ul>
96
+ <p>For agent-cited answers over the same index, see <a href="query.html">query</a>.</p>
97
+ </article>
98
+ </div>
99
+ </div>
100
+ </div>
101
+ </div>
102
+ </body>
103
+ </html>