@popoverai/dotrequirements 0.26.2 → 0.27.1

package/dist/mcp/handlers/authoring.js

@@ -1,113 +0,0 @@
-/**
- * Authoring handlers for MCP tools
- *
- * Provides document creation and validation:
- * - create_requirement_document: Generate requirements template with format guidance
- * - validate_requirements: Validate requirements file syntax offline
- */
-import { existsSync } from "node:fs";
-import { getProjectContext } from "../../requirements/cloud-ai.js";
-import { generateStyleGuide, readLocalStyleGuide, } from "../../requirements/style-guide.js";
-import { parseRequirementsFromFile, validateForPush, } from "../../schema/index.js";
-import { CONVEX_URL } from "../convexClient.js";
-import { errorResponse, resolveProjectFilePath, textResponse, } from "./types.js";
-/**
- * Handler for create_requirement_document tool
- *
- * Requirements covered:
- * - MCP-AUTHOR-1.0: The template includes format guidance with code block examples
- * - MCP-AUTHOR-1.1: The template includes style guidance (concrete examples, concise prose, testable conditions)
- * - MCP-AUTHOR-1.2: When the project has requirementsStyleContext configured, it is included in the template
- * - MCP-AUTHOR-1.3: When cloud credentials are unavailable, the template works without the custom context
- */
-export async function handleCreateRequirementDocument(args, context) {
-    const { filePath = ".requirements/example.requirements.md" } = args;
-    // MCP-AUTHOR-1.3: Try to get requirements, but don't fail if no project is configured
-    let requirements = [];
-    try {
-        requirements = await context.getRequirements();
-    }
-    catch {
-        // No project configured — discovered patterns will be empty
-    }
-    // MCP-AUTHOR-1.2: Try to fetch user-provided style context from cloud
-    let customStyleGuidance = null;
-    try {
-        const project = await context.getProjectFromDiscovery();
-        const contextData = await getProjectContext(project.projectId, project.projectSecret, CONVEX_URL);
-        customStyleGuidance = contextData?.requirementsStyleContext ?? null;
-    }
-    catch {
-        // MCP-AUTHOR-1.3: No credentials or cloud unavailable - continue without user context
-    }
-    const localStyleGuide = readLocalStyleGuide(context.workspaceRoot);
-    return textResponse(generateStyleGuide({
-        requirements,
-        customStyleGuidance,
-        filePath,
-        localStyleGuide,
-    }));
-}
-/**
- * Handler for validate_requirements tool
- *
- * Requirements covered:
- * - MCP-AUTHOR-2.1: When the file has valid syntax, the response confirms validation passed
- * - MCP-AUTHOR-2.2: When the file has syntax errors, the response lists each error with location
- * - MCP-AUTHOR-2.3: Validation does not require network access or cloud credentials
- * - MCP-AUTHOR-2.4: When the file does not exist, an error is returned
- */
-export async function handleValidateRequirements(args, context) {
-    const { filePath } = args;
-    // #49: Resolve against the discovered project.path (matching push) with a
-    // workspaceRoot fallback. MCP-AUTHOR-2.3: validation stays offline — if
-    // discovery has no credentials it simply throws and we fall back to
-    // workspaceRoot resolution.
-    let projectPath;
-    try {
-        projectPath = (await context.getProjectFromDiscovery()).path;
-    }
-    catch {
-        projectPath = undefined;
-    }
-    const fullPath = resolveProjectFilePath(filePath, projectPath, context.workspaceRoot);
-    // MCP-AUTHOR-2.4: Check if file exists
-    if (!existsSync(fullPath)) {
-        return errorResponse(`File not found: ${filePath}`);
-    }
-    try {
-        // MCP-AUTHOR-2.1 & MCP-AUTHOR-2.2: Parse and validate
-        const parsed = parseRequirementsFromFile(fullPath);
-        const reqCount = Object.keys(parsed.requirements).length;
-        // Check push readiness
-        const pushValidation = validateForPush(parsed.metadata);
-        let headline;
-        let pushDetails = "";
-        if (!pushValidation.valid) {
-            headline = `❌ \`${filePath}\` - Not push-ready\n- ${pushValidation.reason}`;
-        }
-        else {
-            const actionLabel = pushValidation.action === "create"
-                ? "Will create new document"
-                : "Will update existing document";
-            headline = `✓ \`${filePath}\` - ${actionLabel}`;
-            if (pushValidation.warning) {
-                pushDetails = `\n- ⚠️ ${pushValidation.warning}`;
-            }
-        }
-        return textResponse(`${headline}${pushDetails}\n\n**Metadata:**\n- Version: ${parsed.metadata.version ?? "(none)"}\n- Document: ${parsed.metadata.document?.title || "(none)"}\n- Document ID: ${parsed.metadata.document?.id || "(none)"}\n\n**Requirements:** ${reqCount} root requirement(s) found`);
-    }
-    catch (error) {
-        // MCP-AUTHOR-2.2: Syntax errors are returned with details
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `✗ Validation failed for \`${filePath}\`:\n\n${error instanceof Error ? error.message : String(error)}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}
-//# sourceMappingURL=authoring.js.map

package/dist/mcp/handlers/debug.d.ts

@@ -1,16 +0,0 @@
-/**
- * debug_mcp_environment handler
- *
- * Returns diagnostic information about the MCP server environment.
- * Useful for debugging configuration issues.
- */
-import type { HandlerContext, ToolResponse } from "./types.js";
-/**
- * Arguments for debug_mcp_environment tool
- */
-export type DebugMcpEnvironmentArgs = Record<string, never>;
-/**
- * Handler for debug_mcp_environment tool
- */
-export declare function handleDebugMcpEnvironment(_args: DebugMcpEnvironmentArgs, context: HandlerContext): Promise<ToolResponse>;
-//# sourceMappingURL=debug.d.ts.map

package/dist/mcp/handlers/debug.js

@@ -1,37 +0,0 @@
-/**
- * debug_mcp_environment handler
- *
- * Returns diagnostic information about the MCP server environment.
- * Useful for debugging configuration issues.
- */
-import { textResponse } from "./types.js";
-/**
- * Handler for debug_mcp_environment tool
- */
-export async function handleDebugMcpEnvironment(_args, context) {
-    // Check for Antigravity-specific env vars
-    const antigravityVars = Object.entries(context.env)
-        .filter(([key]) => key.startsWith("GEMINI_") || key.startsWith("ANTIGRAVITY_"))
-        .map(([key, value]) => `  ${key}: ${value}`)
-        .join("\n");
-    // Show discovered projects from env vars
-    const projectList = Array.from(context.projectPaths.entries())
-        .map(([id, path]) => `  ${id}: ${path}`)
-        .join("\n");
-    const text = `# MCP Server Environment Debug Info
-
-**process.cwd():** ${process.cwd()}
-**WORKSPACE_ROOT:** ${context.workspaceRoot}
-**REQUIREMENTS_DIR env:** ${context.env.REQUIREMENTS_DIR || "(not set)"}
-**HOME:** ${context.env.HOME || "(not set)"}
-**PWD:** ${context.env.PWD || "(not set)"}
-**OLDPWD:** ${context.env.OLDPWD || "(not set)"}
-
-**Antigravity/Gemini env vars:**
-${antigravityVars || "(none found)"}
-
-**Projects from PROJ_* env vars:**
-${projectList || "(none found)"}`;
-    return textResponse(text);
-}
-//# sourceMappingURL=debug.js.map

package/dist/mcp/handlers/get.d.ts

@@ -1,24 +0,0 @@
-/**
- * get_requirement handler
- *
- * Retrieves a specific requirement by ID with its full tree and test coverage.
- */
-import type { HandlerContext, ToolResponse } from "./types.js";
-/**
- * Arguments for get_requirement tool
- */
-export interface GetRequirementArgs {
-    id: string;
-    projectId?: string;
-}
-/**
- * Handler for get_requirement tool
- *
- * Requirements covered:
- * - MCP-GET-1.0: When the ID matches a root requirement, the full tree is returned
- * - MCP-GET-1.1: When the ID matches a child requirement, that subtree is returned
- * - MCP-GET-1.2: When the ID does not exist, an error message is returned
- * - MCP-GET-1.3: When a requirement is retrieved, test references are shown with file path and line number
- */
-export declare function handleGetRequirement(args: GetRequirementArgs, context: HandlerContext): Promise<ToolResponse>;
-//# sourceMappingURL=get.d.ts.map

package/dist/mcp/handlers/get.js

@@ -1,69 +0,0 @@
-/**
- * get_requirement handler
- *
- * Retrieves a specific requirement by ID with its full tree and test coverage.
- */
-import { glob } from "glob";
-import { formatRequirementTree } from "../../requirements/index.js";
-import { findFilesWithRequirement, findTestCodeForRequirement, } from "../../requirements/testCodeExtractor.js";
-import { textResponse } from "./types.js";
-/**
- * Handler for get_requirement tool
- *
- * Requirements covered:
- * - MCP-GET-1.0: When the ID matches a root requirement, the full tree is returned
- * - MCP-GET-1.1: When the ID matches a child requirement, that subtree is returned
- * - MCP-GET-1.2: When the ID does not exist, an error message is returned
- * - MCP-GET-1.3: When a requirement is retrieved, test references are shown with file path and line number
- */
-export async function handleGetRequirement(args, context) {
-    const { id, projectId } = args;
-    const project = await context.getProjectFromDiscovery(projectId);
-    const requirements = await context.getRequirements(projectId);
-    // Get the tree starting from this ID.
-    // MCP-GET-1.0: Full tree for root requirement
-    // MCP-GET-1.1: Subtree for child requirement
-    //
-    // #46: Match the node itself plus all of its descendants by id prefix. The
-    // shared getRequirementTree only matches on rootId/id equality, which drops
-    // grandchildren (e.g. REQ-123.0.0) when a child id (REQ-123.0) is requested.
-    const tree = requirements.filter((r) => r.id === id || r.id.startsWith(`${id}.`));
-    // MCP-GET-1.2: Return error if not found
-    if (tree.length === 0) {
-        return textResponse(`Requirement "${id}" not found`);
-    }
-    const root = tree[0];
-    const formatted = formatRequirementTree(tree);
-    // MCP-GET-1.3: Find test files that reference this requirement
-    const testFiles = await glob("**/*.{test,spec}.{js,jsx,ts,tsx}", {
-        cwd: project.path,
-        absolute: true,
-        ignore: ["**/node_modules/**", "**/dist/**", "**/build/**"],
-    });
-    const matchingFiles = findFilesWithRequirement(testFiles, id);
-    const testCodeSections = [];
-    for (const file of matchingFiles) {
-        const testRefs = findTestCodeForRequirement(file, id);
-        // Deduplicate by removing nested blocks - keep only outermost blocks
-        const deduplicated = testRefs.filter((ref, i) => {
-            // Check if this ref is contained within any other ref
-            const isNested = testRefs.some((other, j) => {
-                if (i === j)
-                    return false;
-                // other contains ref if it starts before or at the same line and ends after or at the same line
-                return (other.startLine <= ref.startLine &&
-                    other.endLine >= ref.endLine &&
-                    (other.startLine < ref.startLine || other.endLine > ref.endLine));
-            });
-            return !isNested;
-        });
-        for (const ref of deduplicated) {
-            testCodeSections.push(`**${ref.requirementId}** tested in \`${ref.file}:${ref.startLine}-${ref.endLine}\`:\n\n\`\`\`typescript\n${ref.code}\n\`\`\``);
-        }
-    }
-    const testSection = testCodeSections.length > 0
-        ? `\n\n## Test Coverage (${testCodeSections.length} reference(s)):\n\n${testCodeSections.join("\n\n---\n\n")}`
-        : "\n\n## Test Coverage\n\nNo tests found referencing this requirement.";
-    return textResponse(`# ${id}\n\n**Document:** ${root.documentTitle}\n**Source:** ${root.sourceFile}\n\n## Requirement Tree (${tree.length} node(s)):\n\n\`\`\`\n${formatted}\n\`\`\`${testSection}`);
-}
-//# sourceMappingURL=get.js.map

