@cbartens/bkit 5.2.4 → 5.4.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 +27 -11
- package/.bkit/core/.agents/context.md +1 -1
- package/.bkit/core/.agents/docs.md +1 -1
- package/.bkit/core/.agents/plugins/bkit/hooks/bkit-guardrails.cjs +1 -1
- package/.bkit/core/.agents/rules.md +18 -1
- package/.bkit/core/.bkit/README.md +26 -10
- package/.bkit/core/.bkit/cloud.md +40 -39
- package/.bkit/core/.bkit/comparison.md +68 -345
- package/.bkit/core/.bkit/install.md +16 -9
- package/.bkit/core/.bkit/lite.md +73 -0
- package/.bkit/core/.bkit/pipeline.md +346 -0
- package/.bkit/core/.bkit/prompts.md +90 -74
- package/.bkit/core/.bkit/providers.md +42 -23
- package/.bkit/core/.bkit/templates.md +138 -19
- package/.bkit/core/.bkit/trackers.md +49 -4
- package/.bkit/core/.bkit/workflows.md +144 -123
- package/.bkit/core/.claude/hooks/bkit-guardrails.cjs +1 -1
- package/.bkit/core/.codex/hooks/bkit-guardrails.cjs +7 -4
- package/.bkit/core/.cursor/hooks/bkit-guardrails.cjs +8 -5
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-agents.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +4 -2
- package/.bkit/core/docs/templates/bkit-audit-config.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-cost.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-database.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +5 -5
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +26 -21
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +2 -2
- package/.bkit/core/docs/templates/bkit-audit-failures.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-gates.md +5 -2
- package/.bkit/core/docs/templates/bkit-audit-issues.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-llm.md +22 -15
- package/.bkit/core/docs/templates/bkit-audit-logs.md +10 -6
- package/.bkit/core/docs/templates/bkit-audit-models.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +7 -7
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +12 -9
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +3 -2
- package/.bkit/core/docs/templates/bkit-audit-repo.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-security.md +14 -12
- package/.bkit/core/docs/templates/bkit-audit-slop.md +1 -1
- package/.bkit/core/docs/templates/bkit-audit-testing.md +10 -8
- package/.bkit/core/docs/templates/bkit-audit-usability.md +1 -1
- package/.bkit/core/docs/templates/bkit-plan.md +8 -6
- package/.bkit/core/engine/checks/after/auth.ts +9 -9
- package/.bkit/core/engine/checks/after/ci-yml.ts +14 -12
- package/.bkit/core/engine/checks/after/github.ts +29 -120
- package/.bkit/core/engine/checks/after/index.ts +2 -2
- package/.bkit/core/engine/checks/after/managed.ts +8 -28
- package/.bkit/core/engine/checks/after/tools.ts +3 -15
- package/.bkit/core/engine/checks/before/context-fetch.ts +1 -21
- package/.bkit/core/engine/checks/before/index.ts +7 -43
- package/.bkit/core/engine/checks/before/mcp.ts +17 -8
- package/.bkit/core/engine/checks/before/repo.ts +9 -12
- package/.bkit/core/engine/checks/status-holes.ts +4 -6
- package/.bkit/core/engine/checks/tips/catalogue.ts +76 -24
- package/.bkit/core/engine/checks/tips/detect.ts +45 -2
- package/.bkit/core/engine/checks/tips/index.ts +77 -26
- package/.bkit/core/engine/cli.ts +57 -27
- package/.bkit/core/engine/commands/analysis.ts +36 -26
- package/.bkit/core/engine/commands/comply.ts +42 -32
- package/.bkit/core/engine/commands/harvest.ts +12 -12
- package/.bkit/core/engine/commands/install/doctor.ts +57 -28
- package/.bkit/core/engine/commands/install/install.ts +73 -130
- package/.bkit/core/engine/commands/install/uninstall.ts +191 -33
- package/.bkit/core/engine/commands/install/upgrade.ts +49 -43
- package/.bkit/core/engine/commands/land.ts +156 -0
- package/.bkit/core/engine/commands/lib.ts +45 -18
- package/.bkit/core/engine/commands/registry.ts +2 -0
- package/.bkit/core/engine/commands/tips.ts +12 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +386 -286
- package/.bkit/core/engine/commands/workflow/counters.ts +21 -12
- package/.bkit/core/engine/commands/workflow/disk.ts +556 -0
- package/.bkit/core/engine/commands/workflow/fids.ts +46 -0
- package/.bkit/core/engine/commands/workflow/issues.ts +73 -28
- package/.bkit/core/engine/commands/workflow/ledgers.ts +3 -1
- package/.bkit/core/engine/commands/workflow/locks.ts +38 -152
- package/.bkit/core/engine/commands/workflow/prs.ts +15 -4
- package/.bkit/core/engine/commands/workflow/repo.ts +2 -2
- package/.bkit/core/engine/commands/workflow/roadmap.ts +49 -53
- package/.bkit/core/engine/commands/workflow/runs.ts +8 -7
- package/.bkit/core/engine/commands/workflow/runtime.ts +3 -2
- package/.bkit/core/engine/commands/workflow/status.ts +33 -11
- package/.bkit/core/engine/commands/workflow/steps.ts +25 -15
- package/.bkit/core/engine/commands/workflow/tests.ts +17 -5
- package/.bkit/core/engine/commands/workflow/workflows.ts +436 -267
- package/.bkit/core/engine/commands/workflow/workstreams.ts +4 -2
- package/.bkit/core/engine/commands/workflow/worktrees.ts +24 -6
- package/.bkit/core/engine/install/cloud-env.ts +10 -31
- package/.bkit/core/engine/install/manifest.ts +14 -7
- package/.bkit/core/engine/install/modules/antigravity.ts +15 -26
- package/.bkit/core/engine/install/modules/claude.ts +20 -28
- package/.bkit/core/engine/install/modules/cloud.ts +5 -2
- package/.bkit/core/engine/install/modules/codex.ts +15 -29
- package/.bkit/core/engine/install/modules/core.ts +106 -70
- package/.bkit/core/engine/install/modules/cursor.ts +6 -20
- package/.bkit/core/engine/install/modules/index.ts +7 -1
- package/.bkit/core/engine/install/modules/opencode.ts +48 -70
- package/.bkit/core/engine/install/network-allowlist.ts +73 -0
- package/.bkit/core/engine/install/placeholders.ts +16 -35
- package/.bkit/core/engine/install/write.ts +59 -12
- package/.bkit/core/engine/ledgers/telemetry.ts +6 -4
- package/.bkit/core/engine/render/hosts.ts +47 -67
- package/.bkit/core/engine/render/models.ts +29 -11
- package/.bkit/core/engine/shared/branches.ts +13 -0
- package/.bkit/core/engine/shared/egress.ts +3 -3
- package/.bkit/core/engine/shared/json.ts +18 -1
- package/.bkit/core/engine/shared/package-json.ts +63 -0
- package/.bkit/core/engine/shared/package-roots.ts +0 -10
- package/.bkit/core/engine/shared/protected-paths.ts +5 -130
- package/.bkit/core/engine/shared/settings.ts +44 -0
- package/.bkit/core/engine/shared/timeouts.ts +8 -7
- package/.bkit/core/hooks/antigravity-hook.js +1 -0
- package/.bkit/core/hooks/guardrails-shell.js +186 -40
- package/.bkit/core/hooks/guardrails-tiers.js +5 -78
- package/.bkit/core/prompts/bkit-audit-generate.md +103 -7
- package/.bkit/core/prompts/bkit-build-challenge-1.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-2.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +1 -1
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +1 -1
- package/.bkit/core/prompts/bkit-build-install-skills.md +1 -1
- package/.bkit/core/prompts/bkit-build-plan-current.md +1 -1
- package/.bkit/core/prompts/bkit-build-plan-execute.md +4 -4
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +1 -1
- package/.bkit/core/prompts/bkit-build-plan-verify.md +2 -2
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +1 -1
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +1 -1
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +1 -1
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +78 -0
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +1 -1
- package/.bkit/core/prompts/bkit-debug-summary.md +3 -3
- package/.bkit/core/prompts/bkit-design-spike.md +1 -1
- package/.bkit/core/prompts/bkit-design-summary.md +2 -2
- package/.bkit/core/prompts/bkit-design-update.md +1 -1
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +1 -1
- package/.bkit/core/prompts/bkit-plan-generate.md +1 -1
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +1 -1
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +1 -1
- package/.bkit/core/prompts/bkit-plan-summary.md +1 -1
- package/.bkit/core/prompts/bkit-plan-update.md +1 -1
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +1 -1
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +1 -1
- package/.bkit/core/prompts/bkit-ship-update-docs.md +1 -1
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +2 -1
- package/.bkit/core/prompts/bkit-utility-update-failures.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +9 -2
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +11 -4
- package/.bkit/core/workflows/bkit-auto.md +2 -2
- package/.bkit/core/workflows/bkit-build.md +10 -10
- package/.bkit/core/workflows/bkit-debug.md +80 -44
- package/.bkit/core/workflows/bkit-design.md +22 -13
- package/.bkit/core/workflows/bkit-plan.md +33 -16
- package/.bkit/core/workflows/bkit-ship.md +87 -98
- package/.bkit/shared/.claude/bkit-cloud.md +58 -25
- package/.bkit/shared/.claude/settings.json +19 -0
- package/.bkit/shared/.cursor/mcp.json +2 -1
- package/.bkit/shared/.opencode/opencode.json +19 -1
- package/.bkit/shared/docs/deployments.md +49 -29
- package/.bkit/shared/docs/security.md +8 -6
- package/.bkit/shared/docs/testing.md +9 -5
- package/.bkit/shared/gitignore +1 -2
- package/.bkit/templates/.cursor/Dockerfile +30 -16
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-bug.yml +78 -0
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-change.yml +91 -0
- package/.bkit/templates/.github/ISSUE_TEMPLATE/bkit-idea.yml +56 -0
- package/.bkit/templates/.github/renovate.json5 +91 -12
- package/.bkit/templates/.github/workflows/bkit-ci.yml +73 -55
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +3 -1
- package/.bkit/templates/.github/workflows/bkit-renovate.yml +8 -1
- package/.bkit/templates/.github/workflows/bkit-trivy.yml +67 -0
- package/.bkit/templates/.husky/pre-commit +6 -0
- package/.bkit/templates/.husky/pre-push +15 -3
- package/.bkit/templates/.lintstagedrc.json +5 -1
- package/.bkit/templates/.oxlintrc.json +21 -0
- package/.bkit/templates/docs/capabilities.md +1 -1
- package/.bkit/templates/scripts/ci/check-capstone.mjs +176 -0
- package/.bkit/templates/scripts/ci/check-capstone.test.mjs +311 -0
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.machine.mjs +197 -0
- package/.bkit/templates/scripts/cleanup/bkit-disk-prune.mjs +164 -0
- package/.bkit/templates/scripts/graphify/bkit-graph-eager.py +2 -2
- package/.bkit/templates/scripts/graphify/bkit-graph-imports.py +43 -20
- package/.bkit/templates/scripts/graphify/bkit-graph-pre-push.sh +33 -11
- package/.bkit/templates/scripts/graphify/bkit-graph-repair.py +3 -2
- package/.bkit/templates/scripts/graphify/bkit-graphify-rollup.py +5 -5
- package/.bkit/templates/scripts/graphify/bkit-graphify.sh +79 -19
- package/CHANGELOG.md +98 -3
- package/README.md +252 -122
- package/dist/checks/after/auth.js +10 -11
- package/dist/checks/after/ci-yml.js +11 -14
- package/dist/checks/after/github.js +32 -125
- package/dist/checks/after/index.js +3 -2
- package/dist/checks/after/managed.js +8 -24
- package/dist/checks/after/tools.js +3 -16
- package/dist/checks/before/context-fetch.js +1 -21
- package/dist/checks/before/index.js +6 -42
- package/dist/checks/before/mcp.js +14 -9
- package/dist/checks/before/repo.js +8 -11
- package/dist/checks/status-holes.js +5 -7
- package/dist/checks/tips/catalogue.js +65 -18
- package/dist/checks/tips/detect.js +41 -2
- package/dist/checks/tips/index.js +61 -25
- package/dist/cli.js +52 -26
- package/dist/commands/analysis.js +21 -5
- package/dist/commands/comply.js +40 -31
- package/dist/commands/harvest.js +12 -13
- package/dist/commands/install/doctor.js +55 -23
- package/dist/commands/install/install.js +72 -122
- package/dist/commands/install/uninstall.js +165 -31
- package/dist/commands/install/upgrade.js +46 -39
- package/dist/commands/land.js +129 -0
- package/dist/commands/lib.js +41 -16
- package/dist/commands/registry.js +2 -0
- package/dist/commands/tips.js +10 -3
- package/dist/commands/workflow/branches.js +303 -248
- package/dist/commands/workflow/counters.js +17 -7
- package/dist/commands/workflow/disk.js +452 -0
- package/dist/commands/workflow/fids.js +39 -0
- package/dist/commands/workflow/issues.js +63 -27
- package/dist/commands/workflow/ledgers.js +3 -1
- package/dist/commands/workflow/locks.js +35 -130
- package/dist/commands/workflow/prs.js +8 -5
- package/dist/commands/workflow/repo.js +2 -2
- package/dist/commands/workflow/roadmap.js +50 -57
- package/dist/commands/workflow/runs.js +5 -5
- package/dist/commands/workflow/runtime.js +3 -2
- package/dist/commands/workflow/status.js +32 -12
- package/dist/commands/workflow/steps.js +19 -11
- package/dist/commands/workflow/tests.js +16 -3
- package/dist/commands/workflow/workflows.js +390 -249
- package/dist/commands/workflow/workstreams.js +4 -2
- package/dist/commands/workflow/worktrees.js +15 -6
- package/dist/install/cloud-env.js +10 -23
- package/dist/install/manifest.js +14 -7
- package/dist/install/modules/antigravity.js +15 -26
- package/dist/install/modules/claude.js +17 -21
- package/dist/install/modules/cloud.js +6 -2
- package/dist/install/modules/codex.js +15 -29
- package/dist/install/modules/core.js +95 -63
- package/dist/install/modules/cursor.js +6 -9
- package/dist/install/modules/index.js +6 -1
- package/dist/install/modules/opencode.js +41 -72
- package/dist/install/network-allowlist.js +62 -0
- package/dist/install/placeholders.js +16 -35
- package/dist/install/write.js +55 -15
- package/dist/ledgers/telemetry.js +5 -4
- package/dist/render/hosts.js +30 -55
- package/dist/render/models.js +20 -9
- package/dist/shared/branches.js +11 -0
- package/dist/shared/egress.js +0 -2
- package/dist/shared/json.js +14 -0
- package/dist/shared/package-json.js +61 -0
- package/dist/shared/package-roots.js +0 -8
- package/dist/shared/protected-paths.js +5 -122
- package/dist/shared/settings.js +23 -1
- package/dist/shared/timeouts.js +8 -7
- package/package.json +21 -17
- package/.bkit/core/.agents/shortcuts.md +0 -73
|
@@ -76,7 +76,7 @@ Verdict: PASS | CONCERNS | FAIL [Initially set to PENDING.]
|
|
|
76
76
|
|
|
77
77
|
## Design Alignment
|
|
78
78
|
|
|
79
|
-
[Summarise: plan `Narrative` and `Success Criteria` match the design doc verbatim? Plan scope within design scope?; initially set to `PENDING`.]
|
|
79
|
+
[Summarise: plan `Narrative` and `Success Criteria` match the design doc verbatim (no design → the issue's)? Plan scope within design scope (no design → the issue's)?; initially set to `PENDING`.]
|
|
80
80
|
|
|
81
81
|
## Deferred & Out-of-Scope
|
|
82
82
|
|
|
@@ -12,7 +12,7 @@ tools:
|
|
|
12
12
|
- Edit
|
|
13
13
|
- Bash
|
|
14
14
|
permissionMode: acceptEdits
|
|
15
|
-
maxTurns:
|
|
15
|
+
maxTurns: 400
|
|
16
16
|
---
|
|
17
17
|
|
|
18
18
|
**Role:** Senior editor correcting decisions the docs or codebase have since contradicted.
|
|
@@ -49,7 +49,14 @@ maxTurns: 100
|
|
|
49
49
|
6. Per `key` changed above → append one row to `docs/decisions.jsonl` in `.bkit/jsonl.md` format with same `key` and updated values; copy unchanged field values verbatim.
|
|
50
50
|
7. Per doc passage that states facts you just corrected → follow doc `Rules` header and edit only the passages to match appended row; do not run full doc sync.
|
|
51
51
|
8. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory.
|
|
52
|
-
9.
|
|
52
|
+
9. Collect setup tips:
|
|
53
|
+
```bash
|
|
54
|
+
"$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")/node_modules/.bin/bkit" tips --workflow=utility
|
|
55
|
+
```
|
|
56
|
+
Plain text, not JSON. Hold stdout as `{BKIT_TIPS}`; prints nothing or exits non-zero → `{BKIT_TIPS}` empty.
|
|
57
|
+
10. Final return: Display output format verbatim as final message to user; do not summarise or trim.
|
|
58
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
59
|
+
Append `{BKIT_TIPS}` under a `## bkit Tips` heading, unless empty.
|
|
53
60
|
|
|
54
61
|
**Output format:**
|
|
55
62
|
|
|
@@ -12,7 +12,7 @@ tools:
|
|
|
12
12
|
- Edit
|
|
13
13
|
- Bash
|
|
14
14
|
permissionMode: acceptEdits
|
|
15
|
-
maxTurns:
|
|
15
|
+
maxTurns: 400
|
|
16
16
|
---
|
|
17
17
|
|
|
18
18
|
**Role:** Senior editor closing deferrals the codebase has already resolved.
|
|
@@ -46,7 +46,14 @@ maxTurns: 100
|
|
|
46
46
|
7. Per `key` changed above → append one row to `docs/deferrals.jsonl` in `.bkit/jsonl.md` format with same `key` and updated values; copy unchanged field values verbatim.
|
|
47
47
|
8. Rank what remains by `severity`, then age.
|
|
48
48
|
9. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory.
|
|
49
|
-
10.
|
|
49
|
+
10. Collect setup tips:
|
|
50
|
+
```bash
|
|
51
|
+
"$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")/node_modules/.bin/bkit" tips --workflow=utility
|
|
52
|
+
```
|
|
53
|
+
Plain text, not JSON. Hold stdout as `{BKIT_TIPS}`; prints nothing or exits non-zero → `{BKIT_TIPS}` empty.
|
|
54
|
+
11. Final return: Display output format verbatim as final message to user; do not summarise or trim.
|
|
55
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
56
|
+
Append `{BKIT_TIPS}` under a `## bkit Tips` heading, unless empty.
|
|
50
57
|
|
|
51
58
|
**Output format:**
|
|
52
59
|
|
|
@@ -11,7 +11,7 @@ tools:
|
|
|
11
11
|
- Write
|
|
12
12
|
- Edit
|
|
13
13
|
permissionMode: acceptEdits
|
|
14
|
-
maxTurns:
|
|
14
|
+
maxTurns: 400
|
|
15
15
|
---
|
|
16
16
|
|
|
17
17
|
**Role:** Senior tech writer syncing project docs with system state after multiple plans.
|
|
@@ -40,6 +40,7 @@ maxTurns: 100
|
|
|
40
40
|
4. Per doc, four passes in order: Sync content (gaps vs implementation) → reorganize structure (dedupe, move misplaced) → compress wording (more token-efficient) → update cross-references (inline `docs/*.md` links).
|
|
41
41
|
5. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory.
|
|
42
42
|
6. Final return: Display output format verbatim as final message to user; do not summarise or trim.
|
|
43
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
43
44
|
|
|
44
45
|
**Output format:**
|
|
45
46
|
|
|
@@ -12,7 +12,7 @@ tools:
|
|
|
12
12
|
- Edit
|
|
13
13
|
- Bash
|
|
14
14
|
permissionMode: acceptEdits
|
|
15
|
-
maxTurns:
|
|
15
|
+
maxTurns: 400
|
|
16
16
|
---
|
|
17
17
|
|
|
18
18
|
**Role:** Senior editor closing failures the codebase has already resolved.
|
|
@@ -46,7 +46,14 @@ maxTurns: 100
|
|
|
46
46
|
7. Per `key` changed above → append one row to `docs/failures.jsonl` in `.bkit/jsonl.md` format with same `key` and updated values; copy unchanged field values verbatim.
|
|
47
47
|
8. Rank what remains by `severity`, then age.
|
|
48
48
|
9. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory.
|
|
49
|
-
10.
|
|
49
|
+
10. Collect setup tips:
|
|
50
|
+
```bash
|
|
51
|
+
"$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")/node_modules/.bin/bkit" tips --workflow=utility
|
|
52
|
+
```
|
|
53
|
+
Plain text, not JSON. Hold stdout as `{BKIT_TIPS}`; prints nothing or exits non-zero → `{BKIT_TIPS}` empty.
|
|
54
|
+
11. Final return: Display output format verbatim as final message to user; do not summarise or trim.
|
|
55
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
56
|
+
Append `{BKIT_TIPS}` under a `## bkit Tips` heading, unless empty.
|
|
50
57
|
|
|
51
58
|
**Output format:**
|
|
52
59
|
|
|
@@ -12,7 +12,7 @@ tools:
|
|
|
12
12
|
- Edit
|
|
13
13
|
- Bash
|
|
14
14
|
permissionMode: acceptEdits
|
|
15
|
-
maxTurns:
|
|
15
|
+
maxTurns: 400
|
|
16
16
|
---
|
|
17
17
|
|
|
18
18
|
**Role:** Senior editor correcting gotchas the docs or codebase have since contradicted.
|
|
@@ -49,7 +49,14 @@ maxTurns: 100
|
|
|
49
49
|
6. Per `key` changed above → append one row to `docs/knowledge.jsonl` in `.bkit/jsonl.md` format with same `key` and updated values; copy unchanged field values verbatim.
|
|
50
50
|
7. Per doc passage that states facts you just corrected → follow doc `Rules` header and edit only the passages to match appended row; do not run full doc sync.
|
|
51
51
|
8. Ensure agent memories (`MEMORY.md` / `memory/*.md`) do not duplicate content and only contain pointers (path, section, one-line hook) to relevant `docs/*.md` sections / `docs/*.jsonl` entries. **If** memory contains duplicate / stale content → update memory.
|
|
52
|
-
9.
|
|
52
|
+
9. Collect setup tips:
|
|
53
|
+
```bash
|
|
54
|
+
"$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")/node_modules/.bin/bkit" tips --workflow=utility
|
|
55
|
+
```
|
|
56
|
+
Plain text, not JSON. Hold stdout as `{BKIT_TIPS}`; prints nothing or exits non-zero → `{BKIT_TIPS}` empty.
|
|
57
|
+
10. Final return: Display output format verbatim as final message to user; do not summarise or trim.
|
|
58
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
59
|
+
Append `{BKIT_TIPS}` under a `## bkit Tips` heading, unless empty.
|
|
53
60
|
|
|
54
61
|
**Output format:**
|
|
55
62
|
|
|
@@ -24,7 +24,7 @@ tools:
|
|
|
24
24
|
- Bash
|
|
25
25
|
# <!-- bkit:tracker false end -->
|
|
26
26
|
permissionMode: acceptEdits
|
|
27
|
-
maxTurns:
|
|
27
|
+
maxTurns: 400
|
|
28
28
|
---
|
|
29
29
|
|
|
30
30
|
**Role:** Senior PM ranking next best items to work on from board and ledgers.
|
|
@@ -60,9 +60,16 @@ maxTurns: 100
|
|
|
60
60
|
8. Per `docs/templates/bkit-audit-*.md` → read only H1 and `**Cadence:**`. **If** due against its cadence (newest report under `docs/audits/` by commit date; never run = due) → audit candidate.
|
|
61
61
|
9. Analyse all plan artifacts, ledger rows, and tracker issues read above plus all audit candidates → list the top `{N}` next best items in priority order; per item add short priority rationale. Audit candidates enter the list only by priority (risk covered first, then how overdue); max 3 audit rows. Both containers stay in `Next Containers` and enter the list only by priority. A container in the list is one item; its action is its relevant children; relevant children do not also take their own rows. **If** tracker unwired → `Next Containers` is `None`.
|
|
62
62
|
10. Group items sharing scope or blocking each other; group by domain boundaries, never token count; treat items done together as one list item.
|
|
63
|
-
11. Per item → recommend the `/bkit-<phase>` command;
|
|
63
|
+
11. Per item → recommend the `/bkit-<phase>` command; recommend the `.bkit/lite.md` lite workflow `<phase>:lite` instead only where it is clearly enough; recommend model tier; recommend `@bkit-audit-generate` for audit reports. **If** tracker wired and item has no issue → recommend filing one first, shape per `.bkit/trackers.md` § Issue shapes.
|
|
64
64
|
12. Update content in `docs/roadmap.md` between markers `<!-- bkit:roadmap-analysis start -->` and `<!-- bkit:roadmap-analysis end -->` only via `Edit`.
|
|
65
|
-
13.
|
|
65
|
+
13. Collect setup tips:
|
|
66
|
+
```bash
|
|
67
|
+
"$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")/node_modules/.bin/bkit" tips --workflow=utility
|
|
68
|
+
```
|
|
69
|
+
Plain text, not JSON. Hold stdout as `{BKIT_TIPS}`; prints nothing or exits non-zero → `{BKIT_TIPS}` empty.
|
|
70
|
+
14. Final return: Display output format verbatim as final message to user; do not summarise or trim.
|
|
71
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
72
|
+
Append `{BKIT_TIPS}` under a `## bkit Tips` heading, unless empty.
|
|
66
73
|
|
|
67
74
|
**Output format:**
|
|
68
75
|
|
|
@@ -73,7 +80,7 @@ maxTurns: 100
|
|
|
73
80
|
|
|
74
81
|
## Next Items
|
|
75
82
|
|
|
76
|
-
[Per item, in priority order: what to do, short priority rationale, recommend `/bkit-<phase>` command or, where clearly enough,
|
|
83
|
+
[Per item, in priority order: what to do, short priority rationale, recommend `/bkit-<phase>` command or, where clearly enough, `<phase>:lite` lite workflow, model tier. **If** none → `None`.]
|
|
77
84
|
|
|
78
85
|
## Groupings
|
|
79
86
|
|
|
@@ -23,14 +23,14 @@ description: "Auto — Phase-routed dispatch of any bkit phase"
|
|
|
23
23
|
<!-- bkit:tracker github start -->
|
|
24
24
|
|
|
25
25
|
> - **Tracker:** GitHub Issues via MCP server `github` (configured in `.mcp.json` `mcpServers.github`). Tool names: `mcp__github__issue_read` (methods `get`, `get_comments`, `get_labels`), `mcp__github__issue_write` (method: `update`), `mcp__github__add_issue_comment`, `mcp__github__list_issues`. Assert `{ISSUE_ID}` non-empty before tool calls; all writes best-effort; never gate. **If** failure → retry once after 5s, then continue.
|
|
26
|
-
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path)
|
|
26
|
+
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:debug`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new; a phase start also drops every `next:*` and `bkit:failed`). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path).
|
|
27
27
|
> - **Comments:** Post the `comment` a step's `bkit` block prints as a new comment via `mcp__github__add_issue_comment({ owner: "{OWNER}", repo: "{REPO}", issue_number: {ISSUE_ID}, body: "{BODY}" })` before its gate; every gate includes `Issue comment attempted (Step N section)`. never edit, paraphrase, summarise, truncate, deduplicate, or reorder prior tracker content. Comment ID tracking not required.
|
|
28
28
|
|
|
29
29
|
<!-- bkit:tracker github end -->
|
|
30
30
|
<!-- bkit:tracker linear start -->
|
|
31
31
|
|
|
32
32
|
> - **Tracker:** Linear via MCP server `linear` (configured in `.mcp.json` `mcpServers.linear`). Tool names: `mcp__linear__get_issue`, `mcp__linear__save_issue`, `mcp__linear__save_comment`, `mcp__linear__list_comments`, `mcp__linear__list_issues`. Assert `{ISSUE_ID}` non-empty before tool calls; all `save_*` writes best-effort; never gate. **If** failure → retry once after 5s, then continue. `save_issue` always includes `id`.
|
|
33
|
-
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path)
|
|
33
|
+
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:debug`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new; a phase start also drops every `next:*` and `bkit:failed`). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path).
|
|
34
34
|
> - **Comments:** Post the `comment` a step's `bkit` block prints as a new comment via `mcp__linear__save_comment({ issueId: "{ISSUE_ID}", body: "{BODY}" })` (no `id` — creates new comment) before its gate; every gate includes `Issue comment attempted (Step N section)`. never edit, paraphrase, summarise, truncate, deduplicate, or reorder prior tracker content. No edit-in-place.
|
|
35
35
|
|
|
36
36
|
<!-- bkit:tracker linear end -->
|
|
@@ -29,14 +29,14 @@ description: "Build Feature — Autonomous implementation"
|
|
|
29
29
|
<!-- bkit:tracker github start -->
|
|
30
30
|
|
|
31
31
|
> - **Tracker:** GitHub Issues via MCP server `github` (configured in `.mcp.json` `mcpServers.github`). Tool names: `mcp__github__issue_read` (methods `get`, `get_comments`, `get_labels`), `mcp__github__issue_write` (method: `update`), `mcp__github__add_issue_comment`, `mcp__github__list_issues`, `mcp__github__projects_write` (methods `add_project_item` / `update_project_item`), `mcp__github__projects_list` (method `list_project_items`) — needs `projects` toolset in `.mcp.json` (`X-MCP-Toolsets`) and `package.json` `bkit.githubProject` config; absent either → board status sync silently skipped. Assert `{ISSUE_ID}` / `{STATE}` / `{LABELS}` non-empty before tool calls; all writes best-effort; never gate. **If** failure → retry once after 5s, then continue.
|
|
32
|
-
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path)
|
|
32
|
+
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:debug`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new; a phase start also drops every `next:*` and `bkit:failed`). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path). `bkit issues labels` computes each transition; MCP writes it.
|
|
33
33
|
> - **Comments:** Post the `comment` a step's `bkit` block prints as a new comment via `mcp__github__add_issue_comment({ owner: "{OWNER}", repo: "{REPO}", issue_number: {ISSUE_ID}, body: "{BODY}" })` before its gate; every gate includes `Issue comment attempted (Step N section)`. never edit, paraphrase, summarise, truncate, deduplicate, or reorder prior tracker content. Comment ID tracking not required.
|
|
34
34
|
|
|
35
35
|
<!-- bkit:tracker github end -->
|
|
36
36
|
<!-- bkit:tracker linear start -->
|
|
37
37
|
|
|
38
38
|
> - **Tracker:** Linear via MCP server `linear` (configured in `.mcp.json` `mcpServers.linear`). Tool names: `mcp__linear__get_issue`, `mcp__linear__save_issue`, `mcp__linear__save_comment`, `mcp__linear__list_comments`, `mcp__linear__list_issues`. Assert `{ISSUE_ID}` / `{STATE}` / `{LABELS}` non-empty before tool calls; all `save_*` writes best-effort; never gate. **If** failure → retry once after 5s, then continue. `save_issue` always includes `id`.
|
|
39
|
-
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path)
|
|
39
|
+
> - **Labels:** Phase labels `bkit:design`, `bkit:plan`, `bkit:build`, `bkit:debug`, `bkit:ship`, `bkit:merged` (mutually exclusive — drop old phase before adding new; a phase start also drops every `next:*` and `bkit:failed`). Additive labels: `bkit:auto` (bkit-auto trigger gate), `bkit:failed` (Failure Path). `bkit issues labels` computes each transition; MCP writes it.
|
|
40
40
|
> - **Comments:** Post the `comment` a step's `bkit` block prints as a new comment via `mcp__linear__save_comment({ issueId: "{ISSUE_ID}", body: "{BODY}" })` (no `id` — creates new comment) before its gate; every gate includes `Issue comment attempted (Step N section)`. never edit, paraphrase, summarise, truncate, deduplicate, or reorder prior tracker content. No edit-in-place.
|
|
41
41
|
|
|
42
42
|
<!-- bkit:tracker linear end -->
|
|
@@ -67,18 +67,18 @@ description: "Build Feature — Autonomous implementation"
|
|
|
67
67
|
<!-- bkit:tracker true start -->
|
|
68
68
|
Post `comment` (when non-null).
|
|
69
69
|
<!-- bkit:tracker true end -->
|
|
70
|
-
3. **If** `HANDOVER_NEEDED` = true → step 4. **Else** → step
|
|
70
|
+
3. **If** `HANDOVER_NEEDED` = true → step 4. **Else** → step 5.
|
|
71
71
|
4. **Subagent:** Invoke `@bkit-debug-abort-handover` using `Agent` tool:
|
|
72
72
|
Context: You are a subagent in the Build Debug phase. Switch into working directory `cd "{WORKTREE_PATH}"` → verify with `pwd` → use for all subsequent file operations.
|
|
73
73
|
Read: `docs/plans/{YYYYMM}/{FID}-plan.md` (if present), `docs/plans/{YYYYMM}/logs/{FID}/status.jsonl`, glob `docs/plans/{YYYYMM}/logs/{FID}/build-*.md`, `git diff origin/dev..HEAD` (apply **Large Diff Guard**).
|
|
74
74
|
Create: `docs/plans/{YYYYMM}/logs/{FID}/build-handover.md`.
|
|
75
|
-
5. `git status --short` → remove unintended files,
|
|
75
|
+
5. `git status --short` → on a feature branch remove unintended files; on `dev` / `main` remove nothing (only the run's own record lands, through a throwaway checkout). Then commit and push the run's record — NEVER onto a branch with an open PR; **Skip if** `{WORKTREE_PATH}` is not set:
|
|
76
76
|
```bash
|
|
77
|
-
"{BKIT}" workflows handover --workflow=build --fid={FID} --month={YYYYMM} --push
|
|
77
|
+
"{BKIT}" workflows handover --workflow=build --fid={FID} --month={YYYYMM} --push --worktree="{WORKTREE_PATH}"
|
|
78
78
|
```
|
|
79
79
|
Route:
|
|
80
80
|
- **If** exit 80 → open PR on `{BRANCH}` via `list_pull_requests` → re-run with `--open-pr={number}` or `--open-pr=none`.
|
|
81
|
-
- **Else** → post `comment` (
|
|
81
|
+
- **Else** → post `comment` (when non-null) → step 6.
|
|
82
82
|
6. **STOP**, no further downstream steps.
|
|
83
83
|
|
|
84
84
|
---
|
|
@@ -346,7 +346,7 @@ Per-step summary file naming for sub-plan loop steps: `{step}-{SUB_PLAN}-{ATTEMP
|
|
|
346
346
|
Hold `value` as `{VERIFY_ATTEMPT}`.
|
|
347
347
|
6. Audit the sub-plan's test-first reds:
|
|
348
348
|
```bash
|
|
349
|
-
"{BKIT}" tests green --file="{STATUS}" --workflow=build --sub-plan={SUB_PLAN} --plan=docs/plans/{YYYYMM}/{FID}-plan-{SUB_PLAN}.md --plan=docs/plans/{YYYYMM}/{FID}-plan.md --log="docs/plans/{YYYYMM}/logs/{FID}/build-tests-green-{SUB_PLAN}-{VERIFY_ATTEMPT}.md"
|
|
349
|
+
"{BKIT}" tests green --file="{STATUS}" --workflow=build --sub-plan={SUB_PLAN} --plan=docs/plans/{YYYYMM}/{FID}-plan-{SUB_PLAN}.md --plan=docs/plans/{YYYYMM}/{FID}-plan.md --brief=docs/plans/{YYYYMM}/logs/{FID}/build-input-{RUN}.md --log="docs/plans/{YYYYMM}/logs/{FID}/build-tests-green-{SUB_PLAN}-{VERIFY_ATTEMPT}.md"
|
|
350
350
|
```
|
|
351
351
|
**If** exit >= 2 → **Failure Path**.
|
|
352
352
|
7. **Subagent:** Invoke `@bkit-build-plan-verify` using `Agent` tool:
|
|
@@ -775,13 +775,13 @@ Per-step summary file naming for sub-plan loop steps: `{step}-{SUB_PLAN}-{ATTEMP
|
|
|
775
775
|
```bash
|
|
776
776
|
"{BKIT}" tips --workflow=build
|
|
777
777
|
```
|
|
778
|
-
Plain text, not JSON. Hold stdout as `{
|
|
778
|
+
Plain text, not JSON. Hold stdout as `{BKIT_TIPS}`; prints nothing or exits non-zero → `{BKIT_TIPS}` empty.
|
|
779
779
|
12. Final return: Display `build-summary.md` content verbatim as final message to user; do not summarise or trim; do not auto-invoke. Append `CI not awaited here — /bkit-ship gates on its result; red → /bkit-debug.`
|
|
780
780
|
<!-- bkit:tracker true start -->
|
|
781
781
|
Append issue link [{ISSUE_ID} {TITLE}]({URL})
|
|
782
782
|
<!-- bkit:tracker true end -->
|
|
783
|
-
Append `
|
|
784
|
-
Append
|
|
783
|
+
Append `Would you like me to explain any of this in plain English? Then write 'yes, explain in plain english'.`
|
|
784
|
+
Append `{BKIT_TIPS}` under a `## bkit Tips` heading, unless empty.
|
|
785
785
|
13. **If** user requests plain English explanation → restate the summary in plain English; name terms and say what they mean; identifiers stay verbatim; plainness lives in sentences, NOT nouns; do not re-run any step.
|
|
786
786
|
|
|
787
787
|
### 🔒 Gate 18 — Close Workflow & Create PR
|