@fulmenhq/tsfulmen 0.2.7 → 0.2.8

package/package.json

@@ -2,36 +2,36 @@
   "author": "3 Leaps, LLC",
   "dependencies": {
     "@3leaps/string-metrics-wasm": "0.3.8",
-    "ajv": "^8.17.1",
+    "ajv": "^8.18.0",
     "ajv-draft-04": "^1.0.0",
     "ajv-formats": "^3.0.1",
     "archiver": "^7.0.1",
-    "commander": "^14.0.1",
+    "commander": "^14.0.3",
     "fast-glob": "^3.3.3",
     "hash-wasm": "^4.12.0",
     "picomatch": "^4.0.3",
     "pino": "^9.5.0",
     "tar-stream": "^3.1.7",
     "unzipper": "^0.12.3",
-    "yaml": "^2.6.1"
+    "yaml": "^2.8.2"
   },
   "description": "TypeScript Fulmen helper library - ergonomic access to Crucible SSOT and core utilities",
   "devDependencies": {
-    "@biomejs/biome": "^2.2.5",
-    "@types/archiver": "^6.0.2",
-    "@types/bun": "^1.1.12",
-    "@types/express": "^5.0.0",
-    "@types/node": "^22.9.0",
+    "@biomejs/biome": "^2.4.3",
+    "@types/archiver": "^7.0.0",
+    "@types/bun": "^1.3.9",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.3.0",
     "@types/picomatch": "^4.0.2",
     "@types/unzipper": "^0.10.11",
     "@vitest/coverage-v8": "^4.0.18",
     "@vitest/ui": "^4.0.18",
-    "fastify": "^5.2.0",
-    "prettier": "^3.6.2",
+    "fastify": "^5.7.4",
+    "prettier": "^3.8.1",
     "prom-client": "^15.1.3",
-    "tsup": "^8.3.5",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.2",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
   "engines": {
@@ -184,5 +184,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.2.7"
+  "version": "0.2.8"
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/PROVENANCE.md

@@ -7,32 +7,31 @@
 | Field      | Value                                      |
 | ---------- | ------------------------------------------ |
 | Repository | https://github.com/3leaps/crucible         |
-| Tag        | v0.1.4                                   |
-| Commit     | 415cec1e5931d091252f91209f6e0456838c6a22 |
-| Date       | 2026-01-22                               |
+| Tag        | v0.1.12                                  |
+| Commit     | 96a17853ee48446f7740d61a518fcfcba20ae444 |
+| Date       | 2026-02-18                               |
 | Synced By  | devlead (Claude Opus 4.5 via Claude Code)  |
 
 ## Structure
 
 ```
 schemas/upstream/3leaps/crucible/
-├── schemas/
-│   ├── agentic/v0/       # Role prompt schema (MANUAL)
-│   ├── ailink/v0/        # Prompt/response schemas
-│   ├── classifiers/v0/   # Dimension meta-schemas
-│   └── foundation/v0/    # Type primitives, error response
-├── config/
-│   └── classifiers/      # Dimension definitions
-├── docs/
-│   ├── standards/        # Classification standards
-│   └── catalog/          # Classifier catalog
-└── PROVENANCE.md
+ ├── schemas/
+ │   ├── classifiers/v0/   # Dimension meta-schemas
+ │   ├── foundation/v0/    # Type primitives, error response
+ │   ├── ailink/v0/        # Prompt/response schemas
+ │   └── agentic/v0/       # Role prompt schemas
+ ├── config/
+ │   └── classifiers/      # Dimension definitions
+ ├── docs/
+ │   ├── standards/        # Classification standards
+ │   └── catalog/          # Classifier catalog
+ └── PROVENANCE.md
 ```
 
 ## Files Synced
 
-- **26 files** auto-synced via `3leaps-crucible-upstream-pull.ts`
-- **1 file** manually synced: `schemas/agentic/v0/role-prompt.schema.json`
+28 files from 3leaps/crucible
 
 ## Canonical URLs
 
@@ -41,13 +40,15 @@ These schemas are canonically hosted at:
 - `https://schemas.3leaps.dev/classifiers/v0/*.json`
 - `https://schemas.3leaps.dev/foundation/v0/*.json`
 - `https://schemas.3leaps.dev/ailink/v0/*.json`
+- `https://schemas.3leaps.dev/agentic/v0/*.json`
 
-## Manual Sync Items
+## Excluded (Manual Sync)
 
-The following are NOT auto-synced - they require manual review for fulmenhq-specific customization:
+The following are NOT synced by this script:
 
-- `schemas/agentic/v0/role-prompt.schema.json` - Present, manually synced
-- `config/agentic/` - Not vendored (fulmenhq maintains its own role definitions)
+- `config/agentic/` - Role definitions
+
+These are synced manually as they require review for fulmenhq-specific customization.
 
 ## Refresh
 

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/access-tier.dimension.json

@@ -93,11 +93,29 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "dataset": "unreviewed-upload", "value": "unknown" },
-    { "dataset": "public-api-docs", "value": "public" },
-    { "dataset": "internal-runbooks", "value": "internal" },
-    { "dataset": "project-roadmap", "value": "restricted" },
-    { "dataset": "security-audit-findings", "value": "privileged" },
-    { "dataset": "legal-discovery-materials", "value": "eyes-only" }
+    {
+      "dataset": "unreviewed-upload",
+      "value": "unknown"
+    },
+    {
+      "dataset": "public-api-docs",
+      "value": "public"
+    },
+    {
+      "dataset": "internal-runbooks",
+      "value": "internal"
+    },
+    {
+      "dataset": "project-roadmap",
+      "value": "restricted"
+    },
+    {
+      "dataset": "security-audit-findings",
+      "value": "privileged"
+    },
+    {
+      "dataset": "legal-discovery-materials",
+      "value": "eyes-only"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/retention-lifecycle.dimension.json

@@ -93,11 +93,29 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "dataset": "new-data-source", "value": "unknown" },
-    { "dataset": "session-cache", "value": "transient" },
-    { "dataset": "debug-logs", "value": "short" },
-    { "dataset": "transaction-history", "value": "standard" },
-    { "dataset": "audit-records", "value": "long" },
-    { "dataset": "litigation-evidence", "value": "legal-hold" }
+    {
+      "dataset": "new-data-source",
+      "value": "unknown"
+    },
+    {
+      "dataset": "session-cache",
+      "value": "transient"
+    },
+    {
+      "dataset": "debug-logs",
+      "value": "short"
+    },
+    {
+      "dataset": "transaction-history",
+      "value": "standard"
+    },
+    {
+      "dataset": "audit-records",
+      "value": "long"
+    },
+    {
+      "dataset": "litigation-evidence",
+      "value": "legal-hold"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/schema-stability.dimension.json

@@ -91,10 +91,25 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "path": "schemas/new-feature/", "value": "unknown" },
-    { "path": "schemas/agentic/v0/", "value": "experimental" },
-    { "path": "schemas/foundation/v1/", "value": "stable" },
-    { "dataset": "api-v2-endpoints", "value": "evolving" },
-    { "dataset": "api-v1-endpoints", "value": "deprecated" }
+    {
+      "path": "schemas/new-feature/",
+      "value": "unknown"
+    },
+    {
+      "path": "schemas/agentic/v0/",
+      "value": "experimental"
+    },
+    {
+      "path": "schemas/foundation/v1/",
+      "value": "stable"
+    },
+    {
+      "dataset": "api-v2-endpoints",
+      "value": "evolving"
+    },
+    {
+      "dataset": "api-v1-endpoints",
+      "value": "deprecated"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/sensitivity.dimension.json

@@ -121,10 +121,25 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "dataset": "retail-pos-transactions", "value": "0-public" },
-    { "dataset": "proxy-session-logs", "value": "2-blinded" },
-    { "dataset": "api-keys-inventory", "value": "4-personal" },
-    { "dataset": "credential-dumps", "value": "5-privileged" },
-    { "dataset": "security-breach-evidence", "value": "6-eyes-only" }
+    {
+      "dataset": "retail-pos-transactions",
+      "value": "0-public"
+    },
+    {
+      "dataset": "proxy-session-logs",
+      "value": "2-blinded"
+    },
+    {
+      "dataset": "api-keys-inventory",
+      "value": "4-personal"
+    },
+    {
+      "dataset": "credential-dumps",
+      "value": "5-privileged"
+    },
+    {
+      "dataset": "security-breach-evidence",
+      "value": "6-eyes-only"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/velocity-mode.dimension.json

@@ -70,10 +70,25 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "dataset": "new-pipeline", "value": "unknown" },
-    { "dataset": "daily-etl-jobs", "value": "batch" },
-    { "dataset": "dashboard-metrics", "value": "micro-batch" },
-    { "dataset": "fraud-detection", "value": "streaming" },
-    { "dataset": "analytics-platform", "value": "hybrid" }
+    {
+      "dataset": "new-pipeline",
+      "value": "unknown"
+    },
+    {
+      "dataset": "daily-etl-jobs",
+      "value": "batch"
+    },
+    {
+      "dataset": "dashboard-metrics",
+      "value": "micro-batch"
+    },
+    {
+      "dataset": "fraud-detection",
+      "value": "streaming"
+    },
+    {
+      "dataset": "analytics-platform",
+      "value": "hybrid"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/volatility.dimension.json

@@ -62,11 +62,29 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "dataset": "newly-ingested-feed", "value": "unknown" },
-    { "dataset": "retail-pos-transactions", "value": "daily" },
-    { "dataset": "network-telemetry", "value": "streaming" },
-    { "dataset": "product-catalog", "value": "weekly" },
-    { "dataset": "agentic-role-definitions", "value": "static" },
-    { "dataset": "api-rate-limits", "value": "hourly" }
+    {
+      "dataset": "newly-ingested-feed",
+      "value": "unknown"
+    },
+    {
+      "dataset": "retail-pos-transactions",
+      "value": "daily"
+    },
+    {
+      "dataset": "network-telemetry",
+      "value": "streaming"
+    },
+    {
+      "dataset": "product-catalog",
+      "value": "weekly"
+    },
+    {
+      "dataset": "agentic-role-definitions",
+      "value": "static"
+    },
+    {
+      "dataset": "api-rate-limits",
+      "value": "hourly"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/config/classifiers/dimensions/volume-tier.dimension.json

@@ -56,11 +56,29 @@
     "last_updated": "2026-01-22"
   },
   "examples": [
-    { "dataset": "new-data-feed", "value": "unknown" },
-    { "dataset": "test-fixtures", "value": "tiny" },
-    { "dataset": "product-catalog", "value": "small" },
-    { "dataset": "transaction-history", "value": "medium" },
-    { "dataset": "event-telemetry", "value": "large" },
-    { "dataset": "global-clickstream", "value": "massive" }
+    {
+      "dataset": "new-data-feed",
+      "value": "unknown"
+    },
+    {
+      "dataset": "test-fixtures",
+      "value": "tiny"
+    },
+    {
+      "dataset": "product-catalog",
+      "value": "small"
+    },
+    {
+      "dataset": "transaction-history",
+      "value": "medium"
+    },
+    {
+      "dataset": "event-telemetry",
+      "value": "large"
+    },
+    {
+      "dataset": "global-clickstream",
+      "value": "massive"
+    }
   ]
 }

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/agentic/v0/README.md

