Skip to content

rill-project-html-digest: decision-material digest at /project read moments - #88

Merged
tarr1124 merged 1 commit into
mainfrom
feature/rill-project-html-digest
Aug 13, 2026
Merged

tarr1124 merged 1 commit into
mainfrom
feature/rill-project-html-digest

Conversation

@tarr1124

Copy link
Copy Markdown
Contributor

Implements the third layer of the read-moment HTML generation model (ADR-082 Phase 2 / G5), after /focus (#86) and /close (#87): /project generates a decision-material HTML digest into projects/{slug}/.view/ at its two read moments — status mode (after the overview render) and run mode on stop (after the run summary).

Plan summary

  • New section "Project Digest (read-moment HTML)" in skills/project/SKILL.md: one generator, two section weightings (run-end leads with stop reason + pending decisions + next actions; status leads with current position + next actions)
  • Ordering: derived views first — /refresh-project current at the read moment (re-run at a run stop), then /refresh-decisions synchronously, then read the refreshed MD sources; on refresh failure/timeout, skip generation (a snapshot must not freeze stale material)
  • Pending decisions re-express the contract-v1.1 fields (Decision / Background / Choices / Default / Blocks / More, ADR-084); consequence-framed and zero-context readable (D82-8 / D84-7) — no internal labels on the page
  • Dated snapshots digest-{YYYY-MM-DD}.html (-2, -3 same-day), claimed by exclusive creation, never overwritten; self-contained; provenance comment; non-fatal with partial-file cleanup; user skip line
  • run mode Step 3 persists the run summary as a project artifact (NNN-run-summary-{date}.md) so the run-end digest stays a pure derived view (rill-html-output.md principle 4), covered by the final rill push

Codex review

  • Round 1: 1 [P2] (stale /refresh-project at run stop) — fixed: fresh recompute required at the stop moment
  • Round 2: 2 [P2] (no refresh-success guard before an immutable snapshot; concurrent same-name snapshot writes) — fixed: skip-on-stale-refresh + exclusive-creation naming
  • Round 3: 0 P-findings

PUBLIC guards: CJK guard pass; non-ASCII in diff limited to § and (both pre-existing in this file); no PII / email / phone.

🤖 Generated with Claude Code

…oments

Wire the "project review" read moment of rill-html-output.md into
skills/project/SKILL.md, completing the three-layer read-moment model
(ADR-082 Phase 2 / G5) after /focus (#86) and /close (#87):

- New section "Project Digest (read-moment HTML)": one generator, two
  section weightings (run-end leads with stop reason + pending decisions
  + next actions; status leads with current position + next actions)
- Ordering: refresh-project (already run) -> refresh-decisions
  (synchronous) -> read refreshed sources -> generate
- Pending decisions re-express the contract-v1.1 fields (ADR-084);
  consequence-framed, zero-context readable (D82-8 / D84-7)
- Dated snapshots at projects/{slug}/.view/digest-{YYYY-MM-DD}.html,
  never overwritten; self-contained; provenance comment; non-fatal with
  partial-file cleanup; skip line
- Run mode Step 3 persists the run summary as a project artifact
  (NNN-run-summary-{date}.md) so the run-end digest stays a pure
  derived view (principle 4), and the final rill push covers it
@tarr1124
tarr1124 merged commit 56b4743 into main Aug 13, 2026
4 checks passed
@tarr1124
tarr1124 deleted the feature/rill-project-html-digest branch August 13, 2026 11:35
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