@vibe-agent-toolkit/cli 0.1.41-rc.7 → 0.1.41

package/docs/resources.md

@@ -18,14 +18,19 @@ including link integrity checking and anchor validation.
 4. Exits 0 always (informational only)
 
 **Path Argument:**
-- `[path]` specifies the **base directory** to start crawling from
-- Recursively finds all `*.md` files under that directory (default pattern: `**/*.md`)
-- When path is specified, **config patterns are ignored** (to avoid pattern conflicts)
-- To use config patterns, run without path argument: `vat resources scan`
+- `[path]` restricts the scan to that subtree of the project
+- Recursively finds all `*.md` / `*.html` files under that directory
+- The path **replaces** the config's `resources.include` patterns
+- The config's `resources.exclude` patterns **still apply** — a path run never
+  scans build output, vendored trees, or test fixtures the project excluded
+- To scan the project's full configured set, run without a path argument:
+  `vat resources scan`
 
 **Options:**
 - `[path]` - Base directory to crawl (defaults to current directory)
 - `--debug` - Enable debug logging
+- `--verbose` - Add a `files:` list with per-file link/anchor counts and checksums
+- `--collection <id>` - Only report files in the named collection (config mode — no path argument)
 
 **Exit Codes:**
 - `0` - Always (scan is informational)
@@ -33,23 +38,28 @@ including link integrity checking and anchor validation.
 
 **Output:** YAML on stdout, logs on stderr
 
+`root` is stated once and is the only absolute path in the document; every
+`path` beneath it is relative to it.
+
 **Example:**
 ```bash
 # Recursively scan all *.md files under docs/
-vat resources scan docs/
+vat resources scan docs/ --verbose
 # Equivalent to: find all files matching docs/**/*.md pattern
 
 # Output:
 # ---
 # status: success
+# root: /home/you/my-project
 # filesScanned: 12
 # linksFound: 47
 # anchorsFound: 23
+# durationSecs: 0.234
 # files:
 #   - path: docs/README.md
 #     links: 5
 #     anchors: 3
-# duration: 234ms
+#     checksum: 47dd7b50af765df240fe2514f029fc697c907fc37a3267e22060f2f9f611975c
 # ---
 ```
 
@@ -78,14 +88,21 @@ for the loud-cwd fallback policy and the projectRoot discovery ladder.
 4. Exits 0 if valid, 1 if errors found
 
 **Path Argument:**
-- `[path]` specifies the **base directory** to start crawling from
-- Recursively finds all `*.md` files under that directory (default pattern: `**/*.md`)
-- When path is specified, **config patterns are ignored** (to avoid pattern conflicts)
-- To use config patterns, run without path argument: `vat resources validate`
+- `[path]` restricts the scan to that subtree of the project
+- Recursively finds all `*.md` / `*.html` files under that directory
+- The path **replaces** the config's `resources.include` patterns
+- The config's `resources.exclude` patterns **still apply** — a path run never
+  scans build output, vendored trees, or test fixtures the project excluded
+- To scan the project's full configured set, run without a path argument:
+  `vat resources validate`
 
 **Options:**
 - `[path]` - Base directory to crawl (defaults to current directory)
 - `--debug` - Enable debug logging
+- `-v, --verbose` - Show all scanned resources, including those without issues. By
+  default `issues` carries one counts-only row per file with findings
+  (`{file, errors?, warnings?, info?, codes}`); `--verbose` replaces each row with
+  its per-issue detail. Every other output field is identical in both modes.
 - `--no-check-frontmatter-links` - Skip frontmatter URI-reference link validation across all collections (default: enabled)
 
 **Exit Codes:**
@@ -108,8 +125,7 @@ vat resources validate docs/
 # status: success
 # filesScanned: 12
 # linksChecked: 47
-# anchorsChecked: 23
-# duration: 456ms
+# durationSecs: 0.456
 # ---
 ```
 
@@ -123,7 +139,7 @@ vat resources validate docs/
 
 # stdout:
 # ---
-# status: failed
+# status: error
 # errorsFound: 2
 # filesWithErrors: 2
 # issueCounts: { errors: 2, warnings: 0, info: 0 }
@@ -136,7 +152,7 @@ vat resources validate docs/
 #         code: LINK_BROKEN_FILE
 #         severity: error
 #         message: Link target not found: ./missing.md
-# duration: 456ms
+# durationSecs: 0.456
 # ---
 ```
 

package/docs/skills.md

