@zalom/plastic 2.0.0-alpha.9 → 2.0.1

package/scripts/session-usage

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# session-usage (intent 355, D10): read the harness transcripts since a cutoff
+# and report per session the model, calls, boot context, last context, median
+# step, steps over 5k, and cache read. Broken records are counted and named.
+#
+# Usage:
+#   session-usage [--since <iso8601>] [--format text|json] [--root <dir>] [--rate-limits <file>]
+#
+# Defaults: the root is ~/.claude/projects, the rate-limit cache is
+# ~/.plastic/.cache/rate-limits.json, and the cutoff is that cache's reset
+# time minus five hours, else the last five hours.
+#
+# Exit codes: 0 reported (unavailable included); 2 usage error.
+
+require "json"
+require "time"
+require_relative "lib/session_usage"
+
+FLAGS = %w[--since --format --root --rate-limits].freeze
+FORMATS = %w[text json].freeze
+
+def usage_abort(message)
+  warn "session-usage: #{message}"
+  warn "Usage: session-usage [--since <iso8601>] [--format text|json] [--root <dir>] [--rate-limits <file>]"
+  exit 2
+end
+
+def parse_args(argv)
+  usage_abort("every flag takes a value") if argv.length.odd?
+  opts = argv.each_slice(2).to_h
+  unknown = opts.keys - FLAGS
+  usage_abort("unknown flag #{unknown.first.inspect}") unless unknown.empty?
+  usage_abort("unknown format #{opts['--format'].inspect}") if opts["--format"] && !FORMATS.include?(opts["--format"])
+  opts
+end
+
+def parse_since(value)
+  value && Time.iso8601(value)
+rescue ArgumentError
+  usage_abort("--since #{value.inspect} is not an ISO 8601 time")
+end
+
+opts = parse_args(ARGV)
+usage = SessionUsage.new(
+  transcripts_root: File.expand_path(opts.fetch("--root", File.join(Dir.home, ".claude", "projects"))),
+  rate_limits_path: File.expand_path(opts.fetch("--rate-limits", File.join(Dir.home, ".plastic", ".cache", "rate-limits.json")))
+)
+report = usage.report(since: parse_since(opts["--since"]))
+if opts["--format"] == "json"
+  puts JSON.pretty_generate(report)
+else
+  print SessionUsage.render_text(report)
+end

package/scripts/skill-lint

@@ -2,11 +2,13 @@
 # encoding: UTF-8
 # frozen_string_literal: true
 
-# skill-lint: deterministic CLI over SkillLint (intent 85b).
+# skill-lint: deterministic CLI over SkillLint (intent 85b), plus one CLI-local
+# check (intent 341, G8, n1, C35).
 #
-# Runs the five structural skill checks (body-budget, frontmatter-validity,
-# bare-pointer, orphan-files, references-depth) over a directory of Agent
-# Skills and reports every violation. Mirrors `scripts/validate-intent`'s
+# Runs the five structural checks (body-budget, frontmatter-validity,
+# bare-pointer, orphan-files, references-depth) via SkillLint, then this
+# script's own refusal-restatement check, over a directory of Agent Skills,
+# and reports every violation. Mirrors `scripts/validate-intent`'s
 # CLI-over-lib shape and exit-code contract.
 #
 # Usage:
@@ -17,6 +19,112 @@
 
 require_relative "lib/skill_lint"
 
