@namewta/speculo 0.1.21 → 0.2.0

package/README.md

@@ -1,103 +1,93 @@
-# Speculo
+# @namewta/speculo
 
-> 以结构化文档驱动 AI Coding 的标准化赋能体系  
-> **SDD (Specification-Driven Development for AI)**
+> Workflow-packaged specification-driven development assets with install, update, and migration tooling.
 
-[![CI](https://github.com/NAMEWTA/Speculo/actions/workflows/ci.yml/badge.svg)](https://github.com/NAMEWTA/Speculo/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/@namewta/speculo.svg)](https://www.npmjs.com/package/@namewta/speculo)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
-[![Node](https://img.shields.io/node/v/@namewta/speculo.svg)](./package.json)
+Speculo packages AI coding workflows as installable assets — commands, skills, workflow packages, and vendor skill collections — delivered into any project via a unified CLI.
 
-**版本：** v2.6
-**核心原则：** 工具无关 · CLI 接入 · workflow 自治
+## Quick Start
 
-## 这是什么
+```bash
+# Initialize Speculo in a target project
+npx @namewta/speculo init
 
-Speculo 是一套结构化文档框架。它通过可复制的 `commands/`、`workflows/`、`skills/` 和 `.speculo/` 状态骨架，让 AI Coding 在不同工具中按标准化、可追溯、可复用的方式执行开发、文档和运维任务。
+# Install all workflow packages
+npx @namewta/speculo init --all
 
-仓库同时提供一个很小的 CLI：
+# Global install
+npm install -g @namewta/speculo
+speculo init [--all] [target]
+```
 
-- `speculo init [target]`：把框架资产安装到目标项目。若 `speculo/` 不存在则全新安装全部资产（冲突时失败）；若已存在则自动更新 `commands/`、`skills/`、`workflows/` 并保留 `.speculo/` 状态和产物。
+After initialization, the target project's `speculo/` directory contains all core assets and selected workflow packages.
 
-## 仓库布局
+## Install
 
-```text
-Speculo/
-├── README.md
-├── docs/                       # 框架文档
-├── src/                        # speculo CLI
-├── test/                       # CLI 测试
-└── template/                   # 包内框架资产源
-    ├── commands/               # 一次性独立命令
-    ├── workflows/              # 多阶段工作流
-    ├── skills/                 # command 可调用的可复用 skill
-    ├── vendor/                 # 原生第三方 AgentSkills 收集目录
-    └── .speculo/               # 项目状态与产物骨架
+```bash
+npm install -g @namewta/speculo
 ```
 
-## 三分钟接入
+Requires: Node.js ≥ 22.22.3
 
-```bash
-# 全局安装 CLI（npm 包名为 @namewta/speculo，命令名为 speculo）
-npm install -g @namewta/speculo
+## Commands
 
-# 安装框架资产到目标项目（首次）
-speculo init my-project
+| Command | Description |
+|---|---|
+| `speculo init [--all] [target]` | Install or refresh Speculo core assets and selected workflow packages. Existing `speculo/.speculo/` state is never overwritten. |
+| `speculo migrate [--apply] [target]` | Preview (or apply) migration from v2 or transitional v3 state to current v3 contract. Dry-run by default; `--apply` to perform the staged, rollback-safe migration. |
+| `speculo update` | Deprecated. Delegates to `speculo init --all`. |
 
-# 后续更新框架资产（speculo/ 已存在时自动进入更新模式，不覆盖 .speculo 状态）
-speculo init my-project
-```
+## Installed Runtime Assets
 
-首次 `init` 会带上 `.speculo/.config/RULES.md` 和 `.speculo/.config/LESSONS.md` 作为最小项目规则/经验库；后续执行不会覆盖它们。
-
-详见 [docs/adopting.md](docs/adopting.md)。
-
-## 内置入口
-
-- `workflows/dev/AGENTS.md`：开发工作流导航
-- `workflows/dev/01-grill-with-docs/01-grill-with-docs.md`：领域澄清与决策拷问
-- `workflows/dev/02-prd/02-prd.md`：全景理解与 PRD
-- `workflows/dev/03-tdd/03-tdd.md`：TDD 实现
-- `workflows/dev/I-to-issues/I-to-issues.md`：`dev/I` 垂直切片分解
-- `workflows/dev/H-diagnose/H-diagnose.md`：`dev/H` hotfix / diagnose
-- `workflows/dev/R-review/R-review.md`：`dev/R` Spec / Engineering / Standards 三维度 diff 审查
-- `workflows/dev/M-domain-modeling/M-domain-modeling.md`：`dev/M` 主动领域建模，维护 CONTEXT 与 ADR
-- `workflows/dev/A-improve-architecture/A-improve-architecture.md`：`dev/A` 架构深化机会扫描与 HTML 审查报告
-- `workflows/dev/D-docs-sync/D-docs-sync.md`：`dev/D` 基于 git diff、归档产物和 `.config` 生命周期同步文档/知识资产
-- `workflows/doc/AGENTS.md`：文档写作 workflow 导航
-- `workflows/person/AGENTS.md`：人物方法论 workflow 导航
-- `.speculo/AGENTS.md`：状态骨架、项目知识和归档的读取指引
-- `.speculo/archive/AGENTS.md`：已完成 change 归档读取指引
-- `commands/status.md`：聚合当前状态
-- `commands/archive.md`：归档 completed change
-- `commands/config-prune.md`：dry-run 审计 `.config` 过期知识资产
-- `commands/{caveman,grill-me,handoff,write-a-skill,scaffold-exercises}.md`：生产力命令
-- `commands/retro.md`：复盘 Speculo 使用痛点并经确认提改进 issue
-
-## 开发
+After initialization, the target project gains the following AI agent-callable assets:
 
-```bash
-pnpm install
-pnpm build
-pnpm test
-```
+### 5 Commands
+
+| Command | Purpose |
+|---|---|
+| `docs-sync` | Clean workspace, sync project documentation from reproducible Git ranges |
+| `finalize` | Completion gates, status finalization, and safe archiving |
+| `knowledge-prune` | Dry-run audit of workflow knowledge namespaces |
+| `retro` | Retrospective analysis with `gh issue` creation |
+| `status` | Summary of installed workflows, active changes, and anomalies |
+
+### 10 Skills
+
+| Skill | Purpose |
+|---|---|
+| `agents-md-builder` | Multi-layer AGENTS.md / CLAUDE.md handbook tree builder |
+| `change-lifecycle` | Change state transitions, verification, and archival |
+| `config-prune` | Configuration namespace pruning |
+| `docs-sync` | Core documentation audit and synchronization |
+| `github-npm-ops` | GitHub issue/PR triage and npm operations |
+| `knowledge-prune` | Knowledge namespace pruning |
+| `runtime-context` | Path resolution for Speculo roots |
+| `scaffold-exercises` | Exercise scaffolding |
+| `speculo-retro` | Retrospective analysis |
+| `worktree-isolation` | Git worktree isolation |
+
+### 2 Workflow Packages
+
+| Workflow | Routes | Description |
+|---|---|---|
+| **matt-pocock** | 10 | Route-first composition of Matt Pocock native skills (engineering + productivity) |
+| **person** | 1 | Persona-methodology-based consulting workflow |
 
-运行环境锁定为 Node `22.22.3`、pnpm `11.1.3`。
+### Vendor Skill Collections
 
-## 致谢 / Acknowledgements
+- **Matt Pocock skills** — Engineering (ask-matt, implement, wayfinder, tdd, code-review, diagnosing-bugs, prototyping, research, domain-modeling, codebase-design, triage, setup, to-spec, to-tickets, grill-with-docs, improve-codebase-architecture) and Productivity (grill-me, handoff, teach, writing-great-skills)
 
-Speculo 的设计受益于以下项目的理念与实践：
+## Documentation
 
-- **[Matt Pocock / skills](https://github.com/mattpocock/skills)** — 技能封装与渐进披露模式的重要参考
-- **[NAMEWTA / specforge](https://github.com/NAMEWTA/specforge)** — 同属 SDD 工具链的兄弟项目，规格生成与验证的互补实践
+- [AGENTS.md](./AGENTS.md) — AI agent handbook (authoritative)
+- [CHANGELOG.md](./CHANGELOG.md) — Release history
+- [docs/](./docs/) — Authoring contracts for commands, skills, workflows, and persistence
+- [.agents/skills/](./.agents/skills/) — Internal authoring tools for Speculo maintainers
+- [README-ZH.md](./README-ZH.md) — 中文镜像
 
-## 文档导航
+## Acknowledgments
 
-- 使用者必读：[adopting.md](docs/adopting.md) · [quick-reference.md](docs/quick-reference.md)
-- 架构原理：[Speculo-architecture.md](docs/Speculo-architecture.md)
-- 机器契约：[persistence-contract.md](docs/persistence-contract.md)
-- 扩展开发：[workflow-authoring.md](docs/workflow-authoring.md) · [skill-authoring.md](docs/skill-authoring.md) · [command-authoring.md](docs/command-authoring.md)
+Inspired by and built upon [Matt Pocock Skills](https://github.com/mattpocock/skills) — the pioneering work that shaped AI-assisted development workflows. Speculo extends this foundation with package-based workflow management, persistence contracts, and a unified install/migrate lifecycle.
 
 ## License
 
-[MIT](./LICENSE) © wta
+MIT — see [LICENSE](./LICENSE)

package/dist/src/cli.js

@@ -2,36 +2,35 @@
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { initSpeculo } from "./index.js";
+import { migrateSpeculo } from "./migrate.js";
 function usage() {
     return [
         "Usage:",
         "  speculo init [--all] [target]",
+        "  speculo migrate [--apply] [target]",
         "",
         "Commands:",
-        "  init    Install speculo assets under speculo/. If speculo/ does not exist,",
-        "          copies .speculo, commands, skills, and workflows with conflict detection.",
-        "          If speculo/ already exists, refreshes commands, skills, and workflows",
-        "          while preserving .speculo/ user state.",
+        "  init       Install or refresh Speculo core assets and selected workflow packages.",
+        "             Existing workflow state under speculo/.speculo/ is never overwritten.",
+        "  migrate    Preview migration from v2 or transitional v3 state to the current v3 contract.",
+        "             Pass --apply to perform the staged, rollback-safe migration.",
         "",
         "Options:",
-        "  --all   Install/update all workflows without interactive selection.",
-        "          Also triggers full overwrite of vendor/ (native skills collection).",
-        "          When omitted, vendor/ is merge-only — new skills are added but",
-        "          existing ones are preserved. In a terminal without --all, an",
-        "          interactive menu lets you pick which workflows to install or refresh."
+        "  --all      Select every workflow and fully refresh vendor assets during init.",
+        "  --apply    Apply a migration; without this flag migrate is always dry-run.",
     ].join("\n");
 }
 async function main(argv) {
-    // Parse --all flag (can appear anywhere in argv)
     const allFlag = argv.includes("--all");
-    const positional = argv.filter(a => a !== "--all");
+    const applyFlag = argv.includes("--apply");
+    const positional = argv.filter((argument) => argument !== "--all" && argument !== "--apply");
     const [command, targetArg, extra] = positional;
     if (!command || command === "--help" || command === "-h") {
         console.log(usage());
         return command ? 0 : 1;
     }
     if (extra) {
-        console.error(`Unexpected argument: ${extra}`);
+        console.error("Unexpected argument: " + extra);
         console.error(usage());
         return 1;
     }
@@ -39,40 +38,64 @@ async function main(argv) {
     const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
     try {
         if (command === "init") {
-            const result = await initSpeculo(target, { packageRoot, all: allFlag });
-            if (result.mode === 'init') {
-                console.log(`Speculo initialized in ${result.target}`);
-                for (const copied of result.copied ?? []) {
-                    console.log(`  copied ${copied}`);
-                }
+            if (applyFlag) {
+                throw new Error("--apply is only valid with `speculo migrate`.");
             }
-            else {
-                console.log(`Speculo updated in ${result.target}`);
-                for (const updated of result.updated ?? []) {
-                    console.log(`  updated ${updated}`);
-                }
+            const result = await initSpeculo(target, {
+                packageRoot,
+                all: allFlag,
+            });
+            console.log(result.mode === "init"
+                ? "Speculo initialized in " + result.target
+                : "Speculo updated in " + result.target);
+            for (const item of result.copied ?? result.updated ?? []) {
+                console.log("  " + (result.mode === "init" ? "copied " : "updated ") + item);
             }
             return 0;
         }
-        if (command === "update") {
-            console.error("Warning: `speculo update` is deprecated. Use `speculo init` instead.");
-            const result = await initSpeculo(target, { packageRoot, all: true });
-            console.log(`Speculo updated in ${result.target}`);
-            for (const updated of result.updated ?? []) {
-                console.log(`  updated ${updated}`);
+        if (command === "migrate") {
+            if (allFlag) {
+                throw new Error("--all is only valid with `speculo init`.");
+            }
+            const result = await migrateSpeculo(target, {
+                packageRoot,
+                apply: applyFlag,
+            });
+            if (!result.legacyDetected) {
+                console.log("No legacy Speculo state detected in " + result.target);
+                return 0;
+            }
+            console.log(result.applied
+                ? "Speculo state migrated in " + result.target
+                : "Speculo migration preview for " + result.target);
+            for (const action of result.actions) {
+                const mapping = action.from
+                    ? action.from + (action.to ? " -> " + action.to : "")
+                    : action.detail;
+                console.log("  " + action.kind + " " + mapping);
+            }
+            if (!result.applied) {
+                console.log("Dry-run only. Re-run with --apply to perform this migration.");
             }
             return 0;
         }
-        console.error(`Unknown command: ${command}`);
+        if (command === "update") {
+            console.error("Warning: `speculo update` is deprecated. Use `speculo init`.");
+            const result = await initSpeculo(target, {
+                packageRoot,
+                all: true,
+            });
+            console.log("Speculo updated in " + result.target);
+            return 0;
+        }
+        console.error("Unknown command: " + command);
         console.error(usage());
         return 1;
     }
     catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error(message);
+        console.error(error instanceof Error ? error.message : String(error));
         return 1;
     }
 }
-const exitCode = await main(process.argv.slice(2));
-process.exitCode = exitCode;
+process.exitCode = await main(process.argv.slice(2));
 //# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/index.d.ts

@@ -1,15 +1,13 @@
 import { type WorkflowSelection } from "./workflows.js";
 export type SpeculoCommandResult = {
     target: string;
-    mode: 'init' | 'update';
+    mode: "init" | "update";
     copied?: string[];
     updated?: string[];
 };
 export type SpeculoOptions = {
     packageRoot?: string;
-    /** If true, install all workflows without prompting (--all equivalent). */
     all?: boolean;
-    /** Explicit workflow selection for programmatic use (bypasses prompt). */
     selection?: WorkflowSelection;
 };
 export declare function initSpeculo(targetArg?: string, options?: SpeculoOptions): Promise<SpeculoCommandResult>;