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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fable-engine
-Version: 1.3.2
+Version: 1.3.4
 Summary: Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server
 Author: REX-codebase
 License: MIT License
@@ -63,7 +63,7 @@ Dynamic: requires-python
  
 <img src="https://img.shields.io/badge/dependencies-0-black" alt="Zero Dependencies"/>
 &nbsp;
-<img src="https://img.shields.io/badge/tests-473%20passing-black" alt="473 tests passing"/>
+<img src="https://img.shields.io/badge/tests-490%20passing-black" alt="490 tests passing"/>
 
 <br/><br/>
 
@@ -116,21 +116,21 @@ pip install fable-engine
 
 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)
+[![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.4%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=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJmYWJsZS1lbmdpbmU9PTEuMy4zIiwiZmFibGUtZW5naW5lIl19)
 
 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 -- uvx --from fable-engine==1.3.2 fable-engine
+// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.4 fable-engine
 // Cursor: ~/.cursor/mcp.json
 {
   "mcpServers": {
     "fable-engine": {
       "command": "uvx",
-      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
+      "args": ["--from", "fable-engine==1.3.4", "fable-engine"]
     }
   }
 }
@@ -140,6 +140,27 @@ Python 3.10+, zero runtime dependencies. Published on [PyPI as `fable-engine`](h
 
 <br/>
 
+### Optional: the Agent Skill
+
+Installing `fable-engine` gives your agent the MCP tools. It does not install
+or activate the Fable Mode Agent Skill - the prompt-side workflow in
+[`skills/fable-mode`](./skills/fable-mode/SKILL.md). Nothing in the package
+activates those instructions on its own; the skill is always a separate,
+explicit opt-in.
+
+The complete skill tree ships inside the wheel. To install it into your
+project's skills directory (the cross-client `.agents/skills/` convention):
+
+```bash
+uvx --from fable-engine==1.3.4 fable-mode install-skill --yes
+```
+
+This copies the skill to `.agents/skills/fable-mode`. Preview first with
+`--dry-run`, choose another location with `--target <dir>`, and reload your
+agent afterwards so it picks up the skill.
+
+<br/>
+
 ### How it works
 
 1. **Think** — Time-locked deliberation. The agent cannot write until the timer ends.

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

@@ -20,7 +20,7 @@
  
 <img src="https://img.shields.io/badge/dependencies-0-black" alt="Zero Dependencies"/>
 &nbsp;
-<img src="https://img.shields.io/badge/tests-473%20passing-black" alt="473 tests passing"/>
+<img src="https://img.shields.io/badge/tests-490%20passing-black" alt="490 tests passing"/>
 
 <br/><br/>
 
@@ -73,21 +73,21 @@ pip install fable-engine
 
 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)
+[![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.4%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=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJmYWJsZS1lbmdpbmU9PTEuMy4zIiwiZmFibGUtZW5naW5lIl19)
 
 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 -- uvx --from fable-engine==1.3.2 fable-engine
+// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.4 fable-engine
 // Cursor: ~/.cursor/mcp.json
 {
   "mcpServers": {
     "fable-engine": {
       "command": "uvx",
-      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
+      "args": ["--from", "fable-engine==1.3.4", "fable-engine"]
     }
   }
 }
@@ -97,6 +97,27 @@ Python 3.10+, zero runtime dependencies. Published on [PyPI as `fable-engine`](h
 
 <br/>
 
+### Optional: the Agent Skill
+
+Installing `fable-engine` gives your agent the MCP tools. It does not install
+or activate the Fable Mode Agent Skill - the prompt-side workflow in
+[`skills/fable-mode`](./skills/fable-mode/SKILL.md). Nothing in the package
+activates those instructions on its own; the skill is always a separate,
+explicit opt-in.
+
+The complete skill tree ships inside the wheel. To install it into your
+project's skills directory (the cross-client `.agents/skills/` convention):
+
+```bash
+uvx --from fable-engine==1.3.4 fable-mode install-skill --yes
+```
+
+This copies the skill to `.agents/skills/fable-mode`. Preview first with
+`--dry-run`, choose another location with `--target <dir>`, and reload your
+agent afterwards so it picks up the skill.
+
+<br/>
+
 ### How it works
 
 1. **Think** — Time-locked deliberation. The agent cannot write until the timer ends.

{fable_engine-1.3.2 → fable_engine-1.3.4}/docs/stop-ai-agents-writing-too-early.md

@@ -18,13 +18,13 @@ Fable Mode separates research from authority. A session begins with execution lo
 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
+uvx --from fable-engine==1.3.4 fable-engine
 ```
 
 For Claude Code:
 
 ```bash
-claude mcp add fable-engine -- uvx --from fable-engine==1.3.2 fable-engine
+claude mcp add fable-engine -- uvx --from fable-engine==1.3.4 fable-engine
 ```
 
 For an MCP client that uses JSON configuration:
@@ -34,7 +34,7 @@ For an MCP client that uses JSON configuration:
   "mcpServers": {
     "fable-engine": {
       "command": "uvx",
-      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
+      "args": ["--from", "fable-engine==1.3.4", "fable-engine"]
     }
   }
 }
@@ -68,7 +68,7 @@ It is not a guarantee of correct code. It makes the path to write access explici
 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
+uvx --from fable-engine==1.3.4 fable-engine
 ```
 
 The server communicates over standard input and output. MCP clients start and manage that process for you after configuration.

{fable_engine-1.3.2 → fable_engine-1.3.4}/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.2"
+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.4"
 
 MAX_RETRY_DELAY_SECONDS = 10.0
 

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

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

{fable_engine-1.3.2 → fable_engine-1.3.4}/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.2",
+            "version": "1.3.4",
             "session_name": self.session_name,
             "session_id": self.session_id,
             "objective": self.objective,

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fable-engine
-Version: 1.3.2
+Version: 1.3.4
 Summary: Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server
 Author: REX-codebase
 License: MIT License
@@ -63,7 +63,7 @@ Dynamic: requires-python
  
 <img src="https://img.shields.io/badge/dependencies-0-black" alt="Zero Dependencies"/>
 &nbsp;
-<img src="https://img.shields.io/badge/tests-473%20passing-black" alt="473 tests passing"/>
+<img src="https://img.shields.io/badge/tests-490%20passing-black" alt="490 tests passing"/>
 
 <br/><br/>
 
@@ -116,21 +116,21 @@ pip install fable-engine
 
 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)
+[![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.4%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=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJmYWJsZS1lbmdpbmU9PTEuMy4zIiwiZmFibGUtZW5naW5lIl19)
 
 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 -- uvx --from fable-engine==1.3.2 fable-engine
+// Claude Code: claude mcp add fable-engine -- uvx --from fable-engine==1.3.4 fable-engine
 // Cursor: ~/.cursor/mcp.json
 {
   "mcpServers": {
     "fable-engine": {
       "command": "uvx",
-      "args": ["--from", "fable-engine==1.3.2", "fable-engine"]
+      "args": ["--from", "fable-engine==1.3.4", "fable-engine"]
     }
   }
 }
@@ -140,6 +140,27 @@ Python 3.10+, zero runtime dependencies. Published on [PyPI as `fable-engine`](h
 
 <br/>
 
+### Optional: the Agent Skill
+
+Installing `fable-engine` gives your agent the MCP tools. It does not install
+or activate the Fable Mode Agent Skill - the prompt-side workflow in
+[`skills/fable-mode`](./skills/fable-mode/SKILL.md). Nothing in the package
+activates those instructions on its own; the skill is always a separate,
+explicit opt-in.
+
+The complete skill tree ships inside the wheel. To install it into your
+project's skills directory (the cross-client `.agents/skills/` convention):
+
+```bash
+uvx --from fable-engine==1.3.4 fable-mode install-skill --yes
+```
+
+This copies the skill to `.agents/skills/fable-mode`. Preview first with
+`--dry-run`, choose another location with `--target <dir>`, and reload your
+agent afterwards so it picks up the skill.
+
+<br/>
+
 ### How it works
 
 1. **Think** — Time-locked deliberation. The agent cannot write until the timer ends.

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

@@ -47,6 +47,7 @@ fable_mode/launcher.py
 fable_mode/manifest.py
 fable_mode/resources.json
 fable_mode/safety.py
+fable_mode/skill_bundle.py
 fable_v2/__init__.py
 fable_v2/adapters.py
 fable_v2/execution_broker.py
@@ -147,6 +148,7 @@ tests/test_scrapers.py
 tests/test_server_actions.py
 tests/test_server_frontier_actions.py
 tests/test_server_protocol.py
+tests/test_skill_distribution.py
 tests/test_stealth_browser.py
 tests/test_system3.py
 tests/test_system3_deep_integration.py

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

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

{fable_engine-1.3.2 → fable_engine-1.3.4}/fable_mode/installer.py

@@ -125,7 +125,18 @@ def _source_path(root: Path, rel: str) -> Path:
         if checkout.is_file():
             return checkout
         return _license_path()
-    return root / rel
+    candidate = root / rel
+    if candidate.exists() or not rel.startswith("skills/"):
+        return candidate
+    # Wheels carry the skill tree as fable_mode package data, not beside
+    # site-packages, so portable installs from a wheel resolve it there.
+    try:
+        packaged = Path(resources.files("fable_mode").joinpath(rel))
+        if packaged.exists():
+            return packaged
+    except (OSError, TypeError, ValueError):
+        pass
+    return candidate
 
 
 @dataclass

{fable_engine-1.3.2 → fable_engine-1.3.4}/fable_mode/launcher.py

@@ -17,6 +17,7 @@ from pathlib import Path
 from .adapters import (RegistrationError, cleanup_recorded_registrations,
                        detect_hosts, register_hosts, validate_registration_record)
 from .installer import Installer, InstallError, verify_installation
+from .skill_bundle import SKILL_NAME, install_skill
 from .manifest import ALLOWED_FILES, validate_manifest
 from . import __version__
 
@@ -251,7 +252,7 @@ def _is_frozen() -> bool:
 def _parser() -> argparse.ArgumentParser:
     p = argparse.ArgumentParser(prog="fable-mode")
     p.add_argument("--version", action="version", version=__version__)
-    p.add_argument("mode", nargs="?", choices=("install", "serve", "verify", "version", "uninstall"), default="install")
+    p.add_argument("mode", nargs="?", choices=("install", "serve", "verify", "version", "uninstall", "install-skill"), default="install")
     p.add_argument("--yes", action="store_true", help="confirm unattended installation")
     p.add_argument("--register-hosts", action="store_true")
     p.add_argument("--aliases", action="store_true", help="also probe legacy cc/antigravity aliases")
@@ -259,6 +260,8 @@ def _parser() -> argparse.ArgumentParser:
     p.add_argument("--state-dir")
     p.add_argument("--install-dir")
     p.add_argument("--workspace")
+    p.add_argument("--target", help="skill destination directory (default: .agents/skills/fable-mode)")
+    p.add_argument("--force", action="store_true", help="overwrite foreign or locally edited skill files")
     return p
 
 
@@ -302,6 +305,31 @@ def main(argv: list[str] | None = None) -> int:
         except (OSError, RuntimeError, ValueError) as exc:
             print(f"serve: {exc}", file=sys.stderr)
             return 1
+    if args.mode == "install-skill":
+        target = (Path(args.target).expanduser() if args.target
+                  else Path.cwd() / ".agents" / "skills" / SKILL_NAME)
+        if not args.dry_run and not args.yes:
+            if not sys.stdin.isatty():
+                print("install-skill requires --yes in unattended mode", file=sys.stderr)
+                return 2
+            try:
+                confirmed = input(f"Install the Fable Mode Agent Skill to {target}? [y/N] ").strip().lower() in {"y", "yes"}
+            except (EOFError, KeyboardInterrupt):
+                confirmed = False
+            if not confirmed:
+                print("Skill installation cancelled.")
+                return 0
+        try:
+            result = install_skill(target, force=args.force, dry_run=args.dry_run)
+        except InstallError as exc:
+            print(f"install-skill: {exc}", file=sys.stderr)
+            return 1
+        verb = "Would install" if result.dry_run else "Installed"
+        changes = f"{len(result.installed)} new, {len(result.updated)} updated, {len(result.unchanged)} unchanged"
+        print(f"{verb} the Fable Mode Agent Skill ({result.planned} files: {changes}) to {result.target}")
+        if not result.dry_run:
+            print("Restart or reload your agent to pick up the skill.")
+        return 0
     installer = Installer(Path(args.install_dir) if args.install_dir else None)
     if args.mode == "verify":
         return verify(installer)

{fable_engine-1.3.2 → fable_engine-1.3.4}/fable_mode/manifest.py

@@ -15,6 +15,7 @@ ALLOWED_FILES: tuple[str, ...] = (
     "fable_mode/launcher.py",
     "fable_mode/manifest.py",
     "fable_mode/safety.py",
+    "fable_mode/skill_bundle.py",
     "fable_mode/resources.json",
     "fable_engine/__init__.py",
     "fable_engine/browser.py",
@@ -116,6 +117,11 @@ ALLOWED_FILES: tuple[str, ...] = (
     "skills/fable-mode/cortex/frontend_design.md",
     "skills/fable-mode/cortex/research.md",
     "skills/fable-mode/cortex/concurrency.md",
+    "skills/fable-mode/cortex/process.md",
+    "skills/fable-mode/cortex/security.md",
+    "skills/fable-mode/cortex/system.md",
+    "skills/fable-mode/cortex/target.md",
+    "skills/fable-mode/cortex/synaptic_matrix.json",
     "LICENSE",
 )
 

{fable_engine-1.3.2 → fable_engine-1.3.4}/fable_mode/resources.json

@@ -8,6 +8,7 @@
     "fable_mode/launcher.py",
     "fable_mode/manifest.py",
     "fable_mode/safety.py",
+    "fable_mode/skill_bundle.py",
     "fable_mode/resources.json",
     "fable_engine/__init__.py",
     "fable_engine/browser.py",
@@ -109,6 +110,11 @@
     "skills/fable-mode/cortex/frontend_design.md",
     "skills/fable-mode/cortex/research.md",
     "skills/fable-mode/cortex/concurrency.md",
+    "skills/fable-mode/cortex/process.md",
+    "skills/fable-mode/cortex/security.md",
+    "skills/fable-mode/cortex/system.md",
+    "skills/fable-mode/cortex/target.md",
+    "skills/fable-mode/cortex/synaptic_matrix.json",
     "LICENSE"
   ]
-}
+}

fable_engine-1.3.4/fable_mode/skill_bundle.py

@@ -0,0 +1,163 @@
+"""Explicit, opt-in installation of the bundled Fable Mode Agent Skill.
+
+The MCP server and the Agent Skill are separate artifacts: connecting the
+server never installs or activates skill instructions.  The canonical
+``skills/fable-mode`` tree ships inside the wheel as package data, and this
+module copies it into a caller-chosen skills directory - by default the
+cross-client ``.agents/skills/fable-mode`` convention - only when explicitly
+asked through ``fable-mode install-skill``.
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import shutil
+import stat
+from dataclasses import dataclass, field
+from importlib import resources
+from pathlib import Path
+
+from . import __version__
+from .installer import InstallError, _reject_path
+from .manifest import source_root
+
+SKILL_NAME = "fable-mode"
+SKILL_MARKER = ".fable-skill-install.json"
+SKILL_REL = Path("skills") / SKILL_NAME
+
+
+def bundled_skill_root() -> Path:
+    """Locate the canonical skill tree in a source checkout or an installed wheel."""
+    checkout = source_root() / SKILL_REL
+    try:
+        if checkout.is_dir() and not checkout.is_symlink():
+            return checkout
+    except OSError:
+        pass
+    try:
+        candidate = Path(resources.files("fable_mode").joinpath(SKILL_REL.as_posix()))
+        if candidate.is_dir() and not candidate.is_symlink():
+            return candidate
+    except (FileNotFoundError, OSError, TypeError, ValueError):
+        pass
+    raise InstallError("the bundled Fable Mode Agent Skill is unavailable in this installation")
+
+
+def _hash(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(1024 * 1024), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def _skill_files(root: Path) -> dict[str, Path]:
+    files: dict[str, Path] = {}
+    for path in sorted(root.rglob("*")):
+        if path.is_dir():
+            continue
+        rel = path.relative_to(root).as_posix()
+        parts = Path(rel)
+        if parts.is_absolute() or ".." in parts.parts:
+            raise InstallError(f"unsafe bundled skill path: {rel}")
+        if path.is_symlink() or not path.is_file():
+            raise InstallError(f"unsafe bundled skill entry: {rel}")
+        files[rel] = path
+    if "SKILL.md" not in files:
+        raise InstallError("the bundled skill tree is incomplete: SKILL.md is missing")
+    return files
+
+
+def _read_marker(target: Path) -> dict | None:
+    marker = target / SKILL_MARKER
+    try:
+        if not marker.is_file() or marker.is_symlink():
+            return None
+        data = json.loads(marker.read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return None
+    if not isinstance(data, dict) or data.get("format") != 1 or data.get("product") != SKILL_NAME:
+        return None
+    if not isinstance(data.get("files"), dict):
+        return None
+    return data
+
+
+@dataclass
+class SkillInstallResult:
+    target: Path
+    dry_run: bool
+    installed: list[str] = field(default_factory=list)
+    updated: list[str] = field(default_factory=list)
+    unchanged: list[str] = field(default_factory=list)
+
+    @property
+    def planned(self) -> int:
+        return len(self.installed) + len(self.updated) + len(self.unchanged)
+
+
+def install_skill(target: Path, *, force: bool = False, dry_run: bool = False) -> SkillInstallResult:
+    """Copy the bundled skill tree into ``target`` with ownership tracking.
+
+    Idempotent: byte-identical files are left untouched.  Files this installer
+    previously wrote are upgraded in place; anything else (a foreign directory
+    or local edits) requires ``force`` so a skill install can never silently
+    overwrite user content.
+    """
+    source = bundled_skill_root()
+    files = _skill_files(source)
+    target = Path(target).expanduser().absolute()
+    _reject_path(target, allow_missing=True)
+    if target.exists() and (target.is_symlink() or not target.is_dir()):
+        raise InstallError("skill target is not a real directory")
+    marker = _read_marker(target) if target.is_dir() else None
+    if target.is_dir() and marker is None and any(target.iterdir()) and not force:
+        raise InstallError(
+            f"{target} exists and was not installed by fable-mode; pass --force to adopt it")
+    recorded = (marker or {}).get("files", {})
+    result = SkillInstallResult(target=target, dry_run=dry_run)
+    conflicts: list[str] = []
+    for rel, src in files.items():
+        dst = target / Path(rel)
+        if not dst.exists():
+            result.installed.append(rel)
+            continue
+        if dst.is_symlink() or not dst.is_file():
+            raise InstallError(f"unsafe existing path in skill target: {rel}")
+        new_hash, current_hash = _hash(src), _hash(dst)
+        if current_hash == new_hash:
+            result.unchanged.append(rel)
+        elif (marker is not None and recorded.get(rel) == current_hash) or force:
+            result.updated.append(rel)
+        else:
+            conflicts.append(rel)
+    if conflicts:
+        listing = ", ".join(conflicts[:5]) + (", ..." if len(conflicts) > 5 else "")
+        raise InstallError(f"local modifications would be overwritten ({listing}); pass --force to overwrite")
+    if dry_run:
+        return result
+    target.mkdir(parents=True, exist_ok=True)
+    written: dict[str, str] = {}
+    for rel in result.installed + result.updated:
+        src = files[rel]
+        dst = target / Path(rel)
+        dst.parent.mkdir(parents=True, exist_ok=True)
+        if os.name != "nt":
+            cursor = dst.parent
+            while cursor != target and cursor != cursor.parent:
+                os.chmod(cursor, 0o700)
+                cursor = cursor.parent
+        shutil.copyfile(src, dst, follow_symlinks=False)
+        os.chmod(dst, 0o600)
+        written[rel] = _hash(dst)
+    for rel in result.unchanged:
+        written[rel] = _hash(target / Path(rel))
+    if os.name != "nt":
+        os.chmod(target, 0o700)
+    marker_path = target / SKILL_MARKER
+    marker_path.write_text(json.dumps(
+        {"format": 1, "product": SKILL_NAME, "version": __version__, "files": written},
+        indent=2, sort_keys=True) + "\n", encoding="utf-8")
+    os.chmod(marker_path, 0o600)
+    return result

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fable-engine"
-version = "1.3.2"
+version = "1.3.4"
 description = "Independent deterministic System 2 cognitive engine and mechanical time-lock MCP server"
 readme = "README.md"
 authors = [{ name = "REX-codebase" }]

fable_engine-1.3.4/setup.py

@@ -0,0 +1,70 @@
+import shutil
+from pathlib import Path
+
+from setuptools import setup, find_packages
+from setuptools.command.build_py import build_py as _build_py
+
+README = (Path(__file__).parent / "README.md").read_text(encoding="utf-8")
+
+_SKILL_SOURCE = Path(__file__).resolve().parent / "skills" / "fable-mode"
+
+
+class build_py(_build_py):
+    """Bundle the canonical Agent Skill tree into the wheel as package data.
+
+    ``pip`` and ``uvx`` install the wheel, so the explicit
+    ``fable-mode install-skill`` flow can only work for those users when the
+    skill tree travels inside the ``fable_mode`` package, not just in the
+    sdist.  The checkout tree stays the single source of truth; it is copied
+    into the build here.
+    """
+
+    def run(self):
+        super().run()
+        if getattr(self, "editable_mode", False):
+            # Editable installs resolve the skill tree from the source
+            # checkout, so no staged copy is needed.
+            return
+        copied = 0
+        destination_root = Path(self.build_lib) / "fable_mode" / "skills" / "fable-mode"
+        for source in sorted(_SKILL_SOURCE.rglob("*")):
+            if not source.is_file():
+                continue
+            destination = destination_root / source.relative_to(_SKILL_SOURCE)
+            destination.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copyfile(source, destination)
+            copied += 1
+        if copied == 0:
+            raise RuntimeError("canonical skill tree is missing from the source tree")
+
+
+setup(
+    name="fable-engine",
+    version="1.3.4",
+    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"],
+    package_data={"fable_mode": ["resources.json", "LICENSE"], "fable_engine": ["fable_session.json"]},
+    python_requires=">=3.10",
+    install_requires=[],
+    cmdclass={"build_py": build_py},
+    entry_points={
+        "console_scripts": [
+            # Portable package-aware installer/runtime.
+            "fable-mode=fable_mode.launcher:main",
+            # Legacy V1 MCP entry point.
+            "fable-engine=fable_engine.server:main",
+            "fable-v1=fable_engine.server:main",
+            # V2 process execution boundary.
+            "fable-v2-broker=fable_v2.execution_broker:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)