deepseek-harness/packages/util/paths
2026-07-18 12:40:13 +08:00
..
src Adapt workspace context to session prefixes 2026-07-10 14:32:44 +08:00
tests test(windows): use host path semantics 2026-07-18 12:40:13 +08:00
package.json fix: tighten project instruction path handling 2026-06-29 21:42:23 +08:00
README.md Merge remote-tracking branch 'origin/master' into codex/project-instruction-files 2026-07-14 19:50:25 +08:00
tsconfig.json fix: tighten project instruction path handling 2026-06-29 21:42:23 +08:00

dsh-paths

Shared filesystem path helpers for DeepSeek Harness user data.

DSH home

DSH_HOME_DIR_NAME owns the default user-data directory name: .dsh.

defaultDshHome() returns the default DeepSeek Harness home by joining the operating-system home directory with .dsh, using Node's platform path rules.

expandHomePath() expands ~, ~/..., and Windows-style ~\... prefixes against the operating-system home directory. It leaves non-tilde paths and ~user/... untouched.

This package is intentionally small and harness-dep-free so product packages can share user-data path conventions without depending on one another.

Known Limitations and Deferred Work

  • Expansion is deliberately narrow — only bare ~, ~/..., and ~\... use the current operating-system home; named-user forms such as ~alice/..., environment variables, and shell expressions remain unchanged.
  • Helpers do not touch the filesystem — callers still own directory creation, existence checks, permissions, and trust policy for the resulting path.