@cbartens/bkit 5.5.1 → 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 +167 -154
- package/.bkit/core/.agents/context.md +95 -29
- package/.bkit/core/.agents/docs.md +18 -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 +112 -102
- package/.bkit/core/.agents/skills.md +63 -15
- package/.bkit/core/.bkit/README.md +167 -154
- package/.bkit/core/.bkit/authoring.md +747 -0
- package/.bkit/core/.bkit/cli.md +407 -0
- package/.bkit/core/.bkit/cloud.md +283 -195
- package/.bkit/core/.bkit/comparison.md +45 -43
- package/.bkit/core/.bkit/install.md +166 -95
- package/.bkit/core/.bkit/jsonl.md +339 -196
- package/.bkit/core/.bkit/pipeline.md +142 -145
- package/.bkit/core/.bkit/prompts.md +295 -264
- package/.bkit/core/.bkit/providers.md +460 -277
- package/.bkit/core/.bkit/router.md +69 -0
- package/.bkit/core/.bkit/templates.md +530 -256
- package/.bkit/core/.bkit/trackers.md +116 -65
- package/.bkit/core/.bkit/workflows.md +742 -618
- 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 +6 -80
- package/.bkit/core/docs/templates/bkit-audit-accessibility.md +128 -130
- package/.bkit/core/docs/templates/bkit-audit-adoption.md +104 -94
- package/.bkit/core/docs/templates/bkit-audit-agents.md +96 -98
- package/.bkit/core/docs/templates/bkit-audit-aio-seo.md +100 -103
- package/.bkit/core/docs/templates/bkit-audit-analytics.md +141 -107
- package/.bkit/core/docs/templates/bkit-audit-annotations.md +99 -97
- package/.bkit/core/docs/templates/bkit-audit-app-performance.md +122 -121
- package/.bkit/core/docs/templates/bkit-audit-app-store.md +158 -101
- package/.bkit/core/docs/templates/bkit-audit-architecture.md +114 -96
- package/.bkit/core/docs/templates/bkit-audit-ci-performance.md +76 -97
- package/.bkit/core/docs/templates/bkit-audit-config.md +123 -101
- package/.bkit/core/docs/templates/bkit-audit-cost.md +86 -99
- package/.bkit/core/docs/templates/bkit-audit-coverage.md +76 -93
- package/.bkit/core/docs/templates/bkit-audit-database.md +102 -95
- package/.bkit/core/docs/templates/bkit-audit-dead-code.md +165 -108
- package/.bkit/core/docs/templates/bkit-audit-deferrals.md +115 -109
- package/.bkit/core/docs/templates/bkit-audit-dependencies.md +265 -113
- package/.bkit/core/docs/templates/bkit-audit-documentation.md +119 -118
- package/.bkit/core/docs/templates/bkit-audit-duplication.md +140 -111
- package/.bkit/core/docs/templates/bkit-audit-failures.md +111 -106
- package/.bkit/core/docs/templates/bkit-audit-flakes.md +100 -99
- package/.bkit/core/docs/templates/bkit-audit-gates.md +107 -103
- package/.bkit/core/docs/templates/bkit-audit-issues.md +105 -105
- package/.bkit/core/docs/templates/bkit-audit-llm.md +134 -85
- package/.bkit/core/docs/templates/bkit-audit-logs.md +124 -125
- package/.bkit/core/docs/templates/bkit-audit-models.md +99 -78
- package/.bkit/core/docs/templates/bkit-audit-privacy.md +56 -76
- package/.bkit/core/docs/templates/bkit-audit-prompts.md +63 -78
- package/.bkit/core/docs/templates/bkit-audit-red-team.md +125 -93
- package/.bkit/core/docs/templates/bkit-audit-reliability.md +97 -96
- package/.bkit/core/docs/templates/bkit-audit-repo.md +170 -98
- package/.bkit/core/docs/templates/bkit-audit-security.md +207 -121
- package/.bkit/core/docs/templates/bkit-audit-slop.md +78 -95
- package/.bkit/core/docs/templates/bkit-audit-testing.md +163 -139
- package/.bkit/core/docs/templates/bkit-audit-usability.md +114 -96
- package/.bkit/core/docs/templates/bkit-plan.md +158 -281
- package/.bkit/core/engine/checks/after/auth.ts +40 -37
- package/.bkit/core/engine/checks/after/ci-yml.ts +104 -31
- package/.bkit/core/engine/checks/after/github.ts +95 -17
- package/.bkit/core/engine/checks/after/index.ts +21 -8
- package/.bkit/core/engine/checks/after/suppression.ts +8 -5
- package/.bkit/core/engine/checks/after/tools.ts +125 -123
- package/.bkit/core/engine/checks/before/context-fetch.ts +227 -33
- package/.bkit/core/engine/checks/before/env.ts +3 -3
- package/.bkit/core/engine/checks/before/files.ts +5 -4
- package/.bkit/core/engine/checks/before/index.ts +25 -1
- package/.bkit/core/engine/checks/before/repo.ts +208 -2
- package/.bkit/core/engine/checks/status-holes.ts +916 -123
- package/.bkit/core/engine/checks/tips/catalogue.ts +82 -20
- package/.bkit/core/engine/checks/tips/detect.ts +66 -0
- package/.bkit/core/engine/checks/tips/index.ts +52 -11
- package/.bkit/core/engine/cli.ts +251 -130
- package/.bkit/core/engine/commands/analysis.ts +282 -199
- 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/comply.ts +77 -103
- package/.bkit/core/engine/commands/install/doctor.ts +2 -2
- package/.bkit/core/engine/commands/install/install.ts +57 -18
- package/.bkit/core/engine/commands/install/uninstall.ts +86 -55
- package/.bkit/core/engine/commands/install/upgrade.ts +32 -15
- package/.bkit/core/engine/commands/land.ts +139 -18
- package/.bkit/core/engine/commands/lib.ts +381 -22
- package/.bkit/core/engine/commands/registry.ts +10 -2
- package/.bkit/core/engine/commands/setup/setup.ts +8 -7
- package/.bkit/core/engine/commands/stats.ts +260 -0
- package/.bkit/core/engine/commands/tips.ts +10 -5
- package/.bkit/core/engine/commands/workflow/branches.ts +2215 -176
- package/.bkit/core/engine/commands/workflow/challenge.ts +748 -0
- package/.bkit/core/engine/commands/workflow/completeness.ts +109 -0
- package/.bkit/core/engine/commands/workflow/context.ts +1249 -47
- package/.bkit/core/engine/commands/workflow/counters.ts +483 -95
- package/.bkit/core/engine/commands/workflow/decisions.ts +585 -0
- package/.bkit/core/engine/commands/workflow/disk.ts +238 -56
- package/.bkit/core/engine/commands/workflow/fids.ts +811 -33
- package/.bkit/core/engine/commands/workflow/issues.ts +413 -64
- package/.bkit/core/engine/commands/workflow/ledgers.ts +1333 -36
- package/.bkit/core/engine/commands/workflow/locks.ts +28 -2
- package/.bkit/core/engine/commands/workflow/plan-blocks.ts +691 -0
- package/.bkit/core/engine/commands/workflow/plan-versions.ts +21 -0
- package/.bkit/core/engine/commands/workflow/plans.ts +257 -0
- package/.bkit/core/engine/commands/workflow/prs.ts +178 -33
- package/.bkit/core/engine/commands/workflow/repo.ts +66 -8
- package/.bkit/core/engine/commands/workflow/roadmap.ts +72 -22
- package/.bkit/core/engine/commands/workflow/run-facts.ts +492 -0
- package/.bkit/core/engine/commands/workflow/runs.ts +827 -79
- package/.bkit/core/engine/commands/workflow/runtime.ts +25 -1
- package/.bkit/core/engine/commands/workflow/skills.ts +1 -0
- package/.bkit/core/engine/commands/workflow/status.ts +329 -33
- package/.bkit/core/engine/commands/workflow/step-table.ts +381 -0
- package/.bkit/core/engine/commands/workflow/steps.ts +841 -105
- package/.bkit/core/engine/commands/workflow/summary-findings.ts +177 -0
- package/.bkit/core/engine/commands/workflow/summary.ts +544 -0
- 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 +2124 -330
- package/.bkit/core/engine/commands/workflow/tracker.ts +1195 -0
- package/.bkit/core/engine/commands/workflow/workflows.ts +1197 -235
- package/.bkit/core/engine/commands/workflow/worktrees.ts +543 -24
- 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 +67 -17
- package/.bkit/core/engine/install/modules/antigravity.ts +3 -2
- package/.bkit/core/engine/install/modules/cloud.ts +24 -16
- package/.bkit/core/engine/install/modules/codex.ts +15 -2
- package/.bkit/core/engine/install/modules/core.ts +1196 -45
- package/.bkit/core/engine/install/modules/cursor.ts +6 -6
- package/.bkit/core/engine/install/modules/opencode.ts +18 -6
- package/.bkit/core/engine/install/template-notes.ts +130 -0
- package/.bkit/core/engine/install/version-file.ts +9 -4
- 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/migrate.ts +92 -0
- package/.bkit/core/engine/ledgers/status.ts +249 -21
- package/.bkit/core/engine/ledgers/telemetry.ts +1397 -253
- package/.bkit/core/engine/render/hosts.ts +118 -14
- package/.bkit/core/engine/render/models.ts +12 -0
- package/.bkit/core/engine/shared/bkit-latest.ts +26 -4
- package/.bkit/core/engine/shared/branches.ts +4 -1
- package/.bkit/core/engine/shared/dep-updater.ts +60 -0
- package/.bkit/core/engine/shared/egress.ts +8 -1
- package/.bkit/core/engine/shared/json.ts +25 -7
- package/.bkit/core/engine/shared/package-manager.ts +9 -0
- package/.bkit/core/engine/shared/settings.ts +243 -31
- package/.bkit/core/engine/shared/text.ts +361 -0
- 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 +215 -0
- package/.bkit/core/engine/tools/instructions-sources.ts +832 -0
- package/.bkit/core/engine/tools/instructions.ts +1802 -0
- package/.bkit/core/hooks/antigravity-hook.js +25 -10
- package/.bkit/core/hooks/gateguard-engine.js +54 -29
- package/.bkit/core/hooks/guardrails-shell.js +4 -5
- package/.bkit/core/hooks/guardrails-tiers.js +10 -4
- 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 +202 -94
- package/.bkit/core/prompts/bkit-build-challenge-1.md +76 -34
- package/.bkit/core/prompts/bkit-build-challenge-2.md +85 -38
- package/.bkit/core/prompts/bkit-build-install-skills.md +50 -28
- package/.bkit/core/prompts/bkit-build-plan-convert.md +85 -0
- package/.bkit/core/prompts/bkit-build-plan-current.md +59 -36
- package/.bkit/core/prompts/bkit-build-plan-gaps-remediate.md +101 -36
- 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 +104 -43
- package/.bkit/core/prompts/bkit-debug-abort-handover.md +47 -32
- package/.bkit/core/prompts/bkit-debug-failure-diagnose.md +109 -57
- package/.bkit/core/prompts/bkit-debug-failure-remediate.md +65 -39
- package/.bkit/core/prompts/bkit-debug-failure-reproduce.md +53 -31
- package/.bkit/core/prompts/bkit-debug-failure-soak.md +65 -34
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-1.md +46 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-2.md +45 -31
- package/.bkit/core/prompts/bkit-design-brainstorm-ideate-3.md +43 -30
- package/.bkit/core/prompts/bkit-design-generate.md +80 -46
- package/.bkit/core/prompts/bkit-design-organise.md +83 -32
- package/.bkit/core/prompts/bkit-design-review-1.md +70 -50
- package/.bkit/core/prompts/bkit-design-review-2.md +65 -46
- package/.bkit/core/prompts/bkit-design-spike.md +64 -40
- package/.bkit/core/prompts/bkit-design-update.md +53 -28
- package/.bkit/core/prompts/bkit-plan-generate.md +101 -29
- package/.bkit/core/prompts/bkit-plan-review-1.md +78 -41
- package/.bkit/core/prompts/bkit-plan-review-2.md +78 -35
- package/.bkit/core/prompts/bkit-plan-scope-check.md +116 -0
- package/.bkit/core/prompts/bkit-plan-update.md +86 -31
- package/.bkit/core/prompts/bkit-ship-conflict-resolve.md +94 -50
- package/.bkit/core/prompts/bkit-ship-deferred-sweep.md +91 -41
- package/.bkit/core/prompts/bkit-ship-update-docs.md +45 -24
- package/.bkit/core/prompts/bkit-utility-compress-markdown.md +65 -49
- package/.bkit/core/prompts/bkit-utility-update-decisions.md +87 -42
- package/.bkit/core/prompts/bkit-utility-update-deferrals.md +81 -37
- package/.bkit/core/prompts/bkit-utility-update-documentation.md +43 -25
- package/.bkit/core/prompts/bkit-utility-update-failures.md +84 -37
- package/.bkit/core/prompts/bkit-utility-update-knowledge.md +88 -42
- package/.bkit/core/prompts/bkit-utility-update-roadmap.md +92 -39
- package/.bkit/core/prompts/bkit-utility-update-tracker.md +159 -60
- package/.bkit/core/workflows/bkit-auto.md +89 -58
- package/.bkit/core/workflows/bkit-build.md +967 -517
- package/.bkit/core/workflows/bkit-debug.md +555 -387
- package/.bkit/core/workflows/bkit-design.md +319 -283
- package/.bkit/core/workflows/bkit-plan.md +319 -342
- package/.bkit/core/workflows/bkit-ship.md +525 -328
- package/.bkit/shared/.agents/plugins/bkit/hooks.json +10 -0
- package/.bkit/shared/.bkit/.env.example +2 -2
- package/.bkit/shared/.claude/bkit-cloud.md +12 -10
- package/.bkit/shared/.claude/settings.json +14 -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/.cursor/mcp.json +1 -1
- package/.bkit/shared/.cursor/rules/bkit-rules.mdc +1 -1
- package/.bkit/shared/.gitattributes +1 -1
- package/.bkit/shared/.mcp.json +1 -1
- package/.bkit/shared/.opencode/opencode.json +12 -1
- package/.bkit/shared/CLAUDE.md +6 -2
- package/.bkit/shared/GEMINI.md +5 -2
- package/.bkit/shared/docs/architecture.md +4 -7
- package/.bkit/shared/docs/data-schema.md +4 -7
- package/.bkit/shared/docs/deployments.md +241 -168
- 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 +289 -174
- 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 +45 -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 +54 -51
- package/.bkit/templates/.github/workflows/bkit-cloud.yml +34 -33
- 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 +96 -36
- package/.bkit/templates/.prettierignore +6 -0
- 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 +10 -2
- 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 +231 -0
- package/README.md +278 -89
- package/dist/checks/after/auth.js +36 -33
- package/dist/checks/after/ci-yml.js +91 -30
- package/dist/checks/after/github.js +91 -17
- package/dist/checks/after/index.js +22 -11
- package/dist/checks/after/suppression.js +8 -5
- package/dist/checks/after/tools.js +111 -114
- package/dist/checks/before/context-fetch.js +218 -33
- package/dist/checks/before/env.js +3 -3
- package/dist/checks/before/files.js +5 -3
- package/dist/checks/before/index.js +20 -3
- package/dist/checks/before/repo.js +197 -2
- package/dist/checks/status-holes.js +739 -114
- package/dist/checks/tips/catalogue.js +70 -19
- package/dist/checks/tips/detect.js +62 -0
- package/dist/checks/tips/index.js +51 -9
- package/dist/cli.js +234 -124
- package/dist/commands/analysis.js +174 -141
- 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/comply.js +54 -91
- package/dist/commands/install/doctor.js +2 -2
- package/dist/commands/install/install.js +50 -19
- package/dist/commands/install/uninstall.js +82 -55
- package/dist/commands/install/upgrade.js +21 -11
- package/dist/commands/land.js +137 -17
- package/dist/commands/lib.js +295 -21
- package/dist/commands/registry.js +10 -2
- package/dist/commands/setup/setup.js +8 -7
- package/dist/commands/stats.js +175 -0
- package/dist/commands/tips.js +7 -3
- package/dist/commands/workflow/branches.js +1873 -152
- package/dist/commands/workflow/challenge.js +609 -0
- package/dist/commands/workflow/completeness.js +97 -0
- package/dist/commands/workflow/context.js +1045 -46
- package/dist/commands/workflow/counters.js +385 -86
- package/dist/commands/workflow/decisions.js +484 -0
- package/dist/commands/workflow/disk.js +214 -56
- package/dist/commands/workflow/fids.js +706 -33
- package/dist/commands/workflow/issues.js +349 -59
- package/dist/commands/workflow/ledgers.js +1123 -37
- package/dist/commands/workflow/locks.js +26 -2
- package/dist/commands/workflow/plan-blocks.js +501 -0
- package/dist/commands/workflow/plan-versions.js +22 -0
- package/dist/commands/workflow/plans.js +205 -0
- package/dist/commands/workflow/prs.js +154 -35
- package/dist/commands/workflow/repo.js +58 -8
- package/dist/commands/workflow/roadmap.js +58 -23
- package/dist/commands/workflow/run-facts.js +421 -0
- package/dist/commands/workflow/runs.js +670 -72
- package/dist/commands/workflow/runtime.js +15 -1
- package/dist/commands/workflow/skills.js +1 -0
- package/dist/commands/workflow/status.js +282 -34
- package/dist/commands/workflow/step-table.js +308 -0
- package/dist/commands/workflow/steps.js +703 -96
- package/dist/commands/workflow/summary-findings.js +117 -0
- package/dist/commands/workflow/summary.js +388 -0
- 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 +1695 -305
- package/dist/commands/workflow/tracker.js +983 -0
- package/dist/commands/workflow/workflows.js +1014 -222
- package/dist/commands/workflow/worktrees.js +432 -26
- package/dist/install/cloud-env.js +233 -99
- package/dist/install/context-ci-workflow.js +85 -0
- package/dist/install/manifest.js +64 -17
- package/dist/install/modules/antigravity.js +3 -2
- package/dist/install/modules/cloud.js +25 -16
- package/dist/install/modules/codex.js +12 -2
- package/dist/install/modules/core.js +1090 -48
- package/dist/install/modules/cursor.js +6 -6
- package/dist/install/modules/opencode.js +13 -7
- package/dist/install/template-notes.js +116 -0
- package/dist/install/version-file.js +9 -4
- package/dist/ledgers/compact.js +87 -0
- package/dist/ledgers/journal.js +233 -0
- package/dist/ledgers/migrate.js +81 -0
- package/dist/ledgers/status.js +176 -13
- package/dist/ledgers/telemetry.js +1010 -125
- package/dist/render/hosts.js +104 -14
- package/dist/render/models.js +12 -0
- package/dist/shared/bkit-latest.js +26 -4
- package/dist/shared/branches.js +3 -1
- package/dist/shared/dep-updater.js +49 -0
- package/dist/shared/egress.js +8 -1
- package/dist/shared/json.js +20 -7
- package/dist/shared/package-manager.js +6 -0
- package/dist/shared/settings.js +181 -24
- package/dist/shared/text.js +333 -0
- package/dist/shared/timeouts.js +2 -0
- package/dist/tools/cli-doc.js +97 -0
- package/dist/tools/grammar-density.js +183 -0
- package/dist/tools/instructions-sources.js +720 -0
- package/dist/tools/instructions.js +1623 -0
- package/package.json +156 -51
- package/.bkit/core/.bkit/lite.md +0 -73
- package/.bkit/core/engine/commands/harvest.ts +0 -459
- package/.bkit/core/engine/commands/workflow/workstreams.ts +0 -166
- package/.bkit/core/engine/tools/wording.ts +0 -748
- package/.bkit/core/prompts/bkit-build-challenge-reconcile.md +0 -69
- package/.bkit/core/prompts/bkit-build-challenge-remediate.md +0 -71
- package/.bkit/core/prompts/bkit-build-challenge-tests.md +0 -74
- package/.bkit/core/prompts/bkit-build-plan-execute.md +0 -76
- package/.bkit/core/prompts/bkit-build-summary.md +0 -94
- package/.bkit/core/prompts/bkit-debug-summary.md +0 -96
- package/.bkit/core/prompts/bkit-design-summary.md +0 -107
- package/.bkit/core/prompts/bkit-plan-complexity-check.md +0 -67
- package/.bkit/core/prompts/bkit-plan-complexity-split.md +0 -88
- package/.bkit/core/prompts/bkit-plan-review-3.md +0 -93
- package/.bkit/core/prompts/bkit-plan-scope-check-1.md +0 -85
- package/.bkit/core/prompts/bkit-plan-scope-check-2.md +0 -85
- package/.bkit/core/prompts/bkit-plan-summary.md +0 -107
- package/.bkit/core/prompts/bkit-ship-summary.md +0 -78
- package/.bkit/templates/scripts/ci/bkit-local-stack-lock.sh +0 -194
- package/dist/commands/harvest.js +0 -353
- package/dist/commands/workflow/workstreams.js +0 -143
- package/dist/tools/wording.js +0 -680
- /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,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; }
|
|
@@ -3,14 +3,18 @@
|
|
|
3
3
|
|
|
4
4
|
# Maestro e2e lanes on GitHub Actions — job logs
|
|
5
5
|
|
|
6
|
-
Fits: native e2e lanes (iOS, Android, or both) whose GitHub Actions jobs run Maestro, on the runner or by handing the run to Expo EAS, and upload no GitHub artifact. `context=e2e
|
|
6
|
+
Fits: native e2e lanes (iOS, Android, or both) whose GitHub Actions jobs run Maestro, either on the runner or by handing the run to Expo EAS, and that upload no GitHub artifact. The `context=e2e` block returns the log of every failed Maestro job in the run. It slices each log to the steps that carry the per-flow result. When no step matches, it returns the log's tail instead.
|
|
7
7
|
|
|
8
|
-
-
|
|
9
|
-
- Secret: `GH_TOKEN` in cloud
|
|
10
|
-
- Non-secret: `MAESTRO_JOB_RE
|
|
11
|
-
-
|
|
8
|
+
- The block reads the per-flow result from steps that succeed inside the failed job. `gh run view --log-failed` (the `context=ci` block) skips those steps, and the Playwright block's artifact download finds nothing on these lanes.
|
|
9
|
+
- Secret: `GH_TOKEN` in cloud. A local `gh auth login` works too.
|
|
10
|
+
- Non-secret: `MAESTRO_JOB_RE`, an anchored regex matching your Maestro lanes' job names (e.g. `^e2e-(ios|android)$`).
|
|
11
|
+
- Non-secret: `MAESTRO_STEPS`, the `|`-separated names of the steps that print the result.
|
|
12
|
+
- Non-secret: `MAESTRO_LOG_TAIL`.
|
|
13
|
+
- Non-secret: `CI_WORKFLOW`, the workflow file that runs these lanes (default `bkit-ci.yml`). The block reads only that workflow's newest run on the current branch.
|
|
14
|
+
- Edit the defaults of these four in the block.
|
|
15
|
+
- CLI: `gh`. It is base tooling, so there is no provision block.
|
|
12
16
|
- Domains: none beyond bkit's derived set (`github.com`).
|
|
13
|
-
- Lanes on EAS
|
|
17
|
+
- Lanes on EAS keep their screenshots, JUnit and view-hierarchy dumps on EAS, not in this log. The `expo-workflows` block in `bkit-expo.md` fetches them.
|
|
14
18
|
|
|
15
19
|
Copy the block below into `.agents/context.md`, below `<!-- bkit:end -->`.
|
|
16
20
|
|
|
@@ -18,21 +22,23 @@ Copy the block below into `.agents/context.md`, below `<!-- bkit:end -->`.
|
|
|
18
22
|
|
|
19
23
|
```bash
|
|
20
24
|
# Maestro e2e (iOS and/or Android): every failed job matching MAESTRO_JOB_RE, one section per job.
|
|
21
|
-
# MAESTRO_JOB_RE
|
|
22
|
-
#
|
|
23
|
-
#
|
|
24
|
-
#
|
|
25
|
-
#
|
|
26
|
-
#
|
|
25
|
+
# Scope MAESTRO_JOB_RE to your Maestro lanes' job names. A job from another lane that it matches
|
|
26
|
+
# is printed as Maestro evidence.
|
|
27
|
+
# The placeholder matches no job, so every run skips itself until you edit it.
|
|
28
|
+
# iOS: Maestro's driver is an XCUITest case that hosts the HTTP server Maestro talks to, so one
|
|
29
|
+
# failure inside it ends the suite and turns every later flow into DeviceUnreachableException.
|
|
30
|
+
# Read the per-flow table before the traces.
|
|
31
|
+
# Customise: CI_WORKFLOW (the workflow file that runs these lanes); MAESTRO_JOB_RE; MAESTRO_STEPS (the steps that print per-flow results); MAESTRO_LOG_TAIL (lines kept per step slice, and of the fallback tail).
|
|
27
32
|
MAESTRO_JOB_RE="${MAESTRO_JOB_RE:-^your-maestro-e2e-job-name$}"
|
|
28
33
|
MAESTRO_STEPS="${MAESTRO_STEPS:-Your per-flow results step|Your failure classification step}"
|
|
29
34
|
MAESTRO_LOG_TAIL="${MAESTRO_LOG_TAIL:-800}"
|
|
30
35
|
command -v gh >/dev/null 2>&1 \
|
|
31
36
|
|| { echo "[context-fetch:maestro] skipped — gh CLI not installed" >&2; exit 0; }
|
|
32
|
-
|
|
37
|
+
CI_WORKFLOW="${CI_WORKFLOW:-bkit-ci.yml}"
|
|
38
|
+
RUN_ID=$(gh run list --branch "$(git branch --show-current)" --workflow "$CI_WORKFLOW" --limit 1 \
|
|
33
39
|
--json databaseId,conclusion --jq 'if (.[0].conclusion // "") == "success" then "" else (.[0].databaseId // "" | tostring) end' 2>/dev/null)
|
|
34
40
|
[ -n "$RUN_ID" ] \
|
|
35
|
-
|| { echo "[context-fetch:maestro] skipped — no failing
|
|
41
|
+
|| { echo "[context-fetch:maestro] skipped — no failing $CI_WORKFLOW run found for this branch" >&2; exit 0; }
|
|
36
42
|
# `gh --jq` takes no `--arg`, so the regex goes through real jq.
|
|
37
43
|
JOBS=$(gh run view "$RUN_ID" --json jobs 2>/dev/null \
|
|
38
44
|
| jq -r --arg re "$MAESTRO_JOB_RE" '.jobs[] | select(.name | test($re)) | select(.conclusion=="failure") | "\(.databaseId)\t\(.name)"' 2>/dev/null)
|
|
@@ -50,8 +56,8 @@ while IFS="$TAB" read -r JOB_ID JOB_NAME; do
|
|
|
50
56
|
fi
|
|
51
57
|
PRINTED=1
|
|
52
58
|
printf '===== Maestro job %s (run %s, job %s) =====\n' "$JOB_NAME" "$RUN_ID" "$JOB_ID"
|
|
53
|
-
# Step names match as fixed strings against the step-name column gh prints
|
|
54
|
-
# last MAESTRO_LOG_TAIL lines.
|
|
59
|
+
# Step names match as fixed strings against the step-name column gh prints, and each slice keeps
|
|
60
|
+
# its last MAESTRO_LOG_TAIL lines. When no step matches, the block prints the whole log's tail.
|
|
55
61
|
FOUND=0
|
|
56
62
|
OLD_IFS=$IFS; IFS='|'
|
|
57
63
|
for STEP in $MAESTRO_STEPS; do
|