package/dist/mcp/handlers/index.d.ts

@@ -1,28 +0,0 @@
-/**
- * MCP Tool Handlers
- *
- * Each handler is a pure function that processes tool arguments
- * and returns an MCP response. Handlers receive a context object
- * that provides access to shared dependencies.
- */
-export type { CreateRequirementDocumentArgs, ValidateRequirementsArgs, } from "./authoring.js";
-export { handleCreateRequirementDocument, handleValidateRequirements, } from "./authoring.js";
-export type { DebugMcpEnvironmentArgs } from "./debug.js";
-export { handleDebugMcpEnvironment } from "./debug.js";
-export type { GetRequirementArgs } from "./get.js";
-export { handleGetRequirement } from "./get.js";
-export type { ListArgs } from "./list.js";
-export { handleList } from "./list.js";
-export type { PushRequirementsArgs } from "./push.js";
-export { handlePushRequirements } from "./push.js";
-export type { ReportArgs } from "./report.js";
-export { handleReport } from "./report.js";
-export type { ReviewTestArgs, StyleCheckArgs } from "./review.js";
-export { handleReviewTest, handleStyleCheck } from "./review.js";
-export type { SearchRequirementsArgs } from "./search.js";
-export { handleSearchRequirements } from "./search.js";
-export type { GetRequirementsByTestArgs, GetTestsByRequirementArgs, } from "./test-mapping.js";
-export { handleGetRequirementsByTest, handleGetTestsByRequirement, } from "./test-mapping.js";
-export type { HandlerContext, ToolContentItem, ToolHandler, ToolResponse, } from "./types.js";
-export { errorResponse, textResponse } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/mcp/handlers/index.js

