@shinaps/skills 0.37.0 → 0.38.0

package/README.md

@@ -18,10 +18,10 @@ sharedで採用する `instructions.md` は共有JSONの `references.specificati
 
 0.35.0から通常設定の `review_flow.mode` に `ask` を追加しました（パス別ルールは `auto`・`manual` だけ）。既存の設定は変更不要です。
 
-CLIはpluginに含まれないため、利用中のskillと同じ `@shinaps/skills@0.37.0` を導入し、`shinaps-skills --version` で確認します。`shinaps-skills validate-linear-config <明示ファイル>` は同梱schemaだけで検証し、ネットワーク取得・正本探索・Git操作・入力変更は行いません。`$schema` は固定URLによるエディタ補助で、契約の正本は[同梱schema](plugins/shinaps-claude/references/linear/configuration.schema.json)です。0.34.0から、Managed Agentsの `.shinaps/managed.json`（`config_version: 1`）も `shinaps-skills validate-managed-config <明示ファイル>` で同じ方式で検証します（[Managedの設定](plugins/shinaps-claude/references/managed/configuration.md)）。
+CLIはpluginに含まれないため、利用中のskillと同じ `@shinaps/skills@0.38.0` を導入し、`shinaps-skills --version` で確認します。`shinaps-skills validate-linear-config <明示ファイル>` は同梱schemaだけで検証し、ネットワーク取得・正本探索・Git操作・入力変更は行いません。`$schema` は固定URLによるエディタ補助で、契約の正本は[同梱schema](plugins/shinaps-claude/references/linear/configuration.schema.json)です。Managed Agentsの `.shinaps/managed.json` も `shinaps-skills validate-managed-config <明示ファイル>` で同じ方式で検証します。0.38.0から `config_version: 2`（リポジトリとアカウント別のvault）になり、lockはアカウントごとの管理ディレクトリへ移ります（[Managedの設定と移行](plugins/shinaps-claude/references/managed/configuration.md)）。
 
 ```sh
-npm install -g @shinaps/skills@0.37.0
+npm install -g @shinaps/skills@0.38.0
 shinaps-skills --version
 shinaps-skills validate-linear-config /absolute/repository/.shinaps/linear.json
 shinaps-skills validate-managed-config /absolute/repository/.shinaps/managed.json
@@ -44,8 +44,8 @@ shinaps-skills validate-managed-config /absolute/repository/.shinaps/managed.jso
 | `release` | 公開条件を確定し、対象バージョンの利用可能性を確認する |
 | `linear-plan` | 相談・必要なspec/explore・Issue作成と整理・プロジェクト設定を行い、実装前で止める |
 | `linear-execute` | Issue単体・Cycle全体・バックログ消化を選び、設定に従って実装・QA・許可された公開を進める |
-| `managed-setup` | Claude Managed Agentsの共通dev構成を自分の組織へ導入・更新する。既存のlockを使い、重複して作らない |
-| `managed-execute` | Managed Agentsのleadへdevを依頼し、観測・質問の取り次ぎ・成果物とdraft PRの確認を行う |
+| `managed-setup` | Claude Managed Agentsの共通dev構成を1つ以上のアカウントへ一コマンドで導入・更新する。アカウントごとのlockを使い、重複して作らない |
+| `managed-execute` | Managed Agentsのleadへdevを依頼し、観測・質問の取り次ぎ・出力のローカル回収とdraft PRの確認を行う |
 
 コミット・PR・リリースは、利用者の依頼またはLinear進行で合意済みの継続許可に従う。[共通設定](plugins/shinaps-claude/references/linear/configuration.md)・[担当と工程](plugins/shinaps-claude/references/linear/workflow.md)・[終了と待機](plugins/shinaps-claude/references/linear/execution.md)を参照し、必要な前工程が揃えば再確認せずに進む。単独スキル利用にはLinear進行や新しいゴールを必須にしない。`autonomous-commit-review` の役割は `commit` に統合した。個人用の別AI呼び出し・ブラウザ管理・ゴール管理・動画制作はこのpluginに含めない。
 
@@ -134,38 +134,50 @@ Claude Codeは標準のmarketplace自動更新機能を使う。`/plugin` のMar
 
 ## Claude Managed Agents
 
-両pluginの `managed-agents/` は、Claude Managed Agentsでdev工程を進めるための共通定義である。lead `shinaps-dev-managed-cc`、devの3役割、skill `dev-managed-cc`、環境 `shinaps-dev` を置く。クラウドのIDを記録する `claude-lock.json` と実設定は利用者ごとのものなので、作業先の `.shinaps/` に置き、公開する定義には含めない。予定実行はこの構成に含めない。
+両pluginの `managed-agents/` は、Claude Managed Agentsでdev工程を進めるための共通定義である。lead `shinaps-dev-managed-cc`、devの3役割、skill `dev-managed-cc`、環境 `shinaps-dev` を置く。クラウドのIDを記録する `claude-lock.json` は利用者のアカウント（APIキーの組織・workspace）ごとのものなので、マシン単位の管理ディレクトリに置き、公開する定義には含めない。予定実行はこの構成に含めない。
 
