@maccesar/titools 2.2.2 → 2.2.4

package/README.md

@@ -619,13 +619,14 @@ Behavior depends on where you run it:
 | Inside a Titanium project (with existing knowledge index files) | Also refreshes `AGENTS.md`/`CLAUDE.md`/`GEMINI.md`          |
 
 What it does:
-- Checks GitHub for the latest version
-- Downloads and installs updated skills and agents
-- Updates platform symlinks for all detected platforms
-- Cleans up legacy artifacts (`alloy-expert` skill, `ti-researcher` agent)
-- Auto-syncs knowledge index files if they exist in the current project
-
-Note: This updates knowledge packages and agents, not the CLI binary itself. To update the CLI, use `npm update -g @maccesar/titools`.
+1. Checks GitHub for the latest CLI version
+2. If a newer version exists → prompts you to update the CLI first with `npm update -g @maccesar/titools`
+3. If CLI is current → syncs skills and agents from the installed package (no download needed)
+4. Updates platform symlinks only for platforms that already have them
+5. Cleans up legacy artifacts (`alloy-expert` skill, `ti-researcher` agent)
+6. Auto-syncs knowledge index files if they exist in the current project
+
+Note: This command syncs knowledge packages and agents from your installed CLI. To get new features, first update the CLI with `npm update -g @maccesar/titools`, then run `titools update`.
 
 ### titools remove
 

package/lib/commands/update.js

@@ -14,7 +14,7 @@ import select from '../prompts/selectCancel.js';
 import {
   detectPlatforms,
 } from '../platform.js';