@@ -1,19 +0,0 @@
-/**
- * MCP Tool Handlers
- *
- * Each handler is a pure function that processes tool arguments
- * and returns an MCP response. Handlers receive a context object
- * that provides access to shared dependencies.
- */
-export { handleCreateRequirementDocument, handleValidateRequirements, } from "./authoring.js";
-// Handlers
-export { handleDebugMcpEnvironment } from "./debug.js";
-export { handleGetRequirement } from "./get.js";
-export { handleList } from "./list.js";
-export { handlePushRequirements } from "./push.js";
-export { handleReport } from "./report.js";
-export { handleReviewTest, handleStyleCheck } from "./review.js";
-export { handleSearchRequirements } from "./search.js";
-export { handleGetRequirementsByTest, handleGetTestsByRequirement, } from "./test-mapping.js";
-export { errorResponse, textResponse } from "./types.js";
-//# sourceMappingURL=index.js.map

package/dist/mcp/handlers/list.d.ts

@@ -1,7 +0,0 @@
-import type { HandlerContext, ToolResponse } from "./types.js";
-export interface ListArgs {
-    untested?: boolean;
-    projectId?: string;
-}
-export declare function handleList(args: ListArgs, context: HandlerContext): Promise<ToolResponse>;
-//# sourceMappingURL=list.d.ts.map

