@frihet/mcp-server 1.16.3 → 1.16.5

package/dist/__tests__/contract.test.js

@@ -1,208 +0,0 @@
-/**
- * Output-schema CONTRACT tests.
- *
- * WHY THIS FILE EXISTS (the bug class it locks down forever):
- *
- * The MCP tools declare Zod `outputSchema`s and put the raw Cloud Function (CF)
- * response into `structuredContent`. The CF response has TWO shapes that have
- * historically drifted from the schemas and broken tools silently:
- *
- *   1. The `{ data, meta }` ENVELOPE. Single-object reads (e.g. the shipped
- *      `/v1/fiscal/modelo/:code` CF) return `res.json({ data: <item>, meta })`;
- *      list reads return `{ data: [<item>...], total, limit, offset }`. The
- *      client unwraps single objects to `body.data` (`requestUnwrapped`) and
- *      keeps the paginated envelope (`requestPaginated`). If the schema and the
- *      unwrap disagree, the tool emits a structuredContent the model can't parse.
- *
- *   2. Firestore-TIMESTAMP-shaped fields. Firestore-direct reads can leak
- *      `{ _seconds, _nanoseconds }` objects on date-ish fields instead of ISO
- *      strings. The enumerated date fields are typed `z.string()`, so a raw
- *      timestamp on `createdAt` would FAIL — but `.passthrough()` carries extra
- *      Firestore-internal timestamp fields (`_syncedAt`, `lastTouchedAt`, …)
- *      through untouched. This test pins BOTH facts: enumerated dates stay ISO
- *      strings, and extra `{_seconds}` fields pass via `.passthrough()`.
- *
- * If a future refactor tightens a schema (drops `.passthrough()`, or retypes a
- * passthrough timestamp field as `z.string()`), or the CF starts returning a
- * shape the schema rejects, THIS test goes red in CI — instead of the bug
- * reaching an LLM as an unparseable tool result.
- *
- * Run: npm test (after build) — node:test + node:assert.
- */
-import { test, describe } from "node:test";
-import assert from "node:assert/strict";
-import { fiscalModeloSummaryOutput, verifactuStatusOutput, paginatedOutput, invoiceItemOutput, expenseItemOutput, clientItemOutput, } from "../tools/shared.js";
-// ── Fixtures: representative CF responses ────────────────────────────────────
-/** A Firestore Timestamp as it appears in a JSON-serialized CF response. */
-const FIRESTORE_TS = { _seconds: 1_771_200_000, _nanoseconds: 0 };
-/**
- * The fiscal-summary CF body AFTER `requestUnwrapped` strips the `{ data, meta }`
- * envelope — i.e. exactly what the tool receives. Includes the `model` (not
- * `modeloCode`) shape the live CF emits, the `modelo303` totals block, a
- * `summary` counts block, and a passthrough Firestore-timestamp field
- * (`computedAt`) that is NOT in the schema's enumerated fields.
- */
-const FISCAL_303_UNWRAPPED = {
-    model: "303",
-    period: "2026-Q1",
-    months: ["2026-01", "2026-02", "2026-03"],
-    modelo303: {
-        baseImponible: 10_000,
-        cuotaRepercutida: 2_100,
-        baseDeducible: 4_000,
-        cuotaDeducible: 840,
-        resultado: 1_260,
-    },
-    summary: { invoiceCount: 12, expenseCount: 7 },
-    readonly: true,
-    note: "Informational summary — never filed to AEAT.",
-    // Firestore-internal timestamp leaking through .passthrough() — must validate.
-    computedAt: FIRESTORE_TS,
-};
-/** The raw `{ data, meta }` envelope as the CF emits it pre-unwrap. */
-const FISCAL_303_ENVELOPE = {
-    data: FISCAL_303_UNWRAPPED,
-    meta: { generatedAt: FIRESTORE_TS, source: "cf:getFiscalModeloSummary" },
-};
-/** Mirror of `requestUnwrapped`: pull `.data` out of a single-object envelope. */
-function unwrap(body) {
-    if (body !== null && typeof body === "object" && !Array.isArray(body) && "data" in body) {
-        const inner = body.data;
-        if (inner !== null && typeof inner === "object" && !Array.isArray(inner)) {
-            return inner;
-        }
-    }
-    return body;
-}
-const VERIFACTU_STATUS = {
-    invoiceId: "inv_2026_001",
-    lastSubmissionAt: "2026-04-15T10:30:00.000Z", // enumerated date field stays ISO
-    hash: "a1b2c3",
-    status: "success",
-    aeatResponse: "Aceptado",
-    qrUrl: "https://www2.agenciatributaria.gob.es/qr/...",
-    // Firestore-internal timestamp via passthrough — must validate.
-    _chainTouchedAt: FIRESTORE_TS,
-};
-/** A paginated list envelope as `requestPaginated` keeps it: data[] + counts. */
-const INVOICE_LIST_ENVELOPE = {
-    data: [
-        {
-            id: "inv_1",
-            clientName: "ACME SL",
-            items: [{ description: "Consulting", quantity: 1, unitPrice: 1000 }],
-            issueDate: "2026-03-01",
-            dueDate: "2026-03-31",
-            status: "sent",
-            total: 1210,
-            createdAt: "2026-03-01T09:00:00.000Z", // enumerated date → ISO string
-            // Firestore-internal timestamp via passthrough.
-            _firestoreUpdatedAt: FIRESTORE_TS,
-        },
-    ],
-    total: 1,
-    limit: 20,
-    offset: 0,
-    nextCursor: "inv_1",
-};
-const EXPENSE_LIST_ENVELOPE = {
-    data: [
-        {
-            id: "exp_1",
-            description: "AWS",
-            amount: 42.5,
-            category: "software",
-            date: "2026-03-02",
-            taxDeductible: true,
-            createdAt: "2026-03-02T00:00:00.000Z",
-            _syncedAt: FIRESTORE_TS,
-        },
-    ],
-    total: 1,
-    limit: 20,
-    offset: 0,
-};
-const CLIENT_LIST_ENVELOPE = {
-    data: [
-        {
-            id: "cli_1",
-            name: "ACME SL",
-            email: "facturas@acme.es",
-            taxId: "B12345678",
-            address: { city: "Madrid", country: "ES" },
-            createdAt: "2026-01-10T00:00:00.000Z",
-            _importedAt: FIRESTORE_TS,
-        },
-    ],
-    total: 1,
-    limit: 20,
-    offset: 0,
-};
-// ── Tests ────────────────────────────────────────────────────────────────────
-describe("output-schema contract — fiscal single-object reads", () => {
-    test("fiscalModeloSummaryOutput accepts the unwrapped 303 CF body", () => {
-        const unwrapped = unwrap(FISCAL_303_ENVELOPE);
-        const parsed = fiscalModeloSummaryOutput.safeParse(unwrapped);
-        assert.equal(parsed.success, true, parsed.success ? "" : JSON.stringify(parsed.error.issues, null, 2));
-    });
-    test("unwrap() strips the { data, meta } envelope (matches client.requestUnwrapped)", () => {
-        const unwrapped = unwrap(FISCAL_303_ENVELOPE);
-        assert.equal(unwrapped.model, "303");
-        assert.equal("meta" in unwrapped, false, "meta must NOT leak into the unwrapped item");
-    });
-    test("a Firestore-Timestamp {_seconds} field survives via .passthrough()", () => {
-        const parsed = fiscalModeloSummaryOutput.safeParse(unwrap(FISCAL_303_ENVELOPE));
-        assert.equal(parsed.success, true);
-        if (parsed.success) {
-            const ts = parsed.data.computedAt;
-            assert.equal(ts?._seconds, FIRESTORE_TS._seconds, "timestamp field must pass through intact");
-        }
-    });
-    test("verifactuStatusOutput accepts the status CF body incl. passthrough timestamp", () => {
-        const parsed = verifactuStatusOutput.safeParse(VERIFACTU_STATUS);
-        assert.equal(parsed.success, true, parsed.success ? "" : JSON.stringify(parsed.error.issues, null, 2));
-    });
-    test("enumerated date fields MUST stay strings — a raw {_seconds} there is rejected", () => {
-        // This pins the contract: the CF must emit ISO strings for enumerated dates.
-        // If it ever leaks a raw timestamp onto `lastSubmissionAt`, the tool would
-        // emit garbage — so we assert the schema (correctly) refuses it.
-        const bad = { ...VERIFACTU_STATUS, lastSubmissionAt: FIRESTORE_TS };
-        const parsed = verifactuStatusOutput.safeParse(bad);
-        assert.equal(parsed.success, false, "raw timestamp on an enumerated z.string() date must fail");
-    });
-});
-describe("output-schema contract — core list reads ({ data, ... } envelope)", () => {
-    test("invoices list envelope validates against paginatedOutput(invoiceItemOutput)", () => {
-        const schema = paginatedOutput(invoiceItemOutput);
-        const parsed = schema.safeParse(INVOICE_LIST_ENVELOPE);
-        assert.equal(parsed.success, true, parsed.success ? "" : JSON.stringify(parsed.error.issues, null, 2));
-    });
-    test("a list item carrying a Firestore Timestamp passthrough field validates", () => {
-        const schema = paginatedOutput(invoiceItemOutput);
-        const parsed = schema.safeParse(INVOICE_LIST_ENVELOPE);
-        assert.equal(parsed.success, true);
-        if (parsed.success) {
-            const item = parsed.data.data[0];
-            const ts = item._firestoreUpdatedAt;
-            assert.equal(ts?._seconds, FIRESTORE_TS._seconds);
-        }
-    });
-    test("expenses list envelope validates against paginatedOutput(expenseItemOutput)", () => {
-        const schema = paginatedOutput(expenseItemOutput);
-        const parsed = schema.safeParse(EXPENSE_LIST_ENVELOPE);
-        assert.equal(parsed.success, true, parsed.success ? "" : JSON.stringify(parsed.error.issues, null, 2));
-    });
-    test("clients list envelope validates against paginatedOutput(clientItemOutput)", () => {
-        const schema = paginatedOutput(clientItemOutput);
-        const parsed = schema.safeParse(CLIENT_LIST_ENVELOPE);
-        assert.equal(parsed.success, true, parsed.success ? "" : JSON.stringify(parsed.error.issues, null, 2));
-    });
-    test("paginatedOutput requires the envelope counts (data/total/limit/offset)", () => {
-        const schema = paginatedOutput(invoiceItemOutput);
-        // Missing `total`/`limit`/`offset` (a bare array-ish body) must fail — this
-        // is the drift that breaks pagination if the CF stops emitting counts.
-        const parsed = schema.safeParse({ data: INVOICE_LIST_ENVELOPE.data });
-        assert.equal(parsed.success, false, "envelope without counts must be rejected");
-    });
-});
-//# sourceMappingURL=contract.test.js.map

