@benbenwu/zcf 3.6.4

package/dist/shared/zcf.DGjQxTq_.mjs

@@ -0,0 +1,34 @@
+import { pathExists } from 'fs-extra';
+import trash from 'trash';
+
+async function moveToTrash(paths) {
+  const pathArray = Array.isArray(paths) ? paths : [paths];
+  const results = [];
+  for (const path of pathArray) {
+    try {
+      const exists = await pathExists(path);
+      if (!exists) {
+        results.push({
+          success: false,
+          path,
+          error: "Path does not exist"
+        });
+        continue;
+      }
+      await trash(path);
+      results.push({
+        success: true,
+        path
+      });
+    } catch (error) {
+      results.push({
+        success: false,
+        path,
+        error: error.message || "Unknown error occurred"
+      });
+    }
+  }
+  return results;
+}
+
+export { moveToTrash as m };

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@benbenwu/zcf",
+  "type": "module",
+  "version": "3.6.4",
+  "packageManager": "pnpm@10.17.1",
+  "description": "Zero-Config Code Flow - One-click configuration tool for Code Cli",
+  "author": {
+    "name": "Miao Da",
+    "email": "ufo025174@gmail.com",
+    "url": "https://github.com/WitMiao"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/UfoMiao/zcf",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/UfoMiao/zcf.git"
+  },
+  "bugs": "https://github.com/UfoMiao/zcf/issues",
+  "keywords": [
+    "claude",
+    "claude-code",
+    "codex",
+    "config",
+    "cli",
+    "setup",
+    "zero-config",
+    "zcf",
+    "anthropic",
+    "openai",
+    "ChatGPT",
+    "ai",
+    "automation",
+    "mcp"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "bin": {
+    "zcf": "bin/zcf.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "dev": "tsx ./src/cli.ts",
+    "build": "unbuild",
+    "start": "node bin/zcf.mjs",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "test:run": "vitest run",
+    "test:watch": "vitest watch",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "update:deps": "pnpx taze major -r -w",
+    "release": "pnpm build && changeset publish",
+    "prepare": "husky",
+    "commitlint": "commitlint",
+    "commitlint:check": "commitlint --from HEAD~1 --to HEAD --verbose",
+    "docs:dev": "pnpm -F @zcf/docs dev",
+    "docs:build": "pnpm -F @zcf/docs build",
+    "docs:preview": "pnpm -F @zcf/docs preview"
+  },
+  "dependencies": {
+    "@rainbowatcher/toml-edit-js": "catalog:runtime",
+    "@types/semver": "catalog:types",
+    "ansis": "catalog:cli",
+    "cac": "catalog:cli",
+    "dayjs": "catalog:runtime",
+    "find-up-simple": "catalog:runtime",
+    "fs-extra": "catalog:runtime",
+    "i18next": "catalog:runtime",
+    "i18next-fs-backend": "catalog:runtime",
+    "inquirer": "catalog:cli",
+    "inquirer-toggle": "catalog:cli",
+    "ora": "catalog:cli",
+    "pathe": "catalog:runtime",
+    "semver": "catalog:runtime",
+    "tinyexec": "catalog:runtime",
+    "trash": "catalog:runtime"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "catalog:build",
+    "@changesets/cli": "catalog:tooling",
+    "@commitlint/cli": "catalog:tooling",
+    "@commitlint/config-conventional": "catalog:tooling",
+    "@commitlint/types": "catalog:tooling",
+    "@types/fs-extra": "catalog:types",
+    "@types/inquirer": "catalog:types",
+    "@types/node": "catalog:types",
+    "@vitest/coverage-v8": "catalog:testing",
+    "@vitest/ui": "catalog:testing",
+    "eslint": "catalog:build",
+    "eslint-plugin-format": "catalog:build",
+    "glob": "catalog:testing",
+    "husky": "catalog:tooling",
+    "lint-staged": "catalog:tooling",
+    "tsx": "catalog:build",
+    "typescript": "catalog:build",
+    "unbuild": "catalog:build",
+    "vitest": "catalog:testing"
+  },
+  "lint-staged": {
+    "*": [
+      "pnpm lint"
+    ]
+  }
+}

package/templates/CLAUDE.md

