Releases · archfill/tsumugi

Release list

tsumugi-cli v0.1.6 Latest

Latest

archfill released this 27 Jun 10:20

cli-v0.1.6

f5cafa5

Patch release. Codex から信頼済みの tsumugi MCP server へ memory 保存・検索する操作を、CLI install 時に自動承認するようにした。

What changed

Codex MCP tool approval

tsumugi-cli install --platform=codex が ~/.codex/config.toml に以下を追加するよう変更:

[mcp_servers.tsumugi.tools.save_observation]
approval_mode = "approve"

[mcp_servers.tsumugi.tools.search_memory]
approval_mode = "approve"

これにより、信頼済みの tsumugi server への save_observation / search_memory は Codex の approval review 対象にならない。
mark_memory_outdated / trigger_dreaming は別の副作用を持つため、自動承認対象にはしていない。
既存の mcp_servers.tsumugi section と対象 tool section を再実行時に重複させず、まとめて更新するようにした。

Docs

apps/cli/README.md に CLI が書く Codex approval 設定と手動設定方法を追記。
integrations/codex/README.md に手動 install 時の approval_mode = "approve" 設定を追記。
Codex hook の session guidance に、approval review で拒否された save_observation を再試行・迂回しない注意を追加。

Upgrade

CLI を更新:

npm install -g @archfill/tsumugi-cli@0.1.6

または都度実行:

npx @archfill/tsumugi-cli@0.1.6 install --platform=codex

既存の Codex 設定へ approval 設定だけ反映したい場合も、同じ install command を再実行できる。

Notes

CLI package version は 0.1.6。
plugin metadata version は引き続き 0.1.0。これは Claude Code / Codex plugin metadata 用で、CLI package version とは別管理。
save_observation は repo / session 内容を永続化する操作なので、信頼済みの tsumugi server にだけこの設定を使う。

Verification

pnpm install --frozen-lockfile
pnpm --filter @archfill/tsumugi-cli typecheck
npm pack --dry-run
temporary CODEX_HOME install smoke: generated mcp_servers.tsumugi.tools.save_observation/search_memory approval settings
idempotency smoke: existing mcp_servers.tsumugi config is updated without duplicate sections
npm publish --auth-type=web
npm view @archfill/tsumugi-cli version dist-tags.latest -> 0.1.6

What changed

known_marketplaces.json / installed_plugins.json / settings / credentials などの atomic write で、一時ファイルを保存先ファイルと同じディレクトリに作成するよう変更。
これにより /tmp と ~/.claude / ~/.config が別ファイルシステムの場合でも rename が失敗しない。
CLI package version を 0.1.5 に更新。
npm package metadata の repository.url を正規形に更新。

Upgrade

CLI を更新:

npm install -g @archfill/tsumugi-cli@0.1.5

または都度実行:

npx @archfill/tsumugi-cli@0.1.5 install

Notes

CLI package version は 0.1.5。
plugin metadata version は引き続き 0.1.0。これは Claude Code の installed plugin metadata 用で、CLI package version とは別管理。

Verification

node --check apps/cli/bin/cli.mjs
npm pack --dry-run
npm publish --access public
npm view @archfill/tsumugi-cli version -> 0.1.5

What changed

Codex marketplace registration

Codex の登録を local path marketplace から Git marketplace に変更:

codex plugin marketplace add archfill/tsumugi --ref main
codex plugin add tsumugi@archfill

これにより、以後の更新は Codex CLI 標準の marketplace upgrade で取得できる:

codex plugin marketplace upgrade archfill

CLI update command

tsumugi-cli update を追加。
Claude Code:
- local marketplace clone を git pull --ff-only
- known_marketplaces.json / installed_plugins.json を再登録
Codex:
- Git marketplace 登録を保証
- codex plugin marketplace upgrade archfill
- codex plugin add tsumugi@archfill で plugin install/enabled 状態を更新

Docs

apps/cli/README.md の install/update 説明を Git marketplace 前提に更新。
integrations/codex/README.md の manual install/update 手順を更新。

Hooks metadata

integrations/codex/hooks/hooks.json から top-level description metadata を削除。
hook 本体の event / matcher / command は変更なし。

Upgrade

CLI を更新:

npm install -g @archfill/tsumugi-cli@0.1.4

または都度実行:

npx @archfill/tsumugi-cli@0.1.4 update

Codex だけ更新する場合:

npx @archfill/tsumugi-cli@0.1.4 update --platform=codex

Claude Code だけ更新する場合:

npx @archfill/tsumugi-cli@0.1.4 update --platform=claude

Notes

CLI package version は 0.1.4。
plugin metadata version は引き続き 0.1.0。これは Claude Code の installed plugin metadata 用で、CLI package version とは別管理。
v0.1.4 以降の Codex 更新は codex plugin marketplace upgrade archfill が使える。

Verification

