@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.
Files changed (44) hide show
  1. package/README.en.md +6 -6
  2. package/README.ja.md +6 -6
  3. package/README.md +6 -6
  4. package/dist/{chunk-XI5SKOOR.js → chunk-MEEFB4BI.js} +2 -2
  5. package/dist/{chunk-XI5SKOOR.js.map → chunk-MEEFB4BI.js.map} +1 -1
  6. package/dist/{chunk-RT5OZJKM.js → chunk-SGWSVWZ5.js} +3 -3
  7. package/dist/{chunk-RT5OZJKM.js.map → chunk-SGWSVWZ5.js.map} +1 -1
  8. package/dist/cli-config-templates-SVV3633D.js +5 -0
  9. package/dist/{cli-config-templates-5KS3AE4H.js.map → cli-config-templates-SVV3633D.js.map} +1 -1
  10. package/dist/index.js +64 -50
  11. package/dist/index.js.map +1 -1
  12. package/dist/metafile-esm.json +1 -1
  13. package/dist/{src-CX5IJGYM.js → src-IW4CY2IN.js} +3 -3
  14. package/dist/src-IW4CY2IN.js.map +1 -0
  15. package/package.json +16 -12
  16. package/templates/apps/api/apps/{{projectName}}-serv/config/_serv.yml.hbs +1 -1
  17. package/templates/apps/api/apps/{{projectName}}-serv/src/app.ts.hbs +6 -2
  18. package/templates/apps/api/apps/{{projectName}}-serv/tests/service.test.ts.hbs +29 -3
  19. package/templates/apps/fullstack/.gitignore.hbs +7 -2
  20. package/templates/apps/fullstack/apps/{{projectName}}-app/README.md.hbs +2 -0
  21. package/templates/apps/fullstack/apps/{{projectName}}-app/package.json.hbs +1 -1
  22. package/templates/apps/mobile-app/messages/en-US.json +1 -1
  23. package/templates/apps/mobile-app/messages/ja-JP.json +1 -1
  24. package/templates/apps/mobile-app/messages/zh-CN.json +1 -1
  25. package/templates/apps/mobile-app/src/lib/api.ts.hbs +8 -5
  26. package/templates/base/.gitignore.hbs +7 -2
  27. package/templates/base/e2e/app.spec.ts.hbs +9 -4
  28. package/templates/base/package.json.hbs +2 -2
  29. package/templates/skills/hai-ai/acp.md +2 -0
  30. package/templates/skills/hai-ai/reference.md +1 -1
  31. package/templates/skills/hai-api-client/reference.md +2 -0
  32. package/templates/skills/hai-cache/reference.md +6 -2
  33. package/templates/skills/hai-core/SKILL.md +1 -1
  34. package/templates/skills/hai-crypto/reference.md +2 -0
  35. package/templates/skills/hai-payment/reference.md +39 -17
  36. package/templates/skills/hai-reach/reference.md +15 -7
  37. package/templates/skills/hai-reldb/reference.md +5 -2
  38. package/templates/skills/hai-scheduler/reference.md +1 -1
  39. package/templates/skills/hai-storage/reference.md +8 -2
  40. package/templates/skills/hai-ui/SKILL.md +3 -1
  41. package/templates/skills/hai-ui/charts.md +51 -0
  42. package/templates/skills/hai-vecdb/reference.md +7 -2
  43. package/dist/cli-config-templates-5KS3AE4H.js +0 -5
  44. 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
- The following uses the target beta version. Check the published channel and availability of `1.0.0-beta.1` before installing. The acceptance target does not mean it has been published; an unversioned install selects latest rather than beta.
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@1.0.0-beta.1 version
31
- pnpm add -g @h-ai/cli@1.0.0-beta.1
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 --defaults
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 --defaults` 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.
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
- 以下は目標Beta版です。公開チャネルと `1.0.0-beta.1` の提供状況を確認してからインストールしてください。検証対象であることは公開済みの意味ではありません。版を省略するとlatestとなり、Betaを自動選択しません。
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@1.0.0-beta.1 version
31
- pnpm add -g @h-ai/cli@1.0.0-beta.1
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 --defaults
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 --defaults` は問題報告を既定で有効にし、API 工程にも追加引数なしで feedback を含めます。一般会員と業務操作員が報告でき、管理メニューの表示と閲覧・処理・再開・エクスポートは `business_operator` に限定します。DB・ストレージ・通知・認証の依存を補い、Fullstack では収集、ページ一覧とサーバー API、API 工程ではサーバー API を生成します。本番では共有 DB と非公開 S3 を使用します。通知は `disabled`、`console`、`reach` を独立に選び、`console` の既定は `metadata` のみです。要約は `consoleContent: summary` を明示し、実送信が必要な場合に Reach 通路と受信者を設定します。
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
- 以下使用目标 Beta 版;先核对实际发布渠道与 `1.0.0-beta.1` 是否可用,再安装。当前验收目标不代表已经发布;不带版本会选择 latest,不会自动选择 Beta。
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@1.0.0-beta.1 version
31
- pnpm add -g @h-ai/cli@1.0.0-beta.1
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 --defaults
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 --defaults` 默认启用反馈;API 工程也默认包含反馈,无需额外参数。普通成员及业务操作员可提交反馈,`business_operator` 才显示管理菜单并能查看、处理、撤销和导出;自动补齐数据库、存储、触达与认证依赖。Fullstack 生成收集入口、分页管理页和服务端接口;API 工程生成服务端接口。生产使用共享 DB 和私有 S3;通知独立选择 `disabled`、`console` 或 `reach`,默认 `console` 只输出 `metadata`。需要摘要时显式设 `consoleContent: summary`,需要实际发送时再配置 Reach 通道与收件人。
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-XI5SKOOR.js.map
35738
- //# sourceMappingURL=chunk-XI5SKOOR.js.map
35737
+ //# sourceMappingURL=chunk-MEEFB4BI.js.map
35738
+ //# sourceMappingURL=chunk-MEEFB4BI.js.map