diff --git a/cypher-executor/src/lib/console-dashboard-model.ts b/cypher-executor/src/lib/console-dashboard-model.ts index da8d2d0..05ff13b 100644 --- a/cypher-executor/src/lib/console-dashboard-model.ts +++ b/cypher-executor/src/lib/console-dashboard-model.ts @@ -16,6 +16,12 @@ * → 燈號只吃「今日寫入」的任務 + 心跳（心跳 dash_beat 是唯一有活管線的 dash_* 資料）。 */ +import { taipeiDayKey } from './taipei-time'; + +// 台北日曆日 key 的唯一實作搬到 lib/taipei-time.ts（fix/console-truth-audit：console 全站 +// 日期顯示統一台北，server/client 共用同一套）。這裡 re-export 維持既有 import 路徑不破。 +export { taipeiDayKey }; + export interface KbdbEntry { id: string; content: string | null; @@ -47,11 +53,6 @@ export function parseJsonContent(e: KbdbEntry): Record | null { } } -/** 台北（UTC+8）日曆日 key，用來判定「這筆 dash_task 是不是今天寫的」。 */ -export function taipeiDayKey(ms: number): string { - return new Date(ms + 8 * 3600 * 1000).toISOString().slice(0, 10); -} - export function agoMinutes(nowMs: number, ms: number | null): number { return ms === null ? -1 : Math.max(0, Math.round((nowMs - ms) / 60000)); } @@ -194,19 +195,8 @@ export function cleanWaitingTitle(raw: string): string { const colon = s.indexOf('：'); if (colon >= 12) s = s.slice(0, colon); if (s.length > 80) s = `${s.slice(0, 79)}…`; - // 截斷可能留下未閉合的全形括號 → 從最後一個未配對「（」剪掉 - let depth = 0; - let lastOpen = -1; - for (let i = 0; i < s.length; i++) { - if (s[i] === '（') { - if (depth === 0) lastOpen = i; - depth++; - } else if (s[i] === '）') { - depth = Math.max(0, depth - 1); - } - } - if (depth > 0 && lastOpen >= 0) s = s.slice(0, lastOpen).trim(); - return s; + // 截斷可能留下未閉合的全形括號 → 共用 trimUnbalancedParen（板標題同款處理） + return trimUnbalancedParen(s); } /** sprint 檔命名慣例 sprint-YYYY-MM.md，字典序即時間序。 @@ -250,6 +240,113 @@ export function buildWaitingFallback(entries: KbdbEntry[], nowMs: number): Waiti }; } +// ── sprint 任務板（「今日完成」活資料源，leo 2026-07-07 拍板）────────────────────── +// +// 動機（leo 原話）：「今天做了這麼多事……其實就是我們到底完成了多少事」。dash_task 沒有 +// 活管線（同 dash_wait 病），真相源＝InkStoneCo sprint 檔「## 任務板」（progress-guard / +// cloud-worker 每日維護勾選）。比照「等你的事」#36 模式：同一輪 Gitea fetch 撈的檔案 +// 順手解析任務板，dash_task 降為 fallback。 + +export interface SprintBoardTask { + title: string; + /** [x]=done、[🔄]=doing、[ ]=todo、[!]=blocked（板上維護慣例，對照 sprint-2026-07a.md） */ + status: 'done' | 'doing' | 'todo' | 'blocked'; + /** 行內所有「完成（YYYY-MM-DD…）」標記的日期（一行可有多次完成，如 T6-T9 分兩天）。 + * [x] 但沒有帶日期的完成標記 → 空陣列＝無法歸日，任何一天都不冒領（寧可略過不誤判）。 */ + completed_days: string[]; + /** 合併多個 sprint 檔時標出處（如 "sprint-2026-07b.md"） */ + sprint?: string; +} + +const BOARD_LINE = /^- \[( |x|X|🔄|!)\]\s*(.*)$/u; +const COMPLETED_DAY = /完成（(\d{4}-\d{2}-\d{2})/gu; + +/** 截斷/切冒號後可能留下未閉合的全形括號 → 從最後一個未配對「（」剪掉。 + * 整串都在括號裡（如「（T10 廢 ENCRYPTION_KEY：…」註記行）會剪成空字串—— + * caller 視空標題為「不是任務」跳過，恰好把括號註記行濾掉。 */ +function trimUnbalancedParen(s: string): string { + let depth = 0; + let lastOpen = -1; + for (let i = 0; i < s.length; i++) { + if (s[i] === '（') { + if (depth === 0) lastOpen = i; + depth++; + } else if (s[i] === '）') { + depth = Math.max(0, depth - 1); + } + } + if (depth > 0 && lastOpen >= 0) s = s.slice(0, lastOpen).trim(); + return s; +} + +/** 板上事項標題＝「第一個全形冒號前」的裸文字（板的維護慣例：`**任務代號**：長敘述…`）。 + * 不能用「第一個粗體」——實讀 07a 發現長敘述裡的 `**完成（2026-07-02…）**` 註記常比 + * 任務名先出現粗體，會抽成「完成（…）」假標題。冒號太前（<4 字，如「附帶：」）不切。 */ +export function cleanBoardTitle(raw: string): string { + let s = raw.replace(/\*\*/g, '').replace(/~~/g, '').replace(/`/g, '').trim(); + const colon = s.indexOf('：'); + if (colon >= 4) s = s.slice(0, colon); + if (s.length > 80) s = `${s.slice(0, 79)}…`; + return trimUnbalancedParen(s.trim()); +} + +/** + * 從 sprint md 撈「## 任務板」段（到下一個 `## ` 為止，`###` 子段照收），解析頂層 + * checkbox 事項。只認**行首**的 `- [x]` 型式——縮排子彈（「 - 做法：」）與無 checkbox + * 的候補區純敘述行都不是任務，natural 濾掉。找不到任務板段落 → null（caller 誠實 + * fallback dash_task，不硬湊）。解析不了的行一律略過，不誤判成完成（寬鬆容錯原則）。 + */ +export function parseSprintTaskBoard(md: string, sprintFile?: string): SprintBoardTask[] | null { + const secIdx = md.search(/^##\s*任務板/mu); + if (secIdx < 0) return null; + const section = md.slice(secIdx); + const lines = section.split('\n'); + const tasks: SprintBoardTask[] = []; + for (const line of lines.slice(1)) { + if (/^##\s/.test(line) && !/^###/.test(line)) break; // 下一個 H2 段落，任務板結束 + const m = line.match(BOARD_LINE); + if (!m) continue; + const mark = m[1]; + const body = m[2]; + const title = cleanBoardTitle(body); + if (!title) continue; + const completed: string[] = []; + for (const cm of body.matchAll(COMPLETED_DAY)) completed.push(cm[1]); + tasks.push({ + title, + status: mark === 'x' || mark === 'X' ? 'done' : mark === '🔄' ? 'doing' : mark === '!' ? 'blocked' : 'todo', + completed_days: completed, + sprint: sprintFile, + }); + } + return tasks.length ? tasks : null; +} + +export interface SprintRouteModel { + /** 今日路線清單：今天完成的（done）＋ 板上仍開著的（doing/todo/blocked），板序即優先序 */ + tasks: { title: string; status: 'done' | 'doing' | 'todo' | 'blocked'; sprint?: string }[]; + today_done: number; + /** 今日完成 ＋ 仍開著的板上事項（今天的可做面）——不是「今天排定量」，板不按日排定 */ + today_total: number; + done_today_titles: string[]; +} + +/** + * 任務板 →「今日完成」模型：done 只數「完成標記日期＝今天（台北）」的項；歷史完成項 + * （前幾天勾的）不進今日清單也不進計數——不冒領昨天的功。開著的項照板序全列（今日路線）。 + */ +export function buildSprintRouteModel(tasks: SprintBoardTask[], nowMs: number): SprintRouteModel { + const todayKey = taipeiDayKey(nowMs); + const doneToday = tasks.filter((t) => t.status === 'done' && t.completed_days.includes(todayKey)); + const open = tasks.filter((t) => t.status !== 'done'); + return { + tasks: [...doneToday, ...open].map((t) => ({ title: t.title, status: t.status, sprint: t.sprint })), + today_done: doneToday.length, + today_total: doneToday.length + open.length, + done_today_titles: doneToday.map((t) => t.title), + }; +} + /** 人話 age：分鐘 → 「3 分鐘前 / 5 小時前 / 3 天前」。-1 → 「時間不明」。 */ export function humanAge(minutes: number): string { if (minutes < 0) return '時間不明'; @@ -265,9 +362,18 @@ export function humanAge(minutes: number): string { * 等leo清單由 progress-guard 每日維護，90 秒新鮮度綽綽有餘。 */ export const GITEA_WAITING_CACHE_TTL_SECONDS = 90; -/** Cache API 裡存的封套：模型 + fetch 當下的牆鐘（回放時補算 age 用）。 */ +/** 同一輪 Gitea fetch 的兩個產物：等你的事（等leo清單）＋ 今日完成/路線（任務板）。 + * 板任務存「原始 completed_days」而非「今天完成幾件」——今天是誰由請求當下判定 + * （buildSprintRouteModel），快取跨台北午夜也不會把昨天的完成假裝成今天的。 */ +export interface SprintSnapshot { + waiting: WaitingModel; + /** null = 檔案讀到了但沒有可解析的任務板（caller fallback dash_task） */ + board: SprintBoardTask[] | null; +} + +/** Cache API 裡存的封套：快照 + fetch 當下的牆鐘（回放時補算 age 用）。 */ export interface CachedWaitingEnvelope { - model: WaitingModel; + snapshot: SprintSnapshot; fetched_at_ms: number; } diff --git a/cypher-executor/src/lib/taipei-time.ts b/cypher-executor/src/lib/taipei-time.ts new file mode 100644 index 0000000..ce744b7 --- /dev/null +++ b/cypher-executor/src/lib/taipei-time.ts @@ -0,0 +1,58 @@ +/** + * Asia/Taipei（UTC+8，無日光節約）時間顯示 helper（fix/console-truth-audit，2026-07-07） + * + * 為什麼存在：console 各頁原本用瀏覽器本地時區（`Date#getFullYear/getMonth/...`）渲染 + * created_at / last_used_at / 刷新時間戳——顯示結果隨看的裝置漂移（換個時區的裝置就換一個 + * 日期），且與駕駛艙 #36 的「台北日曆日」判定（`taipeiDayKey`）不是同一套。本檔把 + * 「epoch ms → 台北牆鐘」收斂成唯一實作： + * - server 側（TS）：dashboard-data 的台北日判定 import 這裡。 + * - client 側（頁面 inline JS）：console.ts / console-dashboard.ts 的 HTML 內嵌 + * `TAIPEI_CLIENT_JS`（同邏輯的 ES5 版）。等價性由 tests/taipei-time.test.ts 用 + * `new Function` 求值 client 版與 server 版逐案對照，防兩份漂移。 + * + * 台北無 DST、固定 +8——用「UTC getter ＋固定位移」即可，不需要 Intl 時區資料庫。 + */ + +export const TAIPEI_OFFSET_MS = 8 * 3600 * 1000; + +function pad2(n: number): string { + return String(n).padStart(2, '0'); +} + +/** 台北日曆日 key（'YYYY-MM-DD'）。#36 駕駛艙「這筆是不是今天寫的」判定用。 */ +export function taipeiDayKey(ms: number): string { + return new Date(ms + TAIPEI_OFFSET_MS).toISOString().slice(0, 10); +} + +/** 台北日期字串 'YYYY-MM-DD'（顯示用，同 taipeiDayKey，語意別名）。 */ +export function taipeiDateStr(ms: number): string { + return taipeiDayKey(ms); +} + +/** 台北日期＋時分 'YYYY-MM-DD HH:MM'。 */ +export function taipeiDateTimeStr(ms: number): string { + const d = new Date(ms + TAIPEI_OFFSET_MS); + return `${taipeiDayKey(ms)} ${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}`; +} + +/** 台北時分秒 'HH:MM:SS'（駕駛艙「上次刷新」戳記用）。 */ +export function taipeiTimeStr(ms: number): string { + const d = new Date(ms + TAIPEI_OFFSET_MS); + return `${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}:${pad2(d.getUTCSeconds())}`; +} + +/** + * client 版（ES5，內嵌進 console 頁 inline