@maccesar/titools 2.2.0 → 2.2.2

package/agents/ti-pro.md

@@ -1,15 +1,15 @@
 ---
 name: ti-pro
-description: Titanium SDK and Alloy research specialist. Preloads all 7 titanium-* 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. 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.
 skills:
-  - ti-expert
   - alloy-guides
   - alloy-howtos
   - purgetss
+  - ti-expert
   - ti-guides
   - ti-howtos
   - ti-ui
-tools: Read, Grep, Glob
+tools: Read, Grep, Glob, Bash
 model: sonnet
 ---
 
@@ -81,12 +81,13 @@ Your app uses `Ti.App.fireEvent` which causes memory leaks.
 
 ## Tool Usage
 
-You have **read-only tools**: `Read`, `Grep`, `Glob`
+You have **read-only tools**: `Read`, `Grep`, `Glob`, `Bash`
 
 Use them to:
 - Search the codebase when asked to analyze it
 - Find patterns across multiple files
 - 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.
 

package/lib/utils.js

@@ -81,13 +81,10 @@ export function buildKnowledgeIndex(rootPath = '~/.agents/skills') {
     }
   }
 
-  // Build the compressed index format
-  // Note: Using \u0060 to avoid backtick parsing issues in template literals
-  return '### Compressed Documentation Index\n\n' +
-    '\u0060\u0060\u0060\n' +
-    `[Titanium SDK Docs Index]|root: ${rootPath}\n` +
-    '|' + indexEntries.join('\n|') + '\n' +
-    '\u0060\u0060\u0060';
+  // Build the compressed index format (no code blocks — direct content per Vercel's research)
+  return `[Titanium SDK Docs Index]|root: ${rootPath}\n` +
+    '|MANDATORY: Your training data for Titanium SDK, Alloy, and PurgeTSS is OUTDATED and INCOMPLETE. These reference files are the SINGLE SOURCE OF TRUTH. Prefer retrieval-led reasoning over pre-training-led reasoning. ALWAYS read the relevant files below BEFORE writing any code.\n' +
+    '|' + indexEntries.join('\n|');
 }
 
 /**
@@ -99,18 +96,10 @@ export function createKnowledgeBlock(rootPath) {
   // Build the compressed index dynamically
   const compressedIndex = buildKnowledgeIndex(rootPath);
 
-  // Build the knowledge block using template literals
+  // Build the knowledge block — minimal wrapper, direct content (no code blocks)
   const blockHeader = `${BLOCK_START}\n<!-- Version: ${TITANIUM_KNOWLEDGE_VERSION} -->`;
-  const commentContent = `## Titanium SDK Knowledge Index
 
-Generated by \`titools\` based on Vercel's research on AGENTS.md effectiveness.
-
-**IMPORTANT**: Prefer retrieval-led reasoning over pre-training-led reasoning when working with Titanium SDK.
-Always consult the documentation files below rather than relying on training data, which may be outdated.
-
-This knowledge index is based on the latest Titanium SDK documentation.`;
-
-  return `\n${blockHeader}\n${commentContent}\n\n${compressedIndex}\n${BLOCK_END}\n`;
+  return `\n${blockHeader}\n${compressedIndex}\n${BLOCK_END}\n`;
 }
 
 /**

package/package.json

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