mandrel 2.111.0 → 2.112.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/.agents/agents/acceptance-critic.md +14 -0
- package/.agents/agents/auditor.md +14 -0
- package/.agents/agents/plan-critic.md +5 -0
- package/.agents/agents/story-worker.md +4 -1
- package/.agents/docs/agentrc-reference.json +22 -10
- package/.agents/docs/configuration.md +351 -37
- package/.agents/docs/execution-reference.md +11 -0
- package/.agents/rules/git-conventions-reference.md +7 -0
- package/.agents/schemas/agentrc.schema.json +174 -14
- package/.agents/schemas/baselines/baseline-envelope.schema.json +16 -4
- package/.agents/schemas/baselines/bundle-size.schema.json +1 -0
- package/.agents/schemas/baselines/coverage.schema.json +1 -0
- package/.agents/schemas/baselines/crap.schema.json +37 -10
- package/.agents/schemas/baselines/duplication.schema.json +1 -0
- package/.agents/schemas/baselines/maintainability.schema.json +1 -0
- package/.agents/schemas/baselines/mutation.schema.json +1 -0
- package/.agents/schemas/crap-report.schema.json +6 -5
- package/.agents/schemas/story-deliver-terminal.schema.json +41 -2
- package/.agents/schemas/story-progress.schema.json +1 -1
- package/.agents/schemas/validation-evidence.schema.json +2 -2
- package/.agents/scripts/boot-sweep.js +41 -3
- package/.agents/scripts/coverage-capture.js +37 -3
- package/.agents/scripts/coverage-ratchet.js +106 -0
- package/.agents/scripts/evidence-gate.js +84 -21
- package/.agents/scripts/lib/audit-baselines/read.js +8 -1
- package/.agents/scripts/lib/audit-baselines/trend.js +2 -1
- package/.agents/scripts/lib/baseline-loader.js +4 -2
- package/.agents/scripts/lib/baselines/codec.js +57 -0
- package/.agents/scripts/lib/baselines/crap-preview-incremental.js +8 -3
- package/.agents/scripts/lib/baselines/crap-preview-scan.js +10 -16
- package/.agents/scripts/lib/baselines/crap-updater-cli.js +4 -13
- package/.agents/scripts/lib/baselines/kernel.js +19 -1
- package/.agents/scripts/lib/baselines/kinds/_crap-codec.js +171 -0
- package/.agents/scripts/lib/baselines/kinds/_crap-read.js +56 -16
- package/.agents/scripts/lib/baselines/kinds/_shared-metric.js +0 -59
- package/.agents/scripts/lib/baselines/kinds/crap.js +283 -319
- package/.agents/scripts/lib/baselines/preview-gates.js +29 -10
- package/.agents/scripts/lib/baselines/reader.js +36 -9
- package/.agents/scripts/lib/baselines/refresh-service.js +79 -18
- package/.agents/scripts/lib/baselines/seat-missing.js +173 -7
- package/.agents/scripts/lib/baselines/writer.js +36 -21
- package/.agents/scripts/lib/changed-files.js +70 -6
- package/.agents/scripts/lib/child-exec.js +10 -0
- package/.agents/scripts/lib/claude/agents-projection.js +5 -5
- package/.agents/scripts/lib/close-lock-events.js +8 -3
- package/.agents/scripts/lib/close-validation/ci-deferral.js +40 -0
- package/.agents/scripts/lib/close-validation/gates.js +111 -35
- package/.agents/scripts/lib/close-validation/process.js +16 -7
- package/.agents/scripts/lib/close-validation/projections/crap.js +43 -10
- package/.agents/scripts/lib/close-validation/runner.js +55 -23
- package/.agents/scripts/lib/close-validation/skip-branch-test.js +144 -0
- package/.agents/scripts/lib/close-validation/test-delta.js +33 -8
- package/.agents/scripts/lib/codex/agents-projection.js +6 -0
- package/.agents/scripts/lib/config/agentrc-overlay.js +9 -5
- package/.agents/scripts/lib/config/explain.js +5 -2
- package/.agents/scripts/lib/config/gates/coverage.schema.js +45 -1
- package/.agents/scripts/lib/config/gates/crap-incremental-coverage.schema.js +1 -1
- package/.agents/scripts/lib/config/git-roots.js +38 -4
- package/.agents/scripts/lib/config/handoff.js +24 -0
- package/.agents/scripts/lib/config/quality.js +26 -13
- package/.agents/scripts/lib/config/worktree-isolation.js +2 -5
- package/.agents/scripts/lib/config-resolver.js +22 -2
- package/.agents/scripts/lib/config-settings-schema-delivery.js +87 -4
- package/.agents/scripts/lib/config-settings-schema-quality.js +36 -1
- package/.agents/scripts/lib/config-settings-schema.js +1 -1
- package/.agents/scripts/lib/coverage-capture-affected.js +1 -0
- package/.agents/scripts/lib/coverage-capture-delta.js +164 -32
- package/.agents/scripts/lib/coverage-capture-own-fix.js +232 -0
- package/.agents/scripts/lib/coverage-capture-usage.js +2 -2
- package/.agents/scripts/lib/coverage-capture.js +15 -0
- package/.agents/scripts/lib/coverage-deferral.js +96 -0
- package/.agents/scripts/lib/coverage-ratchet.js +187 -0
- package/.agents/scripts/lib/crap-baseline-join.js +5 -5
- package/.agents/scripts/lib/crap-engine.js +3 -3
- package/.agents/scripts/lib/crap-method-identity.js +104 -48
- package/.agents/scripts/lib/escomplex-anchor.js +135 -0
- package/.agents/scripts/lib/escomplex-kernel.js +30 -1
- package/.agents/scripts/lib/failure-rows.js +121 -0
- package/.agents/scripts/lib/full-suite-lock.js +44 -4
- package/.agents/scripts/lib/full-suite-queue.js +89 -13
- package/.agents/scripts/lib/generated/agentrc-validator.js +8 -2
- package/.agents/scripts/lib/gh-env.js +3 -6
- package/.agents/scripts/lib/gh-pr-rest.js +1 -0
- package/.agents/scripts/lib/git/base-sync-probe.js +182 -0
- package/.agents/scripts/lib/git-branch-lifecycle.js +9 -0
- package/.agents/scripts/lib/observability/close-telemetry.js +37 -2
- package/.agents/scripts/lib/observability/handoff-telemetry.js +170 -0
- package/.agents/scripts/lib/observability/review-dispositions.js +23 -6
- package/.agents/scripts/lib/observability/runtime-friction.js +17 -4
- package/.agents/scripts/lib/observability/source-classifier.js +3 -0
- package/.agents/scripts/lib/observability/story-outcome.js +393 -0
- package/.agents/scripts/lib/orchestration/check-baselines/phases/compare.js +2 -1
- package/.agents/scripts/lib/orchestration/check-baselines/phases/evaluate.js +19 -1
- package/.agents/scripts/lib/orchestration/check-baselines/phases/fail-detail.js +84 -0
- package/.agents/scripts/lib/orchestration/check-baselines/phases/pipeline.js +14 -5
- package/.agents/scripts/lib/orchestration/check-baselines/phases/refresh-ack.js +3 -2
- package/.agents/scripts/lib/orchestration/check-baselines/phases/report.js +26 -6
- package/.agents/scripts/lib/orchestration/code-review.js +223 -19
- package/.agents/scripts/lib/orchestration/handoff-gates.js +129 -62
- package/.agents/scripts/lib/orchestration/handoff-rescore.js +169 -0
- package/.agents/scripts/lib/orchestration/handoff-suite-of-record.js +45 -0
- package/.agents/scripts/lib/orchestration/preflight-lanes.js +208 -0
- package/.agents/scripts/lib/orchestration/review-base-ref.js +40 -17
- package/.agents/scripts/lib/orchestration/review-deposit.js +38 -12
- package/.agents/scripts/lib/orchestration/review-depth.js +21 -0
- package/.agents/scripts/lib/orchestration/review-history.js +124 -20
- package/.agents/scripts/lib/orchestration/review-providers/claude-verdict.js +23 -8
- package/.agents/scripts/lib/orchestration/review-providers/code-review.js +82 -39
- package/.agents/scripts/lib/orchestration/review-providers/critical-verifier.js +64 -11
- package/.agents/scripts/lib/orchestration/review-providers/degraded-gates.js +98 -3
- package/.agents/scripts/lib/orchestration/review-providers/finding-identity.js +6 -2
- package/.agents/scripts/lib/orchestration/review-providers/findings-renderer.js +55 -8
- package/.agents/scripts/lib/orchestration/review-providers/review-guidance.js +1 -0
- package/.agents/scripts/lib/orchestration/review-providers/review-provider-factory.js +42 -15
- package/.agents/scripts/lib/orchestration/review-providers/types.js +6 -0
- package/.agents/scripts/lib/orchestration/single-story-close/failed-terminal.js +10 -1
- package/.agents/scripts/lib/orchestration/single-story-close/gate-log.js +10 -0
- package/.agents/scripts/lib/orchestration/single-story-close/phases/base-sync.js +7 -4
- package/.agents/scripts/lib/orchestration/single-story-close/phases/close-validation.js +15 -3
- package/.agents/scripts/lib/orchestration/single-story-close/phases/code-review.js +59 -2
- package/.agents/scripts/lib/orchestration/single-story-close/phases/confirm-merge.js +6 -0
- package/.agents/scripts/lib/orchestration/single-story-close/phases/finish.js +15 -4
- package/.agents/scripts/lib/orchestration/single-story-close/phases/land-review-record.js +213 -0
- package/.agents/scripts/lib/orchestration/single-story-close/phases/normalize-pr-title.js +9 -12
- package/.agents/scripts/lib/orchestration/single-story-close/phases/open-pr.js +26 -12
- package/.agents/scripts/lib/orchestration/single-story-close/phases/post-land.js +51 -26
- package/.agents/scripts/lib/orchestration/single-story-close/phases/pre-push.js +3 -2
- package/.agents/scripts/lib/orchestration/single-story-close/phases/pull-request.js +50 -17
- package/.agents/scripts/lib/orchestration/single-story-close/phases/push.js +59 -11
- package/.agents/scripts/lib/orchestration/single-story-close/phases/reconcile-done.js +1 -0
- package/.agents/scripts/lib/orchestration/single-story-close/phases/review-block.js +31 -13
- package/.agents/scripts/lib/orchestration/single-story-close/phases/review-halt.js +29 -6
- package/.agents/scripts/lib/orchestration/single-story-close/phases/review-outcome.js +10 -12
- package/.agents/scripts/lib/orchestration/single-story-close/phases/review-override.js +19 -4
- package/.agents/scripts/lib/orchestration/single-story-close/result.js +30 -13
- package/.agents/scripts/lib/orchestration/single-story-close/review-overlap.js +73 -39
- package/.agents/scripts/lib/orchestration/single-story-close/runner.js +11 -3
- package/.agents/scripts/lib/orchestration/story-close/baseline-upward-writeback.js +3 -2
- package/.agents/scripts/lib/orchestration/story-close/duplication-close-rescore.js +20 -8
- package/.agents/scripts/lib/orchestration/story-deliver-terminal.js +7 -0
- package/.agents/scripts/lib/orchestration/story-handoff.js +774 -196
- package/.agents/scripts/lib/orchestration/ticketing/reads.js +2 -0
- package/.agents/scripts/lib/pr-body-lines.js +32 -0
- package/.agents/scripts/lib/single-story/ci-ratchet-gate.js +140 -0
- package/.agents/scripts/lib/single-story/confirm-and-land.js +17 -7
- package/.agents/scripts/lib/single-story/confirm-merge.js +12 -3
- package/.agents/scripts/lib/single-story-sweep/report-stalled-executing.js +202 -0
- package/.agents/scripts/lib/standalone-ratchets.js +37 -0
- package/.agents/scripts/lib/suite-admission.js +20 -8
- package/.agents/scripts/lib/suite-sizing.js +146 -0
- package/.agents/scripts/lib/workspace-provisioner.js +2 -2
- package/.agents/scripts/merge-baseline.js +14 -3
- package/.agents/scripts/providers/github/comments.js +19 -3
- package/.agents/scripts/providers/github.js +1 -0
- package/.agents/scripts/review-dispositions-report.js +1 -1
- package/.agents/scripts/role-scope-guard.js +267 -0
- package/.agents/scripts/single-story-close.js +4 -4
- package/.agents/scripts/single-story-confirm-merge.js +31 -5
- package/.agents/scripts/single-story-init.js +24 -4
- package/.agents/scripts/story-handoff.js +3 -3
- package/.agents/scripts/story-outcomes-report.js +231 -0
- package/.agents/scripts/story-review-compute.js +9 -5
- package/.agents/scripts/update-coverage-baseline.js +12 -2
- package/.agents/scripts/update-crap-baseline.js +9 -1
- package/.agents/workflows/helpers/code-review.md +63 -9
- package/.agents/workflows/helpers/deliver-digest.md +53 -54
- package/.agents/workflows/helpers/deliver-reference.md +233 -67
- package/.agents/workflows/helpers/deliver-story-reference.md +19 -8
- package/.agents/workflows/helpers/deliver-story.md +7 -2
- package/.agents/workflows/helpers/parallel-tooling.md +29 -0
- package/docs/CHANGELOG.md +46 -0
- package/lib/cli/doctor-checks/coverage-ratchet.js +54 -0
- package/lib/cli/doctor-checks/effective-agentrc.js +23 -0
- package/lib/cli/doctor-checks/llm-review.js +2 -11
- package/lib/cli/doctor-checks/sync-parity.js +5 -1
- package/lib/cli/doctor-checks/test-credit-path.js +7 -2
- package/lib/cli/registry.js +5 -0
- package/package.json +1 -1
|
@@ -91,7 +91,7 @@
|
|
|
91
91
|
"type": "string",
|
|
92
92
|
"pattern": "([;&|`]|\\$\\()"
|
|
93
93
|
},
|
|
94
|
-
"description": "Optional changed-tests command for the delta re-credit: when close's base sync merged sibling landings into a branch whose pre-sync head holds `test` credit, close's `test` gate runs this instead of the full suite, with the credited commit in the `MANDREL_CHANGED_SINCE` environment variable and in place of a literal `$MANDREL_CHANGED_SINCE` argument (e.g. `pnpm vitest run --changed $MANDREL_CHANGED_SINCE`; no shell runs it), and a green run re-credits the merged tree. Ineligible when coverage-capture runs the suite, an incoming path is a coverage-config file or one of the Story's own files, or no incoming path is a suite input. The overlap rule ignores baseline (`baselines/`) and coverage-directory paths. Absent or `null` keeps the full re-run."
|
|
94
|
+
"description": "Optional changed-tests command for the delta re-credit: when close's base sync merged sibling landings into a branch whose pre-sync head holds `test` credit, close's `test` gate runs this instead of the full suite, with the credited commit in the `MANDREL_CHANGED_SINCE` environment variable and in place of a literal `$MANDREL_CHANGED_SINCE` argument (e.g. `pnpm vitest run --changed $MANDREL_CHANGED_SINCE`; no shell runs it), and a green run re-credits the merged tree. Ineligible when coverage-capture runs the suite, an incoming path is a coverage-config file or one of the Story's own files, or no incoming path is a suite input. The overlap rule ignores baseline (`baselines/`) and coverage-directory paths, and paths matching `delivery.quality.gates.coverage.nonInputGlobs`; those globs never change the incoming count or the emptiness rule, and a config file refuses under either value of `captureHandlesConfigChanges`. It is also the skip-branch first-credit depositor: when coverage-capture is active but takes its incremental skip (no changed file under `crap.targetDirs`), handoff and close run it keyed on the `origin/<baseBranch>` merge-base, credited as the full suite. It MUST therefore select any test that reads a non-module input by path (a docs registry, a fixture file) — `--changed` cannot see that edge, so a break only such a test catches surfaces only where the full suite runs later. Prefer reading `MANDREL_CHANGED_SINCE` from the env over the argv token, so the spawned argv stays constant and declarable in `delivery.execution.workloads[]`. Absent or `null` keeps the full re-run and the full skip-branch suite."
|
|
95
95
|
},
|
|
96
96
|
"typecheck": {
|
|
97
97
|
"type": ["string", "null"],
|
|
@@ -416,11 +416,11 @@
|
|
|
416
416
|
"capacity": {
|
|
417
417
|
"type": "integer",
|
|
418
418
|
"minimum": 1,
|
|
419
|
-
"description": "Story #5668. The admission budget, in weight units (CPU workers), shared by every suite spawn across this repository's worktrees and sessions — runs in other repositories on the host are not counted. Unset → the host's `os.availableParallelism()`. A declared workload is admitted while the live weights plus its own fit,
|
|
419
|
+
"description": "Story #5668. The admission budget, in weight units (CPU workers), shared by every suite spawn across this repository's worktrees and sessions — runs in other repositories on the host are not counted. Unset → the host's `os.availableParallelism()`. A declared workload is admitted while the live weights plus its own fit, first-in-first-out: nothing overtakes an earlier live waiter, so a queued full suite is never starved — except a `workloads[].backfill` run, which may pass earlier declared waiters it fits beside, only while the oldest has waited under 300 s."
|
|
420
420
|
},
|
|
421
421
|
"workloads": {
|
|
422
422
|
"type": "array",
|
|
423
|
-
"description": "Story #5668. Suite commands declared safe to run alongside others. A spawn whose argv (whitespace-normalized) EXACTLY equals `command` takes that `weight` and `resources`; anything else — and every spawn when this list is empty, the default — runs exclusively (full capacity, today's serialization). Isolation is never inferred from a flag
|
|
423
|
+
"description": "Story #5668. Suite commands declared safe to run alongside others. A spawn whose argv (whitespace-normalized) EXACTLY equals `command` takes that `weight` and `resources`; anything else — and every spawn when this list is empty, the default — runs exclusively (full capacity, today's serialization). Isolation is never inferred from a flag or prefix; a weight comes from the entry, or from its `tiers` as sized by its own `sizeCommand`. `weight` must count the run's nested worker pool (`--workers 4` → 4), and a full suite needs its own entry before anything can overlap it. Two runs naming a common `resources` entry (a database fixture, a shared coverage file) never overlap; worktree-local outputs need none. A weight above `capacity` refuses the run with exit 78 — nothing spawns, no credit is recorded. An expired wait still exits 75, resumably. Scheduling never changes a run's credit identity. `MANDREL_FULL_SUITE_LOCK=0` (one invocation) or `fullSuiteLock: false` turns admission off entirely; reach for the env hatch only when you have checked the runs share nothing.",
|
|
424
424
|
"items": {
|
|
425
425
|
"type": "object",
|
|
426
426
|
"required": ["command", "weight"],
|
|
@@ -446,11 +446,54 @@
|
|
|
446
446
|
"pattern": "^[a-z0-9][a-z0-9-]*$"
|
|
447
447
|
},
|
|
448
448
|
"description": "Names of shared resources this run needs exclusively."
|
|
449
|
+
},
|
|
450
|
+
"tiers": {
|
|
451
|
+
"type": "array",
|
|
452
|
+
"minItems": 1,
|
|
453
|
+
"items": {
|
|
454
|
+
"type": "object",
|
|
455
|
+
"required": ["maxFiles", "weight"],
|
|
456
|
+
"properties": {
|
|
457
|
+
"maxFiles": {
|
|
458
|
+
"type": "integer",
|
|
459
|
+
"minimum": 0
|
|
460
|
+
},
|
|
461
|
+
"weight": {
|
|
462
|
+
"type": "integer",
|
|
463
|
+
"minimum": 1
|
|
464
|
+
}
|
|
465
|
+
},
|
|
466
|
+
"additionalProperties": false
|
|
467
|
+
},
|
|
468
|
+
"description": "Story #5963. Slice-size tiers: the run books the weight of the first tier (ascending `maxFiles`) whose `maxFiles` covers the count `sizeCommand` prints; none, a sizing failure or a tier weight above `weight` books the full `weight`. Requires `sizeCommand`."
|
|
469
|
+
},
|
|
470
|
+
"sizeCommand": {
|
|
471
|
+
"type": "string",
|
|
472
|
+
"not": {
|
|
473
|
+
"pattern": "([;&|`]|\\$\\()"
|
|
474
|
+
},
|
|
475
|
+
"minLength": 1,
|
|
476
|
+
"description": "Story #5963. Argv (no shell, 60 s bound) printing the slice's test-file count as its last stdout line; run in the spawn's cwd and env just before reserving. Requires `tiers`."
|
|
477
|
+
},
|
|
478
|
+
"backfill": {
|
|
479
|
+
"type": "boolean",
|
|
480
|
+
"default": false,
|
|
481
|
+
"description": "Story #5963. Let this run be admitted ahead of earlier waiters when every one is declared, fits beside it within `capacity` and shares no resource with it, and the oldest has waited under 300 s."
|
|
449
482
|
}
|
|
450
483
|
},
|
|
484
|
+
"dependencies": {
|
|
485
|
+
"tiers": ["sizeCommand"],
|
|
486
|
+
"sizeCommand": ["tiers"]
|
|
487
|
+
},
|
|
451
488
|
"additionalProperties": false
|
|
452
489
|
},
|
|
453
490
|
"default": []
|
|
491
|
+
},
|
|
492
|
+
"preflightConcurrency": {
|
|
493
|
+
"type": "integer",
|
|
494
|
+
"minimum": 1,
|
|
495
|
+
"default": 1,
|
|
496
|
+
"description": "Story #5997. The most handoff preflight checks that may run at once. `1` (the default) is the serial preflight. Above 1, typecheck, lint and format (close's independent gates) may also run in up to N − 1 extra lanes, each admitted through suite admission with no wait under close's argv for that gate; a miss hands the check back to the serial lane. Set it per host in `.agentrc.local.json`: whether a host can afford a second CPU-heavy check is a per-host fact."
|
|
454
497
|
}
|
|
455
498
|
},
|
|
456
499
|
"additionalProperties": false
|
|
@@ -580,13 +623,8 @@
|
|
|
580
623
|
"type": "string",
|
|
581
624
|
"minLength": 1
|
|
582
625
|
},
|
|
583
|
-
"description": "Gitignored files copied from the main checkout into every new worktree. A worktree checks out tracked files only, so local secrets
|
|
584
|
-
"default": [
|
|
585
|
-
".env",
|
|
586
|
-
".mcp.json",
|
|
587
|
-
".agentrc.local.json",
|
|
588
|
-
".agents/instructions.local.md"
|
|
589
|
-
]
|
|
626
|
+
"description": "Gitignored files copied from the main checkout into every new worktree. A worktree checks out tracked files only, so local secrets would otherwise be missing. `.agentrc.local.json` is not copied by default: a worktree reads the main checkout's live overlay.",
|
|
627
|
+
"default": [".env", ".mcp.json", ".agents/instructions.local.md"]
|
|
590
628
|
}
|
|
591
629
|
},
|
|
592
630
|
"additionalProperties": false,
|
|
@@ -714,8 +752,44 @@
|
|
|
714
752
|
"onOverBudget": {
|
|
715
753
|
"type": "string",
|
|
716
754
|
"enum": ["block", "defer-to-ci"],
|
|
717
|
-
"description": "What handoff and close do when the capture script exits 76
|
|
755
|
+
"description": "What handoff and close do when the capture script — or the `test` command (`project.commands.test`, or `testChanged` on the skip branch and the delta re-credit) — exits 76: the consumer-declared signal that the selected slice is over this host's budget and no test ran. `block` (default) stops the handoff (`blocked`) and fails close, naming this key. `defer-to-ci` settles the coverage gate as deferred to CI: no artifact is written or stamped and no credit is recorded, the coverage-reading gates (CRAP preview, coverage and CRAP baselines) are skipped, and handoff and close proceed — the terminal envelope and the PR body say coverage was deferred. Set it only when the consumer's CI runs the deferred suite with a coverage floor. A timeout (124) is never deferred, under either value.",
|
|
718
756
|
"default": "block"
|
|
757
|
+
},
|
|
758
|
+
"suiteOfRecord": {
|
|
759
|
+
"type": "string",
|
|
760
|
+
"enum": ["local", "ci"],
|
|
761
|
+
"description": "Where the coverage capture runs. `local` (default) changes nothing. `ci` — meant for a small host's `.agentrc.local.json` — makes CI the coverage and CRAP ratchet of record: handoff and close settle the coverage gate as deferred (reason `suite-of-record-ci`) without spawning the capture, the PR body carries the `Coverage-deferred:` key line, and confirm-merge waits for `ciRatchetCheck` to go green. Requires `ciRatchetCheck`; without it handoff blocks and close fails.",
|
|
762
|
+
"default": "local"
|
|
763
|
+
},
|
|
764
|
+
"ciRatchetCheck": {
|
|
765
|
+
"type": ["string", "null"],
|
|
766
|
+
"minLength": 1,
|
|
767
|
+
"description": "Name of the consumer's CI check (check-run or status context) that runs `coverage-ratchet.js` on a deferred PR. Required by `suiteOfRecord: ci`; when set, confirm-merge holds `agent::done` on a PR carrying the `Coverage-deferred:` key line until this check is green on the PR head. Default `null`.",
|
|
768
|
+
"default": null
|
|
769
|
+
},
|
|
770
|
+
"nonInputGlobs": {
|
|
771
|
+
"type": "array",
|
|
772
|
+
"items": {
|
|
773
|
+
"type": "string",
|
|
774
|
+
"not": {
|
|
775
|
+
"pattern": "([;&|`]|\\$\\()"
|
|
776
|
+
},
|
|
777
|
+
"minLength": 1
|
|
778
|
+
},
|
|
779
|
+
"description": "Repo-relative picomatch globs naming paths no test reads. A matching path is dropped from both sides of the coverage delta-refresh overlap check and from the re-measured set — a delta of only matching, baseline and coverage-directory paths restamps without a run — and from the overlap check of close's `test` delta re-credit (its incoming count and emptiness test are unchanged). It never changes the suite-input filter, the tree digest or stamp freshness. Default `[]`: nothing is built in, so Markdown counts as an input unless declared here.",
|
|
780
|
+
"default": []
|
|
781
|
+
},
|
|
782
|
+
"captureHandlesConfigChanges": {
|
|
783
|
+
"type": "boolean",
|
|
784
|
+
"description": "Declares that the affected capture script, given `MANDREL_COVERAGE_BASE_REF`, widens its own selection when a coverage-determining config file (`package.json`, a lockfile, `tsconfig*.json`, a test-runner config) changes. When `true`, such a file in the coverage delta no longer refuses the delta refresh. Close's `test` delta re-credit refuses on a config file under either value. Default `false`.",
|
|
785
|
+
"default": false
|
|
786
|
+
},
|
|
787
|
+
"ownFixDeltaMaxFiles": {
|
|
788
|
+
"type": "integer",
|
|
789
|
+
"minimum": 0,
|
|
790
|
+
"maximum": 50,
|
|
791
|
+
"description": "Opt-in own-fix delta refresh for `captureScope: affected`. `0` (default) keeps it off. `N >= 1` lets a delta that today's rule refuses for a Story overlap or a config file be re-measured as a delta when it splits, along HEAD's first-parent chain, into base-sync merges that pass today's rule and the Story's own non-merge commits touching at most `N` suite-input files, with no config file, no deleted or renamed suite input and no net line removal in a test file. Rows outside the delta can go stale high; validate against full captures before raising it. `10` is a reasonable start.",
|
|
792
|
+
"default": 0
|
|
719
793
|
}
|
|
720
794
|
},
|
|
721
795
|
"additionalProperties": false
|
|
@@ -861,7 +935,7 @@
|
|
|
861
935
|
"baseRef": {
|
|
862
936
|
"type": "string",
|
|
863
937
|
"minLength": 1,
|
|
864
|
-
"description": "Default git ref the changed-file set is computed against, for a caller that passes no `--ref`. A `--ref` the caller named wins over this value, so a caller that anchors another gate on the same ref — `.husky/pre-push`, which passes `--ref origin/main` and then previews `--changed-since origin/main` — resolves ONE scope for both steps (Story #5365). Omitted and unpassed, the
|
|
938
|
+
"description": "Default git ref the changed-file set is computed against, for a caller that passes no `--ref`. A `--ref` the caller named wins over this value, so a caller that anchors another gate on the same ref — `.husky/pre-push`, which passes `--ref origin/main` and then previews `--changed-since origin/main` — resolves ONE scope for both steps (Story #5365). Omitted and unpassed, the default is `origin/<project.baseBranch>` (`origin/main` by default), so a local base branch that trails the remote cannot widen the set; a clone where that remote ref does not resolve falls back to the local base branch with a warning."
|
|
865
939
|
}
|
|
866
940
|
},
|
|
867
941
|
"additionalProperties": false
|
|
@@ -1288,6 +1362,28 @@
|
|
|
1288
1362
|
},
|
|
1289
1363
|
"additionalProperties": false
|
|
1290
1364
|
},
|
|
1365
|
+
"ratchets": {
|
|
1366
|
+
"type": "object",
|
|
1367
|
+
"description": "CI's standalone ratchets as the handoff preflight runs them.",
|
|
1368
|
+
"properties": {
|
|
1369
|
+
"coveredByLint": {
|
|
1370
|
+
"type": "array",
|
|
1371
|
+
"uniqueItems": true,
|
|
1372
|
+
"items": {
|
|
1373
|
+
"type": "string",
|
|
1374
|
+
"enum": [
|
|
1375
|
+
"dead-exports",
|
|
1376
|
+
"dead-exports-production",
|
|
1377
|
+
"arch-cycles",
|
|
1378
|
+
"cyclomatic"
|
|
1379
|
+
]
|
|
1380
|
+
},
|
|
1381
|
+
"default": [],
|
|
1382
|
+
"description": "Standalone ratchets the handoff preflight skips once the same pass's whole-tree `lint` check exited 0. Each listed ratchet MUST be run, with the same arguments and over the whole repository, by the command `project.commands.lint` resolves to; mandrel cannot inspect that command, so this is the consumer's declaration. A lint that is absent, disabled, failing or narrowed to changed files covers nothing, and CI stays the backstop. Default `[]` runs every ratchet whose baseline is committed."
|
|
1383
|
+
}
|
|
1384
|
+
},
|
|
1385
|
+
"additionalProperties": false
|
|
1386
|
+
},
|
|
1291
1387
|
"requireBaselines": {
|
|
1292
1388
|
"type": "boolean",
|
|
1293
1389
|
"description": "Story #4495. Fail-closed baseline-enforcement policy for the unified check-baselines close-validation gate. When false (default), a consumer that enables baseline gates (crap/maintainability/…) but has not committed the corresponding baseline artifacts under baselines/ gets a clean skip-with-reason instead of a deterministic first-try close failure. Set true to keep the gate registered so an absent baseline artifact fails close-validation with a preflight hint naming the fix (the fail-closed posture).",
|
|
@@ -1319,6 +1415,19 @@
|
|
|
1319
1415
|
},
|
|
1320
1416
|
"additionalProperties": false
|
|
1321
1417
|
},
|
|
1418
|
+
"close": {
|
|
1419
|
+
"type": "object",
|
|
1420
|
+
"description": "Close-time posture (Story #5954). `baseSync` decides whether close and a handoff re-run merge `origin/<baseBranch>` before validating.",
|
|
1421
|
+
"properties": {
|
|
1422
|
+
"baseSync": {
|
|
1423
|
+
"type": "string",
|
|
1424
|
+
"enum": ["always", "on-conflict"],
|
|
1425
|
+
"description": "`always` (default) merges `origin/<baseBranch>` on every close, as before. `on-conflict` first runs a conflict-only probe and skips the merge when it is conflict-free (`git merge-tree --write-tree`) and the incoming and Story paths are disjoint (raw paths, `baselines/` and renames included); `check-baselines` then compares against the merge-base and the terminal envelope's `baseSync` says why. Any other probe answer merges as today. A handoff applies the probe only on a re-run. Opt in only behind a merge queue that re-tests the merged tree and with no up-to-date-branch requirement: a semantic conflict the probe cannot see surfaces in CI, and coverage is measured on the pre-merge tree.",
|
|
1426
|
+
"default": "always"
|
|
1427
|
+
}
|
|
1428
|
+
},
|
|
1429
|
+
"additionalProperties": false
|
|
1430
|
+
},
|
|
1322
1431
|
"codeReview": {
|
|
1323
1432
|
"type": "object",
|
|
1324
1433
|
"description": "Review-provider chain and on-branch remediation threshold for the /mandrel-deliver code-review ceremony.",
|
|
@@ -1383,7 +1492,7 @@
|
|
|
1383
1492
|
},
|
|
1384
1493
|
"additionalProperties": false
|
|
1385
1494
|
},
|
|
1386
|
-
"description": "Review-provider chain (Story #2871). When unset or empty, falls back to this default: `native` (maintainability scoring of the changed files) then an optional story-scoped `llm-review` — the first available of `code-review` (a
|
|
1495
|
+
"description": "Review-provider chain (Story #2871). When unset or empty, falls back to this default: `native` (maintainability scoring of the changed files) then an optional story-scoped `llm-review` — the first available of `code-review` (a `claude --print` bug review, at the effort `effortByDepth` maps its depth to, whose every finding is critical and halts close before auto-merge) and `codex` (`codex exec`), so a host with both CLIs runs one LLM review and a host with neither skips it. Pin `code-review` or `codex` to choose the CLI. `security-review` and `ultrareview` are opt-in. The orchestrator iterates inline entries in declaration order and merges their Finding[] before posting one structured comment; manual-prompt entries (e.g. ultrareview) contribute a trailing 'Manual review suggestions' section. Selecting an adapter whose probe fails hard-fails at factory construction unless declared `optional: true` in the chain.",
|
|
1387
1496
|
"default": [
|
|
1388
1497
|
{
|
|
1389
1498
|
"name": "native"
|
|
@@ -1426,11 +1535,28 @@
|
|
|
1426
1535
|
"additionalProperties": false
|
|
1427
1536
|
}
|
|
1428
1537
|
},
|
|
1538
|
+
"effortByDepth": {
|
|
1539
|
+
"type": "object",
|
|
1540
|
+
"description": "The `claude --effort` level the `code-review` provider runs at for each review depth. An entry overrides the shipped default for that depth only: `light: low`, `standard: low`, `deep: high`.",
|
|
1541
|
+
"propertyNames": {
|
|
1542
|
+
"enum": ["light", "standard", "deep"]
|
|
1543
|
+
},
|
|
1544
|
+
"additionalProperties": {
|
|
1545
|
+
"type": "string",
|
|
1546
|
+
"enum": ["low", "medium", "high", "xhigh", "max"]
|
|
1547
|
+
}
|
|
1548
|
+
},
|
|
1429
1549
|
"guidanceFile": {
|
|
1430
1550
|
"type": "string",
|
|
1431
1551
|
"minLength": 1,
|
|
1432
1552
|
"description": "Project review guidance, a path relative to the project root. Unset, a root `REVIEW.md` is used when present; an absent file is a no-op. Its text is rendered into every LLM review provider's prompt after the framework's severity and anti-gaming rules, and over 8,000 characters is truncated with a degradation. Guidance may add failure classes and paths worth skipping but cannot lower a severity rule, excuse a `shortcut:`, or change the output shape."
|
|
1433
1553
|
},
|
|
1554
|
+
"onNoVerdict": {
|
|
1555
|
+
"type": "string",
|
|
1556
|
+
"enum": ["report", "block"],
|
|
1557
|
+
"default": "report",
|
|
1558
|
+
"description": "What a Story-scope review that left part or all of the diff without a verdict does. `report` (default) records it (`gates.codeReview: unreviewed` or `partial`) and does not halt. `block` halts handoff and close on any `verdict-missing` or `coverage-partial` degradation, naming the cause, its fix and the `story-review-compute.js` re-run command; `--override-review-block` stays the escape. Reduced context (`degraded`) never halts. Set `block` when this review is the only pre-merge review."
|
|
1559
|
+
},
|
|
1434
1560
|
"skipPaths": {
|
|
1435
1561
|
"type": "array",
|
|
1436
1562
|
"items": {
|
|
@@ -1469,12 +1595,17 @@
|
|
|
1469
1595
|
},
|
|
1470
1596
|
"feedbackLoop": {
|
|
1471
1597
|
"type": "object",
|
|
1472
|
-
"description": "Opt-in
|
|
1598
|
+
"description": "Opt-in toggles for anything posted to the tracker unasked: the retro auto-file graduator and the per-Story outcome record. Both default to OFF (Story #5341).",
|
|
1473
1599
|
"properties": {
|
|
1474
1600
|
"retroProposals": {
|
|
1475
1601
|
"type": "boolean",
|
|
1476
1602
|
"description": "When true, the retro auto-files its actionable routed proposals as meta::<framework-gap|consumer-improvement> + friction::<category> issues via the graduator pre-parsed-findings seam, and the rendered retro sections list the filed issue numbers instead of paste-ready gh command stanzas. Defaults to false (Story #5341), which renders the command stanzas instead.",
|
|
1477
1603
|
"default": false
|
|
1604
|
+
},
|
|
1605
|
+
"outcomeRecord": {
|
|
1606
|
+
"type": "boolean",
|
|
1607
|
+
"description": "When true, every close and confirm-merge attempt upserts one `story-outcome` structured comment on the Story issue: a JSON record of each attempt (status, cause, failed gates, mandrel version) plus a carried-forward summary, read back by story-outcomes-report.js. Defaults to false, which makes no extra GitHub call.",
|
|
1608
|
+
"default": false
|
|
1478
1609
|
}
|
|
1479
1610
|
},
|
|
1480
1611
|
"additionalProperties": false
|
|
@@ -1528,6 +1659,35 @@
|
|
|
1528
1659
|
},
|
|
1529
1660
|
"additionalProperties": false
|
|
1530
1661
|
},
|
|
1662
|
+
"handoff": {
|
|
1663
|
+
"type": "object",
|
|
1664
|
+
"description": "Story #5960. What `story-handoff.js` runs beyond close's own gates.",
|
|
1665
|
+
"properties": {
|
|
1666
|
+
"postSeatChecks": {
|
|
1667
|
+
"type": "array",
|
|
1668
|
+
"items": {
|
|
1669
|
+
"type": "object",
|
|
1670
|
+
"properties": {
|
|
1671
|
+
"cmd": {
|
|
1672
|
+
"type": "string",
|
|
1673
|
+
"minLength": 1
|
|
1674
|
+
},
|
|
1675
|
+
"args": {
|
|
1676
|
+
"type": "array",
|
|
1677
|
+
"items": {
|
|
1678
|
+
"type": "string"
|
|
1679
|
+
}
|
|
1680
|
+
}
|
|
1681
|
+
},
|
|
1682
|
+
"required": ["cmd"],
|
|
1683
|
+
"additionalProperties": false
|
|
1684
|
+
},
|
|
1685
|
+
"description": "Story #5960. Consumer checks the handoff re-runs in its post-capture step, after the seat commits the Story's new baseline rows: each `{ cmd, args? }` runs in the worktree without a shell, with `MANDREL_HANDOFF_STEP=post-capture`, and a non-zero exit settles `fix-required`. Declare the check a consumer downgrades during `preflight` (keyed on `MANDREL_HANDOFF_STEP`) here, so a row the seat did not write still fails the handoff; while any is declared the preflight `lint` credit is withheld until they pass at HEAD. Skipped under a coverage deferral. Default [] runs nothing extra.",
|
|
1686
|
+
"default": []
|
|
1687
|
+
}
|
|
1688
|
+
},
|
|
1689
|
+
"additionalProperties": false
|
|
1690
|
+
},
|
|
1531
1691
|
"routing": {
|
|
1532
1692
|
"type": "object",
|
|
1533
1693
|
"description": "v2 delivery-spawn routing: role-scoped boot contexts and the ceremony profile. The v1 singleDelivery epic-route kill-switch was removed in Stage 6; the freshCriticSampleRate sampling floor was retired in Story #5313 and the derived-level ceremony routing in Story #5343.",
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"title": "BaselineEnvelope",
|
|
5
5
|
"description": "Shared envelope contract for every committed Mandrel baseline (lint, coverage, crap, maintainability, mutation, lighthouse, bundle-size). Each per-kind schema extends this envelope via allOf to constrain the row shape. The committed file carries no run timestamp and no rollup: both were rewritten on every refresh, so two branches refreshing disjoint rows always conflicted textually — and GitHub (PR mergeability, update-branch, the merge queue) never runs the custom merge driver. Readers derive the rollup from rows[]; freshness is the file's git history. The envelope itself is intentionally agnostic about row contents so the kernel can evolve without churning the shared contract.",
|
|
6
6
|
"type": "object",
|
|
7
|
-
"required": ["$schema", "kernelVersion"
|
|
7
|
+
"required": ["$schema", "kernelVersion"],
|
|
8
8
|
"additionalProperties": false,
|
|
9
9
|
"properties": {
|
|
10
10
|
"$schema": {
|
|
@@ -26,14 +26,26 @@
|
|
|
26
26
|
},
|
|
27
27
|
"provenanceStamped": {
|
|
28
28
|
"type": "boolean",
|
|
29
|
-
"description": "
|
|
29
|
+
"description": "Legacy per-kind stamp, no longer written: the CRAP writer once used it to assert that each row's coordinate provenance was recorded. It stays accepted so a baseline written before the grouped CRAP layout parses and reaches the kind's scoring-semantics compat axis, which fails it closed with the re-seed command, instead of dying on a raw schema error."
|
|
30
30
|
},
|
|
31
31
|
"rows": {
|
|
32
32
|
"type": "array",
|
|
33
|
-
"description": "Per-row metrics. Order is kind-specific (e.g. CRAP sorts by
|
|
33
|
+
"description": "Per-row metrics. Order is kind-specific (e.g. CRAP sorts by path then method key); per-kind schemas tighten the item shape. Exactly one of rows and files is present.",
|
|
34
34
|
"items": {
|
|
35
35
|
"type": "object"
|
|
36
36
|
}
|
|
37
|
+
},
|
|
38
|
+
"files": {
|
|
39
|
+
"type": "object",
|
|
40
|
+
"description": "Grouped on-disk row layout for kinds whose codec writes one (CRAP): each canonical path once, mapped to its per-row values. Exactly one of rows and files is present; readers decode it back to rows through the kind's layout codec."
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
"oneOf": [
|
|
44
|
+
{
|
|
45
|
+
"required": ["rows"]
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"required": ["files"]
|
|
37
49
|
}
|
|
38
|
-
|
|
50
|
+
]
|
|
39
51
|
}
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"title": "BundleSizeBaseline",
|
|
5
5
|
"description": "Per-kind baseline schema for the bundle-size gate. Extends the shared baseline-envelope contract.",
|
|
6
6
|
"allOf": [{ "$ref": "baseline-envelope.schema.json" }],
|
|
7
|
+
"required": ["rows"],
|
|
7
8
|
"type": "object",
|
|
8
9
|
"properties": {
|
|
9
10
|
"rows": {
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"title": "CoverageBaseline",
|
|
5
5
|
"description": "Per-kind baseline schema for the coverage gate. Extends the shared baseline-envelope contract.",
|
|
6
6
|
"allOf": [{ "$ref": "baseline-envelope.schema.json" }],
|
|
7
|
+
"required": ["rows"],
|
|
7
8
|
"type": "object",
|
|
8
9
|
"properties": {
|
|
9
10
|
"rows": {
|
|
@@ -2,8 +2,12 @@
|
|
|
2
2
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
3
|
"$id": "https://mandrel/.agents/schemas/baselines/crap.schema.json",
|
|
4
4
|
"title": "CrapBaselineV2",
|
|
5
|
-
"description": "Per-kind baseline schema for the CRAP gate, envelope-shaped. Extends the shared baseline-envelope contract. Distinct from the legacy crap-baseline.schema.json which used a flat shape.",
|
|
6
|
-
"allOf": [
|
|
5
|
+
"description": "Per-kind baseline schema for the CRAP gate, envelope-shaped. Extends the shared baseline-envelope contract. On disk the rows are grouped under `files` (each path once, each method key on its own line); the previous `rows[]` layout still validates so it reaches the scoring-semantics compat axis, which refuses it with the full-scope re-seed command. Distinct from the legacy crap-baseline.schema.json which used a flat shape.",
|
|
6
|
+
"allOf": [
|
|
7
|
+
{
|
|
8
|
+
"$ref": "baseline-envelope.schema.json"
|
|
9
|
+
}
|
|
10
|
+
],
|
|
7
11
|
"type": "object",
|
|
8
12
|
"properties": {
|
|
9
13
|
"scoringSemantics": {
|
|
@@ -12,28 +16,51 @@
|
|
|
12
16
|
},
|
|
13
17
|
"provenanceStamped": {
|
|
14
18
|
"type": "boolean",
|
|
15
|
-
"description": "
|
|
19
|
+
"description": "Legacy stamp, no longer written (the persisted row carries no line coordinate to qualify). Accepted only so a baseline from before the grouped layout reaches the scoring-semantics compat axis rather than a raw schema error."
|
|
16
20
|
},
|
|
17
21
|
"rows": {
|
|
18
22
|
"type": "array",
|
|
19
23
|
"items": {
|
|
20
24
|
"type": "object",
|
|
21
|
-
"required": ["path", "method", "
|
|
25
|
+
"required": ["path", "method", "crap"],
|
|
22
26
|
"additionalProperties": false,
|
|
23
27
|
"properties": {
|
|
24
|
-
"path": {
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
"
|
|
28
|
+
"path": {
|
|
29
|
+
"type": "string"
|
|
30
|
+
},
|
|
31
|
+
"method": {
|
|
32
|
+
"type": "string"
|
|
33
|
+
},
|
|
34
|
+
"startLine": {
|
|
35
|
+
"type": "integer",
|
|
36
|
+
"minimum": 1,
|
|
37
|
+
"description": "Previous rows[] layout only. The persisted CRAP identity is path::method; startLine lives on scan rows in memory."
|
|
38
|
+
},
|
|
39
|
+
"crap": {
|
|
40
|
+
"type": "number",
|
|
41
|
+
"minimum": 0
|
|
42
|
+
},
|
|
28
43
|
"anonymous": {
|
|
29
44
|
"enum": [true],
|
|
30
|
-
"description": "
|
|
45
|
+
"description": "Previous rows[] layout only; an anonymous key is recognisable by its `<anon ` prefix."
|
|
31
46
|
},
|
|
32
47
|
"coordinateSystem": {
|
|
33
48
|
"enum": ["transpiled"],
|
|
34
|
-
"description": "
|
|
49
|
+
"description": "Previous rows[] layout only; it qualified startLine, which the persisted identity no longer carries."
|
|
35
50
|
}
|
|
36
51
|
}
|
|
52
|
+
},
|
|
53
|
+
"description": "In-memory row shape `{ path, method, crap }`, which writers validate before encoding; on disk only the previous layout carries rows[]."
|
|
54
|
+
},
|
|
55
|
+
"files": {
|
|
56
|
+
"type": "object",
|
|
57
|
+
"description": "The grouped on-disk layout: canonical path (sorted) to an object of `\"<method key>\": <crap>` entries (sorted by key). A method key is its scope path — enclosing method segments joined by `/`, ending in its own name — with `#<n>` on a later method that would repeat an earlier key in the same file; an anonymous key is wrapped as `<anon …>`. Identity is path::method; no line number is persisted.",
|
|
58
|
+
"additionalProperties": {
|
|
59
|
+
"type": "object",
|
|
60
|
+
"additionalProperties": {
|
|
61
|
+
"type": "number",
|
|
62
|
+
"minimum": 0
|
|
63
|
+
}
|
|
37
64
|
}
|
|
38
65
|
}
|
|
39
66
|
}
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"title": "DuplicationBaselineV2",
|
|
5
5
|
"description": "Per-kind baseline schema for the code-duplication (DRY) gate, envelope-shaped. Extends the shared baseline-envelope contract. Rows record per-file copy-paste duplication reported by a clone detector (jscpd); the rollup recomputes an exact aggregate ratio from raw line counts.",
|
|
6
6
|
"allOf": [{ "$ref": "baseline-envelope.schema.json" }],
|
|
7
|
+
"required": ["rows"],
|
|
7
8
|
"type": "object",
|
|
8
9
|
"properties": {
|
|
9
10
|
"rows": {
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"title": "MaintainabilityBaseline",
|
|
5
5
|
"description": "Per-kind baseline schema for the Maintainability Index (MI) gate. Extends the shared baseline-envelope contract. Story #2193: the row axis stays `mi`; rollups expose `min` / `p50` / `p95` axes, and configured floors under `delivery.quality.gates.maintainability.floors[*]` target those rollup axes (the framework default is `{ min: 70 }`).",
|
|
6
6
|
"allOf": [{ "$ref": "baseline-envelope.schema.json" }],
|
|
7
|
+
"required": ["rows"],
|
|
7
8
|
"type": "object",
|
|
8
9
|
"properties": {
|
|
9
10
|
"rows": {
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
"title": "MutationBaseline",
|
|
5
5
|
"description": "Per-kind baseline schema for the mutation-testing gate. Extends the shared baseline-envelope contract.",
|
|
6
6
|
"allOf": [{ "$ref": "baseline-envelope.schema.json" }],
|
|
7
|
+
"required": ["rows"],
|
|
7
8
|
"type": "object",
|
|
8
9
|
"properties": {
|
|
9
10
|
"rows": {
|
|
@@ -40,17 +40,17 @@
|
|
|
40
40
|
"incomparable": {
|
|
41
41
|
"type": "integer",
|
|
42
42
|
"minimum": 0,
|
|
43
|
-
"description": "
|
|
43
|
+
"description": "Deprecated: always 0. The compare that refused methods with differing line-coordinate provenance was removed when CRAP rows stopped being keyed by startLine; kept for envelope compatibility."
|
|
44
44
|
},
|
|
45
45
|
"provenanceMismatched": {
|
|
46
46
|
"type": "integer",
|
|
47
47
|
"minimum": 0,
|
|
48
|
-
"description": "
|
|
48
|
+
"description": "Deprecated: always 0. CRAP rows no longer carry a line coordinate, so there is no provenance to mismatch; kept for envelope compatibility."
|
|
49
49
|
},
|
|
50
50
|
"unscorable": {
|
|
51
51
|
"type": "integer",
|
|
52
52
|
"minimum": 0,
|
|
53
|
-
"description": "Story #4871: methods the scan could not score because no coverage artifact covered them. Reported rather than computed from an assumed zero percent coverage (which would drive CRAP maximal on untouched files)
|
|
53
|
+
"description": "Story #4871: methods the scan could not score because no coverage artifact covered them. Reported rather than computed from an assumed zero percent coverage (which would drive CRAP maximal on untouched files)."
|
|
54
54
|
},
|
|
55
55
|
"removed": { "type": "integer", "minimum": 0 },
|
|
56
56
|
"skippedNoCoverage": { "type": "integer", "minimum": 0 },
|
|
@@ -118,7 +118,7 @@
|
|
|
118
118
|
},
|
|
119
119
|
"diagnostics": {
|
|
120
120
|
"type": "array",
|
|
121
|
-
"description": "Story #4866: named, gate-level findings emitted INSTEAD of per-method verdicts when the gate has established that no verdict it could produce would be meaningful — an incomparable baseline
|
|
121
|
+
"description": "Story #4866: named, gate-level findings emitted INSTEAD of per-method verdicts when the gate has established that no verdict it could produce would be meaningful — an incomparable baseline or a baseline stamped ahead of the running code. Present only in that case; `violations` is then empty and the preview gate exits 0. `crap-unsound-comparison-basis` is a retired name kept in the enum for compatibility and no longer emitted.",
|
|
122
122
|
"items": {
|
|
123
123
|
"type": "object",
|
|
124
124
|
"required": ["name", "message"],
|
|
@@ -128,7 +128,8 @@
|
|
|
128
128
|
"type": "string",
|
|
129
129
|
"enum": [
|
|
130
130
|
"crap-unsound-comparison-basis",
|
|
131
|
-
"crap-baseline-incompatible"
|
|
131
|
+
"crap-baseline-incompatible",
|
|
132
|
+
"crap-baseline-ahead"
|
|
132
133
|
]
|
|
133
134
|
},
|
|
134
135
|
"message": { "type": "string" }
|
|
@@ -77,7 +77,7 @@
|
|
|
77
77
|
},
|
|
78
78
|
"gates": {
|
|
79
79
|
"type": "object",
|
|
80
|
-
"description": "Outcome of each close gate this invocation was responsible for. A gate the run skipped (--skip-validation, or a phase it never reached) reports \"skipped\" rather than being omitted, so a missing gate is never mistaken for a passing one. \"overridden\" is distinct from both: the gate ran, it FAILED, and an operator authorized delivery anyway via --override-review-block with a recorded reason. Reporting that as \"passed\" would erase the one fact a reader of this envelope most needs, and reporting it as \"skipped\" would claim the gate never ran. \"
|
|
80
|
+
"description": "Outcome of each close gate this invocation was responsible for. A gate the run skipped (--skip-validation, or a phase it never reached) reports \"skipped\" rather than being omitted, so a missing gate is never mistaken for a passing one. \"overridden\" is distinct from both: the gate ran, it FAILED, and an operator authorized delivery anyway via --override-review-block with a recorded reason. Reporting that as \"passed\" would erase the one fact a reader of this envelope most needs, and reporting it as \"skipped\" would claim the gate never ran. codeReview alone also reports \"unreviewed\" (a review produced no verdict at all: CLI not logged in, out of quota, unparseable output, a skipped optional reviewer, an unresolvable base), \"partial\" (part of the diff went unreviewed) and \"degraded\" (the diff was reviewed with reduced context only), with precedence overridden > unreviewed > partial > degraded > passed. All three are reported, not blocking, unless delivery.codeReview.onNoVerdict is \"block\", which halts on unreviewed or partial. \"deferred\" (coverage-capture only, Story #5949) means the capture script declared its slice over this host's budget (exit 76) under coverage.onOverBudget: defer-to-ci, or that coverage.suiteOfRecord: ci (Story #5955) deferred it before anything spawned — no suite ran, the coverage-reading gates report \"skipped\", and CI owns the run.",
|
|
81
81
|
"additionalProperties": {
|
|
82
82
|
"type": "string",
|
|
83
83
|
"enum": [
|
|
@@ -85,6 +85,8 @@
|
|
|
85
85
|
"failed",
|
|
86
86
|
"skipped",
|
|
87
87
|
"overridden",
|
|
88
|
+
"unreviewed",
|
|
89
|
+
"partial",
|
|
88
90
|
"degraded",
|
|
89
91
|
"deferred"
|
|
90
92
|
]
|
|
@@ -104,6 +106,10 @@
|
|
|
104
106
|
"epicRollup"
|
|
105
107
|
],
|
|
106
108
|
"properties": {
|
|
109
|
+
"reviewRecord": {
|
|
110
|
+
"type": "boolean",
|
|
111
|
+
"description": "The merged PR carries a verification-results review record: close's own post (details.reviewRecord already-recorded), the handoff deposit matching the merged head posted at land (posted-from-deposit), or an Unreviewed marker (unreviewed-no-deposit | unreviewed-stale-deposit). A tail run without a PR number reports true with no-pr. Only a failed read or post reports false, and like every tail step that degrades the report, never the land."
|
|
112
|
+
},
|
|
107
113
|
"followUps": { "type": "boolean" },
|
|
108
114
|
"statusResync": { "type": "boolean" },
|
|
109
115
|
"worktreeReap": {
|
|
@@ -169,7 +175,12 @@
|
|
|
169
175
|
"description": "Present iff status === \"failed\".",
|
|
170
176
|
"required": ["reason"],
|
|
171
177
|
"properties": {
|
|
172
|
-
"reason": { "type": "string", "minLength": 1 }
|
|
178
|
+
"reason": { "type": "string", "minLength": 1 },
|
|
179
|
+
"baselinesKinds": {
|
|
180
|
+
"type": "array",
|
|
181
|
+
"description": "Story #5956 — the check-baselines kinds that reported FAIL when close failed on a baselines entry; omitted when no kind line parsed.",
|
|
182
|
+
"items": { "type": "string", "minLength": 1 }
|
|
183
|
+
}
|
|
173
184
|
},
|
|
174
185
|
"additionalProperties": false
|
|
175
186
|
},
|
|
@@ -232,6 +243,18 @@
|
|
|
232
243
|
"ageSeconds": { "type": ["number", "null"], "minimum": 0 }
|
|
233
244
|
},
|
|
234
245
|
"additionalProperties": false
|
|
246
|
+
},
|
|
247
|
+
"admission": {
|
|
248
|
+
"type": "object",
|
|
249
|
+
"description": "Story #5963 — what the last declared run that waited was admitted at: its booked weight, the entry's declared weight, the sized slice's test-file count (null when unsized) and whether it backfilled ahead of an earlier waiter.",
|
|
250
|
+
"required": ["weight", "declaredWeight", "sliceFiles", "backfilled"],
|
|
251
|
+
"properties": {
|
|
252
|
+
"weight": { "type": "integer", "minimum": 1 },
|
|
253
|
+
"declaredWeight": { "type": "integer", "minimum": 1 },
|
|
254
|
+
"sliceFiles": { "type": ["integer", "null"], "minimum": 0 },
|
|
255
|
+
"backfilled": { "type": "boolean" }
|
|
256
|
+
},
|
|
257
|
+
"additionalProperties": false
|
|
235
258
|
}
|
|
236
259
|
},
|
|
237
260
|
"additionalProperties": false
|
|
@@ -266,6 +289,22 @@
|
|
|
266
289
|
"description": "Story #5417 — wall-clock seconds per close phase that ran (wrong-tree-guard, base-sync, close-validation, push, pull-request, code-review, auto-merge, confirm-merge, post-land). Optional and additive; absent or null when no phase was timed.",
|
|
267
290
|
"additionalProperties": { "type": "number", "minimum": 0 }
|
|
268
291
|
},
|
|
292
|
+
"baseSync": {
|
|
293
|
+
"type": ["object", "null"],
|
|
294
|
+
"description": "Story #5954 — close's base-sync decision under delivery.close.baseSync: mode (always | on-conflict), outcome (merged | already-current | skipped), reason (the mode itself, conflict-free on a skip, or the probe answer that forced a merge: conflict, intersects, unsupported, fetch-failed, already-current) and incoming (paths the base brought in). Optional and additive; null when no sync ran (--skip-sync, or a PR that had already landed).",
|
|
295
|
+
"required": ["mode", "outcome", "reason", "incoming"],
|
|
296
|
+
"properties": {
|
|
297
|
+
"mode": { "enum": ["always", "on-conflict"] },
|
|
298
|
+
"outcome": { "enum": ["merged", "already-current", "skipped"] },
|
|
299
|
+
"reason": { "type": "string", "minLength": 1 },
|
|
300
|
+
"incoming": { "type": "integer", "minimum": 0 }
|
|
301
|
+
},
|
|
302
|
+
"additionalProperties": false
|
|
303
|
+
},
|
|
304
|
+
"pushOutcome": {
|
|
305
|
+
"enum": ["pushed", "skipped-already-at-head", null],
|
|
306
|
+
"description": "Story #5967 — whether close's PR-opening push ran or was skipped because origin already held the Story-branch tip (read phaseDurations.push against it). Optional and additive; absent on every non-close envelope, null when the PR had already landed."
|
|
307
|
+
},
|
|
269
308
|
"timestamp": { "type": "string", "format": "date-time" }
|
|
270
309
|
},
|
|
271
310
|
"allOf": [
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
"phase": {
|
|
27
27
|
"type": "string",
|
|
28
28
|
"minLength": 1,
|
|
29
|
-
"description": "For close, the phase name close passes to setPhase (the phaseDurations keys). For handoff, the step name:
|
|
29
|
+
"description": "For close, the phase name close passes to setPhase (the phaseDurations keys). For handoff, the step name: base-merge, duplication-rescore, seat-static, preflight, credited-run, seat, post-capture, push, review."
|
|
30
30
|
},
|
|
31
31
|
"stageStartedAt": {
|
|
32
32
|
"type": "string",
|