-- leadはFable 5.1（`claude-fable-5-1` / medium）、役割はOpus 5.5（`claude-opus-5-5` / medium）で動く。全agent定義に `speed: standard` を明示する（既存リソースに残るfastを戻すため）。leadのモデルは定義で決まり、Linear進行の経路ごとのメインのモデルとは別に扱う。
-- 体制はLITE・BASIC・ULTRAを初回メッセージで受け、`dev-claude` と同じ体制の表に従い、BASIC・ULTRAではleadが追加の担当を決める。leadがメインとして調査・設計・実装・採否を行い、独立設計・計画レビュー・実装後の独立レビューだけを登録した3役割（architect・plan-reviewer・reviewer）へ委任する。そのため Managed で設計・実装を行うモデルは lead の Fable になる（モデルの定義は変えない）。廃止したdev-ultraなどの入口とexplorerは置かず、探索はleadと独立設計担当が行う。
+- leadと3役割はOpus 5.5（`claude-opus-5-5` / medium）で動く。全agent定義に `speed: standard` を明示する（既存リソースに残るfastを戻すため）。leadのモデルは定義で決まり、Linear進行の経路ごとのメインのモデルとは別に扱う。
+- 体制はLITE・BASIC・ULTRAを初回メッセージで受け、`dev-claude` と同じ体制の表に従い、BASIC・ULTRAではleadが追加の担当を決める。leadがメインとして調査・設計・実装・採否を行い、独立設計（ULTRAでは必須）・計画レビュー・実装後の独立レビューだけを登録した3役割（architect・plan-reviewer・reviewer）へ委任する。Managedで設計・実装を行うモデルはleadのOpusになる。廃止したdev-ultraなどの入口・explorer・refine専用の役割は置かず、探索はleadと独立設計担当が行う。
 - Shinaps AIのMCPとruleを使わない。規約はマウントしたリポジトリの `AGENTS.md`・`CLAUDE.md` と参照先、添付された利用者CLAUDE.mdだけで、最終報告ではShinaps AI ruleを未照合とする。
-- 初回メッセージにリポジトリ・base・head・範囲と受入条件・許可・予算が揃わなければ、leadは作業を始めず欠落を質問する。許可はそのメッセージで明示された操作だけで、構成の導入からは生じない。
+- 初回メッセージにリポジトリ・base・head・範囲と受入条件・体制・許可・予算が揃わなければ、leadは作業を始めず欠落を質問する。許可はそのメッセージで明示された操作だけで、構成の導入からは生じない。
 - 終了地点は範囲を限ったコミット・headブランチへのpush・draft PR。merge・deploy・release・Issueの更新はしない。CodexのQAはセッションの外で、PRの後に行う。push前に最終QAを行うLinear進行とは順序が違う。
 
-### 定義の更新と適用
+### CLI
 
-1. 共通定義は `plugins/shinaps-claude/managed-agents/` を編集元とし、`plugins/shinaps-codex/managed-agents/` へ同じ内容を複製する。一致はテストで確認する。
-2. 作業先では `managed-setup` が、`.shinaps/managed.json`（[設定](plugins/shinaps-claude/references/managed/configuration.md)）の `definitions` が指すディレクトリ（既定は `.shinaps/managed/`、Git対象外）へ共通定義をコピーする。
-3. そのディレクトリで `ant apply --dry-run .` を実行し、計画を確認する。
-4. 利用者の合意後に `ant apply .` で適用する。`--prune`・`--force` は使わず、リソースを削除しない。
-5. 適用前に複製したlock（`.shinaps/work/` に置く）と比べ、更新したリソースの `version`・`hash`・`remote_hash` 以外が変わっていないことを確かめる。
+導入・依頼・観測・回収は配布CLIの `shinaps-skills managed` で行い、クラウドの操作は公式の `ant` CLI（2.4.0以上。コマンド・フラグ・stdin・出力はこの版のソースで照合した）へ委ねる。各アカウントのAPIキーは環境変数 `SHINAPS_MANAGED_API_KEY_<NAME>` か引数 `--api-key <name>=<key>` で渡し、CLIは保存・表示しない。lock・セッション記録・回収した出力は `~/.local/share/shinaps-ai/skills/managed/<account>/` にアカウントごとに分かれる。
 
-手順・安全上の注意・止める条件は[導入と更新の手順](plugins/shinaps-claude/references/managed/setup.md)にある。セッションの依頼・観測・未検証の境界は[依頼と観測の手順](plugins/shinaps-claude/references/managed/execute.md)にある。これらはpluginに含まれ、どちらのruntimeからも読める。
+```sh
+shinaps-skills managed setup --account personal --account work          # 計画の表示だけ
+shinaps-skills managed setup --account personal --account work --apply  # 合意後に適用
+shinaps-skills managed run .shinaps/managed.json --account work --base main --base-sha <SHA> --head feat/x \
+  --staffing BASIC --allow commit,push,draft_pr --budget-cents 4000 --task-file task.md
+shinaps-skills managed status --account work --session <ID>
+shinaps-skills managed reply --account work --session <ID> --message-file answer.md
+shinaps-skills managed collect --account work --session <ID>
+```
 
-### このリポジトリのlock
+- setupはアカウントごとのlockで既存のリソースを更新し、lockが無いのに同名のリソースがあれば作らずに止まる。`--apply` を付けない限りクラウドを変更しない。
+- runはリポジトリ・base・head・範囲・体制・許可・予算を毎回明示し、同じ入力の再実行では新しいセッションを作らない。
+- collectはセッションの出力を保存するだけで、差分を適用しない。CLIはgitを呼ばず、pushしない。
+
+手順・安全上の注意・止める条件は[設定とアカウント](plugins/shinaps-claude/references/managed/configuration.md)・[導入と更新の手順](plugins/shinaps-claude/references/managed/setup.md)・[依頼と観測の手順](plugins/shinaps-claude/references/managed/execute.md)にある。これらはpluginに含まれ、どちらのruntimeからも読める。
 
-shinaps-skills自身のlockは0.34.0で `.shinaps/managed/claude-lock.json`（Git対象外）へ移した。以前の内容は `git show 8679d8f:managed-agents/claude-lock.json` で取り出せる。
+### 定義の更新と適用
+
+共通定義は `plugins/shinaps-claude/managed-agents/` を編集元とし、`plugins/shinaps-codex/managed-agents/` へ同じ内容を複製する。一致はテストで確認する。定義を変えたら `managed setup` で計画を確かめてから `--apply` で適用する。`--prune`・`--force` は使わず、リソースを削除しない。
 
-定義を変えたら、`managed-setup` の手順（[導入と更新の手順](plugins/shinaps-claude/references/managed/setup.md)）でdry-runの計画を確かめてから適用する。`--prune` は付けない。旧CC Ultraのleadと専用skill、旧explorerと旧review-verifierはクラウドでアーカイブ済みで、lockでも追跡しない。
+### このリポジトリのlock
 
