kiokuko-dsh 0.2.36 → 0.2.37

package/dist/dsh/setup.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { readRegularFile } from '../config/read-regular-file.js';
 import { KiokukoError } from '../errors.js';
 import { deploymentParent, publishFile } from './managed-file-deployment.js';
-import { planStandardSkills } from './standard-skill-deployment.js';
+import { planStandardSkills, retireStandardSkills } from './standard-skill-deployment.js';
 import { SOUL_ROUTING_ENTRY_CONTRACT } from './standard-skills.js';
 const BEGIN = '<!-- BEGIN KIOKUKO-DSH MANAGED BLOCK -->';
 const END = '<!-- END KIOKUKO-DSH MANAGED BLOCK -->';
@@ -41,8 +41,8 @@ For generated artifacts, update the owning schema, template or generator, then u
 Choose design tokens by semantic role, not by current appearance. If a role is missing, extend the design system instead of repurposing an unrelated token; when changing theme contracts, verify supported light, dark and custom-theme fallback behavior.
 
 ${END}`;
-/** Replace only a DSH-owned block, preserving every other product's instructions. */
-export function renderDshInstructions(existing) {
+/** Locate one complete DSH-owned block and reject ambiguous ownership markers. */
+export function locateDshBlock(existing) {
     const conflict = () => new KiokukoError('CONFLICT', 'AGENTS.md must contain exactly one complete kiokuko-dsh managed block; repair its markers before setup');
     const starts = existing.split(BEGIN).length - 1;
     const ends = existing.split(END).length - 1;
@@ -66,9 +66,28 @@ export function renderDshInstructions(existing) {
         closing = LEGACY_END;
     }
     else
+        return undefined;
+    return { start, end: end + closing.length };
+}
+/** Replace only a DSH-owned block, preserving every other product's instructions. */
+export function renderDshInstructions(existing) {
+    const location = locateDshBlock(existing);
+    if (location === undefined)
         return existing;
     const newline = existing.includes('\r\n') ? '\r\n' : '\n';
-    return existing.slice(0, start) + DSH_MANAGED_BLOCK.replaceAll('\n', newline) + existing.slice(end + closing.length);
+    return existing.slice(0, location.start) + DSH_MANAGED_BLOCK.replaceAll('\n', newline) + existing.slice(location.end);
+}
+/** Remove only a DSH-owned block and its following setup separator newline. */
+export function renderDshRemoval(existing) {
+    const location = locateDshBlock(existing);
+    if (location === undefined)
+        return existing;
+    let suffix = existing.slice(location.end);
+    if (suffix.startsWith('\r\n'))
+        suffix = suffix.slice(2);
+    else if (suffix.startsWith('\n'))
+        suffix = suffix.slice(1);
+    return existing.slice(0, location.start) + suffix;
 }
 async function planInstructions(workspace) {
     const target = path.join(workspace, 'AGENTS.md');
@@ -103,6 +122,33 @@ export async function setupDsh(options = {}) {
     result.current = !options.check || result.skills.created + result.skills.updated === 0 && result.instructions.status !== 'update-needed';
     return result;
 }
+async function planInstructionRemoval(workspace) {
+    const target = path.join(workspace, 'AGENTS.md');
+    const previous = await readRegularFile(target, { containmentRoot: workspace });
+    if (previous === undefined)
+        return undefined;
+    const content = renderDshRemoval(previous.content);
+    if (content === previous.content)
+        return undefined;
+    await deploymentParent(workspace, target, false);
+    return { target, previous, content };
+}
+/** Explicitly retire matching deployed Skills and remove this product's AGENTS.md block. */
+export async function removeDshSetup(options = {}) {
+    const workspace = await realpath(options.cwd ?? process.cwd());
+    // Validate instruction ownership before deleting any deployed Skill.
+    const instructions = await planInstructionRemoval(workspace);
+    const skills = await retireStandardSkills(options.homeDirectory, { check: options.check ?? false });
+    const result = {
+        current: true,
+        skills,
+        instructions: { path: path.join(workspace, 'AGENTS.md'), status: instructions ? 'unchanged' : 'unmanaged-or-absent' },
+    };
+    if (instructions)
+        result.instructions.status = options.check ? 'update-needed' : await publishFile(workspace, instructions);
+    result.current = !options.check || result.skills.removed === 0 && result.instructions.status !== 'update-needed';
+    return result;
+}
 export async function setupDshOnLoad() {
     try {
         const result = await setupDsh();

package/dist/dsh/setup.js.map

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

package/dist/dsh/standard-skill-deployment.d.ts

@@ -5,11 +5,22 @@ export interface StandardSkillDeployment {
     readonly updated: number;
     readonly unchanged: number;
 }
+export interface StandardSkillRetirement {
+    readonly directory: string;
+    readonly removed: number;
+    readonly preserved: number;
+}
 /** Preflight all standard Skills plus Japanese output without writing files. */
-export declare function planStandardSkills(homeDirectory?: string): Promise<{
+export declare function planStandardSkills(homeDirectory?: string, options?: {
+    preserveUnmanaged?: boolean;
+}): Promise<{
     home: string;
     directory: string;
     files: DeploymentFile[];
 }>;
 export declare function synchronizeStandardSkills(homeDirectory?: string): Promise<StandardSkillDeployment>;
+/** Remove only deployed files that still match this package byte-for-byte. */
+export declare function retireStandardSkills(homeDirectory?: string, options?: {
+    check?: boolean;
+}): Promise<StandardSkillRetirement>;
 //# sourceMappingURL=standard-skill-deployment.d.ts.map

package/dist/dsh/standard-skill-deployment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-skill-deployment.d.ts","sourceRoot":"","sources":["../../src/dsh/standard-skill-deployment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAEjG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,gFAAgF;AAChF,wBAAsB,kBAAkB,CAAC,aAAa,GAAE,MAAqB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAuBpJ;AAED,wBAAsB,yBAAyB,CAAC,aAAa,GAAE,MAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAStH"}
+{"version":3,"file":"standard-skill-deployment.d.ts","sourceRoot":"","sources":["../../src/dsh/standard-skill-deployment.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiC,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAEjG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,gFAAgF;AAChF,wBAAsB,kBAAkB,CAAC,aAAa,GAAE,MAAqB,EAAE,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC,CAuBnM;AAED,wBAAsB,yBAAyB,CAAC,aAAa,GAAE,MAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAStH;AA+BD,8EAA8E;AAC9E,wBAAsB,oBAAoB,CAAC,aAAa,GAAE,MAAqB,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA6BpJ"}

package/dist/dsh/standard-skill-deployment.js

@@ -1,4 +1,4 @@
-import { realpath } from 'node:fs/promises';
+import { readdir, realpath, rmdir, unlink } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { readRegularFile } from '../config/read-regular-file.js';
@@ -8,7 +8,7 @@ import { renderStandardSkillFile } from './standard-skills.js';
 import { JAPANESE_OUTPUT_SKILL_DIRECTORY, JAPANESE_OUTPUT_SKILL_MANAGED_MARKER, loadJapaneseOutputSkill } from './japanese-output-skill.js';
 import { deploymentParent, publishFile } from './managed-file-deployment.js';
 /** Preflight all standard Skills plus Japanese output without writing files. */
-export async function planStandardSkills(homeDirectory = os.homedir()) {
+export async function planStandardSkills(homeDirectory = os.homedir(), options = {}) {
     if (!path.isAbsolute(homeDirectory) || homeDirectory.includes('\0') || path.resolve(homeDirectory) === path.parse(homeDirectory).root) {
         throw new KiokukoError('VALIDATION_ERROR', 'Standard Skill deployment requires an absolute user home');
     }
@@ -27,8 +27,8 @@ export async function planStandardSkills(homeDirectory = os.homedir()) {
         const target = path.join(directory, bundled.directoryName, bundled.relativePath);
         await deploymentParent(home, target, false);
         const previous = await readRegularFile(target, { containmentRoot: home });
-        const rendered = renderStandardSkillFile(previous?.content, bundled, target);
-        files.push({ target, content: rendered.content, previous });
+        const content = options.preserveUnmanaged ? bundled.content : renderStandardSkillFile(previous?.content, bundled, target).content;
+        files.push({ target, content, previous });
     }
     return { home, directory, files };
 }
@@ -44,4 +44,76 @@ export async function synchronizeStandardSkills(homeDirectory = os.homedir()) {
     // Atomicity is per file. An interrupted tree is completed on the next plugin load.
     return result;
 }
+async function countUnplannedEntries(directory, planned) {
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return 0;
+        throw error;
+    }
+    let count = 0;
+    for (const entry of entries) {
+        const target = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            count += await countUnplannedEntries(target, planned);
+        else if (!planned.has(target))
+            count++;
+    }
+    return count;
+}
+async function removeEmptyDeploymentDirectories(directory, files) {
+    const directories = new Set();
+    for (const file of files) {
+        let current = path.dirname(file.target);
+        while (current !== directory && current.startsWith(`${directory}${path.sep}`)) {
+            directories.add(current);
+            current = path.dirname(current);
+        }
+    }
+    for (const target of [...directories].sort((left, right) => right.length - left.length)) {
+        try {
+            await rmdir(target);
+        }
+        catch { /* Preserve non-empty, absent, or otherwise unavailable directories. */ }
+    }
+}
+/** Remove only deployed files that still match this package byte-for-byte. */
+export async function retireStandardSkills(homeDirectory = os.homedir(), options = {}) {
+    const { home, directory, files } = await planStandardSkills(homeDirectory, { preserveUnmanaged: true });
+    const planned = new Set(files.map(file => file.target));
+    const result = { directory, removed: 0, preserved: await countUnplannedEntries(directory, planned) };
+    for (const file of files) {
+        if (file.previous === undefined)
+            continue;
+        if (file.previous.content !== file.content) {
+            result.preserved++;
+            continue;
+        }
+        if (options.check) {
+            result.removed++;
+            continue;
+        }
+        const current = await readRegularFile(file.target, { containmentRoot: home });
+        if (current === undefined)
+            continue;
+        if (current.content !== file.content) {
+            result.preserved++;
+            continue;
+        }
+        try {
+            await unlink(file.target);
+            result.removed++;
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    if (!options.check)
+        await removeEmptyDeploymentDirectories(directory, files);
+    return result;
+}
 //# sourceMappingURL=standard-skill-deployment.js.map

package/dist/dsh/standard-skill-deployment.js.map

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

package/dist/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "kiokuko-dsh",
-    "description": "Version 0.2.36 — Kiokuko plugin for DeepSeek Harness"
+    "description": "Version 0.2.37 — Kiokuko plugin for DeepSeek Harness"
   }
 }

package/dist/locale/ja.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "kiokuko-dsh",
-    "description": "バージョン 0.2.36 — DeepSeek Harness 向け Kiokuko プラグイン"
+    "description": "バージョン 0.2.37 — DeepSeek Harness 向け Kiokuko プラグイン"
   }
 }

package/dist/locale/ko.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "kiokuko-dsh",
-    "description": "버전 0.2.36 — DeepSeek Harness용 Kiokuko 플러그인"
+    "description": "버전 0.2.37 — DeepSeek Harness용 Kiokuko 플러그인"
   }
 }

package/dist/locale/zh-CN.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "kiokuko-dsh",
-    "description": "版本 0.2.36 — DeepSeek Harness 的 Kiokuko 插件"
+    "description": "版本 0.2.37 — DeepSeek Harness 的 Kiokuko 插件"
   }
 }

package/docs/README.ja.md

@@ -2,6 +2,7 @@
 
 目的別に参照してください。
 
+- [OpenAI Decisionsの設定](../README.ja.md#openai-decisions-setup) — APIキーの保存先・自動再読・優先順位・判定providerの切替。[詳細な設定（英語）](typed-decisions.md#openai-credentials)。
 - [導入ガイド](getting-started.ja.md) — DeepSeek Harness Pluginの導入と実行。
 - [基本概念](concepts.ja.md) — RAG、記憶のライフサイクル、Project/Ecosystem/Global、Akinator。
 - [役小角(enno-oduno)](enno-oduno.ja.md) — Agent Loop、確認、回復、継続、検証、Advisory Round。

package/docs/README.md

@@ -2,6 +2,7 @@
 
 Choose a guide by what you need to do:
 
+- [OpenAI Decisions setup](../README.md#openai-decisions-setup) — API key, credential file paths, automatic reload, precedence and provider switching; [detailed configuration](typed-decisions.md#openai-credentials).
 - [Getting started](getting-started.md) — install and run the DeepSeek Harness plugin.
 - [Concepts](concepts.md) — RAG, memory lifecycle, Project/Ecosystem/Global scopes, and Akinator.
 - [役小角(enno-oduno)](enno-oduno.md) — the agent loop, confirmation, recovery, continuation, verification, and Advisory Round.

package/docs/dsh-plugin.md

@@ -53,7 +53,7 @@ requires an explicit resume and a new generation. Old results cannot complete
 or modify that new generation. Model changes transfer the same task to the
 verified primary continuation; CLI resume rereads its persisted state.
 
-Jev/Laya interpretations are advisory. If they are unavailable or abstain, the
+Jev/Laya/OpenAI interpretations are advisory. If they are unavailable or abstain, the
 host records an unresolved decision and accepts a validated main-model
 interpretation or an explicit operation. The original request and authority
 checks remain in force. The CLI displays this SQLite snapshot and committed
@@ -220,6 +220,20 @@ Released v0/v1/v2/v3 history readers are bundled privately into the npm artifact
 
 ## Remove
 
+| Target | After `dsh plugin remove` | How to remove it |
+|---|---|---|
+| DSH rows (`kiokuko-dsh` / `kiokuko-models`) | Removed; the stock export row is restored | No further action |
+| Deployed Skills under `~/.agents/skills` | Remain | `setup-dsh.mjs --remove` |
+| DSH block in `AGENTS.md` | Remains | `setup-dsh.mjs --remove` |
+| `kiokuko-models.json` | Remains | Remove manually only when the saved provider definitions are no longer needed |
+| Kiokuko database and `.agenticreplay/runs` | Remain intentionally | Do not remove them as part of plugin removal |
+
+Disable individual rows when temporarily turning Kiokuko off. Disabling the whole
+bundle also removes the provider referenced by `agent-default-model`, leaving its
+default-model binding unresolved. `patchReload: "live"` has no reader in the
+current DSH and must not be treated as evidence that a profile change took effect
+immediately.
+
 ```bash
 dsh plugin --profile web remove kiokuko-dsh
 ```
@@ -268,19 +282,24 @@ block in the startup directory’s `AGENTS.md`, as described below.
 ## Bundled standard Skills: canonical source and refresh
 
 The repository's `skills/<name>/` directories are the single canonical source
-for the eight standard Skills and for the bundled Japanese output Skill.
+for the 16 standard Skills and for the separately bundled Japanese output and
+Lisp Skills.
 `src/dsh/standard-skills.ts` resolves them relative to the built module
 (`dist/dsh/` → `../../skills/<name>`), and `src/dsh/standard-skill-integrity.ts`
 refuses to load a tree that breaks the manifest: exactly one management marker
 per file, frontmatter `name` equal to the manifest name with a non-empty
 description and no `disable-model-invocation`, every local Markdown link
-resolvable inside its own Skill, and exactly 8 Skills with 27 Markdown files and
-19 reference files.
+resolvable inside its own Skill, and exactly 16 standard Skills with 42 Markdown
+files and 26 reference files.
 
-The Japanese output Skill is an additional ninth Skill. Its directory is
+The Japanese output Skill and Lisp Skill bring the package inventory to 18 Skill
+directories. The Japanese output directory is
 `japanese-translation-for-oss-models/`; its frontmatter/provider name is
-`natural-japanese-output`. Both names refer to the same Skill. Deployment includes
-all nine Skills and 28 Markdown files, including the 19 references.
+`natural-japanese-output`. Both names refer to the same Skill. Setup deploys the
+16 standard Skills plus
+Japanese output: 17 directories and 43 files, including the 26 references. Lisp
+is supplied through the DSH Skill provider and is not installed globally by this
+setup path.
 
 `veteran-programmer-skill` checks workflow completeness before and after changes
 spanning setup, delivery, persisted state or runtime handoffs. SOUL and the code
@@ -300,8 +319,9 @@ alone does not establish remaining input budget or model quality.
 The enabled plugin runs setup on every load, before registering its DSH surfaces:
 
 1. Validate the bundled Skills and preflight the deployment targets.
-2. Synchronize all eight managed Skill directories to the process user's
-   `~/.agents/skills/`, creating missing files and replacing stale managed files.
+2. Synchronize all 16 standard Skill directories and the Japanese output Skill
+   to the process user's `~/.agents/skills/`, creating missing files and replacing
+   stale managed files.
 3. Replace the existing `<!-- BEGIN KIOKUKO-DSH MANAGED BLOCK -->` through
    `<!-- END KIOKUKO-DSH MANAGED BLOCK -->` section of the startup directory's
    `AGENTS.md` with the DSH contract. Preserve all text outside those markers.
@@ -356,6 +376,9 @@ npm run build
 node scripts/setup-dsh.mjs --cwd /absolute/path/to/project --check
 node scripts/setup-dsh.mjs --cwd /absolute/path/to/project
 node scripts/setup-dsh.mjs --cwd /absolute/path/to/project --check
+# Explicitly remove byte-identical deployed copies and the DSH AGENTS.md block.
+node scripts/setup-dsh.mjs --cwd /absolute/path/to/project --remove
+node scripts/setup-dsh.mjs --cwd /absolute/path/to/project --remove --check
 ```
 
 The same `scripts/setup-dsh.mjs` ships in the installed package. Use the **actual
