@fifine/aim-studio 0.0.2 → 0.0.4

package/dist/templates/claude/hooks/session-start.py

@@ -65,6 +65,49 @@ def run_script(script_path: Path) -> str:
         return "No context available"
 
 
+def detect_project_type(project_dir: Path) -> str:
+    """Detect project type based on directory structure."""
+
+    # Check for bin/ directory (CLI tool)
+    if (project_dir / "bin").is_dir():
+        return "cli"
+
+    # Check for story project (has spec/story/)
+    if (project_dir / ".aim-studio" / "spec" / "story").is_dir():
+        return "story"
+
+    # Check for frontend indicators
+    frontend_indicators = [
+        "package.json",
+        "vite.config.ts",
+        "vite.config.js",
+        "next.config.js",
+        "next.config.ts",
+        "nuxt.config.ts",
+    ]
+    has_frontend = any((project_dir / f).exists() for f in frontend_indicators)
+
+    # Check for backend indicators
+    backend_indicators = [
+        "requirements.txt",
+        "pyproject.toml",
+        "go.mod",
+        "Cargo.toml",
+        "pom.xml",
+        "composer.json",
+    ]
+    has_backend = any((project_dir / f).exists() for f in backend_indicators)
+
+    if has_frontend and has_backend:
+        return "fullstack"
+    elif has_frontend:
+        return "frontend"
+    elif has_backend:
+        return "backend"
+
+    return "unknown"
+
+
 def main():
     if should_skip_injection():
         sys.exit(0)
@@ -73,58 +116,125 @@ def main():
     trellis_dir = project_dir / ".aim-studio"
     claude_dir = project_dir / ".claude"
 
+    # Detect project type
+    project_type = detect_project_type(project_dir)
+
     output = StringIO()
 
