@vibecompass/vibecompass 0.10.0 → 0.10.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.10.2 - 2026-06-19
+
+- Add a package-owned docs-review source inventory scanner that writes `state/docs-review-source-inventory.json`, includes scanned subsystem inventory in the review prompt, and records `scanned_unaccounted` / `source_unavailable` reconciliation warnings without changing the primary coverage score basis.
+- Add an accepted docs-review documentation-plan projection at `state/docs-review-documentation-plan.json`, preserving plan titles, purposes, parent groups, baseline/deepening scope, linked inventory ids, evidence, anchors, and producer stamps as derived state.
+- Add `docs-review --source-root <id=path>` so Git-backed repos can be scanned from local checkouts for a run without committing machine-local paths to `project.yaml`.
+- Add a source-inventory concurrency stress test script and run it during `prepublishOnly` to guard symlink root-containment regressions.
+- Ignore common OS metadata files such as `.DS_Store` during source inventory scans so package evidence does not create false route/API items.
+- Collapse nested `config/<group>/**` source-inventory evidence into one platform subsystem per config group instead of fragmenting every leaf config file into its own item.
+- Report all dangling `completeness_inventory[].coverage_area_ids[]` references in one docs-review apply error and prompt agents to fix them at the plan gate.
+- Clarify docs-review coverage reporting so scores are described as evidence/completeness-inventory accounting when present, not doc-count accounting.
+
+## 0.10.1 - 2026-06-14
+
+- Add completeness-inventory guidance to docs-review so coverage plans account for accepted, deferred, and missing subsystems instead of silently omitting large areas.
+- Score accepted coverage against the optional completeness inventory denominator when present, with a backwards-compatible fallback for older coverage plans.
+- Add soft parser warnings for modern coverage plans that omit completeness inventory or under-explain accepted/deferred/missing inventory items.
+- Add prose-only surface matrix guidance for feature docs while keeping `systems[]` as derived overview metadata rather than a second projected graph.
+
 ## 0.10.0 - 2026-06-14
 
 - Make docs-review prompts mode-aware: interactive AI sessions stop at the coverage-plan approval gate, while `--run-local` and hosted single-turn runs emit fenced proposal material for later apply/proposal review.

package/README.md

@@ -134,6 +134,7 @@ npx -y @vibecompass/vibecompass@latest sync-agents --root .compass
 
 # Architecture docs review
 npx -y @vibecompass/vibecompass@latest docs-review --root .compass --guided
+npx -y @vibecompass/vibecompass@latest docs-review --root .compass --guided --source-root app=../app
 npx -y @vibecompass/vibecompass@latest docs-review --root .compass --apply-output
 
 # Rerun docs review from an archived architecture-doc slate
@@ -153,6 +154,9 @@ npx -y @vibecompass/vibecompass@latest docs-review --root .compass --rebuild --a
   state/
 ```
 
+Docs review writes derived state under `state/`, including scanned source
+inventory, accepted coverage, and the accepted documentation-plan projection.
+
 Generated agent files can also include managed VibeCompass blocks:
 
 ```text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecompass/vibecompass",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Local-first project-memory core for VibeCompass",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
   ],
   "scripts": {
     "test": "node --test src/tests/*.test.js",
-    "prepublishOnly": "npm test"
+    "test:source-inventory-stress": "node --test --test-concurrency=8 src/tests/source-inventory.test.js",
+    "prepublishOnly": "npm test && npm run test:source-inventory-stress"
   },
   "keywords": [
     "vibecompass",

package/src/cli.js

@@ -286,6 +286,13 @@ export async function runCli(argv, io = createDefaultIo(), runtime = {}) {
     if (result.localReview) {
       io.stdout.write(`Local review output: ${result.localReview.output_path}\n`);
     }
+    if (result.sourceInventory) {
+      io.stdout.write(`Source inventory: ${result.sourceInventory.summary.item_count} items`);
+      if (result.sourceInventory.summary.warning_count > 0) {
+        io.stdout.write(` (${result.sourceInventory.summary.warning_count} warnings)`);
+      }
+      io.stdout.write('\n');
+    }
     if (result.rebuild) {
       io.stdout.write(`Rebuild scope: ${result.rebuild.scope_path}\n`);
       io.stdout.write(`Stale policy: ${result.rebuild.stale_policy}\n`);
@@ -1170,6 +1177,14 @@ function parseDocsReviewArgs(argv) {
       case '--sync-target':
         parsed.syncTarget = value;
         break;
+      case '--source-root': {
+        const [repoId, sourceRootPath] = splitAssignment(value, '--source-root');
+        parsed.sourceRootOverrides = [
+          ...(parsed.sourceRootOverrides ?? []),
+          { repoId, path: sourceRootPath },
+        ];
+        break;
+      }
       case '--max-tokens':
         parsed.maxTokens = value;
         break;
@@ -1605,6 +1620,7 @@ function usageText() {
     '  --poll-hosted                        Poll hosted docs-review run status and update state/docs-review.json',
     '  --complete                           Mark accepted docs-review changes as completed locally',
     '  --run-local                          Run the generated review request with a local provider',
+    '  --source-root <id=path>              Repeatable run-local source root override for Git-backed repos',
     '  --provider <name>                    Local provider for --run-local. Currently: anthropic',
     '  --run-local-anthropic                Compatibility alias for --run-local --provider anthropic',
     '  --apply-output                       Apply accepted architecture doc blocks from review output',