pluribus-context 0.3.18 → 0.3.20

package/CHANGELOG.md

@@ -1,9 +1,21 @@
 # Changelog
 
+## 0.3.20 - 2026-05-18
+
+- Added a 60-second native-vs-fallback smoke to the community review packet so directory/list reviewers can see Bob native `.bob/rules/*.md` differ from OpenClaw/AGENTS.md generic fallback.
+- Extended `npm run review:smoke` to execute that fidelity demo against the published npm package and assert `nativeDiscoverySurface`, `genericFallback`, and `manualActivationRequired` fields.
+
 ## [Unreleased]
 
 All notable changes to Pluribus are documented here.
 
+## 0.3.19 — Bob native discovery target
+
+### Added
+
+- Add a built-in `bob` adapter that writes `.bob/rules/pluribus.md`, so Pluribus can test native discovery surfaces instead of forcing Bob-style rules through generic `AGENTS.md` fallback.
+- Extend public docs, quickstart, contributor guidance, and portability fidelity examples with Bob rules as a target for native-discovery vs generic-fallback review.
+
 ## 0.3.18 — fidelity audit discovery positioning
 
 ### Changed

package/README.md

@@ -8,7 +8,7 @@
 
 > Detect where AI-agent context loses fidelity across tools — then sync the parts that can be safely shared.
 
-Pluribus (`pluribus-context` on npm, `pluribus` on the command line) is an AI context sync CLI with AI-agent context fidelity audit for teams and projects that use Claude Code, Cursor, GitHub Copilot, OpenClaw, Windsurf, Continue, or Zed.
+Pluribus (`pluribus-context` on npm, `pluribus` on the command line) is an AI context sync CLI with AI-agent context fidelity audit for teams and projects that use Claude Code, Cursor, GitHub Copilot, OpenClaw, Windsurf, Continue, Zed, or Bob.
 
 It shows where instructions keep their semantics, where they are downgraded to a generic fallback, and where manual activation or native discovery matters — then keeps project instructions, conventions, constraints, and team context in one versioned source of truth.
 
@@ -20,7 +20,7 @@ It is **not** a persistent memory layer, retrieval system, agent orchestrator, o
 
 ## The Problem
 
-You use Claude, Copilot, Cursor, Windsurf, Continue, Zed, ChatGPT, and whatever ships next Tuesday.
+You use Claude, Copilot, Cursor, Windsurf, Continue, Zed, Bob, ChatGPT, and whatever ships next Tuesday.
 
 Each one has its own way of understanding your project:
 - `CLAUDE.md` for Claude Code
@@ -30,6 +30,7 @@ Each one has its own way of understanding your project:
 - `.windsurf/rules/pluribus.md` for Windsurf Cascade
 - `.continue/rules/pluribus.md` for Continue
 - `.rules` for Zed
+- `.bob/rules/pluribus.md` for Bob
 
 You end up maintaining **5+ files** that say roughly the same thing — your project's architecture, conventions, tech stack, who you are, what matters. Copy-paste across files. They drift. They rot. You forget to update one. Your AI gives you wrong answers because it's reading stale context.
 
@@ -64,6 +65,7 @@ And it generates the right files for each tool:
 - `.windsurf/rules/pluribus.md` ← for Windsurf Cascade
 - `.continue/rules/pluribus.md` ← for Continue
 - `.rules` ← for Zed
+- `.bob/rules/pluribus.md` ← for Bob
 
 **One source of truth. Zero drift.**
 
@@ -103,7 +105,7 @@ Pluribus is intentionally narrow about filesystem changes:
 
 - `audit`, `validate`, and `sync --dry-run` are read-only.
 - `init` writes `pluribus.md` only. If that file already exists, it refuses to overwrite it.
