hyperflash 1.0.0__tar.gz → 1.1.0__tar.gz

{hyperflash-1.0.0/src/hyperflash.egg-info → hyperflash-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperflash
-Version: 1.0.0
+Version: 1.1.0
 Summary: Universal Engineering Reliability Runtime & Multi-Agent Verification Guardrails
 Author: Virat Ghatge
 License: MIT
@@ -43,7 +43,7 @@ Dynamic: license-file
 
 <br/>
 
-[![PyPI](https://img.shields.io/pypi/v/hyperflash?style=for-the-badge&logo=pypi&color=3775A9)](https://pypi.org/project/hyperflash/)
+[![PyPI - Version](https://img.shields.io/pypi/v/hyperflash?style=for-the-badge&logo=pypi&logoColor=white&color=3776AB)](https://pypi.org/project/hyperflash/)
 [![Stars](https://img.shields.io/github/stars/Virat-Ghatge/hyperflash?style=for-the-badge&logo=github&color=FFD700)](https://github.com/Virat-Ghatge/hyperflash/stargazers)
 [![Forks](https://img.shields.io/github/forks/Virat-Ghatge/hyperflash?style=for-the-badge&logo=github&color=60A5FA)](https://github.com/Virat-Ghatge/hyperflash/network/members)
 [![Issues](https://img.shields.io/github/issues/Virat-Ghatge/hyperflash?style=for-the-badge&color=34D399)](https://github.com/Virat-Ghatge/hyperflash/issues)
@@ -177,7 +177,7 @@ pip install hyperflash
 Scaffold your preferred IDE or agent harness in 1 second:
 
 ```bash
-# Configure Cursor, Claude Code, Windsurf, Git Hooks, and Antigravity in one command
+# Configure Cursor, Claude Code, Windsurf, Git Hooks, Antigravity, and OpenCode in one command
 hyperflash init
 
 # Or target your specific harness:
@@ -186,6 +186,25 @@ hyperflash init --target claude
 hyperflash init --target windsurf
 hyperflash init --target git
 hyperflash init --target antigravity
+hyperflash init --target opencode
+```
+
+### 🚀 Universal Agent Launcher
+Launch your preferred coding environment with the native HyperFlash agent persona pre-activated:
+
+```bash
+# Launch OpenCode with native HyperFlash agent
+hyperflash launch opencode
+
+# Launch Antigravity terminal session with HyperFlash agent
+hyperflash launch antigravity   # or: hyperflash launch agy
+
+# Launch Claude Code with HyperFlash rules and /hyperflash command
+hyperflash launch claude
+
+# Launch Cursor or Windsurf with HyperFlash agent rules
+hyperflash launch cursor
+hyperflash launch windsurf
 ```
 
 ### 🔌 Universal MCP Server Integration
@@ -227,6 +246,18 @@ HyperFlash features a built-in Model Context Protocol (MCP) server running over
 }
 ```
 
+#### In OpenCode (`opencode.json`):
+```json
+{
+  "mcpServers": {
+    "hyperflash": {
+      "command": "hyperflash",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
 ### Or Clone & Run Local Shell Installer
 If you are developing locally without `pip`:
 
@@ -282,32 +313,59 @@ HyperFlash integrates directly into the Antigravity Desktop IDE and the terminal
 
 ### 2. Claude Code (Anthropic CLI)
 
-You can bring HyperFlash's invariants into Claude Code using project memory and pre/post tool hooks.
+You can bring HyperFlash's invariants into Claude Code using project memory, pre/post tool hooks, and native slash commands.
 
-#### Step 1: Add HyperFlash Constitution to `CLAUDE.md`
-Add the following to your project's `CLAUDE.md` or `~/.claude/CLAUDE.md`:
-
-```markdown
-# HyperFlash Reliability Constitution for Claude Code
+#### Step 1: Automatic Setup via CLI
+```bash
+hyperflash init --target claude
+```
+This automatically configures:
+- `CLAUDE.md`: System reliability constitution.
+- `.claude.json`: Local stdio MCP server for safe patching and AST symbol graphs.
+- `.claude/commands/hyperflash.md`: Dedicated agent slash command.
 
-1. GROUND FIRST: Never call file editing tools on an existing file without calling `View` or `Cat` first in this session.
-2. ZERO CODE ELISION: Never emit `// ... rest of code`, `# ... existing code`, or `TODO: implement`. Every edit must be 100% complete.
-3. CONTRACT BOUNDARY: Only mutate files explicitly discussed and approved for the current task. Do not touch external modules.
-4. EVIDENCE OVER CLAIMS: Never declare a task complete or a bug fixed unless you have executed the project test command (`pytest`, `npm test`, `cargo test`) in this session and observed exit code 0.
-5. CHUNKED DECODE: For files exceeding 200 lines, emit class/function skeletons first, then populate method bodies in surgical 100-150 line diffs.
+#### Step 2: Activate HyperFlash in Claude Code
+Inside any Claude Code terminal session, simply run:
+```text
+/hyperflash
+```
+Or launch Claude Code directly with HyperFlash active:
+```bash
+hyperflash launch claude
 ```
 
-#### Step 2: Wire Pre-Commit Verification
-Run HyperFlash's standalone verification script inside Claude Code:
+#### Step 3: Run Deterministic Verification
+Execute HyperFlash's verification hierarchy directly from Claude Code:
 ```bash
-python -m src.skills.hyperflash.scripts.verify_hierarchy --tier 6
+hyperflash verify --tier 6
 ```
 
 ---
 
 ### 3. OpenCode / OpenHands / SWE-Agent
 
-HyperFlash scripts can be invoked directly inside any autonomous agent container or Python environment:
+OpenCode supports dedicated named agents natively. HyperFlash installs as a first-class persona with custom system prompts and tools.
+
+#### Step 1: Automatic Setup via CLI
+```bash
+hyperflash init --target opencode
+```
+This configures:
+- `OPENCODE.md`: OpenCode engineering constitution.
+- `.opencode/agents/hyperflash.json`: Dedicated agent persona definition.
+- `opencode.json`: Declares `agent: "hyperflash"`, registers agent configuration, and wires the `hyperflash` stdio MCP server.
+
+#### Step 2: Launch OpenCode with HyperFlash Persona
+```bash
+# Direct OpenCode CLI
+opencode --agent hyperflash
+
+# Or via the universal runner
+hyperflash launch opencode
+```
+
+#### Step 3: Custom Agent Harnesses (Python / Containers)
+HyperFlash guardrails can also be evaluated programmatically inside any agent container:
 
 ```python
 # In your custom agent loop or OpenHands execution environment
@@ -331,34 +389,25 @@ def run_hyperflash_guards(tool_call: dict) -> bool:
 
 ### 4. Cursor & Windsurf IDEs
 
-Scaffold full HyperFlash rules and MCP integration with one command:
+HyperFlash delivers always-on rule enforcement and tool capabilities for modern AI-native IDEs.
+
+#### Step 1: Automatic Setup via CLI
 ```bash
-hyperflash init --target cursor   # Configures .cursorrules & .cursor/mcp.json
-hyperflash init --target windsurf # Configures .windsurfrules & .windsurf/mcp.json
+hyperflash init --target cursor   # Configures .cursorrules, .cursor/rules/hyperflash.mdc, .cursor/mcp.json
+hyperflash init --target windsurf # Configures .windsurfrules, .windsurf/rules/hyperflash.md, .windsurf/mcp.json
 ```
 
-Or manually configure your workspace:
-- **Rules file (`.cursorrules` or `.windsurfrules`):**
-```markdown
-# HyperFlash Engineering Rules
-- Always view the entire target file before proposing edits.
-- Never truncate code with comments like `// existing code remains the same`. Write the entire functional block.
-- Always include exhaustive static type annotations on all parameters and return values.
-- Before claiming a task is done, run terminal commands to verify compilation and tests.
-- Emit a `decision:` and `pre_mortem:` YAML block before multi-file edits.
-```
-- **MCP Server (`.cursor/mcp.json` or `.windsurf/mcp.json`):**
-```json
-{
-  "mcpServers": {
-    "hyperflash": {
-      "command": "hyperflash",
-      "args": ["mcp"]
-    }
-  }
-}
+#### Step 2: Launch IDE with HyperFlash
+```bash
+hyperflash launch cursor
+hyperflash launch windsurf
 ```
 
+#### What Gets Configured:
+- **Cursor Rules MDC (`.cursor/rules/hyperflash.mdc`):** Enforces `alwaysApply: true` so Cursor Composer and Agent mode strictly observe the 8 Invariants across all edits.
+- **Windsurf Rules (`.windsurf/rules/hyperflash.md` & `.windsurfrules`):** Guides Cascade Agent with zero-elision and ground-before-mutating constraints.
+- **MCP Integration (`mcp.json`):** Exposes `hyperflash_safe_patch`, `hyperflash_verify`, and `hyperflash_get_symbol_graph` directly to the IDE agent.
+
 ---
 
 ### 5. Git Pre-Commit & CI/CD Quality Gates
@@ -374,7 +423,7 @@ hyperflash init --target git
 ```yaml
 repos:
   - repo: https://github.com/Virat-Ghatge/hyperflash
-    rev: v1.0.0
+    rev: v1.1.0
     hooks:
       - id: hyperflash-zero-elision
       - id: hyperflash-verify

{hyperflash-1.0.0 → hyperflash-1.1.0}/README.md

@@ -18,7 +18,7 @@
 
 <br/>
 
-[![PyPI](https://img.shields.io/pypi/v/hyperflash?style=for-the-badge&logo=pypi&color=3775A9)](https://pypi.org/project/hyperflash/)
+[![PyPI - Version](https://img.shields.io/pypi/v/hyperflash?style=for-the-badge&logo=pypi&logoColor=white&color=3776AB)](https://pypi.org/project/hyperflash/)
 [![Stars](https://img.shields.io/github/stars/Virat-Ghatge/hyperflash?style=for-the-badge&logo=github&color=FFD700)](https://github.com/Virat-Ghatge/hyperflash/stargazers)
 [![Forks](https://img.shields.io/github/forks/Virat-Ghatge/hyperflash?style=for-the-badge&logo=github&color=60A5FA)](https://github.com/Virat-Ghatge/hyperflash/network/members)
 [![Issues](https://img.shields.io/github/issues/Virat-Ghatge/hyperflash?style=for-the-badge&color=34D399)](https://github.com/Virat-Ghatge/hyperflash/issues)
@@ -152,7 +152,7 @@ pip install hyperflash
 Scaffold your preferred IDE or agent harness in 1 second:
 
 ```bash
-# Configure Cursor, Claude Code, Windsurf, Git Hooks, and Antigravity in one command
+# Configure Cursor, Claude Code, Windsurf, Git Hooks, Antigravity, and OpenCode in one command
 hyperflash init
 
 # Or target your specific harness:
@@ -161,6 +161,25 @@ hyperflash init --target claude
 hyperflash init --target windsurf
 hyperflash init --target git
 hyperflash init --target antigravity
+hyperflash init --target opencode
+```
+
+### 🚀 Universal Agent Launcher
+Launch your preferred coding environment with the native HyperFlash agent persona pre-activated:
+
+```bash
+# Launch OpenCode with native HyperFlash agent
+hyperflash launch opencode
+
+# Launch Antigravity terminal session with HyperFlash agent
+hyperflash launch antigravity   # or: hyperflash launch agy
+
+# Launch Claude Code with HyperFlash rules and /hyperflash command
+hyperflash launch claude
+
+# Launch Cursor or Windsurf with HyperFlash agent rules
+hyperflash launch cursor
+hyperflash launch windsurf
 ```
 
 ### 🔌 Universal MCP Server Integration
@@ -202,6 +221,18 @@ HyperFlash features a built-in Model Context Protocol (MCP) server running over
 }
 ```
 
+#### In OpenCode (`opencode.json`):
+```json
+{
+  "mcpServers": {
+    "hyperflash": {
+      "command": "hyperflash",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
 ### Or Clone & Run Local Shell Installer
 If you are developing locally without `pip`:
 
@@ -257,32 +288,59 @@ HyperFlash integrates directly into the Antigravity Desktop IDE and the terminal
 
 ### 2. Claude Code (Anthropic CLI)
 
-You can bring HyperFlash's invariants into Claude Code using project memory and pre/post tool hooks.
+You can bring HyperFlash's invariants into Claude Code using project memory, pre/post tool hooks, and native slash commands.
 
-#### Step 1: Add HyperFlash Constitution to `CLAUDE.md`
-Add the following to your project's `CLAUDE.md` or `~/.claude/CLAUDE.md`:
-
-```markdown
-# HyperFlash Reliability Constitution for Claude Code
+#### Step 1: Automatic Setup via CLI
+```bash
+hyperflash init --target claude
+```
+This automatically configures:
+- `CLAUDE.md`: System reliability constitution.
+- `.claude.json`: Local stdio MCP server for safe patching and AST symbol graphs.
+- `.claude/commands/hyperflash.md`: Dedicated agent slash command.
 
-1. GROUND FIRST: Never call file editing tools on an existing file without calling `View` or `Cat` first in this session.
-2. ZERO CODE ELISION: Never emit `// ... rest of code`, `# ... existing code`, or `TODO: implement`. Every edit must be 100% complete.
-3. CONTRACT BOUNDARY: Only mutate files explicitly discussed and approved for the current task. Do not touch external modules.
-4. EVIDENCE OVER CLAIMS: Never declare a task complete or a bug fixed unless you have executed the project test command (`pytest`, `npm test`, `cargo test`) in this session and observed exit code 0.
-5. CHUNKED DECODE: For files exceeding 200 lines, emit class/function skeletons first, then populate method bodies in surgical 100-150 line diffs.
+#### Step 2: Activate HyperFlash in Claude Code
+Inside any Claude Code terminal session, simply run:
+```text
+/hyperflash
+```
+Or launch Claude Code directly with HyperFlash active:
+```bash
+hyperflash launch claude
 ```
 
-#### Step 2: Wire Pre-Commit Verification
-Run HyperFlash's standalone verification script inside Claude Code:
+#### Step 3: Run Deterministic Verification
+Execute HyperFlash's verification hierarchy directly from Claude Code:
 ```bash
-python -m src.skills.hyperflash.scripts.verify_hierarchy --tier 6
+hyperflash verify --tier 6
 ```
 
 ---
 
 ### 3. OpenCode / OpenHands / SWE-Agent
 
-HyperFlash scripts can be invoked directly inside any autonomous agent container or Python environment:
+OpenCode supports dedicated named agents natively. HyperFlash installs as a first-class persona with custom system prompts and tools.
+
+#### Step 1: Automatic Setup via CLI
+```bash
+hyperflash init --target opencode
+```
+This configures:
+- `OPENCODE.md`: OpenCode engineering constitution.
+- `.opencode/agents/hyperflash.json`: Dedicated agent persona definition.
+- `opencode.json`: Declares `agent: "hyperflash"`, registers agent configuration, and wires the `hyperflash` stdio MCP server.
+
+#### Step 2: Launch OpenCode with HyperFlash Persona
+```bash
+# Direct OpenCode CLI
+opencode --agent hyperflash
+
+# Or via the universal runner
+hyperflash launch opencode
+```
+
+#### Step 3: Custom Agent Harnesses (Python / Containers)
+HyperFlash guardrails can also be evaluated programmatically inside any agent container:
 
 ```python
 # In your custom agent loop or OpenHands execution environment
@@ -306,34 +364,25 @@ def run_hyperflash_guards(tool_call: dict) -> bool:
 
 ### 4. Cursor & Windsurf IDEs
 
-Scaffold full HyperFlash rules and MCP integration with one command:
+HyperFlash delivers always-on rule enforcement and tool capabilities for modern AI-native IDEs.
+
+#### Step 1: Automatic Setup via CLI
 ```bash
-hyperflash init --target cursor   # Configures .cursorrules & .cursor/mcp.json
-hyperflash init --target windsurf # Configures .windsurfrules & .windsurf/mcp.json
+hyperflash init --target cursor   # Configures .cursorrules, .cursor/rules/hyperflash.mdc, .cursor/mcp.json
+hyperflash init --target windsurf # Configures .windsurfrules, .windsurf/rules/hyperflash.md, .windsurf/mcp.json
 ```
 
-Or manually configure your workspace:
-- **Rules file (`.cursorrules` or `.windsurfrules`):**
-```markdown
-# HyperFlash Engineering Rules
-- Always view the entire target file before proposing edits.
-- Never truncate code with comments like `// existing code remains the same`. Write the entire functional block.
-- Always include exhaustive static type annotations on all parameters and return values.
-- Before claiming a task is done, run terminal commands to verify compilation and tests.
-- Emit a `decision:` and `pre_mortem:` YAML block before multi-file edits.
-```
-- **MCP Server (`.cursor/mcp.json` or `.windsurf/mcp.json`):**
-```json
-{
-  "mcpServers": {
-    "hyperflash": {
-      "command": "hyperflash",
-      "args": ["mcp"]
-    }
-  }
-}
+#### Step 2: Launch IDE with HyperFlash
+```bash
+hyperflash launch cursor
+hyperflash launch windsurf
 ```
 
+#### What Gets Configured:
+- **Cursor Rules MDC (`.cursor/rules/hyperflash.mdc`):** Enforces `alwaysApply: true` so Cursor Composer and Agent mode strictly observe the 8 Invariants across all edits.
+- **Windsurf Rules (`.windsurf/rules/hyperflash.md` & `.windsurfrules`):** Guides Cascade Agent with zero-elision and ground-before-mutating constraints.
+- **MCP Integration (`mcp.json`):** Exposes `hyperflash_safe_patch`, `hyperflash_verify`, and `hyperflash_get_symbol_graph` directly to the IDE agent.
+
 ---
 
 ### 5. Git Pre-Commit & CI/CD Quality Gates
@@ -349,7 +398,7 @@ hyperflash init --target git
 ```yaml
 repos:
   - repo: https://github.com/Virat-Ghatge/hyperflash
-    rev: v1.0.0
+    rev: v1.1.0
     hooks:
       - id: hyperflash-zero-elision
       - id: hyperflash-verify

{hyperflash-1.0.0 → hyperflash-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hyperflash"
-version = "1.0.0"
+version = "1.1.0"
 description = "Universal Engineering Reliability Runtime & Multi-Agent Verification Guardrails"
 readme = "README.md"
 requires-python = ">=3.10"

{hyperflash-1.0.0 → hyperflash-1.1.0}/src/hyperflash/__init__.py

@@ -14,7 +14,7 @@ from hyperflash.core import (
     save_contract,
 )
 
-__version__: str = "1.0.0"
+__version__: str = "1.1.0"
 
 __all__: list[str] = [
     "__version__",

{hyperflash-1.0.0 → hyperflash-1.1.0}/src/hyperflash/cli.py

@@ -6,6 +6,8 @@ from __future__ import annotations
 
 import argparse
 import json
+import shutil
+import subprocess
 import sys
 from pathlib import Path
 from typing import Any, Sequence
@@ -24,6 +26,7 @@ from hyperflash.polyglot import (
     setup_claude,
     setup_cursor,
     setup_git_hooks,
+    setup_opencode,
     setup_windsurf,
 )
 
@@ -61,8 +64,12 @@ def cmd_init(args: argparse.Namespace) -> int:
         files = setup_antigravity(workspace)
         for f in files:
             print(f"  • Configured Antigravity: {f}")
+    elif target == "opencode":
+        files = setup_opencode(workspace)
+        for f in files:
+            print(f"  • Configured OpenCode: {f}")
     else:
-        print(f"❌ Unknown target '{target}'. Choose from all, cursor, claude, windsurf, git, antigravity.")
+        print(f"❌ Unknown target '{target}'. Choose from all, cursor, claude, windsurf, git, antigravity, opencode.")
         return 1
 
     print("✅ HyperFlash initialization complete. Guardrails are active.")
@@ -164,6 +171,42 @@ def cmd_check_elision(args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_launch(args: argparse.Namespace) -> int:
+    """Handles 'hyperflash launch' command."""
+    harness: str = args.harness.lower()
+    extra_args: list[str] = list(getattr(args, "extra_args", []) or [])
+
+    cmd_map: dict[str, list[str]] = {
+        "opencode": ["opencode", "--agent", "hyperflash"],
+        "antigravity": ["agy", "--agent", "hyperflash"],
+        "agy": ["agy", "--agent", "hyperflash"],
+        "claude": ["claude"],
+        "cursor": ["cursor", "."],
+        "windsurf": ["windsurf", "."],
+    }
+
+    base_cmd = cmd_map.get(harness)
+    if not base_cmd:
+        print(f"❌ Unknown harness '{harness}'. Choose from opencode, claude, cursor, windsurf, antigravity, agy.")
+        return 1
+
+    binary_name = base_cmd[0]
+    if not shutil.which(binary_name):
+        print(f"❌ Harness '{harness}' not found in PATH. Please install it first.")
+        return 1
+
+    full_cmd: list[str] = base_cmd + extra_args
+    try:
+        proc = subprocess.run(full_cmd)
+        return proc.returncode
+    except FileNotFoundError:
+        print(f"❌ Harness '{harness}' not found in PATH. Please install it first.")
+        return 1
+    except Exception as exc:
+        print(f"❌ Error launching '{harness}': {exc}")
+        return 1
+
+
 def build_parser() -> argparse.ArgumentParser:
     """Constructs the CLI argument parser."""
     parser = argparse.ArgumentParser(
@@ -180,10 +223,10 @@ def build_parser() -> argparse.ArgumentParser:
     subparsers = parser.add_subparsers(dest="command", help="Available subcommands")
 
     # init
-    p_init = subparsers.add_parser("init", help="1-Click setup for Cursor, Claude Code, Windsurf, Git hooks, Antigravity")
+    p_init = subparsers.add_parser("init", help="1-Click setup for Cursor, Claude Code, Windsurf, Git hooks, Antigravity, OpenCode")
     p_init.add_argument(
         "--target",
-        choices=["all", "cursor", "claude", "windsurf", "git", "antigravity"],
+        choices=["all", "cursor", "claude", "windsurf", "git", "antigravity", "opencode"],
         default="all",
         help="Target platform to configure (default: all)",
     )
@@ -194,6 +237,19 @@ def build_parser() -> argparse.ArgumentParser:
         help="Workspace root directory (default: .)",
     )
 
+    # launch
+    p_launch = subparsers.add_parser("launch", help="Launch your preferred coding harness with HyperFlash agent active")
+    p_launch.add_argument(
+        "harness",
+        choices=["opencode", "claude", "cursor", "windsurf", "antigravity", "agy"],
+        help="Target harness",
+    )
+    p_launch.add_argument(
+        "extra_args",
+        nargs=argparse.REMAINDER,
+        help="Additional arguments forwarded to harness",
+    )
+
     # mcp
     p_mcp = subparsers.add_parser("mcp", help="Launch stdio MCP server for universal tool integration")
     p_mcp.add_argument(
@@ -288,6 +344,7 @@ def main(argv: Sequence[str] | None = None) -> None:
         "decide": cmd_decide,
         "status": cmd_status,
         "check-elision": cmd_check_elision,
+        "launch": cmd_launch,
     }
 
     handler = dispatch.get(args.command)