+# RefusalRestatementCheck (C35): a skill body must not restate, past a short
+# run of words, a refusal rule the conventions chapter already carries; it
+# must link that chapter instead. No-op when <skills_dir>/conventions/references
+# does not exist, so an older tree or a fixture dir with no conventions chapter
+# is unaffected.
+#
+# Deliberately lives in this CLI, not in scripts/lib/skill_lint.rb: C35 is a
+# doctrine-duplication check, one level removed from SkillLint's five
+# structural checks, and keeping it here means adding it touches only the
+# files this change is scoped to.
+class RefusalRestatementCheck
+  REFUSAL_KEYWORD_RE = /\brefus(e|es|ed|ing|al)\b/i
+  CONVENTIONS_LINK_RE = %r{conventions/references/|plastic-conventions}i
+
+  # How many consecutive normalized words must match, verbatim, between a
+  # skill's refusal paragraph and the doctrine text before it counts as a
+  # restatement rather than a coincidental shared phrase.
+  NGRAM = 6
+
+  def initialize(skills_dir)
+    @skills_dir = skills_dir
+  end
+
+  def run
+    doctrine = doctrine_blob
+    return [] unless doctrine
+
+    skill_md_paths.flat_map do |skill_md|
+      skill_dir = File.dirname(skill_md)
+      next [] if File.basename(skill_dir) == "conventions" # the source never restates itself
+
+      check_skill(skill_dir, skill_md, File.read(skill_md), doctrine)
+    end
+  end
+
+  private
+
+  def skill_md_paths
+    Dir.glob(File.join(@skills_dir, "*", "SKILL.md")).sort
+  end
+
+  def doctrine_blob
+    chapters = Dir.glob(File.join(@skills_dir, "conventions", "references", "*.md")).sort
+    return nil if chapters.empty?
+
+    text = chapters.map { |f| File.read(f) }.join(" ")
+    " #{normalize_words(text).join(" ")} "
+  end
+
+  def normalize_words(text)
+    text.downcase.gsub("`", "").gsub(/[^a-z0-9\s-]/, " ").split(/\s+/).reject(&:empty?)
+  end
+
+  # Same split as SkillLint's own frontmatter/body divide: `content.split("---", 3)`.
+  def body_and_offset(content)
+    parts = content.split("---", 3)
+    return [content, 0] if parts.length < 3
+
+    prefix_len = parts[0].length + 3 + parts[1].length + 3
+    [parts[2], content[0...prefix_len].count("\n")]
+  end
+
+  # Blank-line-delimited paragraph blocks, so a refusal keyword and its
+  # doctrine echo are compared across the whole paragraph, not one line.
+  def paragraph_blocks(lines)
+    blocks = []
+    start = nil
+    lines.each_with_index do |line, i|
+      if line.strip.empty?
+        blocks << { start: start, text: lines[start..(i - 1)].join } if start
+        start = nil
+      else
+        start ||= i
+      end
+    end
+    blocks << { start: start, text: lines[start..].join } if start
+    blocks
+  end
+
+  def restated?(block_text, doctrine)
+    words = normalize_words(block_text)
+    return false if words.length < NGRAM
+
+    (0..(words.length - NGRAM)).any? do |i|
+      doctrine.include?(" #{words[i, NGRAM].join(" ")} ")
+    end
+  end
+
+  def check_skill(skill_dir, skill_md, content, doctrine)
+    name = File.basename(skill_dir)
+    body, offset = body_and_offset(content)
+
+    paragraph_blocks(body.lines).filter_map do |block|
+      next unless block[:text].match?(REFUSAL_KEYWORD_RE)
+      next if block[:text].match?(CONVENTIONS_LINK_RE) # links the chapter instead of restating
+      next unless restated?(block[:text], doctrine)
+
+      {
+        check: "refusal-restatement", skill: name, file: skill_md, line: offset + block[:start] + 1,
+        message: "this paragraph restates a refusal rule word-for-word from " \
+                  "skills/conventions/references/; link the chapter instead of repeating its text",
+      }
+    end
+  end
+end
+
 def resolve_skills_dir(args)
   if (i = args.index("--skills-dir"))
     args[i + 1]
@@ -37,14 +145,15 @@ end
 
 dir = File.expand_path(resolve_skills_dir(ARGV))
 result = SkillLint.new(skills_dir: dir).run
+violations = result.violations + RefusalRestatementCheck.new(dir).run
 
-if result.ok?
+if violations.empty?
   puts "OK: #{dir}"
   exit 0
 end
 
 warn "VIOLATIONS: #{dir}"
