@agentskit/doc-bridge 1.11.2 → 1.12.0

package/ecosystem.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "$comment": "Canonical registry of AgentsKit ecosystem products. Stable identity lives in products[]. Numeric values live in the generated ecosystem-claims ledger. The deprecated properties array remains a v1 compatibility shim for sibling consumers; do not treat properties as the product catalog.",
+  "$comment": "Canonical seven-product AgentsKit catalog. The three-entry properties array is the legacy v1 compatibility projection; shared navigation is derived from products[].",
   "parentBrand": {
     "id": "agentskit",
     "name": "AgentsKit"
@@ -9,7 +9,15 @@
     "canonicalDescription": "AgentsKit is the open-source TypeScript ecosystem for building production AI agents without locking application architecture to a model provider, framework, database, or hosted platform.",
     "metaDescription": "Open-source TypeScript ecosystem for production AI agents. Swap models, providers, tools, memory, RAG, and interfaces without architectural lock-in.",
     "commercialBoundary": "The listed products are free and open source.",
-    "openSourceProductIds": ["agentskit", "registry", "agentskit-chat", "playbook", "doc-bridge", "code-review"],
+    "openSourceProductIds": [
+      "agentskit",
+      "registry",
+      "agentskit-chat",
+      "doc-bridge",
+      "code-review",
+      "harness",
+      "playbook"
+    ],
     "managedProductIds": []
   },
   "products": [
@@ -26,7 +34,7 @@
       "repo": "AgentsKit-io/agentskit",
       "accent": "#2EA043",
       "metadata": {
-        "alternateName": "AgentsKit.js",
+        "alternateName": "AgentsKit",
         "description": "A free, MIT-licensed TypeScript ecosystem for production AI agents with replaceable contracts for models, runtimes, tools, memory, RAG, observability, sandboxing, evaluation, and interfaces.",
         "dateCreated": "2026-04-02",
         "applicationCategory": "DeveloperApplication",
@@ -57,11 +65,21 @@
         "claimSource": {
           "url": "https://www.agentskit.io/api/stats.json",
           "claims": {
-            "packages": { "path": "counts.packages" },
-            "core-size-kb-gzip": { "path": "coreSizeKbGzip" },
-            "catalog-providers": { "path": "counts.catalogProviders" },
-            "native-adapters": { "path": "counts.nativeAdapters" },
-            "integrations": { "path": "counts.integrations" }
+            "packages": {
+              "path": "counts.packages"
+            },
+            "core-size-kb-gzip": {
+              "path": "coreSizeKbGzip"
+            },
+            "catalog-providers": {
+              "path": "counts.catalogProviders"
+            },
+            "native-adapters": {
+              "path": "counts.nativeAdapters"
+            },
+            "integrations": {
+              "path": "counts.integrations"
+            }
           }
         },
         "stage": "Build",
@@ -72,12 +90,30 @@
           "kind": "integration-stack",
           "headline": "Swap the stack. Keep the agent.",
           "metrics": [
-            { "value": "140+", "label": "providers" },
-            { "value": "25", "label": "adapters" },
-            { "value": "50", "label": "integrations" }
+            {
+              "value": "140+",
+              "label": "providers"
+            },
+            {
+              "value": "25",
+              "label": "adapters"
+            },
+            {
+              "value": "50",
+              "label": "integrations"
+            }
           ],
-          "capabilities": ["Tools", "RAG", "Memory", "MCP"],
-          "steps": ["Choose any adapter", "Add tools and memory", "Ship without rewrites"]
+          "capabilities": [
+            "Tools",
+            "RAG",
+            "Memory",
+            "MCP"
+          ],
+          "steps": [
+            "Choose any adapter",
+            "Add tools and memory",
+            "Ship without rewrites"
+          ]
         },
         "cta": "Build with AgentsKit"
       },
@@ -95,9 +131,10 @@
         "next": [
           "registry",
           "agentskit-chat",
-          "playbook",
           "doc-bridge",
-          "code-review"
+          "code-review",
+          "harness",
+          "playbook"
         ]
       }
     },
@@ -117,8 +154,16 @@
         "claimSource": {
           "url": "https://registry.agentskit.io/r/index.json",
           "claims": {
-            "agents": { "path": "agents", "aggregate": "length" },
-            "remaining-categories": { "path": "agents", "aggregate": "distinct", "field": "category", "subtract": 5 }
+            "agents": {
+              "path": "agents",
+              "aggregate": "length"
+            },
+            "remaining-categories": {
+              "path": "agents",
+              "aggregate": "distinct",
+              "field": "category",
+              "subtract": 5
+            }
           }
         },
         "stage": "Discover",
