rafters 0.0.57 → 0.0.59

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(),
@@ -13377,6 +13389,7 @@ async function installWithPackageManager(packageManager, dependencies, options)
 }
 
 // src/utils/install-registry-deps.ts
+var REACT_RUNTIME_PACKAGES = /* @__PURE__ */ new Set(["react", "react-dom", "@types/react", "@types/react-dom"]);
 function parseDependency(dep) {
   const trimmed = dep.trim();
   if (!trimmed) {
@@ -13427,8 +13440,12 @@ async function installRegistryDependencies(items, targetDir, options = {}) {
     return result;
   }
   const externalDeps = [];
+  const dropForTarget = options.target && options.target !== "react";
   for (const dep of allDeps) {
-    if (parseDependency(dep).name.startsWith("@rafters/")) {
+    const { name } = parseDependency(dep);
+    if (name.startsWith("@rafters/")) {
+      result.skipped.push(dep);
+    } else if (dropForTarget && REACT_RUNTIME_PACKAGES.has(name)) {
       result.skipped.push(dep);
     } else {
       externalDeps.push(dep);
@@ -13628,6 +13645,14 @@ function isAlreadyInstalled(config2, item) {
   }
   return config2.installed.primitives.includes(item.name);
 }
+function isInstalledOnDisk(config2, item, cwd) {
+  if (!isAlreadyInstalled(config2, item)) return false;
+  const filesToCheck = item.type === "ui" ? selectFilesForFramework(item.files, getComponentTarget(config2)).files : item.files;
+  for (const file2 of filesToCheck) {
+    if (fileExists(cwd, transformPath(file2.path, config2, cwd))) return true;
+  }
+  return false;
+}
 function trackInstalled(config2, items) {
   if (!config2.installed) {
     config2.installed = { components: [], primitives: [], composites: [], rules: [] };
@@ -13844,13 +13869,20 @@ async function add(componentArgs, options) {
   const target = getComponentTarget(config2);
   for (const item of allItems) {
     if (!options.overwrite && isAlreadyInstalled(config2, item)) {
+      if (isInstalledOnDisk(config2, item, cwd)) {
+        log({
+          event: "add:skip",
+          component: item.name,
+          reason: "already installed"
+        });
+        skipped.push(item.name);
+        continue;
+      }
       log({
-        event: "add:skip",
+        event: "add:warning",
         component: item.name,
-        reason: "already installed"
+        message: "Config tracks this as installed but no files found on disk -- reinstalling."
       });
-      skipped.push(item.name);
-      continue;
     }
     try {
       const result = await installItem(cwd, item, options, config2);
@@ -13891,7 +13923,7 @@ async function add(componentArgs, options) {
   };
   let depsResult = emptyDeps;
   try {
-    depsResult = await installRegistryDependencies(filteredItems, cwd);
+    depsResult = await installRegistryDependencies(filteredItems, cwd, { target });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     log({
@@ -30440,7 +30472,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.59",
   "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",