@toddzheng024/dscode 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Todd Zheng
+
+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/cli.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { run } from './manager.mjs';
+const release = JSON.parse(readFileSync(new URL('./release.json', import.meta.url), 'utf8'));
+const args = process.argv.slice(2);
+if (args[0] === '--version') console.log(release.version);
+else if (args[0] === '--help' || args[0] === '-h') console.log(`DSCODE ${release.version}\n\n  dscode                         Start; first launch installs the Hub preset\n  dscode install [version]       Install an exact preset release\n  dscode update [version]        Upgrade (default: launcher release)\n  dscode history                 List retained preset revisions\n  dscode rollback [revision]     Restore a retained revision\n  dscode doctor                  Check the installed Hub profile\n  dscode --continue              Continue the previous session\n  dscode --resume SESSION_ID     Resume a session\n  dscode --cwd DIRECTORY         Work in a directory\n\nState: $DSCODE_HOME or ~/.local/share/dscode-hub\nModel credentials: configure /model in the TUI or set DEEPSEEK_API_KEY.`);
+else run(args, release).catch(error => { console.error(error.message); process.exitCode = 1; });

package/manager.mjs

@@ -0,0 +1,84 @@
+import { mkdirSync, readFileSync, existsSync, openSync, closeSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { createRequire } from 'node:module';
+import { spawn } from 'node:child_process';
+const require = createRequire(import.meta.url);
+export function stateHome(env = process.env) {
+  return resolve(env.DSCODE_HOME || join(homedir(), '.local/share/dscode-hub'));
+}
+export function acquireLock(home) {
+  mkdirSync(home, { recursive: true });
+  const path = join(home, '.launcher.lock');
+  for (let attempt = 0; attempt < 2; attempt++) {
+    try { const fd = openSync(path, 'wx', 0o600); writeFileSync(fd, String(process.pid)); closeSync(fd); return () => unlinkSync(path); }
+    catch (error) {
+      if (error.code !== 'EEXIST') throw error;
+      const pid = Number(readFileSync(path, 'utf8'));
+      if (!Number.isSafeInteger(pid) || pid <= 0) throw Error('Invalid DSCODE lock; inspect ' + path);
+      try { process.kill(pid, 0); }
+      catch (error) { if (error.code === 'ESRCH') { unlinkSync(path); continue; } throw error; }
+      throw Error(`DSCODE is already running (pid ${pid}). Exit it before launching or changing versions.`);
+    }
+  }
+  throw Error('Could not acquire DSCODE lock');
+}
+export function commandPlan(args, release, installed) {
+  const [command, ...rest] = args;
+  const flags = ['--profile', 'dscode'];
+  if (command === 'install' || command === 'update') {
+    if (rest.length > 1 || rest[0] && !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(rest[0])) throw Error('Usage: dscode install|update [exact-version]');
+    return { hub: ['profile', installed ? 'upgrade' : 'apply', release.slug, '--version', rest[0] ?? release.version, ...flags] };
+  }
+  if (command === 'rollback') {
+    if (rest.length > 1 || rest[0]?.startsWith('-')) throw Error('Usage: dscode rollback [revision]');
+    return { hub: ['profile', 'rollback', ...rest, ...flags] };
+  }
+  if (command === 'history' || command === 'doctor') {
+    if (rest.length) throw Error('Usage: dscode ' + command);
+    return { hub: ['profile', command, ...flags] };
+  }
+  return { launch: args, install: !installed };
+}
+export async function run(args, release) {
+  const home = stateHome();
+  const envFile = join(home, '.env');
+  if (existsSync(envFile)) process.loadEnvFile(envFile);
+  const hub = join(dirname(require.resolve('@dsh-plugin-hub/cli')), 'bin.js');
+  const pnpm = join(dirname(fileURLToPath(import.meta.url)), 'tools');
+  const env = { ...process.env, DSH_HOME: home, DSH_AGENTS_HOME: join(home, 'agents'), PATH: process.env.PATH };
+  const exec = (entry, argv, cwd = process.cwd()) => new Promise((resolvePromise, reject) => {
+    const child = spawn(process.execPath, [entry, ...argv], { env: entry === hub ? { ...env, PATH: pnpm + ':' + env.PATH, npm_config_ignore_scripts: 'true', DSH_HUB_MACHINE: '1' } : env, cwd, stdio: 'inherit' });
+    const forward = signal => child.kill(signal);
+    const handlers = ['SIGTERM','SIGHUP'].map(signal => { const handler = () => forward(signal); process.on(signal,handler); return [signal,handler]; });
+    const cleanup = () => handlers.forEach(([signal,handler]) => process.off(signal,handler));
+    child.once('error', error => { cleanup(); reject(error); });
+    child.once('exit', (code, signal) => { cleanup(); code === 0 ? resolvePromise() : reject(Error(`DSCODE process exited: ${signal ?? code}`)); });
+  });
+  const releaseLock = acquireLock(home);
+  try {
+    const profile = join(home, 'profiles/dscode');
+    const state = join(home, '.hub/installations/dscode/current.json');
+    const installed = existsSync(state) && existsSync(join(profile, 'package.json'));
+    if (!installed && existsSync(profile)) throw Error('Existing unmanaged/incomplete dscode profile; inspect ' + profile);
+    const plan = commandPlan(args, release, installed);
+    if (plan.hub) return await exec(hub, plan.hub);
+    if (plan.install) {
+      console.log(`Installing DSCODE ${release.version} from dshpluginhub.ai…`);
+      await exec(hub, ['profile','apply',release.slug,'--version',release.version,'--profile','dscode']);
+    }
+    const metadata = JSON.parse(readFileSync(join(profile,'node_modules',release.bundle,'package.json'),'utf8'));
+    if (metadata.name !== release.bundle) throw Error('Unexpected DSCODE bundle');
+    const dshPackage = join(profile, 'node_modules/@deepseek-ai/dsh/package.json');
+    const dsh = join(dirname(dshPackage),'lib/bin.js');
+    const overlays = ['mcp.local.yml','harness.local.yml'].flatMap(file => {
+      const path=join(home,'config',file); return existsSync(path) ? ['--patch',path] : [];
+    });
+    const launch = [...plan.launch];
+    let cwd = process.cwd();
+    const index = launch.indexOf('--cwd');
+    if(index >= 0) { if(!launch[index+1]) throw Error('--cwd requires a directory'); cwd=resolve(launch[index+1]); launch.splice(index,2); }
+    await exec(dsh, ['--profile','dscode',...overlays,...launch], cwd);
+  } finally { releaseLock(); }
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "author": "Todd Zheng",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qiz029/dscode.git"
+  },
+  "name": "@toddzheng024/dscode",
+  "description": "One-command launcher for the DSCODE Hub coding harness preset.",
+  "bin": {
+    "dscode": "./cli.mjs"
+  },
+  "files": [
+    "cli.mjs",
+    "manager.mjs",
+    "release.json",
+    "tools"
+  ],
+  "dependencies": {
+    "@dsh-plugin-hub/cli": "0.2.0",
+    "pnpm": "10.15.1"
+  }
+}

