create-ailk 0.5.0 → 0.6.0

package/templates/apps/api/src/routes/content/update.ts

@@ -1,112 +0,0 @@
-// oss: false
-/**
- * PATCH /v1/content/:type/:slug
- *
- * Updates an existing page of `:type` at `:slug`. Paid-licensed deploys only.
- *
- * Optimistic locking is mandatory: the request MUST carry an `If-Match`
- * header containing the `version` token returned by a prior read or write.
- * Missing/empty header → 409. Stale token → 409 with `details.currentVersion`
- * echoed so the caller can re-fetch and retry.
- *
- * 404 when the page does not exist.
- *
- * Adapter errors (`AdapterWriteError("not_found" | "conflict" | …)`) are
- * translated by the hoisted `mapAdapterError` from `@working-theory/content-adapters`
- * (issue #398) — single source of truth across the API + MCP surfaces.
- */
-import {
-  FrontmatterSchema,
-  SCHEMA_ORG_TYPES,
-  type SchemaOrgType,
-} from "@working-theory/content-adapters";
-import type { FastifyPluginAsync, FastifyReply } from "fastify";
-import { z } from "zod";
-
-import { getContentAdapter } from "../../lib/content-adapter.js";
-import {
-  adapterErrorResponse,
-  conflictError,
-  validationError,
-  type ErrorBody,
-} from "../../lib/errors.js";
-import { requirePaidTier } from "../../lib/require-paid-tier.js";
-
-import { SLUG_PATTERN } from "./slug.js";
-
-const paramsSchema = z.object({
-  type: z.enum(SCHEMA_ORG_TYPES),
-  slug: z.string().regex(SLUG_PATTERN),
-});
-
-const writeBodySchema = FrontmatterSchema.extend({ body: z.string().min(1) });
-
-function send(reply: FastifyReply, status: number, body: ErrorBody) {
-  return reply.status(status).send(body);
-}
-
-export const updatePageRoute: FastifyPluginAsync = async (fastify) => {
-  fastify.patch<{
-    Params: { type: string; slug: string };
-    Body: unknown;
-  }>(
-    "/v1/content/:type/:slug",
-     
-    { preHandler: requirePaidTier },
-    async (request, reply) => {
-      const params = paramsSchema.safeParse(request.params);
-      if (!params.success) {
-        const err = validationError("Invalid type or slug", {
-          issues: params.error.issues,
-        });
-        return send(reply, err.status, err.body);
-      }
-
-      const ifMatch = request.headers["if-match"];
-      if (typeof ifMatch !== "string" || ifMatch.length === 0) {
-        const err = conflictError(
-          "Missing required If-Match header (version token)",
-        );
-        return send(reply, err.status, err.body);
-      }
-
-      const parsed = writeBodySchema.safeParse(request.body);
-      if (!parsed.success) {
-        const err = validationError("Invalid request body", {
-          issues: parsed.error.issues,
-        });
-        return send(reply, err.status, err.body);
-      }
-
-      const { type, slug } = params.data;
-      const { body: pageBody, ...page } = parsed.data;
-
-      if (page.type !== type || page.slug !== slug) {
-        const err = validationError(
-          "Body `type`/`slug` must match URL params",
-          {
-            url: { type, slug },
-            body: { type: page.type, slug: page.slug },
-          },
-        );
-        return send(reply, err.status, err.body);
-      }
-
-      try {
-        const adapter = getContentAdapter();
-        const result = await adapter.updatePage(
-          type as SchemaOrgType,
-          slug,
-          { ...page, body: pageBody },
-          { ifMatch },
-        );
-        return reply.status(200).send(result);
-      } catch (error) {
-        const err = adapterErrorResponse(error, { type, slug });
-        if (err) return send(reply, err.status, err.body);
-        request.log.error({ err: error }, "[Content] updatePage failed");
-        return reply.status(500).send({ error: "Internal server error" });
-      }
-    },
-  );
-};

package/templates/apps/mcp/__tests__/create_page.test.ts

