@hraness/wordcell 0.25.1 → 0.26.1

package/dist/{index-7drercgk.js → index-9fywek7g.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-h170byqw.js";
 import {
   packUntrustedSearchContext
-} from "./index-mcpppwbq.js";
+} from "./index-9zkba8hr.js";
 
 // src/workflows/decision-context.ts
 var decisionContextWorkflow = defineWorkflow({

package/dist/{index-hz2wyggk.js → index-9paxge84.js}

@@ -5,7 +5,7 @@ import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase,
   validateKnowledgeBaseSearchHistory
-} from "./index-mcpppwbq.js";
+} from "./index-9zkba8hr.js";
 import {
   expandSearchRequest,
   parseSearchRules

package/dist/{index-mcpppwbq.js → index-9zkba8hr.js}

@@ -12,14 +12,9 @@ import {
   UntrustedContentBudgetError,
   createUntrustedToolResult
 } from "./index-4j3tt0c3.js";
-import {
-  MAX_RERANK_CANDIDATES,
-  MAX_RERANK_SNIPPET_BYTES,
-  applyRerank
-} from "./index-j70m75wd.js";
 import {
   percolateWithGraph
-} from "./index-e26mdwxz.js";
+} from "./index-wqx1x32f.js";
 import {
   openGraphAuthority
 } from "./index-3gc2yk4k.js";
@@ -27,6 +22,11 @@ import {
   validateGraphPercolationOptions,
   validateGraphQueryRequest
 } from "./index-pgtm2nhf.js";
+import {
+  MAX_RERANK_CANDIDATES,
+  MAX_RERANK_SNIPPET_BYTES,
+  applyRerank
+} from "./index-j70m75wd.js";
 import {
   GitHistoryError,
   gitHistoryForNotes,

package/dist/{index-59bcxqee.js → index-j2jt49gr.js}

@@ -2,7 +2,7 @@
 import {
   MAX_SEARCH_RESULTS,
   openKnowledgeBase
-} from "./index-mcpppwbq.js";
+} from "./index-9zkba8hr.js";
 import {
   MAX_EVALUATION_EVIDENCE_BYTES,
   redactEvaluationMachinePaths

package/dist/{index-nwrehke7.js → index-nd8v7r0z.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   isolatedAgentBrowserEnvironment
-} from "./index-xwxy71ew.js";
+} from "./index-ncwzmsge.js";
 import {
   BoundedByteBuffer
 } from "./index-gh719d91.js";

package/dist/{index-t3abkwk4.js → index-zbv70qmk.js}

@@ -2,7 +2,7 @@
 import {
   acquireArchiveTodaySnapshot,
   discoverArchiveTodaySnapshot
-} from "./index-hxyjer3x.js";
+} from "./index-hacpnaew.js";
 import {
   canonicalizeUrl,
   chooseBestExtraction,
@@ -18,7 +18,7 @@ import {
   inspectClipEnvironment,
   renderAdapterCapabilities,
   renderDoctorReport
-} from "./index-nwrehke7.js";
+} from "./index-nd8v7r0z.js";
 import {
   cloneBrowserProfile
 } from "./index-5n05se68.js";
