@atoms-tech/atoms-mcp 0.3.0 → 0.3.1

package/dist/tools/list-items.d.ts

@@ -1,36 +0,0 @@
-/**
- * atoms_list_items — List items in a project with optional filters.
- * ENTRY POINT tool for discovering project contents.
- */
-import type { ItemSummary } from "../types/responses.js";
-export declare function listItemsHandler(params: {
-    project_id: string;
-    type?: string;
-    domain?: string;
-    level?: string;
-    limit: number;
-    offset: number;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        data: any[];
-        meta: {
-            truncated: boolean;
-            truncation_message: string;
-            total_count?: number | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-            has_more?: boolean | undefined;
-        };
-        status: "success";
-    };
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: import("../types/responses.js").ToolError | import("../types/responses.js").ToolSuccess<ItemSummary[]>;
-}>;

package/dist/tools/list-items.js

@@ -1,35 +0,0 @@
-/**
- * atoms_list_items — List items in a project with optional filters.
- * ENTRY POINT tool for discovering project contents.
- */
-import { getClient } from "../db/client.js";
-import { listItems } from "../db/queries.js";
-import { formatToolResult, formatErrorResult, success, paginationMeta, dbError, authError, } from "./_base.js";
-export async function listItemsHandler(params) {
-    try {
-        const client = await getClient();
-        const { items, totalCount } = await listItems(client, params.project_id, {
-            type: params.type,
-            domain: params.domain,
-            level: params.level,
-            limit: params.limit,
-            offset: params.offset,
-        });
-        // Map to @basic fields
-        const data = items.map((item) => ({
-            id: item.id,
-            title: item.title,
-            type: item.type,
-            status: item.data?.status,
-            domains: item.data?.tags?.domains ?? [],
-            level: item.data?.tags?.level,
-        }));
-        return formatToolResult(success(data, paginationMeta(totalCount, params.limit, params.offset)));
-    }
-    catch (err) {
-        if (err instanceof Error && err.message.includes("Not authenticated")) {
-            return formatErrorResult(authError());
-        }
-        return formatErrorResult(dbError(err instanceof Error ? err.message : String(err)));
-    }
-}

package/dist/tools/list-projects.d.ts

@@ -1,37 +0,0 @@
-/**
- * atoms_list_projects — Discover accessible projects.
- *
- * ENTRY POINT tool. Must be called first to get project_id for all other tools.
- * RLS ensures only projects the user has org membership for are returned.
- */
-export declare function listProjectsHandler(): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        data: any[];
-        meta: {
-            truncated: boolean;
-            truncation_message: string;
-            total_count?: number | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-            has_more?: boolean | undefined;
-        };
-        status: "success";
-    };
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: import("../types/responses.js").ToolError | import("../types/responses.js").ToolSuccess<{
-        id: string;
-        name: string;
-        description: string | null;
-        org_id: string;
-        org_name: string;
-        created_at: string;
-    }[]>;
-}>;

package/dist/tools/list-projects.js

@@ -1,27 +0,0 @@
-/**
- * atoms_list_projects — Discover accessible projects.
- *
- * ENTRY POINT tool. Must be called first to get project_id for all other tools.
- * RLS ensures only projects the user has org membership for are returned.
- */
-import { getClient } from "../db/client.js";
-import { listProjects } from "../db/queries.js";
-import { success, formatToolResult, formatErrorResult, dbError } from "./_base.js";
-export async function listProjectsHandler() {
-    try {
-        const client = await getClient();
-        const projects = await listProjects(client);
-        const data = projects.map((p) => ({
-            id: p.id,
-            name: p.name,
-            description: p.description,
-            org_id: p.org_id,
-            org_name: p.org_name,
-            created_at: p.created_at,
-        }));
-        return formatToolResult(success(data));
-    }
-    catch (err) {
-        return formatErrorResult(dbError(err instanceof Error ? err.message : "Unknown error"));
-    }
-}

package/dist/tools/project-summary.d.ts

