@fulmenhq/tsfulmen 0.2.6 → 0.2.8

package/dist/crucible/index.d.ts

@@ -70,9 +70,69 @@ declare class InvalidAssetIdError extends Error {
     constructor(id: string, category: AssetCategory, reason: string);
 }
 
+interface RolePrompt {
+    readonly slug: string;
+    readonly name: string;
+    readonly description: string;
+    readonly version: string;
+    readonly status: string;
+    readonly author?: string;
+    readonly category?: string;
+    readonly extends?: string;
+    readonly domains?: readonly string[];
+    readonly tags?: readonly string[];
+    readonly context?: string;
+    readonly scope: readonly string[];
+    readonly mindset?: RoleMindset;
+    readonly responsibilities: readonly string[];
+    readonly escalates_to: readonly RoleEscalation[];
+    readonly does_not: readonly string[];
+    readonly examples?: readonly RoleExample[];
+    readonly checklists?: Readonly<Record<string, readonly string[]>>;
+    readonly pre_push_checklist?: readonly string[];
+    readonly required_reading?: RoleRequiredReading;
+    readonly cross_role_note?: string;
+}
+interface RoleMindset {
+    readonly focus: readonly string[];
+    readonly principles: readonly string[];
+}
+interface RoleEscalation {
+    readonly target: string;
+    readonly when: string;
+}
+interface RoleExample {
+    readonly type: string;
+    readonly title?: string;
+    readonly content: string;
+}
+interface RoleRequiredReading {
+    readonly description?: string;
+    readonly pattern?: string;
+    readonly files?: readonly RoleRequiredReadingFile[];
+}
+interface RoleRequiredReadingFile {
+    readonly path?: string;
+    readonly reason?: string;
+}
+/**
+ * List available role slugs, sorted alphabetically.
+ * README and non-YAML assets are excluded.
+ */
+declare function listRoleSlugs(): Promise<readonly string[]>;
+/**
+ * Load a single role by slug.
+ * @throws {AssetNotFoundError} if the slug does not match a role YAML
+ */
+declare function loadRole(slug: string): Promise<RolePrompt>;
+/**
+ * Load all roles keyed by slug.
+ */
+declare function loadRoleCatalog(): Promise<ReadonlyMap<string, RolePrompt>>;
+
 declare function listSchemas(kind?: SchemaKind): Promise<readonly SchemaSummary[]>;
 declare function loadSchemaById(id: string): Promise<unknown>;
 
 declare function getCrucibleVersion(): CrucibleVersion;
 
-export { type AssetCategory, type AssetListOptions, AssetNotFoundError, type AssetSummary, type ConfigSummary, type CrucibleVersion, type DocumentationFilter, type DocumentationMetadata, type DocumentationSummary, InvalidAssetIdError, type SchemaKind, type SchemaSummary, getConfigDefaults, getCrucibleVersion, getDocumentation, getDocumentationMetadata, getDocumentationWithMetadata, listAssets, listCategories, listConfigDefaults, listDocumentation, listSchemas, loadSchemaById };
+export { type AssetCategory, type AssetListOptions, AssetNotFoundError, type AssetSummary, type ConfigSummary, type CrucibleVersion, type DocumentationFilter, type DocumentationMetadata, type DocumentationSummary, InvalidAssetIdError, type RoleEscalation, type RoleExample, type RoleMindset, type RolePrompt, type RoleRequiredReading, type RoleRequiredReadingFile, type SchemaKind, type SchemaSummary, getConfigDefaults, getCrucibleVersion, getDocumentation, getDocumentationMetadata, getDocumentationWithMetadata, listAssets, listCategories, listConfigDefaults, listDocumentation, listRoleSlugs, listSchemas, loadRole, loadRoleCatalog, loadSchemaById };

package/dist/crucible/index.js

@@ -6607,6 +6607,52 @@ async function getDocumentationMetadata(id) {
   }
 }
 
+// src/crucible/roles.ts
+init_telemetry();
+var ROLE_PREFIX = "agentic/roles";
+var SLUG_PATTERN = /^[a-z][a-z0-9]*$/;
+async function listRoleSlugs() {
+  const assets = await listAssets("config", { prefix: ROLE_PREFIX });
+  const slugs = [];
+  for (const asset of assets) {
+    const filename = asset.id.slice(ROLE_PREFIX.length + 1);
+    if (filename === "README" || filename.includes("/")) {
+      continue;
+    }
+    if (SLUG_PATTERN.test(filename)) {
+      slugs.push(filename);
+    }
+  }
+  slugs.sort((a, b) => a.localeCompare(b));
+  return slugs;
+}
+async function loadRole(slug) {
+  if (!SLUG_PATTERN.test(slug)) {
+    const available = await listRoleSlugs();
+    throw new AssetNotFoundError(slug, "config", [...available]);
+  }
+  const assetId = `${ROLE_PREFIX}/${slug}`;
+  const path = assetIdToPath(assetId, "config");
+  const fullPath = join(process.cwd(), path);
+  try {
+    const content = await readFile(fullPath, "utf-8");
+    metrics.counter("foundry_lookup_count").inc();
+    return parse(content);
+  } catch (_error) {
+    const available = await listRoleSlugs();
+    throw new AssetNotFoundError(slug, "config", [...available]);
+  }
+}
+async function loadRoleCatalog() {
+  const slugs = await listRoleSlugs();
+  const catalog = /* @__PURE__ */ new Map();
+  for (const slug of slugs) {
+    const role = await loadRole(slug);
+    catalog.set(role.slug, role);
+  }
+  return catalog;
+}
+
 // src/crucible/schemas.ts
 init_telemetry();
 async function listSchemas2(kind) {
@@ -6665,6 +6711,6 @@ function getCrucibleVersion() {
   }
 }
 
-export { AssetNotFoundError, InvalidAssetIdError, getConfigDefaults, getCrucibleVersion, getDocumentation, getDocumentationMetadata, getDocumentationWithMetadata, listAssets, listCategories, listConfigDefaults, listDocumentation, listSchemas2 as listSchemas, loadSchemaById };
+export { AssetNotFoundError, InvalidAssetIdError, getConfigDefaults, getCrucibleVersion, getDocumentation, getDocumentationMetadata, getDocumentationWithMetadata, listAssets, listCategories, listConfigDefaults, listDocumentation, listRoleSlugs, listSchemas2 as listSchemas, loadRole, loadRoleCatalog, loadSchemaById };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map