@agentskit/doc-bridge 1.9.0 → 1.10.0

package/docs/spec/config-v1.md

@@ -478,6 +478,8 @@ areas?: {
   depth?: number
   /** Directories that contain areas rather than being one. */
   roots?: string[]
+  /** Glob patterns for directories that hold code without being a unit of architecture. */
+  exclude?: string[]
 }
 ```
 
@@ -486,8 +488,16 @@ modules. `src` is not an area in any useful sense; `src/query` is. So `roots` na
 directories that hold areas — by default `src`, `lib`, `app`, `source`, `server`, `client`,
 `packages`, `apps` — and `depth` says how many levels below such a root an area sits.
 
+`exclude` names what the convention gets wrong in the other direction. A monorepo where every
+package keeps `tests/` and `fixtures/` beside `src/` derives an area per directory, and
+connectivity then asks for a document about a folder of test data — on one 26-package monorepo,
+43 of 81 undocumented areas were exactly that. A candidate matching an exclude pattern is not
+derived, and its modules fall to the most specific area that still encloses them, or to none,
+which is the honest answer for a folder of fixtures.
+
 Areas are derived, never declared, with one exception that matters: **any path an ownership record
-names becomes an area**, whatever the convention says. A configuration that reads
+names becomes an area**, whatever the convention says — including a path `exclude` matches, because
+a person saying a directory is a unit outranks a pattern saying it is not. A configuration that reads
 `path: "src/mcp"` is a human stating that the directory is a unit, and the graph should have an
 entity for it. Such an area carries `metadata.ownershipId`, which is what lets an agent document
 declaring `id` plus `editRoot` resolve to the thing it owns.

package/mcpb/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "doc-bridge",
   "display_name": "Doc Bridge",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Deterministic repository handoffs for coding agents, running locally without an LLM or API key.",
   "long_description": "Doc Bridge turns a repository's own documentation and ownership metadata into deterministic handoffs: where an agent should start, which paths it may edit, which checks it must run, and when a human must take over. The local connector exposes the same read-only contract available through Doc Bridge CLI and CI.",
   "author": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/doc-bridge",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "mcpName": "io.github.AgentsKit-io/doc-bridge",
   "description": "Human↔agent documentation bridge — deterministic handoffs, doc-site links, memory→docs, optional AgentsKit RAG/chat.",
   "type": "module",
@@ -123,28 +123,28 @@
   },
   "devDependencies": {
     "@agentskit/chat": "0.4.1",
-    "@agentskit/core": "1.12.8",
+    "@agentskit/core": "1.12.9",
     "@agentskit/ink": "0.10.9",
     "@agentskit/react": "0.8.3",
     "@anthropic-ai/mcpb": "2.1.2",
     "@changesets/cli": "^3.0.1",
     "@lhci/cli": "^0.15.1",
-    "@playwright/test": "1.62.1",
+    "@playwright/test": "1.63.0",
     "@tailwindcss/postcss": "4.3.3",
     "@types/mdast": "^4.0.4",
     "@types/node": "^26.4.0",
-    "@types/react": "19.2.18",
-    "@types/react-dom": "19.2.5",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
     "@vitest/coverage-v8": "4.1.11",
     "esbuild": "^0.28.2",
-    "fumadocs-core": "16.15.4",
+    "fumadocs-core": "16.15.10",
     "fumadocs-mdx": "15.4.0",
-    "fumadocs-ui": "16.15.4",
-    "lucide-react": "1.38.0",
-    "next": "16.3.3",
+    "fumadocs-ui": "16.15.10",
+    "lucide-react": "1.45.0",
+    "next": "16.3.5",
     "proxy-agent": "8.0.2",
-    "react": "19.2.8",
-    "react-dom": "19.2.8",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
     "tailwindcss": "4.3.3",
     "tsup": "^8.5.0",
     "vitest": "^4.1.11"

package/skills/doc-bridge-handoff/scripts/resolve-handoff.mjs

@@ -3,7 +3,7 @@
 import { spawnSync } from 'node:child_process'
 import { isAbsolute } from 'node:path'
 
-const VERSION = '1.9.0'
+const VERSION = '1.10.0'
 const kinds = new Set(['package', 'ownership'])
 const args = process.argv.slice(2)
 const id = args[0]

package/src/config/schema.ts

@@ -249,12 +249,21 @@ export const AnalysisConfigSchema = z
     /**
      * How code areas are derived — the unit of architecture between a package and a file.
      * `roots` names directories that contain areas rather than being one (`src` holds
-     * `src/query`); `depth` is how many levels below such a root an area sits.
+     * `src/query`); `depth` is how many levels below such a root an area sits; `exclude`
+     * names directories that hold code without being a unit of architecture.
      */
     areas: z
       .object({
         depth: z.number().int().min(1).max(8).optional(),
         roots: z.array(z.string().min(1).max(128)).max(32).optional(),
+        /**
+         * Glob patterns for directories that are not areas. A monorepo where every package
+         * keeps `tests/` and `fixtures/` beside `src/` derives one area per directory, and
+         * then connectivity asks for a document about a folder of test data. An ownership
+         * record naming an excluded path still makes it an area: a person saying a directory
+         * is a unit outranks a pattern saying it is not.
+         */
+        exclude: z.array(z.string().min(1).max(256)).max(64).optional(),
       })
       .strict()
       .optional(),

package/src/discovery/areas.ts

@@ -1,3 +1,5 @@
+import { minimatch } from 'minimatch'
+
 import { toPosix } from '../lib/paths.js'
 import { entityId } from './identity.js'
 
@@ -58,6 +60,15 @@ export type DeriveAreasOptions = {
   readonly ownership?: readonly AreaOwnership[]
   readonly depth?: number
   readonly roots?: readonly string[]
+  /**
+   * Glob patterns for directories that hold code without being a unit of architecture.
+   *
+   * A candidate that matches is not derived as an area, and its modules fall to the most
+   * specific area that still encloses them — or to none, which is the honest answer for a
+   * folder of fixtures. An ownership record naming the same path still wins: a person saying
+   * a directory is a unit outranks a pattern saying it is not.
+   */
+  readonly exclude?: readonly string[]
 }
 
 /*
@@ -124,11 +135,15 @@ export const deriveAreas = (options: DeriveAreasOptions): readonly DerivedArea[]
   const roots = options.roots ?? [...DEFAULT_AREA_ROOTS]
   const ownership = (options.ownership ?? []).map((record) => ({ ...record, path: normalize(record.path) }))
 
+  const excluded = options.exclude ?? []
+  const isExcluded = (path: string): boolean =>
+    excluded.some((pattern) => minimatch(path, pattern, { dot: true }))
+
   /** Candidate path to the package it belongs to. */
   const candidates = new Map<string, string>()
   for (const module of options.modules) {
     const path = conventionalAreaPath(module, depth, roots)
-    if (path && !candidates.has(path)) candidates.set(path, module.packageId)
+    if (path && !candidates.has(path) && !isExcluded(path)) candidates.set(path, module.packageId)
   }
   // An ownership record naming a directory that holds observed code is an area by declaration.
   for (const record of ownership) {

package/src/discovery/repository.ts

@@ -648,6 +648,7 @@ export const discoverRepository = (opts: DiscoveryOptions = {}): DiscoverySnapsh
     ownership: Object.entries(opts.config?.routing?.options?.ownership ?? {}).map(([id, record]) => ({ id, path: record.path })),
     ...(opts.config?.analysis?.areas?.depth !== undefined ? { depth: opts.config.analysis.areas.depth } : {}),
     ...(opts.config?.analysis?.areas?.roots !== undefined ? { roots: opts.config.analysis.areas.roots } : {}),
+    ...(opts.config?.analysis?.areas?.exclude !== undefined ? { exclude: opts.config.analysis.areas.exclude } : {}),
   })
   const areasById = new Map(areas.map((area) => [area.id, area]))
   const areasByPath = new Map(areas.map((area) => [area.path, area.id]))

package/src/version.ts

@@ -1 +1 @@
-export const PACKAGE_VERSION = '1.9.0'
+export const PACKAGE_VERSION = '1.10.0'