rafters 0.0.1 → 0.0.2

package/dist/index.js

@@ -50518,6 +50518,20 @@ var TOOL_DEFINITIONS = [
       },
       required: ["name"]
     }
+  },
+  {
+    name: "rafters_token",
+    description: "Get full intelligence for a design token: current value, derivation rule, dependencies, dependents (cascade impact), and human override context. Shows what the system computes vs what a designer chose and why. Use when you need to understand token relationships or respect designer decisions.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: 'Token name (e.g., "spacing-6", "primary-500", "spacing-base"). Use rafters_vocabulary to see available tokens.'
+        }
+      },
+      required: ["name"]
+    }
   }
 ];
 var RaftersToolHandler = class {
@@ -50538,6 +50552,8 @@ var RaftersToolHandler = class {
         return this.getPattern(args.pattern);
       case "rafters_component":
         return this.getComponent(args.name);
+      case "rafters_token":
+        return this.getToken(args.name);
       default:
         return {
           content: [{ type: "text", text: `Unknown tool: ${name2}` }],
@@ -50897,6 +50913,113 @@ var RaftersToolHandler = class {
       return this.handleError("getComponent", error47);
     }
   }
+  // ==================== Tool 4: Token ====================
+  /**
+   * Get full token intelligence including dependency graph and override context
+   */
+  async getToken(tokenName) {
+    try {
+      const namespaces = ["color", "spacing", "typography"];
+      let foundToken = null;
+      let foundNamespace = "";
+      for (const ns of namespaces) {
+        try {
+          const tokens = await this.adapter.loadNamespace(ns);
+          const token = tokens.find((t2) => t2.name === tokenName);
+          if (token) {
+            foundToken = token;
+            foundNamespace = ns;
+            break;
+          }
+        } catch {
+        }
+      }
+      if (!foundToken) {
+        const allTokenNames = [];
+        for (const ns of namespaces) {
+          try {
+            const tokens = await this.adapter.loadNamespace(ns);
+            allTokenNames.push(...tokens.map((t2) => t2.name));
+          } catch {
+          }
+        }
+        const similar = allTokenNames.filter((n) => n.includes(tokenName) || tokenName.includes(n.split("-")[0] || "")).slice(0, 5);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  error: `Token "${tokenName}" not found`,
+                  similar: similar.length > 0 ? similar : void 0,
+                  suggestion: "Use rafters_vocabulary to see all available tokens"
+                },
+                null,
+                2
+              )
+            }
+          ],
+          isError: true
+        };
+      }
+      const intelligence = {
+        name: foundToken.name,
+        namespace: foundNamespace,
+        value: foundToken.value
+      };
+      if (foundToken.generationRule) {
+        intelligence.derivation = {
+          rule: foundToken.generationRule,
+          mathRelationship: foundToken.mathRelationship,
+          progressionSystem: foundToken.progressionSystem,
+          scalePosition: foundToken.scalePosition
+        };
+      }
+      if (foundToken.dependsOn && foundToken.dependsOn.length > 0) {
+        intelligence.dependsOn = foundToken.dependsOn;
+      }
+      if (foundToken.computedValue !== void 0) {
+        intelligence.computedValue = foundToken.computedValue;
+      }
+      if (foundToken.userOverride) {
+        intelligence.override = {
+          previousValue: foundToken.userOverride.previousValue,
+          reason: foundToken.userOverride.reason,
+          overriddenBy: foundToken.userOverride.overriddenBy,
+          overriddenAt: foundToken.userOverride.overriddenAt,
+          context: foundToken.userOverride.context,
+          tags: foundToken.userOverride.tags,
+          revertAfter: foundToken.userOverride.revertAfter
+        };
+        intelligence.isOverridden = true;
+      } else {
+        intelligence.isOverridden = false;
+      }
+      if (foundToken.semanticMeaning) {
+        intelligence.semanticMeaning = foundToken.semanticMeaning;
+      }
+      if (foundToken.usageContext) {
+        intelligence.usageContext = foundToken.usageContext;
+      }
+      if (foundToken.usagePatterns) {
+        intelligence.do = foundToken.usagePatterns.do;
+        intelligence.never = foundToken.usagePatterns.never;
+      }
+      if (foundToken.containerQueryAware !== void 0) {
+        intelligence.containerQueryAware = foundToken.containerQueryAware;
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(intelligence, null, 2)
+          }
+        ]
+      };
+    } catch (error47) {
+      return this.handleError("getToken", error47);
+    }
+  }
   /**
    * Handle errors consistently
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "CLI for Rafters design system - scaffold tokens and add components",
   "type": "module",
   "bin": {
@@ -28,8 +28,8 @@
     "typescript": "5.9.3",
     "vitest": "^3.2.0",
     "zocker": "^3.0.0",
-    "@rafters/shared": "0.0.1",
-    "@rafters/design-tokens": "0.0.1"
+    "@rafters/design-tokens": "0.0.1",
+    "@rafters/shared": "0.0.1"
   },
   "publishConfig": {
     "access": "public"