{"_id":"@berrydev-ai/plugin-llm-wiki","_rev":"3-486c759ecffc9c990f73d21aa23ff014","name":"@berrydev-ai/plugin-llm-wiki","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.1":{"name":"@berrydev-ai/plugin-llm-wiki","version":"0.1.1","keywords":["paperclip","plugin","automation","wiki","knowledge"],"author":{"name":"Berry Development"},"license":"MIT","_id":"@berrydev-ai/plugin-llm-wiki@0.1.1","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki#readme","bugs":{"url":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki/issues"},"dist":{"shasum":"d45c9e4f6b1b7ddcdb6a4a80a84d24e73ba65570","tarball":"https://registry.npmjs.org/@berrydev-ai/plugin-llm-wiki/-/plugin-llm-wiki-0.1.1.tgz","fileCount":31,"integrity":"sha512-w6zs3gAN6wE3zx0sFepIPs+VAe4tPVhlSDOoOXj/ic/o+hUBZLlt4fz8fUXUoqLNAN20vhAP0ZGBma3KZop4xQ==","signatures":[{"sig":"MEYCIQDdgm4mBYvIBtJ/caX6OXzfW19hLN0CBCJzoVMGDvmDWgIhAL38maBuOyqB+E6rGp21kM3CdHo8c73Csy7sPjrJBYha","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2600928},"type":"module","engines":{"node":">=24.11.0"},"gitHead":"673eb8bb8d1f1f6eb33de661b55c163211fc16dc","scripts":{"dev":"node ./esbuild.config.mjs --watch","test":"vitest run --config ./vitest.config.ts","build":"node ./esbuild.config.mjs","dev:ui":"paperclip-plugin-dev-server --root . --ui-dir dist/ui --port 4177","prepack":"npm run build","typecheck":"tsc --noEmit","build:rollup":"rollup -c"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/paperclip-plugin-llm-wiki.git","type":"git"},"_npmVersion":"11.19.0","description":"Local-file LLM Wiki plugin for source ingestion, wiki browsing, query, lint, and maintenance workflows. Maintained fork of @paperclipai/plugin-llm-wiki.","directories":{},"_nodeVersion":"26.7.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jsdom":"^28.0.0","tslib":"^2.8.1","rollup":"^4.62.4","vitest":"^4.1.10","esbuild":"^0.28.1","react-dom":"^19.2.8","typescript":"^5.7.3","@types/node":"^24.0.0","@types/react":"^19.2.18","@types/react-dom":"^19.2.4","@paperclipai/plugin-sdk":"2026.817.0","@rollup/plugin-typescript":"^12.1.2","@rollup/plugin-node-resolve":"^16.0.1"},"paperclipPlugin":{"ui":"./dist/ui/","worker":"./dist/worker.js","manifest":"./dist/manifest.js"},"peerDependencies":{"react":">=18"},"_npmOperationalInternal":{"tmp":"tmp/plugin-llm-wiki_0.1.1_1787406209124_0.5572482708825532","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@berrydev-ai/plugin-llm-wiki","version":"0.1.2","keywords":["paperclip","plugin","automation","wiki","knowledge"],"author":{"name":"Berry Development"},"license":"MIT","_id":"@berrydev-ai/plugin-llm-wiki@0.1.2","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"homepage":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki#readme","bugs":{"url":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki/issues"},"dist":{"shasum":"ddc5e6a282380abd92255cc0213a67da13e22652","tarball":"https://registry.npmjs.org/@berrydev-ai/plugin-llm-wiki/-/plugin-llm-wiki-0.1.2.tgz","fileCount":31,"integrity":"sha512-tnmcSoXPvnDpJVN3kqD4yzRLEu1aqS2D4gfq3E4qUZaWr94B+IfotWYbSNWEYMCpHImSJJ9WZm/oo+UOi8BadA==","signatures":[{"sig":"MEUCIQDoXxOmynqMXwAh9Vj96xt7MVD4LXl7vQgB8kw0ibCj8QIgAQ+bQ7J+tLzMe9pxe+tKd69dR4wS74c+s6vrzCgB8nM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2602658},"type":"module","engines":{"node":">=24.11.0"},"gitHead":"2d345785e790cffd22f9bc1ea8530ac84196f005","scripts":{"dev":"node ./esbuild.config.mjs --watch","test":"vitest run --config ./vitest.config.ts","build":"node ./esbuild.config.mjs","dev:ui":"paperclip-plugin-dev-server --root . --ui-dir dist/ui --port 4177","typecheck":"tsc --noEmit","build:rollup":"rollup -c"},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"repository":{"url":"git+https://github.com/berrydev-ai/paperclip-plugin-llm-wiki.git","type":"git"},"_npmVersion":"11.19.0","description":"Local-file LLM Wiki plugin for source ingestion, wiki browsing, query, lint, and maintenance workflows. Maintained fork of @paperclipai/plugin-llm-wiki.","directories":{},"_nodeVersion":"26.7.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jsdom":"^28.0.0","tslib":"^2.8.1","rollup":"^4.62.4","vitest":"^4.1.10","esbuild":"^0.28.1","react-dom":"^19.2.8","typescript":"^5.7.3","@types/node":"^24.0.0","@types/react":"^19.2.18","@types/react-dom":"^19.2.4","@paperclipai/plugin-sdk":"2026.817.0","@rollup/plugin-typescript":"^12.1.2","@rollup/plugin-node-resolve":"^16.0.1"},"paperclipPlugin":{"ui":"./dist/ui/","worker":"./dist/worker.js","manifest":"./dist/manifest.js"},"peerDependencies":{"react":">=18"},"_npmOperationalInternal":{"tmp":"tmp/plugin-llm-wiki_0.1.2_1787408790658_0.6275513852087153","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@berrydev-ai/plugin-llm-wiki","version":"0.1.3","type":"module","description":"Local-file LLM Wiki plugin for source ingestion, wiki browsing, query, lint, and maintenance workflows. Maintained fork of @paperclipai/plugin-llm-wiki.","license":"MIT","homepage":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki#readme","bugs":{"url":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki/issues"},"repository":{"type":"git","url":"git+https://github.com/berrydev-ai/paperclip-plugin-llm-wiki.git"},"publishConfig":{"access":"public"},"scripts":{"build":"node ./esbuild.config.mjs","build:rollup":"rollup -c","dev":"node ./esbuild.config.mjs --watch","dev:ui":"paperclip-plugin-dev-server --root . --ui-dir dist/ui --port 4177","prepack":"npm run build","test":"vitest run --config ./vitest.config.ts","typecheck":"tsc --noEmit"},"paperclipPlugin":{"manifest":"./dist/manifest.js","worker":"./dist/worker.js","ui":"./dist/ui/"},"keywords":["paperclip","plugin","automation","wiki","knowledge"],"author":{"name":"Berry Development"},"devDependencies":{"@paperclipai/plugin-sdk":"2026.817.0","@rollup/plugin-node-resolve":"^16.0.1","@rollup/plugin-typescript":"^12.1.2","@types/node":"^24.0.0","@types/react":"^19.2.18","@types/react-dom":"^19.2.4","esbuild":"^0.28.1","jsdom":"^28.0.0","react-dom":"^19.2.8","rollup":"^4.62.4","tslib":"^2.8.1","typescript":"^5.7.3","vitest":"^4.1.10"},"peerDependencies":{"react":">=18"},"engines":{"node":">=24.11.0"},"gitHead":"6f8864937009ffa8f859cf55ba4ca678eb542373","_id":"@berrydev-ai/plugin-llm-wiki@0.1.3","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-l7Qv55wjSNynJ0b0oWv7v1wbSBu4aOZ7DofBI74aKeSLzT0QLmAkfkLkCHLczQ0AfnbffWAq5qEklSvSaFHbpg==","shasum":"cbd28f040288ae97d2a7a91af6158dc5cb33b290","tarball":"https://registry.npmjs.org/@berrydev-ai/plugin-llm-wiki/-/plugin-llm-wiki-0.1.3.tgz","fileCount":32,"unpackedSize":2631697,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDXfC6t2Csr2biJ2d4sFqFkKBekMVvqHhOWHP6sbvmFjQIhAMmPKEJlXbB+ETOz/NHe+t8XzFKsNK83FNFBprptpjz9"}]},"_npmUser":{"name":"coderberry","email":"coderberry@gmail.com"},"directories":{},"maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-llm-wiki_0.1.3_1787608391367_0.1471450797585765"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-22T13:43:28.874Z","modified":"2026-08-24T21:53:11.690Z","0.1.1":"2026-08-22T13:43:29.275Z","0.1.2":"2026-08-22T14:26:30.818Z","0.1.3":"2026-08-24T21:53:11.536Z"},"bugs":{"url":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki/issues"},"author":{"name":"Berry Development"},"license":"MIT","homepage":"https://github.com/berrydev-ai/paperclip-plugin-llm-wiki#readme","keywords":["paperclip","plugin","automation","wiki","knowledge"],"repository":{"type":"git","url":"git+https://github.com/berrydev-ai/paperclip-plugin-llm-wiki.git"},"description":"Local-file LLM Wiki plugin for source ingestion, wiki browsing, query, lint, and maintenance workflows. Maintained fork of @paperclipai/plugin-llm-wiki.","maintainers":[{"name":"coderberry","email":"coderberry@gmail.com"}],"readme":"# LLM Wiki\n\nLocal-file LLM Wiki plugin for source ingestion, wiki browsing, query, lint, and maintenance workflows.\n\n> **Maintained fork.** This is `@berrydev-ai/plugin-llm-wiki`, a fork of the LLM\n> Wiki plugin from the [Paperclip monorepo](https://github.com/paperclipai/paperclip).\n> It exists because the upstream `@paperclipai/plugin-llm-wiki@0.1.0` on npm is\n> uninstallable — it ships a template named `.gitignore`, which npm renames to\n> `.npmignore` on install, so the manifest throws `ENOENT` at load. See\n> [UPSTREAM.md](UPSTREAM.md) for the fork policy and how to sync from upstream.\n\n## Install\n\n```bash\npaperclipai plugin install @berrydev-ai/plugin-llm-wiki\n```\n\nThe manifest still declares the plugin id `paperclipai.plugin-llm-wiki`, so an\ninstance that already had the upstream plugin installed keeps its wiki data and\napplied migrations.\n\n## Development\n\nRequires Node 24 (see `.nvmrc`). Node 26 ships an experimental native\n`localStorage` that shadows jsdom's and breaks the UI tests.\n\n```bash\nnpm install\nnpm run build\nnpm test\n```\n\n`npm test` includes `tests/packaging.spec.ts`, which packs the package, installs\nthe tarball for real, and loads the installed manifest — the guard against\nreintroducing the packaging bug that motivated this fork.\n\n## Scope\n\nThis package is the standalone home for LLM Wiki behavior. Wiki-specific routes,\nUI, prompts, tools, local-folder templates, migrations, fixtures, and tests live\nhere rather than in Paperclip core.\n\nThe alpha surface includes:\n\n- manifest-declared Wiki page, sidebar entry, and settings page\n- trusted local folder declaration for `raw/`, `wiki/`, `AGENTS.md`, `IDEA.md`, `wiki/index.md`, and `wiki/log.md`\n- plugin database namespace migration for wiki instances, sources, pages, operations, query sessions, and resource bindings\n- managed `Wiki Maintainer` agent, managed `LLM Wiki` project, and paused managed routines for wiki update processing, lint, and index refresh\n- plugin-operation issue creation using `surfaceVisibility: \"plugin_operation\"`\n- operation reconciliation from Paperclip issue/run lifecycle events, including run IDs, terminal status, affected pages, and issue-scoped cost summaries\n- local source capture into `raw/` with metadata rows in the plugin DB namespace\n- opt-in company-scoped Paperclip event ingestion controls for issues, comments, and documents; event ingestion is disabled by default and routes captured raw provenance into the default space only\n- manual Paperclip project/root issue distillation and bounded backfill actions with explicit work items, operation issues, source caps, and estimated cost recording\n- Paperclip-derived distillation (cursor windows, manual `distill-now`, backfill) always writes into the default wiki space in Phase 1; non-default spaces remain on manual / raw-file ingest until per-space Paperclip ingestion profiles ship\n- Paperclip-derived distillation maintains `wiki/projects//standup.md` as the executive current-state view for each represented project, alongside durable `wiki/projects//index.md` knowledge pages\n- wiki page writes with plugin path validation, atomic local-folder writes, metadata/revision rows, backlink extraction, and optional stale-hash protection\n- wiki tools for search/read/write/propose patch/source/log/index/backlinks workflows\n\n## Phase 5 Security Gate\n\nPaperclip-derived text ingestion stays limited to issue titles/descriptions, issue comments, and issue documents.\n\n- Issue attachments/assets are **metadata-only** in Phase 5.\n- Issue work products are **metadata-only** in Phase 5.\n- The wiki must not fetch `/api/assets/:id/content`, dereference work-product `url` fields, or store those capability-bearing links in source bundles/snapshots.\n\nThe accepted policy lives in [doc/plans/2026-05-06-llm-wiki-paperclip-asset-security-gate.md](../../../doc/plans/2026-05-06-llm-wiki-paperclip-asset-security-gate.md).\n\n## Development\n\n```bash\npnpm install\npnpm dev # watch builds\npnpm dev:ui # local dev server with hot-reload events\npnpm test\n```\n\nFrom the Paperclip repo root:\n\n```bash\npnpm --filter @paperclipai/plugin-llm-wiki typecheck\npnpm --filter @paperclipai/plugin-llm-wiki test\npnpm --filter @paperclipai/plugin-llm-wiki build\n```\n\n## Alpha Verification\n\nRun these commands from the Paperclip repo root before handing off alpha plugin\nchanges:\n\n```bash\npnpm --filter @paperclipai/plugin-llm-wiki typecheck\npnpm --filter @paperclipai/plugin-llm-wiki test\npnpm --filter @paperclipai/plugin-llm-wiki build\n```\n\nThe focused Vitest suite covers:\n\n- standalone package boundaries and package-local harness dependencies\n- required local folder bootstrap writes\n- raw source capture plus ingest metadata persistence\n- hidden plugin-operation issue creation for ingest/query/file-as-page workflows\n- disabled and enabled Paperclip event ingestion paths\n- managed routine declarations, manual distill/backfill work items, source cap handling, and backfill project/date scoping\n- atomic page writes, metadata/revision rows, backlinks, and stale-hash refusal\n- query session creation, run-id recording, stream event forwarding, and completion updates\n- idempotent operation lifecycle and cost-event reconciliation\n- filing a streamed query answer back into the wiki through a hidden operation\n\nRemaining alpha gaps:\n\n- Paperclip currently declares `cost_event.created` for plugins but does not publish it when cost rows are created. Issue-scoped operation costs still reconcile through orchestration summaries; standalone query-session spend needs the host to publish the declared event before it can be attributed live.\n- Browser screenshot capture is maintained separately under `tests/screenshots`;\n generated `screenshots/` outputs are local artifacts and are ignored by git.\n- Host-level plugin install and live agent invocation still need Paperclip\n server/runtime smoke coverage when preparing a release candidate.\n\n\n\n## Install Into Paperclip\n\n```bash\ncurl -X POST http://127.0.0.1:3100/api/plugins/install \\\n -H \"Content-Type: application/json\" \\\n -d '{\"packageName\":\"/Users/dotta/paperclip/.paperclip/worktrees/PAP-3179-design-a-llm-wiki-plugin/packages/plugins/plugin-llm-wiki\",\"isLocalPath\":true}'\n```\n\n## Build Options\n\n- `pnpm build` uses esbuild presets from `@paperclipai/plugin-sdk/bundlers`.\n- `pnpm build:rollup` uses rollup presets from the same SDK.\n\nAfter changing manifest-loaded assets such as skills, agent instructions, or\ntemplates, recompile the local plugin before re-enabling it:\n\n```bash\npnpm --filter @paperclipai/plugin-llm-wiki build\n```\n\nThe package-local `dist/` directory is ignored by git, but local Paperclip\ninstalls load the compiled `dist/manifest.js` and `dist/worker.js` files at\nruntime. If activation failed before the rebuild, re-enable the plugin or\nrestart the Paperclip dev server so the host imports the fresh bundle.\n\n## Local File Layout\n\n```text\n/\n AGENTS.md\n IDEA.md\n .gitignore\n raw/\n .gitkeep\n wiki/\n index.md\n log.md\n sources/\n .gitkeep\n projects/\n .gitkeep\n /\n index.md\n standup.md\n decisions.md\n history.md\n entities/\n .gitkeep\n concepts/\n .gitkeep\n synthesis/\n .gitkeep\n```\n\nUse the settings page or `bootstrap-root` action to configure the folder and\nwrite the starter files. The plugin uses Paperclip's local folder API for path\ncontainment, symlink checks, read/write validation, and atomic writes.\n\nBootstrap preserves existing files rather than overwriting operator edits. The\ndefault first-install skeleton is copied from the vanilla LLM Wiki layout, with\n`CLAUDE.md` renamed to `AGENTS.md` and Paperclip project overviews, standups,\ndecisions, and history kept together under `wiki/projects//`.\n\n## Managed Agent Instructions\n\nPlugin-managed agent instruction bundles live under:\n\n```text\nagents//AGENTS.md\n```\n\nFor this plugin the Wiki Maintainer source bundle is `agents/wiki-maintainer/AGENTS.md`.\nAny additional files in that folder are installed as sibling instruction files\nfor the managed agent. The settings health check reports drift from these\ndefaults, and resetting the managed agent asks for confirmation before replacing\ncustomized instructions.\n","readmeFilename":"README.md"}