📦 deps(thirdparty): update snapshots

2026-05-29 08:33:53 +00:00
parent fdb52f1e96
commit 06e0d13d57
1615 changed files with 232858 additions and 0 deletions
@@ -0,0 +1,166 @@
+# Stage 5: Adapters
+
+**Status:** ⬜ Not Started
+**Blocked By:** Handlers
+**Unlocks:** Documents
+
+## Objective
+
+Wrap handlers with CLI and/or MCP transport adapters.
+
+## CLI Commands
+
+{{#each CLI_COMMANDS}}
+### {{this.name}}
+
+- **Handler:** `{{this.handler}}`
+- **Current File:** `{{this.file}}`
+
+#### Migration
+
+- [ ] Create command with Zod schema
+- [ ] Wrap handler
+- [ ] Use `output()` for responses
+- [ ] Use `exitWithError()` for errors
+- [ ] Add integration test
+
+```typescript
+import { command, output, exitWithError } from "@outfitter/cli";
+import { {{this.handler}} } from "../handlers/{{this.handlerFile}}";
+import { createAppContext } from "../context";
+import { z } from "zod";
+
+const InputSchema = z.object({
+  {{this.inputFields}}
+});
+
+export const {{this.name}}Command = command("{{this.commandName}}")
+  .description("{{this.description}}")
+  {{this.options}}
+  .action(async ({ args, flags }) => {
+    const ctx = createAppContext();
+    const result = await {{this.handler}}({ {{this.inputMapping}} }, ctx);
+
+    if (result.isErr()) {
+      exitWithError(result.error);
+    }
+
+    await output(result.value);
+  })
+  .build();
+```
+
+---
+
+{{/each}}
+
+## MCP Tools
+
+{{#each MCP_TOOLS}}
+### {{this.name}}
+
+- **Handler:** `{{this.handler}}`
+- **Current File:** `{{this.file}}`
+
+#### Migration
+
+- [ ] Create tool with Zod schema
+- [ ] Add `.describe()` to all fields
+- [ ] Wrap handler
+- [ ] Register with server
+- [ ] Add integration test
+
+```typescript
+import { defineTool } from "@outfitter/mcp";
+import { {{this.handler}} } from "../handlers/{{this.handlerFile}}";
+import { z } from "zod";
+
+export const {{this.name}}Tool = defineTool({
+  name: "{{this.toolName}}",
+  description: "{{this.description}}",
+  schema: z.object({
+    {{this.schemaFields}}
+  }),
+  handler: async (input, ctx) => {
+    return {{this.handler}}(input, ctx);
+  },
+});
+```
+
+---
+
+{{/each}}
+
+## CLI Patterns
+
+### Output Modes
+
+```typescript
+// Automatic mode detection (TTY vs pipe)
+await output(data);
+
+// Force specific mode
+await output(data, { mode: "json" });
+await output(data, { mode: "human" });
+```
+
+### Error Handling
+
+```typescript
+if (result.isErr()) {
+  exitWithError(result.error);
+  // Prints error message
+  // Exits with category-mapped code (1-9, 130)
+}
+```
+
+### Testing CLI
+
+```typescript
+import { createCliHarness } from "@outfitter/testing";
+
+const harness = createCliHarness(myCommand);
+
+it("handles success", async () => {
+  const result = await harness.run(["--id", "123"]);
+  expect(result.exitCode).toBe(0);
+  expect(result.stdout).toContain("success");
+});
+```
+
+## MCP Patterns
+
+### Tool Registration
+
+```typescript
+import { createMcpServer } from "@outfitter/mcp";
+
+const server = createMcpServer({ name: "myapp" });
+server.registerTool(myTool);
+server.start();
+```
+
+### Testing MCP
+
+```typescript
+import { createMcpHarness } from "@outfitter/testing";
+
+const harness = createMcpHarness(server);
+
+it("handles tool call", async () => {
+  const result = await harness.callTool("my-tool", { id: "123" });
+  expect(result.isOk()).toBe(true);
+});
+```
+
+## Completion Checklist
+
+- [ ] All CLI commands use `output()` and `exitWithError()`
+- [ ] All MCP tools have `.describe()` on schema fields
+- [ ] Handlers wrapped, not inlined
+- [ ] Integration tests with harnesses
+- [ ] Error codes verified
+
+## Notes
+
+{{ADAPTER_NOTES}}