@lucern/pack-host 1.0.29 → 1.0.31

package/dist/contracts.d.ts

@@ -12,63 +12,63 @@ type ProjectionBehavior = "none" | "inherits_policy" | "projection_required";
 type PackRuntimeStage = "registered" | "validated" | "installed" | "enabled" | "degraded" | "disabled" | "removed";
 type SharedService = "decision-kernel" | "knowledge-compiler" | "learning-loop";
 type SharedServiceMode = "required" | "optional";
-type RouteNamespace = {
-    web: string[];
+interface RouteNamespace {
     api: string[];
-};
-type SurfaceOwnership = {
+    web: string[];
+}
+interface SurfaceOwnership {
     components: string[];
     convex: string[];
     tools: string[];
-};
-type PolicyRule = {
-    resource: PolicyResource;
+}
+interface PolicyRule {
     actions: PolicyAction[];
     notes?: string;
-};
-type PolicyProfile = {
+    resource: PolicyResource;
+}
+interface PolicyProfile {
     audiences: PackAudience[];
     rules: PolicyRule[];
-};
-type DataContract = {
-    requiredNodeTypes: string[];
+}
+interface DataContract {
+    projectionBehavior: ProjectionBehavior;
     requiredEdgeTypes: string[];
+    requiredNodeTypes: string[];
     requiredTables: string[];
-    projectionBehavior: ProjectionBehavior;
-};
-type TemplateAssets = {
-    workflows: string[];
+}
+interface TemplateAssets {
     prompts: string[];
     reports: string[];
     uiLabels: string[];
-};
-type PackTestSuite = {
+    workflows: string[];
+}
+interface PackTestSuite {
+    contract: string[];
     parity: string[];
     policy: string[];
-    contract: string[];
-};
-type SharedServiceIntegration = {
-    service: SharedService;
-    mode: SharedServiceMode;
+}
+interface SharedServiceIntegration {
     contracts: string[];
-};
-type AppPackManifest = {
-    key: string;
-    name: string;
-    version: string;
-    lifecycle: PackLifecycle;
+    mode: SharedServiceMode;
+    service: SharedService;
+}
+interface AppPackManifest {
+    capabilityFlags: string[];
     category: PackCategory;
-    description: string;
+    dataContract: DataContract;
     dependencies: string[];
-    capabilityFlags: string[];
+    description: string;
+    key: string;
+    lifecycle: PackLifecycle;
+    name: string;
+    policyProfile: PolicyProfile;
     routeNamespace: RouteNamespace;
+    sharedServices: SharedServiceIntegration[];
     surfaces: SurfaceOwnership;
-    policyProfile: PolicyProfile;
-    dataContract: DataContract;
     templates: TemplateAssets;
     testSuite: PackTestSuite;
-    sharedServices: SharedServiceIntegration[];
-};
+    version: string;
+}
 type AppPackManifestInput = Omit<AppPackManifest, "sharedServices"> & {
     sharedServices?: SharedServiceIntegration[];
 };