package/dist/__tests__/contract.test.js.map

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

package/dist/__tests__/d4b-hr-payroll-onboarding-tools.test.d.ts

@@ -1,13 +0,0 @@
-/**
- * Tests for D4-B megasprint MCP tools — HR + Webhook test + Payroll + Onboarding + Permissions + Period close (20 tools).
- *
- * Uses Node.js built-in test runner (node:test + node:assert). Run: npm test (after build).
- *
- * Coverage:
- *   - Tool registration counts per module
- *   - Happy path for every tool (mock client returns fixture)
- *   - Error path: 404 propagated as isError=true
- *   - Trust-area gates: confirm=false for period_close / period_reopen returns isError
- */
-export {};
-//# sourceMappingURL=d4b-hr-payroll-onboarding-tools.test.d.ts.map

package/dist/__tests__/d4b-hr-payroll-onboarding-tools.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"d4b-hr-payroll-onboarding-tools.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/d4b-hr-payroll-onboarding-tools.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/d4b-hr-payroll-onboarding-tools.test.js

@@ -1,420 +0,0 @@
-/**
- * Tests for D4-B megasprint MCP tools — HR + Webhook test + Payroll + Onboarding + Permissions + Period close (20 tools).
- *
- * Uses Node.js built-in test runner (node:test + node:assert). Run: npm test (after build).
- *
- * Coverage:
- *   - Tool registration counts per module
- *   - Happy path for every tool (mock client returns fixture)
- *   - Error path: 404 propagated as isError=true
- *   - Trust-area gates: confirm=false for period_close / period_reopen returns isError
- */
-import { test, describe, beforeEach } from "node:test";
-import assert from "node:assert/strict";
-class StubMcpServer {
-    tools = new Map();
-    registerTool(name, config, handler) {
-        this.tools.set(name, { name, config, handler });
-    }
-}
-// ── Mock fixtures ────────────────────────────────────────────────────────────
-const MOCK_LEAVE = {
-    id: "leave_001",
-    employeeId: "emp_001",
-    type: "vacation",
-    startDate: "2026-06-01",
-    endDate: "2026-06-15",
-    durationDays: 15,
-    status: "pending",
-    reason: "Summer break",
-    createdAt: "2026-05-16T08:00:00Z",
-};
-const MOCK_LEAVES_LIST = { data: [MOCK_LEAVE], total: 1, limit: 20, offset: 0 };
-const MOCK_ATTENDANCE = {
-    id: "att_001",
-    employeeId: "emp_001",
-    clockInAt: "2026-05-16T09:00:00Z",
-    status: "open",
-};
-const MOCK_OVERTIME = {
-    period: "2026-05",
-    totalRegularHours: 160,
-    totalOvertimeHours: 12,
-    estimatedCostEur: 480,
-    byEmployee: [],
-};
-const MOCK_ANOMALY = {
-    id: "anom_001",
-    type: "overtime_spike",
-    severity: "medium",
-    subjectId: "emp_001",
-    detectedAt: "2026-05-16T10:00:00Z",
-    status: "open",
-};
-const MOCK_ANOMALIES_LIST = { data: [MOCK_ANOMALY], total: 1, limit: 20, offset: 0 };
-const MOCK_WEBHOOK_TEST = {
-    webhookId: "wh_abc",
-    delivered: true,
-    statusCode: 200,
-    responseTimeMs: 142,
-    eventType: "webhook.test",
-    attemptedAt: "2026-05-16T10:30:00Z",
-};
-const MOCK_PAYROLL_EXPORT = {
-    format: "a3",
-    month: "2026-05",
-    fileUrl: "https://files.frihet.io/payroll/2026-05-a3.csv",
-    filename: "payroll-2026-05.csv",
-    rowCount: 12,
-    generatedAt: "2026-05-16T10:00:00Z",
-};
-const MOCK_PAYROLL_CHECKLIST = {
-    month: "2026-05",
-    totalEmployees: 12,
-    readyEmployees: 10,
-    missingEmployees: 2,
-    employees: [],
-};
-const MOCK_ONBOARDING_STATUS = {
-    workspaceId: "ws_001",
-    persona: "empresa",
-    completedSteps: ["create_workspace", "set_persona"],
-    pendingSteps: ["connect_bank", "invite_team"],
-    percentComplete: 50,
-};
-const MOCK_ONBOARDING_PERSONA_RESULT = {
-    workspaceId: "ws_001",
-    persona: "gestoria",
-    updatedAt: "2026-05-16T10:00:00Z",
-};
-const MOCK_PERMISSIONS_MATRIX = {
-    roles: [{ role: "admin", permissions: ["invoices.*", "expenses.*"] }],
-    resources: ["invoices", "expenses"],
-};
-const MOCK_PERMISSIONS_ME = {
-    userId: "user_001",
-    role: "admin",
-    permissions: ["invoices.read", "invoices.write"],
-    workspaceId: "ws_001",
-};
-const MOCK_PERIOD = {
-    id: "period_2026_q2",
-    type: "quarterly",
-    status: "open",
-    startDate: "2026-04-01",
-    endDate: "2026-06-30",
-};
-const MOCK_PERIOD_CLOSED = { ...MOCK_PERIOD, status: "closed", closedAt: "2026-05-16T10:00:00Z" };
-// ── Client stubs ─────────────────────────────────────────────────────────────
-function makeSuccessClient() {
-    return {
-        // HR
-        listLeaves: async () => MOCK_LEAVES_LIST,
-        createLeaveRequest: async (d) => ({ ...MOCK_LEAVE, ...d }),
-        approveLeave: async (id) => ({ ...MOCK_LEAVE, id, status: "approved" }),
-        rejectLeave: async (id, d) => ({ ...MOCK_LEAVE, id, status: "rejected", decisionReason: d["reason"] }),
-        cancelLeave: async (id) => ({ ...MOCK_LEAVE, id, status: "cancelled" }),
-        attendanceClockIn: async (d) => ({ ...MOCK_ATTENDANCE, ...d }),
-        attendanceClockOut: async (id) => ({ ...MOCK_ATTENDANCE, id, clockOutAt: "2026-05-16T17:00:00Z", status: "closed", durationMinutes: 480 }),
-        getOvertimeReport: async () => MOCK_OVERTIME,
-        listAnomalies: async () => MOCK_ANOMALIES_LIST,
-        // Webhook test (existing webhooks methods need stubs too for registerWebhookTools to call them)
-        listWebhooks: async () => ({ data: [], total: 0, limit: 20, offset: 0 }),
-        getWebhook: async () => ({ id: "wh_abc" }),
-        createWebhook: async (d) => ({ id: "wh_new", ...d }),
-        updateWebhook: async (id, d) => ({ id, ...d }),
-        deleteWebhook: async () => undefined,
-        testWebhook: async () => MOCK_WEBHOOK_TEST,
-        // Payroll
-        exportPayroll: async () => MOCK_PAYROLL_EXPORT,
-        getPayrollChecklist: async () => MOCK_PAYROLL_CHECKLIST,
-        // Onboarding
-        getOnboardingStatus: async () => MOCK_ONBOARDING_STATUS,
-        setOnboardingPersona: async (d) => ({ ...MOCK_ONBOARDING_PERSONA_RESULT, persona: d["persona"] }),
-        // Permissions
-        getPermissionsMatrix: async () => MOCK_PERMISSIONS_MATRIX,
-        getMyPermissions: async () => MOCK_PERMISSIONS_ME,
-        // Period close
-        getCurrentPeriod: async () => MOCK_PERIOD,
-        closePeriod: async () => MOCK_PERIOD_CLOSED,
-        reopenPeriod: async (d) => ({ ...MOCK_PERIOD, status: "reopened", reopenReason: d["reason"] }),
-    };
-}
-function make404Client() {
-    const notFound = () => {
-        const err = Object.assign(new Error("Not Found"), { statusCode: 404, errorCode: "not_found" });
-        return Promise.reject(err);
-    };
-    return new Proxy({}, { get: () => notFound });
-}
-// ── Helpers ──────────────────────────────────────────────────────────────────
-async function makeHrServer(clientFn) {
-    const server = new StubMcpServer();
-    const { registerHrTools } = await import("../tools/hr.js");
-    registerHrTools(server, clientFn());
-    return server;
-}
-async function makeWebhookServer(clientFn) {
-    const server = new StubMcpServer();
-    const { registerWebhookTools } = await import("../tools/webhooks.js");
-    registerWebhookTools(server, clientFn());
-    return server;
-}
-async function makePayrollServer(clientFn) {
-    const server = new StubMcpServer();
-    const { registerPayrollTools } = await import("../tools/payroll.js");
-    registerPayrollTools(server, clientFn());
-    return server;
-}
-async function makeOnboardingServer(clientFn) {
-    const server = new StubMcpServer();
-    const { registerOnboardingTools } = await import("../tools/onboarding.js");
-    registerOnboardingTools(server, clientFn());
-    return server;
-}
-async function makePermissionsServer(clientFn) {
-    const server = new StubMcpServer();
-    const { registerPermissionsTools } = await import("../tools/permissions.js");
-    registerPermissionsTools(server, clientFn());
-    return server;
-}
-async function makeAccountingCloseServer(clientFn) {
-    const server = new StubMcpServer();
-    const { registerAccountingCloseTools } = await import("../tools/accountingClose.js");
-    registerAccountingCloseTools(server, clientFn());
-    return server;
-}
-// ── Registration tests ───────────────────────────────────────────────────────
-describe("D4-B Registration counts", () => {
-    test("HR tools — 9 registered", async () => {
-        const s = await makeHrServer(makeSuccessClient);
-        assert.equal(s.tools.size, 9);
-        for (const name of [
-            "leave_request_create",
-            "leave_approve",
-            "leave_reject",
-            "leave_cancel",
-            "leave_list",
-            "attendance_clock_in",
-            "attendance_clock_out",
-            "overtime_report",
-            "anomaly_list",
-        ]) {
-            assert.ok(s.tools.has(name), `missing tool ${name}`);
-        }
-    });
-    test("Webhook tools — 6 registered (5 existing + 1 test_webhook)", async () => {
-        const s = await makeWebhookServer(makeSuccessClient);
-        assert.equal(s.tools.size, 6);
-        assert.ok(s.tools.has("test_webhook"));
-    });
-    test("Payroll tools — 2 registered", async () => {
-        const s = await makePayrollServer(makeSuccessClient);
-        assert.equal(s.tools.size, 2);
-        assert.ok(s.tools.has("payroll_export"));
-        assert.ok(s.tools.has("payroll_checklist"));
-    });
-    test("Onboarding tools — 2 registered", async () => {
-        const s = await makeOnboardingServer(makeSuccessClient);
-        assert.equal(s.tools.size, 2);
-        assert.ok(s.tools.has("onboarding_status"));
-        assert.ok(s.tools.has("onboarding_persona_set"));
-    });
-    test("Permissions tools — 2 registered", async () => {
-        const s = await makePermissionsServer(makeSuccessClient);
-        assert.equal(s.tools.size, 2);
-        assert.ok(s.tools.has("permissions_matrix"));
-        assert.ok(s.tools.has("permissions_me"));
-    });
-    test("Period close tools — 3 registered", async () => {
-        const s = await makeAccountingCloseServer(makeSuccessClient);
-        assert.equal(s.tools.size, 3);
-        assert.ok(s.tools.has("period_close_status"));
-        assert.ok(s.tools.has("period_close"));
-        assert.ok(s.tools.has("period_reopen"));
-    });
-});
-// ── HR happy-path tests ──────────────────────────────────────────────────────
-describe("HR Tools — happy path", () => {
-    let server;
-    beforeEach(async () => { server = await makeHrServer(makeSuccessClient); });
-    test("leave_request_create returns pending leave", async () => {
-        const r = await server.tools.get("leave_request_create").handler({
-            employeeId: "emp_001", type: "vacation", startDate: "2026-06-01", endDate: "2026-06-15",
-        });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "pending");
-        assert.equal(r.structuredContent["employeeId"], "emp_001");
-    });
-    test("leave_approve sets status approved", async () => {
-        const r = await server.tools.get("leave_approve").handler({ leaveId: "leave_001" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "approved");
-    });
-    test("leave_reject requires reason and sets rejected", async () => {
-        const r = await server.tools.get("leave_reject").handler({ leaveId: "leave_001", reason: "Coverage conflict" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "rejected");
-        assert.equal(r.structuredContent["decisionReason"], "Coverage conflict");
-    });
-    test("leave_cancel sets status cancelled", async () => {
-        const r = await server.tools.get("leave_cancel").handler({ leaveId: "leave_001" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "cancelled");
-    });
-    test("leave_list returns paginated leaves", async () => {
-        const r = await server.tools.get("leave_list").handler({ status: "pending" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["data"].length, 1);
-        assert.equal(r.structuredContent["total"], 1);
-    });
-    test("attendance_clock_in returns open entry", async () => {
-        const r = await server.tools.get("attendance_clock_in").handler({ employeeId: "emp_001", mood: "ok" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "open");
-    });
-    test("attendance_clock_out closes entry with duration", async () => {
-        const r = await server.tools.get("attendance_clock_out").handler({ entryId: "att_001" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "closed");
-        assert.equal(r.structuredContent["durationMinutes"], 480);
-    });
-    test("overtime_report returns aggregated hours", async () => {
-        const r = await server.tools.get("overtime_report").handler({ period: "2026-05" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["totalOvertimeHours"], 12);
-    });
-    test("anomaly_list returns paginated anomalies", async () => {
-        const r = await server.tools.get("anomaly_list").handler({ severity: "medium" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["data"].length, 1);
-    });
-});
-// ── Webhook test happy-path + error ──────────────────────────────────────────
-describe("Webhook test_webhook", () => {
-    test("happy path returns delivered=true", async () => {
-        const server = await makeWebhookServer(makeSuccessClient);
-        const r = await server.tools.get("test_webhook").handler({ id: "wh_abc", eventType: "invoice.paid" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["delivered"], true);
-        assert.equal(r.structuredContent["statusCode"], 200);
-    });
-    test("404 propagates as isError=true", async () => {
-        const server = await makeWebhookServer(make404Client);
-        const r = await server.tools.get("test_webhook").handler({ id: "wh_missing" });
-        assert.ok(r.isError);
-    });
-});
-// ── Payroll ──────────────────────────────────────────────────────────────────
-describe("Payroll Tools", () => {
-    test("payroll_export returns CSV URL for A3 format", async () => {
-        const server = await makePayrollServer(makeSuccessClient);
-        const r = await server.tools.get("payroll_export").handler({ format: "a3", month: "2026-05" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["format"], "a3");
-        assert.equal(r.structuredContent["rowCount"], 12);
-    });
-    test("payroll_checklist returns readiness counts", async () => {
-        const server = await makePayrollServer(makeSuccessClient);
-        const r = await server.tools.get("payroll_checklist").handler({ month: "2026-05" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["readyEmployees"], 10);
-        assert.equal(r.structuredContent["missingEmployees"], 2);
-    });
-    test("payroll_export 404 → isError", async () => {
-        const server = await makePayrollServer(make404Client);
-        const r = await server.tools.get("payroll_export").handler({ format: "a3", month: "2026-05" });
-        assert.ok(r.isError);
-    });
-});
-// ── Onboarding ───────────────────────────────────────────────────────────────
-describe("Onboarding Tools", () => {
-    test("onboarding_status returns persona + steps", async () => {
-        const server = await makeOnboardingServer(makeSuccessClient);
-        const r = await server.tools.get("onboarding_status").handler({});
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["persona"], "empresa");
-        assert.equal(r.structuredContent["percentComplete"], 50);
-    });
-    test("onboarding_persona_set updates persona", async () => {
-        const server = await makeOnboardingServer(makeSuccessClient);
-        const r = await server.tools.get("onboarding_persona_set").handler({ persona: "gestoria" });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["persona"], "gestoria");
-    });
-});
-// ── Permissions ──────────────────────────────────────────────────────────────
-describe("Permissions Tools", () => {
-    test("permissions_matrix returns roles + resources", async () => {
-        const server = await makePermissionsServer(makeSuccessClient);
-        const r = await server.tools.get("permissions_matrix").handler({});
-        assert.ok(!r.isError);
-        assert.ok(Array.isArray(r.structuredContent["roles"]));
-    });
-    test("permissions_me returns caller role", async () => {
-        const server = await makePermissionsServer(makeSuccessClient);
-        const r = await server.tools.get("permissions_me").handler({});
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["role"], "admin");
-    });
-});
-// ── Period close (TRUST AREA) ────────────────────────────────────────────────
-describe("Period Close Tools", () => {
-    test("period_close_status returns open period", async () => {
-        const server = await makeAccountingCloseServer(makeSuccessClient);
-        const r = await server.tools.get("period_close_status").handler({});
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "open");
-    });
-    test("period_close confirm=false returns isError without calling API", async () => {
-        const server = await makeAccountingCloseServer(makeSuccessClient);
-        const r = await server.tools.get("period_close").handler({ type: "quarterly", confirm: false });
-        assert.ok(r.isError);
-        assert.ok(r.content[0].text.includes("confirm=true"));
-    });
-    test("period_close confirm=true closes period", async () => {
-        const server = await makeAccountingCloseServer(makeSuccessClient);
-        const r = await server.tools.get("period_close").handler({ type: "quarterly", confirm: true });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "closed");
-    });
-    test("period_reopen confirm=false returns isError", async () => {
-        const server = await makeAccountingCloseServer(makeSuccessClient);
-        const r = await server.tools.get("period_reopen").handler({ periodId: "period_2026_q2", reason: "Audit correction", confirm: false });
-        assert.ok(r.isError);
-        assert.ok(r.content[0].text.includes("confirm=true"));
-    });
-    test("period_reopen confirm=true with reason reopens period", async () => {
-        const server = await makeAccountingCloseServer(makeSuccessClient);
-        const r = await server.tools.get("period_reopen").handler({ periodId: "period_2026_q2", reason: "Audit correction", confirm: true });
-        assert.ok(!r.isError);
-        assert.equal(r.structuredContent["status"], "reopened");
-        assert.equal(r.structuredContent["reopenReason"], "Audit correction");
-    });
-    test("period_close 404 → isError", async () => {
-        const server = await makeAccountingCloseServer(make404Client);
-        const r = await server.tools.get("period_close").handler({ type: "monthly", confirm: true });
-        assert.ok(r.isError);
-    });
-});
-// ── HR error paths ───────────────────────────────────────────────────────────
-describe("HR Tools — error paths", () => {
-    test("leave_list 404 → isError", async () => {
-        const server = await makeHrServer(make404Client);
-        const r = await server.tools.get("leave_list").handler({});
-        assert.ok(r.isError);
-    });
-    test("leave_request_create 404 → isError", async () => {
-        const server = await makeHrServer(make404Client);
-        const r = await server.tools.get("leave_request_create").handler({
-            employeeId: "emp_001", type: "vacation", startDate: "2026-06-01", endDate: "2026-06-15",
-        });
-        assert.ok(r.isError);
-    });
-    test("attendance_clock_out 404 → isError", async () => {
-        const server = await makeHrServer(make404Client);
-        const r = await server.tools.get("attendance_clock_out").handler({ entryId: "att_missing" });
-        assert.ok(r.isError);
-    });
-});
-//# sourceMappingURL=d4b-hr-payroll-onboarding-tools.test.js.map