@fulmenhq/tsfulmen 0.1.13 → 0.2.0

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

@@ -0,0 +1,183 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/agentic/v0/role-prompt.schema.json",
+  "title": "Agentic Role Prompt",
+  "description": "Schema for AI coding agent role prompts. Defines structured role definitions that guide AI assistants working in repositories.",
+  "type": "object",
+  "required": [
+    "slug",
+    "name",
+    "description",
+    "version",
+    "status",
+    "scope",
+    "responsibilities",
+    "escalates_to",
+    "does_not"
+  ],
+  "properties": {
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*$",
+      "minLength": 2,
+      "maxLength": 16,
+      "description": "Role identifier (lowercase letters/numbers, no hyphens). Examples: devlead, secrev, infoarch"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "Human-readable role name. Example: Development Lead"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 256,
+      "description": "One-line description of the role's purpose"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Semantic version for role prompt evolution"
+    },
+    "author": {
+      "type": "string",
+      "maxLength": 64,
+      "description": "Role prompt author (role slug or human identifier)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "review", "approved", "deprecated"],
+      "description": "Role prompt lifecycle status"
+    },
+    "category": {
+      "type": "string",
+      "enum": ["agentic", "automation", "review", "governance", "marketing"],
+      "description": "Role category for organization"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*$"
+      },
+      "description": "Searchable tags for the role"
+    },
+    "extends": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to base role this extends"
+    },
+    "context": {
+      "type": "string",
+      "description": "When to use this role, distinct from similar roles"
+    },
+    "scope": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "description": "What this role covers - boundaries of responsibility"
+    },
+    "mindset": {
+      "type": "object",
+      "properties": {
+        "focus": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Key questions to ask, thinking patterns"
+        },
+        "principles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Guiding principles for this role"
+        }
+      },
+      "description": "Context engineering - shapes how the agent approaches problems"
+    },
+    "responsibilities": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "description": "Specific tasks and duties"
+    },
+    "escalates_to": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/escalation"
+      },
+      "minItems": 1,
+      "description": "When and to whom to escalate"
+    },
+    "does_not": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "description": "Explicit exclusions and out-of-scope items"
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/example"
+      },
+      "description": "Concrete examples of role application"
+    },
+    "checklists": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "description": "Named checklists for common tasks"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "escalation": {
+      "type": "object",
+      "required": ["target", "when"],
+      "properties": {
+        "target": {
+          "type": "string",
+          "description": "Who to escalate to (role slug, 'human maintainers', etc.)"
+        },
+        "when": {
+          "type": "string",
+          "description": "Conditions that trigger escalation"
+        }
+      },
+      "additionalProperties": false
+    },
+    "example": {
+      "type": "object",
+      "required": ["type", "content"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["commit", "review", "checklist", "other"],
+          "description": "Type of example"
+        },
+        "title": {
+          "type": "string",
+          "description": "Example title"
+        },
+        "content": {
+          "type": "string",
+          "description": "Example content (may be multi-line)"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

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

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/ailink/v0/prompt.schema.json",
+  "title": "AILink Prompt Configuration",
+  "description": "Schema for AILink prompt configuration files. Prompts define how AI backends process requests, including input variables, tools, and response validation.",
+  "type": "object",
+  "required": [
+    "slug",
+    "name",
+    "description",
+    "version"
+  ],
+  "properties": {
+    "slug": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "Unique identifier for the prompt (lowercase alphanumeric with hyphens)"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Human-readable display name"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "description": "Brief description of what this prompt does"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "description": "Semantic version for prompt content evolution"
+    },
+    "author": {
+      "type": "string",
+      "maxLength": 64,
+      "description": "Prompt author or maintainer"
+    },
+    "updated": {
+      "type": "string",
+      "format": "date",
+      "description": "Last update date (YYYY-MM-DD)"
+    },
+    "input": {
+      "type": "object",
+      "description": "Input specification for prompt variables",
+      "properties": {
+        "required_variables": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          },
+          "description": "Variables that must be provided"
+        },
+        "optional_variables": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          },
+          "description": "Optional variables with defaults"
+        },
+        "accepts_images": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this prompt accepts image input"
+        },
+        "image_types": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "image/png",
+              "image/jpeg",
+              "image/webp",
+              "image/gif"
+            ]
+          },
+          "description": "Accepted image MIME types (if accepts_images is true)"
+        },
+        "max_images": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 20,
+          "default": 1,
+          "description": "Maximum number of images allowed"
+        }
+      },
+      "additionalProperties": false
+    },
+    "system_template": {
+      "type": "string",
+      "minLength": 1,
+      "description": "System prompt template with {{variable}} placeholders"
+    },
+    "user_template": {
+      "type": "string",
+      "default": "{{input}}",
+      "description": "User prompt template (optional)"
+    },
+    "depth_variants": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Keyed user prompt variants (e.g., quick, deep, thorough)"
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/tool"
+      },
+      "description": "Server-side tools the prompt may use"
+    },
+    "response_schema": {
+      "anyOf": [
+        {
+          "type": "object",
+          "description": "Inline JSONSchema for response validation"
+        },
+        {
+          "type": "object",
+          "required": [
+            "$ref"
+          ],
+          "properties": {
+            "$ref": {
+              "type": "string",
+              "description": "Reference to external schema"
+            }
+          },
+          "additionalProperties": false
+        }
+      ],
+      "description": "JSONSchema for expected response structure"
+    },
+    "response_options": {
+      "type": "object",
+      "properties": {
+        "may_include_images": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether response may contain images"
+        },
+        "image_types": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Expected image MIME types in response"
+        }
+      },
+      "additionalProperties": false
+    },
+    "provider_hints": {
+      "type": "object",
+      "properties": {
+        "preferred_models": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Models known to work well with this prompt"
+        },
+        "min_context_window": {
+          "type": "integer",
+          "minimum": 1000,
+          "description": "Minimum context window size needed"
+        },
+        "supports_tools": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether this prompt benefits from tool use"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "tool": {
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "Tool type identifier (e.g., web_search, x_search, code_execution)"
+        },
+        "config": {
+          "type": "object",
+          "description": "Tool-specific configuration"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/crucible-ts/upstream/3leaps/ailink/v0/search-response.schema.json

@@ -0,0 +1,152 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.3leaps.dev/ailink/v0/search-response.schema.json",
+  "title": "AILink Search Response",
+  "description": "Base schema for AILink search/analysis response validation. Extensible for domain-specific responses.",
+  "type": "object",
+  "required": [
+    "summary"
+  ],
+  "properties": {
+    "summary": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Concise overall assessment"
+    },
+    "risk_level": {
+      "type": "string",
+      "enum": [
+        "low",
+        "medium",
+        "high",
+        "critical",
+        "unknown"
+      ],
+      "description": "Overall risk assessment"
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Model's confidence in the assessment (0-1)"
+    },
+    "insights": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Key findings as bullet points"
+    },
+    "mentions": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/mention"
+      },
+      "description": "Relevant mentions found during search"
+    },
+    "recommendations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Actionable recommendations"
+    },
+    "attachments": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/attachment"
+      },
+      "description": "Images or other media in response"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "mention": {
+      "type": "object",
+      "required": [
+        "source",
+        "description"
+      ],
+      "properties": {
+        "source": {
+          "type": "string",
+          "enum": [
+            "web",
+            "news",
+            "social",
+            "github",
+            "registry",
+            "trademark",
+            "other"
+          ],
+          "description": "Source type of the mention"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief summary of the finding"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL to the source (if available)"
+        },
+        "relevance": {
+          "type": "string",
+          "enum": [
+            "high",
+            "medium",
+            "low"
+          ],
+          "description": "Relevance to the query"
+        },
+        "sentiment": {
+          "type": "string",
+          "enum": [
+            "positive",
+            "neutral",
+            "negative",
+            "mixed"
+          ],
+          "description": "Sentiment of the mention"
+        },
+        "date": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the mention was found or published"
+        }
+      },
+      "additionalProperties": true
+    },
+    "attachment": {
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "IANA media type (e.g., image/png)"
+        },
+        "data": {
+          "type": "string",
+          "contentEncoding": "base64",
+          "description": "Base64-encoded binary data"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL reference (alternative to inline data)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Filename if applicable"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description or alt text"
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}

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

