chore: sync managed files with align 17.3.0 #13

Merged
jercik merged 1 commit from chore/align-17-3-0 into main 2026-10-27 12:18:59 +00:00
Owner

Syncs managed files with @j4k/align 17.3.0 (j4k-align --fix).

Only the managed workflows changed: checks.yml, dedupe-check.yml and release.yml.

🤖 Generated with Claude Code

Syncs managed files with `@j4k/align` 17.3.0 (`j4k-align --fix`). Only the managed workflows changed: `checks.yml`, `dedupe-check.yml` and `release.yml`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
chore: sync managed files with align 17.3.0
All checks were successful
Checks / reuse (pull_request) Has been skipped
Checks / pr-flow-canary (pull_request) Has been skipped
commit-msg / commitlint (pull_request) Successful in 4s
Checks / quality-checks (26.12.1) (pull_request) Successful in 31s
Checks / quality-checks (24.15.0) (pull_request) Successful in 45s
Checks / qc-result (pull_request) Has been skipped
Review / Review (pull_request_target) Successful in 2m8s
ca14c6a74d
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Review 01M5YK359SGYPA21KS204JWNPS — head ca14c6a74d2495fe986479254a235aa5d12193a5

Review — j4k-oss/perplexity-agent-mcp @ 6aa040c688

Scope: diff against base tree f94d2a07180d
Review finished: 5 succeeded, 0 failed, 5 skipped by dispatch
Triage: settled
Facts: current review-wide projection

Computed under:

{
  "abandonment": "abandonment-v1",
  "anchor_recipe": 1,
  "batch_policy": "batch-v1",
  "coverage": "coverage-v3",
  "dispatch_policy": "dispatch-v2",
  "grounder_version": 1,
  "grounding_read_rule": "grounding-read-v1",
  "promotion_policy": "promotion-v1",
  "report": "report-v5",
  "tally": "tally-v1",
  "triage_settle": "triage-settle-v2"
}

Findings (1)

medium — release.yml points readers to an ADR file that does not exist in the repository

  • claim: 01M5YK549Z44MY7K734Y3BR7PV
  • anchor: .forgejo/workflows/release.yml (snippet)
a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md).
  • lens: writing-quality · arm: default
  • verdicts: 1 valid / 0 invalid / 0 uncertain
    • pass 01M5YK5JHD8VS1FBQXHJD0PS7F · valid: Grounded exact snippet confirms release.yml's header comment delegates the same-tree reuse rationale to docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md. The reviewer's concrete trace (ls docs fails; find for *.md returns only README.md, AGENTS.md, CLAUDE.md; grep for adr/same-tree across .forgejo and docs) shows the target is absent, and the independent general-bug claim reports the same tree listing and that the diff touches only the three workflow files and adds no ADR. Nothing in the batch shows the file exists. A relative repo path that resolves to nothing sends the maintainer to a dead end for the decision's rationale; even if the ADR lives in a template repository that renders these workflows, the pointer as written does not say so, so the defect stands either way (the fix would then belong in that template). The proposed remedies (add the ADR, name the other repository, or drop the path and let the checks.yml reuse-job comment carry the explanation) are appropriate. Severity: I would rate this low rather than medium; it is a broken documentation pointer with no runtime effect, though it does hide the rationale for a gate-relaxing design.
  • duplicates: 01M5YK57YS3PWX71H2DEDYKVV6 (general-bug)
  • disposition: none

The header comment of release.yml sends the reader to docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md for why the release gate may reuse a pull request pass. That file is not in the tree: the repository has no docs/ directory at all, and the only Markdown files are README.md, AGENTS.md and CLAUDE.md. The comment is the only place the new reuse design's rationale is delegated to, so a maintainer who follows it finds nothing and cannot learn why a green PR run on the same tree is accepted in place of a full release-time run, or why the 24-hour window applies. The comment reads: 'the release gate verifies the merged revision before publishing: it runs the managed quality suite, or reuses a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md).' The checks.yml comment above the reuse job states the mechanism but not the decision rationale or rejected alternatives, so it does not substitute. Correction: either add the ADR in this repository, or (if the ADR lives in another repository, such as the one that renders these workflows) name that repository in the pointer, or drop the path and let the reuse job comment in checks.yml carry the explanation. Examined: unpacked tree listing (ls docs fails; find . -name '*.md' returns three files), grep for 'adr' and 'same-tree' across .forgejo, AGENTS.md and README.md, and the full diff of the three workflow files. Not verifiable from here: whether the ADR exists in a template or monorepo that j4k-align renders from; if it does, the pointer must say so.

Other claims

  • grounding-pending (0)
  • ungrounded (0)
  • rejected (0)
  • duplicate-of (1)
    • 01M5YK57YS3PWX71H2DEDYKVV6 low — release.yml cites an ADR file that does not exist in the repository → 01M5YK549Z44MY7K734Y3BR7PV
  • unadjudicated (0)