-    output.write("""<session-context>
-You are starting a new session in a Trellis-managed project.
-Read and follow all instructions below carefully.
-</session-context>
+    # 根据项目类型显示不同的欢迎信息
+    welcome_messages = {
+        "cli": "AIM Studio CLI 项目",
+        "frontend": "AIM Studio 前端项目",
+        "backend": "AIM Studio 后端项目",
+        "fullstack": "AIM Studio 全栈项目",
+        "story": "AIM Studio 漫剧创作项目",
+        "unknown": "AIM Studio 项目",
+    }
+
+    output.write(f"""<session-context>
+您正在启动一个 {welcome_messages.get(project_type, 'AIM Studio')} 会话。
+请仔细阅读以下说明并遵循执行。
+
+项目类型: {project_type}
 
 """)
 
+    # Get current context
     output.write("<current-state>\n")
     context_script = trellis_dir / "scripts" / "get_context.py"
     output.write(run_script(context_script))
     output.write("\n</current-state>\n\n")
 
+    # Workflow
     output.write("<workflow>\n")
-    workflow_content = read_file(trellis_dir / "workflow.md", "No workflow.md found")
+    workflow_content = read_file(trellis_dir / "workflow.md", "未找到 workflow.md")
     output.write(workflow_content)
     output.write("\n</workflow>\n\n")
 
+    # Guidelines - 根据项目类型注入相应的规范
     output.write("<guidelines>\n")
 
-    output.write("## Frontend\n")
-    frontend_index = read_file(
-        trellis_dir / "spec" / "frontend" / "index.md", "Not configured"
-    )
-    output.write(frontend_index)
-    output.write("\n\n")
-
-    output.write("## Backend\n")
-    backend_index = read_file(
-        trellis_dir / "spec" / "backend" / "index.md", "Not configured"
-    )
-    output.write(backend_index)
-    output.write("\n\n")
+    # CLI 项目
+    if project_type == "cli":
+        output.write("## CLI 开发规范\n")
+        cli_index = read_file(
+            trellis_dir / "spec" / "cli" / "index.md", "未配置 CLI 规范"
+        )
+        output.write(cli_index)
+        output.write("\n\n")
+
+    # Frontend 项目
+    if project_type in ("frontend", "fullstack"):
+        output.write("## 前端开发规范\n")
+        frontend_index = read_file(
+            trellis_dir / "spec" / "frontend" / "index.md", "未配置前端规范"
+        )
+        output.write(frontend_index)
+        output.write("\n\n")
+
+    # Backend 项目
+    if project_type in ("backend", "fullstack", "cli"):
+        output.write("## 后端开发规范\n")
+        backend_index = read_file(
+            trellis_dir / "spec" / "backend" / "index.md", "未配置后端规范"
+        )
+        output.write(backend_index)
+        output.write("\n\n")
+
+    # Story 项目
+    if project_type == "story":
+        output.write("## 漫剧创作规范\n")
+        story_index = read_file(
+            trellis_dir / "spec" / "story" / "index.md", "未配置漫剧规范"
+        )
+        output.write(story_index)
+        output.write("\n\n")
 
-    output.write("## Guides\n")
+    # Guides - 始终提供
+    output.write("## 开发指南\n")
     guides_index = read_file(
-        trellis_dir / "spec" / "guides" / "index.md", "Not configured"
+        trellis_dir / "spec" / "guides" / "index.md", "未配置开发指南"
     )
     output.write(guides_index)
 
     output.write("\n</guidelines>\n\n")
 
+    # 读取命令文件 - 必须使用 commands/aim/ 目录（新结构）
+    def read_command_file(filename: str) -> str:
+        """读取 commands/aim/ 目录下的命令文件"""
+        aim_path = claude_dir / "commands" / "aim" / filename
+        if aim_path.exists():
+            return read_file(aim_path, "")
+        return f"未找到命令文件: {filename}"
+
+    # 根据项目类型选择不同的 start 指令
+    if project_type == "story":
+        start_md = read_command_file("story.md")
+    else:
+        start_md = read_command_file("start.md")
+
     output.write("<instructions>\n")
-    start_md = read_file(
-        claude_dir / "commands" / "trellis" / "start.md", "No start.md found"
-    )
     output.write(start_md)
     output.write("\n</instructions>\n\n")
 
+    # 项目类型特定的提示
+    type_hints = {
+        "cli": "注意：这是一个 CLI 工具项目，请参考 spec/cli/ 目录下的规范。",
+        "frontend": "注意：这是一个前端项目，请参考 spec/frontend/ 目录下的规范。",
+        "backend": "注意：这是一个后端项目，请参考 spec/backend/ 目录下的规范。",
+        "fullstack": "注意：这是一个全栈项目，请同时参考 spec/frontend/ 和 spec/backend/ 目录下的规范。",
+        "story": "注意：这是一个漫剧创作项目，请使用 /aim:story 命令开始创作。漫剧命令不适用于其他类型的项目。",
+        "unknown": "注意：项目类型未知，请根据实际情况选择合适的工作流程。",
+    }
+
+    output.write(f"""<project-type-hint>
+{type_hints.get(project_type, '')}
+</project-type-hint>
+
+""")
+
     output.write("""<ready>
-Context loaded. Wait for user's first message, then follow <instructions> to handle their request.
+上下文已加载。请等待用户的第一个消息，然后按照 <instructions> 中的说明处理用户请求。
 </ready>""")
 
     result = {

package/dist/templates/markdown/index.d.ts

@@ -29,4 +29,9 @@ export declare const storyIndexContent: string;
 export declare const storyCharacterContent: string;
 export declare const storyWorldContent: string;
 export declare const storyScriptContent: string;
+export declare const cliIndexContent: string;
+export declare const cliDirectoryStructureContent: string;
+export declare const cliOptionsFlagsContent: string;
+export declare const cliOutputFormattingContent: string;
+export declare const cliErrorHandlingContent: string;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/markdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MAErD,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MACiB,CAAC;AAGxE,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,iBAAiB,EAAE,MAE/B,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AAGF,eAAO,MAAM,eAAe,EAAE,MAE7B,CAAC;AACF,eAAO,MAAM,4BAA4B,EAAE,MAE1C,CAAC;AACF,eAAO,MAAM,sBAAsB,EAAE,MAEpC,CAAC;AACF,eAAO,MAAM,0BAA0B,EAAE,MAExC,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,MAErC,CAAC"}

package/dist/templates/markdown/index.js

@@ -55,4 +55,10 @@ export const storyIndexContent = readLocalTemplate("spec/story/index.md.txt");
 export const storyCharacterContent = readLocalTemplate("spec/story/character.md.txt");
 export const storyWorldContent = readLocalTemplate("spec/story/world.md.txt");
 export const storyScriptContent = readLocalTemplate("spec/story/script.md.txt");
+// CLI tool structure
+export const cliIndexContent = readLocalTemplate("spec/cli/index.md.txt");
+export const cliDirectoryStructureContent = readLocalTemplate("spec/cli/directory-structure.md.txt");
+export const cliOptionsFlagsContent = readLocalTemplate("spec/cli/options-flags.md.txt");
+export const cliOutputFormattingContent = readLocalTemplate("spec/cli/output-formatting.md.txt");
+export const cliErrorHandlingContent = readLocalTemplate("spec/cli/error-handling.md.txt");
 //# sourceMappingURL=index.js.map

package/dist/templates/markdown/index.js.map

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

package/dist/templates/markdown/spec/cli/directory-structure.md.txt

@@ -0,0 +1,71 @@
+# CLI Directory Structure
+
+> How the CLI tool is organized.
+
+---
+
+## Overview
+
+Describe your CLI project's directory structure and organization.
+
+---
+
+## Entry Point
+
+| File | Purpose |
+|------|---------|
+| `bin/aim.js` | Main CLI entry point |
+| `src/cli/` | CLI argument parsing |
+| `src/commands/` | Command implementations |
+
+---
+
+## Example Structure
+
+```
+.
+├── bin/
+│   └── aim.js           # CLI entry point
+├── src/
+│   ├── cli/            # Command-line parsing
+│   │   └── index.ts
+│   ├── commands/       # Command implementations
+│   │   ├── init.ts
+│   │   └── update.ts
+│   ├── utils/          # Utility functions
+│   └── types/          # TypeScript types
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## Patterns
+
+Describe common patterns used in your project:
+
+### Command Organization
+
+```typescript
+// Example: how commands are registered
+export const commands = [init, update];
+```
+
+### Module Boundaries
+
+- `src/cli/` - Pure CLI concerns (parsing, help text)
+- `src/commands/` - Business logic
+- `src/utils/` - Shared utilities
+
+---
+
+## Anti-Patterns
+
+- ❌ Mixing business logic in CLI entry point
+- ❌ No separation between commands
+
+---
+
+## Add Your Examples
+
+Replace these with real examples from your codebase.

package/dist/templates/markdown/spec/cli/error-handling.md.txt

@@ -0,0 +1,91 @@
+# CLI Error Handling
+
+> How errors are handled and reported.
+
+---
+
+## Overview
+
+Document your CLI's error handling patterns, exit codes, and error messages.
+
+---
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error |
+| `2` | Misuse of command |
+| `3` | Internal error |
+
+---
+
+## Error Categories
+
+| Category | Exit Code | Example |
+|----------|-----------|---------|
+| Validation | `2` | Missing required argument |
+| Not Found | `2` | File/directory not found |
+| Permission | `2` | Cannot write to directory |
+| Internal | `3` | Unexpected exception |
+
+---
+
+## Error Message Format
+
+```
+❌ Error: <short description>
+   <detailed explanation (optional)>
+   <suggestion/fix (optional)>
+```
+
+### Example
+
+```
+❌ Error: Template not found
+   Template "react" does not exist
+   Run "aim template list" to see available templates
+```
+
+---
+
+## Patterns
+
+### Throwing Errors
+
+```typescript
+import { error as consoleError, exit } from 'node:process';
+
+function validateArgs(args: string[]) {
+  if (!args.length) {
+    consoleError('Error: Missing required argument');
+    exit(2);
+  }
+}
+```
+
+### Try-Catch with Exit
+
+```typescript
+try {
+  await doSomething();
+} catch (err) {
+  consoleError(`Error: ${err.message}`);
+  exit(1);
+}
+```
+
+---
+
+## Anti-Patterns
+
+- ❌ Silent failures
+- ❌ Stack traces exposed to users
+- ❌ No error suggestions
+
+---
+
+## Add Your Examples
+
+Replace with your actual error handling patterns.

package/dist/templates/markdown/spec/cli/index.md.txt

@@ -0,0 +1,37 @@
+# CLI Tool Development Guidelines
+
+> Best practices for CLI tool development in this project.
+
+---
+
+## Overview
+
+This directory contains guidelines for CLI tool development. Fill in each file with your project's specific conventions.
+
+---
+
+## Guidelines Index
+
+| Guide | Description | Status |
+|-------|-------------|--------|
+| [Directory Structure](./directory-structure.md) | Command organization, module layout | TODO |
+| [Options & Flags](./options-flags.md) | Global options, flags, environment variables | TODO |
+| [Output Formatting](./output-formatting.md) | Output formats, colors, user feedback | TODO |
+| [Error Handling](./error-handling.md) | Error codes, messages, exit statuses | TODO |
+
+---
+
+## How to Fill These Guidelines
+
+For each guideline file:
+
+1. Document your project's **actual conventions** (not ideals)
+2. Include **code examples** from your codebase
+3. List **forbidden patterns** and why
+4. Add **common mistakes** your team has made
+
+The goal is to help AI assistants and new team members understand how YOUR project works.
+
+---
+
+**Language**: All documentation should be written in **English**.

package/dist/templates/markdown/spec/cli/options-flags.md.txt

@@ -0,0 +1,71 @@
+# CLI Options & Flags
+
+> How command-line options and flags are defined.
+
+---
+
+## Overview
+
+Document your CLI's options, flags, and environment variables.
+
+---
+
+## Global Options
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--help` | `-h` | Show help | - |
+| `--version` | `-v` | Show version | - |
+| `--verbose` | - | Enable verbose output | `false` |
+
+---
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AIM_HOME` | AIM Studio home directory | `~/.aim-studio` |
+| `AIM_CONFIG` | Config file path | `~/.aim-studio/config.json` |
+
+---
+
+## Command-Specific Options
+
+### init Command
+
+```bash
+aim init -u username --template react
+```
+
+| Option | Alias | Description |
+|--------|-------|-------------|
+| `--user` | `-u` | Developer username |
+| `--template` | - | Template to use |
+| `--force` | - | Overwrite existing files |
+
+---
+
+## Patterns
+
+### Option Definition
+
+```typescript
+// Example: using commander.js
+program
+  .option('-u, --user <name>', 'Developer username')
+  .option('-t, --template <template>', 'Template name')
+  .option('-f, --force', 'Overwrite existing files');
+```
+
+---
+
+## Anti-Patterns
+
+- ❌ Too many required options
+- ❌ Inconsistent option names (`--user` vs `--username`)
+
+---
+
+## Add Your Examples
+
+Replace with your actual option definitions.

package/dist/templates/markdown/spec/cli/output-formatting.md.txt

@@ -0,0 +1,93 @@
+# CLI Output Formatting
+
+> How the CLI formats and presents output to users.
+
+---
+
+## Overview
+
+Document your CLI's output conventions including colors, formatting, and user feedback.
+
+---
+
+## Output Types
+
+| Type | Use Case |
+|------|----------|
+| `console.log` | Normal output, confirmations |
+| `console.error` | Errors, warnings |
+| `chalk` | Colored output for emphasis |
+
+---
+
+## Color Conventions
+
+| Color | Usage |
+|-------|-------|
+| `cyan` | Primary information, headers |
+| `green` | Success messages, confirmations |
+| `yellow` | Warnings |
+| `red` | Errors |
+| `gray` | Secondary information |
+
+---
+
+## Example Output
+
+### Success
+
+```
+✅ Project initialized successfully!
+```
+
+### Error
+
+```
+❌ Error: Directory already exists
+   Use --force to overwrite
+```
+
+### Progress
+
+```
+📦 Downloading template...
+   345.2 KB / 345.2 KB
+```
+
+---
+
+## Patterns
+
+### Using Chalk
+
+```typescript
+import chalk from 'chalk';
+
+console.log(chalk.green('✓ ') + 'Success message');
+console.log(chalk.red('✗ ') + 'Error message');
+console.log(chalk.cyan('ℹ ') + 'Info message');
+```
+
+### Progress Indicators
+
+```typescript
+// Using ora for spinners
+import ora from 'ora';
+
+const spinner = ora('Loading...').start();
+spinner.succeed('Done!');
+```
+
+---
+
+## Anti-Patterns
+
+- ❌ No error messages
+- ❌ Inconsistent colors
+- ❌ Too much output (noise)
+
+---
+
+## Add Your Examples
+
+Replace with your actual output patterns.

package/dist/utils/project-detector.d.ts

@@ -1,7 +1,7 @@
 /**
  * Project type detected by analyzing project files
  */
-export type ProjectType = "frontend" | "backend" | "fullstack" | "story" | "unknown";
+export type ProjectType = "frontend" | "backend" | "fullstack" | "story" | "cli" | "unknown";
 /**
  * Detect project type by analyzing project files
  *

package/dist/utils/project-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAiKrF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAqB1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAanE"}
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../src/utils/project-detector.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,SAAS,GACT,WAAW,GACX,OAAO,GACP,KAAK,GACL,SAAS,CAAC;AA6Kd;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA8B1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAenE"}

package/dist/utils/project-detector.js

@@ -97,6 +97,17 @@ const BACKEND_DEPS = [
     "flask",
     "django",
 ];
+/**
+ * Files that indicate a CLI tool project (not frontend/backend)
+ */
+const CLI_INDICATORS = [
+    // Node.js CLI tools
+    "bin/aim.js",
+    "bin/trellis.js",
+    "bin/cli.js",
+    // Python CLI tools (click, typer, argparse)
+    "pyproject.toml", // Check for CLI tools in dependencies
+];
 /**
  * Check if a file exists in the project directory
  */
@@ -150,6 +161,9 @@ function checkPackageJson(cwd) {
  * @returns Detected project type
  */
 export function detectProjectType(cwd) {
+    // Check for CLI tool indicators first (has bin/ directory)
+    const hasCliFiles = CLI_INDICATORS.some((f) => fileExists(cwd, f));
+    const hasBinDir = fs.existsSync(path.join(cwd, "bin"));
     // Check for file indicators
     const hasFrontendFiles = FRONTEND_INDICATORS.some((f) => fileExists(cwd, f));
     const hasBackendFiles = BACKEND_INDICATORS.some((f) => fileExists(cwd, f));
@@ -157,6 +171,10 @@ export function detectProjectType(cwd) {
     const { hasFrontend: hasFrontendDeps, hasBackend: hasBackendDeps } = checkPackageJson(cwd);
     const isFrontend = hasFrontendFiles || hasFrontendDeps;
     const isBackend = hasBackendFiles || hasBackendDeps;
+    // CLI tool detection: has bin/ directory but no frontend/backend indicators
+    if ((hasCliFiles || hasBinDir) && !isFrontend && !isBackend) {
+        return "cli";
+    }
     if (isFrontend && isBackend) {
         return "fullstack";
     }
@@ -181,6 +199,8 @@ export function getProjectTypeDescription(type) {
             return "Fullstack project (frontend + backend)";
         case "story":
             return "Story project (Comic/Novel creation)";
+        case "cli":
+            return "CLI tool project (command-line interface)";
         case "unknown":
             return "Unknown project type (defaults to fullstack)";
     }