i-repo 2.9.1 → 2.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i-repo",
-  "version": "2.9.1",
+  "version": "2.10.1",
   "description": "Modern CLI for ConMas i-Reporter - Built for humans and AI",
   "type": "module",
   "bin": {
@@ -18,6 +18,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "check:adc": "node scripts/check-adc.mjs",
+    "check:spawn": "node scripts/check-spawn.mjs",
+    "healthcheck:smoke": "node scripts/healthcheck-smoke.mjs",
     "gen:agents": "node scripts/gen-agents-md.mjs",
     "audit": "npm audit --omit=dev --audit-level=high",
     "prepublishOnly": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && npm run build"
@@ -29,7 +31,9 @@
     "plugins",
     "scripts/irepo-mcp.mjs",
     "scripts/gen-agents-md.mjs",
-    "scripts/check-adc.mjs"
+    "scripts/check-adc.mjs",
+    "scripts/check-spawn.mjs",
+    "scripts/healthcheck-smoke.mjs"
   ],
   "keywords": [
     "ireporter",

package/plugins/README.md

@@ -1,33 +1,41 @@
-# plugins/ — i-Repo GEMBA OS 同梱プラグイン
+# plugins/ — gemba-adc 参照プラグインの正本
 
-i-Repo GEMBA OS（旧称 i-Repo Data Connector）が利用する i-repo CLI プラグインの**正本**です。
-従来は `~/.i-repo/plugins/` にしか存在せず版管理外でしたが、ここをリポジトリ内の
-single source of truth とし、インストーラで各環境へ配置します。
+`gemba-adc/1.0`（読み返し契約。仕様は [`../spec/gemba-adc/`](../spec/gemba-adc/)）の**参照実装プラグインの正本**です。
+i-repo CLI リポジトリ内の single source of truth とし、インストーラで各環境へ配置します。
+i-Repo GEMBA OS をはじめとする消費者は、これらを npm 依存（`node_modules/i-repo/plugins/`）として取り込みます。
 
-> 構成: 各プラグインは単一ファイル実行体 + 共有ライブラリ `lib/gemba-read.js`
-> （読み返し `query` の共通エンジン: envelope / 時刻3形式パース / keysetカーソル。
-> ADC-1 仕様 `docs/仕様/` 参照）。インストーラが `lib/` ごと配布し、プラグインは
-> `./lib/gemba-read.js` を相対 require する（write 経路は lib 非依存）。
+> 構成: 各プラグインは単一ファイル実行体 + 共有ライブラリ
+> - `lib/gemba-read.js` … 読み返し `query` の共通エンジン（envelope / 時刻3形式パース / keyset カーソル。ADC-1 §3）。
+> - `lib/spawn.js` … 外部 CLI（mongosh / duckdb / bq 等）を spawn する共通層（Windows の `.cmd` ラップ・孫プロセス kill・メタ文字拒否）。`mongo` / `parquet` / `bigquery` が使用。
+>
+> インストーラが `lib/` ごと配布し、プラグインは `./lib/...` を相対 require する（write 経路は lib 非依存）。
 > **プラグインを更新したら必ずインストーラを再実行すること** — アプリ/CLI が呼ぶのは
 > `~/.i-repo/plugins/` のインストール済み実体であり、リポジトリ正本ではない。
+>
+> **実体を変えたら必ず `--plugin-schema` の `version` を上げること。** 下流の消費者（i-Repo GEMBA OS 等）は
+> この実体を**公開ミラーへ再配布**し、その更新検知を `version` ＋ SHA256 で行う。版番据え置きのまま中身だけ
+> 変えると、消費アプリが「更新あり」を検知できず旧版を配り続ける（過去に mongo で版番据え置きの実体差分、
+> archive で再配布漏れによる版ズレが起きた）。npm 公開後、消費側は依存を上げてミラーを再同期する必要がある。
 
 ## 同梱プラグイン
 
-| ファイル | 役割 | 由来 |
-|---|---|---|
-| `i-repo-archive` | 帳票スナップショット＋S3 push。`--with-detail` 対応 | **i-repo CLI公式 archive のパッチ版**（`--with-detail` を追加） |
-| `i-repo-mongo` | MongoDBへupsert | このプロジェクトで作成 |
-| `i-repo-sqlite` | ローカルSQLiteへ蓄積 | このプロジェクトで作成 |
-| `i-repo-elastic` | Elasticsearchへindex | このプロジェクトで作成 |
-| `i-repo-parquet` | Parquet / Apache Iceberg へ書き出し | このプロジェクトで作成 |
+| ファイル | 役割 | query(gemba-read) | native-query |
+|---|---|---|---|
+| `i-repo-sqlite` | ローカル SQLite へ蓄積 | ✅（読み返し参照実装） | sql-select |
+| `i-repo-mongo` | MongoDB へ upsert | ✅ | mongo-aggregation |
+| `i-repo-elastic` | Elasticsearch へ index | ✅ + 全文検索 | es-query-dsl |
+| `i-repo-parquet` | Parquet / Apache Iceberg へ書き出し | ✅ | — |
+| `i-repo-bigquery` | BigQuery へ書き出し（roles: sink/read/analyze） | ✅ | — |
+| `i-repo-archive` | 帳票スナップショット＋クラウド配信／取り戻し | — | — |
 
-> `i-repo-s3` と `i-repo-hello` は i-repo CLI 同梱のサンプルのため含めていません。
-> 使い方は [../docs/プラグイン使い方集/](../docs/プラグイン使い方集/) を参照。
+`i-repo-archive` の配信先（`store`）: `dir-bundle`（create）/ `s3-bundle`（push-s3）/ `gcs-bundle`（push-gcs）/
+`azure-bundle`（push-azure）/ `local-bundle`（push-local）。クラウドからの取り戻し（read-only）に `pull-s3` /
+`pull-gcs` / `pull-azure`、配信先フォルダ名は `--prefix` トークン（`{batchId}`/`{date}`/`{datetime}`/`{flow}`）で
+自由化。`--cleanup`（破壊的）で配信後のローカル stage を掃除。Azure secret は `--sas` / `--connection-string`
+（envVar 解決）。
 
-> ⚠️ `i-repo-archive` はCLI公式プラグインに `--with-detail`（クラスター値・objectKeyの
-> manifest埋め込み）を加えたパッチ版です。CLI本体のアップデートで上書きされる可能性があるため、
-> このリポジトリ版を正本とし、インストーラで配置します。本来はCLIチームへの取り込み依頼が筋
-> （[../docs/CLI要望書/](../docs/CLI要望書/) 参照）。
+> 詳しい契約と読み返しの使い方は [`../docs/DATA-ACCESS.md`](../docs/DATA-ACCESS.md) と
+> [`../docs/PLUGINS.md`](../docs/PLUGINS.md) を参照。`examples/node/i-repo-sqlite-query/` に実行可能な参照例。
 
 ## インストール
 
@@ -35,7 +43,7 @@ single source of truth とし、インストーラで各環境へ配置します
 # macOS / Linux
 ./plugins/install.sh
 
-# Windows (PowerShell) — Node製プラグインの .cmd shim も生成する
+# Windows (PowerShell) — Node 製プラグインの .cmd shim も生成する
 powershell -ExecutionPolicy Bypass -File .\plugins\install.ps1
 ```
 
@@ -43,16 +51,17 @@ powershell -ExecutionPolicy Bypass -File .\plugins\install.ps1
 
 確認:
 ```bash
-i-repo plugin list          # archive/mongo/sqlite/elastic/parquet が見えること
-i-repo plugin verify mongo  # 契約適合チェック
+i-repo plugin list             # sqlite/mongo/elastic/parquet/bigquery/archive が見えること
+i-repo plugin verify sqlite    # 契約適合チェック
 ```
 
 ## 前提
 
-- **Node.js**: mongo/sqlite/elastic/parquet/archive は Node 製。
-  - sqlite は `node:sqlite`（Node 22.5+）、elastic は内蔵 fetch（Node 18+）を使用。
-- 各プラグインの追加依存（任意・使う配信先に応じて）:
+- **Node.js**: 全プラグインが Node 製。
+  - sqlite は `node:sqlite`（Node 22.5+）、elastic は内蔵 fetch を使用。
+- 各プラグインの追加依存（任意・使う配信先／ストアに応じて）:
   - mongo → `mongosh`
-  - parquet → `duckdb`（Iceberg書き込みは DuckDB 1.4+）
-  - archive push-s3 / s3 → `aws` CLI
-- 充足状況は Connector アプリの「プラグイン」タブ、または `i-repo <plugin> --plugin-healthcheck` で確認できる。
+  - parquet → `duckdb`（Iceberg 書き込みは DuckDB 1.4+）
+  - bigquery → `bq`（Google Cloud SDK）
+  - archive のクラウド配信／取り戻し → `aws`（S3）/ `gcloud`・`rsync`（GCS）/ `az`（Azure Blob）
+- 充足状況は `i-repo <plugin> --plugin-healthcheck`、または消費アプリ（GEMBA OS）の「プラグイン」タブで確認できる。