agent-doc-system 1.1.0 → 1.2.0

package/evals/scenarios/fixture-c-03-shared-vocabulary.json

@@ -5,5 +5,11 @@
   "touch": ["shared/index.js"],
   "truth": ["component:default/shared", "component:default/edge", "component:default/console", "event:corp.telemetry.ingest.v1"],
   "critical": ["event:corp.telemetry.ingest.v1"],
-  "verification": []
+  "verification": [
+    "verify:vitest run",
+    "verify:tsc --noEmit",
+    "verify-id:component:default/console:test",
+    "verify-id:component:default/console:typecheck",
+    "verify-id:component:default/edge:test"
+  ]
 }

package/evals/scenarios/fixture-e-01-change-shared-lib.json

@@ -0,0 +1,14 @@
+{
+  "id": "e-01",
+  "repository": "fixture-e",
+  "title": "Change the shared engine crate",
+  "touch": ["crates/engine/src/lib.rs"],
+  "truth": ["component:default/engine", "component:default/cli"],
+  "critical": [],
+  "verification": [
+    "verify:cargo test -p engine",
+    "verify:cargo clippy -p engine",
+    "verify:cargo test -p cli",
+    "verify:cargo clippy -p cli"
+  ]
+}

package/evals/scenarios/fixture-e-02-change-manifest.json

@@ -0,0 +1,9 @@
+{
+  "id": "e-02",
+  "repository": "fixture-e",
+  "title": "Change the CLI crate manifest",
+  "touch": ["apps/cli/Cargo.toml"],
+  "truth": ["component:default/cli", "component:default/engine", "component:default/testutil", "external:serde"],
+  "critical": [],
+  "verification": ["verify:cargo test -p cli", "verify:cargo clippy -p cli"]
+}

package/evals/scenarios/fixture-e-03-local-module.json

@@ -0,0 +1,9 @@
+{
+  "id": "e-03",
+  "repository": "fixture-e",
+  "title": "Change CLI code that looks like the logging crate and an ambiguous foo_bar import",
+  "touch": ["apps/cli/src/logging.rs", "apps/cli/src/main.rs"],
+  "truth": ["component:default/cli", "component:default/engine"],
+  "critical": [],
+  "verification": ["verify:cargo test -p cli", "verify:cargo clippy -p cli"]
+}

package/evals/scenarios/fixture-e-04-ambiguous-crate.json

@@ -0,0 +1,14 @@
+{
+  "id": "e-04",
+  "repository": "fixture-e",
+  "title": "Change each crate of the foo-bar / foo_bar pair",
+  "touch": ["crates/foo-bar/src/lib.rs", "crates/foo_bar/src/lib.rs"],
+  "truth": ["component:default/foo-bar", "component:default/foo-u-bar"],
+  "critical": [],
+  "verification": [
+    "verify:cargo test -p foo-bar",
+    "verify:cargo clippy -p foo-bar",
+    "verify:cargo test -p foo_bar",
+    "verify:cargo clippy -p foo_bar"
+  ]
+}

package/evals/scenarios/fixture-f-01-change-shared-lib.json

@@ -0,0 +1,9 @@
+{
+  "id": "f-01",
+  "repository": "fixture-f",
+  "title": "Change the shared ledger-core library",
+  "touch": ["libs/ledger-core/src/ledger_core/models.py"],
+  "truth": ["component:default/ledger-core", "component:default/ledger-api"],
+  "critical": [],
+  "verification": ["verify:uv run pytest", "verify:uv run ruff check", "verify:uv run mypy"]
+}

package/evals/scenarios/fixture-f-02-change-manifest.json

@@ -0,0 +1,9 @@
+{
+  "id": "f-02",
+  "repository": "fixture-f",
+  "title": "Change the ledger API manifest",
+  "touch": ["services/ledger-api/pyproject.toml"],
+  "truth": ["component:default/ledger-api", "component:default/ledger-core", "component:default/ledger-testing", "external:sqlalchemy"],
+  "critical": [],
+  "verification": ["verify:uv run pytest", "verify:uv run ruff check", "verify:uv run mypy"]
+}

package/evals/scenarios/fixture-f-03-shadowed-import.json

