@meshxdata/fops 0.0.5 → 0.0.6

package/src/plugins/bundled/fops-plugin-memory/skills/memory/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: memory
+description: Persistent memory across agent sessions
+---
+
+## Agent Memory
+
+You have persistent memory across sessions. Relevant memories are automatically recalled into your context when they match the user's query. You can also save new memories during conversations.
+
+## When to Save Memories
+
+Save a memory when you learn something that would be useful in **future sessions**:
+
+- **Resolved issues**: "postgres init fails if vault isn't started first — start vault before running migrations"
+- **User preferences**: "user prefers to rebuild images rather than pull from ECR"
+- **Stack quirks**: "trino takes 30-45 seconds to become healthy after container starts"
+- **Configuration discoveries**: "frontend needs NEXT_PUBLIC_API_URL set to http://localhost:9001 in .env"
+- **Debugging insights**: "backend OOM usually means too many Kafka consumers — reduce KAFKA_MAX_POLL_RECORDS"
+- **Workflow patterns**: "user runs fops down && fops up to reset state, not just restart"
+
+## How to Save
+
+```bash
+fops memory save "description of what you learned"
+fops memory save "postgres needs vault running first" --tag postgres --tag startup
+```
+
+Tags help with recall but are optional. The text itself is searched.
+
+## When NOT to Save
+
+- Transient state (container is currently down, an image was just pulled)
+- Information already in the stack context (service ports, container health)
+- Generic knowledge (Docker commands, AWS docs)
+- Anything the user explicitly asks you not to remember
+
+## Commands
+
+```bash
+fops memory save "text" [--tag tag1 --tag tag2]   # Save a memory
+fops memory list                                    # List all memories
+fops memory search "query"                          # Search by relevance
+fops memory forget <id>                             # Remove a memory
+fops memory clear                                   # Clear all memories
+fops mem ...                                        # Shorthand alias
+```
+
+## Recall
+
+Memories are automatically recalled via the knowledge system. When the user's message matches stored memories, they appear in your context under "Agent Memory". You don't need to explicitly search — relevant memories are injected per turn.
+
+## Housekeeping
+
+If you notice a recalled memory is outdated or incorrect, suggest removing it:
+
+```bash
+fops memory forget abc123
+```

package/src/plugins/loader.js

@@ -10,6 +10,45 @@ import { loadBuiltinAgents } from "../agent/agents.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
+/**
+ * Sync bundled plugins from src/plugins/bundled/ to ~/.fops/plugins/.
+ * Installs missing plugins and updates existing ones when the bundled version is newer.
+ */
+function syncBundledPlugins() {
+  const bundledDir = path.join(__dirname, "bundled");
+  if (!fs.existsSync(bundledDir)) return;
+
+  const globalDir = path.join(os.homedir(), ".fops", "plugins");
+  fs.mkdirSync(globalDir, { recursive: true });
+
+  const entries = fs.readdirSync(bundledDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const srcDir = path.join(bundledDir, entry.name);
+    const manifestPath = path.join(srcDir, "fops.plugin.json");
+    if (!fs.existsSync(manifestPath)) continue;
+
+    let manifest;
+    try { manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8")); } catch { continue; }
+
+    const destDir = path.join(globalDir, entry.name);
+    const destManifest = path.join(destDir, "fops.plugin.json");
+
+    // Skip if installed version is same or newer
+    if (fs.existsSync(destManifest)) {
+      try {
+        const existing = JSON.parse(fs.readFileSync(destManifest, "utf8"));
+        if (existing.version >= manifest.version) continue;
+      } catch {
+        // corrupt manifest — overwrite
+      }
+    }
+
+    // Copy plugin to ~/.fops/plugins/<name>/
+    fs.cpSync(srcDir, destDir, { recursive: true });
+  }
+}
+
 /**
  * Ensure ~/.fops/plugins/node_modules symlinks to the CLI's node_modules.
  * This lets global plugins resolve bare imports (chalk, execa, inquirer, etc.)
@@ -106,6 +145,7 @@ async function loadBuiltinPlugins(registry) {
  * Returns a populated PluginRegistry.
  */
 export async function loadPlugins() {
+  syncBundledPlugins();
   ensurePluginNodeModules();
   const registry = createRegistry();
   loadBuiltinAgents(registry);

package/src/setup/setup.js

@@ -109,6 +109,7 @@ export function runSetup(dir, opts = {}) {
           } catch {
             console.log(chalk.yellow("\n⚠ Some images failed to download."));
           }
+          console.log("");
           console.log(chalk.green("Setup complete. Run: fops up"));
           return;
         }
@@ -162,6 +163,7 @@ export function runSetup(dir, opts = {}) {
         console.log(chalk.dim("  Then re-run: fops init --download\n"));
       }
     }
+    console.log("");
     console.log(chalk.green("Setup complete. Run: fops up"));
   })();
 }

package/src/setup/wizard.js

@@ -130,6 +130,18 @@ export async function runInitWizard() {
         hasAws = await installTool("AWS CLI", { brew: "awscli", winget: "Amazon.AWSCLI" });
       }
 
+      // 1Password desktop app (optional — needed for CLI integration)
+      const has1PwdApp = process.platform === "darwin"
+        ? fs.existsSync("/Applications/1Password.app")
+        : process.platform === "win32"
+          ? fs.existsSync(path.join(process.env.LOCALAPPDATA || "", "1Password", "app", "8", "1Password.exe"))
+          : false;
+      if (has1PwdApp) console.log(chalk.green("  ✓ 1Password"));
+      else {
+        console.log(chalk.yellow("  ⚠ 1Password") + chalk.dim(" — desktop app needed for CLI integration"));
+        await installTool("1Password", { brewCask: "1password", winget: "AgileBits.1Password" });
+      }
+
       // 1Password CLI (optional)
       if (hasOp) console.log(chalk.green("  ✓ 1Password CLI"));
       else {