@superclaude-org/superflag 3.1.1 → 3.1.4

package/SUPERFLAG.md

@@ -0,0 +1,80 @@
+# SuperFlag
+MCP Protocol: get_directives([flags])
+
+## Core Workflow
+<core_workflow>
+When flags detected in user input:
+1. Execute MCP tool: get_directives([detected_flags])
+2. Apply directives completely and in order
+3. Verify compliance at checkpoints
+
+**Call flags generously** - unexpected directives may contain guidance that helps you in ways you didn't anticipate.
+</core_workflow>
+
+## Parametric Flags
+Some flags accept an optional number suffix. Strip the suffix before calling get_directives:
+- `--team-5` → call `get_directives(["--team"])`, use 5 as the team size
+- `--sub-3` → call `get_directives(["--sub"])`, use 3 as the sub-agent count
+- `--team` / `--sub` (no number) → auto-determine count from task complexity
+
+## Available Flags
+
+### Analysis & Optimization
+- **--analyze**: Multi-perspective evidence-based analysis requiring 3+ independent perspectives for root cause identification
+- **--performance**: Measure-first performance optimization with baseline metrics and ROI calculation before changes
+- **--refactor**: Safe atomic refactoring with continuous test verification and zero regression guarantee
+- **--strict**: Zero-error transparent execution with honest reporting, no fabricated rules, verify-before-claim
+- **--lean**: Minimal resource-efficient implementation preserving all capabilities while eliminating waste
+
+### Discovery & Documentation
+- **--discover**: Research-first solution selection with 3+ alternatives and quantitative comparison before deciding
+- **--explain**: Progressive domain-expert disclosure from architectural intent to implementation details
+- **--save**: Document SuperFlag development for seamless continuation
+- **--load**: Load and verify handoff context by cross-checking document state against git reality
+
+### Workflow Management
+- **--team**: Multi-agent coordination with optional count (--team-N) — automatically selects Agent tool or TeamCreate based on task structure, role-specialized agents
+- **--skill**: Context-aware skill invocation — analyzes task and invokes the most appropriate superpowers skill before any action
+- **--todo**: Scope-locked task tracking with real-time progress and zero silent drops
+- **--seq**: Dependency-ordered sequential execution with mandatory checkpoint verification between steps
+- **--collab**: Evidence-anchored peer collaboration with quantitative validation, anti-sycophancy, and position accountability
+
+### Output Control
+- **--concise**: Precise timeless professional content prioritizing accuracy over brevity
+- **--git**: Anonymous atomic commits with ASCII-only WHY-focused messages, no push without request
+- **--readonly**: Analysis-only mode with absolute no-modification guarantee across files and git
+
+### Execution Discipline
+- **--integrity**: Verification-before-claim with evidence for every assertion
+- **--evolve**: Monotonic forward improvement with regression prevention
+
+### Meta Control
+- **--reset**: Clear session and force fresh directives
+- **--auto**: Grant autonomous flag selection authority
+
+## Flag Selection Strategy
+<flag_selection_strategy>
+When --auto is used:
+1. Analyze user intent and task requirements
+2. Select complementary flags that work together
+3. Avoid conflicting flags (e.g., --readonly with --git)
+4. Prioritize based on task type:
+   - Bugs: --analyze, --strict, --todo
+   - Performance: --performance, --lean
+   - Features: --discover, --skill, --todo
+   - Documentation: --explain, --save, --concise
+   - Multi-agent work: --team or --team-N (auto-selects Agent tool vs TeamCreate)
+   - Skill-driven work: --skill (auto-selects the right superpowers skill)
+</flag_selection_strategy>
+
+## Examples
+```
+"Fix this bug --analyze --strict"
+"Optimize the code --performance --lean"
+"Refactor safely --refactor --git"
+"Research alternatives --discover --todo"
+"Track complex task --todo --seq"
+"Run with 3 agents --team-3"
+"Auto-select best skill --skill"
+"Autonomous mode --auto"
+```

package/dist/install.js

@@ -238,6 +238,9 @@ async function installInteractive(platformNames) {
                 detail: settingsResult ? "Hook registered" : "Already registered"
             });
         }
+        // Register MCP server for all platforms
+        const mcpResult = await registerMcpServer(platform);
+        tasks.push(mcpResult);
     }
     // Display results
     displayResults(tasks);
@@ -276,12 +279,11 @@ async function uninstallInteractive(platformNames) {
                 detail: settingsResult ? "Hook unregistered" : "Not found"
             });
         }
+        // Unregister MCP server for all platforms
+        const mcpResult = await unregisterMcpServer(platform);
+        tasks.push(mcpResult);
     }
     displayResults(tasks);
