@vorionsys/shared-constants 1.0.0

package/src/index.ts

@@ -0,0 +1,206 @@
+/**
+ * @vorionsys/shared-constants
+ *
+ * Single source of truth for the Vorion ecosystem
+ *
+ * This package provides shared constants, types, and helper functions
+ * that ensure consistency across all Vorion products and sites:
+ *
+ * - Trust tiers and thresholds (T0-T7)
+ * - Domain and URL configuration
+ * - Capability definitions
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   TrustTier,
+ *   TIER_THRESHOLDS,
+ *   scoreToTier,
+ *   API_ENDPOINTS,
+ *   CAPABILITIES,
+ * } from '@vorionsys/shared-constants';
+ *
+ * // Get tier from score
+ * const tier = scoreToTier(750); // TrustTier.T4_STANDARD
+ *
+ * // Get tier info
+ * const info = TIER_THRESHOLDS[TrustTier.T4_STANDARD];
+ * console.log(info.name); // "Standard"
+ * console.log(info.min, info.max); // 650, 799
+ *
+ * // Get API endpoint
+ * const apiUrl = API_ENDPOINTS.cognigate.production;
+ * // "https://cognigate.dev/v1"
+ * ```
+ *
+ * @see https://basis.vorion.org
+ * @see https://vorion.org
+ */
+
+// =============================================================================
+// TRUST TIERS
+// =============================================================================
+
+export {
+  TrustTier,
+  TIER_THRESHOLDS,
+  scoreToTier,
+  getTierThreshold,
+  getTierName,
+  getTierColor,
+  getTierMinScore,
+  getTierMaxScore,
+  getTierCode,
+  meetsTierRequirement,
+  parseTier,
+  ALL_TIERS,
+  type TierThreshold,
+  type TrustTierName,
+  type TrustTierCode,
+} from './tiers';
+
+// =============================================================================
+// DOMAINS & URLS
+// =============================================================================
+
+export {
+  VORION_DOMAINS,
+  AGENTANCHOR_DOMAINS,
+  COGNIGATE_DOMAINS,
+  API_ENDPOINTS,
+  VORION_EMAILS,
+  AGENTANCHOR_EMAILS,
+  GITHUB,
+  NPM_PACKAGES,
+  ALL_DOMAINS,
+  DOMAIN_ALIASES,
+  type VorionDomain,
+  type AgentAnchorDomain,
+  type CognigateDomain,
+} from './domains';
+
+// =============================================================================
+// CAPABILITIES
+// =============================================================================
+
+export {
+  CapabilityCategory,
+  CAPABILITIES,
+  getCapabilitiesForTier,
+  getCapability,
+  isCapabilityAvailable,
+  getCapabilityMinTier,
+  getCapabilitiesByCategory,
+  getAllCapabilityCodes,
+  type CapabilityDefinition,
+} from './capabilities';
+
+// =============================================================================
+// PRODUCTS
+// =============================================================================
+
+export {
+  ProductCategory,
+  ProductStatus,
+  VORION_PRODUCTS,
+  AGENTANCHOR_PRODUCTS,
+  ALL_PRODUCTS,
+  getProduct,
+  getProductsByCategory,
+  getProductsByStatus,
+  getProductsByOrganization,
+  type ProductDefinition,
+} from './products';
+
+// =============================================================================
+// RATE LIMITS & QUOTAS
+// =============================================================================
+
+export {
+  RATE_LIMITS,
+  TIER_QUOTAS,
+  getRateLimits,
+  getMinTierForLimits,
+  wouldExceedLimit,
+  formatRateLimit,
+  getQuota,
+  isUnlimited,
+  type RateLimitConfig,
+  type QuotaConfig,
+} from './rate-limits';
+
+// =============================================================================
+// ERROR CODES
+// =============================================================================
+
+export {
+  ErrorCategory,
+  AUTH_ERRORS,
+  VALIDATION_ERRORS,
+  RATE_LIMIT_ERRORS,
+  NOT_FOUND_ERRORS,
+  TRUST_ERRORS,
+  SERVER_ERRORS,
+  EXTERNAL_ERRORS,
+  ERROR_CODES,
+  getErrorByCode,
+  getErrorsByCategory,
+  getRetryableErrors,
+  formatErrorMessage,
+  createErrorResponse,
+  type ErrorDefinition,
+  type ErrorCode,
+} from './error-codes';
+
+// =============================================================================
+// API VERSIONS
+// =============================================================================
+
+export {
+  VersionStatus,
+  COGNIGATE_VERSIONS,
+  COGNIGATE_CURRENT_VERSION,
+  COGNIGATE_DEFAULT_VERSION,
+  TRUST_API_VERSIONS,
+  TRUST_CURRENT_VERSION,
+  LOGIC_API_VERSIONS,
+  LOGIC_CURRENT_VERSION,
+  BASIS_VERSIONS,
+  BASIS_CURRENT_VERSION,
+  BASIS_SPEC_VERSION,
+  CAR_SPEC_VERSIONS,
+  CAR_SPEC_CURRENT_VERSION,
+  API_VERSIONS,
+  getCurrentVersion,
+  getVersionDefinition,
+  isVersionSupported,
+  isVersionDeprecated,
+  getStableVersions,
+  buildApiUrl,
+  VERSION_HEADERS,
+  type ApiVersionDefinition,
+} from './api-versions';
+
+// =============================================================================
+// THEMES
+// =============================================================================
+
+export {
+  ACTIVE_THEME,
+  THEMES,
+  getActiveTheme,
+  getAllThemeIds,
+  themeToCssVars,
+  type ThemeId,
+  type ThemeTokens,
+} from './themes';
+
+// =============================================================================
+// PACKAGE VERSION
+// =============================================================================
+
+/** Package version */
+export const VERSION = '1.0.0';
+
+/** Last updated date */
+export const LAST_UPDATED = '2026-02-04';

