Skip to content

armgit / Orkas

Public Imported from GitHub
0

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.

3.1 KB
Raw Blame
#!/usr/bin/env node
/**
 * Fail fast when node_modules has drifted from package-lock.json.
 *
 * This repository takes frequent parallel pushes, so a merge routinely advances
 * the lockfile while the working tree keeps whatever was installed earlier. The
 * resulting test failures are actively misleading: a stale SDK made
 * `provider_catalog` report that it could not resolve `claude-fable-5`, which
 * reads as a broken model catalog rather than an uninstalled dependency.
 *
 * Compare every locked package at its resolved location, including nested
 * copies. A security fix can advance a transitive package while its direct
 * parent stays unchanged. Read only the locked package manifests; do not
 * recursively walk node_modules or inspect package contents on test startup.
 */
import fs from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';

const HERE = path.dirname(fileURLToPath(import.meta.url));
export const DEFAULT_PC_ROOT = path.resolve(HERE, '..');

function readJson(file) {
  try {
    return JSON.parse(fs.readFileSync(file, 'utf8'));
  } catch {
    return null;
  }
}

/**
 * @returns {{ checked: number, drifted: Array<{name: string, expected: string, installed: string|null}> }}
 */
export function installedDependencyDrift(pcRoot = DEFAULT_PC_ROOT) {
  const pkg = readJson(path.join(pcRoot, 'package.json'));
  const lock = readJson(path.join(pcRoot, 'package-lock.json'));
  if (!pkg || !lock?.packages) return { checked: 0, drifted: [] };

  const drifted = [];
  let checked = 0;

  for (const [location, entry] of Object.entries(lock.packages)) {
    if (!location.startsWith('node_modules/') || entry.link) continue;
    const expected = entry?.version;
    if (!expected) continue;
    const manifest = path.join(pcRoot, location, 'package.json');
    // Foreign-platform optionals may be absent. If installed, they must still
    // match: optionality is not permission to run an outdated package.
    if (entry.optional && !fs.existsSync(manifest)) continue;
    const name = location.slice('node_modules/'.length);
    const installedPkg = readJson(manifest);
    // A missing package.json means the dependency is absent entirely, which is
    // as much drift as a version mismatch.
    const installed = installedPkg?.version ?? null;
    checked++;
    if (installed !== expected) drifted.push({ name, expected, installed });
  }

  return { checked, drifted };
}

export function formatDriftReport(drifted) {
  const lines = [
    '',
    'Installed dependencies do not match package-lock.json:',
    ...drifted.map(({ name, expected, installed }) => (
      `  ${name}: lockfile ${expected}, installed ${installed ?? '(missing)'}`
    )),
    '',
    'Run `npm install` before the tests. Skipping it produces failures that',
    'look like product bugs — a stale SDK reports missing models, a stale',
    'native addon reports an ABI error — instead of naming the real cause.',
    '',
  ];
  return lines.join('\n');
}

if (import.meta.url === `file://${process.argv[1]}`) {
  const { drifted } = installedDependencyDrift();
  if (drifted.length) {
    process.stderr.write(formatDriftReport(drifted));
    process.exit(1);
  }
}