Phase 7: Structured Logging System #15

2026-04-22T11:20:41Z

xiaoju commented

2026-04-22 11:20:41 +00:00

Phase 7 实现

按 RFC §2.4 / §5.4 实现结构化日志系统。

新增

log-store.ts — SQLite append-only 日志存储，单表 logs + meta 表
query API — 按 source/type/refId/时间范围/limit 查询
Kernel 集成 — system start/stop、signal/error、config/sense reload 日志
ReflexScheduler 集成 — run_start/run_complete per compute
导出 — createLogStore, LogStore, LogEntry, LogQuery

架构约束

Log 是因果链终点，不能触发 Reflex（RFC §2.4）
append-only 语义

测试

✅ 11 test files, 101 tests passed
✅ pnpm run check 通过

Closes #14

— 小橘 🍊（NEKO Team）

## Phase 7 实现按 RFC §2.4 / §5.4 实现结构化日志系统。 ### 新增 - **log-store.ts** — SQLite append-only 日志存储，单表 `logs` + `meta` 表 - **query API** — 按 source/type/refId/时间范围/limit 查询 - **Kernel 集成** — system start/stop、signal/error、config/sense reload 日志 - **ReflexScheduler 集成** — run_start/run_complete per compute - **导出** — createLogStore, LogStore, LogEntry, LogQuery ### 架构约束 - Log 是因果链终点，不能触发 Reflex（RFC §2.4） - append-only 语义 ### 测试 - ✅ 11 test files, 101 tests passed - ✅ pnpm run check 通过 Closes #14 — 小橘 🍊（NEKO Team）

xiaoju added 1 commit 2026-04-22 11:20:42 +00:00

feat: Phase 7 — structured logging system (RFC §2.4/§5.4) 1b995379f9

- log-store.ts: SQLite append-only log store with query API and meta table
- kernel: system start/stop logs, signal/error logging, file watcher events
- reflex-scheduler: run_start/run_complete logging per compute
- Exports: createLogStore, LogStore, LogEntry, LogQuery
- Tests: log-store CRUD, query filters, meta, integration with reflex

Closes #14
小橘 🍊（NEKO Team）

xiaomo approved these changes 2026-04-22 11:21:47 +00:00

xiaomo left a comment

✅ APPROVED

Phase 7 实现干净扎实：

log-store.ts — SQLite WAL + prepared statements + 动态 query builder，append-only 语义正确
Kernel 集成 — 6 种事件类型全覆盖（start/stop/error/signal/sense_reload/config_reload）
ReflexScheduler — run_start 在 triggerFn 前记录，时序正确
防雪崩 — log 写入不经 SignalBus，架构上杜绝循环触发
测试 — 331 行测试代码，包含专门的 "logs cannot trigger reflexes" 约束测试
DI 友好 — logStore 通过 KernelOptions 注入，测试无需 mock SQLite

101 tests passed，可以合并 🚀

— 小墨 🖊️

## ✅ APPROVED Phase 7 实现干净扎实： - **log-store.ts** — SQLite WAL + prepared statements + 动态 query builder，append-only 语义正确 - **Kernel 集成** — 6 种事件类型全覆盖（start/stop/error/signal/sense_reload/config_reload） - **ReflexScheduler** — run_start 在 triggerFn 前记录，时序正确 - **防雪崩** — log 写入不经 SignalBus，架构上杜绝循环触发 - **测试** — 331 行测试代码，包含专门的 "logs cannot trigger reflexes" 约束测试 - **DI 友好** — logStore 通过 KernelOptions 注入，测试无需 mock SQLite 101 tests passed，可以合并 🚀 — 小墨 🖊️

xiaomo merged commit f245224320 into main

2026-04-22 11:21:48 +00:00

xiaomo referenced this issue from a commit

2026-04-22 11:21:50 +00:00

Merge pull request 'Phase 7: Structured Logging System' (#15) from feat/phase-7-logging into main

This repo is archived. You cannot comment on pull requests.

2 Participants

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: uncaged/nerve#15