@@ -1,63 +0,0 @@
-/**
- * atoms_project_summary — One-call compliance/health dashboard for a project.
- *
- * Returns item counts by type, test status breakdown, coverage stats
- * (overall + per domain), and recent change activity.
- */
-interface DomainCoverage {
-    domain: string;
-    covered: number;
-    total: number;
-    percent: number;
-}
-interface ProjectSummaryData {
-    project_id: string;
-    project_name: string;
-    counts: {
-        requirements: number;
-        test_cases: number;
-        notes: number;
-    };
-    test_status: {
-        passed: number;
-        failed: number;
-        blocked: number;
-        not_run: number;
-    };
-    coverage: {
-        covered: number;
-        uncovered: number;
-        total: number;
-        percent: number;
-    };
-    coverage_by_domain: DomainCoverage[];
-    recent_changes: number;
-    last_updated: string;
-}
-export declare function projectSummaryHandler(params: {
-    project_id: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        data: any[];
-        meta: {
-            truncated: boolean;
-            truncation_message: string;
-            total_count?: number | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-            has_more?: boolean | undefined;
-        };
-        status: "success";
-    };
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: import("../types/responses.js").ToolError | import("../types/responses.js").ToolSuccess<ProjectSummaryData>;
-}>;
-export {};

package/dist/tools/project-summary.js

@@ -1,169 +0,0 @@
-/**
- * atoms_project_summary — One-call compliance/health dashboard for a project.
- *
- * Returns item counts by type, test status breakdown, coverage stats
- * (overall + per domain), and recent change activity.
- */
-import { getClient } from "../db/client.js";
-import { formatToolResult, formatErrorResult, success, dbError, authError, notFoundError, } from "./_base.js";
-export async function projectSummaryHandler(params) {
-    try {
-        const client = await getClient();
-        // 1. Verify project exists and get its name
-        const { data: project, error: projErr } = await client
-            .from("projects")
-            .select("id, name")
-            .eq("id", params.project_id)
-            .is("deleted_at", null)
-            .maybeSingle();
-        if (projErr)
-            throw new Error(projErr.message);
-        if (!project) {
-            return formatErrorResult(notFoundError("Project", params.project_id));
-        }
-        // 2. Get all items grouped by type
-        const { data: items, error: itemsErr } = await client
-            .from("items")
-            .select("id, type, data")
-            .eq("project_id", params.project_id)
-            .is("deleted_at", null);
-        if (itemsErr)
-            throw new Error(itemsErr.message);
-        const allItems = items ?? [];
-        const counts = {
-            requirements: 0,
-            test_cases: 0,
-            notes: 0,
-        };
-        const testCaseIds = [];
-        const requirementItems = [];
-        for (const item of allItems) {
-            if (item.type === "requirement") {
-                counts.requirements++;
-                const domains = item.data?.tags?.domains ?? [];
-                requirementItems.push({ id: item.id, domains });
-            }
-            else if (item.type === "test-case") {
-                counts.test_cases++;
-                testCaseIds.push(item.id);
-            }
-            else if (item.type === "note") {
-                counts.notes++;
-            }
-        }
-        // 3. Get latest test result per test case from test_results shadow table
-        const testStatus = {
-            passed: 0,
-            failed: 0,
-            blocked: 0,
-            not_run: 0,
-        };
-        if (testCaseIds.length > 0) {
-            // Fetch all test results for this project, ordered by run_at desc
-            const { data: results, error: resultsErr } = await client
-                .from("test_results")
-                .select("item_id, result, run_at")
-                .eq("project_id", params.project_id)
-                .order("run_at", { ascending: false });
-            if (resultsErr)
-                throw new Error(resultsErr.message);
-            // Deduplicate to latest result per test case
-            const latestByItem = new Map();
-            for (const r of results ?? []) {
-                if (!latestByItem.has(r.item_id)) {
-                    latestByItem.set(r.item_id, r.result);
-                }
-            }
-            // Count statuses — test cases without any result are "not_run"
-            for (const tcId of testCaseIds) {
-                const result = latestByItem.get(tcId);
-                if (!result || result === "not-run") {
-                    testStatus.not_run++;
-                }
-                else if (result === "passed") {
-                    testStatus.passed++;
-                }
-                else if (result === "failed") {
-                    testStatus.failed++;
-                }
-                else if (result === "blocked") {
-                    testStatus.blocked++;
-                }
-                else {
-                    testStatus.not_run++;
-                }
-            }
-        }
-        // 4. Coverage: requirements with at least one verified_by relationship
-        const { data: verifiedRels, error: relErr } = await client
-            .from("item_relationships")
-            .select("from_id")
-            .eq("project_id", params.project_id)
-            .eq("type", "verified_by");
-        if (relErr)
-            throw new Error(relErr.message);
-        const coveredIds = new Set((verifiedRels ?? []).map((r) => r.from_id));
-        const coveredCount = requirementItems.filter((r) => coveredIds.has(r.id)).length;
-        const totalReqs = requirementItems.length;
-        const coverage = {
-            covered: coveredCount,
-            uncovered: totalReqs - coveredCount,
-            total: totalReqs,
-            percent: totalReqs > 0
-                ? Math.round((coveredCount / totalReqs) * 1000) / 10
-                : 100,
-        };
-        // 5. Coverage by domain
-        const domainMap = new Map();
-        for (const req of requirementItems) {
-            const domains = req.domains.length > 0 ? req.domains : ["(untagged)"];
-            const isCovered = coveredIds.has(req.id);
-            for (const domain of domains) {
-                if (!domainMap.has(domain)) {
-                    domainMap.set(domain, { covered: 0, total: 0 });
-                }
-                const entry = domainMap.get(domain);
-                entry.total++;
-                if (isCovered)
-                    entry.covered++;
-            }
-        }
-        const coverageByDomain = Array.from(domainMap.entries())
-            .sort((a, b) => a[0].localeCompare(b[0]))
-            .map(([domain, stats]) => ({
-            domain,
-            covered: stats.covered,
-            total: stats.total,
-            percent: stats.total > 0
-                ? Math.round((stats.covered / stats.total) * 1000) / 10
-                : 100,
-        }));
-        // 6. Recent changes (last 7 days)
-        const sevenDaysAgo = new Date();
-        sevenDaysAgo.setDate(sevenDaysAgo.getDate() - 7);
-        const { count: recentChanges, error: histErr } = await client
-            .from("change_history")
-            .select("id", { count: "exact", head: true })
-            .eq("project_id", params.project_id)
-            .gte("changed_at", sevenDaysAgo.toISOString());
-        if (histErr)
-            throw new Error(histErr.message);
-        const data = {
-            project_id: params.project_id,
-            project_name: project.name,
-            counts,
-            test_status: testStatus,
-            coverage,
-            coverage_by_domain: coverageByDomain,
-            recent_changes: recentChanges ?? 0,
-            last_updated: new Date().toISOString(),
-        };
-        return formatToolResult(success(data));
-    }
-    catch (err) {
-        if (err instanceof Error && err.message.includes("Not authenticated")) {
-            return formatErrorResult(authError());
-        }
-        return formatErrorResult(dbError(err instanceof Error ? err.message : String(err)));
-    }
-}

