ai-dev-analytics 1.1.11 → 2.0.0

package/README.en.md

@@ -2,90 +2,98 @@
 
 # AIDA
 
-### Make Vibe Coding Measurable.
+### Make project rules, skills, and module memory the real source of truth.
 
-Every vibe coding session generates massive insights — deviations, patterns, quality signals.<br>
-*But you close the terminal, and all of it vanishes. Next session, you start blind again.*<br>
-**AIDA captures structured data at every development checkpoint, visualizes it in a live dashboard, and distills deviation patterns into rules that make your AI write better code — every single run.**
-
-One line to integrate. Zero workflow changes.
+AIDA 2.0 is no longer centered on task ledgers or run timelines. It keeps the assets that actually matter over time:
+**rules, skills, module memory, and branch-level demand summaries.**
 
 ```json
-{ "mcpServers": { "aida": { "command": "npx", "args": ["-y", "ai-dev-analytics", "mcp"] } } }
+{ "mcpServers": { "aida": { "command": "npx", "args": ["--registry=https://registry.npmjs.org/", "-y", "ai-dev-analytics", "mcp"] } } }
 ```
 
-[![npm version](https://img.shields.io/badge/npm-v1.1.7-0066ff)](https://www.npmjs.com/package/ai-dev-analytics)
+[![npm version](https://img.shields.io/badge/npm-v2.0.0-0066ff)](https://www.npmjs.com/package/ai-dev-analytics)
 [![license](https://img.shields.io/github/license/LWTlong/ai-dev-analytics?color=%23333)](./LICENSE)
 [![node](https://img.shields.io/node/v/ai-dev-analytics?color=%23339933)](https://nodejs.org)
 [![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#testing)
-[![Live Demo](https://img.shields.io/badge/🎯_Live_Demo-Interactive_Dashboard-FF4B4B)](https://lwtlong.github.io/ai-dev-analytics/)
-[![ai-dev-analytics MCP server](https://glama.ai/mcp/servers/LWTlong/ai-dev-analytics/badges/score.svg)](https://glama.ai/mcp/servers/LWTlong/ai-dev-analytics)
-
-[![ai-dev-analytics MCP server](https://glama.ai/mcp/servers/LWTlong/ai-dev-analytics/badges/card.svg)](https://glama.ai/mcp/servers/LWTlong/ai-dev-analytics)
 
-[Quick Start](#-30-second-setup) · [Data Loop](#-the-data-driven-loop) · [Dashboard](#-the-dashboard) · [Command Reference](./COMMANDS.md) · [Docs](./docs/INDEX.md) · [中文](./README.md)
+[Chinese README](./README.md) · [Command Reference](./COMMANDS.md) · [Docs](./docs/INDEX.md)
 
 </div>
 
 ---
 
-## The Insight
+## What AIDA 2.0 Keeps
+
+The durable truth sources are:
+
+```text
+.aida/
+  config.json
+  rules.json
+  skills.json
+  summary.json
+  aida-guide.md
+  memories/
+    index.json
+    modules/*.json
+  rules/*.md
+```
 
-Vibe coding is powerful. But it's a black box.
+- `rules.json`: project-level technical rules
+- `skills.json`: project-level skills registry
+- `memories/index.json`: low-cost memory lookup index
+- `memories/modules/*.json`: module-level business memory
+- `summary.json`: branch / demand summaries
 
-You tell Claude to build a feature. It writes code. You ship it. But you have **zero visibility** into what actually happened:
+## What AIDA 2.0 Discards
 
-- How many tasks did AI complete? How long did each take?
-- Where did AI deviate from your project conventions? Why?
-- Which deviations keep recurring? What rules would prevent them?
-- What's the bug rate? Which phases produce the most bugs?
+2.0 intentionally removes the heavy 1.x runtime ledger model:
 
-Without data, you can't improve. You're just vibing — over and over, with the same blind spots.
+- `run.json`
+- persistent task ledgers
+- timeline / events / workflow history
+- `.aida/runs/**`
+- `.aida/index.json`
+- `.aida/tool-configs.json`
 
-**AIDA makes the invisible visible.** It collects structured data from every vibe coding session, renders it in a real-time dashboard, and turns deviation patterns into project rules. Your AI doesn't just code — it **learns your project**.
+Migration is a cleaning rebuild, not a full carry-over.
 
----
+## Command Model
 
-## 🔄 The Data-Driven Loop
+The main 2.0 commands are:
 
-```
-Vibe Coding Session
-        ↓
-   AIDA silently collects structured data
-   (tasks, deviations, bugs, reviews, files, timeline)
-        ↓
-   Dashboard visualizes patterns
-        ↓
-   Deviation patterns identified → AI suggests rules → user confirms → sedimented
-   .aida/rules.json
-        ↓
-   AI reads rules next session → same mistakes eliminated
+```bash
+aida init
+aida sync
+aida build
+aida doctor
+aida migrate-legacy
 ```
 
-See the Chinese main README for the latest product positioning and examples: [README.md](./README.md).
+- `init`: create the 2.0 truth-source layout
+- `sync`: refresh memories, summaries, and generated tool artifacts
+- `build`: rebuild generated artifacts from JSON truth sources
+- `doctor`: inspect and normalize project state
+- `migrate-legacy`: migrate 1.x / legacy projects into the 2.0 structure
 
----
+## Context Recovery
 
-## 📊 The Dashboard
+Memory recovery is intentionally layered:
 
-Run:
+1. read `memories/index.json`
+2. read `summary.json`
+3. only read matched `memories/modules/*.json`
 
-```bash
-npx ai-dev-analytics dashboard
-```
-
-Then open `http://localhost:2375`.
+This keeps token usage low and prevents loading the full memory corpus every time.
 
-Live demo: [https://lwtlong.github.io/ai-dev-analytics/](https://lwtlong.github.io/ai-dev-analytics/)
-
----
+## Notes
 
-## ⚡ 30-Second Setup
+- MCP is an optional structured execution channel, not the system foundation.
+- CLI and MCP should operate on the same JSON truth sources.
+- Built-in bundled workflow skills are no longer seeded by default in 2.0.
 
-Add one MCP entry:
-
-```json
-{ "mcpServers": { "aida": { "command": "npx", "args": ["-y", "ai-dev-analytics", "mcp"] } } }
-```
+For full product explanation, migration behavior, and Chinese examples, use:
 
-For detailed command behavior, migration notes, dedupe rules, and rerun semantics, see [COMMANDS.md](./COMMANDS.md).
+- [README.md](./README.md)
+- [COMMANDS.md](./COMMANDS.md)
+- [docs/AIDA-2.0-DESIGN.md](./docs/AIDA-2.0-DESIGN.md)

package/README.md

@@ -2,19 +2,19 @@
 
 # AIDA
 
-### 让 Vibe Coding 数据化。
+### 让 AI 项目规则、技能和模块记忆真正成为真源。
 
-每一次 Vibe Coding 都在产生大量信号 —— 偏差、模式、质量数据。<br>
-*但你关掉终端，这些全部消失。下次对话，继续盲写。*<br>
-**AIDA 在每个开发节点采集结构化数据，用看板可视化，再把偏差规律沉淀成规则 —— 让你的 AI 每次运行都写出更符合预期的代码。**
+项目里真正长期有价值的，不是 task 流水账，而是：<br>
+*规则、技能、模块业务记忆，以及需求最终改了什么。*<br>
+**AIDA 2.0 把这些资产统一沉淀到 `.aida/*.json`，再稳定分发到 Claude / Cursor / Codex 等工具。**
 
-一行配置接入，零工作流改变。
+一行配置接入，最少命令，围绕 JSON 真源工作。
 
 ```json
 { "mcpServers": { "aida": { "command": "npx", "args": ["--registry=https://registry.npmjs.org/", "-y", "ai-dev-analytics", "mcp"] } } }
 ```
 
-[![npm version](https://img.shields.io/badge/npm-v1.1.7-0066ff)](https://www.npmjs.com/package/ai-dev-analytics)
+[![npm version](https://img.shields.io/badge/npm-v2.0.0-0066ff)](https://www.npmjs.com/package/ai-dev-analytics)
 [![license](https://img.shields.io/github/license/LWTlong/ai-dev-analytics?color=%23333)](./LICENSE)
 [![node](https://img.shields.io/node/v/ai-dev-analytics?color=%23339933)](https://nodejs.org)
 [![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#测试)
@@ -23,7 +23,7 @@
 
 [![ai-dev-analytics MCP server](https://glama.ai/mcp/servers/LWTlong/ai-dev-analytics/badges/card.svg)](https://glama.ai/mcp/servers/LWTlong/ai-dev-analytics)
 
-[一行接入](#-30-秒上手) · [场景操作指南](#-场景操作指南) · [数据驱动闭环](#-数据驱动闭环) · [命令速览](#-命令速览) · [重复执行与覆盖策略](#-重复执行与覆盖策略) · [规则去重与冲突判断](#-规则去重与冲突判断) · [命令文档](./COMMANDS.md) · [文档导航](./docs/INDEX.md) · [English](./README.en.md)
+[一行接入](#-30-秒上手) · [2.0 真源模型](#-20-真源模型) · [场景操作指南](#-场景操作指南) · [命令速览](#-命令速览) · [重复执行与覆盖策略](#-重复执行与覆盖策略) · [规则去重与冲突判断](#-规则去重与冲突判断) · [命令文档](./COMMANDS.md) · [文档导航](./docs/INDEX.md) · [English](./README.en.md)
 
 </div>
 
@@ -31,62 +31,52 @@
 
 ## 一个洞察
 
-Vibe Coding 很强。但它是一个黑箱。
+AI 编码很强，但项目记忆往往是散的。
 
-你让 Claude 写一个功能，它写了，你 ship 了。但你对过程**零可见性**：
+你让 Claude 写一个功能，它写了，你 ship 了。但长期真正缺的是这些：
 
-- AI 完成了多少任务？每个任务花了多长时间？
-- AI 在哪里偏离了你的项目规范？为什么？
-- 哪些偏差反复出现？加什么规则能根治？
-- Bug 率多少？哪个阶段产出最多 Bug？
+- 这个项目有哪些长期有效的规则？
+- 这个项目有哪些真正要保留的 skills？
+- 某个模块以前为什么这么写？
+- 上一个需求改了哪些模块、为什么改？
 
-没有数据，你就无法改进。你只是在一遍又一遍地 vibe —— 带着同样的盲区。
+没有这些真源，AI 每次都像新同事第一次进项目，靠重新扫代码碰运气。
 
-**AIDA 让不可见变可见。** 它在每次 vibe coding 过程中采集结构化数据，用实时看板渲染，再把偏差模式沉淀成项目规则。你的 AI 不再只是写代码 —— 它**学习你的项目**。
+**AIDA 2.0 让这些资产固定下来。** 它把规则、技能、模块记忆和需求摘要沉淀成统一 JSON 真源，再分发到你实际使用的 AI 工具里。你的 AI 不再只是写代码，它开始**继承你的项目上下文**。
 
 ---
 
-## 🔄 数据驱动闭环
+## 🧱 2.0 真源模型
 
-这是 AIDA 的核心 —— **数据进来，规则出去，代码越来越好。**
+2.0 的核心不是 run/task 流水账，而是这 5 类真源：
 
 ```
-Vibe Coding 过程
-        ↓
-   AIDA 静默采集结构化数据
-   （任务、偏差、Bug、自检、文件变更、时间线）
-        ↓
-   看板可视化呈现规律
-   "9 个偏差 → 56% 幻觉, 44% 规则缺失"
-        ↓
-   发现偏差规律 → AI 建议沉淀规则 → 用户确认 → 写入规则库
-   .aida/rules.json ← 你的 AI 知识库在成长
-        ↓
-   AI 下次读取规则 → 同样的错误被消除
-        ↓
-   循环往复 —— 每一轮，AI 输出都更接近你的预期
+.aida/
+  config.json
+  rules.json
+  skills.json
+  summary.json
+  aida-guide.md
+  memories/
+    index.json
+    modules/*.json
+  rules/*.md
 ```
 
-**来自真实生产项目的数据：**
+- `rules.json`：项目级技术规范真源
+- `skills.json`：项目级技能真源
+- `memories/index.json`：模块目录索引，低 token 检索入口
+- `memories/modules/*.json`：模块正文，记录为什么这么实现、改过什么
+- `summary.json`：需求/分支级轻量摘要，记录这次最终改了什么
 
-| 运行 | 偏差情况 | 发生了什么 | 沉淀的规则 |
-|------|---------|-----------|-----------|
-| 第 1 轮 | 47 个任务产生 23 个偏差 | AI 组件用错、布局写反、API 模式不对 | 沉淀 6 条项目专属规则 |
-| 第 2 轮 | **零重复偏差** | AI 读了规则，相同模式的错误归零 | — |
+2.0 会主动丢弃这些 1.x 噪音：
 
-**第一步：看清 AI *为什么*出错** —— 根因分布一目了然：是 AI 幻觉、规则缺失、还是上下文不足？
-
-![偏差根因分布](https://raw.githubusercontent.com/LWTlong/ai-dev-analytics/main/docs/deviation-root-cause.png)
-
-**第二步：看清 AI *在哪*出错** —— 类别分布精准定位：UI 间距、布局结构、组件使用、API 模式。
-
-![偏差类别分布](https://raw.githubusercontent.com/LWTlong/ai-dev-analytics/main/docs/deviation-category.png)
-
-**第三步：看规则的复利效应** —— 随着规则积累，重复偏差会逐步下降。
-
-![偏差与规则趋势](https://raw.githubusercontent.com/LWTlong/ai-dev-analytics/main/docs/deviation-rule-trend.png)
-
-`.aida/rules.json` 就是你的**项目专属 AI 知识库**。用 AI 写得越多，它对*你的项目*就越懂。
+- `run.json`
+- `task` 持久化流水账
+- `timeline / events / workflow`
+- `.aida/runs/**`
+- `.aida/index.json`
+- `.aida/tool-configs.json`
 
 ---
 
@@ -216,7 +206,6 @@ aida init
 
 你会在交互里选择：
 
-- `collect` 或 `full` 模式
 - 需要接入的 AI 工具
 - 是否导入现有工具的规则 / skills 作为 baseline
 
@@ -224,7 +213,7 @@ aida init
 
 ```bash
 aida build
-aida status
+aida doctor
 ```
 
 ### 2. 老项目迁移到 AIDA
@@ -531,7 +520,6 @@ AIDA 用 `fingerprint` 判断 exact duplicate。生成规则如下：
 
 - `.aida/rules/*.md`
 - `.aida/memories/modules/*.md`
-- `.aida/runs/*/context.md`
 - `.cursor/rules/aida/*`
 - `.codex/rules/aida/*`
 - `.claude/rules/aida/*`
@@ -548,14 +536,15 @@ AIDA 用 `fingerprint` 判断 exact duplicate。生成规则如下：
 
 ---
 
-## 📁 数据沉淀与绩效汇报
+## 📁 数据沉淀与需求回顾
 
-AIDA 不只是可视化 —— 它**沉淀数据**。每次运行都积累结构化数据，时间越长价值越大。
+AIDA 2.0 沉淀的重点不是过程流水账，而是长期有价值的结果：
 
-```
-第 1 周：47 个任务、23 个偏差、5 个 Bug、6 条规则、4064 行代码
-第 4 周：180+ 任务、偏差率持续下降、15 条规则、完整质量历史
-一个季度：完整的开发记录 —— 可导出、可分析、可汇报
-```
+- 项目级规则
+- 项目技能
+- 模块业务记忆
+- 需求 / 分支级摘要
+
+这些数据全部都在 `.aida/` 里，以结构化 JSON 保存。你可以直接查询、导出，或接到自己的报表系统里。
 
-所有数据都在 `.aida/` 里，格式是结构化 JSON。没有厂商锁定，随时可以导出、查询或接入别的报表系统。
+更重要的是，AI 下次再改同一个模块时，不需要重新从头猜项目背景，而是可以先通过 memory 索引找到这个模块以前改过什么、为什么改。

package/dist/cli/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAoCA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAiC3C"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAoCA,wBAAsB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAgC3C"}

package/dist/cli/commands/build.js

@@ -47,7 +47,6 @@ export async function build() {
     if (result.mcpFiles.length > 0) {
         console.log(`  MCP: ${result.mcpFiles.join(', ')}`);
     }
-    console.log(`  Tool config snapshot: ${result.toolConfigSnapshot}`);
     if (result.gitignoreAdded.length > 0) {
         console.log(`  .gitignore: added ${result.gitignoreAdded.join(', ')}`);
     }

package/dist/cli/commands/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function doctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAcA,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAmE5C"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,70 @@
+import { green, red, yellow, cyan, dim } from '../../utils/display.js';
+import { configPath } from '../../utils/paths.js';
+import { fileExists } from '../../utils/fs.js';
+import { inspectProjectHealth, normalizeProjectTruthSources } from '../../utils/project-health.js';
+import { findSimilarRules, loadRegistry } from '../../utils/rules.js';
+function hasFixFlag() {
+    return process.argv.slice(3).includes('--fix');
+}
+function line(ok, label, detail) {
+    console.log(`${ok ? green('  ✓') : yellow('  !')} ${label}: ${detail}`);
+}
+export async function doctor() {
+    const projectRoot = process.cwd();
+    console.log(cyan('\n  AIDA Doctor\n'));
+    if (!fileExists(configPath(projectRoot))) {
+        console.log(red('  AIDA not initialized. Run `npx aida init` first.\n'));
+        return;
+    }
+    const fix = hasFixFlag();
+    if (fix) {
+        const normalized = normalizeProjectTruthSources(projectRoot);
+        console.log(green('  ✓ Normalized truth sources'));
+        console.log(`    rules: ${normalized.rules}`);
+        console.log(`    skills: ${normalized.skills}`);
+        console.log(`    memories: ${normalized.memories}`);
+        console.log(`    summary: ${normalized.summary}`);
+        console.log('');
+    }
+    const report = inspectProjectHealth(projectRoot);
+    const similarRules = findSimilarRules(loadRegistry(projectRoot)).slice(0, 10);
+    line(report.rules.exists && !report.rules.legacyRoot, 'rules.json', `${report.rules.count} entries`);
+    line(report.skills.exists && !report.skills.legacyRoot, 'skills.json', `${report.skills.count} entries`);
+    line(report.memories.indexExists && !report.memories.indexLegacyRoot && !report.memories.nestedLayout, 'memories', `${report.memories.moduleCount} modules`);
+    line(report.summary.exists, 'summary.json', `${report.summary.count} summaries`);
+    line(!report.runs.runtimeDirExists && report.runs.legacySchema === 0, 'legacy runtime', report.runs.runtimeDirExists ? '.aida/runs still exists' : 'clean');
+    line(similarRules.length === 0, 'rule duplicates', similarRules.length === 0 ? 'no near-duplicate rules' : `${similarRules.length} potential pair(s)`);
+    if (report.warnings.length === 0 && similarRules.length === 0) {
+        console.log(green('\n  ✓ Project health looks good.\n'));
+        return;
+    }
+    if (report.warnings.length > 0) {
+        console.log(yellow('\n  Warnings'));
+        for (const warning of report.warnings) {
+            console.log(`  - ${warning}`);
+        }
+    }
+    if (similarRules.length > 0) {
+        console.log(yellow(`\n  Potential duplicate rules (${similarRules.length})`));
+        for (const { a, b, similarity } of similarRules) {
+            const pct = Math.round(similarity * 100);
+            console.log(`  - ${a.id} ↔ ${b.id} (${pct}% similar)`);
+            console.log(`    A: ${a.content}`);
+            console.log(`    B: ${b.content}`);
+        }
+    }
+    console.log('');
+    if (report.runs.legacySchema > 0 || report.runs.runtimeDirExists) {
+        console.log(dim('\n  Run `aida doctor --fix` or `aida migrate-legacy` to extract 2.0 truth sources and remove legacy runtime artifacts.\n'));
+    }
+    else if (similarRules.length > 0) {
+        console.log(dim('  Review the pairs above. Keep both if they are materially different; merge or deprecate one if they are duplicates.\n'));
+    }
+    else if (!fix) {
+        console.log(dim('\n  Run `aida doctor --fix` to normalize JSON truth sources and rebuild summary/index.\n'));
+    }
+    else {
+        console.log('');
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AA+GA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAoO1C"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAuCA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuJ1C"}