@lucern/contracts 0.3.0-alpha.7 → 0.3.0-alpha.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/dist/context-pack.contract.d.ts +5 -3
  2. package/dist/context-pack.contract.js.map +1 -1
  3. package/dist/edge-policy-manifest-Dw5IhT1L.d.ts +133 -0
  4. package/dist/function-registry/beliefs.js +4 -4
  5. package/dist/function-registry/beliefs.js.map +1 -1
  6. package/dist/function-registry/coding.js +4 -4
  7. package/dist/function-registry/coding.js.map +1 -1
  8. package/dist/function-registry/context.js +5 -5
  9. package/dist/function-registry/context.js.map +1 -1
  10. package/dist/function-registry/contracts.js +4 -4
  11. package/dist/function-registry/contracts.js.map +1 -1
  12. package/dist/function-registry/coordination.js +4 -4
  13. package/dist/function-registry/coordination.js.map +1 -1
  14. package/dist/function-registry/edges.js +53 -35
  15. package/dist/function-registry/edges.js.map +1 -1
  16. package/dist/function-registry/evidence.js +8 -8
  17. package/dist/function-registry/evidence.js.map +1 -1
  18. package/dist/function-registry/graph.js +4 -4
  19. package/dist/function-registry/graph.js.map +1 -1
  20. package/dist/function-registry/helpers.js +4 -4
  21. package/dist/function-registry/helpers.js.map +1 -1
  22. package/dist/function-registry/identity.js +4 -4
  23. package/dist/function-registry/identity.js.map +1 -1
  24. package/dist/function-registry/index.js +4 -4
  25. package/dist/function-registry/index.js.map +1 -1
  26. package/dist/function-registry/judgments.js +4 -4
  27. package/dist/function-registry/judgments.js.map +1 -1
  28. package/dist/function-registry/legacy.js +4 -4
  29. package/dist/function-registry/legacy.js.map +1 -1
  30. package/dist/function-registry/lenses.js +4 -4
  31. package/dist/function-registry/lenses.js.map +1 -1
  32. package/dist/function-registry/ontologies.js +4 -4
  33. package/dist/function-registry/ontologies.js.map +1 -1
  34. package/dist/function-registry/pipeline.js +4 -4
  35. package/dist/function-registry/pipeline.js.map +1 -1
  36. package/dist/function-registry/questions.js +4 -4
  37. package/dist/function-registry/questions.js.map +1 -1
  38. package/dist/function-registry/tasks.js +4 -4
  39. package/dist/function-registry/tasks.js.map +1 -1
  40. package/dist/function-registry/topics.js +4 -4
  41. package/dist/function-registry/topics.js.map +1 -1
  42. package/dist/function-registry/worktrees.js +4 -4
  43. package/dist/function-registry/worktrees.js.map +1 -1
  44. package/dist/index.d.ts +1 -1
  45. package/dist/index.js +45 -37
  46. package/dist/index.js.map +1 -1
  47. package/dist/manifests/edge-policy-manifest.d.ts +1 -1
  48. package/dist/manifests/edge-policy-manifest.data.d.ts +6 -20
  49. package/dist/manifests/edge-policy-manifest.data.js +18 -26
  50. package/dist/manifests/edge-policy-manifest.data.js.map +1 -1
  51. package/dist/manifests/edge-policy-manifest.js +31 -4
  52. package/dist/manifests/edge-policy-manifest.js.map +1 -1
  53. package/dist/sdk-tools.contract.js +4 -4
  54. package/dist/sdk-tools.contract.js.map +1 -1
  55. package/dist/tenant-bootstrap-seed.contract.d.ts +4 -4
  56. package/dist/tenant-bootstrap-seed.contract.js +2 -2
  57. package/dist/tenant-bootstrap-seed.contract.js.map +1 -1
  58. package/dist/tool-contracts.js +4 -4
  59. package/dist/tool-contracts.js.map +1 -1
  60. package/package.json +1 -1
  61. package/dist/edge-policy-manifest-Byv6cQPP.d.ts +0 -132