package/dist/tools/record-test-result.d.ts

@@ -1,40 +0,0 @@
-/**
- * atoms_record_test_result — Record a pass/fail/blocked result for a test case.
- * Appends to test_results shadow table. Requires editor or admin role.
- */
-export declare function recordTestResultHandler(params: {
-    project_id: string;
-    item_id: string;
-    result: "passed" | "failed" | "blocked" | "not-run";
-    note?: string;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        data: any[];
-        meta: {
-            truncated: boolean;
-            truncation_message: string;
-            total_count?: number | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-            has_more?: boolean | undefined;
-        };
-        status: "success";
-    };
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: import("../types/responses.js").ToolError | import("../types/responses.js").ToolSuccess<{
-        item_id: string;
-        result: "passed" | "failed" | "blocked" | "not-run";
-        run_at: string;
-        run_by: string;
-        note: string | null;
-        message: string;
-    }>;
-}>;

package/dist/tools/record-test-result.js

@@ -1,79 +0,0 @@
-/**
- * atoms_record_test_result — Record a pass/fail/blocked result for a test case.
- * Appends to test_results shadow table. Requires editor or admin role.
- */
-import { getClient, getUserId, getUserEmail, requireWriteAccess } from "../db/client.js";
-import { getItemById } from "../db/queries.js";
-import { getMcpSessionId } from "../server.js";
-import { formatToolResult, formatErrorResult, success, notFoundError, accessDeniedError, validationError, dbError, authError, } from "./_base.js";
-export async function recordTestResultHandler(params) {
-    try {
-        const client = await getClient();
-        const userId = getUserId();
-        const email = getUserEmail();
-        // Check write access
-        try {
-            await requireWriteAccess(client, params.project_id);
-        }
-        catch (err) {
-            if (err instanceof Error && err.message === "VIEWER_ROLE") {
-                return formatErrorResult(accessDeniedError("Viewer"));
-            }
-            throw err;
-        }
-        // Verify the item exists and is a test case
-        const item = await getItemById(client, params.project_id, params.item_id);
-        if (!item) {
-            return formatErrorResult(notFoundError("Item", params.item_id));
-        }
-        if (item.type !== "test-case") {
-            return formatErrorResult(validationError(`Item '${params.item_id}' is a ${item.type}, not a test-case`));
-        }
-        const runAt = new Date().toISOString();
-        // Insert into test_results shadow table
-        const { error: insertErr } = await client
-            .from("test_results")
-            .insert({
-            item_id: params.item_id,
-            project_id: params.project_id,
-            result: params.result,
-            run_by: email || userId,
-            run_at: runAt,
-            note: params.note ?? null,
-        });
-        if (insertErr)
-            throw new Error(insertErr.message);
-        // Audit: log to change_history
-        await client
-            .from("change_history")
-            .insert({
-            item_id: params.item_id,
-            project_id: params.project_id,
-            changed_by: userId,
-            event_type: "test_result_recorded",
-            old_data: null,
-            new_data: { result: params.result, run_at: runAt, note: params.note },
-            actor: "mcp_claude",
-            session_id: getMcpSessionId(),
-        })
-            .then(({ error }) => {
-            if (error) {
-                process.stderr.write(`[atoms-mcp] Warning: change_history log failed: ${error.message}\n`);
-            }
-        });
-        return formatToolResult(success({
-            item_id: params.item_id,
-            result: params.result,
-            run_at: runAt,
-            run_by: email || userId,
-            note: params.note ?? null,
-            message: `Test result '${params.result}' recorded for ${params.item_id}`,
-        }));
-    }
-    catch (err) {
-        if (err instanceof Error && err.message.includes("Not authenticated")) {
-            return formatErrorResult(authError());
-        }
-        return formatErrorResult(dbError(err instanceof Error ? err.message : String(err)));
-    }
-}