-GitHub MCP（`https://api.githubcopilot.com/mcp`）の資格情報はvaultに登録し、セッション作成時に渡す。vaultの資格情報はMCPサーバーのURLで照合されるので、lead定義のURLと末尾のスラッシュまで揃える。leadは最後のメッセージの1行目に `状態: 完了`・`状態: 質問`・`状態: 未完了` を書き、`changes.patch` と作業記録のtarを `/mnt/session/outputs/` に置く（[起動手順](plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/references/launch.md)）。マウントしたリポジトリへのpushとdraft PRの作成は、実際のセッションで確かめるまで未検証である。
+shinaps-skills自身のlockは0.34.0から0.37.0まで `.shinaps/managed/claude-lock.json`（Git対象外）に置いていた。0.38.0では[version 1 からの移行](plugins/shinaps-claude/references/managed/configuration.md#version-1-からの移行)に従い、アカウントの `definitions/claude-lock.json` へ移してから適用する。それ以前の内容は `git show 8679d8f:managed-agents/claude-lock.json` で取り出せる。旧CC Ultraのleadと専用skill、旧explorerと旧review-verifierはクラウドでアーカイブ済みで、lockでも追跡しない。
+
+GitHub MCP（`https://api.githubcopilot.com/mcp`）の資格情報はアカウントの組織のvaultに登録し、セッション作成時に渡す。vaultの資格情報はMCPサーバーのURLで照合されるので、lead定義のURLと末尾のスラッシュまで揃える。leadは最後のメッセージの1行目に `状態: 完了`・`状態: 質問`・`状態: 未完了` を書き、`changes.patch` と作業記録のtarを `/mnt/session/outputs/` に置く（[起動手順](plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/references/launch.md)）。CLIの実クラウドでの実行、マウントしたリポジトリへのpushとdraft PRの作成は、実際のセッションで確かめるまで未検証である。
 
 ## 開発と配布
 
 - Claude版: `plugins/shinaps-claude/`、marketplaceは`.claude-plugin/marketplace.json`
 - Codex版: `plugins/shinaps-codex/`、marketplaceは`.agents/plugins/marketplace.json`
 - Codexカスタムエージェント: `plugins/shinaps-codex/agents/`
-- Claude Managed Agents版: 両pluginの `managed-agents/`（Claude版が編集元）。pluginと一緒に配布され、npmパッケージの `plugins/` にも含まれる。適用は作業先の `.shinaps/managed/` へコピーしてから「Claude Managed Agents」節の手順で行い、`--prune`・`--force` を使わない
+- Claude Managed Agents版: 両pluginの `managed-agents/`（Claude版が編集元）。pluginと一緒に配布され、npmパッケージの `plugins/` にも含まれる。適用は `shinaps-skills managed setup` がアカウントごとの管理ディレクトリへコピーしてから行い、`--prune`・`--force` を使わない
 - 配布CLI: ソースは `bin/skills.ts` と `lib/*.ts`。`npm run build` (`tsc`) で `dist/` にJSを出力し、npmにはそれを配布する。Node.jsは`node_modules`配下の`.ts`に型除去を適用しないため、ソースのままは配布できない。checkoutでは型除去で直接実行するので、`enum`など型除去で消せない構文は使わない (`tsconfig.json` の `erasableSyntaxOnly`)
 
 品質基準とプロジェクト設定の方針は揃えつつ、クライアント固有の実行手順・エージェント形式は別々に管理する。Codex版の工程の資料（`references/` の、`dev/launch.md` を除くもの）はClaude版と一致させ、テストで確認する。Codex版は役割の本文とスキルを書き分け、Claude向けのエージェント呼び出しをCodexに読み替えさせる方式は使わない。スキルを追加・変更した場合は各版への適用可否を判断する。
@@ -254,8 +266,7 @@ Claude版は全14エージェントが `opus / medium`。Codex版の役割定義
 ├── .gitignore             # 保存方式に応じた除外・共有対象の例外
 ├── linear.json            # linear のプロジェクト設定（任意）
 ├── linear/                # linear の補足（任意）
-├── managed.json           # Managed Agents のローカル設定（任意・Git対象外）
-├── managed/               # Managed の共通定義のコピーと claude-lock.json（任意・Git対象外）
+├── managed.json           # Managed Agents の依頼先リポジトリとアカウント別のvault（任意・Git対象外）
 └── work/
     ├── {日時}-{作業名}/
     ├── explorations/
@@ -264,6 +275,8 @@ Claude版は全14エージェントが `opus / medium`。Codex版の役割定義
     └── debug/
 ```
 
+Managed Agentsのアカウントごとのlock・セッション記録・回収した出力は、リポジトリではなく `~/.local/share/shinaps-ai/skills/managed/<account>/` に置く（[設定とアカウント](plugins/shinaps-claude/references/managed/configuration.md)）。
+
 旧 `.claude/shinaps/` の成果物はパスを指定して引き継げる。既存記録を自動移動・削除しない。共有する仕様書などの明示された納品先は尊重し、作業記録に秘密情報を含めない。
 
 ## 対応範囲

package/dist/bin/skills.js

@@ -4,6 +4,7 @@ import { join } from 'node:path';
 import { packageRoot } from '../lib/layout.js';
 import { validateLinearConfig } from '../lib/linear-config.js';
 import { validateManagedConfig } from '../lib/managed-config.js';
+import { managed } from '../lib/managed.js';
 import { run } from '../lib/install.js';
 import { autoUpdate } from '../lib/auto-update.js';
 import { errorMessage } from '../lib/fs.js';
@@ -22,8 +23,10 @@ try {
         if (rest.length !== 1)
             throw new Error('Usage: shinaps-skills validate-managed-config <file>');
         await validateManagedConfig(rest[0]);
-        console.log('Managed configuration is valid (config_version: 1).');
+        console.log('Managed configuration is valid (config_version: 2).');
     }
+    else if (command === 'managed')
+        await managed(rest);
     else if (command === 'auto-update')
         await autoUpdate(rest);
     else

package/dist/lib/config-validation.js

@@ -2,7 +2,7 @@ import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { Ajv } from 'ajv';
 import { packageRoot } from './layout.js';
-/** 明示されたファイルを同梱の契約で検証する。設定の探索・変更や外部取得は行わない。 */
+/** 明示されたファイルを同梱の契約で検証し、検証した内容を返す。設定の探索・変更や外部取得は行わない。 */
 export async function validateConfig(path, contract) {
     const input = JSON.parse(await readFile(path, 'utf8'));
     // 版の不一致は設定修正とskill更新で対処が異なるため、schema検証より先に案内する。
@@ -30,4 +30,5 @@ export async function validateConfig(path, contract) {
             .join('\n');
         throw new Error(`Invalid ${contract.name} configuration. Correct the JSON to match configuration.schema.json:\n${errors}`);
     }
+    return input;
 }

package/dist/lib/install.js

@@ -12,6 +12,7 @@ const usage = [
     'Usage: shinaps-skills <install|update|uninstall|recover> codex',
     '       shinaps-skills validate-linear-config <file>',
     '       shinaps-skills validate-managed-config <file>',
+    '       shinaps-skills managed <setup|run|status|reply|collect> (see managed --help)',
     '       shinaps-skills auto-update <enable|disable|status|check> codex',
     'Claude Code: /plugin marketplace add sh1n4ps/shinaps-skills',
     '             /plugin install shinaps@shinaps-skills',

package/dist/lib/layout.js

@@ -5,6 +5,8 @@ import { fileURLToPath } from 'node:url';
 // launchd ジョブは enable した版の CLI ではなく、実行のたびに npm から取得した最新版の CLI を起動する。
 // そのためここに定義した場所と形式 (auto-update.json、state.json、transaction/journal.json) は
 // どの版でも読めるように保ち、変える場合は旧形式も読めるようにする。
+// Managed Agents のアカウントごとの配置 (managed/<account>/ の lock とセッション記録) も同じ約束で、
+// 版を変えても既存の lock を見失わないようにする。lock を見失うと、次の適用が同じリソースを重複して作る。
 /**
  * このパッケージのルートディレクトリ。リポジトリの checkout、または npm が展開したディレクトリ。
  * このファイルは checkout では `lib/`、配布物では `dist/lib/` にあり深さが違うので、package.json が
@@ -39,6 +41,16 @@ export const managedRoot = (home) => join(home, '.local', 'share', 'shinaps-ai',
 /** 配置済みの配布物。Codex の marketplace はここを指す。 */
 export const payloadDir = (root) => join(root, 'codex');
 export const statePath = (root) => join(root, 'state.json');
+/**
+ * Managed Agents のアカウントのディレクトリ。lock は組織・workspace (APIキー) に属し、リポジトリには
+ * 属さないので、リポジトリではなくマシン単位の管理ディレクトリに置く。
+ * - `definitions/`: `ant apply` の cwd。同梱の共通定義の写しと `claude-lock.json` だけを置く。
+ * - `sessions/<request_id>.json`: このアカウントで作成したセッションの記録。
+ * - `sessions/<session_id>/outputs/`: 回収したファイル。
+ */
+export const managedAccountDir = (root, account) => join(root, 'managed', account);
+/** 同梱の Managed 共通定義。両 plugin の内容は同一 (テストで確認) なので Claude 版を使う。 */
+export const managedTemplatePath = 'plugins/shinaps-claude/managed-agents';
 /** CODEX_HOME の解決値。オプション (`auto-update check` が渡す) → 環境変数 → Codex の既定の順。 */
 export const codexHomeOf = (options, home) => resolve(options.codexHome ?? process.env.CODEX_HOME ?? join(home, '.codex'));
 /**

package/dist/lib/linear-config.js

@@ -1,7 +1,7 @@
 import { validateConfig } from './config-validation.js';
 /** `.shinaps/linear.json` を同梱の契約で検証する。 */
-export function validateLinearConfig(path) {
-    return validateConfig(path, {
+export async function validateLinearConfig(path) {
+    await validateConfig(path, {
         name: 'Linear',
         schema: 'plugins/shinaps-claude/references/linear/configuration.schema.json',
         version: 2,

package/dist/lib/managed-ant.js

@@ -0,0 +1,70 @@
+import { spawn } from 'node:child_process';
+/**
+ * Managed Agents の beta ヘッダ。ant の `--beta` は既定の beta ヘッダを置き換えるので、既定に頼らず
+ * 毎回明示する (agents・environments・sessions の既定と同じ値)。Files は `filesBeta` を使う。
+ */
+export const managedBeta = ['--beta', 'managed-agents-2026-04-01'];
+/** セッションの Files には Files API と Managed Agents の両方の beta が要る。 */
+export const filesBeta = ['--beta', 'files-api-2025-04-14', ...managedBeta];
+/**
+ * 子プロセスの環境。親の `ANTHROPIC_*` (別のキー・ログインのプロファイル・workspace・federation) と
+ * 他アカウントのキー (`SHINAPS_MANAGED_*`) を渡さず、そのアカウントのキーだけを資格情報にする。
+ * ant は環境変数をログインより優先するが、複数の資格情報が残ると、どれが使われるかが ant の優先順位に
+ * 依存し、別アカウントのリソースを操作しかねないため。
+ */
+export function antEnvironment(env, apiKey) {
+    const result = {};
+    for (const [name, value] of Object.entries(env)) {
+        if (!name.startsWith('ANTHROPIC_') && !name.startsWith('SHINAPS_MANAGED_')) {
+            result[name] = value;
+        }
+    }
+    result.ANTHROPIC_API_KEY = apiKey;
+    // ant は FORCE_COLOR=1 で非端末にも色を付ける。計画の文言や jsonl の解析が ANSI で壊れないよう止める。
+    result.FORCE_COLOR = '0';
+    return result;
+}
+/**
+ * stdin に渡すリクエスト本文。ant は本文の文字列値のうち `@` で始まるものをファイル参照として展開し
+ * (`@notes.md` ならそのファイルの内容を送り、無ければ失敗する)、`\@` で始まるものだけを `@` の文字列に
+ * 戻す。題名や回答の本文を書かれたとおりに送るため、`@` で始まる文字列を全て `\@` に置き換える。
+ * `\@` で始まる文字列は ant が必ず `@` に変えるので、そのままは送れない (ant の制約)。
+ */
+export function antRequestBody(value) {
+    return JSON.stringify(value, (_key, item) => typeof item === 'string' && item.startsWith('@') ? `\\${item}` : item);
+}
+/**
+ * PATH 上の `ant` を実行する。本文が無ければ stdin を /dev/null にする。ant は stdin がパイプなら
+ * 本文の有無を 10 ms 待って確かめるので、本文の無い呼び出しにパイプを渡さない。本文は起動と同時に
+ * パイプへ書き込むので、ant が確かめる時点では既に読める。
+ */
+export const antCommand = (env) => ({ argv, apiKey, cwd, body }) => new Promise((resolve, reject) => {
+    const child = spawn('ant', argv, {
+        cwd,
+        env: antEnvironment(env, apiKey),
+        stdio: [body === undefined ? 'ignore' : 'pipe', 'pipe', 'pipe'],
+    });
+    const stdout = [];
+    const stderr = [];
+    child.stdout?.on('data', (chunk) => stdout.push(chunk));
+    child.stderr?.on('data', (chunk) => stderr.push(chunk));
+    child.on('error', reject);
+    child.on('close', (status, signal) => {
+        if (status === 0) {
+            resolve(Buffer.concat(stdout).toString('utf8'));
+            return;
+        }
+        // ant は API エラーの本文と、途中で失敗した apply の結果を stdout に出すので、両方を残す。
+        // 呼び出し側が秘密値を伏字にしてから表示する。
+        const output = [Buffer.concat(stdout), Buffer.concat(stderr)]
+            .map((chunk) => chunk.toString('utf8').trim())
+            .filter(Boolean)
+            .join('\n');
+        reject(new Error(`ant ${argv.slice(0, 2).join(' ')} exited with ${status ?? signal}:\n${output}`));
+    });
+    // ant が本文を読む前に終わる (引数の誤りなど) と書き込みは EPIPE で失敗する。その成否は
+    // 終了コードとエラー出力で報告するので、書き込みのエラーでプロセスを落とさない。
+    child.stdin?.on('error', () => { });
+    if (body !== undefined)
+        child.stdin?.end(antRequestBody(body));
+});

package/dist/lib/managed-config.js

@@ -1,10 +1,10 @@
 import { validateConfig } from './config-validation.js';
-/** `.shinaps/managed.json` を同梱の契約で検証する。 */
-export function validateManagedConfig(path) {
-    return validateConfig(path, {
+/** `.shinaps/managed.json` を同梱の契約で検証し、内容を返す。 */
+export async function validateManagedConfig(path) {
+    return (await validateConfig(path, {
         name: 'Managed',
         schema: 'plugins/shinaps-claude/references/managed/configuration.schema.json',
-        version: 1,
-        migration: 'Create it with managed-setup (config_version: 1).',
-    });
+        version: 2,
+        migration: 'Recreate it as config_version: 2 with managed-execute and move each existing claude-lock.json to its account directory (references/managed/configuration.md, migration from version 1).',
+    }));
 }

package/dist/lib/managed-session.js

@@ -0,0 +1,274 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readdir, rename, rm, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { readJson, readJsonIfExists, writeFileAtomic } from './fs.js';
+import { withLock } from './lock.js';
+import { filesBeta, managedBeta } from './managed-ant.js';
+export const staffings = ['LITE', 'BASIC', 'ULTRA'];
+export const permissions = ['commit', 'push', 'draft_pr'];
+const leadKey = './agents/shinaps-dev-managed-cc.md';
+const environmentKey = './environments/shinaps-dev.yaml';
+const permissionLabels = {
+    commit: 'commit',
+    push: 'headへのpush',
+    draft_pr: 'draft PRの作成',
+};
+const sha256 = (text) => createHash('sha256').update(text).digest('hex');
+/**
+ * `--transform id -r` の出力から ID を取り出す。ant は transform のパスが応答に無いと応答の全体を
+ * 出すので、ID の形でない出力を ID として記録しない。
+ */
+async function readId(output, command) {
+    const id = (await output).trim();
+    if (!/^[A-Za-z0-9_]+$/.test(id))
+        throw new Error(`${command} returned no ID.`);
+    return id;
+}
+/**
+ * 依頼を lead へ送るセッションを作る。同じ入力の依頼は同じセッションを返し、作り直さない。
+ * 作成の途中で止まった記録があれば、重複を避けるために作らずに止める。
+ * @param githubToken マウントするリポジトリの token。本文 (stdin) だけで渡す。
+ * @param claudeMdPath `request.claude_md` の元のファイル。upload に使う。
+ */
+export async function runSession(account, request, options) {
+    const { ant, log } = options;
+    return withLock(account.dir, async () => {
+        const { task, claude_md, ...rest } = request;
+        const recorded = {
+            ...rest,
+            task_sha256: sha256(task),
+            claude_md_sha256: claude_md === null ? null : sha256(claude_md),
+        };
+        const requestId = sha256(JSON.stringify(recorded)).slice(0, 32);
+        const recordPath = join(account.dir, 'sessions', `${requestId}.json`);
+        const previous = await readJsonIfExists(recordPath);
+        if (previous?.session_id) {
+            log(`Session already exists for this request: ${previous.session_id}`);
+            return previous.session_id;
+        }
+        if (previous) {
+            throw new Error(`A previous run of this request stopped while creating a session. Check the sessions of account ${account.name} for metadata shinaps_request=${requestId}; delete ${recordPath} only after confirming none was created, then retry.`);
+        }
+        const lock = await readJsonIfExists(join(account.dir, 'definitions', 'claude-lock.json'));
+        const agent = lock?.resources?.[leadKey]?.id;
+        const environment = lock?.resources?.[environmentKey]?.id;
+        if (!agent || !environment) {
+            throw new Error(`Account ${account.name} has no applied lead and environment. Run managed setup --apply first.`);
+        }
+        await mkdir(join(account.dir, 'sessions'), { recursive: true });
+        const record = {
+            request_id: requestId,
+            session_id: null,
+            created_at: options.now().toISOString(),
+            request: recorded,
+        };
+        // 作成より前に記録する。作成後に記録できずに終わっても、次の実行は止まり、重複して作らない。
+        await writeFileAtomic(recordPath, JSON.stringify(record, null, 2) + '\n');
+        const resources = [
+            {
+                type: 'github_repository',
+                url: request.repository.url,
+                mount_path: request.repository.mount_path,
+                ...(options.githubToken ? { authorization_token: options.githubToken } : {}),
+                checkout: { type: 'commit', sha: request.base_sha },
+            },
+        ];
+        if (options.claudeMdPath) {
+            // upload は記録の後に行う。記録の前だと、途中で止まった実行の再実行のたびに Files が増える。
+            let fileId;
+            try {
+                fileId = await readId(ant({
+                    // セッションの Files と同じ beta の Files API に上げる。パスは絶対パスにする (ant は `-` を
+                    // stdin と解釈する)。
+                    argv: [
+                        'beta:files',
+                        'upload',
+                        '--file',
+                        resolve(options.claudeMdPath),
+                        ...filesBeta,
+                        '--transform',
+                        'id',
+                        '-r',
+                    ],
+                    apiKey: account.apiKey,
+                }), 'ant files upload');
+            }
+            catch (error) {
+                // セッションはまだ作っていないので、記録を残すと同じ依頼の再実行が不要に止まる。
+                await rm(recordPath, { force: true });
+                throw error;
+            }
+            resources.push({ type: 'file', file_id: fileId, mount_path: '/CLAUDE.md' });
+        }
+        const body = {
+            agent,
+            environment_id: environment,
+            ...(request.vault_id ? { vault_ids: [request.vault_id] } : {}),
+            title: request.title ?? request.head,
+            metadata: { shinaps_request: requestId, head: request.head, staffing: request.staffing },
+            budget: {
+                type: 'limit',
+                max_list_cost: { amount: request.budget_cents, currency: 'USD' },
+            },
+            resources,
+            initial_events: [
+                { type: 'user.message', content: [{ type: 'text', text: initialMessage(request) }] },
+            ],
+        };
+        const sessionId = await readId(ant({
+            argv: ['beta:sessions', 'create', ...managedBeta, '--transform', 'id', '-r'],
+            apiKey: account.apiKey,
+            body,
+        }), 'ant beta:sessions create');
+        await writeFileAtomic(recordPath, JSON.stringify({ ...record, session_id: sessionId }, null, 2) + '\n');
+        log(`Created session ${sessionId} for account ${account.name}.`);
+        return sessionId;
+    });
+}
+// lead の契約 (managed-agents/skills/dev-managed-cc/SKILL.md の初回メッセージ) の必須入力を、
+// すべて明示する。欠けると lead は質問で止まり、それまでの費用が無駄になる。
+function initialMessage(request) {
+    const budget = Number(request.budget_cents) / 100;
+    return [
+        `リポジトリ: ${request.repository.url}（マウント先 ${request.repository.mount_path}）`,
+        `base: ${request.base} @ ${request.base_sha}`,
+        `head: ${request.head}`,
+        `範囲と受入条件:\n${request.task.trimEnd()}`,
+        `体制: ${request.staffing}`,
+        `許可: ${request.allow.length ? request.allow.map((name) => permissionLabels[name]).join('・') : 'なし（commit・push・draft PRの作成はしない）'}`,
+        `予算: ${budget} USD（セッションの上限 ${request.budget_cents} セント）`,
+        `必須検証（任意）: ${request.verify ?? '指定なし。リポジトリの規約に従う'}`,
+        `author（任意）: ${request.author ?? '指定なし'}`,
+        ...(request.claude_md === null ? [] : ['利用者 CLAUDE.md: /mnt/session/uploads/CLAUDE.md']),
+    ].join('\n');
+}
+/**
+ * このアカウントの記録にあるセッションか確かめる。別アカウントのキーや、CLI が作っていない
+ * セッションを観測・操作しないため。
+ */
+async function requireRecordedSession(account, sessionId) {
+    const directory = join(account.dir, 'sessions');
+    const names = await readdir(directory).catch(() => []);
+    for (const name of names.filter((entry) => entry.endsWith('.json'))) {
+        const record = await readJson(join(directory, name));
+        if (record.session_id === sessionId)
+            return;
+    }
+    throw new Error(`Session ${sessionId} was not created by managed run for account ${account.name}.`);
+}
+/** セッションの状態と、lead の最後のメッセージ (1 行目が `状態: 完了|質問|未完了`) を返す。 */
+export async function sessionStatus(account, sessionId, ant) {
+    await requireRecordedSession(account, sessionId);
+    const call = (argv) => ant({ argv, apiKey: account.apiKey });
+    const session = JSON.parse(await call([
+        'beta:sessions',
+        'retrieve',
+        '--session-id',
+        sessionId,
+        ...managedBeta,
+        '--format',
+        'json',
+        '--transform',
+        '{status,usage,budget}',
+    ]));
+    // 最新の agent.message 1 件だけを取る。全イベント (ツールの呼び出しを含む) を取得しないため。
+    const [last] = (await call([
+        'beta:sessions:events',
+        'list',
+        '--session-id',
+        sessionId,
+        ...managedBeta,
+        '--type',
+        'agent.message',
+        '--order',
+        'desc',
+        '--max-items',
+        '1',
+        '--format',
+        'jsonl',
+        '--transform',
+        '{content}',
+    ]))
+        .split('\n')
+        .filter((line) => line.trim())
+        .map((line) => JSON.parse(line));
+    const message = last?.content
+        ?.filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('\n') ?? null;
+    const state = message?.match(/^状態: (完了|質問|未完了)/)?.[1] ?? null;
+    return { session_id: sessionId, ...session, state, message };
+}
+/** 質問への回答を user.message として送る。新しい許可・予算はここでは加えられない (本文だけ)。 */
+export async function replySession(account, sessionId, text, ant) {
+    await requireRecordedSession(account, sessionId);
+    await ant({
+        argv: ['beta:sessions:events', 'send', '--session-id', sessionId, ...managedBeta],
+        apiKey: account.apiKey,
+        body: { events: [{ type: 'user.message', content: [{ type: 'text', text }] }] },
+    });
+}
+/**
+ * セッションの出力ファイルを `sessions/<session_id>/outputs/` へ保存し、保存したパスを返す。
+ * 差分の適用はしない。同名のファイルは最新のものだけを保存する (lead は毎ターン changes.patch を
+ * 全体の差分で置き換えるため)。
+ */
+export async function collectOutputs(account, sessionId, ant) {
+    await requireRecordedSession(account, sessionId);
+    const listed = (await ant({
+        argv: [
+            'beta:files',
+            'list',
+            '--scope-id',
+            sessionId,
+            ...filesBeta,
+            '--format',
+            'jsonl',
+            '--transform',
+            '{id,filename,size_bytes,created_at}',
+        ],
+        apiKey: account.apiKey,
+    }))
+        .split('\n')
+        .filter((line) => line.trim())
+        .map((line) => JSON.parse(line));
+    const latest = new Map();
+    for (const file of listed) {
+        // 名前はクラウドのエージェントが決める。保存先の外へ書かないよう、ファイル名だけのものに限る。
+        // ID は ant の引数に渡すので、フラグとして解釈される形 (`-` で始まる) を受け付けない。
+        if (!/^[^/\\\0]+$/.test(file.filename) ||
+            file.filename === '.' ||
+            file.filename === '..' ||
+            !/^[A-Za-z0-9_]+$/.test(file.id)) {
+            throw new Error(`Refusing to save an output with an unsafe file name (file ${file.id}).`);
+        }
+        const current = latest.get(file.filename);
+        // 時刻は小数秒の桁数が揃うとは限らないので、文字列ではなく時刻として比べる。
+        if (!current || Date.parse(current.created_at) < Date.parse(file.created_at)) {
+            latest.set(file.filename, file);
+        }
+    }
+    const directory = join(account.dir, 'sessions', sessionId, 'outputs');
+    await mkdir(directory, { recursive: true });
+    const saved = [];
+    for (const file of latest.values()) {
+        const path = join(directory, file.filename);
+        const temporary = join(directory, `.${file.filename}.${randomUUID()}.tmp`);
+        try {
+            await ant({
+                argv: ['beta:files', 'download', '--file-id', file.id, ...filesBeta, '--output', temporary],
+                apiKey: account.apiKey,
+            });
+            const { size } = await stat(temporary);
+            if (file.size_bytes !== undefined && size !== file.size_bytes) {
+                throw new Error(`Downloaded ${file.filename} has ${size} bytes, but the Files API lists ${file.size_bytes}.`);
+            }
+            await rename(temporary, path);
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+        saved.push(path);
+    }
+    return saved;
+}