@superspec/cli 1.1.0 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superspec/cli",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Spec-driven development for AI coding assistants",
   "type": "module",
   "bin": {

package/templates/en/commands/ss-archive.md

@@ -5,11 +5,21 @@ category: SuperSpec
 description: Archive completed change
 ---
 <!-- SUPERSPEC:START -->
+**Input Parsing Rules**
+
+From user input, extract: **change name** or **all flag**.
+
+| Extract | Rule | Example |
+|---------|------|---------|
+| Change name | Remaining text after removing flags; if empty, use current active change | `/ss-archive addUserAuth` → name=`addUserAuth` |
+| Archive all | `--all`/`all` → add `--all` | `/ss-archive --all`; `/ss-archive all` |
+
 **Guardrails**
 - Only archive when all tasks are COMPLETE
 - Ensure tests pass before archiving
 
 **Steps**
-1. Verify all tasks in tasks.md are marked COMPLETE
-2. Run `superspec archive <name>` or `superspec archive --all`
+1. Parse user input → extract change name or `--all` flag
+2. Verify all tasks in tasks.md are marked COMPLETE
+3. Run `superspec archive <name>` or `superspec archive --all`
 <!-- SUPERSPEC:END -->

package/templates/en/commands/ss-create.md

@@ -27,11 +27,12 @@ The text the user typed after `/ss-create` **is** the feature description. Do no
 
 **Input Parsing Rules**
 
-From user input, extract three things: **feature name**, **intent type**, **developer**, **lang**.
+From user input, extract: **mode flags**, **feature name**, **intent type**, **developer**, **lang**.
 
 | Extract | Rule | Example |
 |---------|------|---------|
-| Feature name | Convert to camelCase. Chinese → translate to English first | "add user auth" → `addUserAuth`; "添加用户认证" → `addUserAuth` |
+| Mode flags | Detect `-b`/`--boost`/`boost` → boost mode; `-c`/`--creative`/`creative` → creative mode; `--no-branch` → skip branch; flags can be combined | `/ss-create -b add auth` → boost; `/ss-create -b -c refactor login` → boost+creative |
+| Feature name | Remove flags from input, convert remainder to camelCase. Chinese → translate to English first | "add user auth" → `addUserAuth`; "添加用户认证" → `addUserAuth` |
 | Intent type | Semantic inference from input | add/new/implement → `feature`; fix/bug/hotfix → `hotfix`; refactor/optimize → `refactor`; docs → `docs`; test → `test`; build/deps → `chore`; default → `feature` |
 | Developer | "@username" or "Developer: xxx" → extract (remove "@"). Fallback: git user name | "添加todolist @jay" → user=`jay` |
 | Lang | CJK chars → `zh`; explicit "zh"/"中文" → `zh`; "en"/"English" → `en`; fallback: config `lang` | "添加todolist" → `zh` |

package/templates/en/commands/ss-link.md

@@ -5,8 +5,17 @@ category: SuperSpec
 description: Add spec dependency
 ---
 <!-- SUPERSPEC:START -->
+**Input Parsing Rules**
+
+From user input, extract: **change name**, **dependency target**.
+
+| Extract | Rule | Example |
+|---------|------|---------|
+| Change name | First argument or text before `--on` | `/ss-link addAuth --on addDB` → name=`addAuth` |
+| Dependency target | `--on <other>`/`depends on <other>`/`→ <other>` → extract target name | `/ss-link addAuth --on addDB`; `/ss-link addAuth depends on addDB` |
+
 **Steps**
-1. Run `superspec deps add <name> --on <other>`
-2. This updates the frontmatter: `depends_on: [other]`
+1. Parse user input → extract change name and dependency target
+2. Run `superspec deps add <name> --on <other>`
 3. Verify: `superspec deps list <name>`
 <!-- SUPERSPEC:END -->

package/templates/en/commands/ss-search.md

@@ -5,8 +5,17 @@ category: SuperSpec
 description: Full-text search across changes
 ---
 <!-- SUPERSPEC:START -->
+**Input Parsing Rules**
+
+From user input, extract: **search query**, **optional flags**.
+
+| Extract | Rule | Example |
+|---------|------|---------|
+| Search query | Remaining text after removing flags | `/ss-search user auth` → query=`user auth` |
+| Include archived | `--archived`/`archived`/`include archived`/`all` → add `--archived` | `/ss-search auth --archived`; `/ss-search auth archived` |
+| Filter type | `--artifact <type>`/`type:<type>` → add `--artifact <type>`; type: `proposal`/`spec`/`tasks`/`clarify`/`checklist` | `/ss-search auth --artifact spec`; `/ss-search auth type:proposal` |
+
 **Steps**
-1. Run `superspec search <query>`
-2. Use `--archived` to include archived changes
-3. Use `--artifact <type>` to filter by artifact type
+1. Parse user input → extract search query and flags
+2. Run `superspec search "<query>" [--archived] [--artifact <type>]`
 <!-- SUPERSPEC:END -->

package/templates/en/commands/ss-validate.md

@@ -5,11 +5,21 @@ category: SuperSpec
 description: Cross-reference consistency check (boost mode)
 ---
 <!-- SUPERSPEC:START -->
+**Input Parsing Rules**
+
+From user input, extract: **change name**, **optional flags**.
+
+| Extract | Rule | Example |
+|---------|------|---------|
+| Change name | Remaining text after removing flags; if empty, use current active change | `/ss-validate addUserAuth` → name=`addUserAuth` |
+| Check deps | `--check-deps`/`check deps`/`dependencies` → add `--check-deps` | `/ss-validate --check-deps`; `/ss-validate check deps` |
+
 **Guardrails**
 - Validate US↔FR↔AC↔tasks consistency
 - Only applicable in boost mode
 
 **Steps**
-1. Run `superspec validate [name]`
-2. Fix any consistency errors reported
+1. Parse user input → extract change name and flags
+2. Run `superspec validate [name] [--check-deps]`
+3. Fix any consistency errors reported
 <!-- SUPERSPEC:END -->

package/templates/zh/commands/ss-archive.md

@@ -5,11 +5,21 @@ category: SuperSpec
 description: 归档已完成的变更
 ---
 <!-- SUPERSPEC:START -->
+**输入解析规则**
+
+从用户输入中提取：**变更名称**或**全部标志**。
+
+| 提取项 | 规则 | 示例 |
+|--------|------|------|
+| 变更名称 | 移除标志后的剩余文本；为空时使用当前活跃变更 | `/ss-archive addUserAuth` → name=`addUserAuth` |
+| 归档全部 | `--all`/`全部`/`所有` → 添加 `--all` | `/ss-archive --all`; `/ss-archive 全部` |
+
 **Guardrails**
 - 只有所有任务都 COMPLETE 后才能归档
 - 归档前确保测试通过
 
 **Steps**
-1. 确认 tasks.md 中所有任务都标记为 COMPLETE
-2. 运行 `superspec archive <name>` 或 `superspec archive --all`
+1. 解析用户输入 → 提取变更名称或 `--all` 标志
+2. 确认 tasks.md 中所有任务都标记为 COMPLETE
+3. 运行 `superspec archive <name>` 或 `superspec archive --all`
 <!-- SUPERSPEC:END -->

package/templates/zh/commands/ss-create.md

@@ -27,11 +27,12 @@ $ARGUMENTS
 
 **输入解析规则**
 
-从用户输入中提取四项：**功能名称**、**意图类型**、**开发者**、**语言**。
+从用户输入中提取：**模式标志**、**功能名称**、**意图类型**、**开发者**、**语言**。
 
 | 提取项 | 规则 | 示例 |
 |--------|------|------|
-| 功能名称 | 转为 camelCase。中文 → 先翻译为英文 | "add user auth" → `addUserAuth`; "添加用户认证" → `addUserAuth` |
+| 模式标志 | 识别 `-b`/`--boost`/`boost`/`增强` → 增强模式; `-c`/`--creative`/`creative`/`创造` → 创造模式; `--no-branch`/`不建分支` → 跳过分支; 可组合使用 | `/ss-create -b 添加认证` → boost; `/ss-create -b -c 重构登录` → boost+creative |
+| 功能名称 | 移除标志后剩余文本，转为 camelCase。中文 → 先翻译为英文 | "add user auth" → `addUserAuth`; "添加用户认证" → `addUserAuth` |
 | 意图类型 | 语义推断 | add/new/implement/新增/添加 → `feature`; fix/bug/hotfix/修复 → `hotfix`; refactor/optimize/重构 → `refactor`; docs → `docs`; test → `test`; build/deps → `chore`; 默认 → `feature` |
 | 开发者 | "@username" 或 "Developer: xxx" → 提取（移除"@"）。回退: git 用户名 | "添加todolist @jay" → user=`jay` |
 | 语言 | CJK 字符 → `zh`; 显式 "zh"/"中文" → `zh`; "en"/"English" → `en`; 回退: 配置 `lang` | "添加todolist" → `zh` |

package/templates/zh/commands/ss-link.md

@@ -5,8 +5,17 @@ category: SuperSpec
 description: 添加 spec 依赖
 ---
 <!-- SUPERSPEC:START -->
+**输入解析规则**
+
+从用户输入中提取：**变更名称**、**依赖目标**。
+
+| 提取项 | 规则 | 示例 |
+|--------|------|------|
+| 变更名称 | 第一个参数或 `--on` 之前的文本 | `/ss-link addAuth --on addDB` → name=`addAuth` |
+| 依赖目标 | `--on <other>`/`依赖 <other>`/`→ <other>` → 提取目标名 | `/ss-link addAuth --on addDB`; `/ss-link addAuth 依赖 addDB` |
+
 **Steps**
-1. 运行 `superspec deps add <name> --on <other>`
-2. 这会更新 frontmatter: `depends_on: [other]`
+1. 解析用户输入 → 提取变更名称和依赖目标
+2. 运行 `superspec deps add <name> --on <other>`
 3. 验证: `superspec deps list <name>`
 <!-- SUPERSPEC:END -->

package/templates/zh/commands/ss-search.md

@@ -5,8 +5,17 @@ category: SuperSpec
 description: 全文搜索变更
 ---
 <!-- SUPERSPEC:START -->
+**输入解析规则**
+
+从用户输入中提取：**搜索关键词**、**可选标志**。
+
+| 提取项 | 规则 | 示例 |
+|--------|------|------|
+| 搜索关键词 | 移除标志后的剩余文本 | `/ss-search 用户认证` → query=`用户认证` |
+| 包含归档 | `--archived`/`归档`/`包含归档`/`all` → 添加 `--archived` | `/ss-search 认证 --archived`; `/ss-search 认证 归档` |
+| 过滤类型 | `--artifact <type>`/`类型:<type>` → 添加 `--artifact <type>`; type: `proposal`/`spec`/`tasks`/`clarify`/`checklist` | `/ss-search 认证 --artifact spec`; `/ss-search 认证 类型:proposal` |
+
 **Steps**
-1. 运行 `superspec search <query>`
-2. 使用 `--archived` 包含已归档的变更
-3. 使用 `--artifact <type>` 按 artifact 类型过滤
+1. 解析用户输入 → 提取搜索关键词和标志
+2. 运行 `superspec search "<query>" [--archived] [--artifact <type>]`
 <!-- SUPERSPEC:END -->

package/templates/zh/commands/ss-validate.md

@@ -5,11 +5,21 @@ category: SuperSpec
 description: 交叉引用一致性检查（boost 模式）
 ---
 <!-- SUPERSPEC:START -->
+**输入解析规则**
+
+从用户输入中提取：**变更名称**、**可选标志**。
+
+| 提取项 | 规则 | 示例 |
+|--------|------|------|
+| 变更名称 | 移除标志后的剩余文本；为空时使用当前活跃变更 | `/ss-validate addUserAuth` → name=`addUserAuth` |
+| 检查依赖 | `--check-deps`/`检查依赖`/`依赖检查` → 添加 `--check-deps` | `/ss-validate --check-deps`; `/ss-validate 检查依赖` |
+
 **Guardrails**
 - 验证 US↔FR↔AC↔tasks 一致性
 - 仅在 boost 模式下适用
 
 **Steps**
-1. 运行 `superspec validate [name]`
-2. 修复报告的任何一致性错误
+1. 解析用户输入 → 提取变更名称和标志
+2. 运行 `superspec validate [name] [--check-deps]`
+3. 修复报告的任何一致性错误
 <!-- SUPERSPEC:END -->