Coverage

Coverage pass: 01M5YK359W09PDVY0JSPT2NZHM
Accounting: complete (all slots terminal; see slot results for failures)
Slot health: healthy

lens part arm unit status runs loss
general-bug whole default claims-emitted 1 no
writing-quality whole default claims-emitted 1 no
restated-sets whole default no-claims 1 no
project-docs whole default no-claims 1 no
unix-cli whole default no-claims 1 no
  • test-trimming — skipped-by-dispatch: no tests changed
  • use-effect — skipped-by-dispatch: only CI workflow YAML changed; no React code
  • react — skipped-by-dispatch: only CI workflow YAML changed; no React code
  • module-design — skipped-by-dispatch: no code changed; all paths are workflow YAML
  • aposd-plain — skipped-by-dispatch: no code changed; all paths are workflow YAML
<!-- review:summary --> **Review** `01M5YK359SGYPA21KS204JWNPS` — head `ca14c6a74d2495fe986479254a235aa5d12193a5` # Review — j4k-oss/perplexity-agent-mcp @ 6aa040c688b3 Scope: diff against base tree `f94d2a07180d` Review finished: 5 succeeded, 0 failed, 5 skipped by dispatch Triage: settled Facts: current review-wide projection Computed under: ```json { "abandonment": "abandonment-v1", "anchor_recipe": 1, "batch_policy": "batch-v1", "coverage": "coverage-v3", "dispatch_policy": "dispatch-v2", "grounder_version": 1, "grounding_read_rule": "grounding-read-v1", "promotion_policy": "promotion-v1", "report": "report-v5", "tally": "tally-v1", "triage_settle": "triage-settle-v2" } ``` ## Findings (1) ### medium — release.yml points readers to an ADR file that does not exist in the repository - claim: `01M5YK549Z44MY7K734Y3BR7PV` - anchor: `.forgejo/workflows/release.yml` (snippet) ``` a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md). ``` - lens: writing-quality · arm: default - verdicts: 1 valid / 0 invalid / 0 uncertain - pass `01M5YK5JHD8VS1FBQXHJD0PS7F` · valid: Grounded exact snippet confirms release.yml's header comment delegates the same-tree reuse rationale to docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md. The reviewer's concrete trace (ls docs fails; find for *.md returns only README.md, AGENTS.md, CLAUDE.md; grep for adr/same-tree across .forgejo and docs) shows the target is absent, and the independent general-bug claim reports the same tree listing and that the diff touches only the three workflow files and adds no ADR. Nothing in the batch shows the file exists. A relative repo path that resolves to nothing sends the maintainer to a dead end for the decision's rationale; even if the ADR lives in a template repository that renders these workflows, the pointer as written does not say so, so the defect stands either way (the fix would then belong in that template). The proposed remedies (add the ADR, name the other repository, or drop the path and let the checks.yml reuse-job comment carry the explanation) are appropriate. Severity: I would rate this low rather than medium; it is a broken documentation pointer with no runtime effect, though it does hide the rationale for a gate-relaxing design. - duplicates: `01M5YK57YS3PWX71H2DEDYKVV6` (general-bug) - disposition: none > The header comment of release.yml sends the reader to `docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md` for why the release gate may reuse a pull request pass. That file is not in the tree: the repository has no `docs/` directory at all, and the only Markdown files are README.md, AGENTS.md and CLAUDE.md. The comment is the only place the new reuse design's rationale is delegated to, so a maintainer who follows it finds nothing and cannot learn why a green PR run on the same tree is accepted in place of a full release-time run, or why the 24-hour window applies. The comment reads: 'the release gate verifies the merged revision before publishing: it runs the managed quality suite, or reuses a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md).' The checks.yml comment above the `reuse` job states the mechanism but not the decision rationale or rejected alternatives, so it does not substitute. Correction: either add the ADR in this repository, or (if the ADR lives in another repository, such as the one that renders these workflows) name that repository in the pointer, or drop the path and let the `reuse` job comment in checks.yml carry the explanation. Examined: unpacked tree listing (`ls docs` fails; `find . -name '*.md'` returns three files), grep for 'adr' and 'same-tree' across .forgejo, AGENTS.md and README.md, and the full diff of the three workflow files. Not verifiable from here: whether the ADR exists in a template or monorepo that j4k-align renders from; if it does, the pointer must say so. ## Other claims - grounding-pending (0) - ungrounded (0) - rejected (0) - duplicate-of (1) - `01M5YK57YS3PWX71H2DEDYKVV6` low — release.yml cites an ADR file that does not exist in the repository → `01M5YK549Z44MY7K734Y3BR7PV` - unadjudicated (0) ## Coverage Coverage pass: 01M5YK359W09PDVY0JSPT2NZHM Accounting: complete (all slots terminal; see slot results for failures) Slot health: healthy | lens | part | arm | unit status | runs | loss | | --- | --- | --- | --- | --- | --- | | general-bug | whole | default | claims-emitted | 1 | no | | writing-quality | whole | default | claims-emitted | 1 | no | | restated-sets | whole | default | no-claims | 1 | no | | project-docs | whole | default | no-claims | 1 | no | | unix-cli | whole | default | no-claims | 1 | no | - test-trimming — skipped-by-dispatch: no tests changed - use-effect — skipped-by-dispatch: only CI workflow YAML changed; no React code - react — skipped-by-dispatch: only CI workflow YAML changed; no React code - module-design — skipped-by-dispatch: no code changed; all paths are workflow YAML - aposd-plain — skipped-by-dispatch: no code changed; all paths are workflow YAML
@ -5,1 +4,3 @@
# managed quality suite on the merged revision before publishing.
# Required PR status checks are intentionally disabled, so the release gate verifies
# the merged revision before publishing: it runs the managed quality suite, or reuses
# a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md).

