get-claudia 1.41.0 → 1.42.0

package/bin/index.js

@@ -178,6 +178,9 @@ async function main() {
   // Show what's new in this release
   showWhatsNew(isUpgrade);
 
+  // Write context/whats-new.md for Claudia's self-awareness
+  writeWhatsNewFile(targetPath, version);
+
   // Install brain visualizer to ~/.claudia/visualizer/
   installVisualizer();
 
@@ -500,36 +503,146 @@ function installVisualizer() {
   }
 }
 
+function extractChangelog(version) {
+  /**
+   * Extract the CHANGELOG section for a specific version.
+   * Returns the text between ## {version} and the next ## heading.
+   */
+  try {
+    const changelogPath = join(__dirname, '..', 'CHANGELOG.md');
+    const changelog = readFileSync(changelogPath, 'utf8');
+    const versionHeader = `## ${version}`;
+    const startIdx = changelog.indexOf(versionHeader);
+    if (startIdx === -1) return null;
+
+    const afterHeader = startIdx + versionHeader.length;
+    // Find the next ## heading
+    const nextHeader = changelog.indexOf('\n## ', afterHeader);
+    const section = nextHeader === -1
+      ? changelog.slice(afterHeader)
+      : changelog.slice(afterHeader, nextHeader);
+
+    return section.trim();
+  } catch {
+    return null;
+  }
+}
+
 function showWhatsNew(isUpgrade) {
-  const c = colors.cyan;
-  const y = colors.yellow;
-  const d = colors.dim;
   const by = colors.boldYellow;
   const bc = colors.boldCyan;
+  const d = colors.dim;
+  const y = colors.yellow;
   const r = colors.reset;
+  const version = getVersion();
 
   const header = isUpgrade ? `${by}What's New${r}` : `${by}What You're Getting${r}`;
   const line = `${y}${'─'.repeat(48)}${r}`;
 
-  console.log(`
+  // Try to extract highlights from CHANGELOG
+  const changelog = extractChangelog(version);
+  if (changelog) {
+    // Extract the first heading (### ...) as the highlight
+    const headingMatch = changelog.match(/^###\s+(.+)$/m);
+    const highlight = headingMatch ? headingMatch[1] : 'Latest improvements';
+
+    // Extract bullet points (lines starting with - **...)
+    const bullets = [];
+    for (const line of changelog.split('\n')) {
+      const m = line.match(/^-\s+\*\*(.+?)\*\*\s*[-–]?\s*(.*)/);
+      if (m && bullets.length < 4) {
+        bullets.push({ title: m[1], desc: m[2] || '' });
+      }
+    }
+
+    console.log(`\n${line}\n  ${header}\n${line}\n`);
+    if (bullets.length > 0) {
+      for (const b of bullets) {
+        const desc = b.desc ? `  ${d}${b.desc}${r}` : '';
+        console.log(`  ${bc}${b.title}${r}${desc}`);
+      }
+    } else {
+      console.log(`  ${bc}${highlight}${r}`);
+    }
+    console.log(`\n${line}\n`);
+  } else {
+    // Fallback: static content
+    console.log(`
 ${line}
   ${header}
 ${line}
 
   ${bc}Zero-Prompt Install${r}  ${d}Everything installs automatically.${r}
-                       ${d}No questions, smart defaults, graceful fallbacks.${r}
-
   ${bc}Obsidian Vault${r}       ${d}Memory syncs to ~/.claudia/vault/ as markdown.${r}
-                       ${d}Open in Obsidian for graph view and search.${r}
-
-  ${bc}Document Storage${r}     ${d}Files, transcripts, and emails are stored${r}
-                       ${d}and linked to people and memories.${r}
-
+  ${bc}Document Storage${r}     ${d}Files stored and linked to people and memories.${r}
   ${bc}Provenance${r}           ${d}Every fact traces back to its source.${r}
-                       ${d}Ask "how do you know that?" and Claudia shows her work.${r}
 
 ${line}
 `);
+  }
+}
+
+function writeWhatsNewFile(targetPath, version) {
+  /**
+   * Write context/whats-new.md so Claudia knows about her own capabilities
+   * after install/upgrade. She reads it at session start, mentions the update,
+   * then deletes it.
+   */
+  try {
+    const contextDir = join(targetPath, 'context');
+    mkdirSync(contextDir, { recursive: true });
+
+    const date = new Date().toISOString().slice(0, 10);
+
+    // Extract changelog for this version
+    const changelogSection = extractChangelog(version) || 'No changelog available for this version.';
+
+    // Read skill-index.json for capabilities list
+    let skillSections = '';
+    try {
+      const skillIndexPath = join(__dirname, '..', 'template-v2', '.claude', 'skills', 'skill-index.json');
+      const skillIndex = JSON.parse(readFileSync(skillIndexPath, 'utf8'));
+      const skills = skillIndex.skills || [];
+
+      const proactive = skills.filter(s => s.invocation === 'proactive');
+      const contextual = skills.filter(s => s.invocation === 'contextual');
+      const explicit = skills.filter(s => s.invocation === 'explicit');
+
+      skillSections = `## Your Complete Skill Set
+
+### Proactive (auto-activate)
+${proactive.map(s => `- **${s.name}** - ${s.description}`).join('\n')}
+
+### Contextual (natural language or /command)
+${contextual.map(s => `- **/${s.name}** - ${s.description}`).join('\n')}
+
+### Explicit (/command only)
+${explicit.map(s => `- **/${s.name}** - ${s.description}`).join('\n')}
+
+## Memory Tools (21 MCP tools)
+13 standalone: remember, recall, about, relate, batch, end_session, consolidate, briefing, summary, reflections, system_health, project_health, cognitive.ingest
+8 merged: temporal (upcoming/since/timeline/morning), graph (network/path/hubs/dormant/reconnect), entities (create/search/merge/delete/overview), vault (sync/status/canvas/import), modify (correct/invalidate/invalidate_relationship), session (buffer/context/unsummarized), document (store/search), provenance (trace/audit)`;
+    } catch {
+      // skill-index.json not found, skip skills section
+    }
+
+    const content = `# Updated to v${version} (${date})
+
+## What's New
+
+${changelogSection}
+
+${skillSections}
+
+---
+_Surface this update in your first greeting, then delete this file._
+`;
+
+    writeFileSync(join(contextDir, 'whats-new.md'), content);
+  } catch (err) {
+    // Non-fatal: whats-new is a nice-to-have
+    process.stderr.write(`${colors.dim}  Could not write whats-new.md: ${err.message}${colors.reset}\n`);
+  }
 }
 
 main();

package/memory-daemon/claudia_memory/__main__.py

@@ -315,14 +315,14 @@ def main():
         help="Import user edits from Obsidian vault back into memory and exit",
     )
     parser.add_argument(
-        "--organize-vault",
+        "--migrate-vault-para",
         action="store_true",
-        help="Migrate vault to Claudia wing structure (use --preview to see plan first)",
+        help="Migrate vault to PARA structure (use --preview to see plan first)",
     )
     parser.add_argument(
         "--preview",
         action="store_true",
-        help="Preview mode for --organize-vault: show migration plan without making changes",
+        help="Preview mode for --migrate-vault-para: show routing plan without making changes",
     )
 
     args = parser.parse_args()
@@ -841,9 +841,9 @@ def main():
                 print(f"  [{status}] {r.get('file', 'unknown')}: {r.get('summary', '')}")
         return
 
-    if args.organize_vault:
+    if args.migrate_vault_para:
         setup_logging(debug=args.debug)
-        from .services.vault_sync import get_vault_path, get_vault_sync_service, run_vault_migration
+        from .services.vault_sync import get_vault_path, run_para_migration
 
         db = get_db()
         db.initialize()
@@ -854,14 +854,7 @@ def main():
             print("Run --vault-sync first to create the vault.")
             sys.exit(1)
 
-        result = run_vault_migration(vault_path, preview=args.preview)
-
-        if not args.preview and result.get("migrated", 0) > 0:
-            # Re-export with wing structure enabled
-            print("\nRegenerating vault with wing structure...")
-            svc = get_vault_sync_service(project_id)
-            stats = svc.export_all()
-            print(f"Vault regenerated: {stats}")
+        run_para_migration(vault_path, db=db, preview=args.preview)
         return
 
     # Run the daemon

package/memory-daemon/claudia_memory/config.py

@@ -95,9 +95,8 @@ class MemoryConfig:
     obsidian_rest_api_port: int = 27124
     obsidian_rest_api_enabled: bool = False
 
-    # Claudia Wing (optional vault container for Claudia's notes)
-    use_claudia_wing: bool = False       # Opt-in wing structure; off by default
-    claudia_wing_dir: str = "claudia"    # Customizable container name
+    # Vault layout (PARA-inspired structure)
+    vault_layout: str = "para"           # Vault organization style (only "para" for now)
 
     # Daemon settings
     log_path: Path = field(default_factory=lambda: Path.home() / ".claudia" / "daemon.log")
@@ -174,10 +173,8 @@ class MemoryConfig:
                     config.obsidian_rest_api_port = data["obsidian_rest_api_port"]
                 if "obsidian_rest_api_enabled" in data:
                     config.obsidian_rest_api_enabled = data["obsidian_rest_api_enabled"]
-                if "use_claudia_wing" in data:
-                    config.use_claudia_wing = data["use_claudia_wing"]
-                if "claudia_wing_dir" in data:
-                    config.claudia_wing_dir = data["claudia_wing_dir"]
+                if "vault_layout" in data:
+                    config.vault_layout = data["vault_layout"]
                 if "enable_entity_summaries" in data:
                     config.enable_entity_summaries = data["enable_entity_summaries"]
                 if "entity_summary_min_memories" in data:
@@ -300,8 +297,7 @@ class MemoryConfig:
             "vault_name": self.vault_name,
             "obsidian_rest_api_port": self.obsidian_rest_api_port,
             "obsidian_rest_api_enabled": self.obsidian_rest_api_enabled,
-            "use_claudia_wing": self.use_claudia_wing,
-            "claudia_wing_dir": self.claudia_wing_dir,
+            "vault_layout": self.vault_layout,
             "enable_entity_summaries": self.enable_entity_summaries,
             "entity_summary_min_memories": self.entity_summary_min_memories,
             "entity_summary_max_age_days": self.entity_summary_max_age_days,