@intra-mart/accel 0.2.0 → 0.3.0-dev.202606150745

package/README.md

@@ -7,7 +7,7 @@ intra-mart Accel Platform (iAP) 開発プロジェクトの作成・管理を行
 ## 必要環境
 
 - 以下のいずれかのパッケージマネージャ（`--package-manager` で選択、デフォルト: Bun）
-  - [Bun](https://bun.sh/) v1.0+
+  - [Bun](https://bun.sh/)
   - [npm](https://www.npmjs.com/)
   - [Yarn](https://classic.yarnpkg.com/) (classic v1)
   - [pnpm](https://pnpm.io/)
@@ -44,6 +44,9 @@ accel init my-project
 ```bash
 accel init my-project \
   --non-interactive \
+  --accelplatform-version 2026-spring \
+  --module im_workflow \
+  --feature jssp,e2e \
   --agent claude-code \
   --locale ja
 ```
@@ -53,6 +56,9 @@ accel init my-project \
 | オプション | 型 | 説明 | デフォルト |
 |---|---|---|---|
 | `[project-name]` (位置引数) | string | プロジェクト名（ディレクトリ名と一致） | `my-accel-project`（対話で変更可） |
+| `--accelplatform-version` | string | iAPバージョン。カタログのリリースID形式（例: `2026-spring`） | 対話で選択 |
+| `--module` | string | 使用モジュール。カタログの `artifactId`（カンマ区切り。例: `im_workflow,im_activiti`） | 対話で選択 |
+| `--feature` | string | 使用機能。カタログの機能ID（カンマ区切り。例: `jssp,e2e`） | 未選択 |
 | `--agent` | string | エージェント種別（`claude-code`, `github-copilot`、カンマ区切り） | 自動検出 |
 | `--locale` | string | ロケール（`ja`, `en`, `zh_CN`） | OS設定から自動検出 |
 | `--artifact-id` | string | アーティファクトID（pomの `artifactId` に相当） | プロジェクト名と同値 |
@@ -66,6 +72,10 @@ accel init my-project \
 | `--non-interactive` | boolean | 非対話モード（このモードでは `project-name` が必須） | `false` |
 | `--no-git-init` | boolean | git initをスキップ | `false`（git initする） |
 | `--skip-install` | boolean | 依存インストールをスキップ | `false` |
+| `--asset-server-url` | string | 資材を取得するGitHubリポジトリのURL（デフォルトProviderの取得先を上書き） | `https://github.com/accelplatform/skills` |
+| `--asset-ref` | string | GitHubから取得するブランチ／タグ／コミット | `experiment` |
+| `--asset-source` | string | （デバッグ用）ローカル資材のパス（tarアーカイブまたは展開済みディレクトリ）。明示時はGitHubより優先 | - |
+| `--debug-server-url` | string | （デバッグ用）ローカル資材サーバーのURL（`GET /archive`）。明示時はGitHubより優先 | - |
 
 ### `accel attach`
 
@@ -73,7 +83,7 @@ accel init my-project \
 
 ```bash
 cd my-existing-project
-accel attach --non-interactive
+accel attach --non-interactive --accelplatform-version 2026-spring --module im_workflow
 ```
 
 `init` との違い:
@@ -89,6 +99,9 @@ accel attach --non-interactive
 | オプション | 型 | 説明 | デフォルト |
 |---|---|---|---|
 | `--name` | string | プロジェクト名 | カレントディレクトリ名 |
+| `--accelplatform-version` | string | iAPバージョン。カタログのリリースID形式（例: `2026-spring`） | 対話で選択 |
+| `--module` | string | 使用モジュール。カタログの `artifactId`（カンマ区切り。例: `im_workflow,im_activiti`） | 対話で選択 |
+| `--feature` | string | 使用機能。カタログの機能ID（カンマ区切り。例: `jssp,e2e`） | 未選択 |
 | `--agent` | string | エージェント種別（`claude-code`, `github-copilot`、カンマ区切り） | 自動検出 |
 | `--locale` | string | ロケール（`ja`, `en`, `zh_CN`） | OS設定から自動検出 |
 | `--artifact-id` | string | アーティファクトID（pomの `artifactId` に相当） | プロジェクト名と同値 |
@@ -102,6 +115,10 @@ accel attach --non-interactive
 | `--overwrite` | boolean | 既存ファイルの上書き確認を行わず、全て上書きする | `false`（対話で確認 / 非対話ではスキップ） |
 | `--non-interactive` | boolean | 非対話モード | `false` |
 | `--skip-install` | boolean | 依存インストールをスキップ | `false` |
+| `--asset-server-url` | string | 資材を取得するGitHubリポジトリのURL（デフォルトProviderの取得先を上書き） | `https://github.com/accelplatform/skills` |
+| `--asset-ref` | string | GitHubから取得するブランチ／タグ／コミット | `experiment` |
+| `--asset-source` | string | （デバッグ用）ローカル資材のパス（tarアーカイブまたは展開済みディレクトリ）。明示時はGitHubより優先 | - |
+| `--debug-server-url` | string | （デバッグ用）ローカル資材サーバーのURL（`GET /archive`）。明示時はGitHubより優先 | - |
 
 ### `accel detach`
 
@@ -116,6 +133,110 @@ accel detach
 - ユーザーが編集したファイルはスキップ（警告表示）
 - `.accel/` ディレクトリを削除
 
+### `accel login`
+
+iAP の接続情報（エンドポイントURL・APIキー）を入力し、`.accel/credentials.json` に保存します。`accel deploy` を実行する前に、コマンドラインから直接接続情報を設定しておけます。
+
+```bash
+cd my-project
+accel login
+```
+
+- `endpoint`（テキスト入力）と `apiKey`（マスク入力）を対話で入力します。
+- 入力したトークンの有効性は、トークン検証API（`{endpoint}/oauth/token/verify`）を呼び出して確認します。検証に失敗（401 など）した場合や接続エラーの場合は、その場で再入力を促します。
+- 検証に成功した時点で `.accel/credentials.json` に保存します。**APIキーはシークレットのため、ファイルは自動的に `.gitignore` に追加されます**（コミット対象外）。
+
+#### 非対話モード
+
+CIでの利用を想定し、プロンプトを出さずに接続情報を検証・保存するモードです。
+
+```bash
+ACCEL_API_KEY=*** accel login \
+  --non-interactive \
+  --endpoint https://example.com/imart
+```
+
+- `endpoint` / `apiKey` は **フラグ ＞ 環境変数 ＞ `.accel/credentials.json`** の優先順位で解決します。
+  - `endpoint`: `--endpoint` / `ACCEL_ENDPOINT`
+  - `apiKey`: `--api-key` / `ACCEL_API_KEY`
+  - **APIキーはシークレット情報のため、CI では `ACCEL_API_KEY` 環境変数での指定を推奨します**（`--api-key` はプロセス一覧やCIログに漏れ得ます）。
+- トークン検証は1回だけ実行します。**失敗時は再入力せず、エラーメッセージを表示して非0終了します**。
+- 検証成功時に `.accel/credentials.json` へ保存します（対話モードと同様、`.gitignore` に自動追記）。
+- `endpoint` / `apiKey` のいずれかが解決できない場合はエラー終了します。
+
+#### オプション一覧
+
+| オプション | 型 | 説明 | デフォルト |
+|---|---|---|---|
+| `--endpoint` | string | iAPのベースURL（環境変数 `ACCEL_ENDPOINT` でも指定可） | 対話で入力 / 保存値 |
+| `--api-key` | string | OAuth Bearerトークン（**環境変数 `ACCEL_API_KEY` 推奨**） | 対話で入力 / 保存値 |
+| `--non-interactive` | boolean | 非対話モード（プロンプトを出さず、検証失敗時は非0終了） | `false` |
+
+### `accel deploy`
+
+ビルド成果物（`./target/` 配下の zip）を iAP のステージング環境へデプロイします。対話モードに加え、CIでの利用を想定した非対話モード（`--non-interactive`）に対応します。
+
+```bash
+cd my-project
+accel deploy
+```
+
+- プロジェクトのルートで実行します。ビルド成果物は `./target/` 配下に出力されている前提です（`mvn package` で生成される `<artifactId>-<version>.zip`）。
+- 初回実行時に iAP の接続情報（エンドポイントURL・APIキー）の入力を求めます。入力値は `.accel/credentials.json` に保存され、保存値で接続できる限り次回以降は再入力不要です。事前に `accel login`（前述）で設定しておくこともできます。
+  - **APIキーはシークレット情報のため、`.accel/credentials.json` は自動的に `.gitignore` に追加されます**（コミット対象外）。
+  - デプロイ実行前に、トークン検証API（`/oauth/token/verify`）で接続情報の有効性を確認します。保存済みのエンドポイント／APIキーが誤っていて**接続エラーや認証エラー（401 など）になった場合は、その場で再入力を促し、接続できるまでリトライします**。中断したい場合は ESC / Ctrl+C で抜けられます。
+- 既存のステージング環境を一覧から選択します（ステージングは iAP 側で事前に作成しておく必要があります）。
+- デプロイ対象の zip は、`.accel/settings.json` の `artifactId` と `projectVersion` から `<artifactId>-<projectVersion>.zip` を `./target/` 配下で完全一致で特定し、見つかれば自動選択します。
+  - 該当ファイルが見つからない場合、または `.accel/settings.json` が無い場合は、従来通り `./target/` 配下の zip を一覧から選択します（単一なら自動選択）。
+    - この選択式の一覧では、`<artifactId>-main-storage.zip` / `<artifactId>-main-public.zip` / `<artifactId>-sample-jssp-internal.zip` のような**バージョンを含まない途中成果物**（`<artifactId>-` の直後が数字で始まらない zip）を除外します。
+    - ただし、除外した結果 0 件になった場合（`.accel/settings.json` の `artifactId` と実ファイル名の artifactId が乖離しているケースなど）は、除外せず `./target/` 配下の全 zip を選択候補とします。
+  - いずれの場合もデプロイ実行前に最終確認を行います。
+- 送信時、zip は imm 形式としてアップロードされます（送信時のファイル名のみ `.imm` に変更され、ディスク上のファイルはそのままです）。
+
+#### 非対話モード
+
+CIでの利用を想定し、プロンプトを一切出さずにデプロイを実行するモードです。
+
+```bash
+ACCEL_API_KEY=*** accel deploy \
+  --non-interactive \
+  --endpoint https://example.com/imart \
+  --staging-id my-staging \
+  --file ./target/my-app-1.0.0.zip \
+  --description "CI deploy"
+```
+
+- **接続情報**は login と同じく **フラグ ＞ 環境変数（`ACCEL_ENDPOINT` / `ACCEL_API_KEY`）＞ `.accel/credentials.json`** の優先順位で解決します（APIキーは `ACCEL_API_KEY` 環境変数での指定を推奨）。
+- デプロイ前にトークン検証を1回だけ実行します。**失敗時は再入力せず、エラーメッセージを表示して非0終了します**。
+- `--staging-id` は**必須**です（一覧選択は行いません。未指定はエラー終了。存在しないステージングはデプロイ時の 404 として表面化します）。
+- デプロイ対象 zip:
+  - `--file` を指定した場合はそのパス（`./target/` 配下に限定しません）を使います。ファイルが存在しなければエラー終了します。
+  - `--file` 未指定の場合は対話モードと同じ自動特定（`<artifactId>-<projectVersion>.zip` 完全一致）を試みます。**自動特定できない場合**（settings 無し／完全一致無し／複数候補）は `--file` 指定が必要な旨を表示してエラー終了します。`./target/` に zip が 1 件も無い場合は、ビルド未実行の旨（`mvn package` 等の実行を促す）を表示してエラー終了します。
+- `--description` は任意です。最終確認プロンプトは出さず、即デプロイします。
+- フラグ／環境変数で渡した接続情報は **`.accel/credentials.json` に保存しません**（CIランナーにシークレット情報を残さないため）。
+
+#### オプション一覧
+
+| オプション | 型 | 説明 | デフォルト |
+|---|---|---|---|
+| `--endpoint` | string | iAPのベースURL（環境変数 `ACCEL_ENDPOINT` でも指定可） | 保存値 / 対話で入力 |
+| `--api-key` | string | OAuth Bearerトークン（**環境変数 `ACCEL_API_KEY` 推奨**） | 保存値 / 対話で入力 |
+| `--staging-id` | string | デプロイ先ステージングID（**非対話モードでは必須**） | 対話で一覧選択 |
+| `--file` | string | デプロイする zip のパス（`./target/` 配下に限定しない） | 自動特定 / 対話で選択 |
+| `--description` | string | デプロイメントの説明 | `""` |
+| `--non-interactive` | boolean | 非対話モード（プロンプトを出さず、失敗時は非0終了） | `false` |
+
+#### 接続情報ファイル `.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バージョンと使用モジュールを自動検出します。
@@ -124,6 +245,12 @@ accel detach
 accel init my-project --juggling-project /path/to/juggling-project
 ```
 
+- iAPバージョンは `juggling.im` のベースバージョンを `@intra-mart/catalog` のリリースと突合して解決します
+- モジュールは選択済みモジュールのIDをカタログのモジュールID（`jp.co.intra_mart.im_workflow` 等）と突合し、一致したものを `artifactId`（`im_workflow` 等）として採用します
+  - モジュール自体のバージョンは突合しません（パッチ適用により `8.0.39-PATCH_001` のようにずれることがあるため）
+  - カタログに存在しないモジュールは無視されます
+- 機能（`--feature`）は `juggling.im` から検出できないため自動設定されません
+
 ## プロジェクト構造
 
 `accel init` 実行後に生成されるディレクトリ構造:
@@ -144,8 +271,25 @@ 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固定になるように一部処理を変更しています。
+選択可能なiAPバージョン・モジュール・機能は、同梱のマスタデータパッケージ `@intra-mart/catalog` のカタログに基づきます（2025 Spring / 8.0.37 以降）。バージョンは `2026-spring` のようなリリースID形式で指定します。新しいリリースへの対応はカタログの更新によって行われます。
+
+## 入力値のバリデーション
+
+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` | カタログのリリースID（`2025-spring` 以降）に含まれる値 |
+| `--module` | 選択したiAPリリースのカタログに含まれるモジュールの `artifactId`（例: `im_workflow`, `im_activiti`）のいずれか（各要素） |
+| `--feature` | 選択したiAPリリースのカタログに含まれる機能ID（例: `jssp`, `imds`, `i18n`, `e2e`）のいずれか（各要素） |
+| `--database` | `postgresql`, `oracle`, `sqlserver` のいずれか |
+| `--agent` | `claude-code`, `github-copilot` のいずれか（各要素） |
+| `--package-manager` | `bun`, `npm`, `yarn`, `pnpm` のいずれか |

package/dist/asset/deployer.js

@@ -1,9 +1,10 @@
 import { readFile, writeFile, mkdir, stat } from "node:fs/promises";
 import { join, dirname, resolve, sep } from "node:path";
-import { labelToSemver } from "../core/version-map.js";
+import { buildEvalContext } from "../core/eval-context.js";
 import { walkAssetRepo } from "./walker.js";
 import { processMarkdown } from "../markdown/processor.js";
 import { applyRegexReplacements } from "./regex-replacement.js";
+import { applyForeachReplacements } from "./foreach-replacement.js";
 import { computeSha1 } from "../utils/hash.js";
 import { writeSettings, writeHashsum } from "../utils/settings-io.js";
 import { execSync } from "node:child_process";
@@ -57,22 +58,8 @@ export const deployAssets = async (options) => {
     try {
         progress?.onFetchStart?.();
         const repoDir = await provider.fetch();
-        const semver = labelToSemver(settings.accelplatformVersion);
-        const context = {
-            version: semver,
-            modules: settings.modules,
-            locale: settings.locale,
-            agents: settings.agents,
-            name: settings.name,
-            artifactId: settings.artifactId,
-            group: settings.group,
-            description: settings.description,
-            accelplatformVersion: settings.accelplatformVersion,
-            database: settings.database,
-            projectVersion: settings.projectVersion,
-            packageManager: settings.packageManager,
-            javascript: settings.javascript,
-        };
+        const semver = settings.accelplatformVersion.semver;
+        const context = buildEvalContext(settings);
         const entries = await walkAssetRepo(repoDir, semver, context);
         const deployedFiles = [];
         const hashEntries = [];
@@ -119,6 +106,10 @@ export const deployAssets = async (options) => {
             let content = await readFile(entry.sourcePath, "utf-8");
             const replacements = collectReplacements(entry);
             if (replacements.length > 0) {
+                const foreachReplacements = replacements.filter((r) => r.type === "foreach");
+                if (foreachReplacements.length > 0) {
+                    content = applyForeachReplacements(content, foreachReplacements, context);
+                }
                 if (targetPath.endsWith(".md")) {
                     content = processMarkdown(content, replacements, context);
                 }

package/dist/asset/foreach-replacement.d.ts

@@ -0,0 +1,2 @@
+import type { EvalContext, ForeachReplacement } from "../core/types.js";
+export declare const applyForeachReplacements: (content: string, replacements: ForeachReplacement[], context: EvalContext) => string;

package/dist/asset/foreach-replacement.js

@@ -0,0 +1,20 @@
+import { evaluateCondition } from "../core/condition-evaluator.js";
+import { interpolateVariables } from "../core/variable-interpolator.js";
+const DEFAULT_SEPARATOR = "\n";
+const itemVariables = (item) => new Map(Object.entries(item).map(([key, value]) => [`item.${key}`, value]));
+export const applyForeachReplacements = (content, replacements, context) => {
+    let result = content;
+    for (const replacement of replacements) {
+        if (!evaluateCondition(replacement.condition, context)) {
+            continue;
+        }
+        const items = replacement.items === "modules"
+            ? context.moduleItems
+            : context.featureItems;
+        const expanded = items
+            .map((item) => interpolateVariables(replacement.template, context, itemVariables(item)))
+            .join(replacement.separator ?? DEFAULT_SEPARATOR);
+        result = result.split(replacement.target).join(expanded);
+    }
+    return result;
+};

package/dist/asset/github-provider.d.ts

@@ -0,0 +1,2 @@
+import type { AssetProvider } from "../core/types.js";
+export declare const createGitHubAssetProvider: (repoUrl: string, ref: string) => AssetProvider;

package/dist/asset/github-provider.js

@@ -0,0 +1,37 @@
+import { join } from "node:path";
+import { mkdir, rm, readdir } from "node:fs/promises";
+import { extractTarGz, createTempDir } from "../utils/archive.js";
+import { downloadFile } from "../utils/https.js";
+export const createGitHubAssetProvider = (repoUrl, ref) => {
+    let tmpDir = null;
+    return {
+        fetch: async () => {
+            tmpDir = await createTempDir("accel-assets-");
+            const archivePath = join(tmpDir, "assets.tar.gz");
+            const extractDir = join(tmpDir, "repo");
+            await mkdir(extractDir, { recursive: true });
+            const base = repoUrl.replace(/\/+$/, "");
+            const archiveUrl = `${base}/archive/${ref}.tar.gz`;
+            try {
+                await downloadFile(archiveUrl, archivePath);
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to fetch the asset repository from ${archiveUrl}. Check the URL and ref: ${reason}`);
+            }
+            await extractTarGz(archivePath, extractDir);
+            const entries = await readdir(extractDir, { withFileTypes: true });
+            const dirs = entries.filter((e) => e.isDirectory());
+            if (dirs.length !== 1) {
+                throw new Error(`Unexpected tarball structure (top-level directory count: ${dirs.length}).`);
+            }
+            return join(extractDir, dirs[0].name);
+        },
+        cleanup: async () => {
+            if (tmpDir) {
+                await rm(tmpDir, { recursive: true, force: true }).catch(() => { });
+                tmpDir = null;
+            }
+        },
+    };
+};

package/dist/asset/local-provider.js

@@ -1,28 +1,7 @@
-import { get } from "node:http";
-import { createWriteStream } from "node:fs";
 import { join } from "node:path";
 import { mkdir, rm } from "node:fs/promises";
 import { extractTarGz, createTempDir } from "../utils/archive.js";
-const downloadFile = (url, destPath) => {
-    return new Promise((resolve, reject) => {
-        const file = createWriteStream(destPath);
-        get(url, (response) => {
-            if (response.statusCode !== 200) {
-                file.close();
-                reject(new Error(`HTTP ${response.statusCode} when downloading from ${url}`));
-                return;
-            }
-            response.pipe(file);
-            file.on("finish", () => {
-                file.close();
-                resolve();
-            });
-        }).on("error", (err) => {
-            file.close();
-            reject(err);
-        });
-    });
-};
+import { downloadFile } from "../utils/https.js";
 export const createLocalAssetProvider = (serverUrl) => {
     let tmpDir = null;
     return {

package/dist/asset/walker.js

@@ -1,6 +1,7 @@
 import { readdir, readFile } from "node:fs/promises";
 import { join, relative, dirname, sep } from "node:path";
 import { evaluateCondition } from "../core/condition-evaluator.js";
+import { emptyEvalContext } from "../core/eval-context.js";
 const toPosixPath = (p) => sep === "/" ? p : p.split(sep).join("/");
 const META_FILE = "_meta.json";
 const readMetaJson = async (dir) => {
@@ -41,21 +42,9 @@ const findMatchingVersionDirs = async (repoDir, targetSemver) => {
             continue;
         }
         if (meta.conditions) {
-            const context = {
-                version: targetSemver,
-                modules: [],
-                locale: "",
-                agents: [],
-                name: "",
-                artifactId: "",
-                group: "",
-                description: "",
-                accelplatformVersion: "",
-                database: "",
-                projectVersion: "",
-                packageManager: "",
-                javascript: false,
-            };
+            const context = emptyEvalContext({
+                accelplatformVersion: { label: "", semver: targetSemver },
+            });
             if (evaluateCondition(meta.conditions, context)) {
                 matched.push(dirPath);
             }

package/dist/commands/attach.d.ts

@@ -11,6 +11,10 @@ export declare const attachCommand: import("citty").CommandDef<{
         type: "string";
         description: string;
     };
+    feature: {
+        type: "string";
+        description: string;
+    };
     name: {
         type: "string";
         description: string;
@@ -66,11 +70,19 @@ export declare const attachCommand: import("citty").CommandDef<{
         description: string;
         default: false;
     };
+    "asset-server-url": {
+        type: "string";
+        description: string;
+    };
+    "asset-ref": {
+        type: "string";
+        description: string;
+    };
     "asset-source": {
         type: "string";
         description: string;
     };
-    "asset-server-url": {
+    "debug-server-url": {
         type: "string";
         description: string;
     };

package/dist/commands/attach.js

@@ -2,12 +2,12 @@ import { defineCommand } from "citty";
 import * as p from "@clack/prompts";
 import { stat } from "node:fs/promises";
 import { basename, join } from "node:path";
-import { CLI_VERSION } from "../core/constants.js";
+import { CLI_VERSION, DEFAULT_ASSET_REPO_URL, DEFAULT_ASSET_REF, } from "../core/constants.js";
 import { runPrompts } from "../interactive/prompts.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 { createGitHubAssetProvider } from "../asset/github-provider.js";
 import { getMessage } from "../i18n/index.js";
 import { detectLocale } from "../utils/locale-detect.js";
 import { printSummary } from "../interactive/summary.js";
@@ -25,11 +25,15 @@ export const attachCommand = defineCommand({
         },
         "accelplatform-version": {
             type: "string",
-            description: "iAP version (e.g., 2026-Spring)",
+            description: "iAP version (e.g., 2026-spring)",
         },
         module: {
             type: "string",
-            description: "Modules to use (comma-separated)",
+            description: "Modules to use (comma-separated artifactIds, e.g., im_workflow)",
+        },
+        feature: {
+            type: "string",
+            description: "Features to use (comma-separated function ids, e.g., jssp)",
         },
         name: {
             type: "string",
@@ -86,13 +90,21 @@ export const attachCommand = defineCommand({
             description: "Non-interactive mode",
             default: false,
         },
+        "asset-server-url": {
+            type: "string",
+            description: "GitHub repository URL to fetch assets from (overrides the default repository)",
+        },
+        "asset-ref": {
+            type: "string",
+            description: "Git ref (branch/tag/commit) to fetch from the GitHub asset repository. Default: master",
+        },
         "asset-source": {
             type: "string",
-            description: "Local asset source path (tar archive or extracted directory). Defaults to the bundled assets/assets.tar.gz.",
+            description: "(debug) Local asset source path (tar archive or extracted directory)",
         },
-        "asset-server-url": {
+        "debug-server-url": {
             type: "string",
-            description: "Asset server URL (takes precedence over --asset-source when explicitly set)",
+            description: "(debug) Local asset server URL serving GET /archive",
         },
     },
     run: async ({ args }) => {
@@ -109,6 +121,10 @@ export const attachCommand = defineCommand({
         const modules = moduleArg
             ? moduleArg.split(",").map((m) => m.trim())
             : undefined;
+        const featureArg = args.feature;
+        const features = featureArg
+            ? featureArg.split(",").map((f) => f.trim())
+            : undefined;
         const agentArg = args.agent;
         const promptOpts = {
             name: args.name ?? basename(projectDir),
@@ -116,6 +132,7 @@ export const attachCommand = defineCommand({
             jugglingProject: args["juggling-project"],
             accelplatformVersion: args["accelplatform-version"],
             module: modules,
+            feature: features,
             group: args.group,
             projectVersion: args["project-version"],
             description: args.description,
@@ -147,6 +164,7 @@ export const attachCommand = defineCommand({
             description: resolved.description,
             accelplatformVersion: resolved.accelplatformVersion,
             modules: resolved.modules,
+            features: resolved.features,
             database: resolved.database,
             agents: resolved.agents,
             javascript: resolved.javascript,
@@ -155,11 +173,14 @@ export const attachCommand = defineCommand({
             jugglingProject: resolved.jugglingProject,
             deployedAssets: {},
         };
-        const serverUrl = args["asset-server-url"];
-        const assetSource = args["asset-source"] ?? defaultAssetSourcePath();
-        const provider = serverUrl
-            ? createLocalAssetProvider(serverUrl)
-            : createFileAssetProvider(assetSource);
+        const assetSource = args["asset-source"];
+        const debugServerUrl = args["debug-server-url"];
+        const provider = assetSource
+            ? createFileAssetProvider(assetSource)
+            : debugServerUrl
+                ? createLocalAssetProvider(debugServerUrl)
+                : createGitHubAssetProvider(args["asset-server-url"] ??
+                    DEFAULT_ASSET_REPO_URL, args["asset-ref"] ?? DEFAULT_ASSET_REF);
         const isInteractive = !args["non-interactive"];
         const overwriteFlag = args.overwrite;
         if (isInteractive) {

package/dist/commands/deploy.d.ts

@@ -0,0 +1,62 @@
+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;
+    nonInteractive?: boolean;
+    endpoint?: string;
+    apiKey?: string;
+    stagingId?: string;
+    file?: string;
+    description?: string;
+    env?: Record<string, string | undefined>;
+    ensureCredentials?: (projectDir: string, locale: string, seed?: Partial<AccelCredentials>) => Promise<AccelCredentials>;
+    repromptCredentials?: (current: AccelCredentials, locale: string) => Promise<AccelCredentials>;
+    resolveCredentialsOrThrow?: (projectDir: string, locale: string, seed: Partial<AccelCredentials>) => Promise<AccelCredentials>;
+    persistCredentials?: (projectDir: string, creds: AccelCredentials) => Promise<void>;
+    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<{
+    endpoint: {
+        type: "string";
+        description: string;
+    };
+    "api-key": {
+        type: "string";
+        description: string;
+    };
+    "staging-id": {
+        type: "string";
+        description: string;
+    };
+    file: {
+        type: "string";
+        description: string;
+    };
+    description: {
+        type: "string";
+        description: string;
+    };
+    "non-interactive": {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+export {};