@m4ike1/ion-cue 0.1.0

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGhF,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAmC7D;AA2BD,MAAM,WAAW,OAAO;IACvB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACpF,OAAO,EAAE,CASX;AAED,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,aAAa,CAAqB;IAE1C,YAAY,eAAe,GAAE,MAAM,EAAO,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAG3E;IAED,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAqBtE;IAED;;;;;OAKG;IACH,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CA0B3C;IAED,OAAO,CAAC,kBAAkB;IAsB1B,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAoB/E;IAED,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrD;IAED,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,GAAG,SAAS,CAWxE;IAED,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC,CAkBzF;IAED,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,eAAe;IAmDvB,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BxD;IAED,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,0BAA0B;IA6BlC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAExC;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAuBnE;IAED;;;OAGG;IACH,OAAO,CAAC,eAAe;IAcvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,IAAI,IAAI,UAAU,EAAE,CAWnB;IAED,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAgBnE;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQzC;IAED;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBpE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1C;IAED,OAAO,CAAC,iBAAiB;CA0BzB","sourcesContent":["import { lstatSync, readdirSync, readFileSync, statSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { join } from \"path\";\nimport { parseElementToml } from \"./toml.ts\";\nimport type { BehavioralDimension, ElementDef, SectionRange } from \"./types.ts\";\nimport { detectCircularUses } from \"./validation.ts\";\n\nexport interface AliasConfig {\n\taliases: Record<string, string>;\n}\n\n/**\n * Parse alias configuration from a cue.toml-style config string.\n * Expects an [aliases] section with key = \"value\" pairs.\n */\nexport function parseAliasConfig(content: string): AliasConfig {\n\tconst aliases: Record<string, string> = {};\n\tconst lines = content.split(\"\\n\");\n\tlet inAliases = false;\n\n\tfor (const line of lines) {\n\t\tconst trimmed = line.trim();\n\t\tif (!trimmed || trimmed.startsWith(\"#\")) continue;\n\n\t\tif (trimmed === \"[aliases]\") {\n\t\t\tinAliases = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Exit aliases section on any other section header\n\t\tif (trimmed.startsWith(\"[\") && trimmed.endsWith(\"]\") && inAliases) {\n\t\t\tinAliases = false;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (inAliases) {\n\t\t\tconst kvMatch = trimmed.match(/^([a-zA-Z0-9_-]+)\\s*=\\s*(.+)$/);\n\t\t\tif (kvMatch) {\n\t\t\t\tconst key = kvMatch[1]!;\n\t\t\t\tlet value = kvMatch[2]!.trim();\n\t\t\t\t// Strip quotes\n\t\t\t\tif ((value.startsWith('\"') && value.endsWith('\"')) || (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n\t\t\t\t\tvalue = value.slice(1, -1);\n\t\t\t\t}\n\t\t\t\taliases[key] = value;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { aliases };\n}\n\nconst VALID_DIMENSIONS: BehavioralDimension[] = [\n\t\"tone\",\n\t\"register\",\n\t\"length\",\n\t\"depth\",\n\t\"structure\",\n\t\"format\",\n\t\"voice\",\n\t\"vocabulary\",\n];\n\ninterface ElementEntry {\n\tdef: ElementDef;\n\ttomlPath: string;\n\tmdPath: string;\n\tsectionIndex?: Map<string, SectionRange>;\n\tmtime?: number;\n}\n\ninterface SharedTagEntry {\n\tpath: string;\n\tsectionIndex?: Map<string, SectionRange>;\n\tmtime?: number;\n}\n\nexport interface CueRoot {\n\t/** Element root directory. */\n\tpath: string;\n\t/** Config scope the root belongs to (drives override matching). */\n\tscope: \"user\" | \"project\";\n}\n\n/**\n * Single source of truth for cue element discovery roots. Used by\n * CueRegistry.discover(), watchedPaths(), and the package manager's\n * resource collection so the config UI lists exactly what will load.\n */\nexport function cueDiscoveryRoots(\n\toptions: { projectRoot?: string; skipHome?: boolean; additionalRoots?: string[] } = {},\n): CueRoot[] {\n\tconst roots: CueRoot[] = (options.additionalRoots ?? []).map((path) => ({ path, scope: \"user\" as const }));\n\tif (!options.skipHome) {\n\t\troots.push({ path: join(homedir(), \".ion\", \"agent\", \"cue\", \"elements\"), scope: \"user\" });\n\t}\n\tif (options.projectRoot) {\n\t\troots.push({ path: join(options.projectRoot, \".ion\", \"cue\", \"elements\"), scope: \"project\" });\n\t}\n\treturn roots;\n}\n\nexport class CueRegistry {\n\tprivate elements = new Map<string, ElementEntry>();\n\tprivate sharedTags = new Map<string, SharedTagEntry>();\n\tprivate realpathCache = new Map<string, string>();\n\tprivate baseRoots: string[];\n\tprivate skipHome: boolean;\n\tprivate disabledNames = new Set<string>();\n\n\tconstructor(additionalRoots: string[] = [], options?: { skipHome?: boolean }) {\n\t\tthis.baseRoots = [...additionalRoots];\n\t\tthis.skipHome = options?.skipHome ?? false;\n\t}\n\n\tprivate computeRoots(projectRoot?: string): string[] {\n\t\treturn cueDiscoveryRoots({\n\t\t\tprojectRoot,\n\t\t\tskipHome: this.skipHome,\n\t\t\tadditionalRoots: this.baseRoots,\n\t\t}).map((r) => r.path);\n\t}\n\n\t/**\n\t * Idempotent: clears all discovered state and re-scans, so it is safe\n\t * to call again when watched files change (see watchedPaths).\n\t * `disabled` holds lowercased element names to skip (config UI toggles).\n\t */\n\tdiscover(projectRoot?: string, options?: { disabled?: string[] }): void {\n\t\tthis.elements.clear();\n\t\tthis.sharedTags.clear();\n\t\tthis.realpathCache.clear();\n\t\tconst roots = this.computeRoots(projectRoot);\n\t\tthis.disabledNames = new Set((options?.disabled ?? []).map((n) => n.toLowerCase()));\n\n\t\tfor (const root of roots) {\n\t\t\tthis.discoverFromRoot(root);\n\t\t}\n\n\t\tthis.discoverSharedTags(roots);\n\n\t\tconst defs = new Map<string, ElementDef>();\n\t\tfor (const [name, entry] of this.elements) {\n\t\t\tdefs.set(name, entry.def);\n\t\t}\n\t\tconst circularErrors = detectCircularUses(defs);\n\t\tfor (const err of circularErrors) {\n\t\t\tconsole.warn(err);\n\t\t}\n\t}\n\n\t/**\n\t * Existing directories whose changes invalidate discovery: element\n\t * roots, shared-tags dirs, and cue.toml parents. Callers watch these\n\t * (non-recursively) and call discover() again on change, then re-arm\n\t * to pick up newly created subdirectories.\n\t */\n\twatchedPaths(projectRoot?: string): string[] {\n\t\tconst dirs = new Set<string>();\n\t\tconst roots = this.computeRoots(projectRoot);\n\t\tfor (const root of roots) {\n\t\t\tdirs.add(root);\n\t\t\tdirs.add(join(root, \"..\", \"tags\"));\n\t\t\ttry {\n\t\t\t\tfor (const entry of readdirSync(root, { withFileTypes: true })) {\n\t\t\t\t\tif (entry.isDirectory()) dirs.add(join(root, entry.name));\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Root does not exist yet; the parent re-arm covers its creation.\n\t\t\t}\n\t\t}\n\t\t// Alias configs live next to the elements roots.\n\t\tif (!this.skipHome) dirs.add(join(homedir(), \".ion\", \"agent\", \"cue\"));\n\t\tif (projectRoot) dirs.add(join(projectRoot, \".ion\", \"cue\"));\n\t\tconst existing: string[] = [];\n\t\tfor (const dir of dirs) {\n\t\t\ttry {\n\t\t\t\tif (statSync(dir).isDirectory() && !existing.includes(dir)) existing.push(dir);\n\t\t\t} catch {\n\t\t\t\t// Does not exist yet; covered when the parent appears.\n\t\t\t}\n\t\t}\n\t\treturn existing;\n\t}\n\n\tprivate discoverSharedTags(roots: string[]): void {\n\t\tconst tagsDirs = [join(homedir(), \".ion\", \"agent\", \"cue\", \"tags\"), ...roots.map((r) => join(r, \"..\", \"tags\"))];\n\n\t\tfor (const tagsDir of tagsDirs) {\n\t\t\tlet entries: string[];\n\t\t\ttry {\n\t\t\t\tentries = readdirSync(tagsDir);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tfor (const file of entries) {\n\t\t\t\tif (!file.endsWith(\".md\")) continue;\n\t\t\t\tconst tagName = file.slice(0, -3).toLowerCase();\n\t\t\t\tif (this.sharedTags.has(tagName)) continue;\n\n\t\t\t\tconst filePath = join(tagsDir, file);\n\t\t\t\tthis.sharedTags.set(tagName, { path: filePath });\n\t\t\t}\n\t\t}\n\t}\n\n\tgetSharedTagSectionIndex(tagName: string): Map<string, SectionRange> | undefined {\n\t\tconst entry = this.sharedTags.get(tagName.toLowerCase());\n\t\tif (!entry) return undefined;\n\n\t\ttry {\n\t\t\tconst stat = statSync(entry.path);\n\t\t\tconst currentMtime = stat.mtimeMs;\n\n\t\t\tif (entry.sectionIndex && entry.mtime === currentMtime) {\n\t\t\t\treturn entry.sectionIndex;\n\t\t\t}\n\n\t\t\tconst body = readFileSync(entry.path, \"utf-8\");\n\t\t\tconst index = this.buildSectionIndex(body);\n\t\t\tentry.sectionIndex = index;\n\t\t\tentry.mtime = currentMtime;\n\t\t\treturn index;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tloadSharedTagBody(tagName: string): string | undefined {\n\t\tconst entry = this.sharedTags.get(tagName.toLowerCase());\n\t\tif (!entry) return undefined;\n\t\ttry {\n\t\t\treturn readFileSync(entry.path, \"utf-8\");\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tgetSharedTagOverrides(tagName: string): BehavioralDimension[] | undefined {\n\t\tconst entry = this.sharedTags.get(tagName.toLowerCase());\n\t\tif (!entry) return undefined;\n\n\t\ttry {\n\t\t\tconst body = readFileSync(entry.path, \"utf-8\");\n\t\t\tconst fm = parseFrontmatter(body);\n\t\t\treturn fm.overrides.length > 0 ? fm.overrides : undefined;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tgetSharedTagDefs(): Map<string, { description: string; overrides: BehavioralDimension[] }> {\n\t\tconst defs = new Map<string, { description: string; overrides: BehavioralDimension[] }>();\n\n\t\tfor (const [name, entry] of this.sharedTags) {\n\t\t\ttry {\n\t\t\t\tconst body = readFileSync(entry.path, \"utf-8\");\n\t\t\t\tconst fm = parseFrontmatter(body);\n\n\t\t\t\tif (!fm.description) {\n\t\t\t\t\tconst descMatch = body.match(/^##\\s+(?:Tag:\\s+)?[^\\n]+\\n+([^\\n#]+)/m);\n\t\t\t\t\tif (descMatch) fm.description = descMatch[1].trim();\n\t\t\t\t}\n\n\t\t\t\tdefs.set(name, fm);\n\t\t\t} catch {}\n\t\t}\n\n\t\treturn defs;\n\t}\n\n\tprivate discoverFromRoot(root: string): void {\n\t\tlet entries: string[];\n\t\ttry {\n\t\t\tentries = readdirSync(root);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\n\t\tconst rootTomls: string[] = [];\n\n\t\tfor (const authorDir of entries) {\n\t\t\tconst authorPath = join(root, authorDir);\n\t\t\tlet isDir = false;\n\t\t\ttry {\n\t\t\t\tisDir = statSync(authorPath).isDirectory();\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!isDir) {\n\t\t\t\tif (authorDir.endsWith(\".toml\")) rootTomls.push(authorDir);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tlet authorEntries: string[];\n\t\t\ttry {\n\t\t\t\tauthorEntries = readdirSync(authorPath);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tfor (const entry of authorEntries) {\n\t\t\t\tif (!entry.endsWith(\".toml\")) continue;\n\t\t\t\tthis.registerElement(authorPath, entry);\n\t\t\t}\n\t\t}\n\n\t\tfor (const entry of rootTomls) {\n\t\t\tthis.registerElement(root, entry);\n\t\t}\n\t}\n\n\tprivate registerElement(dir: string, tomlFile: string): void {\n\t\tconst name = tomlFile.slice(0, -5);\n\t\tif (this.disabledNames.has(name.toLowerCase())) return;\n\t\tconst tomlPath = join(dir, tomlFile);\n\t\tconst mdPath = join(dir, `${name}.md`);\n\n\t\ttry {\n\t\t\tstatSync(mdPath);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\n\t\tconst realToml = this.resolveRealpath(tomlPath);\n\t\tif (this.isDuplicate(realToml)) return;\n\n\t\tconst content = readFileSync(tomlPath, \"utf-8\");\n\t\tconst def = parseElementToml(content);\n\n\t\tconst normalized = def.name.toLowerCase();\n\t\tconst versionedKey = def.version ? `${normalized}@${def.version}` : normalized;\n\n\t\t// Store versioned entry\n\t\tif (this.elements.has(versionedKey)) {\n\t\t\tconsole.warn(`Element \"${def.name}@${def.version}\" from ${tomlPath} shadowed by earlier definition; skipping`);\n\t\t\treturn;\n\t\t}\n\n\t\tthis.validateElement(def);\n\n\t\ttry {\n\t\t\tconst mdBody = readFileSync(mdPath, \"utf-8\");\n\t\t\tthis.validateTagHeaderAlignment(def, mdBody, normalized);\n\t\t} catch {\n\t\t\t// md read failure already handled by missing stat above\n\t\t}\n\n\t\tconst entry: ElementEntry = { def, tomlPath, mdPath };\n\t\tthis.elements.set(versionedKey, entry);\n\n\t\t// Also store under plain name if this is the latest version or first registration\n\t\tif (!this.elements.has(normalized)) {\n\t\t\tthis.elements.set(normalized, entry);\n\t\t} else {\n\t\t\t// Compare versions: keep the latest under the plain name\n\t\t\tconst existing = this.elements.get(normalized)!;\n\t\t\tif (def.version && existing.def.version && this.compareVersions(def.version, existing.def.version) > 0) {\n\t\t\t\tthis.elements.set(normalized, entry);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate resolveRealpath(path: string): string {\n\t\tconst cached = this.realpathCache.get(path);\n\t\tif (cached) return cached;\n\n\t\tlet real: string;\n\t\ttry {\n\t\t\tconst stat = lstatSync(path);\n\t\t\tif (stat.isSymbolicLink()) {\n\t\t\t\tconst { realpathSync } = require(\"fs\");\n\t\t\t\treal = realpathSync(path);\n\t\t\t} else {\n\t\t\t\treal = path;\n\t\t\t}\n\t\t} catch {\n\t\t\treal = path;\n\t\t}\n\n\t\tthis.realpathCache.set(path, real);\n\t\treturn real;\n\t}\n\n\tprivate isDuplicate(realpath: string): boolean {\n\t\tfor (const entry of this.elements.values()) {\n\t\t\tif (this.resolveRealpath(entry.tomlPath) === realpath) return true;\n\t\t}\n\t\treturn false;\n\t}\n\n\t/**\n\t * Load aliases from cue.toml config files in project root.\n\t * Project-level aliases override home-level aliases.\n\t */\n\tloadAliases(projectRoot?: string): Record<string, string> {\n\t\tconst aliases: Record<string, string> = {};\n\n\t\t// Home directory config\n\t\tif (!this.skipHome) {\n\t\t\tconst homeConfig = join(homedir(), \".ion\", \"agent\", \"cue\", \"cue.toml\");\n\t\t\ttry {\n\t\t\t\tconst content = readFileSync(homeConfig, \"utf-8\");\n\t\t\t\tconst parsed = parseAliasConfig(content);\n\t\t\t\tObject.assign(aliases, parsed.aliases);\n\t\t\t} catch {\n\t\t\t\t// Config file doesn't exist or unreadable, skip\n\t\t\t}\n\t\t}\n\n\t\t// Project directory config (overrides home)\n\t\tif (projectRoot) {\n\t\t\tconst projectConfig = join(projectRoot, \".ion\", \"cue\", \"cue.toml\");\n\t\t\ttry {\n\t\t\t\tconst content = readFileSync(projectConfig, \"utf-8\");\n\t\t\t\tconst parsed = parseAliasConfig(content);\n\t\t\t\tObject.assign(aliases, parsed.aliases);\n\t\t\t} catch {\n\t\t\t\t// Config file doesn't exist or unreadable, skip\n\t\t\t}\n\t\t}\n\n\t\treturn aliases;\n\t}\n\n\tprivate validateElement(def: ElementDef): void {\n\t\tif (def.class === \"harness\" && !def.handler) {\n\t\t\tconsole.warn(`Element \"${def.name}\" has class harness but no handler`);\n\t\t}\n\n\t\tfor (const [tagName, tagDef] of Object.entries(def.tags)) {\n\t\t\tfor (const dim of tagDef.overrides) {\n\t\t\t\tif (!VALID_DIMENSIONS.includes(dim)) {\n\t\t\t\t\tconsole.warn(`Element \"${def.name}\" tag \"${tagName}\" has invalid override dimension: ${dim}`);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate validateTagHeaderAlignment(def: ElementDef, body: string, elementName: string): void {\n\t\tconst headerRe = /^##\\s+Tag:\\s+(.+)$/gm;\n\t\tconst headerTags = new Map<string, string>();\n\n\t\tfor (let match = headerRe.exec(body); match !== null; match = headerRe.exec(body)) {\n\t\t\tconst originalName = match[1].trim();\n\t\t\tconst normalizedName = originalName.toLowerCase().replace(/\\s+/g, \"-\");\n\t\t\theaderTags.set(normalizedName, originalName);\n\t\t}\n\n\t\tconst tomlTags = new Set(Object.keys(def.tags).map((t) => t.toLowerCase()));\n\n\t\tfor (const [normalizedTag, originalTag] of headerTags) {\n\t\t\tif (!tomlTags.has(normalizedTag)) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`Element \"${elementName}\" has orphan tag header \"## Tag: ${originalTag}\" with no [tags.${normalizedTag}] TOML entry`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\tfor (const tag of tomlTags) {\n\t\t\tif (!headerTags.has(tag)) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`Element \"${elementName}\" has undeclared [tags.${tag}] TOML entry with no matching \"## Tag:\" header`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\n\tget(name: string): ElementDef | undefined {\n\t\treturn this.elements.get(name.toLowerCase())?.def;\n\t}\n\n\t/**\n\t * Get an element by name and optional version.\n\t * If version is provided, tries to find the exact version first, then falls back to latest compatible.\n\t * If version is not provided, returns the latest version.\n\t */\n\tgetByVersion(name: string, version?: string): ElementDef | undefined {\n\t\tconst normalized = name.toLowerCase();\n\n\t\tif (!version) {\n\t\t\t// No version pin: return latest\n\t\t\treturn this.elements.get(normalized)?.def;\n\t\t}\n\n\t\t// Try exact version match first\n\t\tconst versionedKey = `${normalized}@${version}`;\n\t\tconst exact = this.elements.get(versionedKey);\n\t\tif (exact) return exact.def;\n\n\t\t// Try prefix match for semver (e.g., \"1.2\" matches \"1.2.x\")\n\t\tconst prefix = version.endsWith(\".\") ? version : `${version}.`;\n\t\tfor (const [key, entry] of this.elements) {\n\t\t\tif (key.startsWith(`${normalized}@`) && key.slice(normalized.length + 1).startsWith(prefix)) {\n\t\t\t\treturn entry.def;\n\t\t\t}\n\t\t}\n\n\t\t// Fall back to latest\n\t\treturn this.elements.get(normalized)?.def;\n\t}\n\n\t/**\n\t * Compare two semver versions.\n\t * Returns positive if a > b, negative if a < b, 0 if equal.\n\t */\n\tprivate compareVersions(a: string, b: string): number {\n\t\tconst parseVersion = (v: string) => {\n\t\t\tconst parts = v.split(\".\").map((p) => parseInt(p, 10) || 0);\n\t\t\treturn { major: parts[0] ?? 0, minor: parts[1] ?? 0, patch: parts[2] ?? 0 };\n\t\t};\n\n\t\tconst va = parseVersion(a);\n\t\tconst vb = parseVersion(b);\n\n\t\tif (va.major !== vb.major) return va.major - vb.major;\n\t\tif (va.minor !== vb.minor) return va.minor - vb.minor;\n\t\treturn va.patch - vb.patch;\n\t}\n\n\thas(name: string): boolean {\n\t\treturn this.elements.has(name.toLowerCase());\n\t}\n\n\tlist(): ElementDef[] {\n\t\t// Deduplicate: versioned keys and plain-name keys point to the same entry.\n\t\t// Return only one entry per element by tracking seen toml paths.\n\t\tconst seen = new Set<string>();\n\t\tconst result: ElementDef[] = [];\n\t\tfor (const entry of this.elements.values()) {\n\t\t\tif (seen.has(entry.tomlPath)) continue;\n\t\t\tseen.add(entry.tomlPath);\n\t\t\tresult.push(entry.def);\n\t\t}\n\t\treturn result;\n\t}\n\n\tgetSectionIndex(name: string): Map<string, SectionRange> | undefined {\n\t\tconst entry = this.elements.get(name.toLowerCase());\n\t\tif (!entry) return undefined;\n\n\t\tconst stat = statSync(entry.mdPath);\n\t\tconst currentMtime = stat.mtimeMs;\n\n\t\tif (entry.sectionIndex && entry.mtime === currentMtime) {\n\t\t\treturn entry.sectionIndex;\n\t\t}\n\n\t\tconst body = readFileSync(entry.mdPath, \"utf-8\");\n\t\tconst index = this.buildSectionIndex(body);\n\t\tentry.sectionIndex = index;\n\t\tentry.mtime = currentMtime;\n\t\treturn index;\n\t}\n\n\tloadBody(name: string): string | undefined {\n\t\tconst entry = this.elements.get(name.toLowerCase());\n\t\tif (!entry) return undefined;\n\t\ttry {\n\t\t\treturn readFileSync(entry.mdPath, \"utf-8\");\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/**\n\t * Load body for a specific version of an element.\n\t */\n\tloadBodyByVersion(name: string, version?: string): string | undefined {\n\t\tconst normalized = name.toLowerCase();\n\n\t\tif (!version) {\n\t\t\treturn this.loadBody(name);\n\t\t}\n\n\t\t// Try exact version match first\n\t\tconst versionedKey = `${normalized}@${version}`;\n\t\tconst exact = this.elements.get(versionedKey);\n\t\tif (exact) {\n\t\t\ttry {\n\t\t\t\treturn readFileSync(exact.mdPath, \"utf-8\");\n\t\t\t} catch {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t}\n\n\t\t// Fall back to latest\n\t\treturn this.loadBody(name);\n\t}\n\n\tgetMdPath(name: string): string | undefined {\n\t\treturn this.elements.get(name.toLowerCase())?.mdPath;\n\t}\n\n\tprivate buildSectionIndex(body: string): Map<string, SectionRange> {\n\t\tconst index = new Map<string, SectionRange>();\n\t\tconst headerRe = /^##\\s+(?:Tag:\\s+)?(.+)$/gm;\n\t\tconst headerPositions: Array<{ name: string; pos: number }> = [];\n\n\t\tfor (let match = headerRe.exec(body); match !== null; match = headerRe.exec(body)) {\n\t\t\theaderPositions.push({ name: match[1].trim(), pos: match.index });\n\t\t}\n\n\t\tfor (let i = 0; i < headerPositions.length; i++) {\n\t\t\tconst start = headerPositions[i].pos;\n\t\t\tconst end = i + 1 < headerPositions.length ? headerPositions[i + 1].pos : body.length;\n\t\t\tconst name = headerPositions[i].name;\n\n\t\t\tif (name.toLowerCase() === \"default behavior\") {\n\t\t\t\tindex.set(\"default\", { start, end, tag: \"default\" });\n\t\t\t} else if (name.toLowerCase().startsWith(\"tag:\")) {\n\t\t\t\tconst tag = name.slice(4).trim();\n\t\t\t\tindex.set(tag.toLowerCase(), { start, end, tag });\n\t\t\t} else {\n\t\t\t\tindex.set(name.toLowerCase(), { start, end, tag: name });\n\t\t\t}\n\t\t}\n\n\t\treturn index;\n\t}\n}\n\nfunction parseFrontmatter(body: string): { description: string; overrides: BehavioralDimension[] } {\n\tconst result: { description: string; overrides: BehavioralDimension[] } = { description: \"\", overrides: [] };\n\n\tconst fmMatch = body.match(/^---\\s*\\n([\\s\\S]*?)\\n---/);\n\tif (!fmMatch) return result;\n\n\tconst fm = fmMatch[1];\n\tfor (const line of fm.split(\"\\n\")) {\n\t\tconst trimmed = line.trim();\n\t\tif (!trimmed || trimmed.startsWith(\"#\")) continue;\n\n\t\tconst kvMatch = trimmed.match(/^([a-zA-Z_-]+)\\s*[:=]\\s*(.+)$/);\n\t\tif (!kvMatch) continue;\n\n\t\tconst [, key, valueStr] = kvMatch;\n\t\tif (key === \"description\") {\n\t\t\tresult.description = valueStr\n\t\t\t\t.trim()\n\t\t\t\t.replace(/^\"(.*)\"$/, \"$1\")\n\t\t\t\t.replace(/^'(.*)'$/, \"$1\");\n\t\t} else if (key === \"overrides\") {\n\t\t\tconst inner = valueStr.trim();\n\t\t\tif (inner.startsWith(\"[\") && inner.endsWith(\"]\")) {\n\t\t\t\tresult.overrides = inner\n\t\t\t\t\t.slice(1, -1)\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((s) =>\n\t\t\t\t\t\ts\n\t\t\t\t\t\t\t.trim()\n\t\t\t\t\t\t\t.replace(/^\"(.*)\"$/, \"$1\")\n\t\t\t\t\t\t\t.replace(/^'(.*)'$/, \"$1\"),\n\t\t\t\t\t)\n\t\t\t\t\t.filter(Boolean) as BehavioralDimension[];\n\t\t\t}\n\t\t}\n\t}\n\n\treturn result;\n}\n"]}

