@vorionsys/shared-constants 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -0,0 +1,169 @@
+import { TrustTier } from './tiers.js';
+export { ALL_TIERS, TIER_THRESHOLDS, TierThreshold, TrustTierCode, TrustTierName, getTierCode, getTierColor, getTierMaxScore, getTierMinScore, getTierName, getTierThreshold, meetsTierRequirement, parseTier, scoreToTier } from './tiers.js';
+export { AGENTANCHOR_DOMAINS, AGENTANCHOR_EMAILS, ALL_DOMAINS, API_ENDPOINTS, AgentAnchorDomain, COGNIGATE_DOMAINS, CognigateDomain, DOMAIN_ALIASES, GITHUB, NPM_PACKAGES, VORION_DOMAINS, VORION_EMAILS, VorionDomain } from './domains.js';
+export { CAPABILITIES, CapabilityCategory, CapabilityDefinition, getAllCapabilityCodes, getCapabilitiesByCategory, getCapabilitiesForTier, getCapability, getCapabilityMinTier, isCapabilityAvailable } from './capabilities.js';
+export { AGENTANCHOR_PRODUCTS, ALL_PRODUCTS, ProductCategory, ProductDefinition, ProductStatus, VORION_PRODUCTS, getProduct, getProductsByCategory, getProductsByOrganization, getProductsByStatus } from './products.js';
+export { QuotaConfig, RATE_LIMITS, RateLimitConfig, TIER_QUOTAS, formatRateLimit, getMinTierForLimits, getQuota, getRateLimits, isUnlimited, wouldExceedLimit } from './rate-limits.js';
+export { AUTH_ERRORS, ERROR_CODES, EXTERNAL_ERRORS, ErrorCategory, ErrorCode, ErrorDefinition, NOT_FOUND_ERRORS, RATE_LIMIT_ERRORS, SERVER_ERRORS, TRUST_ERRORS, VALIDATION_ERRORS, createErrorResponse, formatErrorMessage, getErrorByCode, getErrorsByCategory, getRetryableErrors } from './error-codes.js';
+export { API_VERSIONS, ApiVersionDefinition, BASIS_CURRENT_VERSION, BASIS_SPEC_VERSION, BASIS_VERSIONS, CAR_SPEC_CURRENT_VERSION, CAR_SPEC_VERSIONS, COGNIGATE_CURRENT_VERSION, COGNIGATE_DEFAULT_VERSION, COGNIGATE_VERSIONS, LOGIC_API_VERSIONS, LOGIC_CURRENT_VERSION, TRUST_API_VERSIONS, TRUST_CURRENT_VERSION, VERSION_HEADERS, VersionStatus, buildApiUrl, getCurrentVersion, getStableVersions, getVersionDefinition, isVersionDeprecated, isVersionSupported } from './api-versions.js';
+export { ACTIVE_THEME, THEMES, ThemeId, ThemeTokens, getActiveTheme, getAllThemeIds, themeToCssVars } from './themes.js';
+
+/**
+ * @vorionsys/shared-constants - CAR Identity Category Taxonomy v2.0
+ *
+ * Hierarchical controlled vocabulary for agent classification.
+ * Used across all Vorion ecosystem products for consistent agent categorization.
+ *
+ * Categories define:
+ * - Minimum trust tier required for the category
+ * - EU AI Act high-risk classification
+ * - Subcategories for fine-grained classification
+ * - Trust dimensions most relevant to the category
+ *
+ * @see https://basis.vorion.org/car/categories
+ */
+
+/**
+ * Top-level category codes for agent classification
+ */
+declare enum CARCategory {
+    GOVERNANCE = "GOV",
+    REASONING = "RSN",
+    TOOL_USE = "TUL",
+    MEMORY = "MEM",
+    MULTI_AGENT = "MAG",
+    SAFETY = "SAF",
+    AUDIT = "AUD",
+    COMPLIANCE = "CMP",
+    FINANCE = "FIN",
+    HEALTHCARE = "HLT",
+    EMPLOYMENT = "EMP",
+    CREATIVE = "CRE",
+    RESEARCH = "RES",
+    SWARM = "SWM",
+    SELF_IMPROVEMENT = "SLF",
+    HUMAN_INTERFACE = "HIF",
+    SYSTEM = "SYS"
+}
+/**
+ * Trust dimensions relevant to category classification
+ */
+type TrustDimension = 'behavioral' | 'compliance' | 'identity' | 'context' | 'reliability' | 'transparency';
+/**
+ * Subcategory within a top-level category
+ */
+interface CARSubcategory {
+    readonly code: string;
+    readonly name: string;
+    readonly description: string;
+}
+/**
+ * Full category definition with metadata
+ */
+interface CARCategoryDefinition {
+    readonly code: CARCategory;
+    readonly name: string;
+    readonly description: string;
+    /** Minimum trust tier required to operate in this category */
+    readonly minTier: TrustTier;
+    /** Whether this category is high-risk under EU AI Act */
+    readonly euHighRisk: boolean;
+    /** Trust dimensions most relevant to this category */
+    readonly trustDimensions: readonly TrustDimension[];
+    /** Subcategories for fine-grained classification */
+    readonly subcategories: readonly CARSubcategory[];
+}
+/**
+ * Complete CAR category taxonomy
+ */
+declare const CAR_CATEGORIES: readonly CARCategoryDefinition[];
+/**
+ * Get a category by code
+ */
+declare function getCARCategory(code: CARCategory | string): CARCategoryDefinition | undefined;
+/**
+ * Get all categories available at a specific trust tier
+ */
+declare function getCARCategoriesForTier(tier: TrustTier): CARCategoryDefinition[];
+/**
+ * Get all EU AI Act high-risk categories
+ */
+declare function getHighRiskCategories(): CARCategoryDefinition[];
+/**
+ * Check if a category is available at a given trust tier
+ */
+declare function isCARCategoryAvailable(code: CARCategory | string, tier: TrustTier): boolean;
+/**
+ * Get the minimum tier required for a category
+ */
+declare function getCARCategoryMinTier(code: CARCategory | string): TrustTier | undefined;
+/**
+ * Get a subcategory by its full code (e.g., "GOV-POL")
+ */
+declare function getCARSubcategory(fullCode: string): CARSubcategory | undefined;
+/**
+ * Get the parent category for a subcategory code
+ */
+declare function getParentCategory(subcategoryCode: string): CARCategoryDefinition | undefined;
+/**
+ * Get all category codes
+ */
+declare function getAllCARCategoryCodes(): CARCategory[];
+/**
+ * Get all subcategory codes
+ */
+declare function getAllCARSubcategoryCodes(): string[];
+/**
+ * Validate that a category code is valid
+ */
+declare function isValidCARCategory(code: string): code is CARCategory;
+/**
+ * Validate that a subcategory code is valid
+ */
+declare function isValidCARSubcategory(code: string): boolean;
+
+/**
+ * @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
+ */
+
+/** Package version */
+declare const VERSION = "1.0.2";
+/** Last updated date */
+declare const LAST_UPDATED = "2026-02-16";
+
+export { CARCategory, type CARCategoryDefinition, type CARSubcategory, CAR_CATEGORIES, LAST_UPDATED, type TrustDimension, TrustTier, VERSION, getAllCARCategoryCodes, getAllCARSubcategoryCodes, getCARCategoriesForTier, getCARCategory, getCARCategoryMinTier, getCARSubcategory, getHighRiskCategories, getParentCategory, isCARCategoryAvailable, isValidCARCategory, isValidCARSubcategory };

package/dist/index.js

@@ -30,7 +30,7 @@ import {
   getCapability,
   getCapabilityMinTier,
   isCapabilityAvailable
-} from "./chunk-JZJPDGG7.js";
+} from "./chunk-CJQJGJZ6.js";
 import {
   AGENTANCHOR_DOMAINS,
   AGENTANCHOR_EMAILS,
@@ -42,7 +42,7 @@ import {
   NPM_PACKAGES,
   VORION_DOMAINS,
   VORION_EMAILS
-} from "./chunk-IKLCEYZT.js";
+} from "./chunk-OEEPW54O.js";
 import {
   AUTH_ERRORS,
   ERROR_CODES,
@@ -69,7 +69,7 @@ import {
   getProductsByCategory,
   getProductsByOrganization,
   getProductsByStatus
-} from "./chunk-RZQZEF6Q.js";
+} from "./chunk-JOS3AHBL.js";
 import {
   RATE_LIMITS,
   TIER_QUOTAS,
@@ -102,9 +102,321 @@ import {
   themeToCssVars
 } from "./chunk-P3VPMVF3.js";
 
+// src/car-categories.ts
+var CARCategory = /* @__PURE__ */ ((CARCategory2) => {
+  CARCategory2["GOVERNANCE"] = "GOV";
+  CARCategory2["REASONING"] = "RSN";
+  CARCategory2["TOOL_USE"] = "TUL";
+  CARCategory2["MEMORY"] = "MEM";
+  CARCategory2["MULTI_AGENT"] = "MAG";
+  CARCategory2["SAFETY"] = "SAF";
+  CARCategory2["AUDIT"] = "AUD";
+  CARCategory2["COMPLIANCE"] = "CMP";
+  CARCategory2["FINANCE"] = "FIN";
+  CARCategory2["HEALTHCARE"] = "HLT";
+  CARCategory2["EMPLOYMENT"] = "EMP";
+  CARCategory2["CREATIVE"] = "CRE";
+  CARCategory2["RESEARCH"] = "RES";
+  CARCategory2["SWARM"] = "SWM";
+  CARCategory2["SELF_IMPROVEMENT"] = "SLF";
+  CARCategory2["HUMAN_INTERFACE"] = "HIF";
+  CARCategory2["SYSTEM"] = "SYS";
+  return CARCategory2;
+})(CARCategory || {});
+var CAR_CATEGORIES = [
+  // ---- Core Agent Functions ----
+  {
+    code: "GOV" /* GOVERNANCE */,
+    name: "Governance",
+    description: "Policy enforcement, decision arbitration, and oversight agents",
+    minTier: 4 /* T4_STANDARD */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "transparency", "reliability"],
+    subcategories: [
+      { code: "GOV-POL", name: "Policy Enforcement", description: "Enforces organizational policies" },
+      { code: "GOV-ARB", name: "Decision Arbitration", description: "Arbitrates between competing decisions" },
+      { code: "GOV-ESC", name: "Escalation Management", description: "Manages escalation workflows" },
+      { code: "GOV-AUT", name: "Authority Delegation", description: "Delegates authority to sub-agents" }
+    ]
+  },
+  {
+    code: "RSN" /* REASONING */,
+    name: "Reasoning",
+    description: "Logical analysis, planning, and inference agents",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "reliability"],
+    subcategories: [
+      { code: "RSN-LOG", name: "Logical Inference", description: "Deductive and inductive reasoning" },
+      { code: "RSN-PLN", name: "Planning", description: "Multi-step plan generation and optimization" },
+      { code: "RSN-ANL", name: "Analysis", description: "Data analysis and pattern recognition" },
+      { code: "RSN-DEC", name: "Decision Support", description: "Structured decision-making support" }
+    ]
+  },
+  {
+    code: "TUL" /* TOOL_USE */,
+    name: "Tool Use",
+    description: "API invocation, code execution, and external system interaction",
+    minTier: 3 /* T3_MONITORED */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "compliance", "context"],
+    subcategories: [
+      { code: "TUL-API", name: "API Integration", description: "Calls external APIs" },
+      { code: "TUL-COD", name: "Code Execution", description: "Executes code in sandbox or runtime" },
+      { code: "TUL-FIL", name: "File Operations", description: "Reads, writes, and manages files" },
+      { code: "TUL-DB", name: "Database Operations", description: "Queries and modifies databases" }
+    ]
+  },
+  {
+    code: "MEM" /* MEMORY */,
+    name: "Memory",
+    description: "Context retention, knowledge management, and recall agents",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["identity", "context", "reliability"],
+    subcategories: [
+      { code: "MEM-STM", name: "Short-Term Memory", description: "Session and conversation context" },
+      { code: "MEM-LTM", name: "Long-Term Memory", description: "Persistent knowledge storage" },
+      { code: "MEM-RET", name: "Retrieval", description: "Knowledge retrieval and RAG" },
+      { code: "MEM-SUM", name: "Summarization", description: "Context compression and summarization" }
+    ]
+  },
+  // ---- Multi-Agent & Swarm ----
+  {
+    code: "MAG" /* MULTI_AGENT */,
+    name: "Multi-Agent",
+    description: "Inter-agent coordination, messaging, and collaboration",
+    minTier: 4 /* T4_STANDARD */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "identity", "reliability"],
+    subcategories: [
+      { code: "MAG-COM", name: "Communication", description: "Inter-agent message passing" },
+      { code: "MAG-DEL", name: "Delegation", description: "Task delegation between agents" },
+      { code: "MAG-CRD", name: "Coordination", description: "Multi-agent workflow coordination" },
+      { code: "MAG-NEG", name: "Negotiation", description: "Inter-agent negotiation and consensus" }
+    ]
+  },
+  {
+    code: "SWM" /* SWARM */,
+    name: "Swarm",
+    description: "Large-scale agent coordination, topology management, and contagion control",
+    minTier: 6 /* T6_CERTIFIED */,
+    euHighRisk: true,
+    trustDimensions: ["behavioral", "compliance", "reliability", "transparency"],
+    subcategories: [
+      { code: "SWM-TOP", name: "Topology Management", description: "Agent network topology and routing" },
+      { code: "SWM-CON", name: "Contagion Control", description: "Failure spread rate monitoring and containment" },
+      { code: "SWM-SEG", name: "Segment Isolation", description: "Network segment isolation and quarantine" },
+      { code: "SWM-HLT", name: "Health Monitoring", description: "Swarm-wide health and status tracking" }
+    ]
+  },
+  // ---- Safety & Audit ----
+  {
+    code: "SAF" /* SAFETY */,
+    name: "Safety",
+    description: "Content filtering, harm prevention, and safety enforcement",
+    minTier: 3 /* T3_MONITORED */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "reliability", "transparency"],
+    subcategories: [
+      { code: "SAF-FLT", name: "Content Filtering", description: "Input/output content safety filtering" },
+      { code: "SAF-INJ", name: "Injection Detection", description: "Prompt injection and adversarial input detection" },
+      { code: "SAF-BND", name: "Boundary Enforcement", description: "Operational boundary and scope enforcement" },
+      { code: "SAF-KIL", name: "Kill Switch", description: "Emergency halt and containment" }
+    ]
+  },
+  {
+    code: "AUD" /* AUDIT */,
+    name: "Audit",
+    description: "Decision logging, proof chains, and transparency agents",
+    minTier: 3 /* T3_MONITORED */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "transparency", "identity"],
+    subcategories: [
+      { code: "AUD-LOG", name: "Decision Logging", description: "Records all decisions and rationale" },
+      { code: "AUD-PRF", name: "Proof Generation", description: "Generates cryptographic decision proofs" },
+      { code: "AUD-TRC", name: "Traceability", description: "Decision provenance and traceability" },
+      { code: "AUD-RPT", name: "Reporting", description: "Audit report generation and compliance summaries" }
+    ]
+  },
+  {
+    code: "CMP" /* COMPLIANCE */,
+    name: "Compliance",
+    description: "Regulatory compliance monitoring and enforcement",
+    minTier: 4 /* T4_STANDARD */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "transparency", "reliability"],
+    subcategories: [
+      { code: "CMP-REG", name: "Regulatory Monitoring", description: "Monitors regulatory requirements" },
+      { code: "CMP-DPR", name: "Data Protection", description: "GDPR, CCPA, and data privacy compliance" },
+      { code: "CMP-STD", name: "Standards Compliance", description: "ISO, NIST, and industry standard compliance" },
+      { code: "CMP-RPT", name: "Compliance Reporting", description: "Generates compliance reports and attestations" }
+    ]
+  },
+  // ---- Domain-Specific (EU AI Act High-Risk) ----
+  {
+    code: "FIN" /* FINANCE */,
+    name: "Finance",
+    description: "Financial analysis, trading, risk assessment, and compliance",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "reliability", "transparency", "behavioral"],
+    subcategories: [
+      { code: "FIN-TRD", name: "Trading", description: "Automated trading and portfolio management" },
+      { code: "FIN-RSK", name: "Risk Assessment", description: "Financial risk analysis and scoring" },
+      { code: "FIN-AML", name: "Anti-Money Laundering", description: "AML/KYC compliance and monitoring" },
+      { code: "FIN-ADV", name: "Advisory", description: "Financial advice and recommendations" }
+    ]
+  },
+  {
+    code: "HLT" /* HEALTHCARE */,
+    name: "Healthcare",
+    description: "Medical analysis, diagnostics support, and health data processing",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "reliability", "identity", "transparency"],
+    subcategories: [
+      { code: "HLT-DGN", name: "Diagnostics Support", description: "Assists with medical diagnosis" },
+      { code: "HLT-DAT", name: "Health Data Processing", description: "Processes PHI/ePHI data" },
+      { code: "HLT-RES", name: "Medical Research", description: "Clinical research and trial analysis" },
+      { code: "HLT-MON", name: "Patient Monitoring", description: "Continuous patient health monitoring" }
+    ]
+  },
+  {
+    code: "EMP" /* EMPLOYMENT */,
+    name: "Employment",
+    description: "Hiring, HR decisions, performance evaluation, and workforce management",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: true,
+    trustDimensions: ["compliance", "transparency", "behavioral", "identity"],
+    subcategories: [
+      { code: "EMP-HIR", name: "Hiring", description: "Resume screening and candidate evaluation" },
+      { code: "EMP-EVL", name: "Performance Evaluation", description: "Employee performance assessment" },
+      { code: "EMP-WFM", name: "Workforce Management", description: "Scheduling, allocation, and planning" },
+      { code: "EMP-TRN", name: "Training", description: "Employee training and development" }
+    ]
+  },
+  // ---- Creative & Research ----
+  {
+    code: "CRE" /* CREATIVE */,
+    name: "Creative",
+    description: "Content generation, design, and creative production",
+    minTier: 1 /* T1_OBSERVED */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "context"],
+    subcategories: [
+      { code: "CRE-TXT", name: "Text Generation", description: "Copywriting, articles, and text content" },
+      { code: "CRE-IMG", name: "Image Generation", description: "Visual content creation and editing" },
+      { code: "CRE-AUD", name: "Audio Generation", description: "Music, voice, and audio content" },
+      { code: "CRE-VID", name: "Video Generation", description: "Video content creation and editing" }
+    ]
+  },
+  {
+    code: "RES" /* RESEARCH */,
+    name: "Research",
+    description: "Information gathering, literature review, and experimental analysis",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "reliability", "context"],
+    subcategories: [
+      { code: "RES-LIT", name: "Literature Review", description: "Academic and technical literature analysis" },
+      { code: "RES-DAT", name: "Data Collection", description: "Structured data gathering and curation" },
+      { code: "RES-EXP", name: "Experimentation", description: "Experimental design and execution" },
+      { code: "RES-SYN", name: "Synthesis", description: "Research synthesis and meta-analysis" }
+    ]
+  },
+  // ---- Advanced Capabilities ----
+  {
+    code: "SLF" /* SELF_IMPROVEMENT */,
+    name: "Self-Improvement",
+    description: "Self-modification, learning optimization, and capability enhancement",
+    minTier: 7 /* T7_AUTONOMOUS */,
+    euHighRisk: true,
+    trustDimensions: ["behavioral", "compliance", "transparency", "reliability"],
+    subcategories: [
+      { code: "SLF-LRN", name: "Self-Learning", description: "Autonomous learning and adaptation" },
+      { code: "SLF-OPT", name: "Self-Optimization", description: "Performance self-optimization" },
+      { code: "SLF-MOD", name: "Self-Modification", description: "Configuration and behavior self-modification" }
+    ]
+  },
+  {
+    code: "HIF" /* HUMAN_INTERFACE */,
+    name: "Human Interface",
+    description: "Human interaction, communication, and user experience",
+    minTier: 2 /* T2_PROVISIONAL */,
+    euHighRisk: false,
+    trustDimensions: ["behavioral", "context", "identity"],
+    subcategories: [
+      { code: "HIF-CHT", name: "Chat", description: "Conversational user interface" },
+      { code: "HIF-AST", name: "Assistant", description: "Task-oriented personal assistant" },
+      { code: "HIF-TUT", name: "Tutorial", description: "Interactive teaching and guidance" },
+      { code: "HIF-ACC", name: "Accessibility", description: "Accessibility and accommodation support" }
+    ]
+  },
+  {
+    code: "SYS" /* SYSTEM */,
+    name: "System",
+    description: "Infrastructure management, deployment, and system operations",
+    minTier: 5 /* T5_TRUSTED */,
+    euHighRisk: false,
+    trustDimensions: ["compliance", "reliability", "identity"],
+    subcategories: [
+      { code: "SYS-DEP", name: "Deployment", description: "Application deployment and release management" },
+      { code: "SYS-MON", name: "Monitoring", description: "System monitoring and alerting" },
+      { code: "SYS-SEC", name: "Security", description: "Security scanning and incident response" },
+      { code: "SYS-INF", name: "Infrastructure", description: "Infrastructure provisioning and management" }
+    ]
+  }
+];
+function getCARCategory(code) {
+  return CAR_CATEGORIES.find((cat) => cat.code === code);
+}
+function getCARCategoriesForTier(tier) {
+  return CAR_CATEGORIES.filter((cat) => cat.minTier <= tier);
+}
+function getHighRiskCategories() {
+  return CAR_CATEGORIES.filter((cat) => cat.euHighRisk);
+}
+function isCARCategoryAvailable(code, tier) {
+  const cat = getCARCategory(code);
+  return cat !== void 0 && cat.minTier <= tier;
+}
+function getCARCategoryMinTier(code) {
+  return getCARCategory(code)?.minTier;
+}
+function getCARSubcategory(fullCode) {
+  for (const cat of CAR_CATEGORIES) {
+    const sub = cat.subcategories.find((s) => s.code === fullCode);
+    if (sub) return sub;
+  }
+  return void 0;
+}
+function getParentCategory(subcategoryCode) {
+  for (const cat of CAR_CATEGORIES) {
+    if (cat.subcategories.some((s) => s.code === subcategoryCode)) {
+      return cat;
+    }
+  }
+  return void 0;
+}
+function getAllCARCategoryCodes() {
+  return CAR_CATEGORIES.map((cat) => cat.code);
+}
+function getAllCARSubcategoryCodes() {
+  return CAR_CATEGORIES.flatMap(
+    (cat) => cat.subcategories.map((sub) => sub.code)
+  );
+}
+function isValidCARCategory(code) {
+  return CAR_CATEGORIES.some((cat) => cat.code === code);
+}
+function isValidCARSubcategory(code) {
+  return getCARSubcategory(code) !== void 0;
+}
+
 // src/index.ts