@@ -34,7 +34,7 @@ import {
   renderCookiePermissionNotice,
   renderCookiePermissionRecovery,
   setCookiePermissionReporter
-} from "./index-xwxy71ew.js";
+} from "./index-ncwzmsge.js";
 import {
   CONTENT_REWRITE_TRUNCATION_WARNING,
   buildClipMarkdown,
@@ -60,6 +60,15 @@ import {
   renderCookieHeader,
   renderNetscapeCookieJar
 } from "./index-2gv8y733.js";
+import {
+  abortCaptureBundle,
+  beginCaptureBundle,
+  commitCaptureBundle,
+  redactSensitiveText,
+  redactSensitiveTextWithCount,
+  sanitizeArtifactUrl,
+  writeCaptureBundle
+} from "./index-mxxxytys.js";
 import {
   startNetworkProxy
 } from "./index-w2zc0vwa.js";
@@ -68,23 +77,14 @@ import {
   decodeBytes,
   safeFetch
 } from "./index-e5fbsywq.js";
+import {
+  BoundedByteBuffer
+} from "./index-gh719d91.js";
 import {
   captureUrl,
   parseArguments,
   usage
 } from "./index-byz4kzww.js";
-import {
-  BoundedByteBuffer
-} from "./index-gh719d91.js";
-import {
-  abortCaptureBundle,
-  beginCaptureBundle,
-  commitCaptureBundle,
-  redactSensitiveText,
-  redactSensitiveTextWithCount,
-  sanitizeArtifactUrl,
-  writeCaptureBundle
-} from "./index-mxxxytys.js";
 import {
   sanitizeTerminalLine,
   sanitizeTerminalText

package/dist/index.js

@@ -19,6 +19,11 @@ import {
 import {
   initVault
 } from "./index-23z4zxgg.js";
+import {
+  DEFAULT_SYSTEMONE_ENDPOINT,
+  DEFAULT_SYSTEMONE_MODEL,
+  createTypeSafeReranker
+} from "./index-9rf81m0p.js";
 import {
   MAX_SOURCE_DISPOSITION_EVIDENCE,
   MAX_SOURCE_INBOX_CONNECTIONS,
@@ -27,17 +32,12 @@ import {
   MAX_SOURCE_INBOX_RESULTS,
   sourceInbox
 } from "./index-pj501bh1.js";
-import {
-  DEFAULT_SYSTEMONE_ENDPOINT,
-  DEFAULT_SYSTEMONE_MODEL,
-  createTypeSafeReranker
-} from "./index-9rf81m0p.js";
 import {
   FrozenEvaluationSnapshotError,
   knowledgeBaseEvaluationRetrieverIds,
   openKnowledgeBaseEvaluation,
   verifyFrozenEvaluationSnapshot
-} from "./index-59bcxqee.js";
+} from "./index-j2jt49gr.js";
 import {
   DEFAULT_SEARCH_RESULTS,
   MAX_SEARCH_CANDIDATES,
@@ -50,7 +50,7 @@ import {
   packUntrustedSearchContext,
   searchEvidenceRank,
   validateKnowledgeBaseSearchHistory
-} from "./index-mcpppwbq.js";
+} from "./index-9zkba8hr.js";
 import"./index-adx6khj5.js";
 import {
   MAX_EMBEDDING_MODEL_BYTES,
@@ -70,31 +70,20 @@ import {
 } from "./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
 import {
-  MAX_RERANK_CANDIDATES,
-  MAX_RERANK_SNIPPET_BYTES,
-  MAX_RERANK_STATE_BYTES,
-  applyRerank
-} from "./index-j70m75wd.js";
+  percolateWithGraph
+} from "./index-wqx1x32f.js";
 import {
-  MAX_BOOTSTRAP_RESAMPLES,
-  MAX_EVALUATION_DIAGNOSTICS,
-  MAX_EVALUATION_EVIDENCE_BYTES,
-  MAX_EVALUATION_QRELS_PER_QUERY,
-  MAX_EVALUATION_QUERIES,
-  MAX_EVALUATION_RESULTS_PER_QUERY,
-  MAX_EVALUATION_RETRIEVERS,
-  MAX_EVALUATION_TEXT_BYTES,
-  MAX_EVALUATION_TIMEOUT_MS,
-  RETRIEVAL_EVALUATION_REPORT_VERSION,
-  RETRIEVAL_EVALUATION_SCHEMA_VERSION,
-  buildRetrievalEvaluationReport,
-  pairedBootstrapConfidenceInterval,
-  parseRetrievalEvaluationCorpus,
-  runRetrievalEvaluation
-} from "./index-b88v3vtm.js";
+  createGraphSnapshot,
+  openGraphAuthority,
+  queryGraph,
+  rebuildGraph,
+  verifyGraph
+} from "./index-3gc2yk4k.js";
 import {
-  percolateWithGraph
-} from "./index-e26mdwxz.js";
+  GRAPH_LIMITS,
+  GraphAuthorityError,
+  validateGraphQueryRequest
+} from "./index-pgtm2nhf.js";
 import {
   DEFAULT_PERCOLATION_LIMIT,
   DEFAULT_PERCOLATION_MIN_SUPPORT,
@@ -117,17 +106,28 @@ import {
   percolateVault
 } from "./index-bdwcjvr4.js";
 import {
-  createGraphSnapshot,
-  openGraphAuthority,
-  queryGraph,
-  rebuildGraph,
-  verifyGraph
-} from "./index-3gc2yk4k.js";
+  MAX_RERANK_CANDIDATES,
+  MAX_RERANK_SNIPPET_BYTES,
+  MAX_RERANK_STATE_BYTES,
+  applyRerank
+} from "./index-j70m75wd.js";
 import {
-  GRAPH_LIMITS,
-  GraphAuthorityError,
-  validateGraphQueryRequest
-} from "./index-pgtm2nhf.js";
+  MAX_BOOTSTRAP_RESAMPLES,
+  MAX_EVALUATION_DIAGNOSTICS,
+  MAX_EVALUATION_EVIDENCE_BYTES,
+  MAX_EVALUATION_QRELS_PER_QUERY,
+  MAX_EVALUATION_QUERIES,
+  MAX_EVALUATION_RESULTS_PER_QUERY,
+  MAX_EVALUATION_RETRIEVERS,
+  MAX_EVALUATION_TEXT_BYTES,
+  MAX_EVALUATION_TIMEOUT_MS,
+  RETRIEVAL_EVALUATION_REPORT_VERSION,
+  RETRIEVAL_EVALUATION_SCHEMA_VERSION,
+  buildRetrievalEvaluationReport,
+  pairedBootstrapConfidenceInterval,
+  parseRetrievalEvaluationCorpus,
+  runRetrievalEvaluation
+} from "./index-b88v3vtm.js";
 import {
   GitHistoryError,
   MAX_GIT_HISTORY_COMMITS,

package/dist/pdf.js

@@ -24,12 +24,12 @@ import {
   resolvePdfTools,
   runPdfCapture,
   runPdfToolCommand
-} from "./index-qfqjfxaa.js";
+} from "./index-m9p2a4mj.js";
 import"./index-k86wepd8.js";
 import"./index-cd75vky9.js";