@@ -0,0 +1,50 @@
+# Upstream Schemas
+
+**DO NOT EDIT FILES IN THIS DIRECTORY.**
+
+This directory contains vendored copies of schemas from upstream repositories. These files are copied verbatim for offline validation and CI reliability.
+
+## Why Vendoring?
+
+CI pipelines need to validate against these schemas without network dependencies. Fetching from remote URLs at build time creates fragile builds that fail when upstream is unavailable.
+
+## Refresh Process
+
+When upstream schemas change:
+
+1. Pull latest from upstream repository
+2. Copy updated schemas to appropriate subdirectory
+3. Update `PROVENANCE.md` in the source directory
+4. Run `make precommit` to validate
+5. Commit with clear attribution
+
+```bash
+# Example refresh from local clone
+cp -r ../3leaps/crucible/schemas/ailink schemas/upstream/3leaps/
+cp -r ../3leaps/crucible/schemas/agentic schemas/upstream/3leaps/
+# Update PROVENANCE.md with new commit hash
+```
+
+## Directory Structure
+
+```
+upstream/
+├── README.md           # This file
+└── 3leaps/             # From github.com/3leaps/crucible
+    ├── PROVENANCE.md   # Source commit and date
+    ├── ailink/v0/      # AILink prompt schemas
+    └── agentic/v0/     # Agentic role prompt schemas
+```
+
+## Provenance
+
+Each upstream source has a `PROVENANCE.md` documenting:
+
+- Source repository
+- Commit hash
+- Sync date
+- Files included
+
+## Related
+
+- [goneat metaschemas](https://github.com/fulmenhq/goneat) - Same pattern for JSON Schema metaschemas

package/schemas/crucible-ts/web/branding/v1.0.0/site-branding.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.fulmenhq.dev/web/branding/v1.0.0/site-branding.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/web/branding/v1.0.0/site-branding.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "title": "Fulmen Site Branding",

package/schemas/crucible-ts/web/styling/v1.0.0/site-styling.schema.json

@@ -1,5 +1,5 @@
 {
-  "$id": "https://schemas.fulmenhq.dev/web/styling/v1.0.0/site-styling.schema.json",
+  "$id": "https://schemas.fulmenhq.dev/crucible/web/styling/v1.0.0/site-styling.schema.json",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "type": "object",
   "title": "Fulmen Site Styling",

package/schemas/crucible-ts/config/goneat/README.md

@@ -1,60 +0,0 @@
-# Goneat Configuration Schemas
-
-This directory contains JSON Schema definitions that codify configuration and policy
-files consumed by the goneat toolchain. Each schema is published at
-`https://schemas.fulmenhq.dev/config/goneat/<name>-<version>.schema.json` and should
-be referenced from the corresponding YAML/JSON policy files via the `$schema` field
-whenever possible.
-
-## Available Schemas
-
-| Schema                                        | Purpose                                                          |
-| --------------------------------------------- | ---------------------------------------------------------------- |
-| `goneat-config.yaml`                          | Core goneat CLI configuration (toolchain sources, telemetry opt) |
-| `dates.yaml`                                  | Date formatting conventions for release automation               |
-| `security-policy.yaml`                        | Security scanning and suppression policy                         |
-| `lifecycle-phase.json` / `release-phase.json` | Lifecycle metadata used by release automation                    |
-| `version-policy.schema.yaml`                  | Version SSOT propagation policy (new in v0.3.0)                  |
-
-## Version Policy (`version-policy.schema.yaml`)
-
-The version policy schema enables repositories to describe how the authoritative
-`VERSION` file propagates into downstream package manifests using goneat’s
-`version propagate` command. Policies live at `.goneat/version-policy.yaml` in consumer
-repositories and should reference the schema via:
-
-```yaml
-$schema: https://schemas.fulmenhq.dev/config/goneat/version-policy-v1.0.0.schema.json
-```
-
-Key capabilities:
-
-- **Schemes & Channels**: declare whether the repo uses SemVer or CalVer and optionally
-  constrain prerelease channels.
-- **Propagation Rules**: control default include/exclude patterns, handler-specific
-  overrides, workspace behaviour, and backup retention.
-- **Content Rules vs Guards**: `rules` describes version content constraints (channels,
-  tags, prerelease allowances) while `guards` enforce execution preconditions (branch
-  allow-lists, dirty worktree checks). Both sections are optional—planned for Phase 3a of
-  goneat’s roadmap.
-- **Extensibility**: `metadata` allows teams to attach internal annotations that goneat
-  will ignore while keeping the schema forward-compatible.
-
-The schema keys align with manifest filenames (e.g., `package.json`, `pyproject.toml`,
-`go.mod`). The workspace strategy supports three patterns:
-
-- `single-version`: all manifests inherit the root VERSION.
-- `opt-in`: only globs listed in `allowlist` receive independent version control.
-- `opt-out`: everything propagates except paths explicitly listed in `blocklist`.
-
-See the schema `examples` block for a reference configuration that covers common
-use cases (JS + Python monorepo with Go validation only). Additional cookbook
-samples will ship with goneat v0.3.0 documentation.
-
-## Contributing
-
-- Update the `$id` to point at the published schema URL when introducing new versions.
-- Keep the schema version number in lock-step with goneat releases that introduce
-  breaking changes to the configuration surface.
-- Whenever a schema is added or updated, ensure `make check-all` passes so that
-  downstream language wrappers receive the new definition during sync.