package/release.json

@@ -0,0 +1,6 @@
+{
+  "slug": "dscode",
+  "version": "0.1.0",
+  "runtime": "0.1.5-rc.1",
+  "bundle": "@toddzheng024/dscode-bundle"
+}

package/tools/npx

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+// Hub invokes npx for its exact DSH runner. npm exec rewrites PATH; include
+// pnpm explicitly in that same execution environment so global pnpm cannot win.
+import { spawn } from 'node:child_process';
+const [yes, spec, ...args] = process.argv.slice(2);
+if (yes !== '-y' || !/^@deepseek-ai\/dsh@\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(spec ?? '')) {
+  console.error('DSCODE installer received an unsupported runtime command.');process.exit(1);
+}
+const child = spawn('npm', ['exec','--yes','--ignore-scripts',`--package=${spec}`,'--package=pnpm@10.15.1','--','dsh',...args], {stdio:'inherit'});
+for (const signal of ['SIGTERM','SIGHUP']) process.on(signal,()=>child.kill(signal));
+child.on('error',error=>{console.error(error.message);process.exitCode=1;});
+child.on('exit',(code)=>{process.exitCode=code??1;});

package/tools/pnpm

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const require = createRequire(import.meta.url);
+await import(pathToFileURL(join(dirname(require.resolve('pnpm')), 'bin/pnpm.cjs')).href);