@fulmenhq/tsfulmen 0.2.0 → 0.2.3

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/classifiers/v0/dimension-definition.schema.json

@@ -0,0 +1,247 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/classifiers/v0/dimension-definition.schema.json",
+  "title": "Classifier Dimension Definition",
+  "description": "Meta-schema for defining classifier dimensions. Dimensions are orthogonal classification axes that can be applied to datasets, artifacts, or other entities.",
+  "type": "object",
+  "required": ["key", "name", "version", "status", "type", "description"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "format": "uri",
+      "description": "Reference to this meta-schema"
+    },
+    "key": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "minLength": 2,
+      "maxLength": 32,
+      "description": "Machine-readable dimension identifier (lowercase, hyphens allowed)"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "Human-readable dimension name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Semantic version of the dimension definition"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "review", "stable", "deprecated"],
+      "description": "Lifecycle status of the dimension"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["categorical", "sortable", "numeric", "boolean"],
+      "description": "Dimension value type: categorical (unordered), sortable (ordered), numeric (continuous), boolean"
+    },
+    "cardinality": {
+      "type": "string",
+      "enum": ["single", "multiple"],
+      "default": "single",
+      "description": "Whether entities can have one or multiple values for this dimension"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 512,
+      "description": "Purpose and usage of this dimension"
+    },
+    "categorical": {
+      "$ref": "#/$defs/categorical_config",
+      "description": "Configuration for categorical dimensions"
+    },
+    "sortable": {
+      "$ref": "#/$defs/sortable_config",
+      "description": "Configuration for sortable (ordered) dimensions"
+    },
+    "transitions": {
+      "$ref": "#/$defs/transitions",
+      "description": "Valid state transitions between dimension values"
+    },
+    "governance": {
+      "$ref": "#/$defs/governance",
+      "description": "Ownership and review metadata"
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/example"
+      },
+      "description": "Usage examples"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "categorical_config": {
+      "type": "object",
+      "required": ["values"],
+      "properties": {
+        "values": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/categorical_value"
+          },
+          "minItems": 2,
+          "description": "Allowed values for this dimension"
+        },
+        "index_strategy": {
+          "$ref": "#/$defs/index_strategy",
+          "description": "Ordering and indexing configuration"
+        }
+      },
+      "additionalProperties": false
+    },
+    "categorical_value": {
+      "type": "object",
+      "required": ["key", "label", "description", "order"],
+      "properties": {
+        "key": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$",
+          "description": "Machine-readable value identifier"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable display label"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief description of this value"
+        },
+        "order": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Sort order (lower = first)"
+        },
+        "is_none": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this represents a null/none/default state"
+        },
+        "synonyms": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Alternative names that map to this value"
+        }
+      },
+      "additionalProperties": false
+    },
+    "sortable_config": {
+      "type": "object",
+      "required": ["scale", "ordered_values"],
+      "properties": {
+        "scale": {
+          "type": "string",
+          "enum": ["ordinal", "interval", "ratio"],
+          "description": "Measurement scale type"
+        },
+        "order_direction": {
+          "type": "string",
+          "enum": ["asc", "desc"],
+          "default": "asc",
+          "description": "Default sort direction"
+        },
+        "ordered_values": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/categorical_value"
+          },
+          "minItems": 2,
+          "description": "Values in their natural order"
+        }
+      },
+      "additionalProperties": false
+    },
+    "index_strategy": {
+      "type": "object",
+      "properties": {
+        "default_order": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Default sort order of value keys"
+        },
+        "ordinal_mapping": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" },
+          "description": "Numeric ordinal for each value key"
+        },
+        "missing_handling": {
+          "type": "string",
+          "enum": ["use_default", "error", "skip"],
+          "default": "use_default",
+          "description": "How to handle missing values"
+        },
+        "sentinel": {
+          "type": "integer",
+          "description": "Ordinal value for missing/unknown"
+        }
+      },
+      "additionalProperties": false
+    },
+    "transitions": {
+      "type": "object",
+      "properties": {
+        "downgrade": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Valid downgrade paths (e.g., '4-personal->2-blinded')"
+        },
+        "upgrade": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Valid upgrade paths"
+        }
+      },
+      "additionalProperties": false
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "owner": {
+          "type": "string",
+          "description": "Owning team or individual"
+        },
+        "reviewers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Required reviewers for changes"
+        },
+        "review_cycle": {
+          "type": "string",
+          "enum": ["monthly", "quarterly", "semiannual", "annual"],
+          "description": "Review cadence"
+        },
+        "last_updated": {
+          "type": "string",
+          "format": "date",
+          "description": "Last review/update date"
+        }
+      },
+      "additionalProperties": false
+    },
+    "example": {
+      "type": "object",
+      "required": ["value"],
+      "properties": {
+        "dataset": {
+          "type": "string",
+          "description": "Dataset identifier"
+        },
+        "path": {
+          "type": "string",
+          "description": "File path"
+        },
+        "value": {
+          "type": "string",
+          "description": "Dimension value"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/classifiers/v0/sensitivity-level.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/classifiers/v0/sensitivity-level.schema.json",
+  "title": "Data Sensitivity Level",
+  "description": "Standardized sensitivity level enumeration for data classification across 3leaps ecosystems. Levels range from 0 (Public) to 6 (Eyes Only), with UNKNOWN for unclassified data.",
+  "type": "string",
+  "enum": [
+    "unknown",
+    "0-public",
+    "1-confidential",
+    "2-blinded",
+    "3-proprietary",
+    "4-personal",
+    "5-privileged",
+    "6-eyes-only"
+  ],
+  "$defs": {
+    "labels": {
+      "description": "Human-readable labels for each sensitivity level",
+      "type": "object",
+      "properties": {
+        "unknown": { "const": "UNKNOWN" },
+        "0-public": { "const": "0 — Public" },
+        "1-confidential": { "const": "1 — Confidential" },
+        "2-blinded": { "const": "2 — Blinded" },
+        "3-proprietary": { "const": "3 — Proprietary" },
+        "4-personal": { "const": "4 — Personal/Secret" },
+        "5-privileged": { "const": "5 — Privileged/Sysadmin" },
+        "6-eyes-only": { "const": "6 — Eyes Only/Legal Hold" }
+      }
+    },
+    "ordinal_mapping": {
+      "description": "Ordinal values for comparator operations (lte/gte). Higher values indicate more restrictive sensitivity.",
+      "type": "object",
+      "properties": {
+        "unknown": { "const": 0, "description": "Sentinel for unclassified data" },
+        "0-public": { "const": 1 },
+        "1-confidential": { "const": 2 },
+        "2-blinded": { "const": 3 },
+        "3-proprietary": { "const": 4 },
+        "4-personal": { "const": 5 },
+        "5-privileged": { "const": 6 },
+        "6-eyes-only": { "const": 7 }
+      }
+    },
+    "level_descriptions": {
+      "description": "Brief descriptions of each sensitivity level",
+      "type": "object",
+      "properties": {
+        "unknown": { "const": "Unclassified; isolate until classified within 24 hours" },
+        "0-public": { "const": "Public domain or intended for public distribution" },
+        "1-confidential": {
+          "const": "Internal but non-sensitive; NDA-level protection, access logged"
+        },
+        "2-blinded": { "const": "Identities/source obfuscated; verify blinding effectiveness" },
+        "3-proprietary": {
+          "const": "Enterprise-sensitive (MNPI, trade secrets); strict least-privilege"
+        },
+        "4-personal": { "const": "NPPII or secrets; vault-managed only, real-time monitoring" },
+        "5-privileged": { "const": "Platform control data (sysadmin); HSM/air-gapped isolation" },
+        "6-eyes-only": {
+          "const": "Legal hold or extreme restriction; immutable storage, exec authorization"
+        }
+      }
+    }
+  }
+}

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/foundation/v0/error-response.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/foundation/v0/error-response.schema.json",
+  "title": "Error Response",
+  "description": "Standard error response structure for APIs and CLIs across 3leaps ecosystems",
+  "type": "object",
+  "properties": {
+    "code": {
+      "type": "string",
+      "pattern": "^[A-Z][A-Z0-9_]*$",
+      "description": "Machine-readable error code (uppercase with underscores)",
+      "examples": ["VALIDATION_ERROR", "NOT_FOUND", "AUTHENTICATION_FAILED", "RATE_LIMITED"]
+    },
+    "message": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable error message"
+    },
+    "details": {
+      "type": "object",
+      "description": "Additional structured error details (context-specific)",
+      "additionalProperties": true
+    },
+    "path": {
+      "type": "string",
+      "description": "Path to the field or resource that caused the error",
+      "examples": ["$.config.port", "/api/v1/users/123"]
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the error occurred (ISO 8601)"
+    },
+    "requestId": {
+      "type": "string",
+      "description": "Correlation ID for tracing (if applicable)"
+    }
+  },
+  "required": ["code", "message"],
+  "additionalProperties": false,
+  "examples": [
+    {
+      "code": "VALIDATION_ERROR",
+      "message": "Invalid configuration",
+      "details": {
+        "field": "port",
+        "reason": "must be between 1 and 65535"
+      },
+      "path": "$.config.port"
+    },
+    {
+      "code": "NOT_FOUND",
+      "message": "Resource not found",
+      "path": "/api/v1/users/123",
+      "timestamp": "2024-12-28T10:30:00Z",
+      "requestId": "req_abc123"
+    }
+  ]
+}

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/foundation/v0/lifecycle-phases.data.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://schemas.3leaps.dev/foundation/v0/lifecycle-phases.schema.json",
+  "version": "1.0.0",
+  "phases": [
+    {
+      "id": "planned",
+      "order": 0,
+      "label": "Planned",
+      "description": "Repository or component is planned but development has not started. May have placeholder README only.",
+      "badge": {
+        "color": "lightgrey",
+        "url": "https://img.shields.io/badge/lifecycle-planned-lightgrey"
+      },
+      "pr_policy": "none",
+      "stability": "unstable"
+    },
+    {
+      "id": "prototype",
+      "order": 1,
+      "label": "Prototype",
+      "description": "Proof of concept or experimental implementation. Not intended for any use beyond exploration. May be discarded entirely.",
+      "badge": {
+        "color": "yellow",
+        "url": "https://img.shields.io/badge/lifecycle-prototype-yellow"
+      },
+      "pr_policy": "internal",
+      "stability": "unstable"
+    },
+    {
+      "id": "alpha",
+      "order": 2,
+      "label": "Alpha",
+      "description": "Active development with core functionality taking shape. APIs and schemas may change without notice. Not recommended for production. Early feedback welcome.",
+      "badge": {
+        "color": "orange",
+        "url": "https://img.shields.io/badge/lifecycle-alpha-orange"
+      },
+      "pr_policy": "invited",
+      "stability": "unstable"
+    },
+    {
+      "id": "beta",
+      "order": 3,
+      "label": "Beta",
+      "description": "Feature complete and stabilizing. APIs may still change but with deprecation notices. Suitable for non-critical use. Community contributions welcome.",
+      "badge": {
+        "color": "blue",
+        "url": "https://img.shields.io/badge/lifecycle-beta-blue"
+      },
+      "pr_policy": "community",
+      "stability": "stabilizing"
+    },
+    {
+      "id": "stable",
+      "order": 4,
+      "label": "Stable",
+      "description": "Production ready. APIs follow semantic versioning. Breaking changes only in major versions with migration guides.",
+      "badge": {
+        "color": "green",
+        "url": "https://img.shields.io/badge/lifecycle-stable-green"
+      },
+      "pr_policy": "community",
+      "stability": "stable"
+    },
+    {
+      "id": "maintenance",
+      "order": 5,
+      "label": "Maintenance",
+      "description": "No new features planned. Bug fixes and security patches only. Consider migration to successor if available.",
+      "badge": {
+        "color": "yellowgreen",
+        "url": "https://img.shields.io/badge/lifecycle-maintenance-yellowgreen"
+      },
+      "pr_policy": "critical-only",
+      "stability": "frozen"
+    },
+    {
+      "id": "deprecated",
+      "order": 6,
+      "label": "Deprecated",
+      "description": "Being phased out. No new PRs accepted. Users should migrate to recommended alternative.",
+      "badge": {
+        "color": "red",
+        "url": "https://img.shields.io/badge/lifecycle-deprecated-red"
+      },
+      "pr_policy": "none",
+      "stability": "frozen"
+    },
+    {
+      "id": "archived",
+      "order": 7,
+      "label": "Archived",
+      "description": "No longer maintained. Repository is read-only for historical reference. No support provided.",
+      "badge": {
+        "color": "lightgrey",
+        "url": "https://img.shields.io/badge/lifecycle-archived-lightgrey"
+      },
+      "pr_policy": "none",
+      "stability": "frozen"
+    }
+  ]
+}

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/foundation/v0/lifecycle-phases.schema.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/foundation/v0/lifecycle-phases.schema.json",
+  "title": "Lifecycle Phases",
+  "description": "Schema defining repository and component lifecycle phases with canonical ordering",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "const": "https://schemas.3leaps.dev/foundation/v0/lifecycle-phases.schema.json"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Schema version (SemVer)"
+    },
+    "phases": {
+      "type": "array",
+      "description": "Ordered list of lifecycle phases (index determines progression order)",
+      "items": {
+        "$ref": "#/$defs/phase"
+      },
+      "minItems": 1
+    }
+  },
+  "required": ["version", "phases"],
+  "additionalProperties": false,
+  "$defs": {
+    "phase": {
+      "type": "object",
+      "description": "A lifecycle phase definition",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Phase identifier (lowercase, used in LIFECYCLE_PHASE file)"
+        },
+        "order": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Explicit ordering for phase progression (0 = earliest)"
+        },
+        "label": {
+          "type": "string",
+          "description": "Human-readable label"
+        },
+        "description": {
+          "type": "string",
+          "description": "Detailed description of what this phase means"
+        },
+        "badge": {
+          "$ref": "#/$defs/badge",
+          "description": "Shields.io badge configuration"
+        },
+        "pr_policy": {
+          "type": "string",
+          "enum": ["none", "internal", "invited", "community", "critical-only"],
+          "description": "Pull request acceptance policy"
+        },
+        "stability": {
+          "type": "string",
+          "enum": ["unstable", "stabilizing", "stable", "frozen"],
+          "description": "API/schema stability expectation"
+        }
+      },
+      "required": ["id", "order", "label", "description", "badge", "pr_policy", "stability"],
+      "additionalProperties": false
+    },
+    "badge": {
+      "type": "object",
+      "description": "Shields.io badge configuration",
+      "properties": {
+        "color": {
+          "type": "string",
+          "description": "Badge color (shields.io color name or hex)"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Pre-built badge URL"
+        }
+      },
+      "required": ["color", "url"],
+      "additionalProperties": false
+    },
+    "phase_id": {
+      "type": "string",
+      "enum": [
+        "planned",
+        "prototype",
+        "alpha",
+        "beta",
+        "stable",
+        "maintenance",
+        "deprecated",
+        "archived"
+      ],
+      "description": "Valid phase identifier"
+    }
+  }
+}

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/foundation/v0/release-phase.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/foundation/v0/release-phase.schema.json",
+  "title": "Release Phase",
+  "description": "Release cadence phase for distribution pipelines and policy gating. Tracks current deployment cycle state of a repository branch, complementing lifecycle-phases which tracks project maturity.",
+  "type": "string",
+  "enum": ["dev", "rc", "ga", "hotfix"],
+  "examples": ["dev", "rc", "ga"],
+  "$defs": {
+    "phase_descriptions": {
+      "dev": "Active development branch. CI runs tests but artifacts are not published to release channels.",
+      "rc": "Release candidate. Feature-frozen, undergoing final validation before GA. Artifacts may be published to pre-release channels.",
+      "ga": "General availability. Production-ready release. Artifacts published to stable release channels.",
+      "hotfix": "Urgent production fix. Bypasses normal release cadence for critical security or stability patches."
+    }
+  },
+  "$comment": "Drives CI thresholds, artifact publishing, and policy gates. Unlike lifecycle-phases (project maturity), release-phase describes branch/tag state in the release pipeline."
+}