@wingsbutterfly/dsh-rtk 0.1.0

package/lib/rtk-executable.js.map

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

package/lib/rtk-rewrite.d.ts

@@ -0,0 +1,88 @@
+/** One `rtk rewrite` outcome. */
+export interface RtkRewriteResult {
+    changed: boolean;
+    originalCommand: string;
+    rewrittenCommand: string;
+    exitCode: number;
+    error?: string;
+}
+/** Injected runner so tests never spawn a process. */
+export type RtkRunner = (command: string, args: readonly string[], options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+/** Options for {@link resolveRtkRewrite}. */
+export interface RtkRewriteOptions {
+    runner: RtkRunner;
+    executable: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+/**
+ * Split leading `KEY=VALUE` assignments off a command line.
+ *
+ * Shell treats a run of assignments before the command word as that command's
+ * environment, so `FOO=1 ls` invokes `ls`, not `FOO=1`. Detection must look at
+ * the command word; passing the whole line would classify `FOO=1 git status`
+ * as unsupported.
+ *
+ * @param command - raw command line.
+ * @returns the assignment prefix (verbatim, including trailing space) and the command word onward.
+ */
+export declare function splitLeadingEnvAssignments(command: string): {
+    envPrefix: string;
+    command: string;
+};
+/**
+ * Whether a command (ignoring a leading assignment run) already invokes rtk.
+ *
+ * Rewriting an rtk command would produce `rtk rtk …`, and the guard also saves
+ * a process spawn on every already-optimized call.
+ */
+export declare function isAlreadyRtkCommand(command: string): boolean;
+/** Which shell dialect an assignment prefix must be written in. */
+export type ShellKind = 'posix' | 'powershell';
+/**
+ * Prefix a command with an isolated `RTK_DB_PATH` so rtk's usage history lands
+ * in a scratch directory instead of the working tree.
+ *
+ * The two shells need different syntax: `export NAME='value'` is a syntax error
+ * in PowerShell, which spells the same thing `$env:NAME = 'value'`. Both the
+ * harness's `pwsh` tool and its `bash` tool are rewrite targets, so the caller
+ * passes the dialect rather than assuming one.
+ *
+ * The assignment is skipped when the command already sets it or the ambient
+ * environment provides one, so an explicit choice is never overridden.
+ *
+ * @param command - the rewritten command.
+ * @param historyDbPath - absolute path for this deployment's rtk history database.
+ * @param ambientValue - value currently in the environment, if any.
+ * @param shell - the dialect of the command being prefixed.
+ * @returns the command to run, prefixed only when isolation applies.
+ */
+export declare function applyRtkHistoryScope(command: string, historyDbPath: string, ambientValue: string | undefined, shell?: ShellKind): string;
+/**
+ * Ask the installed rtk binary how it would rewrite a command.
+ *
+ * rtk owns the rewrite rules; this plugin deliberately carries no duplicate
+ * table. The exit-code contract is rtk's:
+ *
+ * | code | meaning |
+ * |------|---------|
+ * | 0, 3 | stdout is the rewritten command |
+ * | 1    | no rtk equivalent — run the command unchanged |
+ * | 2    | rtk refused the rewrite; stderr explains why |
+ *
+ * A non-zero code is an ordinary outcome, never a rejection: the caller always
+ * has the original command to fall back on.
+ *
+ * @param command - the raw command the model asked to run.
+ * @param options - runner, executable, deadline, and caller cancellation.
+ * @returns the decision, including the fallback command when nothing changed.
+ */
+export declare function resolveRtkRewrite(command: string, options: RtkRewriteOptions): Promise<RtkRewriteResult>;
+//# sourceMappingURL=rtk-rewrite.d.ts.map

package/lib/rtk-rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-rewrite.d.ts","sourceRoot":"","sources":["../src/rtk-rewrite.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KACnD,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE9D,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6BlG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG5D;AAID,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,YAAY,CAAA;AAK9C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,GAAE,SAAmB,GACzB,MAAM,CAcR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiC9G"}

package/lib/rtk-rewrite.js

@@ -0,0 +1,150 @@
+const ENV_ASSIGNMENT = /^[A-Za-z_][A-Za-z0-9_]*=/;
+/**
+ * Split leading `KEY=VALUE` assignments off a command line.
+ *
+ * Shell treats a run of assignments before the command word as that command's
+ * environment, so `FOO=1 ls` invokes `ls`, not `FOO=1`. Detection must look at
+ * the command word; passing the whole line would classify `FOO=1 git status`
+ * as unsupported.
+ *
+ * @param command - raw command line.
+ * @returns the assignment prefix (verbatim, including trailing space) and the command word onward.
+ */
+export function splitLeadingEnvAssignments(command) {
+    let index = 0;
+    let prefixEnd = 0;
+    while (index < command.length) {
+        const rest = command.slice(index);
+        const match = ENV_ASSIGNMENT.exec(rest);
+        if (match === null)
+            break;
+        let cursor = index + match[0].length;
+        if (cursor >= command.length)
+            return { envPrefix: '', command };
+        const first = command[cursor];
+        if (first === '"' || first === "'") {
+            cursor += 1;
+            while (cursor < command.length && command[cursor] !== first)
+                cursor += 1;
+            if (cursor >= command.length)
+                return { envPrefix: '', command };
+            cursor += 1;
+        }
+        else {
+            while (cursor < command.length && !/\s/.test(command[cursor]))
+                cursor += 1;
+        }
+        if (cursor < command.length && !/\s/.test(command[cursor]))
+            return { envPrefix: '', command };
+        while (cursor < command.length && /\s/.test(command[cursor]))
+            cursor += 1;
+        prefixEnd = cursor;
+        index = cursor;
+    }
+    return { envPrefix: command.slice(0, prefixEnd), command: command.slice(prefixEnd) };
+}
+/**
+ * Whether a command (ignoring a leading assignment run) already invokes rtk.
+ *
+ * Rewriting an rtk command would produce `rtk rtk …`, and the guard also saves
+ * a process spawn on every already-optimized call.
+ */
+export function isAlreadyRtkCommand(command) {
+    const effective = splitLeadingEnvAssignments(command.trimStart()).command.trimStart();
+    return effective === 'rtk' || effective.startsWith('rtk ');
+}
+const RTK_HISTORY_ENV = 'RTK_DB_PATH';
+/// Matches a PowerShell environment assignment already present at the head.
+const PWSH_ASSIGNMENT = /^\$env:RTK_DB_PATH\s*=/;
+/**
+ * Prefix a command with an isolated `RTK_DB_PATH` so rtk's usage history lands
+ * in a scratch directory instead of the working tree.
+ *
+ * The two shells need different syntax: `export NAME='value'` is a syntax error
+ * in PowerShell, which spells the same thing `$env:NAME = 'value'`. Both the
+ * harness's `pwsh` tool and its `bash` tool are rewrite targets, so the caller
+ * passes the dialect rather than assuming one.
+ *
+ * The assignment is skipped when the command already sets it or the ambient
+ * environment provides one, so an explicit choice is never overridden.
+ *
+ * @param command - the rewritten command.
+ * @param historyDbPath - absolute path for this deployment's rtk history database.
+ * @param ambientValue - value currently in the environment, if any.
+ * @param shell - the dialect of the command being prefixed.
+ * @returns the command to run, prefixed only when isolation applies.
+ */
+export function applyRtkHistoryScope(command, historyDbPath, ambientValue, shell = 'posix') {
+    if (!command.trim() || !historyDbPath.trim())
+        return command;
+    if (ambientValue !== undefined && ambientValue.trim())
+        return command;
+    const trimmed = command.trimStart();
+    if (shell === 'powershell') {
+        if (PWSH_ASSIGNMENT.test(trimmed))
+            return command;
+        // PowerShell escapes a literal quote by doubling it.
+        return `$env:${RTK_HISTORY_ENV} = '${historyDbPath.replace(/'/g, "''")}'; ${command}`;
+    }
+    if (splitLeadingEnvAssignments(trimmed).envPrefix.includes(`${RTK_HISTORY_ENV}=`))
+        return command;
+    return `export ${RTK_HISTORY_ENV}='${historyDbPath.replace(/'/g, "'\\''")}'; ${command}`;
+}
+/**
+ * Ask the installed rtk binary how it would rewrite a command.
+ *
+ * rtk owns the rewrite rules; this plugin deliberately carries no duplicate
+ * table. The exit-code contract is rtk's:
+ *
+ * | code | meaning |
+ * |------|---------|
+ * | 0, 3 | stdout is the rewritten command |
+ * | 1    | no rtk equivalent — run the command unchanged |
+ * | 2    | rtk refused the rewrite; stderr explains why |
+ *
+ * A non-zero code is an ordinary outcome, never a rejection: the caller always
+ * has the original command to fall back on.
+ *
+ * @param command - the raw command the model asked to run.
+ * @param options - runner, executable, deadline, and caller cancellation.
+ * @returns the decision, including the fallback command when nothing changed.
+ */
+export async function resolveRtkRewrite(command, options) {
+    const unchanged = (exitCode, error) => ({
+        changed: false,
+        originalCommand: command,
+        rewrittenCommand: command,
+        exitCode,
+        ...(error === undefined ? {} : { error }),
+    });
+    if (!command || !command.trim())
+        return unchanged(1);
+    if (isAlreadyRtkCommand(command))
+        return unchanged(1);
+    let result;
+    try {
+        const runOptions = {};
+        if (options.timeoutMs !== undefined)
+            runOptions.timeoutMs = options.timeoutMs;
+        if (options.signal !== undefined)
+            runOptions.signal = options.signal;
+        result = await options.runner(options.executable, ['rewrite', command], runOptions);
+    }
+    catch (error) {
+        return unchanged(-1, error instanceof Error ? error.message : String(error));
+    }
+    if (result.code === 1)
+        return unchanged(1);
+    if (result.code === 2)
+        return unchanged(2, result.stderr.trim() || 'rtk refused the rewrite');
+    if (result.code === 0 || result.code === 3) {
+        const rewritten = result.stdout.trim();
+        if (!rewritten)
+            return unchanged(result.code, 'rtk returned empty output');
+        if (rewritten === command)
+            return unchanged(result.code);
+        return { changed: true, originalCommand: command, rewrittenCommand: rewritten, exitCode: result.code };
+    }
+    return unchanged(result.code, `unexpected rtk exit code ${result.code}`);
+}
+//# sourceMappingURL=rtk-rewrite.js.map

package/lib/rtk-rewrite.js.map

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

package/lib/runtime-guard.d.ts

@@ -0,0 +1,31 @@
+import type { RtkConfig } from './config.js';
+/** What the last probe found. */
+export interface RtkRuntimeStatus {
+    rtkAvailable: boolean;
+    lastCheckedAt?: number;
+    rtkExecutablePath?: string;
+    rtkExecutableCommand?: string;
+    rtkExecutableResolver?: string;
+    rtkExecutableResolutionWarning?: string;
+    lastError?: string;
+}
+/** How long a probe result stays authoritative before it is refreshed. */
+export declare const RUNTIME_STATUS_TTL_MS = 30000;
+/**
+ * Whether a missing rtk binary must be established before handling a command.
+ *
+ * Only rewrite mode consults availability: `suggest` mode reports what rtk
+ * *would* do and never gates execution on it, and compaction is a pure text
+ * transform that needs no binary at all.
+ */
+export declare function shouldRequireRtkAvailability(config: RtkConfig): boolean;
+/**
+ * Whether command rewriting must stand down for this call.
+ *
+ * With `guardWhenRtkMissing` on, a call that cannot prove rtk is available
+ * runs unchanged — the user's command is never blocked by an absent optimizer.
+ */
+export declare function shouldSkipRewrite(config: RtkConfig, status: RtkRuntimeStatus): boolean;
+/** Whether the cached probe is stale and must be refreshed before use. */
+export declare function isStatusStale(status: RtkRuntimeStatus, now: number, ttlMs?: number): boolean;
+//# sourceMappingURL=runtime-guard.d.ts.map

package/lib/runtime-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guard.d.ts","sourceRoot":"","sources":["../src/runtime-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,8BAA8B,CAAC,EAAE,MAAM,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAItF;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,SAAwB,GAAG,OAAO,CAG3G"}

package/lib/runtime-guard.js

@@ -0,0 +1,32 @@
+/** How long a probe result stays authoritative before it is refreshed. */
+export const RUNTIME_STATUS_TTL_MS = 30_000;
+/**
+ * Whether a missing rtk binary must be established before handling a command.
+ *
+ * Only rewrite mode consults availability: `suggest` mode reports what rtk
+ * *would* do and never gates execution on it, and compaction is a pure text
+ * transform that needs no binary at all.
+ */
+export function shouldRequireRtkAvailability(config) {
+    return config.enabled && config.mode === 'rewrite';
+}
+/**
+ * Whether command rewriting must stand down for this call.
+ *
+ * With `guardWhenRtkMissing` on, a call that cannot prove rtk is available
+ * runs unchanged — the user's command is never blocked by an absent optimizer.
+ */
+export function shouldSkipRewrite(config, status) {
+    if (!config.enabled)
+        return true;
+    if (!config.guardWhenRtkMissing)
+        return false;
+    return !status.rtkAvailable;
+}
+/** Whether the cached probe is stale and must be refreshed before use. */
+export function isStatusStale(status, now, ttlMs = RUNTIME_STATUS_TTL_MS) {
+    if (status.lastCheckedAt === undefined)
+        return true;
+    return now - status.lastCheckedAt > ttlMs;
+}
+//# sourceMappingURL=runtime-guard.js.map

package/lib/runtime-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-guard.js","sourceRoot":"","sources":["../src/runtime-guard.ts"],"names":[],"mappings":"AAaA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAAA;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAwB;IAC3E,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAChC,IAAI,CAAC,MAAM,CAAC,mBAAmB;QAAE,OAAO,KAAK,CAAA;IAC7C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAA;AAC7B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,MAAwB,EAAE,GAAW,EAAE,KAAK,GAAG,qBAAqB;IAChG,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACnD,OAAO,GAAG,GAAG,MAAM,CAAC,aAAa,GAAG,KAAK,CAAA;AAC3C,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@wingsbutterfly/dsh-rtk",
+  "version": "0.1.0",
+  "description": "RTK command rewriting and tool-output compaction for the DeepSeek Harness: rewrites bash commands to their rtk equivalents and compacts noisy tool output before it reaches the model.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "docs",
+    "scripts/link-dsh.mjs",
+    "README.md",
+    "README.zh.md",
+    "CHANGELOG.md",
+    "THIRD_PARTY_NOTICES.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "author": "wings1848",
+  "homepage": "https://github.com/wings1848/dsh-rtk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wings1848/dsh-rtk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wings1848/dsh-rtk/issues"
+  },
+  "keywords": [
+    "deepseek",
+    "harness",
+    "dsh",
+    "dsh-plugin",
+    "rtk",
+    "token-optimization",
+    "output-compaction",
+    "command-rewrite"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "packageManager": "pnpm@12.3.4",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "link-dsh": "node scripts/link-dsh.mjs",
+    "test": "node --run build && node scripts/link-dsh.mjs && node --test test/*.test.ts",
+    "check": "node --run typecheck && node --run test",
+    "prepack": "node --run build"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

package/scripts/link-dsh.mjs

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+/**
+ * Point the harness packages this plugin links against at the *running* DSH
+ * installation.
+ *
+ * Why this exists: `@deepseek-ai/dsh-*` are peer dependencies, and the harness
+ * supplies them at plugin load time from its own install. If npm also materializes
+ * private copies under this package's `node_modules`, the plugin would build tool
+ * definitions (or read settings) through a *different* instance than the runtime
+ * that owns them — a class-identity mismatch that fails confusingly, or silently
+ * drifts a release behind (`0.1.5-rc.2` on the registry versus the `0.1.5-rc.1`
+ * this harness is actually running).
+ *
+ * So: symlink the peer packages into `node_modules` from the harness install, and
+ * let every other dependency resolve normally. Run by the `test` script, and on demand via `pnpm run link-dsh`.
+ *
+ * Every peer is located independently. They are siblings under a global bun
+ * install, but under pnpm each one lives in its own `node_modules/.pnpm/<pkg>@<ver>`
+ * directory — assuming a shared root finds the first package and misses the rest.
+ *
+ * Usage: node scripts/link-dsh.mjs [--check]
+ */
+
+import { existsSync, lstatSync, mkdirSync, readlinkSync, rmSync, symlinkSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/** Harness packages this plugin imports at runtime. */
+const PEER_PACKAGES = [
+  '@deepseek-ai/cordis',
+  '@deepseek-ai/dsh-tools',
+  '@deepseek-ai/dsh-llm',
+  '@deepseek-ai/dsh-commands',
+  '@deepseek-ai/dsh-settings',
+  '@deepseek-ai/dsh-system-prompt',
+  '@deepseek-ai/schemastery',
+]
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const checkOnly = process.argv.includes('--check')
+
+/** Candidate roots for a global DSH installation, most specific first. */
+function installRoots() {
+  const roots = []
+  if (process.env['DSH_INSTALL_ROOT'] !== undefined) roots.push(process.env['DSH_INSTALL_ROOT'])
+  if (process.env['BUN_INSTALL'] !== undefined) {
+    roots.push(join(process.env['BUN_INSTALL'], 'install', 'global', 'node_modules'))
+  }
+  roots.push(join(process.env['HOME'] ?? '', '.bun', 'install', 'global', 'node_modules'))
+  return roots.filter(root => root !== '')
+}
+
+/**
+ * Locate one peer package's directory.
+ *
+ * Tries the global install roots first, then falls back to whatever this
+ * process can resolve — which covers a profile-local install, and a CI checkout
+ * where the only copies are the registry ones pnpm installed. Resolution is per
+ * package because pnpm does not place them side by side.
+ *
+ * @param name - The package name to locate.
+ * @returns Its directory, or undefined when nothing provides it.
+ */
+function findPeer(name) {
+  for (const root of installRoots()) {
+    const candidate = join(root, name)
+    if (existsSync(join(candidate, 'package.json'))) return candidate
+  }
+  try {
+    const require = createRequire(join(packageRoot, 'package.json'))
+    return dirname(require.resolve(`${name}/package.json`))
+  } catch {
+    return undefined
+  }
+}
+
+let linked = 0
+let alreadyCorrect = 0
+const problems = []
+const sources = new Set()
+
+for (const name of PEER_PACKAGES) {
+  const target = findPeer(name)
+  if (target === undefined) {
+    problems.push(`${name}: no installation provides it`)
+    continue
+  }
+  sources.add(dirname(target))
+
+  const link = join(packageRoot, 'node_modules', name)
+  if (existsSync(link) || isSymlink(link)) {
+    if (isSymlink(link) && readlinkSync(link) === target) {
+      alreadyCorrect += 1
+      continue
+    }
+    if (checkOnly) {
+      problems.push(`${name}: node_modules copy is not the harness instance`)
+      continue
+    }
+    rmSync(link, { recursive: true, force: true })
+  }
+
+  if (checkOnly) {
+    problems.push(`${name}: not linked`)
+    continue
+  }
+
+  mkdirSync(dirname(link), { recursive: true })
+  symlinkSync(target, link, 'dir')
+  linked += 1
+  console.log(`link-dsh: ${name} -> ${target}`)
+}
+
+if (problems.length > 0) {
+  for (const problem of problems) console.error(`link-dsh: ${problem}`)
+  // Without a harness there is nothing to link to, and the registry copies pnpm
+  // installed are a working substitute — which is what CI relies on. Only
+  // `--check` treats that as a failure.
+  if (checkOnly) process.exit(1)
+}
+
+if (!checkOnly) {
+  const where = sources.size === 1 ? [...sources][0] : `${sources.size} locations`
+  console.log(`link-dsh: ${linked} linked, ${alreadyCorrect} already correct (from ${where})`)
+}
+
+/** Whether a path is a symbolic link, broken or not. */
+function isSymlink(path) {
+  try {
+    return lstatSync(path).isSymbolicLink()
+  } catch {
+    return false
+  }
+}