@michaelxwb/code-flow 0.6.5 → 1.0.0

package/src/core/code-flow/specs/shared/_map.md

@@ -1,57 +0,0 @@
-# Shared Specs Navigation Map
-
-> 跨项目的共享模板和规范
-
-## Purpose
-
-共享模板供 `cf-task:align` 和 `cf-task:prd` 命令使用，为文档生成提供规范约束。
-
-## Templates
-
-### PRD Templates
-
-| 文件 | 用途 | 适用场景 |
-|------|------|---------|
-| `prd-template.md` | 产品需求文档 | 需求早期阶段，在设计之前 |
-
-### Design Templates
-
-| 文件 | 用途 | 适用场景 |
-|------|------|---------|
-| `design/design-lite.md` | 轻量设计简报 | 功能开发/CLI/Bug修复/小型重构 |
-| `design/design-full.md` | 完整设计文档 | 跨系统集成/性能优化/架构演进/中大型功能 |
-
-> 两档模板均覆盖：接口设计（API/CLI/函数三形态）、性能与容量设计、可执行验收（场景即 TC）。design-full 额外含方案选型 ADR 决策记录与 §6 需求追溯矩阵。
-
-## Workflow
-
-```
-需求 → cf-task:prd → PRD (.prd.md)
-       ↓ （align 读取 .prd.md 派生）
-       → cf-task:align → 设计 (.design.md)
-       ↓ （plan 读取 .design.md 拆解）
-       → cf-task:plan → 任务
-```
-
-## Selection Guide
-
-```
-需求阶段（还未明确用户与场景）：
-  → cf-task:prd 生成 PRD
-
-设计阶段（已有 PRD 或已明确做什么）：
-  → cf-task:align 生成设计简报
-    - 输入 .prd.md → 派生模式（继承目标/用户/功能/范围）
-    - 输入文本 → 新建模式（从零对话）
-
-复杂度判断：
-  简单功能/脚本/Bugfix → design-lite.md
-  复杂系统/跨模块/性能优化 → design-full.md
-```
-
-## Usage
-
-1. `cf-task:prd` 命令引用 `prd-template.md` 生成 PRD
-2. `cf-task:align` 命令引用 `design/design-lite.md` 或 `design/design-full.md` 生成设计文档
-3. PRD 的 US/FEAT ID 被 design 的功能清单"来源"列引用，形成追溯链
-4. 性能敏感需求：align 在出技术方案时即按最优性能设计，落点 design-lite §3.4 / design-full §3.5，并在 §6 矩阵闭合 US→FEAT→API→TC

package/src/core/code-flow/validation.yml

@@ -1,53 +0,0 @@
-# validators 在每次 Stop 按“会话内编辑过的文件”匹配执行（quality_loop.stop_check）。
-# 全量测试 / e2e 等慢命令标 `heavy: true`：Stop 每轮跳过，任务 finish 自动执行
-# 一次，也可显式运行 /cf-validate；避免每个任务都重跑多遍。
-validators:
-    - name: "Python 语法检查"
-      trigger: "**/*.py"
-      command: "python3 -m py_compile {files}"
-      timeout: 30000
-      on_fail: "检查语法错误"
-
-    - name: "TypeScript 类型检查"
-      trigger: "**/*.{ts,tsx}"
-      command: "npx tsc --noEmit"
-      timeout: 30000
-      on_fail: "检查类型定义，参见 specs/frontend/quality-standards.md"
-
-    - name: "Vue 类型检查"
-      trigger: "**/*.vue"
-      command: "npx vue-tsc --noEmit"
-      timeout: 30000
-      on_fail: "检查 Vue 组件类型定义，参见 specs/frontend/component-specs.md"
-
-    - name: "ESLint"
-      trigger: "**/*.{ts,tsx,js,jsx,vue}"
-      command: "npx eslint {files}"
-      timeout: 15000
-      on_fail: "运行 npx eslint --fix 自动修复，参见 specs/frontend/quality-standards.md"
-
-    - name: "Stylelint"
-      trigger: "**/*.{css,scss,less}"
-      command: "npx stylelint {files}"
-      timeout: 15000
-      on_fail: "运行 npx stylelint --fix 自动修复，参见 specs/frontend/component-specs.md"
-
-    - name: "前端单元测试"
-      trigger: "**/*.{ts,tsx,js,jsx,vue}"
-      command: "npx vitest run --reporter=dot"
-      timeout: 60000
-      heavy: true
-      on_fail: "前端测试失败，检查组件渲染和 mock 是否需要更新"
-
-    - name: "Python 类型检查"
-      trigger: "**/*.py"
-      command: "python3 -m mypy {files}"
-      timeout: 30000
-      on_fail: "检查类型注解，参见 specs/backend/code-quality-performance.md"
-
-    - name: "Pytest"
-      trigger: "**/*.py"
-      command: "python3 -m pytest --tb=short -q"
-      timeout: 60000
-      heavy: true
-      on_fail: "测试失败，检查断言和 mock 是否需要更新"

