@shinaps/skills 0.11.0 → 0.12.1

package/dist/lib/layout.js

@@ -0,0 +1,50 @@
+import { existsSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ファイルの配置と形式。
+// launchd ジョブは enable した版の CLI ではなく、実行のたびに npm から取得した最新版の CLI を起動する。
+// そのためここに定義した場所と形式 (auto-update.json、state.json、transaction/journal.json) は
+// どの版でも読めるように保ち、変える場合は旧形式も読めるようにする。
+/**
+ * このパッケージのルートディレクトリ。リポジトリの checkout、または npm が展開したディレクトリ。
+ * このファイルは checkout では `lib/`、配布物では `dist/lib/` にあり深さが違うので、package.json が
+ * ある最も近い親ディレクトリを探す。
+ */
+export const packageRoot = findPackageRoot(dirname(fileURLToPath(import.meta.url)));
+function findPackageRoot(directory) {
+    if (existsSync(join(directory, 'package.json')))
+        return directory;
+    const parent = dirname(directory);
+    if (parent === directory)
+        throw new Error(`package.json not found above ${directory}`);
+    return findPackageRoot(parent);
+}
+/** Codex plugin のディレクトリ。パッケージルートからも配置済み配布物からも同じ相対パス。 */
+export const pluginDir = 'plugins/shinaps-codex';
+export const manifestPath = `${pluginDir}/.codex-plugin/plugin.json`;
+/** Codex の marketplace 定義。 */
+const marketplacePath = '.agents/plugins/marketplace.json';
+/** 配布物としてパッケージからコピーするパス。 */
+export const payloadPaths = [pluginDir, marketplacePath];
+/** marketplace.json の name と、その中の plugin の name。 */
+export const marketplaceName = 'shinaps-skills-codex';
+export const pluginId = `shinaps@${marketplaceName}`;
+/**
+ * インストーラが扱えるエージェントのファイル名。一致しないファイルは置き換えも削除もしない。一致しても
+ * 所有の証明にはならず、実際に置き換え・削除するのは state.json に記録した内容と一致するファイルだけ。
+ */
+export const managedAgent = /^shinaps-[a-z0-9-]+\.toml$/;
+/** 管理ディレクトリ。配布物、state.json、自動更新の設定とロックを置く。 */
+export const managedRoot = (home) => join(home, '.local', 'share', 'shinaps-ai', 'skills');
+/** 配置済みの配布物。Codex の marketplace はここを指す。 */
+export const payloadDir = (root) => join(root, 'codex');
+export const statePath = (root) => join(root, 'state.json');
+/** CODEX_HOME の解決値。オプション (`auto-update check` が渡す) → 環境変数 → Codex の既定の順。 */
+export const codexHomeOf = (options, home) => resolve(options.codexHome ?? process.env.CODEX_HOME ?? join(home, '.codex'));
+/**
+ * 記録された CODEX_HOME が今回の導入先と同じか。旧版 (0.11.0) は指定された値を resolve せずに
+ * 保存していたので、記録側を resolve して比べる。
+ */
+export const isRecordedCodexHome = (recorded, current) => resolve(recorded) === current;
+/** CODEX_HOME 不一致のメッセージの共通部分。続けて対処を書く。 */
+export const codexHomeMismatch = (recorded, current) => `Shinaps is installed in CODEX_HOME=${recorded}, but this run uses ${current}.`;

package/dist/lib/lock.js

@@ -0,0 +1,109 @@
+import { mkdir, readFile, writeFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { errorCode } from './fs.js';
+/**
+ * `<directory>/update.lock` を保持したまま `work` を実行する。ロックはディレクトリで、保持者の pid を
+ * `pid` ファイルに記録する。保持者が存在しないロックは置き換える。保持者が生きているか pid をまだ読め
+ * ないロックは "Another Shinaps update is running" で、別の処理が古いロックの判定中なら
+ * "Another Shinaps update is recovering its lock" で reject する。
+ * 入れ子にできるのは別のディレクトリ同士だけ。scheduler ロックの中で installation ロックを取る
+ * (`auto-update check`) 場合と、その逆 (uninstall) の両方がある。保持中のロックは待たずに即失敗する
+ * ので、どちらの向きでもデッドロックしない。
+ * @param directory ロックの親ディレクトリ。無ければ作る。古いロックの置き換え中は `lock-recovery`
+ *   もここに置く。
+ * @param work ロック保持中に実行する処理。戻り値をそのまま返す。
+ */
+export async function withLock(directory, work) {
+    await mkdir(directory, { recursive: true });
+    const lock = join(directory, 'update.lock');
+    try {
+        await mkdir(lock);
+    }
+    catch (error) {
+        if (errorCode(error) !== 'EEXIST')
+            throw error;
+        await replaceStaleLock(directory, lock);
+    }
+    try {
+        await writeFile(join(lock, 'pid'), String(process.pid));
+        return await work();
+    }
+    finally {
+        await rm(lock, { recursive: true, force: true });
+    }
+}
+// 古いロックの置き換えは、lock-recovery ディレクトリを作れた 1 プロセスだけが行う。複数のプロセスが
+// 同時に置き換えると、別のプロセスが取得した直後のロックを削除してしまうため。lock-recovery はこの
+// 関数の中だけで保持し、work の前に削除する。この間に強制終了されると lock-recovery が残り、自動では
+// 削除されないので、エラーメッセージにパスを含めて手で削除できるようにする。
+async function replaceStaleLock(directory, lock) {
+    const recovery = join(directory, 'lock-recovery');
+    try {
+        await mkdir(recovery);
+    }
+    catch (error) {
+        if (errorCode(error) !== 'EEXIST')
+            throw error;
+        throw new Error(`Another Shinaps update is recovering its lock: ${recovery}. Retry later; remove that directory only after confirming no update is running.`);
+    }
+    try {
+        const pidPath = join(lock, 'pid');
+        const holder = await readLockPid(pidPath);
+        if (holderMayBeAlive(holder))
+            throw lockBusyError(lock);
+        // pid を読んでから生存を確認するまでの間に、保持者が終了してロックを解放し、別のプロセスが取得
+        // している可能性がある。そのため pid を読み直し、同じ終了済みの pid のままのときだけ古いロック
+        // として削除する。読み直しから削除までの間は、保持者が終了済みで、ほかの置き換え処理も
+        // lock-recovery で止まるため、ロックが変わることはない。
+        if ((await readLockPid(pidPath)) !== holder)
+            throw lockBusyError(lock);
+        await rm(lock, { recursive: true, force: true });
+        try {
+            await mkdir(lock);
+        }
+        catch (error) {
+            if (errorCode(error) !== 'EEXIST')
+                throw error;
+            // 上の rm と mkdir の間に別のプロセスが通常の経路で取得した。
+            throw lockBusyError(lock);
+        }
+    }
+    finally {
+        await rm(recovery, { recursive: true, force: true });
+    }
+}
+// pid ファイルの本文。保持者がまだ書いていなければ null。
+async function readLockPid(pidPath) {
+    try {
+        return await readFile(pidPath, 'utf8');
+    }
+    catch (error) {
+        if (errorCode(error) !== 'ENOENT')
+            throw error;
+        return null;
+    }
+}
+// pid ファイルが無い、空または数値でない、別ユーザーのプロセス (EPERM)、のいずれも実行中として扱う。
+// 保持者が mkdir と pid の書き込みの間にいる場合と、その間に強制終了された場合を区別できないため。
+// ESRCH のときだけ保持者がいないとみなす。強制終了で残ったロックは手で削除する (エラーメッセージに
+// パスを含める)。
+function holderMayBeAlive(text) {
+    if (text === null)
+        return true;
+    const pid = Number(text);
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return true;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = errorCode(error);
+        if (code === 'ESRCH')
+            return false;
+        if (code === 'EPERM')
+            return true;
+        throw error;
+    }
+}
+const lockBusyError = (lock) => new Error(`Another Shinaps update is running: ${lock}. Retry after it finishes; remove the lock only after confirming no update is running.`);

package/dist/lib/transaction.js

@@ -0,0 +1,115 @@
+import { mkdir, rm, rename, cp } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { managedAgent, marketplaceName, payloadDir, pluginId, statePath } from './layout.js';
+import { errorCode, errorMessage, readJsonIfExists, readTextIfExists, writeFileAtomic, } from './fs.js';
+/** エージェント内容の sha256。state.json と journal の `nextHashes` はこの形式で記録する。 */
+export const digest = (text) => createHash('sha256').update(text).digest('hex');
+/** 配布物を Codex に登録する。install と restore で同じ手順を使う。 */
+export async function registerPlugin(command, payload) {
+    await command(['plugin', 'marketplace', 'add', payload]);
+    await command(['plugin', 'add', pluginId]);
+}
+const journalDir = (root) => join(root, 'transaction');
+/**
+ * 配置済みの配布物を `preparedDir` で置き換えて `apply` を実行する。両方を取り消せるだけの記録を
+ * `<root>/transaction` に残す。失敗したら `restore` を実行し、元のエラーを再 throw する。restore も
+ * 失敗した場合は両方のエラーを持つ AggregateError を throw し、バックアップは `<root>/transaction`
+ * に残る。次回の install / update / uninstall / recover が、開始時に restore をやり直す。
+ * @param target 更新の対象。
+ * @param journal 変更前の記録。`hadPayload` を付けて journal.json として保存する。
+ * @param preparedDir 準備済みの配布物。`<root>/codex` と同じファイルシステムにあること。rename で
+ *   配置するので成功後は存在しない。
+ * @param apply 配布物を置いたあとに行う処理。Codex への登録、エージェントの書き込み、state.json。
+ */
+export async function replaceInstallation(target, journal, preparedDir, apply) {
+    const dir = journalDir(target.root);
+    const payload = payloadDir(target.root);
+    await rm(dir, { recursive: true, force: true });
+    await mkdir(dir);
+    let hadPayload = true;
+    try {
+        await cp(payload, join(dir, 'payload'), { recursive: true });
+    }
+    catch (error) {
+        if (errorCode(error) !== 'ENOENT')
+            throw error;
+        hadPayload = false;
+    }
+    // 一時ファイルに書いてから rename するので、journal.json が書きかけの内容で読まれることはない。
+    // fsync はしていないため、電源断のあとは journal が残らず、配布物やエージェントが更新途中のまま残る
+    // ことがある。
+    const saved = { ...journal, hadPayload };
+    await writeFileAtomic(join(dir, 'journal.json'), JSON.stringify(saved));
+    try {
+        await rm(payload, { recursive: true, force: true });
+        await rename(preparedDir, payload);
+        await apply();
+    }
+    catch (error) {
+        try {
+            await restore(target);
+        }
+        catch (recovery) {
+            throw new AggregateError([error, recovery], `${errorMessage(error)}; recovery incomplete: ${errorMessage(recovery)}. Backup retained in ${dir}; run "shinaps-skills recover codex" after fixing the cause.`, { cause: error });
+        }
+        throw error;
+    }
+    await removeJournal(dir);
+}
+/**
+ * `replaceInstallation` が書いた `<root>/transaction/journal.json` の内容で、中断した install / update
+ * の前の状態に戻す。journal が無ければ何もせず返る。journal が別の CODEX_HOME のものか、中断後に
+ * エージェントファイルが編集されている (旧内容でも新内容でもない) 場合は、何も変更せずに throw する。
+ * journal が消えるまで何度でも繰り返せる。journal の削除が最後の手順で、完了の印になる。
+ * @param target 更新の対象。`command` は、Codex が plugin を独自のキャッシュにも保持しているため、
+ *   戻した配布物を登録し直すのに使う。
+ */
+export async function restore(target) {
+    const { root, codexHome, command } = target;
+    const dir = journalDir(root);
+    const journalPath = join(dir, 'journal.json');
+    const journal = await readJsonIfExists(journalPath);
+    if (!journal)
+        return;
+    if (journal.codexHome !== codexHome) {
+        throw new Error(`An interrupted update in CODEX_HOME=${journal.codexHome} must be recovered first, but this run uses ${codexHome}. Run "CODEX_HOME=${journal.codexHome} shinaps-skills recover codex".`);
+    }
+    const agentsDir = join(codexHome, 'agents');
+    for (const [name, priorContent] of Object.entries(journal.agents)) {
+        if (!managedAgent.test(name)) {
+            throw new Error(`Invalid agent filename "${name}" in ${journalPath}.`);
+        }
+        const current = await readTextIfExists(join(agentsDir, name));
+        if (current === null)
+            continue;
+        if (current !== priorContent && digest(current) !== journal.nextHashes[name]) {
+            throw new Error(`Modified agent preserved during recovery: ${join(agentsDir, name)}. Move the edited file elsewhere, then run "shinaps-skills recover codex".`);
+        }
+    }
+    const payload = payloadDir(root);
+    await rm(payload, { recursive: true, force: true });
+    if (journal.hadPayload)
+        await cp(join(dir, 'payload'), payload, { recursive: true });
+    await mkdir(agentsDir, { recursive: true });
+    for (const [name, content] of Object.entries(journal.agents)) {
+        if (content === null)
+            await rm(join(agentsDir, name), { force: true });
+        else
+            await writeFileAtomic(join(agentsDir, name), content);
+    }
+    if (journal.state === null)
+        await rm(statePath(root), { force: true });
+    else
+        await writeFileAtomic(statePath(root), journal.state);
+    // Codex は plugin を独自のキャッシュにも保持しているため、ファイルを戻したあとで登録し直す。
+    if (journal.hadPayload)
+        await registerPlugin(command, payload);
+    await removeJournal(dir);
+}
+// journal の削除が完了の時点。順序が重要で、payload/ が先に消えて journal が残ると、次の restore が
+// 新しい配布物を削除したうえで古い配布物のコピーに失敗する。
+async function removeJournal(dir) {
+    await rm(join(dir, 'journal.json'));
+    await rm(dir, { recursive: true });
+}

package/package.json

@@ -1,13 +1,41 @@
 {
   "name": "@shinaps/skills",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Install Shinaps AI workflows and custom agents for Codex",
   "type": "module",
-  "bin": { "shinaps-skills": "bin/skills.mjs" },
-  "files": ["bin/", "lib/", "codex/", "plugins/", ".agents/plugins/marketplace.json", "README.md", "LICENSE"],
-  "engines": { "node": ">=22" },
-  "scripts": { "test": "node --test", "check": "node --check bin/skills.mjs && node --check lib/install.mjs" },
-  "repository": { "type": "git", "url": "https://github.com/sh1n4ps/shinaps-skills.git" },
+  "bin": {
+    "shinaps-skills": "dist/bin/skills.js"
+  },
+  "files": [
+    "dist/",
+    "plugins/",
+    ".agents/plugins/marketplace.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "test": "node --test \"test/*.test.ts\"",
+    "check": "npm run format:check && tsc --noEmit",
+    "verify:package": "node scripts/verify-package.ts",
+    "format": "biome format --write .",
+    "format:check": "biome format ."
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sh1n4ps/shinaps-skills.git"
+  },
   "license": "MIT",
-  "publishConfig": { "access": "public" }
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@types/node": "^26.6.4",
+    "typescript": "^7.0.2"
+  }
 }

package/plugins/{shinaps → shinaps-claude}/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "shinaps",
   "description": "Shinaps AIの開発ワークフロー。プロジェクトの指示から条件を読み、調査・設計・実装・簡素化・UI検証・レビュー・コミット・PR・リリースを支援する12スキル。",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "author": {
     "name": "shinaps",
     "email": "ryuta@shinaps.jp"

package/plugins/{shinaps → shinaps-claude}/skills/commit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: commit
-description: 許可された差分を依存順の小さなローカルコミットへ分割し、各単位を検証・レビューする。通常は単位ごとに確認し、自律コミットを明示された場合はその許可範囲で続行する。
+description: 許可された差分を依存順の小さなローカルコミットへ分割し、各単位を検証・レビューする。開始時に通常（推奨）・自律の進め方をユーザーに確認し、選択された範囲で実行する。
 ---
 
 ## 作業記録の保存先
@@ -19,7 +19,14 @@ description: 許可された差分を依存順の小さなローカルコミッ
 
 ## 範囲と進め方
 
-コミットはユーザーが明示した場合だけ行う。通常は単位の差分・理由・検証結果・メッセージを提示して可否を確認する。「自律的にレビューしてコミットまで」の明示依頼がある場合は、同じ対象について単位ごとの再確認を省略する。どちらも対象外変更、push、PR、公開、既存履歴の書き換えは含まない。
+コミットはユーザーが明示した場合だけ行う。開始時に、今回の対象についてユーザー自身が進め方を選択済みか確認する。未選択なら、利用可能な入力ツール（なければ文章）で「今回のコミットはどちらで進めますか？」と一問だけ聞く。
+
+- **通常（推奨）**: 単位ごとに差分・理由・検証結果・メッセージを提示し、承認を得てからコミットする。
+- **自律**: 許可された対象を単位ごとに検証・レビューし、個別の承認を求めずコミットする。
+
+回答を受け取るまで作業を進めない。未回答や推奨選択肢の初期選択を承認と扱わない。「コミットして」「進めて」などの一般的な依頼や、エージェント自身の計画から自律モードを推測しない。今回の対象についてユーザーが通常・自律を明示済みならその選択を引き継ぎ、同じ確認を繰り返さない。過去の別対象での自律選択は引き継がない。
+
+どちらも対象外変更、push、PR、公開、既存履歴の書き換えは含まない。
 
 Git操作と修正は現在のセッションが行う。独立レビューは利用可能かつ許可された場合に使う。指定のエージェントがなければ、その役割の観点でレビューする。独立レビューがプロジェクトの必須条件なのに実行できなければ、セルフレビューを同等と称さず止める。別worktreeの作成や別セッションへの委託を、このスキルから許可しない。
 

package/plugins/shinaps-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "shinaps",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Shinaps AIのCodex向け開発ワークフロー",
   "skills": "./skills/"
 }