package/dist/tools/search.d.ts

@@ -1,33 +0,0 @@
-/**
- * atoms_search — Full-text search across items in a project.
- */
-import type { ItemSummary } from "../types/responses.js";
-export declare function searchHandler(params: {
-    project_id: string;
-    query: string;
-    type?: string;
-    limit: number;
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        data: any[];
-        meta: {
-            truncated: boolean;
-            truncation_message: string;
-            total_count?: number | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-            has_more?: boolean | undefined;
-        };
-        status: "success";
-    };
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: import("../types/responses.js").ToolError | import("../types/responses.js").ToolSuccess<ItemSummary[]>;
-}>;

package/dist/tools/search.js

@@ -1,27 +0,0 @@
-/**
- * atoms_search — Full-text search across items in a project.
- */
-import { getClient } from "../db/client.js";
-import { searchItems } from "../db/queries.js";
-import { formatToolResult, formatErrorResult, success, paginationMeta, dbError, authError, } from "./_base.js";
-export async function searchHandler(params) {
-    try {
-        const client = await getClient();
-        const { items, totalCount } = await searchItems(client, params.project_id, params.query, { type: params.type, limit: params.limit });
-        const data = items.map((item) => ({
-            id: item.id,
-            title: item.title,
-            type: item.type,
-            status: item.data?.status,
-            domains: item.data?.tags?.domains ?? [],
-            level: item.data?.tags?.level,
-        }));
-        return formatToolResult(success(data, paginationMeta(totalCount, params.limit, 0)));
-    }
-    catch (err) {
-        if (err instanceof Error && err.message.includes("Not authenticated")) {
-            return formatErrorResult(authError());
-        }
-        return formatErrorResult(dbError(err instanceof Error ? err.message : String(err)));
-    }
-}

package/dist/tools/trace.d.ts

@@ -1,52 +0,0 @@
-/**
- * atoms_trace — Graph traversal for traceability queries.
- *
- * Answers questions like "which requirements does TC-00003 verify?"
- * or "what's affected if I change REQ-00001?"
- */
-interface TraceNode {
-    id: string;
-    title: string;
-    type: string;
-    relationship: string;
-    depth: number;
-}
-export declare function traceHandler(params: {
-    project_id: string;
-    item_id: string;
-    direction: "upstream" | "downstream" | "both";
-    depth: number;
-    relationship_types?: string[];
-}): Promise<{
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: {
-        data: any[];
-        meta: {
-            truncated: boolean;
-            truncation_message: string;
-            total_count?: number | undefined;
-            limit?: number | undefined;
-            offset?: number | undefined;
-            has_more?: boolean | undefined;
-        };
-        status: "success";
-    };
-} | {
-    content: {
-        type: "text";
-        text: string;
-    }[];
-    structuredContent: import("../types/responses.js").ToolError | import("../types/responses.js").ToolSuccess<{
-        truncated?: boolean | undefined;
-        truncation_message?: string | undefined;
-        root: string;
-        direction: "upstream" | "downstream" | "both";
-        depth_limit: number;
-        items: TraceNode[];
-        total_count: number;
-    }>;
-}>;
-export {};