+import"./index-mxxxytys.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
-import"./index-mxxxytys.js";
 import"./index-1xxnjn0d.js";
 import"./index-z1w83f81.js";
 

package/dist/portfolio.js

@@ -20,16 +20,16 @@ import {
   selectAuthorizedVaults,
   snapshotPortfolioRegistry,
   validateResolvedPortfolioVaults
-} from "./index-hz2wyggk.js";
-import"./index-mcpppwbq.js";
+} from "./index-9paxge84.js";
+import"./index-9zkba8hr.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
-import"./index-j70m75wd.js";
-import"./index-e26mdwxz.js";
-import"./index-bdwcjvr4.js";
+import"./index-wqx1x32f.js";
 import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";
+import"./index-bdwcjvr4.js";
+import"./index-j70m75wd.js";
 import"./index-1gwbassd.js";
 import"./index-ahyhryb8.js";
 import"./index-1xxnjn0d.js";

package/dist/sdk.js

@@ -11,15 +11,15 @@ import {
   packUntrustedSearchContext,
   searchEvidenceRank,
   validateKnowledgeBaseSearchHistory
-} from "./index-mcpppwbq.js";
+} from "./index-9zkba8hr.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
-import"./index-j70m75wd.js";
-import"./index-e26mdwxz.js";
-import"./index-bdwcjvr4.js";
+import"./index-wqx1x32f.js";
 import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";
