@grafema/util 0.3.17 → 0.3.20

package/src/manifest/resolver.ts

@@ -20,6 +20,7 @@ import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 import { parse as parseYaml } from 'yaml';
 import type { Manifest, ManifestExport } from './types.js';
+import type { RegistryIndex } from './registry.js';
 
 export interface ResolveResult {
   /** The matched export entry */
@@ -105,6 +106,38 @@ export class ManifestResolver {
     return loaded;
   }
 
+  /**
+   * Load manifests from a registry directory (registry/index.yaml).
+   * Reads index.yaml to discover available packages, then loads each manifest.
+   *
+   * @param registryDir Path to the registry directory containing index.yaml
+   * @param packageNames Optional filter — only load these packages
+   * @returns Number of manifests loaded
+   */
+  loadFromRegistry(registryDir: string, packageNames?: string[]): number {
+    const indexPath = join(registryDir, 'index.yaml');
+    if (!existsSync(indexPath)) return 0;
+
+    let index: RegistryIndex;
+    try {
+      index = parseYaml(readFileSync(indexPath, 'utf-8')) as RegistryIndex;
+    } catch {
+      return 0;
+    }
+
+    if (!index?.entries) return 0;
+
+    let loaded = 0;
+    for (const entry of index.entries) {
+      if (packageNames && !packageNames.includes(entry.name)) continue;
+
+      const manifestPath = join(registryDir, entry.name, entry.version, 'manifest.yaml');
+      if (this.loadFromFile(manifestPath)) loaded++;
+    }
+
+    return loaded;
+  }
+
   /**
    * Register a manifest directly (e.g., from in-memory generation).
    */

package/src/notation/traceRenderer.ts

@@ -28,6 +28,8 @@ export type TraceDetail = 'summary' | 'normal' | 'full';
 export interface TraceNarrativeOptions {
   /** Level of detail: summary, normal (default), full */
   detail?: TraceDetail;
+  /** Format hints for CLI (--detail full) vs MCP (detail="full") */
+  hintStyle?: 'cli' | 'mcp';
 }
 
 // === CONSTANTS ===
@@ -40,14 +42,15 @@ const MAX_LINES = 35;
 
 // === LEGEND (from single source of truth) ===
 
-function lodHint(currentDetail: TraceDetail): string {
+function lodHint(currentDetail: TraceDetail, style: 'cli' | 'mcp' = 'mcp'): string {
+  const fmt = (level: string) => style === 'cli' ? `--detail ${level}` : `detail="${level}"`;
   switch (currentDetail) {
     case 'summary':
-      return 'Use detail="normal" for node list, detail="full" for complete chain';
+      return `Use ${fmt('normal')} for node list, ${fmt('full')} for complete chain`;
     case 'normal':
-      return 'Use detail="full" for complete chain, detail="summary" for overview';
+      return `Use ${fmt('full')} for complete chain, ${fmt('summary')} for overview`;
     case 'full':
-      return 'Use detail="summary" for overview, detail="normal" for compressed view';
+      return `Use ${fmt('summary')} for overview, ${fmt('normal')} for compressed view`;
   }
 }
 
@@ -452,7 +455,7 @@ export function renderTraceNarrative(
   // Append legend (from archetypes.ts — single source of truth) + LOD hint
   output.push('');
   output.push(generateLegend());
-  output.push(lodHint(detail));
+  output.push(lodHint(detail, options.hintStyle));
 
   return output.join('\n');
 }