@dev_desh/flux-cap 0.1.4 → 0.2.0

package/README.md

@@ -294,6 +294,31 @@ src/
 
 This is currently a personal learning project, but feedback and suggestions are welcome!
 
+How to control version bumps:
+
+### Method 1: Use GitHub Labels
+Add these labels to your repository and apply them to PRs:
+- `major` or `breaking` → Major version bump
+- `minor` or `feature` → Minor version bump  
+- `patch` or `bugfix` → Patch version bump
+
+### Method 2: Use PR Title Syntax
+Start your PR title with the version type in brackets:
+- `[major] Remove deprecated API endpoints`
+- `[minor] Add new search command` 
+- `[patch] Fix memory leak in dump command`
+
+### Method 3: Automatic Detection (Conservative)
+The system will now only auto-detect major bumps with very explicit indicators like:
+- "breaking change"
+- "breaking:"
+- "major:"
+- "!breaking"
+- "remove api"
+- "delete command"
+
+**Everything else defaults to patch unless you have clear feature indicators for minor.**
+
 ## License
 
 MIT

package/dist/index.js

@@ -20645,7 +20645,7 @@ var FLUX_DEFAULT_CONFIG = {
     hideUncommittedChanges: false
   },
   search: {
-    searchFields: ["message", "workingDir", "branch", "tags"],
+    searchFields: ["message", "workingDir", "branch", "tags", "id"],
     resultLimit: 10,
     fuseOptions: {
       threshold: 0.3,
@@ -20688,7 +20688,6 @@ async function getFluxPath() {
   let fullPath = cwd.split(path.sep);
   while (true) {
     let parentPath = fullPath.join(path.sep) + "/.flux";
-    console.log(`testing ${parentPath}`);
     if (fs.existsSync(parentPath)) {
       return parentPath.split(".flux")[0];
       break;
@@ -20763,9 +20762,79 @@ function getMonthString() {
   const month = String(currentDate.getMonth() + 1).padStart(2, "0");
   return `${year}-${month}`;
 }
-function searchResultFormat({ message, timestamp, score, index }) {
-  const formattedTimestamp = new Date(timestamp).toLocaleString();
-  return `${index !== undefined ? index + 1 : ""}. [${score || "0.00"}] [${formattedTimestamp}] ${message}`;
+function displaySearchResults(results, query) {
+  if (results.length === 0) {
+    if (query) {
+      console.log(`No brain dumps found matching "${query}"`);
+    } else {
+      console.log("No brain dumps found. Try 'flux dump' to create your first one!");
+    }
+    return;
+  }
+  const queryText = query ? ` for "${query}"` : "";
+  console.log(`
+Found ${results.length} brain dump${results.length === 1 ? "" : "s"}${queryText}:
+`);
+  const terminalWidth = process.stdout.columns || 80;
+  const maxIndexWidth = results.length.toString().length;
+  results.forEach((result, index) => {
+    const dump = result.item;
+    const score = result.score?.toFixed(2) || "0.00";
+    const shortId = dump.id.substring(0, 8);
+    const indexStr = `${(index + 1).toString().padStart(maxIndexWidth)}`;
+    const scoreStr = `[${score}]`;
+    const idStr = `${shortId}`;
+    const headerLine = `${indexStr} ${idStr} ${scoreStr}`;
+    console.log(headerLine);
+    const messageIndent = " ".repeat(maxIndexWidth + 1);
+    const lines = dump.message.split(`
+`).map((l) => l.trim()).filter((l) => l.length > 0);
+    const availableWidth = terminalWidth - messageIndent.length - 2;
+    if (lines.length === 0) {
+      console.log(`${messageIndent}(empty message)`);
+    } else {
+      lines.forEach((line, lineIndex) => {
+        if (lineIndex < 3) {
+          const truncatedLine = line.length > availableWidth ? line.substring(0, availableWidth - 3) + "..." : line;
+          console.log(`${messageIndent}${truncatedLine}`);
+        }
+      });
+      if (lines.length > 3) {
+        console.log(`${messageIndent}... (+${lines.length - 3} more line${lines.length - 3 === 1 ? "" : "s"})`);
+      }
+    }
+    const contextInfo = [];
+    const date = new Date(dump.timestamp);
+    const timeAgo = getTimeAgo(date);
+    contextInfo.push("----------------");
+    contextInfo.push(`${timeAgo}`);
+    contextInfo.push("----------------");
+    contextInfo.push(`
+`);
+    if (dump.branch && dump.branch !== "main") {
+      contextInfo.push(`${dump.branch}${dump.hasUncommittedChanges ? " (uncommitted)" : ""}`);
+    }
+    if (contextInfo.length > 0) {
+      console.log(`${messageIndent}${contextInfo.join(" • ")}`);
+    }
+    console.log("");
+  });
+  console.log(`!! Use the 8-character ID (like ${results[0]?.item.id.substring(0, 8)}) to reference specific dumps
+`);
+}
+function getTimeAgo(date) {
+  const now = new Date;
+  const diffMs = now.getTime() - date.getTime();
+  const diffMins = Math.floor(diffMs / (1000 * 60));
+  const diffHours = Math.floor(diffMins / 60);
+  const diffDays = Math.floor(diffHours / 24);
+  if (diffMins < 60)
+    return `${diffMins}m ago`;
+  if (diffHours < 24)
+    return `${diffHours}h ago`;
+  if (diffDays < 7)
+    return `${diffDays}d ago`;
+  return date.toLocaleDateString();
 }
 // node_modules/@inquirer/core/dist/lib/key.js
 var isUpKey = (key, keybindings = []) => key.name === "up" || keybindings.includes("vim") && key.name === "k" || keybindings.includes("emacs") && key.ctrl && key.name === "p";
@@ -23780,7 +23849,36 @@ var resetFluxCommand = async () => {
 
 // src/commands/dump.command.ts
 import { randomUUID as randomUUID2 } from "crypto";
-async function brainDumpAddCommand(message) {
+async function handleBrainDump(message, options) {
+  try {
+    let finalMessage;
+    if (options.multiline) {
+      console.log("Opening editor for multiline input...");
+      const initialText = message ? message.join(" ") : "";
+      const multilineInput = await dist_default5({
+        message: "Enter your brain dump (save & exit when done):",
+        default: initialText,
+        waitForUserInput: false
+      });
+      if (!multilineInput.trim()) {
+        console.log("Brain dump cancelled - no content provided");
+        return;
+      }
+      finalMessage = multilineInput.trim();
+    } else {
+      if (!message || message.length === 0) {
+        console.log('Please provide a message: flux dump "your message"');
+        return;
+      }
+      finalMessage = message.join(" ");
+    }
+    await brainDumpAddCommand(finalMessage, { multiline: options.multiline });
+  } catch (error) {
+    console.error("Error creating brain dump:", error instanceof Error ? error.message : "Unknown error");
+    process.exit(1);
+  }
+}
+async function brainDumpAddCommand(message, options = {}) {
   const fluxPath = await getFluxPath();
   const fs3 = await import("fs");
   console.log("Creating brain dump...");
@@ -23793,7 +23891,7 @@ async function brainDumpAddCommand(message) {
   const newDump = {
     id: randomUUID2(),
     timestamp: new Date().toISOString(),
-    message: message.join(" "),
+    message,
     workingDir,
     branch,
     hasUncommittedChanges
@@ -23801,7 +23899,11 @@ async function brainDumpAddCommand(message) {
   const data = JSON.parse(fs3.readFileSync(`${fluxPath}${FLUX_BRAIN_DUMP_PATH}/${monthString}.json`, "utf8"));
   config.sorted ? data.dumps.unshift(newDump) : data.dumps.push(newDump);
   fs3.writeFileSync(`${fluxPath}${FLUX_BRAIN_DUMP_PATH}/${monthString}.json`, JSON.stringify(data, null, 2));
-  console.log(`✅ Brain dump saved: "${message.join(" ")}"`);
+  const displayMessage = message.length > 50 ? message.substring(0, 47) + "..." : message;
+  const preview = message.includes(`
+`) ? `${message.split(`
+`)[0]}... (multiline)` : displayMessage;
+  console.log(`✅ Brain dump saved: "${preview}"`);
 }
 
 // node_modules/fuse.js/dist/fuse.mjs
@@ -25113,48 +25215,40 @@ async function searchBrainDumpCommand(query) {
   console.log("Searching all brain dumps...");
   const fluxPath = await getFluxPath();
   const config = await getConfigFile(fluxPath);
-  const monthString = getMonthString();
+  const searchQuery = query.join(" ").trim();
   let searchResults = [];
   const allFilePaths = await getAllBrainDumpFilePaths(fluxPath);
   for await (const filePath of allFilePaths) {
     const fileData = JSON.parse(fs3.readFileSync(filePath, "utf8"));
-    const fuse = createFuseInstance(fileData.dumps, config);
-    const results = fuse.search(query.join(" "));
-    searchResults.push(...results);
-    if (searchResults.length > 30) {
-      break;
+    if (searchQuery) {
+      const fuse = createFuseInstance(fileData.dumps, config);
+      const results = fuse.search(searchQuery);
+      searchResults.push(...results);
+    } else {
+      const recentDumps = fileData.dumps.filter((dump) => dump && dump.message && dump.message.trim() !== "").map((dump) => ({
+        item: dump,
+        score: 0,
+        timestamp: new Date(dump.timestamp).getTime()
+      }));
+      searchResults.push(...recentDumps);
     }
   }
-  if (query.length > 0) {
-    if (searchResults.length === 0) {
-      console.log("No brain dumps found matching the query.");
-      return;
-    }
-    const resultLimit = config?.search?.resultLimit || 10;
-    const limitedResults = searchResults.slice(0, resultLimit);
-    console.log(`Found ${searchResults.length} brain dumps matching the query${searchResults.length > resultLimit ? ` (showing first ${resultLimit})` : ""}:`);
-    limitedResults.forEach((result, index) => {
-      const dump = result.item;
-      console.log(searchResultFormat({ index, timestamp: dump.timestamp, message: dump.message, score: result.score?.toFixed(2) }));
-    });
+  if (searchQuery) {
+    searchResults.sort((a, b) => (a.score || 0) - (b.score || 0));
   } else {
-    const resultLimit = config?.search?.resultLimit || 3;
-    let totalCount = 0;
-    for await (const filePath of allFilePaths) {
-      if (totalCount >= resultLimit) {
-        break;
-      }
-      const fileData = JSON.parse(fs3.readFileSync(filePath, "utf8"));
-      for (let i = 0;i < fileData.dumps.length && totalCount < resultLimit; i++) {
-        const dump = fileData.dumps[i];
-        if (!dump || !dump.message || dump.message.trim() === "") {
-          continue;
-        }
-        totalCount += 1;
-        console.log(searchResultFormat({ index: totalCount, timestamp: dump.timestamp, message: dump.message, score: "0.00" }));
-      }
-    }
+    searchResults.sort((a, b) => {
+      const timeA = new Date(a.item.timestamp).getTime();
+      const timeB = new Date(b.item.timestamp).getTime();
+      return timeB - timeA;
+    });
+  }
+  const resultLimit = config?.search?.resultLimit || (searchQuery ? 10 : 5);
+  const limitedResults = searchResults.slice(0, resultLimit);
+  if (searchResults.length > limitedResults.length) {
+    console.log(`
+(Showing ${limitedResults.length} of ${searchResults.length} results)`);
   }
+  displaySearchResults(limitedResults, searchQuery || undefined);
 }
 
 // src/commands/config.command.ts
@@ -25175,7 +25269,7 @@ async function configCommand(fields) {
 var package_default = {
   name: "@dev_desh/flux-cap",
   type: "module",
-  version: "0.1.4",
+  version: "0.2.0",
   description: "Git-aware CLI context manager for ADHD developers",
   bin: {
     flux: "./dist/index.js"
@@ -25229,12 +25323,11 @@ var program2 = new Command;
 program2.name(`flux`).description("Git-aware CLI context manager for ADHD developers").version(package_default.version);
 program2.command("init").description("Initialize flux in the current repository").action(initFluxCommand);
 program2.command("reset").description("Resets flux in the current repository").action(resetFluxCommand);
-program2.command("dump <message...>").description("Add a brain dump with a message. You can also include tags by using #tag in the message.").action(brainDumpAddCommand);
+program2.command("dump [message...]").option("-m, --multiline", "Enable multiline input mode").description("Add a brain dump with a message. Use --multiline for multi-line input.").action(async (message, options) => {
+  await handleBrainDump(message, options);
+});
 program2.command("search [query...]").description("Search brain dumps with a query. If no query is provided, lists all brain dumps for the current month.").action((query) => {
   searchBrainDumpCommand(query ? query : [""]);
 });
 program2.command("config <fields...>").description("Update configuration fields. Example: flux config search.limit 10").action(configCommand);
-program2.command("test").action(async () => {
-  console.log(`Path is - ${await getFluxPath()}`);
-});
 program2.parse(process.argv);

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@dev_desh/flux-cap",
 	"type": "module",
-	"version": "0.1.4",
+	"version": "0.2.0",
 	"description": "Git-aware CLI context manager for ADHD developers",
 	"bin": {
 		"flux": "./dist/index.js"