spec-canon 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 philo-veritas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# SpecCanon
+
+**Spec-Driven Development 框架 —— 让 AI 始终从准确的系统全景出发**
+
+> Change specs are temporary; domain specs are canonical.
+
+---
+
+## 什么是 SpecCanon
+
+SpecCanon 是一套面向 AI Coding Agent（如 Claude Code）的 **Spec-Driven Development (SDD)** 方法论框架。
+
+核心理念：**先文档后代码，人做判断题，AI 做填空题。**
+
+SpecCanon 的本质是一个**文档状态机**：每份 Spec 文档是一个状态节点，状态转移由人触发，AI 负责生成状态内容。通过持续维护 Domain Spec 作为系统行为的单一事实来源（Single Source of Truth），让 AI 在每次开发时都拥有准确的系统全景。
+
+## 核心机制
+
+### 三层文档体系
+
+| 层级 | 文件 | 生命周期 | 职责 |
+|---|---|---|---|
+| **系统级** | `domains/README.md` | 持续更新 | 域间关系全景 |
+| **系统级** | `domains/<domain>/domain_spec.md` | 持续累积 | 系统当前行为（Canon） |
+| **Change 级** | `change-xxx/00_context~04_test_spec` | 单次生命周期 | 本次变更做了什么 |
+| **项目级** | `SKILL.md` / `AI_CHANGELOG.md` | 持续累积 | 团队学到了什么 |
+
+### 闭环演化
+
+```
+domain_spec.md（系统正典）
+      │
+      │ 新 Change 启动 → 读取系统现状
+      ▼
+  00_context → 01_requirement → 02_interface → 03_implementation → 04_test_spec
+      │
+      │ Change 完成 → 关键信息回填
+      ▼
+domain_spec.md（演化更新）
+```
+
+每次 Change 开发都从 Domain Spec 出发，完成后将变更归档回 Domain Spec，形成**知识的持续累积**。Domain Spec 越完善，后续开发的上下文越精准，AI 的产出质量越高。
+
+### 人机分工
+
+| 角色 | 职责 | 类比 |
+|---|---|---|
+| 🧑 人（研发工程师） | 决策、审阅、判断对不对 | 做判断题 |
+| 🤖 AI（Coding Agent） | 生成、补全、确保全不全 | 做填空题 |
+
+## 快速开始
+
+### 我要开始一个新项目
+→ 阅读 [guide/04_new_project_sop.md](docs/guide/04_new_project_sop.md)，然后使用 `spec-canon prompt guide` 查看决策树
+
+### 我要在已有项目中开发新需求
+→ 使用 `spec-canon prompt list --stage daily` 查看日常提示词，按 Step 0 → Step 5 顺序执行
+
+### 我要为已有项目引入 SDD
+→ 阅读 [guide/05_iterative_project_sop.md](docs/guide/05_iterative_project_sop.md) 的冷启动策略，然后使用 `spec-canon prompt list --stage iterative`
+
+## 文档结构
+
+```
+docs/
+├── SOP.md                    ← 导航索引（入口）
+├── guide/                    ← 方法论（一次性阅读）
+│   ├── 01_claude_md.md           CLAUDE.md 书写指南
+│   ├── 02_spec_overview.md       三层文档体系总览
+│   ├── 03_spec_documents.md      各文档详解
+│   ├── 04_new_project_sop.md     新项目 SOP
+│   ├── 05_iterative_project_sop.md  迭代项目 SOP
+│   └── 06_domain_splitting.md       子域分拆规则
+├── prompts/                  ← 提示词文件（CLI `spec-canon prompt` 数据源）
+├── reference/                ← 速查表（随时查阅）
+└── templates/                ← Spec 模板（7 个）
+```
+
+## 为什么叫 SpecCanon
+
+**Canon**（正典）——在 SpecCanon 体系中，`domain_spec.md` 是系统行为的权威来源。每次变更开发完成后，关键信息回填到 Domain Spec，使其成为持续演化的系统正典。
+
+- **Spec** 驱动每一次变更
+- **Canon** 保存系统的真相
+
+> Specs drive change; Canon preserves the system.
+
+## 许可证
+
+MIT

package/bin/spec-canon.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerInitCommand(program: Command): void;

package/dist/commands/init.js

