newaflux 1.2.0 → 1.3.0

package/agents/fluxn-executor.md

@@ -2,6 +2,7 @@
 name: fluxn-executor
 description: Executa fases do plano Newa Flux com commits atômicos. Spawned por /fluxn:execute.
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch
+permissionMode: acceptEdits
 color: green
 ---
 

package/agents/fluxn-researcher.md

@@ -2,6 +2,7 @@
 name: fluxn-researcher
 description: Pesquisa codebase e web para Newa Flux. Spawned por /fluxn:init e /fluxn:research.
 tools: Read, Bash, Grep, Glob, Write, WebSearch, WebFetch
+permissionMode: acceptEdits
 color: cyan
 ---
 

package/agents/fluxn-verifier.md

@@ -2,6 +2,7 @@
 name: fluxn-verifier
 description: Verificação READ-ONLY de implementação vs plano. Spawned por /fluxn:verify.
 tools: Read, Write, Bash, Grep, Glob
+permissionMode: acceptEdits
 color: yellow
 ---
 

package/bin/install.js

@@ -32,6 +32,27 @@ function error(msg) {
   log(`${c.red}  ✗${c.reset} ${msg}`);
 }
 
+// --- Recommended permissions ---
+const RECOMMENDED_PERMISSIONS = [
+  "WebSearch",
+  "WebFetch",
+  "Task(fluxn-researcher)",
+  "Task(fluxn-executor)",
+  "Task(fluxn-verifier)",
+  "Bash(mkdir -p *)",
+  "Bash(rm -f .fluxn/*)",
+  "Bash(rm -rf .fluxn/init)",
+  "Bash(cp *)",
+  "Bash(ls *)",
+  "Bash(git status)",
+  "Bash(git log *)",
+  "Bash(git diff *)",
+  "Bash(git show *)",
+  "Bash(git add *)",
+  "Bash(git commit *)",
+  "Bash(npx *)",
+];
+
 // --- Args ---
 const args = process.argv.slice(2);
 const flags = new Set(args.map((a) => a.toLowerCase()));
@@ -39,6 +60,7 @@ const flags = new Set(args.map((a) => a.toLowerCase()));
 const isUninstall = flags.has("--uninstall") || flags.has("-u");
 const isLocal = flags.has("--local") || flags.has("-l");
 const isGlobal = flags.has("--global") || flags.has("-g");
