{
  "$schema_note": "Machine-readable documentation index for docs/packages/README.md. Edit this file, then: bun run packages:docs-index. CI: bun run packages:docs-index:check. Optional: --bump-verified or --bump-verified=id1,id2.",
  "lastUpdated": "2026-07-28",
  "capabilityMap": "AGENTS.md#grounded-capability-map",
  "legends": {
    "type": {
      "canonical": "bun.com official docs",
      "policy": "FactoryWager install / monorepo SSOT",
      "internal": "harness runbook",
      "generated": "machine-written artifact"
    },
    "status": {
      "active": "maintained and trustworthy",
      "stale": "needs re-verify before relying",
      "planned": "stub or incomplete",
      "archived": "out of install graph / historical only"
    }
  },
  "docs": [
    {
      "id": "registry-md",
      "doc": "REGISTRY.md",
      "href": "./REGISTRY.md",
      "role": "Generated package table — refresh with bun run packages:list --write",
      "type": "generated",
      "status": "active",
      "audience": ["developers"],
      "lastVerified": "2026-07-28",
      "format": "markdown (generated)",
      "groundedCapabilities": ["Bun.Glob (scanFilesSync)", "Bun.file / readJson", "Bun.write"],
      "maintainer": "docs / packages tooling",
      "triggers": ["new workspace member", "version bump", "triage change"],
      "relatedCommands": ["bun run packages:list", "bun run packages:list --write"]
    },
    {
      "id": "monorepo-workspaces",
      "doc": "monorepo-workspaces.md",
      "href": "../harness/tenants/monorepo-workspaces.md",
      "role": "Hybrid workspace graph · catalog · filter runbook · Bun canonical refs",
      "type": "internal",
      "status": "active",
      "audience": ["devops", "contributors"],
      "lastVerified": "2026-07-28",
      "format": "markdown",
      "groundedCapabilities": ["workspace globs", "catalog:", "bun run --filter", "bun outdated --filter"],
      "maintainer": "platform",
      "triggers": ["Bun PM upgrade", "workspace membership change"],
      "relatedCommands": ["bun run validate:workspaces", "bun run --filter '*'", "bun outdated --filter"]
    },
    {
      "id": "monorepo-filter-section",
      "doc": "monorepo-workspaces § bun --filter",
      "href": "../harness/tenants/monorepo-workspaces.md#bun---filter-canonical",
      "role": "Name vs ./path · install · outdated · parallel · type:toml pitfall",
      "type": "internal",
      "status": "active",
      "audience": ["all operators"],
      "lastVerified": "2026-07-28",
      "format": "markdown (section)",
      "groundedCapabilities": ["--filter", "--if-present", "--parallel", "--sequential", "--workspaces"],
      "maintainer": "platform",
      "triggers": ["Bun filter semantics change"],
      "relatedCommands": ["bun run --parallel --filter '*'", "bun install --filter", "bun outdated --filter"]
    },
    {
      "id": "unified-catalogs",
      "doc": "UNIFIED.md § catalogs",
      "href": "../UNIFIED.md#catalogs-and-workspace-protocols",
      "role": "Install + catalog policy · scripts vs filter · type:toml warning",
      "type": "policy",
      "status": "active",
      "audience": ["all"],
      "lastVerified": "2026-07-28",
      "format": "markdown",
      "groundedCapabilities": ["catalog:", "workspace:*", "frozenLockfile", "install.exact"],
      "maintainer": "platform",
      "triggers": ["install policy change", "catalog pin bump"],
      "relatedCommands": ["bun install", "bun run validate:workspaces"]
    },
    {
      "id": "unified-scripts-filter",
      "doc": "UNIFIED § Scripts vs --filter",
      "href": "../UNIFIED.md#scripts-vs---filter",
      "role": "Root scripts vs package --filter · docs UI facet warning",
      "type": "policy",
      "status": "active",
      "audience": ["all"],
      "lastVerified": "2026-07-28",
      "format": "markdown (section)",
      "groundedCapabilities": ["root bun run", "package --filter"],
      "maintainer": "platform",
      "triggers": ["new root ops scripts"],
      "relatedCommands": ["bun run ops:*", "bun run --filter <pkg>"]
    },
    {
      "id": "pm-filter",
      "doc": "pm/filter",
      "href": "https://bun.com/docs/pm/filter",
      "role": "Canonical workspace package selector",
      "type": "canonical",
      "status": "active",
      "audience": ["all"],
      "lastVerified": "2026-07-28",
      "format": "external HTML",
      "groundedCapabilities": ["bun run --filter", "bun install --filter", "bun outdated --filter"],
      "maintainer": "Bun OSS",
      "triggers": [],
      "relatedCommands": ["bun run --filter", "bun outdated --filter", "bun install --filter"]
    },
    {
      "id": "pm-outdated",
      "doc": "pm/cli/outdated",
      "href": "https://bun.com/docs/pm/cli/outdated",
      "role": "Outdated deps; supports --filter",
      "type": "canonical",
      "status": "active",
      "audience": ["all"],
      "lastVerified": "2026-07-28",
      "format": "external HTML",
      "groundedCapabilities": ["bun outdated --filter"],
      "maintainer": "Bun OSS",
      "triggers": [],
      "relatedCommands": ["bun outdated", "bun outdated --filter"]
    },
    {
      "id": "pm-workspaces",
      "doc": "pm/workspaces",
      "href": "https://bun.com/docs/pm/workspaces",
      "role": "Workspace globs · workspace: protocol",
      "type": "canonical",
      "status": "active",
      "audience": ["all"],
      "lastVerified": "2026-07-28",
      "format": "external HTML",
      "groundedCapabilities": ["workspaces", "workspace:*"],
      "maintainer": "Bun OSS",
      "triggers": [],
      "relatedCommands": ["bun install", "bun pm ls"]
    },
    {
      "id": "pm-catalogs",
      "doc": "pm/catalogs",
      "href": "https://bun.com/docs/pm/catalogs",
      "role": "Shared version SSOT · catalog:",
      "type": "canonical",
      "status": "active",
      "audience": ["all"],
      "lastVerified": "2026-07-28",
      "format": "external HTML",
      "groundedCapabilities": ["catalog", "catalog:"],
      "maintainer": "Bun OSS",
      "triggers": [],
      "relatedCommands": ["bun install", "bun outdated"]
    }
  ]
}