@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
|
@@ -3,29 +3,35 @@
|
|
|
3
3
|
|
|
4
4
|
# Google Cloud Run — container logs
|
|
5
5
|
|
|
6
|
-
Fits: services running on Google Cloud Run. `context=runtime
|
|
6
|
+
Fits: services running on Google Cloud Run. The `context=runtime` block runs `gcloud logging read` on `cloud_run_revision` and returns the `severity>=ERROR` lines plus the platform's `Memory limit … exceeded` lines. Those lines are container kills (503 / SIGKILL exit 137). The app itself never logs them, and an error tracker never sees them, because the container dies before its SDK flushes.
|
|
7
7
|
|
|
8
|
-
- Secret: none locally after `gcloud auth login`.
|
|
9
|
-
-
|
|
10
|
-
-
|
|
8
|
+
- Secret: none locally after `gcloud auth login`.
|
|
9
|
+
- Secret in headless runs (cloud agents): `GCP_CLIENT_EMAIL` and `GCP_PRIVATE_KEY` of a service account with `roles/logging.viewer`. The block activates the service account only when the gcloud login cannot mint a token (no login, or a stale one). It does so in a throwaway gcloud config that it deletes on exit, so your own gcloud config is never switched.
|
|
10
|
+
- Non-secret: `GCP_PROJECT_ID`. Uncomment its line in the block so cloud agents inherit it.
|
|
11
|
+
- **If** dev and prod are separate projects → use the `GCP_PROJECT_ID` whose logs you want.
|
|
12
|
+
- Optional non-secret: `GCP_SERVICE` narrows the read to one service. The other knobs are `SINCE`, `GCP_N` and `GCP_FILTER`.
|
|
13
|
+
- CLI: `gcloud`. The provision block installs it in cloud, and GitHub-hosted Ubuntu runners already ship it. The block also uses `node` to build the key file.
|
|
11
14
|
|
|
12
15
|
Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`.
|
|
13
16
|
|
|
14
17
|
<!-- context-fetch:start cloudrun context=runtime -->
|
|
15
18
|
|
|
16
19
|
```bash
|
|
17
|
-
# GCP Cloud Run
|
|
20
|
+
# GCP Cloud Run container logs (read-only): platform and container errors, including OOM kills
|
|
18
21
|
# ("Memory limit of NNNN MiB exceeded" → 503 / SIGKILL exit 137) that never reach the app's own
|
|
19
22
|
# logs or its error tracker.
|
|
20
|
-
# GCP_PROJECT_ID is non-secret
|
|
21
|
-
# Optional GCP_SERVICE narrows to one service
|
|
23
|
+
# GCP_PROJECT_ID is non-secret. Uncomment and set the line below so cloud agents inherit it.
|
|
24
|
+
# Optional GCP_SERVICE narrows the read to one service. Unset, the block reads every
|
|
25
|
+
# cloud_run_revision in the project:
|
|
22
26
|
# GCP_PROJECT_ID="your-gcp-project-id"
|
|
23
27
|
# GCP_SERVICE="your-service-name"
|
|
24
|
-
# Headless auth: active gcloud login
|
|
25
|
-
# login lists ACTIVE yet fails every read with reauth.
|
|
26
|
-
#
|
|
27
|
-
#
|
|
28
|
-
#
|
|
28
|
+
# Headless auth: the block uses the active gcloud login only when `print-access-token` works. A
|
|
29
|
+
# stale user login still lists as ACTIVE, yet fails every read with reauth. With no working
|
|
30
|
+
# login, the block uses a service account built from GCP_CLIENT_EMAIL and GCP_PRIVATE_KEY (the
|
|
31
|
+
# `\n`-escaped PEM, un-escaped) in a throwaway CLOUDSDK_CONFIG, and leaves the operator's gcloud
|
|
32
|
+
# config untouched. Locally, run `gcloud auth login` once and skip both variables.
|
|
33
|
+
# A failed `gcloud logging read` → `skipped`.
|
|
34
|
+
# PII-safe: the block prints scalar and id fields only, never the raw payload.
|
|
29
35
|
# Customise: GCP_SERVICE; SINCE freshness; GCP_N; GCP_FILTER (add textPayload:"<prefix>" for app stdout). Positive control (suggested): run once with GCP_FILTER widened to a known log line; nothing back = reader broken, not clean.
|
|
30
36
|
command -v gcloud >/dev/null 2>&1 \
|
|
31
37
|
|| { echo "[context-fetch:cloudrun] skipped — gcloud CLI missing" >&2; exit 0; }
|
|
@@ -76,9 +82,11 @@ jq '[.[] | {timestamp, severity,
|
|
|
76
82
|
<!-- context-fetch:provision cloudrun -->
|
|
77
83
|
|
|
78
84
|
```bash
|
|
79
|
-
# Install the gcloud CLI in cloud if absent
|
|
80
|
-
#
|
|
81
|
-
#
|
|
85
|
+
# Install the gcloud CLI in cloud if it is absent. The block guards itself and does nothing when
|
|
86
|
+
# the CLI is present.
|
|
87
|
+
# The install script needs no root and no apt. With --disable-prompts it writes the SDK to $HOME
|
|
88
|
+
# and appends it to the shell profile, so later context-fetch shells, which source the profile,
|
|
89
|
+
# find it.
|
|
82
90
|
command -v gcloud >/dev/null 2>&1 \
|
|
83
91
|
|| curl -sSL https://sdk.cloud.google.com | bash -s -- --disable-prompts >/dev/null 2>&1
|
|
84
92
|
```
|
|
@@ -3,16 +3,29 @@
|
|
|
3
3
|
|
|
4
4
|
# Expo EAS — native builds and Workflow e2e runs (Maestro)
|
|
5
5
|
|
|
6
|
-
Fits: React Native / Expo apps on EAS.
|
|
6
|
+
Fits: React Native / Expo apps on EAS. EAS sends build failures and Workflow runs nowhere else, neither to a host log nor to an error tracker, so these blocks are the only place they surface.
|
|
7
7
|
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
- `expo
|
|
8
|
+
- The `expo` block (`context=runtime`) returns recent EAS Build status (id, platform, status, profile, commit, error), then the error-level lines of the latest errored builds' logs.
|
|
9
|
+
- The `expo-workflows` block (`context=e2e`) reads the latest failed EAS Workflow runs (`eas workflow:run`, Maestro). For each run it returns the job status and errors, the step-log tails, the per-flow exception for every flow and retry (EAS GraphQL), the JUnit, and the failure screenshot URLs. From `artifacts.tar.gz` it adds the failing Maestro commands, the list of view-hierarchy dumps, the per-attempt JUnit, the XCUITest runner's own errors and the app's JS console.
|
|
10
|
+
|
|
11
|
+
The settings:
|
|
12
|
+
|
|
13
|
+
- Secret: `EXPO_TOKEN` (an EAS access token). It goes in the app's env (e.g. `apps/mobile/.env.local`), not in `.bkit/.env`.
|
|
14
|
+
- Non-secret, both blocks: `EXPO_APP_DIR`, the EAS-linked app folder (default `apps/mobile`).
|
|
15
|
+
- Non-secret, `expo` block: `EAS_PLATFORM`, `EAS_PROFILE`, `EAS_N` (default and max 50, the CLI limit), `EAS_ERR_N` and `EAS_LOG_N`.
|
|
16
|
+
- Non-secret, `expo-workflows` block: `EAS_WF_FILE`, `EAS_WF_N` and `EAS_WF_FAIL_N` (each at most 100, the CLI limit), `EAS_WF_ERR_N` and `EAS_JUNIT_N`.
|
|
17
|
+
- CLI: `eas` (`eas-cli`). Each block's provision block of the same name installs it in cloud and guards itself, so copying both installs it once. The `expo` block also uses `node` to decompress logs.
|
|
18
|
+
- Domains: `expo.dev` for both blocks, `googleapis.com` for `expo`, and `eascdn.net` for `expo-workflows`. Each section carries its own `allowed-domains` block.
|
|
19
|
+
|
|
20
|
+
How the blocks read their sources:
|
|
21
|
+
|
|
22
|
+
- `expo`: build logs are pre-signed, brotli-encoded storage URLs, valid for about 15 min. macOS curl has no brotli, so the block decompresses the logs with Node zlib and filters the JSON lines with `jq`.
|
|
23
|
+
- `expo-workflows`: when a GitHub Actions job starts the run, pair this block with the `maestro` block (`bkit-maestro.md`). That block reads the GitHub job log, and this one reads EAS.
|
|
24
|
+
- `expo-workflows`: read its output in this order:
|
|
25
|
+
1. The per-flow exception (2b).
|
|
26
|
+
2. The XCUITest runner errors (2e), for any `DeviceUnreachableException`. Maestro's iOS driver is an XCUITest case that hosts the HTTP server, so one failure inside it fails every later flow.
|
|
27
|
+
3. The view-hierarchy dump (2d), for any selector or visibility failure. It is the tree Maestro actually searched, and it can contradict a screenshot.
|
|
28
|
+
- `expo-workflows`: artifact URLs are pre-signed and expire after about 1 h, and EAS keeps the data for 90 days. An expired URL means you re-run `workflow:status`. It does not mean the artifact is gone.
|
|
16
29
|
|
|
17
30
|
Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The two sections are independent: copy one or both, each with its provision and `allowed-domains` blocks.
|
|
18
31
|
|
|
@@ -21,10 +34,11 @@ Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The
|
|
|
21
34
|
<!-- context-fetch:start expo context=runtime -->
|
|
22
35
|
|
|
23
36
|
```bash
|
|
24
|
-
# Expo EAS native build status
|
|
25
|
-
# EXPO_TOKEN is an app/stack
|
|
26
|
-
#
|
|
27
|
-
#
|
|
37
|
+
# Expo EAS native build status and errored-build logs (read-only).
|
|
38
|
+
# EXPO_TOKEN is an app / stack credential, because it builds and ships the native apps. It goes in
|
|
39
|
+
# the app env, not in .bkit/.env.
|
|
40
|
+
# Run `eas` from the EAS-linked app folder. Run from anywhere else, it writes a stub app.json there.
|
|
41
|
+
# A failed `eas build:list` (bad token, EAS_N > 50, network) → `skipped`.
|
|
28
42
|
# Customise: EXPO_APP_DIR; EAS_PLATFORM (android|ios|all); EAS_PROFILE (build profile, e.g. preview / production); EAS_N (builds listed, default and max 50); EAS_ERR_N; EAS_LOG_N (log lines per build); the log-line filter. Positive control (suggested): newest build on expo.dev must be the first line; missing = reader broken, not clean.
|
|
29
43
|
EXPO_APP_DIR="${EXPO_APP_DIR:-apps/mobile}"
|
|
30
44
|
command -v eas >/dev/null && [ -n "${EXPO_TOKEN:-}" ] \
|
|
@@ -42,8 +56,9 @@ EAS_BUILDS=$(eas build:list \
|
|
|
42
56
|
printf '===== eas builds, newest %s (%s) — %s build(s) =====\n' "${EAS_N:-50}" "${EAS_PLATFORM:-all}" "$(printf '%s' "$EAS_BUILDS" | jq length)"
|
|
43
57
|
printf '%s' "$EAS_BUILDS" \
|
|
44
58
|
| jq -c '.[] | {id, platform, status, createdAt, buildProfile, gitCommitHash, error}' # gitCommitHash stitches to the CI run
|
|
45
|
-
# 2)
|
|
46
|
-
# URLs (signature in the query string, no auth header), valid
|
|
59
|
+
# 2) Logs for recent failures. There is no `eas build:logs`. build:view exposes `logFiles`:
|
|
60
|
+
# pre-signed URLs (the signature is in the query string, with no auth header), valid for about
|
|
61
|
+
# 900s, holding brotli-encoded JSON lines.
|
|
47
62
|
# An install-dependencies failure (e.g. a private-registry 401) shows here.
|
|
48
63
|
for id in $(eas build:list --status errored --platform "${EAS_PLATFORM:-all}" ${EAS_PROFILE:+--build-profile "$EAS_PROFILE"} \
|
|
49
64
|
--limit "${EAS_ERR_N:-2}" --json --non-interactive | jq -r '.[].id'); do
|
|
@@ -62,7 +77,8 @@ done
|
|
|
62
77
|
<!-- context-fetch:provision expo -->
|
|
63
78
|
|
|
64
79
|
```bash
|
|
65
|
-
# Install eas-cli in cloud if absent
|
|
80
|
+
# Install eas-cli in cloud if it is absent. The block guards itself and does nothing when the CLI
|
|
81
|
+
# is present.
|
|
66
82
|
command -v eas >/dev/null 2>&1 || pnpm add -g eas-cli
|
|
67
83
|
```
|
|
68
84
|
|
|
@@ -80,9 +96,9 @@ googleapis.com
|
|
|
80
96
|
<!-- context-fetch:start expo-workflows context=e2e -->
|
|
81
97
|
|
|
82
98
|
```bash
|
|
83
|
-
# EAS
|
|
84
|
-
# that one covers `eas build`, this one covers `eas workflow:run`.
|
|
85
|
-
#
|
|
99
|
+
# EAS Workflow runs: the native e2e (Maestro) lane (read-only). This block is separate from the
|
|
100
|
+
# expo block: that one covers `eas build`, and this one covers `eas workflow:run`.
|
|
101
|
+
# A failed `eas workflow:runs` (bad token, network) → `skipped`.
|
|
86
102
|
# Customise: EXPO_APP_DIR; EAS_WF_FILE (e2e workflow file; unset = all); EAS_WF_N (all-status runs listed, max 100); EAS_WF_FAIL_N (FAILURE runs listed, max 100; reaches further back than the all-status list); EAS_WF_ERR_N (failed runs read in detail); EAS_JUNIT_N (lines per JUnit file); which artifacts to inline; the log greps. Positive control (suggested): a known failed run must appear in the FAILURE list; missing = reader broken, not clean.
|
|
87
103
|
EXPO_APP_DIR="${EXPO_APP_DIR:-apps/mobile}"
|
|
88
104
|
command -v eas >/dev/null && [ -n "${EXPO_TOKEN:-}" ] \
|
|
@@ -92,10 +108,10 @@ grep -qs 'projectId' "$EXPO_APP_DIR"/app.json "$EXPO_APP_DIR"/app.config.* \
|
|
|
92
108
|
cd "$EXPO_APP_DIR" || exit 0
|
|
93
109
|
WORK=$(mktemp -d)
|
|
94
110
|
trap 'rm -rf "$WORK"' EXIT
|
|
95
|
-
# 1) Recent workflow runs, newest first. `workflow:runs` does
|
|
96
|
-
#
|
|
97
|
-
#
|
|
98
|
-
# 100 errors. The date field is `startedAt
|
|
111
|
+
# 1) Recent workflow runs, newest first. Unlike its sibling commands, `workflow:runs` does not
|
|
112
|
+
# accept --non-interactive. Passing it errors out with no output, which reads exactly like
|
|
113
|
+
# "no runs found". Its only flags are --json --limit --status --workflow, and a --limit above
|
|
114
|
+
# 100 errors. The date field is `startedAt`. There is no `createdAt`.
|
|
99
115
|
WF_N="${EAS_WF_N:-10}"; [ "$WF_N" -le 100 ] || WF_N=100
|
|
100
116
|
WF_FAIL_N="${EAS_WF_FAIL_N:-100}"; [ "$WF_FAIL_N" -le 100 ] || WF_FAIL_N=100
|
|
101
117
|
eas workflow:runs --json ${EAS_WF_FILE:+--workflow "$EAS_WF_FILE"} --limit "$WF_N" > "$WORK/runs.json" 2>/dev/null \
|
|
@@ -108,32 +124,33 @@ printf '===== eas workflow runs, newest %s — %s run(s) =====\n' "$WF_N" "$(jq
|
|
|
108
124
|
jq -c '.[] | {id, status, workflowName, gitCommitHash, startedAt}' "$WORK/runs.json"
|
|
109
125
|
printf '===== FAILURE runs, newest %s — %s run(s) =====\n' "$WF_FAIL_N" "$(jq length "$WORK/failures.json")"
|
|
110
126
|
jq -c '.[] | {id, workflowName, gitCommitHash, startedAt}' "$WORK/failures.json"
|
|
111
|
-
# 2) Per-run detail. `workflow:status` is the only command that yields
|
|
127
|
+
# 2) Per-run detail. `workflow:status` is the only command that yields both job ids and artifact URLs.
|
|
112
128
|
for run in $(jq -r --argjson n "${EAS_WF_ERR_N:-2}" '.[:$n][].id' "$WORK/failures.json"); do
|
|
113
129
|
echo "===== failed workflow run $run ====="
|
|
114
130
|
STATUS="$WORK/status-$run.json"
|
|
115
|
-
# `workflow:status` prints its JSON, then exits 11 FAILED
|
|
116
|
-
# the exit code
|
|
131
|
+
# `workflow:status` prints its JSON, then exits 11 for FAILED and 12 for canceled. Test the
|
|
132
|
+
# JSON, never the exit code, because an exit-code guard skips every failed run's detail.
|
|
117
133
|
eas workflow:status "$run" --json --non-interactive > "$STATUS" 2>/dev/null
|
|
118
134
|
jq -e '.id' "$STATUS" >/dev/null 2>&1 \
|
|
119
135
|
|| { echo "===== run $run: workflow:status returned no JSON — detail NOT read ====="; continue; }
|
|
120
136
|
jq -r '.jobs[]? | "job \(.id) key=\(.key // "?") \(.status)", (.turtleJobRun.errors[]? | " \(.errorCode): \(.message)")' "$STATUS"
|
|
121
|
-
# 2a) Step logs. `workflow:logs` takes the
|
|
122
|
-
# workflow job found"
|
|
123
|
-
#
|
|
137
|
+
# 2a) Step logs. `workflow:logs` takes the job id, not the run id. The run id returns "No
|
|
138
|
+
# workflow job found". --all-steps is required, because without it the command prompts for
|
|
139
|
+
# a step and hangs headless.
|
|
140
|
+
# Failed jobs only, because a passing job's log tail is noise.
|
|
124
141
|
for job in $(jq -r '.jobs[]? | select(.status=="FAILURE") | .id' "$STATUS"); do
|
|
125
142
|
eas workflow:logs "$job" --all-steps --non-interactive 2>/dev/null | tail -60
|
|
126
143
|
done
|
|
127
|
-
# 2b)
|
|
128
|
-
# stop at EAS's summary line. `allDeviceTestCaseResults.errorMessage` is the only text
|
|
129
|
-
# source
|
|
144
|
+
# 2b) The per-flow exception. Neither the GitHub job log nor the EAS job log carries it, because
|
|
145
|
+
# both stop at EAS's summary line. `allDeviceTestCaseResults.errorMessage` is the only text
|
|
146
|
+
# source, and one POST returns every flow and every retry. Read it before theorising.
|
|
130
147
|
curl -sS https://api.expo.dev/graphql \
|
|
131
148
|
-H "authorization: Bearer $EXPO_TOKEN" -H 'content-type: application/json' \
|
|
132
149
|
-d "{\"query\":\"query{workflowRuns{byId(workflowRunId:\\\"$run\\\"){id status jobs{id key status allDeviceTestCaseResults{name path status errorMessage duration retryCount}}}}}\"}" \
|
|
133
150
|
| jq -r '.data.workflowRuns.byId.jobs[]?.allDeviceTestCaseResults[]? | "----- \(.name) \(.status) attempt=\(.retryCount) \(.duration)ms\n\(.errorMessage // "(no error message)")\n"'
|
|
134
|
-
# 2c) Artifacts
|
|
135
|
-
# The merged JUnit is the per-flow verdict of record
|
|
136
|
-
# fastest read
|
|
151
|
+
# 2c) Artifacts are pre-signed (no auth header) plain files. Unlike build logs, they are not
|
|
152
|
+
# brotli-encoded. The merged JUnit is the per-flow verdict of record. Failure screenshots are
|
|
153
|
+
# often the fastest read. The block prints their URLs only, so open them in an image viewer.
|
|
137
154
|
grep -oE 'https://wf-artifacts[^"]*(junit\.xml|failure-attempt[^"]*\.png)[^"]*' "$STATUS" \
|
|
138
155
|
| while read -r u; do
|
|
139
156
|
case "$u" in
|
|
@@ -141,45 +158,45 @@ for run in $(jq -r --argjson n "${EAS_WF_ERR_N:-2}" '.[:$n][].id' "$WORK/failure
|
|
|
141
158
|
*) echo "===== failure screenshot: $u" ;;
|
|
142
159
|
esac
|
|
143
160
|
done
|
|
144
|
-
# 2d) artifacts.tar.gz
|
|
145
|
-
# XCUITest runner logs. Excluding *.logarchive* and *.mov keeps the
|
|
146
|
-
# .logarchive reads back empty with `log show --archive` anyway
|
|
147
|
-
# <flow>/logs/device-simulator.log
|
|
161
|
+
# 2d) artifacts.tar.gz holds commands.json, the screen-hierarchy dumps, the per-attempt JUnit,
|
|
162
|
+
# and the simulator and XCUITest runner logs. Excluding *.logarchive* and *.mov keeps the
|
|
163
|
+
# extraction small. The .logarchive reads back empty with `log show --archive` anyway, so
|
|
164
|
+
# use <flow>/logs/device-simulator.log, which is the same system log in plain text.
|
|
148
165
|
TARBALL=$(grep -oE 'https://wf-artifacts[^"]*artifacts\.tar\.gz[^"]*' "$STATUS" | head -1)
|
|
149
166
|
[ -n "$TARBALL" ] || continue
|
|
150
167
|
DEST="$WORK/artifacts-$run"
|
|
151
168
|
mkdir -p "$DEST"
|
|
152
169
|
curl -sS "$TARBALL" \
|
|
153
170
|
| tar -xz -C "$DEST" --exclude='*.logarchive*' --exclude='*.mov' 2>/dev/null || true
|
|
154
|
-
# commands.json
|
|
171
|
+
# commands.json holds every Maestro step with its status, its duration and the full error.message.
|
|
155
172
|
find "$DEST" -name commands.json 2>/dev/null | while read -r c; do
|
|
156
173
|
echo "===== failing steps: ${c#"$DEST"/} ====="
|
|
157
174
|
jq -r '.[]? | select(.error != null or (.status // "") == "FAILED")
|
|
158
175
|
| " \(.command // .name // "?") [\(.status // "?")] \(.error.message // "")"' "$c" 2>/dev/null
|
|
159
176
|
done
|
|
160
|
-
# View-hierarchy dumps are large
|
|
161
|
-
# so the failing step's dump
|
|
177
|
+
# View-hierarchy dumps are large, so the block lists them with their sizes. Each is named
|
|
178
|
+
# step-NNN-<command>-<selector>.json, so the name identifies the failing step's dump. Cat that one.
|
|
162
179
|
echo "===== screen-hierarchy dumps (cat the one matching the failing step) ====="
|
|
163
180
|
find "$DEST" -path '*screen-hierarchy*' -name '*.json' -exec ls -lh {} \; 2>/dev/null \
|
|
164
181
|
| awk '{print " " $5 " " $NF}'
|
|
165
|
-
# Per-
|
|
182
|
+
# Per-attempt JUnit. The merged JUnit above hides a flow that failed and then passed on retry.
|
|
166
183
|
find "$DEST" -path '*junit-reports*' -name '*.xml' 2>/dev/null | sort | head -n 20 \
|
|
167
184
|
| while read -r j; do
|
|
168
185
|
echo "===== $(basename "$j") (first ${EAS_JUNIT_N:-300} lines) ====="
|
|
169
186
|
tr -d '\r' < "$j" | head -n "${EAS_JUNIT_N:-300}"
|
|
170
187
|
done
|
|
171
|
-
# 2e)
|
|
172
|
-
# xctest_runner_*.log names the cause
|
|
173
|
-
# symptom shared by several faults, not a diagnosis.
|
|
188
|
+
# 2e) Why the driver died. For any DeviceUnreachableException, read this after the per-flow
|
|
189
|
+
# exception (2b). An `error:` line in xctest_runner_*.log names the cause, and neither job
|
|
190
|
+
# log does. A device-unreachable sweep is a symptom shared by several faults, not a diagnosis.
|
|
174
191
|
echo "===== XCUITest runner: the driver's own failure ====="
|
|
175
192
|
find "$DEST" -name 'xctest_runner_*.log' 2>/dev/null | while read -r r; do
|
|
176
193
|
grep -nE 'error:|TEST EXECUTE FAILED|Test Suite .* failed|failed \(' "$r" | tail -25
|
|
177
194
|
done
|
|
178
|
-
# 2f)
|
|
179
|
-
# com.facebook.react.log, category javascript
|
|
180
|
-
# install / launch chatter and no JS. console.error persists on every run
|
|
181
|
-
# console.log need a `log config --subsystem com.facebook.react.log` step
|
|
182
|
-
# so a low count
|
|
195
|
+
# 2f) The app's own JS console (React Native). RN logs under the framework's os_log subsystem
|
|
196
|
+
# com.facebook.react.log, category javascript. It does not log under the app's bundle id,
|
|
197
|
+
# which returns OS install / launch chatter and no JS. console.error persists on every run.
|
|
198
|
+
# console.warn / console.log need a `log config --subsystem com.facebook.react.log` step
|
|
199
|
+
# before the tests, so without that step a low count is a closed channel, not a quiet app.
|
|
183
200
|
echo "===== app JS console per flow (count, then the lines) ====="
|
|
184
201
|
find "$DEST" -name device-simulator.log 2>/dev/null | while read -r sl; do
|
|
185
202
|
echo " $(grep -c 'com\.facebook\.react\.log:javascript' "$sl") $sl"
|
|
@@ -198,7 +215,8 @@ done
|
|
|
198
215
|
<!-- context-fetch:provision expo-workflows -->
|
|
199
216
|
|
|
200
217
|
```bash
|
|
201
|
-
# Install eas-cli in cloud if absent
|
|
218
|
+
# Install eas-cli in cloud if it is absent. The block guards itself and does nothing when the CLI
|
|
219
|
+
# is present.
|
|
202
220
|
command -v eas >/dev/null 2>&1 || pnpm add -g eas-cli
|
|
203
221
|
```
|
|
204
222
|
|
|
@@ -3,13 +3,20 @@
|
|
|
3
3
|
|
|
4
4
|
# GitHub Actions — failing CI run and diff since the last green run
|
|
5
5
|
|
|
6
|
-
Fits: any repo whose CI runs on GitHub Actions.
|
|
6
|
+
Fits: any repo whose CI runs on GitHub Actions.
|
|
7
7
|
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
8
|
+
- The `context=ci` block reads the selected run and attempt, then returns bounded logs for every failed job. Without a selection it discovers the configured workflow's latest completed run on the current branch.
|
|
9
|
+
- The `context=diff` block compares the selected failing commit with an ancestral successful commit of the same workflow on the baseline branch. Without a selection it compares the configured workflow's last successful commit with `HEAD`.
|
|
10
|
+
|
|
11
|
+
The settings:
|
|
12
|
+
|
|
13
|
+
- Secret: `GH_TOKEN` in cloud. A local `gh auth login` works too.
|
|
14
|
+
- Optional inputs: `BKIT_CI_RUN_ID`, `BKIT_CI_RUN_ATTEMPT`, `BKIT_CI_REPO` and `BKIT_CI_HEAD_SHA`, supplied together by `context fetch --ci-selection-file`.
|
|
15
|
+
- Workflow: `package.json` `bkit.testing.ciWorkflow`; `BASELINE_WORKFLOW` may override the unpinned diff selector.
|
|
16
|
+
- Baseline branch: `BASELINE_BRANCH` (default `dev`). Commit your trunk selector in the copied block so cloud agents inherit it.
|
|
17
|
+
- CLI: `gh`. It is base tooling, so there is no provision block.
|
|
11
18
|
- Domains: none beyond bkit's derived set (`github.com`).
|
|
12
|
-
-
|
|
19
|
+
- The diff needs both commits locally. Missing history or an unavailable baseline is reported as unchecked evidence.
|
|
13
20
|
|
|
14
21
|
Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The blocks are independent: copy one or both.
|
|
15
22
|
|
|
@@ -18,49 +25,55 @@ Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`. The
|
|
|
18
25
|
<!-- context-fetch:start github context=ci -->
|
|
19
26
|
|
|
20
27
|
```bash
|
|
21
|
-
# GitHub Actions:
|
|
22
|
-
#
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
gh auth status >/dev/null 2>&1
|
|
27
|
-
|| { echo "[context-fetch:github] skipped — gh not authenticated (set GH_TOKEN)" >&2; exit 0; }
|
|
28
|
-
RUN_JSON=$(gh run list --branch "$(git branch --show-current)" --limit 1 \
|
|
29
|
-
--json databaseId,conclusion,headSha 2>/dev/null || echo '[]')
|
|
30
|
-
RUN_ID=$(printf '%s' "$RUN_JSON" | jq -r '.[0].databaseId // ""')
|
|
31
|
-
RUN_SHA=$(printf '%s' "$RUN_JSON" | jq -r '.[0].headSha // ""')
|
|
32
|
-
RUN_CONCLUSION=$(printf '%s' "$RUN_JSON" | jq -r '.[0].conclusion // ""')
|
|
33
|
-
[ -n "$RUN_ID" ] \
|
|
34
|
-
|| { echo "[context-fetch:github] skipped — no CI run found for this branch" >&2; exit 0; }
|
|
35
|
-
[ "$RUN_CONCLUSION" != "success" ] \
|
|
36
|
-
|| { echo "[context-fetch:github] skipped — run $RUN_ID concluded success (nothing failing to fetch)" >&2; exit 0; }
|
|
37
|
-
FAILED_STEPS=$(gh run view "$RUN_ID" --json conclusion,jobs \
|
|
38
|
-
--jq '[.jobs[] | select(.conclusion=="failure") | {job: .name, steps: [.steps[] | select(.conclusion=="failure") | .name]}]' 2>/dev/null)
|
|
39
|
-
# Failed-step logs, one tail-bounded section per failed job, so a second failing job keeps its
|
|
40
|
-
# lines. Raise CI_LOG_TAIL if the cause sits higher in a job's log.
|
|
28
|
+
# GitHub Actions: selected-attempt metadata and bounded logs of every failed job.
|
|
29
|
+
# Customise: CI_LOG_TAIL (lines kept per failed job); configured workflow; job/step filters.
|
|
30
|
+
set -o pipefail
|
|
31
|
+
skip() { echo "[context-fetch:github] skipped — $*" >&2; exit 0; }
|
|
32
|
+
command -v gh >/dev/null 2>&1 || skip "gh CLI not installed"
|
|
33
|
+
gh auth status >/dev/null 2>&1 || skip "gh not authenticated (set GH_TOKEN)"
|
|
41
34
|
CI_LOG_TAIL=2000
|
|
42
|
-
|
|
43
|
-
|
|
35
|
+
RUN_ID="${BKIT_CI_RUN_ID:-}"
|
|
36
|
+
RUN_ATTEMPT="${BKIT_CI_RUN_ATTEMPT:-}"
|
|
37
|
+
RUN_REPO="${BKIT_CI_REPO:-}"
|
|
38
|
+
if [ -z "$RUN_ID" ]; then
|
|
39
|
+
CI_WORKFLOW=$(node -p 'require(process.cwd()+"/package.json").bkit?.testing?.ciWorkflow || ""' 2>/dev/null) || skip "workflow configuration unavailable"
|
|
40
|
+
[ -n "$CI_WORKFLOW" ] || skip "no configured CI workflow"
|
|
41
|
+
RUN_LIST=$(gh run list --workflow "$CI_WORKFLOW" --branch "$(git branch --show-current)" --status completed --limit 1 --json databaseId,attempt 2>/dev/null) || skip "CI discovery unavailable"
|
|
42
|
+
RUN_ID=$(printf '%s' "$RUN_LIST" | jq -er '.[0].databaseId | select(type=="number" and .>0)') || skip "no completed CI run found"
|
|
43
|
+
RUN_ATTEMPT=$(printf '%s' "$RUN_LIST" | jq -er '.[0].attempt | select(type=="number" and .>0)') || skip "run attempt unavailable"
|
|
44
|
+
RUN_REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner' 2>/dev/null) || skip "repository identity unavailable"
|
|
45
|
+
fi
|
|
46
|
+
printf '%s\n' "$RUN_ID" "$RUN_ATTEMPT" | command grep -Eqv '^[1-9][0-9]*$' && skip "invalid selected run or attempt"
|
|
47
|
+
printf '%s' "$RUN_REPO" | command grep -Eq '^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$' || skip "invalid selected repository"
|
|
48
|
+
RUN_META=$(gh api "/repos/$RUN_REPO/actions/runs/$RUN_ID/attempts/$RUN_ATTEMPT" 2>/dev/null) || skip "selected run metadata unavailable"
|
|
49
|
+
printf '%s' "$RUN_META" | jq -e --arg id "$RUN_ID" --argjson attempt "$RUN_ATTEMPT" --arg repo "$RUN_REPO" --arg sha "${BKIT_CI_HEAD_SHA:-}" '
|
|
50
|
+
(.id|tostring)==$id and .run_attempt==$attempt and .repository.full_name==$repo and .head_repository.full_name==$repo
|
|
51
|
+
and (.head_sha|test("^([0-9a-f]{40}|[0-9a-f]{64})$")) and ($sha=="" or .head_sha==$sha)
|
|
52
|
+
and (.workflow_id|type=="number" and .>0) and .status=="completed"
|
|
53
|
+
and (.conclusion=="failure" or .conclusion=="timed_out" or .conclusion=="startup_failure")' >/dev/null || skip "selected run identity or failure does not match"
|
|
54
|
+
RUN_SHA=$(printf '%s' "$RUN_META" | jq -r '.head_sha')
|
|
55
|
+
WORKFLOW_ID=$(printf '%s' "$RUN_META" | jq -r '.workflow_id')
|
|
56
|
+
JOB_PAGES=$(gh api "/repos/$RUN_REPO/actions/runs/$RUN_ID/attempts/$RUN_ATTEMPT/jobs?per_page=100" --paginate --slurp 2>/dev/null) || skip "selected job pages unavailable"
|
|
57
|
+
printf '%s' "$JOB_PAGES" | jq -e '
|
|
58
|
+
type=="array" and length>0 and all(.[]; (.total_count|type=="number" and .>=0 and floor==.) and (.jobs|type=="array"))
|
|
59
|
+
and ([.[].total_count]|unique|length)==1 and ([.[].jobs[]]|length)==.[0].total_count
|
|
60
|
+
and ([.[].jobs[].id]|unique|length)==.[0].total_count' >/dev/null || skip "selected job pages incomplete"
|
|
61
|
+
FAILED_JOBS=$(printf '%s' "$JOB_PAGES" | jq -r '.[].jobs[] | select(.conclusion=="failure" or .conclusion=="timed_out" or .conclusion=="startup_failure") | [.id,.name] | @tsv') || skip "failed job list unavailable"
|
|
62
|
+
[ -n "$FAILED_JOBS" ] || skip "no failed job logs available"
|
|
44
63
|
CI_LOGS=""
|
|
45
64
|
TAB=$(printf '\t')
|
|
46
65
|
while IFS="$TAB" read -r JOB JOB_NAME; do
|
|
47
|
-
|
|
48
|
-
JOB_LOG=$(gh run view "$RUN_ID" --job "$JOB" --log-failed 2>/dev/null | tail -n "$CI_LOG_TAIL")
|
|
49
|
-
[ -n "$JOB_LOG" ]
|
|
66
|
+
printf '%s' "$JOB" | command grep -Eq '^[1-9][0-9]*$' || skip "invalid failed job identity"
|
|
67
|
+
JOB_LOG=$(gh run view "$RUN_ID" --repo "$RUN_REPO" --attempt "$RUN_ATTEMPT" --job "$JOB" --log-failed 2>/dev/null | tail -n "$CI_LOG_TAIL") || skip "selected job log unavailable"
|
|
68
|
+
[ -n "$JOB_LOG" ] || skip "selected job log empty"
|
|
69
|
+
CI_LOGS="${CI_LOGS}===== job ${JOB_NAME} =====
|
|
50
70
|
${JOB_LOG}
|
|
51
71
|
"
|
|
52
72
|
done <<EOF_JOBS
|
|
53
73
|
$FAILED_JOBS
|
|
54
74
|
EOF_JOBS
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
[ -n "$CI_LOGS" ] \
|
|
58
|
-
|| { echo "[context-fetch:github] skipped — no logs returned for run $RUN_ID" >&2; exit 0; }
|
|
59
|
-
ERR_SUBSET=$(printf '%s' "$CI_LOGS" | grep -E '##\[error\]|::error' 2>/dev/null)
|
|
60
|
-
printf '===== run %s (headSha %s, conclusion %s) =====\n\n' "$RUN_ID" "${RUN_SHA:-unknown}" "$RUN_CONCLUSION"
|
|
61
|
-
printf '===== failed jobs/steps =====\n%s\n\n' "${FAILED_STEPS:-[]}"
|
|
62
|
-
[ -n "$ERR_SUBSET" ] && printf '===== error annotations =====\n%s\n\n' "$ERR_SUBSET"
|
|
63
|
-
printf '===== failed-step logs =====\n%s\n' "$CI_LOGS"
|
|
75
|
+
jq -cn --arg repo "$RUN_REPO" --arg runId "$RUN_ID" --argjson runAttempt "$RUN_ATTEMPT" --arg headSha "$RUN_SHA" --arg workflowId "$WORKFLOW_ID" '{provider:"github",repo:$repo,runId:$runId,runAttempt:$runAttempt,headSha:$headSha,workflowId:$workflowId,complete:true}' | sed 's/^/bkit-ci-evidence: /'
|
|
76
|
+
printf '===== run %s attempt %s (headSha %s) =====\n%s\n' "$RUN_ID" "$RUN_ATTEMPT" "$RUN_SHA" "$CI_LOGS"
|
|
64
77
|
```
|
|
65
78
|
|
|
66
79
|
<!-- context-fetch:end -->
|
|
@@ -70,24 +83,48 @@ printf '===== failed-step logs =====\n%s\n' "$CI_LOGS"
|
|
|
70
83
|
<!-- context-fetch:start github context=diff -->
|
|
71
84
|
|
|
72
85
|
```bash
|
|
73
|
-
# GitHub Actions:
|
|
74
|
-
#
|
|
75
|
-
|
|
86
|
+
# GitHub Actions: ancestral successful baseline to the selected failing commit.
|
|
87
|
+
# Customise: BASELINE_BRANCH; last-passing --limit; DIFF_STAT_N (files listed).
|
|
88
|
+
set -o pipefail
|
|
89
|
+
skip() { echo "[context-fetch:github] skipped — $*" >&2; exit 0; }
|
|
76
90
|
BASELINE_BRANCH="${BASELINE_BRANCH:-dev}"
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
printf '
|
|
90
|
-
|
|
91
|
+
command -v gh >/dev/null 2>&1 || skip "gh CLI not installed"
|
|
92
|
+
RUN_ID="${BKIT_CI_RUN_ID:-}"
|
|
93
|
+
END_SHA=HEAD
|
|
94
|
+
if [ -n "$RUN_ID" ]; then
|
|
95
|
+
RUN_ATTEMPT="${BKIT_CI_RUN_ATTEMPT:-}"
|
|
96
|
+
RUN_REPO="${BKIT_CI_REPO:-}"
|
|
97
|
+
printf '%s\n' "$RUN_ID" "$RUN_ATTEMPT" | command grep -Eqv '^[1-9][0-9]*$' && skip "invalid selected run or attempt"
|
|
98
|
+
printf '%s' "$RUN_REPO" | command grep -Eq '^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$' || skip "invalid selected repository"
|
|
99
|
+
RUN_META=$(gh api "/repos/$RUN_REPO/actions/runs/$RUN_ID/attempts/$RUN_ATTEMPT" 2>/dev/null) || skip "selected baseline metadata unavailable"
|
|
100
|
+
printf '%s' "$RUN_META" | jq -e --arg id "$RUN_ID" --argjson attempt "$RUN_ATTEMPT" --arg repo "$RUN_REPO" --arg sha "${BKIT_CI_HEAD_SHA:-}" '
|
|
101
|
+
(.id|tostring)==$id and .run_attempt==$attempt and .repository.full_name==$repo and .head_repository.full_name==$repo
|
|
102
|
+
and .head_sha==$sha and (.workflow_id|type=="number" and .>0) and (.created_at|type=="string")' >/dev/null || skip "selected diff identity does not match"
|
|
103
|
+
END_SHA=$(printf '%s' "$RUN_META" | jq -r '.head_sha')
|
|
104
|
+
BASELINE_WORKFLOW=$(printf '%s' "$RUN_META" | jq -r '.workflow_id')
|
|
105
|
+
FAIL_TIME=$(printf '%s' "$RUN_META" | jq -r '.created_at')
|
|
106
|
+
BASELINES=$(gh run list --repo "$RUN_REPO" --branch "$BASELINE_BRANCH" --workflow "$BASELINE_WORKFLOW" --status success --limit 100 --json headSha,createdAt,workflowDatabaseId 2>/dev/null) || skip "successful baseline lookup unavailable"
|
|
107
|
+
CANDIDATES=$(printf '%s' "$BASELINES" | jq -r --arg before "$FAIL_TIME" --arg workflow "$BASELINE_WORKFLOW" '[.[] | select(.createdAt<=$before and (.workflowDatabaseId|tostring)==$workflow)] | sort_by(.createdAt) | reverse | .[].headSha') || skip "baseline response unavailable"
|
|
108
|
+
else
|
|
109
|
+
BASELINE_WORKFLOW="${BASELINE_WORKFLOW:-}"
|
|
110
|
+
if [ -z "$BASELINE_WORKFLOW" ]; then
|
|
111
|
+
BASELINE_WORKFLOW=$(node -p 'require(process.cwd()+"/package.json").bkit?.testing?.ciWorkflow || ""' 2>/dev/null) || skip "workflow configuration unavailable"
|
|
112
|
+
fi
|
|
113
|
+
[ -n "$BASELINE_WORKFLOW" ] || skip "no configured baseline workflow"
|
|
114
|
+
CANDIDATES=$(gh run list --branch "$BASELINE_BRANCH" --workflow "$BASELINE_WORKFLOW" --status success --limit 100 --json headSha --jq '.[].headSha' 2>/dev/null) || skip "successful baseline lookup unavailable"
|
|
115
|
+
fi
|
|
116
|
+
git cat-file -e "${END_SHA}^{commit}" 2>/dev/null || skip "selected commit unavailable in local history"
|
|
117
|
+
LAST_PASS_SHA=""
|
|
118
|
+
while IFS= read -r CANDIDATE; do
|
|
119
|
+
printf '%s' "$CANDIDATE" | command grep -Eq '^([0-9a-f]{40}|[0-9a-f]{64})$' || continue
|
|
120
|
+
if git merge-base --is-ancestor "$CANDIDATE" "$END_SHA" 2>/dev/null; then LAST_PASS_SHA="$CANDIDATE"; break; fi
|
|
121
|
+
done <<EOF_BASELINES
|
|
122
|
+
$CANDIDATES
|
|
123
|
+
EOF_BASELINES
|
|
124
|
+
[ -n "$LAST_PASS_SHA" ] || skip "ancestral same-workflow baseline unavailable in the inspected window"
|
|
125
|
+
DIFF_STAT=$(git diff "$LAST_PASS_SHA..$END_SHA" --stat --stat-count="${DIFF_STAT_N:-200}" 2>/dev/null) || skip "selected diff unavailable"
|
|
126
|
+
[ -n "$DIFF_STAT" ] || skip "no diff from baseline to selected commit"
|
|
127
|
+
printf '===== diff baseline %s to selected commit %s =====\n%s\n' "$LAST_PASS_SHA" "$END_SHA" "$DIFF_STAT"
|
|
91
128
|
```
|
|
92
129
|
|
|
93
130
|
<!-- context-fetch:end -->
|
|
@@ -3,28 +3,34 @@
|
|
|
3
3
|
|
|
4
4
|
# Inngest — failed function runs
|
|
5
5
|
|
|
6
|
-
Fits: apps running durable functions on Inngest Cloud. `context=runtime
|
|
6
|
+
Fits: apps running durable functions on Inngest Cloud. The `context=runtime` block pages through the `inngest/function.failed` system events in a time window (default the last 4 h). It returns a count per day and function, then the newest events with their function id, run id, error class and the opaque `*Id` keys of the triggering event. It never returns the error message, because the message can carry secrets.
|
|
7
7
|
|
|
8
|
-
- Secret: `INNGEST_SIGNING_KEY
|
|
9
|
-
- Non-secret: `SINCE_ISO` / `UNTIL_ISO
|
|
10
|
-
-
|
|
11
|
-
-
|
|
8
|
+
- Secret: `INNGEST_SIGNING_KEY`. Reuse the app's existing key. The key is scoped to one environment: branch environments and production have separate keys. Use the key whose runs you want.
|
|
9
|
+
- Non-secret: `SINCE_ISO` / `UNTIL_ISO`, the window (default the last 4 h). The API on its own looks back only 1 h.
|
|
10
|
+
- Non-secret: `INNGEST_ENV`, the branch environment name. It is required with a branch key and ignored otherwise.
|
|
11
|
+
- Non-secret: `INNGEST_N`, the number of newest events listed (default 25).
|
|
12
|
+
- Non-secret: `INNGEST_MAX_PAGES`, the number of pages of up to 51 events each (default 40).
|
|
13
|
+
- CLI: none (`curl` and `jq`), so there is no provision block.
|
|
14
|
+
- PII: the projection keeps only the keys ending in `Id` from the triggering event's data. Keep free text and personal data out of the `*Id` keys in your event payloads, or narrow the projection.
|
|
12
15
|
|
|
13
16
|
Copy the blocks below into `.agents/context.md`, below `<!-- bkit:end -->`.
|
|
14
17
|
|
|
15
18
|
<!-- context-fetch:start inngest context=runtime -->
|
|
16
19
|
|
|
17
20
|
```bash
|
|
18
|
-
# Inngest Cloud
|
|
19
|
-
# INNGEST_SIGNING_KEY is
|
|
20
|
-
# runs you want.
|
|
21
|
-
#
|
|
22
|
-
#
|
|
23
|
-
#
|
|
24
|
-
#
|
|
25
|
-
#
|
|
26
|
-
#
|
|
27
|
-
#
|
|
21
|
+
# Inngest Cloud: failed durable-function runs that exhausted their retries (read-only).
|
|
22
|
+
# INNGEST_SIGNING_KEY is scoped to one environment (a branch env or production). Use the key for
|
|
23
|
+
# the env whose runs you want. A branch key (`signkey-branch-…`) reads the env named in the header
|
|
24
|
+
# `x-inngest-env`. Without that header the API reads the env `branch` and returns nothing, so the
|
|
25
|
+
# block refuses a branch key while INNGEST_ENV is unset.
|
|
26
|
+
# The block lists `inngest/function.failed` events from received_after, paged by
|
|
27
|
+
# cursor=<last internal_id>. Pages stop at 51 events whatever `limit` says. The API's default
|
|
28
|
+
# window is 1 h.
|
|
29
|
+
# A non-200 first page → `skipped`. A failed later page or the page cap → a TRUNCATED line.
|
|
30
|
+
# The block NEVER prints `.data.error.message` / `.stack`, because error strings can carry
|
|
31
|
+
# secrets from request headers or URLs. It prints the function id, run id, time, error class
|
|
32
|
+
# (`.data.error.name`, printed only when it is shaped like a class name) and only the /Id$/ keys
|
|
33
|
+
# from the triggering event.
|
|
28
34
|
# Customise: INNGEST_ENV (branch environment name, with a branch key); SINCE_ISO / UNTIL_ISO (window, default last 4 h); INNGEST_N (newest events listed); INNGEST_MAX_PAGES (x 51 events); the ids projection (narrow it if any *Id key in your events carries PII). Positive control (suggested): run once over a window holding a run the dashboard shows Failed; nothing back = reader broken, not clean.
|
|
29
35
|
[ -n "${INNGEST_SIGNING_KEY:-}" ] \
|
|
30
36
|
|| { echo "[context-fetch:inngest] skipped — INNGEST_SIGNING_KEY unset" >&2; exit 0; }
|