@@ -0,0 +1,221 @@
+# Templates Module
+
+**Last Updated**: Sun Dec 15 09:15:34 CST 2025
+[Root](../CLAUDE.md) > **templates**
+
+## Module Responsibilities
+
+Template system module providing multilingual configuration templates, AI personality styles, and workflow definitions for both Claude Code and Codex environments. Supports Chinese (zh-CN) and English (en) locales with comprehensive workflow coverage.
+
+## Entry Points and Startup
+
+- **Main Template Directories**:
+  - `claude-code/` - Claude Code specific templates
+  - `codex/` - Codex specific templates
+  - `common/` - Shared configuration templates
+
+## External Interfaces
+
+### Template Structure
+
+```
+templates/
+├── common/                   # Shared templates (cross code-tool)
+│   ├── output-styles/       # AI personality styles
+│   │   ├── en/              # English output styles
+│   │   │   ├── engineer-professional.md
+│   │   │   ├── laowang-engineer.md
+│   │   │   ├── nekomata-engineer.md
+│   │   │   └── ojousama-engineer.md
+│   │   └── zh-CN/           # Chinese output styles
+│   │       ├── engineer-professional.md
+│   │       ├── laowang-engineer.md
+│   │       ├── nekomata-engineer.md
+│   │       └── ojousama-engineer.md
+│   └── workflow/
+│       ├── git/             # Git workflow
+│       │   ├── en/          # English git commands
+│       │   │   ├── git-commit.md
+│       │   │   ├── git-worktree.md
+│       │   │   ├── git-cleanBranches.md
+│       │   │   └── git-rollback.md
+│       │   └── zh-CN/       # Chinese git commands
+│       │       ├── git-commit.md
+│       │       ├── git-worktree.md
+│       │       ├── git-cleanBranches.md
+│       │       └── git-rollback.md
+│       └── sixStep/         # Six-step workflow
+│           ├── en/          # English workflow
+│           │   └── workflow.md
+│           └── zh-CN/       # Chinese workflow
+│               └── workflow.md
+├── claude-code/              # Claude Code templates
+│   ├── common/              # Common configurations
+│   ├── zh-CN/               # Chinese templates
+│   │   └── workflow/        # Workflow templates
+│   │       ├── common/      # Common tools workflow
+│   │       ├── plan/        # Planning workflow
+│   │       └── bmad/        # BMAD workflow
+│   └── en/                  # English templates
+│       └── workflow/        # Workflow templates
+└── codex/                   # Codex templates
+    ├── common/              # Common configurations
+    ├── zh-CN/               # Chinese templates
+    │   └── workflow/        # Workflow templates
+    └── en/                  # English templates
+        └── workflow/        # Workflow templates
+```
+
+### Template Categories
+
+#### 1. Output Styles (AI Personalities)
+
+- **engineer-professional** - Professional engineering style
+- **nekomata-engineer** - Nekomata engineer personality
+- **laowang-engineer** - Laowang engineer personality
+- **ojousama-engineer** - Ojou-sama engineer personality
+- **rem-engineer** - Rem maid engineer personality
+- **default** - Default output style
+- **explanatory** - Explanatory style
+- **learning** - Learning-focused style
+
+#### 2. Workflow Templates
+
+##### Common Tools Workflow
+- **Commands**: `init-project`
+- **Agents**: `init-architect`, `get-current-datetime`
+- **Purpose**: Essential development tools and project initialization
+
+##### Planning Workflow (Plan)
+- **Commands**: `feat`, `workflow`
+- **Agents**: `planner`, `ui-ux-designer`
+- **Purpose**: Feature planning and UX design
+
+##### Six-Step Workflow
+- **Commands**: `zcf-update-docs`, `zcf-pr`, `zcf-release`
+- **Purpose**: Structured development process
+
+##### BMAD Workflow
+- **Commands**: Enterprise-level workflow commands
+- **Purpose**: Business model and architecture design
+
+##### Git Workflow
+- **Commands**: `git-commit`, `git-worktree`, `git-cleanBranches`, `git-rollback`
+- **Purpose**: Version control management with conventional commits, worktree management, branch cleanup, and rollback operations
+
+## Key Dependencies and Configuration
+
+### Template Processing
+
+- **Language Support**: zh-CN and en locales
+- **Code Tool Support**: Claude Code and Codex
+- **Template Format**: Markdown-based configuration files
+- **Variable Substitution**: Dynamic content replacement
+
+### Configuration Integration
+
+- **Workflow Installer**: Integration with `src/utils/workflow-installer.ts`
+- **Language Detection**: Integration with `src/i18n/` system
+- **Platform Support**: Cross-platform path handling
+
+## Data Models
+
+### Template Organization
+
+```typescript
+interface TemplateStructure {
+  codeTool: 'claude-code' | 'codex'
+  locale: 'zh-CN' | 'en'
+  category: 'common' | 'output-styles' | 'workflow'
+  workflow?: {
+    type: 'common' | 'plan' | 'sixStep' | 'bmad' | 'git'
+    commands: string[]
+    agents: string[]
+  }
+}
+```
+
+### Output Style Configuration
+
+```typescript
+interface OutputStyle {
+  id: string
+  name: { 'zh-CN': string, 'en': string }
+  description: { 'zh-CN': string, 'en': string }
+  template: string
+  personality: string
+}
+```
+
+## Testing and Quality
+
+### Template Validation
+
+- **File**: `tests/templates/chinese-templates.test.ts`
+- **Coverage**: Template completeness and format validation
+- **Validation**: Markdown syntax and variable substitution
+
+### Quality Metrics
+
+- **Template Coverage**: 100% for both locales
+- **Code Tool Support**: Claude Code and Codex fully supported
+- **Workflow Coverage**: 5 major workflow categories
+- **Output Styles**: 7 AI personality styles
+
+## Common Issues
+
+- **Path Handling**: Cross-platform path compatibility
+- **Encoding**: UTF-8 encoding for multilingual content
+- **Template Variables**: Proper variable substitution
+- **File Permissions**: Executable permissions for command files
+
+## Related Files
+
+- `src/utils/workflow-installer.ts` - Template installation logic
+- `src/config/workflows.ts` - Workflow configuration definitions
+- `src/i18n/` - Internationalization support
+- `tests/templates/` - Template validation tests
+
+## Change Log (Module-Specific)
+
+### Recent Updates
+
+- Consolidated sixStep workflow templates to `templates/common/workflow/sixStep/` with unified `.zcf` plan directory for both Claude Code and Codex
+- Consolidated output-styles/system-prompt templates to `templates/common/output-styles/`
+- Consolidated git workflow templates to `templates/common/workflow/git/`
+- Added Codex template support for dual code tool architecture
+- Enhanced workflow templates with comprehensive command coverage
+- Improved AI personality styles with professional variations
+- Added cross-platform template compatibility
+- Enhanced template validation and testing coverage
+
+## FAQ
+
+### Q: How to add a new workflow template?
+
+1. Create workflow directory under `templates/{code-tool}/{locale}/workflow/`
+2. Add command files in `commands/` subdirectory
+3. Add agent files in `agents/` subdirectory (if needed)
+4. Update `src/config/workflows.ts` with new workflow definition
+5. Add translations in `src/i18n/locales/{locale}/workflow.ts`
+
+### Q: How to add a new output style?
+
+1. Create style file in `templates/common/output-styles/{locale}/`
+2. Define style configuration with name and description
+3. Add style to available options in configuration
+4. Test style rendering with sample content
+
+### Q: How to support a new language?
+
+1. Create new locale directory under `templates/{code-tool}/{new-locale}/`
+2. Copy existing templates and translate content
+3. Update i18n system to support new locale
+4. Add locale to supported languages list
+
+### Q: How to maintain template consistency?
+
+- Use template validation tests
+- Follow naming conventions
+- Maintain parallel structure across locales
+- Document template variables and usage

