@planu/cli 0.15.2

package/dist/tools/generate-tests-mobile.js

@@ -0,0 +1,300 @@
+// tools/generate-tests-mobile.ts — Mobile platform test scaffold generators
+// iOS (XCTest) and Android (JUnit5 + MockK/Mockito/Compose/Espresso) content
+function toPascalMobile(str) {
+    return str
+        .replace(/[^a-zA-Z0-9\s]/g, '')
+        .split(/\s+/)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+        .join('');
+}
+export function generateXCTestContent(specId, testType) {
+    const cls = toPascalMobile(specId);
+    if (testType === 'ui') {
+        return [
+            `// XCUITest for: ${specId}`,
+            '// Generated by Planu SDD MCP Server',
+            '',
+            'import XCTest',
+            '',
+            `final class ${cls}UITests: XCTestCase {`,
+            '    private var app: XCUIApplication!',
+            '',
+            '    override func setUp() {',
+            '        super.setUp()',
+            '        continueAfterFailure = false',
+            '        app = XCUIApplication()',
+            '        app.launch()',
+            '    }',
+            '',
+            '    override func tearDown() {',
+            '        app = nil',
+            '        super.tearDown()',
+            '    }',
+            '',
+            '    func test_mainElement_isVisible() throws {',
+            `        let element = app.otherElements["${cls.toLowerCase()}-container"]`,
+            '        XCTAssertTrue(element.exists)',
+            '    }',
+            '',
+            '    func test_primaryAction_triggersExpectedState() throws {',
+            `        let button = app.buttons["${cls.toLowerCase()}-primary-action"]`,
+            '        XCTAssertTrue(button.exists)',
+            '        button.tap()',
+            '        // TODO: Assert expected state after tap',
+            '    }',
+            '}',
+        ].join('\n');
+    }
+    if (testType === 'snapshot') {
+        return [
+            `// Snapshot tests for: ${specId}`,
+            '// Generated by Planu SDD MCP Server',
+            '// Requires: swift-snapshot-testing (PointFree)',
+            '',
+            'import XCTest',
+            'import SnapshotTesting',
+            '',
+            `final class ${cls}SnapshotTests: XCTestCase {`,
+            '    override func setUp() {',
+            '        super.setUp()',
+            '        // isRecording = true // Uncomment to record new snapshots',
+            '    }',
+            '',
+            '    func test_view_rendersCorrectly() throws {',
+            `        let sut = ${cls}ViewController()`,
+            '        assertSnapshot(matching: sut, as: .image)',
+            '    }',
+            '',
+            '    func test_view_rendersCorrectly_darkMode() throws {',
+            `        let sut = ${cls}ViewController()`,
+            '        assertSnapshot(matching: sut, as: .image(traits: .init(userInterfaceStyle: .dark)))',
+            '    }',
+            '}',
+        ].join('\n');
+    }
+    // Default: unit
+    return [
+        `// Unit tests for: ${specId}`,
+        '// Generated by Planu SDD MCP Server',
+        '',
+        'import XCTest',
+        '',
+        `final class ${cls}Tests: XCTestCase {`,
+        `    private var sut: ${cls}!`,
+        '',
+        '    override func setUp() {',
+        '        super.setUp()',
+        `        sut = ${cls}()`,
+        '    }',
+        '',
+        '    override func tearDown() {',
+        '        sut = nil',
+        '        super.tearDown()',
+        '    }',
+        '',
+        '    func test_coreLogic_returnsExpectedValue() throws {',
+        '        // TODO: Implement test',
+        '        XCTAssertNotNil(sut)',
+        '    }',
+        '',
+        '    func test_edgeCase_handledGracefully() throws {',
+        '        XCTAssertTrue(true)',
+        '    }',
+        '',
+        '    func test_invalidInput_throwsError() throws {',
+        '        // TODO: Implement error handling test',
+        '        XCTAssertThrowsError(try sut.performAction(with: nil))',
+        '    }',
+        '}',
+    ].join('\n');
+}
+export function generateAndroidTestContent(specId, testType, uiFramework, mockFramework) {
+    const cls = toPascalMobile(specId);
+    if (testType === 'ui') {
+        return uiFramework === 'compose'
+            ? buildComposeUITest(specId, cls)
+            : buildEspressoUITest(specId, cls);
+    }
+    if (testType === 'integration') {
+        return buildRobolectricTest(specId, cls);
+    }
+    return mockFramework === 'mockito'
+        ? buildMockitoUnitTest(specId, cls)
+        : buildMockKUnitTest(specId, cls);
+}
+function buildComposeUITest(specId, cls) {
+    return [
+        `// Compose UI tests for: ${specId}`,
+        '// Generated by Planu SDD MCP Server',
+        '',
+        'import androidx.compose.ui.test.junit4.createComposeRule',
+        'import androidx.compose.ui.test.onNodeWithTag',
+        'import androidx.compose.ui.test.performClick',
+        'import androidx.compose.ui.test.assertIsDisplayed',
+        'import org.junit.Rule',
+        'import org.junit.Test',
+        '',
+        `class ${cls}ComposeTest {`,
+        '    @get:Rule',
+        '    val composeTestRule = createComposeRule()',
+        '',
+        '    @Test',
+        '    fun mainContent_isDisplayed() {',
+        '        composeTestRule.setContent {',
+        `            ${cls}Screen()`,
+        '        }',
+        `        composeTestRule.onNodeWithTag("${cls.toLowerCase()}-container")`,
+        '            .assertIsDisplayed()',
+        '    }',
+        '',
+        '    @Test',
+        '    fun primaryAction_triggersExpectedState() {',
+        '        composeTestRule.setContent {',
+        `            ${cls}Screen()`,
+        '        }',
+        `        composeTestRule.onNodeWithTag("${cls.toLowerCase()}-primary-action")`,
+        '            .performClick()',
+        '        // TODO: Assert expected state',
+        '    }',
+        '}',
+    ].join('\n');
+}
+function buildEspressoUITest(specId, cls) {
+    return [
+        `// Espresso UI tests for: ${specId}`,
+        '// Generated by Planu SDD MCP Server',
+        '',
+        'import androidx.test.espresso.Espresso.onView',
+        'import androidx.test.espresso.action.ViewActions.click',
+        'import androidx.test.espresso.matcher.ViewMatchers.withId',
+        'import androidx.test.ext.junit.runners.AndroidJUnit4',
+        'import org.junit.Test',
+        'import org.junit.runner.RunWith',
+        '',
+        '@RunWith(AndroidJUnit4::class)',
+        `class ${cls}EspressoTest {`,
+        '    @Test',
+        '    fun button_click_triggersExpectedBehavior() {',
+        '        // TODO: Launch activity via ActivityScenario',
+        `        onView(withId(R.id.${cls.toLowerCase()}_button)).perform(click())`,
+        '        // TODO: Assert expected state',
+        '    }',
+        '}',
+    ].join('\n');
+}
+function buildRobolectricTest(specId, cls) {
+    return [
+        `// Robolectric integration tests for: ${specId}`,
+        '// Generated by Planu SDD MCP Server',
+        '',
+        'import org.junit.Test',
+        'import org.junit.runner.RunWith',
+        'import org.robolectric.RobolectricTestRunner',
+        'import org.robolectric.annotation.Config',
+        '',
+        '@RunWith(RobolectricTestRunner::class)',
+        '@Config(sdk = [33])',
+        `class ${cls}IntegrationTest {`,
+        '    @Test',
+        '    fun component_initializesCorrectly() {',
+        '        // TODO: Implement integration test',
+        '    }',
+        '',
+        '    @Test',
+        '    fun component_handlesLifecycleEvents() {',
+        '        // TODO: Test lifecycle transitions',
+        '    }',
+        '}',
+    ].join('\n');
+}
+function buildMockitoUnitTest(specId, cls) {
+    return [
+        `// Unit tests for: ${specId}`,
+        '// Generated by Planu SDD MCP Server',
+        '',
+        'import org.junit.jupiter.api.Test',
+        'import org.junit.jupiter.api.extension.ExtendWith',
+        'import org.mockito.InjectMocks',
+        'import org.mockito.Mock',
+        'import org.mockito.junit.jupiter.MockitoExtension',
+        'import org.mockito.kotlin.whenever',
+        'import org.junit.jupiter.api.Assertions.assertNotNull',
+        '',
+        '@ExtendWith(MockitoExtension::class)',
+        `class ${cls}Test {`,
+        '    @Mock',
+        `    private lateinit var dependency: ${cls}Dependency`,
+        '',
+        '    @InjectMocks',
+        `    private lateinit var sut: ${cls}`,
+        '',
+        '    @Test',
+        '    fun coreLogic_returnsExpectedValue() {',
+        '        whenever(dependency.getData()).thenReturn(listOf())',
+        '        val result = sut.execute()',
+        '        assertNotNull(result)',
+        '    }',
+        '',
+        '    @Test',
+        '    fun edgeCase_handledGracefully() {',
+        '        whenever(dependency.getData()).thenReturn(null)',
+        '        val result = sut.execute()',
+        '        assertNotNull(result)',
+        '    }',
+        '',
+        '    @Test',
+        '    fun invalidInput_throwsException() {',
+        '        // TODO: Implement error case',
+        '    }',
+        '}',
+    ].join('\n');
+}
+function buildMockKUnitTest(specId, cls) {
+    return [
+        `// Unit tests for: ${specId}`,
+        '// Generated by Planu SDD MCP Server',
+        '',
+        'import io.mockk.every',
+        'import io.mockk.impl.annotations.MockK',
+        'import io.mockk.verify',
+        'import org.junit.jupiter.api.BeforeEach',
+        'import org.junit.jupiter.api.Test',
+        'import org.junit.jupiter.api.extension.ExtendWith',
+        'import io.mockk.junit5.MockKExtension',
+        'import org.junit.jupiter.api.Assertions.assertNotNull',
+        '',
+        '@ExtendWith(MockKExtension::class)',
+        `class ${cls}Test {`,
+        '    @MockK',
+        `    private lateinit var dependency: ${cls}Dependency`,
+        '',
+        `    private lateinit var sut: ${cls}`,
+        '',
+        '    @BeforeEach',
+        '    fun setUp() {',
+        `        sut = ${cls}(dependency)`,
+        '    }',
+        '',
+        '    @Test',
+        '    fun coreLogic_returnsExpectedValue() {',
+        '        every { dependency.getData() } returns listOf()',
+        '        val result = sut.execute()',
+        '        assertNotNull(result)',
+        '        verify { dependency.getData() }',
+        '    }',
+        '',
+        '    @Test',
+        '    fun edgeCase_handledGracefully() {',
+        '        every { dependency.getData() } returns emptyList()',
+        '        val result = sut.execute()',
+        '        assertNotNull(result)',
+        '    }',
+        '',
+        '    @Test',
+        '    fun invalidInput_throwsException() {',
+        '        // TODO: Implement error case',
+        '    }',
+        '}',
+    ].join('\n');
+}
+//# sourceMappingURL=generate-tests-mobile.js.map

