@lucern/pack-host 0.1.0-alpha.2

package/dist/manifests/deals-v1.js

@@ -0,0 +1,107 @@
+// src/contracts.ts
+function normalizeStringArray(values) {
+  const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
+  return Array.from(new Set(normalized));
+}
+function defineAppPackManifest(manifest) {
+  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({
+    ...integration,
+    contracts: normalizeStringArray(integration.contracts)
+  }));
+  return {
+    ...manifest,
+    dependencies: normalizeStringArray(manifest.dependencies),
+    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),
+    sharedServices
+  };
+}
+
+// src/manifests/deals-v1.ts
+var dealsV1Manifest = defineAppPackManifest({
+  key: "deals-v1",
+  name: "Deals",
+  version: "1.0.0",
+  lifecycle: "beta",
+  category: "domain",
+  description: "Deal diligence application using shared reasoning graph primitives with deal-calibrated workflows.",
+  dependencies: [
+    "chat-v1",
+    "documents-v1",
+    "news-v1",
+    "decisions-v1"
+  ],
+  capabilityFlags: [
+    "deal.lifecycle",
+    "diligence.workflow",
+    "deal.risk-assessment",
+    "decision.integration"
+  ],
+  routeNamespace: {
+    web: ["/(projects)/projects", "/(projects)/projects/[projectId]"],
+    api: ["/api/research/*", "/api/tasks/*", "/api/reports/*"]
+  },
+  surfaces: {
+    components: [
+      "app/(projects)/projects/page.tsx",
+      "components/project/*",
+      "components/workspace/views/*"
+    ],
+    convex: ["convex/projects.ts", "convex/epistemicDecisions.ts"],
+    tools: [
+      "lib/ai/tools/navigation-tools.ts",
+      "lib/ai/tools/decision-tools.ts"
+    ]
+  },
+  policyProfile: {
+    audiences: ["internal", "lp"],
+    rules: [
+      { resource: "project", actions: ["read", "summarize", "mutate"] },
+      { resource: "node", actions: ["read", "summarize", "mutate"] },
+      { resource: "artifact", actions: ["read", "summarize", "export"] },
+      { resource: "tool_action", actions: ["read", "mutate"] }
+    ]
+  },
+  dataContract: {
+    requiredNodeTypes: ["deal", "belief", "question", "evidence", "decision"],
+    requiredEdgeTypes: [
+      "evaluates",
+      "informs",
+      "depends_on",
+      "based_on_belief"
+    ],
+    requiredTables: [
+      "projects",
+      "epistemicNodes",
+      "epistemicEdges",
+      "decisionEvents"
+    ],
+    projectionBehavior: "projection_required"
+  },
+  templates: {
+    workflows: ["deals/diligence-default", "deals/ic-prep"],
+    prompts: ["deals/main-system-prompt", "deals/risk-ledger-draft"],
+    reports: ["deal-memo", "knowledge-map"],
+    uiLabels: ["deal", "diligence", "investment_case", "ic_readiness"]
+  },
+  testSuite: {
+    parity: ["deal-workflow-parity"],
+    policy: ["deal-data-audience-filtering"],
+    contract: ["deals-pack-contract-v1"]
+  },
+  sharedServices: [
+    {
+      service: "decision-kernel",
+      mode: "required",
+      contracts: ["decision-kernel-v1"]
+    },
+    {
+      service: "knowledge-compiler",
+      mode: "required",
+      contracts: ["knowledge-compiler-v1"]
+    }
+  ]
+});
+
+export { dealsV1Manifest };
+//# sourceMappingURL=deals-v1.js.map
+//# sourceMappingURL=deals-v1.js.map

