ifcraftcorpus 1.2.1__py3-none-any.whl → 1.3.0__py3-none-any.whl

ifcraftcorpus/cli.py

@@ -125,7 +125,10 @@ def cmd_embeddings_status(args: argparse.Namespace) -> int:
         status = "✓ Available" if available else "✗ Not available"
         print(f"{name:20} {status}")
         if available:
-            print(f"{'':20} Model: {provider.model} ({provider.dimension}d)")
+            extra_info = ""
+            if hasattr(provider, "cpu_only") and provider.cpu_only:
+                extra_info = " [CPU-only]"
+            print(f"{'':20} Model: {provider.model} ({provider.dimension}d){extra_info}")
 
     # Auto-detect
     print("\n=== Auto-Detection ===\n")
@@ -164,9 +167,10 @@ def cmd_embeddings_build(args: argparse.Namespace) -> int:
 
     # Get provider
     provider: EmbeddingProvider | None = None
+    cpu_only = getattr(args, "cpu_only", False)
     if args.provider:
         if args.provider == "ollama":
-            provider = OllamaEmbeddings(model=args.model, host=args.ollama_host)
+            provider = OllamaEmbeddings(model=args.model, host=args.ollama_host, cpu_only=cpu_only)
         elif args.provider == "openai":
             provider = OpenAIEmbeddings(model=args.model, api_key=args.openai_key)
         elif args.provider in ("sentence-transformers", "st", "local"):
@@ -175,7 +179,7 @@ def cmd_embeddings_build(args: argparse.Namespace) -> int:
             print(f"Unknown provider: {args.provider}", file=sys.stderr)
             return 1
     else:
-        provider = get_embedding_provider(model=args.model)
+        provider = get_embedding_provider(model=args.model, cpu_only=cpu_only)
 
     if not provider:
         print("No embedding provider available.", file=sys.stderr)
@@ -186,13 +190,19 @@ def cmd_embeddings_build(args: argparse.Namespace) -> int:
         print(f"Provider {provider.provider_name} is not available.", file=sys.stderr)
         return 1
 
+    # Show CPU-only status for Ollama
+    cpu_only_status = ""
+    if hasattr(provider, "cpu_only") and provider.cpu_only:
+        cpu_only_status = " (CPU-only)"
+
     logger.info(
-        "CLI embeddings build provider=%s model=%s output=%s",
+        "CLI embeddings build provider=%s model=%s output=%s cpu_only=%s",
         provider.provider_name,
         provider.model,
         args.output,
+        getattr(provider, "cpu_only", False),
     )
-    print(f"Using provider: {provider.provider_name}")
+    print(f"Using provider: {provider.provider_name}{cpu_only_status}")
     print(f"Model: {provider.model} ({provider.dimension}d)")
 
     # Build embeddings
@@ -308,6 +318,12 @@ def main() -> int:
     )
     emb_build.add_argument("--ollama-host", help="Ollama host URL")
     emb_build.add_argument("--openai-key", help="OpenAI API key")
+    emb_build.add_argument(
+        "--cpu-only",
+        action="store_true",
+        help="Force CPU-only inference for Ollama (num_gpu=0). "
+        "Useful when GPU is under VRAM pressure.",
+    )
     emb_build.set_defaults(func=cmd_embeddings_build)
 
     args = parser.parse_args()

ifcraftcorpus/mcp_server.py

@@ -367,11 +367,15 @@ def embeddings_status() -> dict[str, Any]:
             try:
                 provider = cls()
                 available = provider.check_availability()