@@ -1,202 +0,0 @@
-// oss: false
-/**
- * Tests for the create_page MCP tool handler.
- *
- * D14a Stage 1 Unit C — Layer 1 / Layer 2 acceptance criteria mapped here:
- *   - Free tier → canonical payment_required body, no adapter call.
- *   - Bad frontmatter → validation_failed, no adapter call.
- *   - Slug-already-exists → conflict body with details.existingVersion echoed
- *     (so the agent can pivot to update without re-fetch).
- *   - Pro tier + valid input + new slug → { page, version } success body.
- *
- * Adapter is injected as the second argument so this unit test does not need
- * Stage 1 Unit A's MDX implementation in place. The default adapter resolution
- * (createMdxAdapter against process.cwd()/content) is exercised by integration
- * tests once Unit A lands.
- */
-
-import { AdapterWriteError, type ContentAdapter } from "@working-theory/content-adapters";
-
-const mockCheckLicense = jest.fn();
-
-jest.mock("@working-theory/license", () => ({
-  checkLicense: (...args: unknown[]) => mockCheckLicense(...args),
-}));
-
-import { ailkCreatePage } from "../src/tools/create_page.js";
-
-interface AdapterCalls {
-  createPage: jest.Mock;
-  getPageBySlug: jest.Mock;
-  getPageVersion: jest.Mock;
-}
-
-function makeAdapter(overrides: Partial<AdapterCalls> = {}): ContentAdapter {
-  const calls: AdapterCalls = {
-    createPage: jest.fn(),
-    getPageBySlug: jest.fn().mockResolvedValue(null),
-    getPageVersion: jest.fn(),
-    ...overrides,
-  };
-  // eslint-disable-next-line no-restricted-syntax -- #506/#507: pre-existing test-hygiene violation
-  return {
-    getPageBySlug: calls.getPageBySlug,
-    listPages: jest.fn().mockResolvedValue([]),
-    getDetailBySlug: jest.fn().mockResolvedValue(null),
-    listDetail: jest.fn().mockResolvedValue([]),
-    searchPages: jest.fn().mockResolvedValue([]),
-    extractStructuredData: jest.fn().mockResolvedValue(null),
-    createPage: calls.createPage,
-    updatePage: jest.fn(),
-    deletePage: jest.fn(),
-    getPageVersion: calls.getPageVersion,
-  } as unknown as ContentAdapter;
-}
-
-const VALID_INPUT = {
-  type: "Product" as const,
-  slug: "widget-pro",
-  page: {
-    title: "Widget Pro",
-    description: "The professional widget.",
-  },
-  body: "# Widget Pro\n\nProfessional-grade widget.",
-};
-
-describe("ailkCreatePage", () => {
-  beforeEach(() => {
-    mockCheckLicense.mockReset();
-  });
-
-  describe("license gating", () => {
-    it("returns canonical payment_required body for free tier; adapter not called", async () => {
-      mockCheckLicense.mockResolvedValue({
-        tier: "free",
-        plan: null,
-        features: [],
-        expiresAt: null,
-        revoked: false,
-      });
-      const adapter = makeAdapter();
-
-      const result = await ailkCreatePage(VALID_INPUT, adapter);
-
-      expect(result).toMatchObject({ error: "payment_required" });
-      expect(adapter.createPage).not.toHaveBeenCalled();
-    });
-  });
-
-  describe("validation", () => {
-    beforeEach(() => {
-      mockCheckLicense.mockResolvedValue({
-        tier: "pro",
-        plan: "pro",
-        features: [],
-        expiresAt: null,
-        revoked: false,
-      });
-    });
-
-    it("returns validation_failed when frontmatter is missing required fields", async () => {
-      const adapter = makeAdapter();
-      const result = await ailkCreatePage(
-        {
-          ...VALID_INPUT,
-          page: { title: "Only title" }, // missing description
-        },
-        adapter,
-      );
-      expect(result).toMatchObject({ error: "validation_failed" });
-      expect(adapter.createPage).not.toHaveBeenCalled();
-    });
-
-    it("returns validation_failed when body is empty", async () => {
-      const adapter = makeAdapter();
-      const result = await ailkCreatePage(
-        { ...VALID_INPUT, body: "" },
-        adapter,
-      );
-      expect(result).toMatchObject({ error: "validation_failed" });
-      expect(adapter.createPage).not.toHaveBeenCalled();
-    });
-
-    it("returns validation_failed for unknown SchemaOrgType", async () => {
-      const adapter = makeAdapter();
-      const result = await ailkCreatePage(
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        { ...VALID_INPUT, type: "NotAType" as any },
-        adapter,
-      );
-      expect(result).toMatchObject({ error: "validation_failed" });
-      expect(adapter.createPage).not.toHaveBeenCalled();
-    });
-  });
-
-  describe("slug conflict", () => {
-    it("returns conflict with details.existingVersion when slug already exists", async () => {
-      mockCheckLicense.mockResolvedValue({
-        tier: "pro",
-        plan: "pro",
-        features: [],
-        expiresAt: null,
-        revoked: false,
-      });
-      const adapter = makeAdapter({
-        createPage: jest
-          .fn()
-          .mockRejectedValue(
-            new AdapterWriteError(
-              "conflict",
-              "Page already exists at Product/widget-pro.mdx",
-              { version: "abc123" },
-            ),
-          ),
-      });
-
-      const result = await ailkCreatePage(VALID_INPUT, adapter);
-
-      expect(result).toMatchObject({
-        error: "conflict",
-        details: { version: "abc123" },
-      });
-    });
-  });
-
-  describe("happy path", () => {
-    it("returns { page, version } when adapter succeeds", async () => {
-      mockCheckLicense.mockResolvedValue({
-        tier: "pro",
-        plan: "pro",
-        features: [],
-        expiresAt: null,
-        revoked: false,
-      });
-      const persistedPage = {
-        type: "Product" as const,
-        slug: "widget-pro",
-        title: "Widget Pro",
-        description: "The professional widget.",
-      };
-      const adapter = makeAdapter({
-        createPage: jest
-          .fn()
-          .mockResolvedValue({ page: persistedPage, version: "v1" }),
-      });
-
-      const result = await ailkCreatePage(VALID_INPUT, adapter);
-
-      expect(result).toEqual({ page: persistedPage, version: "v1" });
-      expect(adapter.createPage).toHaveBeenCalledTimes(1);
-      const callArgs = (adapter.createPage as jest.Mock).mock.calls[0];
-      expect(callArgs[0]).toBe("Product");
-      expect(callArgs[1]).toBe("widget-pro");
-      expect(callArgs[2]).toMatchObject({
-        type: "Product",
-        slug: "widget-pro",
-        title: "Widget Pro",
-        description: "The professional widget.",
-        body: "# Widget Pro\n\nProfessional-grade widget.",
-      });
-    });
-  });
-});

