@elevasis/core 0.7.0 → 0.8.0

package/src/scaffold-registry/index.ts

@@ -3,192 +3,208 @@ import path from 'node:path'
 import { parse as parseYaml } from 'yaml'
 import { type ScaffoldRegistry, type ScaffoldRegistryEntry, ScaffoldRegistrySchema } from './schema'
 
-export { ScaffoldRegistrySchema, ScaffoldEntryKindSchema } from './schema'
-export type { ScaffoldRegistry, ScaffoldRegistryEntry, ScaffoldRef, ScaffoldEntryKind } from './schema'
-
-// ---------------------------------------------------------------------------
-// Paths (resolved relative to the monorepo root, not this file's location)
-// ---------------------------------------------------------------------------
-
-/**
- * Resolve a path relative to the monorepo root.
- * Works whether this module is running from packages/core/src or from dist/.
- */
-function monorepoRoot(): string {
-  // Walk up from __dirname until we find the .claude directory (monorepo marker)
-  const { dirname } = path
-  let dir = __dirname
-  for (let i = 0; i < 8; i++) {
-    try {
-      readFileSync(path.join(dir, '.claude', 'settings.json'))
-      return dir
-    } catch {
-      dir = dirname(dir)
-    }
-  }
-  throw new Error(
-    'scaffold-registry: could not locate monorepo root (no .claude/settings.json found in ancestor directories)'
-  )
-}
-
-const YAML_FILENAME = '.claude/scaffold-registry.yml'
-const JSON_FILENAME = '.claude/scaffold-registry.compiled.json'
-
-// ---------------------------------------------------------------------------
-// Load + validate
-// ---------------------------------------------------------------------------
-
-/**
- * Load and Zod-validate the scaffold registry from `.claude/scaffold-registry.yml`.
- *
- * Throws if:
- * - The YAML file is missing or unreadable
- * - The YAML fails Zod validation
- * - The compiled JSON is present but its `entries` count differs from the YAML
- *   (drift detection — regenerate with `compileScaffoldRegistry()` to fix)
- */
-export function loadScaffoldRegistry(): ScaffoldRegistry {
-  const root = monorepoRoot()
-  const yamlPath = path.join(root, YAML_FILENAME)
-
-  let raw: string
-  try {
-    raw = readFileSync(yamlPath, 'utf-8')
-  } catch (err) {
-    throw new Error(`scaffold-registry: could not read ${YAML_FILENAME} — ${String(err)}`)
-  }
-
-  const parsed = parseYaml(raw) as unknown
-  const result = ScaffoldRegistrySchema.safeParse(parsed)
-
-  if (!result.success) {
-    const issues = result.error.issues.map((i) => `  [${i.path.join('.')}] ${i.message}`).join('\n')
-    throw new Error(`scaffold-registry: YAML validation failed:\n${issues}`)
-  }
-
-  const registry = result.data
-
-  // Drift check: if compiled JSON exists, verify entry count matches
-  const jsonPath = path.join(root, JSON_FILENAME)
-  try {
-    const compiledRaw = readFileSync(jsonPath, 'utf-8')
-    const compiled = JSON.parse(compiledRaw) as { entries?: unknown[] }
-    if (compiled.entries?.length !== registry.entries.length) {
-      throw new Error(
-        `scaffold-registry: compiled JSON is out of sync with YAML ` +
-          `(YAML has ${registry.entries.length} entries, JSON has ${compiled.entries?.length ?? 0}). ` +
-          `Run compileScaffoldRegistry() to regenerate.`
-      )
-    }
-  } catch (err) {
-    // If the file doesn't exist, skip drift check silently (first-run scenario)
-    if ((err as { code?: string }).code !== 'ENOENT') {
-      throw err
-    }
-  }
-
-  return registry
-}
-
-// ---------------------------------------------------------------------------
-// Compile
-// ---------------------------------------------------------------------------
-
-/**
- * Load, validate, and write the pre-compiled JSON lookup file.
- * Run this whenever `.claude/scaffold-registry.yml` changes.
- *
- * Called by the `pnpm scaffold:compile-registry` script (wired in Step 2 CI).
- */
-export function compileScaffoldRegistry(): ScaffoldRegistry {
-  const root = monorepoRoot()
-  const registry = loadScaffoldRegistryNoSyncCheck(root)
-
-  const jsonPath = path.join(root, JSON_FILENAME)
-  writeFileSync(jsonPath, JSON.stringify(registry, null, 2) + '\n', 'utf-8')
-
-  return registry
-}
-
-// ---------------------------------------------------------------------------
-// Lookup helpers (used by hooks for fast path matching)
-// ---------------------------------------------------------------------------
-
-/**
- * Load from the pre-compiled JSON only (fastest path; used by PostToolUse hooks).
- * Falls back to YAML if the JSON is missing.
- */
-export function loadScaffoldRegistryFast(): ScaffoldRegistry {
-  const root = monorepoRoot()
-  const jsonPath = path.join(root, JSON_FILENAME)
-
-  try {
-    const raw = readFileSync(jsonPath, 'utf-8')
-    const parsed = JSON.parse(raw) as unknown
-    const result = ScaffoldRegistrySchema.safeParse(parsed)
-    if (result.success) return result.data
-  } catch {
-    // fall through to YAML
-  }
-
-  return loadScaffoldRegistryNoSyncCheck(root)
-}
-
-/**
- * Return all entries whose `sources` contain at least one pattern that matches
- * the given file path. Pattern matching is a simple substring/glob-prefix check
- * suitable for hook use; Step 3 will upgrade to full micromatch when the hook
- * is implemented.
- */
-export function findMatchingEntries(registry: ScaffoldRegistry, filePath: string): ScaffoldRegistryEntry[] {
-  return registry.entries.filter((entry) => entry.sources.some((pattern) => pathMatchesPattern(filePath, pattern)))
-}
-
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-
-function loadScaffoldRegistryNoSyncCheck(root: string): ScaffoldRegistry {
-  const yamlPath = path.join(root, YAML_FILENAME)
-  let raw: string
-  try {
-    raw = readFileSync(yamlPath, 'utf-8')
-  } catch (err) {
-    throw new Error(`scaffold-registry: could not read ${YAML_FILENAME} — ${String(err)}`)
-  }
-  const parsed = parseYaml(raw) as unknown
-  const result = ScaffoldRegistrySchema.safeParse(parsed)
-  if (!result.success) {
-    const issues = result.error.issues.map((i) => `  [${i.path.join('.')}] ${i.message}`).join('\n')
-    throw new Error(`scaffold-registry: YAML validation failed:\n${issues}`)
-  }
-  return result.data
-}
-
-/**
- * Lightweight pattern match: handles exact paths, directory prefixes, and
- * simple `*` wildcards at the end of a segment. Full micromatch lands in Step 3.
- */
-function pathMatchesPattern(filePath: string, pattern: string): boolean {
-  // Normalize separators
-  const normalizedFile = filePath.replace(/\\/g, '/')
-  const normalizedPattern = pattern.replace(/\\/g, '/')
-
-  // Exact match
-  if (normalizedFile === normalizedPattern) return true
-
-  // If pattern ends with `/**` or `/*`, check prefix
-  if (normalizedPattern.endsWith('/**') || normalizedPattern.endsWith('/*')) {
-    const prefix = normalizedPattern.slice(0, normalizedPattern.lastIndexOf('/*'))
-    return normalizedFile.startsWith(prefix + '/')
-  }
-
-  // If pattern contains `*`, convert to simple regex
-  if (normalizedPattern.includes('*')) {
-    const escaped = normalizedPattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*')
-    return new RegExp(`^${escaped}$`).test(normalizedFile)
-  }
-
-  // Directory prefix match (pattern is a directory)
-  return normalizedFile.startsWith(normalizedPattern + '/')
-}
+export {
+  ExternalSyncCategorySchema,
+  ExternalSyncDeletePolicySchema,
+  ExternalSyncOwnerSchema,
+  ExternalSyncStrategySchema,
+  ScaffoldEntryKindSchema,
+  ScaffoldRegistrySchema
+} from './schema'
+export type {
+  ExternalSyncCategory,
+  ExternalSyncDeletePolicy,
+  ExternalSyncOwner,
+  ExternalSyncStrategy,
+  ScaffoldEntryKind,
+  ScaffoldRef,
+  ScaffoldRegistry,
+  ScaffoldRegistryEntry
+} from './schema'
+
+// ---------------------------------------------------------------------------
+// Paths (resolved relative to the monorepo root, not this file's location)
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve a path relative to the monorepo root.
+ * Works whether this module is running from packages/core/src or from dist/.
+ */
+function monorepoRoot(): string {
+  // Walk up from __dirname until we find the .claude directory (monorepo marker)
+  const { dirname } = path
+  let dir = __dirname
+  for (let i = 0; i < 8; i++) {
+    try {
+      readFileSync(path.join(dir, '.claude', 'settings.json'))
+      return dir
+    } catch {
+      dir = dirname(dir)
+    }
+  }
+  throw new Error(
+    'scaffold-registry: could not locate monorepo root (no .claude/settings.json found in ancestor directories)'
+  )
+}
+
+const YAML_FILENAME = '.claude/scaffold-registry.yml'
+const JSON_FILENAME = '.claude/scaffold-registry.compiled.json'
+
+// ---------------------------------------------------------------------------
+// Load + validate
+// ---------------------------------------------------------------------------
+
+/**
+ * Load and Zod-validate the scaffold registry from `.claude/scaffold-registry.yml`.
+ *
+ * Throws if:
+ * - The YAML file is missing or unreadable
+ * - The YAML fails Zod validation
+ * - The compiled JSON is present but its `entries` count differs from the YAML
+ *   (drift detection — regenerate with `compileScaffoldRegistry()` to fix)
+ */
+export function loadScaffoldRegistry(): ScaffoldRegistry {
+  const root = monorepoRoot()
+  const yamlPath = path.join(root, YAML_FILENAME)
+
+  let raw: string
+  try {
+    raw = readFileSync(yamlPath, 'utf-8')
+  } catch (err) {
+    throw new Error(`scaffold-registry: could not read ${YAML_FILENAME} — ${String(err)}`)
+  }
+
+  const parsed = parseYaml(raw) as unknown
+  const result = ScaffoldRegistrySchema.safeParse(parsed)
+
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  [${i.path.join('.')}] ${i.message}`).join('\n')
+    throw new Error(`scaffold-registry: YAML validation failed:\n${issues}`)
+  }
+
+  const registry = result.data
+
+  // Drift check: if compiled JSON exists, verify entry count matches
+  const jsonPath = path.join(root, JSON_FILENAME)
+  try {
+    const compiledRaw = readFileSync(jsonPath, 'utf-8')
+    const compiled = JSON.parse(compiledRaw) as { entries?: unknown[] }
+    if (compiled.entries?.length !== registry.entries.length) {
+      throw new Error(
+        `scaffold-registry: compiled JSON is out of sync with YAML ` +
+          `(YAML has ${registry.entries.length} entries, JSON has ${compiled.entries?.length ?? 0}). ` +
+          `Run compileScaffoldRegistry() to regenerate.`
+      )
+    }
+  } catch (err) {
+    // If the file doesn't exist, skip drift check silently (first-run scenario)
+    if ((err as { code?: string }).code !== 'ENOENT') {
+      throw err
+    }
+  }
+
+  return registry
+}
+
+// ---------------------------------------------------------------------------
+// Compile
+// ---------------------------------------------------------------------------
+
+/**
+ * Load, validate, and write the pre-compiled JSON lookup file.
+ * Run this whenever `.claude/scaffold-registry.yml` changes.
+ *
+ * Called by the `pnpm scaffold:compile-registry` script (wired in Step 2 CI).
+ */
+export function compileScaffoldRegistry(): ScaffoldRegistry {
+  const root = monorepoRoot()
+  const registry = loadScaffoldRegistryNoSyncCheck(root)
+
+  const jsonPath = path.join(root, JSON_FILENAME)
+  writeFileSync(jsonPath, JSON.stringify(registry, null, 2) + '\n', 'utf-8')
+
+  return registry
+}
+
+// ---------------------------------------------------------------------------
+// Lookup helpers (used by hooks for fast path matching)
+// ---------------------------------------------------------------------------
+
+/**
+ * Load from the pre-compiled JSON only (fastest path; used by PostToolUse hooks).
+ * Falls back to YAML if the JSON is missing.
+ */
+export function loadScaffoldRegistryFast(): ScaffoldRegistry {
+  const root = monorepoRoot()
+  const jsonPath = path.join(root, JSON_FILENAME)
+
+  try {
+    const raw = readFileSync(jsonPath, 'utf-8')
+    const parsed = JSON.parse(raw) as unknown
+    const result = ScaffoldRegistrySchema.safeParse(parsed)
+    if (result.success) return result.data
+  } catch {
+    // fall through to YAML
+  }
+
+  return loadScaffoldRegistryNoSyncCheck(root)
+}
+
+/**
+ * Return all entries whose `sources` contain at least one pattern that matches
+ * the given file path. Pattern matching is a simple substring/glob-prefix check
+ * suitable for hook use; Step 3 will upgrade to full micromatch when the hook
+ * is implemented.
+ */
+export function findMatchingEntries(registry: ScaffoldRegistry, filePath: string): ScaffoldRegistryEntry[] {
+  return registry.entries.filter((entry) => entry.sources.some((pattern) => pathMatchesPattern(filePath, pattern)))
+}
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+function loadScaffoldRegistryNoSyncCheck(root: string): ScaffoldRegistry {
+  const yamlPath = path.join(root, YAML_FILENAME)
+  let raw: string
+  try {
+    raw = readFileSync(yamlPath, 'utf-8')
+  } catch (err) {
+    throw new Error(`scaffold-registry: could not read ${YAML_FILENAME} — ${String(err)}`)
+  }
+  const parsed = parseYaml(raw) as unknown
+  const result = ScaffoldRegistrySchema.safeParse(parsed)
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `  [${i.path.join('.')}] ${i.message}`).join('\n')
+    throw new Error(`scaffold-registry: YAML validation failed:\n${issues}`)
+  }
+  return result.data
+}
+
+/**
+ * Lightweight pattern match: handles exact paths, directory prefixes, and
+ * simple `*` wildcards at the end of a segment. Full micromatch lands in Step 3.
+ */
+function pathMatchesPattern(filePath: string, pattern: string): boolean {
+  // Normalize separators
+  const normalizedFile = filePath.replace(/\\/g, '/')
+  const normalizedPattern = pattern.replace(/\\/g, '/')
+
+  // Exact match
+  if (normalizedFile === normalizedPattern) return true
+
+  // If pattern ends with `/**` or `/*`, check prefix
+  if (normalizedPattern.endsWith('/**') || normalizedPattern.endsWith('/*')) {
+    const prefix = normalizedPattern.slice(0, normalizedPattern.lastIndexOf('/*'))
+    return normalizedFile.startsWith(prefix + '/')
+  }
+
+  // If pattern contains `*`, convert to simple regex
+  if (normalizedPattern.includes('*')) {
+    const escaped = normalizedPattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '[^/]*')
+    return new RegExp(`^${escaped}$`).test(normalizedFile)
+  }
+
+  // Directory prefix match (pattern is a directory)
+  return normalizedFile.startsWith(normalizedPattern + '/')
+}