@maccesar/titools 2.2.8 → 2.2.10

package/agents/ti-pro.md

@@ -1,6 +1,6 @@
 ---
 name: ti-pro
-description: Titanium SDK and Alloy research specialist. Preloads all 7 titanium-related skills for comprehensive analysis. Use proactively for: analyzing Titanium/Alloy codebases, reviewing Alloy app architecture, researching Titanium SDK implementations, exploring mobile app architectural questions, multi-feature research across Titanium APIs, cross-referencing framework patterns, or investigating platform-specific Titanium differences. Returns findings with specific file/line references from all documentation.
+description: Titanium SDK and Alloy research specialist. Loads the 7 Titanium skills and uses them together to answer research-style questions. Use for codebase analysis, architecture reviews, Titanium SDK implementation research, cross-feature questions, and platform-specific differences. Returns concrete findings with file and line references.
 skills:
   - alloy-guides
   - alloy-howtos
@@ -15,27 +15,27 @@ model: sonnet
 
 # Titanium SDK Research Specialist
 
-You are a deep-dive research specialist for Titanium SDK and Alloy mobile development.
+You are a research specialist for Titanium SDK and Alloy mobile development. With more than 15 year of experience.
 
 ## What You Do
 
-When invoked, you research complex topics by consulting **all 7 preloaded titanium-\*** skills:
+When invoked, you research complex topics by consulting all 7 Titanium skills:
 
 - `ti-expert` - Architecture, patterns, conventions
 - `alloy-guides` - Alloy MVC complete reference
 - `alloy-howtos` - CLI, config, debugging
-- `purgetss` - Utility-first styling classes (optional addon — use when the project already has it or the user asks about it)
+- `purgetss` - Utility-first styling classes (optional add-on; use when the project already has it or the user asks about it)
 - `ti-guides` - SDK official guides, Hyperloop, distribution
 - `ti-howtos` - Native features, platform-specific APIs
 - `ti-ui` - UI/UX patterns, layouts, gestures
 
 ## Research Process
 
-1. **Understand the query** - What specific aspect needs research?
-2. **Consult ALL relevant skills** - All skills are preloaded in your context
-3. **Cross-reference** - Find connections across multiple skills
-4. **Provide specifics** - Include file paths, line numbers, code examples
-5. **Cite sources** - Reference which skill and file each answer comes from
+1. **Understand the query** - Identify what needs research.
+2. **Consult all relevant skills** - Use the full set.
+3. **Cross-reference** - Connect findings across skills.
+4. **Provide specifics** - Include file paths, line numbers, and code examples.
+5. **Cite sources** - Note which skill and file each answer comes from.
 
 ## What You're Good For
 
@@ -47,7 +47,7 @@ When invoked, you research complex topics by consulting **all 7 preloaded titani
 | **Architecture review**    | "Review this project's folder structure and service layer"         |
 | **Platform differences**   | "Research iOS vs Android differences for this feature"             |
 
-## What You're NOT For
+## What You're Not For
 
 | Use Instead                                  | Reason                                 |
 | -------------------------------------------- | -------------------------------------- |
@@ -60,11 +60,11 @@ When invoked, you research complex topics by consulting **all 7 preloaded titani
 
 When returning research findings:
 
