create-walle 0.7.1 → 0.8.0

package/template/claude-task-manager/public/js/walle.js

@@ -5,9 +5,10 @@ let currentView = 'chat';
 let cache = {};
 let timelineOffset = 0;
 
-// WALL-E API base URL — points directly to the WALL-E process (port 3457)
-// Falls back to same-origin proxy if WALL-E is unreachable
-var WALLE_BASE = 'http://localhost:3457';
+// WALL-E API base URL — derived from page's CTM port (Wall-E = CTM + 1).
+// Falls back to same-origin proxy if WALL-E is unreachable.
+var _ctmPort = parseInt(location.port) || 3456;
+var WALLE_BASE = 'http://localhost:' + (_ctmPort + 1);
 var walleBaseResolved = false;
 
 function resolveWalleBase() {
@@ -187,6 +188,21 @@ WE.init = function() {
   WE.showView(currentView);
 };
 
+WE.toggleMoreTabs = function() {
+  const dd = document.getElementById('we-more-dropdown');
+  dd.style.display = dd.style.display === 'none' ? 'block' : 'none';
+  if (dd.style.display === 'block') {
+    setTimeout(() => document.addEventListener('click', WE._closeMoreTabsOutside, true), 0);
+  }
+};
+WE.closeMoreTabs = function() {
+  document.getElementById('we-more-dropdown').style.display = 'none';
+  document.removeEventListener('click', WE._closeMoreTabsOutside, true);
+};
+WE._closeMoreTabsOutside = function(e) {
+  if (!document.getElementById('we-more-wrap').contains(e.target)) WE.closeMoreTabs();
+};
+
 WE.showView = function(view) {
   // Clean up task pollers/timers when leaving tasks view
   if (currentView === 'tasks' && view !== 'tasks') {
@@ -739,7 +755,7 @@ WE.renderChat = function() {
     api('/chat/history?session_id=default&limit=200').then(function(data) {
       var msgs = data.data || [];
       if (Array.isArray(msgs) && msgs.length > 0) {
-        chatHistory = msgs.map(function(m) { return { role: m.role, text: m.content }; });
+        chatHistory = msgs.map(function(m) { return { role: m.role, text: m.content, created_at: m.created_at }; });
         // Populate user message history (index 0 = most recent)
         userMessageHistory = [];
         for (var i = msgs.length - 1; i >= 0; i--) {
@@ -788,7 +804,7 @@ function renderChatUI() {
     html += '<div class="we-search-header">' + chatSearchResults.length + ' result' + (chatSearchResults.length !== 1 ? 's' : '') + ' for "' + esc(chatSearchQuery) + '"</div>';
     chatSearchResults.forEach(function(msg) {
       var roleClass = msg.role === 'user' ? 'user' : 'assistant';
-      var roleLabel = msg.role === 'user' ? 'YOU' : 'WALL-E';
+      var roleLabel = msg.role === 'user' ? 'You' : 'WALL-E';
       var ts = msg.created_at ? new Date(msg.created_at + 'Z').toLocaleString() : '';
       html += '<div class="we-search-result">';
       html += '<div class="we-search-result-meta"><span class="walle-chat-msg-role ' + roleClass + '">' + roleLabel + '</span> <span class="we-search-result-time">' + esc(ts) + '</span></div>';
@@ -820,7 +836,7 @@ function renderChatUI() {
         }
         // User message
         html += '<div class="walle-chat-msg user" data-idx="' + i + '">';
-        html += '<div class="walle-chat-msg-role user">YOU';
+        html += '<div class="walle-chat-msg-role user">You';
         html += ' <button class="we-edit-btn" onclick="WE._editMessage(' + i + ')" title="Edit & resend">&#9998;</button>';
         html += ' <button class="we-edit-btn we-delete-btn" onclick="WE._deleteMessage(' + i + ')" title="Delete this exchange">&#128465;</button>';
         html += '</div>';
@@ -1502,7 +1518,7 @@ WE._exportAsImage = function() {
   turns.forEach(function(t) {
     turnHtml += '<div class="turn">';
     if (t.userText) {
-      turnHtml += '<div class="role user">YOU</div>';
+      turnHtml += '<div class="role user">You</div>';
       turnHtml += '<div class="msg">' + esc(t.userText).replace(/\n/g, '<br>') + '</div>';
     }
     if (t.assistantText) {
@@ -2160,8 +2176,8 @@ function _renderTaskResultPanel(t) {
     var lineCount = t.result.split('\n').length;
     var isMarkdown = _hasMarkdown(t.result);
     var isShort = lineCount <= 12;
-    // Auto-expand short outputs
-    var expandedClass = isShort ? ' expanded' : '';
+    // Collapsed by default — user clicks to expand
+    var expandedClass = '';
 
     html += '<div class="we-task-output-panel' + expandedClass + '">';
     html += '<div class="we-task-output-header" onclick="this.parentElement.classList.toggle(\'expanded\')">';
@@ -2169,18 +2185,17 @@ function _renderTaskResultPanel(t) {
     if (timeLabel) html += '<span class="we-task-output-time">' + esc(timeLabel) + '</span>';
     html += '<span class="we-task-output-lines">' + lineCount + ' lines</span>';
     html += '<button class="we-task-output-copy" onclick="event.stopPropagation();WE._copyTaskOutput(\'' + tid + '\')" title="Copy output">Copy</button>';
+    html += '<button class="we-task-output-copy" onclick="event.stopPropagation();WE._copyTaskLink(\'' + tid + '\')" title="Copy shareable link">Link</button>';
     html += '<span class="we-task-output-toggle"></span>';
     html += '</div>';
 
-    if (!isShort) {
-      // Show a summary preview for long outputs
-      var summary = _extractResultSummary(t.result);
-      if (summary) {
-        if (isMarkdown) {
-          html += '<div class="we-task-output-summary we-task-md">' + _renderMarkdown(summary) + '</div>';
-        } else {
-          html += '<div class="we-task-output-summary">' + esc(summary) + '</div>';
-        }
+    // Show a summary preview (collapsed by default)
+    var summary = isShort ? t.result.split('\n').slice(0, 3).join('\n') : _extractResultSummary(t.result);
+    if (summary) {
+      if (isMarkdown) {
+        html += '<div class="we-task-output-summary we-task-md">' + _renderMarkdown(summary) + '</div>';
+      } else {
+        html += '<div class="we-task-output-summary">' + esc(summary) + '</div>';
       }
     }
 
@@ -2213,12 +2228,19 @@ WE._copyTaskOutput = function(taskId) {
   }
 };
 
+WE._copyTaskLink = function(taskId) {
+  var url = location.origin + '/#walle/task/' + taskId;
+  navigator.clipboard.writeText(url).then(function() {
+    if (typeof window.toast === 'function') window.toast('Task link copied', { type: 'success' });
+  });
+};
+
 function renderTaskCard(t) {
   var q = _taskFilter.search || '';
   var statusColors = { running: '#228be6', pending: '#fab005', completed: '#5c940d', failed: '#e03131', paused: '#888', cancelled: '#666' };
   var borderColor = statusColors[t.status] || '#333';
 
-  var html = '<div class="we-task-card" style="border-left-color:' + borderColor + '">';
+  var html = '<div class="we-task-card" id="task-' + esc(t.id) + '" style="border-left-color:' + borderColor + '">';
 
   // Row 1: title + badges + status
   html += '<div class="we-task-card-header">';
@@ -2228,40 +2250,47 @@ function renderTaskCard(t) {
   else html += ' <span class="walle-tag" style="background:#1a1a3e;color:#60a5fa">AI</span>';
   if (t.skill) html += ' <span class="walle-tag" style="background:#1a3a1a;color:#4ade80">' + esc(t.skill) + '</span>';
   html += '</span>';
-  html += '<span class="we-task-card-status" style="color:' + borderColor + '">' + esc(t.status) + '</span>';
+  html += '<span class="we-task-card-status" style="color:' + borderColor + '"><span class="we-status-dot we-status-dot--' + esc(t.status) + '"></span>' + esc(t.status) + '</span>';
   html += '</div>';
 
   // Row 2: description
   if (t.description) html += '<div class="we-task-card-desc">' + _hl(t.description, q) + '</div>';
 
-  // Row 3: metadata chips
+  // Row 3: metadata chips — primary (schedule + last run) always visible
   html += '<div class="we-task-meta">';
   if (t.type === 'recurring' && t.schedule) html += '<span>\uD83D\uDD01 ' + esc(t.schedule) + '</span>';
-  if (t.run_count > 0) html += '<span>\u25B6 ' + t.run_count + ' runs</span>';
   if (t.last_run_at) html += '<span>\u23F1 Last: ' + esc(timeAgo(t.last_run_at)) + '</span>';
   if (t.status === 'running' && t.started_at) {
-    // Show live-ticking elapsed time for currently running task
     var startMs = new Date(t.started_at + (t.started_at.includes('Z') ? '' : 'Z')).getTime();
     var elapsedSec = Math.max(0, Math.floor((Date.now() - startMs) / 1000));
     var elStr = elapsedSec < 60 ? elapsedSec + 's' : Math.floor(elapsedSec / 60) + 'm ' + (elapsedSec % 60) + 's';
     html += '<span class="we-task-running-timer" data-start-ms="' + startMs + '" style="color:#228be6">\u23F3 Running: ' + elStr + '</span>';
-  } else if (t.last_duration_ms && t.last_duration_ms > 0) {
-    var durSec = Math.round(t.last_duration_ms / 1000);
-    var durStr = durSec < 60 ? durSec + 's' : Math.floor(durSec / 60) + 'm ' + (durSec % 60) + 's';
-    html += '<span>\u23F1 Took: ' + durStr + '</span>';
-  }
-  if (t.next_run_at && (t.status === 'pending' || t.status === 'paused')) {
-    var nextDate = new Date(t.next_run_at + (t.next_run_at.includes('Z') ? '' : 'Z'));
-    var isFarFuture = nextDate.getFullYear() > 2099;
-    if (!isFarFuture) {
-      var secUntil = Math.floor((nextDate - new Date()) / 1000);
-      if (secUntil <= 0) {
-        html += '<span style="color:#fab005">\u23ED Next: overdue</span>';
-      } else {
-        var nextStr = secUntil < 60 ? secUntil + 's' : secUntil < 3600 ? Math.floor(secUntil / 60) + 'm' : Math.floor(secUntil / 3600) + 'h';
-        html += '<span>\u23ED Next: ' + nextStr + '</span>';
+  }
+  // Secondary metadata — collapsed behind "details" toggle
+  var _hasExtra = (t.run_count > 0) || (t.last_duration_ms && t.last_duration_ms > 0 && t.status !== 'running') || (t.next_run_at && (t.status === 'pending' || t.status === 'paused'));
+  if (_hasExtra) {
+    html += '<span class="we-task-meta-toggle" onclick="this.parentElement.classList.toggle(\'we-meta-expanded\');event.stopPropagation()">details</span>';
+    html += '<span class="we-task-meta-extra">';
+    if (t.run_count > 0) html += '<span>\u25B6 ' + t.run_count + ' runs</span>';
+    if (t.last_duration_ms && t.last_duration_ms > 0 && t.status !== 'running') {
+      var durSec = Math.round(t.last_duration_ms / 1000);
+      var durStr = durSec < 60 ? durSec + 's' : Math.floor(durSec / 60) + 'm ' + (durSec % 60) + 's';
+      html += '<span>\u23F1 Took: ' + durStr + '</span>';
+    }
+    if (t.next_run_at && (t.status === 'pending' || t.status === 'paused')) {
+      var nextDate = new Date(t.next_run_at + (t.next_run_at.includes('Z') ? '' : 'Z'));
+      var isFarFuture = nextDate.getFullYear() > 2099;
+      if (!isFarFuture) {
+        var secUntil = Math.floor((nextDate - new Date()) / 1000);
+        if (secUntil <= 0) {
+          html += '<span style="color:#fab005">\u23ED Next: overdue</span>';
+        } else {
+          var nextStr = secUntil < 60 ? secUntil + 's' : secUntil < 3600 ? Math.floor(secUntil / 60) + 'm' : Math.floor(secUntil / 3600) + 'h';
+          html += '<span>\u23ED Next: ' + nextStr + '</span>';
+        }
       }
     }
+    html += '</span>';
   }
   html += '</div>';
 

package/template/docs/ux-improvement-plan.md

@@ -0,0 +1,84 @@
+# CTM & Wall-E UX Improvement Plan
+
+Date: 2026-04-03
+
+## Phase 1: First Impressions (New User Experience)
+
+### 1.1 Simplify Navigation
+- Group nav into primary (Sessions, Prompts, WALL-E) and secondary
+- Move Insights, Permissions, Review, Rules, Backups behind "More" dropdown
+- Keeps nav clean for new users, power users still have access
+
+### 1.2 Better Empty State
+- Sessions welcome: 1 clear CTA "Start a Claude Session" with brief explanation
+- Remove keyboard shortcuts from welcome (move to ? help overlay)
+- Add "What can I do?" quick examples
+
+### 1.3 Hide Queue Builder by Default
+- Queue Builder panel takes ~25% screen width, always open
+- Make it a toggle/drawer, collapsed by default
+- Show "Queue" button in toolbar that opens it
+
+### 1.4 Wall-E Onboarding
+- First-time visitor sees intro card: "I'm Wall-E" with 3-4 example actions
+- Disappears after first interaction or dismiss
+
+### 1.5 Reduce Wall-E Sub-tabs
+- Current: Chat, Tasks, Brain, Actions, Skills, Timeline, Questions, Status (8 tabs)
+- Proposed: Chat, Tasks, Skills as primary; Brain/Actions/Timeline/Questions/Status behind "More"
+
+## Phase 2: Information Hierarchy & Readability
+
+### 2.1 Task Cards Cleanup
+- Collapse output by default (click to expand)
+- Add colored status dots (green=running, yellow=pending, red=failed, gray=paused)
+- Reduce metadata noise — show schedule + last run, hide others until hover/expand
+
+### 2.2 Prompts Toolbar Simplification
+- Essential always visible: bold, italic, lists, headings
+- Advanced in overflow: font selector, zoom, chains/templates/patterns/harvest/copilot sub-tabs
+- Move sub-tabs into prompt editor sidebar or contextual menu
+
+### 2.3 Insights Action-First Layout
+- Put the action item (green arrow text) FIRST, then explanation
+- Add category icons for workflow/prompt-effectiveness/skill-gap/cost-saving
+
+### 2.4 Permissions Explainer
+- Add brief card at top: "Permissions control what Claude Code can do automatically"
+- Better risk color coding (red=high, yellow=medium, green=low)
+
+## Phase 3: Visual Polish & Consistency
+
+### 3.1 Unified Status Indicators
+- Colored dots + icons for all states across tasks, sessions, integrations
+- Running=green pulse, Pending=yellow, Failed=red, Paused=gray, Connected=green, Disconnected=red
+
+### 3.2 Chat Improvements
+- Date separators between conversations
+- Softer "YOU" label (lowercase or muted)
+- Proper markdown table rendering in chat
+
+### 3.3 Setup Page Polish
+- Move Data Storage into collapsible "Advanced" section
+- Add step progress indicator
+
+### 3.4 Consistent Card Styling
+- Unify border radius, padding, shadow across all pages
+
+## Phase 4: Progressive Disclosure
+
+### 4.1 Contextual Tooltips
+- First-time hints for Shadow Approver, Queue Builder, Harvest, Copilot
+
+### 4.2 Keyboard Shortcuts Overlay
+- Press ? to see all shortcuts (like GitHub)
+
+### 4.3 Collapsible Sidebar Filters
+- Sessions filters collapse to single row
+
+## Implementation Notes
+
+- Test all changes on dev instance (port 4000), never restart primary (port 3456)
+- Use /ctm-dev skill for testing
+- Each phase can be implemented independently
+- Phase 1 has highest impact for new users

package/template/package.json

@@ -1,11 +1,14 @@
 {
   "name": "walle",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "private": true,
   "description": "Wall-E — your personal digital twin",
   "scripts": {
     "start": "node claude-task-manager/server.js",
     "stop": "curl -sX POST http://localhost:${CTM_PORT:-3456}/api/stop/walle; echo 'Stopped.'",
-    "setup": "node bin/setup.js"
+    "setup": "node bin/setup.js",
+    "dev": "bash bin/dev.sh",
+    "dev:fresh": "bash bin/dev.sh --fresh",
+    "dev:refresh": "bash bin/dev.sh --refresh"
   }
 }

package/template/wall-e/agent.js

@@ -98,64 +98,10 @@ function bootstrapSkills() {
 }
 
 function bootstrapTasks() {
-  const existing = brain.listTasks({ limit: 100 });
-  if (existing.length > 0) return; // Already has tasks
-
-  const coreTasks = [
-    // Recurring scheduled tasks
-    {
-      title: 'Morning Briefing',
-      description: 'Generate a daily morning briefing with calendar, Slack activity, pending tasks, and mentions.',
-      type: 'recurring',
-      schedule: 'daily at 7am',
-      skill: 'morning-briefing',
-      priority: 'normal',
-    },
-    {
-      title: 'Sync Calendar',
-      description: 'Sync macOS Calendar events (Google, iCloud, Outlook) into Wall-E brain via EventKit.',
-      type: 'recurring',
-      schedule: 'every 30m',
-      skill: 'google-calendar',
-      priority: 'normal',
-    },
-    {
-      title: 'Slack: Conversation Sync',
-      description: 'Pull latest Slack messages from active conversations into Wall-E brain.',
-      type: 'recurring',
-      schedule: 'every 15m',
-      skill: 'slack-sync',
-      priority: 'normal',
-    },
-    {
-      title: 'Email: Conversation Sync',
-      description: 'Sync sent and inbox emails from macOS Mail into Wall-E brain.',
-      type: 'recurring',
-      schedule: 'every 6h',
-      skill: 'email-sync',
-      priority: 'normal',
-    },
-    // Manual one-time tasks
-    {
-      title: 'Slack: Full History Backfill',
-      description: 'One-time full Slack history pull (2022-present). Run manually to backfill all past conversations.',
-      type: 'once',
-      skill: 'slack-backfill',
-      priority: 'normal',
-    },
-    {
-      title: 'Email: Full Send History Pull',
-      description: 'One-time full sync of sent email history from macOS Mail. Run manually to backfill.',
-      type: 'once',
-      skill: 'email-sync',
-      skill_config: JSON.stringify({ days_back: 90, sync_inbox: true }),
-      priority: 'normal',
-    },
-  ];
-
-  for (const t of coreTasks) {
-    brain.insertTask(t);
-  }
+  const existing = brain.listTasks({ limit: 1 });
+  if (existing.length > 0) return;
+  const coreTasks = require('./core-tasks');
+  for (const t of coreTasks) brain.insertTask(t);
   console.log('[wall-e] Bootstrapped ' + coreTasks.length + ' core tasks');
 }
 

package/template/wall-e/api-walle.js

@@ -34,14 +34,7 @@ function ensureBrainInit() {
     try {
       const tasks = brain.listTasks({ limit: 1 });
       if (tasks.length === 0) {
-        const coreTasks = [
-          { title: 'Morning Briefing', description: 'Daily briefing: calendar, Slack, tasks, mentions.', type: 'recurring', schedule: 'daily at 7am', skill: 'morning-briefing' },
-          { title: 'Sync Calendar', description: 'Sync macOS Calendar events via EventKit.', type: 'recurring', schedule: 'every 30m', skill: 'google-calendar' },
-          { title: 'Slack: Conversation Sync', description: 'Pull latest Slack messages into brain.', type: 'recurring', schedule: 'every 15m', skill: 'slack-sync' },
-          { title: 'Email: Conversation Sync', description: 'Sync emails from macOS Mail.', type: 'recurring', schedule: 'every 6h', skill: 'email-sync' },
-          { title: 'Slack: Full History Backfill', description: 'One-time full Slack history pull. Run manually.', type: 'once', skill: 'slack-backfill' },
-          { title: 'Email: Full Send History Pull', description: 'One-time full email sync (90 days). Run manually.', type: 'once', skill: 'email-sync', skill_config: JSON.stringify({ days_back: 90, sync_inbox: true }) },
-        ];
+        const coreTasks = require('./core-tasks');
         for (const t of coreTasks) brain.insertTask(t);
         console.log('[api-walle] Bootstrapped ' + coreTasks.length + ' core tasks');
       }
@@ -530,6 +523,20 @@ function handleWalleApi(req, res, url) {
     return true;
   }
 
+  // GET /api/wall-e/tasks/:id — single task by ID
+  const taskGetMatch = p.match(/^\/api\/wall-e\/tasks\/([^/]+)$/);
+  if (taskGetMatch && m === 'GET') {
+    if (!brain || !ensureBrainInit()) return jsonResponse(res, { error: 'Brain module not available' }, 503), true;
+    try {
+      const t = brain.getTask(taskGetMatch[1]);
+      if (!t) return jsonResponse(res, { error: 'Task not found' }, 404), true;
+      jsonResponse(res, { data: t });
+    } catch (e) {
+      jsonResponse(res, { error: e.message }, 500);
+    }
+    return true;
+  }
+
   // POST /api/wall-e/tasks
   if (p === '/api/wall-e/tasks' && m === 'POST') {
     if (!brain || !ensureBrainInit()) return jsonResponse(res, { error: 'Brain module not available' }, 503), true;

package/template/wall-e/core-tasks.js

@@ -0,0 +1,53 @@
+'use strict';
+
+// Core tasks bootstrapped on first run.
+// Shared between agent.js and api-walle.js to avoid duplication.
+module.exports = [
+  {
+    title: 'Morning Briefing',
+    description: 'Generate a daily morning briefing with calendar, Slack activity, pending tasks, and mentions.',
+    type: 'recurring',
+    schedule: 'daily at 7am',
+    skill: 'morning-briefing',
+    priority: 'normal',
+  },
+  {
+    title: 'Sync Calendar',
+    description: 'Sync macOS Calendar events (Google, iCloud, Outlook) into Wall-E brain via EventKit.',
+    type: 'recurring',
+    schedule: 'every 30m',
+    skill: 'google-calendar',
+    priority: 'normal',
+  },
+  {
+    title: 'Slack: Conversation Sync',
+    description: 'Pull latest Slack messages from active conversations into Wall-E brain.',
+    type: 'recurring',
+    schedule: 'every 15m',
+    skill: 'slack-sync',
+    priority: 'normal',
+  },
+  {
+    title: 'Email: Conversation Sync',
+    description: 'Sync sent and inbox emails from macOS Mail into Wall-E brain.',
+    type: 'recurring',
+    schedule: 'every 6h',
+    skill: 'email-sync',
+    priority: 'normal',
+  },
+  {
+    title: 'Slack: Full History Backfill',
+    description: 'One-time full Slack history pull (2022-present). Run manually to backfill all past conversations.',
+    type: 'once',
+    skill: 'slack-backfill',
+    priority: 'normal',
+  },
+  {
+    title: 'Email: Full Send History Pull',
+    description: 'One-time full sync of sent email history from macOS Mail. Run manually to backfill.',
+    type: 'once',
+    skill: 'email-sync',
+    skill_config: JSON.stringify({ days_back: 90, sync_inbox: true }),
+    priority: 'normal',
+  },
+];

package/template/wall-e/skills/_bundled/file-ingest/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: file-ingest
+description: >
+  Read files from a local folder and ingest their contents into Wall-E's brain
+  as memories. Supports text files (.md, .txt, .json, .csv, .js, .py, .html, etc).
+  Use for importing notes, documents, code, meeting notes, or any text-based
+  knowledge into the brain for search and context.
+version: 1.0.0
+author: wall-e
+execution: script
+entry: run.js
+trigger:
+  type: manual
+config:
+  folder:
+    type: string
+    description: "Path to the folder to ingest (required)"
+  pattern:
+    type: string
+    default: "*"
+    description: "Glob pattern to filter files (e.g. '*.md', '*.txt')"
+  recursive:
+    type: boolean
+    default: true
+    description: "Whether to recurse into subdirectories"
+  max_file_size_kb:
+    type: number
+    default: 500
+    description: "Skip files larger than this (KB)"
+tags: [sync, data, files]
+permissions:
+  - brain:write
+---
+
+# File Ingest
+
+Reads text files from a local folder and stores each file's content as a memory
+in Wall-E's brain. Files are deduplicated by path — re-running on the same folder
+updates existing memories rather than creating duplicates.
+
+## Usage
+
+Run manually from the Tasks tab, or via the API:
+
+```bash
+curl -X POST http://localhost:3456/api/wall-e/skills/file-ingest/run \
+  -H 'Content-Type: application/json' \
+  -d '{"config": {"folder": "~/Documents/notes"}}'
+```
+
+## Supported File Types
+
+`.md` `.txt` `.json` `.csv` `.js` `.ts` `.py` `.html` `.xml` `.yaml` `.yml`
+`.sh` `.css` `.sql` `.env` `.cfg` `.ini` `.log` `.rst` `.org`
+
+Binary files, images, and files exceeding the size limit are skipped.

package/template/wall-e/skills/_bundled/file-ingest/run.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * File Ingest — read files from a folder and store as brain memories.
+ *
+ * Each file becomes one memory with:
+ *   source: 'file'
+ *   source_id: absolute file path (for dedup)
+ *   source_channel: folder name
+ *   content: file contents (truncated if very large)
+ *   subject: filename
+ *   memory_type: 'document'
+ */
+const fs = require('fs');
+const path = require('path');
+const brain = require(path.resolve(__dirname, '..', '..', '..', 'brain'));
+
+brain.initDb();
+
+const TEXT_EXTENSIONS = new Set([
+  '.md', '.txt', '.json', '.csv', '.js', '.ts', '.jsx', '.tsx',
+  '.py', '.html', '.xml', '.yaml', '.yml', '.sh', '.bash', '.zsh',
+  '.css', '.scss', '.sql', '.env', '.cfg', '.ini', '.log', '.rst',
+  '.org', '.toml', '.rb', '.go', '.java', '.c', '.cpp', '.h',
+  '.swift', '.kt', '.rs', '.r', '.m', '.php', '.pl', '.lua',
+]);
+
+function expandHome(p) {
+  if (p.startsWith('~/')) return path.join(process.env.HOME, p.slice(2));
+  return p;
+}
+
+function walkDir(dir, recursive, pattern) {
+  const results = [];
+  let entries;
+  try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return results; }
+
+  for (const entry of entries) {
+    if (entry.name.startsWith('.')) continue; // skip hidden
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory() && recursive) {
+      results.push(...walkDir(fullPath, recursive, pattern));
+    } else if (entry.isFile()) {
+      const ext = path.extname(entry.name).toLowerCase();
+      if (!TEXT_EXTENSIONS.has(ext)) continue;
+      if (pattern && pattern !== '*') {
+        const glob = pattern.replace(/\*/g, '.*').replace(/\?/g, '.');
+        if (!new RegExp('^' + glob + '$', 'i').test(entry.name)) continue;
+      }
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+function main() {
+  // Read config from env or args
+  const configStr = process.env.SKILL_CONFIG || process.argv[2] || '{}';
+  let config;
+  try { config = JSON.parse(configStr); } catch { config = {}; }
+
+  const folder = expandHome(config.folder || '');
+  if (!folder) {
+    console.error('Error: folder is required. Pass via config: {"folder": "~/path/to/files"}');
+    process.exit(1);
+  }
+
+  const resolvedFolder = path.resolve(folder);
+  if (!fs.existsSync(resolvedFolder)) {
+    console.error('Error: folder not found:', resolvedFolder);
+    process.exit(1);
+  }
+
+  const recursive = config.recursive !== false;
+  const pattern = config.pattern || '*';
+  const maxSizeKb = config.max_file_size_kb || 500;
+  const maxSizeBytes = maxSizeKb * 1024;
+
+  console.log(`# File Ingest\n`);
+  console.log(`Folder: ${resolvedFolder}`);
+  console.log(`Pattern: ${pattern} | Recursive: ${recursive} | Max size: ${maxSizeKb}KB\n`);
+
+  const files = walkDir(resolvedFolder, recursive, pattern);
+  console.log(`Found ${files.length} text file(s)\n`);
+
+  let ingested = 0, skipped = 0, updated = 0;
+  const folderName = path.basename(resolvedFolder);
+
+  for (const filePath of files) {
+    const stat = fs.statSync(filePath);
+    if (stat.size > maxSizeBytes) {
+      skipped++;
+      continue;
+    }
+
+    let content;
+    try { content = fs.readFileSync(filePath, 'utf8'); } catch { skipped++; continue; }
+
+    // Truncate very long files to keep brain manageable
+    if (content.length > 50000) {
+      content = content.slice(0, 50000) + '\n\n[... truncated at 50KB]';
+    }
+
+    const relPath = path.relative(resolvedFolder, filePath);
+    const fileName = path.basename(filePath);
+    const sourceId = 'file:' + filePath;
+
+    // Check if already exists (dedup by source + source_id)
+    const existing = brain.getDb().prepare(
+      'SELECT id FROM memories WHERE source = ? AND source_id = ?'
+    ).get('file', sourceId);
+
+    if (existing) {
+      // Update content if changed
+      brain.getDb().prepare(
+        'UPDATE memories SET content = ?, timestamp = ?, subject = ? WHERE id = ?'
+      ).run(content, stat.mtime.toISOString(), relPath, existing.id);
+      updated++;
+    } else {
+      brain.insertMemory({
+        source: 'file',
+        source_id: sourceId,
+        source_channel: folderName,
+        memory_type: 'document',
+        content,
+        subject: relPath,
+        timestamp: stat.mtime.toISOString(),
+      });
+      ingested++;
+    }
+  }
+
+  console.log(`Results:`);
+  console.log(`  New:     ${ingested}`);
+  console.log(`  Updated: ${updated}`);
+  console.log(`  Skipped: ${skipped} (too large or unreadable)`);
+  console.log(`  Total:   ${files.length}`);
+
+  brain.closeDb();
+}
+
+main();