@linzumi/cli 1.0.275 → 1.0.276

package/scripts/build-differential-entry-impl-res.mjs

@@ -1,64 +0,0 @@
-// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md (M3 cluster 15)
-// Relationship: Builds the ReScript-impl differential entry
-// (packages/linzumi-cli-rescript/src/entry/CommanderDifferentialMain.res,
-// compiled by `rescript` to .res.mjs) into a single runnable bundle at
-// .differential/impl-res.mjs - the peer of scripts/build-differential-entry.mjs's
-// impl-ts bundle, with the SAME platform/target/format/externals/banner so the
-// differential harness compares the two impls under one bundling reality.
-//
-// Version injection: the ReScript package ships no version literal (repo
-// rule); the CLI version is esbuild-`define`d into the bundle as
-// process.env.LINZUMI_CLI_VERSION (read via CommanderEntryVersion.res), so the
-// hello `version` equals the TS impl's linzumiCliVersion (== package.json
-// version) and the min-version refusal transcripts stay byte-identical.
-//
-// FAIL LOUDLY when the compiled ReScript artifacts are missing: the
-// differential harness must never silently fall back to a stub.
-import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { build } from 'esbuild';
-
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-
-const entryPoint = join(
-  packageRoot,
-  '../linzumi-cli-rescript/src/entry/CommanderDifferentialMain.res.mjs'
-);
-
-if (!existsSync(entryPoint)) {
-  console.error(
-    `impl-res differential entry artifact missing: ${entryPoint}\n` +
-      'run `pnpm build` in packages/linzumi-cli-rescript first (rescript compiles src/**.res -> .res.mjs in-source)'
-  );
-  process.exit(1);
-}
-
-const packageJson = JSON.parse(
-  await readFile(join(packageRoot, 'package.json'), 'utf8')
-);
-
-// Renamed banner import, mirroring scripts/build-differential-entry.mjs: this
-// bundle keeps source-level identifiers and the sources may import
-// createRequire themselves - the published banner's bare name would collide.
-const banner = {
-  js: "import { createRequire as __differentialCreateRequire } from 'node:module';\nconst require = __differentialCreateRequire(import.meta.url);",
-};
-
-await build({
-  entryPoints: [entryPoint],
-  bundle: true,
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile: join(packageRoot, '.differential/impl-res.mjs'),
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
-  banner,
-  define: {
-    'process.env.LINZUMI_CLI_VERSION': JSON.stringify(packageJson.version),
-  },
-});

package/scripts/build-differential-entry.mjs