-                result["providers"][name] = {
+                provider_info: dict[str, Any] = {
                     "available": available,
                     "model": provider.model if available else None,
                     "dimension": provider.dimension if available else None,
                 }
+                # Add cpu_only info for Ollama
+                if hasattr(provider, "cpu_only"):
+                    provider_info["cpu_only"] = provider.cpu_only
+                result["providers"][name] = provider_info
             except Exception as exc:  # pragma: no cover - defensive logging
                 logger.warning("Failed to inspect embedding provider %s: %s", name, exc)
                 result["providers"][name] = {"available": False, "error": "import_failed"}
@@ -409,6 +413,8 @@ def embeddings_status() -> dict[str, Any]:
 @tool
 def build_embeddings(
     provider: str | None = None,
+    model: str | None = None,
+    cpu_only: bool | None = None,
     force: bool = False,
 ) -> dict[str, Any]:
     """Build or rebuild the embedding index for semantic search.
@@ -420,6 +426,11 @@ def build_embeddings(
         provider: Embedding provider to use: "ollama", "openai", or
                  "sentence_transformers". If None, auto-detects the best
                  available provider.
+        model: Embedding model name override. If None, uses provider default
+              or OLLAMA_MODEL env var for Ollama.
+        cpu_only: For Ollama provider, force CPU-only inference (num_gpu=0).
+                 Useful when GPU is under VRAM pressure. If None, reads from
+                 OLLAMA_CPU_ONLY env var.
         force: If True, rebuild even if embeddings already exist.
 
     Returns:
@@ -427,15 +438,23 @@ def build_embeddings(
 
     Note:
         Ollama requires a running Ollama server (configure with OLLAMA_HOST env).
+        Set OLLAMA_CPU_ONLY=true to force CPU inference.
         OpenAI requires OPENAI_API_KEY environment variable.
         SentenceTransformers requires the sentence-transformers package.
     """
     global _corpus
 
-    logger.info("build_embeddings requested provider=%s force=%s", provider, force)
+    logger.info(
+        "build_embeddings requested provider=%s model=%s cpu_only=%s force=%s",
+        provider,
+        model,
+        cpu_only,
+        force,
+    )
 
     try:
         from ifcraftcorpus.providers import (
+            EmbeddingProvider,
             OllamaEmbeddings,
             OpenAIEmbeddings,
             SentenceTransformersEmbeddings,
@@ -449,21 +468,22 @@ def build_embeddings(
         }
 
     # Get provider
-    embedding_provider = None
+    embedding_provider: EmbeddingProvider | None = None
     if provider:
-        provider_map = {
-            "ollama": OllamaEmbeddings,
-            "openai": OpenAIEmbeddings,
-            "sentence_transformers": SentenceTransformersEmbeddings,
-        }
-        if provider not in provider_map:
+        provider_lower = provider.lower()
+        if provider_lower == "ollama":
+            embedding_provider = OllamaEmbeddings(model=model, cpu_only=cpu_only)
+        elif provider_lower == "openai":
+            embedding_provider = OpenAIEmbeddings(model=model)
+        elif provider_lower == "sentence_transformers":
+            embedding_provider = SentenceTransformersEmbeddings(model=model)
+        else:
             logger.warning("Unknown embeddings provider requested: %s", provider)
             return {
                 "error": f"Unknown provider: {provider}. Use: ollama, openai, sentence_transformers"
             }
-        embedding_provider = provider_map[provider]()
     else:
-        embedding_provider = get_embedding_provider()
+        embedding_provider = get_embedding_provider(model=model, cpu_only=cpu_only)
 
     if not embedding_provider:
         logger.warning("No embedding provider available for build request")
@@ -506,7 +526,7 @@ def build_embeddings(
     # Update global corpus to use new embeddings
     _corpus = Corpus(embeddings_path=embeddings_path)
 
-    return {
+    result = {
         "status": "success",
         "items_embedded": count,
         "provider": embedding_provider.provider_name,
@@ -514,6 +534,12 @@ def build_embeddings(
         "path": str(embeddings_path),
     }
 
+    # Add cpu_only info for Ollama
+    if hasattr(embedding_provider, "cpu_only"):
+        result["cpu_only"] = embedding_provider.cpu_only
+
+    return result
+
 
 # =============================================================================
 # Subagent Prompts

ifcraftcorpus/providers.py

@@ -9,7 +9,12 @@ Supports multiple backends:
 Provider selection via environment:
 - EMBEDDING_PROVIDER: "ollama", "openai", or "sentence-transformers"
 - OLLAMA_HOST: Ollama server URL (default: http://localhost:11434)
+- IFCRAFTCORPUS_OLLAMA_MODEL: Ollama embedding model (default: nomic-embed-text)
+- IFCRAFTCORPUS_OLLAMA_CPU_ONLY: Set to "true" or "1" to force CPU-only inference
 - OPENAI_API_KEY: OpenAI API key (required for openai provider)
+
+Note: The IFCRAFTCORPUS_ prefix avoids conflicts with other applications
+that may use Ollama with different model/GPU configurations.
 """
 
 from __future__ import annotations
@@ -113,24 +118,44 @@ class OllamaEmbeddings(EmbeddingProvider):
     Recommended model: nomic-embed-text (768 dimensions)
 
     Requires: httpx (pip install httpx)
+
+    Environment variables:
+        OLLAMA_HOST: Server URL (default: http://localhost:11434)
+        IFCRAFTCORPUS_OLLAMA_MODEL: Model name (default: nomic-embed-text)
+        IFCRAFTCORPUS_OLLAMA_CPU_ONLY: Set to "true" or "1" to force CPU-only inference
+
+    Note: The IFCRAFTCORPUS_ prefix avoids conflicts with other applications
+    that may use Ollama with different model/GPU configurations.
     """
 
     def __init__(
         self,
         model: str | None = None,
         host: str | None = None,
+        cpu_only: bool | None = None,
     ):
         """
         Initialize Ollama embeddings.
 
         Args:
-            model: Embedding model name (default: nomic-embed-text)
-            host: Ollama host URL (default: http://localhost:11434)
+            model: Embedding model name (default: nomic-embed-text, or
+                   IFCRAFTCORPUS_OLLAMA_MODEL env)
+            host: Ollama host URL (default: http://localhost:11434, or OLLAMA_HOST env)
+            cpu_only: Force CPU-only inference with num_gpu=0 (default: False, or
+                     IFCRAFTCORPUS_OLLAMA_CPU_ONLY env). Useful when GPU is under
+                     VRAM pressure or to avoid contention with other GPU workloads.
         """
-        self._model = model or DEFAULT_MODELS["ollama"]
+        self._model = model or os.getenv("IFCRAFTCORPUS_OLLAMA_MODEL") or DEFAULT_MODELS["ollama"]
         self._host = host or os.getenv("OLLAMA_HOST", "http://localhost:11434")
         self._dimension = MODEL_DIMENSIONS.get(self._model, 768)
 
+        # CPU-only mode: check parameter, then env var
+        if cpu_only is not None:
+            self._cpu_only = cpu_only
+        else:
+            env_val = os.getenv("IFCRAFTCORPUS_OLLAMA_CPU_ONLY", "").lower()
+            self._cpu_only = env_val in ("true", "1", "yes")
+
     @property
     def model(self) -> str:
         return self._model
@@ -143,20 +168,30 @@ class OllamaEmbeddings(EmbeddingProvider):
     def provider_name(self) -> str:
         return "ollama"
 
+    @property
+    def cpu_only(self) -> bool:
+        """Whether CPU-only mode is enabled."""
+        return self._cpu_only
+
     def embed(self, texts: list[str]) -> EmbeddingResult:
         """Embed texts using Ollama."""
         import httpx
 
         embeddings: list[list[float]] = []
 
+        # Build request payload
+        base_payload: dict[str, object] = {"model": self._model}
+
+        # Add options for CPU-only mode
+        if self._cpu_only:
+            base_payload["options"] = {"num_gpu": 0}
+
         with httpx.Client(timeout=60.0) as client:
             for text in texts:
+                payload = {**base_payload, "prompt": text}
                 response = client.post(
                     f"{self._host}/api/embeddings",
-                    json={
-                        "model": self._model,
-                        "prompt": text,
-                    },
+                    json=payload,
                 )
                 response.raise_for_status()
                 data = response.json()
@@ -372,6 +407,7 @@ class SentenceTransformersEmbeddings(EmbeddingProvider):
 def get_embedding_provider(
     provider_name: str | None = None,
     model: str | None = None,
+    cpu_only: bool | None = None,
 ) -> EmbeddingProvider | None:
     """
     Get an embedding provider based on configuration.
@@ -384,6 +420,8 @@ def get_embedding_provider(
     Args:
         provider_name: Explicit provider name ("ollama", "openai", "sentence-transformers")
         model: Optional model override
+        cpu_only: For Ollama, force CPU-only inference (num_gpu=0). If None, reads
+                 from OLLAMA_CPU_ONLY env var.
 
     Returns:
         Configured EmbeddingProvider or None if none available
@@ -395,7 +433,7 @@ def get_embedding_provider(
         name = name.lower()
         provider: EmbeddingProvider
         if name == "ollama":
-            provider = OllamaEmbeddings(model=model)
+            provider = OllamaEmbeddings(model=model, cpu_only=cpu_only)
         elif name == "openai":
             provider = OpenAIEmbeddings(model=model)
         elif name in ("sentence-transformers", "st", "local"):
@@ -410,9 +448,9 @@ def get_embedding_provider(
         return None
 
     # Auto-detect: try Ollama first, then OpenAI, then SentenceTransformers
-    ollama = OllamaEmbeddings(model=model)
+    ollama = OllamaEmbeddings(model=model, cpu_only=cpu_only)
     if ollama.check_availability():
-        logger.info(f"Using Ollama embeddings ({ollama.model})")
+        logger.info(f"Using Ollama embeddings ({ollama.model}, cpu_only={ollama.cpu_only})")
         return ollama
 
     openai = OpenAIEmbeddings(model=model)

{ifcraftcorpus-1.2.1.dist-info → ifcraftcorpus-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ifcraftcorpus
-Version: 1.2.1
+Version: 1.3.0
 Summary: Interactive fiction craft corpus with search library and MCP server
 Project-URL: Homepage, https://pvliesdonk.github.io/if-craft-corpus
 Project-URL: Repository, https://github.com/pvliesdonk/if-craft-corpus

{ifcraftcorpus-1.2.1.dist-info → ifcraftcorpus-1.3.0.dist-info}/RECORD

@@ -1,67 +1,67 @@
 ifcraftcorpus/__init__.py,sha256=sZlp_jM2CGbkQ6R3te-wXH9IkZ7Zp585fj1MMq21WUQ,2087
-ifcraftcorpus/cli.py,sha256=ZY6T7kj66S1cfeJ75r7VoNkXCtnfcxCcUpA3bRQUi8k,10454
+ifcraftcorpus/cli.py,sha256=aTLZCuSTZ9884nxvngj2RX1VHl9PXKVMMeYAQIVMU6I,11131
 ifcraftcorpus/embeddings.py,sha256=ChRqB1HSCAImczARQQ0Vg_xS5fMPnvd2cg2tFzVaSDc,12962
 ifcraftcorpus/index.py,sha256=mRCN5r7VnwXxc8e1rfBsUDpxnhQFqKvvDcHcHeEXy_I,19262
 ifcraftcorpus/logging_utils.py,sha256=_0c4Y_caKObVRsfgeoi5l5ZvSx0JY_xZDnWa85sBUu0,2179
-ifcraftcorpus/mcp_server.py,sha256=qs8_ShSyWQsP4e17xbyr2ZlaDly9yDzcXtger-AZvmc,26401
+ifcraftcorpus/mcp_server.py,sha256=jm3w_uqeyDpd5D3iB7ZxNJU7dxQnIXmWO7gvgemaeBk,27539
 ifcraftcorpus/parser.py,sha256=M6iKnj0_bqA8tgl7tg1SLYzlOItS_Bs2M1RTwqTTFbw,10859
-ifcraftcorpus/providers.py,sha256=IvKVRbxYLLM3siOAu8X8nOsL1xHmp37Xuryi1MggBj4,12597
+ifcraftcorpus/providers.py,sha256=1cuaB72-fVyt2J441AR7lfn6HuHtM33G6mPZYdYREN0,14508
 ifcraftcorpus/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ifcraftcorpus/search.py,sha256=hz81U44qXb-ZLbAcgDKsj4H_9t1ESxorRWsGSiuHu2I,20962
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/agent-design/agent_prompt_engineering.md,sha256=y-AO3w6MdoSQNV7zHQtJrjJSWM9a6LCSlunXyWWbTjQ,26134
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/agent-design/multi_agent_patterns.md,sha256=Npnx5qxYOQfbiPGgbeZOfyWKr4ImcCTUhOJcgJYH1HY,13275
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/audience-and-access/accessibility_guidelines.md,sha256=SN8tORkgdYYSIcKNQBV-ju8eL2M7Lij9UEZ3AvuUQbY,9892
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/audience-and-access/audience_targeting.md,sha256=ESZ4fyiCgtWVXXrXZIViCNU0ohIFdNcC8CU9dkRfPSQ,11037
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/audience-and-access/localization_considerations.md,sha256=Mgn2bVN_ugFhsZjRomOstayylzFtrzza-lw-T2p3Lnw,9787
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/audio_visual_integration.md,sha256=YE6pdZr7FNe9VIodgF0xttmzSjfZf0guQ81N3Rbkui4,9892
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/collaborative_if_writing.md,sha256=inDHVyqP3zdP-WBWueeKvDb9Ulqu55AUK61lbhIC82w,9929
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/creative_workflow_pipeline.md,sha256=N5ieILKrKB06hrlegFX-5iOvpXQO8sT5MERiFxxRGZY,10305
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/diegetic_design.md,sha256=FsLT2o3D8znEZrHRzg0L_z0sbg58yTzUk8O70FtGGcE,9183
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/idea_capture_and_hooks.md,sha256=wcidi47Elg38Y-1fuVEW6xn68rL_NqPR5x1IcsPu6ZI,8734
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/if_platform_tools.md,sha256=1Kh_xYjy654RkDxVAw5Ji3pgOKRc1WNdxNu93v9Af3Y,11172
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/player_analytics_metrics.md,sha256=sUuPYmmLn5LMLUd9E-ExhauqF101vcqh51NYc99yyv8,9064
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/quality_standards_if.md,sha256=gS6Jr7OWZKmRvtrSrrCkuM8CgqgLCZ1XAHYBSnbEYH8,16432
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/research_and_verification.md,sha256=WFYaq3boUlHueXWkZygxO9s9astK5aMOaVPE6u-CCeI,9874
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/craft-foundations/testing_interactive_fiction.md,sha256=McnbMEgm_PbaxT-dUu8rTzkOOLkIjECKlxVFzcyr7rc,10504
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/emotional-design/conflict_patterns.md,sha256=hPV78jR8W4rYiW52m4n_Ifn3nMGDW7tPEPik4kekiIE,12056
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/emotional-design/emotional_beats.md,sha256=1yblsg1NLT8CW3qfnQX7WXNflnQhyKYc-_9nb1zgWs4,10229
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/game-design/mechanics_design_patterns.md,sha256=sbBWhX8BQOIMyrYfdBjpjlhLeqE_vOuGQXXGFn-zY0U,4506
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/genre-conventions/children_and_ya_conventions.md,sha256=b5juJi2z3FMYKL5Tkw08E1jjtlvQdMy3sbDoU0PV88w,3680
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/genre-conventions/fantasy_conventions.md,sha256=AN-Mc9kkZKOE4qr8jwAyt6Yh5WlXqRFTPad0BS9joY0,13925
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/genre-conventions/historical_fiction.md,sha256=6mAgLSfAD2EV-UCE5WJM1Wk4ARsCuYofKR3Dn0Kcfhg,12016
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/genre-conventions/horror_conventions.md,sha256=449Ik17haBHnlIfGkh6FwDqoes8K-y7WKNimGxSq5yg,12883
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/genre-conventions/mystery_conventions.md,sha256=xZLCcO3MZJ4dghzoMbITZUc1A7xGpSL1B9LtR74Fhj4,12282
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/genre-conventions/sci_fi_conventions.md,sha256=dNkeIipLgtui2Xt6kPlEHT0HHNnCbPDFBQyH_5-1RfQ,5636
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/branching_narrative_construction.md,sha256=Rv8t7zn4g3K6mF1NaHYXAX_vEAdUFcfa-aDA44bAOqs,22265
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/branching_narrative_craft.md,sha256=I4APmDwCQ9dVF9blORxgF_YArfj9aSrTP8TpXJYI-jA,10906
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/endings_patterns.md,sha256=RyxJfZuFyuyEKzmR32H9kBs4jUbeahwylNLkp2oiEjg,10581
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/episodic_serialized_if.md,sha256=tEGRl-L3gRTXmbfoQZ-fCS2CR9xr-dHQgaQNcI4hHdA,9337
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/nonlinear_structure.md,sha256=PfomsB5-l7DwGr1udbvgsTNdJaCdXgLhdYDvBUyKq2k,6287
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/pacing_and_tension.md,sha256=0jlbJwzK2wNLxFQO4zHu6a53vM1Kwb6f5simamexKBU,9530
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/romance_and_relationships.md,sha256=OW3nO9Qn_lCFWRGNyTKQMEOHnmuAA9rIo7wORaF_73U,4012
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/scene_structure_and_beats.md,sha256=WL7buciBLTcl0vyTsLZcEgMI0U6ikA2t0EY9QkKpkJk,10094
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/narrative-structure/scene_transitions.md,sha256=Vu33QmpqWRnja4ITvcJepZ2f1NxK6fdwlroJUsczc1c,8500
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/character_voice.md,sha256=gFQptHphCu9pZ2MzqaCVHvpSiHCefi4vBrwZtsfN0R8,11409
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/dialogue_craft.md,sha256=4aQed24AQ7-VdYiaxjQ0JlK13qeNe3Gq1QgJiAqNEG4,11591
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/exposition_techniques.md,sha256=T06IupDgh7MHQDkhHzo5U0ewDqGs5D60nGFn1V2NV-A,10023
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/narrative_point_of_view.md,sha256=G_mZUPh4qxe3LdzO6hiFizJqbh4QKq6ukjcgTyeKPQ8,11020
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/prose_patterns.md,sha256=UFEancpG4_TG3M7KnJGkZCvkafP6TxkhXEKEZgFPWug,10146
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/subtext_and_implication.md,sha256=jKwBTZx5gVy84AG6x2hHmPwbFIiti419-DaDO4oXlH8,10726
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/prose-and-language/voice_register_consistency.md,sha256=JtY5bwIrrY1Cjy2ITGOGxCepDhoQnr7nzt2pqr2SKtI,9701
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/scope-and-planning/scope_and_length.md,sha256=fF6TDuLSJv5Uf7ov9_Eq0beh8OQF4RBEDmekjZbHkJQ,10315
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/world-and-setting/canon_management.md,sha256=ab1XjWXv3RzEWaChfUJOOSnRKjuQsUDaqYQ3T9bw9o0,10576
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/world-and-setting/setting_as_character.md,sha256=F0kM5EKlDldqPg2UyyfKx05fRyaWIoE-A-sIhl461Cw,9650
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/corpus/world-and-setting/worldbuilding_patterns.md,sha256=IpvZkT6sV3yC23RsICxpeMgb_FT_1mkv1z4NiHKNEIY,11905
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/README.md,sha256=FI9SqJfOg8hoO-3S_dpeIfepPRcd0fyquM7f5Y1J5eE,5817
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/if_genre_consultant.md,sha256=QshDQK4HkMNXYigU91r0CTosl5a-lKqvO9tQMFkbUFI,7244
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/if_platform_advisor.md,sha256=e_uV0vt5Nqah6bUNsiWVhmSuQeF0RIWAZOXJNygpeW8,8515
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/if_prose_writer.md,sha256=fjOazUCXvW62xrhZAsv7ynaDSpG_f1gGK2NJ0clJ1EQ,5927
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/if_quality_reviewer.md,sha256=PLPJtf-6t-jugN75k7EG7ln7S47TT0FcVjWVsRLGOz8,6992
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/if_story_architect.md,sha256=rF_U0Nd3tK0HzaLK6wGL36hRb0B6dfuc6lljAU9pmmo,4936
-ifcraftcorpus-1.2.1.data/data/share/ifcraftcorpus/subagents/if_world_curator.md,sha256=xmbGF--5te8uxfimKFw45bFrhbdRM3LPaYBlhUd4swc,7376
-ifcraftcorpus-1.2.1.dist-info/METADATA,sha256=H9JUOQkXgqYtqwmYxpFzQXpl6VAo_VyzJbiaN2bNkIQ,4989
-ifcraftcorpus-1.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-ifcraftcorpus-1.2.1.dist-info/entry_points.txt,sha256=E8DYJ_qWOgPe758ULKth3gcYo-1XkNEvDomhFjJ-B-U,110
-ifcraftcorpus-1.2.1.dist-info/licenses/LICENSE,sha256=7MoRwpgeEClx14esn2SJnOLz4jvxWP1uN_vjnC2XTHQ,1067
-ifcraftcorpus-1.2.1.dist-info/licenses/LICENSE-CONTENT,sha256=jhGwmahhy9rUFJSSrLUrssnrfa-mXotvNEwq74i93x8,639
-ifcraftcorpus-1.2.1.dist-info/RECORD,,
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/agent-design/agent_prompt_engineering.md,sha256=y-AO3w6MdoSQNV7zHQtJrjJSWM9a6LCSlunXyWWbTjQ,26134
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/agent-design/multi_agent_patterns.md,sha256=Npnx5qxYOQfbiPGgbeZOfyWKr4ImcCTUhOJcgJYH1HY,13275
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/audience-and-access/accessibility_guidelines.md,sha256=SN8tORkgdYYSIcKNQBV-ju8eL2M7Lij9UEZ3AvuUQbY,9892
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/audience-and-access/audience_targeting.md,sha256=ESZ4fyiCgtWVXXrXZIViCNU0ohIFdNcC8CU9dkRfPSQ,11037
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/audience-and-access/localization_considerations.md,sha256=Mgn2bVN_ugFhsZjRomOstayylzFtrzza-lw-T2p3Lnw,9787
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/audio_visual_integration.md,sha256=YE6pdZr7FNe9VIodgF0xttmzSjfZf0guQ81N3Rbkui4,9892
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/collaborative_if_writing.md,sha256=inDHVyqP3zdP-WBWueeKvDb9Ulqu55AUK61lbhIC82w,9929
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/creative_workflow_pipeline.md,sha256=N5ieILKrKB06hrlegFX-5iOvpXQO8sT5MERiFxxRGZY,10305
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/diegetic_design.md,sha256=FsLT2o3D8znEZrHRzg0L_z0sbg58yTzUk8O70FtGGcE,9183
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/idea_capture_and_hooks.md,sha256=wcidi47Elg38Y-1fuVEW6xn68rL_NqPR5x1IcsPu6ZI,8734
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/if_platform_tools.md,sha256=1Kh_xYjy654RkDxVAw5Ji3pgOKRc1WNdxNu93v9Af3Y,11172
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/player_analytics_metrics.md,sha256=sUuPYmmLn5LMLUd9E-ExhauqF101vcqh51NYc99yyv8,9064
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/quality_standards_if.md,sha256=gS6Jr7OWZKmRvtrSrrCkuM8CgqgLCZ1XAHYBSnbEYH8,16432
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/research_and_verification.md,sha256=WFYaq3boUlHueXWkZygxO9s9astK5aMOaVPE6u-CCeI,9874
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/craft-foundations/testing_interactive_fiction.md,sha256=McnbMEgm_PbaxT-dUu8rTzkOOLkIjECKlxVFzcyr7rc,10504
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/emotional-design/conflict_patterns.md,sha256=hPV78jR8W4rYiW52m4n_Ifn3nMGDW7tPEPik4kekiIE,12056
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/emotional-design/emotional_beats.md,sha256=1yblsg1NLT8CW3qfnQX7WXNflnQhyKYc-_9nb1zgWs4,10229
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/game-design/mechanics_design_patterns.md,sha256=sbBWhX8BQOIMyrYfdBjpjlhLeqE_vOuGQXXGFn-zY0U,4506
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/genre-conventions/children_and_ya_conventions.md,sha256=b5juJi2z3FMYKL5Tkw08E1jjtlvQdMy3sbDoU0PV88w,3680
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/genre-conventions/fantasy_conventions.md,sha256=AN-Mc9kkZKOE4qr8jwAyt6Yh5WlXqRFTPad0BS9joY0,13925
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/genre-conventions/historical_fiction.md,sha256=6mAgLSfAD2EV-UCE5WJM1Wk4ARsCuYofKR3Dn0Kcfhg,12016
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/genre-conventions/horror_conventions.md,sha256=449Ik17haBHnlIfGkh6FwDqoes8K-y7WKNimGxSq5yg,12883
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/genre-conventions/mystery_conventions.md,sha256=xZLCcO3MZJ4dghzoMbITZUc1A7xGpSL1B9LtR74Fhj4,12282
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/genre-conventions/sci_fi_conventions.md,sha256=dNkeIipLgtui2Xt6kPlEHT0HHNnCbPDFBQyH_5-1RfQ,5636
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/branching_narrative_construction.md,sha256=Rv8t7zn4g3K6mF1NaHYXAX_vEAdUFcfa-aDA44bAOqs,22265
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/branching_narrative_craft.md,sha256=I4APmDwCQ9dVF9blORxgF_YArfj9aSrTP8TpXJYI-jA,10906
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/endings_patterns.md,sha256=RyxJfZuFyuyEKzmR32H9kBs4jUbeahwylNLkp2oiEjg,10581
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/episodic_serialized_if.md,sha256=tEGRl-L3gRTXmbfoQZ-fCS2CR9xr-dHQgaQNcI4hHdA,9337
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/nonlinear_structure.md,sha256=PfomsB5-l7DwGr1udbvgsTNdJaCdXgLhdYDvBUyKq2k,6287
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/pacing_and_tension.md,sha256=0jlbJwzK2wNLxFQO4zHu6a53vM1Kwb6f5simamexKBU,9530
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/romance_and_relationships.md,sha256=OW3nO9Qn_lCFWRGNyTKQMEOHnmuAA9rIo7wORaF_73U,4012
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/scene_structure_and_beats.md,sha256=WL7buciBLTcl0vyTsLZcEgMI0U6ikA2t0EY9QkKpkJk,10094
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/narrative-structure/scene_transitions.md,sha256=Vu33QmpqWRnja4ITvcJepZ2f1NxK6fdwlroJUsczc1c,8500
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/character_voice.md,sha256=gFQptHphCu9pZ2MzqaCVHvpSiHCefi4vBrwZtsfN0R8,11409
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/dialogue_craft.md,sha256=4aQed24AQ7-VdYiaxjQ0JlK13qeNe3Gq1QgJiAqNEG4,11591
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/exposition_techniques.md,sha256=T06IupDgh7MHQDkhHzo5U0ewDqGs5D60nGFn1V2NV-A,10023
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/narrative_point_of_view.md,sha256=G_mZUPh4qxe3LdzO6hiFizJqbh4QKq6ukjcgTyeKPQ8,11020
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/prose_patterns.md,sha256=UFEancpG4_TG3M7KnJGkZCvkafP6TxkhXEKEZgFPWug,10146
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/subtext_and_implication.md,sha256=jKwBTZx5gVy84AG6x2hHmPwbFIiti419-DaDO4oXlH8,10726
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/prose-and-language/voice_register_consistency.md,sha256=JtY5bwIrrY1Cjy2ITGOGxCepDhoQnr7nzt2pqr2SKtI,9701
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/scope-and-planning/scope_and_length.md,sha256=fF6TDuLSJv5Uf7ov9_Eq0beh8OQF4RBEDmekjZbHkJQ,10315
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/world-and-setting/canon_management.md,sha256=ab1XjWXv3RzEWaChfUJOOSnRKjuQsUDaqYQ3T9bw9o0,10576
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/world-and-setting/setting_as_character.md,sha256=F0kM5EKlDldqPg2UyyfKx05fRyaWIoE-A-sIhl461Cw,9650
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/corpus/world-and-setting/worldbuilding_patterns.md,sha256=IpvZkT6sV3yC23RsICxpeMgb_FT_1mkv1z4NiHKNEIY,11905
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/README.md,sha256=FI9SqJfOg8hoO-3S_dpeIfepPRcd0fyquM7f5Y1J5eE,5817
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/if_genre_consultant.md,sha256=QshDQK4HkMNXYigU91r0CTosl5a-lKqvO9tQMFkbUFI,7244
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/if_platform_advisor.md,sha256=e_uV0vt5Nqah6bUNsiWVhmSuQeF0RIWAZOXJNygpeW8,8515
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/if_prose_writer.md,sha256=fjOazUCXvW62xrhZAsv7ynaDSpG_f1gGK2NJ0clJ1EQ,5927
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/if_quality_reviewer.md,sha256=PLPJtf-6t-jugN75k7EG7ln7S47TT0FcVjWVsRLGOz8,6992
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/if_story_architect.md,sha256=rF_U0Nd3tK0HzaLK6wGL36hRb0B6dfuc6lljAU9pmmo,4936
+ifcraftcorpus-1.3.0.data/data/share/ifcraftcorpus/subagents/if_world_curator.md,sha256=xmbGF--5te8uxfimKFw45bFrhbdRM3LPaYBlhUd4swc,7376
+ifcraftcorpus-1.3.0.dist-info/METADATA,sha256=-QqX06NPksR94gytqc7uS9wuR5OCTcYSNUkd2nfs5Sw,4989
+ifcraftcorpus-1.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ifcraftcorpus-1.3.0.dist-info/entry_points.txt,sha256=E8DYJ_qWOgPe758ULKth3gcYo-1XkNEvDomhFjJ-B-U,110
+ifcraftcorpus-1.3.0.dist-info/licenses/LICENSE,sha256=7MoRwpgeEClx14esn2SJnOLz4jvxWP1uN_vjnC2XTHQ,1067
+ifcraftcorpus-1.3.0.dist-info/licenses/LICENSE-CONTENT,sha256=jhGwmahhy9rUFJSSrLUrssnrfa-mXotvNEwq74i93x8,639
+ifcraftcorpus-1.3.0.dist-info/RECORD,,