@@ -0,0 +1,87 @@
+# Agentic Schemas v0
+
+Schemas for AI coding agent collaboration.
+
+**Status**: Unstable (v0) - breaking changes may occur without notice.
+
+## Schemas
+
+| Schema                    | Purpose                            |
+| ------------------------- | ---------------------------------- |
+| `role-prompt.schema.json` | Role prompt frontmatter validation |
+
+## Usage
+
+### Role Prompts
+
+Role prompts define how AI coding assistants operate within repositories. They use YAML frontmatter validated against `role-prompt.schema.json`:
+
+```yaml
+---
+slug: devlead
+name: Development Lead
+description: Architecture, implementation, and code review
+version: 1.0.0
+author: entarch
+status: approved
+category: agentic
+tags: [role, implementation, architecture]
+---
+
+# Role: devlead
+
+One-line description.
+
+## Context
+When to use this role...
+
+## Scope
+- What this role covers
+- Boundaries of responsibility
+
+## Mindset
+Focus on:
+- Key questions to ask
+- Perspective to maintain
+
+## Responsibilities
+- Specific duties
+- Quality expectations
+
+## Escalates To
+- When to escalate
+- Who to escalate to
+
+## Does Not
+- Explicit exclusions
+- Out-of-scope items
+
+## Examples
+Commit examples, checklists...
+```
+
+### Required Body Sections
+
+By convention (not schema-enforced), role prompts should include:
+
+| Section          | Required    | Purpose                                  |
+| ---------------- | ----------- | ---------------------------------------- |
+| Context          | Recommended | When to use this role                    |
+| Scope            | Yes         | What this role covers                    |
+| Mindset          | Recommended | Context engineering for AI effectiveness |
+| Responsibilities | Yes         | Specific duties and expectations         |
+| Escalates To     | Yes         | When and who to hand off to              |
+| Does Not         | Yes         | Explicit boundaries and exclusions       |
+| Examples         | Recommended | Commit patterns, checklists              |
+
+## Schema URL
+
+```
+https://schemas.3leaps.dev/agentic/v0/role-prompt.schema.json
+```
+
+## Related
+
+- [docs/catalog/roles/](../../docs/catalog/roles/) - Baseline role definitions
+- [docs/repository/agent-identity.md](../../docs/repository/agent-identity.md) - Identity scheme
+- [FulmenHQ Crucible](https://github.com/fulmenhq/crucible) - Enterprise role catalog

package/schemas/crucible-ts/upstream/3leaps/crucible/schemas/agentic/v0/role-prompt.schema.json

@@ -52,7 +52,15 @@
     },
     "category": {
       "type": "string",
-      "enum": ["agentic", "automation", "review", "governance", "marketing"],
+      "enum": [
+        "agentic",
+        "analytics",
+        "automation",
+        "consulting",
+        "governance",
+        "marketing",
+        "review"
+      ],
       "description": "Role category for organization"
     },
     "tags": {
@@ -63,6 +71,32 @@
       },
       "description": "Searchable tags for the role"
     },
