adl-toolkit 0.0.0-stage → 0.1.1

package/bin/adl-toolkit.mjs

@@ -0,0 +1,488 @@
+#!/usr/bin/env node
+
+import { constants as osConstants, homedir, tmpdir } from 'node:os';
+import { closeSync, existsSync, mkdtempSync, openSync, readFileSync, realpathSync, writeSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn, spawnSync } from 'node:child_process';
+import {
+  cancel,
+  confirm,
+  intro,
+  isCancel,
+  multiselect,
+  S_CHECKBOX_SELECTED,
+  S_CHECKBOX_INACTIVE,
+  S_RADIO_ACTIVE,
+  S_RADIO_INACTIVE,
+  note,
+  outro,
+  select,
+  text,
+} from '@clack/prompts';
+
+import { stripVTControlCharacters } from 'node:util';
+import { SelectPrompt, MultiSelectPrompt, TextPrompt } from '@clack/core';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const backend = join(root, 'scripts', 'install_toolkit.py');
+const cancelled = Symbol('cancelled');
+// Keep Clack's multi-selection behavior, with circles matching the graph menu.
+const bulletOutput = new Proxy(process.stdout, {
+  get(stream, property) {
+    if (property === 'write') {
+      return (chunk, ...args) => stream.write(
+        typeof chunk === 'string'
+          ? chunk.replaceAll(S_CHECKBOX_SELECTED, S_RADIO_ACTIVE)
+            .replaceAll(S_CHECKBOX_INACTIVE, S_RADIO_INACTIVE)
+          : chunk,
+        ...args,
+      );
+    }
+    const value = Reflect.get(stream, property, stream);
+    return typeof value === 'function' ? value.bind(stream) : value;
+  },
+});
+const graphOptions = [
+  { value: 'adl-drift', label: 'ADL-Drift' },
+  { value: 'codegraph', label: 'CodeGraph' },
+  { value: 'gitnexus', label: 'Git Nexus' },
+  { value: 'graphify', label: 'Graphify' },
+];
+const addonOptions = [
+  { value: 'caveman', label: 'Caveman', description: 'Concise output to save tokens.' },
+  { value: 'ponytail', label: 'Ponytail', description: 'Minimalist coding with less complexity.' },
+];
+const clientOptions = [
+  { value: 'codex', label: 'Codex' },
+  { value: 'claude', label: 'Claude Code' },
+  { value: 'cursor', label: 'Cursor' },
+  { value: 'antigravity', label: 'Antigravity' },
+];
+
+function help() {
+  console.log(`ADL Toolkit
+
+Usage:
+  npx adl-toolkit install            Open the interactive installer
+  npx adl-toolkit uninstall          Open the interactive uninstaller
+  adl-toolkit install [options]      Run without prompts
+  adl-toolkit uninstall [options]    Run without prompts
+
+Advanced commands:
+  adl-toolkit status                 Inspect the current project's installation
+  adl-toolkit doctor                 Check installation health
+  adl-toolkit repair                 Restore missing configuration and instructions
+  adl-toolkit update                 Upgrade the managed graph runtime
+
+Install options:
+  --graph adl-drift|codegraph|gitnexus|graphify|other  Select exactly one graph tool
+  --addon caveman|ponytail           Add an integration (repeatable)
+  --client codex|claude|cursor|antigravity  Select clients (repeatable; use all for every client)
+  --project PATH                     Target project (default: current directory)
+  --extra http|embeddings            ADL optional dependency (repeatable)
+  --package SPEC                     Package used with --graph other
+  --no-index                         Skip initial indexing
+  --dry-run                          Show the plan without changing files
+
+Uninstall options:
+  --project PATH                     Target project
+  --purge-index                      Also remove generated index data
+  --remove-client CLIENT             Remove one managed client (repeatable)
+  --remove-addon caveman|ponytail     Remove one managed integration (repeatable)
+  --yes                              Confirm removal without prompts
+  --dry-run                          Show the removal plan
+
+Status, doctor, repair, and update options:
+  --project PATH                     Target project (default: current directory)
+  --dry-run                          Preview repair or update without changing files
+
+Run with npx from this repository before npm publication:
+  npx --yes --package=. adl-toolkit install
+  npx --yes --package=. adl-toolkit uninstall`);
+}
+
+function chosen(value) {
+  if (isCancel(value)) throw cancelled;
+  return value;
+}
+
+function projectPath(value) {
+  if (value === '~') return homedir();
+  if (value.startsWith('~/') || value.startsWith('~\\')) {
+    return resolve(homedir(), value.slice(2));
+  }
+  return resolve(value);
+}
+
+function findPython() {
+  const configured = process.env.ADL_TOOLKIT_PYTHON;
+  const candidates = configured
+    ? [[configured, []]]
+    : process.platform === 'win32'
+      ? [['py', ['-3']], ['python', []], ['python3', []]]
+      : [['python3', []], ['python', []]];
+  for (const [command, prefix] of candidates) {
+    const probe = spawnSync(command, [...prefix, '--version'], { encoding: 'utf8' });
+    const match = `${probe.stdout || ''}${probe.stderr || ''}`.match(/Python (\d+)\.(\d+)/);
+    if (probe.status === 0 && match &&
+        (Number(match[1]) > 3 || Number(match[1]) === 3 && Number(match[2]) >= 10)) {
+      return [command, prefix];
+    }
+  }
+  throw new Error('Python 3.10 or newer is required. Install Python or set ADL_TOOLKIT_PYTHON.');
+}
+
+function runBackend(args) {
+  const [python, prefix] = findPython();
+  const result = spawnSync(python, [...prefix, backend, ...args], {
+    stdio: 'inherit', env: { ...process.env, PYTHONUTF8: '1', PYTHONIOENCODING: 'utf-8' },
+  });
+  if (result.error) throw result.error;
+  if (result.signal) return 128 + (osConstants.signals[result.signal] || 0);
+  return result.status ?? 1;
+}
+
+export async function runInstallation(args, output = process.stdout) {
+  const [python, prefix] = findPython();
+  const removing = args[0] === 'uninstall';
+  const action = removing ? 'Uninstall' : 'Installation';
+  const logPath = join(mkdtempSync(join(tmpdir(), `adl-toolkit-${removing ? 'uninstall' : 'install'}-`)), 'audit.log');
+  const log = openSync(logPath, 'wx', 0o600);
+  const value = flag => args.includes(flag) ? args[args.indexOf(flag) + 1] : undefined;
+  const choices = flag => args.flatMap((argument, i) => argument === flag ? [args[i + 1]] : []);
+  const manifest = removing ? readManifest(projectPath(value('--project') || process.cwd())) : null;
+  const summary = removing ? [
+    `Project: ${value('--project') || process.cwd()}`,
+    `Graph: ${manifest?.graph || value('--graph') || 'Managed installation'}`,
+    `Remove AI Agents: ${choices('--remove-client').join(', ') || 'None selected individually'}`,
+    `Remove plugins: ${choices('--remove-addon').join(', ') || 'None selected individually'}`,
+    `Scope: ${args.includes('--remove-client') || args.includes('--remove-addon') ? 'Selected components' : 'Entire installation'}`,
+    `Remove index: ${args.includes('--purge-index') ? 'Yes' : 'No'}`,
+  ] : [
+    `Graph: ${value('--graph')}`, `Plugins: ${choices('--addon').join(', ') || 'None'}`,
+    `AI Agents: ${choices('--client').join(', ')}`, `Project: ${value('--project')}`,
+    ...(args.includes('--package') ? [`Package: ${value('--package')}`] : []),
+    `Build index: ${args.includes('--no-index') ? 'No' : 'Yes'}`,
+  ];
+  const lines = [];
+  let pending = '', child, outputError;
+  const render = () => {
+    const width = Math.max(1, (output.columns || 80) - 4);
+    const height = Math.max(1, Math.min(8, (output.rows || 24) - summary.length - 7));
+    const visible = [...lines, ...(pending ? [pending] : [])].slice(-height);
+    const clip = line => Array.from(line).slice(0, width).join('');
+    output.write('\x1b[H\x1b[2J' + ['Your selections', ...summary, '',
+      `${action} progress · Ctrl+C Cancel`, '┌' + '─'.repeat(width + 2) + '┐',
+      ...visible.map(line => `│ ${clip(line).padEnd(width)} │`), '└' + '─'.repeat(width + 2) + '┘',
+      `Full audit: ${logPath}`].join('\n'));
+  };
+  const interrupt = () => child?.kill('SIGINT');
+  let timer;
+  try {
+    output.write('\x1b[?1049h\x1b[?25l');
+    render();
+    child = spawn(python, [...prefix, '-u', backend, ...args], {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: { ...process.env, PYTHONUNBUFFERED: '1', PYTHONUTF8: '1', PYTHONIOENCODING: 'utf-8' },
+    });
+    process.on('SIGINT', interrupt);
+    for (const stream of [child.stdout, child.stderr]) {
+      stream.setEncoding('utf8');
+      stream.on('data', chunk => {
+        try {
+          writeSync(log, chunk);
+          const parts = (pending + stripVTControlCharacters(chunk)).split(/\r\n|[\r\n]/);
+          pending = parts.pop().slice(-2000);
+          lines.push(...parts.map(line => line.slice(-2000)));
+          lines.splice(0, Math.max(0, lines.length - 8));
+        } catch (error) {
+          outputError = error;
+          child.kill('SIGINT');
+        }
+      });
+    }
+    timer = setInterval(render, 100);
+    const status = await new Promise((resolve, reject) => {
+      child.once('error', reject);
+      child.once('close', (code, signal) => resolve(signal ? 128 + (osConstants.signals[signal] || 0) : code ?? 1));
+    });
+    if (outputError) throw outputError;
+    return status;
+  } finally {
+    clearInterval(timer);
+    process.off('SIGINT', interrupt);
+    closeSync(log);
+    output.write('\x1b[?25h\x1b[?1049l');
+    output.write(`\n${[...lines, pending].filter(Boolean).join('\n')}\nFull ${action.toLowerCase()} audit: ${logPath}\n`);
+  }
+}
+
+export async function wizardPrompt(kind, options) {
+  const Base = kind === 'text' ? TextPrompt : kind === 'multiselect' ? MultiSelectPrompt : SelectPrompt;
+  let direction = 'next';
+  class NavigablePrompt extends Base {
+    emit(event, ...args) {
+      // Keep horizontal arrows from changing menu selections; Left returns a step.
+      if (event === 'cursor' && ['left', 'right'].includes(args[0])) return;
+      return super.emit(event, ...args);
+    }
+  }
+  const validate = value => options.required && !value?.length
+    ? 'Choose at least one option' : options.validate?.(value);
+  const prompt = new NavigablePrompt({
+    ...options,
+    initialUserInput: kind === 'text' ? options.initialValue : undefined,
+    validate,
+    render() {
+      const heading = `${this.state === 'submit' ? '◇' : '◆'} ${options.message}`;
+      if (this.state === 'submit' || this.state === 'cancel') return heading;
+      const body = kind === 'text' ? `│  ${this.userInput || options.placeholder || ''}`
+        : options.options.map((option, i) => {
+          const selected = kind === 'multiselect' ? this.value?.includes(option.value) : this.value === option.value;
+          return `│ ${i === this.cursor ? '›' : ' '} ${selected ? '●' : '○'} ${option.label}`;
+        }).join('\n');
+      const hint = options.hint ? `\n│  ${options.hint}\n│` : '';
+      const description = kind !== 'text' && options.options[this.cursor]?.description;
+      const details = description ? `\n│\n│  \x1b[2m${description}\x1b[22m` : '';
+      return `${heading}${hint}\n${body}${details}${this.state === 'error' ? `\n│  ${this.error}` : ''}`;
+    },
+  });
+  prompt.on('key', (_char, key) => {
+    if (key.name !== 'left') return;
+    direction = 'back';
+    prompt.state = 'submit';
+  });
+  return { value: chosen(await prompt.prompt()), direction };
+}
+
+export async function installWizard(dryRun, prompts = { intro, note, ask: wizardPrompt }, output = process.stdout) {
+  const { intro, note, ask } = prompts;
+  let installationSummary;
+  // Use a separate screen so redraws never erase the user's terminal history.
+  if (output.isTTY) output.write('\x1b[?1049h');
+  try {
+    const values = { graph: 'adl-drift', addons: [], clients: [], project: process.cwd(), package: '', index: true };
+    const selected = new Set();
+    let position = 0;
+    while (true) {
+      if (output.isTTY) output.write('\x1b[H\x1b[2J');
+      intro('ADL Toolkit');
+      note('↑/↓ Choose · Space Toggle · ← Previous step · Enter Save and advance · Ctrl+C Cancel', 'Keyboard controls');
+      const steps = ['graph', 'addons', 'clients', 'project', values.graph === 'other' ? 'package' : 'index', 'review'];
+      const step = steps[position];
+      const fields = {
+        graph: ['select', { message: 'Choose one graph tool', options: graphOptions, initialValue: values.graph }],
+        addons: ['multiselect', { message: 'Choose saving token plugins', hint: 'Selected plugins are active by default in AGENTS.md. Disable them by asking the agent not to use them, or by editing the file.', options: addonOptions, initialValues: values.addons }],
+        clients: ['multiselect', { message: 'Choose one or more AI Agents', options: [{ value: 'all', label: 'Select all' }, ...clientOptions], initialValues: values.clients, required: true }],
+        project: ['text', { message: 'Project directory', initialValue: values.project, validate: value => value?.trim() ? undefined : 'Enter a project directory' }],
+        package: ['text', { message: 'Python package name and version', initialValue: values.package, placeholder: 'package-name==1.2.3', validate: value => value?.trim() ? undefined : 'Enter a package name' }],
+        index: ['select', { message: 'Build the graph index after installation?', options: [{ value: true, label: 'Yes (recommended)' }, { value: false, label: 'No (build manually later)' }], initialValue: values.index }],
+        review: ['select', { message: dryRun ? 'Show this installation plan?' : 'Install now?', options: [{ value: true, label: 'Yes' }, { value: false, label: 'Cancel' }], initialValue: true }],
+      };
+      if (step === 'index') note('Indexes your project so the graph tool can traverse code relationships. Recommended for immediate use; larger projects may take longer.', 'Graph index');
+      const labels = options => choices => choices.map(value => options.find(option => option.value === value)?.label || value).join(', ');
+      const clients = values.clients.includes('all') ? clientOptions.map(option => option.value) : values.clients;
+      const summary = [
+        ...(selected.has('graph') ? [`Graph: ${labels(graphOptions)([values.graph])}`] : []),
+        ...(selected.has('addons') ? [`Plugins: ${labels(addonOptions)(values.addons) || 'None'}`] : []),
+        ...(selected.has('clients') ? [`AI Agents: ${labels(clientOptions)(clients)}`] : []),
+        ...(selected.has('project') ? [`Project: ${projectPath(values.project)}`] : []),
+        ...(values.graph === 'other'
+          ? selected.has('package') ? [`Package: ${values.package}`] : []
+          : selected.has('index') ? [`Build index: ${values.index ? 'Yes' : 'No'}`] : []),
+      ].join('\n');
+      if (summary) note(summary, step === 'review' ? (dryRun ? 'Dry run' : 'Ready to install') : 'Your selections');
+      const { value, direction } = await ask(...fields[step]);
+      if (step !== 'review') values[step] = value;
+      if (direction === 'back') {
+        position = Math.max(0, position - 1);
+        continue;
+      }
+      if (step !== 'review') {
+        selected.add(step);
+        position++;
+        continue;
+      }
+      if (!value) throw cancelled;
+      installationSummary = summary;
+      const args = ['install', '--graph', values.graph, '--project', projectPath(values.project)];
+      for (const client of clients) args.push('--client', client);
+      for (const addon of values.addons) args.push('--addon', addon);
+      if (values.graph === 'other') args.push('--package', values.package.trim());
+      if (values.graph === 'other' || !values.index) args.push('--no-index');
+      if (dryRun) args.push('--dry-run');
+      return args;
+    }
+  } finally {
+    if (output.isTTY) output.write('\x1b[?1049l');
+    if (installationSummary) note(installationSummary, 'Installation selections');
+  }
+}
+
+function readManifest(project) {
+  const path = join(project, '.adl-toolkit', 'install.json');
+  if (!existsSync(path)) return null;
+  try {
+    const manifest = JSON.parse(readFileSync(path, 'utf8'));
+    const graphs = [...graphOptions.map(option => option.value), 'other'];
+    const clients = clientOptions.map(option => option.value);
+    const addons = addonOptions.map(option => option.value);
+    if (!manifest || !graphs.includes(manifest.graph) || !clients.includes(manifest.client) ||
+        (manifest.clients !== undefined && (!Array.isArray(manifest.clients) || !manifest.clients.length ||
+          manifest.clients.some(client => !clients.includes(client)))) ||
+        !Array.isArray(manifest.addons) || manifest.addons.some(addon => !addons.includes(addon))) {
+      return null;
+    }
+    return manifest;
+  } catch {
+    return null;
+  }
+}
+
+export async function uninstallWizard(dryRun, prompts = { intro, note, ask: wizardPrompt }, output = process.stdout) {
+  const { intro, note, ask } = prompts;
+  const values = { project: process.cwd(), removal: 'all', clients: [], addons: [], graph: 'adl-drift', client: 'codex', purge: false };
+  const selected = new Set();
+  let position = 0, removalSummary;
+  if (output.isTTY) output.write('\x1b[?1049h');
+  try {
+    while (true) {
+      if (output.isTTY) output.write('\x1b[H\x1b[2J');
+      intro('ADL Toolkit — Uninstall');
+      note('↑/↓ Choose · Space Toggle · ← Previous step · Enter Save and advance · Ctrl+C Cancel', 'Keyboard controls');
+      const project = projectPath(values.project);
+      const manifest = readManifest(project);
+      const installedClients = manifest?.clients || (manifest ? [manifest.client] : []);
+      const selective = manifest && values.removal !== 'all';
+      const steps = manifest
+        ? ['project', 'removal', ...(selective ? [values.removal === 'client' ? 'clients' : 'addons'] : ['purge']), 'review']
+        : ['project', 'graph', 'client', 'purge', 'review'];
+      const step = steps[position];
+      const removalOptions = [
+        { value: 'all', label: 'Entire managed installation' },
+        ...(installedClients.length > 1 ? [{ value: 'client', label: 'Selected AI Agents (keep graph runtime)' }] : []),
+        ...(manifest?.addons.length ? [{ value: 'addon', label: 'Selected plugins (keep graph runtime)' }] : []),
+      ];
+      const summary = [
+        `Project: ${project}`,
+        ...(manifest ? [
+          `Graph: ${graphOptions.find(option => option.value === manifest.graph)?.label}`,
+          `Installed plugins: ${manifest.addons.map(value => addonOptions.find(option => option.value === value)?.label).join(', ') || 'None'}`,
+          `Installed AI Agents: ${installedClients.map(value => clientOptions.find(option => option.value === value)?.label).join(', ')}`,
+          ...(selected.has('removal') ? [`Remove: ${removalOptions.find(option => option.value === values.removal)?.label}`] : []),
+          ...(values.removal === 'client' ? [`Remove AI Agents: ${values.clients.join(', ') || 'Not selected'}`] : []),
+          ...(values.removal === 'addon' ? [`Remove plugins: ${values.addons.join(', ') || 'Not selected'}`] : []),
+        ] : [`Graph: ${values.graph}`, `AI Agent: ${values.client}`]),
+        ...(!selective && selected.has('purge') ? [`Remove index: ${values.purge ? 'Yes' : 'No'}`] : []),
+      ].join('\n');
+      note(summary, 'Your selections');
+      if (!manifest && step !== 'project') note('No install manifest found. Select the earlier installation. Legacy skills have no ownership record; remove them explicitly with the Skills CLI.', 'Legacy installation');
+      const fields = {
+        project: ['text', { message: 'Project directory', initialValue: values.project, validate: value => value?.trim() ? undefined : 'Enter a project directory' }],
+        removal: ['select', { message: 'What would you like to remove?', options: removalOptions, initialValue: values.removal }],
+        clients: ['multiselect', { message: 'Choose AI Agents to remove', options: clientOptions.filter(option => installedClients.includes(option.value)), initialValues: values.clients, required: true,
+          validate: value => value?.length === installedClients.length ? 'Keep at least one AI Agent, or go back and remove the entire installation.' : undefined }],
+        addons: ['multiselect', { message: 'Choose plugins to remove', options: addonOptions.filter(option => manifest?.addons.includes(option.value)), initialValues: values.addons, required: true }],
+        graph: ['select', { message: 'Graph tool to remove', options: graphOptions, initialValue: values.graph }],
+        client: ['select', { message: 'Choose an AI Agent', options: clientOptions, initialValue: values.client }],
+        purge: ['select', { message: 'Also remove generated index data?', options: [{ value: false, label: 'No' }, { value: true, label: 'Yes' }], initialValue: values.purge }],
+        review: ['select', { message: dryRun ? 'Show this removal plan?' : 'Remove the selected components?', options: [{ value: false, label: 'Cancel' }, { value: true, label: dryRun ? 'Show plan' : 'Remove' }], initialValue: false }],
+      };
+      const { value, direction } = await ask(...fields[step]);
+      if (step !== 'review') values[step] = value;
+      if (step === 'project' && projectPath(values.project) !== project) {
+        selected.clear();
+        values.removal = 'all';
+        values.clients = [];
+        values.addons = [];
+        values.purge = false;
+      }
+      if (direction === 'back') {
+        position = Math.max(0, position - 1);
+        continue;
+      }
+      if (step !== 'review') { selected.add(step); position++; continue; }
+      if (!value) throw cancelled;
+      const args = ['uninstall', '--project', project];
+      if (!manifest) args.push('--graph', values.graph, '--client', values.client);
+      if (manifest && values.removal === 'client') for (const client of values.clients) args.push('--remove-client', client);
+      if (manifest && values.removal === 'addon') for (const addon of values.addons) args.push('--remove-addon', addon);
+      if (!selective && values.purge) args.push('--purge-index');
+      if (dryRun) args.push('--dry-run');
+      args.push('--yes');
+      removalSummary = summary;
+      return args;
+    }
+  } finally {
+    if (output.isTTY) output.write('\x1b[?1049l');
+    if (removalSummary) note(removalSummary, 'Removal selections');
+  }
+}
+
+async function main(argv) {
+  if (argv.includes('--help') || argv.includes('-h')) {
+    help();
+    return 0;
+  }
+  if (argv.includes('--version') || argv.includes('-v')) {
+    console.log('0.1.1');
+    return 0;
+  }
+  const first = argv[0];
+  const command = !first || first.startsWith('-') ? 'install' : first;
+  if (!['install', 'uninstall', 'status', 'doctor', 'repair', 'update'].includes(command)) {
+    console.error(`Unknown command: ${command}\n`);
+    help();
+    return 2;
+  }
+  const rest = first === command ? argv.slice(1) : argv;
+  if (['status', 'doctor', 'repair', 'update'].includes(command)) {
+    return runBackend([command, ...rest]);
+  }
+  const onlyDryRun = rest.length === 1 && rest[0] === '--dry-run';
+  if (rest.length && !onlyDryRun) {
+    const args = [command, ...rest];
+    return ['install', 'uninstall'].includes(command) && process.stdout.isTTY && !rest.includes('--dry-run')
+      && (command === 'install' ? rest.includes('--graph') : rest.includes('--yes'))
+      ? await runInstallation(args) : runBackend(args);
+  }
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    console.error('Interactive selection needs a terminal. Pass --graph and the other options explicitly.\n');
+    help();
+    return 2;
+  }
+  try {
+    const args = command === 'install'
+      ? await installWizard(onlyDryRun)
+      : await uninstallWizard(onlyDryRun);
+    const status = !onlyDryRun
+      ? await runInstallation(args)
+      : runBackend(args);
+    if (status === 0) {
+      outro(onlyDryRun
+        ? command === 'install' ? 'Installation plan shown.' : 'Uninstall plan shown.'
+        : command === 'install' ? 'Installation complete.'
+          : args.includes('--remove-client') || args.includes('--remove-addon')
+            ? 'Selected components removed. Shared graph runtime retained.'
+          : readManifest(args[args.indexOf('--project') + 1])
+            ? 'Some edited files were preserved. Review the cleanup notes above.'
+            : 'Uninstall complete.');
+    }
+    return status;
+  } catch (error) {
+    if (error === cancelled) {
+      cancel('Cancelled. No changes were made.');
+      return 0;
+    }
+    throw error;
+  }
+}
+
+if (process.argv[1] && realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url))) main(process.argv.slice(2)).then(
+  status => { process.exitCode = status; },
+  error => {
+    console.error(`Error: ${error.message}`);
+    process.exitCode = 1;
+  },
+);

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "adl-toolkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Interactive installer for one graph tool and optional agent integrations",
+  "type": "module",
+  "bin": {
+    "adl-toolkit": "bin/adl-toolkit.mjs",
+    "adl-drift": "bin/adl-drift.mjs"
+  },
+  "files": [
+    "bin/",
+    "adl_drift/**/*.py",
+    "adl_drift/harness/skills/",
+    "adl_drift/server/static/",
+    "scripts/install_toolkit.py",
+    "pyproject.toml",
+    "README.md",
+    "INSTALL_TOOLKIT.md"
+  ],
+  "scripts": {
+    "test": "node --test tests/toolkit-cli.test.mjs"
+  },
+  "engines": {
+    "node": ">=22.20.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "1.4.0",
+    "@clack/core": "1.3.1"
+  },
+  "license": "MIT"
+}

