@hraness/wordcell 0.20.0-bootstrap.1

package/dist/workflows/index.js

@@ -0,0 +1,28 @@
+// @bun
+import {
+  decisionContextWorkflow
+} from "../index-8a08v6x8.js";
+import {
+  explainChangeWorkflow
+} from "../index-e4fagfjz.js";
+import {
+  planRadarWorkflow
+} from "../index-rdd5f7jj.js";
+import"../index-h170byqw.js";
+import"../index-m7et4rz4.js";
+import"../index-adx6khj5.js";
+import"../index-n05s3wsb.js";
+import"../index-4j3tt0c3.js";
+import"../index-1gwbassd.js";
+import"../index-why54q5p.js";
+import"../index-48pz4jpc.js";
+import"../index-06c9ctr6.js";
+import"../index-d13v9ckt.js";
+import"../index-5vwpzb5a.js";
+import"../index-ekpwvbra.js";
+import"../index-1xxnjn0d.js";
+export {
+  planRadarWorkflow,
+  explainChangeWorkflow,
+  decisionContextWorkflow
+};

package/dist/workflows/plan-radar.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  planRadarWorkflow
+} from "../index-rdd5f7jj.js";
+import"../index-h170byqw.js";
+import"../index-06c9ctr6.js";
+import"../index-5vwpzb5a.js";
+export {
+  planRadarWorkflow
+};

package/package.json

@@ -0,0 +1,421 @@
+{
+  "name": "@hraness/wordcell",
+  "version": "0.20.0-bootstrap.1",
+  "description": "A knowledge base for coding agents, built from Markdown, backlinks, semantic search, and Git context.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": [
+    "./src/agent-context.ts",
+    "./src/agent-guide-audit.ts",
+    "./src/attachments.ts",
+    "./src/authoring.ts",
+    "./src/benchmark.ts",
+    "./src/capture.ts",
+    "./src/cli.ts",
+    "./src/clip/acquire.ts",
+    "./src/clip/args.ts",
+    "./src/clip/bounded-byte-buffer.ts",
+    "./src/clip/browser-profiles.ts",
+    "./src/clip/bundle-reader.ts",
+    "./src/clip/cli.ts",
+    "./src/clip/cookies.ts",
+    "./src/clip/defuddle-worker.ts",
+    "./src/clip/doctor.ts",
+    "./src/clip/jobs.ts",
+    "./src/clip/network-proxy.ts",
+    "./src/clip/network.ts",
+    "./src/clip/persist.ts",
+    "./src/clip/refresh.ts",
+    "./src/clip/terminal.ts",
+    "./src/evaluation-builder.ts",
+    "./src/evaluation-kb.ts",
+    "./src/evaluation.ts",
+    "./src/git.ts",
+    "./src/graph.ts",
+    "./src/index.ts",
+    "./src/navigation.ts",
+    "./src/pdf.ts",
+    "./src/percolate.ts",
+    "./src/portfolio.ts",
+    "./src/portfolio-audit.ts",
+    "./src/portfolio-identity.ts",
+    "./src/portfolio-registry.ts",
+    "./src/query.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/decision-context.ts",
+    "./src/workflows/explain-change.ts",
+    "./src/workflows/index.ts",
+    "./src/workflows/plan-radar.ts"
+  ],
+  "packageManager": "bun@1.3.14",
+  "engines": {
+    "bun": ">=1.3.14"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hraness/wordcell.git"
+  },
+  "homepage": "https://wordcell.io",
+  "bugs": {
+    "url": "https://github.com/hraness/wordcell/issues"
+  },
+  "keywords": [
+    "knowledge-base",
+    "coding-agents",
+    "agent-memory",
+    "repository-context",
+    "markdown",
+    "obsidian",
+    "agents-md",
+    "web-clipper",
+    "backlinks",
+    "knowledge-graph",
+    "semantic-search",
+    "local-first"
+  ],
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./agent-context": {
+      "types": "./src/agent-context.ts",
+      "import": "./dist/agent-context.js"
+    },
+    "./agent-guide-audit": {
+      "types": "./src/agent-guide-audit.ts",
+      "import": "./dist/agent-guide-audit.js"
+    },
+    "./attachments": {
+      "types": "./src/attachments.ts",
+      "import": "./dist/attachments.js"
+    },
+    "./authoring": {
+      "types": "./src/authoring.ts",
+      "import": "./dist/authoring.js"
+    },
+    "./benchmark": {
+      "types": "./src/benchmark.ts",
+      "import": "./dist/benchmark.js"
+    },
+    "./browser-profiles": {
+      "types": "./src/clip/browser-profiles.ts",
+      "import": "./dist/clip/browser-profiles.js"
+    },
+    "./capture": {
+      "types": "./src/capture.ts",
+      "import": "./dist/capture.js"
+    },
+    "./cli": {
+      "types": "./src/cli.ts",
+      "import": "./dist/cli.js"
+    },
+    "./clip/acquire": {
+      "types": "./src/clip/acquire.ts",
+      "import": "./dist/clip/acquire.js"
+    },
+    "./clip/args": {
+      "types": "./src/clip/args.ts",
+      "import": "./dist/clip/args.js"
+    },
+    "./clip/bounded-byte-buffer": {
+      "types": "./src/clip/bounded-byte-buffer.ts",
+      "import": "./dist/clip/bounded-byte-buffer.js"
+    },
+    "./clip/bundle-reader": {
+      "types": "./src/clip/bundle-reader.ts",
+      "import": "./dist/clip/bundle-reader.js"
+    },
+    "./clip/cli": {
+      "types": "./src/clip/cli.ts",
+      "import": "./dist/clip/cli.js"
+    },
+    "./clip/cookies": {
+      "types": "./src/clip/cookies.ts",
+      "import": "./dist/clip/cookies.js"
+    },
+    "./clip/doctor": {
+      "types": "./src/clip/doctor.ts",
+      "import": "./dist/clip/doctor.js"
+    },
+    "./clip/jobs": {
+      "types": "./src/clip/jobs.ts",
+      "import": "./dist/clip/jobs.js"
+    },
+    "./clip/network": {
+      "types": "./src/clip/network.ts",
+      "import": "./dist/clip/network.js"
+    },
+    "./clip/network-proxy": {
+      "types": "./src/clip/network-proxy.ts",
+      "import": "./dist/clip/network-proxy.js"
+    },
+    "./clip/persist": {
+      "types": "./src/clip/persist.ts",
+      "import": "./dist/clip/persist.js"
+    },
+    "./clip/refresh": {
+      "types": "./src/clip/refresh.ts",
+      "import": "./dist/clip/refresh.js"
+    },
+    "./clip/terminal": {
+      "types": "./src/clip/terminal.ts",
+      "import": "./dist/clip/terminal.js"
+    },
+    "./evaluation": {
+      "types": "./src/evaluation.ts",
+      "import": "./dist/evaluation.js"
+    },
+    "./evaluation-builder": {
+      "types": "./src/evaluation-builder.ts",
+      "import": "./dist/evaluation-builder.js"
+    },
+    "./evaluation-kb": {
+      "types": "./src/evaluation-kb.ts",
+      "import": "./dist/evaluation-kb.js"
+    },
+    "./git": {
+      "types": "./src/git.ts",
+      "import": "./dist/git.js"
+    },
+    "./graph": {
+      "types": "./src/graph.ts",
+      "import": "./dist/graph.js"
+    },
+    "./navigation": {
+      "types": "./src/navigation.ts",
+      "import": "./dist/navigation.js"
+    },
+    "./pdf": {
+      "types": "./src/pdf.ts",
+      "import": "./dist/pdf.js"
+    },
+    "./percolate": {
+      "types": "./src/percolate.ts",
+      "import": "./dist/percolate.js"
+    },
+    "./portfolio": {
+      "types": "./src/portfolio.ts",
+      "import": "./dist/portfolio.js"
+    },
+    "./query": {
+      "types": "./src/query.ts",
+      "import": "./dist/query.js"
+    },
+    "./repository-memory": {
+      "types": "./src/repository-memory.ts",
+      "import": "./dist/repository-memory.js"
+    },
+    "./sdk": {
+      "types": "./src/sdk.ts",
+      "import": "./dist/sdk.js"
+    },
+    "./search": {
+      "types": "./src/search.ts",
+      "import": "./dist/search.js"
+    },
+    "./search-rules": {
+      "types": "./src/search-rules.ts",
+      "import": "./dist/search-rules.js"
+    },
+    "./semantic": {
+      "types": "./src/semantic.ts",
+      "import": "./dist/semantic.js"
+    },
+    "./source-inbox": {
+      "types": "./src/source-inbox.ts",
+      "import": "./dist/source-inbox.js"
+    },
+    "./untrusted-content": {
+      "types": "./src/untrusted-content.ts",
+      "import": "./dist/untrusted-content.js"
+    },
+    "./url-intelligence": {
+      "types": "./src/url-intelligence.ts",
+      "import": "./dist/url-intelligence.js"
+    },
+    "./workflow": {
+      "types": "./src/workflow.ts",
+      "import": "./dist/workflow.js"
+    },
+    "./workflows": {
+      "types": "./src/workflows/index.ts",
+      "import": "./dist/workflows/index.js"
+    },
+    "./workflows/decision-context": {
+      "types": "./src/workflows/decision-context.ts",
+      "import": "./dist/workflows/decision-context.js"
+    },
+    "./workflows/explain-change": {
+      "types": "./src/workflows/explain-change.ts",
+      "import": "./dist/workflows/explain-change.js"
+    },
+    "./workflows/plan-radar": {
+      "types": "./src/workflows/plan-radar.ts",
+      "import": "./dist/workflows/plan-radar.js"
+    }
+  },
+  "bin": {
+    "wordcell": "./dist/cli.js",
+    "kb": "./dist/kb-alias.js",
+    "wordcell-evaluation-builder": "./dist/evaluation-builder.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "files": [
+    "dist",
+    "src/agent-context.ts",
+    "src/agent-guide-audit.ts",
+    "src/authoring.ts",
+    "src/authoring-model.ts",
+    "src/authoring-platform.ts",
+    "src/authoring-program.ts",
+    "src/authoring-runtime.ts",
+    "src/attachments.ts",
+    "src/benchmark.ts",
+    "src/capture.ts",
+    "src/url-intelligence.ts",
+    "src/cli.ts",
+    "src/cli-program.ts",
+    "src/kb-alias.ts",
+    "src/clip/acquire.ts",
+    "src/clip/archive-today.ts",
+    "src/clip/args.ts",
+    "src/clip/assets.ts",
+    "src/clip/bounded-byte-buffer.ts",
+    "src/clip/browser-profiles.ts",
+    "src/clip/bundle-reader.ts",
+    "src/clip/capture.ts",
+    "src/clip/cli.ts",
+    "src/clip/cookies.ts",
+    "src/clip/doctor.ts",
+    "src/clip/jobs.ts",
+    "src/clip/extract.ts",
+    "src/clip/lib.ts",
+    "src/clip/media.ts",
+    "src/clip/network-proxy.ts",
+    "src/clip/network.ts",
+    "src/clip/package-root.ts",
+    "src/clip/persist.ts",
+    "src/clip/refresh.ts",
+    "src/clip/platforms.ts",
+    "src/clip/structured.ts",
+    "src/clip/terminal.ts",
+    "src/clip/metadata-search.ts",
+    "src/clip/url-intelligence.ts",
+    "src/clip/url-metadata.ts",
+    "src/clip/url-metadata-backfill.ts",
+    "src/clip/url-metadata-cli.ts",
+    "src/clip/metadata-search-tool/Cargo.toml",
+    "src/clip/metadata-search-tool/Cargo.lock",
+    "src/clip/metadata-search-tool/runner.ts",
+    "src/clip/metadata-search-tool/src/main.rs",
+    "src/git.ts",
+    "src/evaluation-analysis-v2.ts",
+    "src/evaluation-builder.ts",
+    "src/evaluation-corpus-authoring.ts",
+    "src/evaluation-evidence.ts",
+    "src/evaluation-execution-v2.ts",
+    "src/evaluation-implementation.ts",
+    "src/evaluation-kb-closure.ts",
+    "src/evaluation-kb-runner-v2.ts",
+    "src/evaluation-kb-v2.ts",
+    "src/evaluation-redaction.ts",
+    "src/evaluation-kb.ts",
+    "src/evaluation-measurement-v2.ts",
+    "src/evaluation-packing-v2.ts",
+    "src/evaluation-v2.ts",
+    "src/evaluation.ts",
+    "src/graph.ts",
+    "src/index.ts",
+    "src/init.ts",
+    "src/navigation.ts",
+    "src/note-lock.ts",
+    "src/oh-adoption.ts",
+    "src/percolate.ts",
+    "src/portfolio.ts",
+    "src/portfolio-audit.ts",
+    "src/portfolio-identity.ts",
+    "src/portfolio-registry.ts",
+    "src/pdf.ts",
+    "src/pdf/args.ts",
+    "src/pdf/capture.ts",
+    "src/pdf/cli.ts",
+    "src/pdf/extract.ts",
+    "src/pdf/layout.ts",
+    "src/pdf/markdown.ts",
+    "src/pdf/model.ts",
+    "src/pdf/ocr.ts",
+    "src/pdf/persist.ts",
+    "src/pdf/source.ts",
+    "src/pdf/tools.ts",
+    "src/query.ts",
+    "src/repository-memory.ts",
+    "src/search.ts",
+    "src/search-rules.ts",
+    "src/semantic-runtime.ts",
+    "src/semantic.ts",
+    "src/sdk.ts",
+    "src/source-inbox.ts",
+    "src/untrusted-content.ts",
+    "src/vault.ts",
+    "src/workflow.ts",
+    "src/workflow-model.ts",
+    "src/workflow-platform.ts",
+    "src/workflow-program.ts",
+    "src/workflow-runtime.ts",
+    "src/workflows/decision-context.ts",
+    "src/workflows/explain-change.ts",
+    "src/workflows/index.ts",
+    "src/workflows/plan-radar.ts",
+    "skills/wordcell",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "kb:refresh": "bunx --bun github:hraness/kb#v0.15.1 refresh --root kb",
+    "kb:check:lane": "bunx --bun github:hraness/kb#v0.15.1 check --root kb --no-catalog",
+    "kb:check": "bunx --bun github:hraness/kb#v0.15.1 check --root kb && bunx --bun github:hraness/kb#v0.15.1 agents check --root kb --repo .",
+    "kb:catalog": "bunx --bun github:hraness/kb#v0.15.1 catalog --root kb",
+    "build": "bun -e 'await (await import(\"node:fs/promises\")).rm(\"./dist\", { recursive: true, force: true })' && bun build ./src/index.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/kb-alias.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/navigation.ts ./src/pdf.ts ./src/percolate.ts ./src/portfolio.ts ./src/query.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",
+    "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",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test ./src ./scripts",
+    "url-metadata:backfill": "bun ./dist/cli.js url-metadata backfill",
+    "url-metadata:tool:build": "bun ./dist/cli.js url-metadata tool build",
+    "url-metadata:tool:check": "bun ./dist/cli.js url-metadata tool check",
+    "test:package": "bun run ./scripts/package-smoke.ts",
+    "check": "bun run check:effect && bun run check:workflows && bun run check:portfolio-inventory && bun run check:installed-command-docs && bun run typecheck && bun run build && bun run test:package && bun run test && bun run url-metadata:tool:check",
+    "prepack": "bun run check",
+    "check:effect": "bun run scripts/check-effect-policy.ts && bun test ./scripts/check-effect-architecture.test.ts"
+  },
+  "dependencies": {
+    "@hraness/oh": "github:hraness/oh#v0.2.0",
+    "@steipete/sweet-cookie": "0.4.3",
+    "@tobilu/qmd": "git+https://github.com/hraness/qmd.git#aa993dceb3ef8cfb71d470554ca437570f5a2b3c",
+    "agent-browser": "0.32.3",
+    "defuddle": "0.19.1",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3",
+    "effect": "3.22.1"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "fast-check": "^4.8.0",
+    "typescript": "^6.0.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/skills/wordcell/AGENTS.md

@@ -0,0 +1,22 @@
+# Contents
+
+- `SKILL.md` – public entrypoint, runtime contract, and intent router for all hraness/wordcell agent workflows.
+- `references/query.md` – scoped retrieval through exact metadata, hybrid search, graph structure, and Git provenance.
+- `references/customize.md` and `companion-skills.md` – interview-first Wordcell setup, explicit approval boundaries, and contracts for optional recurring rituals.
+- `references/save-url.md`, `url-authentication.md`, and `url-platforms.md` – auditable web capture, signed-in source handling, and platform-specific completeness boundaries.
+- `references/save-pdf.md` and `pdf-review.md` – PDF ingestion, OCR, image evidence, and mixed-media review.
+- `references/plan.md` and `plan-structure.md` – durable plan authoring and its adaptable Markdown contract.
+- `references/percolate.md` and `refresh.md` – evidence-backed graph edits, catalog maintenance, and vault validation.
+- `templates/companion-skill.template.md` – inert, copyable starting point for an approved companion skill.
+- `agents/openai.yaml` – user-facing skill metadata and invocation prompt.
+
+# Guidelines
+
+- Keep `wordcell` as the only public skill entrypoint. Preserve substantial workflows as focused references and keep the router compact enough to load by default.
+- Keep discovery language grounded in real user requests for knowledge bases, coding-agent memory, Markdown or Obsidian vaults, source capture, repository context, plans, and knowledge graphs. Exclude generic research, PDF reading, and planning outside hraness/wordcell.
+- Invoke the installed `wordcell` CLI without depending on a source checkout. Check for an existing command first, require Bun when installation is needed, and pin installation to the current immutable repository tag.
+- Never initialize or mutate a vault as part of skill or CLI installation.
+- Route setup, evolution, and custom-ritual requests before runtime discovery. Keep inspection non-mutating until the exact proposal is approved, and never treat skill discovery or an ambient account as authority.
+- Keep Markdown authoritative. Preserve incomplete source boundaries, read cited evidence before graph edits, and never generate reciprocal, inferred, transitive, or similarity-derived relationships.
+- In parallel managed-catalog work, defer refresh to the integrating agent and use the catalog-skipping check in each edit lane. Authored-catalog refreshes leave the front door unchanged.
+- Update `agents/openai.yaml`, README installation text, package inventory checks, and the pinned CLI tag together when the skill identity or package release changes.

package/skills/wordcell/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: wordcell
+description: >-
+  Set up, evolve, or operate a hraness/wordcell local-first Markdown knowledge base
+  for coding-agent memory. Use when a user asks to design Wordcell conventions or a
+  recurring Wordcell ritual; search or query a Wordcell or Obsidian vault; load or recover
+  repository context, plans, decisions, concepts, backlinks, semantic search,
+  or Git provenance from an earlier coding session; save, clip, scrape, or
+  archive a URL, article, social thread, signed-in browser page, or PDF as
+  auditable Markdown; create or update a durable plan in the vault; or refresh,
+  check, percolate, and maintain its knowledge graph. Do not use for generic
+  web research, generic PDF reading, or ordinary planning that will not use a
+  hraness/wordcell vault.
+---
+
+# Work with Wordcell
+
+Use hraness/wordcell to preserve and retrieve inspectable agent memory in Markdown
+and Git. Select the smallest workflow that matches the request, then load only
+its references.
+
+## Route the request
+
+Route the request before discovering, installing, or running the CLI. A setup,
+evolution, or custom-ritual request begins with read-only inspection and an
+approved proposal; it does not require a runtime merely because this skill was
+selected.
+
+| User intent | Read |
+| --- | --- |
+| Design, set up, or evolve a Wordcell; choose its boundaries and conventions; or define a recurring Wordcell ritual | [Customize a Wordcell setup](references/customize.md); add [Companion skill contracts](references/companion-skills.md) only when the proposal includes a new or revised skill |
+| Recover work from an earlier session, find notes, search one vault or an authorized portfolio, load repository-path context, inspect plans or decisions, follow backlinks or relationships, audit vault organization, or retrieve Git provenance | [Query the knowledge base](references/query.md) |
+| Save, clip, scrape, or archive a URL, article, social post or thread, GitHub or Discourse discussion, signed-in page, feed, inbox, private document, WhatsApp conversation, or YouTube page | [Capture web content](references/save-url.md); add [browser authentication](references/url-authentication.md) for signed-in sources and [platform routing](references/url-platforms.md) when route choice or completeness matters |
+| Import, extract, archive, OCR, or convert a local or public PDF into Markdown | [Save a PDF](references/save-pdf.md); add [PDF image review](references/pdf-review.md) for scans, screenshots, conversations, charts, or mixed media |
+| Create or update an implementation plan, proposal, RFC, migration plan, execution audit, or phased checklist in the vault | [Write a durable plan](references/plan.md) and [use its structure](references/plan-structure.md) |
+| Review recurring ideas, promote concepts, or add and verify typed relationships | [Percolate concepts and relationships](references/percolate.md) |
+| Refresh or validate the catalog, graph, attachments, repository scopes, context mappings, or overall vault health | [Refresh and check the knowledge base](references/refresh.md) |
+
+Read more than one primary reference only when the request spans those
+workflows. For example, saving a source and linking it from a maintained note
+uses the capture workflow followed by the relevant percolation and refresh
+steps.
+
+## Prepare the runtime when execution needs it
+
+Use an existing `wordcell` command when one is available. Do not reinstall or upgrade
+it merely because this skill loaded.
+
+If `wordcell` is missing, check for Bun. Bun is the required runtime. When Bun is
+also missing, install it with the official instructions at
+<https://bun.sh/docs/installation> under the environment's normal approval
+rules, then repeat command discovery. Install Wordcell only while `wordcell` remains
+missing:
+
+```sh
+command -v kb >/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.20.0/hraness-wordcell-0.20.0.tgz
+}
+wordcell --help
+```
+
+The versioned GitHub archive is the immutable release owned by this skill. Do not
+replace it with `latest`, a branch, or an unpinned package source. Both installed
+commands require Bun `1.3.14` or newer in `PATH`. Run `wordcell doctor` when the
+chosen workflow may need browser capture, media tools, PDF extraction, OCR, or
+local semantic search.
+
+Installation ends after command verification. Never run `wordcell init`, create a
+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.
+
+## Preserve the Wordcell contract
+
+- For an existing vault, resolve `KB_ROOT` to the directory that contains its
+  managed or authored `index.md`. During setup, inspect the explicitly proposed
+  location without assuming that `index.md` or any Wordcell directory exists. Read
+  the applicable repository and vault `AGENTS.md` files before writing. Do not
+  assume the session started in the vault.
+- Treat authored Markdown and Git as the record. Catalogs, backlinks, graph
+  reports, search indexes, embeddings, and percolation candidates are derived
+  views.
+- Open cited notes and source records before turning search results, tags,
+  mentions, or similarity into a conclusion. Author only relationships that
+  the source note's prose and evidence support.
+- Keep source capture separate from synthesis. Preserve access, pagination,
+  extraction, OCR, and configured-limit failures instead of upgrading partial
+  evidence to complete.
+- Follow the selected reference's final checks. In a managed-catalog vault,
+  parallel edit lanes use `wordcell check --root "$KB_ROOT" --no-catalog`; the
+  integrating agent performs one refresh and normal check.

package/skills/wordcell/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Wordcell"
+  short_description: "Set up, query, capture, and maintain Markdown memory"
+  default_prompt: "Use $wordcell to set up or work with this hraness/wordcell knowledge base, routing the request before any runtime preparation and loading only the references needed."