@lucern/pack-host 0.1.0-alpha.2

package/dist/lifecycle.d.ts

@@ -0,0 +1,27 @@
+import { PackLifecycle, AppPackManifest } from './contracts.js';
+
+/**
+ * Pack Lifecycle Enforcement
+ *
+ * License and dependency checks for tenant/workspace pack enablement.
+ */
+
+type PackEnablementReason = "allowed" | "pack_not_found" | "lifecycle_blocked" | "license_missing" | "dependency_missing" | "dependency_not_installed" | "dependency_not_enabled";
+type PackEnablementDecision = {
+    packKey: string;
+    allowed: boolean;
+    reason: PackEnablementReason;
+    missingDependencies: string[];
+};
+type PackEnablementPolicy = {
+    requireExplicitEntitlement?: boolean;
+    allowedLifecycles?: readonly PackLifecycle[];
+    tenantEntitledPackKeys?: readonly string[];
+    workspaceEntitledPackKeys?: readonly string[];
+    installedPackKeys?: readonly string[];
+    enabledPackKeys?: readonly string[];
+};
+declare function evaluatePackEnablement(packKey: string, registry: Record<string, AppPackManifest>, policy?: PackEnablementPolicy): PackEnablementDecision;
+declare function evaluateCatalogEnablement(registry: Record<string, AppPackManifest>, policy?: PackEnablementPolicy): PackEnablementDecision[];
+
+export { type PackEnablementDecision, type PackEnablementPolicy, type PackEnablementReason, evaluateCatalogEnablement, evaluatePackEnablement };

package/dist/lifecycle.js