@@ -0,0 +1,97 @@
+import { join, resolve } from 'node:path';
+import { loadTemplate, SPEC_TEMPLATES } from '../templates/index.js';
+import { ensureDir, fileExists, writeFileSafe, } from '../utils/fs.js';
+import { logger } from '../utils/logger.js';
+const SDD_ROOT = 'spec-canon';
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('初始化 SDD 文档结构')
+        .option('-d, --dir <path>', '目标项目目录', process.cwd())
+        .option('--domain <name>', '同时创建初始业务域')
+        .option('--force', '覆盖已存在的 spec-canon 目录', false)
+        .action(async (opts) => {
+        await runInit(opts);
+    });
+}
+async function runInit(opts) {
+    const targetDir = resolve(opts.dir);
+    const sddDir = join(targetDir, SDD_ROOT);
+    // 检查是否已存在
+    if (!opts.force && (await fileExists(sddDir))) {
+        logger.error(`${SDD_ROOT}/ 目录已存在于 ${targetDir}`);
+        logger.info('使用 --force 覆盖已有结构');
+        process.exitCode = 1;
+        return;
+    }
+    logger.info(`初始化 SDD 文档结构到 ${targetDir}`);
+    logger.blank();
+    const created = [];
+    // 1. 创建目录树
+    const dirs = [
+        join(sddDir, 'domains'),
+        join(sddDir, 'changes'),
+        join(sddDir, 'decisions'),
+        join(sddDir, 'skills'),
+        join(sddDir, 'templates'),
+    ];
+    for (const dir of dirs) {
+        await ensureDir(dir);
+    }
+    // 2. 写入 .gitkeep
+    await writeFileSafe(join(sddDir, 'changes', '.gitkeep'), '');
+    created.push(`${SDD_ROOT}/changes/.gitkeep`);
+    // 3. 写入 7 个 Spec 模板
+    for (const name of SPEC_TEMPLATES) {
+        const content = await loadTemplate(name);
+        await writeFileSafe(join(sddDir, 'templates', name), content);
+        created.push(`${SDD_ROOT}/templates/${name}`);
+    }
+    // 4. 写入 AI_CHANGELOG.md
+    const changelogContent = await loadTemplate('AI_CHANGELOG.md');
+    await writeFileSafe(join(sddDir, 'decisions', 'AI_CHANGELOG.md'), changelogContent);
+    created.push(`${SDD_ROOT}/decisions/AI_CHANGELOG.md`);
+    // 5. 写入 SKILL.md
+    const skillContent = await loadTemplate('skill.md');
+    await writeFileSafe(join(sddDir, 'skills', 'SKILL.md'), skillContent);
+    created.push(`${SDD_ROOT}/skills/SKILL.md`);
+    // 6. 写入 domains/README.md
+    const domainsReadme = await loadTemplate('domains-readme.md');
+    await writeFileSafe(join(sddDir, 'domains', 'README.md'), domainsReadme);
+    created.push(`${SDD_ROOT}/domains/README.md`);
+    // 7. 处理 CLAUDE.md
+    const claudeMdPath = join(targetDir, 'CLAUDE.md');
+    const sddSection = await loadTemplate('claude-md-section.md');
+    if (await fileExists(claudeMdPath)) {
+        logger.warn('CLAUDE.md 已存在，请手动将以下 SDD 协议段添加到文件中：');
+        logger.blank();
+        logger.dim('─'.repeat(60));
+        console.log(sddSection);
+        logger.dim('─'.repeat(60));
+        logger.blank();
+    }
+    else {
+        const claudeMdContent = `# 项目：[项目名称]\n[一句话描述项目做什么]\n\n## 技术栈\n- [语言/框架/数据库/中间件]\n\n${sddSection}`;
+        await writeFileSafe(claudeMdPath, claudeMdContent);
+        created.push('CLAUDE.md');
+        logger.success('已创建 CLAUDE.md（含 SDD 协议段）');
+    }
+    // 8. 处理 --domain
+    if (opts.domain) {
+        const domainDir = join(sddDir, 'domains', opts.domain);
+        await ensureDir(domainDir);
+        const domainSpecContent = await loadTemplate('domain_spec.md');
+        await writeFileSafe(join(domainDir, 'domain_spec.md'), domainSpecContent);
+        created.push(`${SDD_ROOT}/domains/${opts.domain}/domain_spec.md`);
+        logger.success(`已创建业务域: ${opts.domain}`);
+    }
+    // 9. 输出摘要
+    logger.blank();
+    logger.success(`SDD 初始化完成！共创建 ${created.length} 个文件：`);
+    logger.blank();
+    for (const file of created) {
+        logger.dim(`  ${file}`);
+    }
+    logger.blank();
+    logger.info('下一步：编辑 CLAUDE.md 填写项目信息，然后开始你的第一个变更');
+}

