agent-folder-workspace 0.1.3__tar.gz → 0.1.4__tar.gz

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-folder-workspace
-Version: 0.1.3
+Version: 0.1.4
 Summary: Offline, lazy, agent-oriented exploration of heterogeneous folders
 Author-email: Dark Light <darklight@noreply.com>
 License-Expression: Apache-2.0
@@ -37,7 +37,7 @@ hierarchies for agents. It discovers file metadata first and opens document
 bodies only when a caller expands or reads a node. The default parser path is
 local Python code: Microsoft Office and LibreOffice are not required.
 
-> **Project status:** `0.1.3` is an alpha contract. Read-only exploration and
+> **Project status:** `0.1.4` is an alpha contract. Read-only exploration and
 > byte access are implemented; editing, rendering, OCR, and complete semantic
 > coverage of every supported container are not.
 
@@ -278,7 +278,7 @@ best-effort basis. `index_content()` performs a full supported semantic walk
 without retaining all decoded bodies in RAM.
 
 The persistent index is an application-owned SQLite database below
-`<workspace>/.agent-folder-workspace-cache`, separated by a hash of the
+`WORKSPACE_ROOT/.agent-folder-workspace-cache`, separated by a hash of the
 workspace root. Existing owned caches are reused, while the cache subtree is
 excluded from document discovery. `WorkspaceConfig.cache_directory` and MCP's
 optional `cache_directory` argument can select another cache root explicitly.
@@ -423,7 +423,7 @@ The detailed coverage and per-format caveats are in
   rendering. A hard parent timeout cannot guarantee cleanup of a vendor process
   that is itself stuck below COM or LibreOffice process control.
 - The stated 100,000-node and warm p95 performance figures are design targets,
-  not certified guarantees in `0.1.3`; CI covers correctness across Windows,
+  not certified guarantees in `0.1.4`; CI covers correctness across Windows,
   Linux, and macOS but does not emulate a specific Windows-x64 SSD workload.
 
 ## Development

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/README.md

@@ -5,7 +5,7 @@ hierarchies for agents. It discovers file metadata first and opens document
 bodies only when a caller expands or reads a node. The default parser path is
 local Python code: Microsoft Office and LibreOffice are not required.
 
-> **Project status:** `0.1.3` is an alpha contract. Read-only exploration and
+> **Project status:** `0.1.4` is an alpha contract. Read-only exploration and
 > byte access are implemented; editing, rendering, OCR, and complete semantic
 > coverage of every supported container are not.
 
@@ -246,7 +246,7 @@ best-effort basis. `index_content()` performs a full supported semantic walk
 without retaining all decoded bodies in RAM.
 
 The persistent index is an application-owned SQLite database below
-`<workspace>/.agent-folder-workspace-cache`, separated by a hash of the
+`WORKSPACE_ROOT/.agent-folder-workspace-cache`, separated by a hash of the
 workspace root. Existing owned caches are reused, while the cache subtree is
 excluded from document discovery. `WorkspaceConfig.cache_directory` and MCP's
 optional `cache_directory` argument can select another cache root explicitly.
@@ -391,7 +391,7 @@ The detailed coverage and per-format caveats are in
   rendering. A hard parent timeout cannot guarantee cleanup of a vendor process
   that is itself stuck below COM or LibreOffice process control.
 - The stated 100,000-node and warm p95 performance figures are design targets,
-  not certified guarantees in `0.1.3`; CI covers correctness across Windows,
+  not certified guarantees in `0.1.4`; CI covers correctness across Windows,
   Linux, and macOS but does not emulate a specific Windows-x64 SSD workload.
 
 ## Development

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/docs/architecture.md

@@ -144,7 +144,7 @@ evicts least-recently-used values until `max_content_cache_bytes` is respected.
 The cache disappears with the workspace process or refresh.
 
 `ContentIndex` is created on first content-index/search use beneath
-`<workspace>/.agent-folder-workspace-cache` by default. Each root gets a
+`WORKSPACE_ROOT/.agent-folder-workspace-cache` by default. Each root gets a
 directory named with a truncated SHA-256 of the normalized absolute root. An
 existing owned cache is reused; a same-named directory without the ownership
 marker is rejected, and `NodeRegistry` excludes the cache subtree from source

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/docs/formats.md

@@ -68,7 +68,7 @@ outer format's default full-index branches. Cached copies can outlive a
 workspace instance until eviction or `folderws clear-cache`.
 
 By default, indexes and derived copies live below
