@planu/cli 0.89.0 → 0.90.1

package/dist/tools/suggest-tooling.test.js

@@ -0,0 +1,213 @@
+// Tests for handleSuggestTooling
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    t: (key) => key,
+    ti: (key, _vars) => key,
+}));
+vi.mock('../storage/index.js', () => ({
+    knowledgeStore: { getKnowledge: vi.fn() },
+}));
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn(),
+}));
+import { handleSuggestTooling } from './suggest-tooling.js';
+import { knowledgeStore } from '../storage/index.js';
+import { readFile } from 'node:fs/promises';
+const mockGetKnowledge = vi.mocked(knowledgeStore.getKnowledge);
+const mockReadFile = vi.mocked(readFile);
+const baseKnowledge = {
+    language: 'typescript',
+    framework: 'express',
+    projectPath: '/test',
+    stack: ['eslint', 'docker'],
+    conventions: { prettier: true },
+    architecture: { primary: 'monolith', secondary: [], layers: [] },
+    database: 'postgresql',
+    testCommand: 'npm test',
+    buildCommand: 'npm run build',
+    linting: { detectedLinters: [{ tool: 'eslint', version: '8.0.0' }] },
+    apiContracts: [],
+    layers: [],
+};
+const catalogContent = JSON.stringify({
+    _description: 'Dev lifecycle catalog',
+    testing: {
+        why: 'Automated testing ensures quality',
+        tools: {
+            vitest: { name: 'Vitest', docsUrl: 'https://vitest.dev', sdks: { typescript: 'vitest' } },
+        },
+    },
+    linting_formatting: {
+        why: 'Code consistency',
+        tools: {
+            eslint: { name: 'ESLint', docsUrl: 'https://eslint.org', sdks: { typescript: 'eslint' } },
+        },
+    },
+    containerization: {
+        why: 'Portable deployments',
+        tools: {
+            docker: { name: 'Docker', docsUrl: 'https://docker.com' },
+        },
+    },
+    ci_cd: {
+        why: 'Continuous integration',
+        tools: {
+            'github-actions': { name: 'GitHub Actions', docsUrl: 'https://github.com/features/actions' },
+        },
+    },
+    feature_flags: {
+        why: 'Progressive rollouts and experimentation',
+        tools: {
+            launchdarkly: { name: 'LaunchDarkly', docsUrl: 'https://launchdarkly.com' },
+        },
+    },
+    empty_category: {
+        why: 'Category with no tools defined',
+        tools: {},
+    },
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+    mockReadFile.mockResolvedValue(catalogContent);
+});
+describe('handleSuggestTooling', () => {
+    it('should return error when project not found', async () => {
+        mockGetKnowledge.mockResolvedValue(null);
+        const result = await handleSuggestTooling({ projectId: 'missing' });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('errors.projectNotFound');
+    });
+    it('should detect existing tools from stack', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        const result = await handleSuggestTooling({ projectId: 'proj-1' });
+        expect(result.isError).toBeUndefined();
+        const text = result.content[0].text;
+        expect(text).toContain('Maturity score');
+        expect(text).toContain('Current Tooling');
+        expect(text).toContain('ESLint');
+        expect(text).toContain('Docker');
+    });
+    it('should identify gaps for missing categories', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            stack: [],
+            conventions: {},
+            linting: { detectedLinters: [] },
+        });
+        const result = await handleSuggestTooling({ projectId: 'proj-1' });
+        const text = result.content[0].text;
+        expect(text).toContain('Gaps');
+        expect(text).toContain('Recommendations');
+    });
+    it('should filter by specific categories', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        const result = await handleSuggestTooling({
+            projectId: 'proj-1',
+            categories: ['testing'],
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('Maturity score');
+        // Only testing category checked
+    });
+    it('should show correct importance labels in gaps', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            stack: [],
+            conventions: {},
+            linting: { detectedLinters: [] },
+        });
+        const result = await handleSuggestTooling({
+            projectId: 'proj-1',
+            categories: ['ci_cd', 'linting_formatting', 'testing'],
+        });
+        const text = result.content[0].text;
+        // ci_cd is critical, linting_formatting is recommended, testing is critical
+        expect(text).toContain('[CRITICAL]');
+        expect(text).toContain('[RECOMMENDED]');
+    });
+    it('should classify nice-to-have gaps for non-critical non-recommended categories', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            stack: [],
+            conventions: {},
+            linting: { detectedLinters: [] },
+        });
+        const result = await handleSuggestTooling({
+            projectId: 'proj-1',
+            categories: ['feature_flags'],
+        });
+        const text = result.content[0].text;
+        expect(text).toContain('[NICE-TO-HAVE]');
+        expect(text).toContain('LaunchDarkly');
+        expect(text).toContain('low');
+    });
+    it('should skip categories not present in catalog', async () => {
+        mockGetKnowledge.mockResolvedValue(baseKnowledge);
+        const result = await handleSuggestTooling({
+            projectId: 'proj-1',
+            categories: ['version_control', 'security'],
+        });
+        // Both categories are not in the mock catalog, so they are skipped
+        const text = result.content[0].text;
+        expect(text).toContain('Maturity score');
+        expect(text).toContain('0%');
+    });
+    it('should handle category with empty tools without recommending', async () => {
+        mockGetKnowledge.mockResolvedValue({
+            ...baseKnowledge,
+            stack: [],
+            conventions: {},
+            linting: { detectedLinters: [] },
+        });
+        const result = await handleSuggestTooling({
+            projectId: 'proj-1',
+            categories: ['empty_category'],
+        });
+        const text = result.content[0].text;
+        // Gap should be detected but no recommendation since no tools exist
+        expect(text).toContain('Gaps');
+        expect(text).toContain('empty_category');
+        // No recommendations section since toolEntries is empty
+        expect(text).not.toContain('Recommendations');
+    });
+});
+// Separate describe to reset modules and test catalog load failure (line 35)
+describe('handleSuggestTooling — catalog load failure', () => {
+    it('should return empty catalog when readFile throws', async () => {
+        // Reset modules to clear the cached catalog from prior tests
+        vi.resetModules();
+        vi.mock('../i18n/index.js', () => ({
+            t: (key) => key,
+            ti: (key, _vars) => key,
+        }));
+        vi.mock('../storage/index.js', () => ({
+            knowledgeStore: { getKnowledge: vi.fn() },
+        }));
+        vi.mock('node:fs/promises', () => ({
+            readFile: vi.fn(),
+        }));
+        const freshReadFile = vi.mocked((await import('node:fs/promises')).readFile);
+        freshReadFile.mockRejectedValue(new Error('File not found'));
+        const freshKnowledge = vi.mocked((await import('../storage/index.js')).knowledgeStore.getKnowledge);
+        freshKnowledge.mockResolvedValue({
+            language: 'typescript',
+            framework: 'express',
+            projectPath: '/test',
+            stack: ['eslint'],
+            conventions: {},
+            architecture: { primary: 'monolith', secondary: [], layers: [] },
+            database: 'postgresql',
+            testCommand: 'npm test',
+            buildCommand: 'npm run build',
+            linting: { detectedLinters: [{ tool: 'eslint', version: '8.0.0' }] },
+            apiContracts: [],
+            layers: [],
+        });
+        const freshHandler = (await import('./suggest-tooling.js')).handleSuggestTooling;
+        const result = await freshHandler({ projectId: 'proj-1' });
+        expect(result.isError).toBeUndefined();
+        const text = result.content[0].text;
+        expect(text).toContain('0%');
+    });
+});
+//# sourceMappingURL=suggest-tooling.test.js.map