@@ -127,12 +172,20 @@
         "proof": "Ready-made · source-owned",
         "sales": {
           "kind": "registry-install",
-          "headline": "Source-owned agents for your project.",
+          "headline": "Inspect every file before it ships.",
           "metric": "Source-owned",
           "metricLabel": "agent code",
-          "capabilities": ["Ready-made agents", "Source ownership", "CLI installation"],
-          "steps": ["Find the right agent", "Run npx agentskit add", "Own every line"],
-          "command": "npx agentskit add research"
+          "capabilities": [
+            "Ready-made agents",
+            "Source ownership",
+            "CLI installation"
+          ],
+          "steps": [
+            "Find the right agent",
+            "Run npx @agentskit/cli add",
+            "Own every line"
+          ],
+          "command": "npx @agentskit/cli add research"
         },
         "cta": "Explore the Registry"
       },
@@ -150,9 +203,10 @@
         "next": [
           "agentskit",
           "agentskit-chat",
-          "playbook",
           "doc-bridge",
-          "code-review"
+          "code-review",
+          "harness",
+          "playbook"
         ]
       }
     },
@@ -179,12 +233,29 @@
           "metric": "One",
           "metricLabel": "agent experience",
           "logos": [
-            { "id": "human", "label": "Human" },
-            { "id": "agent", "label": "Agent" },
-            { "id": "tools", "label": "Tools" }
+            {
+              "id": "human",
+              "label": "Human"
+            },
+            {
+              "id": "agent",
+              "label": "Agent"
+            },
+            {
+              "id": "tools",
+              "label": "Tools"
+            }
           ],
-          "capabilities": ["Conversation", "Human control", "Tool results"],
-          "steps": ["Define the agent experience", "Connect the conversation surface", "Keep the human in control"]
+          "capabilities": [
+            "Conversation",
+            "Human control",
+            "Tool results"
+          ],
+          "steps": [
+            "Define the agent experience",
+            "Connect the conversation surface",
+            "Keep the human in control"
+          ]
         },
         "cta": "Explore AgentsKit Chat"
       },
@@ -201,62 +272,10 @@
         "next": [
           "agentskit",
           "registry",
-          "playbook",
-          "doc-bridge",
-          "code-review"
-        ]
-      }
-    },
-    {
-      "id": "playbook",
-      "public": true,
-      "distributionClass": "open-source",
-      "name": "Agents Playbook",
-      "shortName": "Playbook",
-      "kind": "methodology",
-      "role": "discipline",
-      "promise": "Make agents ship code a human would actually merge.",
-      "maturity": "stable",
-      "repo": "AgentsKit-io/agents-playbook",
-      "accent": "#8B5CF6",
-      "showcase": {
-        "stage": "Standardize",
-        "headline": "Engineering standards agents can execute.",
-        "detail": "Turn repeatable practices into guidance that coding agents can follow in every repository.",
-        "proof": "Convention → executable guidance",
-        "sales": {
-          "kind": "standards-flow",
-          "headline": "Your standards. Every agent. Every repository.",
-          "metric": "1×",
-          "metricLabel": "define · reuse everywhere",
-          "logos": [
-            { "id": "architecture", "label": "Architecture" },
-            { "id": "tests", "label": "Tests" },
-            { "id": "security", "label": "Security" },
-            { "id": "style", "label": "Style" }
-          ],
-          "capabilities": ["Repository rules", "Review criteria", "Agent guidance", "Team conventions"],
-          "steps": ["Define the standard once", "Agents receive executable guidance", "Review consistent output"]
-        },
-        "cta": "Explore the Playbook"
-      },
-      "surfaces": {
-        "home": "https://playbook.agentskit.io",
-        "docs": "https://playbook.agentskit.io/docs",
-        "llms": "https://playbook.agentskit.io/llms.txt",
-        "stats": "https://playbook.agentskit.io/api/stats.json",
-        "documentation": "fumadocs",
-        "chat": "custom"
-      },
-      "navigation": {
-        "showInBar": true,
-        "order": 3,
-        "next": [
-          "agentskit",
-          "registry",
-          "agentskit-chat",
           "doc-bridge",
-          "code-review"
+          "code-review",
+          "harness",
+          "playbook"
         ]
       }
     },
@@ -283,13 +302,34 @@
           "metric": "↔",
           "metricLabel": "humans and agents",
           "logos": [
-            { "id": "human", "label": "Humans" },
-            { "id": "markdown", "label": "Docs" },
-            { "id": "code", "label": "Code" },
-            { "id": "agent", "label": "Agents" }
+            {
+              "id": "human",
+              "label": "Humans"
+            },
+            {
+              "id": "markdown",
+              "label": "Docs"
+            },
+            {
+              "id": "code",
+              "label": "Code"
+            },
+            {
+              "id": "agent",
+              "label": "Agents"
+            }
+          ],
+          "capabilities": [
+            "ADRs",
+            "Handoffs",
+            "Agent findings",
+            "Human-readable docs"
           ],
-          "capabilities": ["ADRs", "Handoffs", "Agent findings", "Human-readable docs"],
-          "steps": ["Humans document decisions", "Agents receive precise context", "Agent findings return to humans"]
+          "steps": [
+            "Humans document decisions",
+            "Agents receive precise context",
+            "Agent findings return to humans"
+          ]
         },
         "cta": "Explore Doc Bridge"
       },
@@ -302,13 +342,14 @@
       },
       "navigation": {
         "showInBar": true,
-        "order": 4,
+        "order": 3,
         "next": [
           "agentskit",
           "registry",
           "agentskit-chat",
-          "playbook",
-          "code-review"
+          "code-review",
+          "harness",
+          "playbook"
         ]
       }
     },
@@ -325,21 +366,196 @@
       "repo": "AgentsKit-io/code-review",
       "accent": "#F97316",
       "surfaces": {
-        "home": "https://github.com/AgentsKit-io/code-review",
-        "docs": "https://github.com/AgentsKit-io/code-review#readme",
-        "llms": "https://raw.githubusercontent.com/AgentsKit-io/code-review/main/llms.txt",
-        "documentation": "repository",
+        "home": "https://code-review.agentskit.io",
+        "docs": "https://code-review.agentskit.io/docs",
+        "llms": "https://code-review.agentskit.io/llms.txt",
+        "documentation": "fumadocs",
         "chat": "none"
       },
       "navigation": {
-        "showInBar": false,
+        "showInBar": true,
+        "order": 4,
+        "next": [
+          "agentskit",
+          "registry",
+          "agentskit-chat",
+          "doc-bridge",
+          "harness",
+          "playbook"
+        ]
+      },
+      "showcase": {
+        "stage": "Review",
+        "headline": "A review you can tune. Findings you can act on.",
+        "detail": "Choose the concerns that matter and see the review comments adapt to the change.",
+        "proof": "Configurable · provider-neutral · open source",
+        "sales": {
+          "kind": "review-config",
+          "headline": "Set the standard for every review.",
+          "metric": "2",
+          "metricLabel": "review profiles",
+          "capabilities": [
+            "Security",
+            "Performance",
+            "Correctness",
+            "Actionable comments"
+          ],
+          "steps": [
+            "Choose security or performance",
+            "Apply your review configuration",
+            "Get focused, actionable comments"
+          ]
+        },
+        "cta": "Explore Code Review"
+      }
+    },
+    {
+      "id": "harness",
+      "public": true,
+      "distributionClass": "open-source",
+      "name": "AgentsKit Harness",
+      "shortName": "Harness",
+      "kind": "tool",
+      "role": "delivery",
+      "promise": "The keep-pushing loop for your SDLC.",
+      "maturity": "beta",
+      "repo": "AgentsKit-io/harness",
+      "accent": "#F778BA",
+      "showcase": {
+        "stage": "Ship",
+        "headline": "From a vague objective to production, unattended.",
+        "detail": "Interview, plan, vote, build, review, prove, merge, release — one state machine per stage, with humans only where the loop acts on the world.",
+        "proof": "Objective → released change",
+        "sales": {
+          "kind": "standards-flow",
+          "headline": "The loop keeps pushing while you sleep.",
+          "metric": "24/7",
+          "metricLabel": "unattended delivery",
+          "logos": [
+            {
+              "id": "issue",
+              "label": "Issues"
+            },
+            {
+              "id": "worktree",
+              "label": "Worktrees"
+            },
+            {
+              "id": "review",
+              "label": "Review"
+            },
+            {
+              "id": "release",
+              "label": "Release"
+            }
+          ],
+          "capabilities": [
+            "Frozen contracts",
+            "Plan with votes",
+            "Definition of done",
+            "Human gates"
+          ],
+          "steps": [
+            "An issue becomes a contract nobody can widen",
+            "A worker proves it in its own worktree",
+            "A human approves what reaches production"
+          ]
+        },
+        "cta": "Explore Harness"
+      },
+      "surfaces": {
+        "home": "https://harness.agentskit.io/",
+        "docs": "https://harness.agentskit.io/docs",
+        "llms": "https://harness.agentskit.io/llms.txt",
+        "stats": "https://harness.agentskit.io/api/stats.json",
+        "documentation": "fumadocs",
+        "chat": "none"
+      },
+      "navigation": {
+        "showInBar": true,
         "order": 5,
         "next": [
           "agentskit",
           "registry",
           "agentskit-chat",
-          "playbook",
-          "doc-bridge"
+          "doc-bridge",
+          "code-review",
+          "playbook"
+        ]
+      }
+    },
+    {
+      "id": "playbook",
+      "public": true,
+      "distributionClass": "open-source",
+      "name": "Agents Playbook",
+      "shortName": "Playbook",
+      "kind": "methodology",
+      "role": "discipline",
+      "promise": "Make agents ship code a human would actually merge.",
+      "maturity": "stable",
+      "repo": "AgentsKit-io/agents-playbook",
+      "accent": "#8B5CF6",
+      "showcase": {
+        "stage": "Standardize",
+        "headline": "Engineering standards agents can execute.",
+        "detail": "Turn repeatable practices into guidance that coding agents can follow in every repository.",
+        "proof": "Convention → executable guidance",
+        "sales": {
+          "kind": "standards-flow",
+          "headline": "Your standards. Every agent. Every repository.",
+          "metric": "1×",
+          "metricLabel": "define · reuse everywhere",
+          "logos": [
+            {
+              "id": "architecture",
+              "label": "Architecture"
+            },
+            {
+              "id": "tests",
+              "label": "Tests"
+            },
+            {
+              "id": "security",
+              "label": "Security"
+            },
+            {
+              "id": "style",
+              "label": "Style"
+            }
+          ],
+          "capabilities": [
+            "Repository rules",
+            "Review criteria",
+            "Agent guidance",
+            "Team conventions"
+          ],
+          "steps": [
+            "Define the standard once",
+            "Agents receive executable guidance",
+            "Review consistent output"
+          ]
+        },
+        "cta": "Explore the Playbook"
+      },
+      "surfaces": {
+        "home": "https://playbook.agentskit.io",
+        "docs": "https://playbook.agentskit.io/docs",
+        "llms": "https://playbook.agentskit.io/llms.txt",
+        "stats": "https://playbook.agentskit.io/api/stats.json",
+        "documentation": "fumadocs",
+        "chat": "custom"
+      },
+      "navigation": {
+        "showInBar": false,
+        "order": 6,
+        "next": [
+          "agentskit",
+          "registry",
+          "agentskit-chat",
+          "doc-bridge",
+          "code-review",
+          "harness"
         ]
       }
     }
