@tdsoft-tech/aikit 0.1.30 → 0.1.31

package/dist/index.d.ts

@@ -943,6 +943,11 @@ declare class AntiHallucination {
     private patternToRegex;
 }
 
+/**
+ * Non-blocking public API for CLI
+ */
+declare function checkForUpdatesAsync(): Promise<void>;
+
 /**
  * Simple logger with colored output
  */
@@ -1038,4 +1043,4 @@ declare const paths: {
  */
 declare function getVersion(): string;
 
-export { type AIKitConfig, type Agent, AgentManager, type AgentType, AntiHallucination, BeadsIntegration, type Command, CommandRunner, Config, type Memory, MemoryManager, type Plugin, type PluginEvent, PluginSystem, type Skill, SkillEngine, type Tool, ToolRegistry, getVersion as VERSION, defineTool, loadConfig, logger, paths };
+export { type AIKitConfig, type Agent, AgentManager, type AgentType, AntiHallucination, BeadsIntegration, type Command, CommandRunner, Config, type Memory, MemoryManager, type Plugin, type PluginEvent, PluginSystem, type Skill, SkillEngine, type Tool, ToolRegistry, getVersion as VERSION, checkForUpdatesAsync, defineTool, loadConfig, logger, paths };

package/dist/index.js

@@ -153,6 +153,7 @@ var init_paths = __esm({
 import { readFileSync } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname, join as join2 } from "path";
+import { compare, gt, valid } from "semver";
 function getVersion() {
   try {
     const __filename2 = fileURLToPath2(import.meta.url);
@@ -165,6 +166,9 @@ function getVersion() {
     return "0.0.0";
   }
 }
+function isGreaterThan(v1, v2) {
+  return gt(v1, v2);
+}
 var init_version = __esm({
   "src/utils/version.ts"() {
     "use strict";
@@ -3459,14 +3463,14 @@ Total: 2 checkpoints
 init_esm_shims();
 var SESSION_COMMANDS = [
   {
-    name: "session:start",
+    name: "session-start",
     description: "Start a new development session",
     category: "session",
-    usage: "/session:start [name]",
+    usage: "/session-start [name]",
     examples: [
-      "/session:start",
-      "/session:start authentication-refactor",
-      '/session:start "Add user profile feature"'
+      "/session-start",
+      "/session-start authentication-refactor",
+      '/session-start "Add user profile feature"'
     ],
     content: `Start a new development session to track your work.
 
@@ -3474,47 +3478,70 @@ var SESSION_COMMANDS = [
 
 Session name: $ARGUMENTS
 
-1. **Create Session:**
-   - Generate session ID with timestamp
-   - Create session file in .aikit/sessions/
-   - Track active session in .current-session
-   - Capture initial git state
+**IMPORTANT - Scope Rules:**
+- Sessions are scoped to the CURRENT working directory
+- AIKit will NOT search parent directories for .aikit
+- If .aikit doesn't exist in current directory, you MUST run 'aikit init' first
+- Each directory needs its own .aikit if you want separate session tracking
+
+1. **Check Current Directory:**
+   - Verify .aikit exists in current directory (process.cwd())
+   - If not, inform user to run 'aikit init' first
+   - DO NOT search parent directories
 
-2. **Set Goals:**
+2. **Create Session:**
+   - Generate session ID with timestamp
+   - Create session file in .aikit/sessions/ (current directory only)
+   - Determine session tracker file:
+     * Try 'tty' command to get terminal identifier
+     * If 'tty' works, use .aikit/sessions/.current-<sanitized_tty>-session
+       (replace '/' with '-' in TTY path)
+     * If 'tty' fails with "not a tty", get parent PID using: ps -o ppid= -p $$
+       Use .aikit/sessions/.current-ppid-<PPID>-session
+       (each Claude Code window has unique PPID)
+   - Write session ID to the tracker file
+   - **Capture initial git state (scoped to current directory):**
+     * First check if .git exists in CURRENT directory (process.cwd())
+     * ONLY capture git state if .git exists in current directory
+     * DO NOT search parent directories for git repo
+     * If no .git in current directory, skip git state capture
+
+3. **Set Goals:**
    - Ask user for session goals if not provided
    - Document what you want to accomplish
    - Link to Beads task if active
 
-3. **Session Started:**
+4. **Session Started:**
    - Session ID: YYYY-MM-DD-HHMM[-name]
    - Status: active
    - Ready for updates
 
 ## What Gets Tracked
 - Session start time
-- Git branch and commits
-- Modified files
+- Git branch and commits (ONLY if .git exists in current directory)
+- Modified files (ONLY if .git exists in current directory)
 - Progress notes
 - Linked Beads task
 
 ## Session File Location
-.aikit/sessions/YYYY-MM-DD-HHMM[-name].md
+Current directory: .aikit/sessions/YYYY-MM-DD-HHMM[-name].md
+(Always relative to process.cwd(), never parent directories)
 
 ## Examples
 
 Start unnamed session:
 \`\`\`
-/session:start
+/session-start
 \`\`\`
 
 Start with descriptive name:
 \`\`\`
-/session:start auth-refactor
+/session-start auth-refactor
 \`\`\`
 
 Start with goal:
 \`\`\`
-/session:start "Implement OAuth 2.0"
+/session-start "Implement OAuth 2.0"
 Goals:
 - Add Google OAuth
 - Add JWT token handling
@@ -3523,18 +3550,18 @@ Goals:
 ## Notes
 - Session files are markdown with frontmatter
 - Sessions persist across AI conversations
-- Use /session:update to add progress notes
-- Use /session:end to close and summarize`
+- Use /session-update to add progress notes
+- Use /session-end to close and summarize`
   },
   {
-    name: "session:update",
+    name: "session-update",
     description: "Add progress notes to current session",
     category: "session",
-    usage: "/session:update [notes]",
+    usage: "/session-update [notes]",
     examples: [
-      "/session:update",
-      "/session:update Fixed authentication bug",
-      '/session:update "Added JWT middleware"'
+      "/session-update",
+      "/session-update Fixed authentication bug",
+      '/session-update "Added JWT middleware"'
     ],
     content: `Update the current session with progress notes.
 
@@ -3543,19 +3570,28 @@ Goals:
 Progress notes: $ARGUMENTS
 
 1. **Check Active Session:**
-   - Verify there's an active session
+   - Determine session tracker file:
+     * Try 'tty' command to get terminal identifier
+     * If 'tty' works, read .aikit/sessions/.current-<sanitized_tty>-session
+     * If 'tty' fails, get parent PID and read .aikit/sessions/.current-ppid-<PPID>-session
    - Load session file
 
 2. **Capture Current State:**
-   - Get current git branch
-   - Count git commits
-   - List modified files
-   - Check active Beads task
+   - **IMPORTANT - Git State Scope:**
+     * First check if .git exists in CURRENT directory (process.cwd())
+     * ONLY capture git state if .git exists in current directory
+     * DO NOT search parent directories for git repo
+     * If no .git in current directory, skip git state capture
+   - If .git exists in current directory:
+     * Get current git branch
+     * Count git commits
+     * List modified files
+   - Check active Beads task (from .beads directory if exists)
 
 3. **Add Update:**
    - Add timestamped update entry
    - Include your notes (or auto-generate)
-   - Include git state
+   - Include git state ONLY if .git exists in current directory
    - Include Beads task if active
 
 4. **Save Session:**
@@ -3565,27 +3601,25 @@ Progress notes: $ARGUMENTS
 ## What Gets Captured
 - Timestamp of update
 - Your progress notes
-- Current git branch
-- Number of commits
-- List of modified files
+- Git state (branch, commits, files) - ONLY if .git exists in current directory
 - Active Beads task (if any)
 
 ## Examples
 
 Auto-update (no notes):
 \`\`\`
-/session:update
+/session-update
 \`\`\`
 *Auto-generates summary of recent work*
 
 With specific notes:
 \`\`\`
-/session:update Fixed Next.js params issue
+/session-update Fixed Next.js params issue
 \`\`\`
 
 With detailed notes:
 \`\`\`
-/session:update "Implemented OAuth flow with Google provider. Added callback handler and token validation."
+/session-update "Implemented OAuth flow with Google provider. Added callback handler and token validation."
 \`\`\`
 
 ## Notes
@@ -3595,11 +3629,11 @@ With detailed notes:
 - Beads task automatically linked`
   },
   {
-    name: "session:end",
+    name: "session-end",
     description: "End current session with summary",
     category: "session",
-    usage: "/session:end",
-    examples: ["/session:end"],
+    usage: "/session-end",
+    examples: ["/session-end"],
     content: `End the current session and generate a comprehensive summary.
 
 ## Workflow
@@ -3629,7 +3663,10 @@ With detailed notes:
    - Mark session as ended
    - Set end time
    - Save session file
-   - Clear .current-session tracker
+   - Determine session tracker file:
+     * Try 'tty' command to get terminal identifier
+     * If 'tty' works, clear .aikit/sessions/.current-<sanitized_tty>-session
+     * If 'tty' fails, get parent PID and clear .aikit/sessions/.current-ppid-<PPID>-session
 
 ## Summary Includes
 
@@ -3684,17 +3721,20 @@ Lessons:
 - Can start new session after ending`
   },
   {
-    name: "session:current",
+    name: "session-current",
     description: "Show current active session",
     category: "session",
-    usage: "/session:current",
-    examples: ["/session:current"],
+    usage: "/session-current",
+    examples: ["/session-current"],
     content: `Display information about the current active session.
 
 ## Workflow
 
 1. **Check Active Session:**
-   - Read .current-session file
+   - Determine session tracker file:
+     * Try 'tty' command to get terminal identifier
+     * If 'tty' works, read .aikit/sessions/.current-<sanitized_tty>-session
+     * If 'tty' fails, get parent PID and read .aikit/sessions/.current-ppid-<PPID>-session
    - Load session data
 
 2. **Display Session Info:**
@@ -3734,8 +3774,8 @@ Beads Task:
 - bead-001 (in-progress)
 
 Commands:
-/session:update [notes] - Add progress
-/session:end - Close session
+/session-update [notes] - Add progress
+/session-end - Close session
 \`\`\`
 
 ## Notes
@@ -3744,18 +3784,18 @@ Commands:
 - Displays recent progress`
   },
   {
-    name: "session:list",
+    name: "session-list",
     description: "List all sessions",
     category: "session",
-    usage: "/session:list",
-    examples: ["/session:list"],
+    usage: "/session-list",
+    examples: ["/session-list"],
     content: `List all development sessions with summaries.
 
 ## Workflow
 
 1. **Scan Sessions Directory:**
    - Find all .md files in .aikit/sessions/
-   - Exclude .current-session
+   - Exclude all .current-*-session files (terminal trackers)
 
 2. **Sort by Date:**
    - Newest sessions first
@@ -3798,16 +3838,16 @@ Total: 3 sessions
 - Shows both active and ended sessions
 - Most recent sessions first
 - Active session highlighted
-- Use /session:show <id> for details`
+- Use /session-show <id> for details`
   },
   {
-    name: "session:show",
+    name: "session-show",
     description: "Show details of a specific session",
     category: "session",
-    usage: "/session:show <session-id>",
+    usage: "/session-show <session-id>",
     examples: [
-      "/session:show 2025-01-02-1430",
-      "/session:show 2025-01-02-1430-auth-refactor"
+      "/session-show 2025-01-02-1430",
+      "/session-show 2025-01-02-1430-auth-refactor"
     ],
     content: `Display full details of a specific session.
 
@@ -3878,14 +3918,14 @@ Successfully refactored authentication system...
 - Full session details displayed`
   },
   {
-    name: "session:search",
+    name: "session-search",
     description: "Search sessions by keyword",
     category: "session",
-    usage: "/session:search <query>",
+    usage: "/session-search <query>",
     examples: [
-      "/session:search oauth",
-      '/session:search "jwt"',
-      "/session:search authentication"
+      "/session-search oauth",
+      '/session-search "jwt"',
+      "/session-search authentication"
     ],
     content: `Search for sessions matching a keyword.
 
@@ -3906,7 +3946,7 @@ Search query: $ARGUMENTS
 
 3. **Show Actions:**
    - List matching sessions
-   - Suggest /session:show for details
+   - Suggest /session-show for details
 
 ## Example Output
 \`\`\`
@@ -3936,14 +3976,14 @@ Total: 2 matching sessions
 - Use partial IDs too`
   },
   {
-    name: "session:resume",
+    name: "session-resume",
     description: "Resume a past session (load context)",
     category: "session",
-    usage: "/session:resume <session-id>",
+    usage: "/session-resume <session-id>",
     examples: [
-      "/session:resume latest",
-      "/session:resume 2025-01-02-1430",
-      "/session:resume 2025-01-02-1430-auth-refactor"
+      "/session-resume latest",
+      "/session-resume 2025-01-02-1430",
+      "/session-resume 2025-01-02-1430-auth-refactor"
     ],
     content: `Load context from a past session to resume work.
 
@@ -6163,6 +6203,282 @@ List approved dependencies here.
   }
 };
 
+// src/core/update-manager.ts
+init_esm_shims();
+init_version();
+import chalk2 from "chalk";
+
+// src/utils/npm-client.ts
+init_esm_shims();
+import https from "https";
+async function getLatestVersion(packageName) {
+  return new Promise((resolve) => {
+    const url = `https://registry.npmjs.org/${packageName}`;
+    https.get(url, (res) => {
+      let data = "";
+      res.on("data", (chunk) => {
+        data += chunk;
+      });
+      res.on("end", () => {
+        try {
+          if (res.statusCode === 200) {
+            const packageData = JSON.parse(data);
+            const latestVersion = packageData["dist-tags"]?.latest;
+            resolve(latestVersion || null);
+          } else {
+            resolve(null);
+          }
+        } catch {
+          resolve(null);
+        }
+      });
+    }).on("error", () => {
+      resolve(null);
+    }).setTimeout(5e3, () => {
+      resolve(null);
+    });
+  });
+}
+
+// src/utils/update-cache.ts
+init_esm_shims();
+init_paths();
+import { readFile as readFile8, writeFile as writeFile9, mkdir as mkdir8 } from "fs/promises";
+import { existsSync as existsSync5 } from "fs";
+import { join as join13 } from "path";
+var CACHE_FILE = ".update-cache.json";
+var DEFAULT_CACHE = {
+  lastCheckTime: 0,
+  lastCheckedVersion: "0.0.0",
+  errorCount: 0
+};
+function getCachePath() {
+  const configDir = paths.globalConfig();
+  return join13(configDir, CACHE_FILE);
+}
+async function readCache() {
+  try {
+    const cachePath = getCachePath();
+    if (!existsSync5(cachePath)) {
+      return DEFAULT_CACHE;
+    }
+    const content = await readFile8(cachePath, "utf-8");
+    const data = JSON.parse(content);
+    return { ...DEFAULT_CACHE, ...data };
+  } catch {
+    return DEFAULT_CACHE;
+  }
+}
+async function writeCache(data) {
+  try {
+    const cachePath = getCachePath();
+    const configDir = paths.globalConfig();
+    if (!existsSync5(configDir)) {
+      await mkdir8(configDir, { recursive: true });
+    }
+    await writeFile9(cachePath, JSON.stringify(data, null, 2), "utf-8");
+  } catch {
+  }
+}
+async function setLastCheckTime(timestamp) {
+  const cache = await readCache();
+  cache.lastCheckTime = timestamp;
+  await writeCache(cache);
+}
+async function setLastCheckedVersion(version) {
+  const cache = await readCache();
+  cache.lastCheckedVersion = version;
+  await writeCache(cache);
+}
+async function setCompletedUpdate(version) {
+  const cache = await readCache();
+  cache.completedUpdate = version;
+  cache.completedUpdateTime = Date.now();
+  cache.errorCount = 0;
+  cache.lastError = void 0;
+  await writeCache(cache);
+}
+async function clearCompletedUpdate() {
+  const cache = await readCache();
+  cache.completedUpdate = void 0;
+  cache.completedUpdateTime = void 0;
+  await writeCache(cache);
+}
+async function incrementError(error) {
+  const cache = await readCache();
+  cache.errorCount += 1;
+  cache.lastError = error;
+  await writeCache(cache);
+}
+
+// src/core/background-updater.ts
+init_esm_shims();
+init_paths();
+import { spawn } from "child_process";
+import { writeFile as writeFile10, mkdir as mkdir9 } from "fs/promises";
+import { join as join14 } from "path";
+async function spawnUpdateProcess(targetVersion) {
+  try {
+    const configDir = paths.globalConfig();
+    const logsDir = join14(configDir, "logs");
+    await mkdir9(logsDir, { recursive: true });
+    const scriptContent = generateUpdateScript(targetVersion, logsDir);
+    const scriptPath = join14(configDir, "update-script.js");
+    await writeFile10(scriptPath, scriptContent, "utf-8");
+    const child = spawn(process.execPath, [scriptPath], {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: true
+    });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+}
+function generateUpdateScript(targetVersion, logsDir) {
+  return `
+// AIKit Auto-Update Script
+// Generated automatically - DO NOT EDIT
+
+const { spawn } = require('child_process');
+const { writeFile, appendFile } = require('fs').promises;
+const { join } = require('path');
+
+const configDir = '${paths.globalConfig().replace(/\\/g, "\\\\")}';
+const logsDir = '${logsDir.replace(/\\/g, "\\\\")}';
+const cachePath = join(configDir, '.update-cache.json');
+const errorLogPath = join(logsDir, 'update-error.log');
+const targetVersion = '${targetVersion}';
+
+async function logError(message) {
+  const timestamp = new Date().toISOString();
+  await appendFile(errorLogPath, \`[\${timestamp}] \${message}\\n\`);
+}
+
+async function updateCache(version, error) {
+  try {
+    const fs = require('fs');
+    let cache = { lastCheckTime: 0, lastCheckedVersion: '0.0.0', errorCount: 0 };
+
+    try {
+      cache = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+    } catch {}
+
+    if (error) {
+      cache.errorCount = (cache.errorCount || 0) + 1;
+      cache.lastError = error;
+    } else {
+      cache.completedUpdate = version;
+      cache.completedUpdateTime = Date.now();
+      cache.errorCount = 0;
+      cache.lastError = undefined;
+    }
+
+    await writeFile(cachePath, JSON.stringify(cache, null, 2));
+  } catch {}
+}
+
+async function runUpdate() {
+  return new Promise((resolve) => {
+    const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const child = spawn(npmCmd, ['install', '-g', '@tdsoft-tech/aikit@latest'], {
+      stdio: 'pipe',
+    });
+
+    let output = '';
+    let errorOutput = '';
+
+    child.stdout.on('data', (data) => {
+      output += data.toString();
+    });
+
+    child.stderr.on('data', (data) => {
+      errorOutput += data.toString();
+    });
+
+    child.on('close', async (code) => {
+      if (code === 0) {
+        await updateCache(targetVersion, null);
+        resolve(true);
+      } else {
+        const errorMsg = errorOutput || 'npm install failed';
+        await logError(\`Update failed (code \${code}): \${errorMsg}\`);
+        await updateCache(targetVersion, errorMsg);
+        resolve(false);
+      }
+    });
+
+    child.on('error', async (err) => {
+      await logError(\`Update error: \${err.message}\`);
+      await updateCache(targetVersion, err.message);
+      resolve(false);
+    });
+  });
+}
+
+// Run update and exit
+runUpdate().then(() => process.exit(0));
+`;
+}
+
+// src/core/update-manager.ts
+var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
+var PACKAGE_NAME = "@tdsoft-tech/aikit";
+async function shouldCheckForUpdates() {
+  const cache = await readCache();
+  const now = Date.now();
+  return now - cache.lastCheckTime > CHECK_INTERVAL;
+}
+async function displayNotification() {
+  const cache = await readCache();
+  if (cache.completedUpdate) {
+    const currentVersion = getVersion();
+    if (isGreaterThan(cache.completedUpdate, currentVersion)) {
+      console.log(chalk2.cyan.bold("\n\u2728 AIKit has been updated!\n"));
+      console.log(chalk2.gray(`   Version: ${currentVersion} \u2192 ${cache.completedUpdate}`));
+      console.log(chalk2.gray(`   Updated: Just now
+`));
+      console.log(chalk2.gray("Run 'aikit --version' to verify.\n"));
+      await clearCompletedUpdate();
+    }
+  }
+  if (cache.errorCount >= 3 && cache.lastError) {
+    console.log(chalk2.yellow.bold("\n\u26A0\uFE0F  AIKit update failed\n"));
+    console.log(chalk2.gray(`   Last error: ${cache.lastError}`));
+    console.log(chalk2.gray("   Check logs: ~/.config/aikit/logs/update-error.log\n"));
+  }
+}
+async function performBackgroundUpdate(latestVersion) {
+  const success = await spawnUpdateProcess(latestVersion);
+  if (!success) {
+    await incrementError("Failed to spawn update process");
+  } else {
+    await setCompletedUpdate(latestVersion);
+  }
+}
+async function checkForUpdates() {
+  try {
+    await displayNotification();
+    if (!await shouldCheckForUpdates()) {
+      return;
+    }
+    const currentVersion = getVersion();
+    const latestVersion = await getLatestVersion(PACKAGE_NAME);
+    await setLastCheckTime(Date.now());
+    await setLastCheckedVersion(currentVersion);
+    if (!latestVersion || !isGreaterThan(latestVersion, currentVersion)) {
+      return;
+    }
+    await performBackgroundUpdate(latestVersion);
+  } catch {
+  }
+}
+async function checkForUpdatesAsync() {
+  checkForUpdates().catch(() => {
+  });
+}
+
 // src/index.ts
 init_logger();
 init_paths();
@@ -6178,6 +6494,7 @@ export {
   SkillEngine,
   ToolRegistry,
   getVersion as VERSION,
+  checkForUpdatesAsync,
   defineTool,
   loadConfig,
   logger,