node --check apps/cli/bin/cli.mjs
node apps/cli/bin/cli.mjs --help
node apps/cli/bin/cli.mjs update --help
pnpm --filter @archfill/tsumugi-cli typecheck
node apps/cli/bin/cli.mjs update --platform=codex
codex plugin marketplace upgrade archfill --json
pnpm --filter @archfill/tsumugi-cli test
pnpm --filter @archfill/tsumugi-cli pack:dry
main CI: build & typecheck / db integration

解消された問題 (調査結果)

v0.1.2 まで codex plugin add で plugin install までは進むものの、hook が登録されない問題があった。Codex 公式 docs を確認した結果、原因は 3 段:

hook ファイル名/参照のズレ — Codex の plugin-bundled hooks 既定は hooks/hooks.json。v0.1.2 までは hooks/codex-hooks.json という独自名で、.codex-plugin/plugin.json に "hooks" の明示も無く、Codex から hook が発見されていなかった。
plugin install / enable は OK — [plugins."tsumugi@archfill"] enabled = true は立っていた。v0.1.2 の codex plugin add 修正は正解。
script path の cache packaging 問題 — codex plugin add は plugin source (integrations/codex/) のみを cache に copy するため、${PLUGIN_ROOT}/../shared/scripts/... の親階層参照は cache では成立しない (../shared/scripts/ が存在しない)。

加えて Codex 公式仕様として、plugin-bundled hooks は trust 承認まで skip される (参照: Codex Hooks: Plugin-bundled hooks)。

What changed

Plugin layout の刷新

integrations/codex/hooks/codex-hooks.json → integrations/codex/hooks/hooks.json (Codex 既定名にリネーム、manifest 指定不要)
Python script を各 plugin dir 内に duplicate:
- integrations/claude-code/scripts/{_lib,session_start,user_prompt_submit,pre_tool_use_read}.py
- integrations/codex/scripts/{_lib,session_start,user_prompt_submit,pre_tool_use_read}.py
integrations/shared/scripts/ を削除 (各 plugin が self-contained)
親階層参照 ${VAR}/.. を全廃

hooks.json のパス更新

Claude Code: ${CLAUDE_PLUGIN_ROOT}/scripts/...
Codex: ${PLUGIN_ROOT}/scripts/...

CLI / docs 改善

install 完了 outro に Codex の hook trust 承認案内 を追加 (公式 docs リンク付き)
integrations/codex/README.md に hook trust 承認手順の節を追加

Upgrade from v0.1.1 / v0.1.2

強制再 clone で新レイアウトを取得して再 install してください:

npx @archfill/tsumugi-cli@0.1.3 install --platform=codex -f

Codex を再起動した最初の session で hook trust プロンプトが出るので、SessionStart / UserPromptSubmit / PreToolUse(Read) をそれぞれ approve してください (公式仕様)。

承認状態は config.toml で確認:

grep '\[hooks.state."tsumugi@archfill:hooks/hooks.json' ~/.codex/config.toml
# 各 event の trusted_hash エントリが出ていれば成功

Side effects

script の duplicate により plugin source の合計サイズが ~10KB 増加
shared/scripts/ 廃止により Claude Code と Codex でスクリプト並行メンテが必要 (small footprint なので問題限定的)

What changed

Codex: `codex plugin add` を install フローに追加

v0.1.1 では codex plugin marketplace add のみで止まっており、~/.codex/config.toml の [plugins."tsumugi@archfill"] セクションは作られるものの enabled = true が立たず、結果として hook が読み込まれない状態でした。

v0.1.2 では marketplace 登録に続いて codex plugin add tsumugi@archfill も自動で実行します。これにより plugin が正しく enable され、hook が読まれるようになります。

実装は idempotent: 既に install 済みのケース (already installed / already enabled / already present stderr) は benign に成功扱い。

CLI 内部: `runCodex(args, opts)` ヘルパーを切り出し

複数の codex サブコマンド呼出 (marketplace add / plugin add) で共通の stderr-pattern-allowance ロジックを共有します。

README: 手動 install 手順と "What install writes" 表を更新

手動 install (Codex) に codex plugin add tsumugi@archfill の行を追加
「marketplace add だけだと enabled = true が立たない」旨を 1 行で説明
[mcp_servers.tsumugi] 自動追記の TOML スニペットも掲載
"What install writes" 表に新規 Codex 行 2 つ (plugin add / mcp_servers.tsumugi) を追加

Upgrade from v0.1.1

v0.1.1 で install して Codex hook が動いていなかった方は、v0.1.2 で再 install するだけで自動修復されます (force 不要):

npx @archfill/tsumugi-cli install -u https://your-tsumugi.example.com --platform=codex

Known issue (本 release では未解決)

hook command の ${PLUGIN_ROOT}/../shared/scripts/... という親階層参照が Codex の実行時に解決されるかは未検証。codex plugin add 後に hook が実際に発火するか実機確認したのち、必要であれば script の配置を見直す v0.1.3 を別途切る予定です。