@@ -0,0 +1,98 @@
+// src/lifecycle.ts
+var DEFAULT_ALLOWED_LIFECYCLES = [
+  "active",
+  "beta",
+  "experimental"
+];
+function toSet(values) {
+  return new Set(values ?? []);
+}
+function evaluatePackEnablement(packKey, registry, policy = {}) {
+  const manifest = registry[packKey];
+  if (!manifest) {
+    return {
+      packKey,
+      allowed: false,
+      reason: "pack_not_found",
+      missingDependencies: []
+    };
+  }
+  const allowedLifecycles = new Set(
+    policy.allowedLifecycles ?? DEFAULT_ALLOWED_LIFECYCLES
+  );
+  if (!allowedLifecycles.has(manifest.lifecycle)) {
+    return {
+      packKey,
+      allowed: false,
+      reason: "lifecycle_blocked",
+      missingDependencies: []
+    };
+  }
+  const requireExplicitEntitlement = policy.requireExplicitEntitlement ?? false;
+  if (requireExplicitEntitlement) {
+    const entitled = /* @__PURE__ */ new Set([
+      ...toSet(policy.tenantEntitledPackKeys),
+      ...toSet(policy.workspaceEntitledPackKeys)
+    ]);
+    if (!entitled.has(packKey)) {
+      return {
+        packKey,
+        allowed: false,
+        reason: "license_missing",
+        missingDependencies: []
+      };
+    }
+  }
+  const missingDependencies = manifest.dependencies.filter(
+    (dependency) => !registry[dependency]
+  );
+  if (missingDependencies.length > 0) {
+    return {
+      packKey,
+      allowed: false,
+      reason: "dependency_missing",
+      missingDependencies
+    };
+  }
+  const installed = toSet(policy.installedPackKeys);
+  if (installed.size > 0) {
+    const notInstalled = manifest.dependencies.filter(
+      (dependency) => !installed.has(dependency)
+    );
+    if (notInstalled.length > 0) {
+      return {
+        packKey,
+        allowed: false,
+        reason: "dependency_not_installed",
+        missingDependencies: notInstalled
+      };
+    }
+  }
+  const enabled = toSet(policy.enabledPackKeys);
+  if (enabled.size > 0) {
+    const notEnabled = manifest.dependencies.filter(
+      (dependency) => !enabled.has(dependency)
+    );
+    if (notEnabled.length > 0) {
+      return {
+        packKey,
+        allowed: false,
+        reason: "dependency_not_enabled",
+        missingDependencies: notEnabled
+      };
+    }
+  }
+  return {
+    packKey,
+    allowed: true,
+    reason: "allowed",
+    missingDependencies: []
+  };
+}
+function evaluateCatalogEnablement(registry, policy = {}) {
+  return Object.keys(registry).sort().map((packKey) => evaluatePackEnablement(packKey, registry, policy));
+}
+
+export { evaluateCatalogEnablement, evaluatePackEnablement };
+//# sourceMappingURL=lifecycle.js.map
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lifecycle.ts"],"names":[],"mappings":"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","file":"lifecycle.js","sourcesContent":["/**\n * Pack Lifecycle Enforcement\n *\n * License and dependency checks for tenant/workspace pack enablement.\n */\n\nimport type { AppPackManifest, PackLifecycle } from \"./contracts\";\n\nexport type PackEnablementReason =\n  | \"allowed\"\n  | \"pack_not_found\"\n  | \"lifecycle_blocked\"\n  | \"license_missing\"\n  | \"dependency_missing\"\n  | \"dependency_not_installed\"\n  | \"dependency_not_enabled\";\n\nexport type PackEnablementDecision = {\n  packKey: string;\n  allowed: boolean;\n  reason: PackEnablementReason;\n  missingDependencies: string[];\n};\n\nexport type PackEnablementPolicy = {\n  requireExplicitEntitlement?: boolean;\n  allowedLifecycles?: readonly PackLifecycle[];\n  tenantEntitledPackKeys?: readonly string[];\n  workspaceEntitledPackKeys?: readonly string[];\n  installedPackKeys?: readonly string[];\n  enabledPackKeys?: readonly string[];\n};\n\nconst DEFAULT_ALLOWED_LIFECYCLES: PackLifecycle[] = [\n  \"active\",\n  \"beta\",\n  \"experimental\",\n];\n\nfunction toSet(values?: readonly string[]): Set<string> {\n  return new Set(values ?? []);\n}\n\nexport function evaluatePackEnablement(\n  packKey: string,\n  registry: Record<string, AppPackManifest>,\n  policy: PackEnablementPolicy = {}\n): PackEnablementDecision {\n  const manifest = registry[packKey];\n  if (!manifest) {\n    return {\n      packKey,\n      allowed: false,\n      reason: \"pack_not_found\",\n      missingDependencies: [],\n    };\n  }\n\n  const allowedLifecycles = new Set(\n    policy.allowedLifecycles ?? DEFAULT_ALLOWED_LIFECYCLES\n  );\n  if (!allowedLifecycles.has(manifest.lifecycle)) {\n    return {\n      packKey,\n      allowed: false,\n      reason: \"lifecycle_blocked\",\n      missingDependencies: [],\n    };\n  }\n\n  const requireExplicitEntitlement = policy.requireExplicitEntitlement ?? false;\n  if (requireExplicitEntitlement) {\n    const entitled = new Set([\n      ...toSet(policy.tenantEntitledPackKeys),\n      ...toSet(policy.workspaceEntitledPackKeys),\n    ]);\n    if (!entitled.has(packKey)) {\n      return {\n        packKey,\n        allowed: false,\n        reason: \"license_missing\",\n        missingDependencies: [],\n      };\n    }\n  }\n\n  const missingDependencies = manifest.dependencies.filter(\n    (dependency) => !registry[dependency]\n  );\n  if (missingDependencies.length > 0) {\n    return {\n      packKey,\n      allowed: false,\n      reason: \"dependency_missing\",\n      missingDependencies,\n    };\n  }\n\n  const installed = toSet(policy.installedPackKeys);\n  if (installed.size > 0) {\n    const notInstalled = manifest.dependencies.filter(\n      (dependency) => !installed.has(dependency)\n    );\n    if (notInstalled.length > 0) {\n      return {\n        packKey,\n        allowed: false,\n        reason: \"dependency_not_installed\",\n        missingDependencies: notInstalled,\n      };\n    }\n  }\n\n  const enabled = toSet(policy.enabledPackKeys);\n  if (enabled.size > 0) {\n    const notEnabled = manifest.dependencies.filter(\n      (dependency) => !enabled.has(dependency)\n    );\n    if (notEnabled.length > 0) {\n      return {\n        packKey,\n        allowed: false,\n        reason: \"dependency_not_enabled\",\n        missingDependencies: notEnabled,\n      };\n    }\n  }\n\n  return {\n    packKey,\n    allowed: true,\n    reason: \"allowed\",\n    missingDependencies: [],\n  };\n}\n\nexport function evaluateCatalogEnablement(\n  registry: Record<string, AppPackManifest>,\n  policy: PackEnablementPolicy = {}\n): PackEnablementDecision[] {\n  return Object.keys(registry)\n    .sort()\n    .map((packKey) => evaluatePackEnablement(packKey, registry, policy));\n}\n"]}

