@anraktech/sync 0.5.0 → 0.7.0

package/dist/cli.js

@@ -4,9 +4,9 @@
 import { Command } from "commander";
 import { createInterface as createInterface2 } from "readline/promises";
 import { stdin as stdin2, stdout as stdout2 } from "process";
-import { existsSync as existsSync3, statSync as statSync2 } from "fs";
+import { existsSync as existsSync4, statSync as statSync3 } from "fs";
 import { resolve as resolve3 } from "path";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -416,7 +416,7 @@ function resetCache() {
 
 // src/watcher.ts
 import { watch } from "chokidar";
-import { readdirSync, statSync, existsSync as existsSync2 } from "fs";
+import { readdirSync as readdirSync2, statSync as statSync2, existsSync as existsSync3 } from "fs";
 import { join as join3, relative as relative2, basename as basename4, resolve as resolve2 } from "path";
 
 // src/uploader.ts
@@ -621,6 +621,7 @@ import { createInterface } from "readline/promises";
 import { stdin, stdout } from "process";
 import { homedir as homedir2, platform } from "os";
 import { resolve, join as join2 } from "path";
+import { existsSync as existsSync2, readdirSync, statSync } from "fs";
 import chalk2 from "chalk";
 var HOME = homedir2();
 var IS_MAC = platform() === "darwin";
@@ -652,17 +653,39 @@ function normalizePath(folderPath) {
   return resolve(HOME, trimmed);
 }
 var TOOLS = [
+  {
+    type: "function",
+    function: {
+      name: "browse_folder",
+      description: "List files and subfolders in a local directory. Shows file names, sizes, types, and whether they are syncable. Use FIRST when user wants to see what's in a folder before syncing.",
+      parameters: {
+        type: "object",
+        properties: {
+          folderPath: {
+            type: "string",
+            description: "Absolute path to the folder to browse"
+          },
+          filter: {
+            type: "string",
+            enum: ["all", "syncable", "folders"],
+            description: "Filter: 'all' shows everything, 'syncable' shows only supported file types (PDF, DOCX, etc.), 'folders' shows only subfolders. Default: all"
+          }
+        },
+        required: ["folderPath"]
+      }
+    }
+  },
   {
     type: "function",
     function: {
       name: "scan_folder",
-      description: "Scan a local folder on the user's computer and sync all supported files (PDF, DOCX, etc.) to a matching legal case. Use when user asks to scan, sync, upload, or look at a specific folder.",
+      description: "Sync all supported files from a local folder to a matching legal case. Use when user explicitly asks to sync, upload, or push files. If unsure what's in the folder, use browse_folder first.",
       parameters: {
         type: "object",
         properties: {
           folderPath: {
             type: "string",
-            description: "Absolute path to the folder, e.g. /Users/name/Downloads"
+            description: "Absolute path to the folder to sync"
           }
         },
         required: ["folderPath"]
@@ -718,7 +741,7 @@ Server: ${config.apiUrl}
 Home directory: ${HOME}
 Platform: ${IS_MAC ? "macOS" : platform()}
 
-You can scan folders, list cases, show sync status, and more using your tools.
+You can browse local folders, scan & sync files, list cases, show sync status, and more.
 
 Rules:
 - Be concise. This is a terminal \u2014 1-3 lines unless showing a list.
@@ -728,12 +751,64 @@ Rules:
   "desktop" \u2192 ${join2(HOME, "Desktop")}
   "documents" \u2192 ${join2(HOME, "Documents")}
   "~/SomeFolder" \u2192 ${HOME}/SomeFolder
+- When user says "look at" or "check" a folder, use browse_folder FIRST to show what's there.
+- When user says "sync" or "upload", use scan_folder to actually sync.
+- When browsing, highlight which files are syncable (PDF, DOCX, XLSX, etc.) vs not.
+- Present file lists in a clean table/list format with names and sizes.
 - Call tools to perform actions. Summarize results naturally after.
 - If a tool returns an error, report it clearly to the user.
 - Do NOT use thinking tags or reasoning tags in your output.`;
 }
 async function executeTool(name, args, ctx) {
   switch (name) {
+    case "browse_folder": {
+      const rawPath = args.folderPath;
+      if (!rawPath) return JSON.stringify({ error: "Missing folderPath" });
+      const folderPath = normalizePath(rawPath);
+      if (!existsSync2(folderPath)) {
+        return JSON.stringify({ error: `Folder not found: ${folderPath}` });
+      }
+      try {
+        const s = statSync(folderPath);
+        if (!s.isDirectory()) {
+          return JSON.stringify({ error: `Not a directory: ${folderPath}` });
+        }
+      } catch {
+        return JSON.stringify({ error: `Cannot access: ${folderPath}` });
+      }
+      const filter = args.filter || "all";
+      const entries = readdirSync(folderPath);
+      const items = [];
+      for (const entry of entries) {
+        if (isIgnoredFile(entry)) continue;
+        const fullPath = join2(folderPath, entry);
+        let st;
+        try {
+          st = statSync(fullPath);
+        } catch {
+          continue;
+        }
+        if (st.isDirectory()) {
+          if (filter !== "syncable") {
+            items.push({ name: entry, type: "folder" });
+          }
+        } else if (st.isFile()) {
+          if (filter === "folders") continue;
+          const syncable = isSupportedFile(entry);
+          if (filter === "syncable" && !syncable) continue;
+          const sizeKB = Math.round(st.size / 1024);
+          const size = sizeKB > 1024 ? `${(sizeKB / 1024).toFixed(1)} MB` : `${sizeKB} KB`;
+          items.push({ name: entry, type: "file", size, syncable });
+        }
+      }
+      return JSON.stringify({
+        folder: folderPath,
+        totalItems: items.length,
+        items: items.slice(0, 50),
+        // Cap at 50 to avoid token explosion
+        truncated: items.length > 50
+      });
+    }
     case "scan_folder": {
       const rawPath = args.folderPath;
       if (!rawPath) return JSON.stringify({ error: "Missing folderPath" });
@@ -950,7 +1025,7 @@ async function scanFolder(config) {
   function walk(dir) {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
@@ -959,7 +1034,7 @@ async function scanFolder(config) {
       const fullPath = join3(dir, entry);
       let s;
       try {
-        s = statSync(fullPath);
+        s = statSync2(fullPath);
       } catch {
         continue;
       }
@@ -992,11 +1067,11 @@ async function pushSync(config) {
 }
 async function scanExternalFolder(config, folderPath, cases) {
   const absPath = resolve2(folderPath);
-  if (!existsSync2(absPath)) {
+  if (!existsSync3(absPath)) {
     log.error(`Folder not found: ${absPath}`);
     return;
   }
-  if (!statSync(absPath).isDirectory()) {
+  if (!statSync2(absPath).isDirectory()) {
     log.error(`Not a directory: ${absPath}`);
     return;
   }
@@ -1005,7 +1080,7 @@ async function scanExternalFolder(config, folderPath, cases) {
   function walk(dir) {
     let entries;
     try {
-      entries = readdirSync(dir);
+      entries = readdirSync2(dir);
     } catch {
       return;
     }
@@ -1014,7 +1089,7 @@ async function scanExternalFolder(config, folderPath, cases) {
       const fullPath = join3(dir, entry);
       let s;
       try {
-        s = statSync(fullPath);
+        s = statSync2(fullPath);
       } catch {
         continue;
       }
@@ -1136,6 +1211,84 @@ async function startWatching(config) {
   process.on("SIGTERM", shutdown);
 }
 
+// src/updater.ts
+import { execFileSync } from "child_process";
+import chalk3 from "chalk";
+var PACKAGE_NAME = "@anraktech/sync";
+var CHECK_INTERVAL_MS = 4 * 60 * 60 * 1e3;
+var updateCache = { lastCheck: 0, latestVersion: null };
+function compareVersions(current, latest) {
+  const a = current.split(".").map(Number);
+  const b = latest.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((b[i] ?? 0) > (a[i] ?? 0)) return 1;
+    if ((b[i] ?? 0) < (a[i] ?? 0)) return -1;
+  }
+  return 0;
+}
+async function fetchLatestVersion() {
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: AbortSignal.timeout(5e3)
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function performUpdate(currentVersion, latestVersion) {
+  console.log("");
+  console.log(
+    chalk3.dim(`  Update available: ${currentVersion} \u2192 `) + chalk3.green(latestVersion)
+  );
+  console.log(chalk3.dim("  Updating..."));
+  try {
+    execFileSync("npm", ["install", "-g", `${PACKAGE_NAME}@${latestVersion}`], {
+      stdio: "pipe",
+      timeout: 6e4
+    });
+    console.log(chalk3.green("  Updated successfully. Restart to use the new version."));
+    console.log("");
+    return true;
+  } catch {
+    try {
+      execFileSync("npm", ["install", "-g", `${PACKAGE_NAME}@${latestVersion}`, "--prefix", process.env.HOME + "/.npm-global"], {
+        stdio: "pipe",
+        timeout: 6e4
+      });
+      console.log(chalk3.green("  Updated successfully. Restart to use the new version."));
+      console.log("");
+      return true;
+    } catch {
+      console.log(
+        chalk3.dim("  Auto-update failed. Run manually: ") + chalk3.cyan(`npm install -g ${PACKAGE_NAME}`)
+      );
+      console.log("");
+      return false;
+    }
+  }
+}
+async function checkForUpdates(currentVersion) {
+  try {
+    const now = Date.now();
+    if (now - updateCache.lastCheck < CHECK_INTERVAL_MS && updateCache.latestVersion) {
+      if (compareVersions(currentVersion, updateCache.latestVersion) > 0) {
+        performUpdate(currentVersion, updateCache.latestVersion);
+      }
+      return;
+    }
+    const latestVersion = await fetchLatestVersion();
+    updateCache = { lastCheck: now, latestVersion };
+    if (!latestVersion) return;
+    if (compareVersions(currentVersion, latestVersion) > 0) {
+      performUpdate(currentVersion, latestVersion);
+    }
+  } catch {
+  }
+}
+
 // src/cli.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { fileURLToPath } from "url";
@@ -1143,14 +1296,15 @@ import { dirname as dirname2, join as join4 } from "path";
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname2(__filename2);
 var pkg = JSON.parse(readFileSync2(join4(__dirname2, "..", "package.json"), "utf-8"));
+await checkForUpdates(pkg.version);
 var program = new Command();
 program.name("anrak-sync").description("AnrakLegal desktop file sync \u2014 watches local folders, syncs to case management").version(pkg.version);
 program.command("init").description("Set up AnrakLegal Sync (first-time configuration)").option("--password", "Use email/password login instead of browser").action(async (opts) => {
   const rl = createInterface2({ input: stdin2, output: stdout2 });
   try {
-    console.log(chalk3.bold.blue("\n  AnrakLegal Sync \u2014 Setup\n"));
+    console.log(chalk4.bold.blue("\n  AnrakLegal Sync \u2014 Setup\n"));
     const apiUrl = await rl.question(
-      `  AnrakLegal URL ${chalk3.dim("(https://anrak.legal)")}: `
+      `  AnrakLegal URL ${chalk4.dim("(https://anrak.legal)")}: `
     ) || "https://anrak.legal";
     log.info("Connecting to server...");
     const serverConfig = await fetchServerConfig(apiUrl);
@@ -1181,15 +1335,15 @@ program.command("init").description("Set up AnrakLegal Sync (first-time configur
     const rl2 = createInterface2({ input: stdin2, output: stdout2 });
     const defaultFolder = process.platform === "win32" ? "C:\\Cases" : `${process.env.HOME}/Cases`;
     const watchInput = await rl2.question(
-      `  Watch folder ${chalk3.dim(`(${defaultFolder})`)}: `
+      `  Watch folder ${chalk4.dim(`(${defaultFolder})`)}: `
     );
     const watchFolder = resolve3(watchInput || defaultFolder);
     rl2.close();
-    if (!existsSync3(watchFolder)) {
+    if (!existsSync4(watchFolder)) {
       log.warn(
         `Folder ${watchFolder} does not exist \u2014 it will be created when you add files`
       );
-    } else if (!statSync2(watchFolder).isDirectory()) {
+    } else if (!statSync3(watchFolder).isDirectory()) {
       log.error(`${watchFolder} is not a directory`);
       process.exit(1);
     }
@@ -1207,7 +1361,7 @@ program.command("init").description("Set up AnrakLegal Sync (first-time configur
     log.info(`Config saved to ${getConfigDir()}`);
     log.info(`Watching: ${watchFolder}`);
     console.log(
-      chalk3.dim("\n  Run `anrak-sync start` to begin syncing\n")
+      chalk4.dim("\n  Run `anrak-sync start` to begin syncing\n")
     );
   } catch (err) {
     log.error(err instanceof Error ? err.message : String(err));
@@ -1242,7 +1396,7 @@ program.command("login").description("Re-authenticate with AnrakLegal").option("
 });
 program.command("start").description("Start watching for file changes and syncing").action(async () => {
   const config = requireConfig();
-  console.log(chalk3.bold.blue("\n  AnrakLegal Sync\n"));
+  console.log(chalk4.bold.blue("\n  AnrakLegal Sync\n"));
   log.info(`Watching: ${config.watchFolder}`);
   log.info(`Server:   ${config.apiUrl}`);
   console.log("");
@@ -1255,7 +1409,7 @@ program.command("start").description("Start watching for file changes and syncin
 });
 program.command("push").description("One-time sync \u2014 upload all new/changed files, then exit").action(async () => {
   const config = requireConfig();
-  console.log(chalk3.bold.blue("\n  AnrakLegal Sync \u2014 Push\n"));
+  console.log(chalk4.bold.blue("\n  AnrakLegal Sync \u2014 Push\n"));
   log.info(`Folder: ${config.watchFolder}`);
   log.info(`Server: ${config.apiUrl}`);
   console.log("");
@@ -1269,24 +1423,24 @@ program.command("push").description("One-time sync \u2014 upload all new/changed
 program.command("status").description("Show sync status").action(async () => {
   const config = requireConfig();
   const stats = getStats();
-  console.log(chalk3.bold.blue("\n  AnrakLegal Sync \u2014 Status\n"));
+  console.log(chalk4.bold.blue("\n  AnrakLegal Sync \u2014 Status\n"));
   console.log(`  Server:         ${config.apiUrl}`);
   console.log(`  Watch folder:   ${config.watchFolder}`);
   console.log(`  Config:         ${getConfigDir()}`);
   console.log("");
   console.log(`  Files tracked:  ${stats.totalFiles}`);
-  console.log(`  Synced:         ${chalk3.green(stats.synced)}`);
-  console.log(`  Pending:        ${chalk3.yellow(stats.pending)}`);
-  console.log(`  Errors:         ${chalk3.red(stats.errors)}`);
+  console.log(`  Synced:         ${chalk4.green(stats.synced)}`);
+  console.log(`  Pending:        ${chalk4.yellow(stats.pending)}`);
+  console.log(`  Errors:         ${chalk4.red(stats.errors)}`);
   console.log(`  Mapped folders: ${stats.mappedFolders}`);
   try {
     const cases = await listCases(config);
     console.log(`
   Server cases:   ${cases.length}`);
-    console.log(`  Auth:           ${chalk3.green("valid")}`);
+    console.log(`  Auth:           ${chalk4.green("valid")}`);
   } catch {
     console.log(`
-  Auth:           ${chalk3.red("expired \u2014 run anrak-sync login")}`);
+  Auth:           ${chalk4.red("expired \u2014 run anrak-sync login")}`);
   }
   console.log("");
 });
@@ -1294,13 +1448,13 @@ program.command("map").description("Show folder-to-case mappings").action(async
   const config = requireConfig();
   const mappings = getAllMappings();
   const entries = Object.entries(mappings);
-  console.log(chalk3.bold.blue("\n  AnrakLegal Sync \u2014 Mappings\n"));
+  console.log(chalk4.bold.blue("\n  AnrakLegal Sync \u2014 Mappings\n"));
   if (entries.length === 0) {
     log.info("No mappings yet. Run `anrak-sync push` or `anrak-sync start` to create them.");
   } else {
     for (const [folder, mapping] of entries) {
       console.log(
-        `  ${chalk3.cyan(folder)} -> ${mapping.caseNumber} (${chalk3.dim(mapping.caseName)})`
+        `  ${chalk4.cyan(folder)} -> ${mapping.caseNumber} (${chalk4.dim(mapping.caseName)})`
       );
     }
   }
@@ -1309,9 +1463,9 @@ program.command("map").description("Show folder-to-case mappings").action(async
     const mappedIds = new Set(entries.map(([, m]) => m.caseId));
     const unmapped = cases.filter((c) => !mappedIds.has(c.id));
     if (unmapped.length > 0) {
-      console.log(chalk3.dim("\n  Unmapped server cases:"));
+      console.log(chalk4.dim("\n  Unmapped server cases:"));
       for (const c of unmapped) {
-        console.log(`    ${chalk3.dim(c.caseNumber)} ${chalk3.dim(c.caseName)}`);
+        console.log(`    ${chalk4.dim(c.caseNumber)} ${chalk4.dim(c.caseName)}`);
       }
     }
   } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anraktech/sync",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "AnrakLegal desktop file sync agent — watches local folders and syncs to case management",
   "type": "module",
   "bin": {