package/dist/registry.js

@@ -0,0 +1,582 @@
+import { lstatSync, readdirSync, readFileSync, statSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { parseElementToml } from "./toml.js";
+import { detectCircularUses } from "./validation.js";
+/**
+ * Parse alias configuration from a cue.toml-style config string.
+ * Expects an [aliases] section with key = "value" pairs.
+ */
+export function parseAliasConfig(content) {
+    const aliases = {};
+    const lines = content.split("\n");
+    let inAliases = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        if (trimmed === "[aliases]") {
+            inAliases = true;
+            continue;
+        }
+        // Exit aliases section on any other section header
+        if (trimmed.startsWith("[") && trimmed.endsWith("]") && inAliases) {
+            inAliases = false;
+            continue;
+        }
+        if (inAliases) {
+            const kvMatch = trimmed.match(/^([a-zA-Z0-9_-]+)\s*=\s*(.+)$/);
+            if (kvMatch) {
+                const key = kvMatch[1];
+                let value = kvMatch[2].trim();
+                // Strip quotes
+                if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                aliases[key] = value;
+            }
+        }
+    }
+    return { aliases };
+}
+const VALID_DIMENSIONS = [
+    "tone",
+    "register",
+    "length",
+    "depth",
+    "structure",
+    "format",
+    "voice",
+    "vocabulary",
+];
+/**
+ * Single source of truth for cue element discovery roots. Used by
+ * CueRegistry.discover(), watchedPaths(), and the package manager's
+ * resource collection so the config UI lists exactly what will load.
+ */
+export function cueDiscoveryRoots(options = {}) {
+    const roots = (options.additionalRoots ?? []).map((path) => ({ path, scope: "user" }));
+    if (!options.skipHome) {
+        roots.push({ path: join(homedir(), ".ion", "agent", "cue", "elements"), scope: "user" });
+    }
+    if (options.projectRoot) {
+        roots.push({ path: join(options.projectRoot, ".ion", "cue", "elements"), scope: "project" });
+    }
+    return roots;
+}
+export class CueRegistry {
+    elements = new Map();
+    sharedTags = new Map();
+    realpathCache = new Map();
+    baseRoots;
+    skipHome;
+    disabledNames = new Set();
+    constructor(additionalRoots = [], options) {
+        this.baseRoots = [...additionalRoots];
+        this.skipHome = options?.skipHome ?? false;
+    }
+    computeRoots(projectRoot) {
+        return cueDiscoveryRoots({
+            projectRoot,
+            skipHome: this.skipHome,
+            additionalRoots: this.baseRoots,
+        }).map((r) => r.path);
+    }
+    /**
+     * Idempotent: clears all discovered state and re-scans, so it is safe
+     * to call again when watched files change (see watchedPaths).
+     * `disabled` holds lowercased element names to skip (config UI toggles).
+     */
+    discover(projectRoot, options) {
+        this.elements.clear();
+        this.sharedTags.clear();
+        this.realpathCache.clear();
+        const roots = this.computeRoots(projectRoot);
+        this.disabledNames = new Set((options?.disabled ?? []).map((n) => n.toLowerCase()));
+        for (const root of roots) {
+            this.discoverFromRoot(root);
+        }
+        this.discoverSharedTags(roots);
+        const defs = new Map();
+        for (const [name, entry] of this.elements) {
+            defs.set(name, entry.def);
+        }
+        const circularErrors = detectCircularUses(defs);
+        for (const err of circularErrors) {
+            console.warn(err);
+        }
+    }
+    /**
+     * Existing directories whose changes invalidate discovery: element
+     * roots, shared-tags dirs, and cue.toml parents. Callers watch these
+     * (non-recursively) and call discover() again on change, then re-arm
+     * to pick up newly created subdirectories.
+     */
+    watchedPaths(projectRoot) {
+        const dirs = new Set();
+        const roots = this.computeRoots(projectRoot);
+        for (const root of roots) {
+            dirs.add(root);
+            dirs.add(join(root, "..", "tags"));
+            try {
+                for (const entry of readdirSync(root, { withFileTypes: true })) {
+                    if (entry.isDirectory())
+                        dirs.add(join(root, entry.name));
+                }
+            }
+            catch {
+                // Root does not exist yet; the parent re-arm covers its creation.
+            }
+        }
+        // Alias configs live next to the elements roots.
+        if (!this.skipHome)
+            dirs.add(join(homedir(), ".ion", "agent", "cue"));
+        if (projectRoot)
+            dirs.add(join(projectRoot, ".ion", "cue"));
+        const existing = [];
+        for (const dir of dirs) {
+            try {
+                if (statSync(dir).isDirectory() && !existing.includes(dir))
+                    existing.push(dir);
+            }
+            catch {
+                // Does not exist yet; covered when the parent appears.
+            }
+        }
+        return existing;
+    }
+    discoverSharedTags(roots) {
+        const tagsDirs = [join(homedir(), ".ion", "agent", "cue", "tags"), ...roots.map((r) => join(r, "..", "tags"))];
+        for (const tagsDir of tagsDirs) {
+            let entries;
+            try {
+                entries = readdirSync(tagsDir);
+            }
+            catch {
+                continue;
+            }
+            for (const file of entries) {
+                if (!file.endsWith(".md"))
+                    continue;
+                const tagName = file.slice(0, -3).toLowerCase();
+                if (this.sharedTags.has(tagName))
+                    continue;
+                const filePath = join(tagsDir, file);
+                this.sharedTags.set(tagName, { path: filePath });
+            }
+        }
+    }
+    getSharedTagSectionIndex(tagName) {
+        const entry = this.sharedTags.get(tagName.toLowerCase());
+        if (!entry)
+            return undefined;
+        try {
+            const stat = statSync(entry.path);
+            const currentMtime = stat.mtimeMs;
+            if (entry.sectionIndex && entry.mtime === currentMtime) {
+                return entry.sectionIndex;
+            }
+            const body = readFileSync(entry.path, "utf-8");
+            const index = this.buildSectionIndex(body);
+            entry.sectionIndex = index;
+            entry.mtime = currentMtime;
+            return index;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    loadSharedTagBody(tagName) {
+        const entry = this.sharedTags.get(tagName.toLowerCase());
+        if (!entry)
+            return undefined;
+        try {
+            return readFileSync(entry.path, "utf-8");
+        }
+        catch {
+            return undefined;
+        }
+    }
+    getSharedTagOverrides(tagName) {
+        const entry = this.sharedTags.get(tagName.toLowerCase());
+        if (!entry)
+            return undefined;
+        try {
+            const body = readFileSync(entry.path, "utf-8");
+            const fm = parseFrontmatter(body);
+            return fm.overrides.length > 0 ? fm.overrides : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    getSharedTagDefs() {
+        const defs = new Map();
+        for (const [name, entry] of this.sharedTags) {
+            try {
+                const body = readFileSync(entry.path, "utf-8");
+                const fm = parseFrontmatter(body);
+                if (!fm.description) {
+                    const descMatch = body.match(/^##\s+(?:Tag:\s+)?[^\n]+\n+([^\n#]+)/m);
+                    if (descMatch)
+                        fm.description = descMatch[1].trim();
+                }
+                defs.set(name, fm);
+            }
+            catch { }
+        }
+        return defs;
+    }
+    discoverFromRoot(root) {
+        let entries;
+        try {
+            entries = readdirSync(root);
+        }
+        catch {
+            return;
+        }
+        const rootTomls = [];
+        for (const authorDir of entries) {
+            const authorPath = join(root, authorDir);
+            let isDir = false;
+            try {
+                isDir = statSync(authorPath).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (!isDir) {
+                if (authorDir.endsWith(".toml"))
+                    rootTomls.push(authorDir);
+                continue;
+            }
+            let authorEntries;
+            try {
+                authorEntries = readdirSync(authorPath);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of authorEntries) {
+                if (!entry.endsWith(".toml"))
+                    continue;
+                this.registerElement(authorPath, entry);
+            }
+        }
+        for (const entry of rootTomls) {
+            this.registerElement(root, entry);
+        }
+    }
+    registerElement(dir, tomlFile) {
+        const name = tomlFile.slice(0, -5);
+        if (this.disabledNames.has(name.toLowerCase()))
+            return;
+        const tomlPath = join(dir, tomlFile);
+        const mdPath = join(dir, `${name}.md`);
+        try {
+            statSync(mdPath);
+        }
+        catch {
+            return;
+        }
+        const realToml = this.resolveRealpath(tomlPath);
+        if (this.isDuplicate(realToml))
+            return;
+        const content = readFileSync(tomlPath, "utf-8");
+        const def = parseElementToml(content);
+        const normalized = def.name.toLowerCase();
+        const versionedKey = def.version ? `${normalized}@${def.version}` : normalized;
+        // Store versioned entry
+        if (this.elements.has(versionedKey)) {
+            console.warn(`Element "${def.name}@${def.version}" from ${tomlPath} shadowed by earlier definition; skipping`);
+            return;
+        }
+        this.validateElement(def);
+        try {
+            const mdBody = readFileSync(mdPath, "utf-8");
+            this.validateTagHeaderAlignment(def, mdBody, normalized);
+        }
+        catch {
+            // md read failure already handled by missing stat above
+        }
+        const entry = { def, tomlPath, mdPath };
+        this.elements.set(versionedKey, entry);
+        // Also store under plain name if this is the latest version or first registration
+        if (!this.elements.has(normalized)) {
+            this.elements.set(normalized, entry);
+        }
+        else {
+            // Compare versions: keep the latest under the plain name
+            const existing = this.elements.get(normalized);
+            if (def.version && existing.def.version && this.compareVersions(def.version, existing.def.version) > 0) {
+                this.elements.set(normalized, entry);
+            }
+        }
+    }
+    resolveRealpath(path) {
+        const cached = this.realpathCache.get(path);
+        if (cached)
+            return cached;
+        let real;
+        try {
+            const stat = lstatSync(path);
+            if (stat.isSymbolicLink()) {
+                const { realpathSync } = require("fs");
+                real = realpathSync(path);
+            }
+            else {
+                real = path;
+            }
+        }
+        catch {
+            real = path;
+        }
+        this.realpathCache.set(path, real);
+        return real;
+    }
+    isDuplicate(realpath) {
+        for (const entry of this.elements.values()) {
+            if (this.resolveRealpath(entry.tomlPath) === realpath)
+                return true;
+        }
+        return false;
+    }
+    /**
+     * Load aliases from cue.toml config files in project root.
+     * Project-level aliases override home-level aliases.
+     */
+    loadAliases(projectRoot) {
+        const aliases = {};
+        // Home directory config
+        if (!this.skipHome) {
+            const homeConfig = join(homedir(), ".ion", "agent", "cue", "cue.toml");
+            try {
+                const content = readFileSync(homeConfig, "utf-8");
+                const parsed = parseAliasConfig(content);
+                Object.assign(aliases, parsed.aliases);
+            }
+            catch {
+                // Config file doesn't exist or unreadable, skip
+            }
+        }
+        // Project directory config (overrides home)
+        if (projectRoot) {
+            const projectConfig = join(projectRoot, ".ion", "cue", "cue.toml");
+            try {
+                const content = readFileSync(projectConfig, "utf-8");
+                const parsed = parseAliasConfig(content);
+                Object.assign(aliases, parsed.aliases);
+            }
+            catch {
+                // Config file doesn't exist or unreadable, skip
+            }
+        }
+        return aliases;
+    }
+    validateElement(def) {
+        if (def.class === "harness" && !def.handler) {
+            console.warn(`Element "${def.name}" has class harness but no handler`);
+        }
+        for (const [tagName, tagDef] of Object.entries(def.tags)) {
+            for (const dim of tagDef.overrides) {
+                if (!VALID_DIMENSIONS.includes(dim)) {
+                    console.warn(`Element "${def.name}" tag "${tagName}" has invalid override dimension: ${dim}`);
+                }
+            }
+        }
+    }
+    validateTagHeaderAlignment(def, body, elementName) {
+        const headerRe = /^##\s+Tag:\s+(.+)$/gm;
+        const headerTags = new Map();
+        for (let match = headerRe.exec(body); match !== null; match = headerRe.exec(body)) {
+            const originalName = match[1].trim();
+            const normalizedName = originalName.toLowerCase().replace(/\s+/g, "-");
+            headerTags.set(normalizedName, originalName);
+        }
+        const tomlTags = new Set(Object.keys(def.tags).map((t) => t.toLowerCase()));
+        for (const [normalizedTag, originalTag] of headerTags) {
+            if (!tomlTags.has(normalizedTag)) {
+                console.warn(`Element "${elementName}" has orphan tag header "## Tag: ${originalTag}" with no [tags.${normalizedTag}] TOML entry`);
+            }
+        }
+        for (const tag of tomlTags) {
+            if (!headerTags.has(tag)) {
+                console.warn(`Element "${elementName}" has undeclared [tags.${tag}] TOML entry with no matching "## Tag:" header`);
+            }
+        }
+    }
+    get(name) {
+        return this.elements.get(name.toLowerCase())?.def;
+    }
+    /**
+     * Get an element by name and optional version.
+     * If version is provided, tries to find the exact version first, then falls back to latest compatible.
+     * If version is not provided, returns the latest version.
+     */
+    getByVersion(name, version) {
+        const normalized = name.toLowerCase();
+        if (!version) {
+            // No version pin: return latest
+            return this.elements.get(normalized)?.def;
+        }
+        // Try exact version match first
+        const versionedKey = `${normalized}@${version}`;
+        const exact = this.elements.get(versionedKey);
+        if (exact)
+            return exact.def;
+        // Try prefix match for semver (e.g., "1.2" matches "1.2.x")
+        const prefix = version.endsWith(".") ? version : `${version}.`;
+        for (const [key, entry] of this.elements) {
+            if (key.startsWith(`${normalized}@`) && key.slice(normalized.length + 1).startsWith(prefix)) {
+                return entry.def;
+            }
+        }
+        // Fall back to latest
+        return this.elements.get(normalized)?.def;
+    }
+    /**
+     * Compare two semver versions.
+     * Returns positive if a > b, negative if a < b, 0 if equal.
+     */
+    compareVersions(a, b) {
+        const parseVersion = (v) => {
+            const parts = v.split(".").map((p) => parseInt(p, 10) || 0);
+            return { major: parts[0] ?? 0, minor: parts[1] ?? 0, patch: parts[2] ?? 0 };
+        };
+        const va = parseVersion(a);
+        const vb = parseVersion(b);
+        if (va.major !== vb.major)
+            return va.major - vb.major;
+        if (va.minor !== vb.minor)
+            return va.minor - vb.minor;
+        return va.patch - vb.patch;
+    }
+    has(name) {
+        return this.elements.has(name.toLowerCase());
+    }
+    list() {
+        // Deduplicate: versioned keys and plain-name keys point to the same entry.
+        // Return only one entry per element by tracking seen toml paths.
+        const seen = new Set();
+        const result = [];
+        for (const entry of this.elements.values()) {
+            if (seen.has(entry.tomlPath))
+                continue;
+            seen.add(entry.tomlPath);
+            result.push(entry.def);
+        }
+        return result;
+    }
+    getSectionIndex(name) {
+        const entry = this.elements.get(name.toLowerCase());
+        if (!entry)
+            return undefined;
+        const stat = statSync(entry.mdPath);
+        const currentMtime = stat.mtimeMs;
+        if (entry.sectionIndex && entry.mtime === currentMtime) {
+            return entry.sectionIndex;
+        }
+        const body = readFileSync(entry.mdPath, "utf-8");
+        const index = this.buildSectionIndex(body);
+        entry.sectionIndex = index;
+        entry.mtime = currentMtime;
+        return index;
+    }
+    loadBody(name) {
+        const entry = this.elements.get(name.toLowerCase());
+        if (!entry)
+            return undefined;
+        try {
+            return readFileSync(entry.mdPath, "utf-8");
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Load body for a specific version of an element.
+     */
+    loadBodyByVersion(name, version) {
+        const normalized = name.toLowerCase();
+        if (!version) {
+            return this.loadBody(name);
+        }
+        // Try exact version match first
+        const versionedKey = `${normalized}@${version}`;
+        const exact = this.elements.get(versionedKey);
+        if (exact) {
+            try {
+                return readFileSync(exact.mdPath, "utf-8");
+            }
+            catch {
+                return undefined;
+            }
+        }
+        // Fall back to latest
+        return this.loadBody(name);
+    }
+    getMdPath(name) {
+        return this.elements.get(name.toLowerCase())?.mdPath;
+    }
+    buildSectionIndex(body) {
+        const index = new Map();
+        const headerRe = /^##\s+(?:Tag:\s+)?(.+)$/gm;
+        const headerPositions = [];
+        for (let match = headerRe.exec(body); match !== null; match = headerRe.exec(body)) {
+            headerPositions.push({ name: match[1].trim(), pos: match.index });
+        }
+        for (let i = 0; i < headerPositions.length; i++) {
+            const start = headerPositions[i].pos;
+            const end = i + 1 < headerPositions.length ? headerPositions[i + 1].pos : body.length;
+            const name = headerPositions[i].name;
+            if (name.toLowerCase() === "default behavior") {
+                index.set("default", { start, end, tag: "default" });
+            }
+            else if (name.toLowerCase().startsWith("tag:")) {
+                const tag = name.slice(4).trim();
+                index.set(tag.toLowerCase(), { start, end, tag });
+            }
+            else {
+                index.set(name.toLowerCase(), { start, end, tag: name });
+            }
+        }
+        return index;
+    }
+}
+function parseFrontmatter(body) {
+    const result = { description: "", overrides: [] };
+    const fmMatch = body.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (!fmMatch)
+        return result;
+    const fm = fmMatch[1];
+    for (const line of fm.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const kvMatch = trimmed.match(/^([a-zA-Z_-]+)\s*[:=]\s*(.+)$/);
+        if (!kvMatch)
+            continue;
+        const [, key, valueStr] = kvMatch;
+        if (key === "description") {
+            result.description = valueStr
+                .trim()
+                .replace(/^"(.*)"$/, "$1")
+                .replace(/^'(.*)'$/, "$1");
+        }
+        else if (key === "overrides") {
+            const inner = valueStr.trim();
+            if (inner.startsWith("[") && inner.endsWith("]")) {
+                result.overrides = inner
+                    .slice(1, -1)
+                    .split(",")
+                    .map((s) => s
+                    .trim()
+                    .replace(/^"(.*)"$/, "$1")
+                    .replace(/^'(.*)'$/, "$1"))
+                    .filter(Boolean);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=registry.js.map