@pikaa-ai/pikaa 0.3.21 → 0.3.23

package/dist/cli.js

@@ -1084,6 +1084,9 @@ class EphemeralWorkspaceManager {
         /^scratch_/i,
         /^temp_/i,
         /^preview_.*\.html$/i,
+        /.*_log\.txt$/i,
+        /\.log$/i,
+        /^check\.(ps1|bat|cmd|sh)$/i,
         /\.tmp$/i,
         /\.bak$/i,
         /~$/i
@@ -5225,6 +5228,27 @@ class SessionPersistenceManager {
       return null;
     }
   }
+  unbindSession() {
+    for (const unsub of this.unsubscribers) {
+      try {
+        unsub();
+      } catch {}
+    }
+    this.unsubscribers = [];
+  }
+  resumeIntoSession(session, threadId) {
+    const restored = this.loadSession(threadId);
+    if (!restored)
+      return null;
+    this.unbindSession();
+    session.threadId = restored.thread.id;
+    session.setHistory(restored.items);
+    if (restored.thread.model) {
+      session.model = restored.thread.model;
+    }
+    this.bindSession(session, restored.thread.role);
+    return restored;
+  }
   listSessions(options) {
     return this.store.listThreads(options);
   }
@@ -6632,7 +6656,7 @@ function parsePatch(oldSrc, newSrc, contextLines = 3) {
 // package.json
 var package_default = {
   name: "@pikaa-ai/pikaa",
-  version: "0.3.21",
+  version: "0.3.23",
   description: "PIKAA CLI - AI coding agent that runs locally in your terminal.",
   main: "./dist/index.js",
   module: "./dist/index.js",
@@ -8834,7 +8858,8 @@ var AVAILABLE_SLASH_COMMANDS = [
   { name: "/skills", description: "List domain skills in workspace & global" },
   { name: "/memories", description: "View learned preferences & memories" },
   { name: "/worktrees", description: "List active isolated Git Worktrees" },
-  { name: "/sessions", description: "List saved past sessions from SQLite store" },
+  { name: "/resume", description: "Resume a previous conversation session (/resume [id])" },
+  { name: "/sessions", description: "List and manage saved past sessions" },
   { name: "/role", description: "Select and inspect specialized agent roles & personas" },
   { name: "/security", description: "Scan codebase for vulnerabilities & secrets (Strix)" },
   { name: "/agents", description: "List active sub-agents & execution status" },
@@ -8942,9 +8967,10 @@ async function handleSlashCommand(input, ctx) {
     case "/worktree":
       await printWorktrees(ctx);
       return true;
+    case "/resume":
     case "/sessions":
     case "/session":
-      await printSessions(ctx);
+      await handleResumeCommand(ctx, args);
       return true;
     case "/security":
     case "/audit":
@@ -9479,41 +9505,104 @@ function printMemories(ctx) {
   }
   console.log();
 }
-async function printSessions(ctx) {
+function formatRelativeTime(timestamp) {
+  const diffMs = Math.max(0, Date.now() - timestamp);
+  const diffSec = Math.floor(diffMs / 1000);
+  if (diffSec < 60)
+    return "just now";
+  const diffMin = Math.floor(diffSec / 60);
+  if (diffMin < 60)
+    return `${diffMin}m ago`;
+  const diffHours = Math.floor(diffMin / 60);
+  if (diffHours < 24)
+    return `${diffHours}h ago`;
+  const diffDays = Math.floor(diffHours / 24);
+  if (diffDays < 30)
+    return `${diffDays}d ago`;
+  return new Date(timestamp).toLocaleDateString();
+}
+function printRecentConversation(items) {
+  if (!items || items.length === 0)
+    return;
+  const dialog = items.filter((i) => i.type === "user_message" || i.type === "agent_message" || i.role === "user" || i.role === "assistant").slice(-3);
+  if (dialog.length === 0)
+    return;
+  console.log(style.dim("  Recent context:"));
+  for (const item of dialog) {
+    const isUser = item.role === "user" || item.type === "user_message";
+    const text = typeof item.content === "string" ? item.content : item.text || "";
+    const singleLine = text.trim().replace(/\s+/g, " ");
+    const preview = singleLine.length > 85 ? singleLine.slice(0, 82) + "..." : singleLine;
+    const badge = isUser ? style.brand("  \u276F User:") : style.cyan("  \u25CF Assistant:");
+    console.log(`${badge} ${style.dim(preview)}`);
+  }
+  console.log();
+}
+async function handleResumeCommand(ctx, args = []) {
   const storage = ctx.storageManager;
   if (!storage) {
-    console.log(style.yellow("Session persistence manager not active."));
+    console.log(style.yellow(`
+  Session persistence manager not active.
+`));
     return;
   }
-  const threads = storage.listSessions();
-  if (threads.length === 0) {
+  const rawThreads = storage.listSessions();
+  if (rawThreads.length === 0) {
     console.log(style.dim(`
-  No saved sessions in SQLite database.
+  No saved conversation sessions found in SQLite database.
 `));
     return;
   }
+  const threads = [...rawThreads].sort((a, b) => b.updatedAt - a.updatedAt);
+  const filterArg = args[0]?.trim();
+  let defaultIdx = 0;
+  if (filterArg) {
+    const foundIdx = threads.findIndex((t) => t.id === filterArg || t.id.toLowerCase().startsWith(filterArg.toLowerCase()));
+    if (foundIdx !== -1) {
+      defaultIdx = foundIdx;
+    }
+  }
   if (!process.stdin.isTTY || false || !process.stdin.readable) {
+    if (filterArg) {
+      const match = threads[defaultIdx];
+      const restored = storage.resumeIntoSession(ctx.session, match.id);
+      if (restored) {
+        console.log(style.green(`
+  \u2713 Resumed past session: ${style.bold(match.id)} (${restored.items.length} items, model: ${restored.thread.model || ctx.session.model})
+`));
+        printRecentConversation(restored.items);
+      } else {
+        console.log(style.red(`
+  \u2715 Failed to load session '${match.id}'.
+`));
+      }
+      return;
+    }
     console.log();
     console.log(style.bold("  Saved Sessions in SQLite Store:"));
     for (const t of threads) {
-      const dateStr = new Date(t.updatedAt).toLocaleString();
-      console.log(`    \u2022 ${style.cyan(t.id)} [${style.dim(t.model)}] - ${style.dim(dateStr)} (${t.itemsCount} items)`);
+      const timeStr = formatRelativeTime(t.updatedAt);
+      const titleStr = t.title && t.title !== "New Session" ? ` - "${t.title}"` : "";
+      console.log(`    \u2022 ${style.cyan(t.id)} [${style.dim(t.model)}]${titleStr} - ${style.dim(timeStr)} (${t.itemsCount ?? 0} items)`);
     }
     console.log();
     return;
   }
   const items = threads.map((t) => {
-    const dateStr = new Date(t.updatedAt).toLocaleString();
+    const timeStr = formatRelativeTime(t.updatedAt);
+    const titlePart = t.title && t.title !== "New Session" ? `"${t.title.slice(0, 36)}"` : undefined;
     return {
       id: t.id,
       label: t.id,
-      description: `${t.model} \xB7 ${t.itemsCount} items \xB7 ${dateStr}`
+      badge: t.model,
+      description: [titlePart, `${t.itemsCount ?? 0} items`, timeStr].filter(Boolean).join(" \xB7 ")
     };
   });
   const res = await promptInteractiveList({
-    title: `\uD83D\uDDC4\uFE0F Saved SQLite Sessions (${threads.length} total)`,
+    title: `\uD83D\uDDC4\uFE0F Resume Past Conversation (${threads.length} saved)`,
     items,
     mode: "select",
+    defaultIndex: defaultIdx,
     onAction: (key, item, idx) => {
       if (key === "d") {
         storage.deleteSession(item.id);
@@ -9523,18 +9612,24 @@ async function printSessions(ctx) {
       }
       return false;
     },
-    customKeyHints: "\u2191/\u2193: navigate \xB7 Enter: resume session \xB7 d: delete \xB7 Esc: exit"
+    customKeyHints: "\u2191/\u2193: navigate \xB7 Enter: resume conversation \xB7 d: delete \xB7 Esc: cancel"
   });
   if (res.action === "select" && res.selectedItem) {
-    const session = storage.loadSession(res.selectedItem.id);
-    if (session) {
-      ctx.session.setHistory(session.items);
-      if (session.thread.model)
-        ctx.session.model = session.thread.model;
+    const restored = storage.resumeIntoSession(ctx.session, res.selectedItem.id);
+    if (restored) {
       console.log(style.green(`
-  \u2713 Resumed past session: ${style.bold(res.selectedItem.id)} (${session.items.length} items)
+  \u2713 Resumed past conversation: ${style.bold(res.selectedItem.id)} (${restored.items.length} items, model: ${restored.thread.model || ctx.session.model})
+`));
+      printRecentConversation(restored.items);
+    } else {
+      console.log(style.red(`
+  \u2715 Failed to load session '${res.selectedItem.id}'.
 `));
     }
+  } else {
+    console.log(style.dim(`
+  Session resume cancelled.
+`));
   }
 }
 function printSessionStats(ctx) {

package/dist/index.js

@@ -2367,6 +2367,9 @@ class EphemeralWorkspaceManager {
         /^scratch_/i,
         /^temp_/i,
         /^preview_.*\.html$/i,
+        /.*_log\.txt$/i,
+        /\.log$/i,
+        /^check\.(ps1|bat|cmd|sh)$/i,
         /\.tmp$/i,
         /\.bak$/i,
         /~$/i
@@ -9097,6 +9100,27 @@ class SessionPersistenceManager {
       return null;
     }
   }
+  unbindSession() {
+    for (const unsub of this.unsubscribers) {
+      try {
+        unsub();
+      } catch {}
+    }
+    this.unsubscribers = [];
+  }
+  resumeIntoSession(session2, threadId) {
+    const restored = this.loadSession(threadId);
+    if (!restored)
+      return null;
+    this.unbindSession();
+    session2.threadId = restored.thread.id;
+    session2.setHistory(restored.items);
+    if (restored.thread.model) {
+      session2.model = restored.thread.model;
+    }
+    this.bindSession(session2, restored.thread.role);
+    return restored;
+  }
   listSessions(options) {
     return this.store.listThreads(options);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikaa-ai/pikaa",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "description": "PIKAA CLI - AI coding agent that runs locally in your terminal.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/skills/guardian-rails/SKILL.md

@@ -17,12 +17,13 @@ All AI agents, sub-agents, and domain skills must adhere to these non-negotiable
 NEVER DUMP TEMPORARY, SCRATCH, OR DRAFT FILES INTO THE WORKSPACE ROOT OR RANDOM FOLDERS.
 ```
 
-* ❌ **Forbidden Patterns**:
-  * `temp_*`, `tmp_*`, `scratch_*`, `draft_*`, `sandbox_*`
-  * `test_preview.html`, `design_draft.tsx`, `preview.html`, `mock_*.json`
-  * One-off scripts dumped into root directory (`test.js`, `run.py`, `script.sh`)
+* ❌ **Forbidden Anti-Patterns**:
+  * Temporary scripts or logs in project root: `build_log.txt`, `dev_log.txt`, `output.log`, `*.log`, `*_log.txt`, `check.ps1`, `test.ps1`, `script.sh`
+  * Command output redirection to files (e.g. `npm run build > build_log.txt 2>&1`)
+  * `temp_*`, `tmp_*`, `scratch_*`, `draft_*`, `sandbox_*`, `test_preview.html`, `preview.html`, `mock_*.json`
 * ✅ **Mandatory Practice**:
-  * Implement code **in-place** directly within the project's real directory architecture (e.g., `src/components/`, `src/pages/`, `lib/`, `tests/`).
+  * **Direct Command Execution**: Run build, test, and verification commands directly via the `shell` tool and inspect standard output / standard error directly from the returned tool output. Never dump stdout/stderr into `.txt` or `.log` files.
+  * **In-Place Architecture**: Implement code directly within the project's real directory architecture (e.g., `components/`, `src/components/`, `app/`, `lib/`, `tests/`).
   * If a file path is ambiguous, inspect existing project structure (`list_dir`, `find_files`) to locate the correct directory before writing.
 
 ---

package/templates/base/groupy_prompt.md

@@ -12,9 +12,10 @@ You are Groupy, an expert autonomous AI coding assistant. You are running as a c
 
 ## Global Guardian Rails (Zero-Pollution & Workspace Integrity)
 
-- **ABSOLUTE BAN ON TEMPORARY / SCRATCH FILES**:
+- **ABSOLUTE BAN ON TEMPORARY / SCRATCH / LOG FILES**:
   * **NEVER** create temporary, draft, or scratch files in the workspace root or arbitrary subfolders (e.g., `temp_*`, `tmp_*`, `scratch_*`, `draft_*`, `preview.html`, `test_design.*`, `sandbox_*`, `mock_*.json`).
-  * **MANDATORY IN-PLACE EDITING**: All new code, UI components, styles, or scripts must be written directly into the actual project's intended architecture (e.g. `src/components/`, `src/views/`, `app/`, `lib/`, `tests/`).
+  * **NO LOG DUMPING & NO SCRIPT WRAPPERS**: Do NOT redirect command output to log files (e.g. `npm run build > build_log.txt`) or create temporary helper scripts in root (e.g. `check.ps1`, `test.bat`, `run.sh`). Run all commands directly via the `shell` tool and read stdout/stderr directly from the tool output.
+  * **MANDATORY IN-PLACE EDITING**: All new code, UI components, styles, or scripts must be written directly into the actual project's intended architecture (e.g. `src/components/`, `components/`, `app/`, `lib/`, `tests/`).
   * **FRONTEND & DESIGN RULE**: When asked to design UI or pages, implement production-grade components directly inside the project's source tree matching existing framework patterns. Do NOT dump standalone preview HTML/JSX files in root.
   * **SELF-CLEANUP PROTOCOL**: If any transient test script/artifact is absolutely required for a one-off sanity run, it MUST be removed before concluding the turn.
   * **NO TRASH LEFT BEHIND**: Before reporting completion, ensure the workspace is clean and unpolluted (`git status`).