package/dist/contracts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contracts.ts"],"names":[],"mappings":";AA+HA,SAAS,qBAAqB,MAAA,EAA4B;AACxD,EAAA,MAAM,UAAA,GAAa,MAAA,CAChB,GAAA,CAAI,CAAC,UAAU,KAAA,CAAM,IAAA,EAAM,CAAA,CAC3B,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,SAAS,CAAC,CAAA;AACrC,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAI,GAAA,CAAI,UAAU,CAAC,CAAA;AACvC;AAEO,SAAS,sBACd,QAAA,EACiB;AACjB,EAAA,MAAM,kBAAkB,QAAA,CAAS,cAAA,IAAkB,EAAC,EAAG,GAAA,CAAI,CAAC,WAAA,MAAiB;AAAA,IAC3E,GAAG,WAAA;AAAA,IACH,SAAA,EAAW,oBAAA,CAAqB,WAAA,CAAY,SAAS;AAAA,GACvD,CAAE,CAAA;AAEF,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,YAAA,EAAc,oBAAA,CAAqB,QAAA,CAAS,YAAY,CAAA;AAAA,IACxD,eAAA,EAAiB,oBAAA,CAAqB,QAAA,CAAS,eAAe,CAAA;AAAA,IAC9D;AAAA,GACF;AACF","file":"contracts.js","sourcesContent":["/**\n * App Pack Contracts\n *\n * Canonical type contracts for Lucern app-pack manifests and runtime metadata.\n */\n\nexport type PackLifecycle = \"active\" | \"beta\" | \"experimental\";\n\nexport type PackCategory =\n  | \"conversation\"\n  | \"research\"\n  | \"graph\"\n  | \"analytics\"\n  | \"workflow\"\n  | \"decision\"\n  | \"news\"\n  | \"documents\"\n  | \"identity\"\n  | \"operations\"\n  | \"domain\";\n\nexport type PackAudience = string;\n\nexport type PolicyAction = \"read\" | \"summarize\" | \"export\" | \"mutate\" | \"admin\";\n\nexport type PolicyResource =\n  | \"project\"\n  | \"node\"\n  | \"edge\"\n  | \"artifact\"\n  | \"report_section\"\n  | \"tool_action\"\n  | \"task\"\n  | \"user_profile\"\n  | \"team_analytics\";\n\nexport type ProjectionBehavior =\n  | \"none\"\n  | \"inherits_policy\"\n  | \"projection_required\";\n\nexport type PackRuntimeStage =\n  | \"registered\"\n  | \"validated\"\n  | \"installed\"\n  | \"enabled\"\n  | \"degraded\"\n  | \"disabled\"\n  | \"removed\";\n\nexport type SharedService =\n  | \"decision-kernel\"\n  | \"knowledge-compiler\"\n  | \"learning-loop\";\n\nexport type SharedServiceMode = \"required\" | \"optional\";\n\nexport type RouteNamespace = {\n  web: string[];\n  api: string[];\n};\n\nexport type SurfaceOwnership = {\n  components: string[];\n  convex: string[];\n  tools: string[];\n};\n\nexport type PolicyRule = {\n  resource: PolicyResource;\n  actions: PolicyAction[];\n  notes?: string;\n};\n\nexport type PolicyProfile = {\n  audiences: PackAudience[];\n  rules: PolicyRule[];\n};\n\nexport type DataContract = {\n  requiredNodeTypes: string[];\n  requiredEdgeTypes: string[];\n  requiredTables: string[];\n  projectionBehavior: ProjectionBehavior;\n};\n\nexport type TemplateAssets = {\n  workflows: string[];\n  prompts: string[];\n  reports: string[];\n  uiLabels: string[];\n};\n\nexport type PackTestSuite = {\n  parity: string[];\n  policy: string[];\n  contract: string[];\n};\n\nexport type SharedServiceIntegration = {\n  service: SharedService;\n  mode: SharedServiceMode;\n  contracts: string[];\n};\n\nexport type AppPackManifest = {\n  key: string;\n  name: string;\n  version: string;\n  lifecycle: PackLifecycle;\n  category: PackCategory;\n  description: string;\n  dependencies: string[];\n  capabilityFlags: string[];\n  routeNamespace: RouteNamespace;\n  surfaces: SurfaceOwnership;\n  policyProfile: PolicyProfile;\n  dataContract: DataContract;\n  templates: TemplateAssets;\n  testSuite: PackTestSuite;\n  sharedServices: SharedServiceIntegration[];\n};\n\ntype AppPackManifestInput = Omit<AppPackManifest, \"sharedServices\"> & {\n  sharedServices?: SharedServiceIntegration[];\n};\n\nfunction normalizeStringArray(values: string[]): string[] {\n  const normalized = values\n    .map((value) => value.trim())\n    .filter((value) => value.length > 0);\n  return Array.from(new Set(normalized));\n}\n\nexport function defineAppPackManifest(\n  manifest: AppPackManifestInput\n): AppPackManifest {\n  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({\n    ...integration,\n    contracts: normalizeStringArray(integration.contracts),\n  }));\n\n  return {\n    ...manifest,\n    dependencies: normalizeStringArray(manifest.dependencies),\n    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),\n    sharedServices,\n  };\n}\n"]}
+{"version":3,"sources":["../src/contracts.ts"],"names":[],"mappings":";AA+HA,SAAS,qBAAqB,MAAA,EAA4B;AACxD,EAAA,MAAM,UAAA,GAAa,MAAA,CAChB,GAAA,CAAI,CAAC,UAAU,KAAA,CAAM,IAAA,EAAM,CAAA,CAC3B,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,SAAS,CAAC,CAAA;AACrC,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAI,GAAA,CAAI,UAAU,CAAC,CAAA;AACvC;AAEO,SAAS,sBACd,QAAA,EACiB;AACjB,EAAA,MAAM,kBAAkB,QAAA,CAAS,cAAA,IAAkB,EAAC,EAAG,GAAA,CAAI,CAAC,WAAA,MAAiB;AAAA,IAC3E,GAAG,WAAA;AAAA,IACH,SAAA,EAAW,oBAAA,CAAqB,WAAA,CAAY,SAAS;AAAA,GACvD,CAAE,CAAA;AAEF,EAAA,OAAO;AAAA,IACL,GAAG,QAAA;AAAA,IACH,YAAA,EAAc,oBAAA,CAAqB,QAAA,CAAS,YAAY,CAAA;AAAA,IACxD,eAAA,EAAiB,oBAAA,CAAqB,QAAA,CAAS,eAAe,CAAA;AAAA,IAC9D;AAAA,GACF;AACF","file":"contracts.js","sourcesContent":["/**\n * App Pack Contracts\n *\n * Canonical type contracts for Lucern app-pack manifests and runtime metadata.\n */\n\nexport type PackLifecycle = \"active\" | \"beta\" | \"experimental\";\n\nexport type PackCategory =\n  | \"conversation\"\n  | \"research\"\n  | \"graph\"\n  | \"analytics\"\n  | \"workflow\"\n  | \"decision\"\n  | \"news\"\n  | \"documents\"\n  | \"identity\"\n  | \"operations\"\n  | \"domain\";\n\nexport type PackAudience = string;\n\nexport type PolicyAction = \"read\" | \"summarize\" | \"export\" | \"mutate\" | \"admin\";\n\nexport type PolicyResource =\n  | \"project\"\n  | \"node\"\n  | \"edge\"\n  | \"artifact\"\n  | \"report_section\"\n  | \"tool_action\"\n  | \"task\"\n  | \"user_profile\"\n  | \"team_analytics\";\n\nexport type ProjectionBehavior =\n  | \"none\"\n  | \"inherits_policy\"\n  | \"projection_required\";\n\nexport type PackRuntimeStage =\n  | \"registered\"\n  | \"validated\"\n  | \"installed\"\n  | \"enabled\"\n  | \"degraded\"\n  | \"disabled\"\n  | \"removed\";\n\nexport type SharedService =\n  | \"decision-kernel\"\n  | \"knowledge-compiler\"\n  | \"learning-loop\";\n\nexport type SharedServiceMode = \"required\" | \"optional\";\n\nexport interface RouteNamespace {\n  api: string[];\n  web: string[];\n}\n\nexport interface SurfaceOwnership {\n  components: string[];\n  convex: string[];\n  tools: string[];\n}\n\nexport interface PolicyRule {\n  actions: PolicyAction[];\n  notes?: string;\n  resource: PolicyResource;\n}\n\nexport interface PolicyProfile {\n  audiences: PackAudience[];\n  rules: PolicyRule[];\n}\n\nexport interface DataContract {\n  projectionBehavior: ProjectionBehavior;\n  requiredEdgeTypes: string[];\n  requiredNodeTypes: string[];\n  requiredTables: string[];\n}\n\nexport interface TemplateAssets {\n  prompts: string[];\n  reports: string[];\n  uiLabels: string[];\n  workflows: string[];\n}\n\nexport interface PackTestSuite {\n  contract: string[];\n  parity: string[];\n  policy: string[];\n}\n\nexport interface SharedServiceIntegration {\n  contracts: string[];\n  mode: SharedServiceMode;\n  service: SharedService;\n}\n\nexport interface AppPackManifest {\n  capabilityFlags: string[];\n  category: PackCategory;\n  dataContract: DataContract;\n  dependencies: string[];\n  description: string;\n  key: string;\n  lifecycle: PackLifecycle;\n  name: string;\n  policyProfile: PolicyProfile;\n  routeNamespace: RouteNamespace;\n  sharedServices: SharedServiceIntegration[];\n  surfaces: SurfaceOwnership;\n  templates: TemplateAssets;\n  testSuite: PackTestSuite;\n  version: string;\n}\n\ntype AppPackManifestInput = Omit<AppPackManifest, \"sharedServices\"> & {\n  sharedServices?: SharedServiceIntegration[];\n};\n\nfunction normalizeStringArray(values: string[]): string[] {\n  const normalized = values\n    .map((value) => value.trim())\n    .filter((value) => value.length > 0);\n  return Array.from(new Set(normalized));\n}\n\nexport function defineAppPackManifest(\n  manifest: AppPackManifestInput\n): AppPackManifest {\n  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({\n    ...integration,\n    contracts: normalizeStringArray(integration.contracts),\n  }));\n\n  return {\n    ...manifest,\n    dependencies: normalizeStringArray(manifest.dependencies),\n    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),\n    sharedServices,\n  };\n}\n"]}

