@quolu/aishell 0.4.10 → 0.4.12

package/README.ja.md

@@ -1,10 +1,10 @@
 <p align="center">
-  <img src=".github/og.png" alt="AIShell — AI開発へDirect OS contextを提供" width="100%">
+  <img src="https://raw.githubusercontent.com/kitepon/aishell/main/.github/og.png" alt="AIShell — AI開発へDirect OS contextを提供" width="100%">
 </p>
 
 # AIShell
 
-[![CI](https://github.com/kitepon-rgb/aishell/actions/workflows/ci.yml/badge.svg)](https://github.com/kitepon-rgb/aishell/actions/workflows/ci.yml)
+[![CI](https://github.com/kitepon/aishell/actions/workflows/ci.yml/badge.svg)](https://github.com/kitepon/aishell/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@quolu/aishell)](https://www.npmjs.com/package/@quolu/aishell)
 ![macOS 15+](https://img.shields.io/badge/macOS-15%2B-111827)
 ![Swift 6](https://img.shields.io/badge/Swift-6-F05138)
@@ -16,9 +16,10 @@
 [kitepon.dev](https://kitepon.dev/)を運営する[クオ（@QLyun35332）](https://x.com/QLyun35332)が
 開発・メンテナンスしています。
 
-**所有境界:** 本repositoryはApple Silicon Mac向けOS context runtimeを所有します。
-製品横断の導入・統合契約は、kitepon.devの製品開発を支える内部基盤
-[dotagents](https://github.com/kitepon-rgb/dotagents)が担当します。
+**所有境界:** 本repositoryはApple Silicon Mac向けruntimeのinstall、設定、
+state/schema migration、診断、復旧、更新、releaseを単独で所有します。
+[dotagents](https://github.com/kitepon/dotagents)は公開contractを使って製品横断wireと
+互換性を統合しますが、AIShellの内部運用を制御しません。
 
 AIShellは許可root、file identity、filesystem照合state、直接起動したprocess、完全log、artifactを所有する。reasoning、thread、compaction、sub-agent、汎用terminalはAI hostの責務として残す。
 
@@ -117,7 +118,7 @@ aishell-open
 ## Sourceからbuild
 
 ```sh
-git clone https://github.com/kitepon-rgb/aishell.git
+git clone https://github.com/kitepon/aishell.git
 cd aishell
 swift test
 scripts/package-app.sh release
@@ -171,6 +172,35 @@ full profileにはfile一覧・read、SHA-256競合検出付きatomic update、c
 - 初回workspace entryはbounded previewで、後続deltaはcursor pageになる。
 - Developer ID署名とnotarizationは未設定。
 
+## 運用・更新・release
+
+単独installの更新は初回と同じ公式npm経路を使い、新版の管理アプリを開く。
+
+```sh
+npm install -g @quolu/aishell@latest
+aishell-open
+```
+
+未設定・停止中の復旧入口は`runtime_status`と`runtime_open_manager`である。
+工場consumerは専用`AISHELL_TOOL_PROFILE=factory` MCP surfaceから
+`factory_diagnostics`を呼ぶ。schemaとprivacy境界は
+[製品側diagnostics contract](https://github.com/kitepon/aishell/blob/main/docs/factory-diagnostics.md)が正である。
+
+releaseでは`AIShellProduct.version`と`package.json`を一致させ、release記録を
+[`docs/archive/releases/`](https://github.com/kitepon/aishell/tree/main/docs/archive/releases)へ追加して、次を実行する。
+
+```sh
+npm test
+npm run test:package
+git fetch origin
+npm run verify:release-commit
+npm publish --access public
+```
+
+release gateはdirty treeと既定branchへ未着地のcommitを拒否する。publish後は対応する
+GitHub Releaseを作り、`@quolu/aishell@latest`を再installしてMCP initializeと
+`factory_diagnostics`をsmokeする。公開済みversionの正本はGitHub Releasesである。
+
 ## 開発検証
 
 ```sh
@@ -189,9 +219,10 @@ scripts/package-app.sh release
 
 ## ContributionとSecurity
 
-変更提案前に[CONTRIBUTING.md](CONTRIBUTING.md)を確認してほしい。脆弱性はpublic issueへ書かず、[SECURITY.md](SECURITY.md)のprivate経路で報告する。
+変更提案前に[CONTRIBUTING.md](https://github.com/kitepon/aishell/blob/main/CONTRIBUTING.md)を確認してほしい。脆弱性はpublic issueへ書かず、[SECURITY.md](https://github.com/kitepon/aishell/blob/main/SECURITY.md)のprivate経路で報告する。
 
-release notesは[`docs/`](docs/)に置き、GitHub Releasesを公開済みversionの正本とする。
+現役文書の索引は[`docs/README.md`](https://github.com/kitepon/aishell/blob/main/docs/README.md)、過去のrelease notesは
+[`docs/archive/releases/`](https://github.com/kitepon/aishell/tree/main/docs/archive/releases)に置く。
 
 ## License
 

package/README.md

@@ -1,10 +1,10 @@
 <p align="center">
-  <img src=".github/og.png" alt="AIShell — Direct OS context for AI development" width="100%">
+  <img src="https://raw.githubusercontent.com/kitepon/aishell/main/.github/og.png" alt="AIShell — Direct OS context for AI development" width="100%">
 </p>
 
 # AIShell
 
-[![CI](https://github.com/kitepon-rgb/aishell/actions/workflows/ci.yml/badge.svg)](https://github.com/kitepon-rgb/aishell/actions/workflows/ci.yml)
+[![CI](https://github.com/kitepon/aishell/actions/workflows/ci.yml/badge.svg)](https://github.com/kitepon/aishell/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@quolu/aishell)](https://www.npmjs.com/package/@quolu/aishell)
 ![macOS 15+](https://img.shields.io/badge/macOS-15%2B-111827)
 ![Swift 6](https://img.shields.io/badge/Swift-6-F05138)
@@ -15,10 +15,12 @@
 
 Built and maintained by [Quo](https://x.com/QLyun35332) at [kitepon.dev](https://kitepon.dev/en).
 
-**Ownership boundary:** this repository owns the macOS Apple Silicon OS-context
-runtime. Cross-product installation and the integration contract are handled by
-[dotagents](https://github.com/kitepon-rgb/dotagents), the internal development
-toolchain behind kitepon.dev's products.
+**Ownership boundary:** this repository owns the standalone macOS Apple Silicon
+runtime, including installation, configuration, state/schema migration,
+diagnostics, recovery, updates, and releases.
+[dotagents](https://github.com/kitepon/dotagents) consumes the public contract
+for cross-product wiring and compatibility; it does not control AIShell's
+internal operation.
 
 AIShell owns the OS-facing state below the model: allowed roots, file identity, filesystem reconciliation, directly launched processes, complete logs, and retained artifacts. The AI host remains responsible for reasoning, threads, compaction, sub-agents, and general-purpose terminal work.
 
@@ -45,7 +47,7 @@ The default profile exposes five high-density development tools plus two always-
 |---|---|
 | `workspace_snapshot` | Bounded initial workspace preview, reconciled change delta, Git state, and primary context |
 | `read_context` | Budgeted multi-file reads with SHA-256 identity and continuation |
-| `search_context` | Budgeted lexical context from a directly launched `rg` worker; the expanded capability also provides cursor-bound semantic definition/reference/symbol queries without lexical fallback |
+| `search_context` | Budgeted lexical context from a directly launched `rg` worker, scoped to a directory or one regular file; the expanded capability also provides cursor-bound semantic definition/reference/symbol queries without lexical fallback |
 | `run_check` | Direct process execution, primary diagnostics, and complete stdout/stderr artifacts |
 | `artifact_read` | Range, tail, and pattern-centered reads from retained artifacts; the expanded capability also searches and compares finalized managed-run artifacts |
 | `runtime_status` | Allowed-root, pause, worktree, and next-action state, including while paused or unconfigured |
@@ -115,7 +117,7 @@ The current experimental build is not yet Developer ID signed or notarized.
 ## Build from source
 
 ```sh
-git clone https://github.com/kitepon-rgb/aishell.git
+git clone https://github.com/kitepon/aishell.git
 cd aishell
 swift test
 scripts/package-app.sh release
@@ -171,6 +173,37 @@ The full profile includes file listing and reads, atomic SHA-256-guarded updates
 - Initial workspace entries are a bounded preview; later deltas are cursor-paged.
 - Developer ID signing and notarization are not yet configured.
 
+## Operations, updates, and releases
+
+Upgrade a standalone installation through the same official npm path used for
+initial installation, then open the newly installed manager:
+
+```sh
+npm install -g @quolu/aishell@latest
+aishell-open
+```
+
+`runtime_status` and `runtime_open_manager` are the recovery entrypoints for an
+unconfigured or paused runtime. Factory consumers call `factory_diagnostics`
+through the dedicated `AISHELL_TOOL_PROFILE=factory` MCP surface; its schema and
+privacy boundary are owned by [the product contract](https://github.com/kitepon/aishell/blob/main/docs/factory-diagnostics.md).
+
+For a release, keep `AIShellProduct.version` and `package.json` aligned, add the
+release record under [`docs/archive/releases/`](https://github.com/kitepon/aishell/tree/main/docs/archive/releases), and run:
+
+```sh
+npm test
+npm run test:package
+git fetch origin
+npm run verify:release-commit
+npm publish --access public
+```
+
+The release gate rejects a dirty tree or a commit that has not landed on the
+default branch. After publishing, create the matching GitHub Release, reinstall
+`@quolu/aishell@latest`, and smoke MCP initialize plus `factory_diagnostics`.
+GitHub Releases are the public record of shipped versions.
+
 ## Development
 
 ```sh
@@ -189,9 +222,10 @@ On the original verification machine, Xcode 26.6 and the installed CoreSimulator
 
 ## Contributing and security
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) before proposing a change. Please report vulnerabilities through the private process in [SECURITY.md](SECURITY.md), not through a public issue.
+See [CONTRIBUTING.md](https://github.com/kitepon/aishell/blob/main/CONTRIBUTING.md) before proposing a change. Please report vulnerabilities through the private process in [SECURITY.md](https://github.com/kitepon/aishell/blob/main/SECURITY.md), not through a public issue.
 
-Release notes are kept in [`docs/`](docs/). GitHub Releases are the public record for shipped versions.
+The current documentation map is [`docs/README.md`](https://github.com/kitepon/aishell/blob/main/docs/README.md). Historical
+release notes live in [`docs/archive/releases/`](https://github.com/kitepon/aishell/tree/main/docs/archive/releases).
 
 ## License
 

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

@@ -17,9 +17,9 @@
     <key>CFBundlePackageType</key>
     <string>APPL</string>
     <key>CFBundleShortVersionString</key>
-    <string>0.4.10</string>
+    <string>0.4.12</string>
     <key>CFBundleVersion</key>
-    <string>17</string>
+    <string>19</string>
     <key>LSApplicationCategoryType</key>
     <string>public.app-category.utilities</string>
     <key>LSMinimumSystemVersion</key>

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

@@ -10,19 +10,19 @@
 		<dict>
 			<key>cdhash</key>
 			<data>
-			FNwK6EK/vUk8zWyWBn7IN9IzYQ4=
+			uzkv8b/DrKQPJzoVL8NtTyIqqek=
 			</data>
 			<key>requirement</key>
-			<string>cdhash H"14dc0ae842bfbd493ccd6c96067ec837d233610e"</string>
+			<string>cdhash H"bb392ff1bfc3aca40f273a152fc36d4f222aa9e9"</string>
 		</dict>
 		<key>Helpers/aishell-run-supervisor</key>
 		<dict>
 			<key>cdhash</key>
 			<data>
-			snu2dSdhWFLeVr4U/DV5eTlS2eI=
+			0V5WoY6tV3Zqijm+8J8Zv0B6/Pw=
 			</data>
 			<key>requirement</key>
-			<string>cdhash H"b27bb67527615852de56be14fc3579793952d9e2"</string>
+			<string>cdhash H"d15e56a18ead57766a8a39bef09f19bf407afcfc"</string>
 		</dict>
 	</dict>
 	<key>rules</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/aishell",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "A native macOS state runtime with high-density MCP tools for AI development",
   "license": "Apache-2.0",
   "author": {
@@ -9,12 +9,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/kitepon-rgb/aishell.git"
+    "url": "git+https://github.com/kitepon/aishell.git"
   },
   "bugs": {
-    "url": "https://github.com/kitepon-rgb/aishell/issues"
+    "url": "https://github.com/kitepon/aishell/issues"
   },
-  "homepage": "https://github.com/kitepon-rgb/aishell#readme",
+  "homepage": "https://github.com/kitepon/aishell#readme",
   "keywords": [
     "mcp",
     "macos",
@@ -40,8 +40,9 @@
   "scripts": {
     "build:npm": "node scripts/prepare-npm-release.mjs",
     "prepack": "npm run build:npm",
-    "test": "swift test && npm run test:release-gate",
+    "test": "swift test && npm run test:release-gate && npm run test:repository-contract",
     "test:release-gate": "node --test scripts/verify-release-commit.test.mjs",
+    "test:repository-contract": "node --test scripts/repository-contract.test.mjs",
     "test:package": "npm run build:npm && node scripts/verify-npm-package.mjs",
     "verify:release-commit": "node scripts/verify-release-commit.mjs",
     "prepublishOnly": "npm run verify:release-commit && npm run test:package"
@@ -49,6 +50,13 @@
   "engines": {
     "node": ">=18"
   },
+  "devDependencies": {
+    "parse-srcset": "1.0.2",
+    "parse5": "^8.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "unified": "^11.0.5"
+  },
   "publishConfig": {
     "access": "public"
   }