@maccesar/titools 2.0.5 → 2.0.6

package/AGENTS-TEMPLATE.md

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

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.5",
+  "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",