tano.page 0.1.0a1__tar.gz

tano_page-0.1.0a1/.gitignore

@@ -0,0 +1,15 @@
+node_modules/
+dist/
+target/
+.DS_Store
+*.log
+.env
+.env.*
+!.env.example
+test-results/
+artifacts/
+apps/client/src-tauri/gen/android/app/src/main/jniLibs/
+apps/client/src-tauri/gen/android/app/src/main/assets/
+apps/client/src-tauri/gen/android/app/tauri.build.gradle.kts
+apps/client/src-tauri/gen/android/app/tauri.properties
+data/

tano_page-0.1.0a1/LICENSE

@@ -0,0 +1,5 @@
+Copyright (c) 2026 dramwig. All rights reserved.
+
+This package is not released under an open source license. Publication does
+not grant permission to copy, modify, redistribute, or sublicense this work
+except as otherwise permitted by applicable law or a separate agreement.

tano_page-0.1.0a1/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.5
+Name: tano.page
+Version: 0.1.0a1
+Summary: Tano Markdown workspace protocol helpers: content hashes, short IDs and portable path classification.
+Author: dramwig
+License-Expression: LicenseRef-Proprietary
+License-File: LICENSE
+Keywords: markdown,protocol,tano,workspace
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Tano Workspace Protocol Helpers
+
+Tano - Humans and agents, on the same page.
+
+This preview Python library provides working helpers for Tano's local Markdown
+workspace protocol. It is not the desktop application or a sync client.
+PyPI normalizes the distribution name `tano.page` to `tano-page`; import it as
+`tano_page`.
+
+```python
+from tano_page import content_hash, is_short_id, is_workspace_data_path
+
+revision = content_hash(b"# Notes\n")
+assert len(revision) == 64
+assert is_short_id("a1b2c3")
+assert is_workspace_data_path(".tano/objects/a1b2c3.tano.json")
+assert not is_workspace_data_path(".tano/config.json")
+```
+
+- `content_hash` returns a lowercase SHA-256 of the exact bytes, without newline
+  or Unicode normalization.
+- `is_short_id` recognizes six lowercase hexadecimal characters. These IDs are
+  separate from workspace UUIDs.
+- `is_workspace_internal_path` identifies `.tano` paths.
+- `is_workspace_data_path` classifies portable object, capability, relation,
+  and conflict paths. Workspace identity configuration is excluded.
+
+Path classification is not path validation or filesystem authorization. Callers
+must validate relative paths, enforce workspace boundaries, reject unsafe
+symlinks, and compare the base hash before writing. The library performs no
+filesystem or network operations, has no runtime dependencies, and performs
+no actions at installation time.
+
+Copyright dramwig. All rights reserved. See LICENSE; no open source license
+has been granted.

tano_page-0.1.0a1/README.md

@@ -0,0 +1,35 @@
+# Tano Workspace Protocol Helpers
+
+Tano - Humans and agents, on the same page.
+
+This preview Python library provides working helpers for Tano's local Markdown
+workspace protocol. It is not the desktop application or a sync client.
+PyPI normalizes the distribution name `tano.page` to `tano-page`; import it as
+`tano_page`.
+
+```python
+from tano_page import content_hash, is_short_id, is_workspace_data_path
+
+revision = content_hash(b"# Notes\n")
+assert len(revision) == 64
+assert is_short_id("a1b2c3")
+assert is_workspace_data_path(".tano/objects/a1b2c3.tano.json")
+assert not is_workspace_data_path(".tano/config.json")
+```
+
+- `content_hash` returns a lowercase SHA-256 of the exact bytes, without newline
+  or Unicode normalization.
+- `is_short_id` recognizes six lowercase hexadecimal characters. These IDs are
+  separate from workspace UUIDs.
+- `is_workspace_internal_path` identifies `.tano` paths.
+- `is_workspace_data_path` classifies portable object, capability, relation,
+  and conflict paths. Workspace identity configuration is excluded.
+
+Path classification is not path validation or filesystem authorization. Callers
+must validate relative paths, enforce workspace boundaries, reject unsafe
+symlinks, and compare the base hash before writing. The library performs no
+filesystem or network operations, has no runtime dependencies, and performs
+no actions at installation time.
+
+Copyright dramwig. All rights reserved. See LICENSE; no open source license
+has been granted.

tano_page-0.1.0a1/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "tano.page"
+version = "0.1.0a1"
+description = "Tano Markdown workspace protocol helpers: content hashes, short IDs and portable path classification."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
+authors = [{ name = "dramwig" }]
+keywords = ["tano", "markdown", "workspace", "protocol"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/tano_page"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/", "tests/", "README.md", "LICENSE", "pyproject.toml"]