+import"./index-bdwcjvr4.js";
+import"./index-j70m75wd.js";
 import"./index-1gwbassd.js";
 import"./index-ahyhryb8.js";
 import"./index-1xxnjn0d.js";

package/dist/{support-adj7bbge.js → support-ym4mpf7w.js}

@@ -2,43 +2,44 @@
 import {
   parseArguments as parseArguments2,
   parseUrlMetadataArguments
-} from "./index-1wccy765.js";
-import"./index-47893rgw.js";
+} from "./index-8w1zsgcm.js";
+import"./index-5h5awwh4.js";
 import {
   parsePdfArguments
-} from "./index-qfqjfxaa.js";
-import"./index-hz2wyggk.js";
+} from "./index-m9p2a4mj.js";
+import"./index-9paxge84.js";
 import"./index-j4zgmzjr.js";
-import"./index-t3abkwk4.js";
-import"./index-hxyjer3x.js";
+import"./index-npg9z1a4.js";
+import"./index-zbv70qmk.js";
+import"./index-hacpnaew.js";
 import"./index-k86wepd8.js";
-import"./index-nwrehke7.js";
+import"./index-nd8v7r0z.js";
 import"./index-5n05se68.js";
-import"./index-xwxy71ew.js";
+import"./index-8pabwzqg.js";
+import"./index-ncwzmsge.js";
 import"./index-cd75vky9.js";
 import"./index-2gv8y733.js";
+import"./index-mxxxytys.js";
 import"./index-w2zc0vwa.js";
 import"./index-e5fbsywq.js";
+import"./index-gh719d91.js";
 import {
   parseArguments
 } from "./index-byz4kzww.js";
-import"./index-gh719d91.js";
-import"./index-npg9z1a4.js";
-import"./index-mxxxytys.js";
 import"./index-23z4zxgg.js";
-import"./index-pj501bh1.js";
 import"./index-9rf81m0p.js";
-import"./index-59bcxqee.js";
-import"./index-mcpppwbq.js";
+import"./index-pj501bh1.js";
+import"./index-j2jt49gr.js";
+import"./index-9zkba8hr.js";
 import"./index-adx6khj5.js";
 import"./index-fp732bgg.js";
 import"./index-4j3tt0c3.js";
-import"./index-j70m75wd.js";
-import"./index-b88v3vtm.js";
-import"./index-e26mdwxz.js";
-import"./index-bdwcjvr4.js";
+import"./index-wqx1x32f.js";
 import"./index-3gc2yk4k.js";
 import"./index-pgtm2nhf.js";
+import"./index-bdwcjvr4.js";
+import"./index-j70m75wd.js";
+import"./index-b88v3vtm.js";
 import"./index-1gwbassd.js";
 import"./index-ahyhryb8.js";
 import"./index-1xxnjn0d.js";

package/dist/url-intelligence.js

@@ -10,7 +10,7 @@ import {
   readUrlMetadataDocument,
   renderUrlMetadataDocument,
   writeUrlMetadataDocument
-} from "./index-47893rgw.js";
+} from "./index-5h5awwh4.js";
 import {
   ARCHIVE_TODAY_HOSTS,
   ArchiveTodayFailure,
@@ -23,10 +23,10 @@ import {
   parseMetadataSearchResponse,
   rankMetadataSearchResults,
   selectNewestArchiveTodayMemento
-} from "./index-hxyjer3x.js";
+} from "./index-hacpnaew.js";
+import"./index-mxxxytys.js";
 import"./index-e5fbsywq.js";
 import"./index-gh719d91.js";
-import"./index-mxxxytys.js";
 import"./index-1xxnjn0d.js";
 import"./index-qkesh4c6.js";
 import"./index-z1w83f81.js";

package/dist/workflows/decision-context.js