-    if (platformNames.includes("Claude Code")) {
-        console.log(chalk.yellow("\n⚠  Note: Remove MCP server manually with:"));
-        console.log(chalk.gray("   claude mcp remove superflag"));
-    }
 }
 async function install(targetArg) {
     console.log(chalk.cyan.bold("\n============================================================"));
@@ -325,6 +327,9 @@ async function install(targetArg) {
                 detail: settingsResult ? "Hook registered" : "Already registered"
             });
         }
+        // Register MCP server for all platforms
+        const mcpResult = await registerMcpServer(platform);
+        tasks.push(mcpResult);
     }
     // Display results
     displayResults(tasks);
@@ -367,10 +372,15 @@ async function uninstall(targetArg) {
                 detail: settingsResult ? "Hook unregistered" : "Not found"
             });
         }
+        // Unregister MCP server for all platforms
+        const mcpResult = await unregisterMcpServer(platform);
+        tasks.push(mcpResult);
     }
     displayResults(tasks);
-    if (targetArg === "all" || targetArg === "claude-code") {
-        console.log(chalk.yellow("\n⚠  Note: Remove MCP server manually with:"));
+    // Check if Claude Code was in the uninstall and show manual MCP removal note
+    const claudeCodeIncluded = platforms.some(p => p.name === "Claude Code");
+    if (claudeCodeIncluded) {
+        console.log(chalk.yellow("\n⚠  Note: Remove Claude Code MCP server manually with:"));
         console.log(chalk.gray("   claude mcp remove superflag"));
     }
 }
