@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/image.html ADDED
@@ -0,0 +1,107 @@
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>image</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" href="plugin.html">plugin</a>
55
+ <a class="navitem is-active" href="image.html" aria-current="page">image</a>
56
+ </nav>
57
+ </aside>
58
+ <div class="content">
59
+ <div class="content__inner">
60
+ <article class="card card__pad prose">
61
+ <h1>image</h1>
62
+ <p>Manage extra OCR language data used by <code>source.image</code>. Install that plugin first. Base packs <code>por</code> and <code>eng</code> ship with the plugin and cannot be removed. Extra codes such as <code>deu</code> come from the official catalog and are stored outside the vault. The official catalog publishes <code>source.image</code> (and its extra language packs) for Windows x64 and Linux x64 only.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon image language list
65
+ sheldon image language install &lt;code&gt;
66
+ sheldon image language remove &lt;code&gt;
67
+ </code></pre>
68
+ <h2>Important flags / arguments</h2>
69
+ <ul>
70
+ <li>Install <code>source.image</code> first — <code>list</code>, <code>install</code>, and <code>remove</code> all look up that installed plugin.</li>
71
+ <li><code>code</code> — extra OCR language code to install or remove (for example <code>deu</code>). Never pass <code>eng</code> or <code>por</code> to <code>remove</code>.</li>
72
+ <li><code>list</code> is local: base <code>por</code> / <code>eng</code> plus extras already on the installed plugin root. It does not print the remote catalog.</li>
73
+ </ul>
74
+ <h2>Examples</h2>
75
+ <p>Install the plugin, then list local languages (portable):</p>
76
+ <pre><code class="language-sh">sheldon plugin install source.image
77
+ sheldon image language list
78
+ </code></pre>
79
+ <p>Install and remove an extra language pack (portable):</p>
80
+ <pre><code class="language-sh">sheldon image language install deu
81
+ sheldon image language remove deu
82
+ </code></pre>
83
+ <p>Local image files use <code>sheldon ingest file … --plugin source.image</code> (the plugin runs OCR). <code>ingest file</code> has no <code>--ocr</code> flag. URL ingest can add <code>--media images --ocr</code> when <code>source.image</code> is installed.</p>
84
+ <h2>Expected outputs / artifacts</h2>
85
+ <ul>
86
+ <li><code>list</code> — local codes only: <code>por</code> and <code>eng</code> as <code>base</code>, plus extras from the installed plugin root (not the remote catalog).</li>
87
+ <li><code>install</code> — downloads a catalog extra language into the local image/OCR store.</li>
88
+ <li><code>remove</code> — deletes an extra installed language pack from that store (<code>deu</code>; not <code>eng</code> or <code>por</code>).</li>
89
+ <li>Does not modify vault <code>raw/</code> or <code>wiki/</code> contents by itself.</li>
90
+ </ul>
91
+ <h2>Common failures</h2>
92
+ <ul>
93
+ <li><code>source.image</code> not installed — <code>sheldon plugin install source.image</code>, then retry. On macOS the official catalog marks this plugin <code>platform unavailable</code>.</li>
94
+ <li>Language not in catalog / signature failure — retry when online; do not bypass catalog verification.</li>
95
+ <li>Removing <code>eng</code> or <code>por</code> — those are base packs; use an extra code such as <code>deu</code>.</li>
96
+ <li>OCR ingest fails with language-not-installed — run <code>sheldon image language install &lt;code&gt;</code> for every extra required code.</li>
97
+ <li><code>source.image</code> unhealthy — run <code>sheldon plugin doctor source.image</code> after installing the plugin.</li>
98
+ <li>Confusing language packs with vaults — language data is application state; knowledge still lives in the vault from <code>init</code> / <code>--vault</code>. Sheldon does <strong>not</strong> list vaults.</li>
99
+ </ul>
100
+ <p>Related: <a href="plugin.html">plugin</a>, <a href="ingest.html">ingest</a>.</p>
101
+ </article>
102
+ </div>
103
+ </div>
104
+ </div>
105
+ </div>
106
+ </body>
107
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/ingest.html ADDED
@@ -0,0 +1,156 @@
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>ingest</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 is-active" href="ingest.html" aria-current="page">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>ingest</h1>
62
+ <p>Capture sources into immutable local raw records under a topic or project. Ingestion never changes the approved wiki — it only publishes originals and normalized content for later compile and review. Source connectors are plugins; install the ones you need before ingesting.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon ingest file &lt;kind&gt; &lt;slug&gt; &lt;file&gt; [--plugin &lt;id&gt;] [--vault &lt;path&gt;]
65
+ sheldon ingest url &lt;kind&gt; &lt;slug&gt; &lt;url&gt; [--plugin &lt;id&gt;] [--language &lt;tags&gt;] [--cookies &lt;path&gt;] [--media &lt;mode&gt;] [--ocr] [--stt] [--vault &lt;path&gt;]
66
+ sheldon ingest crawl &lt;kind&gt; &lt;slug&gt; &lt;seed-url&gt; --max-pages &lt;1-10&gt; --max-depth &lt;0-2&gt; [--plugin &lt;id&gt;] [--vault &lt;path&gt;]
67
+ sheldon ingest repository &lt;kind&gt; &lt;slug&gt; &lt;directory&gt; [--plugin &lt;id&gt;] [--vault &lt;path&gt;]
68
+ </code></pre>
69
+ <p><code>kind</code> is <code>topic</code> or <code>project</code>. <code>slug</code> identifies the knowledge space inside the vault.</p>
70
+ <h2>Important flags / arguments</h2>
71
+ <ul>
72
+ <li><code>file</code> / <code>url</code> / <code>seed-url</code> / <code>directory</code> — the source to capture.</li>
73
+ <li><code>--plugin &lt;id&gt;</code> — force a specific ingestion plugin when more than one matches (or to override auto-selection).</li>
74
+ <li><code>--max-pages</code> / <code>--max-depth</code> — required bounds for <code>ingest crawl</code> (pages 1–10, depth 0–2).</li>
75
+ <li><code>--language &lt;tags&gt;</code> — preferred comma-separated language tags for URL capture.</li>
76
+ <li><code>--cookies &lt;path&gt;</code> — optional local cookie file for URL ingest (never stored in the vault).</li>
77
+ <li><code>--media &lt;mode&gt;</code> — social media capture: <code>none</code>, <code>thumbnail</code>, or <code>images</code>.</li>
78
+ <li><code>--ocr</code> — (<code>ingest url</code> only) derive local OCR from downloaded image assets; requires <code>--media images</code> and installed <code>source.image</code>. <code>ingest file</code> has no <code>--ocr</code> flag.</li>
79
+ <li><code>--stt</code> — (<code>ingest url</code> only) allow an already-installed local speech-to-text runtime (may download temporary audio).</li>
80
+ <li><code>--vault &lt;path&gt;</code> — explicit vault path when the saved default is wrong or missing.</li>
81
+ </ul>
82
+ <h2>Examples</h2>
83
+ <p>List and install connectors first:</p>
84
+ <pre><code class="language-powershell">sheldon plugin list
85
+ sheldon plugin list --remote
86
+ sheldon plugin install source.file
87
+ sheldon plugin install source.image
88
+ sheldon plugin install source.url
89
+ sheldon plugin install source.youtube
90
+ sheldon plugin install source.instagram
91
+ sheldon plugin install source.linkedin
92
+ sheldon plugin install source.repository
93
+ </code></pre>
94
+ <p>On macOS the official catalog does not ship <code>source.image</code>, <code>source.youtube</code>, or <code>source.instagram</code>. <code>plugin list --remote</code> shows <code>platform unavailable</code> for those ids; install <code>source.file</code>, <code>source.url</code>, <code>source.linkedin</code>, or <code>source.repository</code> from the catalog. Image, YouTube, and Instagram capture remain available from the catalog on Windows and Linux.</p>
95
+ <p>PowerShell — local file:</p>
96
+ <pre><code class="language-powershell">sheldon ingest file topic learning C:\inbox\article.pdf --vault C:\knowledge\sheldon
97
+ </code></pre>
98
+ <p>Unix — local file:</p>
99
+ <pre><code class="language-sh">sheldon ingest file topic learning ~/inbox/article.pdf --vault ~/knowledge/sheldon
100
+ </code></pre>
101
+ <p>PowerShell — local image file (OCR via <code>source.image</code>):</p>
102
+ <pre><code class="language-powershell">sheldon ingest file topic learning C:\inbox\scan.png --plugin source.image --vault C:\knowledge\sheldon
103
+ </code></pre>
104
+ <p>Unix — local image file (OCR via <code>source.image</code>):</p>
105
+ <pre><code class="language-sh">sheldon ingest file topic learning ~/inbox/scan.png --plugin source.image --vault ~/knowledge/sheldon
106
+ </code></pre>
107
+ <p>PowerShell — public URL:</p>
108
+ <pre><code class="language-powershell">sheldon ingest url topic learning https://example.com/article --vault C:\knowledge\sheldon
109
+ </code></pre>
110
+ <p>Unix — public URL:</p>
111
+ <pre><code class="language-sh">sheldon ingest url topic learning https://example.com/article --vault ~/knowledge/sheldon
112
+ </code></pre>
113
+ <p>PowerShell — YouTube video (<code>source.youtube</code>, caption language preference):</p>
114
+ <pre><code class="language-powershell">sheldon ingest url topic learning https://www.youtube.com/watch?v=xxxxxxxxxxx --plugin source.youtube --language pt,en --vault C:\knowledge\sheldon
115
+ </code></pre>
116
+ <p>Unix — YouTube video:</p>
117
+ <pre><code class="language-sh">sheldon ingest url topic learning https://www.youtube.com/watch?v=xxxxxxxxxxx --plugin source.youtube --language pt,en --vault ~/knowledge/sheldon
118
+ </code></pre>
119
+ <p>PowerShell — Instagram Reel (<code>source.instagram</code>; cookies, media; add <code>--stt</code> only when a local speech runtime is already installed):</p>
120
+ <pre><code class="language-powershell">sheldon ingest url topic learning https://www.instagram.com/reel/SHORTCODE/ --plugin source.instagram --cookies C:\secrets\instagram-cookies.txt --media thumbnail --vault C:\knowledge\sheldon
121
+ </code></pre>
122
+ <p>Unix — Instagram Reel:</p>
123
+ <pre><code class="language-sh">sheldon ingest url topic learning https://www.instagram.com/reel/SHORTCODE/ --plugin source.instagram --cookies ~/secrets/instagram-cookies.txt --media thumbnail --vault ~/knowledge/sheldon
124
+ </code></pre>
125
+ <p>Bounded crawl (portable):</p>
126
+ <pre><code class="language-sh">sheldon ingest crawl topic learning https://example.com/docs --max-pages 5 --max-depth 1
127
+ </code></pre>
128
+ <p>Local Git repository snapshot:</p>
129
+ <p>PowerShell:</p>
130
+ <pre><code class="language-powershell">sheldon ingest repository topic learning C:\src\my-repo --vault C:\knowledge\sheldon
131
+ </code></pre>
132
+ <p>Unix:</p>
133
+ <pre><code class="language-sh">sheldon ingest repository topic learning ~/src/my-repo --vault ~/knowledge/sheldon
134
+ </code></pre>
135
+ <h2>Expected outputs / artifacts</h2>
136
+ <ul>
137
+ <li>Prints JSON describing the published source (including source id and normalized paths).</li>
138
+ <li>Writes immutable capture under the entity: <code>raw/&lt;source-id&gt;/</code> (original plus normalized content such as <code>content.md</code>).</li>
139
+ <li>Does not create proposals or modify <code>wiki/</code>.</li>
140
+ </ul>
141
+ <h2>Common failures</h2>
142
+ <ul>
143
+ <li>Required plugin not installed — run <code>sheldon plugin list --remote</code>, then <code>sheldon plugin install &lt;id&gt;</code> (for example <code>source.file</code>, <code>source.image</code>, <code>source.url</code>, <code>source.youtube</code>, <code>source.instagram</code>, <code>source.linkedin</code>, or <code>source.repository</code>). On macOS, <code>source.image</code>, <code>source.youtube</code>, and <code>source.instagram</code> are <code>platform unavailable</code> in the official catalog.</li>
144
+ <li>Ambiguous plugin selection — retry with <code>--plugin &lt;id&gt;</code> using one of the listed candidates.</li>
145
+ <li>No configured vault — pass <code>--vault &lt;path&gt;</code> or run <code>sheldon init</code>.</li>
146
+ <li>Unreadable input path / invalid URL / dirty Git working tree (repository) — fix the input and retry.</li>
147
+ <li>Topic or project slug missing — create it with <code>sheldon topic create</code> / <code>sheldon project create</code> first.</li>
148
+ </ul>
149
+ <p>See <a href="flow-compile-review.html">Compile then review</a> for turning raws into approved wiki notes.</p>
150
+ </article>
151
+ </div>
152
+ </div>
153
+ </div>
154
+ </div>
155
+ </body>
156
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/init.html ADDED
@@ -0,0 +1,98 @@
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>init</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 is-active" href="init.html" aria-current="page">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" 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>init</h1>
62
+ <p>Create a Sheldon vault and save it as the local default for later commands.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon init [path] [--yes]
65
+ </code></pre>
66
+ <h2>Arguments and flags</h2>
67
+ <ul>
68
+ <li><code>path</code> — optional vault directory. When omitted, Sheldon proposes <code>~/Documents/Sheldon</code> and asks for confirmation.</li>
69
+ <li><code>--yes</code> — accept the proposed default path without a prompt (useful in scripts).</li>
70
+ </ul>
71
+ <h2>Examples</h2>
72
+ <p>PowerShell:</p>
73
+ <pre><code class="language-powershell">sheldon init C:\knowledge\sheldon
74
+ sheldon init --yes
75
+ </code></pre>
76
+ <p>Unix:</p>
77
+ <pre><code class="language-sh">sheldon init ~/knowledge/sheldon
78
+ sheldon init --yes
79
+ </code></pre>
80
+ <h2>Expected result</h2>
81
+ <ul>
82
+ <li>Creates the vault layout at the chosen path.</li>
83
+ <li>Writes the local config so later commands can omit <code>--vault</code>.</li>
84
+ <li>Prints <code>Vault initialized: &lt;path&gt;</code>.</li>
85
+ </ul>
86
+ <h2>Common failures</h2>
87
+ <ul>
88
+ <li>Path already contains a vault or conflicting files — choose a new directory or clean the target.</li>
89
+ <li>Confirmation declined when <code>path</code> is omitted and <code>--yes</code> is not set — re-run with an explicit path or <code>--yes</code>.</li>
90
+ </ul>
91
+ <p>Sheldon does <strong>not</strong> list vaults. After <code>init</code>, either rely on the saved default or pass <code>--vault</code> explicitly. See <a href="flow-first-vault.html">First vault</a>.</p>
92
+ </article>
93
+ </div>
94
+ </div>
95
+ </div>
96
+ </div>
97
+ </body>
98
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/mcp.html ADDED
@@ -0,0 +1,135 @@
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>mcp</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 is-active" href="mcp.html" aria-current="page">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>mcp</h1>
62
+ <p>Configure local, scoped MCP knowledge access for a consumer project. MCP uses stdio and explicit topic/project scopes — it does not open network listeners or grant whole-vault access by default.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon mcp configure &lt;consumer&gt; --vault &lt;path&gt; --consumer-id &lt;id&gt; --scope &lt;kind:slug...&gt; [--bundle &lt;path&gt;] [--apply]
65
+ sheldon mcp install-skill &lt;consumer&gt; [--agent &lt;agent&gt;] [--apply]
66
+ sheldon mcp doctor --consumer &lt;path&gt;
67
+ sheldon mcp serve --consumer-config &lt;path&gt;
68
+ </code></pre>
69
+ <h2>Important flags / arguments</h2>
70
+ <ul>
71
+ <li><code>consumer</code> — path to the consumer project directory.</li>
72
+ <li><code>--vault &lt;path&gt;</code> — (<code>configure</code>) absolute Sheldon vault path (required).</li>
73
+ <li><code>--consumer-id &lt;id&gt;</code> — (<code>configure</code>) stable identity for the consumer project.</li>
74
+ <li><code>--scope &lt;kind:slug...&gt;</code> — (<code>configure</code>) authorized scopes such as <code>topic:learning</code>; repeat as needed.</li>
75
+ <li><code>--bundle &lt;path&gt;</code> — (<code>configure</code>) optional bundle definition relative to <code>vault/bundles</code>.</li>
76
+ <li><code>--apply</code> — (<code>configure</code> / <code>install-skill</code>) write the previewed changes after review.</li>
77
+ <li><code>--agent &lt;agent&gt;</code> — (<code>install-skill</code>) <code>codex</code>, <code>claude</code>, <code>grok</code>, <code>both</code> (Codex+Claude), or <code>all</code>.</li>
78
+ <li><code>--consumer &lt;path&gt;</code> — (<code>doctor</code>) consumer project directory to validate.</li>
79
+ <li><code>--consumer-config &lt;path&gt;</code> — (<code>serve</code>) absolute path to the consumer MCP configuration file.</li>
80
+ </ul>
81
+ <h2>Examples</h2>
82
+ <p>PowerShell — preview then apply MCP config:</p>
83
+ <pre><code class="language-powershell">sheldon mcp configure C:\src\app-consumer `
84
+ --vault C:\knowledge\sheldon `
85
+ --consumer-id app-consumer `
86
+ --scope topic:learning
87
+ sheldon mcp configure C:\src\app-consumer `
88
+ --vault C:\knowledge\sheldon `
89
+ --consumer-id app-consumer `
90
+ --scope topic:learning `
91
+ --apply
92
+ </code></pre>
93
+ <p>Unix:</p>
94
+ <pre><code class="language-sh">sheldon mcp configure ~/src/app-consumer \
95
+ --vault ~/knowledge/sheldon \
96
+ --consumer-id app-consumer \
97
+ --scope topic:learning
98
+ sheldon mcp configure ~/src/app-consumer \
99
+ --vault ~/knowledge/sheldon \
100
+ --consumer-id app-consumer \
101
+ --scope topic:learning \
102
+ --apply
103
+ </code></pre>
104
+ <p>PowerShell — install the Sheldon skill and validate:</p>
105
+ <pre><code class="language-powershell">sheldon mcp install-skill C:\src\app-consumer --agent all --apply
106
+ sheldon mcp doctor --consumer C:\src\app-consumer
107
+ </code></pre>
108
+ <p>Unix:</p>
109
+ <pre><code class="language-sh">sheldon mcp install-skill ~/src/app-consumer --agent all --apply
110
+ sheldon mcp doctor --consumer ~/src/app-consumer
111
+ </code></pre>
112
+ <p><code>mcp serve</code> is normally launched by the agent/MCP host with <code>--consumer-config</code>, not typed by hand.</p>
113
+ <h2>Expected outputs / artifacts</h2>
114
+ <ul>
115
+ <li><code>configure</code> without <code>--apply</code> — prints a preview of local client config changes (for example Codex/Claude/Grok config fragments and <code>.sheldon/mcp.yaml</code>).</li>
116
+ <li><code>configure --apply</code> — writes those local files after the same preview.</li>
117
+ <li><code>install-skill</code> — previews or copies the Sheldon skill into the chosen agent skill directories.</li>
118
+ <li><code>doctor</code> — validates the consumer’s Sheldon MCP configuration.</li>
119
+ <li><code>serve</code> — runs the scoped MCP server over stdio for one consumer.</li>
120
+ </ul>
121
+ <h2>Common failures</h2>
122
+ <ul>
123
+ <li>Missing required <code>--vault</code> / <code>--consumer-id</code> / <code>--scope</code> — pass absolute vault path and at least one <code>kind:slug</code> scope. Sheldon does <strong>not</strong> list vaults.</li>
124
+ <li>Scope slug missing in the vault — create the topic/project first, then reconfigure.</li>
125
+ <li>Preview-only run did nothing on disk — add <code>--apply</code> after reviewing the preview.</li>
126
+ <li>Doctor failures — fix the reported consumer config paths and re-run <code>mcp doctor</code>.</li>
127
+ </ul>
128
+ <p>Related: <a href="bundle.html">bundle</a>, <a href="search.html">search</a>, <a href="agent.html">agent</a>.</p>
129
+ </article>
130
+ </div>
131
+ </div>
132
+ </div>
133
+ </div>
134
+ </body>
135
+ </html>
package/node_modules/@sheldon/cli/dist/help/pages/migrate-state.html ADDED
@@ -0,0 +1,100 @@
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>migrate-state</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 is-active" href="migrate-state.html" aria-current="page">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" 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>migrate-state</h1>
62
+ <p>Copy legacy Sheldon plugin/application state into this platform’s state directory after hash verification. Use this when upgrading from an older layout that kept state under a different application-data path. It does not move or rewrite vault knowledge files.</p>
63
+ <h2>Synopsis</h2>
64
+ <pre><code class="language-text">sheldon migrate-state --from &lt;directory&gt;
65
+ </code></pre>
66
+ <h2>Important flags / arguments</h2>
67
+ <ul>
68
+ <li><code>--from &lt;directory&gt;</code> — required path to the legacy Sheldon application-state directory to copy from.</li>
69
+ <li>Target directory is chosen by the current platform state root (not a vault path).</li>
70
+ </ul>
71
+ <h2>Examples</h2>
72
+ <p>PowerShell:</p>
73
+ <pre><code class="language-powershell">sheldon migrate-state --from &quot;$env:APPDATA\Sheldon&quot;
74
+ </code></pre>
75
+ <p>Unix:</p>
76
+ <pre><code class="language-sh">sheldon migrate-state --from &quot;${XDG_STATE_HOME:-$HOME/.local/state}/sheldon&quot;
77
+ </code></pre>
78
+ <p><code>--from</code> is the actual legacy directory on your machine (not a vault path). Adjust it if your previous install used a different location. Typical current state roots are <code>%APPDATA%\Sheldon</code> on Windows and <code>$XDG_STATE_HOME/sheldon</code> or <code>~/.local/state/sheldon</code> on POSIX.</p>
79
+ <h2>Expected outputs / artifacts</h2>
80
+ <ul>
81
+ <li>Verifies hashes, then copies eligible plugin/application state into the current platform state root.</li>
82
+ <li>Prints <code>Plugin state migrated to: &lt;target&gt;</code>.</li>
83
+ <li>Leaves vault contents (<code>raw/</code>, <code>wiki/</code>, proposals) untouched.</li>
84
+ </ul>
85
+ <h2>Common failures</h2>
86
+ <ul>
87
+ <li><code>--from</code> missing or not a directory — pass the real legacy state path.</li>
88
+ <li>Hash verification failure — stop; do not force a partial copy; restore a known-good legacy state and retry.</li>
89
+ <li>Permission denied on source or target — fix filesystem permissions and re-run.</li>
90
+ <li>Already migrated / empty source — confirm the legacy path before retrying.</li>
91
+ </ul>
92
+ <p>This command is about application state, not vault discovery. Sheldon does <strong>not</strong> list vaults; knowledge stays at the path from <code>init</code> or <code>--vault</code>.</p>
93
+ <p>Related: <a href="doctor.html">doctor</a>, <a href="plugin.html">plugin</a>.</p>
94
+ </article>
95
+ </div>
96
+ </div>
97
+ </div>
98
+ </div>
99
+ </body>
100
+ </html>