Roadmap

[djdarcy]

Roadmap

Evergreen tracking issue for UNCtools development priorities.

UNCtools is the L0 path-identity layer of the DazzleLib stack: it converts between UNC (\\server\share) and mapped-drive paths, classifies where a path comes from (unc / network / subst / local / ...), and probes reachability across both name variants. By charter it may probe the filesystem read-only; it never mutates or transfers content (content I/O lives one layer up, in dazzle-filekit).

Phase 1: Foundation -- DONE

• 0.1.0 -- initial PyPI release
• 0.2.0 -- probe-not-mutate split; get_path_type -> classify_path_origin; operations dissolved to a warning facade; dazzle-unctools pointer dist (EPIC: dazzle-unctools 0.2.0 -- probe-not-mutate split + three-axis rename (stack phase P1) #3)
• 0.2.1 -- git-repokit-common subtree + _version.py autobump; .gitignore repair; CONTRIBUTING hook docs (Fix git hooks: Port shell-based hook system from DazzleTreeLib #1)

Phase 2: 0.3.0 -- deprecation cleanup

• Remove the get_path_type -> classify_path_origin shim (warned through 0.2.x)
• Remove the operations re-export facade (warned through 0.2.x)
• Consolidate the near-duplicate UNC path-algebra helpers (parse_unc_path / get_unc_path_elements, join_unc_path / build_unc_path) to one pair
• Adopt the stack's PathIdentityError (from dazzle-lib) as the L0 error base

Phase 3: stack integration

• Ship a native as_resolver() satisfying the stack's PathVariantResolver protocol, so dazzle-filekit consumes unctools directly instead of shipping its own adapter
• Merge the case-sensitivity helpers cleanly with dazzle-filekit's fix_path_case home (cross-layer, per the stack contract)

Phase 4: future / nice-to-have

• Branding / org alignment follow-through (Establish library family branding strategy and GitHub Organization #2)
• Broaden cross-platform mapping detection beyond Windows where meaningful

Versions

Version	Theme	Status
0.1.0	initial release	shipped
0.2.0	probe-not-mutate + naming	shipped
0.2.1	repokit autobump + repo hygiene	in progress
0.3.0	deprecation cleanup	planned

Related: stack epic DazzleLib/.github#3; UNCtools#3.