+    "domains": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "analytics",
+          "architecture",
+          "automation",
+          "consulting",
+          "coordination",
+          "delivery",
+          "development",
+          "documentation",
+          "governance",
+          "implementation",
+          "marketing",
+          "product",
+          "quality",
+          "security",
+          "strategy"
+        ]
+      },
+      "minItems": 1,
+      "maxItems": 3,
+      "description": "Process domains this role operates in (1-3). Used for organizational categorization beyond technical functions."
+    },
     "extends": {
       "type": "string",
       "format": "uri",
@@ -140,6 +174,31 @@
         }
       },
       "description": "Named checklists for common tasks"
+    },
+    "pre_push_checklist": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Checklist of validations to perform before pushing changes"
+    },
+    "required_reading": {
+      "type": "object",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Explanation of what should be read and why"
+        },
+        "pattern": {
+          "type": "string",
+          "description": "Guidance on where to find required reading (project-specific)"
+        }
+      },
+      "description": "Documents that must be read before starting work in this role"
+    },
+    "cross_role_note": {
+      "type": "string",
+      "description": "Guidance on coordination with other roles"
     }
   },
   "additionalProperties": false,

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

@@ -125,7 +125,9 @@
         },
         "synonyms": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Alternative names that map to this value"
         }
       },
@@ -162,12 +164,16 @@
       "properties": {
         "default_order": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Default sort order of value keys"
         },
         "ordinal_mapping": {
           "type": "object",
-          "additionalProperties": { "type": "integer" },
+          "additionalProperties": {
+            "type": "integer"
+          },
           "description": "Numeric ordinal for each value key"
         },
         "missing_handling": {
@@ -188,12 +194,16 @@
       "properties": {
         "downgrade": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Valid downgrade paths (e.g., '4-personal->2-blinded')"
         },
         "upgrade": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Valid upgrade paths"
         }
       },
@@ -208,7 +218,9 @@
         },
         "reviewers": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Required reviewers for changes"
         },
         "review_cycle": {