@@ -2085,15 +2085,15 @@ var IDENTITY_WHOAMI = {
2085
2085
  };
2086
2086
  var COMPILE_CONTEXT = {
2087
2087
  name: "compile_context",
2088
- description: "Compile a focused reasoning context for a topic. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
2088
+ description: "Compile a focused reasoning context. If topicId is omitted, Lucern resolves the best topic from the query. Like `git log --graph --decorate` for the reasoning substrate \u2014 returns the canonical Pillar 3 context pack through the public API shape.",
2089
2089
  parameters: {
2090
2090
  topicId: {
2091
2091
  type: "string",
2092
- description: "Topic scope ID to compile"
2092
+ description: "Optional topic scope ID. Omit to resolve the topic from query."
2093
2093
  },
2094
2094
  query: {
2095
2095
  type: "string",
2096
- description: "Optional focus query used to rank context items"
2096
+ description: "Focus query used to resolve the topic and rank context items. Required when topicId is omitted."
2097
2097
  },
2098
2098
  budget: {
2099
2099
  type: "number",
@@ -2117,7 +2117,7 @@ var COMPILE_CONTEXT = {
2117
2117
  description: "Include related ontological entities in the compiled result"
2118
2118
  }
2119
2119
  },
2120
- required: ["topicId"],
2120
+ required: [],
2121
2121
  response: {
2122
2122
  description: "Compiled context pack for the requested topic",
2123
2123
  fields: {
@@ -4531,17 +4531,44 @@ function surfaceContract(args) {
4531
4531
  }
4532
4532
  });
4533
4533
  }
4534
- var EpistemicNodeTypeSchema = z.enum([
4534
+
4535
+ // src/schema-helpers/spine/tables/epistemicNodes.ts
4536
+ var NODE_TYPES = [
4537
+ "decision",
4535
4538
  "belief",
4536
- "evidence",
4537
4539
  "question",
4538
- "answer",
4540
+ "theme",
4541
+ "deal",
4539
4542
  "topic",
4543
+ "claim",
4544
+ "evidence",
4545
+ "synthesis",
4546
+ "answer",
4547
+ "atomic_fact",
4548
+ "excerpt",
4549
+ "source",
4550
+ "company",
4551
+ "person",
4552
+ "investor",
4553
+ "function",
4554
+ "value_chain"
4555
+ ];
4556
+ new Set(NODE_TYPES);
4557
+
4558
+ // src/types/graph-ref.ts
4559
+ var GRAPH_REF_EXTRA_NODE_TYPES = [
4540
4560
  "edge",
4541
4561
  "ontology",
4542
4562
  "lens",
4543
4563
  "contradiction"
4544
- ]);
4564
+ ];
4565
+ var GRAPH_REF_NODE_TYPES = [
4566
+ ...NODE_TYPES,
4567
+ ...GRAPH_REF_EXTRA_NODE_TYPES
4568
+ ];
4569
+ var EpistemicNodeTypeSchema = z.enum(
4570
+ GRAPH_REF_NODE_TYPES
4571
+ );
4545
4572
  var GraphRefSchema = z.discriminatedUnion("kind", [
4546
4573
  z.object({
4547
4574
  kind: z.literal("epistemic_node"),
@@ -4589,42 +4616,33 @@ function assertEdgePolicyAllowed(manifest, edgeType, from, to) {
4589
4616
  throw error;
4590
4617
  }
4591
4618
  }
4619
+ z.enum(["decision", "belief", "question", "theme", "deal", "topic", "claim", "evidence", "synthesis", "answer", "atomic_fact", "excerpt", "source", "company", "person", "investor", "function", "value_chain"]);
4620
+ var EDGE_TYPE_VALUES = ["supports", "informs", "depends_on", "derived_from", "contains", "tests", "supersedes", "responds_to", "belongs_to", "relates_to_thesis", "works_at", "invested_in", "competes_with", "participates_in", "founded_by", "evaluates", "performs", "function_in", "impacts", "raised_from", "mentioned_in", "perspective_on", "plays_theme", "answers", "explores", "qualifies", "based_on", "based_on_belief", "based_on_question", "blocked_by_contradiction", "informed_by_theme", "same_as", "reinforces", "parent_of", "child_of", "falsified_by", "exclusive_with", "collapses_if", "cascade_from", "counterfactual_of", "cascade_to", "mutually_exclusive", "correlates_with", "amplifies", "precondition_for", "in_tension_with", "strengthened_by", "weakened_by", "alternative_to", "subsumes", "validated_by", "required_for", "blocks", "prerequisite_for", "parallel_to", "corroborates", "extends", "same_source_as", "same_theme_as", "assumes", "would_predict", "analogous_to", "independent_of", "implements", "violates", "co_changes_with", "migrating_from", "migrating_to", "scoped_by", "about_entity", "entity_referenced_in", "contradicts", "cites", "summarizes", "related_to", "partially_answers", "refines", "branches_from"];
4621
+ var STORAGE_EDGE_TYPE_VALUES = [...EDGE_TYPE_VALUES, "extracted_from"];
4622
+ z.enum(EDGE_TYPE_VALUES);
4623
+ z.enum(STORAGE_EDGE_TYPE_VALUES);
4624
+ z.enum(["active", "archived", "watching"]);
4625
+ z.enum(["private", "team", "firm", "external", "public"]);
4592
4626
 
4593
4627
  // src/manifests/edge-policy-manifest.data.ts
4628
+ var publicEpistemicNodeEdgePolicy = (edgeType) => ({
4629
+ edgeType,
4630
+ fromKinds: ["epistemic_node"],
4631
+ toKinds: ["epistemic_node"],
4632
+ description: "Canonical public create_edge policy for graph-node relationships. The policy layer gates edge-type membership, not endpoint semantics."
4633
+ });
4594
4634
  var edgePolicyManifest = {
4595
- policies: [
4596
- {
4597
- edgeType: "evidence_derived_from_evidence",
4598
- fromKinds: ["epistemic_node"],
4599
- fromNodeTypes: ["evidence"],
4600
- toKinds: ["epistemic_node"],
4601
- toNodeTypes: ["evidence"],
4602
- description: "Evidence E2 was synthesized from evidence E1 by a transformation. Provides chain-of-evidence lineage."
4603
- },
4604
- {
4605
- edgeType: "evidence_supports_belief",
4606
- fromKinds: ["epistemic_node"],
4607
- fromNodeTypes: ["evidence"],
4608
- toKinds: ["epistemic_node"],
4609
- toNodeTypes: ["belief"],
4610
- description: "Existing link_evidence_to_belief semantics promoted to the create_edge policy source."
4611
- },
4612
- {
4613
- edgeType: "evidence_supports_question",
4614
- fromKinds: ["epistemic_node"],
4615
- fromNodeTypes: ["evidence"],
4616
- toKinds: ["epistemic_node"],
4617
- toNodeTypes: ["question"],
4618
- description: "Existing link_evidence_to_question semantics promoted to the create_edge policy source."
4619
- }
4620
- ]
4635
+ policies: EDGE_TYPE_VALUES.map(publicEpistemicNodeEdgePolicy)
4621
4636
  };
4622
4637
 
4623
4638
  // src/function-registry/edges.ts
4639
+ var CREATE_EDGE_TYPES = edgePolicyManifest.policies.map(
4640
+ (policy) => policy.edgeType
4641
+ );
4624
4642
  var createEdgeArgs = z.object({
4625
4643
  from: GraphRefSchema,
4626
4644
  to: GraphRefSchema,
4627
- edgeType: z.string(),
4645
+ edgeType: z.enum(CREATE_EDGE_TYPES),
4628
4646
  globalId: z.string().optional(),
4629
4647
  weight: z.number().optional(),
4630
4648
  confidence: z.number().optional(),