@cbartens/bkit 6.0.0 → 6.1.0
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/.bkit/README.md +154 -151
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +17 -15
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-gateguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +6 -5
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-readguard.cjs +1 -0
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-rules.cjs +65 -0
- package/.bkit/core/.agents/rules.md +108 -107
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +154 -151
- package/.bkit/core/.bkit/authoring.md +714 -84
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +281 -193
- package/.bkit/core/.bkit/comparison.md +43 -41
- package/.bkit/core/.bkit/install.md +154 -84
- package/.bkit/core/.bkit/jsonl.md +193 -130
- package/.bkit/core/.bkit/pipeline.md +114 -114
- package/.bkit/core/.bkit/prompts.md +272 -165
- package/.bkit/core/.bkit/providers.md +457 -271
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +529 -256
- package/.bkit/core/.bkit/trackers.md +80 -52
- package/.bkit/core/.bkit/workflows.md +589 -504
- package/.bkit/core/.claude/hooks/bkit-gateguard.cjs +2 -2
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.claude/hooks/bkit-preflight.sh +45 -14
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +3 -3
- package/.bkit/core/.codex/hooks/bkit-rules.cjs +57 -0
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +7 -7
- package/.bkit/core/.cursor/hooks/bkit-preflight.sh +47 -12
- package/.bkit/core/.opencode/plugin/bkit-rules.js +89 -0
- package/.bkit/core/AGENTS.md +5 -73
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +127 -105
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -70
- package/.bkit/core/docs/templates/bkit-audit-agents.md +94 -72
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +140 -82
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +98 -72
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +121 -96
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +157 -76
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +113 -71
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +75 -72
- package/.bkit/core/docs/templates/bkit-audit-config.md +122 -76
- package/.bkit/core/docs/templates/bkit-audit-cost.md +85 -74
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +75 -68
- package/.bkit/core/docs/templates/bkit-audit-database.md +101 -70
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +164 -83
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -86
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +264 -88
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +118 -93
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +139 -86
- package/.bkit/core/docs/templates/bkit-audit-failures.md +110 -81
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +99 -74
- package/.bkit/core/docs/templates/bkit-audit-gates.md +105 -77
- package/.bkit/core/docs/templates/bkit-audit-issues.md +104 -80
- package/.bkit/core/docs/templates/bkit-audit-llm.md +131 -58
- package/.bkit/core/docs/templates/bkit-audit-logs.md +123 -100
- package/.bkit/core/docs/templates/bkit-audit-models.md +98 -53
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -52
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -54
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +124 -68
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +95 -70
- package/.bkit/core/docs/templates/bkit-audit-repo.md +169 -73
- package/.bkit/core/docs/templates/bkit-audit-security.md +206 -96
- package/.bkit/core/docs/templates/bkit-audit-slop.md +77 -70
- package/.bkit/core/docs/templates/bkit-audit-testing.md +162 -114
- package/.bkit/core/docs/templates/bkit-audit-usability.md +113 -71
- package/.bkit/core/docs/templates/bkit-plan.md +138 -132
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +65 -2
- package/.bkit/core/engine/checks/after/index.ts +12 -2
- package/.bkit/core/engine/checks/after/tools.ts +80 -33
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +1 -1
- package/.bkit/core/engine/checks/before/index.ts +7 -0
- package/.bkit/core/engine/checks/before/repo.ts +40 -0
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +68 -17
- package/.bkit/core/engine/checks/tips/detect.ts +32 -0
- package/.bkit/core/engine/checks/tips/index.ts +47 -6
- package/.bkit/core/engine/cli.ts +238 -84
- package/.bkit/core/engine/commands/analysis.ts +128 -76
- package/.bkit/core/engine/commands/ci/ci.ts +363 -29
- package/.bkit/core/engine/commands/ci/pins.ts +172 -0
- package/.bkit/core/engine/commands/ci/push-gate.ts +223 -0
- package/.bkit/core/engine/commands/install/uninstall.ts +21 -27
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +126 -11
- package/.bkit/core/engine/commands/lib.ts +303 -6
- package/.bkit/core/engine/commands/registry.ts +6 -2
- package/.bkit/core/engine/commands/setup/setup.ts +1 -0
- package/.bkit/core/engine/commands/stats.ts +91 -35
- package/.bkit/core/engine/commands/workflow/branches.ts +1477 -117
- package/.bkit/core/engine/commands/workflow/challenge.ts +114 -39
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +433 -55
- package/.bkit/core/engine/commands/workflow/counters.ts +244 -39
- package/.bkit/core/engine/commands/workflow/decisions.ts +61 -17
- package/.bkit/core/engine/commands/workflow/disk.ts +237 -55
- package/.bkit/core/engine/commands/workflow/fids.ts +19 -1
- package/.bkit/core/engine/commands/workflow/issues.ts +6 -0
- package/.bkit/core/engine/commands/workflow/ledgers.ts +458 -18
- package/.bkit/core/engine/commands/workflow/locks.ts +2 -0
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +124 -15
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +12 -3
- package/.bkit/core/engine/commands/workflow/repo.ts +8 -0
- package/.bkit/core/engine/commands/workflow/roadmap.ts +56 -15
- package/.bkit/core/engine/commands/workflow/run-facts.ts +22 -31
- package/.bkit/core/engine/commands/workflow/runs.ts +652 -34
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -0
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +200 -17
- package/.bkit/core/engine/commands/workflow/step-table.ts +75 -33
- package/.bkit/core/engine/commands/workflow/steps.ts +635 -24
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +192 -46
- package/.bkit/core/engine/commands/workflow/tasks.ts +409 -0
- package/.bkit/core/engine/commands/workflow/test-blocks.ts +254 -0
- package/.bkit/core/engine/commands/workflow/tests-changed.ts +201 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1285 -356
- package/.bkit/core/engine/commands/workflow/workflows.ts +228 -43
- package/.bkit/core/engine/commands/workflow/worktrees.ts +389 -47
- package/.bkit/core/engine/install/cloud-env.ts +251 -121
- package/.bkit/core/engine/install/context-ci-workflow.ts +102 -0
- package/.bkit/core/engine/install/manifest.ts +60 -12
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +3 -3
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +956 -52
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +16 -4
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +3 -2
- package/.bkit/core/engine/install/write.ts +5 -0
- package/.bkit/core/engine/ledgers/compact.ts +124 -0
- package/.bkit/core/engine/ledgers/journal.ts +291 -0
- package/.bkit/core/engine/ledgers/status.ts +160 -9
- package/.bkit/core/engine/ledgers/telemetry.ts +158 -21
- package/.bkit/core/engine/render/hosts.ts +114 -14
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +1 -1
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +92 -17
- package/.bkit/core/engine/shared/timeouts.ts +2 -0
- package/.bkit/core/engine/tools/cli-doc.ts +111 -0
- package/.bkit/core/engine/tools/grammar-density.ts +1 -1
- package/.bkit/core/engine/tools/instructions-sources.ts +15 -17
- package/.bkit/core/engine/tools/instructions.ts +94 -43
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +53 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -4
- package/.bkit/core/hooks/guardrails-tiers.js +3 -3
- package/.bkit/core/hooks/preflight-linear.sh +9 -9
- package/.bkit/core/hooks/preflight-rules.sh +8 -0
- package/.bkit/core/hooks/readguard-engine.js +29 -10
- package/.bkit/core/hooks/session-rules-advisory.js +61 -0
- package/.bkit/core/prompts/bkit-audit-generate.md +187 -116
- package/.bkit/core/prompts/bkit-build-challenge-1.md +56 -37
- package/.bkit/core/prompts/bkit-build-challenge-2.md +65 -45
- package/.bkit/core/prompts/bkit-build-install-skills.md +38 -29
- package/.bkit/core/prompts/bkit-build-plan-convert.md +43 -32
- package/.bkit/core/prompts/bkit-build-plan-current.md +49 -39
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +79 -55
- package/.bkit/core/prompts/bkit-build-plan-tasks.md +149 -0
- package/.bkit/core/prompts/bkit-build-plan-tests.md +120 -0
- package/.bkit/core/prompts/bkit-build-plan-verify.md +87 -50
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +36 -35
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +96 -64
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +54 -45
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +42 -33
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +53 -37
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +35 -30
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +34 -29
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +32 -28
- package/.bkit/core/prompts/bkit-design-generate.md +68 -52
- package/.bkit/core/prompts/bkit-design-organise.md +73 -35
- package/.bkit/core/prompts/bkit-design-review-1.md +58 -54
- package/.bkit/core/prompts/bkit-design-review-2.md +54 -50
- package/.bkit/core/prompts/bkit-design-spike.md +54 -47
- package/.bkit/core/prompts/bkit-design-update.md +42 -31
- package/.bkit/core/prompts/bkit-plan-generate.md +76 -58
- package/.bkit/core/prompts/bkit-plan-review-1.md +63 -49
- package/.bkit/core/prompts/bkit-plan-review-2.md +60 -48
- package/.bkit/core/prompts/bkit-plan-scope-check.md +53 -46
- package/.bkit/core/prompts/bkit-plan-update.md +70 -52
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +82 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +80 -45
- package/.bkit/core/prompts/bkit-ship-update-docs.md +35 -29
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +55 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +76 -49
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +70 -41
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +33 -30
- package/.bkit/core/prompts/bkit-utility-update-failures.md +73 -43
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +77 -50
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +77 -45
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +144 -68
- package/.bkit/core/workflows/bkit-auto.md +53 -30
- package/.bkit/core/workflows/bkit-build.md +635 -304
- package/.bkit/core/workflows/bkit-debug.md +301 -148
- package/.bkit/core/workflows/bkit-design.md +167 -95
- package/.bkit/core/workflows/bkit-plan.md +172 -84
- package/.bkit/core/workflows/bkit-ship.md +299 -152
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +3 -0
- package/.bkit/shared/.codex/bkit-cloud.md +98 -0
- package/.bkit/shared/.codex/hooks.json +20 -0
- package/.bkit/shared/.cursor/bkit-cloud.md +3 -3
- package/.bkit/shared/.opencode/opencode.json +1 -1
- package/.bkit/shared/CLAUDE.md +5 -1
- package/.bkit/shared/GEMINI.md +4 -1
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +239 -166
- package/.bkit/shared/docs/design.md +11 -12
- package/.bkit/shared/docs/noise.md +8 -7
- package/.bkit/shared/docs/observability.md +5 -8
- package/.bkit/shared/docs/security.md +35 -17
- package/.bkit/shared/docs/setup.md +29 -18
- package/.bkit/shared/docs/technology.md +3 -6
- package/.bkit/shared/docs/testing.md +282 -176
- package/.bkit/shared/gitignore +6 -2
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +15 -16
- package/.bkit/templates/.cursor/Dockerfile +12 -8
- package/.bkit/templates/.cursor/environment.json +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +10 -8
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +24 -12
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +3 -3
- package/.bkit/templates/.github/renovate.json5 +34 -6
- package/.bkit/templates/.github/workflows/bkit-ci.yml +53 -50
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +13 -14
- package/.bkit/templates/.github/workflows/bkit-health.yml +97 -0
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +5 -4
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +5 -4
- package/.bkit/templates/.husky/pre-commit +2 -2
- package/.bkit/templates/.husky/pre-push +95 -35
- package/.bkit/templates/.prettierignore +6 -7
- package/.bkit/templates/.vale.ini +27 -27
- package/.bkit/templates/context/bkit-cloudrun.md +23 -15
- package/.bkit/templates/context/bkit-expo.md +70 -52
- package/.bkit/templates/context/bkit-github.md +93 -56
- package/.bkit/templates/context/bkit-inngest.md +21 -15
- package/.bkit/templates/context/bkit-maestro.md +22 -16
- package/.bkit/templates/context/bkit-playwright.md +23 -17
- package/.bkit/templates/context/bkit-resend.md +12 -10
- package/.bkit/templates/context/bkit-sentry.md +30 -20
- package/.bkit/templates/context/bkit-serena.md +8 -7
- package/.bkit/templates/context/bkit-stripe.md +14 -13
- package/.bkit/templates/context/bkit-supabase.md +16 -13
- package/.bkit/templates/context/bkit-tavily.md +14 -11
- package/.bkit/templates/context/bkit-vercel.md +27 -18
- package/.bkit/templates/docs/capabilities.md +15 -14
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.mjs → bkit-check-accepted-divergences.mjs} +6 -3
- package/.bkit/templates/scripts/ci/{check-accepted-divergences.test.mjs → bkit-check-accepted-divergences.test.mjs} +3 -3
- package/.bkit/templates/scripts/ci/{check-capstone.mjs → bkit-check-capstone.mjs} +2 -2
- package/.bkit/templates/scripts/ci/{check-capstone.test.mjs → bkit-check-capstone.test.mjs} +4 -4
- package/.bkit/templates/scripts/ci/{check-dependency-audit.mjs → bkit-check-dependency-audit.mjs} +103 -18
- package/.bkit/templates/scripts/ci/{check-dependency-audit.test.mjs → bkit-check-dependency-audit.test.mjs} +31 -3
- package/.bkit/templates/scripts/ci/bkit-machine-lock.sh +387 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.mjs +75 -0
- package/.bkit/templates/scripts/ci/bkit-test-awake.test.mjs +160 -0
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.mjs → bkit-resolve-push-base.mjs} +3 -3
- package/.bkit/templates/scripts/ci/lanes/{resolve-push-base.test.mjs → bkit-resolve-push-base.test.mjs} +4 -4
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +9 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-drift.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-embed.py +63 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +69 -18
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -3
- package/.bkit/templates/scripts/graphify/bkit-graph-surface.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-graphml.py +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +197 -126
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +64 -41
- package/.bkit/templates/scripts/slop/bkit-slop-type-suppression.mjs +23 -7
- package/.bkit/templates/slop-scan.config.json +9 -2
- package/CHANGELOG.md +119 -0
- package/README.md +250 -76
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +52 -2
- package/dist/checks/after/index.js +12 -4
- package/dist/checks/after/tools.js +73 -33
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +1 -1
- package/dist/checks/before/index.js +6 -2
- package/dist/checks/before/repo.js +35 -1
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +59 -17
- package/dist/checks/tips/detect.js +30 -0
- package/dist/checks/tips/index.js +48 -6
- package/dist/cli.js +222 -84
- package/dist/commands/analysis.js +77 -53
- package/dist/commands/ci/ci.js +302 -25
- package/dist/commands/ci/pins.js +142 -0
- package/dist/commands/ci/push-gate.js +194 -0
- package/dist/commands/install/uninstall.js +23 -27
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +126 -10
- package/dist/commands/lib.js +244 -5
- package/dist/commands/registry.js +6 -2
- package/dist/commands/setup/setup.js +1 -0
- package/dist/commands/stats.js +69 -30
- package/dist/commands/workflow/branches.js +1232 -111
- package/dist/commands/workflow/challenge.js +90 -37
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +371 -51
- package/dist/commands/workflow/counters.js +206 -40
- package/dist/commands/workflow/decisions.js +60 -17
- package/dist/commands/workflow/disk.js +213 -55
- package/dist/commands/workflow/fids.js +18 -1
- package/dist/commands/workflow/issues.js +6 -0
- package/dist/commands/workflow/ledgers.js +372 -21
- package/dist/commands/workflow/locks.js +2 -0
- package/dist/commands/workflow/plan-blocks.js +78 -14
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +12 -3
- package/dist/commands/workflow/repo.js +6 -0
- package/dist/commands/workflow/roadmap.js +50 -17
- package/dist/commands/workflow/run-facts.js +23 -28
- package/dist/commands/workflow/runs.js +530 -33
- package/dist/commands/workflow/runtime.js +3 -0
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +166 -19
- package/dist/commands/workflow/step-table.js +61 -29
- package/dist/commands/workflow/steps.js +542 -26
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +154 -41
- package/dist/commands/workflow/tasks.js +378 -0
- package/dist/commands/workflow/test-blocks.js +231 -0
- package/dist/commands/workflow/tests-changed.js +172 -0
- package/dist/commands/workflow/tests.js +1013 -321
- package/dist/commands/workflow/workflows.js +191 -38
- package/dist/commands/workflow/worktrees.js +310 -42
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +57 -12
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +3 -3
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +851 -53
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +11 -5
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +3 -2
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/status.js +115 -5
- package/dist/ledgers/telemetry.js +121 -17
- package/dist/render/hosts.js +100 -14
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +1 -1
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +59 -10
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +1 -1
- package/dist/tools/instructions-sources.js +15 -16
- package/dist/tools/instructions.js +83 -39
- package/package.json +58 -42
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -172
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -124
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/workflow/workstreams.js +0 -149
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Filler.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Hedging.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/LLMSlop.yml +0 -0
- /package/.bkit/templates/.vale/styles/{House → Bkit}/Verbose.yml +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-advisories.json → bkit-accepted-advisories.json} +0 -0
- /package/.bkit/templates/scripts/ci/{accepted-divergences.json → bkit-accepted-divergences.json} +0 -0
- /package/.bkit/templates/scripts/launchd/{launchd.env.example → bkit-launchd.env.example} +0 -0
- /package/.bkit/templates/scripts/launchd/{ai.bkit.launchd.plist → bkit-launchd.plist} +0 -0
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
// tools/cli-doc.ts — check and sync the generated region of `.bkit/cli.md`.
|
|
2
|
+
//
|
|
3
|
+
// The region lists every `bkit <verb>` (`cli.ts` `CLASSIC_VERB_HELP`) and every
|
|
4
|
+
// `bkit <noun> <verb>` (`commands/registry.ts`), rendered from the same specs `--help`
|
|
5
|
+
// prints. Check mode runs in the test suite (`tools/cli-doc.test.ts`); write mode is
|
|
6
|
+
// `pnpm cli:sync`. Text outside the region is hand-written and kept as is.
|
|
7
|
+
import * as fs from "node:fs";
|
|
8
|
+
import * as path from "node:path";
|
|
9
|
+
import { fileURLToPath } from "node:url";
|
|
10
|
+
import { CLASSIC_VERB_HELP } from "../cli.js";
|
|
11
|
+
import { COMMANDS } from "../commands/registry.js";
|
|
12
|
+
export const DOC_PATH = path.join(".bkit", "core", ".bkit", "cli.md");
|
|
13
|
+
export const REGION_START = "<!-- cli:start -->";
|
|
14
|
+
export const REGION_END = "<!-- cli:end -->";
|
|
15
|
+
export const USE_LABEL = { "by-hand": "by hand", workflow: "workflow" };
|
|
16
|
+
/** A markdown table cell: pipes escaped, newlines flattened, `—` when empty. */
|
|
17
|
+
const cell = (text) => text.replace(/\|/g, "\\|").replace(/\s*\n\s*/g, " ") || "—";
|
|
18
|
+
const flagCell = (flags) => flags.map((f) => (f.required ? `**\`--${f.name}\`**` : `\`--${f.name}\``)).join(" ");
|
|
19
|
+
function table(head, rows) {
|
|
20
|
+
return [
|
|
21
|
+
"<!-- prettier-ignore -->",
|
|
22
|
+
`| ${head.join(" | ")} |`,
|
|
23
|
+
`| ${head.map(() => "---").join(" | ")} |`,
|
|
24
|
+
...rows.map((r) => `| ${r.join(" | ")} |`),
|
|
25
|
+
];
|
|
26
|
+
}
|
|
27
|
+
function nounSection(cmd) {
|
|
28
|
+
const rows = Object.entries(cmd.verbs).map(([verb, spec]) => [
|
|
29
|
+
`\`${verb}\``,
|
|
30
|
+
USE_LABEL[spec.use],
|
|
31
|
+
cell(flagCell(spec.flags)),
|
|
32
|
+
cell(spec.summary),
|
|
33
|
+
]);
|
|
34
|
+
return [
|
|
35
|
+
`### \`${cmd.noun}\``,
|
|
36
|
+
"",
|
|
37
|
+
cell(cmd.summary),
|
|
38
|
+
"",
|
|
39
|
+
...table(["Verb", "Use", "Flags", "What it does"], rows),
|
|
40
|
+
"",
|
|
41
|
+
];
|
|
42
|
+
}
|
|
43
|
+
/** The generated region, markers included. */
|
|
44
|
+
export function renderRegion() {
|
|
45
|
+
const classic = CLASSIC_VERB_HELP.map(({ verb, args, flags, summary }) => [
|
|
46
|
+
`\`${["bkit", verb, ...args.split(" ").filter((w) => /^[a-z]/.test(w))].join(" ")}\``,
|
|
47
|
+
cell(flags.map((f) => `\`${f}\``).join(" ")),
|
|
48
|
+
cell(summary),
|
|
49
|
+
]);
|
|
50
|
+
const nouns = [...COMMANDS].sort((a, b) => a.noun.localeCompare(b.noun));
|
|
51
|
+
return [
|
|
52
|
+
REGION_START,
|
|
53
|
+
"",
|
|
54
|
+
"## Commands you run",
|
|
55
|
+
"",
|
|
56
|
+
...table(["Command", "Flags", "What it does"], classic),
|
|
57
|
+
"",
|
|
58
|
+
"## Workflow commands",
|
|
59
|
+
"",
|
|
60
|
+
"Use: `by hand` = safe and useful outside a workflow run; `workflow` = a workflow step only (writes run state, takes locks, commits, pushes or posts). **Bold** flag = required.",
|
|
61
|
+
"",
|
|
62
|
+
...nouns.flatMap(nounSection),
|
|
63
|
+
REGION_END,
|
|
64
|
+
].join("\n");
|
|
65
|
+
}
|
|
66
|
+
/** Offset of `marker` standing alone on a line, else -1 (prose may quote the marker inline). */
|
|
67
|
+
function markerLine(text, marker) {
|
|
68
|
+
return new RegExp(`^${marker}$`, "m").exec(text)?.index ?? -1;
|
|
69
|
+
}
|
|
70
|
+
/** `text` with its generated region replaced by `renderRegion()`; throws when the markers are missing. */
|
|
71
|
+
export function syncDoc(text) {
|
|
72
|
+
const start = markerLine(text, REGION_START);
|
|
73
|
+
const end = markerLine(text, REGION_END);
|
|
74
|
+
if (start < 0 || end < start) {
|
|
75
|
+
throw new Error(`${DOC_PATH}: missing ${REGION_START} / ${REGION_END}`);
|
|
76
|
+
}
|
|
77
|
+
return text.slice(0, start) + renderRegion() + text.slice(end + REGION_END.length);
|
|
78
|
+
}
|
|
79
|
+
function main(argv) {
|
|
80
|
+
const file = path.join(process.cwd(), DOC_PATH);
|
|
81
|
+
const text = fs.readFileSync(file, "utf-8");
|
|
82
|
+
const synced = syncDoc(text);
|
|
83
|
+
if (synced === text)
|
|
84
|
+
return 0;
|
|
85
|
+
if (argv.includes("--write")) {
|
|
86
|
+
fs.writeFileSync(file, synced, "utf-8");
|
|
87
|
+
console.error(`[bkit-cli] rewrote ${DOC_PATH}`);
|
|
88
|
+
return 0;
|
|
89
|
+
}
|
|
90
|
+
console.error(`[bkit-cli] ${DOC_PATH}: generated region stale (run pnpm cli:sync)`);
|
|
91
|
+
return 1;
|
|
92
|
+
}
|
|
93
|
+
if (process.argv[1] && fs.existsSync(process.argv[1])) {
|
|
94
|
+
if (fs.realpathSync(fileURLToPath(import.meta.url)) === fs.realpathSync(process.argv[1])) {
|
|
95
|
+
process.exitCode = main(process.argv.slice(2));
|
|
96
|
+
}
|
|
97
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// tools/grammar-density.ts — articles (`a`, `an`, `the`) per 1,000 words of agent text.
|
|
2
2
|
//
|
|
3
|
-
// The measure behind `.bkit/core/.bkit/authoring.md` §
|
|
3
|
+
// The measure behind `.bkit/core/.bkit/authoring.md` § All Agent-Read Files, Plain, complete sentences: clipped text
|
|
4
4
|
// drops articles, plain English keeps them. `pnpm grammar:density` prints one row per
|
|
5
5
|
// group for the working tree, `--rev=<rev>` for a past commit, and `--diff=<base>..<head>`
|
|
6
6
|
// for only the lines `<head>` added. Repo-only tooling, like `tools/instructions.ts`.
|
|
@@ -29,6 +29,8 @@ export const CARRIER_SURFACES = [
|
|
|
29
29
|
"hook",
|
|
30
30
|
"permission",
|
|
31
31
|
];
|
|
32
|
+
/** A rule's `### {name}`, which tags, clause `- rule:` / `- tags:` lines and prose cite it by. */
|
|
33
|
+
export const RULE_NAME = /^[a-z0-9][a-z0-9-]*/;
|
|
32
34
|
const CITES = /^((?:`[^`:]+:\d+`(?:, )?)+): ?(.*)$/;
|
|
33
35
|
/** One drift item line (` - ` dropped) with its `kept` reason. */
|
|
34
36
|
export function parseDriftItem(raw, kept) {
|
|
@@ -66,8 +68,8 @@ export function entryKeys(section) {
|
|
|
66
68
|
return out;
|
|
67
69
|
}
|
|
68
70
|
const RULE_SECTIONS = [
|
|
69
|
-
{ heading: "Rules",
|
|
70
|
-
{ heading: "Project Rules",
|
|
71
|
+
{ heading: "Rules", region: "bkit" },
|
|
72
|
+
{ heading: "Project Rules", region: "project" },
|
|
71
73
|
];
|
|
72
74
|
/** Top-level `- ` bullets of the bkit block, or of `## Project Rules` below `bkit:end`, in file order. */
|
|
73
75
|
export function ruleBullets(rulesMd, region) {
|
|
@@ -95,7 +97,6 @@ export function parseRuleEntries(md, heading) {
|
|
|
95
97
|
.slice(1)
|
|
96
98
|
.map((section) => {
|
|
97
99
|
const name = section.slice(0, section.indexOf("\n")).trim();
|
|
98
|
-
const id = /^- rule: ([RP]\d+)/m.exec(section)?.[1] ?? "";
|
|
99
100
|
const block = (kind) => [...section.matchAll(new RegExp(`^\`\`\`${kind}\\n([\\s\\S]*?)^\`\`\`$`, "gm"))].flatMap((m) => m[1].split("\n").filter((l) => l.trim() !== ""));
|
|
100
101
|
const refs = [];
|
|
101
102
|
const refsAt = section.search(/^- refs:$/m);
|
|
@@ -141,7 +142,6 @@ export function parseRuleEntries(md, heading) {
|
|
|
141
142
|
}
|
|
142
143
|
return {
|
|
143
144
|
name,
|
|
144
|
-
id,
|
|
145
145
|
text: block("text").join("\n"),
|
|
146
146
|
retired: block("retired"),
|
|
147
147
|
refs,
|
|
@@ -181,21 +181,24 @@ export function refExists(root, ref, section) {
|
|
|
181
181
|
/** Findings for `## Rules` and `## Project Rules` against their masters. */
|
|
182
182
|
export function checkRules(store, masters, exists) {
|
|
183
183
|
const out = [];
|
|
184
|
+
const seen = new Set();
|
|
184
185
|
for (const s of RULE_SECTIONS) {
|
|
185
186
|
const entries = parseRuleEntries(store, s.heading);
|
|
186
187
|
const bullets = ruleBullets(masters[s.region], s.region);
|
|
187
188
|
const n = Math.max(entries.length, bullets.length);
|
|
188
189
|
for (let i = 0; i < n; i++) {
|
|
189
|
-
const want = `${s.prefix}${String(i + 1).padStart(2, "0")}`;
|
|
190
190
|
const e = entries[i];
|
|
191
191
|
const bullet = bullets[i];
|
|
192
192
|
if (!e) {
|
|
193
|
-
out.push(`${
|
|
193
|
+
out.push(`${s.heading} bullet ${i + 1} of rules.md has no entry — ${bullet}`);
|
|
194
194
|
continue;
|
|
195
195
|
}
|
|
196
|
-
const tag =
|
|
197
|
-
if (e.
|
|
198
|
-
out.push(`${tag}:
|
|
196
|
+
const tag = `\`${e.name}\``;
|
|
197
|
+
if (RULE_NAME.exec(e.name)?.[0] !== e.name)
|
|
198
|
+
out.push(`${tag}: name must be kebab-case`);
|
|
199
|
+
if (seen.has(e.name))
|
|
200
|
+
out.push(`${tag}: name used by another rule; names are rule IDs`);
|
|
201
|
+
seen.add(e.name);
|
|
199
202
|
if (bullet === undefined) {
|
|
200
203
|
out.push(`${tag}: no rules.md bullet at position ${i + 1}`);
|
|
201
204
|
continue;
|
|
@@ -515,14 +518,10 @@ export function checkPermissions(store, settings, opencode) {
|
|
|
515
518
|
return out;
|
|
516
519
|
}
|
|
517
520
|
// ---------------------------------------------------------------------------
|
|
518
|
-
// Special Behaviors ← `.bkit/core/.bkit/prompts.md`; Authoring Rules ← `
|
|
521
|
+
// Special Behaviors ← `.bkit/core/.bkit/prompts.md`; Authoring Rules ← `workflows.md`
|
|
519
522
|
// ---------------------------------------------------------------------------
|
|
520
|
-
/** Catalog files the two sections copy. */
|
|
521
|
-
export const CATALOG_SOURCES = [
|
|
522
|
-
".bkit/core/.bkit/prompts.md",
|
|
523
|
-
".bkit/core/.bkit/workflows.md",
|
|
524
|
-
".bkit/core/.bkit/authoring.md",
|
|
525
|
-
];
|
|
523
|
+
/** Catalog files the two sections copy. `authoring.md` is read in place, never copied. */
|
|
524
|
+
export const CATALOG_SOURCES = [".bkit/core/.bkit/prompts.md", ".bkit/core/.bkit/workflows.md"];
|
|
526
525
|
const FENCE_OPEN = /^(`{3,})/;
|
|
527
526
|
/** Per line: true when the line is a fence marker or inside a fenced block. */
|
|
528
527
|
function fencedLines(lines) {
|
|
@@ -16,7 +16,7 @@ import * as fs from "node:fs";
|
|
|
16
16
|
import * as path from "node:path";
|
|
17
17
|
import { fileURLToPath } from "node:url";
|
|
18
18
|
import { findLineAnchoredMarkers, selectMarkers } from "../install/managed-block.js";
|
|
19
|
-
import { checkSources, parseDriftItem, parseRuleEntries, sectionOf, syncSources, } from "./instructions-sources.js";
|
|
19
|
+
import { checkSources, parseDriftItem, parseRuleEntries, RULE_NAME, sectionOf, syncSources, } from "./instructions-sources.js";
|
|
20
20
|
export { sectionOf };
|
|
21
21
|
/** Near-copy threshold: a sentence this similar to a clause but not equal to it is drift. */
|
|
22
22
|
export const NEAR_COPY = 0.8;
|
|
@@ -24,7 +24,7 @@ export const NEAR_COPY = 0.8;
|
|
|
24
24
|
export const SHARED_MIN = {
|
|
25
25
|
prompt: 2,
|
|
26
26
|
workflow: 2,
|
|
27
|
-
audit:
|
|
27
|
+
audit: 2,
|
|
28
28
|
doc: 2,
|
|
29
29
|
};
|
|
30
30
|
/** Surfaces a clause can set a mode for. */
|
|
@@ -121,7 +121,7 @@ export function parseClauses(md) {
|
|
|
121
121
|
clause.fullyRetired = value === "yes";
|
|
122
122
|
}
|
|
123
123
|
else if (key === "rule") {
|
|
124
|
-
clause.rule =
|
|
124
|
+
clause.rule = RULE_NAME.exec(value)?.[0];
|
|
125
125
|
}
|
|
126
126
|
else if (key === "tags") {
|
|
127
127
|
clause.tags = value.split(",").map((t) => t.trim());
|
|
@@ -281,6 +281,23 @@ export function loadCorpus(root) {
|
|
|
281
281
|
* to check or rewrite.
|
|
282
282
|
*/
|
|
283
283
|
export function proseLineIndexes(file) {
|
|
284
|
+
return memoLines(proseCache, file, computeProseLineIndexes);
|
|
285
|
+
}
|
|
286
|
+
/** Line-index memo keyed by surface and content; every clause asks for the same file's lines. */
|
|
287
|
+
function memoLines(cache, file, compute) {
|
|
288
|
+
const key = `${file.surface}\u0000${file.content}`;
|
|
289
|
+
let hit = cache.get(key);
|
|
290
|
+
if (!hit) {
|
|
291
|
+
if (cache.size > 5_000)
|
|
292
|
+
cache.clear();
|
|
293
|
+
hit = compute(file);
|
|
294
|
+
cache.set(key, hit);
|
|
295
|
+
}
|
|
296
|
+
return hit;
|
|
297
|
+
}
|
|
298
|
+
const proseCache = new Map();
|
|
299
|
+
const clauseLineCache = new Map();
|
|
300
|
+
function computeProseLineIndexes(file) {
|
|
284
301
|
const lines = file.content.split("\n");
|
|
285
302
|
let from = 0;
|
|
286
303
|
let to = lines.length;
|
|
@@ -321,9 +338,11 @@ export function proseLineIndexes(file) {
|
|
|
321
338
|
* `**Rules:**` block, whose lines are rules.md copies the `- carry:` check owns.
|
|
322
339
|
*/
|
|
323
340
|
export function clauseLineIndexes(file) {
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
341
|
+
return memoLines(clauseLineCache, file, (f) => {
|
|
342
|
+
const prose = proseLineIndexes(f);
|
|
343
|
+
const block = f.surface === "prompt" ? ruleBlock(f.content.split("\n")) : undefined;
|
|
344
|
+
return block ? prose.filter((i) => i < block.from || i >= block.to) : prose;
|
|
345
|
+
});
|
|
327
346
|
}
|
|
328
347
|
/** Lines a clause is matched against: a `block: rules` clause also sees the prompt's `**Rules:**` block it sits in. */
|
|
329
348
|
function linesFor(clause, file) {
|
|
@@ -424,28 +443,34 @@ export function compileText(text) {
|
|
|
424
443
|
if (hit)
|
|
425
444
|
return hit;
|
|
426
445
|
const slots = [];
|
|
446
|
+
const literals = [];
|
|
427
447
|
let source = "";
|
|
428
448
|
let last = 0;
|
|
429
449
|
for (const m of text.matchAll(SLOT)) {
|
|
430
|
-
|
|
450
|
+
const segment = text.slice(last, m.index);
|
|
451
|
+
literals.push(segment);
|
|
452
|
+
source += escapeRe(segment);
|
|
431
453
|
source += m[2] ? "(.*?)" : "(.+?)";
|
|
432
454
|
slots.push(m[1]);
|
|
433
455
|
last = m.index + m[0].length;
|
|
434
456
|
}
|
|
435
457
|
const tail = text.slice(last);
|
|
436
458
|
// A closing `.` also matches `;`: the line continues the sentence with local text.
|
|
437
|
-
|
|
459
|
+
const tailLiteral = tail.endsWith(".") ? tail.slice(0, -1) : tail;
|
|
460
|
+
literals.push(tailLiteral);
|
|
461
|
+
source += tail.endsWith(".") ? `${escapeRe(tailLiteral)}[.;]` : escapeRe(tail);
|
|
438
462
|
const first = text.search(SLOT);
|
|
439
463
|
const compiled = {
|
|
440
464
|
re: new RegExp(source, "g"),
|
|
441
465
|
slots,
|
|
442
466
|
prefix: first === -1 ? text : text.slice(0, first),
|
|
467
|
+
literal: literals.reduce((a, b) => (b.length > a.length ? b : a), ""),
|
|
443
468
|
slotted: slots.length > 0,
|
|
444
469
|
};
|
|
445
470
|
compiledCache.set(text, compiled);
|
|
446
471
|
return compiled;
|
|
447
472
|
}
|
|
448
|
-
const countIn = (line, c) => [...line.matchAll(c.re)].length;
|
|
473
|
+
const countIn = (line, c) => line.includes(c.literal) ? [...line.matchAll(c.re)].length : 0;
|
|
449
474
|
/** Drop the blockquote, list marker, step number, or checkbox in front of a line's text. */
|
|
450
475
|
export const stripLinePrefix = (line) => line.replace(/^[ \t]*(?:>[ \t]?)?(?:[ \t]*(?:[-*]|\d+\.)[ \t]+)?(?:\[[ xX]\][ \t]+)?/, "");
|
|
451
476
|
/** Split after `.` or `;` (bold close allowed between), never after `e.g.`; the punctuation stays on the sentence. */
|
|
@@ -557,13 +582,15 @@ function nearCopies(clause, lineIdx, line, allTexts) {
|
|
|
557
582
|
window = window.replace(LABEL, "");
|
|
558
583
|
// A clause can close a sentence that opens with local text (`**If** {cond} → {clause}`): also compare the tail.
|
|
559
584
|
const words = window.split(/\s+/);
|
|
560
|
-
const candidates = [window];
|
|
585
|
+
const candidates = [[window, words]];
|
|
561
586
|
for (const n of [cw - 1, cw, cw + 1]) {
|
|
562
|
-
if (n > 0 && n < words.length)
|
|
563
|
-
|
|
587
|
+
if (n > 0 && n < words.length) {
|
|
588
|
+
const tail = words.slice(-n);
|
|
589
|
+
candidates.push([tail.join(" "), tail]);
|
|
590
|
+
}
|
|
564
591
|
}
|
|
565
|
-
for (const found of candidates) {
|
|
566
|
-
if (allTexts.has(found) || !nearCandidate(
|
|
592
|
+
for (const [found, foundWords] of candidates) {
|
|
593
|
+
if (allTexts.has(found) || !nearCandidate(foundWords, canonicalWords, counts))
|
|
567
594
|
continue;
|
|
568
595
|
const score = similarity(found, canonical);
|
|
569
596
|
if (score >= NEAR_COPY && (!best || score > best.score))
|
|
@@ -744,20 +771,23 @@ export function checkClauses(clauses, files) {
|
|
|
744
771
|
return findings.concat(unlistedShared(clauses, files));
|
|
745
772
|
}
|
|
746
773
|
/** Could two sentences be NEAR_COPY-similar? Cheap word-count and shared-word bounds before `similarity`. */
|
|
747
|
-
function nearCandidate(a, b) {
|
|
774
|
+
function nearCandidate(a, b, bCounts) {
|
|
748
775
|
const longer = Math.max(a.length, b.length);
|
|
749
776
|
const need = Math.ceil(NEAR_COPY * longer);
|
|
750
777
|
if (Math.min(a.length, b.length) < need)
|
|
751
778
|
return false;
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
779
|
+
// `bCounts` is read-only (a caller's memoised counts): track the words of `b` used up so far.
|
|
780
|
+
const counts = bCounts ?? wordCounts(b);
|
|
781
|
+
const used = new Map();
|
|
755
782
|
let shared = 0;
|
|
756
783
|
for (const w of a) {
|
|
757
|
-
const n =
|
|
758
|
-
if (n
|
|
784
|
+
const n = counts.get(w);
|
|
785
|
+
if (n === undefined)
|
|
786
|
+
continue;
|
|
787
|
+
const u = used.get(w) ?? 0;
|
|
788
|
+
if (u < n) {
|
|
759
789
|
shared++;
|
|
760
|
-
|
|
790
|
+
used.set(w, u + 1);
|
|
761
791
|
}
|
|
762
792
|
}
|
|
763
793
|
return shared >= need;
|
|
@@ -804,6 +834,7 @@ export function unlistedShared(clauses, files) {
|
|
|
804
834
|
/** Group each sentence with its near-copies; report every group reaching `min` files. */
|
|
805
835
|
function sharedGroups(seen, min, noun) {
|
|
806
836
|
const words = new Map([...seen.keys()].map((s) => [s, s.split(/\s+/)]));
|
|
837
|
+
const counts = new Map([...words].map(([s, w]) => [s, wordCounts(w)]));
|
|
807
838
|
const reported = new Set();
|
|
808
839
|
const findings = [];
|
|
809
840
|
// Seeds: every sentence, widest first, so a group is reported once under its most-copied wording.
|
|
@@ -814,7 +845,7 @@ function sharedGroups(seen, min, noun) {
|
|
|
814
845
|
continue;
|
|
815
846
|
const near = [...seen.keys()].filter((s) => s !== seed &&
|
|
816
847
|
!reported.has(s) &&
|
|
817
|
-
nearCandidate(words.get(seed), words.get(s)) &&
|
|
848
|
+
nearCandidate(words.get(seed), words.get(s), counts.get(s)) &&
|
|
818
849
|
similarity(seed, s) >= NEAR_COPY);
|
|
819
850
|
const group = new Set([...ids.keys(), ...near.flatMap((s) => [...seen.get(s).keys()])]);
|
|
820
851
|
if (group.size < min)
|
|
@@ -1010,8 +1041,8 @@ export const LOCAL_SECTION = {
|
|
|
1010
1041
|
"plan-template": "Plan template",
|
|
1011
1042
|
entry: "Entry file",
|
|
1012
1043
|
};
|
|
1013
|
-
const LOCAL_TAG = /^(?:[
|
|
1014
|
-
/** `[
|
|
1044
|
+
const LOCAL_TAG = /^(?:[a-z0-9][a-z0-9-]*|fit `[^`]+` [\d.]+)$/;
|
|
1045
|
+
/** `[scope-discipline; fit `x` 0.8; keep: {reason}] {text}`; a bracket holding anything but tags stays text. */
|
|
1015
1046
|
export function parseLocalLine(line) {
|
|
1016
1047
|
const m = /^\[([^\]]+)\] (.+)$/.exec(line);
|
|
1017
1048
|
if (m) {
|
|
@@ -1159,7 +1190,7 @@ function ruleCarriers(ix, r, relations, out) {
|
|
|
1159
1190
|
if (file)
|
|
1160
1191
|
found.push({ relation: c.relation, file });
|
|
1161
1192
|
else
|
|
1162
|
-
out?.push(
|
|
1193
|
+
out?.push(`\`${r.name}\`: ${c.relation} carrier \`${n}\` is no ${surface} file`);
|
|
1163
1194
|
}
|
|
1164
1195
|
}
|
|
1165
1196
|
return found;
|
|
@@ -1232,13 +1263,25 @@ export function checkCoverage(store, corpus) {
|
|
|
1232
1263
|
out.push(`${f.name}: local entry no longer in the file: ${e.text}`);
|
|
1233
1264
|
}
|
|
1234
1265
|
}
|
|
1266
|
+
// Every rule name a tag or clause cites is a rule.
|
|
1267
|
+
const ruleNames = new Set(ix.rules.map((r) => r.name));
|
|
1268
|
+
for (const e of ix.local) {
|
|
1269
|
+
for (const t of e.tags.filter((t) => !ruleNames.has(t))) {
|
|
1270
|
+
out.push(`${e.file ?? `shared (${e.carriers})`}: tag \`${t}\` names no rule: ${e.text}`);
|
|
1271
|
+
}
|
|
1272
|
+
}
|
|
1273
|
+
for (const c of ix.clauses) {
|
|
1274
|
+
for (const t of [c.rule ?? [], c.tags ?? []].flat().filter((t) => !ruleNames.has(t))) {
|
|
1275
|
+
out.push(`clause \`${c.name}\`: \`${t}\` names no rule`);
|
|
1276
|
+
}
|
|
1277
|
+
}
|
|
1235
1278
|
// Nothing extra: rule carriers.
|
|
1236
1279
|
for (const r of ix.rules) {
|
|
1237
1280
|
const sentences = splitSentences(r.text);
|
|
1238
1281
|
for (const { relation, file } of ruleCarriers(ix, r, ["verbatim", "partial", "condensed", "specialised", "applies", "cites"], out)) {
|
|
1239
1282
|
const prose = ix.prose.get(file.id);
|
|
1240
|
-
const tag =
|
|
1241
|
-
const linked = ix.clauses.filter((c) => c.rule === r.
|
|
1283
|
+
const tag = `\`${r.name}\``;
|
|
1284
|
+
const linked = ix.clauses.filter((c) => c.rule === r.name || c.name === r.clause);
|
|
1242
1285
|
const viaClause = linked.some((c) => c.texts.some((t) => prose.some((l) => plain(compileText(t).re).test(l))));
|
|
1243
1286
|
if (relation === "verbatim") {
|
|
1244
1287
|
if (viaClause)
|
|
@@ -1253,11 +1296,11 @@ export function checkCoverage(store, corpus) {
|
|
|
1253
1296
|
}
|
|
1254
1297
|
continue;
|
|
1255
1298
|
}
|
|
1256
|
-
const tagged = (localOf.get(file.id) ?? []).some((e) => e.tags.includes(r.
|
|
1257
|
-
const viaTaggedClause = ix.clauses.some((c) => c.tags?.includes(r.
|
|
1299
|
+
const tagged = (localOf.get(file.id) ?? []).some((e) => e.tags.includes(r.name));
|
|
1300
|
+
const viaTaggedClause = ix.clauses.some((c) => c.tags?.includes(r.name) &&
|
|
1258
1301
|
c.texts.some((t) => prose.some((l) => plain(compileText(t).re).test(l))));
|
|
1259
1302
|
if (!tagged && !viaClause && !viaTaggedClause) {
|
|
1260
|
-
out.push(`${tag}: ${relation} carrier \`${file.name}\` has no local line or clause tagged
|
|
1303
|
+
out.push(`${tag}: ${relation} carrier \`${file.name}\` has no local line or clause tagged \`${r.name}\``);
|
|
1261
1304
|
}
|
|
1262
1305
|
}
|
|
1263
1306
|
// Drift: each cite holds its excerpt.
|
|
@@ -1266,20 +1309,20 @@ export function checkCoverage(store, corpus) {
|
|
|
1266
1309
|
if (entry) {
|
|
1267
1310
|
const heading = entry[1] === "hook" ? "Hook Text" : "Permissions";
|
|
1268
1311
|
if (!new RegExp(`^### ${escapeRe(entry[2])}$`, "m").test(sectionOf(store, heading) ?? "")) {
|
|
1269
|
-
out.push(
|
|
1312
|
+
out.push(`\`${r.name}\`: drift names no \`## ${heading}\` entry \`${entry[2]}\``);
|
|
1270
1313
|
}
|
|
1271
1314
|
continue;
|
|
1272
1315
|
}
|
|
1273
1316
|
if (d.cites.length === 0 || d.excerpt === undefined) {
|
|
1274
|
-
out.push(
|
|
1317
|
+
out.push(`\`${r.name}\`: drift item needs \`{file}:{line}\` cites and a "quoted excerpt": ${d.raw}`);
|
|
1275
1318
|
continue;
|
|
1276
1319
|
}
|
|
1277
1320
|
for (const c of d.cites) {
|
|
1278
1321
|
const candidates = citeFiles(ix, c.name);
|
|
1279
1322
|
if (candidates.length === 0)
|
|
1280
|
-
out.push(
|
|
1323
|
+
out.push(`\`${r.name}\`: drift \`${c.name}:${c.line}\` names no file`);
|
|
1281
1324
|
else if (!candidates.some((f) => lineHolds(f, c.line, d.excerpt))) {
|
|
1282
|
-
out.push(
|
|
1325
|
+
out.push(`\`${r.name}\`: drift \`${c.name}:${c.line}\` does not hold "${d.excerpt}"`);
|
|
1283
1326
|
}
|
|
1284
1327
|
}
|
|
1285
1328
|
}
|
|
@@ -1294,7 +1337,7 @@ export function openFits(store) {
|
|
|
1294
1337
|
}
|
|
1295
1338
|
/** Drift items with no `kept` reason. */
|
|
1296
1339
|
export function openDrift(store) {
|
|
1297
|
-
return [...parseRuleEntries(store, "Rules"), ...parseRuleEntries(store, "Project Rules")].flatMap((r) => r.drift.filter((d) => d.kept === undefined).map((d) =>
|
|
1340
|
+
return [...parseRuleEntries(store, "Rules"), ...parseRuleEntries(store, "Project Rules")].flatMap((r) => r.drift.filter((d) => d.kept === undefined).map((d) => `\`${r.name}\`: ${d.raw}`));
|
|
1298
1341
|
}
|
|
1299
1342
|
/** Label line opening a prompt's block of rule copies. */
|
|
1300
1343
|
export const RULES_BLOCK = BLOCK_LABEL.rules;
|
|
@@ -1327,7 +1370,7 @@ export function checkRuleCopies(store, corpus) {
|
|
|
1327
1370
|
rules.find((r) => nearCandidate(text.split(/\s+/), r.text.split(/\s+/)) &&
|
|
1328
1371
|
similarity(text, r.text) >= NEAR_COPY);
|
|
1329
1372
|
if (rule) {
|
|
1330
|
-
out.push(
|
|
1373
|
+
out.push(`\`${rule.name}\`: \`${f.id}:${i + 1}\` copies the rule in its ${BLOCK_LABEL[b]} block; it belongs in the ${RULES_BLOCK} block`);
|
|
1331
1374
|
}
|
|
1332
1375
|
}
|
|
1333
1376
|
}
|
|
@@ -1354,14 +1397,14 @@ export function checkCarry(store, corpus) {
|
|
|
1354
1397
|
for (const n of named) {
|
|
1355
1398
|
carried.add(n);
|
|
1356
1399
|
if (!standing.get(n)?.some((l) => l.text === r.text)) {
|
|
1357
|
-
missing.push(
|
|
1400
|
+
missing.push(`\`${r.name}\`: carry \`${n}\` lacks the whole rule bullet`);
|
|
1358
1401
|
}
|
|
1359
1402
|
}
|
|
1360
1403
|
if (!bkit.includes(r))
|
|
1361
1404
|
continue;
|
|
1362
1405
|
for (const f of prompts) {
|
|
1363
1406
|
if (!named.has(f.name) && standing.get(f.name).some((l) => l.text.includes(r.text))) {
|
|
1364
|
-
undeclared.push(
|
|
1407
|
+
undeclared.push(`\`${r.name}\`: \`${f.name}\` holds the rule but no carry line names it`);
|
|
1365
1408
|
}
|
|
1366
1409
|
}
|
|
1367
1410
|
}
|
|
@@ -1422,12 +1465,13 @@ export function similarEntries(store) {
|
|
|
1422
1465
|
}
|
|
1423
1466
|
const out = [];
|
|
1424
1467
|
const words = entries.map((e) => e.text.split(/\s+/));
|
|
1468
|
+
const counts = words.map(wordCounts);
|
|
1425
1469
|
for (let i = 0; i < entries.length; i++) {
|
|
1426
1470
|
for (let j = i + 1; j < entries.length; j++) {
|
|
1427
1471
|
const [a, b] = [entries[i], entries[j]];
|
|
1428
1472
|
if (a.name === b.name || a.distinct.has(b.name) || b.distinct.has(a.name))
|
|
1429
1473
|
continue;
|
|
1430
|
-
if (!nearCandidate(words[i], words[j]))
|
|
1474
|
+
if (!nearCandidate(words[i], words[j], counts[j]))
|
|
1431
1475
|
continue;
|
|
1432
1476
|
const score = similarity(a.text, b.text);
|
|
1433
1477
|
if (score >= NEAR_COPY) {
|