kiokuko 1.0.5 → 1.0.6

package/README.ja.md

@@ -41,6 +41,33 @@ kiokuko setup --no-embeddings
 
 埋め込みのセットアップを省略します。既存の埋め込み設定は変更しません。
 
+<a id="setup-messages"></a>
+
+### npmの通知とセットアップエラー
+
+`install scripts not yet covered by allowScripts`は、依存パッケージのスクリプトに実行許可が記録されていないという通知です。
+`esbuild`はビルドツール、`fsevents`はmacOSのファイル監視用です。この通知だけではセットアップの失敗とは限りません。
+
+通知が出たパッケージのディレクトリで確認します。
+
+```bash
+npm install-scripts ls
+```
+
+`esbuild`と`fsevents`が表示され、スクリプトを確認したうえで実行を許可する場合は、次のコマンドで記録します。
+
+```bash
+npm install-scripts approve esbuild fsevents
+```
+
+許可はそのディレクトリの`package.json`に保存されます。macOSでKiokukoをグローバルインストールした場合は、エラーに表示されたKiokukoのインストール先で実行してください。
+別のプロジェクトで実行すると、そのプロジェクトの許可設定を確認・変更します。
+詳しくは[npmのスクリプト許可ガイド](https://docs.npmjs.com/cli/v11/commands/npm-install-scripts/)を参照してください。
+
+最後に`Local semantic retrieval dependencies remain unavailable`と`Cannot find package ... @huggingface/hub/index.js`が出た場合は、
+埋め込みランタイムを読み込めず、semantic検索の設定が完了していません。スクリプトの許可でこの読み込みエラーが直るとは確認できていません。
+問い合わせる際は、エラー全文と`kiokuko --version`、`node --version`、`npm --version`の結果を添えてください。
+
 ## アンインストール
 
 Kiokukoを使うクライアントと`kiokuko serve`を終了してから実行します。

package/README.ko.md

@@ -38,6 +38,33 @@ kiokuko setup --no-embeddings
 
 임베딩 설정 단계를 건너뛰며 기존 임베딩 설정은 변경하지 않습니다.
 
+<a id="setup-messages"></a>
+
+### npm 알림과 설정 오류
+
+`install scripts not yet covered by allowScripts`는 해당 의존성 스크립트의 실행 승인이 npm에 기록되지 않았다는 뜻입니다.
+`esbuild`는 빌드 도구이고, `fsevents`는 macOS 파일 감시에 사용됩니다. 이 알림만으로 설정이 실패했다고 볼 수는 없습니다.
+
+알림이 발생한 패키지 디렉터리에서 확인하세요.
+
+```bash
+npm install-scripts ls
+```
+
+`esbuild`와 `fsevents`가 표시되고, 스크립트를 검토한 뒤 실행을 허용하려면 다음 명령으로 승인을 기록하세요.
+
+```bash
+npm install-scripts approve esbuild fsevents
+```
+
+승인은 해당 디렉터리의 `package.json`에 저장됩니다. macOS에 Kiokuko를 전역 설치했다면 오류에 표시된 Kiokuko 설치 디렉터리에서 실행하세요.
+다른 프로젝트에서 실행하면 그 프로젝트의 승인 설정을 조회하고 변경합니다.
+자세한 내용은 [npm 스크립트 승인 안내](https://docs.npmjs.com/cli/v11/commands/npm-install-scripts/)를 참조하세요.
+
+설정이 `Local semantic retrieval dependencies remain unavailable`과 `Cannot find package ... @huggingface/hub/index.js`로 끝나면,
+임베딩 런타임을 불러오지 못해 semantic 검색 설정이 완료되지 않은 상태입니다. 스크립트 승인으로 이 불러오기 오류가 해결되는지는 확인되지 않았습니다.
+도움을 요청할 때는 전체 오류와 `kiokuko --version`, `node --version`, `npm --version`의 출력을 첨부하세요.
+
 ## 제거
 
 Kiokuko를 사용하는 클라이언트와 `kiokuko serve`를 먼저 종료하세요.

package/README.md

@@ -44,6 +44,38 @@ kiokuko setup --no-embeddings
 
 This skips embedding setup and preserves any existing embedding settings.
 
+<a id="setup-messages"></a>
+
+### npm notices and setup errors
+
+`install scripts not yet covered by allowScripts` means npm has no recorded
+approval for those dependency scripts. `esbuild` is a build tool; `fsevents`
+supports macOS file watching. The notice alone does not mean setup failed.
+
+Run this in the package directory that produced the notice:
+
+```bash
+npm install-scripts ls
+```
+
+If it lists `esbuild` and `fsevents`, and you have reviewed and want to allow their
+scripts, record approval with:
+
+```bash
+npm install-scripts approve esbuild fsevents
+```
+
+Approval updates that directory's `package.json`. For a global macOS Kiokuko
+install, use the installed Kiokuko directory shown in the error; running these
+commands in another project reviews and changes that project's policy.
+See [npm's script approval guide](https://docs.npmjs.com/cli/v11/commands/npm-install-scripts/).
+
+If setup ends with `Local semantic retrieval dependencies remain unavailable`
+and `Cannot find package ... @huggingface/hub/index.js`, the embedding runtime
+could not load and semantic setup is incomplete. Script approval is not a
+confirmed fix for this import error. Report the full error and the output of
+`kiokuko --version`, `node --version`, and `npm --version` when requesting help.
+
 ## Uninstall
 
 Stop clients using Kiokuko and any `kiokuko serve` process first.

package/README.zh-CN.md

@@ -38,6 +38,33 @@ kiokuko setup --no-embeddings
 
 此选项跳过嵌入设置步骤，不更改已有的嵌入配置。
 
+<a id="setup-messages"></a>
+
+### npm 提示与设置错误
+
+`install scripts not yet covered by allowScripts` 表示 npm 尚未记录这些依赖脚本的执行许可。
+`esbuild` 是构建工具，`fsevents` 用于 macOS 文件监控。仅出现此提示不代表设置失败。
+
+在产生提示的包目录中运行：
+
+```bash
+npm install-scripts ls
+```
+
+如果列出了 `esbuild` 和 `fsevents`，并且你已检查脚本、决定允许执行，可运行：
+
+```bash
+npm install-scripts approve esbuild fsevents
+```
+
+许可会写入该目录的 `package.json`。在 macOS 上全局安装 Kiokuko 时，请在错误信息显示的 Kiokuko 安装目录中操作；
+在其他项目中运行这些命令，查看和修改的是那个项目的许可设置。
+详情请参阅 [npm 脚本许可指南](https://docs.npmjs.com/cli/v11/commands/npm-install-scripts/)。
+
+如果设置最终报出 `Local semantic retrieval dependencies remain unavailable` 和 `Cannot find package ... @huggingface/hub/index.js`，
+说明嵌入运行时无法加载，semantic 检索尚未配置完成。尚未确认批准脚本能解决此导入错误。
+寻求帮助时，请附上完整错误信息以及 `kiokuko --version`、`node --version`、`npm --version` 的输出。
+
 ## 卸载
 
 先退出使用 Kiokuko 的客户端和 `kiokuko serve`。

package/dist/setup/standard-skills.d.ts

@@ -23,6 +23,9 @@ export declare const STANDARD_WORKFLOW_SKILL_FILES: readonly ["SKILL.md"];
 export declare const STANDARD_JAPANESE_SKILL_NAME = "natural-japanese-output";
 export declare const STANDARD_JAPANESE_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->";
 export declare const STANDARD_JAPANESE_SKILL_FILES: readonly ["SKILL.md"];
+export declare const STANDARD_COMPLETION_SKILL_NAME = "one-shot-software-completion";
+export declare const STANDARD_COMPLETION_SKILL_MANAGED_MARKER = "<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->";
+export declare const STANDARD_COMPLETION_SKILL_FILES: readonly ["SKILL.md", "references/discovery-and-scope.md", "references/boundaries-and-lifecycle.md", "references/verification-and-completion.md", "references/failure-recovery.md"];
 export declare const STANDARD_SKILL_MANIFESTS: readonly [{
     readonly name: "kiokuko-ui-design-soul";
     readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-ui-design-soul -->";
@@ -47,6 +50,10 @@ export declare const STANDARD_SKILL_MANIFESTS: readonly [{
     readonly name: "natural-japanese-output";
     readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->";
     readonly files: readonly ["SKILL.md"];
+}, {
+    readonly name: "one-shot-software-completion";
+    readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->";
+    readonly files: readonly ["SKILL.md", "references/discovery-and-scope.md", "references/boundaries-and-lifecycle.md", "references/verification-and-completion.md", "references/failure-recovery.md"];
 }, {
     readonly name: "kiokuko-soul";
     readonly managedMarker: "<!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-soul -->";

package/dist/setup/standard-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-skills.d.ts","sourceRoot":"","sources":["../../src/setup/standard-skills.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,gCAAgC,oEAAoE,CAAC;AAClH,eAAO,MAAM,sBAAsB,qHAOzB,CAAC;AACX,eAAO,MAAM,wBAAwB,+OAO3B,CAAC;AACX,eAAO,MAAM,uBAAuB,yRAI1B,CAAC;AACX,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAChE,eAAO,MAAM,oCAAoC,iEAAiE,CAAC;AACnH,eAAO,MAAM,2BAA2B,uBAAwB,CAAC;AACjE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAC/E,eAAO,MAAM,sCAAsC,8EAA8E,CAAC;AAClI,eAAO,MAAM,4BAA4B,oIAO/B,CAAC;AACX,eAAO,MAAM,8BAA8B,gPAOjC,CAAC;AACX,eAAO,MAAM,6BAA6B,gUAKhC,CAAC;AACX,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,8DAA8D,CAAC;AAChH,eAAO,MAAM,2BAA2B,uBAAwB,CAAC;AACjE,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,kCAAkC,0DAA0D,CAAC;AAC1G,eAAO,MAAM,yBAAyB,uBAAwB,CAAC;AAC/D,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,sCAAsC,sEAAsE,CAAC;AAC1H,eAAO,MAAM,6BAA6B,uBAAwB,CAAC;AACnE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,sCAAsC,qEAAqE,CAAC;AACzH,eAAO,MAAM,6BAA6B,uBAAwB,CAAC;AAQnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BiB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAkCD,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAEzF;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,wBAAwB,EACjC,eAAe,CAAC,EAAE,MAAM,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;CAAE,CAclE"}
+{"version":3,"file":"standard-skills.d.ts","sourceRoot":"","sources":["../../src/setup/standard-skills.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,gCAAgC,oEAAoE,CAAC;AAClH,eAAO,MAAM,sBAAsB,qHAOzB,CAAC;AACX,eAAO,MAAM,wBAAwB,+OAO3B,CAAC;AACX,eAAO,MAAM,uBAAuB,yRAI1B,CAAC;AACX,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAChE,eAAO,MAAM,oCAAoC,iEAAiE,CAAC;AACnH,eAAO,MAAM,2BAA2B,uBAAwB,CAAC;AACjE,eAAO,MAAM,4BAA4B,qCAAqC,CAAC;AAC/E,eAAO,MAAM,sCAAsC,8EAA8E,CAAC;AAClI,eAAO,MAAM,4BAA4B,oIAO/B,CAAC;AACX,eAAO,MAAM,8BAA8B,gPAOjC,CAAC;AACX,eAAO,MAAM,6BAA6B,gUAKhC,CAAC;AACX,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,oCAAoC,8DAA8D,CAAC;AAChH,eAAO,MAAM,2BAA2B,uBAAwB,CAAC;AACjE,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AACvD,eAAO,MAAM,kCAAkC,0DAA0D,CAAC;AAC1G,eAAO,MAAM,yBAAyB,uBAAwB,CAAC;AAC/D,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,sCAAsC,sEAAsE,CAAC;AAC1H,eAAO,MAAM,6BAA6B,uBAAwB,CAAC;AACnE,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AACtE,eAAO,MAAM,sCAAsC,qEAAqE,CAAC;AACzH,eAAO,MAAM,6BAA6B,uBAAwB,CAAC;AAEnE,eAAO,MAAM,8BAA8B,iCAAiC,CAAC;AAC7E,eAAO,MAAM,wCAAwC,0EAA0E,CAAC;AAChI,eAAO,MAAM,+BAA+B,qLAMlC,CAAC;AAQX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCiB,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAkCD,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAEzF;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,wBAAwB,EACjC,eAAe,CAAC,EAAE,MAAM,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAA;CAAE,CAclE"}

package/dist/setup/standard-skills.js

@@ -64,6 +64,15 @@ export const STANDARD_WORKFLOW_SKILL_FILES = ['SKILL.md'];
 export const STANDARD_JAPANESE_SKILL_NAME = 'natural-japanese-output';
 export const STANDARD_JAPANESE_SKILL_MANAGED_MARKER = '<!-- KIOKUKO MANAGED STANDARD SKILL: natural-japanese-output -->';
 export const STANDARD_JAPANESE_SKILL_FILES = ['SKILL.md'];
+export const STANDARD_COMPLETION_SKILL_NAME = 'one-shot-software-completion';
+export const STANDARD_COMPLETION_SKILL_MANAGED_MARKER = '<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->';
+export const STANDARD_COMPLETION_SKILL_FILES = [
+    'SKILL.md',
+    'references/discovery-and-scope.md',
+    'references/boundaries-and-lifecycle.md',
+    'references/verification-and-completion.md',
+    'references/failure-recovery.md',
+];
 export const STANDARD_SKILL_MANIFESTS = [{
         name: STANDARD_UI_SKILL_NAME,
         managedMarker: STANDARD_UI_SKILL_MANAGED_MARKER,
@@ -88,6 +97,10 @@ export const STANDARD_SKILL_MANIFESTS = [{
         name: STANDARD_JAPANESE_SKILL_NAME,
         managedMarker: STANDARD_JAPANESE_SKILL_MANAGED_MARKER,
         files: STANDARD_JAPANESE_SKILL_FILES,
+    }, {
+        name: STANDARD_COMPLETION_SKILL_NAME,
+        managedMarker: STANDARD_COMPLETION_SKILL_MANAGED_MARKER,
+        files: STANDARD_COMPLETION_SKILL_FILES,
     }, {
         name: STANDARD_SOUL_SKILL_NAME,
         managedMarker: STANDARD_SOUL_SKILL_MANAGED_MARKER,

package/dist/setup/standard-skills.js.map

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

package/docs/README.ja.md

@@ -3,6 +3,7 @@
 目的別に参照してください。
 
 - [導入ガイド](getting-started.ja.md) — インストール、Codex/OpenCode/Claude/Hermes設定、再起動、Web UI。
+- [npmの通知とセットアップエラー](../README.ja.md#setup-messages) — スクリプトの許可を確認し、埋め込み依存関係のエラーと区別する。
 - [基本概念](concepts.ja.md) — RAG、記憶のライフサイクル、Project/Ecosystem/Global、Akinator。
 - [Semantic retrieval](semantic-retrieval.ja.md) — embedding runtime、運用、offline、fallback。
 - [Akinator のプロフィール補助](akinator-memory.md) — 候補提示、限定的な対象補完、索引の再構築。

package/docs/README.md

@@ -3,6 +3,7 @@
 Choose a guide by what you need to do:
 
 - [Getting started](getting-started.md) — install, configure Codex/OpenCode/Claude/Hermes, restart clients, and use the Web UI.
+- [npm notices and setup errors](../README.md#setup-messages) — review script approvals and distinguish them from missing embedding dependencies.
 - [Concepts](concepts.md) — RAG, memory lifecycle, Project/Ecosystem/Global scopes, and Akinator.
 - [Semantic retrieval](semantic-retrieval.md) — embedding runtime setup, operation, offline mode, and fallback.
 - [Akinator profile memory](akinator-memory.md) — optional hints, strict target resolution, and index rebuilding.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiokuko",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Model-agnostic external memory for AI coding agents",
   "type": "module",
   "bin": {
@@ -58,7 +58,9 @@
   "allowScripts": {
     "onnxruntime-node": true,
     "sharp": true,
-    "protobufjs": true
+    "protobufjs": true,
+    "esbuild@0.28.2": true,
+    "fsevents@2.3.3": true
   },
   "peerDependencies": {
     "@huggingface/hub": "2.16.1",

package/skills/kiokuko-soul/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kiokuko-soul
-description: Use before every non-trivial Kiokuko-governed task as the mandatory first-read SOUL router. Run the Akinator intake gate before planning or implementation, then route simple code work, general code work, and interactive UI work to the bundled specialist Skills.
+description: Use before every coding request, including small fixes, and every other non-trivial Kiokuko-governed task as the mandatory first-read SOUL router. Run the Akinator intake gate before planning or implementation, then route simple code work, general code work, and interactive UI work to the bundled specialist Skills.
 ---
 
 <!-- KIOKUKO MANAGED STANDARD SKILL: kiokuko-soul -->
@@ -9,7 +9,7 @@ description: Use before every non-trivial Kiokuko-governed task as the mandatory
 
 ## Outcome
 
-Start every non-trivial Kiokuko-governed task by reading one stable router, resolving the Akinator intake gate, then reading the applicable compact specialist indexes and only the expert fragments required by the current task.
+Start every coding request (including small fixes) and every other non-trivial Kiokuko-governed task by reading one stable router, resolving the Akinator intake gate, then reading the applicable compact specialist indexes and only the expert fragments required by the current task.
 
 This Skill owns the entry sequence and routes work. Akinator is the mandatory intake state machine, not a specialist route. This Skill does not duplicate specialist instructions, select another model, or authorize effects beyond the user request and current client permissions.
 
@@ -72,6 +72,14 @@ This route minimizes the solution; it does not replace the code contract below o
 
 Read and apply the `kiokuko-single-purpose-functions` index before writing, modifying, debugging, refactoring, or reviewing code, and before decomposing a code-changing plan. Select one to three `code.*` expert fragments for each cohesive function or task.
 
+### Software completion for every coding request
+
+Before code-changing planning or implementation, apply the compact
+`one-shot-software-completion/SKILL.md` core, including for small, minimal/YAGNI,
+test and UI changes. Reuse its unchanged full text already in active context;
+otherwise read it. A summary is insufficient. Load references only for concrete
+risks; this route does not require reading them all. Follow availability rules below.
+
 ### Interactive UI work
 
 Read and apply the `kiokuko-ui-design-soul` index before designing, implementing, modifying, debugging, or reviewing an interactive interface. Select one to three `ui.*` expert fragments for the actual interaction risks. If UI work changes code, apply both the code and UI indexes.
@@ -87,7 +95,8 @@ Use this order:
 3. `veteran-programmer-skill` when the change crosses workflow stages;
 4. `kiokuko-simple-work` when the finalized intake satisfies the simple-code activation boundary;
 5. `kiokuko-single-purpose-functions` for code planning or code work;
-6. `kiokuko-ui-design-soul` for interactive UI work.
+6. `one-shot-software-completion` for every coding request, including simple code and UI code changes;
+7. `kiokuko-ui-design-soul` for interactive UI work.
 
 Keep each route within the user-approved task scope.
 

package/skills/one-shot-software-completion/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: one-shot-software-completion
+description: Required before planning or implementing any code change, including small fixes, tests and UI. Read this compact core; load references only for concrete risks.
+---
+
+<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->
+
+<!-- kiokuko:runtime contract -->
+# One-Shot Software Completion
+
+Deliver the user's observable result, not an isolated patch. One-shot is a
+delivery goal, not a promise of success in one turn or extra authorization.
+
+## Activation and context
+
+For every coding request, including minimal/YAGNI work, apply this entire core
+before code-changing planning or implementation. Follow `kiokuko-soul` and host
+intake, scope and permissions; this Skill grants no extra agents or continuation.
+Reuse the unchanged full core already in active context, including host-supplied
+text. Read it when absent, changed or lost to compaction; a summary or capability
+listing is insufficient. Reuse the existing plan and evidence, not extra checklists.
+
+## Completion contract
+
+1. Define the observable result. Resolve routine choices from current repository
+   evidence; ask only about consequential uncertainty in intent or authorization.
+2. Trace the real entry point, callers and effects. Include required wiring,
+   delivery steps and checks; preserve unrelated work and compatibility.
+3. Make the smallest complete change. Handle relevant boundaries, errors,
+   security and resource ownership. Define expected results before implementation;
+   add regression coverage for material behavior, reuse adequate existing checks.
+4. Run required checks and focused verification through the changed entry point.
+   Broaden for shared contracts; rerun checks invalidated by edits. A helper test
+   alone does not prove delivery. Never weaken checks to hide failure.
+5. Review the complete diff, including new files. Report behavior, checks/results,
+   assumptions and unverified paths. Distinguish source from deployed/runtime
+   evidence. Continue authorized work; stop only on completion or a concrete blocker.
+
+## Read only for the current risk
+
+A bounded change with clear callers and checks needs only this core. Otherwise
+read the matching reference, one at a time; never preload the set or reread merely
+because the phase changed. Select repository excerpts by relevant symbols/ranges.
+
+| Read when | Reference |
+| --- | --- |
+| Scope, callers or integration are unclear | [Discovery](references/discovery-and-scope.md) |
+| Inputs, effects, lifetime or compatibility change | [Boundaries](references/boundaries-and-lifecycle.md) |
+| Evidence or delivery is uncertain | [Verification](references/verification-and-completion.md) |
+| A check fails or progress stalls; before changing strategy | [Recovery](references/failure-recovery.md) |
+
+Never retry an unchanged failed operation. Reference deferral does not waive the
+core obligations. Follow the router's other applicable contracts without duplicating them.
+<!-- /kiokuko:runtime -->

package/skills/one-shot-software-completion/references/boundaries-and-lifecycle.md

@@ -0,0 +1,56 @@
+<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->
+
+# Boundaries and lifecycle
+
+Use when changing input acceptance, effects, state or a public/stored contract.
+Apply the code Skill's selected experts; this reference helps find omissions
+across the workflow rather than replacing those contracts.
+
+## Derive cases from the actual contract
+
+Select relevant boundaries; do not build an exhaustive speculative matrix.
+Each selected case needs deliberate accept/reject behavior or a demonstrated
+upstream invariant. A type assertion alone does not validate external input.
+
+| Input or boundary | Candidate cases |
+| --- | --- |
+| Text | absent, empty/whitespace, Unicode, length limit, injection-shaped content |
+| Numbers | zero, negative, bounds, fractional/non-finite values, encoded strings |
+| Collections | empty, singleton, duplicates, order, size limits |
+| Optional fields | missing, null, undefined, present but empty |
+| Identity | nonexistent, deleted, stale, another user/tenant's resource |
+| Time | zone/offset, DST, epoch zero, skew, expiry boundary |
+| Concurrent work | duplicate/out-of-order request, cancellation, partial batch |
+
+Example: pagination needs a defined limit range and integer policy, stable
+ordering, cursor behavior and tenant isolation. Whether an unknown cursor is an
+error or an empty page comes from the API contract, not this checklist.
+
+## Decide effects and failure semantics
+
+For each changed network, filesystem, database or process boundary, identify
+ownership, timeout/cancellation, public error and partial-success behavior.
+Reuse the repository policy; avoid silent catches or a success result after a
+required effect failed. Retries require an idempotent operation or a verified
+deduplication contract, bounded attempts and preserved request identity.
+
+A timeout after a write may mean the effect succeeded but its acknowledgment
+was lost. Do not resend a charge, notification or mutation merely because the
+response is absent. Reconcile uncertain state through the supported mechanism.
+
+For each resource or state holder, trace creation, access, invalidation, cleanup,
+restart/reload and test teardown. Account for subscriptions, timers, locks,
+caches and background jobs. Preserve transaction and rollback boundaries;
+cancellation of a UI is not proof that the underlying operation stopped.
+
+## Preserve consumers
+
+Identify contracts that leave this patch: JSON, database rows, queue messages,
+exports, CLI flags, config and environment variables. Preserve existing behavior
+by default. When a breaking change is requested, include its migration/version
+and downstream update strategy within authorized scope.
+
+Adding an optional field with a safe default may preserve compatibility;
+renaming, deleting, changing type or redefining defaults may not. Test old data
+and callers where they remain supported. Check readers as well as writers and
+rollout/restart ordering when old and new versions can coexist.

package/skills/one-shot-software-completion/references/discovery-and-scope.md

@@ -0,0 +1,67 @@
+<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->
+
+# Discovery and scope
+
+Use when the behavioral requirement, caller graph or patch boundary is unclear.
+Keep decisions in the existing plan; a separate document is not required.
+
+## Reconstruct the requirement
+
+- Express the requested result as observable input, action and output. "Add
+  pagination" needs an entry point, response shape, ordering, defaults and
+  compatibility with existing callers, not just a pagination helper.
+- Resolve unspecified choices from a working analog, project instructions and
+  conventions, then the framework idiom already used locally. Prefer the least
+  disruptive reversible choice and record material assumptions. Explicit user
+  requirements outrank inferred conventions.
+- Repository evidence cannot answer every ambiguity. Ask when competing
+  interpretations materially change the requested result, data, public contract
+  or permissions. Complete independent work while a necessary answer is pending.
+  Do not treat naming or formatting choices with established defaults as blockers.
+
+## Trace before editing
+
+Follow entry point -> target -> callees/effects -> callers/consumers. Search
+changed symbols and serialized field names; the compiler cannot find untyped
+fixtures, external consumers or dynamic registrations. Inspect tests and the
+actual check commands. Check imports, module state, exports and nearby helpers
+in contiguous reads; read the whole file when its contract depends on them.
+Avoid recursively reading every transitive dependency without a concrete risk.
+
+Use the closest maintained analog for placement, registration, errors, config,
+tests and docs. Recency alone does not make an example correct. Preserve existing
+dependency direction and use local validation, HTTP, IDs, retry and test helpers
+before adding another implementation or dependency.
+
+## Find the required accompanying changes
+
+From the actual workflow, identify relevant types, validation, serialization,
+permissions, flags, UI strings, CLI help/API docs, fixtures, exports, registration,
+migrations and generated artifacts. Logging and changelog entries are required
+only when the task or repository requires them. For setup and delivery, follow
+the artifact to its consumer and reload trigger with `veteran-programmer-skill`.
+
+Example: a new notification provider may require its client/schema, registry
+entry and configuration validation. A provider class tested only in isolation
+does not prove users can select it.
+
+## Bound and plan the patch
+
+- Include every step required to make the behavior reachable and correct. A
+  smaller diff is a tiebreaker between complete solutions.
+- Follow changed contracts through types, stored/wire data, callers, fixtures
+  and docs. Keep compatibility where consumers cannot change in this patch;
+  intentional compatibility aliases are not stale references to remove.
+- Fix an adjacent defect when the new behavior depends on it, or isolate the
+  new path so it does not spread the defect. Record the choice. Stable pagination,
+  for example, may need an ID tiebreaker in an existing shared sort.
+- Leave unrelated cleanup alone. A same-file edit or cheap refactor is not by
+  itself justification to expand scope. Preserve staged and unstaged user work.
+- Record path -> responsibility -> concrete check. Include expected outputs for
+  the main path and material failure cases. Order related edits so checks remain
+  interpretable, commonly contracts -> implementation -> wiring -> tests/docs.
+  Reassess scope if the plan grows; file count alone cannot decide correctness.
+
+Establish focused baseline results when existing failures could obscure the
+change. Inspect shared callers before choosing wider checks; preserve exact
+commands and results so new failures can be attributed rather than guessed.

package/skills/one-shot-software-completion/references/failure-recovery.md

@@ -0,0 +1,43 @@
+<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->
+
+# Failure recovery
+
+Read when a check fails or progress stalls. Recovery stays within the original
+scope, current host role and permissions; it is not an automatic retry policy.
+
+## Classify before editing
+
+Read the relevant complete error and causal context. Separate observations from
+hypotheses; multiple causes may coexist.
+
+| Evidence indicates | Next action |
+| --- | --- |
+| Wrong interpretation of the requirement | Revisit the observable result and material ambiguity |
+| Missed caller, helper contract or integration | Trace that dependency and correct the plan |
+| Local implementation error | Apply a focused fix and its regression check |
+| Environment/tooling failure | Verify the cause; make only an authorized, bounded repair |
+| Failure demonstrated in the baseline | Report it; investigate if it blocks or interacts with the change |
+
+If the same failure remains after two targeted fixes, stop making variants of
+the same patch. Create a minimal reproduction or focused diagnostic, revisit
+the input/contract and consider a different approach supported by repository
+evidence. Do not rerun an unchanged failed operation without new information.
+
+## Preserve the evidence
+
+Do not loosen assertions, skip tests, add broad catches/casts, suppress errors
+or increase timeouts merely to make a failure disappear. Change a check only
+when evidence shows its expectation is wrong and explain that correction.
+
+Fix tooling only when it blocks required verification and the repair is within
+scope. Prefer a targeted runnable check when broader infrastructure is missing;
+report exactly what it proves and what remains unverified. Do not rewrite CI,
+install unrelated dependencies or change external configuration to evade a
+blocker. A permission or credential gap is not a prompt to bypass controls.
+
+After a repair, rerun the failed check and all checks affected by the new diff,
+then review the final patch again. A signature repair can require caller tests,
+typecheck and runtime integration even if only one test originally failed.
+Stop when requirements are verified or progress requires unavailable evidence,
+access or a consequential user decision. State the blocker and concrete next
+action rather than claiming completion or promising unattended continuation.

package/skills/one-shot-software-completion/references/verification-and-completion.md

@@ -0,0 +1,62 @@
+<!-- KIOKUKO MANAGED STANDARD SKILL: one-shot-software-completion -->
+
+# Verification and completion
+
+Use when selecting evidence, reviewing a patch or validating its delivery.
+
+## Prove behavior at the changed boundary
+
+Use commands defined by the repository. Run required checks and choose further
+checks by the affected contract: typecheck, lint, focused tests, relevant
+integration tests, build/package inspection and an actual entry-point exercise.
+Reuse a passing integration test when it already exercises that entry point;
+do not add a redundant live operation merely to tick a runtime checkbox.
+
+- State expected outputs before implementation. Check meaningful success and
+  failure cases, forbidden effects after rejection, ownership and compatibility.
+- For a regression test, observe failure before the fix or demonstrate that an
+  isolated mutation of the defective behavior makes it fail. Do not revert user
+  work to create that demonstration. Excessive mocks can hide missing wiring.
+- Exercise the public route, CLI, mounted interaction, migration or package
+  consumer that must work. If a fixture substitutes for a live service, identify
+  the substitution and the remaining uncertainty.
+- Compare failures with recorded baseline evidence. Do not label a failure
+  pre-existing without evidence or infer a product defect from a sandbox/network
+  restriction alone.
+- Broaden checks for changed shared callers, public contracts or delivery. After
+  a repair, rerun invalidated checks, including integration/build checks affected
+  by it. Repeat the full suite only when required or justified by the change.
+
+Tests should protect behavior rather than mirror implementation or prose.
+For low-impact mechanical edits, an existing focused check or direct inspection
+may suffice. Missing credentials or unavailable infrastructure must be reported;
+they never turn an unrun check into a pass.
+
+## Review the complete patch
+
+Read staged, unstaged and new-file changes in scope. For each hunk ask:
+
+1. Does it implement the requested observable behavior or required integration?
+2. Which accepted input, failure or caller could make it wrong?
+3. Are error behavior, authorization, cleanup and compatibility preserved?
+4. Is a new function actually reachable through registration/export/binding?
+5. Are placeholders, debug effects, hardcoded secrets/paths, accidental `.only`
+   or `.skip`, casts and suppressed checks justified or removed?
+
+Inspect generated/snapshot changes rather than accepting churn. Reconcile the
+diff with the plan and accompanying artifacts: present, deliberately omitted
+with a reason, or still missing. A correct helper with no consumer is unfinished.
+If review causes edits, rerun the checks whose evidence those edits invalidate.
+
+## Completion decision
+
+The request is complete when its observable behavior has matching evidence,
+required integration and compatibility are covered, relevant boundaries and
+failure cases are handled, required checks have no unexplained new failures,
+and the final review has no unresolved issue within scope.
+
+Report the changed behavior, material assumptions and repository basis, exact
+checks/results, and any adjacent repair, dependency or breaking change. Name
+unverified runtime/deployment paths, blockers and deliberate exclusions. Distinguish
+source, packaged files, deployed copies and the active process; evidence for one
+does not prove the others. Do not call partially verified delivery fully verified.