@try-works/dsh-memory 0.1.18 → 0.1.20

package/src/workspace-key.js

@@ -1,68 +1,68 @@
-// Stable, portable workspace-key derivation (pure). A workspace key must be
-// identical across devices that check out the same memory repo, even though the
-// local folder path differs. Resolution order: explicit > git remote URL > basename.
-
-/** Normalize any git remote spelling to a lowercase https URL with no trailing .git or slash. */
-export function normalizeRemoteUrl(url) {
-  if (typeof url !== 'string' || url.trim() === '') return undefined
-  let u = url.trim()
-  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(u)) {
-    u = u.replace(/^[a-z][a-z0-9+.-]*:\/\//i, 'https://')
-    u = u.replace(/^https:\/\/[^/@]+@/, 'https://') // strip userinfo
-  } else if (/^[^/\\:@]+@[^/\\:]+:.+/.test(u)) {
-    const i = u.indexOf(':')
-    u = 'https://' + u.slice(0, i).replace(/^[^@]+@/, '') + '/' + u.slice(i + 1)
-  }
-  u = u.replace(/\.git$/i, '')
-  u = u.replace(/\/+$/, '')
-  return u.toLowerCase()
-}
-
-/**
- * Filesystem-safe slug from a display segment.
- *
- * Keeps Unicode letters and digits, replaces everything else with a hyphen. A Latin-only rule
- * (a-z0-9) was actively harmful: any CJK, Cyrillic or Greek topic slugged to an EMPTY string,
- * so every such topic collapsed into one file and silently merged unrelated subjects. Keeping
- * the script is the only lossless option - and pure-ASCII input is unaffected, so existing
- * slugs and file names do not move.
- *
- * Bounded on code points, not UTF-16 units, so a multi-byte name is never cut mid-character.
- */
-export function slugify(segment) {
-  const raw = String(segment ?? '').trim().toLowerCase()
-  const slug = raw.replace(/[^\p{L}\p{N}]+/gu, '-').replace(/^-+|-+$/g, '')
-  if (slug === '') return ''
-  const points = [...slug]
-  return points.length > 60 ? points.slice(0, 60).join('').replace(/-+$/g, '') : slug
-}
-/** Reject traversal / empty / oversized keys. */
-export function sanitizeKey(key) {
-  if (typeof key !== 'string') return undefined
-  const s = slugify(key)
-  if (!s || s === '.' || s === '..' || s.length > 120) return undefined
-  return s
-}
-
-/** Derive a key from a normalized remote URL; GitHub drops the host, others keep it. */
-export function keyFromRemote(url) {
-  const n = normalizeRemoteUrl(url)
-  if (!n) return undefined
-  try {
-    const u = new URL(n)
-    const p = u.pathname.replace(/^\/+|\/+$/g, '')
-    if (u.hostname === 'github.com') return slugify(p.split('/').join('-'))
-    return slugify(u.hostname.replace(/^www\./, '') + '-' + p.split('/').join('-'))
-  } catch {
-    return undefined
-  }
-}
-
-/** Full resolution order: explicit -> remote -> basename. */
-export function deriveWorkspaceKey({ remote, basename, explicit } = {}) {
-  if (typeof explicit === 'string' && explicit.trim() !== '') return sanitizeKey(explicit)
-  const fromRemote = keyFromRemote(remote)
-  if (fromRemote) return fromRemote
-  if (typeof basename === 'string' && basename.trim() !== '') return sanitizeKey(basename)
-  return undefined
-}
+// Stable, portable workspace-key derivation (pure). A workspace key must be
+// identical across devices that check out the same memory repo, even though the
+// local folder path differs. Resolution order: explicit > git remote URL > basename.
+
+/** Normalize any git remote spelling to a lowercase https URL with no trailing .git or slash. */
+export function normalizeRemoteUrl(url) {
+  if (typeof url !== 'string' || url.trim() === '') return undefined
+  let u = url.trim()
+  if (/^[a-z][a-z0-9+.-]*:\/\//i.test(u)) {
+    u = u.replace(/^[a-z][a-z0-9+.-]*:\/\//i, 'https://')
+    u = u.replace(/^https:\/\/[^/@]+@/, 'https://') // strip userinfo
+  } else if (/^[^/\\:@]+@[^/\\:]+:.+/.test(u)) {
+    const i = u.indexOf(':')
+    u = 'https://' + u.slice(0, i).replace(/^[^@]+@/, '') + '/' + u.slice(i + 1)
+  }
+  u = u.replace(/\.git$/i, '')
+  u = u.replace(/\/+$/, '')
+  return u.toLowerCase()
+}
+
+/**
+ * Filesystem-safe slug from a display segment.
+ *
+ * Keeps Unicode letters and digits, replaces everything else with a hyphen. A Latin-only rule
+ * (a-z0-9) was actively harmful: any CJK, Cyrillic or Greek topic slugged to an EMPTY string,
+ * so every such topic collapsed into one file and silently merged unrelated subjects. Keeping
+ * the script is the only lossless option - and pure-ASCII input is unaffected, so existing
+ * slugs and file names do not move.
+ *
+ * Bounded on code points, not UTF-16 units, so a multi-byte name is never cut mid-character.
+ */
+export function slugify(segment) {
+  const raw = String(segment ?? '').trim().toLowerCase()
+  const slug = raw.replace(/[^\p{L}\p{N}]+/gu, '-').replace(/^-+|-+$/g, '')
+  if (slug === '') return ''
+  const points = [...slug]
+  return points.length > 60 ? points.slice(0, 60).join('').replace(/-+$/g, '') : slug
+}
+/** Reject traversal / empty / oversized keys. */
+export function sanitizeKey(key) {
+  if (typeof key !== 'string') return undefined
+  const s = slugify(key)
+  if (!s || s === '.' || s === '..' || s.length > 120) return undefined
+  return s
+}
+
+/** Derive a key from a normalized remote URL; GitHub drops the host, others keep it. */
+export function keyFromRemote(url) {
+  const n = normalizeRemoteUrl(url)
+  if (!n) return undefined
+  try {
+    const u = new URL(n)
+    const p = u.pathname.replace(/^\/+|\/+$/g, '')
+    if (u.hostname === 'github.com') return slugify(p.split('/').join('-'))
+    return slugify(u.hostname.replace(/^www\./, '') + '-' + p.split('/').join('-'))
+  } catch {
+    return undefined
+  }
+}
+
+/** Full resolution order: explicit -> remote -> basename. */
+export function deriveWorkspaceKey({ remote, basename, explicit } = {}) {
+  if (typeof explicit === 'string' && explicit.trim() !== '') return sanitizeKey(explicit)
+  const fromRemote = keyFromRemote(remote)
+  if (fromRemote) return fromRemote
+  if (typeof basename === 'string' && basename.trim() !== '') return sanitizeKey(basename)
+  return undefined
+}

package/src/workspace.js

@@ -1,87 +1,87 @@
-// Workspace association: a portable registry (memory.json, committed) maps
-// key -> {title, remotes, createdAt}; a device-local map (state/associations.json,
-// gitignored) maps key -> {path, workspaceId}. Paths are machine-specific and never
-// committed, so the same store reconciles across devices by remote URL or basename.
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
-import { basename, join } from 'node:path'
-import { workspacesDir, workspaceDir } from './store.js'
-import { deriveWorkspaceKey, sanitizeKey } from './workspace-key.js'
-
-export function associationsPath(root) { return join(root, 'state', 'associations.json') }
-
-export function readAssociations(root) {
-  try { return JSON.parse(readFileSync(associationsPath(root), 'utf8')) }
-  catch { return {} }
-}
-
-export function writeAssociations(root, value) {
-  mkdirSync(join(root, 'state'), { recursive: true })
-  writeFileSync(associationsPath(root), JSON.stringify(value, null, 2) + '\n')
-}
-
-/** Resolution order: explicit > device-local association (by canonical path) > remote > basename. */
-export function resolveKeyFor(root, { cwd, remote, basename, explicit } = {}) {
-  if (explicit) return sanitizeKey(explicit)
-  if (cwd) {
-    const assoc = readAssociations(root)
-    const hit = Object.entries(assoc).find(([, a]) => a.path === cwd)
-    if (hit) return hit[0]
-  }
-  return deriveWorkspaceKey({ remote, basename })
-}
-
-/** Registry + on-disk dirs + device-local associations, merged. */
-export function listWorkspaces(store) {
-  const mem = store.readMemoryJson()
-  const registry = mem.workspaces ?? {}
-  const assoc = readAssociations(store.root)
-  const keys = new Set(Object.keys(registry))
-  const wdir = workspacesDir(store.root)
-  if (existsSync(wdir)) {
-    for (const name of readdirSync(wdir)) {
-      if (existsSync(join(wdir, name, 'meta.json'))) keys.add(name)
-    }
-  }
-  return [...keys].sort().map((key) => {
-    const rec = registry[key] ?? {}
-    return {
-      key,
-      title: rec.title ?? key,
-      remotes: rec.remotes ?? [],
-      createdAt: rec.createdAt,
-      path: assoc[key]?.path,
-      workspaceId: assoc[key]?.workspaceId,
-    }
-  })
-}
-
-/** Associate a key (explicit, or derived from remote/basename) and record it durably. */
-export function associate(store, { key, title, remote, cwd, workspaceId } = {}) {
-  const safe = sanitizeKey(key) ?? deriveWorkspaceKey({ remote, basename: cwd ? basename(cwd) : undefined })
-  if (!safe) throw new Error('cannot derive a workspace key; pass an explicit key')
-  store.ensureWorkspace(safe, { title: title ?? safe, remotes: remote ? [remote] : [] })
-
-  // portable registry (committed to git)
-  const mem = store.readMemoryJson()
-  mem.workspaces = mem.workspaces ?? {}
-  const prev = mem.workspaces[safe] ?? {}
-  mem.workspaces[safe] = {
-    title: title ?? prev.title ?? safe,
-    remotes: remote ? Array.from(new Set([...(prev.remotes ?? []), remote])) : (prev.remotes ?? []),
-    createdAt: prev.createdAt ?? new Date().toISOString(),
-  }
-  store.writeMemoryJson(mem)
-
-  // keep the per-workspace meta.json in sync with the registry
-  writeFileSync(join(workspaceDir(store.root, safe), 'meta.json'), JSON.stringify({
-    key: safe, title: mem.workspaces[safe].title, remotes: mem.workspaces[safe].remotes, createdAt: mem.workspaces[safe].createdAt,
-  }, null, 2) + '\n')
-
-  // device-local association (gitignored)
-  if (cwd || workspaceId) {
-    const assoc = readAssociations(store.root)
-    assoc[safe] = { ...(assoc[safe] ?? {}), ...(cwd ? { path: cwd } : {}), ...(workspaceId ? { workspaceId } : {}) }
-    writeAssociations(store.root, assoc)
-  }
-  return safe
-}
+// Workspace association: a portable registry (memory.json, committed) maps
+// key -> {title, remotes, createdAt}; a device-local map (state/associations.json,
+// gitignored) maps key -> {path, workspaceId}. Paths are machine-specific and never
+// committed, so the same store reconciles across devices by remote URL or basename.
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { basename, join } from 'node:path'
+import { workspacesDir, workspaceDir } from './store.js'
+import { deriveWorkspaceKey, sanitizeKey } from './workspace-key.js'
+
+export function associationsPath(root) { return join(root, 'state', 'associations.json') }
+
+export function readAssociations(root) {
+  try { return JSON.parse(readFileSync(associationsPath(root), 'utf8')) }
+  catch { return {} }
+}
+
+export function writeAssociations(root, value) {
+  mkdirSync(join(root, 'state'), { recursive: true })
+  writeFileSync(associationsPath(root), JSON.stringify(value, null, 2) + '\n')
+}
+
+/** Resolution order: explicit > device-local association (by canonical path) > remote > basename. */
+export function resolveKeyFor(root, { cwd, remote, basename, explicit } = {}) {
+  if (explicit) return sanitizeKey(explicit)
+  if (cwd) {
+    const assoc = readAssociations(root)
+    const hit = Object.entries(assoc).find(([, a]) => a.path === cwd)
+    if (hit) return hit[0]
+  }
+  return deriveWorkspaceKey({ remote, basename })
+}
+
+/** Registry + on-disk dirs + device-local associations, merged. */
+export function listWorkspaces(store) {
+  const mem = store.readMemoryJson()
+  const registry = mem.workspaces ?? {}
+  const assoc = readAssociations(store.root)
+  const keys = new Set(Object.keys(registry))
+  const wdir = workspacesDir(store.root)
+  if (existsSync(wdir)) {
+    for (const name of readdirSync(wdir)) {
+      if (existsSync(join(wdir, name, 'meta.json'))) keys.add(name)
+    }
+  }
+  return [...keys].sort().map((key) => {
+    const rec = registry[key] ?? {}
+    return {
+      key,
+      title: rec.title ?? key,
+      remotes: rec.remotes ?? [],
+      createdAt: rec.createdAt,
+      path: assoc[key]?.path,
+      workspaceId: assoc[key]?.workspaceId,
+    }
+  })
+}
+
+/** Associate a key (explicit, or derived from remote/basename) and record it durably. */
+export function associate(store, { key, title, remote, cwd, workspaceId } = {}) {
+  const safe = sanitizeKey(key) ?? deriveWorkspaceKey({ remote, basename: cwd ? basename(cwd) : undefined })
+  if (!safe) throw new Error('cannot derive a workspace key; pass an explicit key')
+  store.ensureWorkspace(safe, { title: title ?? safe, remotes: remote ? [remote] : [] })
+
+  // portable registry (committed to git)
+  const mem = store.readMemoryJson()
+  mem.workspaces = mem.workspaces ?? {}
+  const prev = mem.workspaces[safe] ?? {}
+  mem.workspaces[safe] = {
+    title: title ?? prev.title ?? safe,
+    remotes: remote ? Array.from(new Set([...(prev.remotes ?? []), remote])) : (prev.remotes ?? []),
+    createdAt: prev.createdAt ?? new Date().toISOString(),
+  }
+  store.writeMemoryJson(mem)
+
+  // keep the per-workspace meta.json in sync with the registry
+  writeFileSync(join(workspaceDir(store.root, safe), 'meta.json'), JSON.stringify({
+    key: safe, title: mem.workspaces[safe].title, remotes: mem.workspaces[safe].remotes, createdAt: mem.workspaces[safe].createdAt,
+  }, null, 2) + '\n')
+
+  // device-local association (gitignored)
+  if (cwd || workspaceId) {
+    const assoc = readAssociations(store.root)
+    assoc[safe] = { ...(assoc[safe] ?? {}), ...(cwd ? { path: cwd } : {}), ...(workspaceId ? { workspaceId } : {}) }
+    writeAssociations(store.root, assoc)
+  }
+  return safe
+}