package/dist/manifests/deals-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts.ts","../../src/manifests/deals-v1.ts"],"names":[],"mappings":"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","file":"deals-v1.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","/**\n * App Pack Manifest: deals-v1\n *\n * Declarative runtime contract for the deals-v1 application pack.\n */\n\nimport { defineAppPackManifest } from \"../contracts\";\n\nexport const dealsV1Manifest = defineAppPackManifest({\n  key: \"deals-v1\",\n  name: \"Deals\",\n  version: \"1.0.0\",\n  lifecycle: \"beta\",\n  category: \"domain\",\n  description:\n    \"Deal diligence application using shared reasoning graph primitives with deal-calibrated workflows.\",\n  dependencies: [\n    \"chat-v1\",\n    \"documents-v1\",\n    \"news-v1\",\n    \"decisions-v1\",\n  ],\n  capabilityFlags: [\n    \"deal.lifecycle\",\n    \"diligence.workflow\",\n    \"deal.risk-assessment\",\n    \"decision.integration\",\n  ],\n  routeNamespace: {\n    web: [\"/(projects)/projects\", \"/(projects)/projects/[projectId]\"],\n    api: [\"/api/research/*\", \"/api/tasks/*\", \"/api/reports/*\"],\n  },\n  surfaces: {\n    components: [\n      \"app/(projects)/projects/page.tsx\",\n      \"components/project/*\",\n      \"components/workspace/views/*\",\n    ],\n    convex: [\"convex/projects.ts\", \"convex/epistemicDecisions.ts\"],\n    tools: [\n      \"lib/ai/tools/navigation-tools.ts\",\n      \"lib/ai/tools/decision-tools.ts\",\n    ],\n  },\n  policyProfile: {\n    audiences: [\"internal\", \"lp\"],\n    rules: [\n      { resource: \"project\", actions: [\"read\", \"summarize\", \"mutate\"] },\n      { resource: \"node\", actions: [\"read\", \"summarize\", \"mutate\"] },\n      { resource: \"artifact\", actions: [\"read\", \"summarize\", \"export\"] },\n      { resource: \"tool_action\", actions: [\"read\", \"mutate\"] },\n    ],\n  },\n  dataContract: {\n    requiredNodeTypes: [\"deal\", \"belief\", \"question\", \"evidence\", \"decision\"],\n    requiredEdgeTypes: [\n      \"evaluates\",\n      \"informs\",\n      \"depends_on\",\n      \"based_on_belief\",\n    ],\n    requiredTables: [\n      \"projects\",\n      \"epistemicNodes\",\n      \"epistemicEdges\",\n      \"decisionEvents\",\n    ],\n    projectionBehavior: \"projection_required\",\n  },\n  templates: {\n    workflows: [\"deals/diligence-default\", \"deals/ic-prep\"],\n    prompts: [\"deals/main-system-prompt\", \"deals/risk-ledger-draft\"],\n    reports: [\"deal-memo\", \"knowledge-map\"],\n    uiLabels: [\"deal\", \"diligence\", \"investment_case\", \"ic_readiness\"],\n  },\n  testSuite: {\n    parity: [\"deal-workflow-parity\"],\n    policy: [\"deal-data-audience-filtering\"],\n    contract: [\"deals-pack-contract-v1\"],\n  },\n  sharedServices: [\n    {\n      service: \"decision-kernel\",\n      mode: \"required\",\n      contracts: [\"decision-kernel-v1\"],\n    },\n    {\n      service: \"knowledge-compiler\",\n      mode: \"required\",\n      contracts: [\"knowledge-compiler-v1\"],\n    },\n  ],\n});\n"]}

package/dist/manifests/decisions-v1.d.ts

@@ -0,0 +1,10 @@
+import { AppPackManifest } from '../contracts.js';
+
+/**
+ * App Pack Manifest: decisions-v1
+ *
+ * Declarative runtime contract for the decisions-v1 application pack.
+ */
+declare const decisionsV1Manifest: AppPackManifest;
+
+export { decisionsV1Manifest };

package/dist/manifests/decisions-v1.js