package/templates/claude-code/CLAUDE.md

@@ -0,0 +1,250 @@
+# Templates Module
+
+**Last Updated**: Mon Oct 27 19:39:26 CST 2025
+[Root](../CLAUDE.md) > **templates**
+
+## Module Responsibilities
+
+Template configuration module providing multilingual configuration templates, workflow templates, and AI memory templates, supporting both Chinese and English environments for comprehensive Claude Code environment setup.
+
+## Entry Points and Startup
+
+- **Main Entry Points**:
+  - `common/` - Common configuration templates
+  - `zh-CN/` - Chinese template collection
+  - `en/` - English template collection
+
+## External Interfaces
+
+### Template Structure
+
+```
+templates/
+├── common/                    # Common configuration templates
+│   ├── CLAUDE.md             # Base CLAUDE.md template
+│   └── settings.json         # Claude settings template
+├── zh-CN/                    # Chinese template collection
+│   ├── memory/               # AI memory templates
+│   └── workflow/             # Workflow templates
+└── en/                       # English template collection
+    ├── memory/               # AI memory templates
+    └── workflow/             # Workflow templates
+```
+
+### Template Category System
+
+```typescript
+// Template categories
+interface TemplateCategories {
+  memory: {
+    'mcp.md': string // MCP service guidance
+    'technical-guides.md': string // Technical implementation guides
+    'personality.md': string // AI personality configuration
+    'rules.md': string // Core programming principles
+  }
+  workflow: {
+    common: WorkflowCommands // Common tools workflow
+    plan: WorkflowCommands // Feature planning workflow
+    sixStep: WorkflowCommands // Six-step development workflow
+    bmad: WorkflowCommands // BMad enterprise workflow
+    git: WorkflowCommands // Git operation workflow
+  }
+}
+```
+
+## Key Dependencies and Configuration
+
+### Template Installation Process
+
+- Templates are copied to `~/.claude/` directory during initialization
+- Language-specific templates selected based on user configuration
+- Automatic template merging and update mechanisms
+- Template validation and consistency checking
+
+### Configuration Files
+
+- `common/settings.json` - Base Claude settings template
+- `common/CLAUDE.md` - Project guidance template
+- Language-specific memory and workflow templates
+
+## Data Models
+
+### Workflow Template Structure
+
+#### Common Tools Workflow (`common/`)
+
+- **Commands**: `init-project.md` - Project initialization command
+- **Agents**: `init-architect.md`, `get-current-datetime.md` - Core utility agents
+
+#### Feature Planning Workflow (`plan/`)
+
+- **Commands**: `feat.md` - Feature development command
+- **Agents**: `planner.md`, `ui-ux-designer.md` - Planning and design agents
+
+#### Six-Step Development Workflow (`sixStep/`)
+
+- **Commands**: `workflow.md` - Six-step development process
+- **Agents**: None - Process-oriented workflow
+
+#### BMad Enterprise Workflow (`bmad/`)
+
+- **Commands**: `bmad-init.md` - BMad initialization
+- **Agents**: Complete enterprise development team simulation
+
+#### Git Workflow (`git/`)
+
+- **Commands**: `git-commit.md`, `git-worktree.md`, `git-cleanBranches.md`, `git-rollback.md`
+- **Agents**: None - Git operation commands
+
+### Memory Template Structure
+
+#### AI Memory Templates
+
+- **mcp.md**: MCP service usage guidelines and best practices
+- **technical-guides.md**: Technical execution guidelines and standards
+- **personality.md**: AI assistant behavior and personality configuration
+- **rules.md**: Core programming principles and workflow methodology
+
+### Template Language Support
+
+#### Chinese Templates (`zh-CN/`)
+
+- Complete Chinese localization for all templates
+- Chinese AI interaction patterns
+- Chinese technical documentation standards
+- Chinese workflow descriptions
+
+#### English Templates (`en/`)
+
+- Complete English localization for all templates
+- English AI interaction patterns
+- English technical documentation standards
+- English workflow descriptions
+
+## Testing and Quality
+
+### Template Validation Strategy
+
+- **Consistency Testing**: Verify Chinese-English template correspondence
+- **Syntax Testing**: Validate markdown syntax and formatting
+- **Content Testing**: Verify template completeness and accuracy
+- **Integration Testing**: Test template installation and configuration
+
+### Quality Metrics
+
+#### ✅ Template Completeness
+
+- Chinese-English template parity: **100%**
+- Workflow category coverage: **5/5 categories**
+- Memory template coverage: **4/4 templates**
+- Command template coverage: **Complete**
+
+#### ✅ Language Support
+
+- Chinese localization: **Complete**
+- English localization: **Complete**
+- Template structure consistency: **Validated**
+- Content accuracy: **Verified**
+
+#### ✅ Installation Testing
+
+- Template copying mechanism: **Tested**
+- Language selection logic: **Verified**
+- Template merging: **Functional**
+- Update mechanism: **Working**
+
+### Test Coverage
+
+- **Template Tests**: `tests/templates/chinese-templates.test.ts`
+- **Installation Tests**: Integration tests for template deployment
+- **Validation Tests**: Template structure and content verification
+
+## FAQ
+
+### Q: How to add new workflow templates?
+
+1. Add template files in both `zh-CN/workflow/` and `en/workflow/`
+2. Update workflow configuration in `src/config/workflows.ts`
+3. Add corresponding translation keys in i18n files
+4. Test template installation and functionality
+
+### Q: How to modify AI memory templates?
+
+1. Update template files in both language directories
+2. Ensure consistency between Chinese and English versions
+3. Test AI behavior changes with modified templates
+4. Update documentation if needed
+
+### Q: How are templates installed during initialization?
+
+Templates are copied from the package to `~/.claude/` directory based on user's language selection, with smart merging to preserve existing customizations.
+
+### Q: How to maintain template version compatibility?
+
+- Use semantic versioning for major template changes
+- Provide migration guides for breaking changes
+- Maintain backward compatibility when possible
+- Test template updates with existing configurations
+
+## Related File List
+
+### Common Configuration Templates
+
+- `common/CLAUDE.md` - Base project guidance template
+- `common/settings.json` - Claude configuration template
+
+### Chinese Templates (`zh-CN/`)
+
+#### Memory Templates
+
+- `memory/mcp.md` - MCP服务使用指南
+- `memory/technical-guides.md` - 技术执行准则
+- `memory/personality.md` - AI助手个性配置
+- `memory/rules.md` - 核心编程原则
+
+#### Workflow Templates
+
+- `workflow/common/commands/init-project.md` - 项目初始化命令
+- `workflow/common/agents/init-architect.md` - 初始化架构师
+- `workflow/common/agents/get-current-datetime.md` - 时间工具
+- `workflow/plan/commands/feat.md` - 功能开发命令
+- `workflow/plan/agents/planner.md` - 规划师
+- `workflow/plan/agents/ui-ux-designer.md` - UI/UX设计师
+- `workflow/sixStep/commands/workflow.md` - 六步开发流程
+- `workflow/bmad/commands/bmad-init.md` - BMad初始化
+- `workflow/git/commands/` - Git操作命令集
+
+### English Templates (`en/`)
+
+#### Memory Templates
+
+- `memory/mcp.md` - MCP Services Usage Guide
+- `memory/technical-guides.md` - Technical Execution Guidelines
+- `memory/personality.md` - AI Assistant Personality Configuration
+- `memory/rules.md` - Core Programming Principles
+
+#### Workflow Templates
+
+- `workflow/common/commands/init-project.md` - Project initialization command
+- `workflow/common/agents/init-architect.md` - Initialization architect
+- `workflow/common/agents/get-current-datetime.md` - DateTime utility
+- `workflow/plan/commands/feat.md` - Feature development command
+- `workflow/plan/agents/planner.md` - Planner agent
+- `workflow/plan/agents/ui-ux-designer.md` - UI/UX designer
+- `workflow/sixStep/commands/workflow.md` - Six-step development workflow
+- `workflow/bmad/commands/bmad-init.md` - BMad initialization
+- `workflow/git/commands/` - Git operation commands
+
+### Test Files
+
+- `tests/templates/chinese-templates.test.ts` - Chinese template validation
+- Template integration tests distributed across test suites
+
+## Changelog
+
+### 2025-08-20
+
+- **Module Documentation Created**: Completed comprehensive documentation of templates module
+- **Template Architecture Analysis**: Detailed analysis of bilingual template structure and workflow organization
+- **Quality Assessment**: Verified complete Chinese-English template parity and coverage
+- **Template Category Documentation**: Complete recording of 5 workflow categories and 4 memory templates

package/templates/claude-code/common/settings.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "env": {
+    "DISABLE_TELEMETRY": "1",
+    "DISABLE_ERROR_REPORTING": "1",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
+    "MCP_TIMEOUT": "60000"
+  },
+  "includeCoAuthoredBy": false,
+  "permissions": {
+    "allow": [
+      "Bash",
+      "Edit",
+      "Glob",
+      "Grep",
+      "KillShell",
+      "LS",
+      "LSP",
+      "MultiEdit",
+      "NotebookEdit",
+      "NotebookRead",
+      "Read",
+      "Skill",
+      "Task",
+      "TaskCreate",
+      "TaskGet",
+      "TaskList",
+      "TaskOutput",
+      "TaskStop",
+      "TaskUpdate",
+      "TodoWrite",
+      "ToolSearch",
+      "WebFetch",
+      "WebSearch",
+      "Write",
+      "mcp__ide",
+      "mcp__exa",
+      "mcp__context7",
+      "mcp__mcp-deepwiki",
+      "mcp__Playwright",
+      "mcp__spec-workflow",
+      "mcp__open-websearch",
+      "mcp__serena"
+    ],
+    "deny": []
+  },
+  "hooks": {}
+}