package/plugins/shinaps-codex/skills/commit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: commit
-description: 許可された差分を依存順の小さなローカルコミットへ分割し、各単位を検証・レビューする。通常は単位ごとに確認し、自律コミットを明示された場合はその許可範囲で続行する。
+description: 許可された差分を依存順の小さなローカルコミットへ分割し、各単位を検証・レビューする。開始時に通常（推奨）・自律の進め方をユーザーに確認し、選択された範囲で実行する。
 ---
 
 ## 作業記録の保存先
@@ -19,7 +19,14 @@ description: 許可された差分を依存順の小さなローカルコミッ
 
 ## 範囲と進め方
 
-コミットはユーザーが明示した場合だけ行う。通常は単位の差分・理由・検証結果・メッセージを提示して可否を確認する。「自律的にレビューしてコミットまで」の明示依頼がある場合は、同じ対象について単位ごとの再確認を省略する。どちらも対象外変更、push、PR、公開、既存履歴の書き換えは含まない。
+コミットはユーザーが明示した場合だけ行う。開始時に、今回の対象についてユーザー自身が進め方を選択済みか確認する。未選択なら、利用可能な入力ツール（なければ文章）で「今回のコミットはどちらで進めますか？」と一問だけ聞く。
+
+- **通常（推奨）**: 単位ごとに差分・理由・検証結果・メッセージを提示し、承認を得てからコミットする。
+- **自律**: 許可された対象を単位ごとに検証・レビューし、個別の承認を求めずコミットする。
+
+回答を受け取るまで作業を進めない。未回答や推奨選択肢の初期選択を承認と扱わない。「コミットして」「進めて」などの一般的な依頼や、エージェント自身の計画から自律モードを推測しない。今回の対象についてユーザーが通常・自律を明示済みならその選択を引き継ぎ、同じ確認を繰り返さない。過去の別対象での自律選択は引き継がない。
+
+どちらも対象外変更、push、PR、公開、既存履歴の書き換えは含まない。
 
 Git操作と修正は現在のセッションが行う。独立レビューは利用可能かつ許可された場合に使う。指定のエージェントがなければ、その役割の観点でレビューする。独立レビューがプロジェクトの必須条件なのに実行できなければ、セルフレビューを同等と称さず止める。別worktreeの作成や別セッションへの委託を、このスキルから許可しない。
 