package/dist/manifestValidation.d.ts

@@ -0,0 +1,28 @@
+import { AppPackManifest } from './contracts.js';
+
+/**
+ * Pack Manifest Validation
+ *
+ * Runtime schema and dictionary validation for app-pack manifests.
+ */
+
+type PackValidationSeverity = "error" | "warning";
+type PackValidationIssue = {
+    code: string;
+    severity: PackValidationSeverity;
+    message: string;
+    path: string;
+};
+type PackManifestValidationResult = {
+    manifestKey: string;
+    valid: boolean;
+    issues: PackValidationIssue[];
+};
+type PackSchemaDictionary = {
+    nodeTypes: readonly string[];
+    edgeTypes: readonly string[];
+    tables: readonly string[];
+};
+declare function validateAppPackManifest(manifest: AppPackManifest, dictionary?: PackSchemaDictionary): PackManifestValidationResult;
+
+export { type PackManifestValidationResult, type PackSchemaDictionary, type PackValidationIssue, type PackValidationSeverity, validateAppPackManifest };

package/dist/manifestValidation.js

@@ -0,0 +1,253 @@
+import { z } from 'zod';
+
+// src/manifestValidation.ts
+var manifestKeyPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*-v[0-9]+$/;
+var semverPattern = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+var appPackManifestSchema = z.object({
+  key: z.string().regex(manifestKeyPattern),
+  name: z.string().min(1),
+  version: z.string().regex(semverPattern),
+  lifecycle: z.enum(["active", "beta", "experimental"]),
+  category: z.enum([
+    "conversation",
+    "research",
+    "graph",
+    "analytics",
+    "workflow",
+    "decision",
+    "news",
+    "documents",
+    "identity",
+    "operations",
+    "domain"
+  ]),
+  description: z.string().min(1),
+  dependencies: z.array(z.string().min(1)),
+  capabilityFlags: z.array(z.string().min(1)),
+  routeNamespace: z.object({
+    web: z.array(z.string().min(1)),
+    api: z.array(z.string().min(1))
+  }),
+  surfaces: z.object({
+    components: z.array(z.string().min(1)),
+    convex: z.array(z.string().min(1)),
+    tools: z.array(z.string().min(1))
+  }),
+  policyProfile: z.object({
+    audiences: z.array(z.string().min(1)).min(1),
+    rules: z.array(
+      z.object({
+        resource: z.enum([
+          "project",
+          "node",
+          "edge",
+          "artifact",
+          "report_section",
+          "tool_action",
+          "task",
+          "user_profile",
+          "team_analytics"
+        ]),
+        actions: z.array(z.enum(["read", "summarize", "export", "mutate", "admin"])).min(1),
+        notes: z.string().optional()
+      })
+    ).min(1)
+  }),
+  dataContract: z.object({
+    requiredNodeTypes: z.array(z.string().min(1)),
+    requiredEdgeTypes: z.array(z.string().min(1)),
+    requiredTables: z.array(z.string().min(1)).min(1),
+    projectionBehavior: z.enum([
+      "none",
+      "inherits_policy",
+      "projection_required"
+    ])
+  }),
+  templates: z.object({
+    workflows: z.array(z.string().min(1)),
+    prompts: z.array(z.string().min(1)),
+    reports: z.array(z.string().min(1)),
+    uiLabels: z.array(z.string().min(1))
+  }),
+  testSuite: z.object({
+    parity: z.array(z.string().min(1)).min(1),
+    policy: z.array(z.string().min(1)).min(1),
+    contract: z.array(z.string().min(1)).min(1)
+  }),
+  sharedServices: z.array(
+    z.object({
+      service: z.enum([
+        "decision-kernel",
+        "knowledge-compiler",
+        "learning-loop"
+      ]),
+      mode: z.enum(["required", "optional"]),
+      contracts: z.array(z.string().min(1)).min(1)
+    })
+  )
+});
+function toIssue(code, message, path, severity = "error") {
+  return {
+    code,
+    severity,
+    message,
+    path
+  };
+}
+function collectDuplicateValues(values) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const value of values) {
+    counts.set(value, (counts.get(value) ?? 0) + 1);
+  }
+  return [...counts.entries()].filter(([, count]) => count > 1).map(([value]) => value).sort();
+}
+function collectUnknownValues(values, knownValues) {
+  const known = new Set(knownValues);
+  return values.filter((value) => !known.has(value));
+}
+function validateManifestShape(manifest) {
+  const parsed = appPackManifestSchema.safeParse(manifest);
+  if (parsed.success) {
+    return [];
+  }
+  return parsed.error.issues.map(
+    (issue) => toIssue(
+      "PACK_MANIFEST_SCHEMA_INVALID",
+      issue.message,
+      issue.path.join(".") || "(root)"
+    )
+  );
+}
+function validateManifestUniqueness(manifest) {
+  const issues = [];
+  const duplicateDependencies = collectDuplicateValues(manifest.dependencies);
+  if (duplicateDependencies.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_DEPENDENCIES_DUPLICATE",
+        `Duplicate dependencies declared: ${duplicateDependencies.join(", ")}`,
+        "dependencies"
+      )
+    );
+  }
+  if (manifest.dependencies.includes(manifest.key)) {
+    issues.push(
+      toIssue(
+        "PACK_DEPENDENCY_SELF_REFERENCE",
+        `Pack "${manifest.key}" cannot depend on itself.`,
+        "dependencies"
+      )
+    );
+  }
+  const duplicateCapabilities = collectDuplicateValues(
+    manifest.capabilityFlags
+  );
+  if (duplicateCapabilities.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_CAPABILITIES_DUPLICATE",
+        `Duplicate capability flags declared: ${duplicateCapabilities.join(", ")}`,
+        "capabilityFlags"
+      )
+    );
+  }
+  const duplicateWebRoutes = collectDuplicateValues(
+    manifest.routeNamespace.web
+  );
+  if (duplicateWebRoutes.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_WEB_ROUTES_DUPLICATE",
+        `Duplicate web routes declared: ${duplicateWebRoutes.join(", ")}`,
+        "routeNamespace.web"
+      )
+    );
+  }
+  const duplicateApiRoutes = collectDuplicateValues(
+    manifest.routeNamespace.api
+  );
+  if (duplicateApiRoutes.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_API_ROUTES_DUPLICATE",
+        `Duplicate api routes declared: ${duplicateApiRoutes.join(", ")}`,
+        "routeNamespace.api"
+      )
+    );
+  }
+  const duplicateServices = collectDuplicateValues(
+    manifest.sharedServices.map((integration) => integration.service)
+  );
+  if (duplicateServices.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_SHARED_SERVICE_DUPLICATE",
+        `Duplicate shared-service integrations declared: ${duplicateServices.join(", ")}`,
+        "sharedServices"
+      )
+    );
+  }
+  return issues;
+}
+function validateManifestDictionary(manifest, dictionary) {
+  if (!dictionary) {
+    return [];
+  }
+  const issues = [];
+  const unknownNodeTypes = collectUnknownValues(
+    manifest.dataContract.requiredNodeTypes,
+    dictionary.nodeTypes
+  );
+  const unknownEdgeTypes = collectUnknownValues(
+    manifest.dataContract.requiredEdgeTypes,
+    dictionary.edgeTypes
+  );
+  const unknownTables = collectUnknownValues(
+    manifest.dataContract.requiredTables,
+    dictionary.tables
+  );
+  if (unknownNodeTypes.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_UNKNOWN_NODE_TYPES",
+        `Unknown required node types: ${unknownNodeTypes.join(", ")}`,
+        "dataContract.requiredNodeTypes"
+      )
+    );
+  }
+  if (unknownEdgeTypes.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_UNKNOWN_EDGE_TYPES",
+        `Unknown required edge types: ${unknownEdgeTypes.join(", ")}`,
+        "dataContract.requiredEdgeTypes"
+      )
+    );
+  }
+  if (unknownTables.length > 0) {
+    issues.push(
+      toIssue(
+        "PACK_UNKNOWN_TABLES",
+        `Unknown required tables: ${unknownTables.join(", ")}`,
+        "dataContract.requiredTables"
+      )
+    );
+  }
+  return issues;
+}
+function validateAppPackManifest(manifest, dictionary) {
+  const issues = [
+    ...validateManifestShape(manifest),
+    ...validateManifestUniqueness(manifest),
+    ...validateManifestDictionary(manifest, dictionary)
+  ];
+  return {
+    manifestKey: manifest.key,
+    valid: issues.every((issue) => issue.severity !== "error"),
+    issues
+  };
+}
+
+export { validateAppPackManifest };
+//# sourceMappingURL=manifestValidation.js.map
+//# sourceMappingURL=manifestValidation.js.map

