Skip to content

Spec 5: first-class incident reports (v0.5.0) - #12

Merged
clark-mackey merged 2 commits into
mainfrom
claude/amazing-jackson-e13639
Jul 6, 2026
Merged

Spec 5: first-class incident reports (v0.5.0)#12
clark-mackey merged 2 commits into
mainfrom
claude/amazing-jackson-e13639

Conversation

@clark-mackey

Copy link
Copy Markdown
Owner

Summary

Promotes v0.5.0 from development to main.

Spec 5 — first-class incident reports (design: project/specs/SPEC-05-first-class-incident-reports.md on development, approved 2026-06-01):

  • INCIDENT_template.md — lightweight, ADR-style standalone incident report (frontmatter linking, Summary/Timeline/Root Cause/Resolution/Prevention/Detection/Files; word severities, no SEV-N enterprise weight)
  • incidents.py — tolerant stdlib parser + index builder; filename YYYY-MM-DD-slug.md date is authoritative, handles human-formatted header dates, BOM, missing fields (validated against 5 real pre-existing incident files with zero edits)
  • lfg incidents-index — rebuilds logs/incidents/README.md index table (Date | Severity | Status | Incident)
  • Installer seeds the template + index — un-orphans the logs/incidents/ directory the installer already created
  • Rules/DEVLOG template — inline 🚨 INCIDENT DEVLOG entry stays the default; standalone report is the documented escalation path
  • Template-hash manifest hardeningupdate_template_hashes.py now normalizes BOM + CRLF/CR→LF before hashing (mirrors check-version.py), so the manifest and --match-dir recognition no longer depend on the checkout's line endings; manifest rebuilt on the normalized basis (0.3.0 from tag, 0.4.0 from what actually shipped, 0.5.0 from HEAD)
  • Docs: log_file_how_to.md, INSTALL, CONTRIBUTING, README

Test plan

  • 222 passed on development (Windows, CRLF working copy)
  • 221 passed + 1 expected skip on this branch (dogfood archive test skips — no logs/ on main)
  • Smoke coverage: install seeds incidents dir/template/index (smoke_install.{sh,ps1})

🤖 Generated with Claude Code

clark-mackey and others added 2 commits July 5, 2026 22:35
Promote v0.5.0 from development to main:
- INCIDENT_template.md — ADR-style lightweight incident report template
- incidents.py — tolerant stdlib parser + index builder for logs/incidents/
- lfg incidents-index — CLI verb to (re)build logs/incidents/README.md
- Installer seeds the incident template and index; un-orphans logs/incidents/
- Inline DEVLOG INCIDENT entry stays the default; standalone report is the
  escalation path (rule + DEVLOG template note)
- Template-hash manifest: normalize BOM/EOL before hashing (cross-platform);
  manifest rebuilt on normalized basis
- Docs: log_file_how_to, INSTALL, CONTRIBUTING, README updated

222 tests green on development; 221+1 expected skip here (no logs/ on main).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
clark-mackey added a commit that referenced this pull request Jul 6, 2026
…0.5.0 state

- CHANGELOG rebuilt: v0.3.0/v0.4.0/v0.5.0 version blocks cut from the
  entries pooled in [Unreleased] since February; mojibake emoji fixed;
  header 'current state' pointer moved from DEVLOG to STATE.md;
  template-guidelines cruft removed
- STATE.md rewritten to actual now (v0.5.0 pending, PR #12, objectives)
- DEVLOG: incident entry + Specs 1-5 catch-up narrative
- First standalone incident report filed (dogfoods Spec 5) and
  logs/incidents/README.md generated via lfg incidents-index
- PRD Current State refreshed to July 2026 / v0.5.0; change-log rows
  added for Spec 4 + Spec 5; test count corrected 80 -> 222
- Dogfood config version bumped 0.2.0 -> 0.5.0

lfg validate: 0 errors (4 warnings: 2 pre-commit hash placeholders,
2 approaching-budget notices)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@clark-mackey
clark-mackey merged commit 0d622e8 into main Jul 6, 2026
6 checks passed
clark-mackey added a commit that referenced this pull request Jul 6, 2026
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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