package/dist/tools/suggest-tooling.test.js.map

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

package/dist/tools/summarize-spec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=summarize-spec.test.d.ts.map

package/dist/tools/summarize-spec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-spec.test.d.ts","sourceRoot":"","sources":["../../src/tools/summarize-spec.test.ts"],"names":[],"mappings":""}

package/dist/tools/summarize-spec.test.js

@@ -0,0 +1,180 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+vi.mock('../i18n/index.js', () => ({
+    ti: vi.fn((_key, params) => `translated:${JSON.stringify(params)}`),
+}));
+vi.mock('../storage/index.js', () => ({
+    specStore: {
+        getSpec: vi.fn(),
+    },
+}));
+vi.mock('node:fs/promises', () => ({
+    readFile: vi.fn(),
+}));
+import { handleSummarizeSpec } from './summarize-spec.js';
+import { specStore } from '../storage/index.js';
+import { readFile } from 'node:fs/promises';
+const makeSpec = (overrides = {}) => ({
+    id: 'SPEC-001',
+    title: 'User Auth',
+    type: 'feature',
+    scope: 'feature',
+    status: 'draft',
+    difficulty: 3,
+    risk: 'medium',
+    target: 'fullstack',
+    tags: ['auth'],
+    gitBranch: 'feat/spec-001-user-auth',
+    huPath: '/test/docs/SPEC-001/HU.md',
+    fichaTecnicaPath: '/test/docs/SPEC-001/FICHA-TECNICA.md',
+    estimation: {
+        devHours: 8,
+        reviewHours: 2,
+        recommendedModel: 'sonnet',
+        tokensOpus: 5000,
+        tokensSonnet: 10000,
+        apiCostUsd: 1.5,
+        humanCostUsd: 500,
+        totalCostUsd: 501.5,
+        tokenOptimization: { mode: 'local' },
+    },
+    actuals: null,
+    dependencies: ['SPEC-002'],
+    blockedBy: [],
+    impactAnalysis: { affectedModules: ['auth', 'users'] },
+    ...overrides,
+});
+beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(readFile).mockRejectedValue(new Error('not found'));
+});
+describe('handleSummarizeSpec', () => {
+    it('should return error when spec not found', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(null);
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-999',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBe(true);
+    });
+    it('should return technical format by default', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBeUndefined();
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.format).toBe('technical');
+        expect(parsed.specId).toBe('SPEC-001');
+        expect(parsed.spec).toBeDefined();
+        expect(parsed.estimation).toBeDefined();
+        expect(parsed.files).toBeDefined();
+    });
+    it('should return oneliner format', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            format: 'oneliner',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.format).toBe('oneliner');
+        expect(parsed.summary).toBeDefined();
+        expect(parsed.cost).toContain('$');
+    });
+    it('should return executive format', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            format: 'executive',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.format).toBe('executive');
+        expect(parsed.keyRisks).toBeDefined();
+        expect(parsed.timeline).toBeDefined();
+        expect(parsed.recommendation).toBe('Ready for review');
+    });
+    it('should handle high risk and high difficulty in risk highlights', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ risk: 'high', difficulty: 4, scope: 'architectural', blockedBy: ['SPEC-003'] }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.riskHighlights.some((r) => r.includes('high'))).toBe(true);
+        expect(parsed.riskHighlights.some((r) => r.includes('difficulty'))).toBe(true);
+        expect(parsed.riskHighlights.some((r) => r.includes('Architectural'))).toBe(true);
+    });
+    it('should extract key decisions from ficha content', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec());
+        vi.mocked(readFile).mockImplementation(((path) => {
+            if (path.includes('FICHA-TECNICA')) {
+                return Promise.resolve('## Technical Notes\nUse JWT tokens for auth sessions and verification.\n\n## Decision Log\nDecided to use bcrypt for password hashing because of security.');
+            }
+            if (path.includes('HU')) {
+                return Promise.resolve('## Description\nUser story for auth.');
+            }
+            return Promise.reject(new Error('not found'));
+        }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.keyDecisions.length).toBeGreaterThan(0);
+    });
+    it('should handle executive format with approved status', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ status: 'approved' }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+            format: 'executive',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.recommendation).toBe('Ready for implementation');
+    });
+    it('should return empty oneLiner for null spec', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(null);
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-999',
+            projectId: 'proj-123',
+            format: 'oneliner',
+        });
+        // When spec is not found, an error is returned before oneliner is built
+        expect(result.isError).toBe(true);
+    });
+    it('should highlight cross-module scope risk', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({ scope: 'cross-module', risk: 'low', difficulty: 2, blockedBy: [], dependencies: [] }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.riskHighlights.some((r) => r.includes('Cross-module'))).toBe(true);
+    });
+    it('should show no-risks fallback when no risks identified', async () => {
+        vi.mocked(specStore.getSpec).mockResolvedValue(makeSpec({
+            risk: 'low',
+            difficulty: 2,
+            scope: 'feature',
+            blockedBy: [],
+            dependencies: [],
+        }));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.riskHighlights.some((r) => r.includes('No significant risks'))).toBe(true);
+    });
+    it('should handle errors gracefully', async () => {
+        vi.mocked(specStore.getSpec).mockRejectedValue(new Error('DB error'));
+        const result = await handleSummarizeSpec({
+            specId: 'SPEC-001',
+            projectId: 'proj-123',
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=summarize-spec.test.js.map

package/dist/tools/summarize-spec.test.js.map

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

package/dist/tools/update-status/dod-gates.d.ts

@@ -0,0 +1,16 @@
+import type { ToolResult } from '../../types/index.js';
+import type { Spec } from '../../types/spec/core.js';
+/** SPEC-222 Trigger 1: Run validate engine before marking done. Returns score or null on error/skip. */
+export declare function runValidateGate(spec: Spec, projectPath: string, forceStatus?: boolean): Promise<{
+    blocked: true;
+    score: number;
+} | {
+    blocked: false;
+    score: number | null;
+}>;
+/**
+ * Checks the DoD gate before transitioning to 'done'.
+ * Returns an error ToolResult if blocked (unless force=true), null if passed.
+ */
+export declare function checkDodGate(spec: Spec, specId: string, projectId: string, projectPath: string | undefined, _force: boolean): Promise<ToolResult | null>;
+//# sourceMappingURL=dod-gates.d.ts.map

package/dist/tools/update-status/dod-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dod-gates.d.ts","sourceRoot":"","sources":["../../../src/tools/update-status/dod-gates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,wGAAwG;AACxG,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAgBtF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyE5B"}

package/dist/tools/update-status/dod-gates.js

@@ -0,0 +1,117 @@
+import { validateSpec } from '../../engine/validator.js';
+import { generateDoD } from '../../engine/validator/dor-dod.js';
+import { addLesson, getLessons } from '../../storage/lessons-store.js';
+import { dispatchFeedbackEvent } from '../learn.js';
+/** SPEC-222 Trigger 1: Run validate engine before marking done. Returns score or null on error/skip. */
+export async function runValidateGate(spec, projectPath, forceStatus) {
+    if (forceStatus) {
+        return { blocked: false, score: null };
+    }
+    try {
+        const validateResult = await validateSpec(spec, projectPath);
+        // score is null when no criteria exist — treat as passing to avoid false blocks.
+        const scoreValue = validateResult.score ?? 100;
+        if (scoreValue < 70) {
+            return { blocked: true, score: scoreValue };
+        }
+        return { blocked: false, score: validateResult.score };
+    }
+    catch {
+        /* best-effort — don't block transition if validate fails */
+        return { blocked: false, score: null };
+    }
+}
+/**
+ * Checks the DoD gate before transitioning to 'done'.
+ * Returns an error ToolResult if blocked (unless force=true), null if passed.
+ */
+export async function checkDodGate(spec, specId, projectId, projectPath, _force) {
+    const dod = await generateDoD(spec, undefined, undefined, projectPath);
+    const requiredItems = dod.items.filter((i) => i.required);
+    const blockingItems = requiredItems
+        .filter((i) => i.status === 'failed')
+        .map((i) => i.description);
+    const warningItems = dod.items
+        .filter((i) => !i.required && i.status !== 'passed')
+        .map((i) => i.description);
+    if (blockingItems.length === 0) {
+        return null;
+    }
+    // SPEC-248: Auto-capture lesson when DoD gate blocks (fire-and-forget)
+    if (projectPath) {
+        void autoCaptureLessonDodGate(spec, specId, projectId, projectPath);
+    }
+    const humanMessage = `❌ DoD gate failed: ${blockingItems.slice(0, 3).join('; ')}${blockingItems.length > 3 ? ` (and ${blockingItems.length - 3} more)` : ''}`;
+    const expertSummary = `DoD: ${dod.passedCount}/${dod.items.length} passed | Blocking: ${blockingItems.length} | Warnings: ${warningItems.length}`;
+    const fixHints = blockingItems.map((item) => `💡 To fix: ${item}`);
+    void dispatchFeedbackEvent(projectId, {
+        type: 'checklist',
+        specId,
+        input: { gate: 'dod', specType: spec.type },
+        outcome: { passed: false, failedItems: blockingItems },
+        delta: { failedCount: blockingItems.length },
+        timestamp: new Date().toISOString(),
+    });
+    const failedItems = requiredItems
+        .filter((i) => i.status === 'failed')
+        .map((i) => ({ id: i.id, description: i.description, category: i.category }));
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    error: 'DoD gate failed',
+                    message: humanMessage,
+                    expertSummary,
+                    blockingItems,
+                    failedItems,
+                    warningItems,
+                    fixHints,
+                    gateResults: dod.gateResults ?? null,
+                    hint: '💡 Alternatively: use force:true to bypass all gates',
+                }, null, 2),
+            },
+        ],
+        isError: true,
+        structuredContent: {
+            error: 'dod_gate_failed',
+            code: 422,
+            context: {
+                specId,
+                blockingItems,
+                warningItems,
+                passed: dod.passedCount,
+                total: dod.items.length,
+            },
+            fixHint: blockingItems[0]
+                ? `Fix: ${blockingItems[0]}. Use force:true to bypass all gates.`
+                : 'Use force:true to bypass all gates.',
+        },
+    };
+}
+async function autoCaptureLessonDodGate(spec, specId, projectId, projectPath) {
+    try {
+        const existing = await getLessons(projectPath, {
+            specId,
+            category: 'testing',
+            tags: ['auto-captured', 'dod-gate'],
+        });
+        if (existing.length > 0) {
+            return;
+        }
+        await addLesson(projectPath, {
+            projectId,
+            specId,
+            category: 'testing',
+            severity: 'high',
+            title: `DoD gate blocked for ${spec.title}`,
+            description: 'Required DoD items were not passing when attempting to mark spec as done',
+            prevention: 'Ensure tests pass and acceptance criteria are met before marking done',
+            tags: [...spec.tags, 'auto-captured', 'dod-gate'],
+        });
+    }
+    catch {
+        /* best-effort — never throw */
+    }
+}
+//# sourceMappingURL=dod-gates.js.map

package/dist/tools/update-status/dod-gates.js.map

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

package/dist/tools/update-status/file-sync.d.ts

@@ -0,0 +1,6 @@
+import type { SpecStatus, UpdateStatusInput } from '../../types/index.js';
+import type { Spec } from '../../types/spec/core.js';
+export declare function recordDoneMetrics(projectId: string, specId: string, spec: Spec, actuals: NonNullable<UpdateStatusInput['actuals']>, projectPath?: string): Promise<void>;
+export declare function syncSpecFiles(updatedSpec: Spec, currentStatus: SpecStatus, newStatus: SpecStatus): Promise<void>;
+export declare function tryReconcile(newStatus: string, specId: string, projectId: string): Promise<string | null>;
+//# sourceMappingURL=file-sync.d.ts.map

package/dist/tools/update-status/file-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sync.d.ts","sourceRoot":"","sources":["../../../src/tools/update-status/file-sync.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAe,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AASvF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,WAAW,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,EAClD,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAoCD,wBAAsB,aAAa,CACjC,WAAW,EAAE,IAAI,EACjB,aAAa,EAAE,UAAU,EACzB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAKxB"}