@lucern/pack-host 1.0.29 → 1.0.30

package/dist/domain-pack/contracts.d.ts

@@ -14,167 +14,167 @@
  * All fields are internal until RS-5+ external authoring certification.
  */
 type OntologyProvisionMode = "bind" | "seed" | "extend";
-type OntologyBinding = {
+interface OntologyBinding {
     ontologyId: string;
-    versionConstraint: string;
-    required: boolean;
     provisionMode?: OntologyProvisionMode;
-    seedRef?: string;
-    requiredEntityTypes?: string[];
+    required: boolean;
     requiredEdgeTypes?: string[];
-};
-type TopicRoot = {
-    slug: string;
-    name: string;
+    requiredEntityTypes?: string[];
+    seedRef?: string;
+    versionConstraint: string;
+}
+interface TopicRoot {
     description: string;
-    ontologyId?: string;
-};
-type WorkflowStep = {
-    stepId: string;
     name: string;
+    ontologyId?: string;
+    slug: string;
+}
+interface WorkflowStep {
     description: string;
-    requiredRoles: string[];
-    produces?: string[];
     gateId?: string;
-};
-type WorkflowTemplate = {
-    workflowId: string;
     name: string;
+    produces?: string[];
+    requiredRoles: string[];
+    stepId: string;
+}
+interface WorkflowTemplate {
     description: string;
-    steps: WorkflowStep[];
-    requiredArtifacts: string[];
     gateCheckpoints: string[];
-};
+    name: string;
+    requiredArtifacts: string[];
+    steps: WorkflowStep[];
+    workflowId: string;
+}
 type GateCriterionOperator = "gte" | "lte" | "eq" | "gt" | "lt";
-type GateCriterion = {
+interface GateCriterion {
     criterionId: string;
     description: string;
     metric: string;
-    threshold?: number;
     operator?: GateCriterionOperator;
-};
+    threshold?: number;
+}
 type GateSeverity = "blocking" | "warning" | "informational";
-type GateSchema = {
+interface GateSchema {
+    criteria: GateCriterion[];
+    description: string;
     gateId: string;
     name: string;
-    description: string;
-    criteria: GateCriterion[];
     severity: GateSeverity;
-};
-type ArtifactSchema = {
+}
+interface ArtifactSchema {
     artifactId: string;
-    name: string;
-    description: string;
-    stage: string;
     contentSchema: Record<string, unknown>;
-    requiredFields: string[];
-};
-type ReasoningRole = {
-    roleId: string;
+    description: string;
     name: string;
+    requiredFields: string[];
+    stage: string;
+}
+interface ReasoningRole {
     description: string;
-    perspective: string;
-    optimizesFor: string;
     mayBlock: boolean;
-};
-type InquiryShapingQuestionTemplate = {
-    templateId: string;
-    questionType: "validation" | "falsification" | "assumption_probe" | "counterfactual" | "scope" | "comparison" | "mechanism" | "general";
+    name: string;
+    optimizesFor: string;
+    perspective: string;
+    roleId: string;
+}
+interface InquiryShapingQuestionTemplate {
     priority?: "critical" | "high" | "medium" | "low";
+    questionType: "validation" | "falsification" | "assumption_probe" | "counterfactual" | "scope" | "comparison" | "mechanism" | "general";
     template: string;
-    whenObjectiveIncludes?: string[];
-};
-type InquiryShapingTaskTemplate = {
     templateId: string;
-    title: string;
+    whenObjectiveIncludes?: string[];
+}
+interface InquiryShapingTaskTemplate {
     description?: string;
-    taskType?: "general" | "find_evidence" | "verify_claim" | "research" | "review" | "interview" | "analysis" | "track_metrics";
     priority?: "urgent" | "high" | "medium" | "low";
+    taskType?: "general" | "find_evidence" | "verify_claim" | "research" | "review" | "interview" | "analysis" | "track_metrics";
+    templateId: string;
+    title: string;
     whenObjectiveIncludes?: string[];
     whenQuestionTypes?: string[];
-};
-type InquiryShapingFrameworkHint = {
+}
+interface InquiryShapingFrameworkHint {
+    boost?: number;
     frameworkName: string;
+    reason?: string;
     whenObjectiveIncludes?: string[];
     whenQuestionTypes?: string[];
-    boost?: number;
-    reason?: string;
-};
-type InquiryShapingConfig = {
+}
+interface InquiryShapingConfig {
+    frameworkHints?: InquiryShapingFrameworkHint[];
     questionTemplates?: InquiryShapingQuestionTemplate[];
     taskTemplates?: InquiryShapingTaskTemplate[];
-    frameworkHints?: InquiryShapingFrameworkHint[];
-};
+}
 type RuntimeTarget = "claude-code" | "codex" | "hybrid" | "portable";
 type PromptSource = "langfuse" | "file";
 type PromptChannel = "bootstrap" | "workflow" | "analysis" | "review" | "tool";
