Skip to content

[aw-failures] Daily AstroStyleLite Markdown Spellcheck: cspell --format flag unsupported (100% failure rate) #27350

@github-actions

Description

@github-actions

Run §24666802909 is the 3rd execution of this workflow and has failed each time (100% failure rate). The spellcheck job crashes with exit code 2 before any files are scanned.

Problem Statement

The workflow invokes cspell@8.19.4 lint --format json, but --format is not a recognized flag in this version:

error: unknown option '--format'
jq: invalid JSON text passed to --argjson
Process completed with exit code 2.

This is not a spelling error in any file — the spellcheck tool itself crashes before scanning anything. Zero tokens are consumed (agent job never reaches execution).

Affected Workflow & Runs

Job Execution Flow

Job Conclusion
activation ✅ success (16s)
spellcheck failure (16s) — --format flag unsupported
agent ⏭ skipped
detection ⏭ skipped
safe_outputs ⏭ skipped
conclusion ⏭ skipped

Root Cause

cspell@8.19.4 does not support the --format json CLI flag. The downstream jq --argjson call receives empty/invalid input and also exits with code 2. Because spellcheck fails before setting needs.spellcheck.outputs.has_findings, the agent job is unconditionally skipped via its gate condition (if: needs.spellcheck.outputs.has_findings == 'true').

Active Fix

PR #27340 on branch copilot/investigate-spellcheck-issue is actively investigating and fixing this issue. The Design Decision Gate and Test Quality Sentinel both ran on this PR branch and issued noops (no blocking issues found).

Proposed Remediation

One of:

  1. Pin cspell to a version that supports --format json (e.g., before the flag was removed)
  2. Replace --format json with the correct cspell@8.19.4 output option
  3. Capture cspell stdout without --format, then process via jq

Success Criteria

  • spellcheck job exits 0 (no findings) or exits non-zero with has_findings=true set — no crashes
  • Agent job runs when findings exist; correctly skipped when there are none
  • Workflow no longer reports failure when no spelling errors are present

References:

Generated by [aw] Failure Investigator (6h) · ● 577.3K ·

  • expires on Apr 27, 2026, 1:22 PM UTC

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions