aodw-skill 0.7.17 → 0.7.19

package/bin/commands/new.js

@@ -1,11 +1,8 @@
 import fs from 'fs-extra';
 import path from 'path';
-import http from 'http';
-import https from 'https';
-import { URL } from 'url';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
-import { getProjectConfig, getUserConfig } from '../utils/config.js';
+import { getProjectConfig } from '../utils/config.js';
 
 function getProjectName() {
     // 1. Try .aodw/project.yaml
@@ -25,35 +22,6 @@ function getProjectName() {
     return path.basename(process.cwd());
 }
 
-function fetchIdFromServer(serverUrl, project) {
-    return new Promise((resolve, reject) => {
-        const url = new URL('/api/next-id', serverUrl);
-        url.searchParams.set('project', project);
-
-        const client = url.protocol === 'https:' ? https : http;
-
-        const req = client.get(url.toString(), (res) => {
-            if (res.statusCode !== 200) {
-                reject(new Error(`Server returned status ${res.statusCode}`));
-                return;
-            }
-
-            let data = '';
-            res.on('data', (chunk) => data += chunk);
-            res.on('end', () => {
-                try {
-                    const json = JSON.parse(data);
-                    resolve(json.id);
-                } catch (e) {
-                    reject(e);
-                }
-            });
-        });
-
-        req.on('error', (e) => reject(e));
-    });
-}
-
 function getLocalMaxSeq() {
     const rtDir = path.join(process.cwd(), 'RT');
     if (!fs.existsSync(rtDir)) return 0;
@@ -77,34 +45,7 @@ function getLocalNextId() {
     return `RT-${String(maxSeq + 1).padStart(3, '0')}`;
 }
 
-function syncIdToServer(serverUrl, project, seq) {
-    return new Promise((resolve, reject) => {
-        const url = new URL('/api/sync-id', serverUrl);
-        url.searchParams.set('project', project);
-        url.searchParams.set('seq', seq.toString());
-
-        const client = url.protocol === 'https:' ? https : http;
-
-        const req = client.request(url.toString(), { method: 'POST' }, (res) => {
-            if (res.statusCode === 200) {
-                resolve(true);
-            } else {
-                reject(new Error(`Server returned status ${res.statusCode}`));
-            }
-        });
-
-        req.on('error', (e) => reject(e));
-        req.end();
-    });
-}
-
-
 export async function createNewRT(options) {
-    const userConfig = getUserConfig();
-
-    // Determine Server URL: Flag > Config > Env Var
-    const serverUrl = options.server || userConfig.server_url || process.env.AODW_ID_SERVER;
-
     // Determine Project Name: Flag > Config/Package/Dir
     const project = options.project || getProjectName();
 
@@ -120,66 +61,9 @@ export async function createNewRT(options) {
         title = answers.title;
     }
 
-    let id;
-    // Check if user has configured collaborative mode
-    const isCollaborativeMode = userConfig.mode === 'collaborative';
-
-    if (isCollaborativeMode) {
-        // In collaborative mode, server URL is required
-        if (!serverUrl || serverUrl.trim() === '') {
-            console.error(chalk.red('Error: Collaborative mode requires a server URL.'));
-            console.error(chalk.yellow('Please configure the server URL by running: aodw config'));
-            console.error(chalk.yellow('Or set the AODW_ID_SERVER environment variable.'));
-            process.exit(1);
-        }
-
-        try {
-            console.log(chalk.blue(`Fetching ID from server (${serverUrl})...`));
-            const serverId = await fetchIdFromServer(serverUrl, project);
-            const serverSeq = parseInt(serverId.replace('RT-', ''), 10);
-
-            // Get local max ID and compare
-            const localMaxSeq = getLocalMaxSeq();
-
-            if (serverSeq <= localMaxSeq) {
-                // Server ID is outdated, use local max + 1
-                const finalSeq = localMaxSeq + 1;
-                id = `RT-${String(finalSeq).padStart(3, '0')}`;
-                console.log(chalk.yellow(`⚠ Server ID (${serverId}) ≤ local max (RT-${String(localMaxSeq).padStart(3, '0')})`));
-                console.log(chalk.green(`Using local ID: ${id}`));
-
-                // Sync to server
-                try {
-                    await syncIdToServer(serverUrl, project, finalSeq);
-                    console.log(chalk.blue(`✔ Synced ID to server: ${id}`));
-                } catch (syncErr) {
-                    console.warn(chalk.yellow(`⚠ Failed to sync ID to server: ${syncErr.message}`));
-                    console.warn(chalk.yellow('  The server may not support sync-id API, but RT creation will continue.'));
-                }
-            } else {
-                id = serverId;
-                console.log(chalk.green(`Obtained ID: ${id}`));
-            }
-        } catch (e) {
-            console.error(chalk.red(`Failed to fetch ID from server: ${e.message}`));
-            const { useLocal } = await inquirer.prompt([{
-                type: 'confirm',
-                name: 'useLocal',
-                message: 'Do you want to fall back to local ID generation? (Warning: Risk of collision)',
-                default: false
-            }]);
-            if (!useLocal) process.exit(1);
-            id = getLocalNextId();
-        }
-    } else {
-        // Independent mode: always use local generation, ignore server_url
-        // This ensures that when user chooses independent mode, no network request is made
-        id = getLocalNextId();
-        console.log(chalk.yellow(`Using local ID generation: ${id}`));
-        if (serverUrl) {
-            console.log(chalk.gray(`Note: server_url is configured but ignored in independent mode`));
-        }
-    }
+    // 固定独立模式：始终本地生成 RT-ID
+    const id = getLocalNextId();
+    console.log(chalk.yellow(`Using local ID generation: ${id}`));
 
     // Create Directory
     const rtPath = path.join(process.cwd(), 'RT', id);

package/bin/processors/index.js

@@ -61,7 +61,7 @@ export class CursorProcessor extends BaseProcessor {
         let processed = content.replace(/\{\{REF_PREFIX\}\}/g, '@');
         // Replace AODW_DIR placeholder (Next version - fixed to .aodw-next)
         processed = processed.replace(/\{\{AODW_DIR\}\}/g, '.aodw-next');
-        
+
         // For Rules (.mdc): Inject globs and alwaysApply
         if (this.targetPath.endsWith('.mdc')) {
             processed = this.injectFrontmatter(processed, 'globs', '*');
@@ -73,18 +73,6 @@ export class CursorProcessor extends BaseProcessor {
     }
 }
 
-export class CopilotProcessor extends BaseProcessor {
-    transform(content) {
-        // For Prompts: Inject model and mode
-        if (this.targetPath.endsWith('.prompt.md')) {
-            let newContent = this.injectFrontmatter(content, 'model', 'gpt-4o');
-            newContent = this.injectFrontmatter(newContent, 'mode', 'chat');
-            return newContent;
-        }
-        return content;
-    }
-}
-
 export class ClaudeProcessor extends BaseProcessor {
     transform(content) {
         // Replace template placeholders: empty for Claude
@@ -95,25 +83,3 @@ export class ClaudeProcessor extends BaseProcessor {
         return processed;
     }
 }
-
-export class GeminiProcessor extends BaseProcessor {
-    transform(content) {
-        // Replace template placeholders: empty for Gemini
-        let processed = content.replace(/\{\{REF_PREFIX\}\}/g, '');
-        // Replace AODW_DIR placeholder (Next version - fixed to .aodw-next)
-        processed = processed.replace(/\{\{AODW_DIR\}\}/g, '.aodw-next');
-        // Gemini uses standard markdown, no frontmatter needed
-        return processed;
-    }
-}
-
-export class GeneralProcessor extends BaseProcessor {
-    transform(content) {
-        // Replace template placeholders: empty for General
-        let processed = content.replace(/\{\{REF_PREFIX\}\}/g, '');
-        // Replace AODW_DIR placeholder (Next version - fixed to .aodw-next)
-        processed = processed.replace(/\{\{AODW_DIR\}\}/g, '.aodw-next');
-        // General uses standard markdown, no frontmatter needed
-        return processed;
-    }
-}

package/bin/update-adapters-from-template.js

@@ -16,9 +16,7 @@ import { fileURLToPath } from 'url';
 import {
   AntigravityProcessor,
   CursorProcessor,
-  ClaudeProcessor,
-  GeminiProcessor,
-  GeneralProcessor
+  ClaudeProcessor
 } from './processors/index.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -66,18 +64,6 @@ async function updateAdapters() {
   await fs.ensureDir(path.dirname(claudeTarget));
   await installFile(SOURCE_TEMPLATE, claudeTarget, ClaudeProcessor);
 
-  // Gemini
-  console.log('\n📦 Updating Gemini adapter...');
-  const geminiTarget = path.join(TARGET_ADAPTERS, 'gemini/.agent/rules/aodw-next.md');
-  await fs.ensureDir(path.dirname(geminiTarget));
-  await installFile(SOURCE_TEMPLATE, geminiTarget, GeminiProcessor);
-
-  // General
-  console.log('\n📦 Updating General adapter...');
-  const generalTarget = path.join(TARGET_ADAPTERS, 'general/AGENTS.md');
-  await fs.ensureDir(path.dirname(generalTarget));
-  await installFile(SOURCE_TEMPLATE, generalTarget, GeneralProcessor);
-
   console.log('\n✅ All adapters updated successfully!');
   console.log('\n📝 Note: These files are fallback files for CLI installation.');
   console.log('   CLI will use the template directly if available.');

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "aodw-skill",
-  "version": "0.7.17",
+  "version": "0.7.19",
   "description": "Next-channel CLI tool to scaffold AODW in your project",
   "main": "bin/aodw.js",
   "files": [
     "bin/",
     ".aodw-next/",
-    "AODW_Adapters/",
-    "docs/"
+    "AODW_Adapters/"
   ],
   "bin": {
     "aodw-skill": "bin/aodw.js"
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "pack:check": "npm pack --dry-run"
   },
   "keywords": [
     "aodw",

package/.aodw-next/01-core/ai-interaction-rules-summary.md

@@ -1,37 +0,0 @@
-# AI 交互规则摘要
-
-## 0. UI 任务判断（前置）
-
-涉及页面/界面/布局/组件/表单/Dashboard/交互体验 → 视为 UI 任务，进入 UI 专用流程（详见 `.aodw-next/02-workflow/ui-workflow-rules.md`）。
-
-## 1. 提问类型
-
-- **决策型**：必须提供选项 + 推荐 + 理由，支持 custom 回答
-- **信息型**：必须提供示例答案，限制 ≤10 词
-
-## 2. 格式规范
-
-```
-Q1. <问题>
-A. <选项1>  B. <选项2>  C. <选项3>
-Recommended: B（理由：……）
-请回复：A/B/C 或 custom:<答案>
-```
-
-## 3. 每轮限制
-
-- 单轮最多 5 个问题，建议 ≤3 个
-- 必须 Ask → Wait → Respond → Continue，不得连续提问
-
-## 4. 中断与暂停
-
-- 用户说"暂停" → 立即停止，切换普通模式
-- 用户说"继续 AODW" → 恢复流程
-
-## 5. 实现前门槛（四要素）
-
-编码前必须满足：假设已声明 / 歧义已处理 / 成功标准已定义 / 最小方案已确认。缺一不可。
-
-## 6. 分支验证
-
-任何代码修改前必须 `git branch --show-current`，在 main/master 上**立即停止**。

package/.aodw-next/01-core/ai-knowledge-rules-summary.md

@@ -1,25 +0,0 @@
-# AI 知识规则摘要
-
-## 1. 文档分类
-
-- **Spec 文档**：spec.md / rt-lite.md（需求定义）
-- **Plan 文档**：plan.md / rt-lite.md §2（实现方案）
-- **过程文档**：impact.md / invariants.md / tests.md / changelog.md
-- **知识文档**：模块 README / modules-index.yaml
-
-## 2. Spec-Lite 的 rt-lite.md
-
-不再创建独立的 spec-lite.md 和 plan-lite.md，全部整合在 rt-lite.md 中。
-
-## 3. 文档同步原则
-
-- 代码改动后必须同步更新相关文档
-- 文档与代码不一致视为 Bug
-- RT 完成前必须执行知识蒸馏（更新模块文档和 modules-index.yaml）
-
-## 4. 知识蒸馏（RT 完成前提）
-
-合并前必须：
-1. 读取 modules-index.yaml 找到受影响模块
-2. 更新对应模块 README
-3. 确认文档反映最新代码状态

package/.aodw-next/01-core/git-discipline-summary.md

@@ -1,36 +0,0 @@
-# Git Discipline 摘要
-
-## 0. 确认门控
-
-AI 可执行所有 Git 操作，但不可逆操作（commit / merge / push / tag / worktree add-remove / branch delete）执行前**必须向用户确认**。
-
-无需确认：读取文件、git log/status/diff、创建/切换分支。
-
-## 1. 分支命名
-
-格式：`feature/RT-{seq}-{short-name}`（kebab-case，2-4 词）
-示例：`feature/RT-001-login-fix`
-
-## 2. Worktree
-
-一个 RT = 一个 Worktree = 一个 Feature 分支。
-- 创建：Decision 阶段 `git worktree add ../Project-RT-XXX feature/RT-XXX-name`
-- 清理：RT 完成合并后删除
-
-## 3. 提交信息
-
-格式：`<type>(<scope>): <subject>` + `Refs: RT-XXX`
-示例：`fix(auth): handle token expiration — Refs: RT-001`
-
-## 4. 标签
-
-完成后打标签：`done-RT-XXX`
-
-## 5. 合并
-
-- 禁止 fast-forward，使用 `--no-ff`
-- 合并前必须通过 lint + test + 编码规范检查
-
-## 6. 完成流程
-
-知识蒸馏 → 确认合并 → 确认清理 → 播报完成

package/.aodw-next/02-workflow/rt-id-generation-rules.md

@@ -1,24 +0,0 @@
-# RT-ID 生成规则（本地模式）
-
-## 0. 强制策略
-
-AODW 使用**本地生成 RT-ID**，不依赖远程服务。
-
-## 1. 生成逻辑
-
-1. 扫描项目 `RT/` 目录下所有 `RT-XXX` 格式的目录
-2. 找到最大序号 `N`
-3. 生成新 ID：`RT-{N+1}`（补零到 3 位，如 `RT-001`, `RT-002`）
-4. 如果生成的 ID 对应的目录已存在：递增序号直到找到可用 ID
-
-## 2. 检查清单
-
-- [ ] 已扫描 `RT/` 目录找到最大序号
-- [ ] 已生成 `RT-{N+1}` 格式的 ID
-- [ ] 已确认该 ID 对应的目录不存在
-
-## 3. 格式规范
-
-- 格式：`RT-XXX`（3 位数字，左侧补零）
-- 示例：`RT-001`, `RT-042`, `RT-123`
-- 目录：`RT/RT-XXX/`

package/.aodw-next/02-workflow/rt-manager-summary.md

@@ -1,15 +0,0 @@
-# RT-Manager Summary
-
-## 主要职责
-- RT 编号、目录、分支管理
-- Intake 流程与 Spec-Full/Spec-Lite 分流
-- 状态机维护：created → intaking → decided → in-progress → reviewing → done
-
-## 强制前置检查
-- 必须在 feature 分支上工作
-- 未切分支不得修改业务代码
-
-## 核心门禁
-- decided → in-progress 前必须具备 spec/plan
-- Plan 完成后必须等待用户确认
-- 提交前必须展示 diff 与 status

package/.aodw-next/02-workflow/ui-workflow-rules-summary.md

@@ -1,39 +0,0 @@
-# UI Workflow Rules (Summary)
-
-> **注意**：这是 UI 工作流规则的摘要版本，包含核心检查点和流程。
-> 完整版本请阅读：`02-workflow/ui-workflow-rules.md`
-
----
-
-## 核心检查点
-
-### UI 任务必须
-- 用户确认后再执行
-- 明确任务范围和验收标准
-- 记录关键决策和理由
-
-### 代码规范
-- 遵循 `03-standards/stacks/` 中的 UI 规范
-- 使用对应的 UI Kit 组件
-- 遵循无障碍设计原则
-
-### Git 规范
-- 遵循 `01-core/git-discipline.md`
-- UI 任务使用 feature 分支
-
----
-
-## 快速参考
-
-| 阶段 | 检查点 | 相关规范 |
-|-------|---------|---------|
-| 立项 | 明确范围、确认验收标准 | 01-core/ai-interaction-rules |
-| 设计 | 组件选择、设计稿评审 | 01-core/ai-interaction-rules |
-| 实现 | 代码规范、UI Kit 使用 | 03-standards/stacks/ |
-| 验证 | 用户确认、无障碍检查 | 01-core/ai-interaction-rules |
-
----
-
-## 需要详细信息时
-
-请阅读完整版：`02-workflow/ui-workflow-rules.md`

package/.aodw-next/03-standards/stacks/rust-axum/ai-coding-rules-backend.md

@@ -1,134 +0,0 @@
-# AI Coding Rules - Backend Development (Rust)
-
-> **注意**：本文件是 `.aodw-next/03-standards/ai-coding-rules.md` 的子规范文件。  
-> 请先阅读主文件了解通用编码原则。
-
-**适用场景**：
-- 后端开发（Rust + Axum + SQLx）
-- 命令行工具开发
-- 高性能组件开发
-
-**依赖规范**：
-- [Rust API Guidelines](https://rust-lang.github.io/api-guidelines/)
-- [Effective Rust](https://www.lurklurk.org/effective-rust/)
-
-## 1. 核心原则 (Core Principals)
-
-### 1.1 稳定性优先 (Stability First)
-- **绝对禁止在业务逻辑中使用 `unwrap()` 或 `expect()`**。
-    - 仅允许在 `tests/`, `examples/`, 或 `bin/` 的初始化阶段（无法恢复的启动错误）使用。
-    - 业务代码必须使用 `match`, `if let`, 或 `?` 传播 `Result`。
-- **避免 Panic**：任何可能 Panic 的操作（如数组索引 `arr[i]`）都应使用安全版本（如 `arr.get(i)`）。
-
-### 1.2 错误处理 (Error Handling)
-- 使用 `thiserror` 定义库/模块级别的错误枚举。
-- 使用 `anyhow` 处理顶层应用（Application）的错误传播。
-- **Axum Handler** 必须返回实现了 `IntoResponse` 的 Result 类型（通常自定义 `AppError`）。
-
-### 1.3 异步规范 (Async)
-- 避免在异步上下文中执行阻塞操作（如标准 `std::fs` 或大量 CPU 计算）。
-- 使用 `tokio::fs` 替代 `std::fs`。
-- 长时间计算任务使用 `tokio::task::spawn_blocking`。
-
----
-
-## 2. 代码风格与命名 (Style & Naming)
-
-遵循 `rustfmt` 默认配置。
-
-- **Types (Structs, Enums, Traits)**: `PascalCase`
-- **Functions, Methods, Variables, Modules**: `snake_case`
-- **Constants, Statics**: `SCREAMING_SNAKE_CASE`
-- **File Names**: `snake_case.rs`
-
----
-
-## 3. 目录结构规范 (Directory Structure)
-
-```
-backend/
-  src/
-    bin/              # 独立可执行文件（工具脚本）
-    routes/           # Axum 路由处理函数 (Handlers)
-      mod.rs          # 路由注册
-      users.rs        # 用户模块路由
-    models/           # 数据模型 (Structs) & DB 映射
-    services/         # 业务逻辑层 (可选，复杂逻辑从 routes 剥离)
-    utils/            # 通用工具函数
-    main.rs           # 应用入口，仅包含启动配置
-```
-
-- **Routes**: 负责 HTTP 解析、参数校验、调用 Service/Model、返回响应。
-- **Services/Models**: 负责核心业务逻辑和数据持久化，不应依赖 HTTP 层细节。
-
----
-
-## 4. 最佳实践 (Best Practices)
-
-### 4.1 SQLx 使用
-- 优先使用 `sqlx::query_as!` 宏进行编译时 SQL 检查。
-- 如果必须使用动态 SQL，确保使用参数化查询 (`bind`) 防止注入。
-- 数据库模型 Struct 字段应与 DB 列名一致，或使用 `#[sqlx(rename = "...")]`。
-
-### 4.2 Axum Handler
-- 保持 Handler 瘦身：如果逻辑超过 50 行，考虑提取到 Service 层或独立函数。
-- 使用 `State` 抽取共享状态（如 DB Pool）。
-
-### 4.3 日志 (Logging)
-- 使用 `tracing` 而非 `println!`。
-- 关键业务路径必须有 `info!` 日志。
-- 错误分支必须有 `error!` 日志，包含上下文信息。
-
----
-
-## 5. 工具链配置 (Tooling)
-
-所有 Rust 项目必须包含以下配置：
-
-### 5.1 工具初始化（必须）
-
-在开始开发前，必须运行工具初始化：
-- 通过 AI 命令："初始化工具" 或 "设置开发工具"
-- 通过 CLI 命令：`aodw-skill init-tools`
-
-工具初始化会自动：
-- 检测 rustfmt、clippy、cargo 是否已安装
-- 从模板生成 `rustfmt.toml` 和 `clippy.toml` 配置文件
-- 配置 pre-commit hooks（如果使用）
-
-### 5.2 配置文件
-
-**rustfmt.toml**（从模板生成）：
-- 模板位置：`.aodw-next/templates/tools-config/backend/rustfmt.config.template.toml`
-- 生成位置：项目根目录 `rustfmt.toml`
-- 主要配置：
-  ```toml
-  edition = "2021"
-  max_width = 100
-  use_small_heuristics = "Max"
-  ```
-
-**clippy.toml**（从模板生成）：
-- 模板位置：`.aodw-next/templates/tools-config/backend/clippy.config.template.toml`
-- 生成位置：项目根目录 `clippy.toml` 或 `Cargo.toml` 的 `[lints.clippy]` 部分
-- 主要配置：
-  - 零警告策略：`warn = "all"`, `deny = ["warnings"]`
-  - 复杂度限制：`cognitive-complexity-threshold = 15`（见模板 `clippy.config.template.toml`）
-  - 文件长度限制：`too_many_lines_threshold = 400`
-
-### 5.3 提交前检查（必须）
-
-所有代码提交前必须通过以下检查：
-- `cargo fmt -- --check`（代码格式化检查）
-- `cargo clippy -- -D warnings`（零警告策略）
-- `cargo test`（单元测试）
-
-这些检查应配置在 pre-commit hooks 中，确保提交前自动执行。
-
----
-
-## 6. 代码质量指标 (Metrics)
-
-- **函数长度**: 软限制 60 行。超过则拆分。
-- **文件长度**: 软限制 400 行。
-- **复杂度**: 单个函数 Cyclomatic Complexity < 15。

package/.aodw-next/06-project/README.md

@@ -1,16 +0,0 @@
-# 06-project 目录
-
-本目录用于存放项目级别的用户生成文件，初始为空。
-
-## 文件说明
-
-运行 `aodw-skill init-overview` 后，本目录会自动生成以下文件：
-
-- `ai-overview.md` - 项目概览文档（技术栈、架构、模块职责等）
-- `modules-index.yaml` - 模块索引文件（映射代码目录到模块文档）
-
-## 注意事项
-
-- 这些文件是**用户生成内容**，更新 AODW-Next 时会被保护，不会被覆盖
-- 模板文件位于 `../templates/` 目录下
-- AI 修改代码前会读取这些文件来理解项目结构