@crystalplatforms/adm 0.2.3 → 0.3.0

package/src/utils/dotfiles-sync.js

@@ -1,89 +1,89 @@
-const fs = require('fs');
-const path = require('path');
-const chalk = require('chalk');
-const { handleConflict, createBackup } = require('./file-conflict-handler');
-
-const DEFAULT_FILES = ['.bashrc', '.zshrc', '.gitconfig', '.ssh/config'];
-
-/**
- * Syncs dotfiles from repo to home directory
- *
- * Options:
- *   repo: string — dotfiles repo path/URL
- *   homeDir: string — home directory (defaults to os.homedir())
- *   copy: boolean — copy instead of symlinking
- *   only: string[] — file filter (without dot, e.g. ['bashrc', 'zshrc'])
- *   files: string[] — file list (with dot, e.g. ['.bashrc'])
- *   onConflict: () => 'skip' | 'backup' — conflict strategy
- */
-async function syncDotfiles(options = {}) {
-  const configDir = process.env.ADM_CONFIG_DIR || path.join(require('os').homedir(), '.adm');
-  const dotfilesDir = path.join(configDir, 'dotfiles');
-  const homeDir = options.homeDir || process.env.ADM_TEST_HOME || require('os').homedir();
-
-  // Determine file list to sync
-  let files = options.files || DEFAULT_FILES;
-
-  // --only filter (user provides without dot: 'bashrc' → '.bashrc')
-  if (options.only && options.only.length > 0) {
-    files = options.only.map(f => f.startsWith('.') ? f : '.' + f);
-  }
-
-  const result = { symlinked: [], copied: [], skipped: [], backedUp: [], errors: [] };
-
-  for (const file of files) {
-    const sourcePath = path.join(dotfilesDir, file);
-    const targetPath = path.join(homeDir, file);
-
-    // Check if source file exists in repo
-    if (!fs.existsSync(sourcePath)) {
-      continue;
-    }
-
-    // Create target directory if needed (e.g. .ssh/)
-    const targetDir = path.dirname(targetPath);
-    if (!fs.existsSync(targetDir)) {
-      fs.mkdirSync(targetDir, { recursive: true });
-    }
-
-    // Check for conflict
-    const conflict = handleConflict({ targetPath, sourcePath });
-    if (conflict === 'conflict') {
-      const strategy = options.onConflict ? options.onConflict(file) : 'skip';
-      if (strategy === 'skip') {
-        result.skipped.push(file);
-        console.log(chalk.yellow(`  ⚠ Skipped ${file} (conflict)`));
-        continue;
-      }
-      if (strategy === 'backup') {
-        createBackup(targetPath);
-        result.backedUp.push(file);
-        fs.unlinkSync(targetPath);
-        console.log(chalk.blue(`  ℹ Backup ${file} → ${file}.backup`));
-      }
-    }
-
-    // Symlink or copy
-    try {
-      if (options.copy) {
-        fs.copyFileSync(sourcePath, targetPath);
-        // Preserve permissions
-        const sourceStat = fs.statSync(sourcePath);
-        fs.chmodSync(targetPath, sourceStat.mode);
-        result.copied.push(file);
-        console.log(chalk.green(`  ✔ Copied ${file}`));
-      } else {
-        fs.symlinkSync(sourcePath, targetPath);
-        result.symlinked.push(file);
-        console.log(chalk.green(`  ✔ Symlink ${file}`));
-      }
-    } catch (err) {
-      result.errors.push({ file, error: err.message });
-      console.error(chalk.red(`  ✖ Error ${file}: ${err.message}`));
-    }
-  }
-
-  return result;
-}
-
-module.exports = { syncDotfiles };
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const { handleConflict, createBackup } = require('./file-conflict-handler');
+
+const DEFAULT_FILES = ['.bashrc', '.zshrc', '.gitconfig', '.ssh/config'];
+
+/**
+ * Syncs dotfiles from repo to home directory
+ *
+ * Options:
+ *   repo: string — dotfiles repo path/URL
+ *   homeDir: string — home directory (defaults to os.homedir())
+ *   copy: boolean — copy instead of symlinking
+ *   only: string[] — file filter (without dot, e.g. ['bashrc', 'zshrc'])
+ *   files: string[] — file list (with dot, e.g. ['.bashrc'])
+ *   onConflict: () => 'skip' | 'backup' — conflict strategy
+ */
+async function syncDotfiles(options = {}) {
+  const configDir = process.env.ADM_CONFIG_DIR || path.join(require('os').homedir(), '.adm');
+  const dotfilesDir = path.join(configDir, 'dotfiles');
+  const homeDir = options.homeDir || process.env.ADM_TEST_HOME || require('os').homedir();
+
+  // Determine file list to sync
+  let files = options.files || DEFAULT_FILES;
+
+  // --only filter (user provides without dot: 'bashrc' → '.bashrc')
+  if (options.only && options.only.length > 0) {
+    files = options.only.map(f => f.startsWith('.') ? f : '.' + f);
+  }
+
+  const result = { symlinked: [], copied: [], skipped: [], backedUp: [], errors: [] };
+
+  for (const file of files) {
+    const sourcePath = path.join(dotfilesDir, file);
+    const targetPath = path.join(homeDir, file);
+
+    // Check if source file exists in repo
+    if (!fs.existsSync(sourcePath)) {
+      continue;
+    }
+
+    // Create target directory if needed (e.g. .ssh/)
+    const targetDir = path.dirname(targetPath);
+    if (!fs.existsSync(targetDir)) {
+      fs.mkdirSync(targetDir, { recursive: true });
+    }
+
+    // Check for conflict
+    const conflict = handleConflict({ targetPath, sourcePath });
+    if (conflict === 'conflict') {
+      const strategy = options.onConflict ? options.onConflict(file) : 'skip';
+      if (strategy === 'skip') {
+        result.skipped.push(file);
+        console.log(chalk.yellow(`  ⚠ Skipped ${file} (conflict)`));
+        continue;
+      }
+      if (strategy === 'backup') {
+        createBackup(targetPath);
+        result.backedUp.push(file);
+        fs.unlinkSync(targetPath);
+        console.log(chalk.blue(`  ℹ Backup ${file} → ${file}.backup`));
+      }
+    }
+
+    // Symlink or copy
+    try {
+      if (options.copy) {
+        fs.copyFileSync(sourcePath, targetPath);
+        // Preserve permissions
+        const sourceStat = fs.statSync(sourcePath);
+        fs.chmodSync(targetPath, sourceStat.mode);
+        result.copied.push(file);
+        console.log(chalk.green(`  ✓ Copied ${file}`));
+      } else {
+        fs.symlinkSync(sourcePath, targetPath);
+        result.symlinked.push(file);
+        console.log(chalk.green(`  ✓ Symlink ${file}`));
+      }
+    } catch (err) {
+      result.errors.push({ file, error: err.message });
+      console.error(chalk.red(`  ✖ Error ${file}: ${err.message}`));
+    }
+  }
+
+  return result;
+}
+
+module.exports = { syncDotfiles };

