feat(schema): add can:// durable-id builders (v2)

Author: rahlk

codeanalyzer/schema/ids.py

@@ -0,0 +1,23 @@
+"""Canonical `can://` id construction for schema v2 (durable ids, ≥ callable).
+Ordinal ids (< callable) are `ordinal_id(callable_id, tag)`. Pure functions;
+ids are opaque handles (the <file> segment itself contains '/')."""
+from __future__ import annotations
+from typing import List
+
+_SCHEME = "can://python"
+
+def application_id(app_name: str) -> str:
+    return f"{_SCHEME}/{app_name}"
+
+def module_id(app_name: str, file_key: str) -> str:
+    rel = file_key.replace("\\", "/").lstrip("./")
+    return f"{application_id(app_name)}/{rel}"
+
+def child_id(parent_id: str, segment: str) -> str:
+    return f"{parent_id}/{segment}"
+
+def callable_sig_segment(name: str, param_names: List[str]) -> str:
+    return f"{name}({','.join(param_names)})"
+
+def ordinal_id(callable_id: str, tag: str) -> str:
+    return f"{callable_id}@{tag}"

test/test_v2_ids.py

@@ -0,0 +1,17 @@
+from codeanalyzer.schema import ids
+
+def test_application_and_module_ids():
+    assert ids.application_id("myapp") == "can://python/myapp"
+    assert ids.module_id("myapp", "pkg/mod.py") == "can://python/myapp/pkg/mod.py"
+
+def test_callable_signature_segment_uses_param_names():
+    assert ids.callable_sig_segment("hash", ["self", "s"]) == "hash(self,s)"
+    assert ids.callable_sig_segment("noargs", []) == "noargs()"
+
+def test_child_and_ordinal_ids_compose():
+    mod = ids.module_id("myapp", "pkg/mod.py")
+    cls = ids.child_id(mod, "Hasher")
+    fn = ids.child_id(cls, ids.callable_sig_segment("hash", ["self", "s"]))
+    assert fn == "can://python/myapp/pkg/mod.py/Hasher/hash(self,s)"
+    assert ids.ordinal_id(fn, "15:4") == fn + "@15:4"
+    assert ids.ordinal_id(fn, "entry") == fn + "@entry"