@quolu/aishell 0.2.1 → 0.3.1

package/README.md

@@ -1,9 +1,15 @@
 # AIShell
 
-AIがshell、Terminal、AppleScript、JXAを介さず、SwiftのmacOS APIを通してOSを直接操作する実験プロジェクト。
+AIの要求を汎用shell文字列へ潰さず、SwiftのmacOS APIと指定された開発workerを通してOS状態を直接扱う実験プロジェクト。
 
 ## 現在できること
 
+- 既定のdevelopment profileから、OS状態を束ねた5本の高密度toolを提供
+  - `workspace_snapshot`: 初回scanのbounded previewとFSEvents由来の変更delta、Git状態、主要context
+  - `read_context`: 複数fileのbudget付きread、SHA-256、continuation
+  - `search_context`: `rg` workerによるbudget付き検索context
+  - `run_check`: 直接process実行、主要診断、完全stdout/stderr artifact
+  - `artifact_read`: artifactのrange、tail、pattern周辺read
 - 許可フォルダ内の一覧、検索、UTF-8テキスト読取
 - フォルダ／テキスト作成、copy、move、rename、Trash
 - stat、SHA-256、再帰tree
@@ -50,13 +56,15 @@ MCP実行ファイルはアプリ内に同梱される。
 codex mcp add aishell -- /opt/homebrew/bin/aishell-mcp
 ```
 
-このMacでは登録済み。新しく開始したCodexタスクから `aishell` の20ツールを利用できる。AIには次のように伝えればよい。
+新しく開始したCodexタスクでは、既定で上記5本のdevelopment toolを利用できる。従来のprimitiveを含む25 toolが必要な互換利用では、server環境へ`AISHELL_TOOL_PROFILE=full`を設定する。
 
 ```text
-AIShellを使いこなして。最初にruntime_statusを確認して。Git worktreeはautomaticGitWorktreePathsとeffectiveAllowedRootPathsへ自動反映されるので、worktreeごとの許可追加を私へ要求しないで。停止中または通常フォルダの許可root不足ならruntime_open_managerで管理画面を開いて。絶対パスはeffectiveAllowedRootPaths、相対パスはprimaryAllowedRootPathを基準に扱って。
+複数file・反復workspace観測ではworkspace_snapshotを使い、返されたcursorでdeltaを取って。32 KiBを超え得るbuild/test出力はrun_checkを使い、通常responseにない証拠だけartifact_readで読む。小さな単一file作業はCodex標準toolを使ってよい。
 ```
 
-`runtime_status` は設定root、自動認識したGit worktree、実効root、相対パスの基準、停止状態、次の操作を返す。停止中でも `runtime_open_manager` で管理アプリを前面化できるため、Computer Useや旧shellで入口を作る必要はない。許可root変更と再開は管理画面で人が行い、停止中の通常操作は引き続き拒否される。
+full profileの`runtime_status`は設定root、自動認識したGit worktree、実効root、相対パスの基準、停止状態、次の操作を返す。停止中でも`runtime_open_manager`で管理アプリを前面化できる。許可root変更と再開は管理画面で人が行い、停止中の通常操作は引き続き拒否される。
+
+`run_check`は指定workerがfile更新・子process・network accessを行い得るため、MCPへdestructive/open-world capabilityとして掲示する。host設定によっては実行承認が必要になる。0.3のstdio serverは1 requestずつ処理し、timeout時のprocess tree終了は行うが、MCP cancellationと並列pollingは未実装である。
 
 登録確認と解除は次のとおり。
 
@@ -74,6 +82,8 @@ scripts/package-app.sh release
 
 `xcodegen generate` で `AIShell.xcodeproj` を再生成できる。現在の検証機ではXcode 26.6とCoreSimulatorのbuild versionが一致せず、`xcodebuild` はXCBuild開始待ちで停止するため、同じSwift 6.3.3 toolchainを使うSwiftPMでビルド・テストした。この環境問題はソースの成功扱いへ混ぜていない。
 
-## 実装上の禁止事項
+## 高密度runtimeの設計制約
+
+`AIShellCore` と `AIShellMCP` はshellやAppleScript/JXAの文字列を解釈せず、開発プログラム名を`PATH`から実行ファイルURLへ解決し、引数配列と分離したままmacOSのprocess APIへ渡す。`sh`、`bash`、`zsh`、`dash`、`ksh`、`csh`、`tcsh`、`fish`、`env`、`osascript`というbasenameの直接起動と、パイプ、リダイレクト、shell展開は拒否する。
 
-`AIShellCore` と `AIShellMCP` は、shell、AppleScript、JXA、コマンド文字列を実行しない。開発プログラムは実行ファイルの絶対パスと引数配列を分離したままmacOSのprocess APIへ渡し、shell本体の起動、パイプ、リダイレクト、shell展開を拒否する。MCPは型付き要求をmacOSネイティブAPIへ渡すアダプターである。
+この拒否listはsecurity boundaryではない。改名したbinaryや、許可されたworkerが内部で起動する子processまでは阻止しない。目的は任意コード実行を安全化することではなく、AIの要求を安易な`zsh -lc`へ戻さず、executable、arguments、working directory、lifecycle、artifactを分離してAIShellが所有する高密度経路へ誘導することである。`env`も環境変数mapとAIShell自身の`PATH`解決で不要なwrapperなので同じ設計レールに含める。MCPは型付き要求をOS-owned runtimeへ渡すアダプターである。

package/dist/AIShell.app/Contents/Info.plist

@@ -17,9 +17,9 @@
     <key>CFBundlePackageType</key>
     <string>APPL</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.2.1</string>
+    <string>0.3.1</string>
     <key>CFBundleVersion</key>
-    <string>4</string>
+    <string>6</string>
     <key>LSApplicationCategoryType</key>
     <string>public.app-category.utilities</string>
     <key>LSMinimumSystemVersion</key>

package/dist/AIShell.app/Contents/_CodeSignature/CodeResources

@@ -10,10 +10,10 @@
 		<dict>
 			<key>cdhash</key>
 			<data>
-			P6TLSD44rySuSWOPk1nwQYY+93k=
+			FLGSmJXEwfXtdPx0sRj6U3C4sCo=
 			</data>
 			<key>requirement</key>
-			<string>cdhash H"3fa4cb483e38af24ae49638f9359f041863ef779"</string>
+			<string>cdhash H"14b1929895c4c1f5ed74fc74b118fa5370b8b02a"</string>
 		</dict>
 	</dict>
 	<key>rules</key>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quolu/aishell",
-  "version": "0.2.1",
-  "description": "A native macOS MCP server for direct file, app, and development tool operations without a shell",
+  "version": "0.3.1",
+  "description": "A native macOS state runtime with high-density MCP tools for AI development",
   "license": "UNLICENSED",
   "author": "quolu",
   "repository": {