@curdx/flow 2.3.11 → 3.1.0

package/CHANGELOG.md

@@ -1,44 +1,31 @@
 # Changelog
 
-## 2.3.8
+All notable changes to `@curdx/flow` are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/) and the project follows [Semantic Versioning](https://semver.org/).
 
-- taught `doctor` to detect dirty CurDX-Flow source checkouts, so plugin developers immediately see when Claude cannot possibly be running their latest local edits yet
-- surfaced bundled source repo metadata (`branch`, `shortSha`, `exactTag`, `dirty`) alongside bundled plugin body version in diagnostics and JSON output
-- documented the reinstall workflow for “same version, but local source changed” plugin-development scenarios
+## 3.1.0 — 2026-04-26
 
-## 2.3.7
+Major rewrite preserving the same goal (one-command installer for Claude Code plugins and MCP servers) with a cleaner internal architecture and broader coverage.
 
-- taught `doctor` to detect source/package-vs-installed plugin version drift so local plugin development and release validation no longer silently run against stale Claude plugin cache state
-- exposed bundled plugin body version in the runtime report and machine-readable doctor payload for automation consumers
-- documented the reinstall/restart recovery path when Claude is still loading an older CurDX-Flow build
+### Added
 
-## 2.3.6
+- **Bilingual UI** — every interactive run starts with a 中文 / English picker; default is auto-detected from `$LANG`. No config file is written.
+- **Two new MCP servers**:
+  - `sequential-thinking` (`@modelcontextprotocol/server-sequential-thinking`)
+  - `context7` (Upstash HTTP MCP) with optional API key prompt at install time
+- **`citty` subcommand mode** — `npx @curdx/flow install|uninstall|update|status` for non-interactive / CI use, alongside the original interactive menu.
+- **`status --json`** — machine-readable install state for scripting.
+- **`install --all --yes`** — non-interactive bulk install.
+- **`Pkg` registry abstraction** (`src/registry/types.ts`) — every installable item declares `isInstalled / install / uninstall / update / prereqCheck / configPrompts` once, and the four flows (install / uninstall / update / status) use the same interface. Future additions are a single file in `src/registry/`.
+- **Idempotency layer** — every flow pre-checks state via cached `claude plugin list --json` / `claude mcp list` parsing, so re-running after a partial install is safe.
+- **`prereqCheck` for `chrome-devtools-mcp`** — detects Node ≥ 20.19 and a locally installed Chrome before attempting install.
+- **GitHub Actions CI + Release workflows** — Node 20 + 22 matrix on PRs; `v*` tag triggers `npm publish --provenance --access public` and an auto-noted GitHub Release.
 
-- taught `doctor` to inspect file-based Claude Code managed settings and apply them at the correct highest-precedence layer for CurDX-Flow plugin options
-- upgraded the `doctor --json` contract to v2 so wrappers can distinguish inspected `managed-file` scope from uninspected server-managed / MDM / CLI overrides
-- added report and workflow coverage for managed-settings fragments, invalid managed JSON, and managed-vs-local/project/user precedence
+### Changed
 
-## 2.3.5
+- `@clack/prompts` upgraded **0.8.x → 1.2.x** (Node ≥ 20.12 required).
+- Bundler: now `tsup` producing a single 35 KB ESM file (`dist/index.mjs`) with shebang banner — no more multi-file dist.
+- Plugin registry now uses the **real marketplace name** from `.claude-plugin/marketplace.json`, not the GitHub repo path. Specifically `chrome-devtools-mcp` lives in marketplace `chrome-devtools-plugins`, not `chrome-devtools-mcp`.
 
-- added a versioned `doctor --json` contract for CI/wrappers, including applied-fix metadata and explicit settings-inspection scope metadata
-- added CLI-level regression coverage so `doctor --json` stays silent except for JSON stdout and exit code
-- locked runtime env consumer drift checks against manifest `userConfig` keys and the actual bundled hook/monitor scripts
+### Removed
 
-## 2.3.1
-
-- expanded `doctor` to report CurDX-Flow’s bundled main-thread agent, monitor surface, and plugin option defaults
-- documented where Claude Code stores CurDX-Flow non-sensitive `userConfig` values in `pluginConfigs`
-- added troubleshooting guidance for stop-hook blocking and plugin monitor behavior
-
-## 2.3.0
-
-- added a default `flow-orchestrator` main-thread agent through plugin-level `settings.json`
-- added a plugin `flow-state` monitor plus `userConfig` runtime knobs for stop-hook blocking, dependency reminders, and monitor cadence
-- made the manifest explicit about `outputStyles` and `monitors`, shipped the monitor assets in npm tarballs, and strengthened pack/plugin contract tests
-- updated doctor/runtime guidance and public docs to reflect the new main-agent + monitor architecture
-
-## 2.2.4
-
-- aligned the public docs surface with the current skill-first plugin layout
-- kept thin entry docs while moving detailed workflow logic into skill references
-- locked command summaries to workflow skill descriptions with tests
+- `~/.curdx-flow/config.json` — language preference is no longer persisted; the picker runs every interactive session.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 wdx
+Copyright (c) 2026 bydongxin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,95 +1,44 @@
-# CurdX-Flow
+# @curdx/flow
 
-> Stop Claude Code from faking "done".
-> Spec-driven workflow, goal-backward verification, and Karpathy discipline for real feature delivery.
+Interactive installer for Claude Code plugins and MCP servers.
 
-[![npm version](https://img.shields.io/npm/v/@curdx/flow.svg)](https://www.npmjs.com/package/@curdx/flow)
-[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
-[![Plugin](https://img.shields.io/badge/claude--code-plugin-blue)](https://code.claude.com)
-
-CurdX-Flow is a skill-first Claude Code plugin. The public surface stays small:
-11 slash commands, 5 auto-invoked skills, 17 internal agents, and a thin set of
-entry docs. The heavy workflow detail lives in `skills/*/references/` and
-`knowledge/`.
-
-## Install
+## Quick start
 
 ```bash
-npx @curdx/flow install --all
+npx @curdx/flow
 ```
 
-Requires modern Claude Code and Node 18+. The install flow registers the plugin,
-required reasoning/doc tools, and recommended companion plugins. Run
-`npx @curdx/flow doctor` after install if anything looks off. For CI or wrapper
-automation, use `npx @curdx/flow doctor --json`, which now includes file-based
-managed settings in its inspected precedence model.
+On first run you'll be asked to pick a language (中文 / English). Then choose what to install, update, uninstall, or just check status.
 
-After restart, CurDX-Flow routes the main thread through `flow-orchestrator`
-by default and starts the bundled `.flow` progress monitor in interactive
-Claude Code sessions.
-
-## 11 slash commands, that's it
-
-```text
-/curdx-flow:init           Initialize the .flow scaffold for the current repository.
-/curdx-flow:start          Create, resume, list, or switch the active feature spec.
-/curdx-flow:status         Show active spec health, progress, artifacts, and recovery hints.
-/curdx-flow:spec           Generate or refresh research, requirements, design, and tasks for the active spec.
-/curdx-flow:implement      Execute active-spec tasks with strategy routing and atomic progress.
-/curdx-flow:cancel         Cancel the active execution loop or delete a spec with explicit confirmation.
-/curdx-flow:verify         Verify the active spec against code, tests, and browser evidence.
-/curdx-flow:review         Run two-stage review with optional adversarial, edge-case, and DevEx passes.
-/curdx-flow:fast           Execute a one-shot small task without creating a spec.
-/curdx-flow:debug          Debug a bug or failing test with the root-cause workflow.
-/curdx-flow:help           Show command detail, workflow guidance, and troubleshooting.
-```
-
-Plus 5 auto-invoked skills: `/curdx-flow:epic`, `/curdx-flow:browser-qa`,
-`/curdx-flow:ui-sketch`, `/curdx-flow:security-audit`,
-`/curdx-flow:brownfield-index`.
-
-## Quick start
+## Subcommands
 
 ```bash
-cd ~/your-project
-claude
-/curdx-flow:init
-/curdx-flow:start jwt-auth "Add JWT authentication to the REST API"
-/curdx-flow:spec
-/curdx-flow:implement
-/curdx-flow:verify
-/curdx-flow:review
-
-# Main artifacts:
-#   .flow/specs/jwt-auth/verification-report.md
-#   .flow/specs/jwt-auth/review-report.md
+npx @curdx/flow              # interactive menu
+npx @curdx/flow install      # interactive install (current state-aware)
+npx @curdx/flow install --all --yes
+npx @curdx/flow uninstall
+npx @curdx/flow update
+npx @curdx/flow status
+npx @curdx/flow status --json
+npx @curdx/flow --lang en    # override language
 ```
 
-This produces a durable audit trail instead of a chat-only claim of completion.
-
-## What ships
+## What it installs
 
-- 11 slash commands and 5 auto-invoked skills
-- 17 internal agents
-- a default main-thread `flow-orchestrator` agent
-- a `.flow` state monitor that streams spec progress changes back into Claude
-- 8 composable gates
-- 4 execution strategies for `/curdx-flow:implement`
-- thin public docs, thick supporting references
+| id | type | source |
+| --- | --- | --- |
+| `pua` | plugin | `tanweai/pua` → `pua@pua-skills` |
+| `claude-mem` | plugin | `thedotmack/claude-mem` |
+| `chrome-devtools-mcp` | plugin | `ChromeDevTools/chrome-devtools-mcp` |
+| `frontend-design` | plugin | `claude-plugins-official` (built-in) |
+| `sequential-thinking` | mcp | `@modelcontextprotocol/server-sequential-thinking` |
+| `context7` | mcp | HTTP — `https://mcp.context7.com/mcp` (optional API key) |
 
-## Docs
+## Requirements
 
-- [docs/getting-started.md](./docs/getting-started.md) for the first end-to-end walkthrough
-- [docs/command-reference.md](./docs/command-reference.md) for flags, strategy semantics, and specialty skill contracts
-- [docs/workflows.md](./docs/workflows.md) for greenfield, brownfield, epic, fast, and enterprise flows
-- [docs/headless-ci.md](./docs/headless-ci.md) for `claude --bare -p`, `system/init`, `system/plugin_install`, and CI patterns
-- [docs/troubleshoot.md](./docs/troubleshoot.md) for operator fixes
-- [docs/architecture.md](./docs/architecture.md) for the skill-first layout
-- [docs/agent-reference.md](./docs/agent-reference.md) for the 17 internal agents and their artifacts
+- Node.js >= 20.12
+- `claude` CLI installed and on `PATH` (this tool shells out to `claude plugin` and `claude mcp`)
 
-## Notes
+## License
 
-- `enterprise` mode turns on adversarial, edge-case, security, and DevEx gates.
-- `subagent` is serial; `wave` is the parallel strategy.
-- Headless usage should favor `claude --bare -p` and explicit `--plugin-dir`,
-  `--settings`, and `--mcp-config` wiring.
+MIT