-type PromptBinding = {
-    promptId: string;
+interface PromptBinding {
+    channel: PromptChannel;
     description: string;
-    source: PromptSource;
-    ref: string;
     fallbackRef?: string;
-    channel: PromptChannel;
+    promptId: string;
+    ref: string;
     required: boolean;
     runtimeTargets?: RuntimeTarget[];
-};
+    source: PromptSource;
+}
 type ToolKind = "mcp" | "cli" | "script" | "hook" | "ai-tool";
-type ToolBinding = {
-    toolId: string;
+interface ToolBinding {
     description: string;
-    kind: ToolKind;
     entrypoint: string;
+    kind: ToolKind;
     required: boolean;
     runtimeTargets?: RuntimeTarget[];
-};
+    toolId: string;
+}
 type SetupAssetKind = "instruction" | "settings" | "hook" | "skill" | "agent" | "manifest" | "template" | "inbox" | "script" | "ui";
-type SetupAsset = {
+interface SetupAsset {
     assetId: string;
-    kind: SetupAssetKind;
     description: string;
+    kind: SetupAssetKind;
     path: string;
     required: boolean;
     runtimeTargets?: RuntimeTarget[];
-};
-type TopicTemplate = {
-    slug: string;
-    name: string;
+}
+interface TopicTemplate {
     description: string;
-    parentSlug?: string;
-    ontologyId?: string;
-};
-type InstallProfile = {
-    profileId: string;
     name: string;
+    ontologyId?: string;
+    parentSlug?: string;
+    slug: string;
+}
+interface InstallProfile {
+    assetIds: string[];
+    defaultTopicSlugs: string[];
     description: string;
-    runtimeTarget: RuntimeTarget;
+    name: string;
+    profileId: string;
     promptIds: string[];
+    runtimeTarget: RuntimeTarget;
     toolIds: string[];
-    assetIds: string[];
-    defaultTopicSlugs: string[];
-};
-type OperatingSystemLayer = {
+}
+interface OperatingSystemLayer {
+    installProfiles?: InstallProfile[];
     prompts?: PromptBinding[];
-    tools?: ToolBinding[];
     setupAssets?: SetupAsset[];
+    tools?: ToolBinding[];
     topicTemplates?: TopicTemplate[];
-    installProfiles?: InstallProfile[];
-};
-type DomainPack = {
-    packId: string;
+}
+interface DomainPack {
+    appPackKeys?: string[];
+    artifacts: ArtifactSchema[];
+    gates: GateSchema[];
+    inquiryShaping?: InquiryShapingConfig;
+    methodologyPackId?: string;
     name: string;
-    version: string;
     ontologyBindings: OntologyBinding[];
+    operatingSystem?: OperatingSystemLayer;
+    packId: string;
+    roles: ReasoningRole[];
     topicRoots: TopicRoot[];
+    version: string;
     workflows: WorkflowTemplate[];
-    gates: GateSchema[];
-    artifacts: ArtifactSchema[];
-    roles: ReasoningRole[];
-    inquiryShaping?: InquiryShapingConfig;
-    operatingSystem?: OperatingSystemLayer;
-    appPackKeys?: string[];
-    methodologyPackId?: string;
-};
+}
 type DomainPackInput = Omit<DomainPack, "appPackKeys"> & {
     appPackKeys?: string[];
 };