@@ -1,180 +0,0 @@
-// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md (M2.5 + M2.6)
-// Relationship: Builds the TS-impl differential entry
-// (src/differentialCommanderEntry.ts) into a single runnable bundle at
-// .differential/impl-ts.mjs, mirroring the published dist/index.js build
-// configuration (same platform/target/format/externals/banner) so the
-// differential harness exercises the SAME bundling reality the shipped CLI
-// has - this is the M3 packaging seam's dist/impl-ts precursor: the M3
-// chooser design ships dist/impl-ts/ + dist/impl-res/ side by side, and the
-// M2.5 differential runner's impl parameter selects between them (the
-// impl-res twin is scripts/build-differential-entry-impl-res.mjs).
-//
-// M2.6 mutation mode (`--mutation <name>`): applies ONE seeded behavior
-// delta from scripts/differentialMutations.mjs as a build-time source patch
-// and emits .differential/impl-ts.mutant-<name>.mjs instead. The harness's
-// anti-false-green mutation check builds each mutant and asserts the
-// differential suite goes RED on it. Every patch anchor must match the
-// current source EXACTLY ONCE - zero or multiple matches fail the build
-// loudly, so a commander refactor can never silently no-op a mutation.
-//
-// Unminified deliberately: the bundle is a local test artifact
-// (.differential/ is gitignored, never published), and readable output makes
-// differential findings debuggable.
-import { copyFile, mkdir, readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { build } from 'esbuild';
-import { differentialMutations } from './differentialMutations.mjs';
-
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-
-function parseArgs(argv) {
-  if (argv.length === 0) {
-    return { mutation: undefined };
-  }
-  if (argv[0] === '--mutation' && argv.length === 2) {
-    const mutation = differentialMutations.find(
-      (entry) => entry.name === argv[1]
-    );
-    if (mutation === undefined) {
-      const known = differentialMutations.map((entry) => entry.name);
-      throw new Error(
-        `unknown differential mutation ${JSON.stringify(argv[1])}; known mutations: ${known.join(', ')}`
-      );
-    }
-    return { mutation };
-  }
-  throw new Error(
-    'usage: node scripts/build-differential-entry.mjs [--mutation <name>]'
-  );
-}
-
-const { mutation } = parseArgs(process.argv.slice(2));
-
-// Count non-overlapping occurrences of `needle` in `haystack`. An empty
-// needle is a registry authoring error, refused loudly (indexOf('') matches
-// at every position, which would both loop forever here and make the
-// exactly-once rule meaningless); the harness registry conformance pins the
-// same rule at rest (Greptile finding on #3115).
-function occurrences(haystack, needle) {
-  if (needle.length === 0) {
-    throw new Error('mutation patch `find` must be a non-empty string');
-  }
-  let count = 0;
-  let from = 0;
-  for (;;) {
-    const at = haystack.indexOf(needle, from);
-    if (at === -1) {
-      return count;
-    }
-    count += 1;
-    from = at + needle.length;
-  }
-}
-
-// esbuild onLoad plugin: apply the mutation's patches to their target
-// sources, enforcing the exactly-once anchor rule per patch. Also asserts
-// every patch was actually loaded by the bundle (a patched-but-unbundled
-// file would be a silent no-op mutation).
-function mutationPlugin(activeMutation) {
-  const patchesByFile = new Map();
-  for (const patch of activeMutation.patches) {
-    const absolute = join(packageRoot, patch.file);
-    const existing = patchesByFile.get(absolute) ?? [];
-    existing.push(patch);
-    patchesByFile.set(absolute, existing);
-  }
-  const applied = new Set();
-
-  return {
-    plugin: {
-      name: 'differential-mutation',
-      setup(pluginBuild) {
-        pluginBuild.onLoad({ filter: /\.ts$/ }, async (args) => {
-          const patches = patchesByFile.get(args.path);
-          if (patches === undefined) {
-            return undefined;
-          }
-          let contents = await readFile(args.path, 'utf8');
-          for (const patch of patches) {
-            const found = occurrences(contents, patch.find);
-            if (found !== 1) {
-              throw new Error(
-                `mutation ${activeMutation.name}: anchor in ${patch.file} matched ${found} times (must match exactly once); the commander source moved - re-anchor the patch in scripts/differentialMutations.mjs`
-              );
-            }
-            contents = contents.replace(patch.find, patch.replace);
-            applied.add(`${patch.file}:${patch.find.slice(0, 40)}`);
-          }
-          return { contents, loader: 'ts' };
-        });
-      },
-    },
-    assertAllApplied() {
-      const expected = activeMutation.patches.length;
-      if (applied.size !== expected) {
-        throw new Error(
-          `mutation ${activeMutation.name}: only ${applied.size} of ${expected} patches were loaded into the bundle - a patched file is not part of the differential entry`
-        );
-      }
-    },
-  };
-}
-
-// Renamed banner import: unlike the minified dist build, this bundle keeps
-// source-level identifiers, and the commander sources themselves import
-// createRequire - the published banner's bare name would collide.
-const banner = {
-  js: "import { createRequire as __differentialCreateRequire } from 'node:module';\nconst require = __differentialCreateRequire(import.meta.url);",
-};
-
-const outfile =
-  mutation === undefined
-    ? join(packageRoot, '.differential/impl-ts.mjs')
-    : join(packageRoot, `.differential/impl-ts.mutant-${mutation.name}.mjs`);
-
-const mutationHooks =
-  mutation === undefined ? undefined : mutationPlugin(mutation);
-
-await build({
-  entryPoints: [join(packageRoot, 'src/differentialCommanderEntry.ts')],
-  bundle: true,
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile,
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
-  banner,
-  plugins: mutationHooks === undefined ? [] : [mutationHooks.plugin],
-});
-
-mutationHooks?.assertAllApplied();
-
-// The runtime resolves assets/ relative to the bundle (same as dist/).
-await mkdir(join(packageRoot, '.differential/assets'), { recursive: true });
-await copyFile(
-  join(packageRoot, 'src/assets/linzumi-logo.svg'),
-  join(packageRoot, '.differential/assets/linzumi-logo.svg')
-);
-
-// F5: the cross-harness failover bridge rides next to the bundle exactly as
-// it does in dist/ (the runner dynamic-imports ./crossHarnessFailover.mjs
-// relative to import.meta.url), bundled with the compiled ReScript
-// transpiler artifacts resolved at build time. Unlike the dist build there
-// is NO stub fallback here: the differential harness must exercise the REAL
-// transpile leg, so missing artifacts fail this build loudly.
-await build({
-  entryPoints: [join(packageRoot, 'src/crossHarnessFailover.mjs')],
-  bundle: true,
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile: join(packageRoot, '.differential/crossHarnessFailover.mjs'),
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  banner,
-});

package/scripts/build-onboarding-demo-evidence.mjs

@@ -1,186 +0,0 @@
-// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md
-// (M3 cluster 13, onboarding - visual evidence).
-// Relationship: Builds the TS TWIN of the onboarding demo entrypoint
-// (packages/linzumi-cli-rescript/src/onboarding/CommanderOnboardingDemoMain.res):
-// the REAL runSignupFlow mounted on the live terminal - real
-// @inquirer/prompts rendering, the real raw-keypress project picker, the
-// REAL createSignupServerClient speaking HTTP to the SAME in-process
-// ScriptedAuthServer (imported from the ReScript package's compiled
-// module - one server implementation, zero drift), replaying the SAME
-// commanderOnboardingDemoScenario.json. scripts/onboarding_evidence_
-// capture.sh drives both entrypoints with the same tmux key schedule and
-// byte-compares the captures.
-//
-// Determinism: the scenario is dummy data; the only wall-clock effects
-// (config-file timestamps) never reach the terminal (the demo runs with
-// debugLaunchPayload off unless --debug-signup is passed for ad-hoc use).
-import { mkdir, readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { build } from 'esbuild';
-
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-
-const driverSource = `
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { runSignupFlow, signupSuggestTasksForProjectForTest, signupPromptCancelMessage } from './src/signupFlow';
-import { createSignupServerClient } from './src/signupServerClient';
-// The ONE scripted-server implementation: the ReScript package's cluster 3
-// double, imported as plain ESM.
-import * as ScriptedAuthServer from '../linzumi-cli-rescript/src/parity/ScriptedAuthServer.res.mjs';
-
-const scenarioPath = join(
-  '${packageRoot}',
-  '..',
-  'linzumi-cli-rescript',
-  'src',
-  'onboarding',
-  'commanderOnboardingDemoScenario.json'
-);
-const scenario = JSON.parse(readFileSync(scenarioPath, 'utf8'));
-
-function reviveProjects(projects) {
-  return (projects ?? []).map((project) => ({
-    path: project.path,
-    language: project.language,
-    source: project.source,
-    ...(project.gitHead === undefined || project.gitHead === null
-      ? {}
-      : { gitHead: project.gitHead }),
-  }));
-}
-
-const jsonResponse = (value) =>
-  ScriptedAuthServer.jsonResponse(200, JSON.stringify(value ?? {}));
-
-async function main() {
-  const args = process.argv.slice(2);
-  const mock = args.includes('--mock');
-  const handle = await ScriptedAuthServer.start({
-    routes: [
-      {
-        method: 'POST',
-        path: '/api/v2/signup/email-code/start',
-        responses: [jsonResponse(scenario.server.emailCodeStart)],
-      },
-      {
-        method: 'POST',
-        path: '/api/v2/signup/email-code/verify',
-        responses: [jsonResponse(scenario.server.emailCodeVerify)],
-      },
-      {
-        method: 'POST',
-        path: '/api/v2/signup/mission-control/complete',
-        responses: [jsonResponse(scenario.server.missionControlComplete)],
-      },
-      {
-        method: 'POST',
-        path: '/api/v2/signup/mission-control/start-tasks',
-        responses: [jsonResponse(scenario.server.missionControlStartTasks)],
-      },
-    ],
-  });
-  const serviceUrl = handle.baseUrl;
-  const preflight = scenario.preflight ?? {};
-  const tools = preflight.tools ?? {};
-  const demoHome = process.env.LINZUMI_ONBOARDING_DEMO_HOME ?? process.env.HOME ?? '/tmp';
-  const noopCacheStore = { read: () => undefined, write: () => {} };
-  try {
-    await runSignupFlow({
-      // Real stdio: the prompts default to the REAL inquirer surface and
-      // the raw-keypress picker (deps.prompts stays undefined).
-      input: process.stdin,
-      output: process.stdout,
-      preflight: {
-        cwd: demoHome,
-        homeDir: demoHome,
-        probeTool: async (command) => {
-          const tool = tools[command];
-          if (tool === undefined) {
-            return { command, available: false };
-          }
-          return { command, available: tool.available, version: tool.version ?? undefined };
-        },
-        readGitEmail: async () => preflight.gitEmail ?? undefined,
-        discoverCodeRoots: async () => preflight.codeRoots ?? [],
-        checkBrowserHandoff: async () => preflight.browserHandoff !== false,
-      },
-      projectDiscovery: {
-        discoverProjects: async () => reviveProjects(scenario.projects),
-      },
-      taskSuggestion: {
-        suggestTasks: (project, output) =>
-          signupSuggestTasksForProjectForTest({
-            project,
-            output,
-            taskCacheStore: noopCacheStore,
-            codexTaskRunner: async () => scenario.suggestedTasks ?? [],
-          }),
-      },
-      forceSignup: args.includes('--force-signup'),
-      serviceUrl,
-      openBrowser: false,
-      debugLaunchPayload: args.includes('--debug-signup'),
-      signupServerClient: mock ? false : createSignupServerClient({ serviceUrl }),
-      commanderLauncher: async () => ({
-        status: 'started',
-        runnerId: scenario.launch?.runnerId ?? 'demo-commander',
-        restartCommand:
-          scenario.launch?.restartCommand ?? 'npx -y @linzumi/cli@latest connect',
-        instanceId: 'demo-instance',
-      }),
-    });
-    await handle.stop();
-    process.exit(0);
-  } catch (error) {
-    await handle.stop();
-    const message = error instanceof Error ? error.message : String(error);
-    process.stdout.write((signupPromptCancelMessage(error) ?? message) + '\\n');
-    process.exit(1);
-  }
-}
-
-main();
-`;
-
-await mkdir(join(packageRoot, '.differential'), { recursive: true });
-
-// The build-auth-parity-oracle.mjs banner convention (inquirer's CJS deps
-// require node builtins at module scope).
-const banner = {
-  js: "import { createRequire as __onboardingDemoCreateRequire } from 'node:module';\nconst require = __onboardingDemoCreateRequire(import.meta.url);",
-};
-
-await build({
-  banner,
-  stdin: {
-    contents: driverSource,
-    resolveDir: packageRoot,
-    sourcefile: 'onboarding-demo-evidence-driver.ts',
-    loader: 'ts',
-  },
-  bundle: true,
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile: join(packageRoot, '.differential/onboarding-demo-evidence.mjs'),
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
-});
-
-// Keep the scenario honest: fail the build loudly if the shared file is
-// missing (the twin reads it at RUNTIME from the sibling package).
-await readFile(
-  join(
-    packageRoot,
-    '..',
-    'linzumi-cli-rescript',
-    'src',
-    'onboarding',
-    'commanderOnboardingDemoScenario.json'
-  ),
-  'utf8'
-);

package/scripts/build-tui-demo-evidence.mjs

@@ -1,107 +0,0 @@
-// Spec: kandan/plans/2026-07-10-compute-nodes-rescript-commander-zero-ts-program.md
-// (M3 cluster 11, the TUI - visual evidence).
-// Relationship: Builds the TS-side VISUAL-EVIDENCE demo driver: a bundle
-// that mounts the REAL TS commander console TUI (reportRunnerConsoleEvent
-// on a live TTY) and replays the SAME dummy-event feed the ReScript demo
-// entrypoint replays
-// (packages/linzumi-cli-rescript/src/tui/commanderTuiDemoFeed.json), so
-// the cluster's before/after terminal captures compare the two
-// implementations on identical input.
-//
-// Run (inside a real terminal / tmux pane):
-//   node scripts/build-tui-demo-evidence.mjs
-//   LINZUMI_TUI_DEMO_FIXED_NOW=<ms> node .differential/tui-demo.mjs
-//
-// Env knobs (mirroring the ReScript demo):
-//   LINZUMI_TUI_DEMO_FIXED_NOW  pin Date.now() (and therefore every
-//                               time-ago cell + the render ticker clock)
-//                               so captures are deterministic.
-//
-// The output is a local evidence artifact (.differential/ is gitignored,
-// never published).
-import { mkdir } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { build } from 'esbuild';
-
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-
-const driverSource = `
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { reportRunnerConsoleEvent } from './src/runnerConsoleReporter';
-
-const fixedNowRaw = process.env.LINZUMI_TUI_DEMO_FIXED_NOW;
-const fixedNow = fixedNowRaw === undefined ? undefined : Number(fixedNowRaw);
-if (fixedNow !== undefined && Number.isFinite(fixedNow)) {
-  const RealDate = Date;
-  class FixedDate extends RealDate {
-    constructor(...args) {
-      if (args.length === 0) {
-        super(fixedNow);
-      } else {
-        super(...args);
-      }
-    }
-    static now() {
-      return fixedNow;
-    }
-  }
-  globalThis.Date = FixedDate;
-}
-
-const now = Date.now();
-
-// Resolve *_offset timestamp fields against the demo clock (the ReScript
-// demo performs the same resolution).
-function resolveOffsets(value) {
-  if (Array.isArray(value)) {
-    return value.map(resolveOffsets);
-  }
-  if (value !== null && typeof value === 'object') {
-    const out = {};
-    for (const [key, entry] of Object.entries(value)) {
-      if (key.endsWith('_offset') && typeof entry === 'number') {
-        out[key.slice(0, -'_offset'.length)] = now + entry;
-      } else {
-        out[key] = resolveOffsets(entry);
-      }
-    }
-    return out;
-  }
-  return value;
-}
-
-const feedPath = join(
-  process.cwd(),
-  '../linzumi-cli-rescript/src/tui/commanderTuiDemoFeed.json'
-);
-const feed = JSON.parse(readFileSync(feedPath, 'utf8'));
-for (const entry of feed.events) {
-  reportRunnerConsoleEvent(entry.event, resolveOffsets(entry.payload));
-}
-
-// Keep the process (and the TUI) alive for interactive navigation; the
-// TUI's own C-c binding exits.
-setInterval(() => {}, 1000);
-`;
-
-await mkdir(join(packageRoot, '.differential'), { recursive: true });
-
-await build({
-  stdin: {
-    contents: driverSource,
-    resolveDir: packageRoot,
-    sourcefile: 'tui-demo-driver.ts',
-    loader: 'ts',
-  },
-  bundle: true,
-  platform: 'node',
-  target: 'node20',
-  format: 'esm',
-  outfile: join(packageRoot, '.differential/tui-demo.mjs'),
-  minify: false,
-  sourcemap: false,
-  legalComments: 'none',
-  external: ['ws', 'undici', 'blessed', '@anthropic-ai/claude-agent-sdk'],
-});