package/src/utils/file-conflict-handler.js

@@ -1,30 +1,30 @@
-const fs = require('fs');
-
-/**
- * Detects file conflict — whether target file already exists
- * Returns 'no-conflict' or 'conflict'
- */
-function handleConflict({ targetPath, sourcePath }) {
-  if (!fs.existsSync(targetPath)) {
-    return 'no-conflict';
-  }
-
-  // Check if it's a symlink — not a conflict if so
-  const stat = fs.lstatSync(targetPath);
-  if (stat.isSymbolicLink()) {
-    return 'no-conflict';
-  }
-
-  return 'conflict';
-}
-
-/**
- * Creates a backup of a file (.backup) and returns the backup path
- */
-function createBackup(filePath) {
-  const backupPath = filePath + '.backup';
-  fs.copyFileSync(filePath, backupPath);
-  return backupPath;
-}
-
-module.exports = { handleConflict, createBackup };
+const fs = require('fs');
+
+/**
+ * Detects file conflict — whether target file already exists
+ * Returns 'no-conflict' or 'conflict'
+ */
+function handleConflict({ targetPath, sourcePath }) {
+  if (!fs.existsSync(targetPath)) {
+    return 'no-conflict';
+  }
+
+  // Check if it's a symlink — not a conflict if so
+  const stat = fs.lstatSync(targetPath);
+  if (stat.isSymbolicLink()) {
+    return 'no-conflict';
+  }
+
+  return 'conflict';
+}
+
+/**
+ * Creates a backup of a file (.backup) and returns the backup path
+ */
+function createBackup(filePath) {
+  const backupPath = filePath + '.backup';
+  fs.copyFileSync(filePath, backupPath);
+  return backupPath;
+}
+
+module.exports = { handleConflict, createBackup };