tano_page-0.1.0a1/src/tano_page/__init__.py

@@ -0,0 +1,24 @@
+"""Byte-level helpers for Tano's Markdown workspace protocol."""
+
+from .protocol import (
+    OBJECT_DIRECTORY,
+    WORKSPACE_CAPABILITY_PATH,
+    WORKSPACE_DATA_DIRECTORY,
+    WORKSPACE_RELATION_PATH,
+    content_hash,
+    is_short_id,
+    is_workspace_data_path,
+    is_workspace_internal_path,
+)
+
+__version__ = "0.1.0a1"
+__all__ = [
+    "OBJECT_DIRECTORY",
+    "WORKSPACE_CAPABILITY_PATH",
+    "WORKSPACE_DATA_DIRECTORY",
+    "WORKSPACE_RELATION_PATH",
+    "content_hash",
+    "is_short_id",
+    "is_workspace_data_path",
+    "is_workspace_internal_path",
+]

tano_page-0.1.0a1/src/tano_page/protocol.py

@@ -0,0 +1,33 @@
+"""Path classification does not validate filesystem access or authorize writes."""
+
+import hashlib
+import re
+
+WORKSPACE_DATA_DIRECTORY = ".tano"
+OBJECT_DIRECTORY = ".tano/objects"
+WORKSPACE_CAPABILITY_PATH = ".tano/capabilities.json"
+WORKSPACE_RELATION_PATH = ".tano/relations.tano-relations.json"
+
+
+def content_hash(content: bytes) -> str:
+    """Return the SHA-256 of exact bytes for Tano's expectedHash field."""
+    return hashlib.sha256(content).hexdigest()
+
+
+def is_short_id(value: object) -> bool:
+    """Recognize six lowercase hexadecimal characters, separate from UUIDs."""
+    return isinstance(value, str) and re.fullmatch(r"[0-9a-f]{6}", value) is not None
+
+
+def is_workspace_internal_path(path: str) -> bool:
+    """Classify paths inside Tano's portable data directory."""
+    return path == WORKSPACE_DATA_DIRECTORY or path.startswith(".tano/")
+
+
+def is_workspace_data_path(path: str) -> bool:
+    """Classify portable data paths, excluding workspace identity and app caches."""
+    return (
+        path in (WORKSPACE_CAPABILITY_PATH, WORKSPACE_RELATION_PATH)
+        or (path.startswith(".tano/conflicts/") and path.endswith(".json"))
+        or (path.startswith(".tano/objects/") and path.endswith(".tano.json"))
+    )

tano_page-0.1.0a1/tests/test_protocol.py

@@ -0,0 +1,49 @@
+import unittest
+
+from tano_page import (
+    WORKSPACE_CAPABILITY_PATH,
+    WORKSPACE_RELATION_PATH,
+    content_hash,
+    is_short_id,
+    is_workspace_data_path,
+    is_workspace_internal_path,
+)
+
+
+class ProtocolTests(unittest.TestCase):
+    def test_hashes_exact_content_bytes(self):
+        self.assertEqual(
+            content_hash(b"abc"),
+            "ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad",
+        )
+        self.assertNotEqual(content_hash(b"# Notes\n"), content_hash(b"# Notes\r\n"))
+
+    def test_reference_ids_do_not_accept_other_identity_formats(self):
+        for valid in ("a1b2c3", "000000"):
+            self.assertTrue(is_short_id(valid))
+        for invalid in (
+            "A1B2C3", "abcdef0", "12345", "a1b2cg", "\uff1123456", 123456,
+            "550e8400-e29b-41d4-a716-446655440000",
+        ):
+            with self.subTest(value=invalid):
+                self.assertFalse(is_short_id(invalid))
+
+    def test_identity_and_caches_are_excluded_from_portable_data(self):
+        for path in (
+            WORKSPACE_CAPABILITY_PATH,
+            WORKSPACE_RELATION_PATH,
+            ".tano/objects/a1b2c3.tano.json",
+            ".tano/conflicts/conflict.json",
+        ):
+            self.assertTrue(is_workspace_internal_path(path))
+            self.assertTrue(is_workspace_data_path(path))
+        for path in (".tano/config.json", ".tano/cache.sqlite", ".tano/objects/a.json"):
+            self.assertTrue(is_workspace_internal_path(path))
+            self.assertFalse(is_workspace_data_path(path))
+        self.assertTrue(is_workspace_internal_path(".tano"))
+        self.assertFalse(is_workspace_internal_path(".tano-backup/config.json"))
+        self.assertFalse(is_workspace_internal_path("notes/.tano/config.json"))
+
+
+if __name__ == "__main__":
+    unittest.main()