package/src/migrate/spec-workflow.js

@@ -1,238 +0,0 @@
-"use strict";
-
-const childProcess = require("node:child_process");
-const crypto = require("node:crypto");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const PREFLIGHT = path.join(__dirname, "../core/code-flow/scripts/cf_spec_migrate.py");
-
-function walkFiles(root, directory = root) {
-  const files = [];
-  if (!fs.existsSync(directory)) return files;
-  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-    const full = path.join(directory, entry.name);
-    const relative = path.relative(root, full);
-    if (entry.isDirectory() && relative === path.join(".code-flow", "migrations")) continue;
-    if (entry.isDirectory()) files.push(...walkFiles(root, full));
-    else files.push(relative);
-  }
-  return files.sort();
-}
-
-function migrationFiles(root) {
-  const entries = [".code-flow", ".claude", ".codex", ".costrict", ".opencode", ".agents", "AGENTS.md", "CLAUDE.md"];
-  const files = [];
-  for (const entry of entries) {
-    const target = path.join(root, entry);
-    if (!fs.existsSync(target)) continue;
-    if (fs.statSync(target).isDirectory()) files.push(...walkFiles(root, target));
-    else files.push(entry);
-  }
-  return [...new Set(files)].sort();
-}
-
-function hash(data) {
-  return crypto.createHash("sha256").update(data).digest("hex");
-}
-
-function sourceHashes(root) {
-  const result = {};
-  for (const relative of migrationFiles(root)) {
-    result[relative] = hash(fs.readFileSync(path.join(root, relative)));
-  }
-  return result;
-}
-
-function pythonCommand() {
-  return process.env.PYTHON || "python3";
-}
-
-function preview(root) {
-  const project = fs.realpathSync(root);
-  const result = childProcess.spawnSync(
-    pythonCommand(), [PREFLIGHT, "preflight", "--root", project, "--json"],
-    { encoding: "utf8", shell: false }
-  );
-  if (result.status !== 0) throw new Error(result.stderr || result.stdout || "preflight failed");
-  return JSON.parse(result.stdout);
-}
-
-function migrationId(root, hashes) {
-  const seed = `${root}\0${JSON.stringify(hashes)}\0${Date.now()}`;
-  return `spec-workflow-${hash(seed).slice(0, 12)}`;
-}
-
-function copyBackup(root, backup, hashes) {
-  for (const relative of Object.keys(hashes)) {
-    const target = path.join(backup, relative);
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.copyFileSync(path.join(root, relative), target);
-  }
-}
-
-function writeJson(target, value) {
-  fs.writeFileSync(target, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-}
-
-function prepare(root) {
-  const project = fs.realpathSync(root);
-  const plan = preview(project);
-  const hashes = sourceHashes(project);
-  const id = migrationId(project, hashes);
-  const workspace = path.join(project, ".code-flow", "migrations", id);
-  const backup = path.join(workspace, "backup");
-  const staging = path.join(workspace, "staging");
-  fs.mkdirSync(backup, { recursive: true });
-  fs.mkdirSync(staging, { recursive: true });
-  copyBackup(project, backup, hashes);
-  const preparedPlan = { ...plan, migration_id: id, project_root: project, source_hashes: hashes };
-  const status = plan.unresolved.length ? "prepared_blocked" : "prepared";
-  writeJson(path.join(workspace, "migration-plan.json"), preparedPlan);
-  writeJson(path.join(workspace, "journal.json"), { version: 1, migration_id: id, status, operations: [] });
-  return { migration_id: id, status, workspace, plan: path.join(workspace, "migration-plan.json") };
-}
-
-function readJson(target) {
-  return JSON.parse(fs.readFileSync(target, "utf8"));
-}
-
-function journalPaths(planPath) {
-  const workspace = path.dirname(planPath);
-  return { workspace, journal: path.join(workspace, "journal.json"), staging: path.join(workspace, "staging"), backup: path.join(workspace, "backup") };
-}
-
-function sameHashes(first, second) {
-  return JSON.stringify(first) === JSON.stringify(second);
-}
-
-function runStaging(planPath, locations) {
-  const result = childProcess.spawnSync(
-    pythonCommand(), [PREFLIGHT, "stage", "--plan", planPath, "--staging", locations.staging, "--json"],
-    { encoding: "utf8", shell: false }
-  );
-  if (result.status !== 0) throw new Error(result.stdout || result.stderr || "staging failed");
-  return JSON.parse(result.stdout);
-}
-
-function verifyStaging(staging, manifest) {
-  for (const item of manifest.targets) {
-    const target = path.join(staging, item.path);
-    if (!fs.existsSync(target) || hash(fs.readFileSync(target)) !== item.sha256) {
-      throw new Error(`staging hash mismatch: ${item.path}`);
-    }
-  }
-}
-
-function persistJournal(target, journal, status) {
-  journal.status = status;
-  writeJson(target, journal);
-}
-
-function targetEntries(manifest) {
-  return manifest.targets.filter((item) => item.path !== ".code-flow/.version");
-}
-
-function commitEntry(project, staging, item, journal, journalPath) {
-  const source = path.join(staging, item.path);
-  const target = path.join(project, item.path);
-  journal.operations.push({ path: item.path, status: "renaming" });
-  writeJson(journalPath, journal);
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  if (fs.existsSync(target)) fs.rmSync(target, { recursive: true, force: true });
-  fs.renameSync(source, target);
-  journal.operations[journal.operations.length - 1].status = "committed";
-  writeJson(journalPath, journal);
-}
-
-function obsoletePaths(plan, manifest) {
-  const targets = new Set(manifest.targets.map((item) => item.path));
-  return Object.keys(plan.source_hashes).filter((item) => item.startsWith(".code-flow/") && item !== ".code-flow/.version" && !targets.has(item));
-}
-
-function removeObsolete(project, paths) {
-  for (const relative of paths) fs.rmSync(path.join(project, relative), { recursive: true, force: true });
-}
-
-function restoreBackup(plan, locations, manifest) {
-  for (const item of manifest.targets || []) {
-    if (item.path !== ".code-flow/.version") fs.rmSync(path.join(plan.project_root, item.path), { recursive: true, force: true });
-  }
-  for (const relative of Object.keys(plan.source_hashes)) {
-    const source = path.join(locations.backup, relative);
-    const target = path.join(plan.project_root, relative);
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.copyFileSync(source, target);
-  }
-}
-
-function rollback(planPath, error = "requested") {
-  const plan = readJson(planPath);
-  const locations = journalPaths(planPath);
-  const journal = readJson(locations.journal);
-  try {
-    restoreBackup(plan, locations, journal.manifest || { targets: [] });
-    journal.error = String(error);
-    persistJournal(locations.journal, journal, "rolled_back");
-    return { status: "rolled_back", migration_id: plan.migration_id };
-  } catch (restoreError) {
-    journal.error = String(restoreError);
-    persistJournal(locations.journal, journal, "recovery_required");
-    return { status: "recovery_required", migration_id: plan.migration_id };
-  }
-}
-
-function targetsMatch(project, manifest) {
-  return targetEntries(manifest).every((item) => {
-    const target = path.join(project, item.path);
-    return fs.existsSync(target) && hash(fs.readFileSync(target)) === item.sha256;
-  });
-}
-
-function finishVersion(plan, journal, journalPath) {
-  fs.writeFileSync(path.join(plan.project_root, ".code-flow/.version"), "0.6.0", "utf8");
-  persistJournal(journalPath, journal, "committed");
-  return { status: "committed", migration_id: plan.migration_id };
-}
-
-function recoverCommitting(plan, journal, locations, options) {
-  if (!targetsMatch(plan.project_root, journal.manifest)) return rollback(path.join(locations.workspace, "migration-plan.json"), "target hash mismatch");
-  if (options.interruptBeforeVersion) return { status: "committing", migration_id: plan.migration_id };
-  return finishVersion(plan, journal, locations.journal);
-}
-
-function apply(planPath, options = {}) {
-  const plan = readJson(planPath);
-  const locations = journalPaths(planPath);
-  const versionPath = path.join(plan.project_root, ".code-flow/.version");
-  if (fs.existsSync(versionPath) && fs.readFileSync(versionPath, "utf8").trim() === "0.6.0") return { status: "already_migrated", migration_id: plan.migration_id };
-  const journal = readJson(locations.journal);
-  if (journal.status === "committing") return recoverCommitting(plan, journal, locations, options);
-  if (plan.unresolved.length) throw new Error("migration plan has unresolved items");
-  if (!sameHashes(sourceHashes(plan.project_root), plan.source_hashes)) throw new Error("source hash drift");
-  try {
-    const manifest = runStaging(planPath, locations);
-    verifyStaging(locations.staging, manifest);
-    journal.manifest = manifest;
-    persistJournal(locations.journal, journal, "committing");
-    let completed = 0;
-    for (const item of targetEntries(manifest)) {
-      if (options.failAfter === completed) throw new Error(`injected rename failure ${completed}`);
-      if (options.exdevAfter === completed) {
-        const exdev = new Error("injected EXDEV");
-        exdev.code = "EXDEV";
-        throw exdev;
-      }
-      commitEntry(plan.project_root, locations.staging, item, journal, locations.journal);
-      completed += 1;
-    }
-    removeObsolete(plan.project_root, obsoletePaths(plan, manifest));
-    removeObsolete(plan.project_root, manifest.deletions || []);
-    if (options.interruptBeforeVersion) return { status: "committing", migration_id: plan.migration_id };
-    return finishVersion(plan, journal, locations.journal);
-  } catch (error) {
-    return rollback(planPath, error);
-  }
-}
-
-module.exports = { apply, preview, prepare, rollback, sourceHashes, walkFiles };