-1. **Summary** - Brief overview of findings
-2. **Key Points** - Bulleted list with specific references
-3. **Code Examples** - From the skills, with source citations
-4. **Related Skills** - Which skills were consulted
-5. **File References** - Specific `path:line` format
+1. **Summary** - Brief overview of findings.
+2. **Key Points** - Bulleted list with specific references.
+3. **Code Examples** - From the skills, with source citations.
+4. **Related Skills** - Which skills were consulted.
+5. **File References** - Specific `path:line` format.
 
 Example:
 ```markdown
@@ -81,7 +81,7 @@ Your app uses `Ti.App.fireEvent` which causes memory leaks.
 
 ## Tool Usage
 
-You have **read-only tools**: `Read`, `Grep`, `Glob`, `Bash`
+You have read-only tools: `Read`, `Grep`, `Glob`, `Bash`.
 
 Use them to:
 - Search the codebase when asked to analyze it
@@ -89,7 +89,7 @@ Use them to:
 - Verify claims against actual code
 - List files/directories and inspect structure with shell commands
 
-You **cannot** modify files. If the user asks for changes, provide the research and suggest using the appropriate skill or main conversation for implementation.
+You cannot modify files. If the user asks for changes, provide the research and suggest using the appropriate skill or main conversation for implementation.
 
 ---
 

package/lib/commands/update.js

@@ -23,7 +23,7 @@ import {
 import { agentsCommand } from './agents.js';
 import {
   checkForUpdate,
-  fetchLatestVersion,
+  fetchLatestNpmVersion,
 } from '../downloader.js';
 import { createSkillSymlinks } from '../symlink.js';
 import { formatList, isTitaniumProject } from '../utils.js';
@@ -42,6 +42,49 @@ function hasAnySkillSymlink(platformSkillsDir) {
   return skillList.some((skill) => existsSync(join(platformSkillsDir, skill)));
 }
 
+/**
+ * Perform the actual update for a specific scope
+ * @param {string|undefined} baseDir - Base directory (undefined = global, path = local)
+ * @param {string} repoDir - Repository directory
+ * @param {Object} spinner - Ora spinner instance
+ * @returns {Promise<void>}
+ */
+async function performUpdate(baseDir, repoDir, spinner) {
+  // Detect platforms with existing symlinks (only update those)
+  const detectedPlatforms = detectPlatforms(baseDir);
+  const platformsWithSymlinks = detectedPlatforms.filter((p) =>
+    hasAnySkillSymlink(p.skillsDir)
+  );
+
+  // Install skills
+  spinner.start('Syncing skills...');
+  const skillsResult = await installSkills(repoDir, baseDir);
+  spinner.succeed(`${skillsResult.installed.length} skills updated`);
+
+  // Install agents (only if Claude Code has symlinks)
+  const claudePlatform = platformsWithSymlinks.find((p) => p.name === 'claude');
+  if (claudePlatform) {
+    spinner.start('Syncing agents...');
+    const agentsResult = await installAgents(repoDir, baseDir);
+    if (agentsResult.installed.length > 0) {
+      spinner.succeed('Platform agents updated');
+    } else {
+      spinner.info('No agents to sync');
+    }
+  }
+
+  cleanupLegacyArtifacts(baseDir);
+
+  // Update symlinks silently for platforms that already had them
+  for (const platform of platformsWithSymlinks) {
+    await createSkillSymlinks(
+      platform.skillsDir,
+      SKILLS,
+      baseDir
+    );
+  }
+}
+
 /**
  * Update command handler
  * @param {Object} options - Command options
@@ -65,15 +108,16 @@ export async function updateCommand(options) {
     const localPlatforms = detectPlatforms(projectDir);
     const hasLocalSkills = isProject && hasSkillsAt(projectDir);
     const hasGlobalSkills = hasSkillsAt(undefined);
-    if (hasLocalSkills && !hasGlobalSkills) {
-      baseDir = projectDir;
-    } else if (isProject && localPlatforms.length > 0) {
+
+    // Only show prompt if BOTH local and global skills exist
+    if (hasLocalSkills && hasGlobalSkills) {
       try {
         const scope = await select({
-          message: 'Local installation detected. What do you want to update:',
+          message: 'Both local and global skills detected. What do you want to update:',
           choices: [
             { name: 'Global skills (user home)', value: 'global' },
             { name: 'Local skills (current project)', value: 'local' },
+            { name: 'Both locations', value: 'both' },
           ],
           theme: {
             style: {
@@ -87,32 +131,44 @@ export async function updateCommand(options) {
           process.exit(0);
         }
         if (scope === 'local') {
-          baseDir = process.cwd();
+          baseDir = projectDir;
+        } else if (scope === 'both') {
+          baseDir = 'both';
         }
       } catch (error) {
         console.log('\nCancelled.');
         process.exit(0);
       }
+    } else if (hasLocalSkills && !hasGlobalSkills) {
+      // Only local skills exist, update local
+      baseDir = projectDir;
     }
+    // If only global skills exist, baseDir remains undefined (global)
   }
 
-  if (baseDir) {
+  // Display mode
+  if (baseDir === 'both') {
+    console.log(chalk.cyan('Mode: Updating both global and local skills'));
+  } else if (baseDir) {
     console.log(chalk.cyan('Mode: Local update (current project)'));
   } else {
     console.log(chalk.cyan('Mode: Global update (user home)'));
   }
   console.log('');
 
-  const skillsDir = getAgentsSkillsDir(baseDir);
-  const hasSkillsInstalled = skillsDir && SKILLS.some((skill) => existsSync(join(skillsDir, skill)));
-  if (!hasSkillsInstalled) {
-    console.log(chalk.yellow('No skills installed at this location.'));
-    console.log('Install them first with:');
-    console.log('  titools install');
-    console.log('');
-    console.log('Looked for skills in:');
-    console.log(`  ${baseDir ? 'Local' : 'Global'}: ${skillsDir}`);
-    return;
+  // Verify skills are installed
+  if (baseDir !== 'both') {
+    const skillsDir = getAgentsSkillsDir(baseDir);
+    const hasSkillsInstalled = skillsDir && SKILLS.some((skill) => existsSync(join(skillsDir, skill)));
+    if (!hasSkillsInstalled) {
+      console.log(chalk.yellow('No skills installed at this location.'));
+      console.log('Install them first with:');
+      console.log('  titools install');
+      console.log('');
+      console.log('Looked for skills in:');
+      console.log(`  ${baseDir ? 'Local' : 'Global'}: ${skillsDir}`);
+      return;
+    }
   }
 
   // Check for updates
@@ -121,11 +177,11 @@ export async function updateCommand(options) {
   try {
     const hasUpdate = await checkForUpdate(PACKAGE_VERSION);
 
-    // If there's a newer version on GitHub, prompt user to update CLI first
+    // If there's a newer version on npm, prompt user to update CLI first
     if (hasUpdate) {
       let latestVersion = '(newer)';
       try {
-        latestVersion = await fetchLatestVersion();
+        latestVersion = await fetchLatestNpmVersion();
       } catch {
         // Ignore error, we already know there's an update
       }
@@ -158,38 +214,18 @@ export async function updateCommand(options) {
       return;
     }
 
-    // Detect platforms with existing symlinks (only update those)
-    const detectedPlatforms = detectPlatforms(baseDir);
-    const platformsWithSymlinks = detectedPlatforms.filter((p) =>
-      hasAnySkillSymlink(p.skillsDir)
-    );
-
-    // Install skills
-    spinner.start('Syncing skills...');
-    const skillsResult = await installSkills(repoDir, baseDir);
-    spinner.succeed(`${skillsResult.installed.length} skills updated`);
-
-    // Install agents (only if Claude Code has symlinks)
-    const claudePlatform = platformsWithSymlinks.find((p) => p.name === 'claude');
-    if (claudePlatform) {
-      spinner.start('Syncing agents...');
-      const agentsResult = await installAgents(repoDir, baseDir);
-      if (agentsResult.installed.length > 0) {
-        spinner.succeed('Platform agents updated');
-      } else {
-        spinner.info('No agents to sync');
-      }
-    }
-
-    cleanupLegacyArtifacts(baseDir);
+    // Perform update(s)
+    if (baseDir === 'both') {
+      // Update both global and local
+      console.log(chalk.bold('Updating global skills...'));
+      await performUpdate(undefined, repoDir, spinner);
+      console.log('');
 
-    // Update symlinks silently for platforms that already had them
-    for (const platform of platformsWithSymlinks) {
-      await createSkillSymlinks(
-        platform.skillsDir,
-        SKILLS,
-        baseDir
-      );
+      console.log(chalk.bold('Updating local skills...'));
+      await performUpdate(process.cwd(), repoDir, spinner);
+    } else {
+      // Update single scope
+      await performUpdate(baseDir, repoDir, spinner);
     }
 
     // Summary

package/lib/downloader.js

@@ -112,13 +112,28 @@ export async function downloadRawFile(filePath, destPath, ref = 'main') {
 }
 
 /**
- * Check if an update is available
+ * Fetch latest version from npm registry
+ * @returns {Promise<string>} Latest version number
+ */
+export async function fetchLatestNpmVersion() {
+  const response = await fetch('https://registry.npmjs.org/@maccesar/titools');
+
+  if (!response.ok) {
+    throw new Error(`Failed to fetch npm info: ${response.statusText}`);
+  }
+
+  const data = await response.json();
+  return data['dist-tags'].latest;
+}
+
+/**
+ * Check if an update is available (checks npm)
  * @param {string} currentVersion - Current version
  * @returns {Promise<boolean>} True if update available
  */
 export async function checkForUpdate(currentVersion) {
   try {
-    const latestVersion = await fetchLatestVersion();
+    const latestVersion = await fetchLatestNpmVersion();
     // Remove 'v' prefix if present
     const latest = latestVersion.replace(/^v/, '');
     const current = currentVersion.replace(/^v/, '');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "2.2.8",
+  "version": "2.2.10",
   "description": "Titanium SDK skills and agents for AI coding assistants (Claude Code, Gemini CLI, Codex CLI)",
   "main": "lib/index.js",
   "type": "module",