package/templates/apps/mcp/__tests__/delete_page.test.ts

@@ -1,177 +0,0 @@
-// oss: false
-/**
- * Tests for the delete_page MCP tool handler.
- *
- * D14a Stage 1 Unit C — Layer 1 / Layer 2 acceptance criteria mapped here:
- *   - Free tier → payment_required, no adapter call.
- *   - Missing ifMatch → validation_failed.
- *   - Stale ifMatch → conflict with details.currentVersion echoed.
- *   - Slug not found → not_found body.
- *   - Pro + matching ifMatch → { ok: true } success body.
- */
-
-import { AdapterWriteError, type ContentAdapter } from "@working-theory/content-adapters";
-
-const mockCheckLicense = jest.fn();
-
-jest.mock("@working-theory/license", () => ({
-  checkLicense: (...args: unknown[]) => mockCheckLicense(...args),
-}));
-
-import { ailkDeletePage } from "../src/tools/delete_page.js";
-
-function makeAdapter(
-  overrides: Partial<{ deletePage: jest.Mock }> = {},
-): ContentAdapter {
-  // eslint-disable-next-line no-restricted-syntax -- #506/#507: pre-existing test-hygiene violation
-  return {
-    getPageBySlug: jest.fn().mockResolvedValue(null),
-    listPages: jest.fn().mockResolvedValue([]),
-    getDetailBySlug: jest.fn().mockResolvedValue(null),
-    listDetail: jest.fn().mockResolvedValue([]),
-    searchPages: jest.fn().mockResolvedValue([]),
-    extractStructuredData: jest.fn().mockResolvedValue(null),
-    createPage: jest.fn(),
-    updatePage: jest.fn(),
-    deletePage: overrides.deletePage ?? jest.fn().mockResolvedValue(undefined),
-    getPageVersion: jest.fn(),
-  } as unknown as ContentAdapter;
-}
-
-const VALID_INPUT = {
-  type: "Product" as const,
-  slug: "widget-pro",
-  ifMatch: "v1",
-};
-
-describe("ailkDeletePage", () => {
-  beforeEach(() => {
-    mockCheckLicense.mockReset();
-  });
-
-  it("returns payment_required for free tier; adapter not called", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "free",
-      plan: null,
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-
-    const result = await ailkDeletePage(VALID_INPUT, adapter);
-
-    expect(result).toMatchObject({ error: "payment_required" });
-    expect(adapter.deletePage).not.toHaveBeenCalled();
-  });
-
-  it("returns validation_failed when slug violates SLUG_PATTERN (issue #398 — defence-in-depth parity with create/update)", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-
-    const result = await ailkDeletePage(
-      { ...VALID_INPUT, slug: "../etc/passwd" },
-      adapter,
-    );
-
-    expect(result).toMatchObject({ error: "validation_failed" });
-    expect(adapter.deletePage).not.toHaveBeenCalled();
-  });
-
-  it("returns validation_failed when ifMatch is missing", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-    const { ifMatch: _ignored, ...inputNoIfMatch } = VALID_INPUT;
-
-    const result = await ailkDeletePage(
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      inputNoIfMatch as any,
-      adapter,
-    );
-
-    expect(result).toMatchObject({ error: "validation_failed" });
-    expect(adapter.deletePage).not.toHaveBeenCalled();
-  });
-
-  it("returns conflict on stale ifMatch", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter({
-      deletePage: jest
-        .fn()
-        .mockRejectedValue(
-          new AdapterWriteError(
-            "conflict",
-            "Version mismatch on Product/widget-pro.mdx",
-            { currentVersion: "v9" },
-          ),
-        ),
-    });
-
-    const result = await ailkDeletePage(VALID_INPUT, adapter);
-
-    expect(result).toMatchObject({
-      error: "conflict",
-      details: { currentVersion: "v9" },
-    });
-  });
-
-  it("returns not_found when adapter signals missing slug", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter({
-      deletePage: jest
-        .fn()
-        .mockRejectedValue(
-          new AdapterWriteError(
-            "not_found",
-            "No page at Product/widget-pro.mdx",
-          ),
-        ),
-    });
-
-    const result = await ailkDeletePage(VALID_INPUT, adapter);
-
-    expect(result).toMatchObject({ error: "not_found" });
-  });
-
-  it("returns { ok: true } on happy path", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-
-    const result = await ailkDeletePage(VALID_INPUT, adapter);
-
-    expect(result).toEqual({ ok: true });
-    expect(adapter.deletePage).toHaveBeenCalledWith("Product", "widget-pro", {
-      ifMatch: "v1",
-    });
-  });
-});

