@fulmenhq/tsfulmen 0.2.2 → 0.2.4

package/dist/types-Dv5TERCM.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Application Identity Types
+ *
+ * TypeScript interfaces matching the Crucible app-identity schema v1.0.0
+ */
+/**
+ * Repository category taxonomy from Fulmen standards
+ */
+type RepositoryCategory = "cli" | "workhorse" | "service" | "library" | "pipeline" | "codex" | "sdk";
+/**
+ * Python-specific packaging metadata
+ * Field names use snake_case to match Crucible schema
+ */
+interface PythonMetadata {
+    readonly distribution_name?: string;
+    readonly package_name?: string;
+    readonly console_scripts?: ReadonlyArray<{
+        readonly name: string;
+        readonly entry_point: string;
+    }>;
+}
+/**
+ * Required application identity fields
+ *
+ * All fields are readonly to enforce immutability
+ * Field names use snake_case to match Crucible schema
+ */
+interface AppIdentity {
+    /**
+     * Lowercase kebab-case binary/executable name
+     * Pattern: ^[a-z][a-z0-9-]{0,62}[a-z0-9]$
+     */
+    readonly binary_name: string;
+    /**
+     * Lowercase alphanumeric vendor namespace (no hyphens)
+     * Pattern: ^[a-z][a-z0-9]{0,62}[a-z0-9]$
+     */
+    readonly vendor: string;
+    /**
+     * Uppercase environment variable prefix (must end with _)
+     * Pattern: ^[A-Z][A-Z0-9_]*_$
+     */
+    readonly env_prefix: string;
+    /**
+     * Filesystem-safe config directory name
+     * Pattern: ^[a-z][a-z0-9-]{0,62}[a-z0-9]$
+     */
+    readonly config_name: string;
+    /**
+     * One-line application description (10-200 chars)
+     */
+    readonly description: string;
+}
+/**
+ * Optional metadata fields
+ *
+ * Additional properties are allowed for extensibility
+ * Field names use snake_case to match Crucible schema
+ */
+interface IdentityMetadata {
+    readonly project_url?: string;
+    readonly support_email?: string;
+    readonly license?: string;
+    readonly repository_category?: RepositoryCategory;
+    readonly telemetry_namespace?: string;
+    readonly registry_id?: string;
+    readonly python?: PythonMetadata;
+    readonly [key: string]: unknown;
+}
+/**
+ * Complete application identity document
+ */
+interface Identity {
+    readonly app: AppIdentity;
+    readonly metadata?: IdentityMetadata;
+}
+/**
+ * Options for loading identity
+ */
+interface LoadIdentityOptions {
+    /**
+     * Explicit path override
+     * Highest priority in discovery algorithm
+     */
+    readonly path?: string;
+    /**
+     * Test injection - bypass filesystem and discovery
+     * Never cached
+     */
+    readonly identity?: Identity;
+    /**
+     * Starting directory for ancestor search
+     * Defaults to process.cwd()
+     */
+    readonly startDir?: string;
+    /**
+     * Force reload, bypass cache
+     * Useful for testing cache behavior
+     */
+    readonly skipCache?: boolean;
+    /**
+     * Skip schema validation (dangerous)
+     * Only use for testing or when identity is pre-validated
+     */
+    readonly skipValidation?: boolean;
+}
+
+export type { AppIdentity as A, Identity as I, LoadIdentityOptions as L, PythonMetadata as P, RepositoryCategory as R, IdentityMetadata as a };

package/package.json

@@ -24,15 +24,15 @@
     "@types/node": "^22.9.0",
     "@types/picomatch": "^4.0.2",
     "@types/unzipper": "^0.10.11",
-    "@vitest/coverage-v8": "^2.1.5",
-    "@vitest/ui": "^2.1.5",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
     "fastify": "^5.2.0",
     "prettier": "^3.6.2",
     "prom-client": "^15.1.3",
     "tsup": "^8.3.5",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.5"
+    "vitest": "^4.0.18"
   },
   "engines": {
     "bun": "\u003e=1.0.0",
@@ -165,7 +165,7 @@
     "dev": "tsx src/index.ts",
     "lint": "make lint",
     "lint:fix": "make fmt",
-    "prepublishOnly": "bun run quality \u0026\u0026 bun run validate:all \u0026\u0026 bunx tsx scripts/prepare-wasm-package.ts",
+    "prepublishOnly": "bunx tsx scripts/release-guard-prepublish.ts \u0026\u0026 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",
@@ -184,5 +184,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.2.2"
+  "version": "0.2.4"
 }