@intra-mart/accel 0.1.0 → 0.3.0-next.202605250439

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` を指定しない場合）
 
 ## インストール
@@ -40,6 +44,8 @@ accel init my-project
 ```bash
 accel init my-project \
   --non-interactive \
+  --accelplatform-version 2026-Spring \
+  --module workflow \
   --agent claude-code \
   --locale ja
 ```
@@ -49,6 +55,8 @@ accel init my-project \
 | オプション | 型 | 説明 | デフォルト |
 |---|---|---|---|
 | `[project-name]` (位置引数) | string | プロジェクト名（ディレクトリ名と一致） | `my-accel-project`（対話で変更可） |
+| `--accelplatform-version` | string | iAPバージョン（例: `2026-Spring`） | 対話で選択 |
+| `--module` | string | 使用モジュール（カンマ区切り） | 対話で選択 |
 | `--agent` | string | エージェント種別（`claude-code`, `github-copilot`、カンマ区切り） | 自動検出 |
 | `--locale` | string | ロケール（`ja`, `en`, `zh_CN`） | OS設定から自動検出 |
 | `--artifact-id` | string | アーティファクトID（pomの `artifactId` に相当） | プロジェクト名と同値 |
@@ -58,9 +66,12 @@ 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` |
+| `--asset-source` | string | ローカル資材のパス（tarアーカイブまたは展開済みディレクトリ） | パッケージ同梱の `assets/assets.tar.gz` |
+| `--asset-server-url` | string | 資材サーバーURL。明示指定時は `--asset-source` より優先される | - |
 
 ### `accel attach`
 
@@ -68,20 +79,24 @@ accel init my-project \
 
 ```bash
 cd my-existing-project
-accel attach --non-interactive
+accel attach --non-interactive --accelplatform-version 2026-Spring --module workflow
 ```
 
 `init` との違い:
 - ディレクトリを新規作成せず、カレントディレクトリを使用
 - git initは行わない
 - プロジェクト名のデフォルトはカレントディレクトリ名
-- **既存ファイルがある配備先はスキップ**（上書きしない）。スキップされたファイルは `hashsum.txt` および `deployedAssets` に記録されないため、`detach` の対象外となる
+- **既存ファイルがある配備先はファイル単位で上書き確認**を行う。対話モードでは1ファイルごとに「Yes / No / All (以降全て上書き) / Skip-all (以降全てスキップ)」を選択。`--overwrite` 指定時は確認なしで全て上書き。非対話モードかつ `--overwrite` 未指定の場合は全てスキップ
+  - 上書きされたファイルは `hashsum.txt` および `deployedAssets` に記録される（`detach` の対象になる）
+  - スキップされたファイルは記録されない（`detach` の対象外）
 
 #### オプション一覧
 
 | オプション | 型 | 説明 | デフォルト |
 |---|---|---|---|
 | `--name` | string | プロジェクト名 | カレントディレクトリ名 |
+| `--accelplatform-version` | string | iAPバージョン（例: `2026-Spring`） | 対話で選択 |
+| `--module` | string | 使用モジュール（カンマ区切り） | 対話で選択 |
 | `--agent` | string | エージェント種別（`claude-code`, `github-copilot`、カンマ区切り） | 自動検出 |
 | `--locale` | string | ロケール（`ja`, `en`, `zh_CN`） | OS設定から自動検出 |
 | `--artifact-id` | string | アーティファクトID（pomの `artifactId` に相当） | プロジェクト名と同値 |
