admin/claw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: mark internal normalized writer plans as historical

Browse Source
This commit is contained in:
木炎
2026-05-06 09:47:38 +08:00
parent 8162118e6d
commit 6122b521a8
2 changed files with 23 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/superpowers/plans/2026-04-26-skill-normalized-result-and-dashboard-local-reader-implementation-plan.md
View File

@@ -1,16 +1,22 @@
# Skill Normalized Result And Dashboard Local Reader Implementation Plan
> Historical note (2026-05-06): this plan describes the pre-extraction in-repo `normalized_writer` implementation that once lived inside `claw-new`. The canonical implementation now lives in `D:\data\ideaSpace\rust\sgClaw\normalized_writer`.
>
> Historical archive scope: paths such as `src/result_normalization/*`, `src/bin/normalized_writer.rs`, `sgclaw::result_normalization`, and `CARGO_BIN_EXE_normalized_writer` are preserved below only as historical implementation context.
>
> Historical execution status: this file is retained as an archive of the original in-repo execution sequence. The task lists and command blocks below are no longer valid implementation instructions for `claw-new`.
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Build a stable normalized-result pipeline in `claw-new`, a local HTTP reader in `digital-employee`, and a dashboard data path that consumes normalized skill results instead of raw `run-record.json`.
**Goal:** Historical goal: build a stable normalized-result pipeline in `claw-new`, a local HTTP reader in `digital-employee`, and a dashboard data path that consumes normalized skill results instead of raw `run-record.json`.
**Architecture:** `claw-new` adds a result normalizer that reads scheduled skill `run-record.json` files and writes stable normalized snapshots plus `index.json`. `digital-employee` adds an embedded localhost-only Node reader that serves those normalized files over HTTP, while the Vue dashboard replaces static mock imports with a polling data layer that consumes the local API and supports `count_snapshot` and `detail_snapshot`.
**Architecture:** Historical architecture: `claw-new` added a result normalizer that read scheduled skill `run-record.json` files and wrote stable normalized snapshots plus `index.json`. `digital-employee` added an embedded localhost-only Node reader that served those normalized files over HTTP, while the Vue dashboard replaced static mock imports with a polling data layer that consumed the local API and supported `count_snapshot` and `detail_snapshot`.
**Tech Stack:** Rust (`serde`, `serde_json`, existing `sg_claw` CLI), Node/Express in `digital-employee`, Vue 2 + Vuex + Vue CLI dev proxy.
**Tech Stack:** Historical stack: Rust (`serde`, `serde_json`, existing `sg_claw` CLI), Node/Express in `digital-employee`, Vue 2 + Vuex + Vue CLI dev proxy.
---
## File Structure
## Historical File Structure
### `claw-new` files
@@ -69,7 +75,7 @@
---
### Task 1: Add Public Normalized Result Contract In `claw-new`
### Task 1: Historical Execution - Add Public Normalized Result Contract In `claw-new`
**Files:**
- Create: `src/result_normalization/contract.rs`
@@ -1599,7 +1605,7 @@ git -C D:/data/ideaSpace/rust/sgClaw/digital-employee add src/store/index.js src
git -C D:/data/ideaSpace/rust/sgClaw/digital-employee commit -m "feat: add dashboard results store"
```
### Task 10: Replace Static Report Data With Live Results In Dashboard
### Task 10: Historical Execution - Replace Static Report Data With Live Results In Dashboard
**Files:**
- Modify: `D:/data/ideaSpace/rust/sgClaw/digital-employee/src/views/Dashboard.vue`
@@ -1710,7 +1716,7 @@ git -C D:/data/ideaSpace/rust/sgClaw/digital-employee add src/views/Dashboard.vu
git -C D:/data/ideaSpace/rust/sgClaw/digital-employee commit -m "feat: wire dashboard to normalized results"
```
### Task 11: Document Operator Workflow And Validate End-To-End
### Task 11: Historical Execution - Document Operator Workflow And Validate End-To-End
**Files:**
- Modify: `D:/data/ideaSpace/rust/sgClaw/digital-employee/README.md`
@@ -1786,4 +1792,3 @@ npm run serve:web
git add docs/superpowers/plans/2026-04-26-skill-normalized-result-and-dashboard-local-reader-implementation-plan.md D:/data/ideaSpace/rust/sgClaw/digital-employee/README.md
git commit -m "docs: document normalized result implementation workflow"
```