package/dist/dependencyResolution.d.ts

@@ -7,12 +7,12 @@ import { PackValidationIssue } from './manifestValidation.js';
  * Dependency-graph validation and deterministic activation ordering.
  */
 
-type PackDependencyResolutionResult = {
-    orderedPackKeys: string[];
+interface PackDependencyResolutionResult {
     dependencyClosureByPack: Record<string, string[]>;
     issues: PackValidationIssue[];
+    orderedPackKeys: string[];
     valid: boolean;
-};
+}
 declare function resolvePackDependencyGraph(manifests: AppPackManifest[]): PackDependencyResolutionResult;
 
 export { type PackDependencyResolutionResult, resolvePackDependencyGraph };

package/dist/dependencyResolution.js

@@ -10,6 +10,73 @@ function toIssue(code, message, path, severity = "error") {
 function buildManifestMap(manifests) {
   return new Map(manifests.map((manifest) => [manifest.key, manifest]));
 }
+function initializeDependencyGraph(manifests) {
+  const manifestsByKey = buildManifestMap(manifests);
+  const indegree = /* @__PURE__ */ new Map();
+  const adjacency = /* @__PURE__ */ new Map();
+  for (const manifest of manifests) {
+    indegree.set(manifest.key, indegree.get(manifest.key) ?? 0);
+    adjacency.set(manifest.key, []);
+  }
+  return { adjacency, indegree, manifestsByKey };
+}
+function linkPackDependency(manifest, dependency, graph, issues) {
+  if (!graph.manifestsByKey.has(dependency)) {
+    issues.push(
+      toIssue(
+        "PACK_DEPENDENCY_MISSING",
+        `Pack "${manifest.key}" depends on unknown pack "${dependency}".`,
+        `dependencies:${manifest.key}`
+      )
+    );
+    return;
+  }
+  const dependencyDependents = graph.adjacency.get(dependency) ?? [];
+  dependencyDependents.push(manifest.key);
+  graph.adjacency.set(dependency, dependencyDependents);
+  graph.indegree.set(manifest.key, (graph.indegree.get(manifest.key) ?? 0) + 1);
+}
+function linkPackDependencies(manifests, graph, issues) {
+  for (const manifest of manifests) {
+    for (const dependency of manifest.dependencies) {
+      linkPackDependency(manifest, dependency, graph, issues);
+    }
+  }
+}
+function topologicalPackOrder(graph) {
+  const queue = [...graph.indegree.entries()].filter(([, value]) => value === 0).map(([packKey]) => packKey).sort();
+  const orderedPackKeys = [];
+  while (queue.length > 0) {
+    const nextKey = queue.shift();
+    if (!nextKey) {
+      break;
+    }
+    orderedPackKeys.push(nextKey);
+    const dependents = graph.adjacency.get(nextKey) ?? [];
+    for (const dependent of dependents) {
+      const updated = (graph.indegree.get(dependent) ?? 0) - 1;
+      graph.indegree.set(dependent, updated);
+      if (updated === 0) {
+        queue.push(dependent);
+      }
+    }
+    queue.sort();
+  }
+  return orderedPackKeys;
+}
+function recordUnresolvedDependencyCycles(orderedPackKeys, graph, issues) {
+  if (orderedPackKeys.length === graph.manifestsByKey.size) {
+    return;
+  }
+  const unresolved = [...graph.indegree.entries()].filter(([, value]) => value > 0).map(([key]) => key).sort();
+  issues.push(
+    toIssue(
+      "PACK_DEPENDENCY_CYCLE",
+      `Dependency graph is not acyclic; unresolved packs: ${unresolved.join(", ")}`,
+      "dependencies"
+    )
+  );
+}
 function walkDependencyClosure(manifestKey, manifestsByKey, path, closure, issues) {
   const manifest = manifestsByKey.get(manifestKey);
   if (!manifest) {
@@ -50,63 +117,8 @@ function walkDependencyClosure(manifestKey, manifestsByKey, path, closure, issue
     );
   }
 }
-function resolvePackDependencyGraph(manifests) {
-  const issues = [];
-  const manifestsByKey = buildManifestMap(manifests);
-  const indegree = /* @__PURE__ */ new Map();
-  const adjacency = /* @__PURE__ */ new Map();
-  for (const manifest of manifests) {
-    indegree.set(manifest.key, indegree.get(manifest.key) ?? 0);
-    adjacency.set(manifest.key, []);
-  }
-  for (const manifest of manifests) {
-    for (const dependency of manifest.dependencies) {
-      if (!manifestsByKey.has(dependency)) {
-        issues.push(
-          toIssue(
-            "PACK_DEPENDENCY_MISSING",
-            `Pack "${manifest.key}" depends on unknown pack "${dependency}".`,
-            `dependencies:${manifest.key}`
-          )
-        );
-        continue;
-      }
-      const dependencyDependents = adjacency.get(dependency) ?? [];
-      dependencyDependents.push(manifest.key);
-      adjacency.set(dependency, dependencyDependents);
-      indegree.set(manifest.key, (indegree.get(manifest.key) ?? 0) + 1);
-    }
-  }
-  const queue = [...indegree.entries()].filter(([, value]) => value === 0).map(([packKey]) => packKey).sort();
-  const orderedPackKeys = [];
-  while (queue.length > 0) {
-    const nextKey = queue.shift();
-    if (!nextKey) {
-      break;
-    }
-    orderedPackKeys.push(nextKey);
-    const dependents = adjacency.get(nextKey) ?? [];
-    for (const dependent of dependents) {
-      const current = indegree.get(dependent) ?? 0;
-      const updated = current - 1;
-      indegree.set(dependent, updated);
-      if (updated === 0) {
-        queue.push(dependent);
-      }
-    }
-    queue.sort();
-  }
-  if (orderedPackKeys.length !== manifestsByKey.size) {
-    const unresolved = [...indegree.entries()].filter(([, value]) => value > 0).map(([key]) => key).sort();
-    issues.push(
-      toIssue(
-        "PACK_DEPENDENCY_CYCLE",
-        `Dependency graph is not acyclic; unresolved packs: ${unresolved.join(", ")}`,
-        "dependencies"
-      )
-    );
-  }
-  const dependencyClosureByPack = {};
+function dependencyClosureByPack(manifests, manifestsByKey, issues) {
+  const dependencyClosure = {};
   for (const manifest of manifests) {
     const closure = /* @__PURE__ */ new Set();
     walkDependencyClosure(
@@ -116,11 +128,23 @@ function resolvePackDependencyGraph(manifests) {
       closure,
       issues
     );
-    dependencyClosureByPack[manifest.key] = [...closure].sort();
+    dependencyClosure[manifest.key] = [...closure].sort();
   }
+  return dependencyClosure;
+}
+function resolvePackDependencyGraph(manifests) {
+  const issues = [];
+  const graph = initializeDependencyGraph(manifests);
+  linkPackDependencies(manifests, graph, issues);
+  const orderedPackKeys = topologicalPackOrder(graph);
+  recordUnresolvedDependencyCycles(orderedPackKeys, graph, issues);
   return {
     orderedPackKeys,
-    dependencyClosureByPack,
+    dependencyClosureByPack: dependencyClosureByPack(
+      manifests,
+      graph.manifestsByKey,
+      issues
+    ),
     issues,
     valid: issues.every((issue) => issue.severity !== "error")
   };

package/dist/dependencyResolution.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/dependencyResolution.ts"],"names":[],"mappings":"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","file":"dependencyResolution.js","sourcesContent":["/**\n * Pack Dependency Resolution\n *\n * Dependency-graph validation and deterministic activation ordering.\n */\n\nimport type { AppPackManifest } from \"./contracts\";\nimport type { PackValidationIssue } from \"./manifestValidation\";\n\nexport type PackDependencyResolutionResult = {\n  orderedPackKeys: string[];\n  dependencyClosureByPack: Record<string, string[]>;\n  issues: PackValidationIssue[];\n  valid: boolean;\n};\n\nfunction toIssue(\n  code: string,\n  message: string,\n  path: string,\n  severity: \"error\" | \"warning\" = \"error\"\n): PackValidationIssue {\n  return {\n    code,\n    severity,\n    message,\n    path,\n  };\n}\n\nfunction buildManifestMap(\n  manifests: AppPackManifest[]\n): Map<string, AppPackManifest> {\n  return new Map(manifests.map((manifest) => [manifest.key, manifest]));\n}\n\nfunction walkDependencyClosure(\n  manifestKey: string,\n  manifestsByKey: Map<string, AppPackManifest>,\n  path: string[],\n  closure: Set<string>,\n  issues: PackValidationIssue[]\n): void {\n  const manifest = manifestsByKey.get(manifestKey);\n  if (!manifest) {\n    return;\n  }\n\n  for (const dependency of manifest.dependencies) {\n    if (!manifestsByKey.has(dependency)) {\n      issues.push(\n        toIssue(\n          \"PACK_DEPENDENCY_MISSING\",\n          `Pack \"${manifestKey}\" depends on unknown pack \"${dependency}\".`,\n          `dependencies:${manifestKey}`\n        )\n      );\n      continue;\n    }\n\n    if (path.includes(dependency)) {\n      const cycle = [...path, dependency].join(\" -> \");\n      issues.push(\n        toIssue(\n          \"PACK_DEPENDENCY_CYCLE\",\n          `Cycle detected: ${cycle}`,\n          `dependencies:${manifestKey}`\n        )\n      );\n      continue;\n    }\n\n    if (closure.has(dependency)) {\n      continue;\n    }\n\n    closure.add(dependency);\n    walkDependencyClosure(\n      dependency,\n      manifestsByKey,\n      [...path, dependency],\n      closure,\n      issues\n    );\n  }\n}\n\nexport function resolvePackDependencyGraph(\n  manifests: AppPackManifest[]\n): PackDependencyResolutionResult {\n  const issues: PackValidationIssue[] = [];\n  const manifestsByKey = buildManifestMap(manifests);\n  const indegree = new Map<string, number>();\n  const adjacency = new Map<string, string[]>();\n\n  for (const manifest of manifests) {\n    indegree.set(manifest.key, indegree.get(manifest.key) ?? 0);\n    adjacency.set(manifest.key, []);\n  }\n\n  for (const manifest of manifests) {\n    for (const dependency of manifest.dependencies) {\n      if (!manifestsByKey.has(dependency)) {\n        issues.push(\n          toIssue(\n            \"PACK_DEPENDENCY_MISSING\",\n            `Pack \"${manifest.key}\" depends on unknown pack \"${dependency}\".`,\n            `dependencies:${manifest.key}`\n          )\n        );\n        continue;\n      }\n\n      const dependencyDependents = adjacency.get(dependency) ?? [];\n      dependencyDependents.push(manifest.key);\n      adjacency.set(dependency, dependencyDependents);\n\n      indegree.set(manifest.key, (indegree.get(manifest.key) ?? 0) + 1);\n    }\n  }\n\n  const queue = [...indegree.entries()]\n    .filter(([, value]) => value === 0)\n    .map(([packKey]) => packKey)\n    .sort();\n\n  const orderedPackKeys: string[] = [];\n  while (queue.length > 0) {\n    const nextKey = queue.shift();\n    if (!nextKey) {\n      break;\n    }\n\n    orderedPackKeys.push(nextKey);\n    const dependents = adjacency.get(nextKey) ?? [];\n    for (const dependent of dependents) {\n      const current = indegree.get(dependent) ?? 0;\n      const updated = current - 1;\n      indegree.set(dependent, updated);\n      if (updated === 0) {\n        queue.push(dependent);\n      }\n    }\n    queue.sort();\n  }\n\n  if (orderedPackKeys.length !== manifestsByKey.size) {\n    const unresolved = [...indegree.entries()]\n      .filter(([, value]) => value > 0)\n      .map(([key]) => key)\n      .sort();\n\n    issues.push(\n      toIssue(\n        \"PACK_DEPENDENCY_CYCLE\",\n        `Dependency graph is not acyclic; unresolved packs: ${unresolved.join(\", \")}`,\n        \"dependencies\"\n      )\n    );\n  }\n\n  const dependencyClosureByPack: Record<string, string[]> = {};\n  for (const manifest of manifests) {\n    const closure = new Set<string>();\n    walkDependencyClosure(\n      manifest.key,\n      manifestsByKey,\n      [manifest.key],\n      closure,\n      issues\n    );\n    dependencyClosureByPack[manifest.key] = [...closure].sort();\n  }\n\n  return {\n    orderedPackKeys,\n    dependencyClosureByPack,\n    issues,\n    valid: issues.every((issue) => issue.severity !== \"error\"),\n  };\n}\n"]}
+{"version":3,"sources":["../src/dependencyResolution.ts"],"names":[],"mappings":"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","file":"dependencyResolution.js","sourcesContent":["// biome-ignore-all lint/style/useFilenamingConvention: Legacy public @lucern/pack-host/dependencyResolution subpath.\n/**\n * Pack Dependency Resolution\n *\n * Dependency-graph validation and deterministic activation ordering.\n */\n\nimport type { AppPackManifest } from \"./contracts\";\nimport type { PackValidationIssue } from \"./manifestValidation\";\n\nexport interface PackDependencyResolutionResult {\n  dependencyClosureByPack: Record<string, string[]>;\n  issues: PackValidationIssue[];\n  orderedPackKeys: string[];\n  valid: boolean;\n}\n\ninterface PackDependencyGraph {\n  adjacency: Map<string, string[]>;\n  indegree: Map<string, number>;\n  manifestsByKey: Map<string, AppPackManifest>;\n}\n\nfunction toIssue(\n  code: string,\n  message: string,\n  path: string,\n  severity: \"error\" | \"warning\" = \"error\"\n): PackValidationIssue {\n  return {\n    code,\n    severity,\n    message,\n    path,\n  };\n}\n\nfunction buildManifestMap(\n  manifests: AppPackManifest[]\n): Map<string, AppPackManifest> {\n  return new Map(manifests.map((manifest) => [manifest.key, manifest]));\n}\n\nfunction initializeDependencyGraph(\n  manifests: AppPackManifest[]\n): PackDependencyGraph {\n  const manifestsByKey = buildManifestMap(manifests);\n  const indegree = new Map<string, number>();\n  const adjacency = new Map<string, string[]>();\n\n  for (const manifest of manifests) {\n    indegree.set(manifest.key, indegree.get(manifest.key) ?? 0);\n    adjacency.set(manifest.key, []);\n  }\n\n  return { adjacency, indegree, manifestsByKey };\n}\n\nfunction linkPackDependency(\n  manifest: AppPackManifest,\n  dependency: string,\n  graph: PackDependencyGraph,\n  issues: PackValidationIssue[]\n): void {\n  if (!graph.manifestsByKey.has(dependency)) {\n    issues.push(\n      toIssue(\n        \"PACK_DEPENDENCY_MISSING\",\n        `Pack \"${manifest.key}\" depends on unknown pack \"${dependency}\".`,\n        `dependencies:${manifest.key}`\n      )\n    );\n    return;\n  }\n\n  const dependencyDependents = graph.adjacency.get(dependency) ?? [];\n  dependencyDependents.push(manifest.key);\n  graph.adjacency.set(dependency, dependencyDependents);\n  graph.indegree.set(manifest.key, (graph.indegree.get(manifest.key) ?? 0) + 1);\n}\n\nfunction linkPackDependencies(\n  manifests: AppPackManifest[],\n  graph: PackDependencyGraph,\n  issues: PackValidationIssue[]\n): void {\n  for (const manifest of manifests) {\n    for (const dependency of manifest.dependencies) {\n      linkPackDependency(manifest, dependency, graph, issues);\n    }\n  }\n}\n\nfunction topologicalPackOrder(graph: PackDependencyGraph): string[] {\n  const queue = [...graph.indegree.entries()]\n    .filter(([, value]) => value === 0)\n    .map(([packKey]) => packKey)\n    .sort();\n\n  const orderedPackKeys: string[] = [];\n  while (queue.length > 0) {\n    const nextKey = queue.shift();\n    if (!nextKey) {\n      break;\n    }\n\n    orderedPackKeys.push(nextKey);\n    const dependents = graph.adjacency.get(nextKey) ?? [];\n    for (const dependent of dependents) {\n      const updated = (graph.indegree.get(dependent) ?? 0) - 1;\n      graph.indegree.set(dependent, updated);\n      if (updated === 0) {\n        queue.push(dependent);\n      }\n    }\n    queue.sort();\n  }\n\n  return orderedPackKeys;\n}\n\nfunction recordUnresolvedDependencyCycles(\n  orderedPackKeys: string[],\n  graph: PackDependencyGraph,\n  issues: PackValidationIssue[]\n): void {\n  if (orderedPackKeys.length === graph.manifestsByKey.size) {\n    return;\n  }\n\n  const unresolved = [...graph.indegree.entries()]\n    .filter(([, value]) => value > 0)\n    .map(([key]) => key)\n    .sort();\n\n  issues.push(\n    toIssue(\n      \"PACK_DEPENDENCY_CYCLE\",\n      `Dependency graph is not acyclic; unresolved packs: ${unresolved.join(\", \")}`,\n      \"dependencies\"\n    )\n  );\n}\n\nfunction walkDependencyClosure(\n  manifestKey: string,\n  manifestsByKey: Map<string, AppPackManifest>,\n  path: string[],\n  closure: Set<string>,\n  issues: PackValidationIssue[]\n): void {\n  const manifest = manifestsByKey.get(manifestKey);\n  if (!manifest) {\n    return;\n  }\n\n  for (const dependency of manifest.dependencies) {\n    if (!manifestsByKey.has(dependency)) {\n      issues.push(\n        toIssue(\n          \"PACK_DEPENDENCY_MISSING\",\n          `Pack \"${manifestKey}\" depends on unknown pack \"${dependency}\".`,\n          `dependencies:${manifestKey}`\n        )\n      );\n      continue;\n    }\n\n    if (path.includes(dependency)) {\n      const cycle = [...path, dependency].join(\" -> \");\n      issues.push(\n        toIssue(\n          \"PACK_DEPENDENCY_CYCLE\",\n          `Cycle detected: ${cycle}`,\n          `dependencies:${manifestKey}`\n        )\n      );\n      continue;\n    }\n\n    if (closure.has(dependency)) {\n      continue;\n    }\n\n    closure.add(dependency);\n    walkDependencyClosure(\n      dependency,\n      manifestsByKey,\n      [...path, dependency],\n      closure,\n      issues\n    );\n  }\n}\n\nfunction dependencyClosureByPack(\n  manifests: AppPackManifest[],\n  manifestsByKey: Map<string, AppPackManifest>,\n  issues: PackValidationIssue[]\n): Record<string, string[]> {\n  const dependencyClosure: Record<string, string[]> = {};\n  for (const manifest of manifests) {\n    const closure = new Set<string>();\n    walkDependencyClosure(\n      manifest.key,\n      manifestsByKey,\n      [manifest.key],\n      closure,\n      issues\n    );\n    dependencyClosure[manifest.key] = [...closure].sort();\n  }\n  return dependencyClosure;\n}\n\nexport function resolvePackDependencyGraph(\n  manifests: AppPackManifest[]\n): PackDependencyResolutionResult {\n  const issues: PackValidationIssue[] = [];\n  const graph = initializeDependencyGraph(manifests);\n  linkPackDependencies(manifests, graph, issues);\n  const orderedPackKeys = topologicalPackOrder(graph);\n  recordUnresolvedDependencyCycles(orderedPackKeys, graph, issues);\n\n  return {\n    orderedPackKeys,\n    dependencyClosureByPack: dependencyClosureByPack(\n      manifests,\n      graph.manifestsByKey,\n      issues\n    ),\n    issues,\n    valid: issues.every((issue) => issue.severity !== \"error\"),\n  };\n}\n"]}

package/dist/domain-pack/authoring.core.d.ts

@@ -1,4 +1,4 @@
-import { DomainPack, RuntimeTarget, DomainPackInput } from './contracts.js';
+import { RuntimeTarget, DomainPack, DomainPackInput } from './contracts.js';
 import { DomainPackValidationIssue } from './validation.js';
 
 /**
@@ -12,104 +12,104 @@ import { DomainPackValidationIssue } from './validation.js';
 
 declare const DOMAIN_PACK_MANIFEST_KIND: "lucern-domain-pack-manifest";
 type DomainPackManifestFormat = "json" | "yaml";
-type DomainPackFrameworkContract = {
+interface DomainPackFrameworkContract {
     frameworkId: string;
-    version: string;
-    versionConstraint?: string;
     required?: boolean;
     runtimeTargets?: RuntimeTarget[];
-};
+    version: string;
+    versionConstraint?: string;
+}
 type DomainPackSchemaExtensionTarget = "artifact" | "workflow" | "gate" | "prompt" | "tool" | "install-profile" | "topic-template";
-type DomainPackSchemaExtension = {
-    extensionId: string;
-    target: DomainPackSchemaExtensionTarget;
+interface DomainPackSchemaExtension {
     description: string;
-    version: string;
     extends?: string;
+    extensionId: string;
     schema: Record<string, unknown>;
-};
-type DomainPackOntologyEntityExtension = {
-    value: string;
-    label: string;
+    target: DomainPackSchemaExtensionTarget;
+    version: string;
+}
+interface DomainPackOntologyEntityExtension {
     description?: string;
+    label: string;
     schema?: Record<string, unknown>;
     subtypes?: string[];
-};
-type DomainPackOntologyEdgeExtension = {
     value: string;
-    label: string;
+}
+interface DomainPackOntologyEdgeExtension {
+    constraintSeverity?: "error" | "warning" | "informational";
     description?: string;
+    label: string;
     sourceTypes?: string[];
     targetTypes?: string[];
-    constraintSeverity?: "error" | "warning" | "informational";
-};
-type DomainPackOntologyExtension = {
-    extensionId: string;
-    ontologyId: string;
-    baseVersionConstraint: string;
+    value: string;
+}
+interface DomainPackOntologyExtension {
     additiveOnly: boolean;
-    entityTypes?: DomainPackOntologyEntityExtension[];
+    baseVersionConstraint: string;
     edgeTypes?: DomainPackOntologyEdgeExtension[];
-};
+    entityTypes?: DomainPackOntologyEntityExtension[];
+    extensionId: string;
+    ontologyId: string;
+}
 type DomainPackLineageMode = "root" | "remix" | "fork";
-type DomainPackLineage = {
+interface DomainPackLineage {
     mode: DomainPackLineageMode;
+    notes?: string;
+    parentManifestDigest?: string;
     parentPackId?: string;
     parentVersion?: string;
-    parentManifestDigest?: string;
     supersedesPackId?: string;
-    notes?: string;
-};
-type DomainPackAuthoringMetadata = {
+}
+interface DomainPackAuthoringMetadata {
     description?: string;
     owner?: string;
     tags?: string[];
-};
-type DomainPackAuthoringManifest = {
+}
+interface DomainPackAuthoringManifest {
+    frameworks?: DomainPackFrameworkContract[];
     kind: typeof DOMAIN_PACK_MANIFEST_KIND;
+    lineage: DomainPackLineage;
     manifestVersion: string;
+    metadata?: DomainPackAuthoringMetadata;
+    ontologyExtensions?: DomainPackOntologyExtension[];
     pack: DomainPack;
-    frameworks?: DomainPackFrameworkContract[];
     schemaExtensions?: DomainPackSchemaExtension[];
-    ontologyExtensions?: DomainPackOntologyExtension[];
-    lineage: DomainPackLineage;
-    metadata?: DomainPackAuthoringMetadata;
-};
-type DomainPackAuthoringManifestInput = {
+}
+interface DomainPackAuthoringManifestInput {
+    frameworks?: DomainPackFrameworkContract[];
     kind?: typeof DOMAIN_PACK_MANIFEST_KIND;
+    lineage?: DomainPackLineage;
     manifestVersion?: string;
+    metadata?: DomainPackAuthoringMetadata;
+    ontologyExtensions?: DomainPackOntologyExtension[];
     pack: DomainPack | DomainPackInput;
-    frameworks?: DomainPackFrameworkContract[];
     schemaExtensions?: DomainPackSchemaExtension[];
-    ontologyExtensions?: DomainPackOntologyExtension[];
-    lineage?: DomainPackLineage;
-    metadata?: DomainPackAuthoringMetadata;
-};
+}
 type DomainPackAuthoringValidationIssue = DomainPackValidationIssue & {
     source: "manifest" | "pack" | "framework" | "schema-extension" | "ontology-extension" | "lineage" | "terminology" | "parse";
 };
-type DomainPackManifestCounts = {
-    topicRoots: number;
-    workflows: number;
-    gates: number;
+interface DomainPackManifestCounts {
     artifacts: number;
-    roles: number;
-    prompts: number;
-    tools: number;
-    setupAssets: number;
-    installProfiles: number;
     frameworks: number;
-    schemaExtensions: number;
+    gates: number;
+    installProfiles: number;
     ontologyExtensions: number;
-};
-type DomainPackAuthoringValidationResult = {
-    valid: boolean;
+    prompts: number;
+    roles: number;
+    schemaExtensions: number;
+    setupAssets: number;
+    tools: number;
+    topicRoots: number;
+    workflows: number;
+}
+interface DomainPackAuthoringValidationResult {
+    counts: DomainPackManifestCounts;
     format: DomainPackManifestFormat | null;
+    issues: DomainPackAuthoringValidationIssue[];
     manifest: DomainPackAuthoringManifest | null;
     manifestDigest: string | null;
-    issues: DomainPackAuthoringValidationIssue[];
-    counts: DomainPackManifestCounts;
-};
+    valid: boolean;
+}
 type DomainPackAuthoringPreview = DomainPackAuthoringValidationResult & {
     readyToPublish: boolean;
     canonicalJson: string | null;
@@ -117,42 +117,42 @@ type DomainPackAuthoringPreview = DomainPackAuthoringValidationResult & {
     lineageSummary: string | null;
     requiredRuntimeTargets: RuntimeTarget[];
 };
-type DomainPackPublicationLineageEdge = {
-    edgeType: "remixed_from" | "supersedes";
+interface DomainPackPublicationLineageEdge {
     childPackId: string;
+    edgeType: "remixed_from" | "supersedes";
     parentPackId: string;
     parentVersion: string;
-};
-type DomainPackPublication = {
-    publicationId: string;
-    packId: string;
-    version: string;
-    manifestDigest: string;
-    manifest: DomainPackAuthoringManifest;
-    lineageEdge: DomainPackPublicationLineageEdge | null;
+}
+interface DomainPackPublication {
     canonicalJson: string;
     canonicalYaml: string;
-};
-type DomainPackPublishResult = {
-    published: boolean;
+    lineageEdge: DomainPackPublicationLineageEdge | null;
+    manifest: DomainPackAuthoringManifest;
+    manifestDigest: string;
+    packId: string;
+    publicationId: string;
+    version: string;
+}
+interface DomainPackPublishResult {
     preview: DomainPackAuthoringPreview;
     publication: DomainPackPublication | null;
-};
-type DomainPackAuthoringToolInput = {
-    manifestText: string;
+    published: boolean;
+}
+interface DomainPackAuthoringToolInput {
     format?: DomainPackManifestFormat;
-};
-type DomainPackAuthoringToolDefinition<Result> = {
-    name: "validate_domain_pack_manifest" | "preview_domain_pack_manifest" | "publish_domain_pack_manifest";
+    manifestText: string;
+}
+interface DomainPackAuthoringToolDefinition<Result> {
     description: string;
-    inputSchema: Record<string, unknown>;
     execute: (args: DomainPackAuthoringToolInput) => Result;
-};
-type DomainPackAuthoringToolset = {
-    validate: DomainPackAuthoringToolDefinition<DomainPackAuthoringValidationResult>;
+    inputSchema: Record<string, unknown>;
+    name: "validate_domain_pack_manifest" | "preview_domain_pack_manifest" | "publish_domain_pack_manifest";
+}
+interface DomainPackAuthoringToolset {
     preview: DomainPackAuthoringToolDefinition<DomainPackAuthoringPreview>;
     publish: DomainPackAuthoringToolDefinition<DomainPackPublishResult>;
-};
+    validate: DomainPackAuthoringToolDefinition<DomainPackAuthoringValidationResult>;
+}
 declare function defineDomainPackAuthoringManifest(input: DomainPackAuthoringManifestInput): DomainPackAuthoringManifest;
 declare function countManifestArtifacts(manifest: DomainPackAuthoringManifest | null): DomainPackManifestCounts;
 declare function serializeDomainPackAuthoringManifest(manifest: DomainPackAuthoringManifest, format?: DomainPackManifestFormat): string;

package/dist/domain-pack/authoring.core.js

@@ -63,12 +63,13 @@ function defineDomainPack(input) {
 // src/domain-pack/authoring.core.ts
 var DOMAIN_PACK_MANIFEST_KIND = "lucern-domain-pack-manifest";
 var CURRENT_MANIFEST_VERSION = "1.0.0";
+var YAML_NUMERIC_SCALAR = /^-?\d+(?:\.\d+)?$/;
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
 }
 function dedupeStrings2(values) {
   if (!values) {
-    return void 0;
+    return;
   }
   return Array.from(
     new Set(values.map((value) => value.trim()).filter((value) => value.length))
@@ -79,7 +80,7 @@ function normalizeRuntimeTargets2(values) {
 }
 function normalizeFrameworks(frameworks) {
   if (!frameworks) {
-    return void 0;
+    return;
   }
   return frameworks.map((framework) => ({
     ...framework,
@@ -91,7 +92,7 @@ function normalizeFrameworks(frameworks) {
 }
 function normalizeSchemaExtensions(extensions) {
   if (!extensions) {
-    return void 0;
+    return;
   }
   return extensions.map((extension) => ({
     ...extension,
@@ -104,7 +105,7 @@ function normalizeSchemaExtensions(extensions) {
 }
 function normalizeOntologyExtensions(extensions) {
   if (!extensions) {
-    return void 0;
+    return;
   }
   return extensions.map((extension) => ({
     ...extension,
@@ -143,7 +144,7 @@ function normalizeLineage(lineage) {
 }
 function normalizeMetadata(metadata) {
   if (!metadata) {
-    return void 0;
+    return;
   }
   return {
     description: metadata.description?.trim(),
@@ -271,7 +272,7 @@ function parseYamlScalar(raw) {
   if (value === "false") {
     return false;
   }
-  if (/^-?\d+(?:\.\d+)?$/.test(value)) {
+  if (YAML_NUMERIC_SCALAR.test(value)) {
     return Number(value);
   }
   if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {