Skip to content

Add a read-only preflight report for the output, cache and backup folders (#53) - #277

Merged
Jumpstile merged 1 commit into
mainfrom
feat/preflight-report
Nov 17, 2026
Merged

Jumpstile merged 1 commit into
mainfrom
feat/preflight-report

Conversation

@Jumpstile

Copy link
Copy Markdown
Owner

Part of #53. Small local, read-only preflight check (the Integration Doctor described in #53 comments is not in main).

  • New public Get-ChannelForgePreflightReport (contract preflight-report/v1) plus a private helper file; one export line added to the manifest.
  • Checks per OutputRoot, CacheRoot and optional BackupRoot: exists (never creates), inside project, no link, writable (canary in .preflight, removed), free space (default floor 100 MB). Also: staging and final on one volume; published M3U and XMLTV match the manifest.
  • Unknown is never reported as Pass. Overall is the worst status.
  • Known limits: the published-file check stops at the first hash mismatch; the no-link failure message is generic; a fresh install with no cache folder reports Fail by design; no CLI or web entry point yet.
  • Tests (pwsh 7): PreflightReport (8), ModuleManifest, PathBoundaries and WriteGuardrails passed, 0 failed (count printed in the run log). Not tested: full suite, Windows PowerShell 5.1, UNC roots.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh

…ders (#53)

Get-ChannelForgePreflightReport (preflight-report/v1) checks, for OutputRoot, CacheRoot and an optional BackupRoot: exists, inside the project, not a link, writable (one tiny file in a .preflight subfolder, removed again) and free space. It also checks that staging and final share a volume and that the published M3U and XMLTV match their manifest. A check that cannot run is Unknown, never Pass. It never changes accepted state or published output.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh
@Jumpstile
Jumpstile merged commit 3578b2b into main Nov 17, 2026
11 checks passed
@Jumpstile
Jumpstile deleted the feat/preflight-report branch November 17, 2026 16:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant