@agentskit/doc-bridge 1.11.0 → 1.11.2

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 1.11.2
+
+### Patch Changes
+
+- 221b4a6: Retire the public AKOS ecosystem contract and generated documentation references.
+
+## 1.11.1
+
+### Patch Changes
+
+- faf29f5: Stop reporting a path an ignore rule rescues as unreproducible.
+  
+  `git check-ignore --verbose` emits a record for every path that *matched* a rule, including the path
+  a `!` negation rescues — and such a path is precisely one Git does not ignore. The reproducibility
+  check read the record without reading the pattern, so `dist/*` plus `!dist/keep.js` reported
+  `dist/keep.js` as a reason the index could not be rebuilt from a clean checkout. The opposite of
+  what the rule says, stated confidently.
+  
+  The window is narrow: `check-ignore` stops reporting a path once it is committed, and a path rescued
+  by a negation is usually committed, which is the point of rescuing it. It shows up while such a path
+  is still untracked — a file added but not yet committed.
+  
+  Found by turning the new `index-reproducible` gate on in this repository, which had to add
+  `!.doc-bridge/index.json` to its own `.gitignore` to commit the index the gate verifies.
+
 ## 1.11.0
 
 ### Minor Changes

package/README.md

@@ -297,19 +297,23 @@ gates without silently rebuilding them. It rejects non-exact package versions.
 See the [Marketplace guide](docs/MARKETPLACE.md).
 
 The guide is pinned to the published stable Action release `v1.7.45`; the
-checked-in package version is `1.8.0`.
+checked-in package version is `1.11.2`.
 
 Coverage is repository-specific. Run `ak-docs doctor --badge` locally to emit
 current handoff and human-bridge badges, or `pnpm coverage:badge` in CI; this
 README intentionally avoids publishing a stale static percentage.
 
-Or locally:
+Or locally, as two steps rather than one, because they answer different questions:
 
 ```bash
-ak-docs index && ak-docs gate run
+ak-docs index     # after changing docs or config — then review and commit the result
+ak-docs gate run  # verifies the committed index, which is what CI verifies
 ```
 
-Gate fails with `Index is stale. Run: ak-docs index` — same check in CI annotations.
+Chaining them (`index && gate run`) cannot report a stale index: it gates an artifact written a
+second earlier against a rebuild of the same tree. The gate's value is that the committed index
+and the repository agree, so run it the way CI does, against what is committed. It fails with
+`Index is stale. Run: ak-docs index` — the same check, and the same annotation, as in CI.
 
 ## Product surface
 

package/action.yml

@@ -20,7 +20,7 @@ inputs:
   package-version:
     description: Exact @agentskit/doc-bridge npm version (kept in sync with this Action release)
     required: false
-    default: '1.11.0'
+    default: '1.11.2'
 
 runs:
   using: composite

package/dist/cli/program.js

@@ -922,9 +922,9 @@ var ManifestSchema = z2.object({
   schemaVersion: z2.literal(2),
   parentBrand: z2.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z2.array(ProductSchema).min(1),
-  // Historical four-product shim or full seven-product projection of products[].
-  properties: z2.array(LegacyPropertySchema).refine((value) => value.length === 4 || value.length === 7, {
-    message: "must project either the legacy four products or the full seven-product catalog"
+  // Legacy three-product shim or full public product projection of products[].
+  properties: z2.array(LegacyPropertySchema).refine((value) => value.length === 3 || value.length === 6, {
+    message: "must project either the legacy three products or the full public product catalog"
   }),
   builder: z2.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional()
 }).passthrough();
@@ -959,15 +959,14 @@ var ClaimsSchema = z2.object({
   manifestSchemaVersion: z2.literal(2),
   products: z2.array(ClaimProductSchema)
 }).passthrough();
-var LEGACY_FOUR_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
-var FULL_SEVEN_PRODUCT_IDS = [
+var LEGACY_PRODUCT_IDS = ["agentskit", "playbook", "registry"];
+var PUBLIC_PRODUCT_IDS = [
   "agentskit",
   "registry",
   "agentskit-chat",
   "playbook",
   "doc-bridge",
-  "code-review",
-  "akos"
+  "code-review"
 ];
 var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
   const manifest = ManifestSchema.parse(manifestInput);
@@ -994,7 +993,7 @@ var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
       if (!products.has(nextId)) throw new Error(`Product ${product.id} references unknown product ${nextId}.`);
     }
   }
-  const propertyIds = manifest.properties.length === 7 ? FULL_SEVEN_PRODUCT_IDS : LEGACY_FOUR_PRODUCT_IDS;
+  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 product = products.get(id);
@@ -4062,7 +4061,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.11.0";
+var PACKAGE_VERSION = "1.11.2";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -8065,7 +8064,7 @@ var checkIndexReproducibility = (root, indexPath, paths) => {
   const ignored = [];
   for (let index = 0; index + 3 < fields.length; index += 4) {
     const [source, line, pattern, path] = [fields[index], fields[index + 1], fields[index + 2], fields[index + 3]];
-    if (!path) continue;
+    if (!path || pattern?.startsWith("!")) continue;
     ignored.push({ path, rule: `${source ?? "?"}:${line ?? "?"}:${pattern ?? "?"}` });
   }
   return { checked: true, ignored: ignored.sort((left, right) => left.path.localeCompare(right.path)) };