@@ -0,0 +1,103 @@
+// src/contracts.ts
+function normalizeStringArray(values) {
+  const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
+  return Array.from(new Set(normalized));
+}
+function defineAppPackManifest(manifest) {
+  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({
+    ...integration,
+    contracts: normalizeStringArray(integration.contracts)
+  }));
+  return {
+    ...manifest,
+    dependencies: normalizeStringArray(manifest.dependencies),
+    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),
+    sharedServices
+  };
+}
+
+// src/manifests/decisions-v1.ts
+var decisionsV1Manifest = defineAppPackManifest({
+  key: "decisions-v1",
+  name: "Decisions",
+  version: "1.0.0",
+  lifecycle: "beta",
+  category: "decision",
+  description: "Graph-native decision workflow with belief-level voting, risk ledgers, and snapshot locking.",
+  dependencies: ["epistemic-algorithms-v1"],
+  capabilityFlags: [
+    "decision.workflow",
+    "belief.level-voting",
+    "risk.ledger",
+    "decision.snapshot"
+  ],
+  routeNamespace: {
+    web: ["/(projects)/projects/[projectId]/decisions"],
+    api: ["/api/thesis-audit/*", "/api/reports/*"]
+  },
+  surfaces: {
+    components: ["app/(projects)/projects/[projectId]/decisions/page.tsx"],
+    convex: ["convex/epistemicDecisions.ts", "convex/convictionEngine.ts"],
+    tools: [
+      "lib/ai/tools/decision-tools.ts",
+      "lib/ai/tools/conviction-tools.ts"
+    ]
+  },
+  policyProfile: {
+    audiences: ["internal", "lp"],
+    rules: [
+      { resource: "project", actions: ["read", "summarize", "mutate"] },
+      { resource: "node", actions: ["read", "summarize", "mutate"] },
+      { resource: "edge", actions: ["read", "mutate"] },
+      { resource: "artifact", actions: ["read", "export"] }
+    ]
+  },
+  dataContract: {
+    requiredNodeTypes: ["decision", "belief", "question", "evidence", "theme"],
+    requiredEdgeTypes: [
+      "based_on_belief",
+      "based_on_question",
+      "informed_by_theme",
+      "blocked_by_contradiction"
+    ],
+    requiredTables: [
+      "epistemicNodes",
+      "epistemicEdges",
+      "decisionEvents",
+      "beliefVotes",
+      "decisionRiskLedger",
+      "decisionSnapshots"
+    ],
+    projectionBehavior: "projection_required"
+  },
+  templates: {
+    workflows: ["decisions/pre-ic", "decisions/in-ic", "decisions/post-ic"],
+    prompts: [
+      "decisions/main-system-prompt",
+      "decisions/risk-ledger-assistant"
+    ],
+    reports: ["decision-brief", "ic-memo"],
+    uiLabels: ["decision", "risk_ledger", "vote_map", "snapshot"]
+  },
+  testSuite: {
+    parity: ["decision-flow-parity"],
+    policy: ["decision-lineage-visibility"],
+    contract: ["decisions-pack-contract-v1"]
+  },
+  sharedServices: [
+    {
+      service: "decision-kernel",
+      mode: "required",
+      contracts: ["decision-kernel-v1"]
+    },
+    {
+      service: "knowledge-compiler",
+      mode: "required",
+      contracts: ["knowledge-compiler-v1"]
+    }
+  ]
+});
+
+export { decisionsV1Manifest };
+//# sourceMappingURL=decisions-v1.js.map
+//# sourceMappingURL=decisions-v1.js.map

