Skip to content
Forgeplan

forgeplan journal

Show the decision journal — a chronological timeline of when artifacts were activated, superseded, deprecated, or renewed, annotated with their R_eff scores. Unlike log, which records every mutation, journal shows only decision events — the story you tell a new teammate.

When to use

Section titled “When to use”
  • Onboarding — “how did we get here?”
  • Retrospectives — which decisions aged well vs. got superseded
  • --risk mode: find active decisions without evidence (blind spots) on a time axis
  • Preparing release notes — extract everything activated since tag

Not to use when

Section titled “Not to use when”

Usage

Section titled “Usage”
forgeplan journal [OPTIONS]

Options

Section titled “Options”
  -t, --type <TYPE>  Filter by kind (adr, note, problem, solution)
      --risk         Show only at-risk decisions (no evidence, stale, low R_eff)
  -h, --help         Print help
  -V, --version      Print version

Examples

Section titled “Examples”

Full decision timeline:

Terminal window
forgeplan journal

Only ADRs — architectural record, smaller set:

Terminal window
forgeplan journal --type adr

Risk mode — active decisions without evidence or with stale proof:

Terminal window
forgeplan journal --risk

Output interpretation

Section titled “Output interpretation”

One line per decision event, newest first:

2026-04-11  ACTIVATE    PRD-046  R_eff=0.85   Docs v0.18.0 catch-up
2026-04-09  ACTIVATE    ADR-007  R_eff=1.00   Choose bm25 crate v2.3.2
2026-04-08  SUPERSEDE   PRD-018  → PRD-042    FPF KB vector search
2026-04-07  DEPRECATE   RFC-003  R_eff=0.10   (replaced by RFC-004)
ColumnMeaning
DateDate of the lifecycle event
EventACTIVATE / SUPERSEDE / DEPRECATE / RENEW / REOPEN
ArtifactID of the decision
R_effEffective trust (min(evidence_scores)), 0.00–1.00
TitleShort title

R_eff = 0.00 on an active decision is a red flag — it means no evidence is linked at all. --risk surfaces exactly these.

How it fits

Section titled “How it fits”

journal sits between log (raw mutations) and health (current rollup):

log         → journal    → health
everything    decisions    current state

Use it to tell the decision story; use health to see where you are now.

See also

Section titled “See also”