@superclaude-org/superflag 3.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Context Engine MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,292 @@
+# SuperFlag
+
+> **⚠️ MIGRATION NOTICE**: TypeScript/MCP version now available:
+> ```bash
+> npm install -g @superclaude-org/superflag
+> # or use with npx
+> npx @superclaude-org/superflag install
+> ```
+
+![Claude Code](https://img.shields.io/badge/Claude%20Code-supported-F37435)
+![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-supported-1ABC9C)
+![Continue](https://img.shields.io/badge/Continue-supported-FFFFFF)
+
+> **Note**: This project was inspired by the pioneering work in [SuperClaude Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) and [SuperGemini Framework](https://github.com/SuperClaude-Org/SuperGemini_Framework). Special thanks to [SuperClaude-Org](https://github.com/SuperClaude-Org) team members [@NomenAK](https://github.com/NomenAK) and [@mithun50](https://github.com/mithun50) whose work made this possible.
+
+SuperFlag provides 18 contextual flags that guide assistant behavior (e.g., `--strict`, `--auto`). It exposes an MCP stdio server and small setup helpers for common clients.
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @superclaude-org/superflag
+
+# Interactive installation (choose platforms)
+superflag install
+
+# Direct installation
+superflag install cc       # Claude Code
+superflag install gemini   # Gemini CLI
+superflag install cn       # Continue
+
+# Register MCP server in Claude Code
+claude mcp add superflag "npx" "-y" "@superclaude-org/superflag" -s user
+```
+
+Then in your client/assistant, use prompts with flags:
+- "Fix this bug --auto" (auto-select flags)
+- "--save" (handoff documentation)
+- "Analyze --strict" (precise, zero-tolerance mode)
+
+## 18 Flags
+
+| Flag | Purpose |
+|------|---------|
+| `--analyze` | Multi-angle systematic analysis |
+| `--auto` | AI selects optimal flag combination |
+| `--collab` | Co-develop solutions through trust-based iteration |
+| `--concise` | Minimal communication |
+| `--discover` | Discover existing solutions before building new |
+| `--explain` | Progressive disclosure |
+| `--git` | Version control best practices |
+| `--lean` | Essential focus only |
+| `--load` | Load handoff documentation |
+| `--parallel` | Multi-agent processing |
+| `--performance` | Speed and efficiency optimization |
+| `--readonly` | Analysis only mode |
+| `--refactor` | Code quality improvement |
+| `--reset` | Reset all flag states to new (clears session cache) |
+| `--save` | Handoff documentation |
+| `--seq` | Sequential thinking |
+| `--strict` | Zero-error enforcement |
+| `--todo` | Task management |
+
+## Installation
+
+### Claude Code
+```bash
+# Install package
+pip install superflag
+
+# Install configuration files (automatic MCP registration)
+superflag install
+```
+
+### Continue Extension
+```bash
+# Install package
+pip install superflag
+
+# Install configuration files
+superflag install --target cn
+```
+
+Edit `~/.continue/mcpServers/superflag.yaml`:
+
+```yaml
+# Standard Python (most common)
+name: SuperFlag
+command: python
+args: ["-m", "superflag"]
+
+# Or use absolute path to specific environment
+# name: SuperFlag
+# command: /path/to/venv/bin/python
+# args: ["-m", "superflag"]
+```
+
+Restart VS Code, then type `@` in Continue chat to access MCP tools.
+
+### Gemini CLI
+```bash
+# Install package
+pip install superflag
+
+# Install configuration files for Gemini CLI
+superflag install --target gemini-cli
+```
+
+This command:
+- Appends `@SUPERFLAG.md` to `~/.gemini/GEMINI.md` (adds once; no duplicate)
+- Writes latest instructions to `~/.gemini/SUPERFLAG.md`
+
+Register the MCP stdio command in Gemini CLI settings:
+  - Command: `python -m superflag`
+  - Args: `[]`
+  - Transport: stdio
+
+MCP registration (example)
+- File: `~/.gemini/settings.json`
+- Add or merge this into the `mcpServers` section:
+
+```json
+{
+  "mcpServers": {
+    "superflag": {
+      "type": "stdio",
+      "command": "python",
+      "args": ["-m", "superflag"],
+      "env": {}
+    }
+  }
+}
+```
+
+Gemini CLI settings
+- Location: `~/.gemini/settings.json`
+- Structure:
+
+```json
+{
+  "mcpServers": {
+    "<server-name>": {
+      "type": "stdio",
+      "command": "<executable or interpreter>",
+      "args": ["<arg1>", "<arg2>", "..."],
+      "env": { "ENV_KEY": "value" }
+    }
+  }
+}
+```
+
+Common setups
+- pip (python -m):
+```json
+{
+  "mcpServers": {
+    "superflag": {
+      "type": "stdio",
+      "command": "python",
+      "args": ["-m", "superflag"],
+      "env": {}
+    }
+  }
+}
+```
+
+- venv absolute path (Windows):
+```json
+{
+  "mcpServers": {
+    "superflag": {
+      "type": "stdio",
+      "command": "C:\\path\\to\\venv\\Scripts\\superflag.exe",
+      "args": [],
+      "env": {}
+    }
+  }
+}
+```
+
+- venv with interpreter (module run):
+```json
+{
+  "mcpServers": {
+    "superflag": {
+      "type": "stdio",
+      "command": "/path/to/venv/bin/python",
+      "args": ["-m", "superflag"],
+      "env": {}
+    }
+  }
+}
+```
+
+Notes
+- `type` is `stdio`.
+- If the command is not on PATH, use an absolute path (escape backslashes on Windows).
+- After editing, restart Gemini CLI and verify tools (e.g., list_available_flags).
+
+## Usage
+
+### In Chat
+```python
+# Auto mode - AI selects flags
+"Refactor this code --auto"
+
+# Direct flags
+"--save"  # Creates handoff doc
+"--analyze --strict"  # Multi-angle analysis with zero errors
+"--reset --analyze"  # Reset session and reapply
+
+# Combined flags
+"Review this --analyze --strict --seq"
+```
+
+### MCP Tools
+- `get_directives(['--flag1', '--flag2'])` - Activates flags
+
+Development: use `pip install -e .` for editable installs.
+
+Configuration updates: edit `~/.superflag/flags.yaml` and restart the MCP server.
+
+### Optional MCP Servers
+Additional MCP servers can complement certain flags:
+
+#### For `--seq` flag:
+```bash
+# Sequential thinking server  
+claude mcp add -s user -- sequential-thinking npx -y @modelcontextprotocol/server-sequential-thinking
+```
+
+These are optional; SuperFlag works without them.
+
+### Session
+- Duplicate flags produce a brief reminder instead of repeating full directives.
+- Use `--reset` when the task/context changes (resets all flag states to new).
+- The server tracks active flags per session.
+- Note: In Claude, flag states persist through `/clear` or `/compact` commands. Use `--reset` to reinitialize.
+
+## `--auto`
+`--auto` instructs the assistant to analyze the task and pick appropriate flags (do not include `--auto` in get_directives calls).
+
+Behavior
+- `--auto` only: the assistant selects a full set of flags automatically.
+- `--auto --flag1 --flag2`: the assistant applies `--flag1`, `--flag2` and may add additional flags if helpful. User‑specified flags take priority when there is overlap or conflict.
+- `--flag1 --flag2` (without `--auto`): only the specified flags are applied.
+
+## Files Created
+
+```
+~/.claude/
+├── CLAUDE.md                     # References @SUPERFLAG.md
+├── SUPERFLAG.md             # Flag instructions (auto-updated)
+├── hooks/
+│   └── superflag.py              # Hook for flag detection (Claude Code only)
+└── settings.json                 # Updated with hook registration (Claude Code only)
+
+~/.continue/
+├── config.yaml         # Contains SuperFlag rules
+└── mcpServers/
+    ├── superflag.yaml
+    ├── sequential-thinking.yaml
+    └── context7.yaml
+
+~/.superflag/
+└── flags.yaml          # Flag definitions
+
+~/.gemini/
+├── GEMINI.md           # References @SUPERFLAG.md
+└── SUPERFLAG.md   # Flag instructions (auto-updated)
+```
+
+## Uninstallation
+
+```bash
+# Complete uninstall from all environments (Claude Code + Continue)
+superflag uninstall
+
+# Remove Python package
+pip uninstall superflag
+```
+
+Note: During uninstallation, `~/.superflag/flags.yaml` is backed up to `~/flags.yaml.backup_YYYYMMDD_HHMMSS` before removal. During installation, existing flags.yaml is backed up and updated to the latest version.
+
+Claude Code note: Uninstall removes the `@SUPERFLAG.md` reference from `~/.claude/CLAUDE.md`, deletes `~/.claude/SUPERFLAG.md` if present, removes the hook file from `~/.claude/hooks/superflag.py`, and removes the hook registration from `~/.claude/settings.json`.
+
+Gemini CLI note: Uninstall removes the `@SUPERFLAG.md` reference from `~/.gemini/GEMINI.md` and deletes `~/.gemini/SUPERFLAG.md` if present.
+
+Continue note: Uninstall removes the SuperFlag rules from `~/.continue/config.yaml` (when present) and deletes `~/.continue/mcpServers/superflag.yaml` if present.
+
+## License
+MIT

package/dist/directives.d.ts

@@ -0,0 +1,44 @@
+interface FlagConfig {
+    brief: string;
+    directive: string;
+    verification?: string;
+}
+interface FlagsYaml {
+    directives: Record<string, FlagConfig>;
+    hook_messages?: Record<string, any>;
+    meta_instructions?: {
+        list_available_flags?: string;
+        get_directives?: string;
+    };
+}
+interface Directive {
+    brief: string;
+    raw: string;
+}
+export declare class DirectiveLoader {
+    private cachedConfig;
+    private lastLoadTime;
+    private cacheTimeout;
+    /**
+     * Load directives for specified flags from YAML file
+     */
+    loadDirectives(flags: string[], yamlPath: string): Promise<Record<string, Directive>>;
+    /**
+     * Load and cache YAML configuration
+     */
+    loadYamlConfig(yamlPath: string): Promise<FlagsYaml>;
+    /**
+     * Format a flag config into a directive
+     */
+    private formatDirective;
+    /**
+     * Copy bundled flags.yaml to user directory
+     */
+    private copyBundledConfig;
+    /**
+     * Clear the cache (useful for testing or forced reload)
+     */
+    clearCache(): void;
+}
+export {};
+//# sourceMappingURL=directives.d.ts.map

package/dist/directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"AAUA,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,iBAAiB,CAAC,EAAE;QAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAiB;IAErC;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAwBrC;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAmC1D;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/directives.js

@@ -0,0 +1,99 @@
+import * as yaml from "js-yaml";
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export class DirectiveLoader {
+    cachedConfig = null;
+    lastLoadTime = 0;
+    cacheTimeout = 60000; // 1 minute cache
+    /**
+     * Load directives for specified flags from YAML file
+     */
+    async loadDirectives(flags, yamlPath) {
+        // Load configuration
+        const config = await this.loadYamlConfig(yamlPath);
+        // Map flags to directives
+        const directives = {};
+        for (const flag of flags) {
+            const flagConfig = config.directives?.[flag];
+            if (flagConfig) {
+                directives[flag] = this.formatDirective(flagConfig);
+            }
+            else {
+                // Handle unknown flag
+                directives[flag] = {
+                    brief: "Unknown flag",
+                    raw: `<task>\nUnknown flag: ${flag}\n</task>\n\n<verify>\n☐ Flag not found in configuration\n</verify>`,
+                };
+            }
+        }
+        return directives;
+    }
+    /**
+     * Load and cache YAML configuration
+     */
+    async loadYamlConfig(yamlPath) {
+        const now = Date.now();
+        // Check cache
+        if (this.cachedConfig &&
+            now - this.lastLoadTime < this.cacheTimeout) {
+            return this.cachedConfig;
+        }
+        try {
+            // Check if file exists
+            await fs.access(yamlPath);
+            // Read and parse YAML
+            const content = await fs.readFile(yamlPath, "utf-8");
+            const config = yaml.load(content);
+            // Update cache
+            this.cachedConfig = config;
+            this.lastLoadTime = now;
+            return config;
+        }
+        catch (error) {
+            // If user's file doesn't exist, copy from package
+            try {
+                return await this.copyBundledConfig(yamlPath);
+            }
+            catch (copyError) {
+                // Fatal error: No flags.yaml found
+                throw new Error(`Cannot find flags.yaml. The package is corrupted or incomplete. Please reinstall.`);
+            }
+        }
+    }
+    /**
+     * Format a flag config into a directive
+     */
+    formatDirective(flagConfig) {
+        // Just use the directive as-is from YAML
+        // The YAML already has proper formatting
+        return {
+            brief: flagConfig.brief,
+            raw: flagConfig.directive,
+        };
+    }
+    /**
+     * Copy bundled flags.yaml to user directory
+     */
+    async copyBundledConfig(yamlPath) {
+        const packageFlagsPath = path.join(__dirname, '..', 'flags.yaml');
+        const content = await fs.readFile(packageFlagsPath, 'utf-8');
+        const config = yaml.load(content);
+        // Copy to user's home directory
+        const dir = path.dirname(yamlPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(yamlPath, content, 'utf-8');
+        return config;
+    }
+    /**
+     * Clear the cache (useful for testing or forced reload)
+     */
+    clearCache() {
+        this.cachedConfig = null;
+        this.lastLoadTime = 0;
+    }
+}
+//# sourceMappingURL=directives.js.map

package/dist/directives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.js","sourceRoot":"","sources":["../src/directives.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { SuperFlagServer } from "./server.js";
+import chalk from "chalk";
+import { VERSION } from "./version.js";
+// Check for CLI commands
+const args = process.argv.slice(2);
+// Handle version flags (NPM best practice)
+if (args[0] === "--version" || args[0] === "-v" || args[0] === "version") {
+    console.log(VERSION);
+    process.exit(0);
+}
+// Handle help flags
+if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+    console.log(`SuperFlag v${VERSION}`);
+    console.log("\nUsage:");
+    console.log("  superflag --version, -v              Show version");
+    console.log("  superflag --help, -h                 Show help");
+    console.log("  superflag install [--target TARGET]  Install SuperFlag");
+    console.log("  superflag uninstall [--target TARGET] Uninstall SuperFlag");
+    console.log("  superflag                            Run as MCP server");
+    console.log("\nTargets:");
+    console.log("  claude-code  Claude Code platform");
+    console.log("  gemini-cli   Gemini CLI platform");
+    console.log("  cn           Continue platform");
+    console.log("  all          All platforms");
+    process.exit(0);
+}
+if (args[0] === "install" || args[0] === "uninstall") {
+    // Delegate to install script
+    import("./install.js").then(module => {
+        module.handleCommand(args[0], args.slice(1));
+    }).catch(err => {
+        console.error(chalk.red(`Failed to load install module: ${err.message}`));
+        process.exit(1);
+    });
+}
+else {
+    // Run MCP server
+    runServer().catch((error) => {
+        console.error(chalk.red("Fatal error running server:"), error);
+        process.exit(1);
+    });
+}
+async function runServer() {
+    console.error(chalk.cyan("Starting SuperFlag MCP Server..."));
+    const server = new Server({
+        name: "superflag",
+        version: VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    const superflagServer = new SuperFlagServer();
+    // Register tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: superflagServer.getTools(),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const result = await superflagServer.handleToolCall(request.params.name, request.params.arguments);
+        return result;
+    });
+    // Connect via stdio
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(chalk.green("✓ SuperFlag MCP Server running on stdio"));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/install.d.ts

@@ -0,0 +1,2 @@
+export declare function handleCommand(command: string, args?: string[]): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAoDA,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCvF"}