package/dist/manifests/decisions-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts.ts","../../src/manifests/decisions-v1.ts"],"names":[],"mappings":"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","file":"decisions-v1.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","/**\n * App Pack Manifest: decisions-v1\n *\n * Declarative runtime contract for the decisions-v1 application pack.\n */\n\nimport { defineAppPackManifest } from \"../contracts\";\n\nexport const decisionsV1Manifest = defineAppPackManifest({\n  key: \"decisions-v1\",\n  name: \"Decisions\",\n  version: \"1.0.0\",\n  lifecycle: \"beta\",\n  category: \"decision\",\n  description:\n    \"Graph-native decision workflow with belief-level voting, risk ledgers, and snapshot locking.\",\n  dependencies: [\"epistemic-algorithms-v1\"],\n  capabilityFlags: [\n    \"decision.workflow\",\n    \"belief.level-voting\",\n    \"risk.ledger\",\n    \"decision.snapshot\",\n  ],\n  routeNamespace: {\n    web: [\"/(projects)/projects/[projectId]/decisions\"],\n    api: [\"/api/thesis-audit/*\", \"/api/reports/*\"],\n  },\n  surfaces: {\n    components: [\"app/(projects)/projects/[projectId]/decisions/page.tsx\"],\n    convex: [\"convex/epistemicDecisions.ts\", \"convex/convictionEngine.ts\"],\n    tools: [\n      \"lib/ai/tools/decision-tools.ts\",\n      \"lib/ai/tools/conviction-tools.ts\",\n    ],\n  },\n  policyProfile: {\n    audiences: [\"internal\", \"lp\"],\n    rules: [\n      { resource: \"project\", actions: [\"read\", \"summarize\", \"mutate\"] },\n      { resource: \"node\", actions: [\"read\", \"summarize\", \"mutate\"] },\n      { resource: \"edge\", actions: [\"read\", \"mutate\"] },\n      { resource: \"artifact\", actions: [\"read\", \"export\"] },\n    ],\n  },\n  dataContract: {\n    requiredNodeTypes: [\"decision\", \"belief\", \"question\", \"evidence\", \"theme\"],\n    requiredEdgeTypes: [\n      \"based_on_belief\",\n      \"based_on_question\",\n      \"informed_by_theme\",\n      \"blocked_by_contradiction\",\n    ],\n    requiredTables: [\n      \"epistemicNodes\",\n      \"epistemicEdges\",\n      \"decisionEvents\",\n      \"beliefVotes\",\n      \"decisionRiskLedger\",\n      \"decisionSnapshots\",\n    ],\n    projectionBehavior: \"projection_required\",\n  },\n  templates: {\n    workflows: [\"decisions/pre-ic\", \"decisions/in-ic\", \"decisions/post-ic\"],\n    prompts: [\n      \"decisions/main-system-prompt\",\n      \"decisions/risk-ledger-assistant\",\n    ],\n    reports: [\"decision-brief\", \"ic-memo\"],\n    uiLabels: [\"decision\", \"risk_ledger\", \"vote_map\", \"snapshot\"],\n  },\n  testSuite: {\n    parity: [\"decision-flow-parity\"],\n    policy: [\"decision-lineage-visibility\"],\n    contract: [\"decisions-pack-contract-v1\"],\n  },\n  sharedServices: [\n    {\n      service: \"decision-kernel\",\n      mode: \"required\",\n      contracts: [\"decision-kernel-v1\"],\n    },\n    {\n      service: \"knowledge-compiler\",\n      mode: \"required\",\n      contracts: [\"knowledge-compiler-v1\"],\n    },\n  ],\n});\n"]}

package/dist/manifests/documents-v1.d.ts

@@ -0,0 +1,10 @@
+import { AppPackManifest } from '../contracts.js';
+
+/**
+ * App Pack Manifest: documents-v1
+ *
+ * Declarative runtime contract for the documents-v1 application pack.
+ */
+declare const documentsV1Manifest: AppPackManifest;
+
+export { documentsV1Manifest };

package/dist/manifests/documents-v1.js

