@fulmenhq/tsfulmen 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -14,6 +14,37 @@ _No unreleased changes._
 
 ---
 
+## [0.3.2] - 2026-06-17
+
+> **Patch — app-identity follow-up.** Syncs the Crucible SSOT to v0.4.14 (which adds the formal `metadata.typescript` app-identity section) and promotes tsfulmen's interim custom `metadata.console_scripts` field to it. No code or behavior change; the only published delta is the refreshed bundled `crucible-ts` schemas. Full details in `docs/releases/v0.3.2.md`.
+
+### Changed
+
+- **Synced Crucible SSOT `v0.4.13 → v0.4.14`** (`.goneat/ssot-consumer.yaml` ref). Refreshes the bundled app-identity assets under `schemas/crucible-ts`, `config/crucible-ts`, and `docs/crucible-ts` — the schema now carries the optional `metadata.typescript` object (npm analogue of `metadata.python`: `package_name` + `console_scripts → package.json bin`), plus the `typescript-package` fixture and parity case.
+- **Promoted `.fulmen/app.yaml` to `metadata.typescript`** — the package's three bins (`tsfulmen-schema`, `tsfulmen-signals`, `tsfulmen-prometheus`) move from the interim custom `metadata.console_scripts` field to the first-class `metadata.typescript` section now that Crucible defines it. (`.fulmen/app.yaml` is the repo's own identity and is not in the npm `files` payload.)
+
+## [0.3.1] - 2026-06-15
+
+> **Patch — compile-safety.** Makes tsfulmen safe to embed in `bun build --compile` single-file binaries. Fixes two blockers surfaced downstream by `forge-workhorse-tuvan`: the embedded CLIs shadowed the consumer's own program on import, and an eager WASM load crashed compiled binaries at startup. No breaking changes; Node engine floor unchanged (`>=22.12.0`). Shipped as five reviewed PRs (#13, #14, #15, #16, #17). Full details in `docs/releases/v0.3.1.md`.
+
+### Fixed
+
+- **CLI shadowing under `bun build --compile`** (#15) — the schema/signals/prometheus CLIs self-executed on import via the non-compile-safe guard `import.meta.url === \`file://${process.argv[1]}\``; under `--compile` it fired for non-entry modules, so a compiled consumer importing `@fulmenhq/tsfulmen/schema` ran `tsfulmen-schema` instead of its own program. The library modules no longer parse argv on import; executables moved to dedicated bin entries out of the importable graph.
+- **Compiled-binary WASM `ENOENT` crash** (#14) — bump `@3leaps/string-metrics-wasm` 0.3.8 → 0.3.10, fixing the eager top-level WASM load that `--compile` rewrites but does not embed. Consumers no longer need an `overrides` entry.
+
+### Added
+
+- **Package `bin` commands** `tsfulmen-schema`, `tsfulmen-signals`, `tsfulmen-prometheus` (#15) — the previously internal-only developer CLIs are now exposed as dedicated bin entrypoints (separate from the importable library surface). Additive; no existing API changes.
+- **`.fulmen/app.yaml` app identity** (#16) — declares the package's Fulmen app identity (binary `tsfulmen`, vendor `fulmenhq`, category `sdk`) now that it ships executables; fixes the latent `make validate-app-identity` target. Not shipped in `files` (repo-own identity; must not shadow a consumer's discovery).
+
+### Changed
+
+- **`createPrometheusCLI()` pure factory** (#15) — extracted from the prometheus CLI's `main()`; also delivers the v0.3.0 `buildProgram()` testability follow-up.
+- **CI: GitHub Actions off the Node 20 runtime** (#13) — `checkout`/`cache`/`upload-artifact`/`download-artifact` bumped to node24 majors ahead of GitHub's 2026-06-16 cutover; `setup-bun` normalized; invalid `cache:` input dropped.
+- **CI: compiled-binary smoke guard** (#17) — new build-job step + `make verify-compile-smoke` that packs the tarball, compiles a fixture importing the schema (shadow) and similarity (WASM) surfaces, and asserts the consumer owns its CLI and WASM loads. Both 0.3.0 blockers shipped silently because nothing exercised `--compile`.
+
+---
+
 ## [0.3.0] - 2026-06-06
 
 > **Breaking (majors wave).** Migrates four major dependencies (archiver 8, pino 10, TypeScript 6, commander 15) and **raises the Node engine floor to `>=22.12.0`** (was `>=20.0.0`). No external consumers are affected (the galaxy runs Node 22+). Shipped as four reviewed PRs (#6, #9, #10, #11). Full details in `docs/releases/v0.3.0.md`.

package/config/crucible-ts/repository/app-identity/app-identity.example.yaml

@@ -37,6 +37,14 @@ metadata:
         entry_point: percheron.cli:main
       - name: percheron-validate
         entry_point: percheron.validation:cli
+  # TypeScript/npm packaging metadata (for npm projects — alternative to python)
+  # typescript:
+  #   # npm package name (scoped or unscoped)
+  #   package_name: "@fulmenhq/tsfulmen"
+  #   # Executable bin entries — map to package.json `bin`
+  #   console_scripts:
+  #     - name: tsfulmen-schema
+  #       entry_point: ./dist/bin/schema-cli.js
 
 # Additional custom fields allowed for extensibility
 # custom_field: value

package/config/crucible-ts/repository/app-identity/fixtures/valid/typescript-package.yaml

@@ -0,0 +1,17 @@
+# Valid application identity exercising metadata.typescript (npm packaging)
+app:
+  binary_name: tsfulmen
+  vendor: fulmenhq
+  env_prefix: TSFULMEN_
+  config_name: tsfulmen
+  description: TypeScript Fulmen SDK with developer CLIs
+metadata:
+  license: MIT
+  repository_category: sdk
+  typescript:
+    package_name: "@fulmenhq/tsfulmen"
+    console_scripts:
+      - name: tsfulmen-schema
+        entry_point: ./dist/bin/schema-cli.js
+      - name: tsfulmen-signals
+        entry_point: ./dist/bin/signals-cli.js

package/config/crucible-ts/repository/app-identity/parity-snapshot.json

@@ -73,6 +73,34 @@
           }
         },
         "validation_result": "pass"
+      },
+      "typescript_package": {
+        "input_file": "fixtures/valid/typescript-package.yaml",
+        "expected_output": {
+          "binary_name": "tsfulmen",
+          "vendor": "fulmenhq",
+          "env_prefix": "TSFULMEN_",
+          "config_name": "tsfulmen",
+          "description": "TypeScript Fulmen SDK with developer CLIs",
+          "metadata": {
+            "license": "MIT",
+            "repository_category": "sdk",
+            "typescript": {
+              "package_name": "@fulmenhq/tsfulmen",
+              "console_scripts": [
+                {
+                  "name": "tsfulmen-schema",
+                  "entry_point": "./dist/bin/schema-cli.js"
+                },
+                {
+                  "name": "tsfulmen-signals",
+                  "entry_point": "./dist/bin/signals-cli.js"
+                }
+              ]
+            }
+          }
+        },
+        "validation_result": "pass"
       }
     },
     "invalid": {

package/config/crucible-ts/taxonomy/metrics.yaml

@@ -121,7 +121,7 @@ required:
   - version
   - metrics
 additionalProperties: false
-version: "0.4.13"
+version: "0.4.14"
 defaults:
   histogram_buckets:
     ms_metrics: