@maccesar/titools 2.0.4 → 2.0.6

package/AGENTS-TEMPLATE.md

@@ -101,7 +101,8 @@ The generated file contains:
 Example output:
 
 ```html
-<!-- TITANIUM-KNOWLEDGE-v2.0.0 -->
+<!-- TITANIUM-KNOWLEDGE-START -->
+<!-- Version: v2.0.6 -->
 <!--
 Titanium SDK Knowledge Index
 Generated by titools -->

package/README.md

@@ -60,22 +60,11 @@ Installs Titanium skills and agents globally:
 - ✅ ti-researcher agent
 - ✅ AGENTS-TEMPLATE.md (template for documentation generation)
 
-### Using npx skills (Skills Only)
-
-You can also install **only the skills** using the `skills` CLI:
-
-```bash
-npx skills add macCesar/titools
-```
-
-**Note:** This installs only skills (no agents, no `titools agents` command). For the complete experience, use the full NPM installation above.
-
 ### Verify Installation
 
 **Check titools version:**
 ```bash
 titools --version
-# Should show: v2.0.0
 ```
 
 **Check central location:**
@@ -170,7 +159,6 @@ The `titools agents` command will:
 
 ```
 [Titanium SDK Docs Index]|root: ~/.agents/skills
-|IMPORTANT: Prefer retrieval-led reasoning over pre-training-led reasoning
 |alloy-expert/references:{alloy-structure.md,anti-patterns.md,...}
 |purgetss/references:{animation-system.md,class-index.md,...}
 |ti-ui/references:{layouts-and-positioning.md,listviews-and-performance.md,...}
@@ -720,76 +708,50 @@ Ask the AI to:
 
 ---
 
-## AGENTS.md Troubleshooting
-
-### AGENTS.md Not Working?
-
-If your AI assistant doesn't seem to use the AGENTS.md information:
-1. Verify AGENTS.md exists in your project root
-2. Check that your AI assistant supports AGENTS.md (Claude Code does)
-3. Try explicitly referencing it: "Check the AGENTS.md documentation for this"
+## Troubleshooting
 
-### ti-docs-index / titools agents Command Not Found?
+### titools command not found?
 
 If the command is not found:
+```bash
+# Verify installation
+npm list -g @maccesar/titools
+
+# Re-install
+npm install -g @maccesar/titools
+```
 
-**NPM installation:**
-1. Verify NPM installation: `npm list -g @maccesar/titanium-skills`
-2. Check if command exists: `which titools`
-3. Re-run: `npm install -g @maccesar/titanium-skills`
+### AGENTS.md not working?
 
-**Bash installation:**
-1. Verify full installation was used (not `npx skills add`)
-2. Check if command exists: `which ti-docs-index`
-3. Re-run installer: `curl -fsSL https://raw.githubusercontent.com/macCesar/titools/main/install.sh | bash`
+If your AI doesn't use the AGENTS.md information:
+1. Verify AGENTS.md/CLAUDE.md exists in your project root
+2. Check that your AI supports these files (Claude Code does)
+3. Try explicitly referencing: "Check the AGENTS.md documentation"
 
-### Version Mismatch Warning?
+### Version mismatch warning?
 
-If you see a version mismatch warning:
-1. Check your Titanium SDK version: `grep -A 1 "<sdk-version>" tiapp.xml`
-2. AGENTS.md is based on the latest documentation
-3. Be cautious when using newer APIs in older projects
-4. Consult official docs for your version: https://titaniumsdk.com/guide
+AGENTS.md is based on the latest documentation. Be cautious when using newer APIs in older projects.
 
 ---
 
 ## Uninstall
 
 ```bash
+# Remove the CLI
 npm uninstall -g @maccesar/titools
-```
-
-Then manually remove the installed files:
-
-```bash
-# Remove skill symlinks from all platforms
-rm -rf ~/.claude/skills/{alloy-expert,purgetss,ti-ui,ti-howtos,ti-guides,alloy-guides,alloy-howtos}
-rm -rf ~/.gemini/skills/{alloy-expert,purgetss,ti-ui,ti-howtos,ti-guides,alloy-guides,alloy-howtos}
-rm -rf ~/.codex/skills/{alloy-expert,purgetss,ti-ui,ti-howtos,ti-guides,alloy-guides,alloy-howtos}
-
-# Remove agent from Claude Code
-rm -f ~/.claude/agents/ti-researcher.md
 
-# Remove Titanium SDK skills from central directory
-rm -rf ~/.agents/skills
+# Remove skills and agents
+titools uninstall
 ```
 
-**Note:** AGENTS.md/CLAUDE.md/GEMINI.md files in your projects are NOT removed automatically. To remove them from a specific project:
+**Note:** AGENTS.md/CLAUDE.md/GEMINI.md files in your projects are NOT removed. To remove them manually:
 
 ```bash
 rm -f /path/to/your/project/AGENTS.md
 rm -f /path/to/your/project/CLAUDE.md
 rm -f /path/to/your/project/GEMINI.md
 ```
