SP2: physical project store

.github/workflows/ci.yml

@@ -36,3 +36,6 @@ jobs:
 
       - name: Compile
         run: rebar3 compile
+
+      - name: Cross reference analysis (undefined function calls)
+        run: rebar3 xref

.gitignore

@@ -17,3 +17,4 @@ rebar3
 CLAUDE.local.md
 resume
 ttb_last_config
+.worktrees/

CLAUDE.md

@@ -160,7 +160,11 @@ nref spaces:
 - **Environment**: scaffold nrefs 1–35; permanent tier `[?LABEL_START, ?NREF_START)` = `[10001, 1000000)` holds English (10000), loader-assigned atom-labeled bootstrap nodes, and worker `init/1` seeds (graphdb_attr, graphdb_language sub-groups); runtime allocations ≥ `?NREF_START` (1000000). Boundaries are macros in `apps/graphdb/include/graphdb_nrefs.hrl` — **not** directives in `bootstrap.terms`. All graphdb node-nref allocation goes through `graphdb_nref` (first child of `graphdb_sup`): permanent phase during init, runtime phase after the `graphdb:start/2` flip.
 - **Project**: allocator starts at **1** — no pre-assigned nrefs, no bootstrap file, no floor needed
 
-Cross-database nref resolution: `characterization` and `reciprocal` fields always reference environment nrefs; `target_nref` is routed to environment or project based on the arc label's `target_kind` AVP stored in the environment attribute library. This routing is encoded by the pure `graphdb_ns` module (SP1). A project is an anchor node under `Projects` (nref 5); project write operations require a `graphdb_project` session (SP1 — see `docs/designs/project-env-reference-namespace-model-design.md` and `TASKS.md` → *Multi-project sessions*). SP1 is behaviour-preserving against today's single store; physical per-project storage is SP2.
+Cross-database nref resolution is **home-relative**: `characterization` and `reciprocal` (arc labels), class nodes, and attribute nodes always resolve to the environment; `source_nref` and `target_nref` route through the operation's `Home :: environment | Project`. This routing is encoded by the pure `graphdb_ns` module (`namespace_of/2`, `target_namespace/2`, `node_table/1`, `rel_table/1`).
+
+A project is an anchor node under `Projects` (nref 5). `graphdb_project:register_project/1` creates that anchor **and** the project's own three Mnesia tables (`nodes_<Anchor>`, `relationships_<Anchor>`, `counters_<Anchor>`); `open/1` resolves a project nref into a `Project` handle `#{anchor, nodes, rels, counters}`, validated by `require_project/1`. Project nref and rel-id allocation is project-local, starting at 1. Project write operations and instance reads take a `Project` handle as their first argument and reject a missing/invalid one with `{error, invalid_project}`.
+
+Because each project's allocator restarts at 1, project nrefs collide numerically with environment bootstrap nrefs 1–35 — a bare nref is only unique within a `Home`. SP1 (reference & namespace model) and SP2 (physical project store) are both implemented; SP3 (distribution/residency + proxy dereference) and SP4 (migration) remain. See `docs/designs/project-env-reference-namespace-model-design.md`, `docs/designs/sp2-physical-project-store-design.md`, and `TASKS.md` → *Multi-project sessions*.
 
 ### Bootstrap Nref Quick-Reference (BFS, nrefs 1–35)
 

apps/graphdb/src/graphdb_attr.erl

@@ -139,7 +139,9 @@
 		%% Seeded nref accessors
 		seeded_nrefs/0,
 		%% Cross-worker stamping
-		retro_stamp_attribute_types/0
+		retro_stamp_attribute_types/0,
+		%% Cross-worker lookup (graphdb_language, graphdb_rules init/1 seeding)
+		find_attribute_by_name/2
 		]).
 
 %%---------------------------------------------------------------------
@@ -159,8 +161,7 @@
 %%---------------------------------------------------------------------
 -ifdef(TEST).
 -export([
-		valid_target_kind/1,
-		find_attribute_by_name/2
+		valid_target_kind/1
 		]).
 -endif.