Skip to content

Add canonical task-report archive and finalize-before-teardown gate - #1232

Closed
prandelicious wants to merge 5 commits into
kunchenguid:mainfrom
prandelicious:fm/firstmate-report-artifact-lifecycle
Closed

Add canonical task-report archive and finalize-before-teardown gate#1232
prandelicious wants to merge 5 commits into
kunchenguid:mainfrom
prandelicious:fm/firstmate-report-artifact-lifecycle

Conversation

@prandelicious

Copy link
Copy Markdown

Summary

  • Adds bin/fm-report-finalize.sh to archive scout reports and ship delivery receipts under data/reports/<project>/<task-id>.md, record report_archive= in task meta, and regenerate a per-project INDEX.md.
  • Requires finalization for ordinary ship and scout tasks in bin/fm-teardown.sh before destructive cleanup (--force still skips).
  • Clarifies scout brief report destinations as private FM_HOME paths; updates fleet snapshot to prefer archived paths; documents the contract in docs/task-report-archive.md.

Test plan

  • bash tests/fm-report-finalize.test.sh
  • bash tests/fm-decision-hold-lifecycle.test.sh
  • bin/fm-lint.sh
  • no-mistakes through lint (push used fork remote due to upstream permission)

Design tradeoffs

  • Working reports stay at data/<id>/report.md during the task; finalize copies into the archive without mass-moving historical reports.
  • Ship tasks get a short synthesized delivery receipt when no working report exists, rather than requiring a verbose report.
  • Post-teardown decision holds can resolve origins via archived report paths when working copies are absent.

Made with Cursor

prandelicious and others added 5 commits July 29, 2026 12:29
Ship and scout tasks now archive deliverables under data/reports/<project>/
through fm-report-finalize.sh before fm-teardown.sh proceeds, with focused
tests and docs/task-report-archive.md as the single contract owner.

Co-authored-by: Cursor <[email protected]>
… fm-report-lib.sh, note report_archive= meta field
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