-result.violations.each do |v|
+violations.each do |v|
   warn "#{v[:check]} #{v[:skill]} #{v[:file]}:#{v[:line].nil? ? "-" : v[:line]} #{v[:message]}"
 end
 exit 1

package/scripts/spawn-preamble

@@ -44,7 +44,7 @@ WORKTREE_FALLBACK_INSTRUCTION =
   "directory, cd directly to the code worktree path above before editing project code."
 
 # Verbatim completion-report contract (intent 74). Kept as one constant so the
-# contract doc (skills/auto/references/agent-report-contract.md), the role prompts,
+# contract doc (docs/help/agent-report-contract.md), the role prompts,
 # and the test assert against the exact same string. SINGLE SOURCE OF TRUTH for the
 # report wording: the work output is lifecycle artifacts, the final message is a
 # structured report about them. Both are required and they do not contradict.
@@ -64,7 +64,7 @@ REPORT_CONTRACT =
   "depends on the discovering session's file-write access. Keep the report " \
   "prose-stripped: the envelope and payload only, no greeting, no preamble, " \
   "no end-recap, no restating of the task; reasoning stays in the thinking channel. " \
-  "See skills/auto/references/agent-report-contract.md for the per-role format."
+  "See docs/help/agent-report-contract.md for the per-role format."
 
 def parse_args(argv)
   role = nil

package/scripts/update.rb

@@ -231,12 +231,33 @@ class Update < InstallerCore
     ($stdin.gets&.strip || "").downcase.start_with?("y")
   end
 
-  # Thin npx-exec glue (not unit-tested; the decision above is). Delegates the file-sync to
-  # the target version's install verb, recording the ledger action as `update`.
-  def perform_switch(target, agent_flags)
+  # Thin npx-exec glue (the decision above is unit-tested). Delegates the file-sync to
+  # the target version's install verb, recording the ledger action as `update`. On
+  # success, commits the re-synced core files and clears the update-check cache
+  # (former update skill, lines 124-125).
+  def perform_switch(target, agent_flags, switch_runner: ->(cmd) { system(*cmd) })
     cmd = ["npx", "#{PKG}@#{target}", "install", "--reinstall", "--ledger-action", "update", *agent_flags]
     puts "  $ #{cmd.join(" ")}"
-    system(*cmd) ? 0 : 1
+    return 1 unless switch_runner.call(cmd)
+
+    commit_core_files(target)
+    clear_update_check_cache
+    0
+  end
+
+  # Intent 372 (former update skill, lines 124-125): `~/.plastic` is its own git
+  # repository (install.rb's git_init_if_absent), so a successful update commits the
+  # core files it just re-synced. Empty commits are allowed: a same-version repair
+  # re-syncs nothing new, and that is still worth a ledger-adjacent commit.
+  def commit_core_files(target, runner: ->(cmd) { system(*cmd) })
+    runner.call(["git", "-C", plastic_home, "add", "PLASTIC.md", "scripts", "AGENTS.md", "VERSION",
+      "versions.json", "deprecations.yml", "config_asks.yml"])
+    runner.call(["git", "-C", plastic_home, "commit", "-m", "chore: update Plastic to #{target}",
+      "--allow-empty"])
+  end
+
+  def clear_update_check_cache
+    FileUtils.rm_f(File.join(plastic_home, ".cache", "update-check.json"))
   end
 
   def show_help

package/scripts/validate-work-graph

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# validate-work-graph - deterministic CLI over WorkGraphValidator (intent 334, n4).
+#
+# Checks whether one intent directory's graph.md and nodes/ form a valid work
+# graph: needs targets resolve, node files reconcile with the declared graph,
+# per-kind body sections are present, and (above the trivial bar) a verify
+# node gates two or more work nodes with a failure-mode matrix per work node.
+# Modelled on scripts/validate-intent: errors to stderr, same exit-code shape.
+#
+# Usage:
+#   validate-work-graph <intent_dir>
+#
+# Exit codes: 0 (valid), 1 (invalid or unreadable; report on stderr),
+# 2 (usage - no argument given).
+
+require_relative "lib/work_graph_validator"
+
+intent_dir = ARGV.find { |a| !a.start_with?("--") }
+
+if intent_dir.nil?
+  warn "usage: validate-work-graph <intent_dir>"
+  exit 2
+end
+
+dir = File.expand_path(intent_dir)
+result = WorkGraphValidator.validate(dir)
+
+if result[:ok]
+  puts "OK: #{dir}"
+  exit 0
+end
+
+warn "INVALID: #{dir}"
+result[:missing].each { |m| warn "missing: #{m}" }
+result[:errors].each { |e| warn e }
+exit 1

package/scripts/verify-intent

@@ -11,11 +11,12 @@
 #
 # --base overrides the auto-detected diff base (default: the merge base with the repo's
 # detected default branch) for repos where detection is ambiguous. --suite is an optional
-# caller-supplied command to run (in the repo directory) and fold into the verdict. No
+# caller-supplied command to run (in the repo directory) and merge into the verdict. No
 # other flags exist.
 #
 # Checks, all run every invocation (the fourth only when --suite is given):
-#   1. doctor    - Doctor#run_intent_check(id, store: scope), fail-open on a crash
+#   1. doctor    - Doctor#run_intent_check(id, store: scope), fail-open on a crash; the doctor
+#                  scan includes the intent_ticks_lag warning (intent 329)
 #   2. em-dash   - added lines only of `git diff <base>...HEAD`, never the whole tree
 #   3. diffstat  - `git diff --stat <base>...HEAD`, never a failure on its own
 #   4. suite     - the supplied --suite command, run with RUBYOPT cleared

package/scripts/write-handoff

@@ -16,6 +16,7 @@
 #
 # Exit codes: 0 done; 2 usage error.
 
+require_relative "lib/store_layout"
 require_relative "lib/session_ledger"
 require_relative "lib/handoff"
 
@@ -48,7 +49,7 @@ usage_abort("--trigger is required (#{Handoff::TRIGGERS.join(', ')})") unless op
 usage_abort("--trigger must be one of #{Handoff::TRIGGERS.join(', ')}") unless Handoff::TRIGGERS.include?(opts[:trigger])
 
 plastic_home = expand(ENV.fetch("PLASTIC_HOME", "~/.plastic"))
-store = opts[:store] ? expand(opts[:store]) : File.join(plastic_home, "store")
+store = opts[:store] ? expand(opts[:store]) : Plastic::StoreLayout.global_store(plastic_home)
 templates = opts[:templates] ? expand(opts[:templates]) : File.expand_path("../templates", __dir__)
 usage_abort("templates dir not found: #{templates}") unless Dir.exist?(templates)
 

package/templates/agents.md

@@ -42,7 +42,7 @@ Active/Future/Completed placement is managed in INDEX.md, not in frontmatter.
 
 ## Creating Tactical Intents
 
-Create through the `plastic-intent-creating` skill, which scaffolds with one call:
+Create through the `plastic intent new` command, which scaffolds with one call:
 `ruby ~/.plastic/scripts/new-intent --store .plastic/store --intent "<one-line>" --slug <slug> [--sources <governing-id>]`.
 It allocates the Folgezettel ID, creates `.plastic/store/ID--slug/ID--slug.md` born
 complete, and wires the links. Never hand-author the files: `new-intent` validates the
@@ -54,14 +54,14 @@ Plastic has its own lifecycle skills. When a Plastic skill exists for the curren
 
 | Phase | Skill | Produces |
 |-------|-------|----------|