@@ -355,6 +571,7 @@
       "tagline": "Build agents without gluing many libraries together.",
       "kind": "library",
       "accent": "#2EA043",
+      "showInBar": true,
       "llms": "https://www.agentskit.io/llms.txt",
       "stats": "https://www.agentskit.io/api/stats.json"
     },
@@ -368,6 +585,7 @@
       "tagline": "Make agents ship code a human would actually merge.",
       "kind": "methodology",
       "accent": "#8B5CF6",
+      "showInBar": false,
       "llms": "https://playbook.agentskit.io/llms.txt",
       "stats": "https://playbook.agentskit.io/api/stats.json"
     },
@@ -381,6 +599,7 @@
       "tagline": "Copy ready-made agents and own the source.",
       "kind": "registry",
       "accent": "#58A6FF",
+      "showInBar": true,
       "llms": "https://registry.agentskit.io/llms.txt",
       "stats": "https://registry.agentskit.io/r/index.json"
     }

package/mcpb/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "doc-bridge",
   "display_name": "Doc Bridge",
-  "version": "1.11.2",
+  "version": "1.12.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.11.2",
+  "version": "1.12.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",
@@ -80,6 +80,7 @@
     "graphology-dag": "~0.4.1",
     "graphology-metrics": "~2.4.2",
     "graphology-shortest-path": "~2.1.0",
+    "ignore": "^7.0.6",
     "knap": "~0.5.1",
     "mdast-util-to-string": "^4.0.0",
     "mermaid": "^11.17.2",

package/skills/doc-bridge-handoff/SKILL.md