@@ -1,17 +1,17 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-7drercgk.js";
+} from "../index-9fywek7g.js";
 import"../index-h170byqw.js";
-import"../index-mcpppwbq.js";
+import"../index-9zkba8hr.js";
 import"../index-adx6khj5.js";
 import"../index-fp732bgg.js";
 import"../index-4j3tt0c3.js";
-import"../index-j70m75wd.js";
-import"../index-e26mdwxz.js";
-import"../index-bdwcjvr4.js";
+import"../index-wqx1x32f.js";
 import"../index-3gc2yk4k.js";
 import"../index-pgtm2nhf.js";
+import"../index-bdwcjvr4.js";
+import"../index-j70m75wd.js";
 import"../index-1gwbassd.js";
 import"../index-ahyhryb8.js";
 import"../index-1xxnjn0d.js";

package/dist/workflows/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   decisionContextWorkflow
-} from "../index-7drercgk.js";
+} from "../index-9fywek7g.js";
 import {
   explainChangeWorkflow
 } from "../index-e4fagfjz.js";
@@ -9,15 +9,15 @@ import {
   planRadarWorkflow
 } from "../index-rdd5f7jj.js";
 import"../index-h170byqw.js";
-import"../index-mcpppwbq.js";
+import"../index-9zkba8hr.js";
 import"../index-adx6khj5.js";
 import"../index-fp732bgg.js";
 import"../index-4j3tt0c3.js";
-import"../index-j70m75wd.js";
-import"../index-e26mdwxz.js";
-import"../index-bdwcjvr4.js";
+import"../index-wqx1x32f.js";
 import"../index-3gc2yk4k.js";
 import"../index-pgtm2nhf.js";
+import"../index-bdwcjvr4.js";
+import"../index-j70m75wd.js";
 import"../index-1gwbassd.js";
 import"../index-ahyhryb8.js";
 import"../index-1xxnjn0d.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/wordcell",
-  "version": "0.25.1",
+  "version": "0.26.1",
   "description": "Wordcell keeps decisions, plans, and sources as Markdown beside your code, so coding agents can find them from the file they are about to change.",
   "license": "MIT",
   "type": "module",
@@ -311,8 +311,8 @@
     }
   },
   "bin": {
-    "wordcell": "./dist/cli.js",
-    "wordcell-evaluation-builder": "./dist/evaluation-builder.js"
+    "wordcell": "./dist/cli-bin.js",
+    "wordcell-evaluation-builder": "./dist/evaluation-builder-bin.js"
   },
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -472,14 +472,20 @@
     "assets/agent-skill.svg",
     "src/support.ts",
     "src/support-profile.ts",
