@fulmenhq/tsfulmen 0.1.13 → 0.2.0

package/schemas/crucible-ts/taxonomy/fixture/v1.0.0/fixture-catalog.schema.json

@@ -0,0 +1,166 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/fixture/v1.0.0/fixture-catalog.schema.json",
+  "title": "Fixture Catalog Schema",
+  "description": "Schema for the Fulmen fixture catalog registry. Defines fixture names, categories, variants, and i18n metadata.",
+  "type": "object",
+  "required": [
+    "version",
+    "fixtures"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Catalog schema version (semver)"
+    },
+    "fixtures": {
+      "type": "object",
+      "description": "Map of fixture names to their definitions",
+      "additionalProperties": {
+        "$ref": "#/$defs/fixture"
+      },
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9]{1,20}$",
+        "description": "Fixture name: ASCII lowercase, starts with letter, 2-21 chars"
+      }
+    }
+  },
+  "$defs": {
+    "fixture": {
+      "type": "object",
+      "required": [
+        "category",
+        "mode",
+        "default_lang",
+        "summary",
+        "variants"
+      ],
+      "properties": {
+        "category": {
+          "type": "string",
+          "enum": [
+            "proving",
+            "utility",
+            "chaos"
+          ],
+          "description": "Behavioral category of the fixture"
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "server",
+            "client",
+            "datastore",
+            "identity"
+          ],
+          "description": "Fixture mode (identity planned for v0.4.3)"
+        },
+        "default_lang": {
+          "type": "string",
+          "pattern": "^[a-z]{2}$",
+          "description": "ISO 639-1 language code for primary language of summary/descriptions"
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 200,
+          "description": "Brief description in default_lang"
+        },
+        "summary_i18n": {
+          "type": "object",
+          "description": "Translations of summary (keyed by ISO 639-1 code, excludes default_lang)",
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 200
+          },
+          "propertyNames": {
+            "pattern": "^[a-z]{2}$"
+          }
+        },
+        "aliases": {
+          "type": "array",
+          "description": "Alternative names (UTF-8), typo corrections, i18n nicknames",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 50
+          },
+          "uniqueItems": true
+        },
+        "variants": {
+          "type": "object",
+          "description": "Map of variant codes to their definitions",
+          "additionalProperties": {
+            "$ref": "#/$defs/variant"
+          },
+          "propertyNames": {
+            "pattern": "^[0-9]{3}$",
+            "description": "Variant code: 3-digit zero-padded (001-999, 000 reserved)"
+          },
+          "minProperties": 1
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "active",
+            "planned",
+            "deprecated"
+          ],
+          "default": "active",
+          "description": "Lifecycle status of the fixture"
+        }
+      },
+      "additionalProperties": false
+    },
+    "variant": {
+      "type": "object",
+      "required": [
+        "name",
+        "description"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]{0,30}$",
+          "description": "Short variant identifier (ASCII, kebab-case)"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 500,
+          "description": "Description in fixture's default_lang"
+        },
+        "description_i18n": {
+          "type": "object",
+          "description": "Translations of description (keyed by ISO 639-1 code)",
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 500
+          },
+          "propertyNames": {
+            "pattern": "^[a-z]{2}$"
+          }
+        },
+        "status": {
+          "type": "string",
+          "enum": [
+            "active",
+            "planned",
+            "deprecated"
+          ],
+          "default": "active",
+          "description": "Lifecycle status of the variant"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/crucible-ts/taxonomy/language/v1.0.0/language-key.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/taxonomy/language/v1.0.0/language-key.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/language/v1.0.0/language-key.schema.json",
   "title": "Fulmen Language Key",
   "description": "Enum of canonical Fulmen helper language identifiers",
   "type": "string",

package/schemas/crucible-ts/taxonomy/language/v1.0.0/language-metadata.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/taxonomy/language/v1.0.0/language-metadata.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/language/v1.0.0/language-metadata.schema.json",
   "title": "Fulmen Language Metadata",
   "description": "Metadata object describing Fulmen helper language support status",
   "type": "object",

package/schemas/crucible-ts/taxonomy/library/foundry-catalogs/v1.1.0/catalog-entry.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/library/foundry-catalogs/v1.1.0/catalog-entry.schema.json",
+  "title": "Fulmen Foundry Catalog Entry",
+  "description": "Schema for individual catalog entries in the foundry reference data registry. v1.1.0 adds weight classification, default_inclusion, and feature_group for library feature gates.",
+  "type": "object",
+  "required": [
+    "catalog_name",
+    "description",
+    "schema_path",
+    "config_path",
+    "format",
+    "status",
+    "added_version",
+    "weight",
+    "default_inclusion",
+    "feature_group"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "catalog_name": {
+      "type": "string",
+      "description": "Unique identifier for the catalog (lowercase, hyphenated)",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "examples": [
+        "countries",
+        "http-statuses",
+        "exit-codes",
+        "signals"
+      ]
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of catalog contents",
+      "minLength": 10
+    },
+    "schema_path": {
+      "type": "string",
+      "description": "Path to JSON Schema for catalog entries",
+      "pattern": "^schemas/"
+    },
+    "config_path": {
+      "type": "string",
+      "description": "Path to YAML catalog data file",
+      "pattern": "^config/"
+    },
+    "format": {
+      "type": "string",
+      "enum": [
+        "yaml",
+        "json"
+      ],
+      "description": "Data file format"
+    },
+    "weight": {
+      "type": "string",
+      "enum": [
+        "light",
+        "heavy"
+      ],
+      "default": "light",
+      "description": "Dependency footprint for consuming this catalog. light = serde-class only; heavy = requires regex, glob, or other significant deps"
+    },
+    "default_inclusion": {
+      "type": "boolean",
+      "default": true,
+      "description": "Whether catalog is included in default/standard builds. false = opt-in only"
+    },
+    "feature_group": {
+      "type": "string",
+      "description": "Feature gate group for library implementations (e.g., foundry-core, foundry-patterns)",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "examples": [
+        "foundry-core",
+        "foundry-patterns",
+        "foundry-mime"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "active",
+        "deprecated",
+        "experimental"
+      ],
+      "description": "Current lifecycle status of the catalog"
+    },
+    "added_version": {
+      "type": "string",
+      "description": "Crucible version when catalog was added",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "notes": {
+      "type": "string",
+      "description": "Additional implementation notes or guidance"
+    }
+  }
+}

package/schemas/crucible-ts/taxonomy/library/fulencode/detection-confidence/v1.0.0/levels.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/taxonomy/library/fulencode/detection-confidence-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/library/fulencode/detection-confidence-v1.0.0.json",
   "title": "Detection Confidence Taxonomy Schema",
   "description": "Schema for encoding detection confidence levels taxonomy",
   "type": "object",

package/schemas/crucible-ts/taxonomy/library/fulencode/encoding-families/v1.0.0/families.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/taxonomy/library/fulencode/encoding-families-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/library/fulencode/encoding-families-v1.0.0.json",
   "title": "Encoding Families Taxonomy Schema",
   "description": "Schema for encoding families taxonomy defining supported encodings",
   "type": "object",

package/schemas/crucible-ts/taxonomy/library/fulencode/normalization-profiles/v1.0.0/profiles.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/taxonomy/library/fulencode/normalization-profiles-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/library/fulencode/normalization-profiles-v1.0.0.json",
   "title": "Normalization Profiles Taxonomy Schema",
   "description": "Schema for Unicode normalization profiles taxonomy",
   "type": "object",

package/schemas/crucible-ts/taxonomy/library/fulhash/algorithms/v1.0.0/algorithms.yaml

@@ -0,0 +1,16 @@
+version: "1.0.0"
+last_updated: "2025-11-21"
+description: "Supported hashing algorithms for FulHash"
+algorithms:
+  - id: xxh3-128
+    name: XXH3 (128-bit)
+    description: "Fast non-cryptographic hash (default). Excellent collision resistance, extremely high throughput (50GB/s+)."
+  - id: sha256
+    name: SHA-256
+    description: "Cryptographic security standard. Resistant to intentional collisions. Use for security verification."
+  - id: crc32
+    name: CRC-32 (IEEE)
+    description: "32-bit Cyclic Redundancy Check. Standard for GZIP/ZIP/PNG legacy format interoperability."
+  - id: crc32c
+    name: CRC-32C (Castagnoli)
+    description: "32-bit CRC (Castagnoli). HW accelerated (SSE4.2/ARMv8). Use for cloud storage (GCS, AWS) and networking."

package/schemas/crucible-ts/taxonomy/library/modules/v1.0.0/module-entry.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://fulmenhq.dev/schemas/taxonomy/library/modules/v1.0.0/module-entry.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/taxonomy/library/modules/v1.0.0/module-entry.schema.json",
   "title": "Fulmen Helper Library Module Entry",
   "description": "Schema for individual module entries in the helper library module registry",
   "type": "object",