package/templates/apps/mcp/__tests__/update_page.test.ts

@@ -1,196 +0,0 @@
-// oss: false
-/**
- * Tests for the update_page MCP tool handler.
- *
- * D14a Stage 1 Unit C — Layer 1 / Layer 2 acceptance criteria mapped here:
- *   - Free tier → payment_required, no adapter call.
- *   - Missing ifMatch → validation_failed (caught by input schema).
- *   - Stale ifMatch → conflict body with details.currentVersion echoed.
- *   - Slug not found → not_found body.
- *   - Bad frontmatter → validation_failed, no adapter call.
- *   - Pro + valid + matching ifMatch → { page, version } success body.
- */
-
-import { AdapterWriteError, type ContentAdapter } from "@working-theory/content-adapters";
-
-const mockCheckLicense = jest.fn();
-
-jest.mock("@working-theory/license", () => ({
-  checkLicense: (...args: unknown[]) => mockCheckLicense(...args),
-}));
-
-import { ailkUpdatePage } from "../src/tools/update_page.js";
-
-function makeAdapter(
-  overrides: Partial<{
-    updatePage: jest.Mock;
-  }> = {},
-): ContentAdapter {
-  // eslint-disable-next-line no-restricted-syntax -- #506/#507: pre-existing test-hygiene violation
-  return {
-    getPageBySlug: jest.fn().mockResolvedValue(null),
-    listPages: jest.fn().mockResolvedValue([]),
-    getDetailBySlug: jest.fn().mockResolvedValue(null),
-    listDetail: jest.fn().mockResolvedValue([]),
-    searchPages: jest.fn().mockResolvedValue([]),
-    extractStructuredData: jest.fn().mockResolvedValue(null),
-    createPage: jest.fn(),
-    updatePage: overrides.updatePage ?? jest.fn(),
-    deletePage: jest.fn(),
-    getPageVersion: jest.fn(),
-  } as unknown as ContentAdapter;
-}
-
-const VALID_INPUT = {
-  type: "Product" as const,
-  slug: "widget-pro",
-  page: {
-    title: "Widget Pro v2",
-    description: "Updated.",
-  },
-  body: "# Widget Pro v2\n",
-  ifMatch: "v1",
-};
-
-describe("ailkUpdatePage", () => {
-  beforeEach(() => {
-    mockCheckLicense.mockReset();
-  });
-
-  it("returns payment_required for free tier; adapter not called", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "free",
-      plan: null,
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-
-    const result = await ailkUpdatePage(VALID_INPUT, adapter);
-
-    expect(result).toMatchObject({ error: "payment_required" });
-    expect(adapter.updatePage).not.toHaveBeenCalled();
-  });
-
-  it("returns validation_failed when ifMatch is missing", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-    const { ifMatch: _ignored, ...inputNoIfMatch } = VALID_INPUT;
-
-    const result = await ailkUpdatePage(
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      inputNoIfMatch as any,
-      adapter,
-    );
-
-    expect(result).toMatchObject({ error: "validation_failed" });
-    expect(adapter.updatePage).not.toHaveBeenCalled();
-  });
-
-  it("returns conflict with details.currentVersion on stale ifMatch", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter({
-      updatePage: jest
-        .fn()
-        .mockRejectedValue(
-          new AdapterWriteError(
-            "conflict",
-            "Version mismatch on Product/widget-pro.mdx",
-            { currentVersion: "v9" },
-          ),
-        ),
-    });
-
-    const result = await ailkUpdatePage(VALID_INPUT, adapter);
-
-    expect(result).toMatchObject({
-      error: "conflict",
-      details: { currentVersion: "v9" },
-    });
-  });
-
-  it("returns not_found when adapter signals missing slug", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter({
-      updatePage: jest
-        .fn()
-        .mockRejectedValue(
-          new AdapterWriteError(
-            "not_found",
-            "No page at Product/widget-pro.mdx",
-          ),
-        ),
-    });
-
-    const result = await ailkUpdatePage(VALID_INPUT, adapter);
-
-    expect(result).toMatchObject({ error: "not_found" });
-  });
-
-  it("returns validation_failed when frontmatter is bad", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const adapter = makeAdapter();
-
-    const result = await ailkUpdatePage(
-      { ...VALID_INPUT, page: { title: "Missing description" } },
-      adapter,
-    );
-
-    expect(result).toMatchObject({ error: "validation_failed" });
-    expect(adapter.updatePage).not.toHaveBeenCalled();
-  });
-
-  it("returns { page, version } on happy path", async () => {
-    mockCheckLicense.mockResolvedValue({
-      tier: "pro",
-      plan: "pro",
-      features: [],
-      expiresAt: null,
-      revoked: false,
-    });
-    const persistedPage = {
-      type: "Product" as const,
-      slug: "widget-pro",
-      title: "Widget Pro v2",
-      description: "Updated.",
-    };
-    const adapter = makeAdapter({
-      updatePage: jest
-        .fn()
-        .mockResolvedValue({ page: persistedPage, version: "v2" }),
-    });
-
-    const result = await ailkUpdatePage(VALID_INPUT, adapter);
-
-    expect(result).toEqual({ page: persistedPage, version: "v2" });
-    const callArgs = (adapter.updatePage as jest.Mock).mock.calls[0];
-    expect(callArgs[0]).toBe("Product");
-    expect(callArgs[1]).toBe("widget-pro");
-    expect(callArgs[3]).toEqual({ ifMatch: "v1" });
-  });
-});