@h-ai/cli 1.0.0-beta.7 → 1.0.0-beta.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +6 -6
- package/README.ja.md +6 -6
- package/README.md +6 -6
- package/dist/{chunk-XI5SKOOR.js → chunk-MEEFB4BI.js} +2 -2
- package/dist/{chunk-XI5SKOOR.js.map → chunk-MEEFB4BI.js.map} +1 -1
- package/dist/{chunk-RT5OZJKM.js → chunk-SGWSVWZ5.js} +3 -3
- package/dist/{chunk-RT5OZJKM.js.map → chunk-SGWSVWZ5.js.map} +1 -1
- package/dist/cli-config-templates-SVV3633D.js +5 -0
- package/dist/{cli-config-templates-5KS3AE4H.js.map → cli-config-templates-SVV3633D.js.map} +1 -1
- package/dist/index.js +64 -50
- package/dist/index.js.map +1 -1
- package/dist/metafile-esm.json +1 -1
- package/dist/{src-CX5IJGYM.js → src-IW4CY2IN.js} +3 -3
- package/dist/src-IW4CY2IN.js.map +1 -0
- package/package.json +16 -12
- package/templates/apps/api/apps/{{projectName}}-serv/config/_serv.yml.hbs +1 -1
- package/templates/apps/api/apps/{{projectName}}-serv/src/app.ts.hbs +6 -2
- package/templates/apps/api/apps/{{projectName}}-serv/tests/service.test.ts.hbs +29 -3
- package/templates/apps/fullstack/.gitignore.hbs +7 -2
- package/templates/apps/fullstack/apps/{{projectName}}-app/README.md.hbs +2 -0
- package/templates/apps/fullstack/apps/{{projectName}}-app/package.json.hbs +1 -1
- package/templates/apps/mobile-app/messages/en-US.json +1 -1
- package/templates/apps/mobile-app/messages/ja-JP.json +1 -1
- package/templates/apps/mobile-app/messages/zh-CN.json +1 -1
- package/templates/apps/mobile-app/src/lib/api.ts.hbs +8 -5
- package/templates/base/.gitignore.hbs +7 -2
- package/templates/base/e2e/app.spec.ts.hbs +9 -4
- package/templates/base/package.json.hbs +2 -2
- package/templates/skills/hai-ai/acp.md +2 -0
- package/templates/skills/hai-ai/reference.md +1 -1
- package/templates/skills/hai-api-client/reference.md +2 -0
- package/templates/skills/hai-cache/reference.md +6 -2
- package/templates/skills/hai-core/SKILL.md +1 -1
- package/templates/skills/hai-crypto/reference.md +2 -0
- package/templates/skills/hai-payment/reference.md +39 -17
- package/templates/skills/hai-reach/reference.md +15 -7
- package/templates/skills/hai-reldb/reference.md +5 -2
- package/templates/skills/hai-scheduler/reference.md +1 -1
- package/templates/skills/hai-storage/reference.md +8 -2
- package/templates/skills/hai-ui/SKILL.md +3 -1
- package/templates/skills/hai-ui/charts.md +51 -0
- package/templates/skills/hai-vecdb/reference.md +7 -2
- package/dist/cli-config-templates-5KS3AE4H.js +0 -5
- package/dist/src-CX5IJGYM.js.map +0 -1
package/README.en.md
CHANGED
|
@@ -23,12 +23,12 @@ Use `hai` to create applications, add modules, generate starter code, build and
|
|
|
23
23
|
|
|
24
24
|
Use Node.js matching `engines` (`^22.23.4 || ^24.22.1 || ^26.12.1`) and pnpm 12.11.2. In PowerShell use `pnpm.cmd`.
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
Inspect the published channels and install latest. Check supported options with `hai create --help`; validate unreleased source features using the local development steps below.
|
|
27
27
|
|
|
28
28
|
```sh
|
|
29
29
|
pnpm view @h-ai/cli dist-tags
|
|
30
|
-
pnpm view @h-ai/cli@
|
|
31
|
-
pnpm add -g @h-ai/cli@
|
|
30
|
+
pnpm view @h-ai/cli@latest version
|
|
31
|
+
pnpm add -g @h-ai/cli@latest
|
|
32
32
|
hai --version
|
|
33
33
|
hai --help
|
|
34
34
|
```
|
|
@@ -38,7 +38,7 @@ Generated framework dependencies use the exact CLI version. Installation failure
|
|
|
38
38
|
### Create an application
|
|
39
39
|
|
|
40
40
|
```sh
|
|
41
|
-
hai create my-app --type fullstack --frontends web
|
|
41
|
+
hai create my-app --type fullstack --frontends web
|
|
42
42
|
cd my-app
|
|
43
43
|
pnpm dev
|
|
44
44
|
```
|
|
@@ -101,7 +101,7 @@ hai generate model order
|
|
|
101
101
|
hai generate migration add-orders
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
`hai add` resolves module dependencies and fills configuration. `hai init` fills missing configuration and AI files while preserving custom content. `--force` regenerates module configuration; review the diff before using it.
|
|
104
|
+
`hai add` resolves module dependencies and fills configuration. `hai init` fills missing configuration and AI files while preserving custom content. `--force` regenerates module configuration; review the diff before using it. Already listed modules are checked for missing transitive dependencies and workspace catalog entries. Rerun the same command after an earlier failed install; existing versions, comments and configured values are preserved.
|
|
105
105
|
|
|
106
106
|
Pages use SvelteKit file routes. APIs use either SvelteKit routes or the target serv application's shared contract/procedure structure. API/fullstack roots select a unique backend automatically; use `--workspace <package-name-or-relative-path>` when multiple applications apply, or enter the target workspace. Plain Vite page/API combinations are rejected. Serv does not accept `--output`; SvelteKit route output must stay inside `src/routes`; custom `kit.files` layouts are rejected rather than guessed. SvelteKit API targets must already install `@h-ai/kit` and `zod`. Serv updates only existing aggregation points with `@hai-generator` markers; unknown structures require manual integration. Names cannot contain paths. Existing files require `--force`, which never replaces registered business domains. Files are checked as one batch and rolled back on write failure. Migrations only generate up/down functions; inspect data effects before running them.
|
|
107
107
|
|
|
@@ -200,7 +200,7 @@ The [fullstack security configuration guide template](templates/apps/fullstack/d
|
|
|
200
200
|
|
|
201
201
|
### Feedback and offline analysis
|
|
202
202
|
|
|
203
|
-
A new `hai create my-app --type fullstack --frontends web
|
|
203
|
+
A new `hai create my-app --type fullstack --frontends web` includes feedback by default; API projects also include it without additional options. Members and business operators can submit reports. Only `business_operator` sees the review menu and can read, process, reopen or export reports. Database, storage, reach and authentication dependencies are included. Fullstack provides intake, paginated review and server contracts; API projects provide the server contracts. Production uses shared DB and private S3. Notifications independently select `disabled`, `console` or `reach`; `console` defaults to `metadata` only. Select `consoleContent: summary` explicitly for summaries, or configure Reach providers and recipients for actual delivery.
|
|
204
204
|
|
|
205
205
|
Register collectEvidence through feedback.init(config, { collectEvidence }) to await business text or archives. _feedback.yml includes businessCollectionTimeoutMs and webhookUrl/webhookSecret/webhookTimeoutMs. Webhook delivery retries durably and exposes status and administrator retry in details. Keep secrets in private server environment settings; see [feedback examples](../feedback/README.en.md).
|
|
206
206
|
|
package/README.ja.md
CHANGED
|
@@ -23,12 +23,12 @@
|
|
|
23
23
|
|
|
24
24
|
Node.js は `engines`(`^22.23.4 || ^24.22.1 || ^26.12.1`)に合わせ、pnpm 12.11.2 を使用します。PowerShell では `pnpm.cmd` を使用してください。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
公開チャネルを確認して latest をインストールします。`hai create --help` で対応オプションを確認し、未公開機能は下記のローカル開発手順で検証してください。
|
|
27
27
|
|
|
28
28
|
```sh
|
|
29
29
|
pnpm view @h-ai/cli dist-tags
|
|
30
|
-
pnpm view @h-ai/cli@
|
|
31
|
-
pnpm add -g @h-ai/cli@
|
|
30
|
+
pnpm view @h-ai/cli@latest version
|
|
31
|
+
pnpm add -g @h-ai/cli@latest
|
|
32
32
|
hai --version
|
|
33
33
|
hai --help
|
|
34
34
|
```
|
|
@@ -38,7 +38,7 @@ hai --help
|
|
|
38
38
|
### アプリの作成
|
|
39
39
|
|
|
40
40
|
```sh
|
|
41
|
-
hai create my-app --type fullstack --frontends web
|
|
41
|
+
hai create my-app --type fullstack --frontends web
|
|
42
42
|
cd my-app
|
|
43
43
|
pnpm dev
|
|
44
44
|
```
|
|
@@ -101,7 +101,7 @@ hai generate model order
|
|
|
101
101
|
hai generate migration add-orders
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
`hai add` は依存を解決して設定を追加します。`hai init` は不足する設定と AI ファイルを補い、独自内容は保持します。`--force` はモジュール設定を再生成するため、差分を確認して使用してください。
|
|
104
|
+
`hai add` は依存を解決して設定を追加します。`hai init` は不足する設定と AI ファイルを補い、独自内容は保持します。`--force` はモジュール設定を再生成するため、差分を確認して使用してください。 既存モジュールも推移的依存と workspace catalog の不足を検査します。旧版でインストールに失敗した場合は同じコマンドを再実行でき、既存の版・コメント・設定値を保持します。
|
|
105
105
|
|
|
106
106
|
page は SvelteKit のファイルルートに対応し、api は対象アプリに応じて SvelteKit または serv の共有 contract/procedure を生成します。API/fullstack のルートでは一意なバックエンドを自動選択します。複数候補は `--workspace <パッケージ名または相対パス>` で指定するか、対象 workspace に移動してください。通常の Vite への page/api 生成は拒否します。serv は `--output` を受け付けず、SvelteKit の出力は `src/routes` 内に限定し、独自の `kit.files` は推測せず拒否します。SvelteKit API には `@h-ai/kit` と `zod` が必要です。serv は `@hai-generator` マーカーのある既存の集約入口だけを更新し、未知の構成には手動統合を要求します。名前にパスは指定できません。既存ファイルは `--force` が必要ですが、登録済み業務領域は置換しません。一括検査後に書き込み、失敗時は今回の変更を戻します。マイグレーションは up/down 関数のみ生成するため、実行前にデータへの影響を確認してください。
|
|
107
107
|
|
|
@@ -202,7 +202,7 @@ fullstack 例はアプリ設定で `admin`、`audit_admin`、`config_admin`、`b
|
|
|
202
202
|
|
|
203
203
|
feedback.init(config, { collectEvidence }) で業務の本文・ZIP を非同期収集できます。_feedback.yml は businessCollectionTimeoutMs と webhookUrl/webhookSecret/webhookTimeoutMs を提供します。Webhook は永続再試行と詳細画面での状態確認・再試行に対応し、秘密はサーバー非公開環境に保存します。[feedback の例](../feedback/README.ja.md) を参照してください。
|
|
204
204
|
|
|
205
|
-
`hai create my-app --type fullstack --frontends web
|
|
205
|
+
`hai create my-app --type fullstack --frontends web` は問題報告を既定で有効にし、API 工程にも追加引数なしで feedback を含めます。一般会員と業務操作員が報告でき、管理メニューの表示と閲覧・処理・再開・エクスポートは `business_operator` に限定します。DB・ストレージ・通知・認証の依存を補い、Fullstack では収集、ページ一覧とサーバー API、API 工程ではサーバー API を生成します。本番では共有 DB と非公開 S3 を使用します。通知は `disabled`、`console`、`reach` を独立に選び、`console` の既定は `metadata` のみです。要約は `consoleContent: summary` を明示し、実送信が必要な場合に Reach 通路と受信者を設定します。
|
|
206
206
|
|
|
207
207
|
`hai feedback summary <bundle.zip>`、`inspect`、`evidence --request-id <ID> --page 1 --page-size 20`、`view` で本番へ接続せず分析できます。表示はloopbackのみで待機し、Ctrl+Cで閉じます。
|
|
208
208
|
|
package/README.md
CHANGED
|
@@ -23,12 +23,12 @@
|
|
|
23
23
|
|
|
24
24
|
需要符合项目 `engines` 的 Node.js(`^22.23.4 || ^24.22.1 || ^26.12.1`)与 pnpm 12.11.2。PowerShell 使用 `pnpm.cmd`。
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
先查询已发布渠道,再安装当前 latest。使用 `hai create --help` 核对所安装版本支持的选项;尚未发布的源码能力按下方本地开发步骤验证。
|
|
27
27
|
|
|
28
28
|
```sh
|
|
29
29
|
pnpm view @h-ai/cli dist-tags
|
|
30
|
-
pnpm view @h-ai/cli@
|
|
31
|
-
pnpm add -g @h-ai/cli@
|
|
30
|
+
pnpm view @h-ai/cli@latest version
|
|
31
|
+
pnpm add -g @h-ai/cli@latest
|
|
32
32
|
hai --version
|
|
33
33
|
hai --help
|
|
34
34
|
```
|
|
@@ -38,7 +38,7 @@ hai --help
|
|
|
38
38
|
### 创建项目
|
|
39
39
|
|
|
40
40
|
```sh
|
|
41
|
-
hai create my-app --type fullstack --frontends web
|
|
41
|
+
hai create my-app --type fullstack --frontends web
|
|
42
42
|
cd my-app
|
|
43
43
|
pnpm dev
|
|
44
44
|
```
|
|
@@ -101,7 +101,7 @@ hai generate model order
|
|
|
101
101
|
hai generate migration add-orders
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
`hai add` 解析模块依赖并补充配置。`hai init` 补齐缺失配置和 AI 文件,保留已有自定义内容;`--force` 可重建模块配置,使用前检查差异。
|
|
104
|
+
`hai add` 解析模块依赖并补充配置。`hai init` 补齐缺失配置和 AI 文件,保留已有自定义内容;`--force` 可重建模块配置,使用前检查差异。 已有模块也会检查传递依赖与所属 workspace 的 catalog;旧版安装失败后可重跑同一命令修复,保留已有版本、注释和配置值。
|
|
105
105
|
|
|
106
106
|
page 只支持 SvelteKit 文件路由;api 会按目标应用选择 SvelteKit 文件路由或 serv 的共享 contract/procedure。API/fullstack 根目录可自动选择唯一后端;多应用用 `--workspace <包名或相对路径>`,也可进入目标 workspace。纯 Vite 的 page/api 组合明确拒绝;serv 不接受 `--output`,SvelteKit 路由输出须位于 `src/routes` 内,定制 `kit.files` 时明确拒绝猜测;API 目标须已安装 `@h-ai/kit` 与 `zod`。serv 只改写带 `@hai-generator` 标记的既有聚合入口,未知结构要求手动扩展,不创建平行路由。名称不能包含路径;默认拒绝覆盖,`--force` 只替换生成文件,不覆盖已有业务领域注册。整批预检,写入失败回滚本次修改。迁移只生成 up/down 函数,不自动执行;运行前确认数据影响。
|
|
107
107
|
|
|
@@ -200,7 +200,7 @@ fullstack 的逐项开关、默认值、启用前提与使用影响见[配置化
|
|
|
200
200
|
|
|
201
201
|
### 问题反馈与离线分析
|
|
202
202
|
|
|
203
|
-
使用 `hai create my-app --type fullstack --frontends web
|
|
203
|
+
使用 `hai create my-app --type fullstack --frontends web` 默认启用反馈;API 工程也默认包含反馈,无需额外参数。普通成员及业务操作员可提交反馈,`business_operator` 才显示管理菜单并能查看、处理、撤销和导出;自动补齐数据库、存储、触达与认证依赖。Fullstack 生成收集入口、分页管理页和服务端接口;API 工程生成服务端接口。生产使用共享 DB 和私有 S3;通知独立选择 `disabled`、`console` 或 `reach`,默认 `console` 只输出 `metadata`。需要摘要时显式设 `consoleContent: summary`,需要实际发送时再配置 Reach 通道与收件人。
|
|
204
204
|
|
|
205
205
|
业务扩展在 feedback.init(config, { collectEvidence }) 中 await 文本/ZIP 等材料;_feedback.yml 提供 businessCollectionTimeoutMs、webhookUrl/webhookSecret/webhookTimeoutMs。Webhook 独立持久重试,详情可查看状态并重试;密钥仅放服务端私有环境。见 [feedback 配置与示例](../feedback/README.md)。
|
|
206
206
|
|
|
@@ -35734,5 +35734,5 @@ async function acquireImportLock(path, root) {
|
|
|
35734
35734
|
}
|
|
35735
35735
|
|
|
35736
35736
|
export { DEPLOY_MIDDLEWARE, DeployConfigSchema, DeploymentArtifactSchema, HaiDeployError, ProviderConfigSchema, artifactChecksum, canKeepMiddleware, createDeploymentPlan, deploy, describeMiddlewareBackend, getDeployCommandState, getDeployRecovery, importDeploymentSecrets, loadDeploymentConfig, loadDeploymentEnvironment, mergeEnvironmentLayers, normalizeProjectName, parseMiddlewareField, readDeploymentArtifact, resolveDownloadProxy, resolveImageReference, saveDeploymentEnvironment, saveMiddlewareEnvironment, validateMiddlewareField };
|
|
35737
|
-
//# sourceMappingURL=chunk-
|
|
35738
|
-
//# sourceMappingURL=chunk-
|
|
35737
|
+
//# sourceMappingURL=chunk-MEEFB4BI.js.map
|
|
35738
|
+
//# sourceMappingURL=chunk-MEEFB4BI.js.map
|