kiokuko 1.0.0 → 1.0.1

package/dist/uninstall/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/uninstall/render.ts"],"names":[],"mappings":"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"}

package/docs/breaking-changes-1.0.md

@@ -4,6 +4,13 @@ Kiokuko 1.0 removes enno-oduno, zenki, and goki. There is no replacement
 orchestrator. Akinator intake, memory, Skill discovery, Curator, and the normal
 CLI, MCP, and Web interfaces remain available.
 
+## Setup defaults
+
+`kiokuko setup` now also installs and configures local semantic retrieval. For the
+previous client-only behavior, use `kiokuko setup --no-embeddings`. Existing
+embedding settings and models are preserved when this flag is used.
+`kiokuko embeddings setup` remains a compatible entrypoint for the same setup flow.
+
 ## Database
 
 Older databases cannot be upgraded or opened by 1.0. They are rejected without
@@ -45,6 +52,12 @@ new package major. Removed commands and tools fail as unsupported operations.
 
 ## Remove previously installed automation
 
+To remove Kiokuko completely, including these retired integrations, use
+[`kiokuko uninstall`](cli-contract.md#uninstall) and select all four agents,
+or use `kiokuko uninstall --all`. Complete cleanup also deletes stored memory
+and embedding models. Selecting only some agents retains shared data and the
+npm package. The manual steps below are for retaining Kiokuko 1.0.
+
 Stop affected clients before editing their configuration. Remove only these
 old Kiokuko entries, preserving other hooks and user content:
 

package/docs/cli-contract.md

@@ -1,24 +1,29 @@
-# Embedding CLI contract
+# Setup and embedding CLI contract
 
-The default global installation is intentionally lightweight:
+The npm package stays lightweight. The default setup command configures clients,
+installs the pinned optional runtime when needed, downloads the verified local
+model, and enables semantic retrieval:
 
 ```bash
 npm install --global @askdkc/kiokuko
 kiokuko setup
 ```
 
-This keeps lexical retrieval and the normal setup flow available without the
-optional local semantic runtime. To opt into local semantic retrieval, run the
-following command. It installs the pinned optional dependencies when needed,
-then applies the same client configuration flow as `kiokuko setup`: managed
-MCP blocks are updated and registered-project instructions are refreshed.
-Unmanaged MCP identities require interactive confirmation before replacement;
-non-interactive or `--dry-run --json` runs fail closed without changing them.
+To configure clients without embedding setup:
 
 ```bash
-kiokuko embeddings setup
+kiokuko setup --no-embeddings
 ```
 
+`--no-embeddings` skips runtime checks and installation, model download, and
+embedding activation/generation. It preserves existing embedding settings and
+models; it does not disable an active semantic profile. `kiokuko embeddings setup`
+is a compatibility entrypoint for the same implementation and accepts the same flags.
+
+Both paths update managed MCP blocks and refresh registered-project instructions.
+Unmanaged MCP identities require interactive confirmation before replacement;
+non-interactive or `--dry-run --json` runs fail closed without changing them.
+
 `boolean@3.2.0` is an upstream transitive dependency of the Transformers.js
 runtime. It is not a Kiokuko dependency and is not present in the lightweight
 install. On Linux, the first automatic dependency installation uses sudo
@@ -26,14 +31,91 @@ through npm. On macOS it installs into Kiokuko's package-local `node_modules`
 instead of the shared npm global prefix; other platforms invoke npm directly.
 Do not persist npm script permissions or use `--dangerously-allow-all-scripts`.
 
-`kiokuko embeddings setup` installs the pinned `local-small` preset without a
+`kiokuko setup` installs the pinned `local-small` preset without a
 separate confirmation flag. Automation uses:
 
 ```bash
-kiokuko embeddings setup --preset local-small --json
+kiokuko setup --preset local-small --json
 ```
 
 `--dry-run` performs no download, model load, database write, or filesystem
 mutation. `--offline` uses only an existing verified installation. `--replace`
 allows switching profiles. `status --json` reports bounded coverage and model
-state; `repair` restores the same pinned artifact without destructive cleanup.
+state. Repeating setup reuses verified model files.
+
+JSON keeps the invoked operation name (`setup` or `embeddings.setup`) and includes
+`embeddingsSkipped`. Normal setup includes the client setup fields, semantic result,
+and `projectSetup`; `--no-embeddings` returns the client setup result without a
+semantic result. Dry-run reads an existing database without initializing or upgrading it.
+
+## Uninstall
+
+Stop clients using Kiokuko and any foreground `kiokuko serve` process before cleanup:
+
+```bash
+kiokuko uninstall --dry-run
+kiokuko uninstall
+# After selecting all agents and completing cleanup:
+npm uninstall --global kiokuko
+```
+
+On a terminal, `uninstall` shows Codex, OpenCode, Claude Code, and Hermes Agent
+with no initial selections. Up/Down moves focus, Space toggles a choice, Enter
+submits, and Esc/Ctrl+C cancels without changing files. Number keys 1–4 also toggle
+choices. Submitting an empty selection changes nothing. Selecting only some agents
+removes their managed integrations and Skills, retaining unchecked agents and
+shared memory, models, runtime files, and project bindings. Keep the npm package
+after partial removal. Selecting all four agents performs complete cleanup.
+
+For explicit selection or scripts:
+
+```bash
+kiokuko uninstall --clients opencode,claude --dry-run
+kiokuko uninstall --clients opencode,claude
+# Complete cleanup without a selection prompt:
+kiokuko uninstall --all --dry-run
+kiokuko uninstall --all
+npm uninstall --global kiokuko
+```
+
+`--clients` and `--all` are mutually exclusive. Noninteractive and `--json`
+deletion require one of them. A noninteractive or JSON `--dry-run` without either
+option previews all agents without writing files.
+
+Complete cleanup deletes all memory in the selected database, its sidecars, downloaded
+embedding models, and runtime files. It removes Kiokuko MCP entries and managed
+instruction blocks for Codex, OpenCode, Claude Code, and every Hermes profile
+under the configured Hermes root. Marked standard Skills, including retired
+references and the old orchestration Skill, are removed. Retired managed
+OpenCode plugins and Kiokuko Stop/UserPromptSubmit hook handlers are also removed.
+
+The database registry supplies project locations, including custom agent-file
+paths from `.kiokuko.json`. Uninstall removes the managed instruction block,
+the binding, and its exact `.gitignore` entry. Shared files retain other content;
+standalone generated files and empty owned directories are deleted. Unmarked
+Skill files and other files in a shared data directory are reported as preserved.
+User-chosen backup/export destinations are not tracked and are retained.
+MCP entries that cannot be identified as Kiokuko-managed are excluded from
+uninstall: their configuration files are retained unchanged and reported as
+`preserved` with a reason. Cleanup of other artifacts continues, including the
+final npm removal command. Invalid configuration syntax still rejects the plan.
+
+Use the same `KIOKUKO_DATA_DIR`, `CODEX_HOME`, `CLAUDE_CONFIG_DIR`, XDG variables,
+and `HERMES_HOME` as setup. Uninstall does not search the home directory or discover
+previous environment overrides. Missing registered project roots are reported;
+unregistered copies and projects from an unavailable/deleted database cannot be
+discovered automatically.
+
+`--dry-run` validates the plan without changing files; `--json` emits the normal
+envelope with `clients`, `scope` (`all`, `clients`, or `none`), `files`,
+`missingProjects`, `dryRun`, and `npmCommand`. `npmCommand` is `null` for partial
+or empty selections. A live instance,
+embedding setup lock, malformed configuration, mismatched project binding, or
+symbolic link rejects cleanup. The full plan is validated before mutation.
+Filesystem failures during application return `PARTIAL_FAILURE` with completed
+paths and the cause. Changes already applied are not rolled back; keep the npm
+package, resolve the problem, and rerun. The database is deleted after client and
+project cleanup, so a failed configuration edit retains the registry for retry.
+
+After complete cleanup, the human success output ends with `npm uninstall --global kiokuko`. Uninstall
+does not execute npm, remove the running package, or request sudo itself.

package/docs/getting-started.ja.md

@@ -9,7 +9,19 @@ npm install --global @askdkc/kiokuko
 kiokuko setup
 ```
 
-Optional setup flags: `--no-standard-skills`, `--skill-discovery off|official|community`, and `--dry-run --json`.
+`setup`はクライアント設定とローカルsemantic検索の導入を行います。
+埋め込みランタイムの導入・モデル取得・埋め込み生成を省略する場合:
+
+```bash
+kiokuko setup --no-embeddings
+```
+
+既存の埋め込み設定とモデルは保持します。設定済みsemantic検索を無効化するフラグではありません。
+ほかに`--no-standard-skills`、`--skill-discovery off|official|community`、`--dry-run --json`が使えます。
+
+Terminalでは、↑↓でエージェント間を移動し、Spaceでチェックを切り替え、Enterで確定します。
+数字キー1〜4でも各エージェントのチェックを切り替えられます。検出済みのエージェントは選択済みで、複数選択できます。
+EscまたはCtrl+Cで選択を中断します。自動実行では`--clients codex,opencode`のように対象を指定してください。
 
 Codexでは次のmanaged blockを所有します。
 
@@ -30,12 +42,13 @@ required = true
 
 ## Embeddings
 
-`kiokuko embeddings setup`は固定semantic runtimeを導入し、`kiokuko setup`と同じclient設定フロー（conflict確認、managed MCP更新、
-登録済みプロジェクトのinstructions更新）を実行します。
+`kiokuko setup`は固定semantic runtimeの導入とclient設定（conflict確認、managed MCP更新、
+登録済みプロジェクトのinstructions更新）を実行します。`kiokuko embeddings setup`は同じ実装への
+互換入口で、こちらでも`--no-embeddings`を指定できます。
 
 ```bash
-kiokuko embeddings setup --clients codex
-kiokuko embeddings setup --preset local-small --offline
+kiokuko setup --clients codex
+kiokuko setup --preset local-small --offline
 kiokuko embeddings status --json
 ```
 

package/docs/getting-started.md

@@ -9,7 +9,20 @@ npm install --global @askdkc/kiokuko
 kiokuko setup
 ```
 
-Optional setup flags: `--no-standard-skills`, `--skill-discovery off|official|community`, and `--dry-run --json`.
+`setup` configures clients and local semantic retrieval by default. To skip the
+embedding runtime, model download, and embedding generation:
+
+```bash
+kiokuko setup --no-embeddings
+```
+
+Existing embedding settings and models are preserved. This flag does not disable
+a previously configured semantic profile. Other setup flags include
+`--no-standard-skills`, `--skill-discovery off|official|community`, and `--dry-run --json`.
+
+In a terminal, use Up/Down to move, Space to toggle a client, and Enter to confirm.
+Number keys 1–4 also toggle clients. Detected clients start checked; multiple clients can be selected.
+Press Esc or Ctrl+C to cancel selection. For automation, specify clients with `--clients codex,opencode`.
 
 For Codex, setup owns one exact managed block:
 
@@ -32,13 +45,14 @@ database, and Codex MCP health; doctor is read-only.
 
 ## Embeddings setup
 
-`kiokuko embeddings setup` installs the pinned local semantic runtime and runs the
-same client configuration flow as `kiokuko setup`, including conflict confirmation,
-managed MCP replacement, and registered-project instruction refresh.
+`kiokuko setup` installs the pinned local semantic runtime and runs client
+configuration, including conflict confirmation, managed MCP replacement, and
+registered-project instruction refresh. `kiokuko embeddings setup` is a compatibility
+entrypoint for the same implementation and also accepts `--no-embeddings`.
 
 ```bash
-kiokuko embeddings setup --clients codex
-kiokuko embeddings setup --preset local-small --offline
+kiokuko setup --clients codex
+kiokuko setup --preset local-small --offline
 kiokuko embeddings status --json
 ```
 

package/docs/semantic-retrieval.ja.md

@@ -1,11 +1,13 @@
 # Semantic retrieval
 
-軽量インストールではlexical検索が動きます。semantic検索は任意のlocal `local-small` embedding profileです。
+`kiokuko setup`でlexical検索とlocal `local-small` semantic profileを設定します。
+埋め込みの導入を省略する場合は`kiokuko setup --no-embeddings`を使います。既存の埋め込み設定は保持します。
+`kiokuko embeddings setup`も互換入口として利用できます。
 
 ```bash
-kiokuko embeddings setup
+kiokuko setup
 kiokuko embeddings status --json
-kiokuko embeddings repair
+kiokuko setup --offline
 ```
 
 固定runtimeを導入し、load前にartifactを検証します。`--offline`は検証済みlocal installationを要求し、`--dry-run`はdownload・書き込み・profile変更を行いません。

package/docs/semantic-retrieval.md

@@ -1,12 +1,13 @@
 # Semantic retrieval
 
-Lexical retrieval works in the lightweight install. Semantic retrieval is an
-optional local `local-small` embedding profile.
+`kiokuko setup` configures lexical retrieval and the local `local-small` semantic
+profile. Use `kiokuko setup --no-embeddings` to skip embedding setup while preserving
+any existing embedding settings. `kiokuko embeddings setup` remains a compatibility entrypoint.
 
 ```bash
-kiokuko embeddings setup
+kiokuko setup
 kiokuko embeddings status --json
-kiokuko embeddings repair
+kiokuko setup --offline
 ```
 
 Setup installs only the pinned runtime and verifies every artifact before loading

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiokuko",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Model-agnostic external memory for AI coding agents",
   "type": "module",
   "bin": {