kiokuko-dsh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 askdkc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,50 @@
+# Kiokuko DeepSeek Harness Plugin
+
+[English](README.md) | 日本語 | [简体中文](README.zh-CN.md) | [한국어](README.ko.md)
+
+`kiokuko-dsh`は、[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)向けのout-of-tree Pluginです。
+npmにはまだ公開していません。
+
+## 導入
+
+DeepSeek Harness `0.1.2-alpha.3` と Node.js 24.16.0 以上が必要です。
+
+初回のGit導入前に、`web` profileでこのパッケージのbuildを許可します。
+失敗したinstallに表示されたcommit付きのkeyを
+`~/.dsh/profiles/web/pnpm-workspace.yaml`へ追加してください:
+
+```yaml
+allowBuilds:
+  "kiokuko-dsh@https://codeload.github.com/askdkc/kiokuko-dsh/tar.gz/<commit>": true
+```
+
+既存の項目は残し、`<commit>`はpnpmが表示した値に置き換えてから、下の導入コマンドを再実行します。
+
+DeepSeek Harnessのcheckoutから導入する場合:
+
+```bash
+pnpm dsh plugin --profile web add github:askdkc/kiokuko-dsh
+pnpm dsh --profile web --dump-config
+```
+
+ローカルcheckoutを使う場合は、先にビルドしてパスを指定します:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm dsh plugin --profile web add /path/to/kiokuko-dsh
+```
+
+インストール済みの`dsh` CLIでは先頭の`pnpm`を外します。削除:
+
+```bash
+dsh plugin --profile web remove kiokuko-dsh
+```
+
+npm公開前に裸の`kiokuko-dsh`を指定しないでください。npm registryのパッケージとして解決されます。
+
+詳細は[DeepSeek Harness Pluginガイド](docs/dsh-plugin.md)を参照してください。
+
+## License
+
+MIT

package/README.ko.md

@@ -0,0 +1,50 @@
+# Kiokuko DeepSeek Harness Plugin
+
+[English](README.md) | [日本語](README.ja.md) | [简体中文](README.zh-CN.md) | 한국어
+
+`kiokuko-dsh`는 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)를 위한 out-of-tree Plugin입니다.
+아직 npm에 공개되지 않았습니다.
+
+## 설치
+
+DeepSeek Harness `0.1.2-alpha.3` 및 Node.js 24.16.0 이상이 필요합니다.
+
+처음 Git으로 설치하기 전에 `web` profile에서 이 패키지의 build를 허용합니다.
+실패한 설치에서 pnpm이 표시한 commit 포함 exact key를
+`~/.dsh/profiles/web/pnpm-workspace.yaml`에 추가하십시오.
+
+```yaml
+allowBuilds:
+  "kiokuko-dsh@https://codeload.github.com/askdkc/kiokuko-dsh/tar.gz/<commit>": true
+```
+
+기존 항목은 유지하고 `<commit>`을 pnpm이 표시한 값으로 바꾼 뒤 아래 설치 명령을 다시 실행합니다.
+
+DeepSeek Harness checkout에서 설치:
+
+```bash
+pnpm dsh plugin --profile web add github:askdkc/kiokuko-dsh
+pnpm dsh --profile web --dump-config
+```
+
+로컬 checkout을 사용할 때는 먼저 빌드한 뒤 경로를 지정합니다:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm dsh plugin --profile web add /path/to/kiokuko-dsh
+```
+
+설치된 `dsh` CLI를 사용할 때는 앞의 `pnpm`만 생략합니다. 삭제:
+
+```bash
+dsh plugin --profile web remove kiokuko-dsh
+```
+
+npm에 공개하기 전에는 `kiokuko-dsh`만 단독으로 지정하지 마십시오. npm registry 패키지로 해석됩니다.
+
+자세한 내용은 [DeepSeek Harness Plugin 안내](docs/dsh-plugin.md)를 참조하십시오.
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,53 @@
+# Kiokuko DeepSeek Harness Plugin
+
+[日本語](README.ja.md) | [简体中文](README.zh-CN.md) | [한국어](README.ko.md)
+
+`kiokuko-dsh` is an out-of-tree plugin for
+[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
+The package is not published to npm yet.
+
+## Install
+
+DeepSeek Harness `0.1.2-alpha.3` and Node.js 24.16.0 or newer are required.
+
+Before the first Git install, allow this package's build in the `web` profile.
+The failed install prints the exact commit key to add to
+`~/.dsh/profiles/web/pnpm-workspace.yaml`:
+
+```yaml
+allowBuilds:
+  "kiokuko-dsh@https://codeload.github.com/askdkc/kiokuko-dsh/tar.gz/<commit>": true
+```
+
+Keep existing entries, replace `<commit>` with the value pnpm printed, then
+run the install command below again.
+
+From a DeepSeek Harness checkout:
+
+```bash
+pnpm dsh plugin --profile web add github:askdkc/kiokuko-dsh
+pnpm dsh --profile web --dump-config
+```
+
+For a local checkout, build it first and pass its path:
+
+```bash
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm dsh plugin --profile web add /path/to/kiokuko-dsh
+```
+
+With an installed `dsh` CLI, omit the `pnpm` launcher. Remove the plugin with:
+
+```bash
+dsh plugin --profile web remove kiokuko-dsh
+```
+
+Do not use bare `kiokuko-dsh` until the package is published to npm; that form
+asks npm for a registry package.
+
+See [the DeepSeek Harness Plugin guide](docs/dsh-plugin.md) for runtime details.
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,50 @@
+# Kiokuko DeepSeek Harness Plugin
+
+[English](README.md) | [日本語](README.ja.md) | 简体中文 | [한국어](README.ko.md)
+
+`kiokuko-dsh` 是面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 out-of-tree Plugin。
+该包尚未发布到 npm。
+
+## 安装
+
+需要 DeepSeek Harness `0.1.2-alpha.3` 和 Node.js 24.16.0 或更高版本。
+
+首次从 Git 安装前，请在 `web` profile 中允许此包执行构建。
+将失败安装时 pnpm 显示的带 commit 的 exact key 添加到
+`~/.dsh/profiles/web/pnpm-workspace.yaml`：
+
+```yaml
+allowBuilds:
+  "kiokuko-dsh@https://codeload.github.com/askdkc/kiokuko-dsh/tar.gz/<commit>": true
+```
+
+保留已有条目，将 `<commit>` 替换为 pnpm 显示的值，然后重新运行下面的安装命令。
+
+从 DeepSeek Harness checkout 安装：
+
+```bash
+pnpm dsh plugin --profile web add github:askdkc/kiokuko-dsh
+pnpm dsh --profile web --dump-config
+```
+
+使用本地 checkout 时，先构建再传入路径：
+
+```bash
+pnpm install --frozen-lockfile
+pnpm run build
+pnpm dsh plugin --profile web add /path/to/kiokuko-dsh
+```
+
+使用已安装的 `dsh` CLI 时去掉开头的 `pnpm`。删除：
+
+```bash
+dsh plugin --profile web remove kiokuko-dsh
+```
+
+npm 发布前不要直接指定 `kiokuko-dsh`，否则会被当作 npm registry 包解析。
+
+详见 [DeepSeek Harness Plugin 指南](docs/dsh-plugin.md)。
+
+## License
+
+MIT

package/dist/agent-file/atomic-write.d.ts

@@ -0,0 +1,93 @@
+import { chmod, type FileHandle } from 'node:fs/promises';
+export interface FileIdentity {
+    device: bigint;
+    inode: bigint;
+}
+export interface RegularFileSnapshot {
+    content: string;
+    mode: number;
+    identity: FileIdentity;
+}
+export interface FileExpectation {
+    expected: RegularFileSnapshot | undefined;
+    /** Paths whose absence is part of the same decision (for example an alternate config path). */
+    mustRemainAbsent?: readonly string[];
+    /** Reject every symbolic-link component below this already-resolved root. */
+    containmentRoot?: string;
+    /** When present, the parent must preexist and retain this exact directory identity. */
+    expectedParentDirectory?: FileIdentity;
+}
+export declare class AtomicCleanupFailure extends Error {
+    /** Exact pathname of the owned artifact, when its full binding was proven after the failure. */
+    readonly artifactPath: string | undefined;
+    constructor(
+    /** Exact pathname of the owned artifact, when its full binding was proven after the failure. */
+    artifactPath: string | undefined, options: {
+        cause: unknown;
+    });
+}
+export interface AtomicWriteResult {
+    installed: RegularFileSnapshot;
+    cleanupFailures: readonly AtomicCleanupFailure[];
+}
+export interface AtomicUnlinkResult {
+    cleanupFailures: readonly AtomicCleanupFailure[];
+}
+export declare class AtomicCommittedMutationError extends AggregateError {
+    readonly outcome: AtomicWriteResult;
+    readonly operationError: unknown;
+    constructor(outcome: AtomicWriteResult, operationError: unknown);
+}
+export declare class AtomicCommittedUnlinkError extends AggregateError {
+    readonly outcome: AtomicUnlinkResult;
+    readonly operationError: unknown;
+    constructor(outcome: AtomicUnlinkResult, operationError: unknown);
+}
+export declare function assertAtomicCleanupComplete(result: Pick<AtomicWriteResult | AtomicUnlinkResult, 'cleanupFailures'>): void;
+export interface AtomicWriteDependencies {
+    chmod?: typeof chmod;
+    beforeLink?: (source: string, destination: string) => void | Promise<void>;
+    afterLink?: (source: string, destination: string) => void | Promise<void>;
+    beforeRename?: (source: string, destination: string) => void | Promise<void>;
+    afterRename?: (source: string, destination: string) => void | Promise<void>;
+    beforeCleanup?: (artifactPath: string) => void | Promise<void>;
+    beforeCommit?: (filePath: string) => void | Promise<void>;
+    afterQuarantine?: (filePath: string) => void | Promise<void>;
+    afterInstall?: (filePath: string) => void | Promise<void>;
+}
+export interface ReadRegularFileDependencies {
+    /** Test seam for proving that reads remain bound to the opened descriptor. */
+    afterOpen?: (filePath: string, handle: FileHandle) => void | Promise<void>;
+    /** Test seam for preserving an operation failure when descriptor close also fails. */
+    closeHandle?: (handle: FileHandle) => Promise<void>;
+    /** Test seam for exercising the Windows no-O_NOFOLLOW strategy on any host. */
+    platform?: NodeJS.Platform;
+}
+export interface ConditionalUnlinkDependencies {
+    beforeRename?: (source: string, destination: string) => void | Promise<void>;
+    afterRename?: (source: string, destination: string) => void | Promise<void>;
+    beforeCleanup?: (artifactPath: string) => void | Promise<void>;
+    beforeCommit?: (filePath: string) => void | Promise<void>;
+}
+export declare function readRegularFile(filePath: string, dependencies?: ReadRegularFileDependencies & {
+    containmentRoot?: string;
+}): Promise<RegularFileSnapshot | undefined>;
+/** Read an exact directory identity without following its final path component. */
+export declare function readDirectoryIdentity(directoryPath: string): Promise<FileIdentity | undefined>;
+export interface PendingAtomicMutation {
+    kind: 'deleted' | 'previous' | 'rollback';
+    snapshot: RegularFileSnapshot;
+}
+/**
+ * Bind a native atomic-write quarantine for this exact basename without
+ * following path components. Its snapshot may constrain convergence, but it
+ * never grants the caller ownership of the artifact.
+ */
+export declare function readPendingAtomicMutation(filePath: string, expectedParentDirectory: FileIdentity, containmentRoot?: string): Promise<PendingAtomicMutation | undefined>;
+export declare function assertFileExpectation(filePath: string, expectation: FileExpectation): Promise<void>;
+export declare function atomicWriteText(filePath: string, content: string, mode?: number, dependencyOverrides?: AtomicWriteDependencies): Promise<AtomicWriteResult>;
+/** Write only when the target is still the exact file observed at planning time. */
+export declare function atomicWriteTextIfUnchanged(filePath: string, content: string, expectation: FileExpectation, mode?: number, dependencyOverrides?: AtomicWriteDependencies): Promise<AtomicWriteResult>;
+/** Delete only when the target is still the exact planned file identity and content. */
+export declare function unlinkRegularFileIfUnchanged(filePath: string, expectation: FileExpectation, dependencyOverrides?: ConditionalUnlinkDependencies): Promise<AtomicUnlinkResult>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/agent-file/atomic-write.d.ts.map

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