i-repo 2.8.0 → 2.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i-repo",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "description": "Modern CLI for ConMas i-Reporter - Built for humans and AI",
   "type": "module",
   "bin": {
@@ -17,12 +17,19 @@
     "generate:fixtures": "node scripts/generate-fixtures.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
+    "check:adc": "node scripts/check-adc.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"
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "spec/gemba-adc",
+    "plugins",
+    "scripts/irepo-mcp.mjs",
+    "scripts/gen-agents-md.mjs",
+    "scripts/check-adc.mjs"
   ],
   "keywords": [
     "ireporter",

package/plugins/README.md

@@ -0,0 +1,58 @@
+# plugins/ — i-Repo GEMBA OS 同梱プラグイン
+
+i-Repo GEMBA OS（旧称 i-Repo Data Connector）が利用する i-repo CLI プラグインの**正本**です。
+従来は `~/.i-repo/plugins/` にしか存在せず版管理外でしたが、ここをリポジトリ内の
+single source of truth とし、インストーラで各環境へ配置します。
+
+> 構成: 各プラグインは単一ファイル実行体 + 共有ライブラリ `lib/gemba-read.js`
+> （読み返し `query` の共通エンジン: envelope / 時刻3形式パース / keysetカーソル。
+> ADC-1 仕様 `docs/仕様/` 参照）。インストーラが `lib/` ごと配布し、プラグインは
+> `./lib/gemba-read.js` を相対 require する（write 経路は lib 非依存）。
+> **プラグインを更新したら必ずインストーラを再実行すること** — アプリ/CLI が呼ぶのは
+> `~/.i-repo/plugins/` のインストール済み実体であり、リポジトリ正本ではない。
+
+## 同梱プラグイン
+
+| ファイル | 役割 | 由来 |
+|---|---|---|
+| `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 へ書き出し | このプロジェクトで作成 |
+
+> `i-repo-s3` と `i-repo-hello` は i-repo CLI 同梱のサンプルのため含めていません。
+> 使い方は [../docs/プラグイン使い方集/](../docs/プラグイン使い方集/) を参照。
+
+> ⚠️ `i-repo-archive` はCLI公式プラグインに `--with-detail`（クラスター値・objectKeyの
+> manifest埋め込み）を加えたパッチ版です。CLI本体のアップデートで上書きされる可能性があるため、
+> このリポジトリ版を正本とし、インストーラで配置します。本来はCLIチームへの取り込み依頼が筋
+> （[../docs/CLI要望書/](../docs/CLI要望書/) 参照）。
+
+## インストール
+
+```bash
+# macOS / Linux
+./plugins/install.sh
+
+# Windows (PowerShell) — Node製プラグインの .cmd shim も生成する
+powershell -ExecutionPolicy Bypass -File .\plugins\install.ps1
+```
+
+配置先は既定で `~/.i-repo/plugins/`（環境変数 `IREPO_PLUGIN_DIR` で変更可）。
+
+確認:
+```bash
+i-repo plugin list          # archive/mongo/sqlite/elastic/parquet が見えること
+i-repo plugin verify mongo  # 契約適合チェック
+```
+
+## 前提
+
+- **Node.js**: mongo/sqlite/elastic/parquet/archive は Node 製。
+  - sqlite は `node:sqlite`（Node 22.5+）、elastic は内蔵 fetch（Node 18+）を使用。
+- 各プラグインの追加依存（任意・使う配信先に応じて）:
+  - mongo → `mongosh`
+  - parquet → `duckdb`（Iceberg書き込みは DuckDB 1.4+）
+  - archive push-s3 / s3 → `aws` CLI
+- 充足状況は Connector アプリの「プラグイン」タブ、または `i-repo <plugin> --plugin-healthcheck` で確認できる。