@@ -0,0 +1,88 @@
+// src/contracts.ts
+function normalizeStringArray(values) {
+  const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
+  return Array.from(new Set(normalized));
+}
+function defineAppPackManifest(manifest) {
+  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({
+    ...integration,
+    contracts: normalizeStringArray(integration.contracts)
+  }));
+  return {
+    ...manifest,
+    dependencies: normalizeStringArray(manifest.dependencies),
+    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),
+    sharedServices
+  };
+}
+
+// src/manifests/documents-v1.ts
+var documentsV1Manifest = defineAppPackManifest({
+  key: "documents-v1",
+  name: "Documents",
+  version: "1.0.0",
+  lifecycle: "active",
+  category: "documents",
+  description: "Document upload, extraction, annotation, and conversion into graph-grounded evidence.",
+  dependencies: ["chat-v1"],
+  capabilityFlags: [
+    "document.ingestion",
+    "document.extraction",
+    "document.annotation",
+    "document.rag"
+  ],
+  routeNamespace: {
+    web: [
+      "/(projects)/projects/[projectId]/documents",
+      "/(projects)/projects/[projectId]/documents/[documentId]"
+    ],
+    api: ["/api/documents/*", "/api/rag/document", "/api/rag/extract-pdf"]
+  },
+  surfaces: {
+    components: ["components/documents/*", "components/document/*"],
+    convex: [
+      "convex/projectDocuments.ts",
+      "convex/documents.ts",
+      "convex/documentAnnotations.ts",
+      "convex/projectDocumentsActions.ts"
+    ],
+    tools: ["lib/ai/tools/create-document.ts"]
+  },
+  policyProfile: {
+    audiences: ["internal", "lp"],
+    rules: [
+      { resource: "artifact", actions: ["read", "summarize", "mutate"] },
+      { resource: "project", actions: ["read", "summarize", "mutate"] },
+      { resource: "tool_action", actions: ["read", "mutate"] }
+    ]
+  },
+  dataContract: {
+    requiredNodeTypes: ["source", "excerpt", "evidence", "synthesis"],
+    requiredEdgeTypes: ["extracted_from", "based_on", "informs"],
+    requiredTables: [
+      "projectDocuments",
+      "projectDocumentsSyncLog",
+      "documentAnnotations",
+      "epistemicNodes"
+    ],
+    projectionBehavior: "inherits_policy"
+  },
+  templates: {
+    workflows: [
+      "documents/upload-extract-link",
+      "documents/annotate-to-evidence"
+    ],
+    prompts: ["documents/extraction", "documents/summarization"],
+    reports: [],
+    uiLabels: ["documents", "annotations", "excerpts", "sources"]
+  },
+  testSuite: {
+    parity: ["documents-page-parity"],
+    policy: ["document-access-enforcement"],
+    contract: ["documents-pack-contract-v1"]
+  }
+});
+
+export { documentsV1Manifest };
+//# sourceMappingURL=documents-v1.js.map
+//# sourceMappingURL=documents-v1.js.map

package/dist/manifests/documents-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts.ts","../../src/manifests/documents-v1.ts"],"names":[],"mappings":"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","file":"documents-v1.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","/**\n * App Pack Manifest: documents-v1\n *\n * Declarative runtime contract for the documents-v1 application pack.\n */\n\nimport { defineAppPackManifest } from \"../contracts\";\n\nexport const documentsV1Manifest = defineAppPackManifest({\n  key: \"documents-v1\",\n  name: \"Documents\",\n  version: \"1.0.0\",\n  lifecycle: \"active\",\n  category: \"documents\",\n  description:\n    \"Document upload, extraction, annotation, and conversion into graph-grounded evidence.\",\n  dependencies: [\"chat-v1\"],\n  capabilityFlags: [\n    \"document.ingestion\",\n    \"document.extraction\",\n    \"document.annotation\",\n    \"document.rag\",\n  ],\n  routeNamespace: {\n    web: [\n      \"/(projects)/projects/[projectId]/documents\",\n      \"/(projects)/projects/[projectId]/documents/[documentId]\",\n    ],\n    api: [\"/api/documents/*\", \"/api/rag/document\", \"/api/rag/extract-pdf\"],\n  },\n  surfaces: {\n    components: [\"components/documents/*\", \"components/document/*\"],\n    convex: [\n      \"convex/projectDocuments.ts\",\n      \"convex/documents.ts\",\n      \"convex/documentAnnotations.ts\",\n      \"convex/projectDocumentsActions.ts\",\n    ],\n    tools: [\"lib/ai/tools/create-document.ts\"],\n  },\n  policyProfile: {\n    audiences: [\"internal\", \"lp\"],\n    rules: [\n      { resource: \"artifact\", actions: [\"read\", \"summarize\", \"mutate\"] },\n      { resource: \"project\", actions: [\"read\", \"summarize\", \"mutate\"] },\n      { resource: \"tool_action\", actions: [\"read\", \"mutate\"] },\n    ],\n  },\n  dataContract: {\n    requiredNodeTypes: [\"source\", \"excerpt\", \"evidence\", \"synthesis\"],\n    requiredEdgeTypes: [\"extracted_from\", \"based_on\", \"informs\"],\n    requiredTables: [\n      \"projectDocuments\",\n      \"projectDocumentsSyncLog\",\n      \"documentAnnotations\",\n      \"epistemicNodes\",\n    ],\n    projectionBehavior: \"inherits_policy\",\n  },\n  templates: {\n    workflows: [\n      \"documents/upload-extract-link\",\n      \"documents/annotate-to-evidence\",\n    ],\n    prompts: [\"documents/extraction\", \"documents/summarization\"],\n    reports: [],\n    uiLabels: [\"documents\", \"annotations\", \"excerpts\", \"sources\"],\n  },\n  testSuite: {\n    parity: [\"documents-page-parity\"],\n    policy: [\"document-access-enforcement\"],\n    contract: [\"documents-pack-contract-v1\"],\n  },\n});\n"]}