@@ -374,8 +397,8 @@ runtime user. Check the reported paths: a successful source build or bundled
 parity check alone does not prove that another process's deployed files match.
 
 `node scripts/verify-standard-skills.mjs` remains a source/bundle integrity check
-for the eight standard Skills (27 files, 19 references). Use `setup-dsh.mjs --check`
-for the complete nine-Skill deployment **and** project instruction check.
+for the 16 standard Skills (42 files, 26 references). Use `setup-dsh.mjs --check`
+for the complete 17-directory, 43-file deployment **and** project instruction check.
 
 ## STORE contract and permissions
 
@@ -402,9 +425,14 @@ Runtime effects are explicit:
 - optional GitHub or embedding credentials are supplied by the user and are
   never bundled or persisted by the plugin.
 
-`prepare` runs only `npm run build`. Git installs need build approval in the
-consuming profile; use the repository-scoped rule in [Install](#install) so
-ordinary updates do not require another commit-specific permission.
+`prepare` runs `node scripts/prepare-build.mjs`, which normally builds through
+the invoking package manager. Only `CI=true` together with
+`KIOKUKO_CI_DEFER_PREPARE=1` defers this package's duplicate build to the selected
+verifier's clean build; dependency lifecycle scripts remain enabled. See
+[CI build ownership](verification.md#consolidated-duplicate-invocations).
+Git installs still need build approval in the consuming profile; use the
+repository-scoped rule in [Install](#install) so ordinary updates do not require
+another commit-specific permission.
 
 The npm tarball already contains `dist/`, so its normal install path does not
 depend on a consumer-side build permission.

package/docs/getting-started.ja.md

@@ -3,6 +3,8 @@
 `kiokuko-dsh`はDeepSeek Harness向けPluginです。公開パッケージが提供する
 のは`./dsh` Plugin entrypointだけです。導入、session、lifecycleはDSHが所有します。
 
+補助判定でOpenAIを使う場合は、[OpenAI Decisionsの設定](../README.ja.md#openai-decisions-setup)でAPIキーの保存先とWeb profileとの違いを確認してください。主モデルのChatGPT/Codex OAuthとは別です。手順は現行ソースの対応を示し、公開済みnpmの `latest` に含まれることを保証しません。
+
 ## インストール
 
 公式 DeepSeek Harness の現在のソースと Node.js 24.16.0 以上を使用します。DSH の版名による固定判定はせず、実際のホスト API と解決したソース revision に対する隔離試験で互換性を確認します。[検証範囲](current-upstream-compatibility-report.md)を参照してください。

package/docs/getting-started.md

@@ -3,6 +3,8 @@
 `kiokuko-dsh` is a DeepSeek Harness plugin. The published package contains the
 `./dsh` plugin entrypoint. DSH owns installation, sessions, and lifecycle.
 
+Before choosing OpenAI for auxiliary decisions, follow the [OpenAI Decisions setup](../README.md#openai-decisions-setup) for API-key storage and the Web-profile path distinction. Main-model ChatGPT/Codex OAuth is separate. The guide describes current source support, not a guarantee about the published npm `latest`.
+
 ## Install
 
 Use current official DeepSeek Harness and Node.js 24.16.0 or newer. Compatibility is checked against actual host APIs and the resolved upstream source revision, not a fixed DSH release label. See [verified scope](current-upstream-compatibility-report.md).

package/docs/model-selection.ja.md

@@ -14,7 +14,7 @@ DSHの権限判定、必要な検証を維持し、役小角の契約・WorkUnit
 
 Webプロファイルでは [Kiokuko Models](kiokuko-models.md) から接続を設定できます。DSH本体のModelsで設定する必要はありません。登録したモデルは、通常会話・Enno・Deepでネイティブ接続と併用できます。
 
-通常版・modular coreとも `modelAutoMode.mode: off` が既定です。同じDSHプロファイルでKiokuko Modelsまたはdsh-codexからCodexを認証し、JevかLayaの判定を準備したうえで、まず `observe` で選択案を確認します。
+通常版・modular coreとも `modelAutoMode.mode: off` が既定です。同じDSHプロファイルでKiokuko Modelsまたはdsh-codexからCodexを認証し、Jev・Laya・[OpenAI](typed-decisions.md#openai-credentials)のいずれかの判定を準備したうえで、まず `observe` で選択案を確認します。
 
 ```yaml
 modelAutoMode:
@@ -34,7 +34,7 @@ modelAutoMode:
 
 初期候補は `gpt-6-luna` の low・medium・high と `gpt-6-sol` の high です。`modelAutoMode.routes` には最大4件、`id`（`luna-low`、`luna-medium`、`luna-high`、`sol-high`）と `binding`（`provider`、`model`、`reasoningEffort`）を指定できます。IDは経路のラベルなので、登録済みのAstraなども正確なbindingで割り当てられます。候補はCodex由来とResponses方式を確認でき、現在のモデル一覧、文脈容量・入力形式・推論強度、要求設定の検証、token meterを通った接続に限定します。ネイティブの `openai-codex` とKiokuko所有のCodex接続が対象です。名前だけを似せた接続やOpenAI API接続は対象外です。有効なbindingが2件未満なら判定しません。
 
-新しい受付済みの通常タスクでは、現在の依頼文、タスク種別、添付の種類、経路IDと判定基準を選択中のJevかLayaへ送ります。この判定のために添付の内容、全履歴、リポジトリ全体は送信しません。Choice 1問の結果をrunに保存し、継続では同じ経路を使います。再起動時に判定結果が不明なら再送せず元のモデルを維持します。`observe`、棄権、probe失敗、metadata不足、非対応effort、timeout、入力超過でも元のモデルを維持します。取消、セッション同一性の不一致、保存の整合性エラーでは要求を止めます。認証・利用枠・モデル利用不可によるdispatch失敗を別モデルへ自動再送しません。
+新しい受付済みの通常タスクでは、現在の依頼文、タスク種別、添付の種類、経路IDと判定基準を選択中のJev・Laya・OpenAIへ送ります。この判定のために添付の内容、全履歴、リポジトリ全体は送信しません。Choice 1問の結果をrunに保存し、継続では同じ経路を使います。再起動時に判定結果が不明なら再送せず元のモデルを維持します。`observe`、棄権、probe失敗、metadata不足、非対応effort、timeout、入力超過でも元のモデルを維持します。取消、セッション同一性の不一致、保存の整合性エラーでは要求を止めます。認証・利用枠・モデル利用不可によるdispatch失敗を別モデルへ自動再送しません。
 
 状態表示では、設定・準備状態・選択案・適用したbindingと、nativeの `request/header` で確認した実モデルを区別します。初期候補は判定基準であり、品質・時間・利用枠の改善を保証しません。Enno、Deep、子、雑談、回答の再検討、保護されたLisp実行は既存の経路を使います。実装失敗後の自動昇格は初期版に含めません。
 

package/docs/model-selection.md

@@ -15,7 +15,7 @@ plan approval or automatic Enno continuation.
 
 In Web profiles, [Kiokuko Models](kiokuko-models.md) manages connections without requiring DSH's Models settings. Its registered models are available to ordinary chat, Enno and Deep alongside native connections.
 
-`modelAutoMode` is off by default in both the full plugin and modular core. To try it, authenticate Codex through Kiokuko Models or dsh-codex in the same DSH profile, configure a Jev or Laya typed-decision backend, then use `observe` before enabling automatic routing:
+`modelAutoMode` is off by default in both the full plugin and modular core. To try it, authenticate Codex through Kiokuko Models or dsh-codex in the same DSH profile, configure a Jev, Laya or [OpenAI typed-decision backend](typed-decisions.md#openai-credentials), then use `observe` before enabling automatic routing:
 
 ```yaml
 modelAutoMode:
@@ -35,7 +35,7 @@ The command changes only the current native session. `on` also clears its manual
 
 The initial preset offers `gpt-6-luna` at low, medium and high effort, plus `gpt-6-sol` at high effort. Up to four exact route bindings can be configured under `modelAutoMode.routes`; each has an `id` from `luna-low`, `luna-medium`, `luna-high`, `sol-high`, and a `binding` with `provider`, `model`, and `reasoningEffort`. These are route labels, so a registered Astra or other GPT model may be assigned explicitly. No new model ID is guessed or substituted. A candidate must have a validated Codex origin and Responses protocol, live model context and modality metadata, supported efforts, call-config validation and token meter. Both native `openai-codex` and Kiokuko-owned Codex routes qualify; an arbitrary provider name or OpenAI API connection does not. Fewer than two valid bindings skips classification.
 
-For a new admitted normal task, Kiokuko sends the current task text, task type, attachment kinds, route IDs and rubric to the selected Jev or Laya backend. It does not send attachment bytes, full history or repository contents for this classification. One Choice result selects a route or abstains. The route is stored against the exact run and reused for continuations; an unknown in-flight decision after restart is retained without another classifier call. `observe` records a proposal but keeps the current model. A failed probe, missing metadata, unsupported effort, timeout, oversized input or abstention also keeps the current model. Cancellation, stale session identity and storage integrity failures stop the request. Dispatch authentication, quota and unavailable-model errors remain ordinary failures; no alternate model is retried automatically.
+For a new admitted normal task, Kiokuko sends the current task text, task type, attachment kinds, route IDs and rubric to the selected Jev, Laya or OpenAI backend. It does not send attachment bytes, full history or repository contents for this classification. One Choice result selects a route or abstains. The route is stored against the exact run and reused for continuations; an unknown in-flight decision after restart is retained without another classifier call. `observe` records a proposal but keeps the current model. A failed probe, missing metadata, unsupported effort, timeout, oversized input or abstention also keeps the current model. Cancellation, stale session identity and storage integrity failures stop the request. Dispatch authentication, quota and unavailable-model errors remain ordinary failures; no alternate model is retried automatically.
 
 The status distinguishes the configured mode, readiness, proposal and selected binding from the model observed in a native `request/header`. The initial preset is a rubric, not a claim that it improves quality, elapsed time or subscription usage. Enno, Deep, children, chat, review continuation and protected Lisp execution retain their existing owners. Automatic escalation after a failed implementation pass is not enabled.
 

package/docs/store-evidence.md

@@ -17,6 +17,12 @@ permissions, and disposable-profile result independently.
 | npm lifecycle | `prepare: npm run build` |
 | Automatic size policy | intentionally exceeded; manual `user-reviewed` track |
 
+This table records the **0.1.3 review snapshot**, including its original lifecycle
+command; it is not the current package's release evidence. Current source uses
+`prepare: node scripts/prepare-build.mjs` with normal builds and an explicit CI-only
+deferral. See [current lifecycle and permissions](../PERMISSIONS.md#installation-lifecycle)
+and [CI build ownership](verification.md#consolidated-duplicate-invocations).
+
 The Commit field is filled only after the user commits and pushes the verified
 working tree. The catalog must point to that full immutable Commit, not a branch
 name or moving tag.

package/docs/typed-decisions.md

@@ -23,7 +23,7 @@ excerpted or rewritten, and classification grants no execution permission.
 The common API also accepts explicit `noul` (yes probability) and `score`
 (ordered rubric) questions. Their validated answers have `status: "measured"`;
 they grant no permission. The existing Choice request and answer shapes remain
-valid. TypeSafe can evaluate all three question types in one batch. Nimble and
+valid. TypeSafe and OpenAI can evaluate all three question types in one batch. Nimble and
 Laya accept Choice only and return `DECISION_UNSUPPORTED` before inference for
 other kinds. The separate Lisp `kioku.typesafe:evaluate` API retains its own
 wire contract.
@@ -49,6 +49,59 @@ base configuration. A stale host cannot overwrite a selection saved by another
 host; restart it to load the latest choice. Changing the base configuration uses
 that configuration's selection, with the YAML provider as the default.
 
+<a id="openai-credentials"></a>
+## OpenAI credentials
+
+Jev remains the default; OpenAI, local Laya and Nimble are alternatives. OpenAI uses the official [Decisions API](https://developers.openai.com/api/docs/guides/decisions), `POST /v1/decisions`, with `gpt-6-luna` as this checkout's default decision model. This is separate from the main chat model: ChatGPT/Codex OAuth login does not supply `OPENAI_API_KEY`, and a TypeSafe/Jev key cannot replace it.
+
+These instructions describe the current source. They do not assert that the published npm `latest` already includes OpenAI support. If `use openai` is unavailable, check the installed build's command support first.
+
+1. Create an API key for your OpenAI API project and add it to the credential store used by the running DSH. With the standard `credentials-local` provider, choose the path as follows:
+
+   | Configuration | Credential file |
+   |---|---|
+   | Default harness home | `~/.dsh/.credentials.yaml` |
+   | Custom `DSH_HOME` | `$DSH_HOME/.credentials.yaml` |
+   | Explicit `credentials.path` (the provider's `config.path`) | The configured path, overriding the home default |
+
+   `--profile web` keeps profile packages and patches under `$DSH_HOME/profiles/web`; it does **not** by itself move credentials there. A profile can override `credentials.path`, or its launcher can use another `DSH_HOME`. Use that effective file, not a guessed `profiles/web/.credentials.yaml`.
+
+2. In an existing file, add only `OPENAI_API_KEY` under `refs` and preserve all other `refs` and `records`. This is a minimal **new-file example**, with a nonfunctional placeholder:
+
+   ```yaml
+   version: 1
+   refs:
+     OPENAI_API_KEY: "OPENAI_API_KEY_EXAMPLE_ONLY"
+   records: {}
+   ```
+
+   Replace the placeholder privately with your key. On macOS/Linux, protect the actual file; for the default path:
+
+   ```sh
+   chmod 600 "$HOME/.dsh/.credentials.yaml"
+   ```
+
+   Use your configured path instead when it differs. The default `watch: true` reloads valid file edits automatically for subsequent requests; restarting DSH is unnecessary. Do not paste keys into chat, screenshots or Git.
+
+3. In DSH's command input, select OpenAI and inspect the result:
+
+   ```text
+   /kioku-decisions use openai
+   /kioku-decisions status
+   ```
+
+   `use openai` makes a real API probe, which may incur usage charges. Only a successful probe and save persist the choice for this project and new requests; failure or cancellation keeps the prior choice. Existing requests keep their binding. `status` makes no inference call. Optional `/kioku-decisions probe` makes another real probe.
+
+The standard provider resolves **saved file > launch environment > project `.env` > harness-home `.env`**. Environment variables still work when the credentials service is present, unless a saved value overrides them. For an environment-only setup, export the key **before** launching DSH from that shell:
+
+```sh
+export OPENAI_API_KEY='OPENAI_API_KEY_EXAMPLE_ONLY'
+```
+
+This is a placeholder, not a usable key. An export in another shell after DSH has started does not update its launch snapshot; use the watched file to update an already running instance. Keep credential-bearing `.env` files out of Git.
+
+## Provider configuration
+
 Configure `typedDecisions` on the full plugin or modular core:
 
 OpenAI uses the distinct official [Decisions API](https://developers.openai.com/api/docs/guides/decisions),
@@ -56,13 +109,30 @@ OpenAI uses the distinct official [Decisions API](https://developers.openai.com/
 It maps Choice, Noul (predicate) and Score to the native API and validates ordered
 named answers, distributions, rubric levels and individual refusals. The default
 model is `gpt-6-luna`; probability ≥ 0.9 and margin ≥ 0.2 are required for Choice.
-Set `OPENAI_API_KEY` through DSH credentials (or the environment when no credentials
-service exists). TypeSafe credentials are never substituted. No redirects,
+Kiokuko resolves `OPENAI_API_KEY` through `ctx.credentials.resolve` when the service
+exists; the standard local provider includes the launch environment and `.env`
+fallbacks described [above](#openai-credentials). Only a composition without that
+service uses Kiokuko's direct `process.env` fallback. A different credential
+provider may have different resolution rules. TypeSafe credentials are never substituted. No redirects,
 automatic retries, or provider fallback are added. `use openai` probes before
 persisting; missing credentials, failed probes and cancellation leave selection unchanged.
 Existing Jev/Laya stored configuration digests retain their original shape.
 Current token records retain input/output totals; cached-token breakdown is not recorded.
 
+To select OpenAI in the plugin or core configuration instead of a project command:
+
+```yaml
+typedDecisions:
+  mode: auto
+  provider: openai
+  openai:
+    model: gpt-6-luna
+    timeoutMs: 5000
+```
+
+Keep keys in the credential store, not in `typedDecisions`. A configured provider
+is not evidence of a successful API call; use the command probe to verify access.
+
 The normal startup card offers the four decision/Lisp ON/OFF combinations and Cancel
 in one question before model tool assembly. It uses the currently selected backend,
 shown in the card; selection does not prove authentication or successful inference.
@@ -129,7 +199,8 @@ A live comparison requires explicit
 `TYPESAFE_API_KEY`; it sends only the checked-in synthetic fixture and must not
 be interpreted as a production accuracy estimate.
 
-Set the TypeSafe key through DSH, then inspect status:
+The following commands manage only the TypeSafe/Jev key; for OpenAI, use the
+[credential-file setup](#openai-credentials). Set the TypeSafe key through DSH, then inspect status:
 
 ```text
 /kioku-typesafe-key <key>