@dev_desh/flux-cap 0.3.0 → 0.5.0

package/README.md

@@ -29,11 +29,16 @@ flux init
 ```
 *Interactive setup will ask about your privacy preferences*
 
-### 2. Start capturing thoughts
+### 2. Start capturing thoughts with tags
 ```bash
+# Basic brain dumps
 flux dump "remember to add error handling to auth module"
 flux dump "bug in user validation - check line 42" 
-flux dump "idea: add dark mode toggle"
+
+# Tagged brain dumps for better organization
+flux dump -i "add dark mode toggle"              # Ideas
+flux dump -n "team meeting at 3pm tomorrow"      # Notes  
+flux dump -t "refactor payment processing logic" # Tasks
 ```
 
 ### 3. Search your brain dumps
@@ -41,22 +46,27 @@ flux dump "idea: add dark mode toggle"
 # Search with a query
 flux search "auth"
 
+# Search by tags (when implemented in search)
+flux search "ideas"
+flux search "tasks"
+
 # List recent dumps (no query)
 flux search
 ```
 
-
 ## Features
 
-### Brain Dump System
+### Brain Dump System with Smart Tags
 - Instantly capture thoughts without breaking flow: `flux dump "fix auth validation bug"`
+- **Tag system** for better organization: `-i` for ideas, `-n` for notes, `-t` for tasks
 - Git-aware context tracking (branch, working directory, uncommitted changes)
 - Monthly file organization for easy browsing
 - Privacy-first design - you control what gets tracked
 
-### Search
+### Intelligent Search
 - Fuzzy search across all your brain dumps: `flux search "auth"`
-- Configurable search fields (message, branch, working directory)
+- **Tag-aware searching** for filtering by type
+- Configurable search fields (message, branch, working directory, tags)
 - Result ranking with relevance scores
 - Multi-month search with automatic limits
 
@@ -78,89 +88,98 @@ flux search
 - No need to initialize in every subfolder - works project-wide
 - Seamlessly handles monorepos and complex project structures
 
-
 ## Commands
 
 | Command | Description | Example |
 |---------|-------------|---------|
 | `flux init` | Initialize flux-cap with privacy setup | `flux init` |
 | `flux dump <message...>` | Capture a brain dump | `flux dump "fix the bug in auth.ts"` |
+| `flux dump -i <message...>` | Capture an idea | `flux dump -i "add keyboard shortcuts"` |
+| `flux dump -n <message...>` | Capture a note | `flux dump -n "meeting notes from standup"` |
+| `flux dump -t <message...>` | Capture a task | `flux dump -t "refactor user authentication"` |
+| `flux dump -m` | Multiline input mode | `flux dump -m` |
 | `flux search [query...]` | Search brain dumps or list recent ones | `flux search "authentication"` |
-| `flux config <fields...>` | View or update configuration | `flux config` |
+| `flux config [field] [value]` | View or update configuration | `flux config search.resultLimit 20` |
+| `flux config --add-tag <tag>` | Add custom tags to configuration | `flux config --add-tag "bug"` |
+| `flux config --remove-tag <tag>` | Remove tags from configuration | `flux config --remove-tag "old-tag"` |
 | `flux reset` | Complete reset (deletes all data) | `flux reset` |
 
-## Use Cases
+## Tag System
 
-### Context Switching
-```bash
-# Before switching tasks
-flux dump "was working on user auth, next: add validation to login form"
+### Built-in Tags
+flux-cap comes with three built-in tag shortcuts:
+- **`-i, --ideas`** - For capturing ideas and inspiration
+- **`-n, --notes`** - For general notes and reminders  
+- **`-t, --tasks`** - For tasks and todos
 
-# After interruption  
-flux search "auth"  # Quickly find where you left off
-```
-
-### Bug Tracking
+### Custom Tags (via config)
+Extend your tagging system by adding custom tags for brain dumps:
 ```bash
-flux dump "weird bug in payment flow - users can't checkout"
-flux dump "bug seems related to session timeout"
-
-# Later...
-flux search "payment bug"
+# Built-in shortcuts (current)
+flux dump -i "idea message"
+flux dump -n "note message" 
+flux dump -t "task message"
+
+# Generic tag option (new)
+flux dump --tag thought "my message"
+flux dump --tag bug "found an issue"
+flux dump --tag meeting "standup notes"
 ```
 