package/dist/mcp/handlers/list.js

@@ -1,43 +0,0 @@
-import { getReferencedRequirementIds } from "../../requirements/grep.js";
-import { textResponse } from "./types.js";
-export async function handleList(args, context) {
-    const { untested = false, projectId } = args;
-    const project = await context.getProjectFromDiscovery(projectId);
-    const requirements = await context.getRequirements(projectId);
-    if (requirements.length === 0) {
-        return textResponse(`No requirements found in project: ${project.path}\n\nMake sure .requirements/ directory exists with Markdown files (*.requirements.md).`);
-    }
-    if (untested) {
-        return formatUntested(requirements, project.path);
-    }
-    return formatAll(requirements);
-}
-function formatAll(requirements) {
-    const grouped = new Map();
-    for (const req of requirements) {
-        const existing = grouped.get(req.rootId) || [];
-        existing.push(req);
-        grouped.set(req.rootId, existing);
-    }
-    const formatted = Array.from(grouped.entries())
-        .map(([rootId, reqs]) => {
-        const root = reqs.find((r) => r.path.length === 0);
-        const childCount = reqs.length - 1;
-        return `- **${rootId}**: ${root?.content || "(no content)"} (${childCount} children)`;
-    })
-        .join("\n");
-    return textResponse(`Found ${grouped.size} requirement(s) with ${requirements.length} total nodes:\n\n${formatted}`);
-}
-async function formatUntested(requirements, projectPath) {
-    const referencedIds = await getReferencedRequirementIds(projectPath);
-    const rootRequirements = requirements.filter((r) => r.path.length === 0);
-    const untested = rootRequirements.filter((r) => !referencedIds.has(r.id));
-    if (untested.length === 0) {
-        return textResponse(`All ${rootRequirements.length} requirement(s) have test references — coverage is complete.`);
-    }
-    const formatted = untested
-        .map((r) => `- **${r.id}**: ${r.content}`)
-        .join("\n");
-    return textResponse(`Found ${untested.length} untested requirement(s) out of ${rootRequirements.length} total:\n\n${formatted}`);
-}
-//# sourceMappingURL=list.js.map