package/dist/manifestValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/manifestValidation.ts"],"names":[],"mappings":"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","file":"manifestValidation.js","sourcesContent":["/**\n * Pack Manifest Validation\n *\n * Runtime schema and dictionary validation for app-pack manifests.\n */\n\nimport { z } from \"zod\";\nimport type { AppPackManifest } from \"./contracts\";\n\nconst manifestKeyPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*-v[0-9]+$/;\nconst semverPattern = /^\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?$/;\n\nexport type PackValidationSeverity = \"error\" | \"warning\";\n\nexport type PackValidationIssue = {\n  code: string;\n  severity: PackValidationSeverity;\n  message: string;\n  path: string;\n};\n\nexport type PackManifestValidationResult = {\n  manifestKey: string;\n  valid: boolean;\n  issues: PackValidationIssue[];\n};\n\nexport type PackSchemaDictionary = {\n  nodeTypes: readonly string[];\n  edgeTypes: readonly string[];\n  tables: readonly string[];\n};\n\nconst appPackManifestSchema = z.object({\n  key: z.string().regex(manifestKeyPattern),\n  name: z.string().min(1),\n  version: z.string().regex(semverPattern),\n  lifecycle: z.enum([\"active\", \"beta\", \"experimental\"]),\n  category: z.enum([\n    \"conversation\",\n    \"research\",\n    \"graph\",\n    \"analytics\",\n    \"workflow\",\n    \"decision\",\n    \"news\",\n    \"documents\",\n    \"identity\",\n    \"operations\",\n    \"domain\",\n  ]),\n  description: z.string().min(1),\n  dependencies: z.array(z.string().min(1)),\n  capabilityFlags: z.array(z.string().min(1)),\n  routeNamespace: z.object({\n    web: z.array(z.string().min(1)),\n    api: z.array(z.string().min(1)),\n  }),\n  surfaces: z.object({\n    components: z.array(z.string().min(1)),\n    convex: z.array(z.string().min(1)),\n    tools: z.array(z.string().min(1)),\n  }),\n  policyProfile: z.object({\n    audiences: z.array(z.string().min(1)).min(1),\n    rules: z\n      .array(\n        z.object({\n          resource: z.enum([\n            \"project\",\n            \"node\",\n            \"edge\",\n            \"artifact\",\n            \"report_section\",\n            \"tool_action\",\n            \"task\",\n            \"user_profile\",\n            \"team_analytics\",\n          ]),\n          actions: z\n            .array(z.enum([\"read\", \"summarize\", \"export\", \"mutate\", \"admin\"]))\n            .min(1),\n          notes: z.string().optional(),\n        })\n      )\n      .min(1),\n  }),\n  dataContract: z.object({\n    requiredNodeTypes: z.array(z.string().min(1)),\n    requiredEdgeTypes: z.array(z.string().min(1)),\n    requiredTables: z.array(z.string().min(1)).min(1),\n    projectionBehavior: z.enum([\n      \"none\",\n      \"inherits_policy\",\n      \"projection_required\",\n    ]),\n  }),\n  templates: z.object({\n    workflows: z.array(z.string().min(1)),\n    prompts: z.array(z.string().min(1)),\n    reports: z.array(z.string().min(1)),\n    uiLabels: z.array(z.string().min(1)),\n  }),\n  testSuite: z.object({\n    parity: z.array(z.string().min(1)).min(1),\n    policy: z.array(z.string().min(1)).min(1),\n    contract: z.array(z.string().min(1)).min(1),\n  }),\n  sharedServices: z.array(\n    z.object({\n      service: z.enum([\n        \"decision-kernel\",\n        \"knowledge-compiler\",\n        \"learning-loop\",\n      ]),\n      mode: z.enum([\"required\", \"optional\"]),\n      contracts: z.array(z.string().min(1)).min(1),\n    })\n  ),\n});\n\nfunction toIssue(\n  code: string,\n  message: string,\n  path: string,\n  severity: PackValidationSeverity = \"error\"\n): PackValidationIssue {\n  return {\n    code,\n    severity,\n    message,\n    path,\n  };\n}\n\nfunction collectDuplicateValues(values: readonly string[]): string[] {\n  const counts = new Map<string, number>();\n  for (const value of values) {\n    counts.set(value, (counts.get(value) ?? 0) + 1);\n  }\n  return [...counts.entries()]\n    .filter(([, count]) => count > 1)\n    .map(([value]) => value)\n    .sort();\n}\n\nfunction collectUnknownValues(\n  values: readonly string[],\n  knownValues: readonly string[]\n): string[] {\n  const known = new Set(knownValues);\n  return values.filter((value) => !known.has(value));\n}\n\nfunction validateManifestShape(\n  manifest: AppPackManifest\n): PackValidationIssue[] {\n  const parsed = appPackManifestSchema.safeParse(manifest);\n  if (parsed.success) {\n    return [];\n  }\n\n  return parsed.error.issues.map((issue) =>\n    toIssue(\n      \"PACK_MANIFEST_SCHEMA_INVALID\",\n      issue.message,\n      issue.path.join(\".\") || \"(root)\"\n    )\n  );\n}\n\nfunction validateManifestUniqueness(\n  manifest: AppPackManifest\n): PackValidationIssue[] {\n  const issues: PackValidationIssue[] = [];\n\n  const duplicateDependencies = collectDuplicateValues(manifest.dependencies);\n  if (duplicateDependencies.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_DEPENDENCIES_DUPLICATE\",\n        `Duplicate dependencies declared: ${duplicateDependencies.join(\", \")}`,\n        \"dependencies\"\n      )\n    );\n  }\n\n  if (manifest.dependencies.includes(manifest.key)) {\n    issues.push(\n      toIssue(\n        \"PACK_DEPENDENCY_SELF_REFERENCE\",\n        `Pack \"${manifest.key}\" cannot depend on itself.`,\n        \"dependencies\"\n      )\n    );\n  }\n\n  const duplicateCapabilities = collectDuplicateValues(\n    manifest.capabilityFlags\n  );\n  if (duplicateCapabilities.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_CAPABILITIES_DUPLICATE\",\n        `Duplicate capability flags declared: ${duplicateCapabilities.join(\", \")}`,\n        \"capabilityFlags\"\n      )\n    );\n  }\n\n  const duplicateWebRoutes = collectDuplicateValues(\n    manifest.routeNamespace.web\n  );\n  if (duplicateWebRoutes.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_WEB_ROUTES_DUPLICATE\",\n        `Duplicate web routes declared: ${duplicateWebRoutes.join(\", \")}`,\n        \"routeNamespace.web\"\n      )\n    );\n  }\n\n  const duplicateApiRoutes = collectDuplicateValues(\n    manifest.routeNamespace.api\n  );\n  if (duplicateApiRoutes.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_API_ROUTES_DUPLICATE\",\n        `Duplicate api routes declared: ${duplicateApiRoutes.join(\", \")}`,\n        \"routeNamespace.api\"\n      )\n    );\n  }\n\n  const duplicateServices = collectDuplicateValues(\n    manifest.sharedServices.map((integration) => integration.service)\n  );\n  if (duplicateServices.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_SHARED_SERVICE_DUPLICATE\",\n        `Duplicate shared-service integrations declared: ${duplicateServices.join(\", \")}`,\n        \"sharedServices\"\n      )\n    );\n  }\n\n  return issues;\n}\n\nfunction validateManifestDictionary(\n  manifest: AppPackManifest,\n  dictionary?: PackSchemaDictionary\n): PackValidationIssue[] {\n  if (!dictionary) {\n    return [];\n  }\n\n  const issues: PackValidationIssue[] = [];\n  const unknownNodeTypes = collectUnknownValues(\n    manifest.dataContract.requiredNodeTypes,\n    dictionary.nodeTypes\n  );\n  const unknownEdgeTypes = collectUnknownValues(\n    manifest.dataContract.requiredEdgeTypes,\n    dictionary.edgeTypes\n  );\n  const unknownTables = collectUnknownValues(\n    manifest.dataContract.requiredTables,\n    dictionary.tables\n  );\n\n  if (unknownNodeTypes.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_UNKNOWN_NODE_TYPES\",\n        `Unknown required node types: ${unknownNodeTypes.join(\", \")}`,\n        \"dataContract.requiredNodeTypes\"\n      )\n    );\n  }\n\n  if (unknownEdgeTypes.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_UNKNOWN_EDGE_TYPES\",\n        `Unknown required edge types: ${unknownEdgeTypes.join(\", \")}`,\n        \"dataContract.requiredEdgeTypes\"\n      )\n    );\n  }\n\n  if (unknownTables.length > 0) {\n    issues.push(\n      toIssue(\n        \"PACK_UNKNOWN_TABLES\",\n        `Unknown required tables: ${unknownTables.join(\", \")}`,\n        \"dataContract.requiredTables\"\n      )\n    );\n  }\n\n  return issues;\n}\n\nexport function validateAppPackManifest(\n  manifest: AppPackManifest,\n  dictionary?: PackSchemaDictionary\n): PackManifestValidationResult {\n  const issues: PackValidationIssue[] = [\n    ...validateManifestShape(manifest),\n    ...validateManifestUniqueness(manifest),\n    ...validateManifestDictionary(manifest, dictionary),\n  ];\n\n  return {\n    manifestKey: manifest.key,\n    valid: issues.every((issue) => issue.severity !== \"error\"),\n    issues,\n  };\n}\n"]}

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

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

