docs: update AI.md patch marker and handoff block after doc consistency pass

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Mario Fetka
2026-06-18 19:26:34 +02:00
parent 8e6a6d54bf
commit a11cd57553

30
AI.md
View File

@@ -46,7 +46,7 @@ unfinished work out of `TODO.md` merely because its architecture is documented.
Latest commit in an up-to-date tree:
- `docs: define namespace userspace uniqueness boundary`
- `tests: update namespace-import-layout test to use consolidated NSS_IMPORT_NOTES.md`
Compare `git log -1 --format="%s"` with this subject. If the tree is older,
check which COMN audit commits are missing and replay them before starting new
@@ -54,23 +54,21 @@ work.
## Current patch handoff block
Last completed work block: **namespace userspace uniqueness boundary**
Last completed work block: **MD consistency and doc consolidation pass**
The latest design work clarifies how imported NSS namespace code should be used
for future Mars/NWFS integration. `libnwnss` remains the NSS namespace provider
using the real `src/nwnss/comn/namespace` implementations. A later `nwfs`
wrapper will translate Mars volume options, host paths, search handles and
compatibility policy before calling into `libnwnss`; the current half-finished
`nwfs` namespace staging remains ignored until that cleanup phase.
All repository markdown files were audited for stale paths and cross-file
inconsistencies. Outdated references to `include/nwfs/nss/`, `src/nwfs/nss/`,
`include/core/`, `src/core/` and `wolfssl` were corrected. Fifteen smaller
doc files were consolidated into five topic-focused files under `doc/`. The
`nwfs.nss.namespace-import-layout` test was updated from the merged-away
`doc/NSS_NAMESPACE_AUDIT.md` to the new `doc/NSS_IMPORT_NOTES.md`.
Most namespace operations are pure provider helpers and can be called through the
real NSS families directly: compare, wildcard match/replace, ASCII/Unicode
conversion, legal-name checks and component scanning for DOS, LONG/OS2,
UNIX/NFS, MAC, DATASTREAM and EA. `*_generateUniqueName()` is the exception: it
requires directory uniqueness/collision lookup. HostFS, OtherFS, sidecar or
Mars directory enumeration for that path belongs in a parallel
`nameSpaceUserspace.c` / `nameSpaceUserspace.h` boundary, not inline in
`dosNSpace.c`, `longNSpace.c`, `unixNSpace.c`, `macNSpace.c` or `nameSpace.c`.
Ownership boundaries for service processes, quota/salvage, namespace uniqueness
and the libnwnss/nwfs backend split were documented as durable design decisions
across `REDESIGN.md`, `AI.md`, and `CLAUDE.md`.
Test suite is 62/62 green. Build directory is
`/home/mario/mars/mars-nwe-build` (out-of-tree).
## Directory/NDS work order