@@ -192,18 +192,32 @@ discovery rule that this command participates in.
 **Output Format:**
 ```yaml
 status: success
-package: @my-org/my-package
 skillsBuilt: 2
-skills:
+outputCommitted: true      # false ⇒ dist/skills was NOT replaced
+skills:                    # bundles that exist on disk; empty when outputCommitted is false
   - name: skill1
     outputPath: /path/to/dist/skills/skill1
     filesPackaged: 5
+    issueCounts: { errors: 0, warnings: 1, info: 0 }
+    issues:                # every finding, at every verbosity
+      - code: LINK_DROPPED_BY_DEPTH
+        severity: warning
+        message: ...
+        location: dist/skills/skill1/docs/deep.md
+        fix: ...
   - name: skill2
     outputPath: /path/to/dist/skills/skill2
     filesPackaged: 3
+    issueCounts: { errors: 0, warnings: 0, info: 0 }
+    issues: []
+skillsStaged: []           # the same rows, WITHOUT outputPath, when the promotion was aborted
 duration: 1234ms
 ```
 
+`--verbose` changes the stderr report only — the YAML above is identical at either
+verbosity. See `vat skills build --help` for the full field list and the identity
+`issueCounts` reconciles against.
+
 **Examples:**
 ```bash
 # Build all skills from package.json
@@ -362,11 +376,14 @@ to override (single-skill sources only).
 | `windsurf` | `~/.codeium/windsurf/skills/` | `.windsurf/skills/` |
 | `agents` | `~/.agents/skills/` | `.agents/skills/` |
 
-These paths were last reviewed against vendor conventions on 2026-04-08 and are
-not verified at build or test time — the tests assert the table's shape, never
-that a path is where a platform actually looks. If a vendor moves its convention,
-installs land somewhere unread and every VAT check still passes. Re-check the
-vendor's documentation before relying on a non-`claude` target.
+These paths were last reviewed against each platform's own published docs on
+2026-07-30 (all fourteen unchanged) and are not verified at build or test time.
+The tests derive their expectations from the table and assert invariants of it —
+every target present, both scopes relative and forward-slash only, and that the
+resolver composes base + relative path. No test can check that a path is where a
+platform actually looks. If a vendor moves its convention, installs land
+somewhere unread and every VAT check still passes. Re-check the vendor's
+documentation before relying on a non-`claude` target.
 
 **Visibility:** VAT's own inspection commands are Claude-scoped — `vat skills
 list --user` and `vat audit --user` read `~/.claude` only. A skill installed to
@@ -495,6 +512,7 @@ only when the `SKILL.md` declares none.
 **Output Format:**
 ```yaml
 status: success
+root: /abs/path/to/project
 context: project | user
 skillsFound: 3
 skills:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-agent-toolkit/cli",
-  "version": "0.1.41-rc.7",
+  "version": "0.1.41",
   "description": "Command-line interface for vibe-agent-toolkit",
   "type": "module",
   "bin": {
@@ -41,16 +41,16 @@
   "//dependencies-note": "DO NOT add example agent packages or adopter packages here. Adopter packages (like vat-development-agents) depend on the CLI binary at build time — declaring them as deps creates a circular build dependency. They are built in a second turbo pass via package#task overrides in turbo.json.",
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
-    "@vibe-agent-toolkit/agent-config": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/agent-schema": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/agent-skills": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/claude-marketplace": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/discovery": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/gateway-mcp": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/rag": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/rag-lancedb": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/resources": "0.1.41-rc.7",
-    "@vibe-agent-toolkit/utils": "0.1.41-rc.7",
+    "@vibe-agent-toolkit/agent-config": "0.1.41",
+    "@vibe-agent-toolkit/agent-schema": "0.1.41",
+    "@vibe-agent-toolkit/agent-skills": "0.1.41",
+    "@vibe-agent-toolkit/claude-marketplace": "0.1.41",
+    "@vibe-agent-toolkit/discovery": "0.1.41",
+    "@vibe-agent-toolkit/gateway-mcp": "0.1.41",
+    "@vibe-agent-toolkit/rag": "0.1.41",
+    "@vibe-agent-toolkit/rag-lancedb": "0.1.41",
+    "@vibe-agent-toolkit/resources": "0.1.41",
+    "@vibe-agent-toolkit/utils": "0.1.41",
     "adm-zip": "^0.6.0",
     "commander": "^12.1.0",
     "picomatch": "^4.0.3",
@@ -65,7 +65,7 @@
     "@types/picomatch": "^4.0.2",
     "@types/semver": "^7.7.1",
     "@types/tar": "^6.1.13",
-    "@vibe-agent-toolkit/dev-tools": "0.1.41-rc.7",
+    "@vibe-agent-toolkit/dev-tools": "0.1.41",
     "rimraf": "^6.0.1",
     "typescript": "^5.7.3",
     "vitest": "^3.2.4"