jishushell 0.6.5 → 0.7.3

package/node_modules/which/README.md

@@ -1,54 +0,0 @@
-# which
-
-Like the unix `which` utility.
-
-Finds the first instance of a specified executable in the PATH
-environment variable.  Does not cache the results, so `hash -r` is not
-needed when the PATH changes.
-
-## USAGE
-
-```javascript
-var which = require('which')
-
-// async usage
-which('node', function (er, resolvedPath) {
-  // er is returned if no "node" is found on the PATH
-  // if it is found, then the absolute path to the exec is returned
-})
-
-// or promise
-which('node').then(resolvedPath => { ... }).catch(er => { ... not found ... })
-
-// sync usage
-// throws if not found
-var resolved = which.sync('node')
-
-// if nothrow option is used, returns null if not found
-resolved = which.sync('node', {nothrow: true})
-
-// Pass options to override the PATH and PATHEXT environment vars.
-which('node', { path: someOtherPath }, function (er, resolved) {
-  if (er)
-    throw er
-  console.log('found at %j', resolved)
-})
-```
-
-## CLI USAGE
-
-Same as the BSD `which(1)` binary.
-
-```
-usage: which [-as] program ...
-```
-
-## OPTIONS
-
-You may pass an options object as the second argument.
-
-- `path`: Use instead of the `PATH` environment variable.
-- `pathExt`: Use instead of the `PATHEXT` environment variable.
-- `all`: Return all matches, instead of just the first one.  Note that
-  this means the function returns an array of strings instead of a
-  single string.

package/node_modules/which/bin/node-which

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-var which = require("../")
-if (process.argv.length < 3)
-  usage()
-
-function usage () {
-  console.error('usage: which [-as] program ...')
-  process.exit(1)
-}
-
-var all = false
-var silent = false
-var dashdash = false
-var args = process.argv.slice(2).filter(function (arg) {
-  if (dashdash || !/^-/.test(arg))
-    return true
-
-  if (arg === '--') {
-    dashdash = true
-    return false
-  }
-
-  var flags = arg.substr(1).split('')
-  for (var f = 0; f < flags.length; f++) {
-    var flag = flags[f]
-    switch (flag) {
-      case 's':
-        silent = true
-        break
-      case 'a':
-        all = true
-        break
-      default:
-        console.error('which: illegal option -- ' + flag)
-        usage()
-    }
-  }
-  return false
-})
-
-process.exit(args.reduce(function (pv, current) {
-  try {
-    var f = which.sync(current, { all: all })
-    if (all)
-      f = f.join('\n')
-    if (!silent)
-      console.log(f)
-    return pv;
-  } catch (e) {
-    return 1;
-  }
-}, 0))

package/node_modules/which/package.json

@@ -1,43 +0,0 @@
-{
-  "author": "Isaac Z. Schlueter <i@izs.me> (http://blog.izs.me)",
-  "name": "which",
-  "description": "Like which(1) unix command. Find the first instance of an executable in the PATH.",
-  "version": "2.0.2",
-  "repository": {
-    "type": "git",
-    "url": "git://github.com/isaacs/node-which.git"
-  },
-  "main": "which.js",
-  "bin": {
-    "node-which": "./bin/node-which"
-  },
-  "license": "ISC",
-  "dependencies": {
-    "isexe": "^2.0.0"
-  },
-  "devDependencies": {
-    "mkdirp": "^0.5.0",
-    "rimraf": "^2.6.2",
-    "tap": "^14.6.9"
-  },
-  "scripts": {
-    "test": "tap",
-    "preversion": "npm test",
-    "postversion": "npm publish",
-    "prepublish": "npm run changelog",
-    "prechangelog": "bash gen-changelog.sh",
-    "changelog": "git add CHANGELOG.md",
-    "postchangelog": "git commit -m 'update changelog - '${npm_package_version}",
-    "postpublish": "git push origin --follow-tags"
-  },
-  "files": [
-    "which.js",
-    "bin/node-which"
-  ],
-  "tap": {
-    "check-coverage": true
-  },
-  "engines": {
-    "node": ">= 8"
-  }
-}