-### Idea Capture
+### Tag Examples
 ```bash
-flux dump "idea: add keyboard shortcuts to dashboard" 
-flux dump "maybe use React.memo for performance optimization"
-```
+# Ideas for future features
+flux dump -i "add real-time collaboration to the editor"
+flux dump -i "implement auto-save every 30 seconds"
 
-## Automated Versioning
+# Meeting notes and reminders
+flux dump -n "team decided to use TypeScript for new components"
+flux dump -n "remember to update documentation before release"
 
-flux-cap uses [Changesets](https://github.com/changesets/changesets) for automated semantic versioning:
+# Task tracking
+flux dump -t "fix memory leak in image processor"
+flux dump -t "write unit tests for authentication module"
 
-### What happens when you merge a PR:
-1. **Automatic Analysis**: GitHub Actions analyzes your PR changes
-2. **Smart Version Bumping**: Determines appropriate version (major/minor/patch) based on:
-   - PR title and description
-   - Commit messages  
-   - Files changed
-3. **Changelog Generation**: Creates detailed changelog entries
-4. **Version Updates**: Updates `package.json` automatically
-5. **Git Integration**: Commits changes back to main branch
+# Combine with multiline for detailed entries
+flux dump -t -m  # Opens editor for detailed task description
+```
 
-### Version Bump Rules:
-- **Major** (`1.0.0 → 2.0.0`): Breaking changes, removed features, incompatible API changes
-- **Minor** (`1.0.0 → 1.1.0`): New features, new commands, backwards-compatible enhancements
-- **Patch** (`1.0.0 → 1.0.1`): Bug fixes, documentation updates, refactoring, performance improvements
+## Use Cases
 
-### Manual Changesets:
+### Context Switching
 ```bash
-# Add a changeset manually (if needed)
-bun run changeset
+# Before switching tasks
+flux dump -t "was working on user auth, next: add validation to login form"
 
-# Check pending changesets
-bun run changeset:status
+# After interruption  
+flux search "auth"  # Quickly find where you left off
+flux search "tasks" # Find your pending tasks
+```
 
-# Apply version changes locally
-bun run changeset:version
+### Bug Tracking & Ideas
+```bash
+# Track bugs and investigations
+flux dump -n "weird bug in payment flow - users can't checkout"
+flux dump -n "bug seems related to session timeout - check Redis config"
 
-## Development
+# Capture ideas as they come
+flux dump -i "add keyboard shortcuts to dashboard"
+flux dump -i "maybe use React.memo for performance optimization"
 
-Want to contribute or run locally?
+# Later...
+flux search "payment bug"
+flux search "ideas"
+```
 
+### Meeting Notes & Task Management  
 ```bash
-# Clone and setup
-git clone https://github.com/yourusername/flux-cap
-cd flux-cap
-bun install
-
-# Run in development mode
-bun run dev <command>
+# Capture meeting outcomes
+flux dump -n "team standup: focus on performance this sprint"
+flux dump -t "implement caching layer for API responses"
 
-# Build and test locally  
-bun run build
-npm link
+# Track follow-up tasks
+flux dump -t "review Sarah's PR for authentication changes"
+flux dump -t "update deployment documentation"
 ```
 
 ## Configuration
@@ -182,7 +201,7 @@ flux-cap stores configuration in `.flux/config.json`. You can customize:
 ```json
 {
   "search": {
-    "searchFields": ["message", "branch", "workingDir"],
+    "searchFields": ["message", "branch", "workingDir", "tags"],
     "resultLimit": 10,
     "fuseOptions": {
       "threshold": 0.3,            // 0.0 = exact match, 1.0 = match anything
@@ -192,6 +211,13 @@ flux-cap stores configuration in `.flux/config.json`. You can customize:
 }
 ```
 
+### Tag Configuration
+```json
+{
+  "tags": ["bug", "meeting", "review", "urgent"]  // Your custom tags
+}
+```
+
 ### Other Options
 ```json
 {
@@ -219,40 +245,62 @@ flux-cap stores configuration in `.flux/config.json`. You can customize:
   "id": "019c5419-671b-7000-9600-5d9b4c563579",
   "timestamp": "2026-02-12T23:04:36.891Z", 
   "message": "fix auth validation bug",
+  "tags": ["tasks"],
   "workingDir": "/Users/you/project",
-  "branch": "feature/auth-fix",
+  "branch": "feature/auth-fix", 
   "hasUncommittedChanges": true
 }
 ```
 
-## Use Cases
+## Automated Versioning
 
-### Context Switching
-```bash
-# Before switching tasks
-flux dump "was working on user auth, next: add validation to login form"
+flux-cap uses [Changesets](https://github.com/changesets/changesets) for automated semantic versioning:
 
-# After interruption  
-flux search "auth"  # Quickly find where you left off
-```
+### What happens when you merge a PR:
+1. **Automatic Analysis**: GitHub Actions analyzes your PR changes
+2. **Smart Version Bumping**: Determines appropriate version (major/minor/patch) based on:
+   - PR title and description
+   - Commit messages  
+   - Files changed
+3. **Changelog Generation**: Creates detailed changelog entries
+4. **Version Updates**: Updates `package.json` automatically
+5. **Git Integration**: Commits changes back to main branch
+
+### Version Bump Rules:
+- **Major** (`1.0.0 → 2.0.0`): Breaking changes, removed features, incompatible API changes
+- **Minor** (`1.0.0 → 1.1.0`): New features, new commands, backwards-compatible enhancements
+- **Patch** (`1.0.0 → 1.0.1`): Bug fixes, documentation updates, refactoring, performance improvements
 
-### Bug Tracking
+### Manual Changesets:
 ```bash
-flux dump "weird bug in payment flow - users can't checkout"
-flux dump "bug seems related to session timeout"
+# Add a changeset manually (if needed)
+bun run changeset
 
-# Later...
-flux search "payment bug"
-```
+# Check pending changesets
+bun run changeset:status
 
-### Idea Capture
-```bash
-flux dump "idea: add keyboard shortcuts to dashboard"
-flux dump "maybe use React.memo for performance optimization"
+# Apply version changes locally
+bun run changeset:version
 ```
 
 ## Development
 
+Want to contribute or run locally?
+
+```bash
+# Clone and setup
+git clone https://github.com/yourusername/flux-cap
+cd flux-cap
+bun install
+
+# Run in development mode
+bun run dev <command>
+
+# Build and test locally  
+bun run build
+npm link
+```
+
 Built with:
 - **Bun** - Fast JavaScript runtime
 - **TypeScript** - Type safety
@@ -276,6 +324,7 @@ src/
 ## Roadmap
 
 ### Phase 2 (Coming Soon)
+- [ ] Enhanced tag-based search filtering
 - [ ] ASCII Pomodoro timer with themes
 - [ ] Visual focus mode display
 - [ ] Theme rotation system
@@ -284,11 +333,13 @@ src/
 - [ ] Advanced git context switching
 - [ ] Session restoration
 - [ ] Time tracking per context
+- [ ] Tag analytics and insights
 
 ### Phase 4 (Maybe)
 - [ ] AI-powered brain dump analysis
 - [ ] Team collaboration features
 - [ ] Cross-machine sync
+- [ ] Smart tag suggestions
 
 ## Contributing
 

package/dist/index.js

@@ -20626,6 +20626,58 @@ var {
 
 // src/commands/init.command.ts
 import fs2 from "fs";
+// package.json
+var package_default = {
+  name: "@dev_desh/flux-cap",
+  type: "module",
+  version: "0.5.0",
+  description: "Git-aware CLI context manager for ADHD developers",
+  bin: {
+    flux: "./dist/index.js"
+  },
+  files: [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    build: "bun build src/index.ts --outdir dist --target node --format esm",
+    dev: "bun run src/index.ts",
+    prepublishOnly: "bun run build",
+    publish: "npm publish --access=public",
+    "local-install": "bun run build && npm link",
+    "local-uninstall": "npm unlink -g flux-cap",
+    "local-reinstall": "bun run local-uninstall && bun run local-install",
+    changeset: "changeset",
+    "changeset:add": "changeset add",
+    "changeset:status": "changeset status",
+    "changeset:version": "changeset version",
+    "changeset:publish": "changeset publish"
+  },
+  engines: {
+    node: ">=18.0.0"
+  },
+  keywords: [
+    "cli",
+    "productivity",
+    "adhd",
+    "git",
+    "context-switching",
+    "brain-dump",
+    "developer-tools"
+  ],
+  dependencies: {
+    inquirer: "^13.2.5"
+  },
+  devDependencies: {
+    "@changesets/cli": "^2.29.8",
+    "@types/inquirer": "^9.0.9"
+  },
+  repository: {
+    type: "git",
+    url: "https://github.com/kaustubh285/flux-cap"
+  }
+};
 
 // src/utils/constants.ts
 var FLUX_FOLDER_PATH = ".flux/";
@@ -20633,7 +20685,7 @@ var FLUX_BRAIN_DUMP_PATH = `${FLUX_FOLDER_PATH}dumps/`;
 var FLUX_SESSION_PATH = `${FLUX_FOLDER_PATH}sessions/`;
 var FLUX_CONFIG_PATH = `${FLUX_FOLDER_PATH}config.json`;
 var FLUX_DEFAULT_CONFIG = {
-  fluxVersion: "0.0.1",
+  fluxVersion: package_default.version,
   defaultFocusDuration: 1500,
   todoKeywords: ["TODO", "FIXME", "BUG", "OPTIMIZE", "HACK"],
   notifications: true,
@@ -20651,7 +20703,8 @@ var FLUX_DEFAULT_CONFIG = {
       threshold: 0.3,
       includeScore: true
     }
-  }
+  },
+  tags: ["notes", "ideas", "tasks"]
 };
 // src/utils/privacy.ts
 import { execSync } from "child_process";
@@ -20680,6 +20733,23 @@ function getCurrentBranch(config) {
     return "";
   }
 }
+function getTags(options, config) {
+  let tags = [];
+  if (options.tag) {
+    tags.push(options.tag);
+  }
+  let optionTags = Object.keys(options).filter((key) => options[key] === true);
+  if (!config.tags) {
+    console.log("You do not have any tags configured. You can add tags to your config to use this feature. or run `flux config --add-tags notes ideas tasks` to add default tags. or update the config file");
+  } else {
+    for (const tag of optionTags) {
+      if (config.tags && config.tags.includes(tag)) {
+        tags.push(tag);
+      }
+    }
+  }
+  return tags;
+}
 // src/utils/lib.ts
 import fs from "fs";
 import path from "path";
@@ -23872,7 +23942,7 @@ async function handleBrainDump(message, options) {
       }
       finalMessage = message.join(" ");
     }
-    await brainDumpAddCommand(finalMessage, { multiline: options.multiline });
+    await brainDumpAddCommand(finalMessage, options);
   } catch (error) {
     console.error("Error creating brain dump:", error instanceof Error ? error.message : "Unknown error");
     process.exit(1);
@@ -23888,13 +23958,15 @@ async function brainDumpAddCommand(message, options = {}) {
   const workingDir = await getWorkingDir(config);
   const branch = getCurrentBranch(config);
   const hasUncommittedChanges = getGitUncommittedChanges(config);
+  const tags = getTags(options, config);
   const newDump = {
     id: randomUUID2(),
     timestamp: new Date().toISOString(),
     message,
     workingDir,
     branch,
-    hasUncommittedChanges
+    hasUncommittedChanges,
+    tags
   };
   const data = JSON.parse(fs3.readFileSync(`${fluxPath}${FLUX_BRAIN_DUMP_PATH}/${monthString}.json`, "utf8"));
   config.sorted ? data.dumps.unshift(newDump) : data.dumps.push(newDump);
@@ -25252,82 +25324,88 @@ async function searchBrainDumpCommand(query) {
 }
 
 // src/commands/config.command.ts
-async function configCommand(fields) {
-  console.log("This command is still to be implemented");
+async function configCommand(data) {
+  console.log(`Updating key: ${data[0]} to ${data[1]}`);
+  const fluxPath = await getFluxPath();
   const fs4 = await import("fs");
-  const config = await getConfigFile();
-  const value = fields[fields.length - 1];
-  const keys = fields.slice(0, -1)[0]?.split(".").map((k) => k.trim()) || [];
-  console.log(`want to update config field: ${JSON.stringify(keys)} with value: ${value}`);
-  if (keys.length === 0 || value === undefined) {
-    console.log("Current Flux Capacitor configuration:");
-    console.log(JSON.stringify(config, null, 4));
+  const config = await getConfigFile(fluxPath);
+  if (data.length < 2) {
+    console.log("Please provide a key and value to update the config. Example: flux config --add-tags notes ideas tasks");
     return;
   }
-}
-// package.json
-var package_default = {
-  name: "@dev_desh/flux-cap",
-  type: "module",
-  version: "0.3.0",
-  description: "Git-aware CLI context manager for ADHD developers",
-  bin: {
-    flux: "./dist/index.js"
-  },
-  files: [
-    "dist/**/*",
-    "README.md",
-    "LICENSE"
-  ],
-  scripts: {
-    build: "bun build src/index.ts --outdir dist --target node --format esm",
-    dev: "bun run src/index.ts",
-    prepublishOnly: "bun run build",
-    publish: "npm publish --access=public",
-    "local-install": "bun run build && npm link",
-    "local-uninstall": "npm unlink -g flux-cap",
-    "local-reinstall": "bun run local-uninstall && bun run local-install",
-    changeset: "changeset",
-    "changeset:add": "changeset add",
-    "changeset:status": "changeset status",
-    "changeset:version": "changeset version",
-    "changeset:publish": "changeset publish"
-  },
-  engines: {
-    node: ">=18.0.0"
-  },
-  keywords: [
-    "cli",
-    "productivity",
-    "adhd",
-    "git",
-    "context-switching",
-    "brain-dump",
-    "developer-tools"
-  ],
-  dependencies: {
-    inquirer: "^13.2.5"
-  },
-  devDependencies: {
-    "@changesets/cli": "^2.29.8",
-    "@types/inquirer": "^9.0.9"
-  },
-  repository: {
-    type: "git",
-    url: "https://github.com/kaustubh285/flux-cap"
+  const key = data[0];
+  const value = data.slice(1).join(" ");
+  const editableKeys = [
+    "hideWorkingDir",
+    "hideBranchName",
+    "hideUncommittedChanges",
+    "resultLimit",
+    "threshold",
+    "includeScore",
+    "defaultFocusDuration"
+  ];
+  if (!editableKeys.includes(key)) {
+    console.log(`Invalid config key.
+Editable keys are: ${editableKeys.join(", ")}`);
+    return;
   }
-};
+  if (key === "hideWorkingDir") {
+    config.privacy.hideWorkingDir = value === "true";
+  }
+  if (key === "hideBranchName") {
+    config.privacy.hideBranchName = value === "true";
+  }
+  if (key === "hideUncommittedChanges") {
+    config.privacy.hideUncommittedChanges = value === "true";
+  }
+  if (key === "resultLimit") {
+    const limit = parseInt(value, 10);
+    if (!isNaN(limit)) {
+      config.search.resultLimit = limit;
+    } else {
+      console.log("Invalid value for resultLimit. Please provide a number.");
+      return;
+    }
+  }
+  if (key === "threshold") {
+    const threshold = parseFloat(value);
+    if (!isNaN(threshold)) {
+      if (config.search && config.search.fuseOptions) {
+        config.search.fuseOptions.threshold = threshold;
+      }
+    } else {
+      console.log("Invalid value for threshold. Please provide a number.");
+      return;
+    }
+  }
+  if (key === "includeScore") {
+    if (config.search && config.search.fuseOptions) {
+      config.search.fuseOptions.includeScore = value === "true";
+    }
+  }
+  if (key === "defaultFocusDuration") {
+    const duration = parseInt(value, 10);
+    if (!isNaN(duration)) {
+      config.defaultFocusDuration = duration;
+    } else {
+      console.log("Invalid value for defaultFocusDuration. Please provide a number.");
+      return;
+    }
+  }
+  fs4.writeFileSync(fluxPath + FLUX_CONFIG_PATH, JSON.stringify(config, null, 4));
+  console.log("Config updated successfully.");
+}
 
 // src/index.ts
 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...]").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) => {
+program2.command("dump [message...]").option("-m, --multiline", "Enable multiline input mode").option("-n, --notes", "Jot down a note").option("-i, --ideas", "Jot down an idea").option("-t, --tasks", "Jot down a task").option("-b, --bugs", "Jot down a bug").option("--tag [custom]", "Jot down a custom tagged").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("config [data...]").description("Update configuration fields. Example: flux config search.limit 10").action(configCommand);
 program2.parse(process.argv);

package/package.json

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