@@ -91,8 +106,12 @@ 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` |
+| `--asset-source` | string | ローカル資材のパス（tarアーカイブまたは展開済みディレクトリ） | パッケージ同梱の `assets/assets.tar.gz` |
+| `--asset-server-url` | string | 資材サーバーURL。明示指定時は `--asset-source` より優先される | - |
 
 ### `accel detach`
 
@@ -107,6 +126,33 @@ accel detach
 - ユーザーが編集したファイルはスキップ（警告表示）
 - `.accel/` ディレクトリを削除
 
+### `accel deploy`
+
+ビルド成果物（`./target/` 配下の zip）を iAP のステージング環境へデプロイします。**対話モードのみ**対応です。
+
+```bash
+cd my-project
+accel deploy
+```
+
+- プロジェクトのルートで実行します。ビルド成果物は `./target/` 配下に出力されている前提です（`mvn package` で生成される `<artifactId>-<version>.zip`）。
+- 初回実行時に iAP の接続情報（エンドポイントURL・APIキー）の入力を求めます。入力値は `.accel/credentials.json` に保存され、次回以降は再入力不要です。
+  - **APIキーは秘匿情報のため、`.accel/credentials.json` は自動的に `.gitignore` に追加されます**（コミット対象外）。
+- 既存のステージング環境を一覧から選択します（ステージングは iAP 側で事前に作成しておく必要があります）。
+- `./target/` 配下の zip が複数ある場合は選択し、単一の場合は自動選択します。いずれの場合もデプロイ実行前に最終確認を行います。
+- 送信時、zip は imm 形式としてアップロードされます（送信時のファイル名のみ `.imm` に変更され、ディスク上のファイルはそのままです）。
+
+#### 接続情報ファイル `.accel/credentials.json`
+
+```json
+{
+  "endpoint": "https://example.com/imart",
+  "apiKey": "<OAuth Bearer トークン>"
+}
+```
+
+`endpoint` には iAP のベースURL を指定します。API パス（`/api/bearer/development/...`）は CLI が組み立てます。
+
 ## IM-Juggling連携
 
 `--juggling-project` オプションでIM-Jugglingプロジェクトのパスを指定すると、`juggling.im` からiAPバージョンと使用モジュールを自動検出します。
@@ -135,8 +181,24 @@ my-project/
 
 - `.accel/settings.json` — プロジェクト設定。git管理対象、手動編集可
 - `.accel/hashsum.txt` — 配備ファイルのSHA-1。`detach` 時の変更検出に使用
+- `.accel/credentials.json` — iAP接続情報（endpoint / APIキー）。`accel deploy` 初回実行時に生成。APIキーを含むため `.gitignore` 対象（git管理対象外）
 
 ## 対応iAPバージョン
 
-現段階では、2025-Autumn (8.0.38) のみをサポートしています。
-iAPのバージョン検出処理については、2025-Autumn固定になるように一部処理を変更しています。
+2024-Spring (8.0.35) 以降の iAP バージョンを選択可能です。
+
+## 入力値のバリデーション
+
+CLIに渡された値および対話で入力された値は、以下のルールでバリデーションされます。違反する値は対話モードでは再入力を促し、非対話モードではエラーメッセージを表示して終了します。
+
+| オプション | ルール |
+|-----------|------|
+| `[project-name]` / `--name` | 空文字不可。ディレクトリ名として不正な文字を含まない（`/ \ : * ? " < > \|`、制御文字、先頭末尾の空白／ドット） |
+| `--artifact-id` | Maven artifactId 規約: `^[A-Za-z0-9][A-Za-z0-9._-]*$` |
+| `--group` | Maven groupId 規約: ドット区切りの識別子 `^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*)*$` |
+| `--project-version` | Maven version 規約: `^[A-Za-z0-9][A-Za-z0-9._-]*$` |
+| `--accelplatform-version` | 対応iAPバージョン一覧（`2024-Spring` 以降）に含まれる値 |
+| `--module` | `workflow`, `bpm`, `copilot`, `imbox`, `pdfd`, `kaiden` のいずれか（各要素） |
+| `--database` | `postgresql`, `oracle`, `sqlserver` のいずれか |
+| `--agent` | `claude-code`, `github-copilot` のいずれか（各要素） |
+| `--package-manager` | `bun`, `npm`, `yarn`, `pnpm` のいずれか |

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/deploy.d.ts

@@ -0,0 +1,26 @@
+import type { AccelCredentials, StagingResponse } from "../core/types.js";
+import { type ApiClient } from "../deploy/api-client.js";
+export declare const toImmFileName: (zipPath: string) => string;
+type ConfirmInfo = {
+    endpoint: string;
+    stagingId: string;
+    sourceFile: string;
+    sentAs: string;
+};
+export type DeployPrompts = {
+    selectStaging: (stagings: StagingResponse[], locale: string) => Promise<string>;
+    selectZip: (zips: string[], locale: string) => Promise<string>;
+    description: (locale: string) => Promise<string>;
+    confirm: (info: ConfirmInfo, locale: string) => Promise<boolean>;
+};
+export type RunDeployDeps = {
+    projectDir: string;
+    locale?: string;
+    ensureCredentials?: (projectDir: string, locale: string) => Promise<AccelCredentials>;
+    scanTargets?: (projectDir: string) => Promise<string[]>;
+    apiClientFactory?: (endpoint: string, apiKey: string) => ApiClient;
+    prompts?: DeployPrompts;
+};
+export declare const runDeploy: (deps: RunDeployDeps) => Promise<void>;
+export declare const deployCommand: import("citty").CommandDef<{}>;
+export {};