package/dist/tools/generate-tests-mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests-mobile.js","sourceRoot":"","sources":["../../src/tools/generate-tests-mobile.ts"],"names":[],"mappings":"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"}

package/dist/tools/generate-tests.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateTestPlanInput, ToolResult } from '../types/index.js';
+export declare function handleGenerateTests(args: GenerateTestPlanInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-tests.d.ts.map

package/dist/tools/generate-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.d.ts","sourceRoot":"","sources":["../../src/tools/generate-tests.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,qBAAqB,EAIrB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAa3B,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAgM1F"}

package/dist/tools/generate-tests.js

@@ -0,0 +1,173 @@
+// tools/generate-tests.ts — Generate test scaffold from spec
+// Uses project knowledge + spec to create test definitions
+import { t, ti } from '../i18n/index.js';
+import { knowledgeStore, specStore } from '../storage/index.js';
+import { generateUnitTestContent, generateIntegrationTestContent, generateE2eTestContent, buildTestCommands, } from './generate-tests-content.js';
+import { buildContractMockSummaryLines } from './generate-tests/adapters/contract-testing-adapter.js';
+import { handlePlanMode } from './generate-tests/plan-mode-handler.js';
+import { runSpecializedGenerators } from './generate-tests/spec-dispatcher.js';
+import { inferTestFramework, inferTestDir, getTestExt, generateUnitTestDefs, generateIntegrationTestDefs, generateE2eTestDefs, } from './generate-tests/test-helpers.js';
+export async function handleGenerateTests(args) {
+    const { specId, projectId, autoGenerate = false } = args;
+    const knowledge = await knowledgeStore.getKnowledge(projectId);
+    if (!knowledge) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.projectNotFound', { projectId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // SPEC-058a: Plan mode — generate full layered test plan for the project
+    if (specId === '_plan') {
+        return handlePlanMode(projectId, knowledge);
+    }
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('errors.specNotFound', { specId }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Determine test framework from project knowledge
+    const testFramework = inferTestFramework(knowledge.language, knowledge.stack);
+    const testDir = inferTestDir(knowledge.language);
+    const testExt = getTestExt(knowledge.language);
+    // Generate test definitions based on spec
+    const unitTests = generateUnitTestDefs(spec.title, spec.target, testDir);
+    const integrationTests = generateIntegrationTestDefs(spec.title, spec.target, testDir);
+    const e2eTests = generateE2eTestDefs(spec.title, spec.target, testDir);
+    // Generate test files with scaffolding
+    const testFiles = [];
+    const slug = spec.id.toLowerCase().replace(/[^a-z0-9]/g, '-');
+    // Unit test file
+    testFiles.push({
+        path: `${testDir}/unit/${slug}.test.${testExt}`,
+        framework: testFramework,
+        content: generateUnitTestContent(spec.title, spec.target, testFramework, knowledge.language),
+        ready: autoGenerate,
+    });
+    // Integration test file
+    if (spec.target === 'backend' || spec.target === 'fullstack') {
+        testFiles.push({
+            path: `${testDir}/integration/${slug}.integration.test.${testExt}`,
+            framework: testFramework,
+            content: generateIntegrationTestContent(spec.title, testFramework, knowledge.language),
+            ready: autoGenerate,
+        });
+    }
+    // E2E test file
+    if (spec.target === 'frontend' || spec.target === 'fullstack') {
+        const e2eFramework = knowledge.stack.includes('playwright')
+            ? 'playwright'
+            : knowledge.stack.includes('cypress')
+                ? 'cypress'
+                : 'playwright';
+        testFiles.push({
+            path: `${testDir}/e2e/${slug}.e2e.test.${testExt}`,
+            framework: e2eFramework,
+            content: generateE2eTestContent(spec.title, e2eFramework),
+            ready: autoGenerate,
+        });
+    }
+    // Dispatch spec-specific generators (agents, smart contracts, ML, games, MCP, events, etc.)
+    const { isApiSpec } = runSpecializedGenerators({ spec, knowledge, testDir, testFramework, slug, autoGenerate, testExt }, unitTests, integrationTests, testFiles);
+    const commands = buildTestCommands(knowledge.testCommand, testFramework);
+    const result = {
+        unitTests,
+        integrationTests,
+        e2eTests,
+        manualTests: [
+            `Manually verify ${spec.title} in development environment`,
+            'Check edge cases not covered by automated tests',
+            'Verify visual appearance matches design',
+        ],
+        coverageTarget: 80,
+        testFiles,
+        commands,
+    };
+    // Format output
+    const lines = [
+        `## ${t('tools.generate_tests.description')}`,
+        '',
+        `**Spec:** ${spec.title} (\`${spec.id}\`)`,
+        `**Framework:** ${testFramework}`,
+        `**Coverage target:** ${result.coverageTarget}%`,
+        '',
+    ];
+    if (result.unitTests.length > 0) {
+        lines.push('### Unit Tests');
+        lines.push('');
+        for (const test of result.unitTests) {
+            lines.push(`- **${test.name}** (${test.priority}) — ${test.description}`);
+            lines.push(`  File: \`${test.file}\``);
+        }
+        lines.push('');
+    }
+    if (result.integrationTests.length > 0) {
+        lines.push('### Integration Tests');
+        lines.push('');
+        for (const test of result.integrationTests) {
+            lines.push(`- **${test.name}** (${test.priority}) — ${test.description}`);
+            lines.push(`  File: \`${test.file}\``);
+        }
+        lines.push('');
+    }
+    if (result.e2eTests.length > 0) {
+        lines.push('### E2E Tests');
+        lines.push('');
+        for (const test of result.e2eTests) {
+            lines.push(`- **${test.name}** (${test.priority}) — ${test.description}`);
+            lines.push(`  File: \`${test.file}\``);
+        }
+        lines.push('');
+    }
+    if (result.manualTests.length > 0) {
+        lines.push('### Manual Tests');
+        lines.push('');
+        for (const test of result.manualTests) {
+            lines.push(`- [ ] ${test}`);
+        }
+        lines.push('');
+    }
+    // SPEC-018: Contract + mock summary (API specs only)
+    if (isApiSpec) {
+        lines.push(...buildContractMockSummaryLines(spec.title, knowledge));
+    }
+    // Show generated files
+    if (result.testFiles.length > 0) {
+        lines.push('### Generated Test Files');
+        lines.push('');
+        for (const file of result.testFiles) {
+            lines.push(`#### \`${file.path}\``);
+            lines.push('');
+            const ext = file.path.endsWith('.py') ? 'python' : 'typescript';
+            lines.push(`\`\`\`${ext}`);
+            lines.push(file.content);
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    // Commands
+    if (result.commands.length > 0) {
+        lines.push('### Commands');
+        lines.push('');
+        lines.push('```bash');
+        for (const cmd of result.commands) {
+            lines.push(cmd);
+        }
+        lines.push('```');
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/tools/generate-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.js","sourceRoot":"","sources":["../../src/tools/generate-tests.ts"],"names":[],"mappings":"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"}

package/dist/tools/git/branch-ops.d.ts

@@ -0,0 +1,4 @@
+import type { ToolResult, GitConfig } from '../../types/index.js';
+export declare function handleCreateBranch(projectId: string, specId: string | undefined, config?: GitConfig): Promise<ToolResult>;
+export declare function handleCheckBranch(projectId: string, _specId: string | undefined, config?: GitConfig): Promise<ToolResult>;
+//# sourceMappingURL=branch-ops.d.ts.map

package/dist/tools/git/branch-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/git/branch-ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAmB,MAAM,sBAAsB,CAAC;AAYnF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,UAAU,CAAC,CA8DrB;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,UAAU,CAAC,CAsDrB"}

package/dist/tools/git/branch-ops.js

@@ -0,0 +1,106 @@
+import { specStore } from '../../storage/index.js';
+import { ti } from '../../i18n/index.js';
+import { git, resolveProjectPath, slugify, mergeConfig, DEFAULT_BRANCH_PREFIXES, DEFAULT_PROTECTED_BRANCHES, } from './git-helpers.js';
+export async function handleCreateBranch(projectId, specId, config) {
+    if (!specId) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: 'specId is required for create-branch action' }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const projectPath = await resolveProjectPath(projectId);
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [
+                { type: 'text', text: JSON.stringify({ error: `Spec '${specId}' not found` }, null, 2) },
+            ],
+            isError: true,
+        };
+    }
+    const mergedConfig = mergeConfig(config);
+    /* v8 ignore start */
+    const prefixes = mergedConfig.branchPrefix ?? DEFAULT_BRANCH_PREFIXES;
+    const prefix = prefixes[spec.type] ?? 'feat';
+    /* v8 ignore end */
+    const slug = slugify(spec.title);
+    const branchName = `${prefix}/${specId}-${slug}`;
+    // Check if branch already exists
+    try {
+        const { stdout } = await git(projectPath, ['branch', '--list', branchName]);
+        if (stdout.trim().length > 0) {
+            await git(projectPath, ['checkout', branchName]);
+            const result = {
+                action: 'create-branch',
+                branchName,
+                message: `Switched to existing branch '${branchName}'`,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+    }
+    catch {
+        // branch list failed — proceed with creation
+    }
+    await git(projectPath, ['checkout', '-b', branchName]);
+    await specStore.updateSpec(projectId, specId, { gitBranch: branchName });
+    const result = {
+        action: 'create-branch',
+        branchName,
+        message: ti('tools.manage_git.success', { action: 'create-branch' }),
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+export async function handleCheckBranch(projectId, _specId, config) {
+    const projectPath = await resolveProjectPath(projectId);
+    const { stdout: currentBranch } = await git(projectPath, ['rev-parse', '--abbrev-ref', 'HEAD']);
+    const branch = currentBranch.trim();
+    const mergedConfig = mergeConfig(config);
+    /* v8 ignore start */
+    const protectedBranches = mergedConfig.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES;
+    /* v8 ignore end */
+    const isProtected = protectedBranches.includes(branch);
+    const conventionPattern = /^(feat|fix|refactor|infra|docs|project)\/SPEC-\d{3}-/;
+    const followsConvention = conventionPattern.test(branch);
+    const specIdMatch = /SPEC-\d{3}/.exec(branch);
+    const branchSpecId = specIdMatch ? specIdMatch[0] : null;
+    let specExists = false;
+    if (branchSpecId) {
+        const spec = await specStore.getSpec(projectId, branchSpecId);
+        specExists = spec !== null;
+    }
+    const issues = [];
+    if (isProtected) {
+        issues.push(`Currently on protected branch '${branch}'. Create a feature branch for changes.`);
+    }
+    if (!followsConvention && !isProtected) {
+        issues.push(`Branch '${branch}' does not follow Planu naming convention: <type>/SPEC-XXX-<slug>`);
+    }
+    if (branchSpecId && !specExists) {
+        issues.push(`Spec '${branchSpecId}' referenced in branch name not found in project.`);
+    }
+    const result = {
+        action: 'check-branch',
+        branchName: branch,
+        isProtected,
+        followsConvention,
+        linkedSpecId: branchSpecId,
+        specExists,
+        issues,
+        message: issues.length === 0
+            ? `Branch '${branch}' is valid`
+            : `Branch '${branch}' has ${issues.length} issue(s)`,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+}
+//# sourceMappingURL=branch-ops.js.map

package/dist/tools/git/branch-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-ops.js","sourceRoot":"","sources":["../../../src/tools/git/branch-ops.ts"],"names":[],"mappings":"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"}

package/dist/tools/git/breaking-ops.d.ts

@@ -0,0 +1,5 @@
+import type { ToolResult } from '../../types/index.js';
+export declare function handleBreakingCheck(projectId: string, config?: {
+    baseBranch?: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=breaking-ops.d.ts.map

package/dist/tools/git/breaking-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/git/breaking-ops.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,sBAAsB,CAAC;AAG3F,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,UAAU,CAAC,CAuDrB"}