norn-cli 3.0.0 → 3.1.0

package/demos/mcp-ticket-testing/servers/house-server.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+/**
+ * "House" — the custom MCP server a team writes for its own product.
+ *
+ * Deterministic on purpose: the demo is about declaring a server and granting it, not about
+ * what any particular tool does. Everything here is in-memory and reset per process.
+ */
+
+const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const { ListToolsRequestSchema, CallToolRequestSchema } = require('@modelcontextprotocol/sdk/types.js');
+
+const state = {
+    tenant: 'acme',
+    auditLog: [],
+    orders: [
+        { id: 'A-1001', tenant: 'acme', total: 42.5, status: 'placed' },
+        { id: 'A-1002', tenant: 'acme', total: 18.0, status: 'shipped' }
+    ]
+};
+
+const TOOLS = [
+    {
+        name: 'getFixtureUser',
+        description: 'Return the seeded test user for the current tenant.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: {} }
+    },
+    {
+        name: 'resetTenant',
+        description: 'Reset the tenant to its seeded state before a test run.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: {} }
+    },
+    {
+        name: 'callEndpoint',
+        description: 'Call a backend endpoint and return its status and body.',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                method: { type: 'string', description: 'HTTP method, e.g. GET or POST.' },
+                path: { type: 'string', description: 'Endpoint path, e.g. /orders/A-1001.' }
+            },
+            required: ['method', 'path']
+        }
+    },
+    {
+        name: 'readAuditLog',
+        description: 'Return the audit entries written during this run, oldest first.',
+        inputSchema: { type: 'object', additionalProperties: false, properties: {} }
+    },
+    {
+        name: 'queryDb',
+        description: 'Read rows from a seeded table by name.',
+        inputSchema: {
+            type: 'object',
+            additionalProperties: false,
+            properties: { table: { type: 'string', description: 'Table to read, e.g. orders.' } },
+            required: ['table']
+        }
+    }
+];
+
+function structured(value) {
+    return { content: [{ type: 'text', text: JSON.stringify(value) }], structuredContent: value };
+}
+
+function callEndpoint(args) {
+    const path = String(args.path || '');
+    const method = String(args.method || 'GET').toUpperCase();
+    state.auditLog.push({ at: state.auditLog.length + 1, method, path });
+
+    const orderMatch = path.match(/^\/orders\/([A-Za-z0-9-]+)$/);
+    if (orderMatch) {
+        const order = state.orders.find(item => item.id === orderMatch[1]);
+        return order
+            ? { status: 200, body: order }
+            : { status: 404, body: { error: 'order not found' } };
+    }
+    if (path === '/orders') {
+        return { status: 200, body: { orders: state.orders } };
+    }
+    return { status: 404, body: { error: 'no such endpoint' } };
+}
+
+async function main() {
+    const server = new Server(
+        { name: 'norn-demo-house', version: '1.0.0' },
+        { capabilities: { tools: {} } }
+    );
+
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+    server.setRequestHandler(CallToolRequestSchema, async request => {
+        const args = request.params.arguments || {};
+        switch (request.params.name) {
+            case 'getFixtureUser':
+                return structured({ id: 'u-1', email: 'tester@example.com', tenant: state.tenant });
+            case 'resetTenant':
+                state.auditLog = [];
+                return structured({ tenant: state.tenant, reset: true });
+            case 'callEndpoint':
+                return structured(callEndpoint(args));
+            case 'readAuditLog':
+                return structured({ entries: state.auditLog });
+            case 'queryDb':
+                return structured({
+                    table: args.table,
+                    rows: args.table === 'orders' ? state.orders : []
+                });
+            default:
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: `Unknown tool: ${request.params.name}` }]
+                };
+        }
+    });
+
+    await server.connect(new StdioServerTransport());
+}
+
+main().catch(error => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});

package/demos/mcp-ticket-testing/tickets.norn

@@ -0,0 +1,32 @@
+import "./agents.nornagent"
+
+# Prove both servers are reachable without spending anything on a model.
+# These steps resolve the same aliases the agents use, so a failure here points at the server
+# rather than at an agent — this is the loop to develop a server against.
+test sequence ServersUp
+    var browserTools = run mcp list Browser
+    assert browserTools.length > 0
+
+    var houseTools = run mcp list House
+    assert houseTools.length > 0
+
+    var user = run mcp call House getFixtureUser()
+    assert user.structuredContent.email == "tester@example.com"
+end sequence
+
+# The application this whole slice was designed against: a ticket arrives, two agents test it
+# from different sides with different tools, a third writes it up, and a judge rules on whether
+# the expected test cases were actually covered.
+test sequence TicketPROJ142
+    var ticket = run readJson "./fixtures/proj-142.json"
+
+    var frontend = run FrontendTester ticket
+    var backend = run BackendTester ticket
+    # An agent's input is a variable or a string — there is no object-literal form — so the two
+    # runs are interpolated into one prompt.
+    var report = run Reporter "Frontend run:\n{{frontend.body}}\n\nBackend run:\n{{backend.body}}"
+
+    print "QA report" | "{{report.text}}"
+
+    judge report with Reviewer expects file expectations/proj-142.md
+end sequence