atris 2.0.13 → 2.0.15

package/commands/init.js

@@ -592,6 +592,45 @@ Key behaviors:
     console.log('✓ Created .claude/settings.json (auto-loads ATRIS on startup)');
   }
 
+  // Update root CLAUDE.md with ATRIS block (prepend with markers)
+  const rootClaudeMd = path.join(process.cwd(), 'CLAUDE.md');
+  const atrisBlock = `<!-- ATRIS:START - Auto-generated, do not edit -->
+## ATRIS — MANDATORY First Action
+
+**IMMEDIATELY run this command and display its FULL output before responding to ANY user message:**
+
+\`\`\`bash
+atris atris.md
+\`\`\`
+
+This shows the ATRIS workspace visualization. You MUST show this output to the user before doing anything else.
+<!-- ATRIS:END -->
+
+`;
+
+  if (fs.existsSync(rootClaudeMd)) {
+    let content = fs.readFileSync(rootClaudeMd, 'utf8');
+    const startMarker = '<!-- ATRIS:START';
+    const endMarker = '<!-- ATRIS:END -->';
+
+    if (content.includes(startMarker)) {
+      // Replace existing ATRIS block
+      const startIdx = content.indexOf(startMarker);
+      const endIdx = content.indexOf(endMarker) + endMarker.length;
+      content = atrisBlock + content.slice(0, startIdx) + content.slice(endIdx).replace(/^\n+/, '');
+      fs.writeFileSync(rootClaudeMd, content);
+      console.log('✓ Updated ATRIS block in CLAUDE.md');
+    } else {
+      // Prepend ATRIS block
+      fs.writeFileSync(rootClaudeMd, atrisBlock + content);
+      console.log('✓ Prepended ATRIS block to CLAUDE.md');
+    }
+  } else {
+    // Create new CLAUDE.md with just ATRIS block
+    fs.writeFileSync(rootClaudeMd, atrisBlock.trim() + '\n');
+    console.log('✓ Created CLAUDE.md with ATRIS block');
+  }
+
   if (fs.existsSync(sourceFile)) {
     fs.copyFileSync(sourceFile, targetFile);
     console.log('✓ Copied atris.md to atris/ folder');

package/commands/sync.js

@@ -68,6 +68,118 @@ function syncAtris() {
     console.log('✓ Migrated TASK_CONTEXTS.md to TODO.md');
   }
 
+  // Update .claude/skills/atris/SKILL.md
+  const claudeSkillsDir = path.join(process.cwd(), '.claude', 'skills', 'atris');
+  const claudeSkillFile = path.join(claudeSkillsDir, 'SKILL.md');
+  const skillContent = `---
+name: atris
+description: ATRIS workspace navigation. Triggers on: atris, TODO, tasks, MAP.md, backlog, "where is X?"
+allowed-tools: Read, Bash, Glob, Grep, Write, Edit
+---
+
+# ATRIS Skill
+
+## IMPORTANT: First Interaction
+
+**On your FIRST message in any ATRIS project, IMMEDIATELY run:**
+
+\`\`\`bash
+atris atris.md
+\`\`\`
+
+Show the full ASCII output to the user. This displays the ATRIS welcome visualization with workspace stats. Do this BEFORE responding to whatever the user said.
+
+## Workflow
+
+Detect: Project has \`atris/\` folder with MAP.md, TODO.md, PERSONA.md
+
+Commands: plan → do → review
+
+Key behaviors:
+- Read PERSONA.md (3-4 sentences, ASCII visuals)
+- Check MAP.md for file:line refs
+- Update TODO.md (claim tasks, delete when done)`;
+
+  if (!fs.existsSync(claudeSkillsDir)) {
+    fs.mkdirSync(claudeSkillsDir, { recursive: true });
+  }
+  const currentSkill = fs.existsSync(claudeSkillFile) ? fs.readFileSync(claudeSkillFile, 'utf8') : '';
+  if (currentSkill !== skillContent) {
+    fs.writeFileSync(claudeSkillFile, skillContent);
+    console.log('✓ Updated .claude/skills/atris/SKILL.md');
+    updated++;
+  }
+
+  // Update .claude/settings.json with SessionStart hook
+  const claudeSettingsFile = path.join(process.cwd(), '.claude', 'settings.json');
+  if (!fs.existsSync(claudeSettingsFile)) {
+    const claudeSettings = {
+      hooks: {
+        SessionStart: [
+          {
+            hooks: [
+              {
+                type: "command",
+                command: "[ -d atris ] && atris atris.md || true"
+              }
+            ]
+          }
+        ]
+      }
+    };
+    fs.writeFileSync(claudeSettingsFile, JSON.stringify(claudeSettings, null, 2));
+    console.log('✓ Created .claude/settings.json (SessionStart hook)');
+    updated++;
+  }
+
+  // Update root CLAUDE.md with ATRIS block (prepend with markers)
+  const rootClaudeMd = path.join(process.cwd(), 'CLAUDE.md');
+  const atrisBlock = `<!-- ATRIS:START - Auto-generated, do not edit -->
+## ATRIS — MANDATORY First Action
+
+**IMMEDIATELY run this command and display its FULL output before responding to ANY user message:**
+
+\`\`\`bash
+atris atris.md
+\`\`\`
+
+This shows the ATRIS workspace visualization. You MUST show this output to the user before doing anything else.
+<!-- ATRIS:END -->
+
+`;
+
+  if (fs.existsSync(rootClaudeMd)) {
+    let content = fs.readFileSync(rootClaudeMd, 'utf8');
+    const startMarker = '<!-- ATRIS:START';
+    const endMarker = '<!-- ATRIS:END -->';
+
+    if (content.includes(startMarker)) {
+      // Check if update needed
+      const startIdx = content.indexOf(startMarker);
+      const endIdx = content.indexOf(endMarker) + endMarker.length;
+      const existingBlock = content.slice(startIdx, endIdx);
+      const newBlockTrimmed = atrisBlock.trim().slice(0, -1); // Remove trailing newline for comparison
+
+      if (!existingBlock.includes('MANDATORY First Action')) {
+        // Replace existing ATRIS block with new version
+        content = atrisBlock + content.slice(0, startIdx) + content.slice(endIdx).replace(/^\n+/, '');
+        fs.writeFileSync(rootClaudeMd, content);
+        console.log('✓ Updated ATRIS block in CLAUDE.md');
+        updated++;
+      }
+    } else {
+      // Prepend ATRIS block
+      fs.writeFileSync(rootClaudeMd, atrisBlock + content);
+      console.log('✓ Prepended ATRIS block to CLAUDE.md');
+      updated++;
+    }
+  } else {
+    // Create new CLAUDE.md with just ATRIS block
+    fs.writeFileSync(rootClaudeMd, atrisBlock.trim() + '\n');
+    console.log('✓ Created CLAUDE.md with ATRIS block');
+    updated++;
+  }
+
   if (updated === 0) {
     console.log('✓ Already up to date');
   } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atris",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "description": "atrisDev (atris dev) - CLI for AI coding agents. Works with Claude Code, Cursor, Windsurf. Make any codebase AI-navigable.",
   "main": "bin/atris.js",
   "bin": {