@@ -378,20 +388,20 @@ function showNextSteps(platformNames) {
     console.log(chalk.yellow("\n📝 Next Steps:"));
     if (platformNames.includes("Claude Code")) {
         console.log(chalk.white("\nFor Claude Code:"));
-        console.log(chalk.cyan("  1. Register MCP server:"));
-        console.log(chalk.gray(`     claude mcp add superflag npx @superclaude-org/superflag@latest -s user`));
-        console.log(chalk.cyan("  2. Restart Claude Code"));
+        console.log(chalk.cyan("  1. Restart Claude Code"));
+        console.log(chalk.cyan("  2. Verify connection: claude mcp list"));
     }
     if (platformNames.includes("Gemini CLI")) {
         console.log(chalk.white("\nFor Gemini CLI:"));
-        console.log(chalk.cyan("  1. Register MCP server in Gemini settings"));
-        console.log(chalk.cyan("  2. Restart Gemini CLI"));
+        console.log(chalk.cyan("  1. Restart Gemini CLI"));
+        console.log(chalk.cyan("  2. MCP server already configured"));
     }
     if (platformNames.includes("Continue")) {
         console.log(chalk.white("\nFor Continue:"));
-        console.log(chalk.cyan("  1. Restart Continue extension"));
+        console.log(chalk.cyan("  1. Restart VS Code with Continue extension"));
+        console.log(chalk.cyan("  2. MCP server already configured"));
     }
-    console.log(chalk.green("\n3. Test with: \"Analyze this code --analyze --strict\""));
+    console.log(chalk.green("\n✅ Test with: \"Analyze this code --analyze --strict\""));
 }
 function showUsage() {
     console.log("\nUsage:");
@@ -760,111 +770,298 @@ function getDefaultFlagsYaml() {
     }
 }
 function getSuperflagMdContent() {
-    return `# SuperFlag
-MCP Protocol: get_directives([flags])
-
-## Core Workflow
-<core_workflow>
-When flags detected in user input:
-1. Execute MCP tool: get_directives([detected_flags])
-2. Apply directives completely and in order
-3. Verify compliance at checkpoints
-</core_workflow>
-
-## Available Flags
-
-### Analysis & Optimization
-- **--analyze**: Multi-perspective root cause analysis
-- **--performance**: Measure and optimize bottlenecks
-- **--refactor**: Safe code structure improvements
-- **--strict**: Zero-error execution with transparency
-- **--lean**: Eliminate waste with minimal implementation
-
-### Discovery & Documentation
-- **--discover**: Research existing solutions first
-- **--explain**: Progressive disclosure from overview to details
-- **--save**: Create handoff documents for continuity
-- **--load**: Restore context from handoff documents
-
-### Workflow Management
-- **--parallel**: Execute independent tasks simultaneously
-- **--todo**: Track progress with structured task management
-- **--seq**: Sequential step-by-step problem solving
-- **--collab**: Co-develop with quantitative validation
-
-### Output Control
-- **--concise**: Professional, culturally neutral content
-- **--git**: Anonymous, ASCII-only commit messages
-- **--readonly**: Analysis without file modifications
-
-### Meta Control
-- **--reset**: Clear session and force fresh directives
-- **--auto**: Grant autonomous flag selection authority
-
-## Flag Selection Strategy
-<flag_selection_strategy>
-When --auto is used:
-1. Analyze user intent and task requirements
-2. Select complementary flags that work together
-3. Avoid conflicting flags (e.g., --readonly with --git)
-4. Prioritize based on task type:
-   - Bugs: --analyze, --strict, --todo
-   - Performance: --performance, --lean
-   - Features: --discover, --parallel, --todo
-   - Documentation: --explain, --save, --concise
-</flag_selection_strategy>
-
-## Examples
-\`\`\`
-"Fix this bug --analyze --strict"
-"Optimize the code --performance --lean"
-"Refactor safely --refactor --git"
-"Research alternatives --discover --parallel"
-"Track complex task --todo --seq"
-\`\`\`
-`;
+    // Read SUPERFLAG.md from the package root
+    const superflagPath = path.join(__dirname, "..", "SUPERFLAG.md");
+    try {
+        return fsSync.readFileSync(superflagPath, "utf-8");
+    }
+    catch {
+        throw new Error(`SUPERFLAG.md not found at ${superflagPath}`);
+    }
 }
 function getPythonHookContent() {
-    return `#!/usr/bin/env python3
-"""SuperFlag Claude Code Hook - TypeScript Edition Bridge"""
-
-import sys
-import json
-import re
-
-def main():
-    try:
-        user_input = sys.stdin.read()
-
-        # Detect flags in user input
-        flags = re.findall(r'--\\w+', user_input)
-
-        if flags:
-            # Output hook message for Claude Code
-            message = {
-                "type": "system",
-                "message": f"Flags detected: {', '.join(flags)}\\n" +
-                          "Execute: get_directives(" + str(flags) + ") for systematic implementation."
-            }
-            print(json.dumps(message))
-            return 0
-
-    except Exception:
-        pass
-
-    return 1
-
-if __name__ == "__main__":
-    sys.exit(main())
+    return `#!/usr/bin/env python3
+"""SuperFlag Claude Code Hook - TypeScript Edition Bridge"""
+
+import sys
+import json
+import re
+
+def main():
+    try:
+        user_input = sys.stdin.read()
+
+        # Detect flags in user input
+        flags = re.findall(r'--\\w+', user_input)
+
+        if flags:
+            # Output hook message for Claude Code
+            message = {
+                "type": "system",
+                "message": f"Flags detected: {', '.join(flags)}\\n" +
+                          "Execute: get_directives(" + str(flags) + ") for systematic implementation."
+            }
+            print(json.dumps(message))
+            return 0
+
+    except Exception:
+        pass
+
+    return 1
+
+if __name__ == "__main__":
+    sys.exit(main())
 `;
 }
-// Main execution
+// =====================================================
+// MCP Auto-Registration Functions
+// =====================================================
+async function registerMcpServer(platform) {
+    try {
+        switch (platform.name) {
+            case "Claude Code":
+                return await registerClaudeCodeMcp();
+            case "Gemini CLI":
+                return await registerGeminiMcp();
+            case "Continue":
+                return await registerContinueMcp();
+            default:
+                return {
+                    name: `${platform.name} MCP`,
+                    status: "SKIP",
+                    detail: "Not supported"
+                };
+        }
+    }
+    catch (error) {
+        return {
+            name: `${platform.name} MCP`,
+            status: "FAIL",
+            detail: error instanceof Error ? error.message : "Unknown error"
+        };
+    }
+}
+async function unregisterMcpServer(platform) {
+    try {
+        switch (platform.name) {
+            case "Claude Code":
+                return await unregisterClaudeCodeMcp();
+            case "Gemini CLI":
+                return await unregisterGeminiMcp();
+            case "Continue":
+                return await unregisterContinueMcp();
+            default:
+                return {
+                    name: `${platform.name} MCP`,
+                    status: "SKIP",
+                    detail: "Not supported"
+                };
+        }
+    }
+    catch (error) {
+        return {
+            name: `${platform.name} MCP`,
+            status: "FAIL",
+            detail: error instanceof Error ? error.message : "Unknown error"
+        };
+    }
+}
+// Claude Code MCP Registration
+async function registerClaudeCodeMcp() {
+    const configPath = path.join(os.homedir(), ".claude.json");
+    try {
+        let config = {};
+        // Read existing config
+        try {
+            const content = await fs.readFile(configPath, "utf-8");
+            config = JSON.parse(content);
+        }
+        catch {
+            // File doesn't exist, create new config
+            config = {};
+        }
+        // Ensure mcpServers section exists
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        // Add SuperFlag MCP server
+        config.mcpServers.superflag = {
+            type: "stdio",
+            command: "npx",
+            args: ["@superclaude-org/superflag@latest"],
+            env: {}
+        };
+        // Write back to file
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+        return {
+            name: "Claude Code MCP",
+            status: "OK",
+            detail: "Registered"
+        };
+    }
+    catch (error) {
+        return {
+            name: "Claude Code MCP",
+            status: "FAIL",
+            detail: error instanceof Error ? error.message : "Unknown error"
+        };
+    }
+}
+async function unregisterClaudeCodeMcp() {
+    const configPath = path.join(os.homedir(), ".claude.json");
+    try {
+        const content = await fs.readFile(configPath, "utf-8");
+        const config = JSON.parse(content);
+        if (config.mcpServers && config.mcpServers.superflag) {
+            delete config.mcpServers.superflag;
+            await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+            return {
+                name: "Claude Code MCP",
+                status: "OK",
+                detail: "Unregistered"
+            };
+        }
+        return {
+            name: "Claude Code MCP",
+            status: "SKIP",
+            detail: "Not found"
+        };
+    }
+    catch {
+        return {
+            name: "Claude Code MCP",
+            status: "SKIP",
+            detail: "Config not found"
+        };
+    }
+}
+// Gemini CLI MCP Registration
+async function registerGeminiMcp() {
+    const configPath = path.join(os.homedir(), ".gemini", "settings.json");
+    try {
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(configPath), { recursive: true });
+        let config = {};
+        // Read existing config
+        try {
+            const content = await fs.readFile(configPath, "utf-8");
+            config = JSON.parse(content);
+        }
+        catch {
+            // File doesn't exist, create new config
+            config = {};
+        }
+        // Ensure mcpServers section exists
+        if (!config.mcpServers) {
+            config.mcpServers = {};
+        }
+        // Add SuperFlag MCP server
+        config.mcpServers.superflag = {
+            type: "stdio",
+            command: "npx",
+            args: ["@superclaude-org/superflag@latest"],
+            env: {}
+        };
+        // Write back to file
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+        return {
+            name: "Gemini CLI MCP",
+            status: "OK",
+            detail: "Registered"
+        };
+    }
+    catch (error) {
+        return {
+            name: "Gemini CLI MCP",
+            status: "FAIL",
+            detail: error instanceof Error ? error.message : "Unknown error"
+        };
+    }
+}
+async function unregisterGeminiMcp() {
+    const configPath = path.join(os.homedir(), ".gemini", "settings.json");
+    try {
+        const content = await fs.readFile(configPath, "utf-8");
+        const config = JSON.parse(content);
+        if (config.mcpServers && config.mcpServers.superflag) {
+            delete config.mcpServers.superflag;
+            await fs.writeFile(configPath, JSON.stringify(config, null, 2) + "\n");
+            return {
+                name: "Gemini CLI MCP",
+                status: "OK",
+                detail: "Unregistered"
+            };
+        }
+        return {
+            name: "Gemini CLI MCP",
+            status: "SKIP",
+            detail: "Not found"
+        };
+    }
+    catch {
+        return {
+            name: "Gemini CLI MCP",
+            status: "SKIP",
+            detail: "Config not found"
+        };
+    }
+}
+// Continue MCP Registration
+async function registerContinueMcp() {
+    const mcpDir = path.join(os.homedir(), ".continue", "mcpServers");
+    const configPath = path.join(mcpDir, "superflag.yaml");
+    try {
+        // Ensure directory exists
+        await fs.mkdir(mcpDir, { recursive: true });
+        const mcpConfig = {
+            name: "SuperFlag",
+            command: "npx",
+            args: ["@superclaude-org/superflag@latest"],
+            env: {}
+        };
+        // Write MCP server config
+        await fs.writeFile(configPath, yaml.dump(mcpConfig));
+        return {
+            name: "Continue MCP",
+            status: "OK",
+            detail: "Registered"
+        };
+    }
+    catch (error) {
+        return {
+            name: "Continue MCP",
+            status: "FAIL",
+            detail: error instanceof Error ? error.message : "Unknown error"
+        };
+    }
+}
+async function unregisterContinueMcp() {
+    const configPath = path.join(os.homedir(), ".continue", "mcpServers", "superflag.yaml");
+    try {
+        await fs.unlink(configPath);
+        return {
+            name: "Continue MCP",
+            status: "OK",
+            detail: "Unregistered"
+        };
+    }
+    catch {
+        return {
+            name: "Continue MCP",
+            status: "SKIP",
+            detail: "Not found"
+        };
+    }
+}
+// Main execution (only for direct execution)
 async function main() {
     const args = process.argv.slice(2);
     const command = args[0];
     const commandArgs = args.slice(1);
     await handleCommand(command || "", commandArgs);
 }
-// Run if this is the main module
-main().catch(console.error);
+// Run only if this is the main module (not imported)
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}
 //# sourceMappingURL=install.js.map