package/dist/domain-pack/contracts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/domain-pack/contracts.ts"],"names":[],"mappings":";AAoSA,SAAS,cAAc,MAAA,EAA4B;AACjD,EAAA,OAAO,KAAA,CAAM,IAAA;AAAA,IACX,IAAI,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,CAAC,MAAM,CAAA,CAAE,IAAA,EAAM,CAAA,CAAE,OAAO,CAAC,CAAA,KAAM,CAAA,CAAE,MAAA,GAAS,CAAC,CAAC;AAAA,GACjE;AACF;AAMA,SAAS,wBACP,MAAA,EAC6B;AAC7B,EAAA,OAAO,MAAA,GAAU,aAAA,CAAc,MAAM,CAAA,GAAwB,MAAA;AAC/D;AAEA,SAAS,yBAAyB,OAAA,EAA2C;AAC3E,EAAA,OAAO;AAAA,IACL,GAAG,OAAA;AAAA,IACH,qBAAqB,OAAA,CAAQ,mBAAA,GACzB,aAAA,CAAc,OAAA,CAAQ,mBAAmB,CAAA,GACzC,MAAA;AAAA,IACJ,mBAAmB,OAAA,CAAQ,iBAAA,GACvB,aAAA,CAAc,OAAA,CAAQ,iBAAiB,CAAA,GACvC;AAAA,GACN;AACF;AAEA,SAAS,yBACP,KAAA,EACkC;AAClC,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,KAAA,CAAM,OAAA,EAAS,GAAA,CAAI,CAAC,MAAA,MAAY;AAAA,MACvC,GAAG,MAAA;AAAA,MACH,cAAA,EAAgB,uBAAA,CAAwB,MAAA,CAAO,cAAc;AAAA,KAC/D,CAAE,CAAA;AAAA,IACF,KAAA,EAAO,KAAA,CAAM,KAAA,EAAO,GAAA,CAAI,CAAC,IAAA,MAAU;AAAA,MACjC,GAAG,IAAA;AAAA,MACH,cAAA,EAAgB,uBAAA,CAAwB,IAAA,CAAK,cAAc;AAAA,KAC7D,CAAE,CAAA;AAAA,IACF,WAAA,EAAa,KAAA,CAAM,WAAA,EAAa,GAAA,CAAI,CAAC,KAAA,MAAW;AAAA,MAC9C,GAAG,KAAA;AAAA,MACH,cAAA,EAAgB,uBAAA,CAAwB,KAAA,CAAM,cAAc;AAAA,KAC9D,CAAE,CAAA;AAAA,IACF,gBAAgB,KAAA,CAAM,cAAA;AAAA,IACtB,eAAA,EAAiB,KAAA,CAAM,eAAA,EAAiB,GAAA,CAAI,CAAC,OAAA,MAAa;AAAA,MACxD,GAAG,OAAA;AAAA,MACH,SAAA,EAAW,aAAA,CAAc,OAAA,CAAQ,SAAS,CAAA;AAAA,MAC1C,OAAA,EAAS,aAAA,CAAc,OAAA,CAAQ,OAAO,CAAA;AAAA,MACtC,QAAA,EAAU,aAAA,CAAc,OAAA,CAAQ,QAAQ,CAAA;AAAA,MACxC,iBAAA,EAAmB,aAAA,CAAc,OAAA,CAAQ,iBAAiB;AAAA,KAC5D,CAAE;AAAA,GACJ;AACF;AAEO,SAAS,iBAAiB,KAAA,EAAoC;AACnE,EAAA,OAAO;AAAA,IACL,GAAG,KAAA;AAAA,IACH,gBAAA,EAAkB,KAAA,CAAM,gBAAA,CAAiB,GAAA,CAAI,wBAAwB,CAAA;AAAA,IACrE,aAAa,KAAA,CAAM,WAAA,GACf,aAAA,CAAc,KAAA,CAAM,WAAW,CAAA,GAC/B,MAAA;AAAA,IACJ,eAAA,EAAiB,wBAAA,CAAyB,KAAA,CAAM,eAAe,CAAA;AAAA,IAC/D,SAAA,EAAW,KAAA,CAAM,SAAA,CAAU,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MACrC,GAAG,CAAA;AAAA,MACH,iBAAA,EAAmB,aAAA,CAAc,CAAA,CAAE,iBAAiB,CAAA;AAAA,MACpD,eAAA,EAAiB,aAAA,CAAc,CAAA,CAAE,eAAe,CAAA;AAAA,MAChD,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,QACzB,GAAG,CAAA;AAAA,QACH,aAAA,EAAe,aAAA,CAAc,CAAA,CAAE,aAAa,CAAA;AAAA,QAC5C,UAAU,CAAA,CAAE,QAAA,GAAW,aAAA,CAAc,CAAA,CAAE,QAAQ,CAAA,GAAI;AAAA,OACrD,CAAE;AAAA,KACJ,CAAE;AAAA,GACJ;AACF","file":"contracts.js","sourcesContent":["/**\n * Domain Pack Contracts\n *\n * A DomainPack is a self-contained reasoning context bundle that defines\n * how reasoning works in a specific domain. It binds ontology versions,\n * defines topic structure, declares workflow templates, gate schemas,\n * artifact schemas, and reasoning roles.\n *\n * This is the THIRD pack type in Lucern's architecture:\n *   - AppPackManifest: UI routes, surfaces, policy profiles (app-level)\n *   - MethodologyPack: Agent workflow phases, gates, enforcement (process-level)\n *   - DomainPack: Reasoning domain context (domain-level)\n *\n * All fields are internal until RS-5+ external authoring certification.\n */\n\n// ---------------------------------------------------------------------------\n// Ontology Binding — ties a pack to specific ontology versions\n// ---------------------------------------------------------------------------\n\nexport type OntologyProvisionMode = \"bind\" | \"seed\" | \"extend\";\n\nexport type OntologyBinding = {\n  ontologyId: string;\n  versionConstraint: string; // semver range, e.g., \"^1.0.0\"\n  required: boolean;\n  provisionMode?: OntologyProvisionMode;\n  seedRef?: string;\n  requiredEntityTypes?: string[];\n  requiredEdgeTypes?: string[];\n};\n\n// ---------------------------------------------------------------------------\n// Topic Root — defines the domain's top-level topic tree structure\n// ---------------------------------------------------------------------------\n\nexport type TopicRoot = {\n  slug: string;\n  name: string;\n  description: string;\n  ontologyId?: string; // which ontology governs this root\n};\n\n// ---------------------------------------------------------------------------\n// Workflow Template — shape of a workflow (not execution logic)\n// ---------------------------------------------------------------------------\n\nexport type WorkflowStep = {\n  stepId: string;\n  name: string;\n  description: string;\n  requiredRoles: string[]; // roleId references\n  produces?: string[]; // artifactId references\n  gateId?: string; // gate checked after this step\n};\n\nexport type WorkflowTemplate = {\n  workflowId: string;\n  name: string;\n  description: string;\n  steps: WorkflowStep[];\n  requiredArtifacts: string[]; // artifactId references\n  gateCheckpoints: string[]; // gateId references\n};\n\n// ---------------------------------------------------------------------------\n// Gate Schema — declarative description of what must be true\n// ---------------------------------------------------------------------------\n\nexport type GateCriterionOperator = \"gte\" | \"lte\" | \"eq\" | \"gt\" | \"lt\";\n\nexport type GateCriterion = {\n  criterionId: string;\n  description: string;\n  metric: string;\n  threshold?: number;\n  operator?: GateCriterionOperator;\n};\n\nexport type GateSeverity = \"blocking\" | \"warning\" | \"informational\";\n\nexport type GateSchema = {\n  gateId: string;\n  name: string;\n  description: string;\n  criteria: GateCriterion[];\n  severity: GateSeverity;\n};\n\n// ---------------------------------------------------------------------------\n// Artifact Schema — what artifacts workflows produce\n// ---------------------------------------------------------------------------\n\nexport type ArtifactSchema = {\n  artifactId: string;\n  name: string;\n  description: string;\n  stage: string; // workflow step that produces this\n  contentSchema: Record<string, unknown>; // JSON Schema for content\n  requiredFields: string[];\n};\n\n// ---------------------------------------------------------------------------\n// Reasoning Role — epistemic actors in the domain\n// ---------------------------------------------------------------------------\n\nexport type ReasoningRole = {\n  roleId: string;\n  name: string;\n  description: string;\n  perspective: string;\n  optimizesFor: string;\n  mayBlock: boolean; // Epistemic Invariant #13: agents may block progress\n};\n\n// ---------------------------------------------------------------------------\n// Inquiry Shaping — pack-level hooks for RS-3 auto-shaping\n// ---------------------------------------------------------------------------\n\nexport type InquiryShapingQuestionTemplate = {\n  templateId: string;\n  questionType:\n    | \"validation\"\n    | \"falsification\"\n    | \"assumption_probe\"\n    | \"counterfactual\"\n    | \"scope\"\n    | \"comparison\"\n    | \"mechanism\"\n    | \"general\";\n  priority?: \"critical\" | \"high\" | \"medium\" | \"low\";\n  template: string; // Supports {{objective}} and {{hypothesis}}\n  whenObjectiveIncludes?: string[];\n};\n\nexport type InquiryShapingTaskTemplate = {\n  templateId: string;\n  title: string; // Supports {{objective}} and {{hypothesis}}\n  description?: string; // Supports {{objective}} and {{hypothesis}}\n  taskType?:\n    | \"general\"\n    | \"find_evidence\"\n    | \"verify_claim\"\n    | \"research\"\n    | \"review\"\n    | \"interview\"\n    | \"analysis\"\n    | \"track_metrics\";\n  priority?: \"urgent\" | \"high\" | \"medium\" | \"low\";\n  whenObjectiveIncludes?: string[];\n  whenQuestionTypes?: string[];\n};\n\nexport type InquiryShapingFrameworkHint = {\n  frameworkName: string;\n  whenObjectiveIncludes?: string[];\n  whenQuestionTypes?: string[];\n  boost?: number;\n  reason?: string;\n};\n\nexport type InquiryShapingConfig = {\n  questionTemplates?: InquiryShapingQuestionTemplate[];\n  taskTemplates?: InquiryShapingTaskTemplate[];\n  frameworkHints?: InquiryShapingFrameworkHint[];\n};\n\n// ---------------------------------------------------------------------------\n// Operating System Layer — prompts, tools, topic bootstrap, install surfaces\n// ---------------------------------------------------------------------------\n\nexport type RuntimeTarget = \"claude-code\" | \"codex\" | \"hybrid\" | \"portable\";\n\nexport type PromptSource = \"langfuse\" | \"file\";\nexport type PromptChannel =\n  | \"bootstrap\"\n  | \"workflow\"\n  | \"analysis\"\n  | \"review\"\n  | \"tool\";\n\nexport type PromptBinding = {\n  promptId: string;\n  description: string;\n  source: PromptSource;\n  ref: string;\n  fallbackRef?: string;\n  channel: PromptChannel;\n  required: boolean;\n  runtimeTargets?: RuntimeTarget[];\n};\n\nexport type ToolKind = \"mcp\" | \"cli\" | \"script\" | \"hook\" | \"ai-tool\";\n\nexport type ToolBinding = {\n  toolId: string;\n  description: string;\n  kind: ToolKind;\n  entrypoint: string;\n  required: boolean;\n  runtimeTargets?: RuntimeTarget[];\n};\n\nexport type SetupAssetKind =\n  | \"instruction\"\n  | \"settings\"\n  | \"hook\"\n  | \"skill\"\n  | \"agent\"\n  | \"manifest\"\n  | \"template\"\n  | \"inbox\"\n  | \"script\"\n  | \"ui\";\n\nexport type SetupAsset = {\n  assetId: string;\n  kind: SetupAssetKind;\n  description: string;\n  path: string;\n  required: boolean;\n  runtimeTargets?: RuntimeTarget[];\n};\n\nexport type TopicTemplate = {\n  slug: string;\n  name: string;\n  description: string;\n  parentSlug?: string;\n  ontologyId?: string;\n};\n\nexport type InstallProfile = {\n  profileId: string;\n  name: string;\n  description: string;\n  runtimeTarget: RuntimeTarget;\n  promptIds: string[];\n  toolIds: string[];\n  assetIds: string[];\n  defaultTopicSlugs: string[];\n};\n\nexport type OperatingSystemLayer = {\n  prompts?: PromptBinding[];\n  tools?: ToolBinding[];\n  setupAssets?: SetupAsset[];\n  topicTemplates?: TopicTemplate[];\n  installProfiles?: InstallProfile[];\n};\n\n// ---------------------------------------------------------------------------\n// Domain Pack — the top-level contract\n// ---------------------------------------------------------------------------\n\nexport type DomainPack = {\n  // Identity\n  packId: string;\n  name: string;\n  version: string; // semver\n\n  // Scope\n  ontologyBindings: OntologyBinding[];\n  topicRoots: TopicRoot[];\n\n  // Workflow Templates\n  workflows: WorkflowTemplate[];\n\n  // Gate Schemas\n  gates: GateSchema[];\n\n  // Artifact Schemas\n  artifacts: ArtifactSchema[];\n\n  // Reasoning Roles\n  roles: ReasoningRole[];\n\n  // Inquiry shaping hooks\n  inquiryShaping?: InquiryShapingConfig;\n\n  // Runtime/install packaging layer\n  operatingSystem?: OperatingSystemLayer;\n\n  // Composition — optional references to other pack types\n  appPackKeys?: string[]; // AppPackManifest keys this domain uses\n  methodologyPackId?: string; // MethodologyPack for agent behavior\n};\n\n// ---------------------------------------------------------------------------\n// Builder helper — normalizes arrays and validates basic structure\n// ---------------------------------------------------------------------------\n\nfunction dedupeStrings(values: string[]): string[] {\n  return Array.from(\n    new Set(values.map((v) => v.trim()).filter((v) => v.length > 0))\n  );\n}\n\nexport type DomainPackInput = Omit<DomainPack, \"appPackKeys\"> & {\n  appPackKeys?: string[];\n};\n\nfunction normalizeRuntimeTargets(\n  values: RuntimeTarget[] | undefined\n): RuntimeTarget[] | undefined {\n  return values ? (dedupeStrings(values) as RuntimeTarget[]) : undefined;\n}\n\nfunction normalizeOntologyBinding(binding: OntologyBinding): OntologyBinding {\n  return {\n    ...binding,\n    requiredEntityTypes: binding.requiredEntityTypes\n      ? dedupeStrings(binding.requiredEntityTypes)\n      : undefined,\n    requiredEdgeTypes: binding.requiredEdgeTypes\n      ? dedupeStrings(binding.requiredEdgeTypes)\n      : undefined,\n  };\n}\n\nfunction normalizeOperatingSystem(\n  layer: OperatingSystemLayer | undefined\n): OperatingSystemLayer | undefined {\n  if (!layer) {\n    return;\n  }\n\n  return {\n    prompts: layer.prompts?.map((prompt) => ({\n      ...prompt,\n      runtimeTargets: normalizeRuntimeTargets(prompt.runtimeTargets),\n    })),\n    tools: layer.tools?.map((tool) => ({\n      ...tool,\n      runtimeTargets: normalizeRuntimeTargets(tool.runtimeTargets),\n    })),\n    setupAssets: layer.setupAssets?.map((asset) => ({\n      ...asset,\n      runtimeTargets: normalizeRuntimeTargets(asset.runtimeTargets),\n    })),\n    topicTemplates: layer.topicTemplates,\n    installProfiles: layer.installProfiles?.map((profile) => ({\n      ...profile,\n      promptIds: dedupeStrings(profile.promptIds),\n      toolIds: dedupeStrings(profile.toolIds),\n      assetIds: dedupeStrings(profile.assetIds),\n      defaultTopicSlugs: dedupeStrings(profile.defaultTopicSlugs),\n    })),\n  };\n}\n\nexport function defineDomainPack(input: DomainPackInput): DomainPack {\n  return {\n    ...input,\n    ontologyBindings: input.ontologyBindings.map(normalizeOntologyBinding),\n    appPackKeys: input.appPackKeys\n      ? dedupeStrings(input.appPackKeys)\n      : undefined,\n    operatingSystem: normalizeOperatingSystem(input.operatingSystem),\n    workflows: input.workflows.map((w) => ({\n      ...w,\n      requiredArtifacts: dedupeStrings(w.requiredArtifacts),\n      gateCheckpoints: dedupeStrings(w.gateCheckpoints),\n      steps: w.steps.map((s) => ({\n        ...s,\n        requiredRoles: dedupeStrings(s.requiredRoles),\n        produces: s.produces ? dedupeStrings(s.produces) : undefined,\n      })),\n    })),\n  };\n}\n"]}
+{"version":3,"sources":["../../src/domain-pack/contracts.ts"],"names":[],"mappings":"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","file":"contracts.js","sourcesContent":["/**\n * Domain Pack Contracts\n *\n * A DomainPack is a self-contained reasoning context bundle that defines\n * how reasoning works in a specific domain. It binds ontology versions,\n * defines topic structure, declares workflow templates, gate schemas,\n * artifact schemas, and reasoning roles.\n *\n * This is the THIRD pack type in Lucern's architecture:\n *   - AppPackManifest: UI routes, surfaces, policy profiles (app-level)\n *   - MethodologyPack: Agent workflow phases, gates, enforcement (process-level)\n *   - DomainPack: Reasoning domain context (domain-level)\n *\n * All fields are internal until RS-5+ external authoring certification.\n */\n\n// ---------------------------------------------------------------------------\n// Ontology Binding — ties a pack to specific ontology versions\n// ---------------------------------------------------------------------------\n\nexport type OntologyProvisionMode = \"bind\" | \"seed\" | \"extend\";\n\nexport interface OntologyBinding {\n  ontologyId: string;\n  provisionMode?: OntologyProvisionMode;\n  required: boolean;\n  requiredEdgeTypes?: string[];\n  requiredEntityTypes?: string[];\n  seedRef?: string;\n  versionConstraint: string; // semver range, e.g., \"^1.0.0\"\n}\n\n// ---------------------------------------------------------------------------\n// Topic Root — defines the domain's top-level topic tree structure\n// ---------------------------------------------------------------------------\n\nexport interface TopicRoot {\n  description: string;\n  name: string;\n  ontologyId?: string; // which ontology governs this root\n  slug: string;\n}\n\n// ---------------------------------------------------------------------------\n// Workflow Template — shape of a workflow (not execution logic)\n// ---------------------------------------------------------------------------\n\nexport interface WorkflowStep {\n  description: string;\n  gateId?: string; // gate checked after this step\n  name: string;\n  produces?: string[]; // artifactId references\n  requiredRoles: string[]; // roleId references\n  stepId: string;\n}\n\nexport interface WorkflowTemplate {\n  description: string;\n  gateCheckpoints: string[]; // gateId references\n  name: string;\n  requiredArtifacts: string[]; // artifactId references\n  steps: WorkflowStep[];\n  workflowId: string;\n}\n\n// ---------------------------------------------------------------------------\n// Gate Schema — declarative description of what must be true\n// ---------------------------------------------------------------------------\n\nexport type GateCriterionOperator = \"gte\" | \"lte\" | \"eq\" | \"gt\" | \"lt\";\n\nexport interface GateCriterion {\n  criterionId: string;\n  description: string;\n  metric: string;\n  operator?: GateCriterionOperator;\n  threshold?: number;\n}\n\nexport type GateSeverity = \"blocking\" | \"warning\" | \"informational\";\n\nexport interface GateSchema {\n  criteria: GateCriterion[];\n  description: string;\n  gateId: string;\n  name: string;\n  severity: GateSeverity;\n}\n\n// ---------------------------------------------------------------------------\n// Artifact Schema — what artifacts workflows produce\n// ---------------------------------------------------------------------------\n\nexport interface ArtifactSchema {\n  artifactId: string;\n  contentSchema: Record<string, unknown>; // JSON Schema for content\n  description: string;\n  name: string;\n  requiredFields: string[];\n  stage: string; // workflow step that produces this\n}\n\n// ---------------------------------------------------------------------------\n// Reasoning Role — epistemic actors in the domain\n// ---------------------------------------------------------------------------\n\nexport interface ReasoningRole {\n  description: string;\n  mayBlock: boolean; // Epistemic Invariant #13: agents may block progress\n  name: string;\n  optimizesFor: string;\n  perspective: string;\n  roleId: string;\n}\n\n// ---------------------------------------------------------------------------\n// Inquiry Shaping — pack-level hooks for RS-3 auto-shaping\n// ---------------------------------------------------------------------------\n\nexport interface InquiryShapingQuestionTemplate {\n  priority?: \"critical\" | \"high\" | \"medium\" | \"low\";\n  questionType:\n    | \"validation\"\n    | \"falsification\"\n    | \"assumption_probe\"\n    | \"counterfactual\"\n    | \"scope\"\n    | \"comparison\"\n    | \"mechanism\"\n    | \"general\";\n  template: string; // Supports {{objective}} and {{hypothesis}}\n  templateId: string;\n  whenObjectiveIncludes?: string[];\n}\n\nexport interface InquiryShapingTaskTemplate {\n  description?: string; // Supports {{objective}} and {{hypothesis}}\n  priority?: \"urgent\" | \"high\" | \"medium\" | \"low\";\n  taskType?:\n    | \"general\"\n    | \"find_evidence\"\n    | \"verify_claim\"\n    | \"research\"\n    | \"review\"\n    | \"interview\"\n    | \"analysis\"\n    | \"track_metrics\";\n  templateId: string;\n  title: string; // Supports {{objective}} and {{hypothesis}}\n  whenObjectiveIncludes?: string[];\n  whenQuestionTypes?: string[];\n}\n\nexport interface InquiryShapingFrameworkHint {\n  boost?: number;\n  frameworkName: string;\n  reason?: string;\n  whenObjectiveIncludes?: string[];\n  whenQuestionTypes?: string[];\n}\n\nexport interface InquiryShapingConfig {\n  frameworkHints?: InquiryShapingFrameworkHint[];\n  questionTemplates?: InquiryShapingQuestionTemplate[];\n  taskTemplates?: InquiryShapingTaskTemplate[];\n}\n\n// ---------------------------------------------------------------------------\n// Operating System Layer — prompts, tools, topic bootstrap, install surfaces\n// ---------------------------------------------------------------------------\n\nexport type RuntimeTarget = \"claude-code\" | \"codex\" | \"hybrid\" | \"portable\";\n\nexport type PromptSource = \"langfuse\" | \"file\";\nexport type PromptChannel =\n  | \"bootstrap\"\n  | \"workflow\"\n  | \"analysis\"\n  | \"review\"\n  | \"tool\";\n\nexport interface PromptBinding {\n  channel: PromptChannel;\n  description: string;\n  fallbackRef?: string;\n  promptId: string;\n  ref: string;\n  required: boolean;\n  runtimeTargets?: RuntimeTarget[];\n  source: PromptSource;\n}\n\nexport type ToolKind = \"mcp\" | \"cli\" | \"script\" | \"hook\" | \"ai-tool\";\n\nexport interface ToolBinding {\n  description: string;\n  entrypoint: string;\n  kind: ToolKind;\n  required: boolean;\n  runtimeTargets?: RuntimeTarget[];\n  toolId: string;\n}\n\nexport type SetupAssetKind =\n  | \"instruction\"\n  | \"settings\"\n  | \"hook\"\n  | \"skill\"\n  | \"agent\"\n  | \"manifest\"\n  | \"template\"\n  | \"inbox\"\n  | \"script\"\n  | \"ui\";\n\nexport interface SetupAsset {\n  assetId: string;\n  description: string;\n  kind: SetupAssetKind;\n  path: string;\n  required: boolean;\n  runtimeTargets?: RuntimeTarget[];\n}\n\nexport interface TopicTemplate {\n  description: string;\n  name: string;\n  ontologyId?: string;\n  parentSlug?: string;\n  slug: string;\n}\n\nexport interface InstallProfile {\n  assetIds: string[];\n  defaultTopicSlugs: string[];\n  description: string;\n  name: string;\n  profileId: string;\n  promptIds: string[];\n  runtimeTarget: RuntimeTarget;\n  toolIds: string[];\n}\n\nexport interface OperatingSystemLayer {\n  installProfiles?: InstallProfile[];\n  prompts?: PromptBinding[];\n  setupAssets?: SetupAsset[];\n  tools?: ToolBinding[];\n  topicTemplates?: TopicTemplate[];\n}\n\n// ---------------------------------------------------------------------------\n// Domain Pack — the top-level contract\n// ---------------------------------------------------------------------------\n\nexport interface DomainPack {\n  // Composition — optional references to other pack types\n  appPackKeys?: string[]; // AppPackManifest keys this domain uses\n\n  // Artifact Schemas\n  artifacts: ArtifactSchema[];\n\n  // Gate Schemas\n  gates: GateSchema[];\n\n  // Inquiry shaping hooks\n  inquiryShaping?: InquiryShapingConfig;\n  methodologyPackId?: string; // MethodologyPack for agent behavior\n  name: string;\n\n  // Scope\n  ontologyBindings: OntologyBinding[];\n\n  // Runtime/install packaging layer\n  operatingSystem?: OperatingSystemLayer;\n  // Identity\n  packId: string;\n\n  // Reasoning Roles\n  roles: ReasoningRole[];\n  topicRoots: TopicRoot[];\n  version: string; // semver\n\n  // Workflow Templates\n  workflows: WorkflowTemplate[];\n}\n\n// ---------------------------------------------------------------------------\n// Builder helper — normalizes arrays and validates basic structure\n// ---------------------------------------------------------------------------\n\nfunction dedupeStrings(values: string[]): string[] {\n  return Array.from(\n    new Set(values.map((v) => v.trim()).filter((v) => v.length > 0))\n  );\n}\n\nexport type DomainPackInput = Omit<DomainPack, \"appPackKeys\"> & {\n  appPackKeys?: string[];\n};\n\nfunction normalizeRuntimeTargets(\n  values: RuntimeTarget[] | undefined\n): RuntimeTarget[] | undefined {\n  return values ? (dedupeStrings(values) as RuntimeTarget[]) : undefined;\n}\n\nfunction normalizeOntologyBinding(binding: OntologyBinding): OntologyBinding {\n  return {\n    ...binding,\n    requiredEntityTypes: binding.requiredEntityTypes\n      ? dedupeStrings(binding.requiredEntityTypes)\n      : undefined,\n    requiredEdgeTypes: binding.requiredEdgeTypes\n      ? dedupeStrings(binding.requiredEdgeTypes)\n      : undefined,\n  };\n}\n\nfunction normalizeOperatingSystem(\n  layer: OperatingSystemLayer | undefined\n): OperatingSystemLayer | undefined {\n  if (!layer) {\n    return;\n  }\n\n  return {\n    prompts: layer.prompts?.map((prompt) => ({\n      ...prompt,\n      runtimeTargets: normalizeRuntimeTargets(prompt.runtimeTargets),\n    })),\n    tools: layer.tools?.map((tool) => ({\n      ...tool,\n      runtimeTargets: normalizeRuntimeTargets(tool.runtimeTargets),\n    })),\n    setupAssets: layer.setupAssets?.map((asset) => ({\n      ...asset,\n      runtimeTargets: normalizeRuntimeTargets(asset.runtimeTargets),\n    })),\n    topicTemplates: layer.topicTemplates,\n    installProfiles: layer.installProfiles?.map((profile) => ({\n      ...profile,\n      promptIds: dedupeStrings(profile.promptIds),\n      toolIds: dedupeStrings(profile.toolIds),\n      assetIds: dedupeStrings(profile.assetIds),\n      defaultTopicSlugs: dedupeStrings(profile.defaultTopicSlugs),\n    })),\n  };\n}\n\nexport function defineDomainPack(input: DomainPackInput): DomainPack {\n  return {\n    ...input,\n    ontologyBindings: input.ontologyBindings.map(normalizeOntologyBinding),\n    appPackKeys: input.appPackKeys\n      ? dedupeStrings(input.appPackKeys)\n      : undefined,\n    operatingSystem: normalizeOperatingSystem(input.operatingSystem),\n    workflows: input.workflows.map((w) => ({\n      ...w,\n      requiredArtifacts: dedupeStrings(w.requiredArtifacts),\n      gateCheckpoints: dedupeStrings(w.gateCheckpoints),\n      steps: w.steps.map((s) => ({\n        ...s,\n        requiredRoles: dedupeStrings(s.requiredRoles),\n        produces: s.produces ? dedupeStrings(s.produces) : undefined,\n      })),\n    })),\n  };\n}\n"]}