Pre-choice usable artifact execution

Purpose & Output Contractの最小の実成果物またはremote mutation previewをmain contextで作成する。effect別のparse/open・secret・irreversible・corrupt guardだけを実行し、現物path・digest・開き方またはpreview receiptを提示してからaccept-as-is/light/standard/detailedを記録する。accept-as-isはmutationを実行せずhandoff完了とし、後続sectionを実行しない。

Post-choice selected improvement execution

以下の既存workflow・goal-seek・評価・修正sectionおよびexternal mutation safety wrapperはlight/standard/detailedが記録されてsemantic_evaluator_startedへ遷移した場合だけ実行する。actual mutationはcanonical preview→hook-confirm→authorize→execute wrapperだけを通し、release/exhaustiveは別の明示eventを必要とする。

<!-- external-mutation-guard-cli:v1 -->

Canonical external mutation receipt flow (mandatory)

Never execute the external mutation argv directly. Replace every angle-bracket placeholder with the reviewed value from this run; the central CLI fails closed on missing/invalid values.

Resolve the guard plugin root once, before preview. An installed plugin cannot reach a sibling plugin as <plugin root>/.., so never guess that path:

python3 "${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/extract-plugin-root.py" skill-governance-adapters

Use the printed absolute path as <GUARD_PLUGIN_ROOT> in preview, authorize and execute (other Bash is blocked while the confirmation is pending, so do not resolve it again). If the resolver exits non-zero, stop without any external mutation and tell the user to install the skill-governance-adapters plugin.

python3 "<GUARD_PLUGIN_ROOT>/scripts/build-external-mutation-guard.py" preview --project-root "$PWD" --entrypoint-ref "plugin:<PLUGIN_NAME>/skills/<SKILL_NAME>/SKILL.md" --target-scope "<TARGET_SCOPE>" --diff-summary "<DIFF_SUMMARY>" --side-effect-summary "<SIDE_EFFECT_SUMMARY>" --command-json '<MUTATION_ARGV_JSON>'

Present that official preview output to the user. Only the exact user reply printed by preview may trigger the registered hook-confirm producer. Then use the two returned receipt paths:

python3 "<GUARD_PLUGIN_ROOT>/scripts/build-external-mutation-guard.py" authorize --project-root "$PWD" --preview-receipt "<PREVIEW_RECEIPT_PATH>" --confirmation-receipt "<CONFIRMATION_RECEIPT_PATH>"
python3 "<GUARD_PLUGIN_ROOT>/scripts/build-external-mutation-guard.py" execute --project-root "$PWD" --authorization-receipt "<AUTHORIZATION_RECEIPT_PATH>" --command-json '<MUTATION_ARGV_JSON>'

Do not use an auto-approval flag or invoke the mutation command outside this receipt flow.

<!-- /external-mutation-guard-cli:v1 -->

run-codex-plugin-install

Runtime root contract

runtime_root_policy: host-skill-path の製品別root解決、cwd推測禁止、prompt継承は ref-cross-platform-runtime の共有正本 をそのまま適用する。installerに渡すrepository rootはplugin runtime rootと混同せず明示入力にする。

Purpose & Output Contract

明示されたlocal/Git sourceとplugin scopeを入力に、marketplace登録・install・CLI実測を一連で実行し、検証済みreceiptを出力する。成功出力は status=installed、verified=true、installed/enabledの実測、runtime identity、hook_trust=user-review-required を含む。user-global install状態を変更する副作用はユーザーがinstallを依頼した場合に限り、hook trustは変更しない。

ユーザーが install を明示依頼した場合だけ、Claude Codeのuser scopeまたはCodexの user-global marketplace/cache/configを変更する。package生成とは別の副作用境界とし、 hook trustは自動承認しない。

入力

• plugin-name: marketplaceに掲載済みのplugin identity
• source: repository rootの絶対/相対path、またはGit source (owner/repo 等)
• ref: Git sourceだけで指定可能。PR merge後のbranch/tag/SHA