package/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "adl-drift"
+version = "0.1.0"
+description = "Static analysis engine for Python and Java with an MCP server."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "ADL Drift" }]
+dependencies = [
+    "tree-sitter>=0.23",
+    "tree-sitter-python>=0.23",
+    "tree-sitter-java>=0.23",
+    "defusedxml>=0.7.1",
+    "networkx>=3.2",
+    "click>=8.1",
+    "rich>=13.7",
+    "pydantic>=2.6",
+    "platformdirs>=4.2",
+    "mcp>=1.2,<2",
+]
+
+[project.optional-dependencies]
+http = ["fastapi>=0.110", "uvicorn>=0.27", "sse-starlette>=2.0"]
+embeddings = ["sentence-transformers>=2.6", "numpy>=1.26"]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23"]
+test = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "fastapi>=0.110",
+    "httpx>=0.27",
+    "sse-starlette>=2.0",
+    "numpy>=1.26",
+]
+
+[project.scripts]
+adl-drift = "adl_drift.cli.main:main"
+adl-drift-mcp = "adl_drift.server.mcp_stdio:cli_entry"
+
+[tool.setuptools.packages.find]
+include = ["adl_drift*"]
+exclude = ["tests*"]
+
+[tool.setuptools.package-data]
+"adl_drift.harness" = ["skills/*.md"]
+"adl_drift.server" = ["static/*.html"]