@@ -0,0 +1,9 @@
+{
+  "id": "f-03",
+  "repository": "fixture-f",
+  "title": "Change the app that imports its own utils module",
+  "touch": ["services/b-app/b_app/main.py"],
+  "truth": ["component:default/b-app"],
+  "critical": [],
+  "verification": []
+}

package/evals/scenarios/fixture-f-04-nested-workspace.json

@@ -0,0 +1,9 @@
+{
+  "id": "f-04",
+  "repository": "fixture-f",
+  "title": "Change a nested workspace member, not its parent",
+  "touch": ["python/packages/api/src/api_svc/main.py"],
+  "truth": ["component:default/api-svc", "component:default/core-lib"],
+  "critical": [],
+  "verification": []
+}

package/evals/scenarios/fixture-f-05-alembic-database.json

@@ -0,0 +1,9 @@
+{
+  "id": "f-05",
+  "repository": "fixture-f",
+  "title": "Change the ledger API Alembic migration",
+  "touch": ["services/ledger-api/alembic/versions/0001_init.py"],
+  "truth": ["component:default/ledger-api", "uses:resource:default/ledger-api-postgres"],
+  "critical": ["uses:resource:default/ledger-api-postgres"],
+  "verification": ["verify:uv run pytest", "verify:uv run ruff check", "verify:uv run mypy"]
+}

package/evals/scenarios/fixture-f-06-unittest-job.json

@@ -0,0 +1,9 @@
+{
+  "id": "f-06",
+  "repository": "fixture-f",
+  "title": "Change the ledger job exercised by unittest",
+  "touch": ["jobs/ledger-jobs/tests/test_jobs.py"],
+  "truth": ["component:default/ledger-jobs"],
+  "critical": [],
+  "verification": ["verify:python -m unittest discover"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-doc-system",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "Portable documentation and software-catalog system with an explicit authority model, for AI coding agents",
   "keywords": [
@@ -42,6 +42,7 @@
     "schemas",
     "skills",
     "templates",
+    "CHANGELOG.md",
     "INSTALL_FOR_AGENTS.md"
   ],
   "license": "MIT"

package/skills/agent-doc-system/references/create-migrate.md

@@ -40,9 +40,19 @@ never copies the agentdoc implementation into the repository.
 In `agentdoc.config.yaml`:
 
 - Set `namespace`, fix `discovery.componentDescriptors` to match the real
-  layout, and enable the adapters for the technologies present. `adapters: []`
-  is a valid but useless starting point: with no adapter, a component
-  descriptor is an unsupported claim and compilation fails on purpose.
+  layout, and enable the adapters for the technologies present. `init`
+  pre-selects the language and deployment adapters whose manifests it finds:
+  `node`, `go`, `rust` and `python`, plus `dockerfile` and `wrangler`. It also
+  adds `database`, `openapi`, `events` and `github-actions`. Add the rest
+  (`pnpm`, `turborepo`, `typescript`, `protobuf`, `graphql`, `ansible`, …) when
+  the repository uses them. `adapters: []` is a valid but useless starting
+  point: with no adapter, a component descriptor is an unsupported claim and
+  compilation fails on purpose.
+- An existing catalog does not gain new adapters on upgrade. After upgrading
+  the CLI, compare `adapters:` with the technologies present, for example a
+  repository with `Cargo.toml` or `pyproject.toml` units and no `rust` /
+  `python` entry. Then run `agentdoc audit`: newly visible units appear as
+  `AGENTDOC_COVERAGE_ZERO` until they have a descriptor.
 - Three example authority rules are written **commented out**. Uncomment only
   the ones you can justify, with the rationale in your own words. An authority
   rule is a governance decision; the scaffolder does not make it for you.

package/templates/ci.yml

@@ -17,7 +17,7 @@ jobs:
         with: { node-version: '24' }
       - name: Install the agentdoc CLI
         # Unpinned tracks main. For CI reproducibility pin a tag or commit:
-        #   github:lbframe/agent-doc-system#v1.1.0
+        #   github:lbframe/agent-doc-system#v1.2.0
         # A compiler upgrade intentionally invalidates committed graphs.
         run: npm install -g github:lbframe/agent-doc-system
       - name: Validate and compile