-`<workspace>/.agent-folder-workspace-cache`. The owned directory is excluded
+`WORKSPACE_ROOT/.agent-folder-workspace-cache`. The owned directory is excluded
 from the document inventory, so split or converted artifacts do not reappear
 as source files. `WorkspaceConfig.cache_directory` or MCP's optional absolute
 `cache_directory` can select a different cache for one document basis.

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/docs/superpowers/plans/2026-07-24-workspace-local-cache.md

@@ -4,7 +4,7 @@
 
 **Goal:** Store split and derived document data in an owned cache beside each document basis by default and let MCP choose an absolute cache path per newly opened workspace.
 
-**Architecture:** Resolve every real `FolderWorkspace` to one explicit cache root during open, defaulting to `<workspace>/.agent-folder-workspace-cache`, and exclude that root from the source inventory. Extend `open_workspace` with one backward-compatible optional cache argument; validate and pass it through `WorkspaceManager`, while reporting the selected cache in `WorkspaceInfoV1`.
+**Architecture:** Resolve every real `FolderWorkspace` to one explicit cache root during open, defaulting to `WORKSPACE_ROOT/.agent-folder-workspace-cache`, and exclude that root from the source inventory. Extend `open_workspace` with one backward-compatible optional cache argument; validate and pass it through `WorkspaceManager`, while reporting the selected cache in `WorkspaceInfoV1`.
 
 **Tech Stack:** Python 3.11-3.14, Pydantic v2, FastMCP, pytest, Ruff, strict Mypy, Hatchling/build, Twine.
 

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/docs/windows.md

@@ -153,7 +153,7 @@ the mounted node.
 ## Cache locations
 
 Each document workspace defaults to an owned
-`<workspace>\.agent-folder-workspace-cache` directory. An existing owned cache
+`WORKSPACE_ROOT\.agent-folder-workspace-cache` directory. An existing owned cache
 is reused when MCP opens the workspace; a same-named foreign directory is
 rejected. The workspace scanner excludes this directory. It contains:
 

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agent-folder-workspace"
-version = "0.1.3"
+version = "0.1.4"
 description = "Offline, lazy, agent-oriented exploration of heterogeneous folders"
 readme = "README.md"
 requires-python = ">=3.11,<3.15"

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/scripts/check_wheel.py

@@ -68,7 +68,7 @@ def check_wheel(path: Path) -> str:
         metadata_name = _one(names, ".dist-info/METADATA")
         metadata = BytesParser(policy=default).parsebytes(wheel.read(metadata_name))
         _assert(metadata["Name"] == "agent-folder-workspace", "unexpected project name")
-        _assert(metadata["Version"] == "0.1.3", "unexpected project version")
+        _assert(metadata["Version"] == "0.1.4", "unexpected project version")
         _assert(metadata["License-Expression"] == "Apache-2.0", "unexpected license")
         _assert(
             set(str(metadata["Requires-Python"]).split(",")) == {">=3.11", "<3.15"},

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/src/agent_folder_workspace/__init__.py

@@ -24,7 +24,7 @@ from agent_folder_workspace.models import (
 )
 from agent_folder_workspace.workspace import FolderWorkspace
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"
 
 __all__ = [
     "BackendPolicy",

{agent_folder_workspace-0.1.3 → agent_folder_workspace-0.1.4}/tests/test_distribution.py

@@ -115,7 +115,7 @@ def test_wheel_contains_runtime_resources_and_complete_metadata(
         metadata_name = _single_name(names, ".dist-info/METADATA")
         metadata = BytesParser(policy=default).parsebytes(wheel.read(metadata_name))
         assert metadata["Name"] == "agent-folder-workspace"
-        assert metadata["Version"] == "0.1.3"
+        assert metadata["Version"] == "0.1.4"
         assert metadata["License-Expression"] == "Apache-2.0"
         assert set(metadata["Requires-Python"].split(",")) == {">=3.11", "<3.15"}
         assert metadata["Author-email"] == "Dark Light <darklight@noreply.com>"
@@ -143,7 +143,7 @@ def test_wheel_contains_runtime_resources_and_complete_metadata(
         ):
             assert runtime_selection_term in payload
         for cache_term in (
-            ".agent-folder-workspace-cache",
+            "WORKSPACE_ROOT/.agent-folder-workspace-cache",
             "cache_directory",
             "existing owned cache",
         ):
@@ -183,7 +183,7 @@ def test_sdist_manifest_contains_maintainer_sources_without_local_artifacts(
     with tarfile.open(sdist_path, mode="r:gz") as archive:
         names = {member.name for member in archive.getmembers() if member.isfile()}
 
-    root_prefix = "agent_folder_workspace-0.1.3/"
+    root_prefix = "agent_folder_workspace-0.1.4/"
     required = {
         "README.md",
         "LICENSE",