ゴールシーク実行

ゴール (Goal)

ユーザーが明示したplugin scopeだけが指定sourceからinstalledと検証され、runtime identityとhook trust境界を含むreceiptが後続へ渡せる状態になっている。

目的・背景 (Why)

CLIのexit 0だけではinstall実体、enabled状態、version/source/runtimeの一致は証明できない。操作と実測を分け、ユーザー指定scopeとtrust決定権を保ったまま収束させる。

完了チェックリスト (Checklist)

• local/Gitのsource種別、plugin名、refが明示入力と一致する
• receiptに status/plugin_id/verified/enabled/runtime_path が存在する
• status=installed かつ verified=true をCLI listのinstalled/enabled実測が支持する
• plugin名・version・source・runtime identityが一致する
• runtime pathがabsoluteかつ実在し、repository外cwdの --check がexit 0になる
• hook trustが user-review-required として残り、自動承認されていない

ゴールシークループ

workflow-manifest.json の依存とR1 promptを読み、未充足のチェックを1つ選ぶ。preflight・install・receipt検証の候補から現状に必要な最小操作を都度立案・実行し、検証結果でチェックを更新する。全項目充足まで反復し、3周で未達なら残項目を open_issues に記録して成功扱いせず停止する。

ゴールシーク配線

反復はfrontmatter goal_seek.fork=subagent で親contextから分離する。周回状態は eval-log/run-codex-plugin-install-progress.json、アンカーは eval-log/run-codex-plugin-install-intermediate.jsonl に追記し、original_goal を不変として次周の merged_directive_for_next に必ず合流させる。

ゴールシーク検証

アンカーの機械検査は goal-seek正本 を適用する。各行の required_keys、progressの original_goal_hash、hashlib.sha256 による不変アンカー照合が通らなければ完了にしない。

検証

• local全件routeは install-local-plugins.py --all --check をrepository外cwdから実行する
• 単一local/Git routeはreceiptの status=installed / verified=true / identityと codex plugin list --json の実測を照合する
• 非0・非JSON・同名多重activation・依存cache version不一致はPASSに変換しない

Claude Code / Codexへlocal全件install

絶対script pathを使えば、harness外のどのcwdからでも実行できる。helperはClaude側では <repo>/marketplaces/local、Codex側では<repo>を別々の絶対marketplace rootとして登録する。

python3 /absolute/path/to/harness/plugins/harness-creator/scripts/install-local-plugins.py --all

別cwdからread-only verification:

cd /tmp
python3 /absolute/path/to/harness/plugins/harness-creator/scripts/install-local-plugins.py --all --check

1件だけなら--plugin <name>、片方だけなら--platform claude|codexを付ける。

Codex単独のlocal / Git実行

local repository:

python3 "$PLUGIN_ROOT/scripts/install-codex-plugin.py" \
  --source /absolute/path/to/repository \
  --plugin <plugin-name>

merge済みGit ref:

python3 "$PLUGIN_ROOT/scripts/install-codex-plugin.py" \
  --source owner/repo \
  --ref main \
  --plugin <plugin-name>

helperはmarketplace名をCLI receiptから取得し、Git sourceが既登録ならsnapshotをupgrade、 pluginをinstallし、codex plugin list --jsonでinstalled/enabledを再確認する。

完了条件

• report status=installed
• plugin_id=<plugin>@<marketplace> が installed
• enabled状態をreportに記録
• local全件installでは両catalogのplugin集合一致、全cache pathの絶対path・実在を確認
• repository外cwdで--checkがstatus=verified
• hook trustは user-review-required のまま保持
• current hook command/eventをユーザーが確認してtrust後、新規threadでskillを確認

失敗時

• local marketplaceに対象entryがなければglobal状態を変更する前に停止
• local sourceへ--refを指定したら停止
• marketplace add/install/listのいずれかが非0または非JSONならexit 3
• hook trustを代行しない