package/dist/mcp/handlers/push.d.ts

@@ -1,26 +0,0 @@
-/**
- * Push handler for MCP tools
- *
- * Provides requirements push functionality:
- * - push_requirements: Push local requirements to cloud
- */
-import type { HandlerContext, ToolResponse } from "./types.js";
-/**
- * Arguments for push_requirements tool
- */
-export interface PushRequirementsArgs {
-    filePath?: string;
-    confirmed?: boolean;
-    projectId?: string;
-}
-/**
- * Handler for push_requirements tool
- *
- * Requirements covered:
- * - MCP-PUSH-1.0: When not confirmed, no changes are made and a preview of creates/updates is returned
- * - MCP-PUSH-1.1: When confirmed is true, the push executes and returns success message
- * - MCP-PUSH-1.2: When credentials are missing or invalid, an error explains how to authenticate
- * - MCP-PUSH-1.3: When filePath is provided, only that file is pushed (MCP-PUSH-1.3.0: missing file is an error)
- */
-export declare function handlePushRequirements(args: PushRequirementsArgs, context: HandlerContext): Promise<ToolResponse>;
-//# sourceMappingURL=push.d.ts.map

package/dist/mcp/handlers/push.js

@@ -1,232 +0,0 @@
-/**
- * Push handler for MCP tools
- *
- * Provides requirements push functionality:
- * - push_requirements: Push local requirements to cloud
- */
-import { existsSync } from "node:fs";
-import { basename, resolve } from "node:path";
-import { dryRunPush, executePush, parseFilesForPushIndividually, } from "../../push/index.js";
-import { findRequirementsFiles } from "../../requirements/index.js";
-import { CONVEX_URL } from "../convexClient.js";
-import { errorResponse, textResponse } from "./types.js";
-/**
- * Handler for push_requirements tool
- *
- * Requirements covered:
- * - MCP-PUSH-1.0: When not confirmed, no changes are made and a preview of creates/updates is returned
- * - MCP-PUSH-1.1: When confirmed is true, the push executes and returns success message
- * - MCP-PUSH-1.2: When credentials are missing or invalid, an error explains how to authenticate
- * - MCP-PUSH-1.3: When filePath is provided, only that file is pushed (MCP-PUSH-1.3.0: missing file is an error)
- */
-export async function handlePushRequirements(args, context) {
-    const { filePath, confirmed = false, projectId } = args;
-    // MCP-PUSH-1.2: Get project credentials (throws if not configured)
-    let project;
-    try {
-        project = await context.getProjectFromDiscovery(projectId);
-    }
-    catch (error) {
-        return errorResponse(`Push requires project credentials. Run \`dotrequirements link\` to connect to cloud.\n\nError: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    // Determine files to push
-    let filesToPush;
-    // MCP-PUSH-1.3: When filePath is provided, only that file is pushed
-    if (filePath) {
-        const fullPath = resolve(project.path, filePath);
-        if (!existsSync(fullPath)) {
-            return errorResponse(`File not found: ${filePath}`);
-        }
-        filesToPush = [fullPath];
-    }
-    else {
-        // Use same file discovery as CLI - searches entire workspace
-        filesToPush = await findRequirementsFiles(project.path);
-        if (filesToPush.length === 0) {
-            return textResponse("No *.requirements.md files found. Nothing to push.");
-        }
-    }
-    // Parse files. #45/SYNC-FAIL-4: one invalid file does not abort the whole
-    // push — its failure is surfaced in the preview's "Skipped - Invalid"
-    // section while valid files still push. Same helper as the CLI command.
-    const { parsedFiles, totalRequirements, parseFailures } = parseFilesForPushIndividually(filesToPush);
-    // Build credentials
-    const credentials = {
-        projectId: project.projectId,
-        projectSecret: project.projectSecret,
-        convexUrl: CONVEX_URL,
-    };
-    // Run dry run (always, even when confirmed - ensures fresh state).
-    // SYNC-FAIL-3: two files claiming the same document ID abort the push
-    // before any cloud write — surface that as a clean error result naming
-    // both files rather than an unhandled throw.
-    let dryRunResult;
-    try {
-        dryRunResult = await dryRunPush(parsedFiles, credentials);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (message.includes("claim the same document ID")) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `✗ Push aborted: ${message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        throw error;
-    }
-    // #45: Merge dry-run invalids (missing document section, cloud validation)
-    // with local parse failures so both are surfaced together, each named by
-    // filename.
-    const allInvalid = [
-        ...dryRunResult.invalid.map(({ file, result }) => ({
-            fileName: basename(file.filePath),
-            error: result.error ?? "invalid",
-        })),
-        ...parseFailures.map(({ filePath, error }) => ({
-            fileName: basename(filePath),
-            error,
-        })),
-    ];
-    // Check if there's anything to push
-    const pushableCount = dryRunResult.updates.length +
-        dryRunResult.creates.length +
-        dryRunResult.notFound.length;
-    if (pushableCount === 0 && allInvalid.length > 0) {
-        // Only invalid files
-        const invalidList = allInvalid
-            .map(({ fileName, error }) => `- ${fileName}: ${error}`)
-            .join("\n");
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `✗ No valid documents to push.\n\n**Invalid files:**\n${invalidList}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-    // MCP-PUSH-1.0: When not confirmed, show preview
-    if (!confirmed) {
-        let summary = `# Push Preview\n\n**Files:** ${parsedFiles.length}\n**Requirements:** ${totalRequirements}\n\n`;
-        if (dryRunResult.updates.length > 0) {
-            summary += `## Updates (${dryRunResult.updates.length})\n`;
-            for (const { file, result } of dryRunResult.updates) {
-                const fileName = basename(file.filePath);
-                const hasConflict = dryRunResult.conflicts.some((c) => c.item.file === file);
-                const conflictNote = hasConflict ? " ⚠️ [cloud changed since pull]" : "";
-                const warningNote = result.warning ? ` (${result.warning})` : "";
-                summary += `- ~ ${fileName}${conflictNote}${warningNote}\n`;
-            }
-            summary += "\n";
-        }
-        if (dryRunResult.creates.length > 0) {
-            summary += `## New Documents (${dryRunResult.creates.length})\n`;
-            for (const { file, result } of dryRunResult.creates) {
-                const fileName = basename(file.filePath);
-                const warningNote = result.warning ? ` (${result.warning})` : "";
-                summary += `- + ${fileName}${warningNote}\n`;
-            }
-            summary += "\n";
-        }
-        if (dryRunResult.notFound.length > 0) {
-            summary += `## Not Found in Cloud (${dryRunResult.notFound.length}) - will create new\n`;
-            for (const { file, result } of dryRunResult.notFound) {
-                const fileName = basename(file.filePath);
-                summary += `- ! ${fileName} (ID: ${result.documentId})\n`;
-            }
-            summary += "\n";
-        }
-        if (allInvalid.length > 0) {
-            summary += `## Skipped - Invalid (${allInvalid.length})\n`;
-            for (const { fileName, error } of allInvalid) {
-                summary += `- ✗ ${fileName}: ${error}\n`;
-            }
-            summary += "\n";
-        }
-        if (dryRunResult.conflicts.length > 0) {
-            summary += `⚠️ **Warning:** ${dryRunResult.conflicts.length} file(s) have cloud changes since last pull. Pushing will overwrite those changes.\n\n`;
-        }
-        summary += `**To proceed:** Call this tool again with \`confirmed: true\``;
-        return textResponse(summary);
-    }
-    // MCP-PUSH-1.1: When confirmed, execute push
-    try {
-        const result = await executePush(dryRunResult, credentials);
-        // SYNC-FAIL-1: a failed push must not masquerade as success
-        const failed = result.errors.length;
-        const syncedCount = result.created + result.updated;
-        let output;
-        if (failed > 0 && syncedCount === 0) {
-            output = `✗ Push failed: ${failed} document(s) could not be saved.\n\n`;
-        }
-        else if (failed > 0) {
-            output = `⚠ Push incomplete: ${syncedCount} document(s) synced, ${failed} failed.\n\n`;
-        }
-        else {
-            output = "✓ Push complete!\n\n";
-        }
-        if (result.created > 0) {
-            output += `**Created:** ${result.created} document(s)\n`;
-        }
-        if (result.updated > 0) {
-            output += `**Updated:** ${result.updated} document(s)\n`;
-        }
-        // IMPORT-3: marker failures are loud but never fatal
-        if (result.importWarnings.length > 0) {
-            output += `\n**Import marker warnings:**\n`;
-            for (const { fileName, status } of result.importWarnings) {
-                output +=
-                    status === "already_used"
-                        ? `- ⚠ ${fileName}: import marker already used — requirements were saved as natively authored (they count toward the plan's requirement limit). Re-running codebase-to-spec produces a fresh marker.\n`
-                        : `- ⚠ ${fileName}: import marker not recognized — the CLI may need updating. Requirements were saved as natively authored (they count toward the plan's requirement limit).\n`;
-            }
-        }
-        if (result.errors.length > 0) {
-            output += `\n**Errors:**\n`;
-            for (const { fileName, error } of result.errors) {
-                output += `- ${fileName}: ${error}\n`;
-            }
-        }
-        // SYNC-FAIL-2.1: cloud save succeeded but the local file couldn't be
-        // updated — name the file, say the cloud is fine, and give the recovery
-        // step so a retry doesn't mint a duplicate document.
-        if (result.writeBackWarnings?.length > 0) {
-            output += `\n**Warnings:**\n`;
-            for (const warning of result.writeBackWarnings) {
-                output +=
-                    `- ⚠ ${warning.fileName}: saved to the cloud, but the local file could not be updated (${warning.error}). ` +
-                        `To avoid creating a duplicate, add "id: ${warning.documentId}" under "document:" in the frontmatter of ${warning.filePath}, then push again.\n`;
-            }
-        }
-        // SYNC-LAND-1: where each synced document lives in the web app
-        if (result.synced.length > 0) {
-            output += `\n**Review in dot•requirements:**\n`;
-            for (const doc of result.synced) {
-                output += `- ${doc.fileName}: ${doc.url}\n`;
-            }
-        }
-        // SYNC-FAIL-1.2: total failure is an error result, not a success story
-        if (failed > 0 && syncedCount === 0) {
-            return { content: [{ type: "text", text: output }], isError: true };
-        }
-        return textResponse(output);
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `✗ Push failed:\n\n${error instanceof Error ? error.message : String(error)}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}
-//# sourceMappingURL=push.js.map

package/dist/mcp/handlers/report.d.ts

@@ -1,16 +0,0 @@
-/**
- * Unified coverage handler for the MCP `report_coverage` tool. Replaces
- * `get_requirement_coverage` and `get_project_coverage_summary` with a
- * single tool that takes a `source: "local" | "cloud"` argument and
- * mirrors the CLI `dotreq report` semantics.
- */
-import type { HandlerContext, ToolResponse } from "./types.js";
-export interface ReportArgs {
-    source?: "local" | "cloud";
-    requirementKey?: string;
-    branch?: string;
-    sinceTimestamp?: number;
-    projectId?: string;
-}
-export declare function handleReport(args: ReportArgs, context: HandlerContext): Promise<ToolResponse>;
-//# sourceMappingURL=report.d.ts.map