What changed

Claude Code: `TSUMUGI_API_URL` を `settings.json.env` に自動書込

v0.1.0 では ~/.config/tsumugi/credentials.json に URL を保存しても、plugin の .mcp.json 内 ${TSUMUGI_API_URL}/mcp を解決する手段がなく、再起動後に "Missing environment variables: TSUMUGI_API_URL" エラーが出ていました。

v0.1.1 では ~/.claude/settings.json の env ブロックに TSUMUGI_API_URL を直接書き込みます。Claude Code を再起動するだけで MCP server が自動で繋がります。

Codex: `~/.codex/config.toml` に `[mcp_servers.tsumugi]` を自動書込

v0.1.0 では Codex 側は shell rc に手動で export TSUMUGI_API_URL=... する必要がありました。

v0.1.1 では ~/.codex/config.toml に既存の MCP server エントリ (例: mcp_servers.yui) と同じ literal URL 形式で [mcp_servers.tsumugi] セクションを自動で追加・更新します。codex を再起動するだけで MCP が動きます。

実装は 行ベースで idempotent: 既存セクションは内容を replace、未存在なら末尾に append。他の [mcp_servers.*] セクションやコメントは完全に保護されます。

Install

npx @archfill/tsumugi-cli install

Upgrade from v0.1.0

v0.1.0 で install していて MCP エラーに遭遇している方は、v0.1.1 で再 install すれば自動で修復されます (force re-clone 不要):

npx @archfill/tsumugi-cli install -u https://your-tsumugi.example.com

Install

npx @archfill/tsumugi-cli install

対話で:

tsumugi server URL を入力
Install for which platform? (Claude Code / Codex / Both)

の 2 つを聞かれるだけで、marketplace 登録 / plugin 有効化 / credentials 書込まで全部自動。

Features

Claude Code 対応: ~/.claude/plugins/ 配下に marketplace + plugin 登録、settings.json の enabledPlugins に追記
Codex 対応: ~/.codex/plugins/marketplaces/archfill/ に clone、codex plugin marketplace add で登録 (codex CLI が PATH にある場合)
Both 同時インストール: --platform=both (デフォルト) で両プラットフォームに 1 コマンドで導入
対話 UI: @clack/prompts ベースの polished な prompts + スピナー付きタスク進捗
非対話モード: --non-interactive + --url で CI / スクリプト対応
fail-safe: ファイル書込は atomic (tmp + rename) で既存設定を破壊しない

What it installs

3 つの inject-only hook (SessionStart / UserPromptSubmit / PreToolUse(Read)) — agent への過去 memory 注入と save_observation rubric (ADR-011)
tsumugi MCP server (save_observation / search_memory / trigger_dreaming / get_dreaming_status) を .mcp.json 経由で自動登録

CLI options

-u, --url <URL>           tsumugi server URL
-p, --platform <kind>     claude | codex | both
-y, --non-interactive     Skip prompts (requires --url)
-f, --force               Re-clone marketplace
-h, --help

Releases: archfill/tsumugi

Release list

tsumugi-cli v0.1.6

What changed

Codex MCP tool approval

Docs

Upgrade

Notes

Verification

Links

Uh oh!

tsumugi-cli v0.1.5

What changed

Upgrade

Notes

Verification

Links

Uh oh!

tsumugi-cli v0.1.4

What changed

Codex marketplace registration

CLI update command

Docs

Hooks metadata

Upgrade

Notes

Verification

Links

Uh oh!

tsumugi-cli v0.1.3

解消された問題 (調査結果)

What changed

Plugin layout の刷新

hooks.json のパス更新

CLI / docs 改善

Upgrade from v0.1.1 / v0.1.2

Side effects

Links

Uh oh!

tsumugi-cli v0.1.2

What changed

Codex: codex plugin add を install フローに追加

CLI 内部: runCodex(args, opts) ヘルパーを切り出し

README: 手動 install 手順と "What install writes" 表を更新

Upgrade from v0.1.1

Known issue (本 release では未解決)

Links

Uh oh!

tsumugi-cli v0.1.1

What changed

Claude Code: TSUMUGI_API_URL を settings.json.env に自動書込

Codex: ~/.codex/config.toml に [mcp_servers.tsumugi] を自動書込

Install

Upgrade from v0.1.0

Links

Uh oh!

tsumugi-cli v0.1.0

Install

Features

What it installs

CLI options

Links

Uh oh!

Codex: `codex plugin add` を install フローに追加

CLI 内部: `runCodex(args, opts)` ヘルパーを切り出し

Claude Code: `TSUMUGI_API_URL` を `settings.json.env` に自動書込

Codex: `~/.codex/config.toml` に `[mcp_servers.tsumugi]` を自動書込