package/dist/manifests/epistemic-algorithms-v1.d.ts

@@ -0,0 +1,10 @@
+import { AppPackManifest } from '../contracts.js';
+
+/**
+ * App Pack Manifest: epistemic-algorithms-v1
+ *
+ * Declarative runtime contract for the epistemic-algorithms-v1 application pack.
+ */
+declare const epistemicAlgorithmsV1Manifest: AppPackManifest;
+
+export { epistemicAlgorithmsV1Manifest };

package/dist/manifests/epistemic-algorithms-v1.js

@@ -0,0 +1,107 @@
+// src/contracts.ts
+function normalizeStringArray(values) {
+  const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
+  return Array.from(new Set(normalized));
+}
+function defineAppPackManifest(manifest) {
+  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({
+    ...integration,
+    contracts: normalizeStringArray(integration.contracts)
+  }));
+  return {
+    ...manifest,
+    dependencies: normalizeStringArray(manifest.dependencies),
+    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),
+    sharedServices
+  };
+}
+
+// src/manifests/epistemic-algorithms-v1.ts
+var epistemicAlgorithmsV1Manifest = defineAppPackManifest({
+  key: "epistemic-algorithms-v1",
+  name: "Epistemic Algorithms",
+  version: "1.0.0",
+  lifecycle: "active",
+  category: "analytics",
+  description: "Reasoning quality engines: contradiction detection, conviction dynamics, and graph intelligence analytics.",
+  dependencies: ["graph-visualization-v1", "chat-v1"],
+  capabilityFlags: [
+    "contradiction.detection",
+    "conviction.analytics",
+    "reasoning.depth",
+    "bias.detection"
+  ],
+  routeNamespace: {
+    web: [
+      "/(projects)/projects/[projectId]/contradictions",
+      "/(projects)/projects/[projectId]/thesis-audit"
+    ],
+    api: ["/api/thesis-audit", "/api/graph-explain", "/api/lucern/*"]
+  },
+  surfaces: {
+    components: ["components/epistemic/*", "components/contradiction/*"],
+    convex: [
+      "convex/contradictions.ts",
+      "convex/convictionEngine.ts",
+      "convex/graphIntelligence.ts",
+      "convex/thesisAuditAgents.ts"
+    ],
+    tools: ["lib/ai/tools/graph-intelligence-tools.ts"]
+  },
+  policyProfile: {
+    audiences: ["internal", "lp"],
+    rules: [
+      { resource: "node", actions: ["read", "summarize"] },
+      { resource: "edge", actions: ["read", "summarize"] },
+      { resource: "artifact", actions: ["read", "summarize", "export"] }
+    ]
+  },
+  dataContract: {
+    requiredNodeTypes: ["belief", "question", "evidence", "theme", "decision"],
+    requiredEdgeTypes: [
+      "informs",
+      "contradicts",
+      "depends_on",
+      "strengthened_by",
+      "weakened_by",
+      "collapses_if"
+    ],
+    requiredTables: [
+      "contradictions",
+      "beliefConfidence",
+      "epistemicAudit",
+      "graphAnalysisResults"
+    ],
+    projectionBehavior: "inherits_policy"
+  },
+  templates: {
+    workflows: ["epistemic/contradiction-resolution", "epistemic/thesis-audit"],
+    prompts: [
+      "graph-intelligence/full-guide",
+      "graph-intelligence/bias-detection"
+    ],
+    reports: ["knowledge_map"],
+    uiLabels: [
+      "contradiction",
+      "conviction",
+      "thesis_audit",
+      "epistemic_health"
+    ]
+  },
+  testSuite: {
+    parity: ["epistemic-algorithm-output-parity"],
+    policy: ["epistemic-output-scope-filtering"],
+    contract: ["epistemic-algorithms-pack-contract-v1"]
+  },
+  sharedServices: [
+    {
+      service: "knowledge-compiler",
+      mode: "required",
+      contracts: ["knowledge-compiler-v1"]
+    }
+  ]
+});
+
+export { epistemicAlgorithmsV1Manifest };
+//# sourceMappingURL=epistemic-algorithms-v1.js.map
+//# sourceMappingURL=epistemic-algorithms-v1.js.map

