i-repo 2.6.0 → 2.7.0

package/dist/commands/plugin.js

@@ -106,9 +106,17 @@ pluginCommand
             if (Array.isArray(row.platforms)) {
                 row.platforms = row.platforms.join(", ");
             }
+            if (Array.isArray(row.input)) {
+                row.input = row.input.join(", ");
+            }
             if (Array.isArray(row.subcommands)) {
                 row.subcommands = row.subcommands
-                    .map((s) => (s.description ? `${String(s.name)} (${String(s.description)})` : String(s.name)))
+                    .map((s) => {
+                    const intake = Array.isArray(s.input) ? ` [${s.input.join("/")}]` : "";
+                    return s.description
+                        ? `${String(s.name)}${intake} (${String(s.description)})`
+                        : `${String(s.name)}${intake}`;
+                })
                     .join(", ");
             }
         }

package/dist/plugins/describe.d.ts

@@ -21,6 +21,15 @@ export declare const KNOWN_PLATFORMS: readonly ["macos", "linux", "windows"];
 export type PluginPlatform = (typeof KNOWN_PLATFORMS)[number];
 /** process.platform → platforms 語彙。未知の OS は null (= ゲート対象外) */
 export declare function platformKeywordFor(p: NodeJS.Platform): PluginPlatform | null;
+/**
+ * input (intake = データの受け取り方) の閉じた語彙 (要望書v2)。
+ * 「どう渡すか」を実行前に機械可読にする — sink にディレクトリを渡す等の
+ * 取り違えを連携側 (GUI/Connector) が起動前に検出できるようにする。
+ * CLI 本体はこれでゲートしない (宣言した意図を伝えるヒント。成否の判定は
+ * あくまで receipt の verified)。
+ */
+export declare const KNOWN_INPUTS: readonly ["stdin-ndjson", "files", "dir", "none"];
+export type PluginInput = (typeof KNOWN_INPUTS)[number];
 /** params の1エントリ。GUI/ink がフォーム部品へ写像できる最小集合に絞る */
 export interface PluginParam {
     /** フラグ名 (例: "--bucket") */
@@ -44,6 +53,8 @@ export interface PluginParam {
 export interface PluginSubcommand {
     name: string;
     description?: string;
+    /** このサブコマンドの intake。プラグインレベルの input を上書きする (要望書v2 §3.2) */
+    input?: PluginInput[];
 }
 /** --plugin-schema 応答の全体形 (基本 + 拡張。未知フィールドは無視) */
 export interface PluginDescribe {
@@ -59,6 +70,11 @@ export interface PluginDescribe {
     /** 対応 OS。未宣言 = 制限なし。宣言があり現在の OS が含まれない場合、dispatch は実行を拒否する */
     platforms?: PluginPlatform[];
     subcommands?: PluginSubcommand[];
+    /**
+     * intake = データの受け取り方 (要望書v2)。未宣言 = 不明 (連携側は安全側 =
+     * 渡し方を推測しない)。subcommands[].input がある場合はそちらが優先。
+     */
+    input?: PluginInput[];
 }
 /**
  * plugin describe の表示行を組む。plugin/path は CLI が解決した事実 —

package/dist/plugins/describe.js

@@ -31,6 +31,14 @@ export function platformKeywordFor(p) {
         return "linux";
     return null;
 }
+/**
+ * input (intake = データの受け取り方) の閉じた語彙 (要望書v2)。
+ * 「どう渡すか」を実行前に機械可読にする — sink にディレクトリを渡す等の
+ * 取り違えを連携側 (GUI/Connector) が起動前に検出できるようにする。
+ * CLI 本体はこれでゲートしない (宣言した意図を伝えるヒント。成否の判定は
+ * あくまで receipt の verified)。
+ */
+export const KNOWN_INPUTS = ["stdin-ndjson", "files", "dir", "none"];
 const PARAM_TYPES = new Set(["string", "number", "boolean", "select"]);
 /**
  * plugin describe の表示行を組む。plugin/path は CLI が解決した事実 —
@@ -112,7 +120,23 @@ export async function probePlatforms(bin, timeoutMs = 1500) {
 }
 /** 拡張フィールドのいずれかを宣言しているか */
 export function hasDescribeFields(row) {
-    return ["name", "version", "description", "phases", "params", "platforms", "subcommands"].some((k) => k in row);
+    return ["name", "version", "description", "phases", "params", "platforms", "subcommands", "input"].some((k) => k in row);
+}
+/**
+ * input (intake) 宣言の検査。閉じた語彙の非空配列であること。
+ * "none" は「データ入力なし」なので他の値との併記は矛盾 — 受理すると
+ * 連携側が「渡さなくてよいのか stdin で渡すのか」を判断できない。
+ */
+function validateInputList(value, field) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        !value.every((v) => typeof v === "string" && KNOWN_INPUTS.includes(v))) {
+        return `${field} must be a non-empty array of ${KNOWN_INPUTS.map((k) => `"${k}"`).join(" | ")}`;
+    }
+    if (value.includes("none") && value.length > 1) {
+        return `${field} must not combine "none" with other intake values`;
+    }
+    return null;
 }
 /**
  * 宣言の形式検査。問題の説明文を返す (空配列 = 適合)。
@@ -142,6 +166,11 @@ export function validateDescribe(row) {
             problems.push(`platforms must be a non-empty array of ${KNOWN_PLATFORMS.map((k) => `"${k}"`).join(" | ")}`);
         }
     }
+    if ("input" in row) {
+        const problem = validateInputList(row.input, "input");
+        if (problem)
+            problems.push(problem);
+    }
     let declaredSubs = null;
     if ("subcommands" in row) {
         const subs = row.subcommands;
@@ -168,6 +197,11 @@ export function validateDescribe(row) {
                 if ("description" in s && typeof s.description !== "string") {
                     problems.push(`subcommands[${i}].description must be a string`);
                 }
+                if ("input" in s) {
+                    const problem = validateInputList(s.input, `subcommands[${i}].input`);
+                    if (problem)
+                        problems.push(problem);
+                }
             });
         }
     }

package/dist/plugins/templates.js

@@ -25,7 +25,7 @@ case "\${1:-}" in
     exit 0 ;;
   --plugin-schema)
     # 自己記述 (PLUGINS.md §3)。params は GUI/ink のフォーム生成に使われる
-    printf '{"pluginApi":["1"],"schemaVersions":["1.0"],"recordTypes":["*"],"name":"i-repo-${name}","version":"0.1.0","description":"TODO: what this plugin does","phases":["write","verify"],"platforms":["macos","linux"],"params":[{"name":"--dry-run","type":"boolean","label":"Dry run","description":"Validate without writing"}]}\\n'
+    printf '{"pluginApi":["1"],"schemaVersions":["1.0"],"recordTypes":["*"],"name":"i-repo-${name}","version":"0.1.0","description":"TODO: what this plugin does","phases":["write","verify"],"platforms":["macos","linux"],"input":["stdin-ndjson"],"params":[{"name":"--dry-run","type":"boolean","label":"Dry run","description":"Validate without writing"}]}\\n'
     exit 0 ;;
 esac
 
@@ -115,6 +115,7 @@ if (arg0 === "--plugin-schema") {
     description: "TODO: what this plugin does",
     phases: ["write", "verify"],
     platforms: ["macos", "linux", "windows"],
+    input: ["stdin-ndjson"],
     params: [
       { name: "--dry-run", type: "boolean", label: "Dry run", description: "Validate without writing" },
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i-repo",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Modern CLI for ConMas i-Reporter - Built for humans and AI",
   "type": "module",
   "bin": {