package/dist/commands/prompt.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerPromptCommand(program: Command): void;

package/dist/commands/prompt.js

@@ -0,0 +1,145 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { findPrompt, getPromptsDir, listPrompts, loadPromptContent, } from '../prompts/catalog.js';
+import { renderPrompt } from '../prompts/renderer.js';
+import { logger } from '../utils/logger.js';
+const STAGE_LABELS = {
+    daily: '日常开发 (daily)',
+    'new-project': '新项目 (new-project)',
+    iterative: '迭代项目冷启动 (iterative)',
+};
+const STAGE_ORDER = ['daily', 'new-project', 'iterative'];
+export function registerPromptCommand(program) {
+    const prompt = program
+        .command('prompt')
+        .description('输出 SDD 提示词');
+    prompt
+        .command('list')
+        .description('列出所有可用提示词')
+        .option('-s, --stage <stage>', '按阶段筛选 (daily / new-project / iterative)')
+        .action(async (opts) => {
+        await runList(opts.stage);
+    });
+    prompt
+        .command('show <id>')
+        .description('输出指定提示词')
+        .option('-c, --change <name>', '变更目录名（替换 {{CHANGE}}）')
+        .option('-d, --domain <name>', '业务域名称（替换 {{DOMAIN}}）')
+        .option('-m, --module <path>', '目标模块路径（替换 {{MODULE}}）')
+        .option('-p, --prd <content>', 'PRD 内容/文件引用（替换 {{PRD}}）')
+        .option('--raw', '输出原始模板（不替换变量）', false)
+        .action(async (id, opts) => {
+        await runShow(id, opts);
+    });
+    prompt
+        .command('guide')
+        .description('显示决策树指南')
+        .action(async () => {
+        await runGuide();
+    });
+}
+async function runList(stage) {
+    const prompts = await listPrompts(stage);
+    if (prompts.length === 0) {
+        if (stage) {
+            logger.error(`未找到阶段 "${stage}" 的提示词`);
+            logger.info(`可用阶段: ${STAGE_ORDER.join(', ')}`);
+        }
+        else {
+            logger.error('未找到任何提示词');
+        }
+        process.exitCode = 1;
+        return;
+    }
+    if (stage) {
+        // 单阶段输出
+        printStageGroup(stage, prompts);
+    }
+    else {
+        // 按阶段分组输出
+        const grouped = groupByStage(prompts);
+        let first = true;
+        for (const s of STAGE_ORDER) {
+            const entries = grouped.get(s);
+            if (!entries || entries.length === 0)
+                continue;
+            if (!first)
+                console.log();
+            printStageGroup(s, entries);
+            first = false;
+        }
+    }
+}
+function printStageGroup(stage, entries) {
+    const label = STAGE_LABELS[stage] ?? stage;
+    console.log(label);
+    for (const entry of entries) {
+        const vars = entry.variables.length > 0
+            ? `  [${entry.variables.join(', ')}]`
+            : '';
+        const aliases = entry.aliases && entry.aliases.length > 0
+            ? ` (${entry.aliases.join(', ')})`
+            : '';
+        console.log(`  ${entry.id.padEnd(16)} ${entry.name}${aliases}${vars}`);
+    }
+}
+function groupByStage(prompts) {
+    const map = new Map();
+    for (const p of prompts) {
+        const list = map.get(p.stage) ?? [];
+        list.push(p);
+        map.set(p.stage, list);
+    }
+    return map;
+}
+async function runShow(id, opts) {
+    const entry = await findPrompt(id);
+    if (!entry) {
+        logger.error(`未找到提示词: ${id}`);
+        logger.info('使用 "spec-canon prompt list" 查看所有可用提示词');
+        process.exitCode = 1;
+        return;
+    }
+    const template = await loadPromptContent(entry);
+    if (opts.raw) {
+        process.stdout.write(template);
+        return;
+    }
+    const variables = {};
+    if (opts.change)
+        variables['CHANGE'] = opts.change;
+    if (opts.domain)
+        variables['DOMAIN'] = opts.domain;
+    if (opts.module)
+        variables['MODULE'] = opts.module;
+    if (opts.prd)
+        variables['PRD'] = opts.prd;
+    const { text, unreplaced } = renderPrompt(template, variables);
+    // 提示词 → stdout
+    process.stdout.write(text);
+    // ctx 提示词缺少 -d/-m 时的专属提示 → stderr
+    if (entry.id === 'ctx' && !opts.domain && !opts.module) {
+        console.error();
+        console.error('⚠ ctx 提示词需要指定 -d（从 domain_spec）或 -m（从代码库）');
+    }
+    // 未替换变量警告 → stderr
+    if (unreplaced.length > 0) {
+        const varOpts = {
+            CHANGE: '-c, --change',
+            DOMAIN: '-d, --domain',
+            MODULE: '-m, --module',
+            PRD: '-p, --prd',
+        };
+        console.error();
+        console.error("--------------------------------");
+        for (const v of unreplaced) {
+            const opt = varOpts[v] ?? `--${v.toLowerCase()}`;
+            console.error(`⚠ 变量 {{${v}}} 未替换，使用 ${opt} 指定`);
+        }
+    }
+}
+async function runGuide() {
+    const guidePath = join(getPromptsDir(), 'guide.md');
+    const content = await readFile(guidePath, 'utf-8');
+    process.stdout.write(content);
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { registerInitCommand } from './commands/init.js';
+import { registerPromptCommand } from './commands/prompt.js';
+const program = new Command();
+program
+    .name('spec-canon')
+    .description('CLI toolkit for Spec-Driven Development (SDD)')
+    .version('0.1.0');
+registerInitCommand(program);
+registerPromptCommand(program);
+program.parse();

package/dist/prompts/catalog.d.ts

@@ -0,0 +1,20 @@
+export interface PromptEntry {
+    id: string;
+    aliases?: string[];
+    name: string;
+    file: string;
+    stage: string;
+    step: string;
+    description: string;
+    variables: string[];
+    tags: string[];
+}
+interface CatalogData {
+    prompts: PromptEntry[];
+}
+export declare function loadCatalog(): Promise<CatalogData>;
+export declare function findPrompt(id: string): Promise<PromptEntry | undefined>;
+export declare function listPrompts(stage?: string): Promise<PromptEntry[]>;
+export declare function loadPromptContent(entry: PromptEntry): Promise<string>;
+export declare function getPromptsDir(): string;
+export {};

package/dist/prompts/catalog.js

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROMPTS_DIR = resolve(__dirname, '../../templates/prompts');
+let cachedCatalog = null;
+export async function loadCatalog() {
+    if (cachedCatalog)
+        return cachedCatalog;
+    const catalogPath = join(PROMPTS_DIR, 'catalog.json');
+    const raw = await readFile(catalogPath, 'utf-8');
+    cachedCatalog = JSON.parse(raw);
+    return cachedCatalog;
+}
+export async function findPrompt(id) {
+    const catalog = await loadCatalog();
+    return catalog.prompts.find((p) => p.id === id || p.aliases?.includes(id));
+}
+export async function listPrompts(stage) {
+    const catalog = await loadCatalog();
+    if (!stage)
+        return catalog.prompts;
+    return catalog.prompts.filter((p) => p.stage === stage);
+}
+export async function loadPromptContent(entry) {
+    const filePath = join(PROMPTS_DIR, entry.file);
+    return readFile(filePath, 'utf-8');
+}
+export function getPromptsDir() {
+    return PROMPTS_DIR;
+}

package/dist/prompts/renderer.d.ts

@@ -0,0 +1,5 @@
+export interface RenderResult {
+    text: string;
+    unreplaced: string[];
+}
+export declare function renderPrompt(template: string, variables: Record<string, string>): RenderResult;

package/dist/prompts/renderer.js

@@ -0,0 +1,21 @@
+const IF_BLOCK = /\{\{#if\s+([A-Z_]+)\}\}([\s\S]*?)\{\{\/if\}\}/g;
+const VAR_PATTERN = /\{\{([A-Z_]+)\}\}/g;
+export function renderPrompt(template, variables) {
+    // 1. 处理条件块：保留已提供变量的块内容，移除未提供的
+    const afterBlocks = template
+        .replace(IF_BLOCK, (_match, name, body) => {
+        return name in variables ? body : '';
+    })
+        .replace(/\n{3,}/g, '\n\n') // 压缩连续空行
+        .trim();
+    // 2. 替换剩余的 {{VAR}}
+    const unreplaced = [];
+    const text = afterBlocks.replace(VAR_PATTERN, (match, name) => {
+        if (name in variables) {
+            return variables[name];
+        }
+        unreplaced.push(name);
+        return match;
+    });
+    return { text, unreplaced: [...new Set(unreplaced)] };
+}

package/dist/templates/index.d.ts

@@ -0,0 +1,6 @@
+export declare function loadTemplate(name: string): Promise<string>;
+/** 7 个 Change Spec 模板 */
+export declare const SPEC_TEMPLATES: readonly ["00_context.md", "01_requirement.md", "02_interface.md", "03_implementation.md", "04_test_spec.md", "domain_spec.md", "AI_CHANGELOG.md"];
+/** CLI 独有模板 */
+export declare const CLI_TEMPLATES: readonly ["claude-md-section.md", "domains-readme.md", "skill.md"];
+export declare function loadAllSpecTemplates(): Promise<Map<string, string>>;

package/dist/templates/index.js

@@ -0,0 +1,32 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = resolve(__dirname, '../../templates');
+export async function loadTemplate(name) {
+    const filePath = join(TEMPLATES_DIR, name);
+    return readFile(filePath, 'utf-8');
+}
+/** 7 个 Change Spec 模板 */
+export const SPEC_TEMPLATES = [
+    '00_context.md',
+    '01_requirement.md',
+    '02_interface.md',
+    '03_implementation.md',
+    '04_test_spec.md',
+    'domain_spec.md',
+    'AI_CHANGELOG.md',
+];
+/** CLI 独有模板 */
+export const CLI_TEMPLATES = [
+    'claude-md-section.md',
+    'domains-readme.md',
+    'skill.md',
+];
+export async function loadAllSpecTemplates() {
+    const map = new Map();
+    for (const name of SPEC_TEMPLATES) {
+        map.set(name, await loadTemplate(name));
+    }
+    return map;
+}

package/dist/utils/fs.d.ts

@@ -0,0 +1,5 @@
+export declare function ensureDir(dirPath: string): Promise<void>;
+export declare function fileExists(filePath: string): Promise<boolean>;
+export declare function writeFileIfNotExists(filePath: string, content: string): Promise<boolean>;
+export declare function writeFileSafe(filePath: string, content: string): Promise<void>;
+export declare function readFileSafe(filePath: string): Promise<string>;

package/dist/utils/fs.js

@@ -0,0 +1,29 @@
+import { mkdir, writeFile, access, readFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+export async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function writeFileIfNotExists(filePath, content) {
+    if (await fileExists(filePath)) {
+        return false;
+    }
+    await ensureDir(dirname(filePath));
+    await writeFile(filePath, content, 'utf-8');
+    return true;
+}
+export async function writeFileSafe(filePath, content) {
+    await ensureDir(dirname(filePath));
+    await writeFile(filePath, content, 'utf-8');
+}
+export async function readFileSafe(filePath) {
+    return readFile(filePath, 'utf-8');
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+export declare const logger: {
+    success(msg: string): void;
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    dim(msg: string): void;
+    blank(): void;
+};

package/dist/utils/logger.js

@@ -0,0 +1,26 @@
+const RESET = '\x1b[0m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const RED = '\x1b[31m';
+const CYAN = '\x1b[36m';
+const DIM = '\x1b[2m';
+export const logger = {
+    success(msg) {
+        console.log(`${GREEN}✔${RESET} ${msg}`);
+    },
+    info(msg) {
+        console.log(`${CYAN}ℹ${RESET} ${msg}`);
+    },
+    warn(msg) {
+        console.log(`${YELLOW}⚠${RESET} ${msg}`);
+    },
+    error(msg) {
+        console.error(`${RED}✖${RESET} ${msg}`);
+    },
+    dim(msg) {
+        console.log(`${DIM}${msg}${RESET}`);
+    },
+    blank() {
+        console.log();
+    },
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "spec-canon",
+  "version": "0.1.0",
+  "description": "CLI toolkit for Spec-Driven Development (SDD)",
+  "type": "module",
+  "license": "MIT",
+  "author": "philo-veritas",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/philo-veritas/spec-canon.git"
+  },
+  "homepage": "https://github.com/philo-veritas/spec-canon#readme",
+  "bugs": {
+    "url": "https://github.com/philo-veritas/spec-canon/issues"
+  },
+  "keywords": [
+    "sdd",
+    "spec-driven-development",
+    "cli",
+    "ai-coding",
+    "documentation",
+    "spec"
+  ],
+  "bin": {
+    "spec-canon": "./bin/spec-canon.mjs"
+  },
+  "scripts": {
+    "prebuild": "node scripts/sync-templates.mjs",
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "templates/"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "commander": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}