-    "src/directory-sync.ts"
+    "src/directory-sync.ts",
+    "src/cli-bin.ts",
+    "src/cli-startup.ts",
+    "src/cli-update.ts",
+    "src/cli-release.ts",
+    "src/evaluation-builder-bin.ts",
+    "src/evaluation-builder-cli-args.ts"
   ],
   "scripts": {
     "kb:refresh": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell refresh --root kb",
     "kb:check:lane": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell check --root kb --no-catalog",
     "kb:check": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell check --root kb && bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell agents check --root kb --repo .",
     "kb:catalog": "bunx --bun --package https://github.com/hraness/wordcell/releases/download/v0.24.1/hraness-wordcell-0.24.1.tgz wordcell catalog --root kb",
-    "build": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./dist\", { recursive: true, force: true })' && bun build ./src/index.ts ./src/publish.ts ./src/publish-model.ts ./src/publish-search.ts ./src/agent-context.ts ./src/agent-guide-audit.ts ./src/attachments.ts ./src/authoring.ts ./src/benchmark.ts ./src/clip/browser-profiles.ts ./src/capture.ts ./src/cli.ts ./src/clip/acquire.ts ./src/clip/args.ts ./src/clip/bounded-byte-buffer.ts ./src/clip/bundle-reader.ts ./src/clip/cli.ts ./src/clip/cookies.ts ./src/clip/doctor.ts ./src/clip/jobs.ts ./src/clip/network.ts ./src/clip/network-proxy.ts ./src/clip/persist.ts ./src/clip/refresh.ts ./src/clip/terminal.ts ./src/evaluation.ts ./src/evaluation-builder.ts ./src/evaluation-kb.ts ./src/git.ts ./src/graph.ts ./src/graph-percolation.ts ./src/graph-authority.ts ./src/navigation.ts ./src/pdf.ts ./src/percolate.ts ./src/portfolio.ts ./src/query.ts ./src/rerank.ts ./src/rerank-typesafe.ts ./src/repository-memory.ts ./src/sdk.ts ./src/search.ts ./src/search-rules.ts ./src/semantic.ts ./src/source-inbox.ts ./src/untrusted-content.ts ./src/url-intelligence.ts ./src/workflow.ts ./src/workflows/index.ts ./src/workflows/decision-context.ts ./src/workflows/explain-change.ts ./src/workflows/plan-radar.ts ./src/clip/defuddle-worker.ts --outdir ./dist --root ./src --target bun --format esm --splitting --packages external && bun build ./src/publish-reader/reader.ts --outfile ./dist/publish-reader/reader.js --target browser --format esm && bun build ./src/publish-reader/theme.ts --outfile ./dist/publish-reader/theme.js --target browser --format iife && cp ./src/publish-reader/reader.css ./dist/publish-reader/reader.css",
+    "build": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./dist\", { recursive: true, force: true })' && bun build ./src/index.ts ./src/publish.ts ./src/publish-model.ts ./src/publish-search.ts ./src/agent-context.ts ./src/agent-guide-audit.ts ./src/attachments.ts ./src/authoring.ts ./src/benchmark.ts ./src/clip/browser-profiles.ts ./src/capture.ts ./src/cli.ts ./src/cli-bin.ts ./src/evaluation-builder-bin.ts ./src/clip/acquire.ts ./src/clip/args.ts ./src/clip/bounded-byte-buffer.ts ./src/clip/bundle-reader.ts ./src/clip/cli.ts ./src/clip/cookies.ts ./src/clip/doctor.ts ./src/clip/jobs.ts ./src/clip/network.ts ./src/clip/network-proxy.ts ./src/clip/persist.ts ./src/clip/refresh.ts ./src/clip/terminal.ts ./src/evaluation.ts ./src/evaluation-builder.ts ./src/evaluation-kb.ts ./src/git.ts ./src/graph.ts ./src/graph-percolation.ts ./src/graph-authority.ts ./src/navigation.ts ./src/pdf.ts ./src/percolate.ts ./src/portfolio.ts ./src/query.ts ./src/rerank.ts ./src/rerank-typesafe.ts ./src/repository-memory.ts ./src/sdk.ts ./src/search.ts ./src/search-rules.ts ./src/semantic.ts ./src/source-inbox.ts ./src/untrusted-content.ts ./src/url-intelligence.ts ./src/workflow.ts ./src/workflows/index.ts ./src/workflows/decision-context.ts ./src/workflows/explain-change.ts ./src/workflows/plan-radar.ts ./src/clip/defuddle-worker.ts --outdir ./dist --root ./src --target bun --format esm --splitting --packages external && bun build ./src/publish-reader/reader.ts --outfile ./dist/publish-reader/reader.js --target browser --format esm && bun build ./src/publish-reader/theme.ts --outfile ./dist/publish-reader/theme.js --target browser --format iife && cp ./src/publish-reader/reader.css ./dist/publish-reader/reader.css",
     "check:workflows": "bun ./scripts/check-workflow-yaml.ts",
     "check:installed-command-docs": "bun ./scripts/check-installed-command-docs.ts",
     "check:portfolio-inventory": "bun ./scripts/check-portfolio-inventory.ts",
@@ -506,7 +512,8 @@
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
     "effect": "3.22.1",
-    "@hraness/support-foundation": "git+https://github.com/hraness/support-foundation.git#b32c1c81bb2444f50509ed54388758ecfab1f1c0"
+    "@hraness/support-foundation": "git+https://github.com/hraness/support-foundation.git#b32c1c81bb2444f50509ed54388758ecfab1f1c0",
+    "@hraness/cli-update": "https://github.com/hraness/cli-update/releases/download/v0.1.0/hraness-cli-update-0.1.0.tgz"
   },
   "devDependencies": {
     "@hraness/build-governance": "github:hraness/build-governance#v0.1.0",

package/skills/wordcell/SKILL.md

@@ -58,7 +58,7 @@ missing:
 ```sh
 command -v wordcell >/dev/null 2>&1 || {
   command -v bun >/dev/null 2>&1 || exit 1
-  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.25.1/hraness-wordcell-0.25.1.tgz
+  bun add --global --ignore-scripts https://github.com/hraness/wordcell/releases/download/v0.26.1/hraness-wordcell-0.26.1.tgz
 }
 wordcell --help
 ```
@@ -73,6 +73,15 @@ Installation ends after command verification. Never run `wordcell init`, create
 vault, refresh a catalog, or edit Markdown as an installation side effect.
 Initialize or mutate a vault only when the user's request requires that change.
 
+Supported global installations check for verified releases daily before work.
+Use `wordcell update status`, `wordcell update check`, and `wordcell update`
+to inspect or update the installed version. `wordcell update disable` saves an
+opt-out; `wordcell update enable` restores updates. For offline or externally
+version-bound work, set `HRANESS_NO_UPDATE=1` for the invocation. Never override
+a saved opt-out or a consumer's version binding as part of task setup. Updates
+require `gh`, preserve `--ignore-scripts`, and wait for active commands to exit.
+SDK imports and help never check for updates.
+
 ## Preserve the Wordcell contract
 
 - For an existing vault, resolve `KB_ROOT` to the directory that contains its

package/src/cli-bin.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+import { fileURLToPath } from "node:url";
+import { runWordcellBin } from "./cli-update.js";
+
+if (import.meta.main) process.exitCode = await runWordcellBin("wordcell", fileURLToPath(import.meta.url), process.argv.slice(2));

package/src/cli-help.ts

@@ -650,6 +650,18 @@ export const commandHelp: readonly CommandHelp[] = [
     examples: ["wordcell url-metadata backfill --root kb"],
     notes: ["Run `wordcell url-metadata --help` for every option."],
   },
+  {
+    id: "update",
+    label: "update [check|status|enable|disable]",
+    usage: "wordcell update [check|status|enable|disable] [--json]",
+    summary: "Update this global installation or change automatic update settings.",
+    group: "advanced",
+    options: [JSON_OPTION, ["--check", "Check the latest release without installing"]],
+    examples: ["wordcell update status", "wordcell update disable"],
+    notes: ["Supported global installs on macOS and Linux update daily before work.",
+      "Set HRANESS_NO_UPDATE=1 to skip automatic checks for one invocation.",
+      "Active commands prevent replacement. SDK imports never check for updates."],
+  },
   {
     id: "support",
     label: "support",

package/src/cli-program.ts

@@ -1,15 +1,14 @@
+import { parseCliStartupCommand } from "./cli-startup.js";
 import { terminalIntro } from "./cli-intro.js";
 import {
   advancedHelp,
   closestMatch,
   commandHelpText,
-  commandWordCount,
   knownCommandWords,
   optionNames,
   resolveCommandId,
   rootHelp,
   startHelp,
-  valueOptions,
 } from "./cli-help.js";
 import { detectAudience, renderFailure, sentence, symbol, terminalOutput, terminalStyle, type TerminalEnvironment } from "./cli-style.js";
 import { open, realpath, stat } from "node:fs/promises";
@@ -2280,10 +2279,6 @@ function parsePortfolioCommand(arguments_: readonly string[]): ParseResult {
   };
 }
 
-function isHelpFlag(argument: string | undefined): boolean {
-  return argument === "--help" || argument === "-h";
-}
-
 /** True for the help request a delegated parser answers itself. */
 function isDelegatedHelp(command: ParsedCommand): boolean {
   if (command.kind === "clip") return command.arguments.length === 1 && command.arguments[0] === "help";
@@ -2293,59 +2288,10 @@ function isDelegatedHelp(command: ParsedCommand): boolean {
   return false;
 }
 
-/** Help for delegated commands comes from their own parsers. */
-function delegatedHelp(first: string): ParsedCommand | undefined {
-  if (first === "clip" || first === "inspect") return { kind: "clip", arguments: ["help"] };
-  if (first === "pdf") return { kind: "pdf", arguments: ["--help"] };
-  if (first === "url-metadata") return { kind: "url-metadata", arguments: ["--help"] };
-  return undefined;
-}
-
-/** `help`, `help advanced`, and `help <command...>`. */
-function parseHelpTopic(words: readonly string[]): ParseResult {
-  const topic = words.filter((word) => !isHelpFlag(word) && word !== "--json");
-  if (topic.length === 0) return { ok: true, value: { kind: "help" } };
-  if (topic.length === 1 && topic[0] === "advanced") return { ok: true, value: { kind: "help", topic: "advanced" } };
-  const delegated = delegatedHelp(topic[0] ?? "");
-  if (delegated !== undefined) return { ok: true, value: delegated };
-  const id = resolveCommandId(topic);
-  if (id === undefined) return { ok: false, message: "unknown help topic" };
-  return { ok: true, value: { kind: "help", topic: id } };
-}
-
-/**
- * `<command> --help` anywhere a person would type it: right after the command
- * words, or as the last argument when it is not the value of an option.
- */
-function embeddedHelp(arguments_: readonly string[]): ParseResult | undefined {
-  const separator = arguments_.indexOf("--");
-  const end = separator === -1 ? arguments_.length : separator;
-  const index = arguments_.slice(0, end).findIndex(isHelpFlag);
-  if (index <= 0) return undefined;
-  const delegated = delegatedHelp(arguments_[0] ?? "");
-  if (delegated !== undefined) {
-    return index === 1 || index === end - 1 ? { ok: true, value: delegated } : undefined;
-  }
-  const id = resolveCommandId(arguments_.slice(0, index).filter((word) => !word.startsWith("-")));
-  if (id === undefined) return undefined;
-  const words = commandWordCount(id);
-  const previous = arguments_[index - 1] ?? "";
-  // `--help` is never an option value; `-h` could be one, as in `--body -h`.
-  const flag = arguments_[index];
-  const lastArgument = index === end - 1 && (flag === "--help" || !valueOptions(id).has(previous));
-  if (index !== words && !lastArgument) return undefined;
-  return { ok: true, value: { kind: "help", topic: id } };
-}
-
 export function parseArguments(arguments_: readonly string[]): ParseResult {
+  const startup = parseCliStartupCommand(arguments_);
+  if (startup !== undefined) return startup;
   const command = arguments_[0];
-  if (command === undefined) return { ok: true, value: { kind: "help", topic: "start" } };
-  if (command === "help" || isHelpFlag(command)) return parseHelpTopic(arguments_.slice(1));
-  if (command === "--version" || command === "-V" || command === "-v" || command === "version") {
-    return { ok: true, value: { kind: "version", json: arguments_.includes("--json") } };
-  }
-  const help = embeddedHelp(arguments_);
-  if (help !== undefined) return help;
   if (command === "capture" && arguments_[1] === "diff") {
     return parseCaptureDiffCommand(arguments_.slice(2));
   }