package/bin/skills.mjs

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import { run } from '../lib/install.mjs';
-
-try {
-  await run(process.argv.slice(2));
-} catch (error) {
-  console.error(`Shinaps: ${error.message}`);
-  process.exitCode = 1;
-}

package/lib/install.mjs

@@ -1,116 +0,0 @@
-import { mkdir, readFile, writeFile, readdir, cp, rm, rename, lstat } from 'node:fs/promises';
-import { homedir } from 'node:os';
-import { join, dirname, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createHash, randomUUID } from 'node:crypto';
-import { spawnSync } from 'node:child_process';
-
-const source = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-const plugin = 'shinaps@shinaps-skills-codex';
-const digest = text => createHash('sha256').update(text).digest('hex');
-
-async function optional(path) {
-  try {
-    if ((await lstat(path)).isSymbolicLink()) throw new Error(`Symlink preserved: ${path}`);
-    return await readFile(path, 'utf8');
-  }
-  catch (error) { if (error.code === 'ENOENT') return null; throw error; }
-}
-
-export async function run(args, options = {}) {
-  const [action, target, ...extra] = args;
-  const log = options.log ?? console.log;
-  if (!action || action === '--help' || action === 'help') {
-    log('Usage: shinaps-skills <install|update|uninstall> codex\nClaude Code: /plugin marketplace add sh1n4ps/shinaps-skills\n             /plugin install shinaps@shinaps-skills');
-    return;
-  }
-  if (!['install', 'update', 'uninstall'].includes(action) || target !== 'codex' || extra.length) {
-    throw new Error('Use install, update or uninstall followed by codex. See --help.');
-  }
-  const home = options.home ?? homedir();
-  const codexHome = options.codexHome ?? process.env.CODEX_HOME ?? join(home, '.codex');
-  const root = join(home, '.local', 'share', 'shinaps-ai', 'skills');
-  const statePath = join(root, 'state.json');
-  const payload = join(root, 'codex');
-  const agentsDir = join(codexHome, 'agents');
-  const stateText = await optional(statePath);
-  const state = stateText ? JSON.parse(stateText) : { agents: {}, codexHome };
-  // Ownership is bound to the installation target, so a changed CODEX_HOME cannot
-  // make an uninstall remove a different account's files.
-  if (state.codexHome !== codexHome) throw new Error('CODEX_HOME differs from the existing install. Use the original target first.');
-  const command = options.command ?? ((argv) => {
-    const result = spawnSync('codex', argv, { stdio: 'inherit' });
-    if (result.error) throw result.error;
-    if (result.status !== 0) throw new Error(`codex ${argv.join(' ')} failed. Fix the reported error and retry; installed state is retained.`);
-  });
-  const save = async () => {
-    await mkdir(root, { recursive: true });
-    await writeFile(statePath + '.tmp', JSON.stringify(state, null, 2) + '\n');
-    await rename(statePath + '.tmp', statePath);
-  };
-  // A prefix does not prove ownership. Only exact recorded content is replaced
-  // or deleted; a user's edits require their explicit resolution.
-  for (const [name, hash] of Object.entries(state.agents)) {
-    if (!/^shinaps-[a-z0-9-]+\.toml$/.test(name)) throw new Error('Invalid managed agent filename.');
-    const current = await optional(join(agentsDir, name));
-    if (current !== null && digest(current) !== hash && digest(current) !== state.pending?.[name]) throw new Error(`Modified agent preserved: ${join(agentsDir, name)}`);
-  }
-  if (action === 'uninstall') {
-    if (!stateText) { log('No managed Shinaps installation found.'); return; }
-    await command(['plugin', 'remove', plugin]);
-    await command(['plugin', 'marketplace', 'remove', 'shinaps-skills-codex']);
-    for (const name of Object.keys(state.agents)) await rm(join(agentsDir, name), { force: true });
-    await rm(payload, { recursive: true, force: true });
-    await rm(statePath);
-    log('Removed managed Codex plugin and agents. Other skills and MCP credentials were preserved.');
-    return;
-  }
-  const agentSource = join(options.source ?? source, 'codex', 'agents');
-  const next = {};
-  for (const name of await readdir(agentSource)) {
-    if (!/^shinaps-[a-z0-9-]+\.toml$/.test(name)) continue;
-    const content = await readFile(join(agentSource, name), 'utf8');
-    const current = await optional(join(agentsDir, name));
-    if (!(name in state.agents) && current !== null) throw new Error(`Unmanaged agent preserved: ${join(agentsDir, name)}. Remove or relocate the old Shinaps registration first.`);
-    next[name] = { content, hash: digest(content) };
-  }
-  // npx's download cache is temporary. Keep the marketplace payload at a stable
-  // location so later Codex sessions and updates do not depend on that cache.
-  await rm(payload, { recursive: true, force: true });
-  await mkdir(payload, { recursive: true });
-  await cp(join(options.source ?? source, 'plugins', 'shinaps-codex'), join(payload, 'plugins', 'shinaps-codex'), { recursive: true });
-  await mkdir(join(payload, '.agents', 'plugins'), { recursive: true });
-  await cp(join(options.source ?? source, '.agents', 'plugins', 'marketplace.json'), join(payload, '.agents', 'plugins', 'marketplace.json'));
-  await save();
-  await command(['plugin', 'marketplace', 'add', payload]);
-  await command(['plugin', 'add', plugin]);
-  await mkdir(agentsDir, { recursive: true });
-  for (const [name, { content, hash }] of Object.entries(next)) {
-    // Keep both the old and new digest until the atomic replacement completes.
-    // Retrying after an interrupted update can then recognize either version.
-    state.agents[name] ??= hash;
-    state.pending = { [name]: hash };
-    await save();
-    const temporary = join(agentsDir, `.${name}.${randomUUID()}.tmp`);
-    try {
-      await writeFile(temporary, content, { flag: 'wx' });
-      await rename(temporary, join(agentsDir, name));
-    } finally {
-      await rm(temporary, { force: true });
-    }
-    state.agents[name] = hash;
-    delete state.pending;
-    await save();
-  }
-  for (const name of Object.keys(state.agents)) {
-    if (!(name in next)) {
-      await rm(join(agentsDir, name), { force: true });
-      delete state.agents[name];
-    }
-  }
-  await save();
-  log('Shinaps installed. Start a new Codex session to load skills and agents.');
-  log('No Shinaps AI account is required to install. For MCP features, create an account at https://app.shinaps.ai and use your client’s authentication flow.');
-  log('MCP setup (only if not already configured): codex mcp add shinaps-ai --url https://app.shinaps.ai/mcp');
-  log('Then: codex mcp login shinaps-ai');
-}