@objectstack/spec 3.0.8 → 3.0.9

package/dist/kernel/index.js

@@ -39,6 +39,222 @@ var OclifPluginConfigSchema = zod.z.object({
   /** Topic separator character (default: space) */
   topicSeparator: zod.z.string().optional().describe("Character separating topic and command names")
 }).describe("oclif plugin configuration section");
+var MetadataCategoryEnum = zod.z.enum([
+  "objects",
+  "views",
+  "pages",
+  "flows",
+  "dashboards",
+  "permissions",
+  "agents",
+  "reports",
+  "actions",
+  "translations",
+  "themes",
+  "datasets",
+  "apis",
+  "triggers",
+  "workflows"
+]).describe("Metadata category within the artifact");
+var ArtifactFileEntrySchema = zod.z.object({
+  /** Relative path within the artifact (e.g. "metadata/objects/account.object.json") */
+  path: zod.z.string().describe("Relative file path within the artifact"),
+  /** File size in bytes */
+  size: zod.z.number().int().nonnegative().describe("File size in bytes"),
+  /** Metadata category (if under metadata/) */
+  category: MetadataCategoryEnum.optional().describe("Metadata category this file belongs to")
+}).describe("A single file entry within the artifact");
+var ArtifactChecksumSchema = zod.z.object({
+  /** Hash algorithm used (default: SHA256) */
+  algorithm: zod.z.enum(["sha256", "sha384", "sha512"]).default("sha256").describe("Hash algorithm used for checksums"),
+  /** Map of relative file paths to their hash values */
+  files: zod.z.record(zod.z.string(), zod.z.string().regex(/^[a-f0-9]+$/)).describe("File path to hash value mapping")
+}).describe("Checksum manifest for artifact integrity verification");
+var ArtifactSignatureSchema = zod.z.object({
+  /** Signature algorithm */
+  algorithm: zod.z.enum(["RSA-SHA256", "RSA-SHA384", "RSA-SHA512", "ECDSA-SHA256"]).default("RSA-SHA256").describe("Signing algorithm used"),
+  /** Public key reference (URL or fingerprint) for verification */
+  publicKeyRef: zod.z.string().describe("Public key reference (URL or fingerprint) for signature verification"),
+  /** Base64-encoded signature value */
+  signature: zod.z.string().describe("Base64-encoded digital signature"),
+  /** Timestamp of when the artifact was signed */
+  signedAt: zod.z.string().datetime().optional().describe("ISO 8601 timestamp of when the artifact was signed"),
+  /** Signer identity (publisher ID or email) */
+  signedBy: zod.z.string().optional().describe("Identity of the signer (publisher ID or email)")
+}).describe("Digital signature for artifact authenticity verification");
+var PackageArtifactSchema = zod.z.object({
+  /** Artifact format version (for forward compatibility) */
+  formatVersion: zod.z.string().regex(/^\d+\.\d+$/).default("1.0").describe('Artifact format version (e.g. "1.0")'),
+  /** Package ID from the manifest */
+  packageId: zod.z.string().describe("Package identifier from manifest"),
+  /** Package version from the manifest */
+  version: zod.z.string().describe("Package version from manifest"),
+  /** Artifact format */
+  format: zod.z.enum(["tgz", "zip"]).default("tgz").describe("Archive format of the artifact"),
+  /** Total artifact size in bytes */
+  size: zod.z.number().int().positive().optional().describe("Total artifact file size in bytes"),
+  /** Build timestamp */
+  builtAt: zod.z.string().datetime().describe("ISO 8601 timestamp of when the artifact was built"),
+  /** Build tool and version that produced this artifact */
+  builtWith: zod.z.string().optional().describe('Build tool identifier (e.g. "os-cli@3.2.0")'),
+  /** File listing within the artifact */
+  files: zod.z.array(ArtifactFileEntrySchema).optional().describe("List of files contained in the artifact"),
+  /** Metadata categories present in the artifact */
+  metadataCategories: zod.z.array(MetadataCategoryEnum).optional().describe("Metadata categories included in this artifact"),
+  /** Integrity checksums for all files */
+  checksums: ArtifactChecksumSchema.optional().describe("SHA256 checksums for artifact integrity verification"),
+  /** Digital signature for authenticity */
+  signature: ArtifactSignatureSchema.optional().describe("Digital signature for artifact authenticity verification")
+}).describe("Package artifact structure and metadata");
+
+// src/kernel/cli-plugin-commands.zod.ts
+var PluginBuildOptionsSchema = zod.z.object({
+  /** Project root directory (defaults to cwd) */
+  directory: zod.z.string().optional().describe("Project root directory (defaults to current working directory)"),
+  /** Output directory for the built artifact */
+  outDir: zod.z.string().optional().describe("Output directory for the built artifact (defaults to ./dist)"),
+  /** Archive format */
+  format: zod.z.enum(["tgz", "zip"]).default("tgz").describe("Archive format for the artifact"),
+  /** Whether to sign the artifact */
+  sign: zod.z.boolean().default(false).describe("Whether to digitally sign the artifact"),
+  /** Path to the private key for signing */
+  privateKeyPath: zod.z.string().optional().describe("Path to RSA/ECDSA private key file for signing"),
+  /** Signing algorithm */
+  signAlgorithm: zod.z.enum(["RSA-SHA256", "RSA-SHA384", "RSA-SHA512", "ECDSA-SHA256"]).optional().describe("Signing algorithm to use"),
+  /** Checksum algorithm */
+  checksumAlgorithm: zod.z.enum(["sha256", "sha384", "sha512"]).default("sha256").describe("Hash algorithm for file checksums"),
+  /** Whether to include seed data */
+  includeData: zod.z.boolean().default(true).describe("Whether to include seed data in the artifact"),
+  /** Whether to include locale/translation files */
+  includeLocales: zod.z.boolean().default(true).describe("Whether to include locale/translation files")
+}).describe("Options for the os plugin build command");
+var PluginBuildResultSchema = zod.z.object({
+  /** Whether the build succeeded */
+  success: zod.z.boolean().describe("Whether the build succeeded"),
+  /** Path to the generated artifact file */
+  artifactPath: zod.z.string().optional().describe("Absolute path to the generated artifact file"),
+  /** Artifact metadata (validated against PackageArtifactSchema) */
+  artifact: PackageArtifactSchema.optional().describe("Artifact metadata"),
+  /** Total file count in the artifact */
+  fileCount: zod.z.number().int().min(0).optional().describe("Total number of files in the artifact"),
+  /** Total artifact size in bytes */
+  size: zod.z.number().int().min(0).optional().describe("Total artifact size in bytes"),
+  /** Build duration in milliseconds */
+  durationMs: zod.z.number().optional().describe("Build duration in milliseconds"),
+  /** Error message if build failed */
+  errorMessage: zod.z.string().optional().describe("Error message if build failed"),
+  /** Warnings emitted during build */
+  warnings: zod.z.array(zod.z.string()).optional().describe("Warnings emitted during build")
+}).describe("Result of the os plugin build command");
+var ValidationSeverityEnum = zod.z.enum([
+  "error",
+  // Must fix — artifact is invalid
+  "warning",
+  // Should fix — may cause issues
+  "info"
+  // Informational — suggestion
+]).describe("Validation issue severity");
+var ValidationFindingSchema = zod.z.object({
+  /** Finding severity */
+  severity: ValidationSeverityEnum.describe("Issue severity level"),
+  /** Rule or check that produced this finding */
+  rule: zod.z.string().describe("Validation rule identifier"),
+  /** Human-readable message */
+  message: zod.z.string().describe("Human-readable finding description"),
+  /** File path within the artifact (if applicable) */
+  path: zod.z.string().optional().describe("Relative file path within the artifact")
+}).describe("A single validation finding");
+var PluginValidateOptionsSchema = zod.z.object({
+  /** Path to the .tgz artifact file to validate */
+  artifactPath: zod.z.string().describe("Path to the artifact file to validate"),
+  /** Whether to verify the digital signature */
+  verifySignature: zod.z.boolean().default(true).describe("Whether to verify the digital signature"),
+  /** Path to the public key for signature verification */
+  publicKeyPath: zod.z.string().optional().describe("Path to the public key for signature verification"),
+  /** Whether to verify SHA256 checksums of all files */
+  verifyChecksums: zod.z.boolean().default(true).describe("Whether to verify checksums of all files"),
+  /** Whether to validate metadata schema compliance */
+  validateMetadata: zod.z.boolean().default(true).describe("Whether to validate metadata against schemas"),
+  /** Target platform version for compatibility check */
+  platformVersion: zod.z.string().optional().describe("Platform version for compatibility verification")
+}).describe("Options for the os plugin validate command");
+var PluginValidateResultSchema = zod.z.object({
+  /** Whether the artifact is valid (no error-level findings) */
+  valid: zod.z.boolean().describe("Whether the artifact passed validation"),
+  /** Artifact metadata extracted from the archive */
+  artifact: PackageArtifactSchema.optional().describe("Extracted artifact metadata"),
+  /** Checksum verification result */
+  checksumVerification: zod.z.object({
+    /** Whether all checksums match */
+    passed: zod.z.boolean().describe("Whether all checksums match"),
+    /** Checksum details */
+    checksums: ArtifactChecksumSchema.optional().describe("Verified checksums"),
+    /** Files with mismatched checksums */
+    mismatches: zod.z.array(zod.z.string()).optional().describe("Files with checksum mismatches")
+  }).optional().describe("Checksum verification result"),
+  /** Signature verification result */
+  signatureVerification: zod.z.object({
+    /** Whether the signature is valid */
+    passed: zod.z.boolean().describe("Whether the signature is valid"),
+    /** Signature details */
+    signature: ArtifactSignatureSchema.optional().describe("Signature details"),
+    /** Reason for failure */
+    failureReason: zod.z.string().optional().describe("Signature verification failure reason")
+  }).optional().describe("Signature verification result"),
+  /** Platform compatibility result */
+  platformCompatibility: zod.z.object({
+    /** Whether the artifact is compatible with the target platform */
+    compatible: zod.z.boolean().describe("Whether artifact is compatible"),
+    /** Required platform version range */
+    requiredRange: zod.z.string().optional().describe("Required platform version range"),
+    /** Target platform version checked against */
+    targetVersion: zod.z.string().optional().describe("Target platform version")
+  }).optional().describe("Platform compatibility check result"),
+  /** All validation findings */
+  findings: zod.z.array(ValidationFindingSchema).describe("All validation findings"),
+  /** Counts by severity */
+  summary: zod.z.object({
+    errors: zod.z.number().int().min(0).describe("Error count"),
+    warnings: zod.z.number().int().min(0).describe("Warning count"),
+    infos: zod.z.number().int().min(0).describe("Info count")
+  }).optional().describe("Finding counts by severity")
+}).describe("Result of the os plugin validate command");
+var PluginPublishOptionsSchema = zod.z.object({
+  /** Path to the .tgz artifact file to publish */
+  artifactPath: zod.z.string().describe("Path to the artifact file to publish"),
+  /** Marketplace API base URL */
+  registryUrl: zod.z.string().url().optional().describe("Marketplace API base URL"),
+  /** Authentication token for the marketplace API */
+  token: zod.z.string().optional().describe("Authentication token for marketplace API"),
+  /** Release notes for this version */
+  releaseNotes: zod.z.string().optional().describe("Release notes for this version"),
+  /** Whether this is a pre-release */
+  preRelease: zod.z.boolean().default(false).describe("Whether this is a pre-release version"),
+  /** Whether to skip validation before publishing */
+  skipValidation: zod.z.boolean().default(false).describe("Whether to skip local validation before publish"),
+  /** Access level for the published package */
+  access: zod.z.enum(["public", "restricted"]).default("public").describe("Package access level on the marketplace"),
+  /** Tags for categorization */
+  tags: zod.z.array(zod.z.string()).optional().describe("Tags for marketplace categorization")
+}).describe("Options for the os plugin publish command");
+var PluginPublishResultSchema = zod.z.object({
+  /** Whether the publish succeeded */
+  success: zod.z.boolean().describe("Whether the publish succeeded"),
+  /** Package ID that was published */
+  packageId: zod.z.string().optional().describe("Published package identifier"),
+  /** Version that was published */
+  version: zod.z.string().optional().describe("Published version string"),
+  /** Artifact reference in the marketplace */
+  artifactUrl: zod.z.string().url().optional().describe("URL of the published artifact in the marketplace"),
+  /** SHA256 checksum of the uploaded artifact */
+  sha256: zod.z.string().optional().describe("SHA256 checksum of the uploaded artifact"),
+  /** Submission ID for tracking the review process */
+  submissionId: zod.z.string().optional().describe("Marketplace submission ID for review tracking"),
+  /** Error message if publish failed */
+  errorMessage: zod.z.string().optional().describe("Error message if publish failed"),
+  /** Human-readable status message */
+  message: zod.z.string().optional().describe("Human-readable status message")
+}).describe("Result of the os plugin publish command");
 var RuntimeMode = zod.z.enum([
   "development",
   // Hot-reload, verbose logging
@@ -113,6 +329,50 @@ var KernelContextSchema = zod.z.object({
    */
   previewMode: PreviewModeConfigSchema.optional().describe('Preview/demo mode configuration (used when mode is "preview")')
 });
+var DependencyStatusEnum = zod.z.enum([
+  "satisfied",
+  // Already installed and version compatible
+  "needs_install",
+  // Not installed, needs to be installed
+  "needs_upgrade",
+  // Installed but version incompatible, needs upgrade
+  "conflict"
+  // Conflicts with another package's dependency
+]).describe("Resolution status for a dependency");
+var ResolvedDependencySchema = zod.z.object({
+  /** Package identifier of the dependency */
+  packageId: zod.z.string().describe("Dependency package identifier"),
+  /** SemVer range required by the parent package */
+  requiredRange: zod.z.string().describe('SemVer range required (e.g. "^2.0.0")'),
+  /** Actual version resolved (if available) */
+  resolvedVersion: zod.z.string().optional().describe("Actual version resolved from registry"),
+  /** Currently installed version (if any) */
+  installedVersion: zod.z.string().optional().describe("Currently installed version"),
+  /** Resolution status */
+  status: DependencyStatusEnum.describe("Resolution status"),
+  /** Conflict details (when status is "conflict") */
+  conflictReason: zod.z.string().optional().describe("Explanation of the conflict")
+}).describe("Resolution result for a single dependency");
+var RequiredActionSchema = zod.z.object({
+  /** Type of action required */
+  type: zod.z.enum(["install", "upgrade", "confirm_conflict"]).describe("Type of action required"),
+  /** Target package identifier */
+  packageId: zod.z.string().describe("Target package identifier"),
+  /** Human-readable description of the action */
+  description: zod.z.string().describe("Human-readable action description")
+}).describe("Action required before installation can proceed");
+var DependencyResolutionResultSchema = zod.z.object({
+  /** All dependencies and their resolution results */
+  dependencies: zod.z.array(ResolvedDependencySchema).describe("Resolution result for each dependency"),
+  /** Whether installation can proceed without conflicts */
+  canProceed: zod.z.boolean().describe("Whether installation can proceed"),
+  /** Actions that require user confirmation or system execution */
+  requiredActions: zod.z.array(RequiredActionSchema).describe("Actions required before proceeding"),
+  /** Topologically sorted package IDs for installation order */
+  installOrder: zod.z.array(zod.z.string()).describe("Topologically sorted package IDs for installation"),
+  /** Detected circular dependency chains */
+  circularDependencies: zod.z.array(zod.z.array(zod.z.string())).optional().describe('Circular dependency chains detected (e.g. [["A", "B", "A"]])')
+}).describe("Complete dependency resolution result");
 var DevServiceOverrideSchema = zod.z.object({
   /** Service identifier (e.g. 'auth', 'eventBus', 'fileStorage') */
   service: zod.z.string().min(1).describe("Target service identifier"),
@@ -1613,12 +1873,22 @@ var PluginContextSchema = zod.z.object({
     register: zod.z.function().describe("Register a driver")
   }).passthrough().describe("Driver Registry")
 });
+var UpgradeContextSchema = zod.z.object({
+  /** Version before upgrade */
+  previousVersion: zod.z.string().describe("Version before upgrade"),
+  /** Version after upgrade */
+  newVersion: zod.z.string().describe("Version after upgrade"),
+  /** Whether this is a major version bump */
+  isMajorUpgrade: zod.z.boolean().describe("Whether this is a major version bump"),
+  /** Metadata snapshot before upgrade (for migration logic) */
+  previousMetadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Metadata snapshot before upgrade")
+}).describe("Version migration context for onUpgrade hook");
 var PluginLifecycleSchema = zod.z.object({
   onInstall: zod.z.function().optional().describe("Called when plugin is installed"),
   onEnable: zod.z.function().optional().describe("Called when plugin is enabled"),
   onDisable: zod.z.function().optional().describe("Called when plugin is disabled"),
   onUninstall: zod.z.function().optional().describe("Called when plugin is uninstalled"),
-  onUpgrade: zod.z.function().optional().describe("Called when plugin is upgraded")
+  onUpgrade: zod.z.function().optional().describe("Called when plugin is upgraded. Receives UpgradeContext with previousVersion, newVersion, and isMajorUpgrade")
 });
 var CORE_PLUGIN_TYPES = [
   "ui",
@@ -1976,7 +2246,22 @@ var ManifestSchema = zod.z.object({
    * Configures how the plugin is loaded, initialized, and managed at runtime.
    * Includes strategies for lazy loading, code splitting, caching, and hot reload.
    */
-  loading: PluginLoadingConfigSchema.optional().describe("Plugin loading and runtime behavior configuration")
+  loading: PluginLoadingConfigSchema.optional().describe("Plugin loading and runtime behavior configuration"),
+  /**
+   * Platform Compatibility Requirements.
+   * Specifies the minimum ObjectStack platform version required to run this package.
+   * Used at install time to prevent incompatible packages from being installed.
+   *
+   * @example
+   * ```yaml
+   * engine:
+   *   objectstack: ">=3.0.0"
+   * ```
+   */
+  engine: zod.z.object({
+    /** ObjectStack platform version requirement (SemVer range) */
+    objectstack: zod.z.string().regex(/^[><=~^]*\d+\.\d+\.\d+/).describe('ObjectStack platform version requirement (SemVer range, e.g. ">=3.0.0")')
+  }).optional().describe("Platform compatibility requirements")
 });
 var CustomizationOriginSchema = zod.z.enum([
   "package",
@@ -2829,29 +3114,29 @@ var PackageStatusEnum = zod.z.enum([
   // Removal in progress
   "error"
   // Installation or runtime error
-]);
+]).describe("Package installation status");
 var InstalledPackageSchema = zod.z.object({
   /** 
    * The full package manifest (source of truth for package definition).
    */
-  manifest: ManifestSchema,
+  manifest: ManifestSchema.describe("Full package manifest"),
   /**
    * Current lifecycle status.
    */
-  status: PackageStatusEnum.default("installed"),
+  status: PackageStatusEnum.default("installed").describe("Package state: installed, disabled, installing, upgrading, uninstalling, or error"),
   /**
    * Whether the package is currently enabled (active).
    * When disabled, the package's metadata is not loaded into the registry.
    */
-  enabled: zod.z.boolean().default(true),
+  enabled: zod.z.boolean().default(true).describe("Whether the package is currently enabled"),
   /**
    * ISO 8601 timestamp of when the package was installed.
    */
-  installedAt: zod.z.string().datetime().optional(),
+  installedAt: zod.z.string().datetime().optional().describe("Installation timestamp"),
   /**
    * ISO 8601 timestamp of last update.
    */
-  updatedAt: zod.z.string().datetime().optional(),
+  updatedAt: zod.z.string().datetime().optional().describe("Last update timestamp"),
   /**
    * The currently installed version string.
    * Mirrors manifest.version for quick access without parsing the full manifest.
@@ -2865,73 +3150,124 @@ var InstalledPackageSchema = zod.z.object({
   /**
    * ISO 8601 timestamp of when the package was last enabled/disabled.
    */
-  statusChangedAt: zod.z.string().datetime().optional(),
+  statusChangedAt: zod.z.string().datetime().optional().describe("Status change timestamp"),
   /**
    * Error message if status is 'error'.
    */
-  errorMessage: zod.z.string().optional(),
+  errorMessage: zod.z.string().optional().describe("Error message when status is error"),
   /**
    * Configuration values set by the user for this package.
    * Keys correspond to the package's `configuration.properties`.
    */
-  settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
-});
+  settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("User-provided configuration settings"),
+  /**
+   * Upgrade history for this package.
+   * Records each version migration with status and optional log.
+   */
+  upgradeHistory: zod.z.array(zod.z.object({
+    /** Previous version before upgrade */
+    fromVersion: zod.z.string().describe("Version before upgrade"),
+    /** New version after upgrade */
+    toVersion: zod.z.string().describe("Version after upgrade"),
+    /** Timestamp of the upgrade */
+    upgradedAt: zod.z.string().datetime().describe("Upgrade timestamp"),
+    /** Outcome of the upgrade */
+    status: zod.z.enum(["success", "failed", "rolled_back"]).describe("Upgrade outcome"),
+    /** Migration log entries */
+    migrationLog: zod.z.array(zod.z.string()).optional().describe("Migration step logs")
+  })).optional().describe("Version upgrade history"),
+  /**
+   * Namespaces registered by this package.
+   * Tracks which namespace prefixes are occupied by this package.
+   */
+  registeredNamespaces: zod.z.array(zod.z.string()).optional().describe("Namespace prefixes registered by this package")
+}).describe("Installed package with runtime lifecycle state");
+var NamespaceRegistryEntrySchema = zod.z.object({
+  /** Namespace prefix */
+  namespace: zod.z.string().describe("Namespace prefix"),
+  /** Package that owns this namespace */
+  packageId: zod.z.string().describe("Owning package ID"),
+  /** Registration timestamp */
+  registeredAt: zod.z.string().datetime().describe("Registration timestamp"),
+  /** Namespace status */
+  status: zod.z.enum(["active", "disabled", "reserved"]).describe("Namespace status")
+}).describe("Namespace ownership entry in the registry");
+var NamespaceConflictErrorSchema = zod.z.object({
+  /** Error type discriminator */
+  type: zod.z.literal("namespace_conflict").describe("Error type"),
+  /** Namespace that was requested */
+  requestedNamespace: zod.z.string().describe("Requested namespace"),
+  /** ID of the package that already owns the namespace */
+  conflictingPackageId: zod.z.string().describe("Conflicting package ID"),
+  /** Name of the conflicting package */
+  conflictingPackageName: zod.z.string().describe("Conflicting package display name"),
+  /** Suggested alternative namespace */
+  suggestion: zod.z.string().optional().describe("Suggested alternative namespace")
+}).describe("Namespace collision error during installation");
 var ListPackagesRequestSchema = zod.z.object({
   /** Filter by status */
-  status: PackageStatusEnum.optional(),
+  status: PackageStatusEnum.optional().describe("Filter by package status"),
   /** Filter by package type */
-  type: ManifestSchema.shape.type.optional(),
+  type: ManifestSchema.shape.type.optional().describe("Filter by package type"),
   /** Filter by enabled state */
-  enabled: zod.z.boolean().optional()
-});
+  enabled: zod.z.boolean().optional().describe("Filter by enabled state")
+}).describe("List packages request");
 var ListPackagesResponseSchema = zod.z.object({
-  packages: zod.z.array(InstalledPackageSchema),
-  total: zod.z.number()
-});
+  packages: zod.z.array(InstalledPackageSchema).describe("List of installed packages"),
+  total: zod.z.number().describe("Total package count")
+}).describe("List packages response");
 var GetPackageRequestSchema = zod.z.object({
   /** Package ID (reverse domain identifier from manifest) */
-  id: zod.z.string()
-});
+  id: zod.z.string().describe("Package identifier")
+}).describe("Get package request");
 var GetPackageResponseSchema = zod.z.object({
-  package: InstalledPackageSchema
-});
+  package: InstalledPackageSchema.describe("Package details")
+}).describe("Get package response");
 var InstallPackageRequestSchema = zod.z.object({
   /** The package manifest to install */
-  manifest: ManifestSchema,
+  manifest: ManifestSchema.describe("Package manifest to install"),
   /** Optional: user-provided settings at install time */
-  settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  settings: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("User-provided settings at install time"),
   /** Whether to enable immediately after install (default: true) */
-  enableOnInstall: zod.z.boolean().default(true)
-});
+  enableOnInstall: zod.z.boolean().default(true).describe("Whether to enable immediately after install"),
+  /**
+   * Current platform version for compatibility checking.
+   * When provided, the system compares this against the package's
+   * `engine.objectstack` requirement to verify compatibility.
+   */
+  platformVersion: zod.z.string().optional().describe("Current platform version for compatibility verification")
+}).describe("Install package request");
 var InstallPackageResponseSchema = zod.z.object({
-  package: InstalledPackageSchema,
-  message: zod.z.string().optional()
-});
+  package: InstalledPackageSchema.describe("Installed package details"),
+  message: zod.z.string().optional().describe("Installation status message"),
+  /** Dependency resolution result (when dependencies were analyzed) */
+  dependencyResolution: DependencyResolutionResultSchema.optional().describe("Dependency resolution result from install analysis")
+}).describe("Install package response");
 var UninstallPackageRequestSchema = zod.z.object({
   /** Package ID to uninstall */
-  id: zod.z.string()
-});
+  id: zod.z.string().describe("Package ID to uninstall")
+}).describe("Uninstall package request");
 var UninstallPackageResponseSchema = zod.z.object({
-  id: zod.z.string(),
-  success: zod.z.boolean(),
-  message: zod.z.string().optional()
-});
+  id: zod.z.string().describe("Uninstalled package ID"),
+  success: zod.z.boolean().describe("Whether uninstall succeeded"),
+  message: zod.z.string().optional().describe("Uninstall status message")
+}).describe("Uninstall package response");
 var EnablePackageRequestSchema = zod.z.object({
   /** Package ID to enable */
-  id: zod.z.string()
-});
+  id: zod.z.string().describe("Package ID to enable")
+}).describe("Enable package request");
 var EnablePackageResponseSchema = zod.z.object({
-  package: InstalledPackageSchema,
-  message: zod.z.string().optional()
-});
+  package: InstalledPackageSchema.describe("Enabled package details"),
+  message: zod.z.string().optional().describe("Enable status message")
+}).describe("Enable package response");
 var DisablePackageRequestSchema = zod.z.object({
   /** Package ID to disable */
-  id: zod.z.string()
-});
+  id: zod.z.string().describe("Package ID to disable")
+}).describe("Disable package request");
 var DisablePackageResponseSchema = zod.z.object({
-  package: InstalledPackageSchema,
-  message: zod.z.string().optional()
-});
+  package: InstalledPackageSchema.describe("Disabled package details"),
+  message: zod.z.string().optional().describe("Disable status message")
+}).describe("Disable package response");
 var MetadataChangeTypeSchema = zod.z.enum([
   "added",
   // New metadata item added in new version
@@ -2941,21 +3277,21 @@ var MetadataChangeTypeSchema = zod.z.enum([
   // Metadata item removed in new version
   "renamed"
   // Metadata item renamed
-]);
+]).describe("Type of metadata change between package versions");
 var MetadataDiffItemSchema = zod.z.object({
   /** Metadata type (e.g. "object", "view", "flow") */
   type: zod.z.string().describe("Metadata type"),
   /** Metadata name */
   name: zod.z.string().describe("Metadata name"),
   /** Type of change */
-  changeType: MetadataChangeTypeSchema,
+  changeType: MetadataChangeTypeSchema.describe("Category of metadata modification (added, modified, removed, or renamed)"),
   /** Whether this change has potential conflicts with customizations */
   hasConflict: zod.z.boolean().default(false).describe("Whether this change may conflict with customizations"),
   /** Human-readable summary of the change */
   summary: zod.z.string().optional().describe("Human-readable change summary"),
   /** Previous name (for renames) */
   previousName: zod.z.string().optional().describe("Previous name if renamed")
-});
+}).describe("Single metadata change between package versions");
 var UpgradeImpactLevelSchema = zod.z.enum([
   "none",
   // No impact, seamless upgrade
@@ -2967,7 +3303,7 @@ var UpgradeImpactLevelSchema = zod.z.enum([
   // Significant changes, user review recommended
   "critical"
   // Breaking changes, manual intervention required
-]);
+]).describe("Severity of upgrade impact");
 var UpgradePlanSchema = zod.z.object({
   /** Package being upgraded */
   packageId: zod.z.string().describe("Package identifier"),
@@ -2976,7 +3312,7 @@ var UpgradePlanSchema = zod.z.object({
   /** Target version to upgrade to */
   toVersion: zod.z.string().describe("Target upgrade version"),
   /** Overall impact level */
-  impactLevel: UpgradeImpactLevelSchema,
+  impactLevel: UpgradeImpactLevelSchema.describe("Severity assessment from none (seamless) to critical (breaking changes)"),
   /** List of all metadata changes between versions */
   changes: zod.z.array(MetadataDiffItemSchema).describe("All metadata changes"),
   /** Number of customer customizations that may be affected */
@@ -2995,7 +3331,7 @@ var UpgradePlanSchema = zod.z.object({
   estimatedDuration: zod.z.number().int().min(0).optional().describe("Estimated upgrade duration in seconds"),
   /** Human-readable summary */
   summary: zod.z.string().optional().describe("Human-readable upgrade summary")
-});
+}).describe("Upgrade analysis plan generated before execution");
 var UpgradeSnapshotSchema = zod.z.object({
   /** Snapshot ID (UUID) */
   id: zod.z.string().describe("Snapshot identifier"),
@@ -3008,7 +3344,7 @@ var UpgradeSnapshotSchema = zod.z.object({
   /** Tenant ID */
   tenantId: zod.z.string().optional().describe("Tenant identifier"),
   /** Complete manifest of the old package version */
-  previousManifest: ManifestSchema,
+  previousManifest: ManifestSchema.describe("Complete manifest of the previous package version"),
   /**
    * Snapshot of all metadata records owned by this package.
    * Stored as array of { type, name, metadata } tuples.
@@ -3026,7 +3362,7 @@ var UpgradeSnapshotSchema = zod.z.object({
   createdAt: zod.z.string().datetime().describe("Snapshot creation timestamp"),
   /** Expiry time for snapshot cleanup */
   expiresAt: zod.z.string().datetime().optional().describe("Snapshot expiry timestamp")
-});
+}).describe("Pre-upgrade state snapshot for rollback capability");
 var UpgradePackageRequestSchema = zod.z.object({
   /** Package ID to upgrade */
   packageId: zod.z.string().describe("Package ID to upgrade"),
@@ -3046,7 +3382,7 @@ var UpgradePackageRequestSchema = zod.z.object({
   dryRun: zod.z.boolean().default(false).describe("Preview upgrade without making changes"),
   /** Whether to skip pre-upgrade validation */
   skipValidation: zod.z.boolean().default(false).describe("Skip pre-upgrade compatibility checks")
-});
+}).describe("Upgrade package request");
 var UpgradePhaseSchema = zod.z.enum([
   "pending",
   // Upgrade requested but not started
@@ -3068,12 +3404,12 @@ var UpgradePhaseSchema = zod.z.enum([
   // Rollback in progress
   "rolled-back"
   // Rollback completed
-]);
+]).describe("Current phase of the upgrade process");
 var UpgradePackageResponseSchema = zod.z.object({
   /** Whether the upgrade was successful */
   success: zod.z.boolean().describe("Whether the upgrade succeeded"),
   /** Current upgrade phase */
-  phase: UpgradePhaseSchema,
+  phase: UpgradePhaseSchema.describe("Current upgrade phase"),
   /** The upgrade plan that was executed */
   plan: UpgradePlanSchema.optional().describe("Upgrade plan"),
   /** Snapshot ID for rollback */
@@ -3086,10 +3422,10 @@ var UpgradePackageResponseSchema = zod.z.object({
     customValue: zod.z.unknown()
   })).optional().describe("Unresolved merge conflicts"),
   /** Error message (if failed) */
-  errorMessage: zod.z.string().optional(),
+  errorMessage: zod.z.string().optional().describe("Error message if upgrade failed"),
   /** Human-readable summary */
-  message: zod.z.string().optional()
-});
+  message: zod.z.string().optional().describe("Human-readable status message")
+}).describe("Upgrade package response");
 var RollbackPackageRequestSchema = zod.z.object({
   /** Package ID to rollback */
   packageId: zod.z.string().describe("Package ID to rollback"),
@@ -3097,15 +3433,15 @@ var RollbackPackageRequestSchema = zod.z.object({
   snapshotId: zod.z.string().describe("Snapshot ID to restore from"),
   /** Whether to also rollback customizations */
   rollbackCustomizations: zod.z.boolean().default(true).describe("Whether to restore pre-upgrade customizations")
-});
+}).describe("Rollback package request");
 var RollbackPackageResponseSchema = zod.z.object({
   /** Whether the rollback was successful */
-  success: zod.z.boolean(),
+  success: zod.z.boolean().describe("Whether the rollback succeeded"),
   /** Restored version */
   restoredVersion: zod.z.string().optional().describe("Version restored to"),
   /** Message */
-  message: zod.z.string().optional()
-});
+  message: zod.z.string().optional().describe("Rollback status message")
+}).describe("Rollback package response");
 var PluginHealthStatusSchema = zod.z.enum([
   "healthy",
   // Plugin is operating normally
@@ -4780,7 +5116,7 @@ var DependencyConflictSchema = zod.z.object({
    */
   severity: zod.z.enum(["critical", "error", "warning", "info"])
 });
-var DependencyResolutionResultSchema = zod.z.object({
+var PluginDependencyResolutionResultSchema = zod.z.object({
   /**
    * Resolution successful
    */
@@ -6032,6 +6368,9 @@ var ExecutionContextSchema = zod.z.object({
 
 exports.ActivationEventSchema = ActivationEventSchema;
 exports.AdvancedPluginLifecycleConfigSchema = AdvancedPluginLifecycleConfigSchema;
+exports.ArtifactChecksumSchema = ArtifactChecksumSchema;
+exports.ArtifactFileEntrySchema = ArtifactFileEntrySchema;
+exports.ArtifactSignatureSchema = ArtifactSignatureSchema;
 exports.BreakingChangeSchema = BreakingChangeSchema;
 exports.CLICommandContributionSchema = CLICommandContributionSchema;
 exports.CORE_PLUGIN_TYPES = CORE_PLUGIN_TYPES;
@@ -6046,6 +6385,7 @@ exports.DependencyConflictSchema = DependencyConflictSchema;
 exports.DependencyGraphNodeSchema = DependencyGraphNodeSchema;
 exports.DependencyGraphSchema = DependencyGraphSchema;
 exports.DependencyResolutionResultSchema = DependencyResolutionResultSchema;
+exports.DependencyStatusEnum = DependencyStatusEnum;
 exports.DeprecationNoticeSchema = DeprecationNoticeSchema;
 exports.DevFixtureConfigSchema = DevFixtureConfigSchema;
 exports.DevPluginConfigSchema = DevPluginConfigSchema;
@@ -6109,6 +6449,7 @@ exports.MergeResultSchema = MergeResultSchema;
 exports.MergeStrategyConfigSchema = MergeStrategyConfigSchema;
 exports.MetadataBulkRegisterRequestSchema = MetadataBulkRegisterRequestSchema;
 exports.MetadataBulkResultSchema = MetadataBulkResultSchema;
+exports.MetadataCategoryEnum = MetadataCategoryEnum;
 exports.MetadataChangeTypeSchema = MetadataChangeTypeSchema;
 exports.MetadataCollectionInfoSchema = MetadataCollectionInfoSchema;
 exports.MetadataDependencySchema = MetadataDependencySchema;
@@ -6135,10 +6476,13 @@ exports.MetadataTypeSchema = MetadataTypeSchema;
 exports.MetadataValidationResultSchema = MetadataValidationResultSchema;
 exports.MetadataWatchEventSchema = MetadataWatchEventSchema;
 exports.MultiVersionSupportSchema = MultiVersionSupportSchema;
+exports.NamespaceConflictErrorSchema = NamespaceConflictErrorSchema;
+exports.NamespaceRegistryEntrySchema = NamespaceRegistryEntrySchema;
 exports.OclifPluginConfigSchema = OclifPluginConfigSchema;
 exports.OpsDomainModuleSchema = OpsDomainModuleSchema;
 exports.OpsFilePathSchema = OpsFilePathSchema;
 exports.OpsPluginStructureSchema = OpsPluginStructureSchema;
+exports.PackageArtifactSchema = PackageArtifactSchema;
 exports.PackageDependencyConflictSchema = PackageDependencyConflictSchema;
 exports.PackageDependencyResolutionResultSchema = PackageDependencyResolutionResultSchema;
 exports.PackageDependencySchema = PackageDependencySchema;
@@ -6147,12 +6491,15 @@ exports.PermissionActionSchema = PermissionActionSchema;
 exports.PermissionSchema = PermissionSchema;
 exports.PermissionScopeSchema = PermissionScopeSchema;
 exports.PermissionSetSchema = PermissionSetSchema;
+exports.PluginBuildOptionsSchema = PluginBuildOptionsSchema;
+exports.PluginBuildResultSchema = PluginBuildResultSchema;
 exports.PluginCachingSchema = PluginCachingSchema;
 exports.PluginCapabilityManifestSchema = PluginCapabilityManifestSchema;
 exports.PluginCapabilitySchema = PluginCapabilitySchema;
 exports.PluginCodeSplittingSchema = PluginCodeSplittingSchema;
 exports.PluginCompatibilityMatrixSchema = PluginCompatibilityMatrixSchema;
 exports.PluginContextSchema = PluginContextSchema;
+exports.PluginDependencyResolutionResultSchema = PluginDependencyResolutionResultSchema;
 exports.PluginDependencyResolutionSchema = PluginDependencyResolutionSchema;
 exports.PluginDependencySchema = PluginDependencySchema;
 exports.PluginDiscoveryConfigSchema = PluginDiscoveryConfigSchema;
@@ -6178,6 +6525,8 @@ exports.PluginMetadataSchema = PluginMetadataSchema;
 exports.PluginPerformanceMonitoringSchema = PluginPerformanceMonitoringSchema;
 exports.PluginPreloadConfigSchema = PluginPreloadConfigSchema;
 exports.PluginProvenanceSchema = PluginProvenanceSchema;
+exports.PluginPublishOptionsSchema = PluginPublishOptionsSchema;
+exports.PluginPublishResultSchema = PluginPublishResultSchema;
 exports.PluginQualityMetricsSchema = PluginQualityMetricsSchema;
 exports.PluginRegisteredEventSchema = PluginRegisteredEventSchema;
 exports.PluginRegistryEntrySchema = PluginRegistryEntrySchema;
@@ -6193,6 +6542,8 @@ exports.PluginStatisticsSchema = PluginStatisticsSchema;
 exports.PluginTrustLevelSchema = PluginTrustLevelSchema;
 exports.PluginTrustScoreSchema = PluginTrustScoreSchema;
 exports.PluginUpdateStrategySchema = PluginUpdateStrategySchema;
+exports.PluginValidateOptionsSchema = PluginValidateOptionsSchema;
+exports.PluginValidateResultSchema = PluginValidateResultSchema;
 exports.PluginVendorSchema = PluginVendorSchema;
 exports.PluginVersionMetadataSchema = PluginVersionMetadataSchema;
 exports.PreviewModeConfigSchema = PreviewModeConfigSchema;
@@ -6200,6 +6551,8 @@ exports.ProtocolFeatureSchema = ProtocolFeatureSchema;
 exports.ProtocolReferenceSchema = ProtocolReferenceSchema;
 exports.ProtocolVersionSchema = ProtocolVersionSchema;
 exports.RealTimeNotificationConfigSchema = RealTimeNotificationConfigSchema;
+exports.RequiredActionSchema = RequiredActionSchema;
+exports.ResolvedDependencySchema = ResolvedDependencySchema;
 exports.ResourceTypeSchema = ResourceTypeSchema;
 exports.RollbackPackageRequestSchema = RollbackPackageRequestSchema;
 exports.RollbackPackageResponseSchema = RollbackPackageResponseSchema;
@@ -6224,6 +6577,7 @@ exports.StartupOptionsSchema = StartupOptionsSchema;
 exports.StartupOrchestrationResultSchema = StartupOrchestrationResultSchema;
 exports.UninstallPackageRequestSchema = UninstallPackageRequestSchema;
 exports.UninstallPackageResponseSchema = UninstallPackageResponseSchema;
+exports.UpgradeContextSchema = UpgradeContextSchema;
 exports.UpgradeImpactLevelSchema = UpgradeImpactLevelSchema;
 exports.UpgradePackageRequestSchema = UpgradePackageRequestSchema;
 exports.UpgradePackageResponseSchema = UpgradePackageResponseSchema;
@@ -6231,7 +6585,9 @@ exports.UpgradePhaseSchema = UpgradePhaseSchema;
 exports.UpgradePlanSchema = UpgradePlanSchema;
 exports.UpgradeSnapshotSchema = UpgradeSnapshotSchema;
 exports.ValidationErrorSchema = ValidationErrorSchema;
+exports.ValidationFindingSchema = ValidationFindingSchema;
 exports.ValidationResultSchema = ValidationResultSchema;
+exports.ValidationSeverityEnum = ValidationSeverityEnum;
 exports.ValidationWarningSchema = ValidationWarningSchema;
 exports.VersionConstraintSchema = VersionConstraintSchema;
 exports.VulnerabilitySeverity = VulnerabilitySeverity;