rafters 0.0.83 → 0.0.84

package/dist/index.js

@@ -28427,7 +28427,8 @@ var RegistryItemSchema = external_exports.object({
   // Per-target facets. zod v4's `z.record(enum, ...)` demands EVERY enum key be
   // present; a component built for only some targets must parse, so this is a
   // partial record (only the built targets appear).
-  facets: external_exports.partialRecord(ComponentTargetSchema, FacetSchema).default({})
+  facets: external_exports.partialRecord(ComponentTargetSchema, FacetSchema).default({}),
+  parent: external_exports.string().optional()
 });
 var RegistryIndexSchema = external_exports.object({
   name: external_exports.string(),
@@ -31315,6 +31316,8 @@ function resolveWorkspace(workspaces, defaultWorkspace, name) {
 }
 
 // src/mcp/graph.ts
+var EXPAND_OP = "*";
+var PROBE_OP = "?";
 function assembleGraph(items) {
   const nodes = /* @__PURE__ */ new Map();
   for (const item of items) {
@@ -31330,13 +31333,45 @@ function assembleGraph(items) {
     if (src?.accessibility !== void 0) intel.accessibility = src.accessibility;
     if (src?.attentionEconomics !== void 0) intel.attentionEconomics = src.attentionEconomics;
     if (src?.trustBuilding !== void 0) intel.trustBuilding = src.trustBuilding;
-    nodes.set(item.name, {
+    const gn = {
       id: item.name,
       kind,
       intel,
       facets: item.facets ?? {},
-      composesWith: item.composites
-    });
+      composesWith: item.composites,
+      parts: []
+    };
+    if (item.parent !== void 0) gn.parent = item.parent;
+    nodes.set(item.name, gn);
+  }
+  for (const node of nodes.values()) {
+    if (node.parent === void 0) continue;
+    if (node.parent === node.id) {
+      throw new Error(`graph: node "${node.id}" parent references itself`);
+    }
+    if (!nodes.has(node.parent)) {
+      throw new Error(`graph: node "${node.id}" parent names unknown id "${node.parent}"`);
+    }
+  }
+  for (const node of nodes.values()) {
+    if (node.parent === void 0) continue;
+    const visited = /* @__PURE__ */ new Set();
+    visited.add(node.id);
+    let current = node.parent;
+    while (current !== void 0) {
+      if (visited.has(current)) {
+        throw new Error(
+          `graph: node "${node.id}" has a circular parent chain through "${current}"`
+        );
+      }
+      visited.add(current);
+      current = nodes.get(current)?.parent;
+    }
+  }
+  for (const node of nodes.values()) {
+    if (node.parent === void 0) continue;
+    const parentNode = nodes.get(node.parent);
+    if (parentNode) parentNode.parts.push(node.id);
   }
   for (const node of nodes.values()) {
     for (const target of node.composesWith) {
@@ -31366,6 +31401,7 @@ function describe(addr, graph, target) {
   const [head, ...rest] = parts;
   if (head === void 0) return { error: `cannot resolve: ${addr}` };
   if (head === "components" || head === "composites") {
+    if (rest.length > 0) return { error: `cannot expand: ${addr}` };
     const kind = head === "components" ? "component" : "composite";
     const roster = [];
     for (const node2 of graph.nodes.values()) {
@@ -31373,9 +31409,24 @@ function describe(addr, graph, target) {
     }
     return roster;
   }
+  if (parts[parts.length - 1] === PROBE_OP) {
+    const baseAddr = parts.slice(0, -1).join(".");
+    const result = describe(baseAddr, graph, target);
+    if (typeof result === "object" && result !== null && "error" in result) return null;
+    return result;
+  }
+  if (head === EXPAND_OP || head === PROBE_OP) {
+    return { error: `cannot expand at root: use 'components' or 'composites'` };
+  }
   const node = graph.nodes.get(head);
   if (!node) return { error: `unknown node: ${head}` };
-  if (rest.length === 0) return layer0(node, target);
+  if (rest.length === 0) return layer0(node, graph, target);
+  if (rest[rest.length - 1] === EXPAND_OP) {
+    const prefix = rest.slice(0, -1);
+    if (prefix.length === 0) return expandNode(node, target);
+    if (prefix.length === 1 && prefix[0] === "props") return expandProps(node, target);
+    return { error: `cannot expand: ${addr}` };
+  }
   if (rest.length === 1 && rest[0] === "composesWith") {
     return resolveEdges(node, graph, target);
   }
@@ -31396,7 +31447,7 @@ function toAgentProp(prop) {
   }
   return prop;
 }
-function layer0(node, target) {
+function layer0(node, graph, target) {
   const facet = target === void 0 ? void 0 : node.facets[target];
   const children = [];
   if (facet) {
@@ -31409,12 +31460,23 @@ function layer0(node, target) {
   if (node.composesWith.length > 0) {
     children.push({ addr: `${node.id}.composesWith`, type: "edge" });
   }
+  for (const partId of node.parts) {
+    children.push({ addr: partId, type: "part" });
+  }
   const result = { id: node.id, kind: node.kind, intel: node.intel, children };
   if (facet) {
     result.snippet = facet.snippet;
     if (facet.slots !== void 0) result.slots = facet.slots;
     if (facet.events !== void 0) result.events = facet.events;
   }
+  if (node.parent !== void 0) {
+    result.parent = node.parent;
+    const parentNode = graph.nodes.get(node.parent);
+    if (parentNode) {
+      const siblings = parentNode.parts.filter((id) => id !== node.id);
+      if (siblings.length > 0) result.siblings = siblings;
+    }
+  }
   return result;
 }
 function resolveEdges(node, graph, target) {
@@ -31424,10 +31486,43 @@ function resolveEdges(node, graph, target) {
     if (seen.has(edgeId)) continue;
     seen.add(edgeId);
     const edgeNode = graph.nodes.get(edgeId);
-    if (edgeNode) results.push(layer0(edgeNode, target));
+    if (edgeNode) results.push(layer0(edgeNode, graph, target));
   }
   return results;
 }
+function expandProps(node, target) {
+  const facet = target === void 0 ? void 0 : node.facets[target];
+  const props = {};
+  if (facet) {
+    for (const [name, prop] of Object.entries(facet.props)) {
+      props[name] = toAgentProp(prop);
+    }
+  }
+  return { expanded: true, props };
+}
+function expandNode(node, target) {
+  const facet = target === void 0 ? void 0 : node.facets[target];
+  const props = {};
+  if (facet) {
+    for (const [name, prop] of Object.entries(facet.props)) {
+      props[name] = toAgentProp(prop);
+    }
+  }
+  const result = {
+    id: node.id,
+    kind: node.kind,
+    intel: node.intel,
+    props
+  };
+  if (node.composesWith.length > 0) result.composesWith = node.composesWith;
+  if (node.parts.length > 0) result.parts = node.parts;
+  if (facet) {
+    result.snippet = facet.snippet;
+    if (facet.slots !== void 0) result.slots = facet.slots;
+    if (facet.events !== void 0) result.events = facet.events;
+  }
+  return result;
+}
 
 // src/mcp/intent.ts
 var INTENT_TAGS = {
@@ -31551,7 +31646,7 @@ function selectNearMiss(use, decisive, matchedTags, graph) {
 }
 function describeNode(id, graph) {
   const result = describe(id, graph);
-  if (!Array.isArray(result) && "children" in result) return result;
+  if (result !== null && !Array.isArray(result) && "children" in result) return result;
   return void 0;
 }
 function noMatch() {
@@ -31573,22 +31668,32 @@ function describeWithOverlay(addr, graph, ctx) {
     return roster.map((entry) => ({ id: entry.id, presence: presenceOf(set3, entry.id) }));
   }
   if (addr !== "" && !addr.includes(".") && isNodeResult(result)) {
-    const set3 = result.kind === "component" ? ctx.installed.components : ctx.installed.composites;
-    return {
-      ...result,
-      presence: presenceOf(set3, result.id),
-      target: ctx.target,
-      rendersForTarget: ctx.target !== void 0 && graph.nodes.get(result.id)?.facets[ctx.target] !== void 0
-    };
+    return { ...result, ...stampOf(result.id, result.kind, graph, ctx) };
+  }
+  if (isExpandedNodeResult(result)) {
+    return { ...result, ...stampOf(result.id, result.kind, graph, ctx) };
   }
   return result;
 }
 function presenceOf(set3, id) {
   return set3.has(id) ? "installed" : "available";
 }
+function stampOf(id, kind, graph, ctx) {
+  const set3 = kind === "component" ? ctx.installed.components : ctx.installed.composites;
+  return {
+    presence: presenceOf(set3, id),
+    target: ctx.target,
+    // rendersForTarget reads the node's own facets (on the universal graph):
+    // does a facet for the resolved target exist?
+    rendersForTarget: ctx.target !== void 0 && graph.nodes.get(id)?.facets[ctx.target] !== void 0
+  };
+}
 function isNodeResult(result) {
   return typeof result === "object" && result !== null && !Array.isArray(result) && "id" in result && "kind" in result && "children" in result;
 }
+function isExpandedNodeResult(result) {
+  return typeof result === "object" && result !== null && !Array.isArray(result) && "id" in result && "kind" in result && "props" in result && !("children" in result);
+}
 
 // src/mcp/tools.ts
 function isSafeRelPath(p2) {
@@ -31679,7 +31784,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "rafters_describe",
-    description: 'Recursively introspect the component/composite intel graph. describe() returns the installed surface; describe(components)/describe(composites) list the kind roster; describe(button) returns a node -- intel plus type-marked, drillable children; describe(button.props.fill) drills into a prop; describe(button.props.fill.vocab) returns the real token values. A natural-language question (e.g. "what do I use when it needs to be above everything") routes to the best-matching node plus a near-miss counter-example instead of an address.',
+    description: 'Recursively introspect the component/composite intel graph. describe() returns the installed surface; describe(components)/describe(composites) list the kind roster; describe(button) returns a node -- intel plus type-marked, drillable children; describe(button.props.fill) drills into a prop; describe(button.props.fill.vocab) returns the real token values. describe(button.*) expands all props inline in one call (no more drill-per-prop round trips); describe(button.props.fill.?) probes safely (null on miss, not an error). A natural-language question (e.g. "what do I use when it needs to be above everything") routes to the best-matching node plus a near-miss counter-example instead of an address.',
     inputSchema: {
       type: "object",
       properties: {

package/dist/registry/types.d.ts

@@ -209,6 +209,7 @@ declare const RegistryItemSchema: z.ZodObject<{
         events: z.ZodOptional<z.ZodArray<z.ZodString>>;
         snippet: z.ZodString;
     }, z.core.$strip>>>;
+    parent: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type RegistryItem = z.infer<typeof RegistryItemSchema>;
 /**

package/dist/registry/types.js

@@ -67,7 +67,8 @@ var RegistryItemSchema = z.object({
   // Per-target facets. zod v4's `z.record(enum, ...)` demands EVERY enum key be
   // present; a component built for only some targets must parse, so this is a
   // partial record (only the built targets appear).
-  facets: z.partialRecord(ComponentTargetSchema, FacetSchema).default({})
+  facets: z.partialRecord(ComponentTargetSchema, FacetSchema).default({}),
+  parent: z.string().optional()
 });
 var RegistryIndexSchema = z.object({
   name: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rafters",
-  "version": "0.0.83",
+  "version": "0.0.84",
   "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",