-```
 
-**Note:** AGENTS.md/CLAUDE.md/GEMINI.md files in your projects are NOT removed automatically. To remove them from a specific project:
-
-```bash
-rm -f /path/to/your/project/AGENTS.md
-rm -f /path/to/your/project/CLAUDE.md
-rm -f /path/to/your/project/GEMINI.md
-```
 
 ---
 

package/lib/config.js

@@ -20,8 +20,8 @@ try {
 // Version management
 export const PACKAGE_VERSION = packageVersion;
 export const TITANIUM_KNOWLEDGE_VERSION = `v${PACKAGE_VERSION}`;
-export const BLOCK_START = `<!-- TITANIUM-KNOWLEDGE-${TITANIUM_KNOWLEDGE_VERSION} -->`;
-export const BLOCK_END = '<!-- END-TITANIUM-KNOWLEDGE -->';
+export const BLOCK_START = '<!-- TITANIUM-KNOWLEDGE-START -->';
+export const BLOCK_END = '<!-- TITANIUM-KNOWLEDGE-END -->';
 
 // Repository configuration
 export const REPO_URL = 'https://github.com/macCesar/titools';

package/lib/utils.js

@@ -25,7 +25,8 @@ export function blockExists(filePath) {
   }
 
   const content = readFileSync(filePath, 'utf8');
-  return content.includes(BLOCK_START);
+  // Match both old versioned blocks and new static blocks
+  return /<!-- TITANIUM-KNOWLEDGE-(v[\d.]+|START) -->/.test(content);
 }
 
 /**
@@ -39,10 +40,8 @@ export function removeOldBlock(filePath) {
   }
 
   const content = readFileSync(filePath, 'utf8');
-  const regex = new RegExp(
-    `[\\s\\S]*?${BLOCK_START}[\\s\\S]*?${BLOCK_END}[\\s\\S]*?\\n*`,
-    'g'
-  );
+  // Regex to match any Titanium knowledge block (old or new)
+  const regex = /[\s\S]*?<!-- TITANIUM-KNOWLEDGE-(v[\d.]+|START) -->[\s\S]*?<!-- (END-TITANIUM-KNOWLEDGE|TITANIUM-KNOWLEDGE-END) -->[\s\S]*?\n*/g;
 
   const newContent = content.replace(regex, '\n\n');
 
@@ -99,7 +98,7 @@ export function createKnowledgeBlock() {
   const compressedIndex = buildKnowledgeIndex();
 
   // Build the knowledge block using template literals
-  const blockStart = `<!-- TITANIUM-KNOWLEDGE-${TITANIUM_KNOWLEDGE_VERSION} -->`;
+  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.
@@ -109,7 +108,7 @@ Always consult the documentation files below rather than relying on training dat
 
 This knowledge index is based on the latest Titanium SDK documentation.`;
 
-  return `\n\n${blockStart}\n${commentContent}\n\n${compressedIndex}\n<!-- END-TITANIUM-KNOWLEDGE -->\n`;
+  return `\n\n${blockHeader}\n${commentContent}\n\n${compressedIndex}\n${BLOCK_END}\n`;
 }
 
 /**
@@ -126,19 +125,20 @@ export function addOrUpdateBlock(filePath) {
 
   const block = createKnowledgeBlock();
 
-  // Remove existing block if present (only the block, not the content before/after)
-  if (content.includes(BLOCK_START)) {
-    const startIndex = content.indexOf(BLOCK_START);
-    if (startIndex !== -1) {
-      const endIndex = content.indexOf(BLOCK_END, startIndex);
-      if (endIndex !== -1) {
-        // Remove from start to end of block (including END marker and trailing newlines)
-        const afterBlock = content.substring(endIndex + BLOCK_END.length);
-        // Trim leading newlines from afterBlock
-        const trimmedAfter = afterBlock.replace(/^\n+/, '');
-        content = content.substring(0, startIndex) + '\n\n' + trimmedAfter;
-      }
-    }
+  // Regex to find any existing block (old versioned or new static)
+  // Group 1 matches the version/START, Group 2 matches the END marker
+  const blockRegex = /<!-- TITANIUM-KNOWLEDGE-(v[\d.]+|START) -->[\s\S]*?<!-- (END-TITANIUM-KNOWLEDGE|TITANIUM-KNOWLEDGE-END) -->/;
+  const match = content.match(blockRegex);
+
+  if (match) {
+    const startIndex = match.index;
+    const matchText = match[0];
+    const endIndex = startIndex + matchText.length;
+
+    // Remove the entire block and handle trailing newlines
+    const afterBlock = content.substring(endIndex);
+    const trimmedAfter = afterBlock.replace(/^\n+/, '');
+    content = content.substring(0, startIndex) + '\n\n' + trimmedAfter;
   }
 
   // Add new block at the end (preserve existing content)

package/package.json

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