fapony 0.1.1 → 0.1.3

package/src/plan-seed.ts

@@ -88,7 +88,7 @@ function scopeSourceFiles(root: string): string[] {
 // is about to plan. Headers only (title + shipped date) — pulling the bodies
 // in would recreate the reading task the plan exists to avoid.
 function renderPriorArt(cwd: string, config: Config, roots: string[]): string {
-  const placeholder = "- _(agent เติม)_";
+  const placeholder = "- _(agent fills in)_";
   const keys = roots
     .map((r) => relative(cwd, r))
     .filter((r) => r !== "" && r !== ".");
@@ -124,7 +124,7 @@ function renderPriorArt(cwd: string, config: Config, roots: string[]): string {
       const shipped = content.match(/shipped\s+(\d{4}-\d{2}-\d{2})/)?.[1] ?? "";
       hits.push({
         shipped,
-        line: `- ✅ ตัดสินไปแล้ว: [${n}](../${label}/${n}) — ${title}${shipped ? ` (shipped ${shipped})` : ""} \`(fapony plan-seed)\``,
+        line: `- ✅ Already decided: [${n}](../${label}/${n}) — ${title}${shipped ? ` (shipped ${shipped})` : ""} \`(fapony plan-seed)\``,
       });
     }
   }
@@ -137,7 +137,9 @@ function renderPriorArt(cwd: string, config: Config, roots: string[]): string {
   );
   const shown = hits.slice(0, MAX_PRIOR_ART).map((h) => h.line);
   if (hits.length > MAX_PRIOR_ART) {
-    shown.push(`- … +${hits.length - MAX_PRIOR_ART} more ที่แตะ scope เดียวกัน`);
+    shown.push(
+      `- … +${hits.length - MAX_PRIOR_ART} more touching the same scope`,
+    );
   }
   shown.push(placeholder);
   return shown.join("\n");
@@ -185,49 +187,49 @@ kind: unit
 status: active
 ---
 
-# PLAN-${name} — (agent เติมชื่อเรื่อง)
+# PLAN-${name} — (agent fills in a title)
 
-> **Status:** 🚧 in-progress · **Created:** (agent เติมวันที่)
+> **Status:** 🚧 in-progress · **Created:** (agent fills in the date)
 
 ## TL;DR
-- **What:** (agent เติม) · **Why:** (agent เติม) · **Done when:** (agent เติม)
-- **Order:** (agent เติม)
+- **What:** (agent fills in) · **Why:** (agent fills in) · **Done when:** (agent fills in)
+- **Order:** (agent fills in)
 - **Progress:**
-  - [ ] chunk 1 — (agent เติม)
+  - [ ] chunk 1 — (agent fills in)
 
 ## Context (fapony)
 ${contextFapony}
 
 ## 1. Goal (why)
-_(agent เติม)_
+_(agent fills in)_
 
 ## 2. Scope (do / don't do)
-_(agent เติม)_
+_(agent fills in)_
 
 ## 3. Done criteria (how we know it's finished)
-_(agent เติม — ต้อง verify ได้)_
+_(agent fills in — must be verifiable)_
 
 ## 4. Constraints / Hard rules (must not violate)
-_(agent เติม)_
+_(agent fills in)_
 
 ## 5. Risks & Escape hatches (if it fails)
-_(agent เติม)_
+_(agent fills in)_
 
 ## 6. Steps (what in which order)
-1. _(agent เติม — แต่ละขั้น verify ได้)_
+1. _(agent fills in — each step must be verifiable)_
 
 ## 7. Examples
 ${
   specLink
-    ? `→ ${specLink}  (signature อยู่ spec ไม่ใช่ plan)`
-    : "_(agent เติม — หรือเพิ่ม SPEC ด้วย plan-seed --spec)_"
+    ? `→ ${specLink}  (signatures live in the spec, not the plan)`
+    : "_(agent fills in — or add a SPEC with plan-seed --spec)_"
 }
 
 ## 8. References
 ${priorArt}
 
 ## Context (agent)
-_(slot ว่าง — agent dump graph/code-summary ของตัวเอง)_
+_(empty slot — the agent dumps its own graph/code-summary)_
 `;
 }
 
@@ -437,7 +439,7 @@ function specTemplate(
   // undershot the cap by that many lines (the 18k-SPEC failure mode). Cap the
   // index separately so the body's capLines has a bounded head to work with.
   const fixedHead = [
-    `# SPEC-${name} — (agent เติมชื่อเรื่อง)`,
+    `# SPEC-${name} — (agent fills in a title)`,
     "",
     `> **Used by:** PLAN-${name} — signatures below come from a live source scan — re-seed after structural changes.`,
     ...(scopeEcho ? [`> **Scope:** ${scopeEcho}`] : []),
@@ -456,7 +458,7 @@ function specTemplate(
   );
   const head = [...fixedHead, ...cappedIndex, ""];
   const tail = [
-    "## (agent เติม — wireframes / edge cases / API shapes ที่ plan อ้างถึง)",
+    "## (agent fills in — wireframes / edge cases / API shapes the plan references)",
   ];
   const bodyLines = chunks.flatMap((c) => [
     `## <a id="${c.slug}"></a>${c.title}`,
@@ -557,7 +559,7 @@ export function cmdPlanSeed(args: string[]): void {
   const planPath = join(planDirAbs, `PLAN-${name}.md`);
   if (existsSync(planPath)) {
     console.error(
-      `${planPath} already exists — not overwriting. ใช้ชื่อใหม่ เช่น PLAN-${name}-v2`,
+      `${planPath} already exists — not overwriting. Use a new name, e.g. PLAN-${name}-v2`,
     );
     process.exit(1);
   }
@@ -571,7 +573,7 @@ export function cmdPlanSeed(args: string[]): void {
     const specPath = join(specDirAbs, `SPEC-${name}.md`);
     if (existsSync(specPath)) {
       console.error(
-        `${specPath} already exists — not overwriting. ใช้ชื่อใหม่ เช่น SPEC-${name}-v2`,
+        `${specPath} already exists — not overwriting. Use a new name, e.g. SPEC-${name}-v2`,
       );
       process.exit(1);
     }

package/src/price/fetch.ts

@@ -1,9 +1,9 @@
-// src/price/fetch.ts — ดึงตารางราคา OpenRouter + cache เป็น prices.json
+// src/price/fetch.ts — fetch OpenRouter's price table + cache it as prices.json
 //
-// ราคาเป็น cache ไม่ใช่ state: เก็บที่ ~/.config/fapony/prices.json (เคารพ
-// FAPONY_STATE_DIR) ห้ามเพิ่มตาราง SQLite (กฎ DB Schema: 2 ตารางเท่านั้น)
-// refresh เกิดตอนคนสั่ง `fapony price-scan` เท่านั้น — query ไม่ fetch เอง
-// (วินัยเดียวกับ usage-scan) offline แล้วอ่าน cache เดิม
+// prices are cache, not state: stored at ~/.config/fapony/prices.json (honors
+// FAPONY_STATE_DIR) no new SQLite tables (DB Schema rule: 2 tables only)
+// refresh happens only when someone runs `fapony price-scan` — a query never fetches on its own
+// (same discipline as usage-scan) offline, read the existing cache
 
 import {
   existsSync,
@@ -19,12 +19,12 @@ import type { Config } from "../db/types.js";
 const PRICES_FILENAME = "prices.json";
 const MODELS_URL = "https://openrouter.ai/api/v1/models";
 
-/** เรตราย token (ดอลลาร์) — ทุกเรตมาจาก OpenRouter ตรง ๆ ไม่เดา */
+/** per-token rates (dollars) — every rate comes straight from OpenRouter, no guessing */
 export interface ModelRates {
   input: number;
   output: number;
   cacheRead: number;
-  /** null = ตารางไม่ให้มา → ใช้เรต input แทน (ดู calcCost) */
+  /** null = the table does not provide it → use the input rate instead (see calcCost) */
   cacheWrite: number | null;
 }
 
@@ -37,7 +37,7 @@ export function pricesPath(config?: Config): string {
   return join(faponyDir(config), PRICES_FILENAME);
 }
 
-/** อ่าน cache — คืน null เมื่อไม่มีไฟล์หรือพัง (caller แสดง — + hint) */
+/** Read the cache — null when the file is missing or broken (caller shows "—" + hint) */
 export function loadPrices(config?: Config): PriceTable | null {
   const p = pricesPath(config);
   if (!existsSync(p)) return null;
@@ -53,7 +53,7 @@ export function loadPrices(config?: Config): PriceTable | null {
   }
 }
 
-/** เขียนแบบ atomic (tmp + rename) สร้าง state dir เมื่อยังไม่มี */
+/** Write atomically (tmp + rename), create the state dir when absent */
 export function writePrices(table: PriceTable, config?: Config): void {
   const p = pricesPath(config);
   mkdirSync(dirname(p), { recursive: true });
@@ -72,14 +72,14 @@ function toRate(v: unknown): number | null {
 }
 
 /**
- * แปลง response ดิบของ OpenRouter เป็นตารางเรต (pure — เทสต์ได้โดยไม่ยิงเน็ต)
+ * Turn OpenRouter's raw response into a rate table (pure — testable without hitting the network)
  *
- * ฟิลด์จริง (ยืนยัน 2026-09-14, 445 models): pricing.prompt / .completion /
+ * Real fields (confirmed 2026-09-14, 445 models): pricing.prompt / .completion /
  * .input_cache_read / .input_cache_write (optional) / .input_cache_write_1h
- * (เรต 1h TTL ของบางรุ่น — ใช้เรต 5m มาตรฐานพอ เพราะ log ไม่บอก TTL)
- * เมิน pricing.web_search / pricing.overrides (tier ตาม min_prompt_tokens /
- * utc_days — ใช้ base rate แล้วประกาศข้อจำกัด) · id ขึ้นต้น ~ (alias) ตัดทิ้ง
- * id ลงท้าย :free / :batch เก็บตามนั้น (เป็นแถวราคาของมันเอง)
+ * (the 1h TTL rate of some models — the standard 5m rate suffices because logs do not report TTL)
+ * ignore pricing.web_search / pricing.overrides (tiers based on min_prompt_tokens /
+ * utc_days — use the base rate and state the limitation) · ids starting with ~ (alias) are dropped
+ * ids ending :free / :batch are kept as-is (they are their own price rows)
  */
 export function parsePricesResponse(json: unknown): Record<string, ModelRates> {
   const out: Record<string, ModelRates> = {};
@@ -102,8 +102,8 @@ export function parsePricesResponse(json: unknown): Record<string, ModelRates> {
 }
 
 /**
- * รวมตารางใหม่เข้ากับ cache เดิม — merge ไม่ replace: id ที่หายไปจาก
- * response รอบนี้ (รุ่นเก่าหลุดตาราง) ต้องยังคิดราคาได้ด้วยเรตเดิม
+ * Merge the new table into the old cache — merge, not replace: an id missing from
+ * this response (an old model dropped from the table) must still be priced with its old rate
  */
 export function mergePriceTables(
   old: PriceTable | null,
@@ -115,7 +115,7 @@ export function mergePriceTables(
   };
 }
 
-/** ดึงตารางจาก OpenRouter (public, ไม่ต้อง auth) — fetcher แทรกได้ไว้เทสต์ */
+/** Fetch the table from OpenRouter (public, no auth) — fetcher is injectable for tests */
 export async function fetchPriceTable(
   fetcher: typeof fetch = fetch,
 ): Promise<Record<string, ModelRates>> {
@@ -134,7 +134,7 @@ export async function cmdPriceScan(rawArgs: string[]): Promise<void> {
     fresh = await fetchPriceTable();
   } catch (err) {
     console.error(
-      `fapony price-scan: fetch failed (${String(err)}) — cache เดิมยังอยู่ ใช้ราคาที่มีได้`,
+      `fapony price-scan: fetch failed (${String(err)}) — the existing cache is still here, use the prices you have`,
     );
     process.exit(1);
   }

package/src/price/resolve.ts

@@ -1,7 +1,7 @@
-// src/price/resolve.ts — normalize model id + คิด list-price equivalent
+// src/price/resolve.ts — normalize model id + compute list-price equivalent
 //
-// กฎเหล็ก: map ไม่ได้ต้องเป็น unpriced ห้ามตีเป็น 0 เงียบ ๆ (failure mode หลัก
-// ของฟีเจอร์นี้) · free มีแต่ของที่ราคา 0 จริง (local / แถว :free ในตาราง)
+// Hard rule: an unmappable model must be unpriced, never silently counted as 0 (the main failure mode
+// of this feature) · free only applies to things that truly cost 0 (local / :free rows in the table)
 
 import type { ModelBreakdown, PassiveUsageResult } from "../session/types.js";
 import type { ModelRates, PriceTable } from "./fetch.js";
@@ -13,10 +13,10 @@ export interface PriceResolution {
   rates: ModelRates | null;
 }
 
-/** prefix ของ client ที่แปะหน้าทุก model id — ตัดทิ้งแล้ว lookup ใหม่ */
+/** client prefix prepended to every model id — strip it, then look up again */
 const CLIENT_PREFIXES = ["openrouter/", "opencode-go/", "opencode/"];
 
-/** tier ต่อท้ายของ OpenRouter — :free คือ endpoint ฟรีจริง :batch คือส่วนลด */
+/** OpenRouter's trailing tier — :free is a genuinely free endpoint, :batch is a discount */
 function stripTier(id: string): string {
   return id.endsWith(":free") || id.endsWith(":batch")
     ? id.slice(0, id.lastIndexOf(":"))
@@ -24,8 +24,8 @@ function stripTier(id: string): string {
 }
 
 /**
- * รายชื่อ candidate id ตามลำดับความเฉพาะ: ตรงตัวก่อน กว้างทีหลัง
- * (ตรงตัวชนก่อนเสมอ — bare slug แมตช์กว้างสุดอยู่ท้าย)
+ * Candidate ids ordered by specificity: exact first, broad later
+ * (an exact match always wins — the bare slug is the broadest match and goes last)
  */
 export function candidateIds(provider: string, model: string): string[] {
   const full = provider ? `${provider}/${model}` : model;
@@ -38,14 +38,14 @@ export function candidateIds(provider: string, model: string): string[] {
       break;
     }
   }
-  // opencode ต่อ -free ท้าย slug ของรุ่นฟรี (deepseek-v4-flash-free)
+  // opencode appends -free to the slug of a free model (deepseek-v4-flash-free)
   if (rest.endsWith("-free")) out.push(rest.slice(0, -"-free".length));
   return out;
 }
 
 /**
- * หาเรตให้ model หนึ่งตัว — คืน null เฉพาะของ local เท่านั้นที่ข้ามตาราง
- * (local ไม่เคยมีราคาตั้งแต่แรก ไม่ใช่ "หาไม่เจอ")
+ * Find rates for one model — null only for local, which skips the table
+ * (local never had a price to begin with, it is not "not found")
  */
 function isLocalProvider(provider: string): boolean {
   return provider === "lmstudio_local";
@@ -59,14 +59,14 @@ export function resolvePrice(
   if (!model || model === "(no model id)" || model === "(unknown)")
     return { status: "unpriced", rates: null };
   if (isLocalProvider(provider)) return { status: "free", rates: null };
-  // ลงท้าย :free หรือ -free = เรียกผ่าน free endpoint / รุ่นฟรีของ client มา
-  // ราคาจริงคือ 0 (ไม่ใช่ list price) ไม่ว่าจะ map OpenRouter ได้หรือไม่
+  // ends with :free or -free = used a free endpoint / the client's free model
+  // the real price is 0 (not list price), whether or not OpenRouter maps it
   if (model.endsWith(":free") || model.endsWith("-free"))
     return { status: "free", rates: null };
   for (const id of candidateIds(provider, model)) {
     const rates = table.models[id] ?? table.models[stripTier(id)];
     if (rates) {
-      // แถวราคา 0 ทั้งแถว (:free / รุ่นฟรี) = free จริง ไม่ใช่ unpriced
+      // an all-zero rate row (:free / free model) = genuinely free, not unpriced
       if (
         rates.input === 0 &&
         rates.output === 0 &&
@@ -77,10 +77,10 @@ export function resolvePrice(
       return { status: "priced", rates };
     }
   }
-  // zcode เก็บแค่ slug ไม่มี vendor (GLM-5.3-Flash) — เทียบส่วนหลัง / ตรงตัว
-  // แบบ case-insensitive (exact ไม่ใช่ fuzzy: ยาวเท่ากันทั้งสตริง)
-  // ฝั่งตารางตัด tier (:free/:batch) ก่อนเทียบ — slug เปลือยจะได้ชนแถว :free
-  // ที่ราคา 0 จริง (เช่น ling-3.0-flash-fin) กลายเป็น free ไม่ใช่ unpriced
+  // zcode stores only the slug with no vendor (GLM-5.3-Flash) — compare the suffix / exact
+  // case-insensitive match (exact, not fuzzy: the whole string must be equal in length)
+  // the table side strips the tier (:free/:batch) before comparing — so a bare slug hits the :free
+  // row that is truly 0 (e.g. ling-3.0-flash-fin) and becomes free, not unpriced
   const slug = stripTier(
     candidateIds(provider, model).at(-1) ?? "",
   ).toLowerCase();
@@ -114,11 +114,11 @@ export interface TokenCounts {
 }
 
 /**
- * คิดเงิน pure: แยกเรต input / cache-read / cache-write — ห้ามใช้เรตเดียวรวบ
+ * Pure costing: separate rates for input / cache-read / cache-write — never one rate for all
  *
- * reasoning ไม่คูณแยก: ของ Anthropic-family thinking รวมอยู่ใน output อยู่แล้ว
- * (reader แยกเก็บไว้ดูเฉย ๆ) คูณแยก = double count · cache_write ไม่มีในตาราง
- * → fallback เรต input (เขียน cache แพงกว่า/เท่าอ่านสด ไม่มีทางถูกกว่า)
+ * reasoning is not multiplied separately: Anthropic-family thinking is already included in output
+ * (the reader keeps it separately just for visibility); multiplying separately = double counting · cache_write absent from the table
+ * → fall back to the input rate (writing cache costs more than or equal to a fresh read, never less)
  */
 export function calcCost(t: TokenCounts, rates: ModelRates): number {
   return (
@@ -138,7 +138,7 @@ export interface ImputedModel {
   tokens_cache_read: number;
   tokens_cache_write: number;
   status: PriceStatus;
-  /** ดอลลาร์ list-price — 0 เมื่อ free/unpriced (ดู status อย่าอ่านเลขอย่างเดียว) */
+  /** dollars at list-price — 0 when free/unpriced (check status, do not read the number alone) */
   imputed_cost: number;
 }
 
@@ -152,8 +152,8 @@ export interface ImputeSummary {
 }
 
 /**
- * ตีราคาทั้ง PassiveUsageResult — ใช้กับผลสด (stats/usage) หรือแถว cache
- * (usage-web) ก็ได้เพราะรับแค่ token ต่อ model
+ * Price an entire PassiveUsageResult — works on live results (stats/usage) or cache rows
+ * (usage-web) alike, because it only takes tokens per model
  */
 export function imputeResult(
   result: PassiveUsageResult,

package/src/review-seed.ts

@@ -544,7 +544,7 @@ function hasDynamicDispatch(absFile: string): boolean {
 
 // --- --body: declaration slice (indent-out, no parser) ---
 // extractBody lives in map.ts beside extractExports — the conventions seeder
-// reuses the same slice for wrapper detection (one implementation, กฎ 1).
+// reuses the same slice for wrapper detection (one implementation, rule 1).
 
 // --- --callers: symbol→symbol over importer files (identifier scan) ---
 

package/src/stats/data.ts

@@ -622,15 +622,16 @@ function addSessionTokens(
 }
 
 /**
- * tokens/pass — retry tax ที่มองเห็นได้ (SPEC-cost-per-pass).
+ * tokens/pass — the visible retry tax (SPEC-cost-per-pass).
  *
- * ตัวหารคือ pass-family gate ไม่ใช่ run: bucket เป็น gate อยู่แล้ว และงานที่
- * "จบ" คือ gate ที่ผ่าน · token เป็นยอดต่อ session (dedupe แล้ว) ไม่ใช่ต่อ gate —
- * session เดียวออกหลาย gate ได้ ถ้า sum ต่อ gate จะคูณเกินไม่เท่ากันทุกโมเดล
+ * The divisor is a pass-family gate, not a run: bucket is already a gate, and
+ * work "finished" is a gate that passed · token is a per-session total (deduped),
+ * not per gate — one session can emit several gates, so summing per gate would
+ * multiply unevenly across models.
  *
- * `passes=0` หรือ token รวม 0 → null (ไม่ใช่ Infinity/NaN/0): "วัดไม่ได้" ต้อง
- * แยกจาก "ฟรี" และห้ามหารศูนย์ · cost/pass ยังไม่มีใน v1 — ไม่มี cache split
- * (tokensInput คือ fresh+cache_read+cache_write รวมกัน) จึงคิดราคาไม่ได้โดยไม่เดา
+ * `passes=0` or total token 0 → null (not Infinity/NaN/0): "unmeasurable" is not
+ * "free" and never divide by zero · no cost/pass in v1 — no cache split
+ * (tokensInput is fresh+cache_read+cache_write), so price needs a guess.
  */
 function tokensPerPass(
   passes: number,

package/src/stats/format.ts

@@ -51,9 +51,10 @@ function modelLine(
 }
 
 /**
- * บรรทัด list-price equivalent ต่อท้ายแต่ละ usage section — หน่วยเดียวที่
- * เทียบข้าม client ได้ (client ที่ไม่บันทึก cost มีราคาติดตรงนี้)
- * ราคา list ไม่ใช่เงินที่จ่ายจริง · unpriced แยกออกมาให้เห็น ไม่รวมใน 0
+ * list-price equivalent line appended to each usage section — the one unit
+ * that compares across clients (clients that do not record cost get a price
+ * attached here). List price is not money paid · unpriced is broken out
+ * separately, never folded into 0.
  */
 function imputedLines(
   result: PassiveUsageResult,
@@ -103,8 +104,8 @@ export function formatStatsText(data: StatsData): string {
   if (data.runs.total === 0) return "no runs yet";
 
   const lines: string[] = [];
-  // ราคา list จาก cache อย่างเดียว — query ไม่ fetch เอง (offline ได้, ไม่มี
-  // ไฟล์ = แสดง — + hint ไม่ throw)
+  // list price from cache only — the query never fetches itself (works
+  // offline, missing file = shows — + hint, never throws)
   const prices = loadPrices();
 
   if (data.scope) {

package/src/usage/render.ts

@@ -304,8 +304,9 @@ function shareSection(
 }
 
 /**
- * เติมราคาตั้งให้แถวที่ client ไม่บันทึก cost (0) — ของที่มีราคาจริงอยู่แล้ว
- * ไม่แตะ · คืน view ไว้ render + note ไว้ใต้ตาราง (ป้าย list-price ทุกจุด)
+ * Imputes list prices for rows where the client records no cost (0) — rows
+ * that already have a real price are left alone · returns a view to render
+ * plus a note for below the table (list-price label everywhere)
  */
 function withImputed(
   data: PassiveUsageResult | null,
@@ -332,7 +333,7 @@ function withImputed(
       tokens_reasoning: real?.tokens_reasoning ?? 0,
       tokens_cache_read: m.tokens_cache_read,
       tokens_cache_write: m.tokens_cache_write,
-      // รวมกับ cost จริงรายรุ่น (opencode บันทึกเอง) — ข้างไหนมีค่ากว่ากันเอาข้างนั้น
+      // combine with the real per-model cost (OpenCode records its own) — whichever has a value wins
       cost: real && real.cost > 0 ? real.cost : m.imputed_cost,
     };
   });
@@ -363,7 +364,7 @@ export function renderUsageHtml(
     .filter((k) => k !== "__global__")
     .sort();
 
-  // ราคา list จาก cache อย่างเดียว — serve ไม่ fetch เอง (offline ได้)
+  // list price from cache only — serving never fetches itself (works offline)
   const table = prices === undefined ? loadPrices() : prices;
 
   const owner = ownerName?.trim() ? esc(ownerName.trim()) : "";
@@ -395,7 +396,7 @@ export function renderUsageHtml(
 
     const heading = isGlobal ? "All projects" : shortWt(label);
 
-    // การ์ดที่ไม่มี session เลยไม่มีอะไรให้ดู — ซ่อนแทนที่จะโชว์ "no sessions"
+    // a card with no sessions has nothing to show — hide it instead of showing "no sessions"
     const cards = [
       ["OpenCode", "var(--green)", pOc],
       ["ZCode", "var(--accent)", pZc],

package/templates/PLAN.md

@@ -24,7 +24,7 @@ spec: SPEC-<feature>.md           # if any
 - **Done when:** one line, testable
 - **Order:** what this waits on / what it unblocks (mirrors the frontmatter)
 - **Progress:**
-  - [x] chunk 1 — <what landed>  `<short sha>` <YYYY-MM-DD>
+  - [x] chunk 1 — <what landed>  `<short sha>` <YYYY-MM-DD> · verdict: <grade>
   - [ ] chunk 2 — <what is next>
 
 ---