@cbartens/bkit 5.5.0 → 6.0.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 +30 -20
- package/.bkit/core/.agents/docs.md +1 -0
- package/.bkit/core/.agents/rules.md +51 -26
- package/.bkit/core/.bkit/README.md +29 -19
- package/.bkit/core/.bkit/authoring.md +117 -0
- package/.bkit/core/.bkit/cloud.md +11 -11
- package/.bkit/core/.bkit/comparison.md +5 -5
- package/.bkit/core/.bkit/install.md +20 -20
- package/.bkit/core/.bkit/jsonl.md +202 -122
- package/.bkit/core/.bkit/lite.md +1 -1
- package/.bkit/core/.bkit/pipeline.md +49 -52
- package/.bkit/core/.bkit/prompts.md +106 -167
- package/.bkit/core/.bkit/providers.md +29 -32
- package/.bkit/core/.bkit/templates.md +44 -18
- package/.bkit/core/.bkit/trackers.md +60 -28
- package/.bkit/core/.bkit/workflows.md +399 -359
- package/.bkit/core/AGENTS.md +16 -22
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-agents.md +19 -43
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +11 -35
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-config.md +18 -42
- package/.bkit/core/docs/templates/bkit-audit-cost.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-database.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +15 -38
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +11 -35
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +18 -42
- package/.bkit/core/docs/templates/bkit-audit-failures.md +13 -37
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-gates.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-issues.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-llm.md +16 -40
- package/.bkit/core/docs/templates/bkit-audit-logs.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-models.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +15 -39
- package/.bkit/core/docs/templates/bkit-audit-repo.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-security.md +13 -37
- package/.bkit/core/docs/templates/bkit-audit-slop.md +14 -38
- package/.bkit/core/docs/templates/bkit-audit-testing.md +12 -36
- package/.bkit/core/docs/templates/bkit-audit-usability.md +16 -40
- package/.bkit/core/docs/templates/bkit-plan.md +97 -226
- package/.bkit/core/engine/checks/after/ci-yml.ts +39 -30
- package/.bkit/core/engine/checks/after/github.ts +101 -72
- package/.bkit/core/engine/checks/after/index.ts +10 -12
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +47 -92
- package/.bkit/core/engine/checks/before/env.ts +2 -2
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +18 -1
- package/.bkit/core/engine/checks/before/repo.ts +168 -2
- package/.bkit/core/engine/checks/tips/catalogue.ts +16 -5
- package/.bkit/core/engine/checks/tips/detect.ts +34 -0
- package/.bkit/core/engine/checks/tips/index.ts +10 -7
- package/.bkit/core/engine/cli.ts +20 -53
- package/.bkit/core/engine/commands/analysis.ts +171 -140
- package/.bkit/core/engine/commands/ci/ci.ts +6 -6
- package/.bkit/core/engine/commands/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +65 -28
- package/.bkit/core/engine/commands/land.ts +18 -12
- package/.bkit/core/engine/commands/lib.ts +79 -17
- package/.bkit/core/engine/commands/registry.ts +4 -0
- package/.bkit/core/engine/commands/setup/setup.ts +7 -7
- package/.bkit/core/engine/commands/stats.ts +204 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +741 -62
- package/.bkit/core/engine/commands/workflow/challenge.ts +673 -0
- package/.bkit/core/engine/commands/workflow/context.ts +853 -29
- package/.bkit/core/engine/commands/workflow/counters.ts +267 -84
- package/.bkit/core/engine/commands/workflow/decisions.ts +541 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +2 -2
- package/.bkit/core/engine/commands/workflow/fids.ts +793 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +427 -105
- package/.bkit/core/engine/commands/workflow/ledgers.ts +884 -27
- package/.bkit/core/engine/commands/workflow/locks.ts +26 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +582 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +166 -30
- package/.bkit/core/engine/commands/workflow/repo.ts +59 -7
- package/.bkit/core/engine/commands/workflow/roadmap.ts +16 -7
- package/.bkit/core/engine/commands/workflow/run-facts.ts +501 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +179 -49
- package/.bkit/core/engine/commands/workflow/runtime.ts +22 -1
- package/.bkit/core/engine/commands/workflow/status.ts +142 -29
- package/.bkit/core/engine/commands/workflow/step-table.ts +339 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +213 -88
- package/.bkit/core/engine/commands/workflow/summary.ts +398 -0
- package/.bkit/core/engine/commands/workflow/tests.ts +1013 -148
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +984 -207
- package/.bkit/core/engine/commands/workflow/workstreams.ts +11 -5
- package/.bkit/core/engine/commands/workflow/worktrees.ts +276 -22
- package/.bkit/core/engine/install/manifest.ts +11 -9
- package/.bkit/core/engine/install/modules/cloud.ts +21 -13
- package/.bkit/core/engine/install/modules/core.ts +325 -7
- package/.bkit/core/engine/install/modules/opencode.ts +2 -2
- package/.bkit/core/engine/install/version-file.ts +6 -2
- package/.bkit/core/engine/ledgers/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +92 -15
- package/.bkit/core/engine/ledgers/telemetry.ts +1261 -254
- package/.bkit/core/engine/render/hosts.ts +4 -0
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/egress.ts +7 -0
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/settings.ts +202 -33
- package/.bkit/core/engine/shared/text.ts +361 -0
- package/.bkit/core/engine/tools/grammar-density.ts +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +834 -0
- package/.bkit/core/engine/tools/instructions.ts +1751 -0
- package/.bkit/core/hooks/gateguard-engine.js +24 -23
- package/.bkit/core/hooks/guardrails-shell.js +2 -3
- package/.bkit/core/hooks/guardrails-tiers.js +7 -1
- package/.bkit/core/hooks/readguard-engine.js +2 -2
- package/.bkit/core/prompts/bkit-audit-generate.md +62 -25
- package/.bkit/core/prompts/bkit-build-challenge-1.md +40 -17
- package/.bkit/core/prompts/bkit-build-challenge-2.md +44 -17
- package/.bkit/core/prompts/bkit-build-install-skills.md +26 -13
- package/.bkit/core/prompts/bkit-build-plan-convert.md +74 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +26 -13
- package/.bkit/core/prompts/bkit-build-plan-execute.md +74 -26
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +64 -23
- package/.bkit/core/prompts/bkit-build-plan-verify.md +57 -33
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +30 -14
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +34 -14
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +34 -17
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +26 -13
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +31 -16
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +21 -11
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +20 -11
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +20 -11
- package/.bkit/core/prompts/bkit-design-generate.md +33 -13
- package/.bkit/core/prompts/bkit-design-organise.md +25 -12
- package/.bkit/core/prompts/bkit-design-review-1.md +31 -15
- package/.bkit/core/prompts/bkit-design-review-2.md +28 -13
- package/.bkit/core/prompts/bkit-design-spike.md +30 -13
- package/.bkit/core/prompts/bkit-design-update.md +33 -19
- package/.bkit/core/prompts/bkit-plan-generate.md +75 -19
- package/.bkit/core/prompts/bkit-plan-review-1.md +50 -27
- package/.bkit/core/prompts/bkit-plan-review-2.md +59 -28
- package/.bkit/core/prompts/bkit-plan-scope-check.md +109 -0
- package/.bkit/core/prompts/bkit-plan-update.md +61 -24
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +27 -15
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +31 -16
- package/.bkit/core/prompts/bkit-ship-update-docs.md +30 -15
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +24 -14
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +32 -14
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +29 -14
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +28 -13
- package/.bkit/core/prompts/bkit-utility-update-failures.md +31 -14
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +33 -14
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +38 -17
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +43 -20
- package/.bkit/core/workflows/bkit-auto.md +54 -46
- package/.bkit/core/workflows/bkit-build.md +577 -458
- package/.bkit/core/workflows/bkit-debug.md +348 -333
- package/.bkit/core/workflows/bkit-design.md +201 -237
- package/.bkit/core/workflows/bkit-plan.md +210 -321
- package/.bkit/core/workflows/bkit-ship.md +328 -278
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/settings.json +11 -0
- package/.bkit/shared/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +11 -0
- package/.bkit/shared/CLAUDE.md +2 -2
- package/.bkit/shared/GEMINI.md +2 -2
- package/.bkit/shared/docs/architecture.md +1 -1
- package/.bkit/shared/docs/data-schema.md +1 -1
- package/.bkit/shared/docs/deployments.md +16 -28
- package/.bkit/shared/docs/design.md +1 -1
- package/.bkit/shared/docs/noise.md +1 -1
- package/.bkit/shared/docs/observability.md +2 -2
- package/.bkit/shared/docs/security.md +1 -1
- package/.bkit/shared/docs/setup.md +1 -1
- package/.bkit/shared/docs/technology.md +1 -1
- package/.bkit/shared/docs/testing.md +27 -10
- package/.bkit/templates/.claude/hooks/bkit-cloud-bootstrap.sh +1 -1
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +26 -5
- package/.bkit/templates/.github/workflows/bkit-ci.yml +22 -84
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +21 -19
- package/.bkit/templates/.husky/pre-push +52 -13
- package/.bkit/templates/.prettierignore +7 -0
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +194 -0
- package/.bkit/templates/scripts/ci/check-capstone.mjs +2 -4
- package/.bkit/templates/scripts/ci/check-capstone.test.mjs +4 -23
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.mjs +104 -23
- package/.bkit/templates/scripts/ci/lanes/resolve-push-base.test.mjs +103 -6
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +1 -1
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +3 -1
- package/.bkit/templates/scripts/prettier/bkit-insert-ignore.mjs +49 -29
- package/CHANGELOG.md +142 -0
- package/README.md +58 -34
- package/dist/checks/after/ci-yml.js +39 -29
- package/dist/checks/after/github.js +99 -72
- package/dist/checks/after/index.js +11 -13
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +40 -83
- package/dist/checks/before/env.js +2 -2
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +15 -2
- package/dist/checks/before/repo.js +163 -2
- package/dist/checks/tips/catalogue.js +14 -5
- package/dist/checks/tips/detect.js +32 -0
- package/dist/checks/tips/index.js +7 -5
- package/dist/cli.js +19 -47
- package/dist/commands/analysis.js +109 -100
- package/dist/commands/ci/ci.js +6 -6
- package/dist/commands/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +59 -28
- package/dist/commands/land.js +16 -12
- package/dist/commands/lib.js +51 -16
- package/dist/commands/registry.js +4 -0
- package/dist/commands/setup/setup.js +7 -7
- package/dist/commands/stats.js +136 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +656 -56
- package/dist/commands/workflow/challenge.js +556 -0
- package/dist/commands/workflow/context.js +709 -30
- package/dist/commands/workflow/counters.js +208 -75
- package/dist/commands/workflow/decisions.js +441 -0
- package/dist/commands/workflow/disk.js +2 -2
- package/dist/commands/workflow/fids.js +689 -33
- package/dist/commands/workflow/issues.js +362 -99
- package/dist/commands/workflow/ledgers.js +762 -27
- package/dist/commands/workflow/locks.js +24 -2
- package/dist/commands/workflow/plan-blocks.js +437 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/prs.js +142 -32
- package/dist/commands/workflow/repo.js +52 -7
- package/dist/commands/workflow/roadmap.js +9 -7
- package/dist/commands/workflow/run-facts.js +426 -0
- package/dist/commands/workflow/runs.js +144 -43
- package/dist/commands/workflow/runtime.js +12 -1
- package/dist/commands/workflow/status.js +130 -29
- package/dist/commands/workflow/step-table.js +276 -0
- package/dist/commands/workflow/steps.js +171 -80
- package/dist/commands/workflow/summary.js +275 -0
- package/dist/commands/workflow/tests.js +834 -136
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +834 -195
- package/dist/commands/workflow/workstreams.js +11 -5
- package/dist/commands/workflow/worktrees.js +221 -22
- package/dist/install/manifest.js +11 -9
- package/dist/install/modules/cloud.js +22 -13
- package/dist/install/modules/core.js +326 -7
- package/dist/install/modules/opencode.js +2 -2
- package/dist/install/version-file.js +6 -2
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +61 -8
- package/dist/ledgers/telemetry.js +905 -124
- package/dist/render/hosts.js +4 -0
- package/dist/render/models.js +12 -0
- package/dist/shared/branches.js +3 -1
- package/dist/shared/egress.js +7 -0
- package/dist/shared/json.js +20 -7
- package/dist/shared/settings.js +147 -26
- package/dist/shared/text.js +333 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +721 -0
- package/dist/tools/instructions.js +1579 -0
- package/package.json +114 -23
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/lanes/check-tree-cache.mjs +0 -138
- package/.bkit/templates/scripts/ci/lanes/check-tree-cache.test.mjs +0 -181
- package/dist/commands/harvest.js +0 -353
- package/dist/tools/wording.js +0 -680
|
@@ -7,6 +7,7 @@ import { execFileSync } from "node:child_process";
|
|
|
7
7
|
import { MCP_TOOLSETS_HEADER, parseToolsets } from "../../install/write.js";
|
|
8
8
|
import { parseJson, readJsonFile } from "../../shared/json.js";
|
|
9
9
|
import { readBkitConfig } from "../../shared/settings.js";
|
|
10
|
+
import { isCloudOrCi } from "../before/env.js";
|
|
10
11
|
/**
|
|
11
12
|
* Detect whether branch protection is configured on `main`.
|
|
12
13
|
* Returns "present" | "missing" | "unknown".
|
|
@@ -64,7 +65,7 @@ export function detectActionsWritePermissions() {
|
|
|
64
65
|
*
|
|
65
66
|
* - `github` → GitHub tracker: the GitHub MCP server authenticates with `BKIT_GH_TOKEN`; `gh` uses `gh auth login`.
|
|
66
67
|
* - `linear` → existing Linear setup message (BKIT_LINEAR_API_KEY + LINEAR_ISSUE_ID).
|
|
67
|
-
* - `jira` → admin switch,
|
|
68
|
+
* - `jira` → admin switch, BKIT_JIRA_API_KEY and `bkit.tracker.jira` in package.json.
|
|
68
69
|
* - `none` → prompt to run `bkit install --tracker=github`, `--tracker=linear` or `--tracker=jira`.
|
|
69
70
|
*
|
|
70
71
|
* Only fires when bkit workflows are installed (.claude/ or .cursor/ present).
|
|
@@ -96,10 +97,10 @@ export function buildTrackerSetupAdvisory(cwd) {
|
|
|
96
97
|
id: "tracker-setup-jira",
|
|
97
98
|
severity: "advisory",
|
|
98
99
|
detect: "bkit tracker is configured as `jira`. Jira Cloud is the active tracker.",
|
|
99
|
-
action: 'Jira tracker: (1) an org admin turns on API-token sign-in for the Rovo MCP server (admin.atlassian.com → Rovo → Rovo MCP server → Authentication → "Allow API token authentication"); (2) create an API token with scopes for the app "Atlassian MCP V2" at https://id.atlassian.com/manage-profile/security/api-tokens and set it as `
|
|
100
|
+
action: 'Jira tracker: (1) an org admin turns on API-token sign-in for the Rovo MCP server (admin.atlassian.com → Rovo → Rovo MCP server → Authentication → "Allow API token authentication"); (2) create an API token with scopes for the app "Atlassian MCP V2" at https://id.atlassian.com/manage-profile/security/api-tokens and set it as `BKIT_JIRA_API_KEY` in `.bkit/.env`, then `direnv allow`; (3) set `bkit.tracker.jira.site` (e.g. `https://acme.atlassian.net`) and `bkit.tracker.jira.project` (the project key) in package.json. Full steps: `.bkit/trackers.md` § jira.',
|
|
100
101
|
};
|
|
101
102
|
}
|
|
102
|
-
// tracker === "none". Distinguish opt-out (explicit `bkit.
|
|
103
|
+
// tracker === "none". Distinguish opt-out (explicit `bkit.tracker.default: "none"`)
|
|
103
104
|
// from undecided (field absent). An explicit `none` silences the nudge, as with the
|
|
104
105
|
// dep-updater advisory.
|
|
105
106
|
if (issueTrackerExplicit)
|
|
@@ -107,23 +108,24 @@ export function buildTrackerSetupAdvisory(cwd) {
|
|
|
107
108
|
return {
|
|
108
109
|
id: "tracker-setup-none",
|
|
109
110
|
severity: "advisory",
|
|
110
|
-
detect: "bkit tracker is not configured (`bkit.
|
|
111
|
-
action: 'Optional post-install decision. Run `bkit install --tracker=github` (recommended), `--tracker=linear` or `--tracker=jira` to enable tracker integration. GitHub tracker requires `BKIT_GH_TOKEN` in `.bkit/.env` (fine-grained PAT for one owner, classic PAT across owners). Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. Jira tracker requires `
|
|
111
|
+
detect: "bkit tracker is not configured (`bkit.tracker.default` absent). Workflows run but every tracker call is a no-op.",
|
|
112
|
+
action: 'Optional post-install decision. Run `bkit install --tracker=github` (recommended), `--tracker=linear` or `--tracker=jira` to enable tracker integration. GitHub tracker requires `BKIT_GH_TOKEN` in `.bkit/.env` (fine-grained PAT for one owner, classic PAT across owners). Linear tracker requires `BKIT_LINEAR_API_KEY` in `.bkit/.env`. Jira tracker requires `BKIT_JIRA_API_KEY` in `.bkit/.env` and `bkit.tracker.jira` in package.json. To opt out and silence this advisory, set `bkit.tracker.default` to `"none"` in package.json.',
|
|
112
113
|
};
|
|
113
114
|
}
|
|
114
115
|
/**
|
|
115
|
-
* Classify the `bkit.
|
|
116
|
-
* - "configured" →
|
|
116
|
+
* Classify the `bkit.tracker.github.project` board-sync config in package.json:
|
|
117
|
+
* - "configured" → a Projects v2 board URL
|
|
117
118
|
* - "opted-out" → set to `false` ("no board sync" — stay quiet)
|
|
119
|
+
* - "invalid" → a string that is not a board URL
|
|
118
120
|
* - "absent" → missing, malformed, or unreadable
|
|
119
121
|
*/
|
|
120
122
|
function readGithubProjectConfig(cwd) {
|
|
121
|
-
const
|
|
122
|
-
if (
|
|
123
|
+
const { project, projectUrl } = readBkitConfig(cwd).github;
|
|
124
|
+
if (project === false)
|
|
123
125
|
return "opted-out";
|
|
124
|
-
if (
|
|
126
|
+
if (project !== null)
|
|
125
127
|
return "configured";
|
|
126
|
-
return "absent";
|
|
128
|
+
return projectUrl === null ? "absent" : "invalid";
|
|
127
129
|
}
|
|
128
130
|
/**
|
|
129
131
|
* Inspect the root `.mcp.json` github server's `X-MCP-Toolsets` header for the
|
|
@@ -153,13 +155,13 @@ export function detectProjectsToolset(cwd) {
|
|
|
153
155
|
/**
|
|
154
156
|
* GitHub Projects v2 board-sync prerequisite advisory. Board status sync needs
|
|
155
157
|
* THREE things, none of which install seeds or verifies end-to-end:
|
|
156
|
-
* `bkit.
|
|
157
|
-
* Projects R/W
|
|
158
|
-
* sync silently no-ops —
|
|
159
|
-
*
|
|
158
|
+
* `bkit.tracker.github.project` (the board URL), the `projects` MCP toolset, and a PAT
|
|
159
|
+
* with Projects R/W. Absent any of the first two (the detectable ones), board
|
|
160
|
+
* sync silently no-ops — the URL alone is useless if the toolset lacks
|
|
161
|
+
* `projects`, and vice versa. Emits one advisory naming what's missing.
|
|
160
162
|
*
|
|
161
163
|
* Gates: workflows installed (.claude/ or .cursor/) AND tracker === "github".
|
|
162
|
-
* Stays quiet on explicit opt-out (`bkit.
|
|
164
|
+
* Stays quiet on explicit opt-out (`bkit.tracker.github.project: false`) or when both
|
|
163
165
|
* detectable prerequisites are satisfied (PAT scope can't be checked locally).
|
|
164
166
|
*/
|
|
165
167
|
export function buildGithubProjectAdvisory(cwd) {
|
|
@@ -178,8 +180,10 @@ export function buildGithubProjectAdvisory(cwd) {
|
|
|
178
180
|
if (configOk && toolsetOk)
|
|
179
181
|
return null;
|
|
180
182
|
const missing = [];
|
|
181
|
-
if (
|
|
182
|
-
missing.push("`bkit.
|
|
183
|
+
if (configState === "absent")
|
|
184
|
+
missing.push("`bkit.tracker.github.project` is empty or absent in package.json");
|
|
185
|
+
if (configState === "invalid")
|
|
186
|
+
missing.push("`bkit.tracker.github.project` is not a GitHub Projects board URL");
|
|
183
187
|
if (toolset === "missing")
|
|
184
188
|
missing.push("the `projects` toolset is missing from `.mcp.json` `X-MCP-Toolsets`");
|
|
185
189
|
const missingPhrase = missing.length > 0 ? `: ${missing.join("; ")}` : "";
|
|
@@ -189,68 +193,91 @@ export function buildGithubProjectAdvisory(cwd) {
|
|
|
189
193
|
detect: `GitHub tracker is active but Projects v2 board status sync is not fully configured${missingPhrase}. ` +
|
|
190
194
|
"Board sync silently no-ops — workflows never reflect phase on the project board.",
|
|
191
195
|
action: "Board status sync is optional (workflows never gate on it) but invisible when half-configured. All three prerequisites are required:\n\n" +
|
|
192
|
-
"1. Add
|
|
196
|
+
"1. Add the board's URL to package.json, as the browser shows it on the board (`/orgs/<org>/…` for an organization board, `/users/<login>/…` for a personal one; a trailing `/views/<n>` is fine):\n\n" +
|
|
193
197
|
' "bkit": {\n' +
|
|
194
|
-
' "
|
|
195
|
-
' "
|
|
196
|
-
' "statusFieldId": <numeric-field-id>, "progressOptionId": "<option-id>",\n' +
|
|
197
|
-
' "reviewOptionId": "<option-id>", "doneOptionId": "<option-id>"\n' +
|
|
198
|
+
' "tracker": {\n' +
|
|
199
|
+
' "github": { "project": "https://github.com/orgs/<org>/projects/<number>" }\n' +
|
|
198
200
|
" }\n" +
|
|
199
201
|
" }\n\n" +
|
|
200
|
-
"
|
|
201
|
-
|
|
202
|
-
"the option ids (quoted strings). `gh project field-list`'s `id` is the GraphQL node id (`PVTSSF_…`) " +
|
|
203
|
-
"and must NOT be used for `statusFieldId` — `projects_write` rejects it with " +
|
|
204
|
-
"`updated_field.id: value must be a number`.\n\n" +
|
|
202
|
+
" Workflows set the board's Status field by option name: `In progress` when a phase starts, `In review` at hand-off. " +
|
|
203
|
+
'A board whose Status options are named differently sets `"progress"` and `"review"` beside `"project"` to its own names.\n\n' +
|
|
205
204
|
"2. Ensure the root `.mcp.json` github server enables the `projects` toolset:\n\n" +
|
|
206
205
|
' "X-MCP-Toolsets": "context,issues,pull_requests,repos,users,projects,actions"\n\n' +
|
|
207
|
-
"3. The `BKIT_GH_TOKEN` PAT needs
|
|
208
|
-
"
|
|
206
|
+
"3. The `BKIT_GH_TOKEN` PAT needs Projects read & write (repo scope is not enough): a fine-grained PAT gets it as an " +
|
|
207
|
+
"organization permission, so it reaches organization boards only; a classic PAT with the `project` scope reaches " +
|
|
208
|
+
"organization and personal boards.\n\n" +
|
|
209
|
+
"To opt out and silence this advisory, set `bkit.tracker.github.project` to `false` in package.json.",
|
|
209
210
|
};
|
|
210
211
|
}
|
|
212
|
+
/** `gh` run with the token the engine uses for tracker calls: BKIT_GH_TOKEN as GH_TOKEN when set. */
|
|
213
|
+
function ghAsEngine(args) {
|
|
214
|
+
const token = process.env.BKIT_GH_TOKEN;
|
|
215
|
+
return execFileSync("gh", args, {
|
|
216
|
+
encoding: "utf-8",
|
|
217
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
218
|
+
timeout: 5000,
|
|
219
|
+
env: token ? { ...process.env, GH_TOKEN: token } : process.env,
|
|
220
|
+
});
|
|
221
|
+
}
|
|
211
222
|
/**
|
|
212
|
-
*
|
|
213
|
-
*
|
|
214
|
-
* `
|
|
215
|
-
*
|
|
216
|
-
* rejected with `updated_field.id: value must be a number`, and best-effort sync then
|
|
217
|
-
* no-ops silently. Checked at install/check time, no network needed.
|
|
218
|
-
*
|
|
219
|
-
* Gates: workflows installed AND tracker === "github" AND `bkit.githubProject` is
|
|
220
|
-
* an object carrying `owner` + `number` (an otherwise-usable board) AND
|
|
221
|
-
* `statusFieldId` is present but not a JSON number. An absent `statusFieldId` is
|
|
222
|
-
* the setup advisory's job; opt-out (`false`) and absent config never reach here.
|
|
223
|
+
* Whether the engine's token can move cards on the configured board: "present",
|
|
224
|
+
* "missing", or "unknown" (gh unavailable or unauthenticated). A classic token lists its
|
|
225
|
+
* scopes in `X-OAuth-Scopes` and needs `project`; a fine-grained token lists none, so the
|
|
226
|
+
* board itself is queried.
|
|
223
227
|
*/
|
|
224
|
-
export function
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
228
|
+
export function detectProjectTokenScope(owner, number) {
|
|
229
|
+
let head;
|
|
230
|
+
try {
|
|
231
|
+
head = ghAsEngine(["api", "-i", "user"]).split(/\r?\n\r?\n/)[0] ?? "";
|
|
232
|
+
}
|
|
233
|
+
catch {
|
|
234
|
+
return "unknown";
|
|
235
|
+
}
|
|
236
|
+
const scopes = /^x-oauth-scopes:(.*)$/im.exec(head);
|
|
237
|
+
if (scopes) {
|
|
238
|
+
const list = scopes[1].split(",").map((x) => x.trim());
|
|
239
|
+
return list.includes("project") ? "present" : "missing";
|
|
240
|
+
}
|
|
241
|
+
const field = "projectV2(number: $n) { id }";
|
|
242
|
+
try {
|
|
243
|
+
const out = ghAsEngine([
|
|
244
|
+
"api",
|
|
245
|
+
"graphql",
|
|
246
|
+
"-f",
|
|
247
|
+
`query=query($login: String!, $n: Int!) { repositoryOwner(login: $login) { ... on User { ${field} } ... on Organization { ${field} } } }`,
|
|
248
|
+
"-f",
|
|
249
|
+
`login=${owner}`,
|
|
250
|
+
"-F",
|
|
251
|
+
`n=${number}`,
|
|
252
|
+
]);
|
|
253
|
+
const parsed = parseJson(out);
|
|
254
|
+
const data = (parsed.ok ? parsed.value : null);
|
|
255
|
+
return data?.data?.repositoryOwner?.projectV2?.id ? "present" : "missing";
|
|
256
|
+
}
|
|
257
|
+
catch {
|
|
258
|
+
return "missing";
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
/**
|
|
262
|
+
* The engine moves board cards with `BKIT_GH_TOKEN`; a token that cannot reach the board
|
|
263
|
+
* makes every move fall back to the MCP. Checked live, so it runs only when a board is
|
|
264
|
+
* configured, the tracker is GitHub, and not on cloud / CI (no interactive owner to fix it).
|
|
265
|
+
*/
|
|
266
|
+
export function buildGithubProjectTokenScopeAdvisory(cwd) {
|
|
267
|
+
const config = readBkitConfig(cwd);
|
|
268
|
+
const board = config.github.project;
|
|
269
|
+
if (config.issueTracker !== "github" || !board || isCloudOrCi())
|
|
231
270
|
return null;
|
|
232
|
-
|
|
233
|
-
// has a statusFieldId set — absent statusFieldId is handled by the setup advisory.
|
|
234
|
-
if (!gp || gp.owner === undefined || gp.number === undefined)
|
|
271
|
+
if (detectProjectTokenScope(board.owner, board.number) !== "missing")
|
|
235
272
|
return null;
|
|
236
|
-
const sfid = gp.statusFieldId;
|
|
237
|
-
if (sfid === undefined || typeof sfid === "number")
|
|
238
|
-
return null; // absent or already correct
|
|
239
|
-
const looksLikeNodeId = typeof sfid === "string" && /^PVT/.test(sfid);
|
|
240
|
-
const shape = looksLikeNodeId
|
|
241
|
-
? "a GraphQL node id (`PVTSSF_…`)"
|
|
242
|
-
: `a ${typeof sfid} (\`${String(sfid)}\`)`;
|
|
243
273
|
return {
|
|
244
|
-
id: "github-project-
|
|
274
|
+
id: "github-project-token-scope",
|
|
245
275
|
severity: "advisory",
|
|
246
|
-
detect:
|
|
247
|
-
"
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
"
|
|
251
|
-
"The Status field's numeric `id` (e.g. `350038178`) → `statusFieldId` (a JSON number, NOT quoted); " +
|
|
252
|
-
"each `options[].id` (e.g. `47fc9ee4`) → the option ids (quoted strings). `gh project field-list`'s " +
|
|
253
|
-
"`id` is the GraphQL node id (`PVTSSF_…`) and must NOT be used for `statusFieldId`.",
|
|
276
|
+
detect: `The GitHub token cannot reach the board \`${config.github.projectUrl}\`: a classic token lacks the \`project\` scope, ` +
|
|
277
|
+
"or a fine-grained token's board query returned nothing. Board moves fall back to the MCP.",
|
|
278
|
+
action: "Give `BKIT_GH_TOKEN` Projects read & write: a classic PAT needs the `project` scope (reaches organization and personal boards); " +
|
|
279
|
+
"a fine-grained PAT needs the organization permission Projects: Read and write (organization boards only). " +
|
|
280
|
+
"Then re-run `bkit check`.",
|
|
254
281
|
};
|
|
255
282
|
}
|
|
256
283
|
/**
|
|
@@ -260,15 +287,15 @@ export function detectGithubProjectFieldIdFormat(cwd) {
|
|
|
260
287
|
* consumers to make the choice post-install.
|
|
261
288
|
*
|
|
262
289
|
* Also performs the cloud=claude config-consistency assertion: when
|
|
263
|
-
* `bkit.
|
|
290
|
+
* `bkit.cloud.agent === "claude"` but the installed `bkit-cloud.yml` lacks
|
|
264
291
|
* `id-token: write`, it surfaces a consistency warning (exit-1 signal surfaced via
|
|
265
292
|
* the `blocker` severity in the checks/before/index.ts caller).
|
|
266
293
|
*
|
|
267
294
|
* Resolution order (file presence is authoritative, package.json field is the
|
|
268
295
|
* opt-out):
|
|
269
296
|
* - `.github/workflows/bkit-cloud.yml` present → `cloud-router` (informational; active)
|
|
270
|
-
* - `bkit.
|
|
271
|
-
* - `bkit.
|
|
297
|
+
* - `bkit.cloud.agent === "none"` → null (opt-out — stay quiet)
|
|
298
|
+
* - `bkit.tracker.default === "jira"` → null (Jira runs locally only)
|
|
272
299
|
* - otherwise (undecided) → `cloud-router-none` (nudge to choose)
|
|
273
300
|
*
|
|
274
301
|
* Only fires when there is a `.github/workflows/` dir (the router wakes on a CI
|
|
@@ -286,7 +313,7 @@ export function buildCloudSetupAdvisory(cwd) {
|
|
|
286
313
|
return {
|
|
287
314
|
id: "cloud-claude-missing-id-token",
|
|
288
315
|
severity: "blocker",
|
|
289
|
-
detect: "`bkit.
|
|
316
|
+
detect: "`bkit.cloud.agent` is `claude` but `.github/workflows/bkit-cloud.yml` lacks `id-token: write`. `claude-code-action@v1` will fail at boot with an OIDC error.",
|
|
290
317
|
action: "Re-run `pnpm bkit install --auto=claude --tracker=github` to regenerate the workflow with `id-token: write` and the App-auth framing. Also verify the Claude GitHub App is installed (`/install-github-app`). See bkit's `cloud.md` § Post-CI auto-routing.",
|
|
291
318
|
};
|
|
292
319
|
}
|
|
@@ -314,6 +341,6 @@ export function buildCloudSetupAdvisory(cwd) {
|
|
|
314
341
|
detect: "Cloud agents: post-CI auto-routing is not configured. `.github/workflows/` exists but no `bkit-cloud.yml` — CI pass/fail does not auto-dispatch bkit-ship / bkit-debug.",
|
|
315
342
|
action: "Optional post-install decision. For a GitHub-tracker repo: `pnpm bkit install --auto=claude --tracker=github`. For a Linear-tracker repo: `pnpm bkit install --auto=cursor --tracker=linear`.\n\n" +
|
|
316
343
|
"Prerequisites for `--auto=claude`: `ANTHROPIC_API_KEY` repo secret (or the `ANTHROPIC_FEDERATION_RULE_ID` + `ANTHROPIC_ORGANIZATION_ID` repo variables for keyless workload identity federation) + Claude GitHub App (`/install-github-app`) + GitHub Actions write permissions.\n\n" +
|
|
317
|
-
'To opt out and silence this advisory, set `bkit.
|
|
344
|
+
'To opt out and silence this advisory, set `bkit.cloud.agent` to `"none"` in package.json.',
|
|
318
345
|
};
|
|
319
346
|
}
|
|
@@ -10,7 +10,7 @@ import { readBkitConfig } from "../../shared/settings.js";
|
|
|
10
10
|
import { detectOpencodeYmlProviderDrift } from "../../install/modules/opencode.js";
|
|
11
11
|
import { detectManagedDuplicate, detectManagedStale } from "./managed.js";
|
|
12
12
|
import { buildCloudDashboardsAdvisory, detectCiRouterSecrets, detectGhMcpToken } from "./auth.js";
|
|
13
|
-
import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildTrackerSetupAdvisory, detectActionsWritePermissions,
|
|
13
|
+
import { buildCloudSetupAdvisory, buildGithubProjectAdvisory, buildGithubProjectTokenScopeAdvisory, buildTrackerSetupAdvisory, detectActionsWritePermissions, detectMainBranchProtection, } from "./github.js";
|
|
14
14
|
import { buildDepUpdaterSetupAdvisory, detectBkitStubs, detectValePackageNotSynced, detectWorkflowLintToolsMissing, } from "./tools.js";
|
|
15
15
|
import { detectBkitCloudYmlAlwaysTrueGate, detectCiYmlCapstoneContractDrift, detectCiYmlMissingActionlint, detectCiYmlRunInjection, detectGhaFloatingTags, detectRunLevelsNotComposed, detectTaggedTestsWithoutCiHome, detectTestIntegrationEnv, detectTurboIntegrationInputs, } from "./ci-yml.js";
|
|
16
16
|
import { dropTipSilencedAdvisories, setupTipsChecklistLines, setupTipsMarkdownLines, } from "../tips/index.js";
|
|
@@ -43,7 +43,7 @@ export function suppressedNoteLines(suppressed) {
|
|
|
43
43
|
return [];
|
|
44
44
|
const n = suppressed.length;
|
|
45
45
|
return [
|
|
46
|
-
`${n} advisor${n === 1 ? "y" : "ies"} suppressed by bkit.
|
|
46
|
+
`${n} advisor${n === 1 ? "y" : "ies"} suppressed by bkit.advisories.ignore:`,
|
|
47
47
|
...suppressed.map((note) => `- ${note.id} (${note.scope})`),
|
|
48
48
|
];
|
|
49
49
|
}
|
|
@@ -243,7 +243,7 @@ export function readChangelogVersionDelta(version) {
|
|
|
243
243
|
* cwd defaults to process.cwd().
|
|
244
244
|
*
|
|
245
245
|
* Pass `suppressed` to collect the advisories a package opted out of via
|
|
246
|
-
* `bkit.
|
|
246
|
+
* `bkit.advisories.ignore` (one note per id + owning package); the caller renders them with
|
|
247
247
|
* `suppressedNoteLines` so a dismissal stays visible. Omitted by callers that do not render.
|
|
248
248
|
*/
|
|
249
249
|
export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), suppressed) {
|
|
@@ -265,11 +265,11 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
|
|
|
265
265
|
const ghMcpToken = detectGhMcpToken(cwd);
|
|
266
266
|
if (ghMcpToken)
|
|
267
267
|
phase3.push(ghMcpToken);
|
|
268
|
-
// Main branch protection — bkit's PR-base gates (build Step
|
|
268
|
+
// Main branch protection — bkit's PR-base gates (build Step 14, ship Step 2)
|
|
269
269
|
// assert feat/* PRs target dev. Enforcing it at the GitHub layer needs branch
|
|
270
270
|
// protection on main restricting merges to PRs from dev.
|
|
271
271
|
const protectionStatus = detectMainBranchProtection();
|
|
272
|
-
const scriptHint = "\n\nQuick path: run `bkit setup protect-main --dry-run` to preview the policy, then drop `--dry-run` to apply. It requires the CI capstone job named by `package.json` `bkit.
|
|
272
|
+
const scriptHint = "\n\nQuick path: run `bkit setup protect-main --dry-run` to preview the policy, then drop `--dry-run` to apply. It requires the CI capstone job named by `package.json` `bkit.testing.ciCapstone` (default `bkit-tests-check`, so the required check means 'validated', not just 'tests job did not fail') and pre-flights that the job exists in the `bkit.testing.ciWorkflow` file before requiring it.";
|
|
273
273
|
if (protectionStatus === "missing") {
|
|
274
274
|
phase3.push({
|
|
275
275
|
id: "main-branch-protection-missing",
|
|
@@ -278,7 +278,7 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
|
|
|
278
278
|
action: "main only ever moves via a release PR (release/* -> main); bkit's build/ship workflows keep all feat/* PRs on dev. Gate main at the GitHub layer:\n\n" +
|
|
279
279
|
" Settings → Branches → Add rule → Branch name pattern: main\n" +
|
|
280
280
|
" - Require a pull request before merging\n" +
|
|
281
|
-
|
|
281
|
+
` - Require status checks: ${readBkitConfig(cwd).capstoneJob} (the always-on capstone — required-check green then means 'the planned tiers ran', not just 'nothing failed'; do NOT require bkit-tests-scope, it is always green)\n` +
|
|
282
282
|
" - Do not allow bypassing the above settings (enforce for admins)\n" +
|
|
283
283
|
" - Require linear history; block force-pushes and deletions\n\n" +
|
|
284
284
|
"enforce-for-admins is load-bearing: agents act with the owner's admin token, so an admin-bypass exemption means the agent is the bypass. Covering admins is the only way protection actually constrains agents. dev is intentionally left unprotected — operators choose direct-push or feat/PR and own that tests ran." +
|
|
@@ -286,7 +286,7 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
|
|
|
286
286
|
});
|
|
287
287
|
}
|
|
288
288
|
// Optional post-install decisions (opt-in add-ons):
|
|
289
|
-
// 1. Issue tracker — branch on bkit.
|
|
289
|
+
// 1. Issue tracker — branch on bkit.tracker.default.
|
|
290
290
|
// 2. Dependency updater — read-only. Suggests an example template. Never writes config.
|
|
291
291
|
// 3. Cloud agents — branch on bkit-cloud.yml presence.
|
|
292
292
|
const trackerSetup = buildTrackerSetupAdvisory(cwd);
|
|
@@ -297,11 +297,9 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
|
|
|
297
297
|
const githubProjectSetup = buildGithubProjectAdvisory(cwd);
|
|
298
298
|
if (githubProjectSetup)
|
|
299
299
|
phase3.push(githubProjectSetup);
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
if (githubProjectFieldId)
|
|
304
|
-
phase3.push(githubProjectFieldId);
|
|
300
|
+
const githubProjectToken = buildGithubProjectTokenScopeAdvisory(cwd);
|
|
301
|
+
if (githubProjectToken)
|
|
302
|
+
phase3.push(githubProjectToken);
|
|
305
303
|
const depUpdaterSetup = buildDepUpdaterSetupAdvisory(cwd);
|
|
306
304
|
if (depUpdaterSetup)
|
|
307
305
|
phase3.push(depUpdaterSetup);
|
|
@@ -411,6 +409,6 @@ export function runPostInstallCheck(preflightAdvisories, cwd = process.cwd(), su
|
|
|
411
409
|
const phase3Ids = new Set(deduped.map((f) => f.id));
|
|
412
410
|
const filteredPreflight = dedupedPreflight.filter((f) => !phase3Ids.has(f.id));
|
|
413
411
|
// Final order: preflight advisories (that weren't superseded) first, then Phase 3.
|
|
414
|
-
// An advisory a setup tip reuses goes quiet with that tip (`bkit.
|
|
412
|
+
// An advisory a setup tip reuses goes quiet with that tip (`bkit.advisories.ignore`).
|
|
415
413
|
return dropTipSilencedAdvisories([...filteredPreflight, ...deduped], cwd, onSuppressed);
|
|
416
414
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
// checks/after/suppression.ts — per-package advisory opt-out (`package.json`
|
|
2
|
-
// `bkit.
|
|
2
|
+
// `bkit.advisories.ignore`).
|
|
3
3
|
//
|
|
4
4
|
// A detector can be right in general and still fire on a package where the condition is
|
|
5
5
|
// deliberately not applicable (a rule-linter whose test titles mention `@live`, an
|
|
@@ -12,9 +12,9 @@
|
|
|
12
12
|
// suppressible whatever the manifest says.
|
|
13
13
|
import { readPackageJson } from "../../shared/package-json.js";
|
|
14
14
|
/**
|
|
15
|
-
* Advisory ids `dir/package.json` opts out of. A missing manifest, a `bkit`
|
|
16
|
-
* absent or not an object, and an `
|
|
17
|
-
* yield no ids — never a throw.
|
|
15
|
+
* Advisory ids `dir/package.json` opts out of. A missing manifest, a `bkit` or
|
|
16
|
+
* `bkit.advisories` key that is absent or not an object, and an `advisories.ignore` that is
|
|
17
|
+
* absent or not an array all yield no ids — never a throw.
|
|
18
18
|
*/
|
|
19
19
|
export function ignoredAdvisoryIds(dir) {
|
|
20
20
|
const read = readPackageJson(dir);
|
|
@@ -23,7 +23,10 @@ export function ignoredAdvisoryIds(dir) {
|
|
|
23
23
|
const bkit = read.pkg.bkit;
|
|
24
24
|
if (typeof bkit !== "object" || bkit === null || Array.isArray(bkit))
|
|
25
25
|
return new Set();
|
|
26
|
-
const
|
|
26
|
+
const advisories = bkit.advisories;
|
|
27
|
+
if (typeof advisories !== "object" || advisories === null || Array.isArray(advisories))
|
|
28
|
+
return new Set();
|
|
29
|
+
const list = advisories.ignore;
|
|
27
30
|
if (!Array.isArray(list))
|
|
28
31
|
return new Set();
|
|
29
32
|
return new Set(list.filter((id) => typeof id === "string"));
|