@frontera-sdk/cli 1.52.39 → 1.52.41

package/src/local/local-sync-refs.ts

@@ -15,6 +15,8 @@
  * directory knows, is rewritten.
  */
 
+import { slugify } from './local-project'
+
 /**
  * `object` is an object definition an Agent's object tools work on
  * (`object/claim_ticket`), by slug; its fields travel in the Agent's file.
@@ -24,7 +26,50 @@ export type RefKind = (typeof REF_KINDS)[number]
 
 /** Names as resources are named: slugs, API names, install names. */
 const NAME = '[A-Za-z0-9][A-Za-z0-9._-]*'
-const REF = new RegExp(`^(${REF_KINDS.join('|')})/(${NAME})$`)
+/**
+ * Kinds people name in words: a saved object set ("Open work orders") and a
+ * knowledge base. A reference to one may hold the name as people say it,
+ * spaces and all (`objectSet/Open work orders`), or its name as a reference
+ * holds it (`objectSet/open-work-orders`, `refName`); both resolve.
+ */
+export const WORDED_KINDS: readonly RefKind[] = ['objectSet', 'knowledge']
+/** A worded name: no leading or trailing space, no slash, no line break. */
+const WORDS = '[A-Za-z0-9](?:[A-Za-z0-9 ._()&\'’,-]*[A-Za-z0-9._)])?'
+const PLAIN_KINDS = REF_KINDS.filter((k) => !WORDED_KINDS.includes(k))
+const REF = new RegExp(`^(?:(${PLAIN_KINDS.join('|')})/(${NAME})|(${WORDED_KINDS.join('|')})/(${WORDS}))$`)
+
+/**
+ * The pattern a whole-value reference of these kinds matches (`^(function|workflow)/<name>$`),
+ * the same one `parseRef` reads: what `local schema` tells an editor a project file may write
+ * where the runtime wants an id.
+ */
+export function refPattern(kinds: readonly RefKind[] = REF_KINDS): string {
+  const plain = kinds.filter((k) => !WORDED_KINDS.includes(k))
+  const worded = kinds.filter((k) => WORDED_KINDS.includes(k))
+  const parts = [...(plain.length ? [`(${plain.join('|')})/${NAME}`] : []), ...(worded.length ? [`(${worded.join('|')})/${WORDS}`] : [])]
+  return parts.length === 1 ? `^${parts[0]}$` : `^(?:${parts.join('|')})$`
+}
+
+/**
+ * A resource's name as a reference holds it: as it is when it is already a
+ * slug or API name, else its words made a slug (`Open work orders` →
+ * `open-work-orders`, as `slugify` makes one, at most 24 characters).
+ */
+export function refName(name: string): string {
+  return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name) ? name : slugify(name) || 'unnamed'
+}
+
+/**
+ * A name's id in one kind's map: as written, or for a kind named in words,
+ * by its name as a reference holds it (`objectSet/Open work orders` finds the
+ * set the directory lists as `open-work-orders`).
+ */
+export function lookupRef(names: ReadonlyMap<string, string> | undefined, kind: RefKind, name: string): string | undefined {
+  if (!names) return undefined
+  const exact = names.get(name)
+  if (exact !== undefined || !WORDED_KINDS.includes(kind)) return exact
+  return names.get(refName(name))
+}
 /** `[[function:<id or name>]]` in guidance text, the platform's link form. */
 const LINK = new RegExp(`\\[\\[(${REF_KINDS.join('|')}):([^\\]\\s]+)\\]\\]`, 'g')
 /** `function:<id or name>` as a whole value: a procedure's tool list names its tools this way. */
@@ -37,7 +82,8 @@ export function isUuid(value: string): boolean {
 
 export function parseRef(value: string): { kind: RefKind; name: string } | null {
   const m = REF.exec(value)
-  return m ? { kind: m[1] as RefKind, name: m[2]! } : null
+  if (!m) return null
+  return m[1] ? { kind: m[1] as RefKind, name: m[2]! } : { kind: m[3] as RefKind, name: m[4]! }
 }
 
 export function formatRef(kind: RefKind, name: string): string {
@@ -147,7 +193,7 @@ export function toIds<T>(doc: T, directory: Directory): { doc: T; unresolved: Un
   const out = walk(doc, [], (s, path) => {
     const ref = parseRef(s)
     if (ref) {
-      const id = directory[ref.kind]?.get(ref.name)
+      const id = lookupRef(directory[ref.kind], ref.kind, ref.name)
       if (id) return id
       unresolved.push({ path: path.join('.'), value: s, kind: ref.kind })
       return s