package/dist/manifests/epistemic-algorithms-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts.ts","../../src/manifests/epistemic-algorithms-v1.ts"],"names":[],"mappings":"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","file":"epistemic-algorithms-v1.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","/**\n * App Pack Manifest: epistemic-algorithms-v1\n *\n * Declarative runtime contract for the epistemic-algorithms-v1 application pack.\n */\n\nimport { defineAppPackManifest } from \"../contracts\";\n\nexport const epistemicAlgorithmsV1Manifest = defineAppPackManifest({\n  key: \"epistemic-algorithms-v1\",\n  name: \"Epistemic Algorithms\",\n  version: \"1.0.0\",\n  lifecycle: \"active\",\n  category: \"analytics\",\n  description:\n    \"Reasoning quality engines: contradiction detection, conviction dynamics, and graph intelligence analytics.\",\n  dependencies: [\"graph-visualization-v1\", \"chat-v1\"],\n  capabilityFlags: [\n    \"contradiction.detection\",\n    \"conviction.analytics\",\n    \"reasoning.depth\",\n    \"bias.detection\",\n  ],\n  routeNamespace: {\n    web: [\n      \"/(projects)/projects/[projectId]/contradictions\",\n      \"/(projects)/projects/[projectId]/thesis-audit\",\n    ],\n    api: [\"/api/thesis-audit\", \"/api/graph-explain\", \"/api/lucern/*\"],\n  },\n  surfaces: {\n    components: [\"components/epistemic/*\", \"components/contradiction/*\"],\n    convex: [\n      \"convex/contradictions.ts\",\n      \"convex/convictionEngine.ts\",\n      \"convex/graphIntelligence.ts\",\n      \"convex/thesisAuditAgents.ts\",\n    ],\n    tools: [\"lib/ai/tools/graph-intelligence-tools.ts\"],\n  },\n  policyProfile: {\n    audiences: [\"internal\", \"lp\"],\n    rules: [\n      { resource: \"node\", actions: [\"read\", \"summarize\"] },\n      { resource: \"edge\", actions: [\"read\", \"summarize\"] },\n      { resource: \"artifact\", actions: [\"read\", \"summarize\", \"export\"] },\n    ],\n  },\n  dataContract: {\n    requiredNodeTypes: [\"belief\", \"question\", \"evidence\", \"theme\", \"decision\"],\n    requiredEdgeTypes: [\n      \"informs\",\n      \"contradicts\",\n      \"depends_on\",\n      \"strengthened_by\",\n      \"weakened_by\",\n      \"collapses_if\",\n    ],\n    requiredTables: [\n      \"contradictions\",\n      \"beliefConfidence\",\n      \"epistemicAudit\",\n      \"graphAnalysisResults\",\n    ],\n    projectionBehavior: \"inherits_policy\",\n  },\n  templates: {\n    workflows: [\"epistemic/contradiction-resolution\", \"epistemic/thesis-audit\"],\n    prompts: [\n      \"graph-intelligence/full-guide\",\n      \"graph-intelligence/bias-detection\",\n    ],\n    reports: [\"knowledge_map\"],\n    uiLabels: [\n      \"contradiction\",\n      \"conviction\",\n      \"thesis_audit\",\n      \"epistemic_health\",\n    ],\n  },\n  testSuite: {\n    parity: [\"epistemic-algorithm-output-parity\"],\n    policy: [\"epistemic-output-scope-filtering\"],\n    contract: [\"epistemic-algorithms-pack-contract-v1\"],\n  },\n  sharedServices: [\n    {\n      service: \"knowledge-compiler\",\n      mode: \"required\",\n      contracts: [\"knowledge-compiler-v1\"],\n    },\n  ],\n});\n"]}

