@zgsm/costrict-cli 0.0.1

package/dist/src/ui/commands/builtin/planApplyCommand.js

@@ -0,0 +1,104 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommandKind } from '../types.js';
+import { MessageType } from '../../types.js';
+/**
+ * Plan模式命令：创建规范驱动的开发提案
+ */
+export const planApplyCommand = {
+    name: 'plan-apply',
+    description: '执行规范驱动的开发提案',
+    kind: CommandKind.BUILT_IN,
+    autoExecute: true,
+    action: async (context, args) => {
+        try {
+            // 构建提示内容，包含参数和文件内容注入
+            // 处理控制台参数，并确保安全转义
+            const userArgs = args || '';
+            const prompt = `
+**护栏原则**
+- 优先采用最直接、最小化的实现方式，仅在明确需要或被要求时添加复杂性。
+- 优先参照当前项目代码来实现新模块代码。
+- 保持变更范围是紧密围绕用户预期结果展开的。
+- Apply约束或最佳实践，请一定要参考**Apply约束和最佳实践**。
+
+**步骤**  
+使用 \`update_todo_list\` 工具列出任务清单，将这些步骤作为待办事项跟踪，并逐一完成。
+1. 阅读 \`.cospec/plan/changes/<id>/proposal.md\`（如果存在）、\`tech.md\`（如果存在）和\`task.md\`（如果存在）以确认范围和验收标准。
+2. 按顺序处理任务，保持文件编辑最小化，并专注于任务中的变更描述。
+
+
+**Apply约束和最佳实践** 
+
+~~~markdown
+# Apply 指南
+
+使用 Apply 进行规范驱动开发的 AI 编码助手的说明。
+
+## 工作流程
+
+### 实施变更
+将这些步骤作为 TODO 项跟踪，并逐一完成。
+1. **阅读 proposal.md** （如果存在）- 了解要构建的内容
+2. **阅读 tech.md**（如果存在）- 审查技术决策
+3. **阅读 task.md** （如果存在）- 获取实施清单
+4. **按顺序实施任务** - 按顺序完成
+
+## 目录结构
+
+\`\`\`
+.cospec/plan/
+├── changes/               # 提案 - 具体变更的内容
+│   └─ [change-name]/
+       ├── proposal.md     # 原因、内容、影响
+       ├── task.md         # 实施清单
+       ├── tech.md         # 技术决策（可选）
+       └── specs/          # 增量变更
+           └── [capability]/
+               └── spec.md # ADDED/MODIFIED/REMOVED
+\`\`\`
+
+## 最佳实践
+
+### 简单性优先
+- 默认少于 100 行新代码
+- 单文件实现，直到证明不足
+- 避免使用没有明确要求的框架
+- 选择简单但经过验证的模式
+
+### 复杂性触发器
+仅在以下情况下添加复杂性：
+- 性能数据显示当前解决方案太慢
+- 具体的规模要求（>1000 用户，>100MB 数据）
+- 多个经过验证需要抽象的用例
+
+~~~
+
+
+### 请实现以下功能:
+${userArgs}
+`;
+            // 返回提交提示的动作
+            return {
+                type: 'submit_prompt',
+                content: [
+                    {
+                        text: prompt,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            context.ui.addItem({
+                type: MessageType.ERROR,
+                text: `Failed to execute plan command: ${errorMessage}`,
+            }, Date.now());
+            return undefined;
+        }
+    },
+};
+//# sourceMappingURL=planApplyCommand.js.map

package/dist/src/ui/commands/builtin/planApplyCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planApplyCommand.js","sourceRoot":"","sources":["../../../../../src/ui/commands/builtin/planApplyCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC,QAAQ;IAC1B,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,qBAAqB;YAErB,kBAAkB;YAClB,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6DnB,QAAQ;CACT,CAAC;YAEI,YAAY;YACZ,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,WAAW,CAAC,KAAK;gBACvB,IAAI,EAAE,mCAAmC,YAAY,EAAE;aACxD,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/ui/commands/builtin/planCommand.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SlashCommand } from '../types.js';
+/**
+ * Plan模式命令：创建规范驱动的开发提案
+ */
+export declare const planCommand: SlashCommand;

package/dist/src/ui/commands/builtin/planCommand.js

@@ -0,0 +1,308 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommandKind } from '../types.js';
+import { MessageType } from '../../types.js';
+/**
+ * Plan模式命令：创建规范驱动的开发提案
+ */
+export const planCommand = {
+    name: 'plan',
+    description: '创建规范驱动的开发提案',
+    kind: CommandKind.BUILT_IN,
+    autoExecute: true,
+    action: async (context, args) => {
+        try {
+            // 构建提示内容，包含参数和文件内容注入
+            // 处理控制台参数
+            const userArgs = args || '';
+            const prompt = `
+## Plan模式工作流
+
+### 流程跟踪
+
+工作流开始时，请**先使用\`todo_list\`工具**列出下列任务清单，将上述步骤作为待办事项跟踪，任务列表模板如下：
+\`\`\`
+1. 项目分析
+2. 提案创建
+\`\`\`
+注意：不可遗漏模板中的任一事项！不可打乱顺序！
+
+
+### Plan 变更提案创建阶段具体要求
+
+#### 护栏原则
+- 优先采用最直接、最小化的实现方式，仅在明确需要或被要求时添加复杂性。
+- 保持变更范围是紧密围绕用户预期结果展开的。
+- Plan模式约束或最佳实践，请一定要参考**Plan约束和最佳实践**。
+
+#### 详细步骤
+1. 选择一个唯一的动词引导的\`change-id\`，并在\`.cospec/plan/changes/<id>/\`下构建\`proposal.md\`、\`task.md\`和\`tech.md\`（需要时）。
+2. 将变更映射到具体能力或需求，将多范围工作分解为具有清晰关系和顺序的不同规格增量。
+3. 当解决方案跨越多个系统、引入新模式时，在\`tech.md\`中写明架构设计考量。
+4. 在\`.cospec/plan/changes/<id>/specs/<capability>/spec.md\`中起草规格增量，使用\`## ADDED|MODIFIED|REMOVED Requirements\`，每个需求至少包含一个\`#### Scenario:\`，并在关联时交叉引用。
+5. 将\`task.md\`起草为有序的小型可验证工作项目列表，这些项目提供用户可见的进度，包括验证，并突出依赖项或可并行的工作。
+
+#### 约束和最佳实践
+
+\`\`\`markdown
+# Plan 变更提案创建指南
+
+进行规范驱动开发的 AI 编码助手的说明。
+
+## 流程
+
+### 创建变更
+在以下情况下需要创建提案：
+- 添加功能或特性
+- 进行破坏性变更（API、架构）
+- 更改架构或模式
+- 优化性能（改变行为）
+- 更新安全模式
+
+触发器（示例）：
+- "帮我创建一个变更提案"
+- "帮我规划一个变更"
+- "帮我创建一个提案"
+- "我想创建一个规范提案"
+- "我想创建一个规范"
+
+跳过提案的情况：
+- 错误修复（恢复预期行为）
+- 拼写错误、格式、注释
+- 依赖更新（非破坏性）
+- 配置更改
+- 现有行为的测试
+
+**工作流程**
+1. 选择一个唯一的动词引导的 \`change-id\`，并在 \`.cospec/plan/changes/<id>/\` 下构建 \`proposal.md\`, \`task.md\`, 可选的 \`tech.md\` 和规范增量。
+2. 使用 \`## ADDED|MODIFIED|REMOVED Requirements\` 起草规范增量，每个需求至少包含一个 \`#### Scenario:\`。
+
+## 在任何任务之前
+
+**上下文检查清单：**
+- [ ] 阅读 \`specs/[capability]/spec.md\` 中的相关规范
+- [ ] 检查 \`changes/\` 中待处理的变更是否有冲突
+
+**创建规范之前：**
+- 始终检查功能是否已存在
+- 优先修改现有规范而不是创建重复项
+
+## 目录结构
+
+\`\`\`
+.cospec/plan/
+├── changes/                # 提案 - 具体变更的内容
+│   └─ [change-name]/
+│       ├── proposal.md     # 原因、内容、影响
+│       ├── task.md         # 实施清单
+│       ├── tech.md         # 技术决策（可选；参见标准）
+│       └── specs/          # 增量变更
+│           └── [capability]/
+│               └── spec.md # ADDED/MODIFIED/REMOVED
+\`\`\`
+
+## 创建变更提案
+
+### 决策树
+
+\`\`\`
+新请求？
+├─ 恢复规范行为的错误修复？→ 直接修复
+├─ 拼写错误/格式/注释？→ 直接修复
+├─ 新功能/能力？→ 创建提案
+├─ 破坏性变更？→ 创建提案
+├─ 架构变更？→ 创建提案
+└─ 不明确？→ 创建提案（更安全）
+\`\`\`
+
+### 提案结构
+
+1. **创建目录：** \`changes/[change-id]/\`（短横线命名法，动词引导，唯一）
+
+2. **编写 proposal.md:**
+\`\`\`markdown
+# 变更：[变更的简要描述]
+
+## 原因
+[关于问题/机会的 1-2 句话]
+
+## 变更内容
+- [变更的要点列表]
+- [用 **BREAKING** 标记破坏性变更]
+
+## 影响
+- 受影响的规范：[列出功能]
+- 受影响的代码：[关键文件/系统]
+例如：
+- **受影响的规范**：数据管理
+- **受影响的代码**：
+    - \`{代码路径}\`: {修改点1}。
+    - \`{代码路径}\`: {修改点2}。
+    - ...
+\`\`\`
+
+3. **创建规范增量：** \`specs/[capability]/spec.md\`
+\`\`\`markdown
+## ADDED Requirements
+### Requirement: 新功能
+系统应提供...
+
+#### Scenario: 成功案例
+- **WHEN** 用户执行操作
+- **THEN** 预期结果
+
+## MODIFIED Requirements
+### Requirement: 现有功能
+[完整的修改后的需求]
+
+## REMOVED Requirements
+### Requirement: 旧功能
+**原因**：[为什么移除]
+**迁移**：[如何处理]
+\`\`\`
+如果多个功能受到影响，请在 \`changes/[change-id]/specs/<capability>/spec.md\` 下创建多个增量文件——每个功能一个。
+
+4. **创建 task.md:**
+task.md中只能包含目标和实施，不包含其他任何内容。
+
+\`\`\`markdown
+## 1. 目标
+{当前任务的目标}
+
+## 2. 实施
+- [ ] 1.1 后端： \`{代码路径}\` ，{具体修改、需要注意的关键改动项}。
+- [ ] 1.2 前端： \`{代码路径}\` ，{具体修改、需要注意的关键改动项}。
+- [ ] {实施里面不要写任何测试相关的任务}
+- ...
+\`\`\`
+
+5. **在需要时创建 tech.md:**
+如果满足以下任何条件，请创建 \`tech.md\`；否则省略它：
+- 变更（多个服务/模块）或新架构模式
+- 新的外部依赖或重要的数据模型变更
+- 安全性、性能或任务复杂性较高
+
+最小的 \`tech.md\` 框架：
+\`\`\`markdown
+## 上下文
+[背景、约束、利益相关者]
+
+## 目标 / 非目标
+- 目标：[...]
+- 非目标：[...]
+
+## 决策
+- 决策：[内容和原因]
+- 考虑的替代方案：[选项 + 理由]
+
+## 风险 / 权衡
+- [风险] → 缓解措施
+
+## 迁移计划
+[步骤、回滚]
+
+## 开放问题
+- [...]
+\`\`\`
+
+## 规范文件格式
+
+### 关键：场景格式
+
+**正确**（使用 #### 标题）：
+\`\`\`markdown
+#### Scenario: 用户登录成功
+- **WHEN** 提供有效凭据
+- **THEN** 返回 JWT 令牌
+\`\`\`
+
+**错误**（不要使用项目符号或粗体）：
+\`\`\`markdown
+- **Scenario: 用户登录**  ❌
+**Scenario**: 用户登录     ❌
+### Scenario: 用户登录      ❌
+\`\`\`
+
+每个需求必须至少有一个场景。
+
+### 需求措辞
+- 对规范性要求使用 SHALL/MUST（除非有意非规范性，否则避免使用 should/may）
+
+### 增量操作
+
+- \`## ADDED Requirements\` - 新功能
+- \`## MODIFIED Requirements\` - 变更的行为
+- \`## REMOVED Requirements\` - 弃用的功能
+- \`## RENAMED Requirements\` - 名称变更
+
+标题使用 \`trim(header)\` 匹配 - 忽略空白字符。
+
+#### 何时使用 ADDED vs MODIFIED
+- ADDED：引入可以独立作为需求的新功能或子功能。当变更正交（例如添加"斜杠命令配置"）而不是改变现有需求的语义时，优先使用 ADDED。
+- MODIFIED：更改现有需求的行为、范围或验收标准。始终粘贴完整的更新需求内容（标题 + 所有场景）。归档器将用您在此处提供的内容替换整个需求；部分增量将丢失之前的详细信息。
+- RENAMED：仅在名称更改时使用。如果您还更改行为，请使用 RENAMED（名称）加上 MODIFIED（内容）引用新名称。
+
+
+正确编写 MODIFIED 需求：
+1) 在 \`.cospec/plan/specs/<capability>/spec.md\` 中找到现有需求。
+2) 复制整个需求块（从 \`### Requirement: ...\` 到其场景）。
+3) 将其粘贴到 \`## MODIFIED Requirements\` 下并编辑以反映新行为。
+4) 确保标题文本完全匹配（不区分空白字符）并至少保留一个 \`#### Scenario:\`。
+
+RENAMED 示例：
+\`\`\`markdown
+## RENAMED Requirements
+- FROM: \`### Requirement: 登录\`
+- TO: \`### Requirement: 用户认证\`
+\`\`\`
+
+## 最佳实践
+
+### 清晰引用
+- 使用 \`{文件路径}:{类/函数}\` 格式表示代码位置
+- 引用规范为 \`specs/auth/spec.md\`
+- 链接相关变更和 PR
+
+### 功能命名
+- 使用动词-名词：\`user-auth\`, \`payment-capture\`
+- 每个功能单一目的
+- 10 分钟可理解规则
+- 如果描述需要 "AND"，则拆分
+
+### 变更 ID 命名
+- 使用短横线命名法，简短且描述性：\`add-two-factor-auth\`
+- 优先使用动词引导前缀：\`add-\`, \`update-\`, \`remove-\`, \`refactor-\`
+- 确保唯一性；如果已被占用，附加 \`-2\`, \`-3\` 等
+\`\`\`
+
+记住：规范是事实。变更是提案。保持它们同步。
+
+
+### 用户问题:
+
+${userArgs || '请创建一个新的开发计划提案'}
+`;
+            // 返回提交提示的动作
+            return {
+                type: 'submit_prompt',
+                content: [
+                    {
+                        text: prompt,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            context.ui.addItem({
+                type: MessageType.ERROR,
+                text: `Failed to execute plan command: ${errorMessage}`,
+            }, Date.now());
+            return undefined;
+        }
+    },
+};
+//# sourceMappingURL=planCommand.js.map

package/dist/src/ui/commands/builtin/planCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planCommand.js","sourceRoot":"","sources":["../../../../../src/ui/commands/builtin/planCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC,QAAQ;IAC1B,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,qBAAqB;YAErB,UAAU;YACV,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyQnB,QAAQ,IAAI,eAAe;CAC5B,CAAC;YAEI,YAAY;YACZ,OAAO;gBACL,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,WAAW,CAAC,KAAK;gBACvB,IAAI,EAAE,mCAAmC,YAAY,EAAE;aACxD,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/src/ui/commands/chatCommand.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { SlashCommand } from './types.js';
+import type { Content } from '@google/genai';
+export declare function serializeHistoryToMarkdown(history: Content[]): string;
+export declare const chatCommand: SlashCommand;