package/node_modules/which/which.js

@@ -1,125 +0,0 @@
-const isWindows = process.platform === 'win32' ||
-    process.env.OSTYPE === 'cygwin' ||
-    process.env.OSTYPE === 'msys'
-
-const path = require('path')
-const COLON = isWindows ? ';' : ':'
-const isexe = require('isexe')
-
-const getNotFoundError = (cmd) =>
-  Object.assign(new Error(`not found: ${cmd}`), { code: 'ENOENT' })
-
-const getPathInfo = (cmd, opt) => {
-  const colon = opt.colon || COLON
-
-  // If it has a slash, then we don't bother searching the pathenv.
-  // just check the file itself, and that's it.
-  const pathEnv = cmd.match(/\//) || isWindows && cmd.match(/\\/) ? ['']
-    : (
-      [
-        // windows always checks the cwd first
-        ...(isWindows ? [process.cwd()] : []),
-        ...(opt.path || process.env.PATH ||
-          /* istanbul ignore next: very unusual */ '').split(colon),
-      ]
-    )
-  const pathExtExe = isWindows
-    ? opt.pathExt || process.env.PATHEXT || '.EXE;.CMD;.BAT;.COM'
-    : ''
-  const pathExt = isWindows ? pathExtExe.split(colon) : ['']
-
-  if (isWindows) {
-    if (cmd.indexOf('.') !== -1 && pathExt[0] !== '')
-      pathExt.unshift('')
-  }
-
-  return {
-    pathEnv,
-    pathExt,
-    pathExtExe,
-  }
-}
-
-const which = (cmd, opt, cb) => {
-  if (typeof opt === 'function') {
-    cb = opt
-    opt = {}
-  }
-  if (!opt)
-    opt = {}
-
-  const { pathEnv, pathExt, pathExtExe } = getPathInfo(cmd, opt)
-  const found = []
-
-  const step = i => new Promise((resolve, reject) => {
-    if (i === pathEnv.length)
-      return opt.all && found.length ? resolve(found)
-        : reject(getNotFoundError(cmd))
-
-    const ppRaw = pathEnv[i]
-    const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw
-
-    const pCmd = path.join(pathPart, cmd)
-    const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd
-      : pCmd
-
-    resolve(subStep(p, i, 0))
-  })
-
-  const subStep = (p, i, ii) => new Promise((resolve, reject) => {
-    if (ii === pathExt.length)
-      return resolve(step(i + 1))
-    const ext = pathExt[ii]
-    isexe(p + ext, { pathExt: pathExtExe }, (er, is) => {
-      if (!er && is) {
-        if (opt.all)
-          found.push(p + ext)
-        else
-          return resolve(p + ext)
-      }
-      return resolve(subStep(p, i, ii + 1))
-    })
-  })
-
-  return cb ? step(0).then(res => cb(null, res), cb) : step(0)
-}
-
-const whichSync = (cmd, opt) => {
-  opt = opt || {}
-
-  const { pathEnv, pathExt, pathExtExe } = getPathInfo(cmd, opt)
-  const found = []
-
-  for (let i = 0; i < pathEnv.length; i ++) {
-    const ppRaw = pathEnv[i]
-    const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw
-
-    const pCmd = path.join(pathPart, cmd)
-    const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd
-      : pCmd
-
-    for (let j = 0; j < pathExt.length; j ++) {
-      const cur = p + pathExt[j]
-      try {
-        const is = isexe.sync(cur, { pathExt: pathExtExe })
-        if (is) {
-          if (opt.all)
-            found.push(cur)
-          else
-            return cur
-        }
-      } catch (ex) {}
-    }
-  }
-
-  if (opt.all && found.length)
-    return found
-
-  if (opt.nothrow)
-    return null
-
-  throw getNotFoundError(cmd)
-}
-
-module.exports = which
-which.sync = whichSync

package/scripts/check-adapter-isolation.ts

@@ -1,293 +0,0 @@
-#!/usr/bin/env -S node --experimental-strip-types
-/**
- * check-adapter-isolation — §32.2.1 static enforcement + §30.3 fixtures.
- *
- * Two invariants:
- *
- *   1. Core framework files never import from
- *      `src/services/runtime/adapters/*`. Adapters load exclusively through
- *      `src/services/runtime/index.ts` side-effect imports, and framework
- *      code reaches adapters through `getAdapter(kind)` only.
- *
- *   2. Fixture `instance.json` samples under
- *      `scripts/fixtures/instances/<name>/` satisfy the minimum meta
- *      contract: `id`, `name`, resolvable agent discriminator, and
- *      (for Hermes) the required `paths.agentHome` / `paths.primaryConfig`
- *      / `paths.secretEnv` entries. Legacy openclaw samples round-trip
- *      through `backfillInstanceMeta` to `agentType="openclaw"`.
- *
- * Run via `npm run check:contracts`. Exits non-zero on violation.
- */
-
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-
-const REPO_ROOT = resolve(import.meta.dirname ?? ".", "..");
-
-/**
- * Files that must not import any specific adapter directly. Matches the
- * list in docs/multi-agent-runtime-generalization-plan.md §32.2.1.
- */
-const CORE_FILES = [
-  "src/services/instance-manager.ts",
-  "src/services/nomad-manager.ts",
-  "src/services/setup-manager.ts",
-  "src/services/backup-manager.ts",
-  "src/services/llm-proxy/index.ts",
-  "src/routes/instances.ts",
-  "src/routes/setup.ts",
-  "src/server.ts",
-] as const;
-
-/**
- * Regexes for forbidden adapter imports. Covers both static imports and
- * dynamic `import()`. Note: we deliberately allow references to the
- * registry / runtime/index (`./runtime/index.js`, `./runtime/registry.js`,
- * `./runtime/types.js`, `./runtime/instance.js`) because those contain
- * the framework surface, not adapter-specific logic.
- */
-const FORBIDDEN_IMPORT_PATTERNS = [
-  /from\s+["'][^"']*\/runtime\/adapters\/[^"']+["']/g,
-  /import\s*\(\s*["'][^"']*\/runtime\/adapters\/[^"']+["']\s*\)/g,
-];
-
-/**
- * Literal strings that indicate kind-specific bleed-through into
- * framework files. These are advisory only for now: existing OpenClaw
- * legacy code may still contain OPENCLAW_HOME env references etc. We log
- * them but don't fail the build — the physical migration cleans them up
- * in a follow-up PR. When MIGRATION_STRICT=1 is set, they become errors.
- */
-const KIND_LITERAL_PATTERNS: Array<{ pattern: RegExp; description: string }> = [
-  {
-    pattern: /JOB_PREFIX\s*=\s*["']openclaw-/,
-    description: `JOB_PREFIX literal "openclaw-" — §32.2.7 wants panel.nomadJobPrefix`,
-  },
-  {
-    pattern: /OPENCLAW_HOME|OPENCLAW_INSTANCE_ID|OPENCLAW_GATEWAY_PORT/,
-    description: `OpenClaw-specific env var literal — should live in OpenClawAdapter`,
-  },
-  {
-    pattern: /isHermesInstance\s*\(/,
-    description: `isHermesInstance() — runtime-specific branch, should dispatch via getAdapter`,
-  },
-  {
-    pattern: /agentType\s*===\s*["']hermes["']|agentType\s*===\s*["']openclaw["']/,
-    description: `agentType literal comparison — dispatch through adapter instead`,
-  },
-];
-
-const STRICT = process.env.MIGRATION_STRICT === "1";
-
-type Violation = {
-  file: string;
-  line: number;
-  column: number;
-  text: string;
-  rule: string;
-};
-
-function isCommentLine(lineText: string): boolean {
-  const t = lineText.trimStart();
-  return t.startsWith("//") || t.startsWith("*") || t.startsWith("/*");
-}
-
-function findViolations(filepath: string, content: string): Violation[] {
-  const violations: Violation[] = [];
-
-  // 1. Forbidden adapter imports (HARD errors)
-  for (const pattern of FORBIDDEN_IMPORT_PATTERNS) {
-    let match: RegExpExecArray | null;
-    const re = new RegExp(pattern.source, "g");
-    while ((match = re.exec(content)) !== null) {
-      const before = content.slice(0, match.index);
-      const line = before.split("\n").length;
-      const column = match.index - before.lastIndexOf("\n");
-      violations.push({
-        file: filepath,
-        line,
-        column,
-        text: match[0],
-        rule: "adapter-import-forbidden",
-      });
-    }
-  }
-
-  // 2. Kind-specific literals (SOFT warnings unless MIGRATION_STRICT=1).
-  //    Comment lines are skipped — references in docstrings or `§32`
-  //    migration notes are not actual code bleed-through.
-  if (STRICT) {
-    const lines = content.split("\n");
-    for (let i = 0; i < lines.length; i++) {
-      const lineText = lines[i];
-      if (isCommentLine(lineText)) continue;
-      for (const { pattern, description } of KIND_LITERAL_PATTERNS) {
-        if (pattern.test(lineText)) {
-          violations.push({
-            file: filepath,
-            line: i + 1,
-            column: 1,
-            text: lineText.trim().slice(0, 120),
-            rule: `kind-literal: ${description}`,
-          });
-        }
-      }
-    }
-  }
-
-  return violations;
-}
-
-// ── Fixture schema checks (plan §30.3) ───────────────────────────────
-//
-// Keep the schema rules inline: we only validate a handful of fields and
-// pulling in ajv for a single static script adds disproportionate churn.
-// The check mirrors the runtime contract in `runtime/migrations.ts`:
-//   - every meta must carry `id` / `name`
-//   - `agentType` resolves (missing → defaults to "openclaw")
-//   - Hermes fixtures must declare `paths.agentHome` + `paths.primaryConfig`
-//   - legacy openclaw fixtures must backfill to `agentType === "openclaw"`
-
-type FixtureViolation = { fixture: string; rule: string; detail: string };
-
-function resolveFixtureAgentType(meta: Record<string, unknown>): string {
-  const raw = typeof meta.agentType === "string" ? meta.agentType : "";
-  return raw.trim() ? raw.trim() : "openclaw";
-}
-
-function checkFixture(fixtureName: string, meta: Record<string, unknown>): FixtureViolation[] {
-  const out: FixtureViolation[] = [];
-  const agentType = resolveFixtureAgentType(meta);
-  if (typeof meta.id !== "string" || !meta.id) {
-    out.push({ fixture: fixtureName, rule: "missing-id", detail: "instance.json must carry a non-empty string id" });
-  }
-  if (typeof meta.name !== "string" || !meta.name) {
-    out.push({ fixture: fixtureName, rule: "missing-name", detail: "instance.json must carry a non-empty string name" });
-  }
-  if (agentType === "hermes") {
-    const paths = (meta.paths ?? {}) as Record<string, unknown>;
-    for (const key of ["agentHome", "primaryConfig", "secretEnv"] as const) {
-      if (typeof paths[key] !== "string" || !paths[key]) {
-        out.push({
-          fixture: fixtureName,
-          rule: `hermes-paths-${key}`,
-          detail: `hermes instance.json requires paths.${key}`,
-        });
-      }
-    }
-  }
-  if (fixtureName.startsWith("legacy-openclaw") && agentType !== "openclaw") {
-    out.push({
-      fixture: fixtureName,
-      rule: "legacy-backfill",
-      detail: `legacy fixture must backfill to agentType="openclaw", got "${agentType}"`,
-    });
-  }
-  return out;
-}
-
-function loadFixtures(): FixtureViolation[] {
-  const fixturesRoot = resolve(REPO_ROOT, "scripts/fixtures/instances");
-  let entries: string[];
-  try {
-    entries = readdirSync(fixturesRoot);
-  } catch {
-    return []; // directory optional during early migrations
-  }
-  const violations: FixtureViolation[] = [];
-  for (const entry of entries) {
-    const fullPath = resolve(fixturesRoot, entry);
-    try {
-      if (!statSync(fullPath).isDirectory()) continue;
-    } catch {
-      continue;
-    }
-    const metaPath = resolve(fullPath, "instance.json");
-    let raw: string;
-    try {
-      raw = readFileSync(metaPath, "utf-8");
-    } catch {
-      violations.push({ fixture: entry, rule: "missing-instance-json", detail: metaPath });
-      continue;
-    }
-    try {
-      const meta = JSON.parse(raw) as Record<string, unknown>;
-      violations.push(...checkFixture(entry, meta));
-    } catch (e: any) {
-      violations.push({ fixture: entry, rule: "invalid-json", detail: e?.message ?? String(e) });
-    }
-  }
-  return violations;
-}
-
-function main(): void {
-  const allViolations: Violation[] = [];
-  const softFindings: Array<{ file: string; line: number; text: string; description: string }> = [];
-
-  for (const relPath of CORE_FILES) {
-    const abs = resolve(REPO_ROOT, relPath);
-    let content: string;
-    try {
-      content = readFileSync(abs, "utf-8");
-    } catch {
-      console.warn(`[check-adapter-isolation] skip (not found): ${relPath}`);
-      continue;
-    }
-    allViolations.push(...findViolations(relPath, content));
-
-    // Collect soft findings separately so non-strict runs can still report them.
-    if (!STRICT) {
-      const lines = content.split("\n");
-      for (let i = 0; i < lines.length; i++) {
-        const lineText = lines[i];
-        if (isCommentLine(lineText)) continue;
-        for (const { pattern, description } of KIND_LITERAL_PATTERNS) {
-          if (pattern.test(lineText)) {
-            softFindings.push({
-              file: relPath,
-              line: i + 1,
-              text: lineText.trim().slice(0, 120),
-              description,
-            });
-          }
-        }
-      }
-    }
-  }
-
-  const fixtureViolations = loadFixtures();
-
-  if (allViolations.length === 0 && softFindings.length === 0 && fixtureViolations.length === 0) {
-    console.log("[check-adapter-isolation] OK — core files are fully decoupled from specific adapters");
-    process.exit(0);
-  }
-
-  if (allViolations.length > 0) {
-    console.error(`\n[check-adapter-isolation] ${allViolations.length} HARD violation(s):\n`);
-    for (const v of allViolations) {
-      console.error(`  ${v.file}:${v.line}:${v.column}  [${v.rule}]`);
-      console.error(`    ${v.text}`);
-    }
-  }
-
-  if (fixtureViolations.length > 0) {
-    console.error(`\n[check-adapter-isolation] ${fixtureViolations.length} fixture violation(s):\n`);
-    for (const v of fixtureViolations) {
-      console.error(`  fixtures/${v.fixture}  [${v.rule}] ${v.detail}`);
-    }
-  }
-
-  if (softFindings.length > 0) {
-    console.warn(
-      `\n[check-adapter-isolation] ${softFindings.length} soft finding(s) (remaining framework bleed-through — migrate in follow-up PRs; run with MIGRATION_STRICT=1 to fail on these):\n`,
-    );
-    for (const f of softFindings) {
-      console.warn(`  ${f.file}:${f.line}  ${f.description}`);
-      console.warn(`    ${f.text}`);
-    }
-  }
-
-  process.exit(allViolations.length > 0 || fixtureViolations.length > 0 ? 1 : 0);
-}
-
-main();