@mcp-consultant-tools/figma 27.0.0 → 28.0.0-beta.10

package/build/cli/commands/ado-story-commands.d.ts

@@ -0,0 +1,7 @@
+/**
+ * ADO Story Extraction CLI Commands - maps to extract-ado-stories MCP tool
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerAdoStoryCommands(program: Command, ctx: ServiceContext): void;
+//# sourceMappingURL=ado-story-commands.d.ts.map

package/build/cli/commands/ado-story-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-story-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ado-story-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA0CpF"}

package/build/cli/commands/ado-story-commands.js

@@ -0,0 +1,46 @@
+/**
+ * ADO Story Extraction CLI Commands - maps to extract-ado-stories MCP tool
+ */
+import { getGlobalFlags, handleCliError } from '@mcp-consultant-tools/core';
+import { extractAdoStories } from '../../figma/extractors/ado-story-extractor.js';
+import { outputResult } from '../output.js';
+export function registerAdoStoryCommands(program, ctx) {
+    program
+        .command('extract-ado-stories')
+        .description('Extract ADO User Story Components from a FigJam board or section')
+        .argument('<fileKey>', 'Figma file key (alphanumeric string from URL)')
+        .option('-n, --node-id <nodeId>', 'Section node ID to scope extraction')
+        .option('--ado-org <org>', 'Azure DevOps organization name (for constructing work item links)')
+        .option('--ado-project <project>', 'Azure DevOps project name (for constructing work item links)')
+        .option('--include-placeholders', 'Include ADO components with placeholder IDs (e.g. "ADO xxxxx")', false)
+        .action(async (fileKey, opts) => {
+        try {
+            // Fetch with component properties preserved
+            const dataOptions = {
+                excludeStyles: true,
+                simplifyComponentInstances: true,
+                simplifyConnectors: true,
+                tablesToMarkdown: true,
+            };
+            const rawData = await ctx.figma.getFigmaData(fileKey, opts.nodeId, undefined, dataOptions);
+            const result = extractAdoStories(rawData, {
+                fileKey,
+                adoOrganization: opts.adoOrg,
+                adoProject: opts.adoProject,
+                includePlaceholders: opts.includePlaceholders,
+            });
+            const statesSummary = Object.entries(result.byState)
+                .map(([state, count]) => `${state}: ${count}`)
+                .join(', ');
+            outputResult({
+                fileName: `figma-ado-stories-${fileKey}`,
+                data: result,
+                summary: `Extracted ${result.totalCount} ADO story component(s) from '${fileKey}'${opts.nodeId ? ` (node: ${opts.nodeId})` : ''}${statesSummary ? ` [${statesSummary}]` : ''}`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'extract ADO stories');
+        }
+    });
+}
+//# sourceMappingURL=ado-story-commands.js.map

package/build/cli/commands/ado-story-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-story-commands.js","sourceRoot":"","sources":["../../../src/cli/commands/ado-story-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,UAAU,wBAAwB,CAAC,OAAgB,EAAE,GAAmB;IAC5E,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,kEAAkE,CAAC;SAC/E,QAAQ,CAAC,WAAW,EAAE,+CAA+C,CAAC;SACtE,MAAM,CAAC,wBAAwB,EAAE,qCAAqC,CAAC;SACvE,MAAM,CAAC,iBAAiB,EAAE,mEAAmE,CAAC;SAC9F,MAAM,CAAC,yBAAyB,EAAE,8DAA8D,CAAC;SACjG,MAAM,CAAC,wBAAwB,EAAE,gEAAgE,EAAE,KAAK,CAAC;SACzG,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,IAAS,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,4CAA4C;YAC5C,MAAM,WAAW,GAAqB;gBACpC,aAAa,EAAE,IAAI;gBACnB,0BAA0B,EAAE,IAAI;gBAChC,kBAAkB,EAAE,IAAI;gBACxB,gBAAgB,EAAE,IAAI;aACvB,CAAC;YAEF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;YAE3F,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE;gBACxC,OAAO;gBACP,eAAe,EAAE,IAAI,CAAC,MAAM;gBAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;aAC9C,CAAC,CAAC;YAEH,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;iBACjD,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC;iBAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,YAAY,CACV;gBACE,QAAQ,EAAE,qBAAqB,OAAO,EAAE;gBACxC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,aAAa,MAAM,CAAC,UAAU,iCAAiC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;aAC/K,EACD,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/build/cli/commands/figma-data-commands.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Figma Data CLI Commands - maps to get-figma-data MCP tool
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerFigmaDataCommands(program: Command, ctx: ServiceContext): void;
+//# sourceMappingURL=figma-data-commands.d.ts.map

package/build/cli/commands/figma-data-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-data-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/figma-data-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAwCrF"}

package/build/cli/commands/figma-data-commands.js

@@ -0,0 +1,44 @@
+/**
+ * Figma Data CLI Commands - maps to get-figma-data MCP tool
+ */
+import { getGlobalFlags, handleCliError } from '@mcp-consultant-tools/core';
+import { outputResult } from '../output.js';
+export function registerFigmaDataCommands(program, ctx) {
+    program
+        .command('get-data')
+        .description('Get comprehensive Figma design data in simplified, AI-friendly format')
+        .argument('<fileKey>', 'Figma file key (alphanumeric string from URL)')
+        .option('-n, --node-id <nodeId>', 'Specific node ID(s) to fetch (format: "1234:5678" or "1:10;2:20")')
+        .option('-d, --depth <depth>', 'Tree traversal depth limit')
+        .option('--no-exclude-styles', 'Include all styling info (default: excluded)')
+        .option('--no-tables-to-markdown', 'Keep TABLE nodes as nested structures (default: converted to markdown)')
+        .option('--no-simplify-connectors', 'Keep full CONNECTOR node data (default: simplified)')
+        .option('--no-simplify-components', 'Keep full INSTANCE node data (default: simplified)')
+        .option('--extractors <extractors>', 'Comma-separated list of extractors: layout,text,visuals,component')
+        .action(async (fileKey, opts) => {
+        try {
+            const extractors = opts.extractors
+                ? opts.extractors.split(',').map((e) => e.trim())
+                : undefined;
+            const dataOptions = {
+                excludeStyles: opts.excludeStyles,
+                tablesToMarkdown: opts.tablesToMarkdown,
+                simplifyConnectors: opts.simplifyConnectors,
+                simplifyComponentInstances: opts.simplifyComponents,
+                extractors,
+            };
+            const depth = opts.depth ? parseInt(opts.depth) : undefined;
+            const result = await ctx.figma.getFigmaData(fileKey, opts.nodeId, depth, dataOptions);
+            const nodeCount = Array.isArray(result.nodes) ? result.nodes.length : 0;
+            outputResult({
+                fileName: `figma-data-${fileKey}`,
+                data: result,
+                summary: `Fetched Figma data for file '${fileKey}'${opts.nodeId ? ` (node: ${opts.nodeId})` : ''} - ${nodeCount} top-level node(s)`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'get figma data');
+        }
+    });
+}
+//# sourceMappingURL=figma-data-commands.js.map

package/build/cli/commands/figma-data-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-data-commands.js","sourceRoot":"","sources":["../../../src/cli/commands/figma-data-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,UAAU,yBAAyB,CAAC,OAAgB,EAAE,GAAmB;IAC7E,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,uEAAuE,CAAC;SACpF,QAAQ,CAAC,WAAW,EAAE,+CAA+C,CAAC;SACtE,MAAM,CAAC,wBAAwB,EAAE,mEAAmE,CAAC;SACrG,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;SAC3D,MAAM,CAAC,qBAAqB,EAAE,8CAA8C,CAAC;SAC7E,MAAM,CAAC,yBAAyB,EAAE,wEAAwE,CAAC;SAC3G,MAAM,CAAC,0BAA0B,EAAE,qDAAqD,CAAC;SACzF,MAAM,CAAC,0BAA0B,EAAE,oDAAoD,CAAC;SACxF,MAAM,CAAC,2BAA2B,EAAE,mEAAmE,CAAC;SACxG,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,IAAS,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU;gBAChC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAoD;gBAC5G,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,WAAW,GAAqB;gBACpC,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;gBAC3C,0BAA0B,EAAE,IAAI,CAAC,kBAAkB;gBACnD,UAAU;aACX,CAAC;YAEF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;YAEtF,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,YAAY,CACV;gBACE,QAAQ,EAAE,cAAc,OAAO,EAAE;gBACjC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,gCAAgC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,SAAS,oBAAoB;aACpI,EACD,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;QAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACP,CAAC"}

package/build/cli/commands/image-commands.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Image Download CLI Commands - maps to download-figma-images MCP tool
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerImageCommands(program: Command, _ctx: ServiceContext): void;
+//# sourceMappingURL=image-commands.d.ts.map

package/build/cli/commands/image-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/image-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAWlF"}

package/build/cli/commands/image-commands.js

@@ -0,0 +1,20 @@
+/**
+ * Image Download CLI Commands - maps to download-figma-images MCP tool
+ */
+import { handleCliError } from '@mcp-consultant-tools/core';
+export function registerImageCommands(program, _ctx) {
+    program
+        .command('download-images')
+        .description('Download and process images from Figma designs (Coming in v2)')
+        .argument('<fileKey>', 'Figma file key')
+        .argument('<localPath>', 'Local path to save images')
+        .action(async (_fileKey, _localPath) => {
+        try {
+            throw new Error('Image download functionality is coming in v2. Use get-data for design metadata.');
+        }
+        catch (error) {
+            handleCliError(error, 'download figma images');
+        }
+    });
+}
+//# sourceMappingURL=image-commands.js.map

package/build/cli/commands/image-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-commands.js","sourceRoot":"","sources":["../../../src/cli/commands/image-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5D,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,IAAoB;IAC1E,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,+DAA+D,CAAC;SAC5E,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;SACvC,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,UAAkB,EAAE,EAAE;QACrD,IAAI,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACrG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,cAAc,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;QAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/build/cli/commands/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI Commands barrel export + combined registration
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerAllCommands(program: Command, ctx: ServiceContext): void;
+export { registerFigmaDataCommands } from './figma-data-commands.js';
+export { registerSemanticCommands } from './semantic-commands.js';
+export { registerAdoStoryCommands } from './ado-story-commands.js';
+export { registerImageCommands } from './image-commands.js';
+//# sourceMappingURL=index.d.ts.map

package/build/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAK/E;AAED,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/build/cli/commands/index.js

@@ -0,0 +1,18 @@
+/**
+ * CLI Commands barrel export + combined registration
+ */
+import { registerFigmaDataCommands } from './figma-data-commands.js';
+import { registerSemanticCommands } from './semantic-commands.js';
+import { registerAdoStoryCommands } from './ado-story-commands.js';
+import { registerImageCommands } from './image-commands.js';
+export function registerAllCommands(program, ctx) {
+    registerFigmaDataCommands(program, ctx);
+    registerSemanticCommands(program, ctx);
+    registerAdoStoryCommands(program, ctx);
+    registerImageCommands(program, ctx);
+}
+export { registerFigmaDataCommands } from './figma-data-commands.js';
+export { registerSemanticCommands } from './semantic-commands.js';
+export { registerAdoStoryCommands } from './ado-story-commands.js';
+export { registerImageCommands } from './image-commands.js';
+//# sourceMappingURL=index.js.map

package/build/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,GAAmB;IACvE,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvC,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvC,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/build/cli/commands/semantic-commands.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Semantic Extraction CLI Commands - maps to get-figma-semantic MCP tool
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerSemanticCommands(program: Command, ctx: ServiceContext): void;
+//# sourceMappingURL=semantic-commands.d.ts.map

package/build/cli/commands/semantic-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/semantic-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAyDpF"}

package/build/cli/commands/semantic-commands.js

@@ -0,0 +1,62 @@
+/**
+ * Semantic Extraction CLI Commands - maps to get-figma-semantic MCP tool
+ */
+import { getGlobalFlags, handleCliError } from '@mcp-consultant-tools/core';
+import { extractSemanticData } from '../../figma/extractors/semantic-extractor.js';
+import { outputResult } from '../output.js';
+export function registerSemanticCommands(program, ctx) {
+    program
+        .command('get-semantic')
+        .description('Extract semantically meaningful data from FigJam boards (diff-friendly)')
+        .argument('<fileKey>', 'Figma file key (alphanumeric string from URL)')
+        .option('-n, --node-id <nodeId>', 'Specific node/section ID to fetch')
+        .option('--sticky-overrides <json>', 'JSON map of hex colors to sticky categories (e.g. \'{"#FF0000":"blocker"}\')')
+        .option('--story-pattern <regex>', 'Custom regex pattern for extracting story IDs')
+        .action(async (fileKey, opts) => {
+        try {
+            // Fetch with fills preserved for sticky categorization
+            const dataOptions = {
+                excludeStyles: false, // Need fills for sticky color detection
+                simplifyConnectors: true,
+                simplifyComponentInstances: true,
+                tablesToMarkdown: true,
+            };
+            const rawData = await ctx.figma.getFigmaData(fileKey, opts.nodeId, undefined, dataOptions);
+            // Parse sticky color overrides
+            let stickyColorOverrides;
+            if (opts.stickyOverrides) {
+                try {
+                    stickyColorOverrides = JSON.parse(opts.stickyOverrides);
+                }
+                catch {
+                    throw new Error(`Invalid JSON for --sticky-overrides: ${opts.stickyOverrides}`);
+                }
+            }
+            // Parse custom story pattern
+            let customPattern;
+            if (opts.storyPattern) {
+                try {
+                    customPattern = new RegExp(opts.storyPattern, 'gi');
+                }
+                catch {
+                    throw new Error(`Invalid regex for --story-pattern: ${opts.storyPattern}`);
+                }
+            }
+            const semanticData = extractSemanticData(rawData, fileKey, opts.nodeId, {
+                stickyColorOverrides,
+                storyIdPattern: customPattern,
+            });
+            const stickyCount = semanticData.stickies?.length ?? 0;
+            const storyCount = semanticData.userStories?.length ?? 0;
+            outputResult({
+                fileName: `figma-semantic-${fileKey}`,
+                data: semanticData,
+                summary: `Extracted semantic data from '${fileKey}'${opts.nodeId ? ` (node: ${opts.nodeId})` : ''} - ${stickyCount} sticky note(s), ${storyCount} user story ref(s)`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'get figma semantic data');
+        }
+    });
+}
+//# sourceMappingURL=semantic-commands.js.map

package/build/cli/commands/semantic-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-commands.js","sourceRoot":"","sources":["../../../src/cli/commands/semantic-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,UAAU,wBAAwB,CAAC,OAAgB,EAAE,GAAmB;IAC5E,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,yEAAyE,CAAC;SACtF,QAAQ,CAAC,WAAW,EAAE,+CAA+C,CAAC;SACtE,MAAM,CAAC,wBAAwB,EAAE,mCAAmC,CAAC;SACrE,MAAM,CAAC,2BAA2B,EAAE,8EAA8E,CAAC;SACnH,MAAM,CAAC,yBAAyB,EAAE,+CAA+C,CAAC;SAClF,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,IAAS,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,uDAAuD;YACvD,MAAM,WAAW,GAAqB;gBACpC,aAAa,EAAE,KAAK,EAAE,wCAAwC;gBAC9D,kBAAkB,EAAE,IAAI;gBACxB,0BAA0B,EAAE,IAAI;gBAChC,gBAAgB,EAAE,IAAI;aACvB,CAAC;YAEF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;YAE3F,+BAA+B;YAC/B,IAAI,oBAAgE,CAAC;YACrE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,oBAAoB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC1D,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;YAED,6BAA6B;YAC7B,IAAI,aAAiC,CAAC;YACtC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,aAAa,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;gBACtD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;YAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;gBACtE,oBAAoB;gBACpB,cAAc,EAAE,aAAa;aAC9B,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;YACzD,YAAY,CACV;gBACE,QAAQ,EAAE,kBAAkB,OAAO,EAAE;gBACrC,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,iCAAiC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,WAAW,oBAAoB,UAAU,oBAAoB;aACrK,EACD,cAAc,CAAC,OAAO,CAAC,CACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,cAAc,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;QAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/build/cli/output.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI output helper for figma package.
+ * Thin wrapper setting the package-specific cache directory.
+ */
+import { type GlobalFlags } from '@mcp-consultant-tools/core';
+export declare function outputResult(opts: {
+    fileName: string;
+    data: unknown;
+    summary: string;
+}, flags: GlobalFlags): void;
+//# sourceMappingURL=output.d.ts.map

package/build/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIhG,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1D,KAAK,EAAE,WAAW,GACjB,IAAI,CAEN"}

package/build/cli/output.js

@@ -0,0 +1,10 @@
+/**
+ * CLI output helper for figma package.
+ * Thin wrapper setting the package-specific cache directory.
+ */
+import { outputResult as coreOutputResult } from '@mcp-consultant-tools/core';
+const CACHE_DIR = '.mcp-figma-cache';
+export function outputResult(opts, flags) {
+    coreOutputResult({ ...opts, cacheDir: CACHE_DIR }, flags);
+}
+//# sourceMappingURL=output.js.map

package/build/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAoB,MAAM,4BAA4B,CAAC;AAEhG,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,MAAM,UAAU,YAAY,CAC1B,IAA0D,EAC1D,KAAkB;IAElB,gBAAgB,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/build/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @mcp-consultant-tools/figma CLI
+ *
+ * Command-line interface for Figma operations.
+ * Reuses the same ServiceContext and services as the MCP server.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/build/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/build/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * @mcp-consultant-tools/figma CLI
+ *
+ * Command-line interface for Figma operations.
+ * Reuses the same ServiceContext and services as the MCP server.
+ */
+import { createCliProgram, loadEnvForCli } from '@mcp-consultant-tools/core';
+import { createServiceContext } from './context-factory.js';
+import { registerAllCommands } from './cli/commands/index.js';
+const program = createCliProgram({
+    name: 'mcp-figma-cli',
+    description: 'Figma CLI - design data extraction, semantic analysis, ADO story extraction',
+    version: '28.0.0-beta.8',
+});
+// Load env before parsing (--env-file handled by commander hook)
+program.hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    loadEnvForCli(opts.envFile);
+});
+const ctx = createServiceContext();
+registerAllCommands(program, ctx);
+program.parseAsync(process.argv).catch((error) => {
+    console.error('CLI error:', error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/build/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,OAAO,GAAG,gBAAgB,CAAC;IAC/B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,6EAA6E;IAC1F,OAAO,EAAE,eAAe;CACzB,CAAC,CAAC;AAEH,iEAAiE;AACjE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAgB,EAAE,EAAE;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;AACnC,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAElC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAU,EAAE,EAAE;IACpD,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/context-factory.d.ts

@@ -0,0 +1,4 @@
+import type { ServiceContext } from './types.js';
+export type { ServiceContext } from './types.js';
+export declare function createServiceContext(): ServiceContext;
+//# sourceMappingURL=context-factory.d.ts.map

package/build/context-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-factory.d.ts","sourceRoot":"","sources":["../src/context-factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,oBAAoB,IAAI,cAAc,CA0BrD"}

package/build/context-factory.js

@@ -0,0 +1,26 @@
+/**
+ * Shared service context factory - used by both MCP server and CLI.
+ */
+import { FigmaService } from './services/figma-service.js';
+export function createServiceContext() {
+    let service = null;
+    function getService() {
+        if (!service) {
+            if (!process.env.FIGMA_API_KEY && !process.env.FIGMA_OAUTH_TOKEN) {
+                throw new Error('Missing required Figma configuration: FIGMA_API_KEY or FIGMA_OAUTH_TOKEN');
+            }
+            const config = {
+                apiKey: process.env.FIGMA_API_KEY,
+                oauthToken: process.env.FIGMA_OAUTH_TOKEN,
+                useOAuth: process.env.FIGMA_USE_OAUTH === 'true',
+            };
+            service = new FigmaService(config);
+            console.error('Figma service initialized');
+        }
+        return service;
+    }
+    return {
+        get figma() { return getService(); },
+    };
+}
+//# sourceMappingURL=context-factory.js.map

package/build/context-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-factory.js","sourceRoot":"","sources":["../src/context-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM3D,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,GAAwB,IAAI,CAAC;IAExC,SAAS,UAAU;QACjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAgB;gBAC1B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;gBACjC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;gBACzC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM;aACjD,CAAC;YAEF,OAAO,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,IAAI,KAAK,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/build/index.d.ts

@@ -3,18 +3,14 @@
  * @mcp-consultant-tools/figma
  *
  * MCP server for Figma integration.
- * Provides design data extraction and transformation capabilities.
+ * Entry point: MCP server startup + backward-compatible registerFigmaTools().
  */
-import { FigmaService } from "./FigmaService.js";
 /**
- * Register Figma tools and prompts to an MCP server
- * @param server - The MCP server instance
- * @param figmaService - Optional pre-configured FigmaService (for testing or custom configs)
+ * Register Figma tools to an MCP server.
+ * Backward-compatible API for the meta package.
  */
-export declare function registerFigmaTools(server: any, figmaService?: FigmaService): void;
-/**
- * Export service class for direct usage
- */
-export { FigmaService } from "./FigmaService.js";
-export type { FigmaConfig, FigmaDataOptions } from "./FigmaService.js";
+export declare function registerFigmaTools(server: any): void;
+export { FigmaService } from './services/figma-service.js';
+export type { FigmaConfig, FigmaDataOptions } from './models/index.js';
+export type { ServiceContext } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAOH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMjD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,YAAY,QAsN1E;AAED;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAiDH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAGpD;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/build/index.js

@@ -3,24 +3,20 @@
  * @mcp-consultant-tools/figma
  *
  * MCP server for Figma integration.
- * Provides design data extraction and transformation capabilities.
+ * Entry point: MCP server startup + backward-compatible registerFigmaTools().
  */
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
 import { pathToFileURL } from "node:url";
 import { realpathSync } from "node:fs";
-import { createMcpServer, createEnvLoader, createErrorResponse, createSuccessResponse } from "@mcp-consultant-tools/core";
-import { FigmaService } from "./FigmaService.js";
-import { extractSemanticData } from "./figma/extractors/semantic-extractor.js";
-import { extractAdoStories } from "./figma/extractors/ado-story-extractor.js";
+import { createMcpServer, createEnvLoader } from "@mcp-consultant-tools/core";
+import { FigmaService } from './services/figma-service.js';
+import { registerAllTools } from './tools/index.js';
 /**
- * Register Figma tools and prompts to an MCP server
- * @param server - The MCP server instance
- * @param figmaService - Optional pre-configured FigmaService (for testing or custom configs)
+ * Build a ServiceContext from environment variables (lazy service initialization).
  */
-export function registerFigmaTools(server, figmaService) {
-    let service = figmaService || null;
-    function getFigmaService() {
+function createServiceContext() {
+    let service = null;
+    function getService() {
         if (!service) {
             const missingConfig = [];
             if (!process.env.FIGMA_API_KEY && !process.env.FIGMA_OAUTH_TOKEN) {
@@ -40,123 +36,23 @@ export function registerFigmaTools(server, figmaService) {
         }
         return service;
     }
-    // Tool: get-figma-data
-    server.tool("get-figma-data", "Get comprehensive Figma design data including layout, text, styles, and components. Fetches from Figma API and transforms into simplified, AI-friendly format. Can fetch entire files or specific nodes. Automatically deduplicates styles. Supports optimization options to reduce context window usage.", {
-        fileKey: z.string().describe("Figma file key (alphanumeric string from URL). Example: From 'https://figma.com/file/ABC123/MyFile', use 'ABC123'"),
-        nodeId: z.string().optional().describe("Optional specific node ID(s) to fetch. Format: '1234:5678' or multiple '1:10;2:20'. If omitted, fetches entire file."),
-        depth: z.number().optional().describe("Optional tree traversal depth limit. Useful for large files. Example: depth=3 stops after 3 levels of children."),
-        // Optimization options for reducing context window usage
-        excludeStyles: z.boolean().optional().describe("Remove all styling info (fills, strokes, effects, textStyle, opacity, borderRadius) and globalVars.styles. Useful for understanding architecture without visual details. Default: true. Set to false for full styling data."),
-        tablesToMarkdown: z.boolean().optional().describe("Convert TABLE nodes to markdown table format instead of nested node structures. Significantly reduces token usage for tables. Default: true. Set to false for full node tree."),
-        simplifyConnectors: z.boolean().optional().describe("Simplify CONNECTOR nodes to just connection endpoints (startNodeId, endNodeId, text). Preserves relationship data while removing visual properties. Default: true. Set to false for full connector data."),
-        simplifyComponentInstances: z.boolean().optional().describe("Keep componentId and componentProperties on INSTANCE nodes but remove visual styling. Ideal for ADO User Story components. Default: true. Set to false for full instance data."),
-        extractors: z.array(z.enum(["layout", "text", "visuals", "component"])).optional().describe("Override which extractors to use. Options: layout, text, visuals, component. Default uses all. Example: ['text', 'component'] for content-focused extraction."),
-    }, async ({ fileKey, nodeId, depth, excludeStyles, tablesToMarkdown, simplifyConnectors, simplifyComponentInstances, extractors }) => {
-        try {
-            const figmaService = getFigmaService();
-            // Build data options from parameters
-            const dataOptions = {
-                excludeStyles,
-                tablesToMarkdown,
-                simplifyConnectors,
-                simplifyComponentInstances,
-                extractors,
-            };
-            const result = await figmaService.getFigmaData(fileKey, nodeId, depth, dataOptions);
-            return createSuccessResponse(result);
-        }
-        catch (error) {
-            return createErrorResponse(error, "get-figma-data");
-        }
-    });
-    // Tool: get-figma-semantic
-    server.tool("get-figma-semantic", "Extract semantically meaningful data from FigJam boards while discarding positional/visual information. Produces deterministic, diff-friendly output ideal for change detection. Categorizes sticky notes by color, extracts user story IDs, and preserves connector relationships.", {
-        fileKey: z.string().describe("Figma file key (alphanumeric string from URL). Example: From 'https://figma.com/board/ABC123/MyBoard', use 'ABC123'"),
-        nodeId: z.string().optional().describe("Optional specific node/section ID to fetch. Format: '1234:5678'. If omitted, fetches entire file."),
-        stickyColorOverrides: z.record(z.enum([
-            "blocker", "tbd", "si-investigation", "done", "info", "note", "unknown"
-        ])).optional().describe("Optional color to category overrides. Map hex colors to categories. Example: {'#FF0000': 'blocker', '#00FF00': 'done'}"),
-        storyIdPattern: z.string().optional().describe("Optional custom regex pattern for extracting story IDs. Default: strict pattern requiring prefix (US787, Story #787, Task787, Bug #787)"),
-    }, async ({ fileKey, nodeId, stickyColorOverrides, storyIdPattern, }) => {
-        try {
-            const figmaService = getFigmaService();
-            // Fetch with fills preserved for sticky categorization
-            const dataOptions = {
-                excludeStyles: false, // Need fills for sticky color detection
-                simplifyConnectors: true,
-                simplifyComponentInstances: true,
-                tablesToMarkdown: true,
-            };
-            const rawData = await figmaService.getFigmaData(fileKey, nodeId, undefined, dataOptions);
-            // Parse custom story pattern if provided
-            let customPattern;
-            if (storyIdPattern) {
-                try {
-                    customPattern = new RegExp(storyIdPattern, "gi");
-                }
-                catch (e) {
-                    return createErrorResponse(new Error(`Invalid storyIdPattern regex: ${storyIdPattern}`), "get-figma-semantic");
-                }
-            }
-            // Extract semantic data
-            const semanticData = extractSemanticData(rawData, fileKey, nodeId, {
-                stickyColorOverrides,
-                storyIdPattern: customPattern,
-            });
-            return createSuccessResponse(semanticData);
-        }
-        catch (error) {
-            return createErrorResponse(error, "get-figma-semantic");
-        }
-    });
-    // Tool: extract-ado-stories
-    server.tool("extract-ado-stories", "Extract all ADO User Story Components from a FigJam board or section. Returns structured data with IDs, descriptions, states, parent context, and links. Reduces ~200K raw node data to ~5K structured result.", {
-        fileKey: z.string().describe("Figma file key (alphanumeric string from URL). Example: From 'https://figma.com/board/ABC123/MyBoard', use 'ABC123'"),
-        nodeId: z.string().optional().describe("Optional section node ID to scope extraction. Format: '1234:5678'. If omitted, extracts from entire file."),
-        adoOrganization: z.string().optional().describe("Azure DevOps organization name for constructing work item links. Example: 'myorg'"),
-        adoProject: z.string().optional().describe("Azure DevOps project name for constructing work item links. Example: 'MyProject'"),
-        includePlaceholders: z.boolean().optional().describe("Include ADO components with placeholder IDs (e.g. 'ADO xxxxx'). Default: false (placeholders are filtered out)."),
-    }, async ({ fileKey, nodeId, adoOrganization, adoProject, includePlaceholders, }) => {
-        try {
-            const figmaService = getFigmaService();
-            // Fetch with component properties preserved
-            const dataOptions = {
-                excludeStyles: true,
-                simplifyComponentInstances: true,
-                simplifyConnectors: true,
-                tablesToMarkdown: true,
-            };
-            const rawData = await figmaService.getFigmaData(fileKey, nodeId, undefined, dataOptions);
-            const result = extractAdoStories(rawData, {
-                fileKey,
-                adoOrganization,
-                adoProject,
-                includePlaceholders,
-            });
-            return createSuccessResponse(result);
-        }
-        catch (error) {
-            return createErrorResponse(error, "extract-ado-stories");
-        }
-    });
-    // Tool: download-figma-images (placeholder for v2)
-    server.tool("download-figma-images", "Download and process images from Figma designs (Coming in v2)", {
-        fileKey: z.string().describe("Figma file key"),
-        localPath: z.string().describe("Local path to save images"),
-    }, async ({ fileKey, localPath }) => {
-        return createErrorResponse(new Error("Image download functionality is coming in v2. Use get-figma-data for design metadata."), "download-figma-images");
-    });
-    console.error("Figma tools registered: 4 tools");
+    return {
+        get figma() { return getService(); },
+    };
 }
 /**
- * Export service class for direct usage
+ * Register Figma tools to an MCP server.
+ * Backward-compatible API for the meta package.
  */
-export { FigmaService } from "./FigmaService.js";
+export function registerFigmaTools(server) {
+    const ctx = createServiceContext();
+    registerAllTools(server, ctx);
+}
+// Backward-compatible exports
+export { FigmaService } from './services/figma-service.js';
 /**
  * Standalone CLI server (when run directly)
- *
- * Uses realpathSync to resolve symlinks created by npx, ensuring import.meta.url
- * matches the resolved path in process.argv[1]
+ * Uses realpathSync to resolve symlinks created by npx
  */
 if (import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
     const loadEnv = createEnvLoader();