@atoms-tech/atoms-mcp 0.1.0

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

@@ -0,0 +1,41 @@
+/**
+ * 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;
+    }>;
+}>;
+//# sourceMappingURL=record-test-result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"record-test-result.d.ts","sourceRoot":"","sources":["../../src/tools/record-test-result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFA"}

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

@@ -0,0 +1,80 @@
+/**
+ * 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)));
+    }
+}
+//# sourceMappingURL=record-test-result.js.map

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

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

package/dist/tools/search.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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[]>;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;;;;;;;;;;;;;;;;;;;;;;;GA8BA"}

package/dist/tools/search.js

@@ -0,0 +1,28 @@
+/**
+ * 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)));
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,OAAO,EACP,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAKnC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,WAAW,CAC7C,MAAM,EACN,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,KAAK,EACZ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAC3C,CAAC;QAEF,MAAM,IAAI,GAAkB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM;YACzB,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,EAAE;YACvC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK;SAC9B,CAAC,CAAC,CAAC;QAEJ,OAAO,gBAAgB,CACrB,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAC3D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACtE,OAAO,iBAAiB,CAAC,SAAS,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,iBAAiB,CACtB,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAC1D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/update-item.d.ts

@@ -0,0 +1,43 @@
+/**
+ * atoms_update_item — Update an existing item's fields.
+ * Requires editor or admin role. Logs old/new diff to change_history.
+ */
+export declare function updateItemHandler(params: {
+    project_id: string;
+    item_id: string;
+    title?: string;
+    body?: string;
+    summary?: string;
+    domains?: string[];
+    level?: string;
+    status?: "passed" | "failed" | "blocked" | "not-run";
+}): 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;
+        title: string;
+        type: string;
+        updated_fields: string[];
+    }>;
+}>;
+//# sourceMappingURL=update-item.d.ts.map

package/dist/tools/update-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-item.d.ts","sourceRoot":"","sources":["../../src/tools/update-item.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsGA"}

package/dist/tools/update-item.js

@@ -0,0 +1,98 @@
+/**
+ * atoms_update_item — Update an existing item's fields.
+ * Requires editor or admin role. Logs old/new diff to change_history.
+ */
+import { getClient, getUserId, requireWriteAccess } from "../db/client.js";
+import { getItemById } from "../db/queries.js";
+import { getMcpSessionId } from "../server.js";
+import { formatToolResult, formatErrorResult, success, notFoundError, accessDeniedError, dbError, authError, } from "./_base.js";
+export async function updateItemHandler(params) {
+    try {
+        const client = await getClient();
+        const userId = getUserId();
+        // 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;
+        }
+        // Get existing item
+        const existing = await getItemById(client, params.project_id, params.item_id);
+        if (!existing) {
+            return formatErrorResult(notFoundError("Item", params.item_id));
+        }
+        // Build updated data blob
+        const oldData = { ...existing.data };
+        const updatedData = { ...existing.data };
+        if (params.title !== undefined) {
+            updatedData.title = params.title;
+        }
+        if (params.body !== undefined) {
+            updatedData.body = params.body;
+        }
+        if (params.summary !== undefined) {
+            updatedData.summary = params.summary;
+        }
+        if (params.domains !== undefined) {
+            updatedData.tags = { ...updatedData.tags, domains: params.domains };
+        }
+        if (params.level !== undefined) {
+            updatedData.tags = { ...updatedData.tags, level: params.level };
+        }
+        if (params.status !== undefined) {
+            updatedData.status = params.status;
+        }
+        updatedData.metadata = {
+            ...updatedData.metadata,
+            updated_at: new Date().toISOString(),
+            updated_by: userId,
+        };
+        // Update in database
+        const { error: updateErr } = await client
+            .from("items")
+            .update({
+            title: params.title ?? existing.title,
+            data: updatedData,
+            updated_by: userId,
+        })
+            .eq("id", params.item_id)
+            .eq("project_id", params.project_id);
+        if (updateErr)
+            throw new Error(updateErr.message);
+        // Audit: log diff to change_history
+        await client
+            .from("change_history")
+            .insert({
+            item_id: params.item_id,
+            project_id: params.project_id,
+            changed_by: userId,
+            event_type: "updated",
+            old_data: oldData,
+            new_data: updatedData,
+            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({
+            id: params.item_id,
+            title: updatedData.title,
+            type: existing.type,
+            updated_fields: Object.keys(params).filter((k) => k !== "project_id" && k !== "item_id" && params[k] !== undefined),
+        }));
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("Not authenticated")) {
+            return formatErrorResult(authError());
+        }
+        return formatErrorResult(dbError(err instanceof Error ? err.message : String(err)));
+    }
+}
+//# sourceMappingURL=update-item.js.map

