@vibe-agent-toolkit/cli 0.2.0-rc.1 → 0.2.0-rc.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -5
- package/dist/bin/vat +95 -28
- package/dist/bin/vat.js +95 -28
- package/dist/bin/vat.js.map +1 -1
- package/dist/bin.js +115 -76
- package/dist/bin.js.map +1 -1
- package/dist/command-loaders.d.ts +44 -0
- package/dist/command-loaders.d.ts.map +1 -0
- package/dist/command-loaders.js +60 -0
- package/dist/command-loaders.js.map +1 -0
- package/dist/commands/agent/build.d.ts.map +1 -1
- package/dist/commands/agent/build.js +2 -1
- package/dist/commands/agent/build.js.map +1 -1
- package/dist/commands/agent/import.d.ts.map +1 -1
- package/dist/commands/agent/import.js +3 -2
- package/dist/commands/agent/import.js.map +1 -1
- package/dist/commands/agent/index.js +1 -1
- package/dist/commands/agent/install-path.d.ts +36 -0
- package/dist/commands/agent/install-path.d.ts.map +1 -0
- package/dist/commands/agent/install-path.js +44 -0
- package/dist/commands/agent/install-path.js.map +1 -0
- package/dist/commands/agent/install.d.ts.map +1 -1
- package/dist/commands/agent/install.js +66 -13
- package/dist/commands/agent/install.js.map +1 -1
- package/dist/commands/agent/installed.d.ts.map +1 -1
- package/dist/commands/agent/installed.js +22 -12
- package/dist/commands/agent/installed.js.map +1 -1
- package/dist/commands/agent/list.d.ts.map +1 -1
- package/dist/commands/agent/list.js +2 -1
- package/dist/commands/agent/list.js.map +1 -1
- package/dist/commands/agent/run.d.ts.map +1 -1
- package/dist/commands/agent/run.js +2 -1
- package/dist/commands/agent/run.js.map +1 -1
- package/dist/commands/agent/uninstall.d.ts.map +1 -1
- package/dist/commands/agent/uninstall.js +13 -6
- package/dist/commands/agent/uninstall.js.map +1 -1
- package/dist/commands/agent/validate.d.ts.map +1 -1
- package/dist/commands/agent/validate.js +3 -2
- package/dist/commands/agent/validate.js.map +1 -1
- package/dist/commands/ard/emit.d.ts +153 -0
- package/dist/commands/ard/emit.d.ts.map +1 -0
- package/dist/commands/ard/emit.js +276 -0
- package/dist/commands/ard/emit.js.map +1 -0
- package/dist/commands/ard/index.d.ts +12 -0
- package/dist/commands/ard/index.d.ts.map +1 -0
- package/dist/commands/ard/index.js +80 -0
- package/dist/commands/ard/index.js.map +1 -0
- package/dist/commands/ard/surfaces.d.ts +56 -0
- package/dist/commands/ard/surfaces.d.ts.map +1 -0
- package/dist/commands/ard/surfaces.js +150 -0
- package/dist/commands/ard/surfaces.js.map +1 -0
- package/dist/commands/audit/distributed-tree.d.ts +2 -2
- package/dist/commands/audit/distributed-tree.d.ts.map +1 -1
- package/dist/commands/audit/distributed-tree.js +11 -7
- package/dist/commands/audit/distributed-tree.js.map +1 -1
- package/dist/commands/audit/git-url-clone.d.ts +1 -1
- package/dist/commands/audit/git-url-clone.d.ts.map +1 -1
- package/dist/commands/audit/git-url-clone.js.map +1 -1
- package/dist/commands/audit/hierarchical-output.d.ts +1 -1
- package/dist/commands/audit/hierarchical-output.d.ts.map +1 -1
- package/dist/commands/audit/hierarchical-output.js +1 -1
- package/dist/commands/audit/hierarchical-output.js.map +1 -1
- package/dist/commands/audit/provenance.d.ts.map +1 -1
- package/dist/commands/audit/provenance.js +4 -3
- package/dist/commands/audit/provenance.js.map +1 -1
- package/dist/commands/audit/scan-population.d.ts +158 -0
- package/dist/commands/audit/scan-population.d.ts.map +1 -0
- package/dist/commands/audit/scan-population.js +292 -0
- package/dist/commands/audit/scan-population.js.map +1 -0
- package/dist/commands/audit-settings.d.ts.map +1 -1
- package/dist/commands/audit-settings.js +6 -5
- package/dist/commands/audit-settings.js.map +1 -1
- package/dist/commands/audit.d.ts +98 -8
- package/dist/commands/audit.d.ts.map +1 -1
- package/dist/commands/audit.js +1126 -394
- package/dist/commands/audit.js.map +1 -1
- package/dist/commands/build.d.ts +1 -1
- package/dist/commands/build.d.ts.map +1 -1
- package/dist/commands/build.js +40 -36
- package/dist/commands/build.js.map +1 -1
- package/dist/commands/cache/cache-control.d.ts +82 -0
- package/dist/commands/cache/cache-control.d.ts.map +1 -0
- package/dist/commands/cache/cache-control.js +86 -0
- package/dist/commands/cache/cache-control.js.map +1 -0
- package/dist/commands/cache/clear.d.ts +34 -6
- package/dist/commands/cache/clear.d.ts.map +1 -1
- package/dist/commands/cache/clear.js +101 -15
- package/dist/commands/cache/clear.js.map +1 -1
- package/dist/commands/cache/index.d.ts +13 -63
- package/dist/commands/cache/index.d.ts.map +1 -1
- package/dist/commands/cache/index.js +47 -79
- package/dist/commands/cache/index.js.map +1 -1
- package/dist/commands/claude/claude-config.d.ts.map +1 -1
- package/dist/commands/claude/claude-config.js +6 -0
- package/dist/commands/claude/claude-config.js.map +1 -1
- package/dist/commands/claude/context.d.ts +340 -0
- package/dist/commands/claude/context.d.ts.map +1 -0
- package/dist/commands/claude/context.js +1080 -0
- package/dist/commands/claude/context.js.map +1 -0
- package/dist/commands/claude/index.d.ts +14 -0
- package/dist/commands/claude/index.d.ts.map +1 -1
- package/dist/commands/claude/index.js +22 -2
- package/dist/commands/claude/index.js.map +1 -1
- package/dist/commands/claude/marketplace/changelog-utils.d.ts +1 -1
- package/dist/commands/claude/marketplace/changelog-utils.d.ts.map +1 -1
- package/dist/commands/claude/marketplace/changelog-utils.js +1 -2
- package/dist/commands/claude/marketplace/changelog-utils.js.map +1 -1
- package/dist/commands/claude/marketplace/git-publish.d.ts.map +1 -1
- package/dist/commands/claude/marketplace/git-publish.js +40 -31
- package/dist/commands/claude/marketplace/git-publish.js.map +1 -1
- package/dist/commands/claude/marketplace/license-utils.d.ts.map +1 -1
- package/dist/commands/claude/marketplace/license-utils.js +0 -1
- package/dist/commands/claude/marketplace/license-utils.js.map +1 -1
- package/dist/commands/claude/marketplace/publish-tree.d.ts.map +1 -1
- package/dist/commands/claude/marketplace/publish-tree.js +0 -6
- package/dist/commands/claude/marketplace/publish-tree.js.map +1 -1
- package/dist/commands/claude/marketplace/publish.d.ts.map +1 -1
- package/dist/commands/claude/marketplace/publish.js +2 -1
- package/dist/commands/claude/marketplace/publish.js.map +1 -1
- package/dist/commands/claude/marketplace/validate.d.ts +73 -22
- package/dist/commands/claude/marketplace/validate.d.ts.map +1 -1
- package/dist/commands/claude/marketplace/validate.js +407 -72
- package/dist/commands/claude/marketplace/validate.js.map +1 -1
- package/dist/commands/claude/org/api-keys.d.ts +0 -3
- package/dist/commands/claude/org/api-keys.d.ts.map +1 -1
- package/dist/commands/claude/org/api-keys.js +2 -1
- package/dist/commands/claude/org/api-keys.js.map +1 -1
- package/dist/commands/claude/org/helpers.d.ts +54 -1
- package/dist/commands/claude/org/helpers.d.ts.map +1 -1
- package/dist/commands/claude/org/helpers.js +42 -7
- package/dist/commands/claude/org/helpers.js.map +1 -1
- package/dist/commands/claude/org/index.d.ts.map +1 -1
- package/dist/commands/claude/org/index.js +24 -16
- package/dist/commands/claude/org/index.js.map +1 -1
- package/dist/commands/claude/org/invites.d.ts +0 -3
- package/dist/commands/claude/org/invites.d.ts.map +1 -1
- package/dist/commands/claude/org/invites.js +3 -2
- package/dist/commands/claude/org/invites.js.map +1 -1
- package/dist/commands/claude/org/skills.d.ts +527 -0
- package/dist/commands/claude/org/skills.d.ts.map +1 -1
- package/dist/commands/claude/org/skills.js +1414 -108
- package/dist/commands/claude/org/skills.js.map +1 -1
- package/dist/commands/claude/org/users.d.ts +0 -3
- package/dist/commands/claude/org/users.d.ts.map +1 -1
- package/dist/commands/claude/org/users.js +6 -3
- package/dist/commands/claude/org/users.js.map +1 -1
- package/dist/commands/claude/org/workspaces.d.ts +0 -3
- package/dist/commands/claude/org/workspaces.d.ts.map +1 -1
- package/dist/commands/claude/org/workspaces.js +11 -7
- package/dist/commands/claude/org/workspaces.js.map +1 -1
- package/dist/commands/claude/plugin/build.d.ts +41 -3
- package/dist/commands/claude/plugin/build.d.ts.map +1 -1
- package/dist/commands/claude/plugin/build.js +147 -80
- package/dist/commands/claude/plugin/build.js.map +1 -1
- package/dist/commands/claude/plugin/helpers.d.ts.map +1 -1
- package/dist/commands/claude/plugin/helpers.js +2 -7
- package/dist/commands/claude/plugin/helpers.js.map +1 -1
- package/dist/commands/claude/plugin/install.d.ts +12 -0
- package/dist/commands/claude/plugin/install.d.ts.map +1 -1
- package/dist/commands/claude/plugin/install.js +93 -62
- package/dist/commands/claude/plugin/install.js.map +1 -1
- package/dist/commands/claude/plugin/list.d.ts.map +1 -1
- package/dist/commands/claude/plugin/list.js +3 -2
- package/dist/commands/claude/plugin/list.js.map +1 -1
- package/dist/commands/claude/plugin/marketplace-json.d.ts +24 -9
- package/dist/commands/claude/plugin/marketplace-json.d.ts.map +1 -1
- package/dist/commands/claude/plugin/marketplace-json.js +10 -9
- package/dist/commands/claude/plugin/marketplace-json.js.map +1 -1
- package/dist/commands/claude/plugin/plugin-changelog.d.ts.map +1 -1
- package/dist/commands/claude/plugin/plugin-changelog.js +0 -2
- package/dist/commands/claude/plugin/plugin-changelog.js.map +1 -1
- package/dist/commands/claude/plugin/plugin-files.d.ts.map +1 -1
- package/dist/commands/claude/plugin/plugin-files.js +3 -6
- package/dist/commands/claude/plugin/plugin-files.js.map +1 -1
- package/dist/commands/claude/plugin/plugin-validators.d.ts.map +1 -1
- package/dist/commands/claude/plugin/plugin-validators.js +3 -6
- package/dist/commands/claude/plugin/plugin-validators.js.map +1 -1
- package/dist/commands/claude/plugin/tree-copy.d.ts +73 -0
- package/dist/commands/claude/plugin/tree-copy.d.ts.map +1 -1
- package/dist/commands/claude/plugin/tree-copy.js +221 -14
- package/dist/commands/claude/plugin/tree-copy.js.map +1 -1
- package/dist/commands/claude/plugin/uninstall.d.ts.map +1 -1
- package/dist/commands/claude/plugin/uninstall.js +4 -4
- package/dist/commands/claude/plugin/uninstall.js.map +1 -1
- package/dist/commands/consistency-check.d.ts +17 -15
- package/dist/commands/consistency-check.d.ts.map +1 -1
- package/dist/commands/consistency-check.js +152 -106
- package/dist/commands/consistency-check.js.map +1 -1
- package/dist/commands/corpus/index.d.ts.map +1 -1
- package/dist/commands/corpus/index.js +3 -0
- package/dist/commands/corpus/index.js.map +1 -1
- package/dist/commands/corpus/report.d.ts +1 -2
- package/dist/commands/corpus/report.d.ts.map +1 -1
- package/dist/commands/corpus/report.js +1 -3
- package/dist/commands/corpus/report.js.map +1 -1
- package/dist/commands/corpus/runner.d.ts +58 -1
- package/dist/commands/corpus/runner.d.ts.map +1 -1
- package/dist/commands/corpus/runner.js +95 -41
- package/dist/commands/corpus/runner.js.map +1 -1
- package/dist/commands/corpus/scan.d.ts.map +1 -1
- package/dist/commands/corpus/scan.js +20 -12
- package/dist/commands/corpus/scan.js.map +1 -1
- package/dist/commands/corpus/seed.d.ts +4 -4
- package/dist/commands/corpus/seed.d.ts.map +1 -1
- package/dist/commands/corpus/seed.js +1 -3
- package/dist/commands/corpus/seed.js.map +1 -1
- package/dist/commands/doctor.d.ts +50 -0
- package/dist/commands/doctor.d.ts.map +1 -1
- package/dist/commands/doctor.js +245 -52
- package/dist/commands/doctor.js.map +1 -1
- package/dist/commands/inventory.d.ts +13 -1
- package/dist/commands/inventory.d.ts.map +1 -1
- package/dist/commands/inventory.js +121 -17
- package/dist/commands/inventory.js.map +1 -1
- package/dist/commands/mcp/collections.d.ts +1 -1
- package/dist/commands/mcp/collections.d.ts.map +1 -1
- package/dist/commands/mcp/list-collections.d.ts.map +1 -1
- package/dist/commands/mcp/list-collections.js +2 -1
- package/dist/commands/mcp/list-collections.js.map +1 -1
- package/dist/commands/mcp/serve.d.ts.map +1 -1
- package/dist/commands/mcp/serve.js +3 -2
- package/dist/commands/mcp/serve.js.map +1 -1
- package/dist/commands/okf/index.d.ts +11 -0
- package/dist/commands/okf/index.d.ts.map +1 -0
- package/dist/commands/okf/index.js +114 -0
- package/dist/commands/okf/index.js.map +1 -0
- package/dist/commands/okf/validate.d.ts +191 -0
- package/dist/commands/okf/validate.d.ts.map +1 -0
- package/dist/commands/okf/validate.js +190 -0
- package/dist/commands/okf/validate.js.map +1 -0
- package/dist/commands/phase-utils.d.ts +182 -114
- package/dist/commands/phase-utils.d.ts.map +1 -1
- package/dist/commands/phase-utils.js +154 -163
- package/dist/commands/phase-utils.js.map +1 -1
- package/dist/commands/positional-args.d.ts.map +1 -1
- package/dist/commands/positional-args.js +3 -2
- package/dist/commands/positional-args.js.map +1 -1
- package/dist/commands/rag/clear-command.d.ts.map +1 -1
- package/dist/commands/rag/clear-command.js +2 -1
- package/dist/commands/rag/clear-command.js.map +1 -1
- package/dist/commands/rag/index-command.d.ts +64 -0
- package/dist/commands/rag/index-command.d.ts.map +1 -1
- package/dist/commands/rag/index-command.js +72 -6
- package/dist/commands/rag/index-command.js.map +1 -1
- package/dist/commands/rag/index.d.ts.map +1 -1
- package/dist/commands/rag/index.js +23 -10
- package/dist/commands/rag/index.js.map +1 -1
- package/dist/commands/rag/query-command.d.ts.map +1 -1
- package/dist/commands/rag/query-command.js +2 -1
- package/dist/commands/rag/query-command.js.map +1 -1
- package/dist/commands/rag/stats-command.d.ts.map +1 -1
- package/dist/commands/rag/stats-command.js +2 -1
- package/dist/commands/rag/stats-command.js.map +1 -1
- package/dist/commands/resources/builtin-help.d.ts +27 -0
- package/dist/commands/resources/builtin-help.d.ts.map +1 -0
- package/dist/commands/resources/builtin-help.js +46 -0
- package/dist/commands/resources/builtin-help.js.map +1 -0
- package/dist/commands/resources/check-progress.d.ts +154 -0
- package/dist/commands/resources/check-progress.d.ts.map +1 -0
- package/dist/commands/resources/check-progress.js +222 -0
- package/dist/commands/resources/check-progress.js.map +1 -0
- package/dist/commands/resources/check-supervisor.d.ts +465 -0
- package/dist/commands/resources/check-supervisor.d.ts.map +1 -0
- package/dist/commands/resources/check-supervisor.js +573 -0
- package/dist/commands/resources/check-supervisor.js.map +1 -0
- package/dist/commands/resources/check.d.ts +593 -0
- package/dist/commands/resources/check.d.ts.map +1 -0
- package/dist/commands/resources/check.js +1365 -0
- package/dist/commands/resources/check.js.map +1 -0
- package/dist/commands/resources/index.d.ts.map +1 -1
- package/dist/commands/resources/index.js +418 -4
- package/dist/commands/resources/index.js.map +1 -1
- package/dist/commands/resources/query.d.ts +106 -0
- package/dist/commands/resources/query.d.ts.map +1 -0
- package/dist/commands/resources/query.js +177 -0
- package/dist/commands/resources/query.js.map +1 -0
- package/dist/commands/resources/scan.d.ts +24 -0
- package/dist/commands/resources/scan.d.ts.map +1 -1
- package/dist/commands/resources/scan.js +17 -8
- package/dist/commands/resources/scan.js.map +1 -1
- package/dist/commands/resources/validate.d.ts +42 -2
- package/dist/commands/resources/validate.d.ts.map +1 -1
- package/dist/commands/resources/validate.js +208 -55
- package/dist/commands/resources/validate.js.map +1 -1
- package/dist/commands/skill/review-checklist.d.ts +3 -2
- package/dist/commands/skill/review-checklist.d.ts.map +1 -1
- package/dist/commands/skill/review-checklist.js +40 -2
- package/dist/commands/skill/review-checklist.js.map +1 -1
- package/dist/commands/skill/review.d.ts +247 -0
- package/dist/commands/skill/review.d.ts.map +1 -1
- package/dist/commands/skill/review.js +99 -62
- package/dist/commands/skill/review.js.map +1 -1
- package/dist/commands/skill/test/configure.d.ts +56 -0
- package/dist/commands/skill/test/configure.d.ts.map +1 -1
- package/dist/commands/skill/test/configure.js +75 -16
- package/dist/commands/skill/test/configure.js.map +1 -1
- package/dist/commands/skill/test/run.d.ts +63 -10
- package/dist/commands/skill/test/run.d.ts.map +1 -1
- package/dist/commands/skill/test/run.js +258 -77
- package/dist/commands/skill/test/run.js.map +1 -1
- package/dist/commands/skills/build.d.ts +94 -4
- package/dist/commands/skills/build.d.ts.map +1 -1
- package/dist/commands/skills/build.js +325 -97
- package/dist/commands/skills/build.js.map +1 -1
- package/dist/commands/skills/install.d.ts +2 -1
- package/dist/commands/skills/install.d.ts.map +1 -1
- package/dist/commands/skills/install.js +20 -31
- package/dist/commands/skills/install.js.map +1 -1
- package/dist/commands/skills/list.d.ts +2 -1
- package/dist/commands/skills/list.d.ts.map +1 -1
- package/dist/commands/skills/list.js +44 -26
- package/dist/commands/skills/list.js.map +1 -1
- package/dist/commands/skills/package.d.ts +1 -1
- package/dist/commands/skills/package.d.ts.map +1 -1
- package/dist/commands/skills/package.js +6 -8
- package/dist/commands/skills/package.js.map +1 -1
- package/dist/commands/skills/scope-guard.d.ts.map +1 -1
- package/dist/commands/skills/scope-guard.js +3 -5
- package/dist/commands/skills/scope-guard.js.map +1 -1
- package/dist/commands/skills/shared.d.ts.map +1 -1
- package/dist/commands/skills/shared.js +2 -4
- package/dist/commands/skills/shared.js.map +1 -1
- package/dist/commands/skills/skill-discovery.d.ts +47 -6
- package/dist/commands/skills/skill-discovery.d.ts.map +1 -1
- package/dist/commands/skills/skill-discovery.js +61 -11
- package/dist/commands/skills/skill-discovery.js.map +1 -1
- package/dist/commands/skills/source-resolvers.d.ts +15 -0
- package/dist/commands/skills/source-resolvers.d.ts.map +1 -1
- package/dist/commands/skills/source-resolvers.js +25 -4
- package/dist/commands/skills/source-resolvers.js.map +1 -1
- package/dist/commands/skills/validate-command.d.ts.map +1 -1
- package/dist/commands/skills/validate-command.js +11 -3
- package/dist/commands/skills/validate-command.js.map +1 -1
- package/dist/commands/skills/validate.d.ts +140 -4
- package/dist/commands/skills/validate.d.ts.map +1 -1
- package/dist/commands/skills/validate.js +224 -67
- package/dist/commands/skills/validate.js.map +1 -1
- package/dist/commands/validate.d.ts +1 -1
- package/dist/commands/validate.d.ts.map +1 -1
- package/dist/commands/validate.js +63 -27
- package/dist/commands/validate.js.map +1 -1
- package/dist/commands/verify.d.ts +119 -15
- package/dist/commands/verify.d.ts.map +1 -1
- package/dist/commands/verify.js +357 -142
- package/dist/commands/verify.js.map +1 -1
- package/dist/index.d.ts +0 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -1
- package/dist/index.js.map +1 -1
- package/dist/report-schemas.d.ts +45 -0
- package/dist/report-schemas.d.ts.map +1 -0
- package/dist/report-schemas.js +100 -0
- package/dist/report-schemas.js.map +1 -0
- package/dist/skill-resolution/classify.js +2 -2
- package/dist/skill-resolution/classify.js.map +1 -1
- package/dist/skill-resolution/packaging-config.d.ts +49 -5
- package/dist/skill-resolution/packaging-config.d.ts.map +1 -1
- package/dist/skill-resolution/packaging-config.js +59 -19
- package/dist/skill-resolution/packaging-config.js.map +1 -1
- package/dist/skill-resolution/resolve-skill-reference.d.ts.map +1 -1
- package/dist/skill-resolution/resolve-skill-reference.js +55 -57
- package/dist/skill-resolution/resolve-skill-reference.js.map +1 -1
- package/dist/utils/agent-discovery.d.ts.map +1 -1
- package/dist/utils/agent-discovery.js +22 -11
- package/dist/utils/agent-discovery.js.map +1 -1
- package/dist/utils/agent-runner.d.ts.map +1 -1
- package/dist/utils/agent-runner.js +7 -4
- package/dist/utils/agent-runner.js.map +1 -1
- package/dist/utils/claude-context-lens.d.ts +34 -0
- package/dist/utils/claude-context-lens.d.ts.map +1 -0
- package/dist/utils/claude-context-lens.js +39 -0
- package/dist/utils/claude-context-lens.js.map +1 -0
- package/dist/utils/command-error.d.ts +138 -20
- package/dist/utils/command-error.d.ts.map +1 -1
- package/dist/utils/command-error.js +172 -36
- package/dist/utils/command-error.js.map +1 -1
- package/dist/utils/config-loader.d.ts +2 -1
- package/dist/utils/config-loader.d.ts.map +1 -1
- package/dist/utils/config-loader.js +40 -14
- package/dist/utils/config-loader.js.map +1 -1
- package/dist/utils/corpus-target.d.ts +26 -0
- package/dist/utils/corpus-target.d.ts.map +1 -0
- package/dist/utils/corpus-target.js +35 -0
- package/dist/utils/corpus-target.js.map +1 -0
- package/dist/utils/edge-lens-evaluation.d.ts +83 -0
- package/dist/utils/edge-lens-evaluation.d.ts.map +1 -0
- package/dist/utils/edge-lens-evaluation.js +110 -0
- package/dist/utils/edge-lens-evaluation.js.map +1 -0
- package/dist/utils/help-loader.d.ts.map +1 -1
- package/dist/utils/help-loader.js +0 -1
- package/dist/utils/help-loader.js.map +1 -1
- package/dist/utils/issue-anchor.d.ts +2 -2
- package/dist/utils/issue-anchor.d.ts.map +1 -1
- package/dist/utils/issue-anchor.js +1 -1
- package/dist/utils/issue-rendering.d.ts +3 -3
- package/dist/utils/issue-rendering.d.ts.map +1 -1
- package/dist/utils/issue-rendering.js +3 -3
- package/dist/utils/issue-rendering.js.map +1 -1
- package/dist/utils/issue-severity.d.ts +12 -5
- package/dist/utils/issue-severity.d.ts.map +1 -1
- package/dist/utils/issue-severity.js +1 -1
- package/dist/utils/issue-severity.js.map +1 -1
- package/dist/utils/optional-backend.d.ts +78 -0
- package/dist/utils/optional-backend.d.ts.map +1 -0
- package/dist/utils/optional-backend.js +117 -0
- package/dist/utils/optional-backend.js.map +1 -0
- package/dist/utils/output.d.ts +26 -0
- package/dist/utils/output.d.ts.map +1 -1
- package/dist/utils/output.js +35 -0
- package/dist/utils/output.js.map +1 -1
- package/dist/utils/package-json.d.ts +24 -0
- package/dist/utils/package-json.d.ts.map +1 -0
- package/dist/utils/package-json.js +49 -0
- package/dist/utils/package-json.js.map +1 -0
- package/dist/utils/population-wiring.d.ts +100 -0
- package/dist/utils/population-wiring.d.ts.map +1 -0
- package/dist/utils/population-wiring.js +98 -0
- package/dist/utils/population-wiring.js.map +1 -0
- package/dist/utils/project-root-policy.d.ts +20 -0
- package/dist/utils/project-root-policy.d.ts.map +1 -1
- package/dist/utils/project-root-policy.js +30 -0
- package/dist/utils/project-root-policy.js.map +1 -1
- package/dist/utils/projection-lenses.d.ts +98 -0
- package/dist/utils/projection-lenses.d.ts.map +1 -0
- package/dist/utils/projection-lenses.js +203 -0
- package/dist/utils/projection-lenses.js.map +1 -0
- package/dist/utils/projection-query.d.ts +324 -0
- package/dist/utils/projection-query.d.ts.map +1 -0
- package/dist/utils/projection-query.js +357 -0
- package/dist/utils/projection-query.js.map +1 -0
- package/dist/utils/projection-store.d.ts +335 -0
- package/dist/utils/projection-store.d.ts.map +1 -0
- package/dist/utils/projection-store.js +522 -0
- package/dist/utils/projection-store.js.map +1 -0
- package/dist/utils/relation-limits.d.ts +50 -0
- package/dist/utils/relation-limits.d.ts.map +1 -0
- package/dist/utils/relation-limits.js +50 -0
- package/dist/utils/relation-limits.js.map +1 -0
- package/dist/utils/repeatable-option.d.ts +37 -0
- package/dist/utils/repeatable-option.d.ts.map +1 -0
- package/dist/utils/repeatable-option.js +39 -0
- package/dist/utils/repeatable-option.js.map +1 -0
- package/dist/utils/resource-loader.d.ts +132 -2
- package/dist/utils/resource-loader.d.ts.map +1 -1
- package/dist/utils/resource-loader.js +288 -27
- package/dist/utils/resource-loader.js.map +1 -1
- package/dist/utils/root-argv.d.ts +53 -0
- package/dist/utils/root-argv.d.ts.map +1 -0
- package/dist/utils/root-argv.js +215 -0
- package/dist/utils/root-argv.js.map +1 -0
- package/dist/utils/run-integrity.d.ts +95 -0
- package/dist/utils/run-integrity.d.ts.map +1 -0
- package/dist/utils/run-integrity.js +102 -0
- package/dist/utils/run-integrity.js.map +1 -0
- package/dist/utils/skill-discovery.d.ts.map +1 -1
- package/dist/utils/skill-discovery.js +2 -1
- package/dist/utils/skill-discovery.js.map +1 -1
- package/dist/utils/skill-packaging-config.d.ts +63 -1
- package/dist/utils/skill-packaging-config.d.ts.map +1 -1
- package/dist/utils/skill-packaging-config.js +56 -1
- package/dist/utils/skill-packaging-config.js.map +1 -1
- package/dist/utils/sqlite-experimental-warning.d.ts +69 -0
- package/dist/utils/sqlite-experimental-warning.d.ts.map +1 -0
- package/dist/utils/sqlite-experimental-warning.js +144 -0
- package/dist/utils/sqlite-experimental-warning.js.map +1 -0
- package/dist/utils/url-redact.d.ts.map +1 -1
- package/dist/utils/url-redact.js +4 -6
- package/dist/utils/url-redact.js.map +1 -1
- package/dist/utils/user-context-scanner.d.ts +8 -0
- package/dist/utils/user-context-scanner.d.ts.map +1 -1
- package/dist/utils/user-context-scanner.js +4 -2
- package/dist/utils/user-context-scanner.js.map +1 -1
- package/dist/utils/validate-help-files.d.ts.map +1 -1
- package/dist/utils/validate-help-files.js +12 -6
- package/dist/utils/validate-help-files.js.map +1 -1
- package/dist/utils/vat-bin-path.d.ts +36 -0
- package/dist/utils/vat-bin-path.d.ts.map +1 -0
- package/dist/utils/vat-bin-path.js +48 -0
- package/dist/utils/vat-bin-path.js.map +1 -0
- package/dist/utils/verdict-helpers.d.ts +1 -1
- package/dist/utils/verdict-helpers.d.ts.map +1 -1
- package/dist/utils/verdict-helpers.js +1 -1
- package/dist/utils/verdict-helpers.js.map +1 -1
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +1 -3
- package/dist/version.js.map +1 -1
- package/docs/agent.md +2 -2
- package/docs/audit.md +141 -37
- package/docs/doctor.md +7 -6
- package/docs/index.md +19 -11
- package/docs/mcp.md +2 -2
- package/docs/rag.md +3 -2
- package/docs/resources.md +13 -3
- package/docs/skill-test.md +10 -9
- package/docs/skills.md +53 -69
- package/package.json +35 -26
- package/schemas/ard-emit.json +149 -0
- package/schemas/okf-validate.json +170 -0
- package/schemas/resources-check.json +229 -0
- package/schemas/skill-review.json +230 -0
- package/dist/commands/resources/command-helpers.d.ts +0 -5
- package/dist/commands/resources/command-helpers.d.ts.map +0 -1
- package/dist/commands/resources/command-helpers.js +0 -6
- package/dist/commands/resources/command-helpers.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"claude-config.js","sourceRoot":"","sources":["../../../src/commands/claude/claude-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAqB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAK3C,+EAA+E;IAC/E,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC"}
|
|
1
|
+
{"version":3,"file":"claude-config.js","sourceRoot":"","sources":["../../../src/commands/claude/claude-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAqB,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAK3C,+EAA+E;IAC/E,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAChE,CAAC"}
|
|
@@ -0,0 +1,340 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `vat claude context [path]` — what loads into an agent's context here, and
|
|
3
|
+
* what it costs.
|
|
4
|
+
*
|
|
5
|
+
* The first ANALYSIS verb under `vat claude`, which until now held only
|
|
6
|
+
* management verbs (plugins, marketplaces, org administration). It answers a
|
|
7
|
+
* question, changes nothing, and never gates: there is no threshold anywhere in
|
|
8
|
+
* this file, and the only non-zero exit is {@link handleCommandError}'s 2 for a
|
|
9
|
+
* system failure. A number that fails a build teaches people to stop reading it.
|
|
10
|
+
*
|
|
11
|
+
* ## Everything below is orchestration and formatting — deliberately
|
|
12
|
+
*
|
|
13
|
+
* Which files load, why, and what they cost are all decided in
|
|
14
|
+
* `@vibe-agent-toolkit/resources` (`whatLoadsAt` and `account`). This module
|
|
15
|
+
* populates, calls them, and renders. It computes nothing about context loading
|
|
16
|
+
* of its own, which is the CLI-stays-dumb rule applied to a lane where the
|
|
17
|
+
* temptation is strong: the totals are right there and a "just one more derived
|
|
18
|
+
* field" would put a second, unowned model of the vendor's behaviour in the
|
|
19
|
+
* package no other package can depend on.
|
|
20
|
+
*
|
|
21
|
+
* ## The limits ride WITH the run — ONCE — in every format
|
|
22
|
+
*
|
|
23
|
+
* Spec §11 puts the stated limits in the command's own output rather than in a
|
|
24
|
+
* doc, because a limit a reader has to go and find is a limit that never reaches
|
|
25
|
+
* the person acting on the number. So {@link CLAUDE_CONTEXT_LIMITS} and
|
|
26
|
+
* {@link CLAUDE_CONTEXT_MODELLED_BEHAVIOURS} are fields of the yaml/json
|
|
27
|
+
* ENVELOPE and a printed section of the text rendering, and
|
|
28
|
+
* {@link CLAUDE_CONTEXT_BOUNDS_STATEMENT} — *neither a floor nor a ceiling* —
|
|
29
|
+
* appears in all three. All three are imported, never restated: the sentence is
|
|
30
|
+
* domain content owned beside the list it frames, so every other consumer of the
|
|
31
|
+
* list reaches it too.
|
|
32
|
+
*
|
|
33
|
+
* ⛔ They belong to the ENVELOPE, never to an answer or a region, and every
|
|
34
|
+
* rendering obeys that identically — see {@link ContextEnvelope} for why.
|
|
35
|
+
* Attaching them per answer was not a formatting preference: on the whole-tree
|
|
36
|
+
* sweep `--all` used to be (6,224 answers on this repository) `--format json`
|
|
37
|
+
* measured 76,877,016 bytes and measures 6,581,468 with the block hoisted — 70.3
|
|
38
|
+
* MB of ONE byte-identical paragraph, repeated. That is the JSON spelling of the
|
|
39
|
+
* very burial {@link renderEnvelopeText} refuses to do in text, and it is why
|
|
40
|
+
* {@link ContextCostMapEnvelope} hoists the same block rather than growing one
|
|
41
|
+
* per region.
|
|
42
|
+
*
|
|
43
|
+
* ## `--all` is a MAP, not a sweep
|
|
44
|
+
*
|
|
45
|
+
* ⛔ `--all` emits no per-path documents in any format. It used to answer for
|
|
46
|
+
* every realized path — 10,438 documents and 205,918 lines on a large adopter
|
|
47
|
+
* monorepo, ~491 s — which is not a report anyone reads. It now emits the
|
|
48
|
+
* whole-tree cost map {@link buildContextCostMap} builds, which answers the
|
|
49
|
+
* question the flag exists for: where in this tree is it expensive to work.
|
|
50
|
+
* Naming paths is the drill-down, and is the only way to get a per-path answer.
|
|
51
|
+
*
|
|
52
|
+
* ⛔ Nothing here may read as "complete". Many of the stated limits are signed
|
|
53
|
+
* `over-report`/`under-report` and apply whether or not `unknownTokenRows`,
|
|
54
|
+
* `skippedOversizeRows` and `prunedRows` are all zero, so zeroed counters are not
|
|
55
|
+
* a licence for the words "total cost", "full" or "all context".
|
|
56
|
+
*
|
|
57
|
+
* ⛔ A `null` token or byte count is an UNKNOWN SIZE and is never rendered as 0 —
|
|
58
|
+
* see {@link chargeText}. A confident zero is indistinguishable from a measured
|
|
59
|
+
* one, and the same reasoning is why an unrealized path answers `unknown` rather
|
|
60
|
+
* than an empty table.
|
|
61
|
+
*/
|
|
62
|
+
import { type AccountedRow, type ContextCostMap, type ContextTotals, type DiscoverableContext, type GradedCondition, type LoadedContextAnswer, type ModelledBehaviour, type Projection, type StatedLimit } from '@vibe-agent-toolkit/resources';
|
|
63
|
+
import { Command } from 'commander';
|
|
64
|
+
/**
|
|
65
|
+
* How many rows each RANKED section of the `--all` cost map prints.
|
|
66
|
+
*
|
|
67
|
+
* ⛔ A cap exists because the previous shape of `--all` had none: it answered for
|
|
68
|
+
* every realized path, which on a large adopter monorepo was 10,438 documents and
|
|
69
|
+
* 205,918 lines — an output nobody, human or agent, can act on. The map collapses
|
|
70
|
+
* that to two ranked lists, and a ranked list is only useful if its head is
|
|
71
|
+
* readable in one screen. 20 is that head: enough that a real hot spot is
|
|
72
|
+
* somewhere in it, few enough that the whole report stays scannable.
|
|
73
|
+
*
|
|
74
|
+
* ⛔ It bounds the TEXT rendering ONLY. `--format json` carries the map whole —
|
|
75
|
+
* see {@link ContextCostMapEnvelope} — because a program asked for the map, not
|
|
76
|
+
* for a summary of it, and a silently-truncated array is a defect a consumer
|
|
77
|
+
* cannot see.
|
|
78
|
+
*
|
|
79
|
+
* ⛔ Whenever it fires, {@link omittedNotice} says how many rows were left out. A
|
|
80
|
+
* silent cap reads as "this is everything", which is the one thing this report
|
|
81
|
+
* must never say. Exported so a test pins the notice's arithmetic against the
|
|
82
|
+
* same number the renderer slices at, rather than against a literal that is free
|
|
83
|
+
* to disagree with it.
|
|
84
|
+
*/
|
|
85
|
+
export declare const COST_MAP_ROW_LIMIT = 20;
|
|
86
|
+
/** How the answer is rendered. `text` is for a person; the other two are for a program. */
|
|
87
|
+
export type ContextOutputFormat = 'text' | 'yaml' | 'json';
|
|
88
|
+
/** Flags `vat claude context` accepts. */
|
|
89
|
+
export interface ClaudeContextOptions {
|
|
90
|
+
format?: ContextOutputFormat;
|
|
91
|
+
debug?: boolean;
|
|
92
|
+
all?: boolean;
|
|
93
|
+
discoverable?: boolean;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* The envelope every run emits, however many paths were asked about.
|
|
97
|
+
*
|
|
98
|
+
* ⛔ `answers` is an array **even for one path**, so a consumer never branches on
|
|
99
|
+
* arity. The single-path shape is the N=1 case of the sweep, not a different
|
|
100
|
+
* document — a caller that special-cased "one path means a bare object" is the
|
|
101
|
+
* defect this shape exists to prevent, and pre-1.0 is when to pay for it.
|
|
102
|
+
*
|
|
103
|
+
* `root` rides here rather than on each answer because it is a property of the
|
|
104
|
+
* POPULATION, and one run populates exactly one tree. Repeating it per answer
|
|
105
|
+
* would invite a reader to believe two answers could carry different roots.
|
|
106
|
+
*
|
|
107
|
+
* ⛔ The three limit fields ride here for the SAME reason, and it is the reason
|
|
108
|
+
* {@link renderEnvelopeText} already prints them once: they bound the
|
|
109
|
+
* MEASUREMENT METHOD, not any one path. An answer carrying its own copy reads
|
|
110
|
+
* as though that path had caveats of its own — and repeated across a sweep it
|
|
111
|
+
* is pure duplication, byte-identical every time.
|
|
112
|
+
*/
|
|
113
|
+
export interface ContextEnvelope {
|
|
114
|
+
/**
|
|
115
|
+
* Which of this command's two documents this is.
|
|
116
|
+
*
|
|
117
|
+
* ⛔ A SHAPE discriminator, not a version. `--all` emits
|
|
118
|
+
* {@link ContextCostMapEnvelope} and everything else emits this one; the two
|
|
119
|
+
* share only `root` and the limit block, so a consumer that guessed would read
|
|
120
|
+
* `answers` off a map and silently get `undefined`. It says nothing about a
|
|
121
|
+
* schema generation — under pre-1.0 the package version is the only contract,
|
|
122
|
+
* and this project prohibits emitting a second versioning scheme.
|
|
123
|
+
*/
|
|
124
|
+
readonly kind: 'context-answers';
|
|
125
|
+
readonly root: string;
|
|
126
|
+
readonly answers: readonly (ContextAnswerDocument | ContextUnknownDocument)[];
|
|
127
|
+
/** What these answers do not settle, in either direction. Stated once. */
|
|
128
|
+
readonly boundsStatement: string;
|
|
129
|
+
/** The signed over/under-report bounds on the method. Stated once. */
|
|
130
|
+
readonly limits: readonly StatedLimit[];
|
|
131
|
+
/** The vendor behaviours modelled, each cited. Stated once. */
|
|
132
|
+
readonly modelledBehaviours: readonly ModelledBehaviour[];
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* The envelope `--all` emits: the whole-tree cost map, not a pile of answers.
|
|
136
|
+
*
|
|
137
|
+
* ⛔ **A DIFFERENT document from {@link ContextEnvelope}, deliberately, and
|
|
138
|
+
* `kind` is what tells them apart.** `--all` used to answer for every realized
|
|
139
|
+
* path — 10,438 documents on a large adopter monorepo — which answered the
|
|
140
|
+
* question "what loads at each of ten thousand paths" nobody asked, in place of
|
|
141
|
+
* "where is it expensive to work here", which is what the flag is for. Naming
|
|
142
|
+
* paths explicitly is still the per-path answer, and is now the only way to get
|
|
143
|
+
* one.
|
|
144
|
+
*
|
|
145
|
+
* ⛔ The three limit fields ride HERE, exactly as they ride on
|
|
146
|
+
* {@link ContextEnvelope}, and for the same measured reason: attached per row
|
|
147
|
+
* they were 70.3 MB of one byte-identical paragraph on a single sweep. They bound
|
|
148
|
+
* the MEASUREMENT METHOD, so a region carrying its own copy would also read as
|
|
149
|
+
* though that region had caveats of its own.
|
|
150
|
+
*
|
|
151
|
+
* 🔑 `costMap` is nested rather than spread across the envelope so that "the
|
|
152
|
+
* limits are on the envelope and on nothing inside it" is a structural property a
|
|
153
|
+
* reader can check by eye, rather than an invariant maintained by hand at each
|
|
154
|
+
* new field.
|
|
155
|
+
*/
|
|
156
|
+
export interface ContextCostMapEnvelope {
|
|
157
|
+
/** Which of this command's two documents this is — see {@link ContextEnvelope.kind}. */
|
|
158
|
+
readonly kind: 'context-cost-map';
|
|
159
|
+
readonly root: string;
|
|
160
|
+
/**
|
|
161
|
+
* The map WHOLE — every region and every directory, never the text
|
|
162
|
+
* rendering's top {@link COST_MAP_ROW_LIMIT}. A program asked for the map, and
|
|
163
|
+
* a silently-shortened array is a truncation its consumer cannot detect.
|
|
164
|
+
*/
|
|
165
|
+
readonly costMap: ContextCostMap;
|
|
166
|
+
/** What this map does not settle, in either direction. Stated once. */
|
|
167
|
+
readonly boundsStatement: string;
|
|
168
|
+
/** The signed over/under-report bounds on the method. Stated once. */
|
|
169
|
+
readonly limits: readonly StatedLimit[];
|
|
170
|
+
/** The vendor behaviours modelled, each cited. Stated once. */
|
|
171
|
+
readonly modelledBehaviours: readonly ModelledBehaviour[];
|
|
172
|
+
}
|
|
173
|
+
/**
|
|
174
|
+
* The yaml/json document for a path the projection realizes.
|
|
175
|
+
*
|
|
176
|
+
* `rows` are `AccountedRow`s verbatim rather than a narrowed projection of them:
|
|
177
|
+
* re-shaping the rows here would be the CLI deciding which of the accounting
|
|
178
|
+
* module's facts a consumer is allowed to see, and `resourceId` and `bytes` are
|
|
179
|
+
* exactly what a consumer joining this answer to another projection query needs.
|
|
180
|
+
*/
|
|
181
|
+
export interface ContextAnswerDocument {
|
|
182
|
+
readonly kind: 'answer';
|
|
183
|
+
readonly input: string;
|
|
184
|
+
readonly directory: string;
|
|
185
|
+
readonly file: string | null;
|
|
186
|
+
readonly totals: ContextTotals;
|
|
187
|
+
readonly rows: readonly AccountedRow[];
|
|
188
|
+
readonly conditions: readonly GradedCondition[];
|
|
189
|
+
readonly overBudgetRules: readonly string[];
|
|
190
|
+
readonly unattributedImports: readonly string[];
|
|
191
|
+
/**
|
|
192
|
+
* What the loaded set POINTS AT in one hop and the harness does not load, or
|
|
193
|
+
* null when `--discoverable` was not asked for.
|
|
194
|
+
*
|
|
195
|
+
* ⛔ `null` rather than an empty object, and the difference is the whole
|
|
196
|
+
* reason the field is nullable: an empty `rows` array means "nothing here
|
|
197
|
+
* links anywhere", and a run that never looked must not be readable as that.
|
|
198
|
+
* The same distinction {@link ContextUnknownDocument} exists to draw, one
|
|
199
|
+
* level down.
|
|
200
|
+
*
|
|
201
|
+
* ⛔ Its tokens are NEVER added to `totals`. A markdown link is voluntary —
|
|
202
|
+
* nothing loads it — so folding it into a context-budget figure would charge
|
|
203
|
+
* a session for documents it may never open.
|
|
204
|
+
*/
|
|
205
|
+
readonly discoverable: DiscoverableContext | null;
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* The yaml/json document for a path the projection never realized.
|
|
209
|
+
*
|
|
210
|
+
* ⛔ Structurally different from an answer, and that is the point: it carries no
|
|
211
|
+
* `totals` and no `rows`, so a consumer cannot accidentally read "VAT never
|
|
212
|
+
* looked at this path" as "nothing loads here". `explanation` says the same thing
|
|
213
|
+
* to a person who is reading the document rather than switching on `kind`.
|
|
214
|
+
*/
|
|
215
|
+
export interface ContextUnknownDocument {
|
|
216
|
+
readonly kind: 'unknown';
|
|
217
|
+
readonly input: string;
|
|
218
|
+
readonly reason: 'path-not-realized';
|
|
219
|
+
readonly explanation: string;
|
|
220
|
+
}
|
|
221
|
+
/**
|
|
222
|
+
* Create the `vat claude context [path]` command.
|
|
223
|
+
*
|
|
224
|
+
* @returns The configured Commander command
|
|
225
|
+
*/
|
|
226
|
+
export declare function createContextCommand(): Command;
|
|
227
|
+
/**
|
|
228
|
+
* Action handler for `vat claude context [path]`.
|
|
229
|
+
*
|
|
230
|
+
* ⛔ The two branches produce DIFFERENT documents and there is no third mode: a
|
|
231
|
+
* `--per-path` escape hatch back to the old sweep is exactly the backward
|
|
232
|
+
* compatibility shim this project forbids pre-1.0, and naming paths explicitly
|
|
233
|
+
* already gives the per-path answer — now from a population the caller pays for
|
|
234
|
+
* once instead of ten thousand times.
|
|
235
|
+
*
|
|
236
|
+
* @param pathArgs - The paths to answer for; empty means the current directory
|
|
237
|
+
* @param options - The command's flags
|
|
238
|
+
*/
|
|
239
|
+
export declare function claudeContextCommand(pathArgs: readonly string[], options: ClaudeContextOptions): Promise<void>;
|
|
240
|
+
/**
|
|
241
|
+
* The answer document for one query.
|
|
242
|
+
*
|
|
243
|
+
* Split from the handler so the handler stays a straight line: the accounting
|
|
244
|
+
* call needs the `claude-md` identity set, and threading that through the
|
|
245
|
+
* handler body put three statements between the query and its document.
|
|
246
|
+
*
|
|
247
|
+
* Returns the document alone — rendering moved to {@link renderEnvelopeText},
|
|
248
|
+
* which needs every document at once to print the limits exactly once, and the
|
|
249
|
+
* limits themselves are attached by {@link contextEnvelope}, never here.
|
|
250
|
+
*
|
|
251
|
+
* ⛔ Exported so it can be TESTED. What has to be pinned is an ABSENCE — that no
|
|
252
|
+
* limit field is on the returned document — and an absence is only observable by
|
|
253
|
+
* calling the function that would have added it.
|
|
254
|
+
*
|
|
255
|
+
* @param answer - The query's answer
|
|
256
|
+
* @param projection - The populated projection, for the `claude-md` tag rows
|
|
257
|
+
* @param discoverable - Whether to compute the one-hop reachable set
|
|
258
|
+
* @returns The answer document
|
|
259
|
+
*/
|
|
260
|
+
export declare function answerDocument(answer: LoadedContextAnswer, projection: Projection, discoverable: boolean): ContextAnswerDocument;
|
|
261
|
+
/**
|
|
262
|
+
* Wrap the run's documents in the envelope, with the limits attached ONCE.
|
|
263
|
+
*
|
|
264
|
+
* The one place {@link CLAUDE_CONTEXT_LIMITS} and its two companions enter the
|
|
265
|
+
* machine-readable output. Keeping that a single assignment is what makes the
|
|
266
|
+
* "stated once" property structural rather than a habit: there is no per-answer
|
|
267
|
+
* site left where a copy could be reintroduced.
|
|
268
|
+
*
|
|
269
|
+
* ⛔ Exported so it can be TESTED alongside {@link answerDocument} — the
|
|
270
|
+
* regression this guards (an answer growing its own copy of the block) is a
|
|
271
|
+
* property of the two functions TOGETHER, and a test that can reach only one of
|
|
272
|
+
* them cannot see it.
|
|
273
|
+
*
|
|
274
|
+
* @param root - The corpus root that was enumerated
|
|
275
|
+
* @param answers - One document per requested path, in the order requested
|
|
276
|
+
* @returns The envelope, ready to serialize
|
|
277
|
+
*/
|
|
278
|
+
export declare function contextEnvelope(root: string, answers: readonly (ContextAnswerDocument | ContextUnknownDocument)[]): ContextEnvelope;
|
|
279
|
+
/**
|
|
280
|
+
* Wrap the `--all` cost map in its envelope, with the limits attached ONCE.
|
|
281
|
+
*
|
|
282
|
+
* The mirror of {@link contextEnvelope}, and deliberately its own function rather
|
|
283
|
+
* than a generic over both: the two envelopes differ in more than one field, and
|
|
284
|
+
* a shared builder taking a payload would make `kind` a parameter — which is how
|
|
285
|
+
* a discriminator stops discriminating.
|
|
286
|
+
*
|
|
287
|
+
* ⛔ Exported so a test can pin, over a many-region map, that the limit block
|
|
288
|
+
* appears exactly ONCE in the serialized document. Presence passes on a copy per
|
|
289
|
+
* region, which is the 70.3 MB defect this command already shipped once.
|
|
290
|
+
*
|
|
291
|
+
* @param root - The corpus root that was enumerated
|
|
292
|
+
* @param costMap - The whole-tree cost map, carried entire
|
|
293
|
+
* @returns The envelope, ready to serialize
|
|
294
|
+
*/
|
|
295
|
+
export declare function costMapEnvelope(root: string, costMap: ContextCostMap): ContextCostMapEnvelope;
|
|
296
|
+
/**
|
|
297
|
+
* Render the `--all` cost map for a person: where in this tree it is expensive
|
|
298
|
+
* to work.
|
|
299
|
+
*
|
|
300
|
+
* Four sections, in the order a reader needs them — the region table (what each
|
|
301
|
+
* part of the tree costs at launch), the regions' own files (what they are paying
|
|
302
|
+
* for), the directories that cost the most to work in overall, and what the map
|
|
303
|
+
* looked at — then the limits, ONCE.
|
|
304
|
+
*
|
|
305
|
+
* ⛔ Every ranked section is capped at {@link COST_MAP_ROW_LIMIT} and every cap
|
|
306
|
+
* that fires announces itself. ⛔ Nothing here sums an unknown into a total or
|
|
307
|
+
* calls any figure complete: the counted-not-summed rows are printed beside each
|
|
308
|
+
* estimate, and the stated limits apply whether or not those counters are zero.
|
|
309
|
+
*
|
|
310
|
+
* ⛔ Exported so the properties above can be TESTED with inputs a real tree never
|
|
311
|
+
* produces — a null token count, more directories than the cap. On this repository
|
|
312
|
+
* every file has a measured blob, so an assertion driven by a real run compares
|
|
313
|
+
* `false === false` and would keep passing against a `?? 0`.
|
|
314
|
+
*
|
|
315
|
+
* @param map - The whole-tree cost map from `buildContextCostMap`
|
|
316
|
+
* @returns The text rendering, newline-terminated
|
|
317
|
+
*/
|
|
318
|
+
export declare function renderCostMapText(map: ContextCostMap): string;
|
|
319
|
+
/**
|
|
320
|
+
* What one row costs, or why it costs nothing.
|
|
321
|
+
*
|
|
322
|
+
* ⛔ A null token count renders as "size unknown", never as `0`. The `charged`
|
|
323
|
+
* branch cannot be reached with a null — `sizeCliffOf` classifies those
|
|
324
|
+
* `unmeasured` first — but the check is written as a value test rather than a
|
|
325
|
+
* `?? 0`, so if that ever changed the output would say what it knows instead of
|
|
326
|
+
* asserting a measurement it does not have.
|
|
327
|
+
*
|
|
328
|
+
* **Exported solely so that rule can be pinned by a test that would FAIL if a
|
|
329
|
+
* `?? 0` were introduced.** The property lives in the RENDERER and nowhere else:
|
|
330
|
+
* an assertion over the json rows only re-states what `account` already
|
|
331
|
+
* guarantees, and on any real tree every row carries a blob, so such an
|
|
332
|
+
* assertion compares `false === false` and passes without ever reaching the code
|
|
333
|
+
* that could print a zero. It is not part of this module's command surface and
|
|
334
|
+
* nothing outside its own test may call it.
|
|
335
|
+
*
|
|
336
|
+
* @param row - The accounted row
|
|
337
|
+
* @returns The cost phrase
|
|
338
|
+
*/
|
|
339
|
+
export declare function chargeText(row: AccountedRow): string;
|
|
340
|
+
//# sourceMappingURL=context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/commands/claude/context.ts"],"names":[],"mappings":"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"}
|