Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

3.6 KB
Raw Blame
import { readFileSync } from 'node:fs';
import { join } from 'node:path';
import { atomicWriteFileSync } from '@inkeep/open-knowledge-core/server';
import {
  getNodeValue,
  type Node as JsoncNode,
  type ParseError as JsoncParseError,
  parseTree,
} from 'jsonc-parser';
import {
  type ConfigFileDeclineReason,
  configFileDeclineReason,
} from '../utils/config-file-error.ts';
import { isObject } from '../utils/is-object.ts';
import { LAUNCH_CONFIG_NAME } from './init.ts';
import { existingFileMode, surgicalJsonDelete } from './jsonc-surgical.ts';
import { resolveRemovalFilePath } from './removal-file-path.ts';

export type LaunchRemoveOutcome =
  | { kind: 'removed' }
  | { kind: 'not-present' }
  | { kind: 'declined'; reason: ConfigFileDeclineReason | 'unparseable' };

const JSONC_PARSE_OPTIONS = { allowTrailingComma: true, disallowComments: false };

const JSONC_INVALID_SYMBOL_CODE = 1;
function isBenignBomError(error: JsoncParseError, raw: string): boolean {
  return (
    error.error === JSONC_INVALID_SYMBOL_CODE && error.offset === 0 && raw.charCodeAt(0) === 0xfeff
  );
}

export function removeOwnLaunchEntry(projectRoot: string): LaunchRemoveOutcome {
  const resolved = resolveRemovalFilePath(join(projectRoot, '.claude', 'launch.json'));
  if (resolved.kind !== 'ready') return resolved;
  const configPath = resolved.path;

  let raw: string;
  try {
    raw = readFileSync(configPath, 'utf-8');
  } catch (error) {
    return { kind: 'declined', reason: configFileDeclineReason(error) };
  }

  const errors: JsoncParseError[] = [];
  const tree: JsoncNode | undefined = parseTree(raw, errors, JSONC_PARSE_OPTIONS) ?? undefined;
  if (errors.some((e) => !isBenignBomError(e, raw)))
    return { kind: 'declined', reason: 'unparseable' };
  if (tree?.type !== 'object') return { kind: 'declined', reason: 'unparseable' };

  const root = getNodeValue(tree) as Record<string, unknown>;
  const configs = root.configurations;
  if (!Array.isArray(configs)) return { kind: 'not-present' };

  const index = configs.findIndex(isOwnLaunchEntry);
  if (index === -1) return { kind: 'not-present' };

  const { text, changed } = surgicalJsonDelete(raw, ['configurations', index]);
  if (!changed) return { kind: 'not-present' };
  atomicWriteFileSync(configPath, text, { mode: existingFileMode(configPath) });
  return { kind: 'removed' };
}

function isOwnLaunchEntry(value: unknown): boolean {
  if (!isObject(value)) return false;
  const entry = value as Record<string, unknown>;
  if (entry.name !== LAUNCH_CONFIG_NAME || !Array.isArray(entry.runtimeArgs)) return false;
  const args = entry.runtimeArgs;
  if (entry.runtimeExecutable === '/bin/sh') {
    return (
      args.length === 3 &&
      args[0] === '-l' &&
      args[1] === '-c' &&
      typeof args[2] === 'string' &&
      /^# ok-ui-v[1-9]\d*$/.test(args[2].split(/\r?\n/, 1)[0] ?? '')
    );
  }
  if (entry.runtimeExecutable === 'npx') {
    return LEGACY_NPX_UI_FORMS.some((form) => argsExactlyMatch(args, form));
  }
  return (
    entry.runtimeExecutable === 'powershell' &&
    args.length === 4 &&
    args[0] === '-NoProfile' &&
    args[1] === '-NonInteractive' &&
    args[2] === '-Command' &&
    typeof args[3] === 'string' &&
    /^# ok-ui-win-v[1-9]\d*$/.test(args[3].split(/\r?\n/, 1)[0] ?? '')
  );
}

const LEGACY_NPX_UI_FORMS: ReadonlyArray<readonly string[]> = [
  ['@inkeep/open-knowledge', 'ui'],
  ['-y', '@inkeep/open-knowledge', 'ui'],
  ['-y', '@inkeep/open-knowledge@latest', 'ui'],
];

function argsExactlyMatch(actual: readonly unknown[], expected: readonly string[]): boolean {
  return actual.length === expected.length && actual.every((arg, index) => arg === expected[index]);
}