rafters 0.0.57 → 0.0.58

package/dist/index.js

@@ -12565,6 +12565,17 @@ var RegistryFileSchema = external_exports.object({
   // e.g., ["vitest"] - from @devDependencies JSDoc
 });
 var RegistryItemTypeSchema = external_exports.enum(["ui", "primitive", "composite"]);
+var RegistryItemIntelligenceSchema = external_exports.object({
+  cognitiveLoad: external_exports.number().optional(),
+  attentionEconomics: external_exports.string().optional(),
+  trustBuilding: external_exports.string().optional(),
+  accessibility: external_exports.string().optional(),
+  semanticMeaning: external_exports.string().optional(),
+  usagePatterns: external_exports.object({
+    dos: external_exports.array(external_exports.string()).default([]),
+    nevers: external_exports.array(external_exports.string()).default([])
+  }).optional()
+});
 var RegistryItemSchema = external_exports.object({
   name: external_exports.string(),
   type: RegistryItemTypeSchema,
@@ -12572,7 +12583,8 @@ var RegistryItemSchema = external_exports.object({
   primitives: external_exports.array(external_exports.string()),
   files: external_exports.array(RegistryFileSchema),
   rules: external_exports.array(external_exports.string()).default([]),
-  composites: external_exports.array(external_exports.string()).default([])
+  composites: external_exports.array(external_exports.string()).default([]),
+  intelligence: RegistryItemIntelligenceSchema.optional()
 });
 var RegistryIndexSchema = external_exports.object({
   name: external_exports.string(),
@@ -30440,7 +30452,16 @@ var RaftersToolHandler = class {
                 type: item.type,
                 description: item.description,
                 primitives: item.primitives,
-                rules: item.rules
+                rules: item.rules,
+                composites: item.composites,
+                files: item.files,
+                // The intelligence field carries the WHY of the component:
+                // cognitive load, accessibility, do/never, semantic meaning.
+                // Extracted from JSDoc by the registry generator and present
+                // on every component JSON. Previously stripped by the schema
+                // (not declared) and not referenced by the handler -- the
+                // tool's whole reason for existing went missing somewhere.
+                intelligence: item.intelligence
               },
               null,
               2

package/dist/registry/types.d.ts

@@ -27,6 +27,27 @@ declare const RegistryItemTypeSchema: z.ZodEnum<{
     composite: "composite";
 }>;
 type RegistryItemType = z.infer<typeof RegistryItemTypeSchema>;
+/**
+ * Design intelligence carried per-component. The registry generator
+ * extracts these from JSDoc tags on the component source (see
+ * `@cognitive-load`, `@attention-economics`, `@trust-building`,
+ * `@accessibility`, `@semantic-meaning`, `@usage-patterns` in e.g.
+ * packages/ui/src/components/ui/button.tsx). Surfacing this is the
+ * whole point of rafters -- agents read the encoded judgment instead
+ * of guessing at the design surface.
+ */
+declare const RegistryItemIntelligenceSchema: z.ZodObject<{
+    cognitiveLoad: z.ZodOptional<z.ZodNumber>;
+    attentionEconomics: z.ZodOptional<z.ZodString>;
+    trustBuilding: z.ZodOptional<z.ZodString>;
+    accessibility: z.ZodOptional<z.ZodString>;
+    semanticMeaning: z.ZodOptional<z.ZodString>;
+    usagePatterns: z.ZodOptional<z.ZodObject<{
+        dos: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        nevers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type RegistryItemIntelligence = z.infer<typeof RegistryItemIntelligenceSchema>;
 /**
  * A component or primitive in the registry
  */
@@ -47,6 +68,17 @@ declare const RegistryItemSchema: z.ZodObject<{
     }, z.core.$strip>>;
     rules: z.ZodDefault<z.ZodArray<z.ZodString>>;
     composites: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    intelligence: z.ZodOptional<z.ZodObject<{
+        cognitiveLoad: z.ZodOptional<z.ZodNumber>;
+        attentionEconomics: z.ZodOptional<z.ZodString>;
+        trustBuilding: z.ZodOptional<z.ZodString>;
+        accessibility: z.ZodOptional<z.ZodString>;
+        semanticMeaning: z.ZodOptional<z.ZodString>;
+        usagePatterns: z.ZodOptional<z.ZodObject<{
+            dos: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            nevers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type RegistryItem = z.infer<typeof RegistryItemSchema>;
 /**
@@ -62,4 +94,4 @@ declare const RegistryIndexSchema: z.ZodObject<{
 }, z.core.$strip>;
 type RegistryIndex = z.infer<typeof RegistryIndexSchema>;
 
-export { type RegistryFile, RegistryFileSchema, type RegistryIndex, RegistryIndexSchema, type RegistryItem, RegistryItemSchema, type RegistryItemType, RegistryItemTypeSchema };
+export { type RegistryFile, RegistryFileSchema, type RegistryIndex, RegistryIndexSchema, type RegistryItem, type RegistryItemIntelligence, RegistryItemIntelligenceSchema, RegistryItemSchema, type RegistryItemType, RegistryItemTypeSchema };

package/dist/registry/types.js

@@ -9,6 +9,17 @@ var RegistryFileSchema = z.object({
   // e.g., ["vitest"] - from @devDependencies JSDoc
 });
 var RegistryItemTypeSchema = z.enum(["ui", "primitive", "composite"]);
+var RegistryItemIntelligenceSchema = z.object({
+  cognitiveLoad: z.number().optional(),
+  attentionEconomics: z.string().optional(),
+  trustBuilding: z.string().optional(),
+  accessibility: z.string().optional(),
+  semanticMeaning: z.string().optional(),
+  usagePatterns: z.object({
+    dos: z.array(z.string()).default([]),
+    nevers: z.array(z.string()).default([])
+  }).optional()
+});
 var RegistryItemSchema = z.object({
   name: z.string(),
   type: RegistryItemTypeSchema,
@@ -16,7 +27,8 @@ var RegistryItemSchema = z.object({
   primitives: z.array(z.string()),
   files: z.array(RegistryFileSchema),
   rules: z.array(z.string()).default([]),
-  composites: z.array(z.string()).default([])
+  composites: z.array(z.string()).default([]),
+  intelligence: RegistryItemIntelligenceSchema.optional()
 });
 var RegistryIndexSchema = z.object({
   name: z.string(),
@@ -29,6 +41,7 @@ var RegistryIndexSchema = z.object({
 export {
   RegistryFileSchema,
   RegistryIndexSchema,
+  RegistryItemIntelligenceSchema,
   RegistryItemSchema,
   RegistryItemTypeSchema
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.57",
+  "version": "0.0.58",
   "description": "Design Intelligence CLI. Scaffold tokens, import existing shadcn/Tailwind v4 sources, add components, and serve an MCP server so AI agents read decisions instead of guessing.",
   "homepage": "https://rafters.studio",
   "license": "MIT",