+const isOptimized = flags.has("--optimized") || flags.has("-o");
 const isHelp = flags.has("--help") || flags.has("-h");
 
 if (isHelp) {
@@ -49,12 +71,14 @@ Simplified multi-agent workflow for Claude Code.
 ${c.bold}Usage:${c.reset}
   npx newaflux              Install globally (default)
   npx newaflux --local      Install in current project
+  npx newaflux --optimized  Install with optimized model profile
   npx newaflux --uninstall  Remove installation
   npx newaflux --help       Show this help
 
 ${c.bold}Options:${c.reset}
   -g, --global     Install to ~/.claude/ (all projects)
   -l, --local      Install to ./.claude/ (current project)
+  -o, --optimized  Set optimized model profile (sonnet/opus routing)
   -u, --uninstall  Remove Newa Flux files
   -h, --help       Show help
 `);
@@ -83,6 +107,7 @@ const COMMANDS = [
   "verify.md",
   "go.md",
   "language.md",
+  "profile.md",
 ];
 
 // --- Copy helper ---
@@ -137,6 +162,63 @@ function install() {
     copied++;
   }
 
+  // Set optimized profile if requested
+  if (isOptimized) {
+    const fluxnDir = path.join(process.cwd(), ".fluxn");
+    if (!fs.existsSync(fluxnDir)) {
+      fs.mkdirSync(fluxnDir, { recursive: true });
+    }
+    const configPath = path.join(fluxnDir, "config.md");
+    let configContent = "# Newa Flux Config\n\n**Model Profile:** optimized\n";
+    if (fs.existsSync(configPath)) {
+      const existing = fs.readFileSync(configPath, "utf8");
+      const langMatch = existing.match(/^\*\*Language:\*\*.*$/m);
+      if (langMatch) {
+        configContent = "# Newa Flux Config\n\n" + langMatch[0] + "\n\n**Model Profile:** optimized\n";
+      }
+    }
+    fs.writeFileSync(configPath, configContent, "utf8");
+    success("Optimized profile set: researchers=sonnet, executor=opus, verifier=sonnet");
+  }
+
+  // Merge recommended permissions into settings.json
+  const settingsDir = isLocal
+    ? path.join(process.cwd(), ".claude")
+    : path.join(os.homedir(), ".claude");
+  const settingsPath = path.join(settingsDir, "settings.json");
+  let rulesAdded = 0;
+
+  try {
+    if (!fs.existsSync(settingsDir)) {
+      fs.mkdirSync(settingsDir, { recursive: true });
+    }
+
+    let settings = { permissions: { allow: [] } };
+    if (fs.existsSync(settingsPath)) {
+      const raw = fs.readFileSync(settingsPath, "utf8");
+      settings = JSON.parse(raw);
+      if (!settings.permissions) {
+        settings.permissions = {};
+      }
+      if (!Array.isArray(settings.permissions.allow)) {
+        settings.permissions.allow = [];
+      }
+    }
+
+    const existingRules = new Set(settings.permissions.allow);
+    for (const rule of RECOMMENDED_PERMISSIONS) {
+      if (!existingRules.has(rule)) {
+        settings.permissions.allow.push(rule);
+        rulesAdded++;
+      }
+    }
+
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
+    success(`${rulesAdded} permission rules configured`);
+  } catch (err) {
+    warn(`Could not update settings.json: ${err.message}`);
+  }
+
   // Write version file
   const versionFile = path.join(targetDir, "newaflux-version.txt");
   fs.writeFileSync(versionFile, VERSION, "utf8");
@@ -154,6 +236,7 @@ function install() {
   log(`    ${c.cyan}/fluxn:verify${c.reset}     Verify implementation`);
   log(`    ${c.cyan}/fluxn:go${c.reset}         Research + Plan in one shot`);
   log(`    ${c.cyan}/fluxn:language${c.reset}   Set output language`);
+  log(`    ${c.cyan}/fluxn:profile${c.reset}    Switch model profile`);
   log("");
   log(
     `  ${c.dim}Start with: /fluxn:init in Claude Code${c.reset}`

package/commands/fluxn/execute.md

@@ -43,6 +43,11 @@ mkdir -p .fluxn/phases
 
 ## Step 4: Execute Phase
 
+### Model Resolution
+Read `.fluxn/config.md`. If it contains `**Model Profile:** optimized`:
+- Add `model: "opus"` to the executor Task tool call below
+If `default` or no Model Profile line: do not pass model parameter.
+
 For the target phase, spawn ONE `fluxn-executor` agent:
 
 ```

package/commands/fluxn/go.md

@@ -71,6 +71,11 @@ rm -f .fluxn/research/agent-*.md
 
 ### 1.4: Launch 4 Researchers in Parallel
 
+### Model Resolution
+Read `.fluxn/config.md`. If it contains `**Model Profile:** optimized`:
+- Add `model: "sonnet"` to each researcher Task tool call below
+If `default` or no Model Profile line: do not pass model parameter.
+
 Spawn 4 `fluxn-researcher` agents using the Task tool, ALL IN PARALLEL.
 
 **If new-project:**

package/commands/fluxn/init.md

@@ -28,6 +28,11 @@ mkdir -p .fluxn/init
 
 ## Step 3: Launch 4 Researchers in Parallel
 
+### Model Resolution
+Read `.fluxn/config.md`. If it contains `**Model Profile:** optimized`:
+- Add `model: "sonnet"` to each researcher Task tool call below
+If `default` or no Model Profile line: do not pass model parameter.
+
 Spawn 4 `fluxn-researcher` agents using the Task tool, ALL IN PARALLEL (same message, 4 tool calls):
 
 ### Agent 1 — Tech Stack

package/commands/fluxn/profile.md

@@ -0,0 +1,83 @@
+---
+description: "Switch model profile (default/optimized): /fluxn:profile [default | optimized]"
+allowed-tools: Read, Write, Edit, Bash, Grep, Glob
+---
+
+# /fluxn:profile — Model Profile Configuration
+
+$ARGUMENTS
+
+You are the **model profile handler** for Newa Flux. Your job: show or switch the active model profile that controls which AI models are assigned to each agent.
+
+## Step 1: Load Context
+
+**Language check:** Read `.fluxn/config.md` if it exists. If it contains a `**Language:**` setting, use that language for ALL user-facing output (confirmations, tables, status messages). Internal files (config.md) remain in English.
+
+Read `.fluxn/config.md` if it exists. Look for the `**Model Profile:**` line to determine the current profile.
+
+If the file does not exist or has no `**Model Profile:**` line, the current profile is `default`.
+
+## Step 2: Parse Argument
+
+The profile argument comes from the user's arguments: **$ARGUMENTS**
+
+Valid values:
+- `default` — all agents inherit the parent model (no model parameter passed)
+- `optimized` — assigns specific models per agent for cost/speed optimization
+
+If the argument is not `default` or `optimized` and is not empty, tell the user the argument is invalid and show the two valid options.
+
+## Step 3: Show or Update
+
+### If no argument was provided
+
+Show the current profile status and the model assignment table for that profile. Do not modify any files.
+
+### If an argument was provided
+
+Update `.fluxn/config.md`:
+
+```bash
+mkdir -p .fluxn
+```
+
+- If `.fluxn/config.md` does not exist, create it with the profile setting.
+- If it exists, read it first and add or replace the `**Model Profile:**` line. Preserve all other settings (e.g., `**Language:**`).
+
+The `**Model Profile:**` line format:
+```
+**Model Profile:** [default | optimized]
+```
+
+## Step 4: Display Profile Table
+
+Show the user (in the configured language) the model assignment table for the active profile:
+
+### Default Profile
+
+| Role | Agent | Model |
+|------|-------|-------|
+| Researcher | fluxn-researcher | inherit (parent model) |
+| Executor | fluxn-executor | inherit (parent model) |
+| Verifier | fluxn-verifier | inherit (parent model) |
+| Plan | inline (orchestrator) | inherit (parent model) |
+
+All agents use the same model as the parent Claude Code session. No `model` parameter is passed to Task tool calls.
+
+### Optimized Profile
+
+| Role | Agent | Model |
+|------|-------|-------|
+| Researcher | fluxn-researcher | sonnet |
+| Executor | fluxn-executor | opus |
+| Verifier | fluxn-verifier | sonnet |
+| Plan | inline (orchestrator) | inherit (parent model) |
+
+Researchers and verifier use Sonnet for speed and cost savings. Executor uses Opus for maximum code quality. Planning runs inline and inherits the parent model.
+
+## Step 5: Confirm
+
+Tell the user (in the configured language):
+- Current profile: `[profile name]`
+- If they just changed it: "Profile updated. The new model assignments will apply to all future agent spawns."
+- If they just viewed it: "To switch profiles, run `/fluxn:profile default` or `/fluxn:profile optimized`."

package/commands/fluxn/research.md

@@ -71,6 +71,11 @@ rm -f .fluxn/research/agent-*.md
 
 ## Step 4: Launch 4 Researchers in Parallel
 
+### Model Resolution
+Read `.fluxn/config.md`. If it contains `**Model Profile:** optimized`:
+- Add `model: "sonnet"` to each researcher Task tool call below
+If `default` or no Model Profile line: do not pass model parameter.
+
 Spawn 4 `fluxn-researcher` agents using the Task tool, ALL IN PARALLEL.
 
 Each agent receives PROJECT.md content as base context in their prompt.

package/commands/fluxn/verify.md

@@ -23,6 +23,11 @@ If no phase-done.md files exist, tell the user to run `/fluxn:execute` first.
 
 ## Step 2: Spawn Verifier
 
+### Model Resolution
+Read `.fluxn/config.md`. If it contains `**Model Profile:** optimized`:
+- Add `model: "sonnet"` to the verifier Task tool call below
+If `default` or no Model Profile line: do not pass model parameter.
+
 Spawn ONE `fluxn-verifier` agent:
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newaflux",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Simplified multi-agent workflow framework for Claude Code. 3 agents + 7 commands = 10 files.",
   "bin": {
     "newaflux": "bin/install.js"