package/src/products.ts

@@ -0,0 +1,285 @@
+/**
+ * @vorionsys/shared-constants - Product Definitions
+ *
+ * Single source of truth for all Vorion ecosystem products
+ * Used for consistent product references across all sites
+ *
+ * @see https://vorion.org
+ */
+
+// =============================================================================
+// PRODUCT CATEGORIES
+// =============================================================================
+
+export enum ProductCategory {
+  /** Open source standards and specifications */
+  OPEN_SOURCE = 'open_source',
+
+  /** Commercial SaaS products */
+  COMMERCIAL = 'commercial',
+
+  /** Developer tools and SDKs */
+  DEVELOPER_TOOLS = 'developer_tools',
+
+  /** Educational platforms */
+  EDUCATION = 'education',
+}
+
+// =============================================================================
+// PRODUCT STATUS
+// =============================================================================
+
+export enum ProductStatus {
+  /** In active development, not yet released */
+  DEVELOPMENT = 'development',
+
+  /** Released as alpha/preview */
+  ALPHA = 'alpha',
+
+  /** Released as beta */
+  BETA = 'beta',
+
+  /** Generally available */
+  GA = 'ga',
+
+  /** Deprecated, still supported */
+  DEPRECATED = 'deprecated',
+
+  /** End of life, no longer supported */
+  EOL = 'eol',
+}
+
+// =============================================================================
+// PRODUCT DEFINITIONS
+// =============================================================================
+
+export interface ProductDefinition {
+  /** Unique product identifier */
+  id: string;
+
+  /** Human-readable name */
+  name: string;
+
+  /** Short description */
+  description: string;
+
+  /** Product category */
+  category: ProductCategory;
+
+  /** Current status */
+  status: ProductStatus;
+
+  /** Primary website URL */
+  url: string;
+
+  /** Documentation URL */
+  docsUrl?: string;
+
+  /** GitHub repository URL */
+  repoUrl?: string;
+
+  /** NPM package name */
+  npmPackage?: string;
+
+  /** Parent organization */
+  organization: 'vorion' | 'agentanchor';
+
+  /** Version (semver) */
+  version?: string;
+}
+
+// =============================================================================
+// VORION OPEN SOURCE PRODUCTS
+// =============================================================================
+
+export const VORION_PRODUCTS: Record<string, ProductDefinition> = {
+  basis: {
+    id: 'basis',
+    name: 'BASIS',
+    description: 'Blockchain Agent Safety & Identity Standard - Open framework for AI agent governance',
+    category: ProductCategory.OPEN_SOURCE,
+    status: ProductStatus.GA,
+    url: 'https://basis.vorion.org',
+    docsUrl: 'https://basis.vorion.org/docs',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/packages/basis',
+    npmPackage: '@vorionsys/basis',
+    organization: 'vorion',
+    version: '1.0.0',
+  },
+
+  carId: {
+    id: 'car-id',
+    name: 'CAR ID',
+    description: 'Categorical Agent Registry - Universal agent identification system',
+    category: ProductCategory.OPEN_SOURCE,
+    status: ProductStatus.GA,
+    url: 'https://carid.vorion.org',
+    docsUrl: 'https://carid.vorion.org/docs',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/packages/car-spec',
+    npmPackage: '@vorionsys/car-spec',
+    organization: 'vorion',
+    version: '1.0.0',
+  },
+
+  atsf: {
+    id: 'atsf',
+    name: 'ATSF',
+    description: 'Agent Trust & Safety Framework - Comprehensive safety evaluation system',
+    category: ProductCategory.OPEN_SOURCE,
+    status: ProductStatus.BETA,
+    url: 'https://atsf.vorion.org',
+    docsUrl: 'https://atsf.vorion.org/docs',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/packages/atsf-core',
+    npmPackage: '@vorionsys/atsf-core',
+    organization: 'vorion',
+    version: '0.9.0',
+  },
+
+  kaizen: {
+    id: 'kaizen',
+    name: 'Kaizen',
+    description: 'Interactive AI Learning Experience - Educational platform for agentic AI',
+    category: ProductCategory.EDUCATION,
+    status: ProductStatus.BETA,
+    url: 'https://learn.vorion.org',
+    docsUrl: 'https://learn.vorion.org/docs',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/kaizen',
+    organization: 'vorion',
+  },
+
+  kaizenStudio: {
+    id: 'kaizen-studio',
+    name: 'Kaizen Studio',
+    description: 'Interactive AI learning studio - hands-on agentic AI experiments',
+    category: ProductCategory.EDUCATION,
+    status: ProductStatus.BETA,
+    url: 'https://kaizen.vorion.org',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/kaizen',
+    organization: 'vorion',
+  },
+
+  proofPlane: {
+    id: 'proof-plane',
+    name: 'Proof Plane',
+    description: 'Cryptographic proof layer for agent attestations and verifiable execution',
+    category: ProductCategory.OPEN_SOURCE,
+    status: ProductStatus.BETA,
+    url: 'https://vorion.org/proof-plane',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/packages/proof-plane',
+    npmPackage: '@vorionsys/proof-plane',
+    organization: 'vorion',
+    version: '0.5.0',
+  },
+
+  contracts: {
+    id: 'contracts',
+    name: 'Vorion Contracts',
+    description: 'Smart contracts for on-chain agent governance and attestations',
+    category: ProductCategory.OPEN_SOURCE,
+    status: ProductStatus.BETA,
+    url: 'https://vorion.org/contracts',
+    repoUrl: 'https://github.com/voriongit/vorion/tree/master/packages/contracts',
+    npmPackage: '@vorionsys/contracts',
+    organization: 'vorion',
+  },
+} as const;
+
+// =============================================================================
+// AGENT ANCHOR COMMERCIAL PRODUCTS
+// =============================================================================
+
+export const AGENTANCHOR_PRODUCTS: Record<string, ProductDefinition> = {
+  cognigate: {
+    id: 'cognigate',
+    name: 'Cognigate',
+    description: 'AI Governance API - Reference implementation of BASIS runtime',
+    category: ProductCategory.COMMERCIAL,
+    status: ProductStatus.GA,
+    url: 'https://cognigate.dev',
+    docsUrl: 'https://cognigate.dev/docs',
+    npmPackage: '@vorionsys/cognigate',
+    organization: 'agentanchor',
+    version: '1.0.0',
+  },
+
+  trust: {
+    id: 'trust',
+    name: 'Agent Anchor Trust',
+    description: 'Trust verification and certification platform for AI agents',
+    category: ProductCategory.COMMERCIAL,
+    status: ProductStatus.GA,
+    url: 'https://trust.agentanchorai.com',
+    docsUrl: 'https://trust.agentanchorai.com/docs',
+    organization: 'agentanchor',
+  },
+
+  logic: {
+    id: 'logic',
+    name: 'Agent Anchor Logic',
+    description: 'Policy engine and governance logic for enterprise AI',
+    category: ProductCategory.COMMERCIAL,
+    status: ProductStatus.BETA,
+    url: 'https://logic.agentanchorai.com',
+    docsUrl: 'https://logic.agentanchorai.com/docs',
+    organization: 'agentanchor',
+  },
+
+  platform: {
+    id: 'platform',
+    name: 'Agent Anchor Platform',
+    description: 'Enterprise AI governance dashboard and management console',
+    category: ProductCategory.COMMERCIAL,
+    status: ProductStatus.GA,
+    url: 'https://agentanchorai.com',
+    docsUrl: 'https://agentanchorai.com/docs',
+    organization: 'agentanchor',
+  },
+} as const;
+
+// =============================================================================
+// ALL PRODUCTS
+// =============================================================================
+
+export const ALL_PRODUCTS = {
+  vorion: VORION_PRODUCTS,
+  agentAnchor: AGENTANCHOR_PRODUCTS,
+} as const;
+
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+
+/**
+ * Get a product by its ID
+ */
+export function getProduct(productId: string): ProductDefinition | undefined {
+  return (
+    VORION_PRODUCTS[productId] ||
+    AGENTANCHOR_PRODUCTS[productId]
+  );
+}
+
+/**
+ * Get all products by category
+ */
+export function getProductsByCategory(category: ProductCategory): ProductDefinition[] {
+  const allProducts = [...Object.values(VORION_PRODUCTS), ...Object.values(AGENTANCHOR_PRODUCTS)];
+  return allProducts.filter(p => p.category === category);
+}
+
+/**
+ * Get all products by status
+ */
+export function getProductsByStatus(status: ProductStatus): ProductDefinition[] {
+  const allProducts = [...Object.values(VORION_PRODUCTS), ...Object.values(AGENTANCHOR_PRODUCTS)];
+  return allProducts.filter(p => p.status === status);
+}
+
+/**
+ * Get all products by organization
+ */
+export function getProductsByOrganization(org: 'vorion' | 'agentanchor'): ProductDefinition[] {
+  return org === 'vorion'
+    ? Object.values(VORION_PRODUCTS)
+    : Object.values(AGENTANCHOR_PRODUCTS);
+}