package/dist/tools/update-item.js.map

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

package/dist/types/responses.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Standard response envelopes for all MCP tool responses.
+ * Every tool returns JSON matching one of these shapes.
+ */
+export interface ToolSuccess<T = unknown> {
+    [key: string]: unknown;
+    status: "success";
+    data: T;
+    meta?: PaginationMeta;
+}
+export interface ToolError {
+    [key: string]: unknown;
+    status: "error";
+    message: string;
+    next_steps: string[];
+}
+export interface PaginationMeta {
+    [key: string]: unknown;
+    total_count: number;
+    limit: number;
+    offset: number;
+    has_more: boolean;
+}
+export type ToolResponse<T = unknown> = ToolSuccess<T> | ToolError;
+/**
+ * Item summary returned by list/search tools (@basic fields).
+ */
+export interface ItemSummary {
+    id: string;
+    title: string;
+    type: string;
+    status?: string;
+    domains: string[];
+    level?: string;
+}
+/**
+ * Coverage report returned by atoms_get_coverage.
+ */
+export interface CoverageReport {
+    covered: number;
+    uncovered: number;
+    total: number;
+    coverage_percent: number;
+    uncovered_items: ItemSummary[];
+}
+/**
+ * Change history entry returned by atoms_get_history.
+ */
+export interface HistoryEntry {
+    id: string;
+    event_type: string;
+    changed_by: string | null;
+    changed_at: string;
+    actor: string;
+    session_id: string | null;
+    fields_changed: string[];
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/types/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/types/responses.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,WAAW,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/types/responses.js

@@ -0,0 +1,6 @@
+/**
+ * Standard response envelopes for all MCP tool responses.
+ * Every tool returns JSON matching one of these shapes.
+ */
+export {};
+//# sourceMappingURL=responses.js.map

package/dist/types/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/types/responses.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/work-item.d.ts

@@ -0,0 +1,69 @@
+/**
+ * WorkItem type definition — shared with the ATOMS frontend.
+ * Source of truth: src/app/types.ts in the main app.
+ *
+ * This is a subset focused on what the MCP server needs.
+ */
+export interface WorkItemRelationships {
+    parents: string[];
+    children: string[];
+    related: string[];
+    verified_by?: string[];
+    verifies?: string[];
+}
+export interface WorkItemOwnership {
+    primary: string | null;
+    additional: string[];
+}
+export interface WorkItemTags {
+    domains: string[];
+    level?: string;
+}
+export interface TestRun {
+    date: string;
+    result: "passed" | "failed" | "blocked" | "not-run";
+    by: string;
+    note?: string;
+}
+export interface WorkItemLink {
+    url: string;
+    label: string;
+}
+export interface WorkItemMetadata {
+    created_at: string;
+    created_by: string;
+    updated_at: string;
+    updated_by: string;
+    source_id?: string;
+    imported_at?: string;
+}
+export interface WorkItem {
+    id: string;
+    type: "requirement" | "test-case" | "note" | "table";
+    title: string;
+    summary?: string;
+    body?: string;
+    tags: WorkItemTags;
+    ownership: WorkItemOwnership;
+    relationships: WorkItemRelationships;
+    links: WorkItemLink[];
+    status?: "passed" | "failed" | "blocked" | "not-run";
+    runs?: TestRun[];
+    metadata: WorkItemMetadata;
+}
+/**
+ * Database row shape from Supabase items table.
+ */
+export interface ItemRow {
+    id: string;
+    project_id: string;
+    type: string;
+    title: string;
+    data: WorkItem;
+    created_by: string | null;
+    updated_by: string | null;
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+}
+//# sourceMappingURL=work-item.d.ts.map

package/dist/types/work-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item.d.ts","sourceRoot":"","sources":["../../src/types/work-item.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,aAAa,EAAE,qBAAqB,CAAC;IACrC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACrD,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/types/work-item.js

@@ -0,0 +1,8 @@
+/**
+ * WorkItem type definition — shared with the ATOMS frontend.
+ * Source of truth: src/app/types.ts in the main app.
+ *
+ * This is a subset focused on what the MCP server needs.
+ */
+export {};
+//# sourceMappingURL=work-item.js.map

package/dist/types/work-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item.js","sourceRoot":"","sources":["../../src/types/work-item.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@atoms-tech/atoms-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for ATOMS.tech — AI agent integration for requirements management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "atoms-mcp": "./bin/atoms-mcp.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@supabase/supabase-js": "^2.49.0",
+    "open": "^10.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "keywords": [
+    "mcp",
+    "atoms",
+    "requirements-management",
+    "model-context-protocol",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/support-atoms-tech/atoms-mvp-v2"
+  }
+}