-| What | `plastic-intent-creating` | Intent file |
-| Why | `plastic-intent-speccing` | Rulings as insights, `resources/*.md`, `spec.md` |
-| How | `plastic-intent-speccing` | `actions/`, `plan.md`, `checklist.md` |
-| Exec | `plastic-intent-executing` | Code + `outcome.md` |
-| Done | `plastic-intent-ending` | Lifecycle transition |
+| What | `plastic intent new` | Intent file |
+| Why | `plastic intent spec` | Rulings as insights, `resources/*.md`, `spec.md` |
+| How | `plastic intent spec` | `actions/`, `plan.md`, `checklist.md` |
+| Exec | `plastic intent step` | Code + `outcome.md` |
+| End | `plastic intent end` | Lifecycle transition |
 
 **Artifact convention:** ALL lifecycle artifacts go to the active intent directory (`store/{id}--{slug}/`). Never write specs to `docs/superpowers/specs/` or plans to `docs/superpowers/plans/`.
 
-## When You're Done
+## When the Project Wraps
 
 When this project satisfies the governing intent's goal, report back. The orchestrator will complete the strategic intent.

package/templates/config.yml

@@ -2,11 +2,11 @@ version: 3
 project_roots:
   - ~/.plastic/projects
 stale_threshold_days: 3
-# When to compact. Absolute token counts for a 1M window (35 and 50 percent), not
+# When to compact. Absolute token counts for a 1M window (15 and 25 percent), not
 # percentages: models are reliable only to roughly 50 to 65 percent of advertised
 # context, so a percentage that is right at 200k floats to an untested size at 1M.
-context_offer_tokens: 350000
-context_insist_tokens: 500000
+context_offer_tokens: 150000
+context_insist_tokens: 250000
 execution_mode: subagent-driven
 hash_length: 6
 hash_algorithm: sha256-base36
@@ -34,18 +34,25 @@ architect:
 #       plastic-enforcer: opus
 #     codex:
 #       plastic-executor: gpt-5.6-terra
+#   efforts:
+#     claude:
+#       plastic-executor: medium
+#     codex:
+#       plastic-executor: medium
+# Every shipped agent defaults to medium reasoning effort on both harnesses.
+# An agents.efforts.<harness>.<agent> entry is an explicit per-agent override.
 
-# The advisor (intent 185): two consultation agents, plastic-advisor (the real
-# advisor, expensive, model fable by default) and plastic-faux-advisor (the
-# cheaper imitation, model opus by default, carrying the same reasoning
-# discipline inline). advisor.enabled defaults to enabled; missing or
+# The advisors: Primary Advisor and Secondary Advisor. Both use Fable on Claude
+# Code and gpt-6-astra on Codex. Primary uses medium effort; Secondary uses high.
+# advisor.enabled defaults to enabled; missing or
 # unreadable counts as enabled (fail-open). The claude.default value is an
 # AGENT NAME, never a model name, so it can point at
 # a locally registered agent instead. Set at install time via --no-advisor /
 # --advisor, or uncomment here directly. Each agent's actual model is a plain
-# agents.models.claude.<name> override, same mechanism as any other agent.
+# agents.models.claude.<name> override, same mechanism as any other agent. Codex
+# generates both advisors with their role-specific effort.
 # advisor:
 #   enabled: false               # skip installing both advisor agents and the
 #                                 # agent-advisor skill entirely
 #   claude:
-#     default: plastic-advisor         # which agent the advisor skill routes to
+#     default: plastic-primary-advisor # which agent the advisor skill routes to

package/templates/dashboard-screen.md

@@ -0,0 +1,22 @@
+## ▶ {{scope}} · dashboard
+
+| | | |
+| --- | --- | --- |
+| **Active**      | {{active}} | intents |
+| **In delivery** | {{in_delivery}} | with a fresh lock |
+| **Delivered**   | {{delivered}} | in the last 7 days |
+| **Roadmap**     | {{roadmap}} | frontier batch |
+| **Sessions**    | {{sessions}} | alive |
+| **Changed**     | {{changed}} | newest savepoint |
+
+**Where we are**
+
+| Graph ID | Intent | Stage | Progress | Lead |
+| --- | --- | --- | --- | --- |
+{{where_we_are.rows}}
+
+**Where we go next**
+
+| Rank | Graph ID | Intent | Reason |
+| --- | --- | --- | --- |
+{{where_we_go_next.rows}}