medium — release.yml points readers to an ADR file that does not exist in the repository

The header comment of release.yml sends the reader to docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md for why the release gate may reuse a pull request pass. That file is not in the tree: the repository has no docs/ directory at all, and the only Markdown files are README.md, AGENTS.md and CLAUDE.md. The comment is the only place the new reuse design's rationale is delegated to, so a maintainer who follows it finds nothing and cannot learn why a green PR run on the same tree is accepted in place of a full release-time run, or why the 24-hour window applies. The comment reads: 'the release gate verifies the merged revision before publishing: it runs the managed quality suite, or reuses a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md).' The checks.yml comment above the reuse job states the mechanism but not the decision rationale or rejected alternatives, so it does not substitute. Correction: either add the ADR in this repository, or (if the ADR lives in another repository, such as the one that renders these workflows) name that repository in the pointer, or drop the path and let the reuse job comment in checks.yml carry the explanation. Examined: unpacked tree listing (ls docs fails; find . -name '*.md' returns three files), grep for 'adr' and 'same-tree' across .forgejo, AGENTS.md and README.md, and the full diff of the three workflow files. Not verifiable from here: whether the ADR exists in a template or monorepo that j4k-align renders from; if it does, the pointer must say so.

lens writing-quality · arm default · tally 1 valid / 0 invalid / 0 uncertain
claim 01M5YK549Z44MY7K734Y3BR7PV of review 01M5YK359SGYPA21KS204JWNPS

<!-- review:claim:01M5YK549Z44MY7K734Y3BR7PV --> **medium** — release.yml points readers to an ADR file that does not exist in the repository > The header comment of release.yml sends the reader to `docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md` for why the release gate may reuse a pull request pass. That file is not in the tree: the repository has no `docs/` directory at all, and the only Markdown files are README.md, AGENTS.md and CLAUDE.md. The comment is the only place the new reuse design's rationale is delegated to, so a maintainer who follows it finds nothing and cannot learn why a green PR run on the same tree is accepted in place of a full release-time run, or why the 24-hour window applies. The comment reads: 'the release gate verifies the merged revision before publishing: it runs the managed quality suite, or reuses a pull request pass on the same tree (docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md).' The checks.yml comment above the `reuse` job states the mechanism but not the decision rationale or rejected alternatives, so it does not substitute. Correction: either add the ADR in this repository, or (if the ADR lives in another repository, such as the one that renders these workflows) name that repository in the pointer, or drop the path and let the `reuse` job comment in checks.yml carry the explanation. Examined: unpacked tree listing (`ls docs` fails; `find . -name '*.md'` returns three files), grep for 'adr' and 'same-tree' across .forgejo, AGENTS.md and README.md, and the full diff of the three workflow files. Not verifiable from here: whether the ADR exists in a template or monorepo that j4k-align renders from; if it does, the pointer must say so. lens `writing-quality` · arm `default` · tally 1 valid / 0 invalid / 0 uncertain claim `01M5YK549Z44MY7K734Y3BR7PV` of review `01M5YK359SGYPA21KS204JWNPS`
Author
Owner

The release.yml header comment points at docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md, which does not exist in this repository. Verified: the reference is in the rendered template, not in repo-owned input, so the fix belongs in @j4k/align (the file is managed and not edited here). Deferred; reported to the rollout owner.

The `release.yml` header comment points at `docs/adr/0004-forgejo-checks-reuse-same-tree-passes.md`, which does not exist in this repository. Verified: the reference is in the rendered template, not in repo-owned input, so the fix belongs in `@j4k/align` (the file is managed and not edited here). Deferred; reported to the rollout owner.
jercik merged commit 9fe4b5bb14 into main 2026-10-27 12:18:59 +00:00
jercik deleted branch chore/align-17-3-0 2026-10-27 12:18:59 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
j4k-oss/perplexity-agent-mcp!13
No description provided.