@fulmenhq/tsfulmen 0.1.13 → 0.2.0

package/package.json

@@ -34,8 +34,8 @@
     "vitest": "^2.1.5"
   },
   "engines": {
-    "bun": ">=1.0.0",
-    "node": ">=20.0.0"
+    "bun": "\u003e=1.0.0",
+    "node": "\u003e=20.0.0"
   },
   "exports": {
     ".": {
@@ -94,6 +94,14 @@
       "import": "./dist/schema/index.js",
       "types": "./dist/schema/index.d.ts"
     },
+    "./signals": {
+      "import": "./dist/signals/index.js",
+      "types": "./dist/signals/index.d.ts"
+    },
+    "./similarity": {
+      "import": "./dist/similarity/index.js",
+      "types": "./dist/similarity/index.d.ts"
+    },
     "./telemetry": {
       "import": "./dist/telemetry/index.js",
       "types": "./dist/telemetry/index.d.ts"
@@ -152,23 +160,24 @@
     "dev": "tsx src/index.ts",
     "lint": "make lint",
     "lint:fix": "make fmt",
-    "prepublishOnly": "bun run quality && bun run validate:all && bunx tsx scripts/prepare-wasm-package.ts",
+    "prepublishOnly": "bun run quality \u0026\u0026 bun run validate:all \u0026\u0026 bunx tsx scripts/prepare-wasm-package.ts",
     "quality": "make quality",
     "test": "make test",
     "test:coverage": "make test-coverage",
     "test:watch": "make test-watch",
     "typecheck": "make typecheck",
-    "validate:all": "bun run validate:exports && bun run validate:tsup && bun run validate:source-modules && bun run validate:package && bun run validate:imports && bun run validate:types",
+    "validate:all": "bun run validate:exports \u0026\u0026 bun run validate:tsup \u0026\u0026 bun run validate:source-modules \u0026\u0026 bun run validate:package \u0026\u0026 bun run validate:imports \u0026\u0026 bun run validate:types",
     "validate:exports": "bunx tsx scripts/validate-exports.ts",
     "validate:imports": "bunx tsx scripts/validate-imports.ts",
     "validate:package": "bunx tsx scripts/validate-package-contents.ts",
     "validate:source-modules": "bunx tsx scripts/validate-source-modules.ts",
     "validate:tsup": "bunx tsx scripts/validate-tsup-config.ts",
     "validate:types": "bunx tsx scripts/validate-types.ts",
-    "verify:package": "bunx tsx scripts/verify-published-package.ts",
+    "verify:local": "make verify-local-install",
+    "verify:package": "make verify-published-package",
     "version:sync": "make version-sync"
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.1.13"
+  "version": "0.2.0"
 }

package/schemas/crucible-ts/assessment/v1.0.0/severity-definitions.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/assessment/severity-definitions-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/assessment/severity-definitions-v1.0.0.json",
   "title": "Assessment Severity Definitions",
   "description": "Shared severity definitions for assessment and analysis tooling.",
   "$comment": "Implementations MUST compare severities using severityLevel, not lexical ordering of severityName.",

package/schemas/crucible-ts/config/fulmen-ecosystem/v1.0.0/fulmen-config-paths.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/config/fulmen-ecosystem/fulmen-config-paths-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/config/fulmen-ecosystem/fulmen-config-paths-v1.0.0.json",
   "title": "Fulmen Config Paths",
   "description": "Describes shared configuration directories for Fulmen tools",
   "type": "object",

package/schemas/crucible-ts/config/repository/app-identity/v1.0.0/app-identity.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/config/repository/app-identity/v1.0.0/app-identity.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/config/repository/app-identity/v1.0.0/app-identity.schema.json",
   "title": "Fulmen Application Identity",
   "description": "Application identity metadata for Fulmen ecosystem projects",
   "type": "object",
@@ -29,10 +29,10 @@
         },
         "vendor": {
           "type": "string",
-          "pattern": "^[a-z][a-z0-9]{0,62}[a-z0-9]$",
+          "pattern": "^[a-z0-9]{2,64}$",
           "minLength": 2,
           "maxLength": 64,
-          "description": "Lowercase vendor namespace (no hyphens, alphanumeric only)"
+          "description": "Lowercase vendor namespace (alphanumeric only, no hyphens). Leading digits permitted - vendor is used for filesystem paths and config directories, not language-specific package imports. Examples: 'fulmenhq', '3leaps', '37signals'."
         },
         "env_prefix": {
           "type": "string",

package/schemas/crucible-ts/config/repository/v1.0.0/lifecycle-phase.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/repository/lifecycle-phase-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/repository/lifecycle-phase-v1.0.0.json",
   "title": "Repository Lifecycle Phase",
   "description": "Product lifecycle maturity phase used to drive quality gates, coverage thresholds, and communication posture across Fulmen repositories.",
   "type": "string",

package/schemas/crucible-ts/config/repository-category/codex/v1.0.0/codex-config.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/config/repository-category/codex/v1.0.0/codex-config.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/config/repository-category/codex/v1.0.0/codex-config.schema.json",
   "title": "Codex Configuration Schema",
   "description": "Configuration schema for Fulmen codex templates (documentation sites, schema registries, knowledge hubs)",
   "type": "object",

package/schemas/crucible-ts/config/standards/v1.0.0/adr-adoption-status.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/standards/adr-adoption-status-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/standards/adr-adoption-status-v1.0.0.json",
   "title": "ADR Adoption Status",
   "description": "Per-library adoption status for ecosystem ADRs. Tracks implementation progress across language foundations (gofulmen, pyfulmen, tsfulmen, etc.).",
   "type": "string",

package/schemas/crucible-ts/config/standards/v1.0.0/adr-frontmatter.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/standards/adr-frontmatter-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/standards/adr-frontmatter-v1.0.0.json",
   "title": "ADR Frontmatter Schema",
   "description": "Required frontmatter structure for Architecture Decision Records (ADRs) in the Fulmen ecosystem. Ensures consistency, enables validation, and supports tooling.",
   "type": "object",
@@ -33,7 +33,7 @@
       ]
     },
     "status": {
-      "$ref": "https://schemas.fulmenhq.dev/standards/adr-lifecycle-status-v1.0.0.json",
+      "$ref": "https://schemas.fulmenhq.dev/crucible/standards/adr-lifecycle-status-v1.0.0.json",
       "description": "Current lifecycle status of this ADR. Drives adoption guidance and deprecation warnings."
     },
     "date": {
@@ -164,7 +164,7 @@
       "type": "object",
       "description": "Per-library adoption status tracking. Keys are library names, values are adoption status. Used for ecosystem ADRs only.",
       "additionalProperties": {
-        "$ref": "https://schemas.fulmenhq.dev/standards/adr-adoption-status-v1.0.0.json"
+        "$ref": "https://schemas.fulmenhq.dev/crucible/standards/adr-adoption-status-v1.0.0.json"
       },
       "examples": [
         {

package/schemas/crucible-ts/config/standards/v1.0.0/adr-lifecycle-status.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.fulmenhq.dev/standards/adr-lifecycle-status-v1.0.0.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/standards/adr-lifecycle-status-v1.0.0.json",
   "title": "ADR Lifecycle Status",
   "description": "Lifecycle status for Architecture Decision Records (ADRs) and standards documents. Inspired by ThoughtWorks Technology Radar maturity model, adapted for architectural decision tracking.",
   "type": "string",

package/schemas/crucible-ts/config/sync-keys.schema.yaml

@@ -34,4 +34,18 @@ $defs:
         type: array
         items:
           type: string
+      metadata:
+        type: object
+        description: Optional metadata for sync tooling
+        properties:
+          sourceRepo:
+            type: string
+            description: Source repository URL or 'local' for development references
+          sourcePathBase:
+            type: string
+            description: Base path within source repository for this sync key
+          notes:
+            type: string
+            description: Human-readable notes about usage, constraints, or caveats
+        additionalProperties: true
     additionalProperties: false

package/schemas/crucible-ts/content/ssot-provenance/v1.0.0/ssot-provenance.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/fulmenhq/crucible/schemas/content/ssot-provenance/v1.0.0/ssot-provenance.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/content/ssot-provenance/v1.0.0/ssot-provenance.schema.json",
   "title": "SSOT Sync Provenance Metadata",
   "description": "Aggregate provenance metadata for SSOT sync operations capturing source information for audit trails",
   "type": "object",

package/schemas/crucible-ts/design/README.md

@@ -0,0 +1,159 @@
+# Design System Schemas
+
+Schema definitions for Fulmen design systems. Provides a layered architecture separating semantic vocabulary (core) from implementation-specific patterns (TUI, web).
+
+## Architecture
+
+```
+schemas/design/
+├── core/v1.0.0/           # Semantic vocabulary (shared)
+│   ├── semantic-colors.schema.json
+│   ├── spacing-scale.schema.json
+│   ├── typography-roles.schema.json
+│   └── component-states.schema.json
+├── tui/v1.0.0/            # Terminal UI implementation
+│   ├── theme.schema.json          # Root composition
+│   ├── color-palette.schema.json
+│   ├── typography.schema.json
+│   ├── layout.schema.json
+│   └── component.schema.json
+└── web/v1.0.0/            # (Future) Web implementation
+```
+
+## Core Schemas
+
+Core schemas define **semantic vocabulary** - the language of design - without implementation details. Both TUI and web implementations reference these definitions.
+
+| Schema             | Purpose                                                        |
+| ------------------ | -------------------------------------------------------------- |
+| `semantic-colors`  | Color roles: primary, secondary, success, warning, error, etc. |
+| `spacing-scale`    | Spacing tokens: none, xs, sm, md, lg, xl, etc.                 |
+| `typography-roles` | Text roles: display, headline, body, caption, code, etc.       |
+| `component-states` | UI states: default, hover, focus, active, disabled, etc.       |
+
+## TUI Schemas
+
+Terminal UI schemas implement the core vocabulary for terminal environments with:
+
+- **Color fallback chains**: truecolor → 256-color → 16-color → basic
+- **Character set degradation**: unicode-full → unicode-basic → extended-ascii → ascii
+- **Cell-based layouts**: dimensions in columns/rows
+- **Box drawing**: configurable character sets (rounded, single, double, ascii)
+
+| Schema          | Purpose                                         |
+| --------------- | ----------------------------------------------- |
+| `theme`         | Root composition - aggregates all TUI schemas   |
+| `color-palette` | Terminal colors with capability-based fallbacks |
+| `typography`    | Charset support, glyphs, CJK width handling     |
+| `layout`        | Cell-based dimensions, responsive breakpoints   |
+| `component`     | Widget patterns with state styling              |
+
+## Usage
+
+### Theme Files
+
+Create theme YAML files that reference the TUI theme schema:
+
+```yaml
+$schema: https://schemas.fulmenhq.dev/crucible/design/tui/v1.0.0/theme.schema.json
+version: "1.0.0"
+schema_version: "1.0.0"
+
+metadata:
+  name: "Fulmen Dark"
+  id: "fulmen-dark"
+  description: "Default dark theme for Fulmen TUI applications"
+  dark_mode: true
+
+requirements:
+  min_color_capability: "256"
+  min_charset: "unicode-basic"
+
+colors:
+  version: "1.0.0"
+  name: "fulmen-dark"
+  semantic_colors:
+    primary:
+      role: "primary"
+      foreground:
+        truecolor: "#7AA2F7"
+        ansi256: 111
+        ansi16: "bright-blue"
+  # ...
+```
+
+### Accessing via Helper Libraries
+
+```go
+// Go (gofulmen)
+import "github.com/fulmenhq/crucible"
+
+theme, _ := crucible.DesignRegistry.TUI().Theme("fulmen-dark")
+primaryColor := theme.Colors.SemanticColors.Primary.Foreground.Truecolor
+```
+
+```typescript
+// TypeScript (tsfulmen)
+import { design } from "@fulmenhq/crucible";
+
+const theme = design.tui().theme("fulmen-dark");
+const primaryColor = theme.colors.semanticColors.primary.foreground.truecolor;
+```
+
+## Terminal Capability Detection
+
+TUI themes support graceful degradation based on terminal capabilities:
+
+| Capability    | Detection                     | Fallback Chain                     |
+| ------------- | ----------------------------- | ---------------------------------- |
+| **Color**     | `$COLORTERM`, `$TERM`         | truecolor → 256 → 16 → basic       |
+| **Charset**   | `$LANG`, terminal query       | unicode-full → basic-latin → ascii |
+| **Nerd Font** | User config, detection script | nerd-font → unicode → ascii        |
+
+## WCAG Accessibility
+
+Themes can declare WCAG conformance:
+
+```yaml
+accessibility:
+  wcag_level: "AA"
+  min_contrast_ratio: 4.5
+  focus_visible_required: true
+  color_blind_safe: true
+```
+
+The `wcag_contrast_ratio` field on semantic colors enables automated accessibility checking.
+
+## Examples
+
+Reference themes are available in `examples/design/tui/v1.0.0/themes/`:
+
+- `dark.yaml` - Default dark theme with full capability (WCAG AA)
+- `light.yaml` - Light mode for daytime use (WCAG AA)
+- `high-contrast.yaml` - WCAG AAA compliant high contrast theme
+
+## Roadmap
+
+### v1.0.0 (Current)
+
+- Core semantic vocabulary
+- TUI implementation schemas
+- Reference dark and high-contrast themes
+
+### v1.1.0 (Planned)
+
+- Animation/transition tokens
+- Sound/haptic feedback schemas
+- Theme inheritance/composition
+
+### Future
+
+- Web implementation schemas (`design/web/`)
+- Design token export (Figma, Style Dictionary)
+- Theme marketplace/registry
+
+## Related Documentation
+
+- [Fulmen Ecosystem Guide](../../docs/architecture/fulmen-ecosystem-guide.md)
+- [Schema Normalization Standard](../../docs/standards/schema-normalization.md)
+- [Terminal Catalog](../terminal/v1.0.0/)

package/schemas/crucible-ts/design/core/v1.0.0/component-states.schema.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.fulmenhq.dev/crucible/design/core/v1.0.0/component-states.schema.json",
+  "title": "Component States Vocabulary",
+  "description": "Universal component state definitions for design systems. Implementation-agnostic vocabulary shared across TUI and web contexts.",
+  "type": "object",
+  "$defs": {
+    "interactiveState": {
+      "type": "string",
+      "enum": [
+        "default",
+        "hover",
+        "focus",
+        "focus-visible",
+        "active",
+        "disabled",
+        "loading",
+        "selected",
+        "checked",
+        "indeterminate",
+        "expanded",
+        "collapsed"
+      ],
+      "description": "Interactive component states"
+    },
+    "validationState": {
+      "type": "string",
+      "enum": [
+        "valid",
+        "invalid",
+        "warning",
+        "pending"
+      ],
+      "description": "Form/input validation states"
+    },
+    "feedbackState": {
+      "type": "string",
+      "enum": [
+        "success",
+        "error",
+        "warning",
+        "info",
+        "neutral"
+      ],
+      "description": "User feedback states (for alerts, toasts, etc.)"
+    },
+    "visibilityState": {
+      "type": "string",
+      "enum": [
+        "visible",
+        "hidden",
+        "entering",
+        "exiting"
+      ],
+      "description": "Visibility/transition states"
+    },
+    "stateDefinition": {
+      "type": "object",
+      "description": "A state definition with semantic meaning",
+      "properties": {
+        "state": {
+          "type": "string",
+          "description": "State identifier"
+        },
+        "category": {
+          "type": "string",
+          "enum": [
+            "interactive",
+            "validation",
+            "feedback",
+            "visibility"
+          ],
+          "description": "State category"
+        },
+        "description": {
+          "type": "string",
+          "description": "When this state applies"
+        },
+        "aria_mapping": {
+          "type": "string",
+          "description": "Corresponding ARIA attribute/state"
+        },
+        "visual_indicators": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Required visual indicators for this state"
+        },
+        "can_combine_with": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "States that can coexist with this one"
+        },
+        "mutually_exclusive_with": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "States that cannot coexist with this one"
+        }
+      },
+      "required": [
+        "state",
+        "category"
+      ]
+    },
+    "stateTransition": {
+      "type": "object",
+      "description": "Valid state transition",
+      "properties": {
+        "from": {
+          "type": "string",
+          "description": "Source state"
+        },
+        "to": {
+          "type": "string",
+          "description": "Target state"
+        },
+        "trigger": {
+          "type": "string",
+          "description": "What triggers this transition"
+        },
+        "reversible": {
+          "type": "boolean",
+          "description": "Whether transition can be reversed"
+        }
+      },
+      "required": [
+        "from",
+        "to",
+        "trigger"
+      ]
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[vV]?\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the component states vocabulary"
+    },
+    "interactive_states": {
+      "type": "array",
+      "description": "Interactive state definitions",
+      "items": {
+        "$ref": "#/$defs/stateDefinition"
+      }
+    },
+    "validation_states": {
+      "type": "array",
+      "description": "Validation state definitions",
+      "items": {
+        "$ref": "#/$defs/stateDefinition"
+      }
+    },
+    "feedback_states": {
+      "type": "array",
+      "description": "Feedback state definitions",
+      "items": {
+        "$ref": "#/$defs/stateDefinition"
+      }
+    },
+    "state_transitions": {
+      "type": "array",
+      "description": "Valid state transitions",
+      "items": {
+        "$ref": "#/$defs/stateTransition"
+      }
+    },
+    "accessibility_requirements": {
+      "type": "object",
+      "description": "Accessibility requirements for states",
+      "properties": {
+        "focus_visible_required": {
+          "type": "boolean",
+          "description": "Whether focus-visible indicator is required"
+        },
+        "disabled_announcement": {
+          "type": "boolean",
+          "description": "Whether disabled state must be announced to AT"
+        },
+        "state_change_announcement": {
+          "type": "boolean",
+          "description": "Whether state changes should be announced"
+        }
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Implementation-specific extensions",
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "version"
+  ],
+  "additionalProperties": false
+}