package/templates/display-fixture.md

@@ -0,0 +1,21 @@
+<!-- Doctor's display self-test fixture (intent 331e). Replayed through the
+     installed MessageDisplay hook by `display_hook_paints` to prove painting
+     still works; this is NOT a report-screen scaffold (no {{...}} mustache
+     placeholders) and ships no data of its own. -->
+
+## ▶ 331e · Doctor display check
+
+| | | |
+| --- | --- | --- |
+| **Store**     | project:plastic                | the plastic project store |
+| **Status**    | Active                          | listed under ## Active in INDEX.md |
+| **Stage**     | Exec                            | What, Why, How, Exec delivered; the work is open |
+| **Progress**  | ██████████░░░░░░░░░░ 3 / 6      | 3 steps open |
+
+**Steps**
+
+| Step | Status | What |
+| --- | --- | --- |
+| S1 | done | Tests red |
+| S2 | done | check_display_registration in doctor_core.rb |
+| S3 | open | The three full-run checks in doctor.rb |

package/templates/graph.md

@@ -0,0 +1,16 @@
+# Graph: <intent name>
+
+## Goal
+<What this intent's graph delivers once every node reaches done.>
+
+## Decisions
+- D1 <first ruling made while building this graph>
+
+## Graph
+Edges, `needs` only; the head needs the tail done. The literal target `nothing` declares a root.
+- n1 needs nothing
+
+## Status
+| Node | State | Detail |
+| --- | --- | --- |
+| n1 | planned |  |

package/templates/index.md

@@ -2,7 +2,7 @@
 
 ## Active
 <!-- Line shape: `- [ID — Title](path)`. Writes emit the em-dash (U+2014) between