package/bin/adm-tui

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-/**
- * ADM TUI — Full-screen terminal UI
- * Replaces Commander.js CLI with ink-based TUI for v2.
- */
-'use strict';
-
-const { boot } = require('../src/tui/app');
-
-boot().catch(err => {
-  console.error(err.message);
-  process.exit(1);
-});

package/src/ai/knowledge.js

@@ -1,61 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const KNOWLEDGE_DIR = path.join(os.homedir(), '.adm');
-const KNOWLEDGE_FILE = path.join(KNOWLEDGE_DIR, 'ai-knowledge.json');
-
-const SOURCE_DOCS = ['README.md', path.join('plans', 'prd-v2.md')];
-
-function buildKnowledge(version, projectRoot) {
-  const parts = [];
-
-  for (const doc of SOURCE_DOCS) {
-    const filePath = path.join(projectRoot, doc);
-    try {
-      const content = fs.readFileSync(filePath, 'utf8');
-      // Take first 500 chars per doc for compactness
-      const compact = content.substring(0, 500).trim();
-      if (compact) {
-        parts.push(`--- ${path.basename(doc)} ---\n${compact}`);
-      }
-    } catch {
-      // doc missing — skip
-    }
-  }
-
-  if (parts.length === 0) return null;
-
-  const summary = parts.join('\n\n');
-  const cache = {
-    version,
-    summary,
-    updatedAt: new Date().toISOString(),
-  };
-
-  // Ensure ~/.adm/ exists
-  if (!fs.existsSync(KNOWLEDGE_DIR)) {
-    fs.mkdirSync(KNOWLEDGE_DIR, { recursive: true });
-  }
-  fs.writeFileSync(KNOWLEDGE_FILE, JSON.stringify(cache, null, 2), 'utf8');
-
-  return summary;
-}
-
-function getKnowledge(version, projectRoot) {
-  // Try reading cache
-  try {
-    const raw = fs.readFileSync(KNOWLEDGE_FILE, 'utf8');
-    const cached = JSON.parse(raw);
-    if (cached.version === version) {
-      return cached.summary;
-    }
-    // Version changed — rebuild
-  } catch {
-    // No cache — build fresh
-  }
-
-  return buildKnowledge(version, projectRoot);
-}
-
-module.exports = { getKnowledge, buildKnowledge, KNOWLEDGE_DIR, KNOWLEDGE_FILE };

package/src/commands/connect.js

@@ -1,76 +0,0 @@
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const ora = require('ora');
-const github = require('../integrations/github');
-const gitlab = require('../integrations/gitlab');
-const { listStoredServices, retrieveToken } = require('../utils/keychain');
-
-async function connectGithub({ token } = {}) {
-  if (!token) {
-    ({ token } = await inquirer.prompt([{
-      type: 'password',
-      name: 'token',
-      message: 'Enter GitHub Personal Access Token (PAT):',
-      mask: '*',
-    }]));
-  }
-  const s = ora('Validating GitHub token...').start();
-  try {
-    const result = await github.connect(token);
-    s.succeed(`Connected to GitHub as ${chalk.green(result.user.login)}`);
-    return { ok: true, user: result.user.login };
-  } catch (err) {
-    s.fail(err.message);
-    throw err;
-  }
-}
-
-async function listConnections() {
-  const services = await listStoredServices();
-  if (services.length === 0) {
-    console.log(chalk.yellow('  No connected services.'));
-    return [];
-  }
-  for (const name of services) {
-    const token = await retrieveToken(name);
-    const masked = token ? token.substring(0, 4) + '****' + token.slice(-4) : '(none)';
-    console.log(`  ${chalk.green(name)}: connected (token: ${masked})`);
-  }
-  return services;
-}
-
-async function disconnect(service) {
-  if (service === 'github') {
-    await github.disconnect();
-    console.log(chalk.green('  GitHub disconnected.'));
-    return true;
-  }
-  if (service === 'gitlab') {
-    await gitlab.disconnect();
-    console.log(chalk.green('  GitLab disconnected.'));
-    return true;
-  }
-  throw new Error(`Unknown service: ${service}. Supported: github, gitlab`);
-}
-
-async function connectGitlab({ token } = {}) {
-  if (!token) {
-    ({ token } = await inquirer.prompt([{
-      type: 'password',
-      name: 'token',
-      message: 'Enter GitLab Access Token:',
-      mask: '*',
-    }]));
-  }
-  const s = ora('Validating GitLab token...').start();
-  try {
-    const result = await gitlab.connect(token);
-    s.succeed(`Connected to GitLab as ${chalk.green(result.user.username)}`);
-    return { ok: true, user: result.user.username };
-  } catch (err) {
-    s.fail(err.message);
-    throw err;
-  }
-}
-
-module.exports = { connectGithub, connectGitlab, listConnections, disconnect };

