@a-company/paradigm 3.28.0 → 3.34.0

package/dist/index.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   initCommand
-} from "./chunk-SCC77UUP.js";
-import "./chunk-W4VFKZVF.js";
-import "./chunk-AK5M6KJB.js";
+} from "./chunk-H4TVBJD4.js";
+import "./chunk-S5TDFT5Q.js";
+import "./chunk-36TKPM5Z.js";
 import {
   aggregateFromDirectory,
   buildSymbolIndex,
   getSymbolCounts
-} from "./chunk-6P4IFIK2.js";
+} from "./chunk-CTF6RHKG.js";
 import {
   findPurposeFiles
-} from "./chunk-MRENOFTR.js";
+} from "./chunk-VUSCJJ4A.js";
 import {
   findGateFiles
 } from "./chunk-IRKUEJVW.js";
@@ -111,7 +111,7 @@ ${chalk2.magenta("\u2569  ")}${chalk2.cyan("\u2534 \u2534\u2534\u2514\u2500\u253
 program.name("paradigm").description("Unified developer tools ecosystem").version(VERSION).addHelpText("before", banner);
 program.command("init").description("Initialize Paradigm in the current project").option("-f, --force", "Overwrite existing files").option("--name <name>", "Project name").option("--ide <ide>", "Target IDE: cursor, copilot, windsurf, claude").option("--stack <stack>", "Stack preset (e.g., nextjs, fastapi, swift-ios). Auto-detected if omitted.").option("--migrate", "Output migration prompt for existing IDE files").option("--quick", "Non-interactive mode with smart defaults").option("--dry-run", "Show what would be created without creating").action(initCommand);
 program.command("shift").description("Full project setup in one command (init + team init + scan + sync all IDEs + doctor)").option("-f, --force", "Reinitialize even if already setup").option("-q, --quick", "Skip slow operations (scan)").option("--verify", "Run health checks after setup").option("--ide <ide>", "Target specific IDE instead of all").option("--configure-models", "Force model configuration prompts for team agents").option("--stack <stack>", "Stack preset (e.g., nextjs, fastapi, swift-ios). Auto-detected if omitted.").option("--workspace <name>", "Create or join a multi-project workspace with this name (creates ../.paradigm-workspace)").option("--workspace-path <path>", "Custom workspace file location (default: ../.paradigm-workspace)").action(async (options) => {
-  const { shiftCommand } = await import("./shift-DRF5M3G6.js");
+  const { shiftCommand } = await import("./shift-7XLSBLDW.js");
   await shiftCommand(options);
 });
 program.command("presets").description("List available stack presets for paradigm init/shift").option("-d, --discipline <discipline>", "Filter by discipline (e.g., fullstack, api, mobile)").action(async (options) => {
@@ -143,17 +143,17 @@ program.command("presets").description("List available stack presets for paradig
 `));
 });
 program.command("setup [path]").description("Interactive setup wizard for Paradigm").option("-y, --yes", "Accept all defaults (non-interactive)").option("-f, --force", "Overwrite existing .paradigm config").action(async (path2, options) => {
-  const { setupCommand } = await import("./setup-HOI52TN3.js");
+  const { setupCommand } = await import("./setup-ASR6OMKV.js");
   await setupCommand(path2, options);
 });
 program.command("status").alias("st").description("Show project status and symbol counts").action(statusCommand);
 var purposeCmd = program.command("purpose").description("Purpose-related commands");
 purposeCmd.command("remember [path]").description("Aggregate and display purpose context").action(async (path2 = ".") => {
-  const { purposeRememberCommand } = await import("./remember-IEBQHXHZ.js");
+  const { purposeRememberCommand } = await import("./remember-WR6ZVXLT.js");
   await purposeRememberCommand(path2);
 });
 purposeCmd.command("validate [path]").description("Validate purpose files").action(async (path2 = ".") => {
-  const { purposeValidateCommand } = await import("./validate-TKKRGJKC.js");
+  const { purposeValidateCommand } = await import("./validate-OUHUBZPO.js");
   await purposeValidateCommand(path2);
 });
 var portalCmd = program.command("portal").description("Portal-related commands");
@@ -183,11 +183,11 @@ portalCmd.command("export [path]").description("Export portal configuration in j
 });
 var premiseCmd = program.command("premise").description("Premise-related commands");
 premiseCmd.command("aggregate [path]").description("Aggregate all sources into symbol index").action(async (path2 = ".") => {
-  const { premiseAggregateCommand } = await import("./aggregate-M5WMUI6B.js");
+  const { premiseAggregateCommand } = await import("./aggregate-XHQ6GI3Z.js");
   await premiseAggregateCommand(path2);
 });
 premiseCmd.command("snapshot <name>").description("Create a timeline snapshot").option("-d, --description <desc>", "Snapshot description").action(async (name, options) => {
-  const { premiseSnapshotCommand } = await import("./snapshot-XHINQBZS.js");
+  const { premiseSnapshotCommand } = await import("./snapshot-QZFD7YBI.js");
   await premiseSnapshotCommand(name, options.description);
 });
 program.command("sync [ide]").description("Generate IDE instruction files from .paradigm/ config").option("--all", "Sync all supported IDEs").option("-f, --force", "Overwrite existing files").option("--mcp", "Generate MCP configuration (default: true)").option("--no-mcp", "Skip MCP configuration generation").option("--nested", "Generate nested CLAUDE.md files for directories with .purpose").action(async (ide, options) => {
@@ -200,28 +200,32 @@ program.command("sync-llms").description("Generate llms.txt \u2014 LLM-readable
 });
 program.command("cursorrules [path]").description("[DEPRECATED] Use `paradigm sync cursor` instead").option("-a, --append", "Append to existing .cursorrules").option("-f, --force", "Overwrite existing .cursorrules").option("-p, --preview", "Preview output without writing").option("--init", "Create default .paradigm config if missing").option("--with-scan", "Include probe protocol section").action(async (path2, options) => {
   console.log("\x1B[33m\u26A0\uFE0F  `paradigm cursorrules` is deprecated. Use `paradigm sync cursor` instead.\x1B[0m\n");
-  const { cursorrrulesCommand } = await import("./cursorrules-XBWFX66V.js");
+  const { cursorrrulesCommand } = await import("./cursorrules-3TKZ4E4R.js");
   await cursorrrulesCommand(path2, options);
 });
 program.command("index [path]").description("Generate probe index for visual discovery").option("-o, --output <path>", "Output path for probe-index.json").option("-q, --quiet", "Suppress output").action(async (path2, options) => {
-  const { indexCommand } = await import("./probe-SN4BNXOC.js");
+  const { indexCommand } = await import("./probe-ABMGCXQG.js");
   await indexCommand(path2, options);
 });
 var probeCmd = program.command("probe").description("Probe-related commands");
 probeCmd.command("index [path]").description("Generate probe index (alias for `paradigm index`)").option("-o, --output <path>", "Output path for probe-index.json").option("-q, --quiet", "Suppress output").action(async (path2, options) => {
-  const { indexCommand } = await import("./probe-SN4BNXOC.js");
+  const { indexCommand } = await import("./probe-ABMGCXQG.js");
   await indexCommand(path2, options);
 });
-program.command("upgrade [path]").description("Upgrade project with new Paradigm features").option("--features <features...>", "Features to upgrade (probe, logger)").option("--all", "Apply all available upgrades").option("--from-horizon", "Migrate from Horizon to Paradigm").option("--dry-run", "Show what would be upgraded without making changes").option("-f, --force", "Force re-upgrade even if already configured").action(async (path2, options) => {
-  const { upgradeCommand } = await import("./upgrade-65QOQXRC.js");
+program.command("migrate").description("Detect and apply migrations to bring project up to date").option("--dry-run", "Preview changes without applying").option("--apply", "Apply all auto migrations without prompting").option("-f, --force", "Re-run previously applied migrations").option("--only <ids...>", "Run specific migrations by ID").option("--category <cat>", "Run migrations in a category (directory, config, template, hook)").option("--no-sync", "Skip template sync").option("--list", "List all migrations and their status").option("-v, --verbose", "Show detailed output").action(async (options) => {
+  const { migrateCommand } = await import("./migrate-HRN5TUBQ.js");
+  await migrateCommand(options);
+});
+program.command("upgrade [path]").description("(Deprecated) Upgrade project with new Paradigm features \u2014 use `paradigm migrate`").option("--features <features...>", "Features to upgrade (probe, logger)").option("--all", "Apply all available upgrades").option("--from-horizon", "Migrate from Horizon to Paradigm").option("--dry-run", "Show what would be upgraded without making changes").option("-f, --force", "Force re-upgrade even if already configured").action(async (path2, options) => {
+  const { upgradeCommand } = await import("./upgrade-ANX3LVSA.js");
   await upgradeCommand(path2, options);
 });
 program.command("lint [path]").description("Validate .purpose files for schema errors").option("-f, --fix", "Auto-fix issues where possible").option("-s, --strict", "Fail on warnings (not just errors)").option("-q, --quiet", "Suppress output except errors").option("--json", "Output as JSON").option("--auto-populate", "Scan for undocumented source dirs and suggest .purpose entries (use with --fix to write)").action(async (path2, options) => {
-  const { lintCommand } = await import("./lint-53GPXKKI.js");
+  const { lintCommand } = await import("./lint-MTRZB5EC.js");
   await lintCommand(path2, options);
 });
 program.command("cost [path]").description("Analyze token costs for AI context").option("-d, --detailed", "Show detailed breakdown by file").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { costCommand } = await import("./cost-CTGSLSOC.js");
+  const { costCommand } = await import("./cost-4SZM7OUS.js");
   await costCommand(path2, options);
 });
 var scanCmd = program.command("scan").description("Visual discovery and auto-generation commands");
@@ -245,7 +249,7 @@ flowCmd.action(() => {
 });
 var teamCmd = program.command("team").description("Multi-agent orchestration commands");
 teamCmd.command("init [path]").description("Initialize team configuration with default agents").option("-f, --force", "Overwrite existing configuration").option("--configure-models", "Force model configuration prompts").option("--no-configure-models", "Skip model configuration").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamInitCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamInitCommand } = await import("./team-VH3HYABB.js");
   await teamInitCommand(path2, {
     ...options,
     configureModels: options.configureModels,
@@ -253,27 +257,27 @@ teamCmd.command("init [path]").description("Initialize team configuration with d
   });
 });
 teamCmd.command("status [path]").description("Show current team status").option("--running", "Show only running orchestrations").option("--id <id>", "Show specific orchestration").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamStatusCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamStatusCommand } = await import("./team-VH3HYABB.js");
   await teamStatusCommand(path2, options);
 });
 teamCmd.command("handoff [path]").description("Hand off current task to another agent").requiredOption("-t, --to <agent>", "Target agent name").option("-s, --summary <text>", "Summary of what was done").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamHandoffCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamHandoffCommand } = await import("./team-VH3HYABB.js");
   await teamHandoffCommand(path2, options);
 });
 teamCmd.command("accept [handoff-id] [path]").description("Accept a pending handoff").option("-n, --note <text>", "Acceptance note").option("--json", "Output as JSON").action(async (handoffId, path2, options) => {
-  const { teamAcceptCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamAcceptCommand } = await import("./team-VH3HYABB.js");
   await teamAcceptCommand(handoffId, path2, options);
 });
 teamCmd.command("check [path]").description("Check for conflicts and team health issues").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamCheckCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamCheckCommand } = await import("./team-VH3HYABB.js");
   await teamCheckCommand(path2, options);
 });
 teamCmd.command("history [path]").description("Show full activity log").option("-l, --limit <number>", "Number of entries to show", "50").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamHistoryCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamHistoryCommand } = await import("./team-VH3HYABB.js");
   await teamHistoryCommand(path2, { ...options, limit: parseInt(options.limit) });
 });
 teamCmd.command("reset [path]").description("Reset team state for fresh start").option("-f, --force", "Force reset even with pending work").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamResetCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamResetCommand } = await import("./team-VH3HYABB.js");
   await teamResetCommand(path2, options);
 });
 teamCmd.command("spawn <agent> [path]").description("Spawn an AI agent to work on a task").requiredOption("-t, --task <task>", "Task for the agent to perform").option("-m, --model <model>", "Model to use: opus, sonnet, haiku").option("-p, --provider <provider>", "Provider: auto, claude, claude-code, claude-cli, manual").option("--budget <budget>", 'Budget limits (e.g., "tokens=100000,cost=2")').option("--timeout <ms>", "Timeout in milliseconds").option("--checkpoint", "Pause for approval before writes/deletes").option("-q, --quiet", "Suppress output").option("--json", "Output as JSON").action(async (agent, path2, options) => {
@@ -281,19 +285,19 @@ teamCmd.command("spawn <agent> [path]").description("Spawn an AI agent to work o
   await teamSpawnCommand(agent, path2, options);
 });
 teamCmd.command("orchestrate <task> [path]").description("Orchestrate a multi-agent task").option("--solo", "Run in solo mode (single Claude)").option("--faceted", "Run in faceted mode (multi-agent, default)").option("--compare", "Run both modes and compare results").option("--background", "Run in background mode (returns immediately)").option("--notify <methods>", "Notification methods: bell,desktop,file,webhook (default: bell)").option("-m, --model <model>", "Orchestrator model: opus, sonnet, haiku").option("-p, --provider <provider>", "Provider: auto, claude, claude-code, claude-cli, manual").option("--budget <budget>", 'Budget limits (e.g., "tokens=500000,cost=5")').option("--checkpoint", "Pause for approval between agents").option("--live", "Stream agent output live").option("--pm", "Enable PM governance (compliance checks before/after)").option("-q, --quiet", "Suppress output").option("--json", "Output as JSON").action(async (task, path2, options) => {
-  const { teamOrchestrateCommand } = await import("./orchestrate-HMSQ2CED.js");
+  const { teamOrchestrateCommand } = await import("./orchestrate-3SI6ON33.js");
   await teamOrchestrateCommand(task, path2, options);
 });
 teamCmd.command("diff <orchestration-id> [path]").description("Show diff of changes from a completed orchestration").option("--full", "Show full file contents").option("--json", "Output as JSON").action(async (orchestrationId, path2, options) => {
-  const { teamDiffCommand } = await import("./diff-AH7L4PRQ.js");
+  const { teamDiffCommand } = await import("./diff-T6YJSAAC.js");
   await teamDiffCommand(orchestrationId, path2, options);
 });
 teamCmd.command("accept-orch <orchestration-id> [path]").description("Accept orchestration changes").option("-n, --note <text>", "Acceptance note").option("--json", "Output as JSON").action(async (orchestrationId, path2, options) => {
-  const { teamAcceptOrchestrationCommand } = await import("./accept-orchestration-6EM5EHXA.js");
+  const { teamAcceptOrchestrationCommand } = await import("./accept-orchestration-XXANWJVZ.js");
   await teamAcceptOrchestrationCommand(orchestrationId, path2, options);
 });
 teamCmd.command("reject-orch <orchestration-id> [path]").description("Reject orchestration changes").option("-r, --reason <text>", "Rejection reason").option("--cleanup", "Delete created files").option("--json", "Output as JSON").action(async (orchestrationId, path2, options) => {
-  const { teamRejectOrchestrationCommand } = await import("./accept-orchestration-6EM5EHXA.js");
+  const { teamRejectOrchestrationCommand } = await import("./accept-orchestration-XXANWJVZ.js");
   await teamRejectOrchestrationCommand(orchestrationId, path2, options);
 });
 teamCmd.command("cost [path]").description("Show cost summary for orchestrations").option("--from <date>", "From date (ISO format)").option("--to <date>", "To date (ISO format)").option("--days <n>", "Last N days").option("-d, --detailed", "Show detailed breakdown").option("--json", "Output as JSON").action(async (path2, options) => {
@@ -309,7 +313,7 @@ teamCmd.command("providers [path]").description("Show available agent providers
   await teamProvidersCommand(path2, options);
 });
 teamCmd.command("models [path]").description("Configure or view agent model assignments").option("--refresh", "Refresh model cache from environment").option("--json", "Output as JSON").action(async (path2, options) => {
-  const { teamModelsCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamModelsCommand } = await import("./team-VH3HYABB.js");
   await teamModelsCommand(path2, options);
 });
 var agentsCmd = teamCmd.command("agents").description("Agent management commands");
@@ -324,7 +328,7 @@ agentsCmd.action(() => {
   console.log("\nRun `paradigm team agents suggest --help` for options.\n");
 });
 teamCmd.action(async () => {
-  const { teamStatusCommand } = await import("./team-YOGT2Q2X.js");
+  const { teamStatusCommand } = await import("./team-VH3HYABB.js");
   await teamStatusCommand(void 0, {});
 });
 var pluginCmd = program.command("plugin").description("Plugin management commands");
@@ -338,19 +342,19 @@ pluginCmd.action(async () => {
 });
 var workspaceCmd = program.command("workspace").description("Multi-project workspace commands");
 workspaceCmd.command("init").description("Create a .paradigm-workspace file from sibling projects").option("-n, --name <name>", "Workspace name (default: directory name)").option("-f, --force", "Overwrite existing workspace file").action(async (options) => {
-  const { workspaceInitCommand } = await import("./workspace-L27RR5MF.js");
+  const { workspaceInitCommand } = await import("./workspace-5RBSALXC.js");
   await workspaceInitCommand(options);
 });
 workspaceCmd.command("status").description("Show workspace member status and symbol counts").option("--json", "Output as JSON").action(async (options) => {
-  const { workspaceStatusCommand } = await import("./workspace-L27RR5MF.js");
+  const { workspaceStatusCommand } = await import("./workspace-5RBSALXC.js");
   await workspaceStatusCommand(options);
 });
 workspaceCmd.command("reindex").description("Rebuild scan-index.json for all workspace members").option("-q, --quiet", "Suppress progress output").action(async (options) => {
-  const { workspaceReindexCommand } = await import("./workspace-L27RR5MF.js");
+  const { workspaceReindexCommand } = await import("./workspace-5RBSALXC.js");
   await workspaceReindexCommand(options);
 });
 workspaceCmd.action(async () => {
-  const { workspaceStatusCommand } = await import("./workspace-L27RR5MF.js");
+  const { workspaceStatusCommand } = await import("./workspace-5RBSALXC.js");
   await workspaceStatusCommand({});
 });
 program.command("doctor").description("Health check - validate Paradigm setup").option("--context", "Run only context audit checks (CLAUDE.md quality)").action(async (options) => {
@@ -379,19 +383,19 @@ program.command("watch").description("Watch for changes and auto-sync IDE files"
   await watchCommand();
 });
 program.command("summary").description("Generate .paradigm/project.md with project stats").action(async () => {
-  const { summaryCommand } = await import("./summary-NV7SBV5O.js");
+  const { summaryCommand } = await import("./summary-R4CSYNNP.js");
   await summaryCommand();
 });
 program.command("constellation [path]").alias("const").description("Generate .paradigm/constellation.json - symbol relationship graph for AI agents").option("-f, --format <format>", "Output format: json or yaml", "json").option("-o, --output <path>", "Custom output path").option("-q, --quiet", "Suppress output").action(async (path2, options) => {
-  const { constellationCommand } = await import("./constellation-NXU6Q2HM.js");
+  const { constellationCommand } = await import("./constellation-LZ6XIKDT.js");
   await constellationCommand(path2, options);
 });
 program.command("beacon [path]").description("Generate .paradigm/beacon.md - quick-start orientation for AI agents").option("-r, --refresh", "Regenerate even if beacon exists").option("-o, --output <path>", "Custom output path").option("--json", "Output as JSON (for AI agent queries)").option("-q, --quiet", "Suppress output").action(async (path2, options) => {
-  const { beaconCommand } = await import("./beacon-XL2ALH5O.js");
+  const { beaconCommand } = await import("./beacon-BTLQMYQL.js");
   await beaconCommand(path2, options);
 });
 program.command("ripple <symbol> [path]").description("Show change impact analysis for a symbol").option("-d, --depth <depth>", "Analysis depth (default: 1)", "1").option("--json", "Output as JSON").option("-q, --quiet", "Suppress output").action(async (symbol, path2, options) => {
-  const { rippleCommand } = await import("./ripple-DFMXLFWI.js");
+  const { rippleCommand } = await import("./ripple-QTXKJCEI.js");
   await rippleCommand(symbol, path2, options);
 });
 var threadCmd = program.command("thread").description("Session continuity - pass context between AI agent sessions");

package/dist/{lint-53GPXKKI.js → lint-MTRZB5EC.js}

@@ -4,7 +4,7 @@ import {
   parsePurposeFileDetailed,
   serializePurposeFile,
   validatePurposeFile
-} from "./chunk-MRENOFTR.js";
+} from "./chunk-VUSCJJ4A.js";
 import {
   log
 } from "./chunk-4NCFWYGG.js";

package/dist/mcp.js

@@ -76,7 +76,7 @@ import {
   validatePersona,
   validateProtocol,
   validatePurposeFile
-} from "./chunk-7IJ5JVKT.js";
+} from "./chunk-PFLWLC6J.js";
 import {
   deleteLoreEntry,
   loadLoreEntries,
@@ -6420,6 +6420,14 @@ var purposeAddComponentTool = {
         type: "array",
         items: { type: "string" },
         description: 'Component references (e.g. ["#stripe-service"])'
+      },
+      type: {
+        type: "string",
+        description: 'Component type (e.g., "view", "service", "model", "tool"). Open string per project vocabulary.'
+      },
+      parent: {
+        type: "string",
+        description: 'Parent component (e.g., "#payment-page"). Establishes hierarchy.'
       }
     },
     required: ["purposeFile", "id", "description"]
@@ -6957,7 +6965,9 @@ async function handleAddComponent(args, ctx, reloadContext2) {
     gates,
     signals,
     aspects,
-    components
+    components,
+    type: componentType,
+    parent
   } = args;
   const filePath = resolvePurposeFilePath(purposeFile, ctx.rootDir);
   const data = readPurposeFile(filePath);
@@ -6977,6 +6987,8 @@ async function handleAddComponent(args, ctx, reloadContext2) {
   if (signals !== void 0) item.signals = signals.map((s) => ensurePrefix(s, "!"));
   if (aspects !== void 0) item.aspects = aspects.map((a) => ensurePrefix(a, "~"));
   if (components !== void 0) item.components = components.map((c) => ensurePrefix(c, "#"));
+  if (componentType !== void 0) item.type = componentType;
+  if (parent !== void 0) item.parent = ensurePrefix(parent, "#");
   existing[bareId] = item;
   data[sec] = existing;
   writePurposeFile(filePath, data);
@@ -14200,6 +14212,10 @@ function registerTools(server, getContext2, reloadContext2) {
                 includeWorkspace: {
                   type: "boolean",
                   description: "Also search sibling workspace projects (default: false). Requires workspace configured in config.yaml."
+                },
+                componentType: {
+                  type: "string",
+                  description: 'Filter components by type (e.g., "view", "service", "tool"). Only applies to #component symbols.'
                 }
               },
               required: ["query"]
@@ -14382,13 +14398,16 @@ function registerTools(server, getContext2, reloadContext2) {
       const toolResult = await (async () => {
         switch (name) {
           case "paradigm_search": {
-            const { query, type, limit = 10, fuzzy = true, includeWorkspace = false } = args;
-            const cacheKey = `search:${query}:${type || ""}:${limit}:${fuzzy}:${includeWorkspace}`;
+            const { query, type, limit = 10, fuzzy = true, includeWorkspace = false, componentType } = args;
+            const cacheKey = `search:${query}:${type || ""}:${limit}:${fuzzy}:${includeWorkspace}:${componentType || ""}`;
             let results = await toolCache.getOrCompute(cacheKey, () => {
               let r = searchSymbols(ctx.index, query);
               if (type) {
                 r = r.filter((s) => s.type === type);
               }
+              if (componentType) {
+                r = r.filter((s) => s.componentType === componentType);
+              }
               return r;
             });
             let fuzzyMatches = [];
@@ -14411,7 +14430,9 @@ function registerTools(server, getContext2, reloadContext2) {
                 symbol: s.symbol,
                 type: s.type,
                 description: s.description,
-                filePath: s.filePath
+                filePath: s.filePath,
+                ...s.componentType ? { componentType: s.componentType } : {},
+                ...s.parentSymbol ? { parentSymbol: s.parentSymbol } : {}
               }))
             };
             if (fuzzyMatches.length > 0) {
@@ -14734,6 +14755,14 @@ function registerTools(server, getContext2, reloadContext2) {
                 }
               } catch {
               }
+              const allComponents = getSymbolsByType(ctx.index, "component");
+              const componentTypeBreakdown = {};
+              for (const comp of allComponents) {
+                if (comp.componentType) {
+                  componentTypeBreakdown[comp.componentType] = (componentTypeBreakdown[comp.componentType] || 0) + 1;
+                }
+              }
+              const untypedCount = allComponents.filter((c) => !c.componentType).length;
               return JSON.stringify({
                 project: ctx.projectName,
                 symbolSystem: "v2",
@@ -14745,11 +14774,17 @@ function registerTools(server, getContext2, reloadContext2) {
                   "~ aspects": counts.aspect
                 },
                 total,
+                ...Object.keys(componentTypeBreakdown).length > 0 ? {
+                  componentTypes: {
+                    ...componentTypeBreakdown,
+                    ...untypedCount > 0 ? { "(untyped)": untypedCount } : {}
+                  }
+                } : {},
                 examples,
                 hasPortalYaml: ctx.gateConfig !== null,
                 purposeFiles: ctx.aggregation.purposeFiles.length,
                 ...protocols ? { protocols } : {},
-                note: "Symbol System v2: Use tags [feature], [state], [integration], [idea] for classification",
+                note: "Symbol System v2: Use tags [feature], [state], [integration], [idea] for classification. Use type field for structural role (view, service, tool, etc.)",
                 environment: {
                   os: platform2,
                   shell,
@@ -14963,7 +14998,7 @@ Update command:
               trackToolCall(noWsText.length, name);
               return { content: [{ type: "text", text: noWsText }] };
             }
-            const { rebuildStaticFiles: rebuildStaticFiles2 } = await import("./reindex-YG3KIXAK.js");
+            const { rebuildStaticFiles: rebuildStaticFiles2 } = await import("./reindex-YC7LD4MN.js");
             const memberResults = [];
             for (const member of ctx.workspace.config.members) {
               const memberAbsPath = path29.resolve(path29.dirname(ctx.workspace.workspacePath), member.path);