package/dist/manifests/chat-v1.js

@@ -0,0 +1,87 @@
+// 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/chat-v1.ts
+var chatV1Manifest = defineAppPackManifest({
+  key: "chat-v1",
+  name: "Chat",
+  version: "1.0.0",
+  lifecycle: "active",
+  category: "conversation",
+  description: "Core conversational runtime, streaming orchestration, and tool invocation shell.",
+  dependencies: [],
+  capabilityFlags: [
+    "chat.streaming",
+    "chat.history",
+    "tool.invocation",
+    "slash.commands",
+    "voice.mode"
+  ],
+  routeNamespace: {
+    web: ["/(chat)/chat", "/(chat)/chat/[id]"],
+    api: [
+      "/(chat)/api/chat",
+      "/(chat)/api/coach",
+      "/(chat)/api/history",
+      "/(chat)/api/suggestions",
+      "/(chat)/api/vote"
+    ]
+  },
+  surfaces: {
+    components: [
+      "components/chat/*",
+      "components/chat/sidebars/*",
+      "components/chat/viewers/*"
+    ],
+    convex: ["convex/chats.ts", "convex/messages.ts", "convex/chatState.ts"],
+    tools: ["lib/ai/tools/project-tools.ts"]
+  },
+  policyProfile: {
+    audiences: ["internal", "lp", "public"],
+    rules: [
+      { resource: "project", actions: ["read", "summarize"] },
+      {
+        resource: "tool_action",
+        actions: ["read", "mutate"],
+        notes: "Mutation tools must pass server-side policy checks."
+      },
+      { resource: "artifact", actions: ["read", "summarize"] }
+    ]
+  },
+  dataContract: {
+    requiredNodeTypes: ["belief", "question", "evidence", "theme", "deal"],
+    requiredEdgeTypes: ["informs", "answers", "belongs_to"],
+    requiredTables: ["chats", "messages", "chatState", "projects"],
+    projectionBehavior: "inherits_policy"
+  },
+  templates: {
+    workflows: ["chat/default", "chat/voice-mode"],
+    prompts: ["chat/main-system-prompt", "chat/voice-mode-style"],
+    reports: [],
+    uiLabels: ["chat", "assistant", "conversation"]
+  },
+  testSuite: {
+    parity: ["chat-streaming-parity", "slash-command-parity"],
+    policy: ["chat-context-filtering", "tool-deny-enforcement"],
+    contract: ["chat-pack-contract-v1"]
+  }
+});
+
+export { chatV1Manifest };
+//# sourceMappingURL=chat-v1.js.map
+//# sourceMappingURL=chat-v1.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts.ts","../../src/manifests/chat-v1.ts"],"names":[],"mappings":"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","file":"chat-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: chat-v1\n *\n * Declarative runtime contract for the chat-v1 application pack.\n */\n\nimport { defineAppPackManifest } from \"../contracts\";\n\nexport const chatV1Manifest = defineAppPackManifest({\n  key: \"chat-v1\",\n  name: \"Chat\",\n  version: \"1.0.0\",\n  lifecycle: \"active\",\n  category: \"conversation\",\n  description:\n    \"Core conversational runtime, streaming orchestration, and tool invocation shell.\",\n  dependencies: [],\n  capabilityFlags: [\n    \"chat.streaming\",\n    \"chat.history\",\n    \"tool.invocation\",\n    \"slash.commands\",\n    \"voice.mode\",\n  ],\n  routeNamespace: {\n    web: [\"/(chat)/chat\", \"/(chat)/chat/[id]\"],\n    api: [\n      \"/(chat)/api/chat\",\n      \"/(chat)/api/coach\",\n      \"/(chat)/api/history\",\n      \"/(chat)/api/suggestions\",\n      \"/(chat)/api/vote\",\n    ],\n  },\n  surfaces: {\n    components: [\n      \"components/chat/*\",\n      \"components/chat/sidebars/*\",\n      \"components/chat/viewers/*\",\n    ],\n    convex: [\"convex/chats.ts\", \"convex/messages.ts\", \"convex/chatState.ts\"],\n    tools: [\"lib/ai/tools/project-tools.ts\"],\n  },\n  policyProfile: {\n    audiences: [\"internal\", \"lp\", \"public\"],\n    rules: [\n      { resource: \"project\", actions: [\"read\", \"summarize\"] },\n      {\n        resource: \"tool_action\",\n        actions: [\"read\", \"mutate\"],\n        notes: \"Mutation tools must pass server-side policy checks.\",\n      },\n      { resource: \"artifact\", actions: [\"read\", \"summarize\"] },\n    ],\n  },\n  dataContract: {\n    requiredNodeTypes: [\"belief\", \"question\", \"evidence\", \"theme\", \"deal\"],\n    requiredEdgeTypes: [\"informs\", \"answers\", \"belongs_to\"],\n    requiredTables: [\"chats\", \"messages\", \"chatState\", \"projects\"],\n    projectionBehavior: \"inherits_policy\",\n  },\n  templates: {\n    workflows: [\"chat/default\", \"chat/voice-mode\"],\n    prompts: [\"chat/main-system-prompt\", \"chat/voice-mode-style\"],\n    reports: [],\n    uiLabels: [\"chat\", \"assistant\", \"conversation\"],\n  },\n  testSuite: {\n    parity: [\"chat-streaming-parity\", \"slash-command-parity\"],\n    policy: [\"chat-context-filtering\", \"tool-deny-enforcement\"],\n    contract: [\"chat-pack-contract-v1\"],\n  },\n});\n"]}

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

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