-- `sync` writes only the configured/generated AI context files such as `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, `AGENTS.md`, Windsurf/Continue rules, and `.rules`.
+- `sync` writes only the configured/generated AI context files such as `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, `AGENTS.md`, Windsurf/Continue rules, Zed `.rules`, and Bob `.bob/rules/pluribus.md`.
 - Generated files include a `Generated by Pluribus ... do not edit manually` header so drift is easy to spot in review.
 - Remote imports only touch `pluribus.lock.json` and `.pluribus/cache/remote/` when you explicitly pass `--update-imports`.
 
@@ -272,7 +274,7 @@ npx --yes pluribus-context@latest audit --strict --json --output pluribus-audit.
 
 The JSON shape is documented in [`schemas/audit-result.schema.json`](schemas/audit-result.schema.json) so CI wrappers and dashboards can validate integrations without scraping human output. For copy-paste enforcement, see the [CI audit example](docs/ci-audit-example.md) and the [Pre-commit Audit Hook](docs/pre-commit-audit.md).
 
-If your project does not have `pluribus.md` yet, `pluribus audit` scans for known AI context files (`CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf, Continue, Zed) so you know what to migrate.
+If your project does not have `pluribus.md` yet, `pluribus audit` scans for known AI context files (`CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf, Continue, Zed, Bob) so you know what to migrate.
 
 **6. Sync to all your tools**
 
@@ -336,6 +338,7 @@ pluribus watch --once --tools claude,cursor
 | `openclaw` | `AGENTS.md` | OpenClaw agent runner |
 | `copilot` | `.github/copilot-instructions.md` | GitHub Copilot |
 | `zed` | `.rules` | Zed Editor |
+| `bob` | `.bob/rules/pluribus.md` | Bob rules |
 | `windsurf` | `.windsurf/rules/pluribus.md` | Windsurf Cascade workspace rules |
 | `continue` | `.continue/rules/pluribus.md` | Continue workspace rules |
 
@@ -362,6 +365,7 @@ See `spec/skills-format.md` for the skill file format.
 - [x] Copilot integration (built-in skill)
 - [x] Claude Code integration (built-in skill)
 - [x] Zed Editor integration (built-in skill)
+- [x] Bob rules integration (built-in skill)
 - [ ] Custom skill overrides (local `pluribus/skills/`)
 - [x] Windsurf integration (built-in workspace rule)
 - [x] Continue integration (built-in workspace rule)

package/docs/community-review-packet.md

@@ -4,11 +4,11 @@ Use this when reviewing Pluribus for a list, newsletter, package roundup, or too
 
 ## One-line description
 
-Pluribus keeps intentional AI coding context in one `pluribus.md` source of truth, then syncs or audits the tool-specific files used by Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, and Zed.
+Pluribus keeps intentional AI coding context in one `pluribus.md` source of truth, then syncs or audits the tool-specific files used by Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, Zed, and Bob.
 
 ## Short listing copy
 
-Pluribus is an open-source CLI for teams and solo developers who use multiple AI coding tools. It treats project instructions, conventions, constraints, and shared team context as versioned Markdown, then generates each tool's expected context file (`CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, and Zed rules). The safest first command is a read-only audit:
+Pluribus is an open-source CLI for teams and solo developers who use multiple AI coding tools. It treats project instructions, conventions, constraints, and shared team context as versioned Markdown, then generates each tool's expected context file (`CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, Zed rules, and Bob rules). The safest first command is a read-only audit:
 
 ```bash
 npx --yes pluribus-context@latest audit
@@ -26,9 +26,9 @@ Use these fields for directories, awesome lists, or review forms that ask for a
 | License | MIT |
 | Install / run | `npx --yes pluribus-context@latest audit` or `npm install -g pluribus-context@latest` |
 | Category | AI coding tools / context management |
-| Tags | `claude-code`, `cursor`, `copilot`, `openclaw`, `windsurf`, `continue`, `zed`, `context-drift` |
-| One sentence | Keep one versioned AI coding context in `pluribus.md`, then audit or sync the generated files used by Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, and Zed. |
-| 280-char blurb | Pluribus is an open-source CLI for intentional AI coding context. It keeps project guidance in one `pluribus.md`, then audits or syncs `CLAUDE.md`, Cursor rules, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, and Zed rules. |
+| Tags | `claude-code`, `cursor`, `copilot`, `openclaw`, `windsurf`, `continue`, `zed`, `bob`, `context-drift` |
+| One sentence | Keep one versioned AI coding context in `pluribus.md`, then audit or sync the generated files used by Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, Zed, and Bob. |
+| 280-char blurb | Pluribus is an open-source CLI for intentional AI coding context. It keeps project guidance in one `pluribus.md`, then audits or syncs `CLAUDE.md`, Cursor rules, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, Zed rules, and Bob rules. |
 | Safe first command | `npx --yes pluribus-context@latest audit` |
 
 ### Awesome-list Markdown entry
@@ -36,7 +36,7 @@ Use these fields for directories, awesome lists, or review forms that ask for a
 Use this exact line when a curated list accepts one Markdown bullet per tool:
 
 ```markdown
