@maccesar/titools 2.0.6 → 2.2.0

package/lib/config.js

@@ -8,7 +8,7 @@ import os from 'os';
 import { readFileSync } from 'fs';
 
 // Read package.json version dynamically
-let packageVersion = '1.7.0';
+let packageVersion = '2.1.0';
 try {
   const packagePath = new URL('../package.json', import.meta.url);
   const pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
@@ -30,7 +30,7 @@ export const REPO_API_URL = 'https://api.github.com/repos/macCesar/titools';
 
 // Skills to install
 export const SKILLS = [
-  'alloy-expert',
+  'ti-expert',
   'purgetss',
   'ti-ui',
   'ti-howtos',
@@ -38,45 +38,51 @@ export const SKILLS = [
   'alloy-guides',
   'alloy-howtos',
 ];
+// Legacy skills to remove during updates/uninstall
+export const LEGACY_SKILLS = [
+  'alloy-expert',
+];
 
 // Agents to install
 export const AGENTS = [
+  'ti-pro',
+];
+// Legacy agents to remove during updates/uninstall
+export const LEGACY_AGENTS = [
   'ti-researcher',
 ];
 
 // Directory paths
-export const getAgentsDir = () => path.join(os.homedir(), '.agents');
-export const getAgentsSkillsDir = () => path.join(getAgentsDir(), 'skills');
-export const getClaudeAgentsDir = () => path.join(os.homedir(), '.claude', 'agents');
-export const getClaudeSkillsDir = () => path.join(os.homedir(), '.claude', 'skills');
-export const getGeminiSkillsDir = () => path.join(os.homedir(), '.gemini', 'skills');
-export const getCodexSkillsDir = () => path.join(os.homedir(), '.codex', 'skills');
+export const getAgentsDir = (baseDir = os.homedir()) => path.join(baseDir, '.agents');
+export const getAgentsSkillsDir = (baseDir = os.homedir()) => path.join(getAgentsDir(baseDir), 'skills');
+export const getClaudeAgentsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'agents');
+export const getClaudeSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.claude', 'skills');
+export const getGeminiSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.gemini', 'skills');
+export const getCodexSkillsDir = (baseDir = os.homedir()) => path.join(baseDir, '.codex', 'skills');
 
 // AI platform detection
-export const PLATFORMS = [
+export const getPlatforms = (baseDir = os.homedir()) => [
   {
     name: 'claude',
     displayName: 'Claude Code',
-    skillsDir: getClaudeSkillsDir(),
-    configDir: path.join(os.homedir(), '.claude'),
+    skillsDir: getClaudeSkillsDir(baseDir),
+    configDir: path.join(baseDir, '.claude'),
   },
   {
     name: 'gemini',
     displayName: 'Gemini CLI',
-    skillsDir: getGeminiSkillsDir(),
-    configDir: path.join(os.homedir(), '.gemini'),
+    skillsDir: getGeminiSkillsDir(baseDir),
+    configDir: path.join(baseDir, '.gemini'),
   },
   {
     name: 'codex',
     displayName: 'Codex CLI',
-    skillsDir: getCodexSkillsDir(),
-    configDir: path.join(os.homedir(), '.codex'),
+    skillsDir: getCodexSkillsDir(baseDir),
+    configDir: path.join(baseDir, '.codex'),
   },
 ];
 
 // Files to install
-export const AGENTS_TEMPLATE_FILE = 'AGENTS-TEMPLATE.md';
-export const TI_DOCS_INDEX_SCRIPT = 'ti-docs-index';
 
 // AI file priorities (higher = more priority)
 export const AI_FILE_PRIORITIES = {
@@ -103,16 +109,16 @@ export default {
   REPO_RAW_URL,
   REPO_API_URL,
   SKILLS,
+  LEGACY_SKILLS,
   AGENTS,
+  LEGACY_AGENTS,
   getAgentsDir,
   getAgentsSkillsDir,
   getClaudeAgentsDir,
   getClaudeSkillsDir,
   getGeminiSkillsDir,
   getCodexSkillsDir,
-  PLATFORMS,
-  AGENTS_TEMPLATE_FILE,
-  TI_DOCS_INDEX_SCRIPT,
+  getPlatforms,
   AI_FILE_PRIORITIES,
   TITANIUM_PROJECT_FILE,
   GITHUB_API_HEADERS,

package/lib/downloader.js

@@ -94,7 +94,7 @@ export async function downloadRepoArchive(destDir, ref = 'main') {
 
 /**
  * Download a single file from GitHub raw content
- * @param {string} filePath - Path in repository (e.g., 'AGENTS-TEMPLATE.md')
+ * @param {string} filePath - Path in repository (e.g., 'AGENTS-VERCEL-RESEARCH.md')
  * @param {string} destPath - Local destination path
  * @param {string} ref - Git ref (branch, tag, commit)
  * @returns {Promise<void>}

package/lib/installer.js

@@ -1,6 +1,6 @@
 /**
  * File installation utilities
- * Installs skills, agents, and templates to their respective directories
+ * Installs skills and agents to their respective directories
  */
 
 import {
@@ -11,14 +11,14 @@ import {
 } from 'fs';
 import { join } from 'path';
 import { remove, copy } from 'fs-extra';
+import os from 'os';
 import {
   SKILLS,
   AGENTS,
   getAgentsSkillsDir,
   getClaudeAgentsDir,
-  getAgentsDir,
-  AGENTS_TEMPLATE_FILE,
 } from './config.js';
+import { removeSkills, removeAgents } from './cleanup.js';
 
 /**
  * Recursively copy a directory
@@ -36,25 +36,15 @@ export async function copyDirectory(src, dest) {
   await copy(src, dest, { overwrite: true });
 }
 
-/**
- * Remove existing file or directory
- * @param {string} target - Path to remove
- * @returns {Promise<void>}
- */
-export async function removeExisting(target) {
-  if (existsSync(target)) {
-    await remove(target);
-  }
-}
-
 /**
  * Install a single skill to the agents skills directory
  * @param {string} repoDir - Repository directory
  * @param {string} skillName - Name of the skill
+ * @param {string} baseDir - Base directory for installation
  * @returns {Promise<boolean>} True if installed successfully
  */
-export async function installSkill(repoDir, skillName) {
-  const skillsDir = getAgentsSkillsDir();
+export async function installSkill(repoDir, skillName, baseDir = os.homedir()) {
+  const skillsDir = getAgentsSkillsDir(baseDir);
   const skillSrc = join(repoDir, 'skills', skillName);
   const skillDest = join(skillsDir, skillName);
 
@@ -81,16 +71,28 @@ export async function installSkill(repoDir, skillName) {
 /**
  * Install all skills to the agents skills directory
  * @param {string} repoDir - Repository directory
+ * @param {string} baseDir - Base directory for installation
  * @returns {Promise<Object>} Results object with success/failure counts
  */
-export async function installSkills(repoDir) {
+export async function installSkills(repoDir, baseDir = os.homedir()) {
   const results = {
     installed: [],
     failed: [],
+    removed: [],
   };
 
+  const legacyLocal = removeSkills(baseDir, { legacyOnly: true });
+  results.removed.push(...legacyLocal.removed);
+  results.failed.push(...legacyLocal.failed);
+
+  if (baseDir && baseDir !== os.homedir()) {
+    const legacyGlobal = removeSkills(undefined, { legacyOnly: true });
+    results.removed.push(...legacyGlobal.removed);
+    results.failed.push(...legacyGlobal.failed);
+  }
+
   for (const skill of SKILLS) {
-    if (await installSkill(repoDir, skill)) {
+    if (await installSkill(repoDir, skill, baseDir)) {
       results.installed.push(skill);
     } else {
       results.failed.push(skill);
@@ -104,10 +106,11 @@ export async function installSkills(repoDir) {
  * Install a single agent to Claude agents directory
  * @param {string} repoDir - Repository directory
  * @param {string} agentName - Name of the agent (without .md)
+ * @param {string} baseDir - Base directory for installation
  * @returns {Promise<boolean>} True if installed successfully
  */
-export async function installAgent(repoDir, agentName) {
-  const agentsDir = getClaudeAgentsDir();
+export async function installAgent(repoDir, agentName, baseDir = os.homedir()) {
+  const agentsDir = getClaudeAgentsDir(baseDir);
   const agentSrc = join(repoDir, 'agents', `${agentName}.md`);
   const agentDest = join(agentsDir, `${agentName}.md`);
 
@@ -134,16 +137,28 @@ export async function installAgent(repoDir, agentName) {
 /**
  * Install all agents to Claude agents directory
  * @param {string} repoDir - Repository directory
+ * @param {string} baseDir - Base directory for installation
  * @returns {Promise<Object>} Results object with success/failure counts
  */
-export async function installAgents(repoDir) {
+export async function installAgents(repoDir, baseDir = os.homedir()) {
   const results = {
     installed: [],
     failed: [],
+    removed: [],
   };
 
+  const legacyLocal = removeAgents(baseDir, { legacyOnly: true });
+  results.removed.push(...legacyLocal.removed);
+  results.failed.push(...legacyLocal.failed);
+
+  if (baseDir && baseDir !== os.homedir()) {
+    const legacyGlobal = removeAgents(undefined, { legacyOnly: true });
+    results.removed.push(...legacyGlobal.removed);
+    results.failed.push(...legacyGlobal.failed);
+  }
+
   for (const agent of AGENTS) {
-    if (await installAgent(repoDir, agent)) {
+    if (await installAgent(repoDir, agent, baseDir)) {
       results.installed.push(agent);
     } else {
       results.failed.push(agent);
@@ -153,78 +168,6 @@ export async function installAgents(repoDir) {
   return results;
 }
 
-/**
- * Install AGENTS-TEMPLATE.md to the agents directory
- * @param {string} repoDir - Repository directory
- * @returns {Promise<boolean>} True if installed successfully
- */
-export async function installAgentsTemplate(repoDir) {
-  const agentsDir = getAgentsDir();
-  const templateSrc = join(repoDir, AGENTS_TEMPLATE_FILE);
-  const templateDest = join(agentsDir, AGENTS_TEMPLATE_FILE);
-
-  // Create agents directory if needed
-  if (!existsSync(agentsDir)) {
-    mkdirSync(agentsDir, { recursive: true });
-  }
-
-  // Check if source exists
-  if (!existsSync(templateSrc)) {
-    return false;
-  }
-
-  // Copy template file
-  copyFileSync(templateSrc, templateDest);
-  return true;
-}
-
-/**
- * Install the ti-docs-index helper script
- * @param {string} repoDir - Repository directory
- * @param {string} binDir - Bin directory path
- * @returns {Promise<boolean>} True if installed successfully
- */
-export async function installTiDocsIndexScript(repoDir, binDir) {
-  const scriptSrc = join(repoDir, 'scripts', 'ti-docs-index');
-  const scriptDest = join(binDir, 'ti-docs-index');
-
-  // Check if source exists
-  if (!existsSync(scriptSrc)) {
-    return false;
-  }
-
-  // Create bin directory if needed
-  if (!existsSync(binDir)) {
-    try {
-      mkdirSync(binDir, { recursive: true });
-    } catch {
-      // If we can't create the bin dir, skip script installation
-      return false;
-    }
-  }
-
-  // Try to copy script file
-  try {
-    copyFileSync(scriptSrc, scriptDest);
-  } catch (error) {
-    // If we can't write to binDir (permission denied), skip script installation
-    if (error.code === 'EACCES' || error.code === 'EPERM') {
-      return false;
-    }
-    throw error;
-  }
-
-  // Make executable (chmod +x)
-  try {
-    const { chmod } = await import('fs/promises');
-    await chmod(scriptDest, 0o755);
-  } catch {
-    // Ignore permission errors
-  }
-
-  return true;
-}
-
 /**
  * Get the local repository directory if running from source
  * @returns {string|null} Local repo directory or null
@@ -242,12 +185,9 @@ export function getLocalRepoDir() {
 
 export default {
   copyDirectory,
-  removeExisting,
   installSkill,
   installSkills,
   installAgent,
   installAgents,
-  installAgentsTemplate,
-  installTiDocsIndexScript,
   getLocalRepoDir,
 };

package/lib/platform.js

@@ -4,16 +4,18 @@
  */
 
 import { existsSync } from 'fs';
-import { PLATFORMS } from './config.js';
+import { getPlatforms } from './config.js';
 
 /**
  * Detect installed AI coding assistant platforms
+ * @param {string} baseDir - Optional base directory to check
  * @returns {Array} Detected platforms
  */
-export function detectPlatforms() {
+export function detectPlatforms(baseDir) {
   const detected = [];
+  const platforms = getPlatforms(baseDir);
 
-  for (const platform of PLATFORMS) {
+  for (const platform of platforms) {
     if (existsSync(platform.configDir)) {
       detected.push(platform);
     }
@@ -25,10 +27,12 @@ export function detectPlatforms() {
 /**
  * Get platform by name
  * @param {string} name - Platform name (claude, gemini, codex)
+ * @param {string} baseDir - Optional base directory
  * @returns {Object|null} Platform object or null
  */
-export function getPlatformByName(name) {
-  return PLATFORMS.find((p) => p.name === name) || null;
+export function getPlatformByName(name, baseDir) {
+  const platforms = getPlatforms(baseDir);
+  return platforms.find((p) => p.name === name) || null;
 }
 
 /**

package/lib/prompts/checkboxCancel.js

@@ -0,0 +1,264 @@
+import {
+  Separator,
+  ValidationError,
+  createPrompt,
+  isDownKey,
+  isEnterKey,
+  isNumberKey,
+  isSpaceKey,
+  isUpKey,
+  makeTheme,
+  useKeypress,
+  useMemo,
+  usePagination,
+  usePrefix,
+  useState,
+} from '@inquirer/core';
+import { cursorHide } from '@inquirer/ansi';
+import { styleText } from 'node:util';
+import figures from '@inquirer/figures';
+
+const checkboxTheme = {
+  icon: {
+    checked: styleText('green', figures.circleFilled),
+    unchecked: figures.circle,
+    cursor: figures.pointer,
+  },
+  style: {
+    disabledChoice: (text) => styleText('dim', `- ${text}`),
+    renderSelectedChoices: (selectedChoices) =>
+      selectedChoices.map((choice) => choice.short).join(', '),
+    description: (text) => styleText('cyan', text),
+    keysHelpTip: (keys) =>
+      keys
+        .map(([key, action]) => `${styleText('bold', key)} ${styleText('dim', action)}`)
+        .join(styleText('dim', ' • ')),
+  },
+  keybindings: [],
+};
+
+function isSelectable(item) {
+  return !Separator.isSeparator(item) && !item.disabled;
+}
+
+function isChecked(item) {
+  return isSelectable(item) && item.checked;
+}
+
+function toggle(item) {
+  return isSelectable(item) ? { ...item, checked: !item.checked } : item;
+}
+
+function check(checked) {
+  return function (item) {
+    return isSelectable(item) ? { ...item, checked } : item;
+  };
+}
+
+function normalizeChoices(choices) {
+  return choices.map((choice) => {
+    if (Separator.isSeparator(choice)) return choice;
+    if (typeof choice === 'string') {
+      return {
+        value: choice,
+        name: choice,
+        short: choice,
+        checkedName: choice,
+        disabled: false,
+        checked: false,
+      };
+    }
+    const name = choice.name ?? String(choice.value);
+    const normalizedChoice = {
+      value: choice.value,
+      name,
+      short: choice.short ?? name,
+      checkedName: choice.checkedName ?? name,
+      disabled: choice.disabled ?? false,
+      checked: choice.checked ?? false,
+    };
+    if (choice.description) {
+      normalizedChoice.description = choice.description;
+    }
+    return normalizedChoice;
+  });
+}
+
+const checkboxCancel = createPrompt((config, done) => {
+  const {
+    pageSize = 7,
+    loop = true,
+    required,
+    validate = () => true,
+    cancelValue = 'cancel',
+  } = config;
+  
+  // Shortcuts handling - allow disabling by setting to false or null
+  const shortcuts = { 
+    all: config.shortcuts?.all === undefined ? 'a' : config.shortcuts.all,
+    invert: config.shortcuts?.invert === undefined ? 'i' : config.shortcuts.invert
+  };
+  
+  const theme = makeTheme(checkboxTheme, config.theme);
+  const { keybindings } = theme;
+  const [status, setStatus] = useState('idle');
+  const prefix = usePrefix({ status, theme });
+  const [items, setItems] = useState(normalizeChoices(config.choices));
+  const bounds = useMemo(() => {
+    const first = items.findIndex(isSelectable);
+    const last = items.findLastIndex(isSelectable);
+    if (first === -1) {
+      throw new ValidationError('[checkbox prompt] No selectable choices. All choices are disabled.');
+    }
+    return { first, last };
+  }, [items]);
+  const [active, setActive] = useState(bounds.first);
+  const [errorMsg, setError] = useState();
+  const [cancelled, setCancelled] = useState(false);
+
+  useKeypress(async (key) => {
+    if (key.name?.toLowerCase() === 'q') {
+      setCancelled(true);
+      setStatus('done');
+      done([cancelValue]);
+      return;
+    }
+    if (isEnterKey(key)) {
+      const activeItem = items[active];
+      
+      // If the active item IS the cancel option, cancel immediately
+      if (isSelectable(activeItem) && activeItem.value === cancelValue) {
+        setCancelled(true);
+        setStatus('done');
+        done([cancelValue]);
+        return;
+      }
+
+      // If ANY checked item is the cancel option, cancel immediately
+      const anyCancelChecked = items.some(
+        (item) => isSelectable(item) && item.value === cancelValue && item.checked
+      );
+      if (anyCancelChecked) {
+        setCancelled(true);
+        setStatus('done');
+        done([cancelValue]);
+        return;
+      }
+
+      const selection = items.filter(isChecked);
+      const isValid = await validate([...selection]);
+      if (required && selection.length === 0) {
+        setError('At least one choice must be selected');
+      } else if (isValid === true) {
+        setStatus('done');
+        done(selection.map((choice) => choice.value));
+      } else {
+        setError(isValid || 'You must select a valid value');
+      }
+    } else if (isUpKey(key, keybindings) || isDownKey(key, keybindings)) {
+      if (
+        loop ||
+        (isUpKey(key, keybindings) && active !== bounds.first) ||
+        (isDownKey(key, keybindings) && active !== bounds.last)
+      ) {
+        const offset = isUpKey(key, keybindings) ? -1 : 1;
+        let next = active;
+        do {
+          next = (next + offset + items.length) % items.length;
+        } while (!isSelectable(items[next]));
+        setActive(next);
+      }
+    } else if (isSpaceKey(key)) {
+      setError(undefined);
+      setItems(items.map((choice, i) => (i === active ? toggle(choice) : choice)));
+    } else if (shortcuts.all && key.name === shortcuts.all) {
+      const selectAll = items.some((choice) => isSelectable(choice) && !choice.checked && choice.value !== cancelValue);
+      setItems(items.map((item) => {
+        if (isSelectable(item) && item.value !== cancelValue) {
+          return { ...item, checked: selectAll };
+        }
+        return item;
+      }));
+    } else if (shortcuts.invert && key.name === shortcuts.invert) {
+      setItems(items.map((item) => {
+        if (isSelectable(item) && item.value !== cancelValue) {
+          return toggle(item);
+        }
+        return item;
+      }));
+    } else if (isNumberKey(key)) {
+      const selectedIndex = Number(key.name) - 1;
+      let selectableIndex = -1;
+      const position = items.findIndex((item) => {
+        if (Separator.isSeparator(item)) return false;
+        selectableIndex++;
+        return selectableIndex === selectedIndex;
+      });
+      const selectedItem = items[position];
+      if (selectedItem && isSelectable(selectedItem)) {
+        setActive(position);
+        setItems(items.map((choice, i) => (i === position ? toggle(choice) : choice)));
+      }
+    }
+  });
+
+  const message = theme.style.message(config.message, status);
+  let description;
+  const page = usePagination({
+    items,
+    active,
+    renderItem({ item, isActive }) {
+      if (Separator.isSeparator(item)) {
+        return ` ${item.separator}`;
+      }
+      if (item.disabled) {
+        const disabledLabel = typeof item.disabled === 'string' ? item.disabled : '(disabled)';
+        return theme.style.disabledChoice(`${item.name} ${disabledLabel}`);
+      }
+      if (isActive) {
+        description = item.description;
+      }
+      const checkbox = item.checked ? theme.icon.checked : theme.icon.unchecked;
+      const name = item.checked ? item.checkedName : item.name;
+      const color = isActive ? theme.style.highlight : (x) => x;
+      const cursor = isActive ? theme.icon.cursor : ' ';
+      return color(`${cursor}${checkbox} ${name}`);
+    },
+    pageSize,
+    loop,
+  });
+
+  if (status === 'done') {
+    if (cancelled) {
+      return [prefix, message].filter(Boolean).join(' ');
+    }
+    const selection = items.filter(item => isChecked(item) && item.value !== cancelValue);
+    const answer = theme.style.answer(theme.style.renderSelectedChoices(selection, items));
+    return [prefix, message, answer].filter(Boolean).join(' ');
+  }
+
+  const keys = [
+    ['↑↓', 'navigate'],
+    ['space', 'select'],
+  ];
+  if (shortcuts.all) keys.push([shortcuts.all, 'all']);
+  if (shortcuts.invert) keys.push([shortcuts.invert, 'invert']);
+  keys.push(['⏎', 'submit']);
+  keys.push(['q', 'quit']);
+  const helpLine = theme.style.keysHelpTip(keys);
+  const lines = [
+    [prefix, message].filter(Boolean).join(' '),
+    page,
+    ' ',
+    description ? theme.style.description(description) : '',
+    errorMsg ? theme.style.error(errorMsg) : '',
+    helpLine,
+  ]
+    .filter(Boolean)
+    .join('\n')
+    .trimEnd();
+  return `${lines}${cursorHide}`;
+});
+
+export { Separator };
+export default checkboxCancel;