package/src/commands/issue.js

@@ -1,80 +0,0 @@
-const chalk = require('chalk');
-const ora = require('ora');
-const inquirer = require('inquirer');
-const gitlab = require('../integrations/gitlab');
-const { listStoredServices } = require('../utils/keychain');
-
-/**
- * Lists issues from connected platforms (GitHub + GitLab)
- * When multiple platforms — interactive selection
- * When --platform given — skips selection
- */
-async function listIssues(options = {}) {
-  const services = await listStoredServices();
-
-  if (services.length === 0) {
-    throw new Error('No connected platforms. Run /connect to connect GitHub or GitLab.');
-  }
-
-  // Filter to platforms supporting issues
-  const platforms = services.filter(s => ['github', 'gitlab'].includes(s));
-  if (platforms.length === 0) {
-    throw new Error('No connected platforms. Run /connect to connect GitHub or GitLab.');
-  }
-
-  let platform = options.platform;
-
-  // When --platform given, use it
-  if (!platform) {
-    if (platforms.length === 1) {
-      platform = platforms[0];
-    } else {
-      // Interactive selection
-      const answer = await inquirer.prompt([{
-        type: 'list',
-        name: 'platform',
-        message: 'Which platform to fetch issues from?',
-        choices: platforms.map(p => ({ name: p.charAt(0).toUpperCase() + p.slice(1), value: p })),
-      }]);
-      platform = answer.platform;
-    }
-  }
-
-  const s = ora(`Fetching issues from ${platform}...`).start();
-  try {
-    let issues;
-    if (platform === 'gitlab') {
-      issues = await gitlab.listIssues(options);
-    } else {
-      // GitHub uses search API for issues
-      const github = require('../integrations/github');
-      const octokit = await github.getClient();
-      const { data: user } = await octokit.users.getAuthenticated();
-      const { data } = await octokit.search.issuesAndPullRequests({
-        q: `author:${user.login} is:issue is:open`,
-        sort: 'updated',
-        order: 'desc',
-        per_page: options.limit || 20,
-      });
-      issues = data.items.map(issue => ({
-        iid: issue.number,
-        title: issue.title,
-        state: issue.state,
-        url: issue.html_url,
-        updatedAt: issue.updated_at,
-      }));
-    }
-
-    s.succeed(`Found ${issues.length} issues on ${platform}`);
-    for (const issue of issues) {
-      console.log(`  ${chalk.bold(`#${issue.iid}`)} ${issue.title}`);
-      console.log(`    ${chalk.gray(issue.url)}`);
-    }
-    return issues;
-  } catch (err) {
-    s.fail(err.message);
-    throw err;
-  }
-}
-
-module.exports = { listIssues };

package/src/commands/pr.js

@@ -1,55 +0,0 @@
-const chalk = require('chalk');
-const ora = require('ora');
-const github = require('../integrations/github');
-
-async function listPRs(options = {}) {
-  const s = ora('Fetching pull requests...').start();
-  try {
-    const prs = await github.listPRs(options);
-    s.stop();
-    if (prs.length === 0) {
-      console.log(chalk.yellow('  No open pull requests found.'));
-      return [];
-    }
-    for (const pr of prs) {
-      console.log(
-        `  ${chalk.bold(`#${pr.number}`)} ${pr.title}`,
-        chalk.gray(`(${pr.repo})`),
-        chalk.green(pr.state),
-      );
-      console.log(chalk.gray(`    ${pr.url}`));
-    }
-    return prs;
-  } catch (err) {
-    s.fail(err.message);
-    throw err;
-  }
-}
-
-async function draftPR(title, options = {}) {
-  const s = ora(`Creating draft PR "${title}"...`).start();
-  try {
-    const result = await github.createDraftPR(title, options);
-    s.succeed(`Draft PR #${result.number} created`);
-    console.log(chalk.gray(`  ${result.url}`));
-    return result;
-  } catch (err) {
-    s.fail(err.message);
-    throw err;
-  }
-}
-
-async function commentPR(prNumber, message, options = {}) {
-  const s = ora(`Commenting on PR #${prNumber}...`).start();
-  try {
-    const result = await github.commentOnPR(prNumber, message, options);
-    s.succeed(`Comment added to PR #${prNumber}`);
-    console.log(chalk.gray(`  ${result.url}`));
-    return result;
-  } catch (err) {
-    s.fail(err.message);
-    throw err;
-  }
-}
-
-module.exports = { listPRs, draftPR, commentPR };

package/src/commands/theme.js

@@ -1,103 +0,0 @@
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const { resolveTheme, listThemes } = require('../ui/theme');
-const { readConfig, writeConfig } = require('../config');
-
-/**
- * /theme — interactive theme selector with live preview.
- * Arrow keys to browse, Enter to apply, theme saved to ~/.adm/config.json.
- */
-async function themeCommand() {
-  const config = await readConfig();
-  const currentTheme = config.theme || 'dark';
-  const themes = listThemes();
-
-  // ── Show current theme ────────────────────────────────
-  console.log('');
-  const cur = resolveTheme(config);
-  const cc = cur.colors;
-  console.log(
-    chalk.hex(cc.primary)('  Current: ') +
-    chalk.hex(cc.accent)(cur.name) +
-    chalk.hex(cc.muted)(' (' + currentTheme + ')')
-  );
-  console.log('');
-
-  // ── Build preview for each theme ──────────────────────
-  const choices = themes.map(t => {
-    const c = t.colors;
-    const block = (hex) => chalk.hex(hex)('██');
-    const label =
-      '  ' +
-      block(c.primary) + block(c.accent) + block(c.secondary) +
-      '  ' +
-      chalk.hex(c.primary).bold(t.name.padEnd(10)) +
-      chalk.hex(c.muted)('adm> ') +
-      chalk.hex(c.text)('hello') + ' ' +
-      chalk.hex(c.success)('✓') + ' ' +
-      chalk.hex(c.error)('✗') + ' ' +
-      chalk.hex(c.warning)('⚠');
-
-    return {
-      name: label,
-      value: t.name,
-      short: t.name,
-    };
-  });
-
-  // ── Interactive selection ──────────────────────────────
-  const { selected } = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'selected',
-      message: 'Choose a theme:',
-      choices,
-      default: currentTheme,
-      pageSize: themes.length,
-      loop: false,
-    },
-  ]);
-
-  // ── Save to config ────────────────────────────────────
-  if (selected === currentTheme) {
-    const t = resolveTheme({ theme: selected });
-    console.log('');
-    console.log(chalk.hex(t.colors.muted)('  Already using ' + selected + ' theme.'));
-    console.log('');
-    return;
-  }
-
-  const newConfig = { ...config, theme: selected };
-  await writeConfig(newConfig);
-
-  const t = resolveTheme({ theme: selected });
-  const nc = t.colors;
-  console.log('');
-  console.log(
-    chalk.hex(nc.success)('  ✓ Theme saved: ') +
-    chalk.hex(nc.primary).bold(selected)
-  );
-  console.log(
-    chalk.hex(nc.muted)('  ~/.adm/config.json updated') +
-    chalk.hex(nc.text)(' — restart to see changes everywhere.')
-  );
-  console.log('');
-
-  // ── Show preview of new theme ─────────────────────────
-  showPreview(nc, selected);
-}
-
-function showPreview(c, name) {
-  const border = chalk.hex(c.primary);
-  const pad = '                ';
-  console.log('');
-  console.log(border('  ┌──────────────────────────────────┐'));
-  console.log(border('  │ ') + chalk.hex(c.text).bold('  ADM') + chalk.hex(c.muted)(' · ' + name) + pad.slice(0, Math.max(0, 18 - name.length)) + border('│'));
-  console.log(border('  │ ') + chalk.hex(c.muted)('  adm> ') + chalk.hex(c.text)('status') + pad.slice(0, 12) + border('│'));
-  console.log(border('  │ ') + chalk.hex(c.success)('  ✓ All systems go') + pad.slice(0, 10) + border('│'));
-  console.log(border('  │ ') + chalk.hex(c.accent)('  ██ ██') + chalk.hex(c.text)('  12:34') + pad.slice(0, 10) + border('│'));
-  console.log(border('  └──────────────────────────────────┘'));
-  console.log('');
-}
-
-module.exports = { themeCommand };