-var VERSION = "1.0.0";
-var LAST_UPDATED = "2026-02-04";
+var VERSION = "1.0.2";
+var LAST_UPDATED = "2026-02-16";
 export {
   ACTIVE_THEME,
   AGENTANCHOR_DOMAINS,
@@ -120,6 +432,8 @@ export {
   BASIS_SPEC_VERSION,
   BASIS_VERSIONS,
   CAPABILITIES,
+  CARCategory,
+  CAR_CATEGORIES,
   CAR_SPEC_CURRENT_VERSION,
   CAR_SPEC_VERSIONS,
   COGNIGATE_CURRENT_VERSION,
@@ -161,8 +475,14 @@ export {
   formatErrorMessage,
   formatRateLimit,
   getActiveTheme,
+  getAllCARCategoryCodes,
+  getAllCARSubcategoryCodes,
   getAllCapabilityCodes,
   getAllThemeIds,
+  getCARCategoriesForTier,
+  getCARCategory,
+  getCARCategoryMinTier,
+  getCARSubcategory,
   getCapabilitiesByCategory,
   getCapabilitiesForTier,
   getCapability,
@@ -170,7 +490,9 @@ export {
   getCurrentVersion,
   getErrorByCode,
   getErrorsByCategory,
+  getHighRiskCategories,
   getMinTierForLimits,
+  getParentCategory,
   getProduct,
   getProductsByCategory,
   getProductsByOrganization,
@@ -186,8 +508,11 @@ export {
   getTierName,
   getTierThreshold,
   getVersionDefinition,
+  isCARCategoryAvailable,
   isCapabilityAvailable,
   isUnlimited,
+  isValidCARCategory,
+  isValidCARSubcategory,
   isVersionDeprecated,
   isVersionSupported,
   meetsTierRequirement,

package/dist/products.cjs

@@ -64,7 +64,7 @@ var VORION_PRODUCTS = {
   carId: {
     id: "car-id",
     name: "CAR ID",
-    description: "Categorical Agent Registry - Universal agent identification system",
+    description: "Categorical Agentic Registry - Universal agent identification system",
     category: "open_source" /* OPEN_SOURCE */,
     status: "ga" /* GA */,
     url: "https://carid.vorion.org",

package/dist/products.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @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
+ */
+declare 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"
+}
+declare 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"
+}
+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;
+}
+declare const VORION_PRODUCTS: Record<string, ProductDefinition>;
+declare const AGENTANCHOR_PRODUCTS: Record<string, ProductDefinition>;
+declare const ALL_PRODUCTS: {
+    readonly vorion: Record<string, ProductDefinition>;
+    readonly agentAnchor: Record<string, ProductDefinition>;
+};
+/**
+ * Get a product by its ID
+ */
+declare function getProduct(productId: string): ProductDefinition | undefined;
+/**
+ * Get all products by category
+ */
+declare function getProductsByCategory(category: ProductCategory): ProductDefinition[];
+/**
+ * Get all products by status
+ */
+declare function getProductsByStatus(status: ProductStatus): ProductDefinition[];
+/**
+ * Get all products by organization
+ */
+declare function getProductsByOrganization(org: 'vorion' | 'agentanchor'): ProductDefinition[];
+
+export { AGENTANCHOR_PRODUCTS, ALL_PRODUCTS, ProductCategory, type ProductDefinition, ProductStatus, VORION_PRODUCTS, getProduct, getProductsByCategory, getProductsByOrganization, getProductsByStatus };

package/dist/products.js

@@ -8,7 +8,7 @@ import {
   getProductsByCategory,
   getProductsByOrganization,
   getProductsByStatus
-} from "./chunk-RZQZEF6Q.js";
+} from "./chunk-JOS3AHBL.js";
 export {
   AGENTANCHOR_PRODUCTS,
   ALL_PRODUCTS,