fable-engine 1.3.1__tar.gz → 1.3.2__tar.gz

{fable_engine-1.3.1/fable_engine.egg-info → fable_engine-1.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fable-engine
-Version: 1.3.1
+Version: 1.3.2
 Summary: Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server
 Author: REX-codebase
 License: MIT License
@@ -29,7 +29,7 @@ License: MIT License
 Project-URL: Homepage, https://github.com/REX-codebase/fable-mode
 Project-URL: Repository, https://github.com/REX-codebase/fable-mode
 Project-URL: Issues, https://github.com/REX-codebase/fable-mode/issues
-Keywords: mcp,ai-agents,coding-agents,verification,red-team,llm-tools
+Keywords: mcp,model-context-protocol,ai-agents,coding-agents,agent-safety,verification,red-team,llm-tools
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -49,6 +49,8 @@ Dynamic: requires-python
 
 # Fable Mode
 
+<!-- mcp-name: io.github.REX-codebase/fable-mode -->
+
 **Agents that think before they write.**
 
 <br/>
@@ -83,9 +85,7 @@ mechanical, not prompt advice: no timer, no proof, no write access.
   <img src="./assets/flow-simple.svg" width="720" alt="Think → Prove → Attack → Write"/>
 </div>
 
-<div align="center">
-  <video src="https://github.com/REX-codebase/fable-mode/raw/main/assets/launch-film.mp4" width="720" controls muted loop playsinline></video>
-</div>
+https://github.com/user-attachments/assets/27f4f8a2-b1bb-4398-a08c-bc9fd93d69d7
 
 <br/>
 
@@ -114,22 +114,29 @@ red-team swarm for code, and a sealed record of what was verified.
 pip install fable-engine
 ```
 
-Point your agent at the MCP server:
+Or install the MCP server in your editor:
+
+[![Install MCP server in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_server-007ACC?logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22fable-engine%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22fable-engine%3D%3D1.3.2%22%2C%22fable-engine%22%5D%7D)
+[![Add to Cursor](https://img.shields.io/badge/Cursor-Add_MCP_server-black)](cursor://anysphere.cursor-deeplink/mcp/install?name=fable-engine&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJmYWJsZS1lbmdpbmU9PTEuMy4xIiwiZmFibGUtZW5naW5lIl19)
+
+These links configure Fable Engine for AI agents in VS Code Chat or Cursor. They do not install a standalone editor extension. Both use `uvx`, which downloads and runs the pinned PyPI release in an isolated environment.
+
+Point your agent at the MCP server manually:
 
 ```jsonc
-// Claude Code: claude mcp add fable-engine -- python -m fable_engine.server
+// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.2 fable-engine
 // Cursor: ~/.cursor/mcp.json
 {
   "mcpServers": {
     "fable-engine": {
-      "command": "python",
-      "args": ["-m", "fable_engine.server"]
+      "command": "uvx",
+      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
     }
   }
 }
 ```
 
-Python 3.10+, zero runtime dependencies. PyPI package publishing is in progress.
+Python 3.10+, zero runtime dependencies. Published on [PyPI as `fable-engine`](https://pypi.org/project/fable-engine/).
 
 <br/>
 
@@ -155,6 +162,7 @@ Python 3.10+, zero runtime dependencies. PyPI package publishing is in progress.
 - [V1 → V2 migration](./docs/fable-v1-v2-migration.md)
 - [V2 architecture](./docs/fable-v2-architecture.md)
 - [System 3 (experimental)](./docs/system3-architecture.md)
+- [Stop AI coding agents from writing too early](./docs/stop-ai-agents-writing-too-early.md)
 
 <br/>
 

{fable_engine-1.3.1 → fable_engine-1.3.2}/README.md

@@ -6,6 +6,8 @@
 
 # Fable Mode
 
+<!-- mcp-name: io.github.REX-codebase/fable-mode -->
+
 **Agents that think before they write.**
 
 <br/>
@@ -40,9 +42,7 @@ mechanical, not prompt advice: no timer, no proof, no write access.
   <img src="./assets/flow-simple.svg" width="720" alt="Think → Prove → Attack → Write"/>
 </div>
 
-<div align="center">
-  <video src="https://github.com/REX-codebase/fable-mode/raw/main/assets/launch-film.mp4" width="720" controls muted loop playsinline></video>
-</div>
+https://github.com/user-attachments/assets/27f4f8a2-b1bb-4398-a08c-bc9fd93d69d7
 
 <br/>
 
@@ -71,22 +71,29 @@ red-team swarm for code, and a sealed record of what was verified.
 pip install fable-engine
 ```
 
-Point your agent at the MCP server:
+Or install the MCP server in your editor:
+
+[![Install MCP server in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_server-007ACC?logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22fable-engine%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22fable-engine%3D%3D1.3.2%22%2C%22fable-engine%22%5D%7D)
+[![Add to Cursor](https://img.shields.io/badge/Cursor-Add_MCP_server-black)](cursor://anysphere.cursor-deeplink/mcp/install?name=fable-engine&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJmYWJsZS1lbmdpbmU9PTEuMy4xIiwiZmFibGUtZW5naW5lIl19)
+
+These links configure Fable Engine for AI agents in VS Code Chat or Cursor. They do not install a standalone editor extension. Both use `uvx`, which downloads and runs the pinned PyPI release in an isolated environment.
+
+Point your agent at the MCP server manually:
 
 ```jsonc
-// Claude Code: claude mcp add fable-engine -- python -m fable_engine.server
+// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.2 fable-engine
 // Cursor: ~/.cursor/mcp.json
 {
   "mcpServers": {
     "fable-engine": {
-      "command": "python",
-      "args": ["-m", "fable_engine.server"]
+      "command": "uvx",
+      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
     }
   }
 }
 ```
 
-Python 3.10+, zero runtime dependencies. PyPI package publishing is in progress.
+Python 3.10+, zero runtime dependencies. Published on [PyPI as `fable-engine`](https://pypi.org/project/fable-engine/).
 
 <br/>
 
@@ -112,6 +119,7 @@ Python 3.10+, zero runtime dependencies. PyPI package publishing is in progress.
 - [V1 → V2 migration](./docs/fable-v1-v2-migration.md)
 - [V2 architecture](./docs/fable-v2-architecture.md)
 - [System 3 (experimental)](./docs/system3-architecture.md)
+- [Stop AI coding agents from writing too early](./docs/stop-ai-agents-writing-too-early.md)
 
 <br/>
 

fable_engine-1.3.2/docs/stop-ai-agents-writing-too-early.md

@@ -0,0 +1,80 @@
+# Stop AI coding agents from writing too early
+
+AI coding agents often move from a plausible plan to editing files before they have gathered enough evidence. Prompt instructions can ask them to slow down, but a model can reinterpret or skip prompt advice. Fable Mode adds a mechanical gate: the agent can inspect and reason, but it cannot earn write permission until the configured time lock and proof checks pass.
+
+## The failure mode
+
+A typical unsafe loop looks like this:
+
+1. The agent reads one or two files.
+2. It forms a confident hypothesis.
+3. It edits code before testing the hypothesis.
+4. Tests reveal a hidden constraint after the workspace has already changed.
+
+Fable Mode separates research from authority. A session begins with execution locked. Claims need evidence receipts, implementation faces adversarial review, and the final record shows what was checked.
+
+## Install the MCP server
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) so your MCP client can run the package without changing your global Python environment.
+
+```bash
+uvx --from fable-engine==1.3.2 fable-engine
+```
+
+For Claude Code:
+
+```bash
+claude mcp add fable-engine -- uvx --from fable-engine==1.3.2 fable-engine
+```
+
+For an MCP client that uses JSON configuration:
+
+```json
+{
+  "mcpServers": {
+    "fable-engine": {
+      "command": "uvx",
+      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
+    }
+  }
+}
+```
+
+## What the gate changes
+
+Fable Mode uses four stages:
+
+- **Think:** keep execution locked while the agent gathers context and specifies invariants.
+- **Prove:** attach evidence to claims instead of treating confidence as proof.
+- **Attack:** try to break the proposed change through adversarial checks.
+- **Write:** unlock only after the earlier gates pass.
+
+The minimum time budget is two minutes. That is a floor, not a claim that two minutes is enough for every task. Use a longer budget when the codebase, blast radius, or uncertainty is larger.
+
+## When to use it
+
+Fable Mode fits work where premature edits are expensive:
+
+- migrations and dependency upgrades;
+- security-sensitive changes;
+- refactors across unfamiliar code;
+- changes with hidden compatibility constraints;
+- autonomous coding runs where no person reviews every intermediate step.
+
+It is not a guarantee of correct code. It makes the path to write access explicit and checkable, so a coding agent cannot treat a good-sounding plan as permission to edit.
+
+## Verify the server before connecting a client
+
+The package has no runtime dependencies. You can confirm the pinned release and inspect its MCP initialization response in an isolated environment before adding it to an editor or agent:
+
+```bash
+uvx --from fable-engine==1.3.2 fable-engine
+```
+
+The server communicates over standard input and output. MCP clients start and manage that process for you after configuration.
+
+## Next steps
+
+- Read the [V2 architecture](./fable-v2-architecture.md).
+- Review the [V1 to V2 migration guide](./fable-v1-v2-migration.md).
+- Inspect the source and tests in the [Fable Mode repository](https://github.com/REX-codebase/fable-mode).

{fable_engine-1.3.1 → fable_engine-1.3.2}/fable_engine/scrapers/base.py

@@ -25,7 +25,7 @@ from typing import Any, Dict, List, Optional, Tuple
 
 logger = logging.getLogger("fable-engine.scrapers.base")
 
-USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 FableResearch/1.3.0"
+USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 FableResearch/1.3.2"
 
 MAX_RETRY_DELAY_SECONDS = 10.0
 

{fable_engine-1.3.1 → fable_engine-1.3.2}/fable_engine/server.py

@@ -237,7 +237,7 @@ def main():
                     },
                     "serverInfo": {
                         "name": "fable-engine",
-                        "version": "1.3.0"
+                        "version": "1.3.2"
                     }
                 }
             })

{fable_engine-1.3.1 → fable_engine-1.3.2}/fable_engine/session.py

@@ -1530,7 +1530,7 @@ class FableSession:
     def to_dict(self) -> Dict[str, Any]:
         """Serializes session to dictionary."""
         return {
-            "version": "1.3.0",
+            "version": "1.3.2",
             "session_name": self.session_name,
             "session_id": self.session_id,
             "objective": self.objective,

{fable_engine-1.3.1 → fable_engine-1.3.2/fable_engine.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fable-engine
-Version: 1.3.1
+Version: 1.3.2
 Summary: Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server
 Author: REX-codebase
 License: MIT License
@@ -29,7 +29,7 @@ License: MIT License
 Project-URL: Homepage, https://github.com/REX-codebase/fable-mode
 Project-URL: Repository, https://github.com/REX-codebase/fable-mode
 Project-URL: Issues, https://github.com/REX-codebase/fable-mode/issues
-Keywords: mcp,ai-agents,coding-agents,verification,red-team,llm-tools
+Keywords: mcp,model-context-protocol,ai-agents,coding-agents,agent-safety,verification,red-team,llm-tools
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -49,6 +49,8 @@ Dynamic: requires-python
 
 # Fable Mode
 
+<!-- mcp-name: io.github.REX-codebase/fable-mode -->
+
 **Agents that think before they write.**
 
 <br/>
@@ -83,9 +85,7 @@ mechanical, not prompt advice: no timer, no proof, no write access.
   <img src="./assets/flow-simple.svg" width="720" alt="Think → Prove → Attack → Write"/>
 </div>
 
-<div align="center">
-  <video src="https://github.com/REX-codebase/fable-mode/raw/main/assets/launch-film.mp4" width="720" controls muted loop playsinline></video>
-</div>
+https://github.com/user-attachments/assets/27f4f8a2-b1bb-4398-a08c-bc9fd93d69d7
 
 <br/>
 
@@ -114,22 +114,29 @@ red-team swarm for code, and a sealed record of what was verified.
 pip install fable-engine
 ```
 
-Point your agent at the MCP server:
+Or install the MCP server in your editor:
+
+[![Install MCP server in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_server-007ACC?logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22fable-engine%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22fable-engine%3D%3D1.3.2%22%2C%22fable-engine%22%5D%7D)
+[![Add to Cursor](https://img.shields.io/badge/Cursor-Add_MCP_server-black)](cursor://anysphere.cursor-deeplink/mcp/install?name=fable-engine&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJmYWJsZS1lbmdpbmU9PTEuMy4xIiwiZmFibGUtZW5naW5lIl19)
+
+These links configure Fable Engine for AI agents in VS Code Chat or Cursor. They do not install a standalone editor extension. Both use `uvx`, which downloads and runs the pinned PyPI release in an isolated environment.
+
+Point your agent at the MCP server manually:
 
 ```jsonc
-// Claude Code: claude mcp add fable-engine -- python -m fable_engine.server
+// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.2 fable-engine
 // Cursor: ~/.cursor/mcp.json
 {
   "mcpServers": {
     "fable-engine": {
-      "command": "python",
-      "args": ["-m", "fable_engine.server"]
+      "command": "uvx",
+      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
     }
   }
 }
 ```
 
-Python 3.10+, zero runtime dependencies. PyPI package publishing is in progress.
+Python 3.10+, zero runtime dependencies. Published on [PyPI as `fable-engine`](https://pypi.org/project/fable-engine/).
 
 <br/>
 
@@ -155,6 +162,7 @@ Python 3.10+, zero runtime dependencies. PyPI package publishing is in progress.
 - [V1 → V2 migration](./docs/fable-v1-v2-migration.md)
 - [V2 architecture](./docs/fable-v2-architecture.md)
 - [System 3 (experimental)](./docs/system3-architecture.md)
+- [Stop AI coding agents from writing too early](./docs/stop-ai-agents-writing-too-early.md)
 
 <br/>
 

{fable_engine-1.3.1 → fable_engine-1.3.2}/fable_engine.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ pyproject.toml
 setup.py
 docs/fable-v1-v2-migration.md
 docs/fable-v2-architecture.md
+docs/stop-ai-agents-writing-too-early.md
 docs/system3-architecture.md
 fable_engine/__init__.py
 fable_engine/browser.py

{fable_engine-1.3.1 → fable_engine-1.3.2}/fable_mode/__init__.py

@@ -1,3 +1,3 @@
 """Fable Mode portable runtime and transactional installer."""
 
-__version__ = "1.3.0"
+__version__ = "1.3.2"

{fable_engine-1.3.1 → fable_engine-1.3.2}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fable-engine"
-version = "1.3.1"
+version = "1.3.2"
 description = "Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server"
 readme = "README.md"
 authors = [{ name = "REX-codebase" }]
 license = { file = "LICENSE" }
-keywords = ["mcp", "ai-agents", "coding-agents", "verification", "red-team", "llm-tools"]
+keywords = ["mcp", "model-context-protocol", "ai-agents", "coding-agents", "agent-safety", "verification", "red-team", "llm-tools"]
 requires-python = ">=3.10"
 dependencies = []
 classifiers = [

{fable_engine-1.3.1 → fable_engine-1.3.2}/setup.py

@@ -1,9 +1,15 @@
+from pathlib import Path
+
 from setuptools import setup, find_packages
 
+README = (Path(__file__).parent / "README.md").read_text(encoding="utf-8")
+
 setup(
     name="fable-engine",
-    version="1.3.0",
-    description="Deterministic System 2 Cognitive Engine & Mechanical Time-Lock MCP Server for Antigravity",
+    version="1.3.2",
+    description="Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server",
+    long_description=README,
+    long_description_content_type="text/markdown",
     license="MIT",
     packages=find_packages(),
     py_modules=["fable_mode_entry", "fable_compressor"],