package/dist/manifests/graph-visualization-v1.d.ts

@@ -0,0 +1,10 @@
+import { AppPackManifest } from '../contracts.js';
+
+/**
+ * App Pack Manifest: graph-visualization-v1
+ *
+ * Declarative runtime contract for the graph-visualization-v1 application pack.
+ */
+declare const graphVisualizationV1Manifest: AppPackManifest;
+
+export { graphVisualizationV1Manifest };

package/dist/manifests/graph-visualization-v1.js

@@ -0,0 +1,88 @@
+// src/contracts.ts
+function normalizeStringArray(values) {
+  const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
+  return Array.from(new Set(normalized));
+}
+function defineAppPackManifest(manifest) {
+  const sharedServices = (manifest.sharedServices ?? []).map((integration) => ({
+    ...integration,
+    contracts: normalizeStringArray(integration.contracts)
+  }));
+  return {
+    ...manifest,
+    dependencies: normalizeStringArray(manifest.dependencies),
+    capabilityFlags: normalizeStringArray(manifest.capabilityFlags),
+    sharedServices
+  };
+}
+
+// src/manifests/graph-visualization-v1.ts
+var graphVisualizationV1Manifest = defineAppPackManifest({
+  key: "graph-visualization-v1",
+  name: "Graph Visualization",
+  version: "1.0.0",
+  lifecycle: "active",
+  category: "graph",
+  description: "Interactive graph explorer for node/edge traversal, neighborhood inspection, and query rendering.",
+  dependencies: ["chat-v1"],
+  capabilityFlags: [
+    "graph.rendering",
+    "graph.query",
+    "graph.highlighting",
+    "graph.neighborhood"
+  ],
+  routeNamespace: {
+    web: ["/(projects)/projects/[projectId]/graph"],
+    api: ["/api/graph", "/api/graph-query", "/api/graph-suggestions"]
+  },
+  surfaces: {
+    components: [
+      "app/(projects)/projects/[projectId]/graph/components/*",
+      "components/workspace/views/ProjectHomeView.tsx"
+    ],
+    convex: ["convex/epistemicQueries.ts", "convex/neo4jQueries.ts"],
+    tools: [
+      "lib/ai/tools/knowledge-graph-tools.ts",
+      "lib/ai/tools/cypher-tools.ts"
+    ]
+  },
+  policyProfile: {
+    audiences: ["internal", "lp"],
+    rules: [
+      { resource: "node", actions: ["read", "summarize"] },
+      { resource: "edge", actions: ["read", "summarize"] },
+      { resource: "tool_action", actions: ["read"] }
+    ]
+  },
+  dataContract: {
+    requiredNodeTypes: [
+      "belief",
+      "question",
+      "evidence",
+      "theme",
+      "deal",
+      "decision"
+    ],
+    requiredEdgeTypes: ["informs", "answers", "belongs_to", "depends_on"],
+    requiredTables: ["epistemicNodes", "epistemicEdges"],
+    projectionBehavior: "inherits_policy"
+  },
+  templates: {
+    workflows: ["graph/query-and-traverse"],
+    prompts: [
+      "graph-intelligence/query",
+      "graph-intelligence/suggestions-extraction"
+    ],
+    reports: [],
+    uiLabels: ["graph", "nodes", "edges", "lineage"]
+  },
+  testSuite: {
+    parity: ["graph-query-parity", "graph-render-parity"],
+    policy: ["graph-node-visibility-filtering"],
+    contract: ["graph-visualization-pack-contract-v1"]
+  }
+});
+
+export { graphVisualizationV1Manifest };
+//# sourceMappingURL=graph-visualization-v1.js.map
+//# sourceMappingURL=graph-visualization-v1.js.map