@@ -25,7 +25,7 @@ Use this skill before editing a repository that contains `doc-bridge.config.json
 
 If resolution fails, returns incomplete fields, or names an unknown target, stop. Do not infer edit permission from repository layout.
 
-The resolver and MCP tools are read-only. They resolve project guidance but never authorize edits, publish changes, execute returned checks, or replace repository instructions. The skill uses no credentials and has no provider, hosted service, or AKOS dependency.
+The resolver and MCP tools are read-only. They resolve project guidance but never authorize edits, publish changes, execute returned checks, or replace repository instructions. The skill uses no credentials and has no provider, hosted service, or managed-service dependency.
 
 ## Portable runtimes
 

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.11.2'
+const VERSION = '1.12.0'
 const kinds = new Set(['package', 'ownership'])
 const args = process.argv.slice(2)
 const id = args[0]

package/src/conformance/ecosystem-contract.ts

@@ -50,12 +50,9 @@ const ManifestSchema = z.object({
   schemaVersion: z.literal(2),
   parentBrand: z.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z.array(ProductSchema).min(1),
-  // Legacy three-product shim or full public product projection of products[].
-  properties: z
-    .array(LegacyPropertySchema)
-    .refine((value) => value.length === 3 || value.length === 6, {
-      message: 'must project either the legacy three products or the full public product catalog',
-    }),
+  // Deprecated compatibility shim: when present, every entry projects one products[] record.
+  // Membership is whatever the canonical manifest lists; no product is required by name.
+  properties: z.array(LegacyPropertySchema).optional(),
   builder: z.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional(),
 }).passthrough()
 
@@ -94,18 +91,6 @@ const ClaimsSchema = z.object({
   products: z.array(ClaimProductSchema),
 }).passthrough()
 
-/** Historical three-product shim order. */
-const LEGACY_PRODUCT_IDS = ['agentskit', 'playbook', 'registry'] as const
-/** Full public product projection order (matches products[]). */
-const PUBLIC_PRODUCT_IDS = [
-  'agentskit',
-  'registry',
-  'agentskit-chat',
-  'playbook',
-  'doc-bridge',
-  'code-review',
-] as const
-
 export const parseCanonicalEcosystemContract = (
   manifestInput: unknown,
   claimsInput: unknown,
@@ -136,13 +121,14 @@ export const parseCanonicalEcosystemContract = (
     }
   }
 
-  const propertyIds = manifest.properties.length === 6 ? PUBLIC_PRODUCT_IDS : LEGACY_PRODUCT_IDS
-
-  for (const [index, id] of propertyIds.entries()) {
-    const legacy = manifest.properties[index]
+  const propertyIds = new Set<string>()
+  for (const [index, legacy] of (manifest.properties ?? []).entries()) {
+    const id = legacy.id
     const product = products.get(id)
-    if (!legacy || !product || legacy.id !== id || !product.surfaces.home) {
-      throw new Error(`Legacy property ${index} must project product ${id}.`)
+    if (propertyIds.has(id)) throw new Error(`Legacy property ${id} is listed more than once.`)
+    propertyIds.add(id)
+    if (!product || !product.surfaces.home) {
+      throw new Error(`Legacy property ${index} (${id}) must project a manifest product with a home surface.`)
     }
     const expected = {
       name: product.name,

package/src/discovery/repository.ts

@@ -203,7 +203,13 @@ const discoverPackages = (
     const name = packageName(parsed.value, path)
     const id = entityId('package', name ?? path)
     const duplicate = packages.find((pkg) => pkg.id === id)
-    if (duplicate && duplicate.absPath !== absPath) {
+    // Compare toPosix'd, not raw: the root package above is always registered with its raw, native-separator
+    // `absPath` (other code depends on that — e.g. `packageForModule`'s `startsWith` matching against
+    // `safeWalkFiles`' own native-style paths), while `expandWorkspaceGlobs` always returns toPosix'd absPaths.
+    // On Windows those are two different strings for the exact same directory whenever a workspace list
+    // includes "." explicitly (root resolves to itself both ways) — a false-positive collision on every such
+    // Windows checkout otherwise (reproduced live: harness's own `packages: [., apps/*]`).
+    if (duplicate && toPosix(duplicate.absPath) !== toPosix(absPath)) {
       throw new Error(`Package identity collision for "${id}": "${duplicate.path}" and "${path}".`)
     }
     if (!duplicate) packages.push({ id, ...(name ? { name } : {}), path, absPath, manifestPath, manifest: parsed.value })