-- [Pluribus](https://github.com/caioribeiroclw-pixel/pluribus) - Open-source CLI that keeps one versioned AI coding context in sync across Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, and Zed.
+- [Pluribus](https://github.com/caioribeiroclw-pixel/pluribus) - Open-source CLI that keeps one versioned AI coding context in sync across Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, Zed, and Bob.
 ```
 
 ## Why it may be useful
@@ -54,7 +54,7 @@ Use this section when a directory, list maintainer, or reviewer asks how Pluribu
 | --- | --- |
 | What category is it? | AI coding context management / rules sync CLI. |
 | What is the source of truth? | `pluribus.md`, reviewed in git. |
-| What does it generate? | Tool-native context files for Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, and Zed. |
+| What does it generate? | Tool-native context files for Claude Code, Cursor, Copilot, OpenClaw, Windsurf, Continue, Zed, and Bob. |
 | What is the safe first step? | Run `npx --yes pluribus-context@latest audit` to inspect existing context files without writing. |
 | When is another tool enough? | If you only need one tool's native rules format or a one-time converter, a smaller rules manager/converter may be enough. |
 | What is Pluribus not? | Not chat memory, retrieval, vector search, agent orchestration, or agent merging. |
@@ -91,6 +91,24 @@ Expected result:
 - `sync --dry-run` previews generated context files without writing them.
 - `audit --ci` may exit `1` before generated files are synced; that is expected when outputs are missing or drifted.
 
+## 60-second native-vs-fallback smoke
+
+Use this when reviewing the fidelity-audit positioning. It demonstrates the difference between a native tool discovery surface and a generic fallback in a clean directory:
+
+```bash
+mkdir pluribus-fidelity && cd pluribus-fidelity
+npx --yes pluribus-context@latest init --name "Fidelity review" --description "Native vs fallback smoke" --tools bob,openclaw
+npx --yes pluribus-context@latest sync
+npx --yes pluribus-context@latest audit --json --fidelity-report --output fidelity.json
+node -e "const r=require('./fidelity.json'); console.log(r.fidelityReport.targets.map(t => ({ toolId: t.toolId, file: t.files[0], nativeDiscoverySurface: t.nativeDiscoverySurface, genericFallback: t.genericFallback, manualActivationRequired: t.manualActivationRequired })))"
+```
+
+Expected result:
+
+- Bob writes `.bob/rules/pluribus.md` and reports `nativeDiscoverySurface: ".bob/rules/*.md"`, `genericFallback: false`, `manualActivationRequired: false`.
+- OpenClaw writes `AGENTS.md` and reports `nativeDiscoverySurface: "AGENTS.md"`, `genericFallback: true`, `manualActivationRequired: false`.
+- This is the core Pluribus distinction for reviewers: generated file exists is not enough; the report should show whether the target uses native discovery or a generic fallback.
+
 ## Useful links
 
 - npm package: <https://www.npmjs.com/package/pluribus-context>

package/docs/portability-fidelity-report.md

@@ -1,6 +1,6 @@
 # Portability Fidelity Report
 
-Use this when a rule pack, skill bundle, `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, or Copilot instruction file claims to be portable across AI coding tools.
+Use this when a rule pack, skill bundle, `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, Bob `.bob/rules/*.md`, or Copilot instruction file claims to be portable across AI coding tools.
 
 The goal is not to prove that every tool behaves identically. The goal is to make portability claims falsifiable: which tools were tested, which capabilities are required, where semantics are lossy, and what evidence a reviewer can inspect.
 
@@ -46,6 +46,8 @@ portability:
       evidence: generated .cursorrules smoke-reviewed on 2026-05-18
     - target: github-copilot
       evidence: generated .github/copilot-instructions.md smoke-reviewed on 2026-05-18
+    - target: bob
+      evidence: generated .bob/rules/pluribus.md smoke-reviewed on 2026-05-18
   requiredCapabilities:
     - read repository instructions before planning
     - preserve generated-file warning
@@ -84,7 +86,7 @@ That does **not** prove runtime behavior. You still need tool-specific smoke tes
 
 For each selected target, the JSON report includes:
 
-- `nativeDiscoverySurface` — the file or directory pattern the target normally discovers, such as `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, or `AGENTS.md`.
+- `nativeDiscoverySurface` — the file or directory pattern the target normally discovers, such as `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, `AGENTS.md`, or Bob `.bob/rules/*.md`.
 - `resolutionAnchor` — where the generated surface is resolved from today (`repo-root` for built-in targets).
 - `genericFallback` — whether the output is a broad agent fallback surface rather than a target-specific native surface.
 - `manualActivationRequired` — whether Pluribus knows the output requires manual activation after generation. Built-in project-wide targets are currently `false`; future scoped/skill targets may differ.

package/docs/quickstart.md

@@ -2,7 +2,7 @@
 
 Use this when you want to try Pluribus without touching a real project yet.
 
-Pluribus takes one intentional context file (`pluribus.md`) and generates the tool-specific files your AI tools expect: `CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, and Zed `.rules`.
+Pluribus takes one intentional context file (`pluribus.md`) and generates the tool-specific files your AI tools expect: `CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, Zed `.rules`, and Bob `.bob/rules/pluribus.md`.
 
 Already have one or more of those files? Start with a read-only inventory before replacing anything:
 
@@ -14,7 +14,7 @@ Without `pluribus.md`, audit lists existing AI context surfaces so you can decid
 
 ## What Pluribus writes
 
-The safest path is audit → validate → `sync --dry-run` → `sync`. The first three steps are read-only. `init` writes only `pluribus.md`, and `sync` writes only generated AI context files for the tools you selected (`CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, or Zed `.rules`). Generated files include a `Generated by Pluribus ... do not edit manually` header, so direct edits show up as drift in `pluribus audit`.
+The safest path is audit → validate → `sync --dry-run` → `sync`. The first three steps are read-only. `init` writes only `pluribus.md`, and `sync` writes only generated AI context files for the tools you selected (`CLAUDE.md`, `.cursorrules`, Copilot instructions, `AGENTS.md`, Windsurf/Continue rules, Zed `.rules`, or Bob `.bob/rules/pluribus.md`). Generated files include a `Generated by Pluribus ... do not edit manually` header, so direct edits show up as drift in `pluribus audit`.
 
 Remote imports do not refresh silently; Pluribus writes `pluribus.lock.json` and `.pluribus/cache/remote/` only when you explicitly pass `--update-imports`.
 
@@ -72,6 +72,7 @@ Choose the comma-separated `--tools` list that matches your repo. The built-in a
 | `windsurf` | `.windsurf/rules/pluribus.md` |
 | `continue` | `.continue/rules/pluribus.md` |
 | `zed` | `.rules` |
+| `bob` | `.bob/rules/pluribus.md` |
 
 You can also run `npx --yes pluribus-context@latest --help` to see the current supported tool ids from the CLI itself.
 

package/examples/portability-fidelity/pluribus.md

@@ -1,4 +1,4 @@
-<!-- pluribus:tools: claude,cursor,copilot,openclaw -->
+<!-- pluribus:tools: claude,cursor,copilot,openclaw,bob -->
 
 # Identity
 This repository publishes an AI rule or skill bundle that claims portability across Claude Code, Cursor, GitHub Copilot, and AGENTS.md-compatible coding agents.
@@ -7,7 +7,7 @@ The bundle should be treated as portable only when its required capabilities, te
 
 # Stack
 - Source format: Markdown rules/skills maintained in git.
-- Generated targets: `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, and `AGENTS.md`.
+- Generated targets: `CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`, `AGENTS.md`, and `.bob/rules/pluribus.md`.
 - Review command: `npx --yes pluribus-context@latest sync --dry-run`.
 - Drift command: `npx --yes pluribus-context@latest audit --json`.
 
@@ -32,6 +32,8 @@ portability:
       evidence: generated .github/copilot-instructions.md smoke-reviewed
     - target: agents-md
       evidence: generated AGENTS.md smoke-reviewed
+    - target: bob
+      evidence: generated .bob/rules/pluribus.md smoke-reviewed
   requiredCapabilities:
     - load repository instructions before planning
     - preserve generated-file warning

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pluribus-context",
-  "version": "0.3.18",
-  "description": "AI context/rules sync and fidelity audit CLI for CLAUDE.md, Claude Code, Cursor rules, Copilot instructions, OpenClaw, Windsurf, Continue, and Zed semantic drift.",
+  "version": "0.3.20",
+  "description": "AI context/rules sync and fidelity audit CLI for CLAUDE.md, Claude Code, Cursor rules, Copilot instructions, OpenClaw, Windsurf, Continue, Zed, Bob, and semantic drift.",
   "type": "module",
   "homepage": "https://github.com/caioribeiroclw-pixel/pluribus#readme",
   "repository": {
@@ -77,7 +77,9 @@
     "semantic-loss",
     "native-discovery",
     "agent-context-audit",
-    "agent-memory"
+    "agent-memory",
+    "bob",
+    "bob-rules"
   ],
   "author": "Caio Ribeiro",
   "license": "MIT",

package/src/commands/audit.js

@@ -376,6 +376,7 @@ function inferDiscovery(toolId, outputFiles) {
     windsurf: '.windsurf/rules/*.md',
     continue: '.continue/rules/*.md',
     zed: '.rules',
+    bob: '.bob/rules/*.md',
   }
 
   return {

package/src/skills/built-in.js

@@ -338,6 +338,54 @@ alwaysApply: true
 ## Anti-patterns
 {{anti-patterns}}
 {{/if}}
+`,
+  },
+
+  bob: {
+    id: 'bob',
+    outputFiles: ['.bob/rules/pluribus.md'],
+    required: ['conventions', 'constraints'],
+    optional: ['identity', 'stack', 'goals', 'anti-patterns', 'workflow', 'context'],
+    template: `<!-- Generated by Pluribus {{pluribus.version}} on {{pluribus.date}} — do not edit manually -->
+<!-- Source: {{pluribus.source}} -->
+
+# Pluribus Project Rules for Bob
+
+{{#if identity}}
+## Project
+{{identity}}
+
+{{/if}}
+{{#if stack}}
+## Stack
+{{stack}}
+
+{{/if}}
+## Conventions
+{{conventions}}
+
+## Constraints
+{{constraints}}
+
+{{#if goals}}
+## Goals
+{{goals}}
+
+{{/if}}
+{{#if workflow}}
+## Workflow
+{{workflow}}
+
+{{/if}}
+{{#if anti-patterns}}
+## Anti-patterns
+{{anti-patterns}}
+
+{{/if}}
+{{#if context}}
+## Additional Context
+{{context}}
+{{/if}}
 `,
   },
 }

package/src/utils/version.js

@@ -1 +1 @@
-export const VERSION = '0.3.18'
+export const VERSION = '0.3.20'