@2amtech/hai 0.0.1

package/dist/commands/mcp/server.js

@@ -0,0 +1,80 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerPullTool } from './pull.js';
+import { registerTicketTools } from './tickets.js';
+import { readConfig } from '../../helpers/config.js';
+import '../../plugins/index.js';
+import { findPluginForCapability, extractPluginData, } from '../../schemas/config.js';
+import { getPlugin } from '../../plugins/registry.js';
+function summarizeCapability(config, capability) {
+    const entry = findPluginForCapability(config, capability);
+    if (!entry)
+        return 'not configured';
+    try {
+        const plugin = getPlugin(entry.plugin);
+        const data = extractPluginData(entry);
+        const detail = plugin.summarize?.(capability, data) ?? '';
+        return detail ? `${plugin.name} (${detail})` : plugin.name;
+    }
+    catch {
+        return `${entry.plugin} (unknown)`;
+    }
+}
+function buildProviders(config) {
+    if (!config) {
+        return "No configuration found. Run 'hai init' to set up providers.";
+    }
+    return [
+        `- **Tickets**: ${summarizeCapability(config, 'tickets')}`,
+        `- **Specs**: ${summarizeCapability(config, 'specs')}`,
+    ].join('\n');
+}
+function buildInstructions(config) {
+    return `Hai is a project management integration server that syncs tickets and specifications from remote providers to local markdown files.
+
+## Configured providers
+${buildProviders(config)}
+
+## Available tools
+
+### pullcover available specifications, then read files from \`.ai/specs/\`.
+3. Read \`.ai/ticket-index.md\` to discover available tickets, then read files from \`.ai/tickets/\`.
+4. Use \`ticket_pull\` to pull a specific tick
+Syncs tickets and/or specs from remote providers to local \`.ai/\` markdown files. Use this first to populate local data. Supports dry-run mode and selective sync (tickets only, specs only, or both).
+
+### ticket_pull
+Pulls a specific ticket by key (e.g. PROJ-123) from the remote provider and saves it locally. Only use this when the ticket is not already present in \`.ai/tickets/\`. Supports recursive fetching of linked issues.
+
+## Local data
+
+After pulling, all data is stored as markdown under \`.ai/\` for direct file access:
+
+- **Specifications**: read \`.ai/specification-index.md\` for the spec index, individual specs are in \`.ai/specs/\`
+- **Tickets**: read \`.ai/ticket-index.md\` for the ticket index, individual tickets are in \`.ai/tickets/\`
+
+To browse or search specs and tickets, read these files directly from the filesystem — no MCP tool is needed.
+
+## Typical workflow
+1. Run \`pull\` to sync tickets and specs from remote providers to local markdown files.
+2. Read \`.ai/specification-index.md\` to diset by key only if it is not already in \`.ai/tickets/\`.`;
+}
+export async function mcp(workspaceFolder) {
+    const configPath = `${workspaceFolder}/hai.json`;
+    let config = null;
+    try {
+        config = await readConfig(configPath);
+    }
+    catch {
+        // Config may not exist yet — that's fine, instructions will note it
+    }
+    const server = new McpServer({
+        name: 'hai',
+        version: '1.0.0',
+    }, {
+        instructions: buildInstructions(config),
+    });
+    registerPullTool(server, workspaceFolder);
+    registerTicketTools(server, workspaceFolder);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=server.js.map

package/dist/commands/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../source/commands/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,oBAAoB,EAAC,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAC,gBAAgB,EAAC,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,EAAC,UAAU,EAAC,MAAM,yBAAyB,CAAC;AACnD,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EACN,uBAAuB,EACvB,iBAAiB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,SAAS,EAAC,MAAM,2BAA2B,CAAC;AAGpD,SAAS,mBAAmB,CAC3B,MAAiB,EACjB,UAA0B;IAE1B,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,gBAAgB,CAAC;IACpC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,GAAG,KAAK,CAAC,MAAM,YAAY,CAAC;IACpC,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,MAAwB;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,6DAA6D,CAAC;IACtE,CAAC;IAED,OAAO;QACN,kBAAkB,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;QAC1D,gBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAwB;IAClD,OAAO;;;EAGN,cAAc,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;sGAuB8E,CAAC;AACvG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,eAAuB;IAChD,MAAM,UAAU,GAAG,GAAG,eAAe,WAAW,CAAC;IAEjD,IAAI,MAAM,GAAqB,IAAI,CAAC;IACpC,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,oEAAoE;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAC3B;QACC,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,OAAO;KAChB,EACD;QACC,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC;KACvC,CACD,CAAC;IAEF,gBAAgB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC1C,mBAAmB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/commands/mcp/specs.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSpecTools(server: McpServer, workspaceFolder: string): void;

package/dist/commands/mcp/specs.js

@@ -0,0 +1,325 @@
+import { z } from 'zod';
+import { readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { walkMdFiles } from '../../helpers/fs.js';
+import { mcpError, mcpSuccess, errorText } from './helpers.js';
+export function registerSpecTools(server, workspaceFolder) {
+    const specsDir = join(workspaceFolder, '.ai', 'specs');
+    server.registerTool('spec_get', {
+        description: 'Read a local spec file by path (relative to .ai/specs/)',
+        inputSchema: {
+            path: z
+                .string()
+                .describe("File path relative to .ai/specs/, e.g. 'my-project/overview.md'"),
+        },
+        outputSchema: {
+            path: z.string().describe('The requested spec file path'),
+            content: z
+                .string()
+                .describe('Markdown content of the spec file'),
+        },
+    }, async ({ path }) => {
+        try {
+            const fullPath = join(specsDir, path);
+            const content = await readFile(fullPath, 'utf-8');
+            return mcpSuccess({ path, content }, content);
+        }
+        catch (error) {
+            return mcpError(errorText(error));
+        }
+    });
+    server.registerTool('spec_list', {
+        description: 'List all local spec files under .ai/specs/',
+        inputSchema: {},
+        outputSchema: {
+            files: z
+                .array(z.string())
+                .describe('List of spec file paths relative to .ai/specs/'),
+            count: z.number().describe('Total number of spec files'),
+        },
+    }, async () => {
+        try {
+            const files = [];
+            for await (const fullPath of walkMdFiles(specsDir)) {
+                files.push(relative(specsDir, fullPath));
+            }
+            files.sort();
+            const structuredContent = {
+                files,
+                count: files.length,
+            };
+            return mcpSuccess(structuredContent, files.length > 0
+                ? files.join('\n')
+                : 'No spec files found. Run pull first.');
+        }
+        catch (error) {
+            return mcpError(errorText(error));
+        }
+    });
+    server.registerTool('spec_get_many', {
+        description: 'Read multiple spec files at once by paths (relative to .ai/specs/)',
+        inputSchema: {
+            paths: z
+                .array(z.string())
+                .describe("File paths relative to .ai/specs/, e.g. ['overview.md', 'api/auth.md']"),
+        },
+        outputSchema: {
+            results: z
+                .array(z.object({
+                path: z.string().describe('The requested spec file path'),
+                content: z.string().describe('Markdown content of the spec file'),
+            }))
+                .describe('Successfully read files'),
+            errors: z
+                .array(z.object({
+                path: z.string().describe('The requested spec file path'),
+                error: z.string().describe('Error message'),
+            }))
+                .describe('Files that could not be read'),
+        },
+    }, async ({ paths }) => {
+        const results = [];
+        const errors = [];
+        await Promise.all(paths.map(async (p) => {
+            try {
+                const fullPath = join(specsDir, p);
+                const content = await readFile(fullPath, 'utf-8');
+                results.push({ path: p, content });
+            }
+            catch (error) {
+                errors.push({ path: p, error: errorText(error) });
+            }
+        }));
+        results.sort((a, b) => a.path.localeCompare(b.path));
+        const structuredContent = { results, errors };
+        return mcpSuccess(structuredContent, results.map((r) => `--- ${r.path} ---\n${r.content}`).join('\n\n') +
+            (errors.length > 0
+                ? `\n\nErrors:\n${errors.map((e) => `${e.path}: ${e.error}`).join('\n')}`
+                : ''));
+    });
+    server.registerTool('spec_get_lines', {
+        description: 'Read specific line ranges from one or more spec files (relative to .ai/specs/)',
+        inputSchema: {
+            files: z
+                .array(z.object({
+                path: z
+                    .string()
+                    .describe("File path relative to .ai/specs/, e.g. 'overview.md'"),
+                start: z.number().describe('Start line number (1-based)'),
+                end: z.number().describe('End line number (1-based, inclusive)'),
+            }))
+                .describe('Files and line ranges to read'),
+        },
+        outputSchema: {
+            results: z
+                .array(z.object({
+                path: z.string().describe('The spec file path'),
+                totalLines: z
+                    .number()
+                    .describe('Total number of lines in the file'),
+                start: z.number().describe('Actual start line returned'),
+                end: z.number().describe('Actual end line returned'),
+                lines: z
+                    .string()
+                    .describe('The requested lines with line numbers'),
+            }))
+                .describe('Line range results'),
+            errors: z
+                .array(z.object({
+                path: z.string().describe('The spec file path'),
+                error: z.string().describe('Error message'),
+            }))
+                .describe('Files that could not be read'),
+        },
+    }, async ({ files }) => {
+        const results = [];
+        const errors = [];
+        await Promise.all(files.map(async ({ path: p, start, end }) => {
+            try {
+                const fullPath = join(specsDir, p);
+                const content = await readFile(fullPath, 'utf-8');
+                const allLines = content.split('\n');
+                const totalLines = allLines.length;
+                const clampedStart = Math.max(1, start);
+                const clampedEnd = Math.min(totalLines, end);
+                const selected = allLines.slice(clampedStart - 1, clampedEnd);
+                const numbered = selected
+                    .map((line, i) => `${clampedStart + i}: ${line}`)
+                    .join('\n');
+                results.push({
+                    path: p,
+                    totalLines,
+                    start: clampedStart,
+                    end: clampedEnd,
+                    lines: numbered,
+                });
+            }
+            catch (error) {
+                errors.push({ path: p, error: errorText(error) });
+            }
+        }));
+        const structuredContent = { results, errors };
+        return mcpSuccess(structuredContent, results
+            .map((r) => `--- ${r.path} (${r.totalLines} lines) [${r.start}-${r.end}] ---\n${r.lines}`)
+            .join('\n\n') +
+            (errors.length > 0
+                ? `\n\nErrors:\n${errors.map((e) => `${e.path}: ${e.error}`).join('\n')}`
+                : ''));
+    });
+    const specSearchResultSchema = z.object({
+        file: z.string().describe('Spec file path relative to .ai/specs/'),
+        matches: z
+            .array(z.string())
+            .describe('Matching lines with line numbers'),
+    });
+    server.registerTool('spec_search', {
+        description: 'Search all local spec files for a regex pattern',
+        inputSchema: {
+            pattern: z
+                .string()
+                .describe('Regular expression pattern to search for'),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Whether the search is case-sensitive'),
+        },
+        outputSchema: {
+            results: z
+                .array(specSearchResultSchema)
+                .describe('Files with matching lines'),
+            count: z
+                .number()
+                .describe('Total number of files with matches'),
+        },
+    }, async ({ pattern, caseSensitive }) => {
+        try {
+            const regex = new RegExp(pattern, caseSensitive ? 'g' : 'gi');
+            const results = [];
+            for await (const fullPath of walkMdFiles(specsDir)) {
+                const relativePath = relative(specsDir, fullPath);
+                const content = await readFile(fullPath, 'utf-8');
+                const lines = content.split('\n');
+                const matchingLines = [];
+                for (let i = 0; i < lines.length; i++) {
+                    if (regex.test(lines[i])) {
+                        matchingLines.push(`${i + 1}: ${lines[i]}`);
+                    }
+                    regex.lastIndex = 0;
+                }
+                if (matchingLines.length > 0) {
+                    results.push({
+                        file: relativePath,
+                        matches: matchingLines,
+                    });
+                }
+            }
+            results.sort((a, b) => a.file.localeCompare(b.file));
+            const structuredContent = {
+                results,
+                count: results.length,
+            };
+            return mcpSuccess(structuredContent, results.length > 0
+                ? JSON.stringify(results, null, 2)
+                : 'No matches found.');
+        }
+        catch (error) {
+            return mcpError(errorText(error));
+        }
+    });
+    const excerptChunkSchema = z.object({
+        file: z.string().describe('Spec file path (use with spec_get)'),
+        totalLines: z.number().describe('Total number of lines in the file'),
+        lines: z
+            .array(z.object({
+            number: z.number().describe('Line number (1-based)'),
+            text: z.string().describe('Line content'),
+            isMatch: z
+                .boolean()
+                .describe('Whether this line contains the match'),
+        }))
+            .describe('Excerpt lines around the match (-5 to +5)'),
+    });
+    server.registerTool('spec_search_excerpt', {
+        description: 'Search spec files and return 10-line excerpts around each match (5 lines before and after)',
+        inputSchema: {
+            pattern: z
+                .string()
+                .describe('Regular expression pattern to search for'),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Whether the search is case-sensitive'),
+        },
+        outputSchema: {
+            results: z
+                .array(excerptChunkSchema)
+                .describe('Excerpt chunks with context around matches'),
+            count: z.number().describe('Total number of excerpt chunks'),
+        },
+    }, async ({ pattern, caseSensitive }) => {
+        try {
+            const regex = new RegExp(pattern, caseSensitive ? 'g' : 'gi');
+            const results = [];
+            for await (const fullPath of walkMdFiles(specsDir)) {
+                const relativePath = relative(specsDir, fullPath);
+                const content = await readFile(fullPath, 'utf-8');
+                const allLines = content.split('\n');
+                const totalLines = allLines.length;
+                // Collect matching line indices
+                const matchIndices = [];
+                for (let i = 0; i < allLines.length; i++) {
+                    if (regex.test(allLines[i])) {
+                        matchIndices.push(i);
+                    }
+                    regex.lastIndex = 0;
+                }
+                if (matchIndices.length === 0)
+                    continue;
+                // Merge overlapping ranges and build chunks
+                const ranges = [];
+                for (const idx of matchIndices) {
+                    const start = Math.max(0, idx - 5);
+                    const end = Math.min(allLines.length - 1, idx + 5);
+                    const last = ranges[ranges.length - 1];
+                    if (last && start <= last.end + 1) {
+                        last.end = Math.max(last.end, end);
+                        last.matchSet.add(idx);
+                    }
+                    else {
+                        ranges.push({ start, end, matchSet: new Set([idx]) });
+                    }
+                }
+                for (const range of ranges) {
+                    const lines = [];
+                    for (let i = range.start; i <= range.end; i++) {
+                        lines.push({
+                            number: i + 1,
+                            text: allLines[i],
+                            isMatch: range.matchSet.has(i),
+                        });
+                    }
+                    results.push({ file: relativePath, totalLines, lines });
+                }
+            }
+            results.sort((a, b) => a.file.localeCompare(b.file));
+            const structuredContent = { results, count: results.length };
+            return mcpSuccess(structuredContent, results.length > 0
+                ? results
+                    .map((r) => {
+                    const header = `--- ${r.file} (${r.totalLines} lines) ---`;
+                    const body = r.lines
+                        .map((l) => `${l.isMatch ? '>' : ' '} ${l.number}: ${l.text}`)
+                        .join('\n');
+                    return `${header}\n${body}`;
+                })
+                    .join('\n\n')
+                : 'No matches found.');
+        }
+        catch (error) {
+            return mcpError(errorText(error));
+        }
+    });
+}
+//# sourceMappingURL=specs.js.map

package/dist/commands/mcp/specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.js","sourceRoot":"","sources":["../../../source/commands/mcp/specs.ts"],"names":[],"mappings":"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"}

package/dist/commands/mcp/tickets.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import '../../plugins/index.js';
+export declare function registerTicketTools(server: McpServer, workspaceFolder: string): void;

package/dist/commands/mcp/tickets.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readConfig } from '../../helpers/config.js';
+import '../../plugins/index.js';
+import { resolveTicketProvider } from '../../plugins/resolve.js';
+import { renderTicket } from '../../components/ticket-renderer.js';
+import { projectFromKey, fetchAllIssues, listLocalTicketKeys, } from '../../helpers/tickets.js';
+import { mcpError, mcpSuccess } from './helpers.js';
+async function writeTickets(tickets, localFiles, ticketsDir) {
+    const results = [];
+    for (const ticket of tickets) {
+        const project = projectFromKey(ticket.key);
+        const dir = join(ticketsDir, project);
+        await mkdir(dir, { recursive: true });
+        const filePath = join(ticketsDir, project, `${ticket.key}.md`);
+        const content = renderTicket(ticket, { localFiles });
+        await writeFile(filePath, content, 'utf-8');
+        results.push({ key: ticket.key, filePath, content });
+    }
+    return results;
+}
+export function registerTicketTools(server, workspaceFolder) {
+    const ticketsDir = join(workspaceFolder, '.ai', 'tickets');
+    const ticketEntrySchema = z.object({
+        key: z.string().describe('The ticket key, e.g. PROJ-123'),
+        filePath: z.string().describe('Local file path of the ticket'),
+        content: z.string().describe('Markdown content of the ticket'),
+    });
+    server.registerTool('ticket_pull', {
+        description: 'Pull a specific ticket by key from the remote provider and save it locally. Only use this when the ticket is not already present in .ai/tickets/.',
+        inputSchema: {
+            issueKey: z.string().describe('The issue key, e.g. PROJ-123'),
+            recursive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Fetch linked issues recursively'),
+        },
+        outputSchema: {
+            tickets: z
+                .array(ticketEntrySchema)
+                .describe('Pulled ticket(s)'),
+        },
+    }, async ({ issueKey, recursive }) => {
+        try {
+            const config = await readConfig(join(workspaceFolder, 'hai.json'));
+            const provider = resolveTicketProvider(config);
+            const tickets = await fetchAllIssues(provider, issueKey, recursive);
+            const localFiles = await listLocalTicketKeys(ticketsDir);
+            for (const t of tickets)
+                localFiles.add(t.key);
+            const written = await writeTickets(tickets, localFiles, ticketsDir);
+            return mcpSuccess({ tickets: written });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            let text;
+            if (message.includes('(404)')) {
+                text = `Issue '${issueKey}' not found.`;
+            }
+            else if (message.includes('(401)') ||
+                message.includes('(403)')) {
+                text =
+                    "Authentication failed. Run 'hai init' to update your credentials.";
+            }
+            else if (message.includes('not found')) {
+                text = `${message}\nRun 'hai init' to set up your configuration.`;
+            }
+            else {
+                text = message;
+            }
+            return mcpError(text);
+        }
+    });
+}
+//# sourceMappingURL=tickets.js.map

package/dist/commands/mcp/tickets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickets.js","sourceRoot":"","sources":["../../../source/commands/mcp/tickets.ts"],"names":[],"mappings":"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"}

package/dist/commands/pull.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import '../plugins/index.js';
+type Props = {
+    dryRun: boolean;
+    tickets: boolean;
+    specs: boolean;
+    updateLocal: boolean;
+};
+export default function PullCommand({ dryRun, tickets, specs, updateLocal, }: Props): React.JSX.Element;
+export {};

package/dist/commands/pull.js

@@ -0,0 +1,61 @@
+import React, { useState, useEffect } from 'react';
+import { Text } from 'ink';
+import '../plugins/index.js';
+import Spinner from '../ui/spinner.js';
+import { useConfigContext } from '../contexts/config-context.js';
+import { pullTickets, pullSpecs } from '../helpers/pull.js';
+const PHASE_FLOW = ['tickets', 'specs', 'done'];
+export default function PullCommand({ dryRun, tickets, specs, updateLocal, }) {
+    const [phases, setPhases] = useState([...PHASE_FLOW]);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (tickets) {
+            setPhases(prev => prev.slice(1));
+        }
+        else if (specs) {
+            setPhases(prev => prev.slice(2));
+        }
+        else {
+            setPhases(['done']);
+        }
+    }, [tickets, specs]);
+    if (error) {
+        return React.createElement(Text, { color: "red" },
+            "Error during pull: ",
+            error.message);
+    }
+    return (React.createElement(RenderPhase, { key: phases[0], phase: phases[0], isDryRun: dryRun, shouldUpdateLocal: updateLocal, onNextPhase: () => setPhases(prev => prev.slice(1)), onError: setError }));
+}
+function RenderPhase({ phase, onNextPhase, onError, isDryRun, shouldUpdateLocal, }) {
+    switch (phase) {
+        case 'init':
+            return React.createElement(Text, null, "Loading...");
+        case 'tickets':
+            return (React.createElement(TicketSync, { phase: phase, onNextPhase: onNextPhase, isDryRun: isDryRun, shouldUpdateLocal: shouldUpdateLocal, onError: onError }));
+        case 'specs':
+            return (React.createElement(SpecSync, { phase: phase, onNextPhase: onNextPhase, isDryRun: isDryRun, shouldUpdateLocal: shouldUpdateLocal, onError: onError }));
+        default:
+            return React.createElement(Text, null, "All done!");
+    }
+}
+function TicketSync({ onNextPhase, onError, isDryRun, shouldUpdateLocal, }) {
+    const { config } = useConfigContext();
+    useEffect(() => {
+        pullTickets(config, {
+            dryRun: isDryRun,
+            updateLocal: shouldUpdateLocal,
+        }).then(onNextPhase, onError);
+    }, [config, isDryRun, shouldUpdateLocal, onNextPhase, onError]);
+    return React.createElement(Spinner, { label: "Syncing tickets..." });
+}
+function SpecSync({ onNextPhase, onError, isDryRun, shouldUpdateLocal, }) {
+    const { config } = useConfigContext();
+    useEffect(() => {
+        pullSpecs(config, {
+            dryRun: isDryRun,
+            updateLocal: shouldUpdateLocal,
+        }).then(onNextPhase, onError);
+    }, [config, isDryRun, shouldUpdateLocal, onNextPhase, onError]);
+    return React.createElement(Spinner, { label: "Syncing specs..." });
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.js","sourceRoot":"","sources":["../../source/commands/pull.tsx"],"names":[],"mappings":"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"}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export default function StatusCommand(): React.JSX.Element;