-import { cleanupLegacyArtifacts } from '../cleanup.js';
+import { cleanupLegacyArtifacts, getSkillList } from '../cleanup.js';
 import {
   installSkills,
   installAgents,
@@ -22,16 +22,25 @@ import {
 } from '../installer.js';
 import { agentsCommand } from './agents.js';
 import {
-  downloadRepoArchive,
   checkForUpdate,
+  fetchLatestVersion,
 } from '../downloader.js';
 import { createSkillSymlinks } from '../symlink.js';
 import { formatList, isTitaniumProject } from '../utils.js';
 import { getAgentsSkillsDir } from '../config.js';
-import { mkdtemp } from 'fs/promises';
 import { existsSync } from 'fs';
 import { join, resolve } from 'path';
-import { tmpdir } from 'os';
+
+/**
+ * Check if a platform has any skill symlinks installed
+ * @param {string} platformSkillsDir - Platform skills directory
+ * @returns {boolean} True if any skill symlink exists
+ */
+function hasAnySkillSymlink(platformSkillsDir) {
+  if (!platformSkillsDir || !existsSync(platformSkillsDir)) return false;
+  const skillList = getSkillList();
+  return skillList.some((skill) => existsSync(join(platformSkillsDir, skill)));
+}
 
 /**
  * Update command handler
@@ -112,122 +121,100 @@ export async function updateCommand(options) {
   try {
     const hasUpdate = await checkForUpdate(PACKAGE_VERSION);
 
-    if (!hasUpdate) {
-      spinner.info(`Already up to date (v${PACKAGE_VERSION})`);
-      cleanupLegacyArtifacts(baseDir);
-      console.log('');
-      console.log(chalk.green('✓'), 'Skills and agents are already at the latest version');
-      const projectDir = resolve(process.cwd());
-      if (isTitaniumProject(projectDir)) {
-        const aiFiles = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
-        const hasAnyAiFile = aiFiles.some((file) => existsSync(join(projectDir, file)));
-        if (hasAnyAiFile) {
-          await agentsCommand(projectDir, { onlyExisting: true, force: true });
-        }
+    // If there's a newer version on GitHub, prompt user to update CLI first
+    if (hasUpdate) {
+      let latestVersion = '(newer)';
+      try {
+        latestVersion = await fetchLatestVersion();
+      } catch {
+        // Ignore error, we already know there's an update
       }
-      console.log('');
-      return;
-    }
-
-    spinner.succeed(`Update available!`);
-    console.log('');
-    console.log(chalk.gray(`Current: ${PACKAGE_VERSION}`));
-    console.log(chalk.gray(`Latest:  (from GitHub)`));
-    console.log('');
-
-    // Detect installed platforms at target
-    const detectedPlatforms = detectPlatforms(baseDir);
 
-    if (detectedPlatforms.length === 0) {
-      console.log(chalk.yellow('No AI coding assistants detected.'));
-      if (baseDir) {
-        console.log('Update will install skills to ./.agents/skills/');
-      } else {
-        console.log('Update will install skills to ~/.agents/skills/');
-      }
+      spinner.warn('New version available');
       console.log('');
-    } else {
-      for (const platform of detectedPlatforms) {
-        console.log(chalk.green('✓'), platform.displayName);
-      }
+      console.log(chalk.yellow('A newer version is available on npm:'));
+      console.log(`  Current: ${chalk.gray('v' + PACKAGE_VERSION)}`);
+      console.log(`  Latest:  ${chalk.green(latestVersion)}`);
+      console.log('');
+      console.log('To update, run:');
+      console.log(`  ${chalk.cyan('npm update -g @maccesar/titools')}`);
+      console.log('');
+      console.log('Then run this command again:');
+      console.log(`  ${chalk.cyan('titools update')}`);
       console.log('');
+      return;
     }
 
-    // Download latest from GitHub
-    spinner.start('Downloading latest from GitHub...');
-
-    let repoDir = getLocalRepoDir();
-    let tempDir = null;
+    // CLI is up to date, now sync skills from the installed package
+    spinner.succeed(`CLI is up to date (v${PACKAGE_VERSION})`);
 
+    // Get repository directory from the installed package
+    const repoDir = getLocalRepoDir();
     if (!repoDir) {
-      tempDir = await mkdtemp(join(tmpdir(), 'titanium-skills-'));
-      repoDir = await downloadRepoArchive(tempDir);
+      console.log('');
+      console.log(chalk.red('Error: Could not locate skills source directory.'));
+      console.log('Try reinstalling with:');
+      console.log(`  ${chalk.cyan('npm install -g titools')}`);
+      return;
     }
 
-    spinner.succeed('Downloaded from GitHub');
-
-    try {
-      // Install skills
-      spinner.start('Updating skills...');
-      const skillsResult = await installSkills(repoDir, baseDir);
-      spinner.succeed(
-        `Skills: ${formatList(skillsResult.installed)}`
-      );
-
-      // Install agents
-      spinner.start('Updating agents...');
+    // 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(`Skills: ${formatList(skillsResult.installed)}`);
+
+    // 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(
-          `Agents: ${formatList(agentsResult.installed)}`
-        );
+        spinner.succeed(`Agents: ${formatList(agentsResult.installed)}`);
       } else {
-        spinner.info('No agents to update');
+        spinner.info('No agents to sync');
       }
+    }
 
-      cleanupLegacyArtifacts(baseDir);
+    cleanupLegacyArtifacts(baseDir);
 
-      // Update symlinks for detected platforms
-      for (const platform of detectedPlatforms) {
-        spinner.start(`Updating ${platform.displayName} symlinks...`);
-        const symlinkResult = await createSkillSymlinks(
-          platform.skillsDir,
-          SKILLS,
-          baseDir
-        );
-        if (symlinkResult.linked.length === SKILLS.length) {
-          spinner.succeed(`${platform.displayName} linked`);
-        } else {
-          spinner.warn(
-            `${platform.displayName}: ${symlinkResult.linked.length}/${SKILLS.length} linked`
-          );
-        }
-      }
-
-      // Summary
-      console.log('');
-      console.log(chalk.green('✓ Update complete!'));
-      console.log('');
-      const projectDir = resolve(process.cwd());
-      if (isTitaniumProject(projectDir)) {
-        const aiFiles = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
-        const hasAnyAiFile = aiFiles.some((file) => existsSync(join(projectDir, file)));
-        if (hasAnyAiFile) {
-          await agentsCommand(projectDir, { onlyExisting: true, force: true });
-        } else {
-          console.log(chalk.bold('▸'), 'Run in the Titanium project:', chalk.cyan('titools sync'));
-        }
+    // Update symlinks only for platforms that already had them
+    for (const platform of platformsWithSymlinks) {
+      spinner.start(`Updating ${platform.displayName} symlinks...`);
+      const symlinkResult = await createSkillSymlinks(
+        platform.skillsDir,
+        SKILLS,
+        baseDir
+      );
+      if (symlinkResult.linked.length === SKILLS.length) {
+        spinner.succeed(`${platform.displayName} linked`);
       } else {
-        console.log(chalk.bold('▸'), 'Run in the Titanium project:', chalk.cyan('titools sync'));
+        spinner.warn(
+          `${platform.displayName}: ${symlinkResult.linked.length}/${SKILLS.length} linked`
+        );
       }
-      console.log('');
+    }
 
-    } finally {
-      // Clean up temp directory
-      if (tempDir) {
-        await import('fs-extra').then(({ remove }) => remove(tempDir));
+    // Summary
+    console.log('');
+    console.log(chalk.green('✓ Update complete!'));
+
+    // Update knowledge index in MD files if in a Titanium project
+    const projectDir = resolve(process.cwd());
+    if (isTitaniumProject(projectDir)) {
+      const aiFiles = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
+      const hasAnyAiFile = aiFiles.some((file) => existsSync(join(projectDir, file)));
+      if (hasAnyAiFile) {
+        console.log('');
+        await agentsCommand(projectDir, { onlyExisting: true, force: true });
       }
     }
+    console.log('');
 
   } catch (error) {
     spinner.fail('Update failed');

package/package.json

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

package/skills/ti-expert/references/theming.md

@@ -263,26 +263,68 @@ exports.ThemeService = {
 }
 ```
 
-### Semantic Colors (iOS)
+### Semantic Colors (Cross-Platform)
 
-Titanium supports iOS semantic colors that automatically adapt to Dark Mode:
+Titanium provides a cross-platform semantic colors API for Dark Mode support. Define colors in a `semantic.colors.json` file:
+
+**File location:**
+- **Classic apps**: `Resources/semantic.colors.json`
+- **Alloy apps**: `app/assets/semantic.colors.json`
+
+```json
+{
+  "textColor": {
+    "dark": {
+      "color": "#ff85e2",
+      "alpha": "50"
+    },
+    "light": "#ff1f1f"
+  },
+  "backgroundColor": {
+    "dark": "#1a1a2e",
+    "light": "#ffffff"
+  },
+  "primaryColor": {
+    "dark": {
+      "color": "#4ade80",
+      "alpha": "100"
+    },
+    "light": {
+      "color": "#22c55e",
+      "alpha": "100"
+    }
+  }
+}
+```
+
+**Using semantic colors:**
 
 ```tss
-/* These colors automatically switch in Dark Mode */
+/* Reference via Ti.UI.fetchSemanticColor() */
 "#label": {
-  color: Ti.UI.fetchSemanticColor('label')
+  color: Ti.UI.fetchSemanticColor('textColor')
 }
 
-"#bg": {
-  backgroundColor: Ti.UI.fetchSemanticColor('systemBackground')
+"#container": {
+  backgroundColor: Ti.UI.fetchSemanticColor('backgroundColor')
 }
 ```
 
-Available semantic colors: `label`, `secondaryLabel`, `systemBackground`, `secondarySystemBackground`, `separator`, `systemFill`, etc.
+```javascript
+// Or use color names directly as property values
+$.label.color = 'textColor';
+$.container.backgroundColor = 'backgroundColor';
+```
+
+**How it works:**
+- On iOS 13+ it uses the native system method that checks the user's system-wide Dark Mode setting
+- On all other platforms it checks `Ti.UI.semanticColorType` and returns the correct color variant
+- Alpha can be set from 0.0-100.0 (integer or float)
+- Light values can use hex with alpha via ARGB/AARRGGBB format
 
 :::tip When to use Semantic Colors vs Alloy.Globals
-- **Semantic Colors**: Quick adaptation for iOS only. No Android support.
-- **Alloy.Globals palette**: Cross-platform, full control, consistent behavior on both platforms. **Recommended.**
+- **Semantic Colors**: Built-in Dark Mode support, automatic switching, simpler setup. Works cross-platform.
+- **Alloy.Globals palette**: More control over when/how themes switch, easier to add custom themes beyond light/dark, runtime theme changes with UI rebuild.
 :::
 
 ---