create-done-coding 0.12.3-alpha.0 → 0.13.1-alpha.0

package/es/index.mjs

@@ -1,18 +1,28 @@
 #!/usr/bin/env node
-import { F as s, G as t, S as d, e as c, a as p, b as u, h as l, d as b, i as f } from "./index-b3017a49.js";
+import { C as p, F as c, G as l, L as C, S as d, k as u, f as T, a as f, e as E, h as L, g as P, j as I, i as A, p as F, b as R, d as b, r as g } from "./index-42cea2ea.js";
 import "@done-coding/cli-utils";
-import "node:fs";
+import "node:os";
 import "node:path";
+import "node:crypto";
+import "node:fs";
 import "@done-coding/cli-template";
 import "@done-coding/cli-git";
 export {
-  s as FormNameEnum,
-  t as GitRemoteRepoAliasNameEnum,
+  p as CreateTemplateSourceTypeEnum,
+  c as FormNameEnum,
+  l as GitRemoteRepoAliasNameEnum,
+  C as LOCAL_POINTER_CONFIG_RELATIVE_PATH,
   d as SubcommandEnum,
-  c as commandCliInfo,
-  p as createAsSubcommand,
-  u as createCommandCliInfo,
-  l as createHandler,
-  b as handler,
-  f as injectInfo
+  u as commandCliInfo,
+  T as completeCreateProject,
+  f as createAsSubcommand,
+  E as createCommandCliInfo,
+  L as createHandler,
+  P as getLocalPointerConfigPath,
+  I as handler,
+  A as injectInfo,
+  F as prepareCreateProject,
+  R as readTemplateListFromFile,
+  b as readTemplateListResource,
+  g as resolveTemplateConfigPath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-done-coding",
-  "version": "0.12.3-alpha.0",
+  "version": "0.13.1-alpha.0",
   "description": "项目创建命令行工具",
   "module": "es/index.mjs",
   "type": "module",
@@ -22,6 +22,8 @@
   "scripts": {
     "dev": "vite build -w -m hotBuild",
     "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepack": "pnpm build"
   },
   "repository": {
@@ -37,20 +39,21 @@
   "license": "MIT",
   "sideEffects": false,
   "devDependencies": {
-    "@done-coding/cli-inject": "0.6.3-alpha.0",
+    "@done-coding/cli-inject": "0.6.4-alpha.0",
     "@types/node": "^18.0.0",
     "@types/yargs": "^17.0.28",
     "typescript": "^5.8.3",
     "vite": "^4.4.11",
-    "vite-plugin-dts": "^3.6.0"
+    "vite-plugin-dts": "^3.6.0",
+    "vitest": "^1.6.1"
   },
   "dependencies": {
-    "@done-coding/cli-git": "0.7.3-alpha.0",
-    "@done-coding/cli-template": "0.9.3-alpha.0",
-    "@done-coding/cli-utils": "0.9.3-alpha.0"
+    "@done-coding/cli-git": "0.7.4-alpha.0",
+    "@done-coding/cli-template": "0.10.1-alpha.0",
+    "@done-coding/cli-utils": "0.10.1-alpha.0"
   },
   "engines": {
     "node": ">=18.0.0"
   },
-  "gitHead": "1d0c93a5b93d65a8c01652b576c9c6991abf4c8c"
+  "gitHead": "5a3ce40184afb4503b47b52e261eb2d3b4ee40ce"
 }

package/types/index.d.ts

@@ -1,30 +1,88 @@
 import { CliHandlerArgv } from '@done-coding/cli-utils';
 import { CliInfo } from '@done-coding/cli-utils';
 import { CommandModule } from 'yargs';
+import type { HandlerContextInit } from '@done-coding/cli-utils';
 import type { SubCliInfo } from '@done-coding/cli-utils';
 
+/** create 包根命令配置 */
 export declare const commandCliInfo: Omit<CliInfo, "usage">;
 
+/** 完成创建项目：使用 prepare 阶段草稿和模板参数完成编译、git 初始化与目录落位 */
+export declare const completeCreateProject: (argv: CliHandlerArgv<CreateCompleteOptions>, ctxInit?: HandlerContextInit) => Promise<{
+    success: boolean;
+    projectPath: string;
+    draftId: string;
+    message: string;
+}>;
+
 /** 作为子命令创建 */
 export declare const createAsSubcommand: () => CommandModule<{}, {}>;
 
+/** create 子命令配置 */
 export declare const createCommandCliInfo: SubCliInfo;
 
+/** create complete 入参 */
+export declare interface CreateCompleteOptions extends CreateOptions {
+    /** prepare 阶段返回的草稿 ID */
+    draftId: string;
+    /** 模板预置问题答案 */
+    envData?: Record<string, any>;
+}
+
+/** create 包配置文件结构 */
 export declare interface CreateConfigJson {
+    /** 可选模板列表 */
     templateList: CreateTemplateChoiceItem[];
 }
 
-export declare const createHandler: (argv: CliHandlerArgv<CreateOptions>) => Promise<undefined>;
+/** create 命令 handler：交互模式保持原 CLI 流程，非交互模式走 prepare/complete 协议 */
+export declare const createHandler: (argv: CliHandlerArgv<CreateOptions>, ctxInit?: HandlerContextInit) => Promise<{
+    default?: string | undefined;
+    key: string;
+    required: boolean;
+}[] | {
+    success: boolean;
+    projectPath: string;
+    draftId: string;
+    message: string;
+} | undefined>;
 
+/** 创建项目命令参数 */
 export declare interface CreateOptions {
+    /** 创建项目的根目录 */
+    rootDir?: string;
     /** 项目名称 */
     [FormNameEnum.PROJECT_NAME]?: string;
     /** 是否仅仅(从done-coding系列项目列表中)克隆远程仓库 */
     justCloneFromDoneCoding?: boolean;
-    /** 模板仓库地址 */
+    /** 模板地址，远程 git 地址或本地绝对路径 */
+    [FormNameEnum.TEMPLATE_URL]?: string;
+    /** 模板仓库地址 @deprecated 使用 templateUrl */
     [FormNameEnum.TEMPLATE_GIT_PATH]?: string;
     /** 模板仓库分支 -- 不传则是默认分支 */
     [FormNameEnum.TEMPLATE_GIT_BRANCH]?: string;
+    /** 仓库内模板目录 */
+    templateDirectory?: string;
+    /**
+     * 模板列表配置文件路径（本地）
+     * ---
+     * 指向一个 `{ templateList: [...] }` 配置文件。优先级：本选项 > home 指针文件
+     * (`~/.done-coding/create/index.json`) > 内置远端配置。
+     * MCP 列表工具下为必填；CLI 选填（不传则回落 home 指针 / 内置远端）。
+     */
+    templateConfig?: string;
+    /**
+     * 模板预设答案(JSON 字符串)，非交互供答。
+     * ---
+     * 如 `--env '{"organization":"acme","name":"app"}'`。key 对齐模板
+     * `.done-coding/template.json` 的 `collectEnvDataForm[].key`（不是 label）。
+     * 与 `envFile` 同时给出时，本字段浅覆盖 `envFile`。
+     */
+    env?: string;
+    /** 模板预设答案 JSON 文件路径(非交互供答)，内容为 `{ key: value }` 对象 */
+    envFile?: string;
+    /** 仅打印该模板预设问题清单(JSON)到 stdout，不创建项目、不留草稿 */
+    listQuestions?: boolean;
     /** 是否跳过模板编译(不跳过则会在克隆完成后进行模板编译)
      * --
      * 为MCP模式预留 设置为true则不会进行模板编译
@@ -54,6 +112,27 @@ export declare interface CreateOptions {
     [FormNameEnum.GIT_COMMIT_MESSAGE]?: string;
 }
 
+/** create prepare 返回的模板预置问题 */
+export declare interface CreatePrepareQuestion {
+    key: string;
+    label: string;
+    initial?: string;
+}
+
+/** create prepare 结果 */
+export declare type CreatePrepareResult = {
+    status: "ready";
+    draftId: string;
+    projectPath: string;
+    draftProjectPath: string;
+} | {
+    status: "need_input";
+    draftId: string;
+    projectPath: string;
+    draftProjectPath: string;
+    questions: CreatePrepareQuestion[];
+};
+
 /** 创建模板-分支信息 */
 export declare interface CreateTemplateBranchInfo {
     /** 分支名 */
@@ -66,8 +145,10 @@ export declare interface CreateTemplateBranchInfo {
 export declare interface CreateTemplateChoiceItem {
     /** 模板名 */
     name: string;
-    /** 仓库地址 */
+    /** 模板 git 仓库地址，远程 git 地址或本地 git 仓库根路径 */
     url?: string;
+    /** 仓库内模板目录 */
+    directory?: string;
     /** 描述 */
     description?: string;
     /** 目标分支 */
@@ -76,6 +157,24 @@ export declare interface CreateTemplateChoiceItem {
     instances?: string[];
 }
 
+/** create-mcp「模板列表资源」读取结果的载荷结构 */
+export declare interface CreateTemplateListResource {
+    /** 固定为 "local"：本资源只读本地、不联网、不读全局/远程 */
+    source: "local";
+    /** 解析所用的本地配置文件绝对路径 */
+    configPath: string;
+    /** 模板列表（缺失/非数组/解析失败 → 空数组） */
+    templateList: CreateTemplateChoiceItem[];
+}
+
+/** 创建模板来源类型 */
+export declare enum CreateTemplateSourceTypeEnum {
+    /** git 仓库模板 */
+    GIT = "git",
+    /** 本地目录模板 */
+    LOCAL = "local"
+}
+
 /** 表单name枚举 */
 export declare enum FormNameEnum {
     /** 项目名称选择 */
@@ -98,16 +197,17 @@ export declare enum FormNameEnum {
     CUSTOM_GIT_URL_INPUT = "customUrl",
     /** git的提交信息 */
     GIT_COMMIT_MESSAGE = "gitCommitMessage",
-    /**
-     *  模板仓库地址
-     * ----
-     * 为mcp拓展所加
-     */
+    /** 模板地址 */
+    TEMPLATE_URL = "templateUrl",
+    /** 模板仓库地址 @deprecated 使用 TEMPLATE_URL */
     TEMPLATE_GIT_PATH = "templateGitPath",
     /** 模板仓库分支 */
     TEMPLATE_GIT_BRANCH = "templateGitBranch"
 }
 
+/** 本机指针配置文件绝对路径 */
+export declare const getLocalPointerConfigPath: () => string;
+
 /** 远程仓库别名枚举 */
 export declare enum GitRemoteRepoAliasNameEnum {
     /** 默认 */
@@ -116,11 +216,21 @@ export declare enum GitRemoteRepoAliasNameEnum {
     UPSTREAM = "upstream"
 }
 
-export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any>) => Promise<undefined>;
+/** create 包根 handler */
+export declare const handler: (command: SubcommandEnum, argv: CliHandlerArgv<any>) => Promise<{
+    default?: string | undefined;
+    key: string;
+    required: boolean;
+}[] | {
+    success: boolean;
+    projectPath: string;
+    draftId: string;
+    message: string;
+} | undefined>;
 
 export declare const injectInfo: {
     "name": "create-done-coding",
-    "version": "0.12.3-alpha.0",
+    "version": "0.13.1-alpha.0",
     "description": "项目创建命令行工具",
     "bin": {
         "create-done-coding": "es/cli.mjs"
@@ -131,7 +241,45 @@ export declare const injectInfo: {
     }
 };
 
+/**
+ * 本机【指针】配置文件相对 home 的路径。
+ * ---
+ * 该文件内容是一个【指针】：`{ "configPath": "/abs/真正的配置文件.json" }`，
+ * 指向真正的模板配置文件（`{ templateList: [...] }` = CreateConfigJson）。
+ * 不做多文件合并——用户若需合并，自行维护一份合并好的配置文件并在此指向它。
+ */
+export declare const LOCAL_POINTER_CONFIG_RELATIVE_PATH = ".done-coding/create/index.json";
+
+/** 准备创建项目：非交互模式下克隆模板、读取模板预置问题并返回草稿信息 */
+export declare const prepareCreateProject: (argv: CliHandlerArgv<CreateOptions>, ctxInit?: HandlerContextInit) => Promise<CreatePrepareResult>;
+
+/**
+ * 从指定【本地】配置文件读取模板列表。
+ * ---
+ * 不依赖网络。文件不存在 / 非数组 / 解析失败 → 返回 `[]` 并告警，绝不抛错阻塞。
+ */
+export declare const readTemplateListFromFile: (configPath: string) => Promise<CreateTemplateChoiceItem[]>;
+
+/**
+ * create-mcp「模板列表资源」的纯读取逻辑。
+ * ---
+ * 只调 `readTemplateListFromFile`（本地、不联网、不读家目录全局指针、不读远程默认）。
+ * `configPath` 缺失/为空 → 抛错（不静默联网、不回落）。供 MCP 资源回调与单测复用。
+ */
+export declare const readTemplateListResource: (configPath: string) => Promise<CreateTemplateListResource>;
+
+/**
+ * 解析"模板配置文件路径"。
+ * ---
+ * 优先级：显式传入(CLI `--template-config` / MCP `configPath`) > home 指针文件。
+ * 都没有 → 返回 undefined（由调用方回落到内置远端配置）。
+ * 不依赖网络；读取失败一律忽略，不抛错阻塞。
+ */
+export declare const resolveTemplateConfigPath: (explicitConfigPath?: string) => Promise<string | undefined>;
+
+/** create 包子命令枚举 */
 export declare enum SubcommandEnum {
+    /** 创建项目命令 */
     CREATE = "create"
 }