@intra-mart/accel 0.1.0 → 0.2.0-dev.202605271647

package/README.md

@@ -6,7 +6,11 @@ intra-mart Accel Platform (iAP) 開発プロジェクトの作成・管理を行
 
 ## 必要環境
 
-- [Bun](https://bun.sh/) v1.0+
+- 以下のいずれかのパッケージマネージャ（`--package-manager` で選択、デフォルト: Bun）
+  - [Bun](https://bun.sh/) v1.0+
+  - [npm](https://www.npmjs.com/)
+  - [Yarn](https://classic.yarnpkg.com/) (classic v1)
+  - [pnpm](https://pnpm.io/)
 - Git（`--no-git-init` を指定しない場合）
 
 ## インストール
@@ -58,6 +62,7 @@ accel init my-project \
 | `--database` | string | データベース種別（`postgresql`, `oracle`, `sqlserver`） | `postgresql` |
 | `--javascript` | boolean | TypeScriptの代わりにJavaScriptを使用 | `false` |
 | `--juggling-project` | string | IM-Jugglingプロジェクトパス | - |
+| `--package-manager` | string | パッケージマネージャ（`bun`, `npm`, `yarn`, `pnpm`）。対話には現れず、CLIオプションでのみ指定可能 | `bun` |
 | `--non-interactive` | boolean | 非対話モード（このモードでは `project-name` が必須） | `false` |
 | `--no-git-init` | boolean | git initをスキップ | `false`（git initする） |
 | `--skip-install` | boolean | 依存インストールをスキップ | `false` |
@@ -75,7 +80,9 @@ accel attach --non-interactive
 - ディレクトリを新規作成せず、カレントディレクトリを使用
 - git initは行わない
 - プロジェクト名のデフォルトはカレントディレクトリ名
-- **既存ファイルがある配備先はスキップ**（上書きしない）。スキップされたファイルは `hashsum.txt` および `deployedAssets` に記録されないため、`detach` の対象外となる
+- **既存ファイルがある配備先はファイル単位で上書き確認**を行う。対話モードでは1ファイルごとに「Yes / No / All (以降全て上書き) / Skip-all (以降全てスキップ)」を選択。`--overwrite` 指定時は確認なしで全て上書き。非対話モードかつ `--overwrite` 未指定の場合は全てスキップ
+  - 上書きされたファイルは `hashsum.txt` および `deployedAssets` に記録される（`detach` の対象になる）
+  - スキップされたファイルは記録されない（`detach` の対象外）
 
 #### オプション一覧
 
@@ -91,6 +98,8 @@ accel attach --non-interactive
 | `--database` | string | データベース種別（`postgresql`, `oracle`, `sqlserver`） | `postgresql` |
 | `--javascript` | boolean | TypeScriptの代わりにJavaScriptを使用 | `false` |
 | `--juggling-project` | string | IM-Jugglingプロジェクトパス | - |
+| `--package-manager` | string | パッケージマネージャ（`bun`, `npm`, `yarn`, `pnpm`）。対話には現れず、CLIオプションでのみ指定可能 | `bun` |
+| `--overwrite` | boolean | 既存ファイルの上書き確認を行わず、全て上書きする | `false`（対話で確認 / 非対話ではスキップ） |
 | `--non-interactive` | boolean | 非対話モード | `false` |
 | `--skip-install` | boolean | 依存インストールをスキップ | `false` |
 

package/dist/asset/deployer.d.ts

@@ -1,14 +1,27 @@
 import type { AssetProvider, AccelSettings, HashsumEntry } from "../core/types.js";
+export type OverwriteDecision = "overwrite" | "skip";
+export type ExistingFileHandler = (relativePath: string) => Promise<OverwriteDecision>;
+export type ProgressCallbacks = {
+    onFetchStart?: () => void;
+    onSectionDeploy?: (section: string, files: string[]) => void;
+    onInstallStart?: (command: string) => void;
+    onBuildStart?: (command: string) => void;
+};
 export type DeployOptions = {
     projectDir: string;
     settings: AccelSettings;
     provider: AssetProvider;
     noInstall: boolean;
     skipExistingFiles?: boolean;
+    onExistingFile?: ExistingFileHandler;
+    progress?: ProgressCallbacks;
 };
 export type DeployResult = {
     deployedFiles: string[];
     hashEntries: HashsumEntry[];
     skippedFiles: string[];
+    overwrittenFiles: string[];
 };
+export declare const getInstallCmds: (packageManager: string) => string[];
+export declare const ROOT_SECTION = "(root)";
 export declare const deployAssets: (options: DeployOptions) => Promise<DeployResult>;

package/dist/asset/deployer.js

@@ -1,5 +1,5 @@
 import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
-import { join, dirname } from "node:path";
+import { join, dirname, resolve, sep } from "node:path";
 import { labelToSemver } from "../core/version-map.js";
 import { walkAssetRepo } from "./walker.js";
 import { processMarkdown } from "../markdown/processor.js";
@@ -16,14 +16,46 @@ const fileExists = async (path) => {
         return false;
     }
 };
+const isWithinDir = (parentDir, candidate) => {
+    const parent = resolve(parentDir);
+    const target = resolve(candidate);
+    if (target === parent)
+        return true;
+    const prefix = parent.endsWith(sep) ? parent : parent + sep;
+    return target.startsWith(prefix);
+};
+export const getInstallCmds = (packageManager) => {
+    switch (packageManager) {
+        case "npm":
+            return ["npm ci", "npm run build"];
+        case "yarn":
+            return ["yarn install --frozen-lockfile", "yarn run build"];
+        case "pnpm":
+            return ["pnpm install --frozen-lockfile", "pnpm run build"];
+        case "bun":
+        default:
+            return ["bun ci", "bun run build"];
+    }
+};
 const collectReplacements = (entry) => {
     if (!entry.meta?.replacements)
         return [];
     return entry.meta.replacements;
 };
+export const ROOT_SECTION = "(root)";
+const sectionOf = (relativePath) => {
+    const idx = relativePath.indexOf("/");
+    return idx === -1 ? ROOT_SECTION : relativePath.slice(0, idx) + "/";
+};
+const fileLabelOf = (relativePath, section) => {
+    if (section === ROOT_SECTION)
+        return relativePath;
+    return relativePath.slice(section.length);
+};
 export const deployAssets = async (options) => {
-    const { projectDir, settings, provider, noInstall, skipExistingFiles } = options;
+    const { projectDir, settings, provider, noInstall, skipExistingFiles, onExistingFile, progress, } = options;
     try {
+        progress?.onFetchStart?.();
         const repoDir = await provider.fetch();
         const semver = labelToSemver(settings.accelplatformVersion);
         const context = {
@@ -38,19 +70,52 @@ export const deployAssets = async (options) => {
             accelplatformVersion: settings.accelplatformVersion,
             database: settings.database,
             projectVersion: settings.projectVersion,
+            packageManager: settings.packageManager,
+            javascript: settings.javascript,
         };
         const entries = await walkAssetRepo(repoDir, semver, context);
         const deployedFiles = [];
         const hashEntries = [];
         const deployedAssets = {};
         const skippedFiles = [];
+        const overwrittenFiles = [];
+        let currentSection = null;
         for (const entry of entries) {
             const targetPath = entry.relativePath;
             const destPath = join(projectDir, targetPath);
-            if (skipExistingFiles && (await fileExists(destPath))) {
-                skippedFiles.push(targetPath);
+            const section = sectionOf(targetPath);
+            if (section !== currentSection) {
+                currentSection = section;
+                if (progress?.onSectionDeploy) {
+                    const sectionFiles = entries
+                        .filter((e) => sectionOf(e.relativePath) === section)
+                        .map((e) => fileLabelOf(e.relativePath, section));
+                    progress.onSectionDeploy(section, sectionFiles);
+                }
+            }
+            if (!isWithinDir(projectDir, destPath)) {
+                console.warn(`Warning: skipping asset with path escaping project directory: ${targetPath}`);
+                continue;
+            }
+            if (!isWithinDir(repoDir, entry.sourcePath)) {
+                console.warn(`Warning: skipping asset with source path escaping asset repo: ${entry.sourcePath}`);
                 continue;
             }
+            const exists = await fileExists(destPath);
+            if (exists) {
+                let decision = "overwrite";
+                if (skipExistingFiles) {
+                    decision = "skip";
+                }
+                else if (onExistingFile) {
+                    decision = await onExistingFile(targetPath);
+                }
+                if (decision === "skip") {
+                    skippedFiles.push(targetPath);
+                    continue;
+                }
+                overwrittenFiles.push(targetPath);
+            }
             let content = await readFile(entry.sourcePath, "utf-8");
             const replacements = collectReplacements(entry);
             if (replacements.length > 0) {
@@ -79,17 +144,23 @@ export const deployAssets = async (options) => {
         await writeSettings(projectDir, updatedSettings);
         await writeHashsum(projectDir, hashEntries);
         if (!noInstall) {
-            const installCmds = ["bun ci", "bun run build"];
-            for (const cmd of installCmds) {
-                try {
-                    execSync(cmd, { cwd: projectDir, stdio: "pipe" });
-                }
-                catch {
-                    console.warn(`Warning: install command failed: ${cmd} in ${projectDir}`);
-                }
+            const [installCmd, buildCmd] = getInstallCmds(settings.packageManager);
+            progress?.onInstallStart?.(installCmd);
+            try {
+                execSync(installCmd, { cwd: projectDir, stdio: "pipe" });
+            }
+            catch {
+                console.warn(`Warning: install command failed: ${installCmd} in ${projectDir}`);
+            }
+            progress?.onBuildStart?.(buildCmd);
+            try {
+                execSync(buildCmd, { cwd: projectDir, stdio: "pipe" });
+            }
+            catch {
+                console.warn(`Warning: build command failed: ${buildCmd} in ${projectDir}`);
             }
         }
-        return { deployedFiles, hashEntries, skippedFiles };
+        return { deployedFiles, hashEntries, skippedFiles, overwrittenFiles };
     }
     finally {
         await provider.cleanup().catch(() => { });

package/dist/asset/walker.js

@@ -53,6 +53,8 @@ const findMatchingVersionDirs = async (repoDir, targetSemver) => {
                 accelplatformVersion: "",
                 database: "",
                 projectVersion: "",
+                packageManager: "",
+                javascript: false,
             };
             if (evaluateCondition(meta.conditions, context)) {
                 matched.push(dirPath);

package/dist/commands/attach.d.ts

@@ -47,6 +47,15 @@ export declare const attachCommand: import("citty").CommandDef<{
         type: "string";
         description: string;
     };
+    "package-manager": {
+        type: "string";
+        description: string;
+    };
+    overwrite: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
     "skip-install": {
         type: "boolean";
         description: string;

package/dist/commands/attach.js

@@ -4,12 +4,15 @@ import { stat } from "node:fs/promises";
 import { basename, join } from "node:path";
 import { CLI_VERSION } from "../core/constants.js";
 import { runPrompts } from "../interactive/prompts.js";
-import { deployAssets } from "../asset/deployer.js";
+import { deployAssets, } from "../asset/deployer.js";
 import { createLocalAssetProvider } from "../asset/local-provider.js";
 import { createFileAssetProvider } from "../asset/file-provider.js";
 import { defaultAssetSourcePath } from "../asset/default-source.js";
 import { getMessage } from "../i18n/index.js";
 import { detectLocale } from "../utils/locale-detect.js";
+import { printSummary } from "../interactive/summary.js";
+import { printNextSteps } from "../interactive/next-steps.js";
+import { buildProgressCallbacks } from "../interactive/progress.js";
 export const attachCommand = defineCommand({
     meta: {
         name: "attach",
@@ -64,6 +67,15 @@ export const attachCommand = defineCommand({
             type: "string",
             description: "Maven artifactId (defaults to project name)",
         },
+        "package-manager": {
+            type: "string",
+            description: "Package manager (bun, npm, yarn, pnpm). Default: bun",
+        },
+        overwrite: {
+            type: "boolean",
+            description: "Overwrite existing files without per-file confirmation",
+            default: false,
+        },
         "skip-install": {
             type: "boolean",
             description: "Skip dependency installation",
@@ -112,6 +124,7 @@ export const attachCommand = defineCommand({
             agent: agentArg
                 ? agentArg.split(",").map((a) => a.trim())
                 : undefined,
+            packageManager: args["package-manager"],
             locale,
             noInteraction: args["non-interactive"],
             isInit: false,
@@ -138,6 +151,7 @@ export const attachCommand = defineCommand({
             agents: resolved.agents,
             javascript: resolved.javascript,
             locale: resolved.locale,
+            packageManager: resolved.packageManager,
             jugglingProject: resolved.jugglingProject,
             deployedAssets: {},
         };
@@ -146,22 +160,89 @@ export const attachCommand = defineCommand({
         const provider = serverUrl
             ? createLocalAssetProvider(serverUrl)
             : createFileAssetProvider(assetSource);
-        p.log.info(getMessage("progress.deploying", locale));
+        const isInteractive = !args["non-interactive"];
+        const overwriteFlag = args.overwrite;
+        if (isInteractive) {
+            printSummary(settings, projectDir, locale);
+        }
+        let skipAll = false;
+        let onExistingFile;
+        if (!isInteractive) {
+            if (!overwriteFlag)
+                skipAll = true;
+        }
+        else if (!overwriteFlag) {
+            let sticky;
+            onExistingFile = async (path) => {
+                if (sticky === "all")
+                    return "overwrite";
+                if (sticky === "skipAll")
+                    return "skip";
+                const choice = await p.select({
+                    message: getMessage("attach.overwritePrompt", locale, { path }),
+                    options: [
+                        {
+                            value: "yes",
+                            label: getMessage("attach.overwritePrompt.yes", locale),
+                        },
+                        {
+                            value: "no",
+                            label: getMessage("attach.overwritePrompt.no", locale),
+                        },
+                        {
+                            value: "all",
+                            label: getMessage("attach.overwritePrompt.all", locale),
+                        },
+                        {
+                            value: "skipAll",
+                            label: getMessage("attach.overwritePrompt.skipAll", locale),
+                        },
+                    ],
+                });
+                if (p.isCancel(choice))
+                    process.exit(0);
+                if (choice === "all") {
+                    sticky = "all";
+                    return "overwrite";
+                }
+                if (choice === "skipAll") {
+                    sticky = "skipAll";
+                    return "skip";
+                }
+                return choice === "yes" ? "overwrite" : "skip";
+            };
+        }
         const result = await deployAssets({
             projectDir,
             settings,
             provider,
             noInstall: args["skip-install"],
-            skipExistingFiles: true,
+            skipExistingFiles: skipAll || undefined,
+            onExistingFile,
+            progress: buildProgressCallbacks(locale),
         });
+        for (const path of result.overwrittenFiles) {
+            p.log.info(getMessage("attach.overwritten", locale, { path }));
+        }
         for (const path of result.skippedFiles) {
             p.log.warn(getMessage("warning.fileExists", locale, { path }));
         }
+        if (result.overwrittenFiles.length > 0) {
+            p.log.info(getMessage("attach.overwriteSummary", locale, {
+                count: String(result.overwrittenFiles.length),
+            }));
+        }
         if (result.skippedFiles.length > 0) {
             p.log.info(getMessage("attach.skipSummary", locale, {
                 count: String(result.skippedFiles.length),
             }));
         }
         p.log.success(getMessage("progress.complete", locale));
+        printNextSteps({
+            projectDir,
+            agents: resolved.agents,
+            isInit: false,
+            locale,
+        });
     },
 });

package/dist/commands/init.d.ts

@@ -48,6 +48,10 @@ export declare const initCommand: import("citty").CommandDef<{
         type: "string";
         description: string;
     };
+    "package-manager": {
+        type: "string";
+        description: string;
+    };
     "git-init": {
         type: "boolean";
         description: string;

package/dist/commands/init.js

@@ -12,6 +12,9 @@ import { defaultAssetSourcePath } from "../asset/default-source.js";
 import { getMessage } from "../i18n/index.js";
 import { detectLocale } from "../utils/locale-detect.js";
 import { commandExists } from "../utils/command-exists.js";
+import { printSummary } from "../interactive/summary.js";
+import { printNextSteps } from "../interactive/next-steps.js";
+import { buildProgressCallbacks } from "../interactive/progress.js";
 export const initCommand = defineCommand({
     meta: {
         name: "init",
@@ -67,6 +70,10 @@ export const initCommand = defineCommand({
             type: "string",
             description: "Maven artifactId (defaults to project name)",
         },
+        "package-manager": {
+            type: "string",
+            description: "Package manager (bun, npm, yarn, pnpm). Default: bun",
+        },
         "git-init": {
             type: "boolean",
             description: "Initialize git repository (use --no-git-init to disable)",
@@ -113,6 +120,7 @@ export const initCommand = defineCommand({
             agent: agentArg
                 ? agentArg.split(",").map((a) => a.trim())
                 : undefined,
+            packageManager: args["package-manager"],
             locale,
             withGit: args["git-init"],
             noInteraction: args["non-interactive"],
@@ -149,20 +157,25 @@ export const initCommand = defineCommand({
             agents: resolved.agents,
             javascript: resolved.javascript,
             locale: resolved.locale,
+            packageManager: resolved.packageManager,
             jugglingProject: resolved.jugglingProject,
             deployedAssets: {},
         };
+        const isInteractive = !args["non-interactive"];
+        if (isInteractive) {
+            printSummary(settings, projectDir, locale);
+        }
         const serverUrl = args["asset-server-url"];
         const assetSource = args["asset-source"] ?? defaultAssetSourcePath();
         const provider = serverUrl
             ? createLocalAssetProvider(serverUrl)
             : createFileAssetProvider(assetSource);
-        p.log.info(getMessage("progress.deploying", locale));
         await deployAssets({
             projectDir,
             settings,
             provider,
             noInstall: args["skip-install"],
+            progress: buildProgressCallbacks(locale),
         });
         if (resolved.withGit) {
             if (commandExists("git")) {
@@ -179,5 +192,11 @@ export const initCommand = defineCommand({
             }
         }
         p.log.success(getMessage("progress.complete", locale));
+        printNextSteps({
+            projectDir,
+            agents: resolved.agents,
+            isInit: true,
+            locale,
+        });
     },
 });

package/dist/core/condition-evaluator.js

@@ -1,5 +1,5 @@
 import { satisfies } from "semver";
-import { isAndCondition, isOrCondition, isVersionCondition, isModuleCondition, isLocaleCondition, isAgentCondition, } from "./types.js";
+import { isAndCondition, isOrCondition, isVersionCondition, isModuleCondition, isLocaleCondition, isAgentCondition, isPackageManagerCondition, isJavascriptCondition, } from "./types.js";
 export const evaluateCondition = (condition, context) => {
     if (condition === undefined) {
         return true;
@@ -22,5 +22,11 @@ export const evaluateCondition = (condition, context) => {
     if (isAgentCondition(condition)) {
         return context.agents.includes(condition.agent);
     }
+    if (isPackageManagerCondition(condition)) {
+        return context.packageManager === condition.packageManager;
+    }
+    if (isJavascriptCondition(condition)) {
+        return context.javascript === condition.javascript;
+    }
     return false;
 };

package/dist/core/constants.d.ts

@@ -8,4 +8,6 @@ export declare const MODULE_OPTIONS: readonly ["workflow", "bpm", "copilot", "im
 export type ModuleOption = (typeof MODULE_OPTIONS)[number];
 export declare const LOCALE_OPTIONS: readonly ["ja", "en", "zh_CN"];
 export type LocaleOption = (typeof LOCALE_OPTIONS)[number];
+export declare const PACKAGE_MANAGER_OPTIONS: readonly ["bun", "npm", "yarn", "pnpm"];
+export type PackageManagerOption = (typeof PACKAGE_MANAGER_OPTIONS)[number];
 export declare const DEFAULT_SETTINGS: Omit<AccelSettings, "cliVersion" | "createdAt" | "deployedAssets">;

package/dist/core/constants.js

@@ -10,6 +10,12 @@ export const MODULE_OPTIONS = [
     "kaiden",
 ];
 export const LOCALE_OPTIONS = ["ja", "en", "zh_CN"];
+export const PACKAGE_MANAGER_OPTIONS = [
+    "bun",
+    "npm",
+    "yarn",
+    "pnpm",
+];
 export const DEFAULT_SETTINGS = {
     name: "my-accel-project",
     artifactId: "",
@@ -22,5 +28,6 @@ export const DEFAULT_SETTINGS = {
     agents: ["claude-code", "github-copilot"],
     javascript: false,
     locale: "ja",
+    packageManager: "bun",
     jugglingProject: null,
 };

package/dist/core/types.d.ts

@@ -16,7 +16,13 @@ export type LocaleCondition = {
 export type AgentCondition = {
     agent: string;
 };
-export type LeafCondition = VersionCondition | ModuleCondition | LocaleCondition | AgentCondition;
+export type PackageManagerCondition = {
+    packageManager: string;
+};
+export type JavascriptCondition = {
+    javascript: boolean;
+};
+export type LeafCondition = VersionCondition | ModuleCondition | LocaleCondition | AgentCondition | PackageManagerCondition | JavascriptCondition;
 export type Condition = AndCondition | OrCondition | LeafCondition;
 export type TextReplacement = {
     type: "text";
@@ -69,6 +75,7 @@ export type AccelSettings = {
     agents: string[];
     javascript: boolean;
     locale: string;
+    packageManager: string;
     jugglingProject: string | null;
     deployedAssets: Record<string, string>;
 };
@@ -93,6 +100,8 @@ export type EvalContext = {
     accelplatformVersion: string;
     database: string;
     projectVersion: string;
+    packageManager: string;
+    javascript: boolean;
 };
 export declare const isAndCondition: (c: Condition) => c is AndCondition;
 export declare const isOrCondition: (c: Condition) => c is OrCondition;
@@ -100,3 +109,5 @@ export declare const isVersionCondition: (c: Condition) => c is VersionCondition
 export declare const isModuleCondition: (c: Condition) => c is ModuleCondition;
 export declare const isLocaleCondition: (c: Condition) => c is LocaleCondition;
 export declare const isAgentCondition: (c: Condition) => c is AgentCondition;
+export declare const isPackageManagerCondition: (c: Condition) => c is PackageManagerCondition;
+export declare const isJavascriptCondition: (c: Condition) => c is JavascriptCondition;

package/dist/core/types.js

@@ -4,3 +4,5 @@ export const isVersionCondition = (c) => "version" in c && !("and" in c) && !("o
 export const isModuleCondition = (c) => "module" in c;
 export const isLocaleCondition = (c) => "locale" in c;
 export const isAgentCondition = (c) => "agent" in c;
+export const isPackageManagerCondition = (c) => "packageManager" in c;
+export const isJavascriptCondition = (c) => "javascript" in c;

package/dist/core/validators.d.ts

@@ -1,4 +1,4 @@
-export type Validator = (value: string) => string | undefined;
+export type Validator = (value: string | undefined) => string | undefined;
 export type Validators = {
     name: Validator;
     artifactId: Validator;
@@ -8,5 +8,6 @@ export type Validators = {
     module: Validator;
     database: Validator;
     agent: Validator;
+    packageManager: Validator;
 };
 export declare const createValidators: (locale: string) => Validators;

package/dist/core/validators.js

@@ -1,5 +1,5 @@
 import { getMessage } from "../i18n/index.js";
-import { AGENT_OPTIONS, DATABASE_OPTIONS, MODULE_OPTIONS, } from "./constants.js";
+import { AGENT_OPTIONS, DATABASE_OPTIONS, MODULE_OPTIONS, PACKAGE_MANAGER_OPTIONS, } from "./constants.js";
 import { SELECTABLE_VERSIONS } from "./version-map.js";
 const ARTIFACT_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
 const GROUP_PATTERN = /^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*)*$/;
@@ -23,29 +23,62 @@ const isValidVersionLabel = (value) => SELECTABLE_VERSIONS.some((v) => v.label =
 const isValidModule = (value) => MODULE_OPTIONS.includes(value);
 const isValidDatabase = (value) => DATABASE_OPTIONS.includes(value);
 const isValidAgent = (value) => AGENT_OPTIONS.includes(value);
+const isValidPackageManager = (value) => PACKAGE_MANAGER_OPTIONS.includes(value);
 export const createValidators = (locale) => ({
-    name: (value) => isValidName(value)
-        ? undefined
-        : getMessage("error.invalidName", locale, { value }),
-    artifactId: (value) => isValidArtifactId(value)
-        ? undefined
-        : getMessage("error.invalidArtifactId", locale, { value }),
-    group: (value) => isValidGroup(value)
-        ? undefined
-        : getMessage("error.invalidGroup", locale, { value }),
-    projectVersion: (value) => isValidProjectVersion(value)
-        ? undefined
-        : getMessage("error.invalidProjectVersion", locale, { value }),
-    versionLabel: (value) => isValidVersionLabel(value)
-        ? undefined
-        : getMessage("error.invalidVersion", locale, { version: value }),
-    module: (value) => isValidModule(value)
-        ? undefined
-        : getMessage("error.invalidModule", locale, { module: value }),
-    database: (value) => isValidDatabase(value)
-        ? undefined
-        : getMessage("error.invalidDatabase", locale, { database: value }),
-    agent: (value) => isValidAgent(value)
-        ? undefined
-        : getMessage("error.invalidAgent", locale, { agent: value }),
+    name: (value) => {
+        const v = value ?? "";
+        return isValidName(v)
+            ? undefined
+            : getMessage("error.invalidName", locale, { value: v });
+    },
+    artifactId: (value) => {
+        const v = value ?? "";
+        return isValidArtifactId(v)
+            ? undefined
+            : getMessage("error.invalidArtifactId", locale, { value: v });
+    },
+    group: (value) => {
+        const v = value ?? "";
+        return isValidGroup(v)
+            ? undefined
+            : getMessage("error.invalidGroup", locale, { value: v });
+    },
+    projectVersion: (value) => {
+        const v = value ?? "";
+        return isValidProjectVersion(v)
+            ? undefined
+            : getMessage("error.invalidProjectVersion", locale, { value: v });
+    },
+    versionLabel: (value) => {
+        const v = value ?? "";
+        return isValidVersionLabel(v)
+            ? undefined
+            : getMessage("error.invalidVersion", locale, { version: v });
+    },
+    module: (value) => {
+        const v = value ?? "";
+        return isValidModule(v)
+            ? undefined
+            : getMessage("error.invalidModule", locale, { module: v });
+    },
+    database: (value) => {
+        const v = value ?? "";
+        return isValidDatabase(v)
+            ? undefined
+            : getMessage("error.invalidDatabase", locale, { database: v });
+    },
+    agent: (value) => {
+        const v = value ?? "";
+        return isValidAgent(v)
+            ? undefined
+            : getMessage("error.invalidAgent", locale, { agent: v });
+    },
+    packageManager: (value) => {
+        const v = value ?? "";
+        return isValidPackageManager(v)
+            ? undefined
+            : getMessage("error.invalidPackageManager", locale, {
+                packageManager: v,
+            });
+    },
 });

package/dist/core/variable-interpolator.js

@@ -8,6 +8,7 @@ const VARIABLE_MAP = new Map([
     ["locale", "locale"],
     ["database", "database"],
     ["projectVersion", "projectVersion"],
+    ["packageManager", "packageManager"],
 ]);
 const INTERPOLATION_PATTERN = /\{\{\$(\w+)\}\}/g;
 export const interpolateVariables = (template, context) => {

package/dist/i18n/en.js

@@ -1,16 +1,30 @@
 export const messages = {
+    "intro.init": "Generate an iAP (intra-mart Accel Platform) project and\nassets for Claude Code / GitHub Copilot.\nA few questions follow; everything is then deployed in one go.",
+    "intro.attach": "Mark the current directory as an iAP project and\ndeploy assets for Claude Code / GitHub Copilot.\nA few questions follow; everything is then deployed in one go.",
     "prompt.name": "Enter project name",
+    "prompt.name.hint": "Used as the directory name and recorded in pom.xml <name> and package.json name\nProvide a concise name that represents the system or feature you are creating (e.g. customer-portal, invoice-management)",
     "prompt.artifactId": "Enter artifact ID (Maven artifactId)",
+    "prompt.artifactId.hint": "Recorded in pom.xml as the Maven artifactId (the artifact's identifier)\nThe identifier that forms the built artifact's file name (jar/war) and Maven coordinates. Defaults to the project name; change only if you want a different identifier",
     "prompt.jugglingProject": "Enter IM-Juggling project path (optional)",
+    "prompt.jugglingProject.hint": "If set, the iAP version and modules are auto-detected from juggling.im\nPath to an existing IM-Juggling project directory you want to link; leave empty to skip (e.g. ../customer-portal-juggling)",
     "prompt.accelplatformVersion": "Select iAP version",
+    "prompt.accelplatformVersion.hint": "iAP release version. The deployed assets (CLAUDE.md, etc.) adapt to this version",
     "prompt.modules": "Select modules to use",
+    "prompt.modules.hint": "iAP optional product modules. Each selection deploys matching skills, config, and CLAUDE.md sections",
     "prompt.group": "Enter group name",
+    "prompt.group.hint": "Recorded in pom.xml as the Maven groupId (dot-separated organization identifier)\nAn identifier for your organization or team; reverse-domain notation reduces collisions (e.g. com.example, jp.co.intra_mart.app)",
     "prompt.projectVersion": "Enter project version",
+    "prompt.projectVersion.hint": "Recorded in pom.xml <version> and package.json version\nThe release version of your project; Semantic Versioning (MAJOR.MINOR.PATCH) is common (e.g. 0.1.0, 1.0.0-SNAPSHOT)",
     "prompt.description": "Enter project description",
+    "prompt.description.hint": "Recorded in pom.xml <description> and used in headers of CLAUDE.md and similar files\nA short description of what this system does; being specific helps future readers and search (e.g. Portal to manage customer information)",
     "prompt.database": "Select database",
+    "prompt.database.hint": "The DB iAP connects to. Used to generate sample config and example connection strings in assets",
     "prompt.javascript": "Use JavaScript instead of TypeScript?",
+    "prompt.javascript.hint": "Affects the whole project setup (presence of tsconfig.json, pom.xml / package.json dependencies and scripts, agent asset language guidance)",
     "prompt.agent": "Select agent",
+    "prompt.agent.hint": "claude-code deploys under .claude/, github-copilot deploys under .github/ (instructions, skills, etc.)",
     "prompt.withGit": "Initialize Git repository?",
+    "prompt.withGit.hint": "Runs git init inside the created project directory",
     "juggling.detected.version": "Detected version from juggling.im: {version}",
     "juggling.detected.modules": "Detected modules from juggling.im: {modules}",
     "juggling.notFound": "juggling.im not found at specified path: {path}",
@@ -19,6 +33,13 @@ export const messages = {
     "warning.gitNotFound": "git command not found. Skipping Git initialization.",
     "warning.fileExists": "File already exists, skipping: {path}",
     "attach.skipSummary": "{count} file(s) were skipped because they already exist.",
+    "attach.overwritePrompt": "{path} already exists. Overwrite?",
+    "attach.overwritePrompt.yes": "Yes (overwrite this file)",
+    "attach.overwritePrompt.no": "No (skip this file)",
+    "attach.overwritePrompt.all": "All (overwrite all remaining)",
+    "attach.overwritePrompt.skipAll": "Skip-all (skip all remaining)",
+    "attach.overwritten": "Overwritten: {path}",
+    "attach.overwriteSummary": "{count} file(s) overwritten.",
     "detach.confirm": "Detach Accel CLI from this project. Are you sure?",
     "detach.deleted": "Deleted: {path}",
     "detach.skipped": "Skipped: {path} (modifications detected)",
@@ -33,13 +54,36 @@ export const messages = {
     "error.invalidModule": "Invalid module: {module}",
     "error.invalidDatabase": "Invalid database: {database}",
     "error.invalidAgent": "Invalid agent: {agent}",
+    "error.invalidPackageManager": "Invalid package manager (expected one of bun, npm, yarn, pnpm): {packageManager}",
     "error.invalidName": "Project name contains invalid characters for a directory name, or is empty: {value}",
     "error.invalidArtifactId": "Artifact ID violates Maven naming rules (^[A-Za-z0-9][A-Za-z0-9._-]*$): {value}",
     "error.invalidGroup": "Group name violates Maven groupId naming rules (dot-separated Java identifiers): {value}",
     "error.invalidProjectVersion": "Project version violates Maven version naming rules (^[A-Za-z0-9][A-Za-z0-9._-]*$): {value}",
-    "progress.downloading": "Downloading assets...",
-    "progress.deploying": "Deploying assets...",
-    "progress.installing": "Installing dependencies...",
-    "progress.gitInit": "Initializing Git repository...",
+    "summary.heading": "Deployment settings",
+    "summary.label.name": "Project name",
+    "summary.label.artifactId": "Artifact ID",
+    "summary.label.group": "Group",
+    "summary.label.projectVersion": "Project version",
+    "summary.label.description": "Description",
+    "summary.label.accelplatformVersion": "iAP version",
+    "summary.label.modules": "Modules",
+    "summary.label.database": "Database",
+    "summary.label.javascript": "JavaScript",
+    "summary.label.agents": "Agents",
+    "summary.label.locale": "Locale",
+    "summary.label.packageManager": "Package manager",
+    "summary.label.jugglingProject": "IM-Juggling project",
+    "summary.outputDir": "Output directory",
+    "summary.empty": "(none)",
+    "progress.fetching": "Fetching asset repository...",
+    "progress.deploying.section": "Deploying under {section} ({files})",
+    "progress.deploying.root": "Deploying root-level files ({files})",
+    "progress.installing": "Running {command}...",
+    "progress.building": "Running {command}...",
+    "progress.gitInit": "Running git init...",
     "progress.complete": "Project creation complete.",
+    "nextSteps.heading": "Next steps",
+    "nextSteps.cd": "cd {path}",
+    "nextSteps.agent.claudeCode": "Run claude to start agent-driven development",
+    "nextSteps.agent.githubCopilot": "Run gh copilot to start agent-driven development",
 };

package/dist/i18n/ja.js

@@ -1,16 +1,30 @@
 export const messages = {
+    "intro.init": "iAP（intra-mart Accel Platform）プロジェクトと、\nClaude Code / GitHub Copilot 向けの資材を生成します。\nいくつか質問した後、最後に一括で配備します。",
+    "intro.attach": "カレントディレクトリを iAP プロジェクトとして認識させ、\nClaude Code / GitHub Copilot 向けの資材を配備します。\nいくつか質問した後、最後に一括で配備します。",
     "prompt.name": "プロジェクト名を入力してください",
+    "prompt.name.hint": "ディレクトリ名、pom.xml の <name>、package.json の name に反映されます\n作成するシステムや機能を端的に表す名称を指定してください（例: customer-portal, invoice-management）",
     "prompt.artifactId": "アーティファクトID（pomのartifactId）を入力してください",
+    "prompt.artifactId.hint": "Maven の artifactId として pom.xml に記録されます（成果物のID）\n成果物 (jar/war 等) のファイル名や、Maven で依存関係を識別するための ID の一部として使われます。デフォルトはプロジェクト名と同じ値で、別の識別子を使いたい場合のみ変更してください",
     "prompt.jugglingProject": "IM-Jugglingプロジェクトのパスを入力してください（省略可）",
+    "prompt.jugglingProject.hint": "指定すると juggling.im から iAPバージョンとモジュールを自動検出します\n連携したい既存の IM-Juggling プロジェクトのディレクトリパスを指定してください（例: ../customer-portal-juggling）",
     "prompt.accelplatformVersion": "iAPバージョンを選択してください",
+    "prompt.accelplatformVersion.hint": "iAP本体のリリース版。配備される資材（CLAUDE.md 等）の内容がこのバージョンに合わせて変化します",
     "prompt.modules": "利用するモジュールを選択してください",
+    "prompt.modules.hint": "iAP のオプション製品群。選択したモジュール向けの Skill や設定ファイル、CLAUDE.md 内のセクションが配備されます",
     "prompt.group": "グループ名を入力してください",
+    "prompt.group.hint": "Maven の groupId として pom.xml に記録されます（組織を表すドット区切り名）\n所属する組織やチームを表す識別子。逆ドメイン記法で書くと他者と衝突しにくいです（例: com.example, jp.co.intra_mart.app）",
     "prompt.projectVersion": "プロジェクトバージョンを入力してください",
+    "prompt.projectVersion.hint": "pom.xml の <version> と package.json の version に反映されます\nプロジェクトのリリースバージョン。セマンティックバージョニング（MAJOR.MINOR.PATCH）が一般的です（例: 0.1.0, 1.0.0-SNAPSHOT）",
     "prompt.description": "プロジェクトの説明を入力してください",
+    "prompt.description.hint": "pom.xml の <description> や CLAUDE.md 等のヘッダに反映されます\nこのシステムが何をするものかの簡潔な説明。具体的に書くと後で読む人や検索の助けになります（例: 顧客情報を管理するポータルサイト）",
     "prompt.database": "データベースを選択してください",
+    "prompt.database.hint": "iAP が接続する DB。資材内のサンプル設定や接続文字列の例の生成に使われます",
     "prompt.javascript": "TypeScriptの代わりにJavaScriptを利用しますか？",
+    "prompt.javascript.hint": "プロジェクト全体の構成（tsconfig.json の有無、pom.xml / package.json の依存・スクリプト、エージェント資材内の言語ガイド）に影響します",
     "prompt.agent": "エージェントを選択してください",
+    "prompt.agent.hint": "claude-code → .claude/ 配下、github-copilot → .github/ 配下に、指示書や skills などを配備します",
     "prompt.withGit": "Gitリポジトリを初期化しますか？",
+    "prompt.withGit.hint": "作成したプロジェクトディレクトリで git init を実行します",
     "juggling.detected.version": "juggling.imからバージョンを検出: {version}",
     "juggling.detected.modules": "juggling.imからモジュールを検出: {modules}",
     "juggling.notFound": "指定されたパスにjuggling.imが見つかりません: {path}",
@@ -19,6 +33,13 @@ export const messages = {
     "warning.gitNotFound": "gitコマンドが見つかりません。Git初期化をスキップします。",
     "warning.fileExists": "既存ファイルのためスキップ: {path}",
     "attach.skipSummary": "{count}件のファイルは既に存在したためスキップしました。",
+    "attach.overwritePrompt": "{path} は既に存在します。上書きしますか？",
+    "attach.overwritePrompt.yes": "Yes (このファイルを上書き)",
+    "attach.overwritePrompt.no": "No (このファイルをスキップ)",
+    "attach.overwritePrompt.all": "All (以降全て上書き)",
+    "attach.overwritePrompt.skipAll": "Skip-all (以降全てスキップ)",
+    "attach.overwritten": "上書き: {path}",
+    "attach.overwriteSummary": "{count}件のファイルを上書きしました。",
     "detach.confirm": "このプロジェクトからAccel CLIを解除します。よろしいですか？",
     "detach.deleted": "削除: {path}",
     "detach.skipped": "スキップ: {path} (変更が検出されました)",
@@ -33,13 +54,36 @@ export const messages = {
     "error.invalidModule": "無効なモジュールです: {module}",
     "error.invalidDatabase": "無効なデータベースです: {database}",
     "error.invalidAgent": "無効なエージェントです: {agent}",
+    "error.invalidPackageManager": "無効なパッケージマネージャです（bun, npm, yarn, pnpm のいずれかを指定してください）: {packageManager}",
     "error.invalidName": "プロジェクト名にディレクトリ名として使用できない文字が含まれています、または空です: {value}",
-    "error.invalidArtifactId": "アーティファクトIDが Maven の規約に違反しています（^[A-Za-z0-9][A-Za-z0-9._-]*$）: {value}",
-    "error.invalidGroup": "グループ名が Maven groupId の規約に違反しています（ドット区切りのJava識別子）: {value}",
-    "error.invalidProjectVersion": "プロジェクトバージョンが Maven version の規約に違反しています（^[A-Za-z0-9][A-Za-z0-9._-]*$）: {value}",
-    "progress.downloading": "資材をダウンロードしています...",
-    "progress.deploying": "資材を配備しています...",
-    "progress.installing": "依存関係をインストールしています...",
-    "progress.gitInit": "Gitリポジトリを初期化しています...",
+    "error.invalidArtifactId": "アーティファクトIDが Maven の規約に違反しています(^[A-Za-z0-9][A-Za-z0-9._-]*$): {value}",
+    "error.invalidGroup": "グループ名が Maven groupId の規約に違反しています(ドット区切りのJava識別子): {value}",
+    "error.invalidProjectVersion": "プロジェクトバージョンが Maven version の規約に違反しています(^[A-Za-z0-9][A-Za-z0-9._-]*$): {value}",
+    "summary.heading": "配備設定",
+    "summary.label.name": "プロジェクト名",
+    "summary.label.artifactId": "アーティファクトID",
+    "summary.label.group": "グループ",
+    "summary.label.projectVersion": "プロジェクトバージョン",
+    "summary.label.description": "説明",
+    "summary.label.accelplatformVersion": "iAPバージョン",
+    "summary.label.modules": "モジュール",
+    "summary.label.database": "データベース",
+    "summary.label.javascript": "JavaScript",
+    "summary.label.agents": "エージェント",
+    "summary.label.locale": "ロケール",
+    "summary.label.packageManager": "パッケージマネージャ",
+    "summary.label.jugglingProject": "IM-Jugglingプロジェクト",
+    "summary.outputDir": "出力先",
+    "summary.empty": "(なし)",
+    "progress.fetching": "資材リポジトリを取得しています...",
+    "progress.deploying.section": "{section} 配下を配備中 ({files})",
+    "progress.deploying.root": "ルート直下を配備中 ({files})",
+    "progress.installing": "{command} を実行しています...",
+    "progress.building": "{command} を実行しています...",
+    "progress.gitInit": "git init を実行しています...",
     "progress.complete": "プロジェクトの作成が完了しました。",
+    "nextSteps.heading": "次の手順",
+    "nextSteps.cd": "cd {path}",
+    "nextSteps.agent.claudeCode": "claude を起動してエージェント開発を始めてください",
+    "nextSteps.agent.githubCopilot": "gh copilot を起動してエージェント開発を始めてください",
 };

package/dist/i18n/zh_CN.js

@@ -1,16 +1,30 @@
 export const messages = {
+    "intro.init": "生成 iAP（intra-mart Accel Platform）项目，\n以及面向 Claude Code / GitHub Copilot 的资源。\n将提出若干问题，最后统一进行部署。",
+    "intro.attach": "将当前目录识别为 iAP 项目，\n并部署面向 Claude Code / GitHub Copilot 的资源。\n将提出若干问题，最后统一进行部署。",
     "prompt.name": "请输入项目名称",
+    "prompt.name.hint": "用作目录名称，并写入 pom.xml 的 <name> 和 package.json 的 name\n请提供能简洁表达所创建系统或功能的名称（例如: customer-portal, invoice-management）",
     "prompt.artifactId": "请输入构件ID（Maven artifactId）",
+    "prompt.artifactId.hint": "作为 Maven artifactId 写入 pom.xml（构件的标识符）\n构成成品 (jar/war 等) 文件名和 Maven 坐标的标识符。默认与项目名称相同；如需使用其他标识符请修改",
     "prompt.jugglingProject": "请输入IM-Juggling项目路径（可选）",
+    "prompt.jugglingProject.hint": "若指定，则从 juggling.im 自动检测 iAP 版本和模块\n指定要联动的已有 IM-Juggling 项目目录路径；不需要时留空（例如: ../customer-portal-juggling）",
     "prompt.accelplatformVersion": "请选择iAP版本",
+    "prompt.accelplatformVersion.hint": "iAP 本体的发行版。部署的资源（CLAUDE.md 等）会根据该版本变化",
     "prompt.modules": "请选择要使用的模块",
+    "prompt.modules.hint": "iAP 的可选产品模块。每选一项会部署对应的 Skill、配置文件以及 CLAUDE.md 中的相应章节",
     "prompt.group": "请输入组名",
+    "prompt.group.hint": "作为 Maven groupId 写入 pom.xml（表示组织的点分标识符）\n表示所属组织或团队的标识符；按反向域名记法书写可减少与他人的冲突（例如: com.example, jp.co.intra_mart.app）",
     "prompt.projectVersion": "请输入项目版本",
+    "prompt.projectVersion.hint": "写入 pom.xml 的 <version> 和 package.json 的 version\n项目的发布版本；常用语义化版本（MAJOR.MINOR.PATCH）（例如: 0.1.0, 1.0.0-SNAPSHOT）",
     "prompt.description": "请输入项目描述",
+    "prompt.description.hint": "写入 pom.xml 的 <description>，并用于 CLAUDE.md 等文件的标题部分\n对该系统功能的简要说明；写得具体有助于日后阅读和检索（例如: 用于管理客户信息的门户网站）",
     "prompt.database": "请选择数据库",
+    "prompt.database.hint": "iAP 连接的数据库。用于生成资源中的示例配置和连接字符串样例",
     "prompt.javascript": "是否使用JavaScript代替TypeScript？",
+    "prompt.javascript.hint": "影响整个项目结构（是否存在 tsconfig.json、pom.xml / package.json 的依赖与脚本、代理资源中的语言指引）",
     "prompt.agent": "请选择代理",
+    "prompt.agent.hint": "claude-code 部署到 .claude/ 下，github-copilot 部署到 .github/ 下（指令书、skills 等）",
     "prompt.withGit": "是否初始化Git仓库？",
+    "prompt.withGit.hint": "在创建的项目目录中执行 git init",
     "juggling.detected.version": "从juggling.im检测到版本: {version}",
     "juggling.detected.modules": "从juggling.im检测到模块: {modules}",
     "juggling.notFound": "在指定路径未找到juggling.im: {path}",
@@ -19,6 +33,13 @@ export const messages = {
     "warning.gitNotFound": "未找到git命令。跳过Git初始化。",
     "warning.fileExists": "文件已存在，跳过: {path}",
     "attach.skipSummary": "{count}个文件已存在，已跳过。",
+    "attach.overwritePrompt": "{path} 已存在。要覆盖吗？",
+    "attach.overwritePrompt.yes": "Yes (覆盖此文件)",
+    "attach.overwritePrompt.no": "No (跳过此文件)",
+    "attach.overwritePrompt.all": "All (覆盖所有剩余文件)",
+    "attach.overwritePrompt.skipAll": "Skip-all (跳过所有剩余文件)",
+    "attach.overwritten": "已覆盖: {path}",
+    "attach.overwriteSummary": "已覆盖 {count} 个文件。",
     "detach.confirm": "从此项目解除Accel CLI。确定吗？",
     "detach.deleted": "已删除: {path}",
     "detach.skipped": "已跳过: {path} (检测到修改)",
@@ -33,13 +54,36 @@ export const messages = {
     "error.invalidModule": "无效的模块: {module}",
     "error.invalidDatabase": "无效的数据库: {database}",
     "error.invalidAgent": "无效的代理: {agent}",
+    "error.invalidPackageManager": "无效的包管理器（必须是 bun、npm、yarn、pnpm 之一）: {packageManager}",
     "error.invalidName": "项目名称包含不能用作目录名的字符或为空: {value}",
-    "error.invalidArtifactId": "构件ID违反Maven命名规则（^[A-Za-z0-9][A-Za-z0-9._-]*$）: {value}",
-    "error.invalidGroup": "组名违反Maven groupId命名规则（点分隔的Java标识符）: {value}",
-    "error.invalidProjectVersion": "项目版本违反Maven version命名规则（^[A-Za-z0-9][A-Za-z0-9._-]*$）: {value}",
-    "progress.downloading": "正在下载资源...",
-    "progress.deploying": "正在部署资源...",
-    "progress.installing": "正在安装依赖...",
-    "progress.gitInit": "正在初始化Git仓库...",
+    "error.invalidArtifactId": "构件ID违反Maven命名规则(^[A-Za-z0-9][A-Za-z0-9._-]*$): {value}",
+    "error.invalidGroup": "组名违反Maven groupId命名规则(点分隔的Java标识符): {value}",
+    "error.invalidProjectVersion": "项目版本违反Maven version命名规则(^[A-Za-z0-9][A-Za-z0-9._-]*$): {value}",
+    "summary.heading": "部署设置",
+    "summary.label.name": "项目名称",
+    "summary.label.artifactId": "构件ID",
+    "summary.label.group": "组",
+    "summary.label.projectVersion": "项目版本",
+    "summary.label.description": "描述",
+    "summary.label.accelplatformVersion": "iAP版本",
+    "summary.label.modules": "模块",
+    "summary.label.database": "数据库",
+    "summary.label.javascript": "JavaScript",
+    "summary.label.agents": "代理",
+    "summary.label.locale": "语言",
+    "summary.label.packageManager": "包管理器",
+    "summary.label.jugglingProject": "IM-Juggling项目",
+    "summary.outputDir": "输出目录",
+    "summary.empty": "(无)",
+    "progress.fetching": "正在获取资源仓库...",
+    "progress.deploying.section": "正在部署 {section} 下 ({files})",
+    "progress.deploying.root": "正在部署根目录文件 ({files})",
+    "progress.installing": "正在执行 {command}...",
+    "progress.building": "正在执行 {command}...",
+    "progress.gitInit": "正在执行 git init...",
     "progress.complete": "项目创建完成。",
+    "nextSteps.heading": "下一步",
+    "nextSteps.cd": "cd {path}",
+    "nextSteps.agent.claudeCode": "执行 claude 开始基于代理的开发",
+    "nextSteps.agent.githubCopilot": "执行 gh copilot 开始基于代理的开发",
 };

package/dist/interactive/format.d.ts

@@ -0,0 +1,2 @@
+export declare const withHint: (baseKey: string, locale: string) => string;
+export declare const displayWidth: (s: string) => number;

package/dist/interactive/format.js

@@ -0,0 +1,33 @@
+import { getMessage } from "../i18n/index.js";
+export const withHint = (baseKey, locale) => {
+    const main = getMessage(baseKey, locale);
+    const hintKey = `${baseKey}.hint`;
+    const hint = getMessage(hintKey, locale);
+    if (hint === hintKey)
+        return main;
+    return `${main}\n${hint}`;
+};
+const isWide = (ch) => {
+    const code = ch.codePointAt(0) ?? 0;
+    if (code >= 0x1100 && code <= 0x115f)
+        return true;
+    if (code >= 0x2e80 && code <= 0x9fff)
+        return true;
+    if (code >= 0xa000 && code <= 0xa4cf)
+        return true;
+    if (code >= 0xac00 && code <= 0xd7a3)
+        return true;
+    if (code >= 0xf900 && code <= 0xfaff)
+        return true;
+    if (code >= 0xff00 && code <= 0xff60)
+        return true;
+    if (code >= 0xffe0 && code <= 0xffe6)
+        return true;
+    return false;
+};
+export const displayWidth = (s) => {
+    let w = 0;
+    for (const ch of s)
+        w += isWide(ch) ? 2 : 1;
+    return w;
+};

package/dist/interactive/next-steps.d.ts

@@ -0,0 +1,8 @@
+export type NextStepsOptions = {
+    projectDir: string;
+    agents: string[];
+    isInit: boolean;
+    locale: string;
+};
+export declare const buildNextStepsBody: (opts: NextStepsOptions) => string;
+export declare const printNextSteps: (opts: NextStepsOptions) => void;

package/dist/interactive/next-steps.js

@@ -0,0 +1,22 @@
+import * as p from "@clack/prompts";
+import { basename } from "node:path";
+import { getMessage } from "../i18n/index.js";
+export const buildNextStepsBody = (opts) => {
+    const steps = [];
+    if (opts.isInit) {
+        steps.push(getMessage("nextSteps.cd", opts.locale, { path: basename(opts.projectDir) }));
+    }
+    if (opts.agents.includes("claude-code")) {
+        steps.push(getMessage("nextSteps.agent.claudeCode", opts.locale));
+    }
+    if (opts.agents.includes("github-copilot")) {
+        steps.push(getMessage("nextSteps.agent.githubCopilot", opts.locale));
+    }
+    return steps.map((s, i) => `${i + 1}. ${s}`).join("\n");
+};
+export const printNextSteps = (opts) => {
+    const body = buildNextStepsBody(opts);
+    if (body.length === 0)
+        return;
+    p.note(body, getMessage("nextSteps.heading", opts.locale));
+};

package/dist/interactive/progress.d.ts

@@ -0,0 +1,2 @@
+import { type ProgressCallbacks } from "../asset/deployer.js";
+export declare const buildProgressCallbacks: (locale: string) => ProgressCallbacks;

package/dist/interactive/progress.js

@@ -0,0 +1,21 @@
+import * as p from "@clack/prompts";
+import { ROOT_SECTION } from "../asset/deployer.js";
+import { getMessage } from "../i18n/index.js";
+const MAX_FILES_SHOWN = 3;
+const formatFileList = (files) => {
+    if (files.length <= MAX_FILES_SHOWN)
+        return files.join(", ");
+    return `${files.slice(0, MAX_FILES_SHOWN).join(", ")} +${files.length - MAX_FILES_SHOWN}`;
+};
+export const buildProgressCallbacks = (locale) => ({
+    onFetchStart: () => p.log.info(getMessage("progress.fetching", locale)),
+    onSectionDeploy: (section, files) => {
+        const filesStr = formatFileList(files);
+        const key = section === ROOT_SECTION
+            ? "progress.deploying.root"
+            : "progress.deploying.section";
+        p.log.info(getMessage(key, locale, { section, files: filesStr }));
+    },
+    onInstallStart: (command) => p.log.info(getMessage("progress.installing", locale, { command })),
+    onBuildStart: (command) => p.log.info(getMessage("progress.building", locale, { command })),
+});

package/dist/interactive/prompts.d.ts

@@ -12,6 +12,7 @@ export type PromptOptions = {
     database?: string;
     javascript?: boolean;
     agent?: string[];
+    packageManager?: string;
     locale: string;
     withGit?: boolean;
     noInteraction?: boolean;

package/dist/interactive/prompts.js

@@ -2,6 +2,7 @@ import * as p from "@clack/prompts";
 import { DATABASE_OPTIONS, AGENT_OPTIONS, DEFAULT_SETTINGS, } from "../core/constants.js";
 import { createValidators } from "../core/validators.js";
 import { getMessage } from "../i18n/index.js";
+import { withHint } from "./format.js";
 import { detectAgents, detectDefaultAgents } from "./agent-detect.js";
 import { parseJugglingFile } from "../juggling/parser.js";
 import { extractVersionLabel, extractModules, } from "../juggling/extractor.js";
@@ -71,6 +72,11 @@ export const validateCliValues = (opts, validators) => {
                 throw new Error(err);
         }
     }
+    if (opts.packageManager !== undefined) {
+        const err = validators.packageManager(opts.packageManager);
+        if (err)
+            throw new Error(err);
+    }
 };
 export const runPrompts = async (opts) => {
     const locale = opts.locale;
@@ -103,13 +109,15 @@ export const runPrompts = async (opts) => {
             agents: opts.agent ?? detectDefaultAgents(),
             javascript: opts.javascript ?? DEFAULT_SETTINGS.javascript,
             locale,
+            packageManager: opts.packageManager ?? DEFAULT_SETTINGS.packageManager,
             jugglingProject: opts.jugglingProject ?? null,
             withGit: opts.withGit ?? true,
         };
     }
     p.intro("Accel CLI");
+    p.note(getMessage(opts.isInit ? "intro.init" : "intro.attach", locale));
     const name = (await p.text({
-        message: getMessage("prompt.name", locale),
+        message: withHint("prompt.name", locale),
         defaultValue: opts.name ?? DEFAULT_SETTINGS.name,
         initialValue: opts.name ?? DEFAULT_SETTINGS.name,
         validate: validators.name,
@@ -118,7 +126,7 @@ export const runPrompts = async (opts) => {
         process.exit(0);
     const artifactIdInitial = opts.artifactId ?? name;
     const artifactId = (await p.text({
-        message: getMessage("prompt.artifactId", locale),
+        message: withHint("prompt.artifactId", locale),
         defaultValue: artifactIdInitial,
         initialValue: artifactIdInitial,
         validate: validators.artifactId,
@@ -126,7 +134,7 @@ export const runPrompts = async (opts) => {
     if (p.isCancel(artifactId))
         process.exit(0);
     const jugglingInput = (await p.text({
-        message: getMessage("prompt.jugglingProject", locale),
+        message: withHint("prompt.jugglingProject", locale),
         defaultValue: opts.jugglingProject ?? "",
         initialValue: opts.jugglingProject ?? "",
     }));
@@ -151,7 +159,7 @@ export const runPrompts = async (opts) => {
     const accelplatformVersion = "2025-Autumn";
     const modules = ["workflow", "bpm"];
     const group = (await p.text({
-        message: getMessage("prompt.group", locale),
+        message: withHint("prompt.group", locale),
         defaultValue: opts.group ?? DEFAULT_SETTINGS.group,
         initialValue: opts.group ?? DEFAULT_SETTINGS.group,
         validate: validators.group,
@@ -159,7 +167,7 @@ export const runPrompts = async (opts) => {
     if (p.isCancel(group))
         process.exit(0);
     const projectVersion = (await p.text({
-        message: getMessage("prompt.projectVersion", locale),
+        message: withHint("prompt.projectVersion", locale),
         defaultValue: opts.projectVersion ?? DEFAULT_SETTINGS.projectVersion,
         initialValue: opts.projectVersion ?? DEFAULT_SETTINGS.projectVersion,
         validate: validators.projectVersion,
@@ -167,21 +175,21 @@ export const runPrompts = async (opts) => {
     if (p.isCancel(projectVersion))
         process.exit(0);
     const description = (await p.text({
-        message: getMessage("prompt.description", locale),
+        message: withHint("prompt.description", locale),
         defaultValue: opts.description ?? DEFAULT_SETTINGS.description,
         initialValue: opts.description ?? DEFAULT_SETTINGS.description,
     }));
     if (p.isCancel(description))
         process.exit(0);
     const database = (await p.select({
-        message: getMessage("prompt.database", locale),
+        message: withHint("prompt.database", locale),
         options: DATABASE_OPTIONS.map((d) => ({ value: d, label: d })),
         initialValue: opts.database ?? DEFAULT_SETTINGS.database,
     }));
     if (p.isCancel(database))
         process.exit(0);
     const javascript = (await p.confirm({
-        message: getMessage("prompt.javascript", locale),
+        message: withHint("prompt.javascript", locale),
         initialValue: opts.javascript ?? DEFAULT_SETTINGS.javascript,
     }));
     if (p.isCancel(javascript))
@@ -193,7 +201,7 @@ export const runPrompts = async (opts) => {
             ? detected.map((a) => a.name)
             : [...AGENT_OPTIONS]);
     const agents = (await p.multiselect({
-        message: getMessage("prompt.agent", locale),
+        message: withHint("prompt.agent", locale),
         options: agentOptions,
         initialValues: defaultAgents,
     }));
@@ -202,7 +210,7 @@ export const runPrompts = async (opts) => {
     let withGit = opts.withGit ?? true;
     if (opts.isInit) {
         withGit = (await p.confirm({
-            message: getMessage("prompt.withGit", locale),
+            message: withHint("prompt.withGit", locale),
             initialValue: opts.withGit ?? true,
         }));
         if (p.isCancel(withGit))
@@ -220,6 +228,7 @@ export const runPrompts = async (opts) => {
         agents,
         javascript,
         locale,
+        packageManager: opts.packageManager ?? DEFAULT_SETTINGS.packageManager,
         jugglingProject,
         withGit,
     };

package/dist/interactive/summary.d.ts

@@ -0,0 +1,3 @@
+import type { AccelSettings } from "../core/types.js";
+export declare const buildSummaryBody: (settings: AccelSettings, outputDir: string, locale: string) => string;
+export declare const printSummary: (settings: AccelSettings, outputDir: string, locale: string) => void;

package/dist/interactive/summary.js

@@ -0,0 +1,50 @@
+import * as p from "@clack/prompts";
+import { getMessage } from "../i18n/index.js";
+import { displayWidth } from "./format.js";
+const formatList = (values, emptyLabel) => values.length > 0 ? values.join(", ") : emptyLabel;
+const formatString = (value, emptyLabel) => value.length > 0 ? value : emptyLabel;
+const formatBoolean = (value) => (value ? "true" : "false");
+export const buildSummaryBody = (settings, outputDir, locale) => {
+    const empty = getMessage("summary.empty", locale);
+    const rows = [
+        { labelKey: "summary.label.name", value: settings.name },
+        { labelKey: "summary.label.artifactId", value: settings.artifactId },
+        { labelKey: "summary.label.group", value: settings.group },
+        { labelKey: "summary.label.projectVersion", value: settings.projectVersion },
+        {
+            labelKey: "summary.label.description",
+            value: formatString(settings.description, empty),
+        },
+        { labelKey: "summary.label.database", value: settings.database },
+        {
+            labelKey: "summary.label.javascript",
+            value: formatBoolean(settings.javascript),
+        },
+        {
+            labelKey: "summary.label.agents",
+            value: formatList(settings.agents, empty),
+        },
+        { labelKey: "summary.label.locale", value: settings.locale },
+        {
+            labelKey: "summary.label.packageManager",
+            value: settings.packageManager,
+        },
+        {
+            labelKey: "summary.label.jugglingProject",
+            value: settings.jugglingProject ?? empty,
+        },
+        { labelKey: "summary.outputDir", value: outputDir },
+    ];
+    const labels = rows.map((r) => getMessage(r.labelKey, locale));
+    const maxLabelWidth = Math.max(...labels.map((l) => displayWidth(l)));
+    return rows
+        .map((row, i) => {
+        const label = labels[i];
+        const pad = " ".repeat(Math.max(0, maxLabelWidth - displayWidth(label)));
+        return `${label}${pad} : ${row.value}`;
+    })
+        .join("\n");
+};
+export const printSummary = (settings, outputDir, locale) => {
+    p.note(buildSummaryBody(settings, outputDir, locale), getMessage("summary.heading", locale));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intra-mart/accel",
-  "version": "0.1.0",
+  "version": "0.2.0-dev.202605271647",
   "type": "module",
   "description": "CLI tool for intra-mart Accel Platform development",
   "author": "NTT DATA INTRAMART",
@@ -39,7 +39,7 @@
     "prepublishOnly": "tsc"
   },
   "dependencies": {
-    "@clack/prompts": "^0.10.0",
+    "@clack/prompts": "^1.4.0",
     "citty": "^0.1.6",
     "fast-xml-parser": "^5.2.0",
     "remark": "^15.0.1",