-     id and title; readers (Bridge.index_entry_match) accept the em-dash or a plain
+     id and title; readers (IndexEntry.match) accept the em-dash or a plain
      hyphen, so either form parses (see https://github.com/zalom/plastic/blob/main/docs/internals.md). -->
 (no active intents)
 

package/templates/intent-screen.md

@@ -12,6 +12,6 @@
 
 **Steps**
 
-| Step | Status | What |
+| Step | Status | Detail |
 | --- | --- | --- |
 {{steps.rows}}

package/templates/node-decision.md

@@ -0,0 +1,11 @@
+---
+node: d1
+kind: decision
+files: []
+budget: 20000
+---
+# d1 - <the decision to make>
+
+## Question
+<The question needing an owner ruling, framed so a yes/no answer or a pick
+from a short list settles it.>

package/templates/node-research.md

@@ -0,0 +1,13 @@
+---
+node: r1
+kind: research
+files: []
+budget: 60000
+# Optional. When present, use one relative Markdown path under resources/.
+# report: resources/report--topic.md
+---
+# r1 - <what to find out>
+
+## Deposit
+<Where the finding lands: declare report: above for a resources/ Markdown file,
+or name an artifact URL or a ruling recorded in the intent's ## Decisions.>

package/templates/node-verify.md

@@ -0,0 +1,13 @@
+---
+node: v1
+kind: verify
+files: []
+budget: 40000
+---
+# v1 - <what this node verifies>
+
+<What this node checks, and why it gates the work nodes it needs.>
+
+## Criteria
+- <acceptance criterion one>
+- <acceptance criterion two>

package/templates/node-work.md

@@ -0,0 +1,22 @@
+---
+node: n1
+kind: work
+files: [path/to/file.rb, test/path_to_file_test.rb]
+budget: 100000
+---
+# n1 - <one-line description of what this node builds>
+
+<Why this node exists and what it changes, in a sentence or two.>
+
+## n1 failure-mode matrix
+| Operation | Failure mode | Test |
+| --- | --- | --- |
+| <operation> | <what goes wrong without this code, and its consequence> | `some_test#test_name` |
+
+## Steps
+1. Red: the matrix's tests above, committed before any code.
+2. Write the code that makes them pass.
+3. Green, then the whole suite at its baseline.
+
+## Proven by
+(filled at close from the ledger: commit, suite counts, review verdict)

package/templates/outcome.md

@@ -9,9 +9,14 @@ disposition: delivered|abandoned
 ## Delivered
 <!-- One row per thing delivered, in plain wording a reader recognizes, not
 an implementation summary; the technical detail belongs in ## Summary. Each
-row's label must appear as a standalone token in an actions/*.md heading
-(for example "### S1 - ..." proves row S1): that heading's matrix rows become
-the row's Proven-by cell on the delivered screen (intent 317 D19, 317a). -->
+row's label must appear as a standalone token in an actions/*.md OR
+nodes/*.md heading that owns the matrix table (for example "### S1 - ..."
+with a table beneath it proves row S1, or "## n1 failure-mode matrix" proves
+row n1); that heading's matrix rows become the row's Proven-by cell on the
+delivered screen (intent 317 D19, 317a, 322 D1r, 334 D10r). Readers resolve
+actions/ first, then nodes/ (334 D15r). A label with no owning heading falls
+back to a matrix row cell that carries it, when one under a heading named
+"matrix" exists (322 D3r). -->
 | Row | What |
 | --- | --- |
 | S1 | ... |

package/templates/project.yml

@@ -8,5 +8,5 @@ release:
 #   mode: direct               # direct | pull_request
 #   base: main                 # defaults to origin/HEAD, then main, then master
 #   branch_template: "session/{{day}}"   # {{day}}, {{ticket}}, {{slug}} tokens
-#   ticket_source: intent_id   # intent_id (the session pointer's intent id, else the day id)
+#   ticket_source: intent_id   # intent_id (the delivering intent's id from its delivery lock, else the day id)
 #   workspace: checkout        # checkout | worktree (worktree applies to direct mode only)

package/templates/render.css

@@ -0,0 +1,10 @@
+body { max-width: 46rem; margin: 2rem auto; padding: 0 1rem; font: 16px/1.6 system-ui, sans-serif; color: #1f2933; background: #f4f5f7; }
+h1, h2, h3 { line-height: 1.25; }
+table { border-collapse: collapse; display: block; overflow-x: auto; }
+th, td { border: 1px solid #9aa5b1; padding: 0.3rem 0.6rem; text-align: left; }
+pre { background: #e4e7eb; padding: 0.8rem; overflow-x: auto; }
+code { font-family: ui-monospace, monospace; }
+@media (prefers-color-scheme: dark) {
+  body { color: #e4e7eb; background: #1f2933; }
+  pre { background: #323f4b; }
+}

package/templates/report-plan.md

@@ -0,0 +1,15 @@
+## ▶ {{id}} · {{name}} · plan
+
+| | | |
+| --- | --- | --- |
+{{fields.rows}}
+
+**Steps**
+
+| Step | Action | Detail |
+| --- | --- | --- |
+{{steps.rows}}
+
+**Risks**
+
+{{risks.block}}

package/templates/report-roadmap-delivered.md

@@ -0,0 +1,10 @@
+## ✔ {{slug}} · roadmap · delivered
+{{meta}}
+
+**Delivered**
+
+{{delivered.table}}
+
+**Log**
+
+{{log.table}}

package/templates/report-roadmap-plan.md

@@ -0,0 +1,9 @@
+## ▶ {{slug}} · roadmap · plan
+
+| | | |
+| --- | --- | --- |
+{{fields.rows}}
+
+**Batches**
+
+{{entries.table}}{{tree}}

package/templates/report-roadmap-state.md

@@ -0,0 +1,9 @@
+## ▶ {{slug}} · roadmap
+
+| | | |
+| --- | --- | --- |
+{{fields.rows}}
+
+**Batches**
+
+{{entries.table}}

package/templates/report-state.md

@@ -6,6 +6,6 @@
 
 **Steps**
 
-| Step | Status | What |
+| Step | Status | Detail |
 | --- | --- | --- |
 {{steps.rows}}