@braidhq/server 0.0.1 → 0.1.0

package/dist/routes/clarify.js

@@ -1,83 +1,273 @@
-import { ClarifyCandidateId, ClarifyDraft, ClarifyStatus, ClarifyTicketId, ProposalId, UserId } from '@braidhq/schema';
-import { zValidator } from '@hono/zod-validator';
-import { Hono } from 'hono';
-import { z } from 'zod';
+import { newClarifyCandidateId } from '@braidhq/core';
+import { ClarifyCandidate, ClarifyCandidateId, ClarifyDraft, ClarifyStatus, ClarifyTicket, ClarifyTicketId, Decision, ProposalId, UserId } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
+import { getUserId } from '../middleware/userId.js';
+import { getViewerContext, requirePermission } from '../middleware/workspaceAccess.js';
 import { getWorkspaceId } from '../middleware/workspaceId.js';
+import { NotFoundResponse, ValidationFailureResponse, WorkspaceIdParam } from './_shared.js';
 import { assertEntityInWorkspace } from './helpers.js';
-const ListQuerySchema = z.object({
-    status: z.union([ClarifyStatus, z.array(ClarifyStatus)]).optional(),
+async function latestRationale(decisions, workspaceId, ticketId, action) {
+    const all = await decisions.list({ workspaceId, actions: [action] });
+    const match = all
+        .filter(d => d.references.clarifyTicketId === ticketId && typeof d.rationale === 'string')
+        .sort((a, b) => (a.timestamp < b.timestamp ? 1 : -1))[0];
+    return match?.rationale;
+}
+const ListQuery = z.object({
+    status: z.union([ClarifyStatus, z.array(ClarifyStatus)]).optional().openapi({ description: 'Filter by ticket status; pass one or many.' }),
     limit: z.coerce.number().int().positive().optional(),
     offset: z.coerce.number().int().nonnegative().optional(),
+    showAll: z.coerce.boolean().optional().openapi({ description: 'Owner-only: bypass the personal-pending filter so every member\'s open questions are visible.' }),
 });
-const AnswerBodySchema = z.object({
-    candidateId: ClarifyCandidateId,
-    userId: UserId,
-});
-const SkipBodySchema = z.object({
+// Reviewer-facing answer body. The selection is either an existing
+// `candidateId` or a freshly authored `customCandidate` (description
+// only — the server appends it to the ticket and answers in one
+// transaction). `note` is a free-text rationale that survives on the
+// Decision log; the GET projection surfaces it back as `answerNote`.
+// `userId` accepted for backwards compat; authoritative value is the
+// request context (set by `userIdMiddleware`).
+const AnswerBody = z
+    .object({
+    candidateId: ClarifyCandidateId.optional(),
+    customCandidate: z.object({ description: z.string().min(1) }).optional(),
+    userId: UserId.optional(),
+    note: z.string().min(1).optional(),
+})
+    .refine(body => Boolean(body.candidateId) !== Boolean(body.customCandidate), { message: 'Provide exactly one of candidateId or customCandidate' })
+    .openapi('ClarifyAnswerBody');
+const SkipBody = z.object({
     reason: z.string().min(1),
-    userId: UserId,
+    userId: UserId.optional(),
+}).openapi('ClarifySkipBody');
+// PATCH body for clarify state transitions. Currently the only legal
+// transition the skill drives is `answered → applied`. proposalId is
+// optional: present when a Proposal was produced, absent when the
+// chosen candidate had no graph impact (skill records the ticket as
+// applied without a linking proposal).
+const ApplyBody = z.object({
+    status: z.literal('applied'),
+    proposalId: ProposalId.optional(),
+    userId: UserId.optional(),
+}).openapi('ClarifyApplyBody');
+// Skill-emitted candidates ship their own ids (`cc-1`, `cc-merge`, …);
+// human-authored ones via Studio's "New question" form omit them and
+// let the server mint via `newClarifyCandidateId`. Keeps the ID
+// minting rule (no `crypto.randomUUID() as XxxId` in clients) intact.
+const CreateBody = ClarifyDraft
+    .omit({ workspaceId: true })
+    .extend({ candidates: z.array(ClarifyCandidate.partial({ id: true })) })
+    .openapi('ClarifyCreateBody');
+const ClarifyTicketIdParam = WorkspaceIdParam.extend({
+    clarifyTicketId: ClarifyTicketId.openapi({ param: { name: 'clarifyTicketId', in: 'path' } }),
+});
+const ClarifyListResponse = z.object({
+    items: z.array(ClarifyTicket),
+}).openapi('ClarifyListResponse');
+// GET /clarify/:id may attach a projection field (`skipReason` /
+// `answerNote`) when surfacing the latest Decision rationale. Either
+// field shows up on top of the base ClarifyTicket shape; never both.
+const ClarifyTicketWithProjection = ClarifyTicket.extend({
+    skipReason: z.string().optional(),
+    answerNote: z.string().optional(),
+}).openapi('ClarifyTicketWithProjection');
+const createClarifyRoute = createRoute({
+    method: 'post',
+    path: '/',
+    operationId: 'createClarifyTicket',
+    summary: 'Create a clarify ticket. Skills submit this when they cannot decide between candidate interpretations.',
+    tags: ['clarify'],
+    request: {
+        params: WorkspaceIdParam,
+        body: { content: { 'application/json': { schema: CreateBody } } },
+    },
+    responses: {
+        201: {
+            description: 'The saved clarify ticket.',
+            content: { 'application/json': { schema: ClarifyTicket } },
+        },
+        400: ValidationFailureResponse,
+    },
+});
+const listClarifyRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listClarifyTickets',
+    summary: 'List clarify tickets for a workspace, optionally filtered by status.',
+    tags: ['clarify'],
+    request: {
+        params: WorkspaceIdParam,
+        query: ListQuery,
+    },
+    responses: {
+        200: {
+            description: 'A page of matching clarify tickets.',
+            content: { 'application/json': { schema: ClarifyListResponse } },
+        },
+    },
 });
-const LinkProposalBodySchema = z.object({
-    proposalId: ProposalId,
-    userId: UserId,
+const getClarifyRoute = createRoute({
+    method: 'get',
+    path: '/{clarifyTicketId}',
+    operationId: 'getClarifyTicket',
+    summary: 'Fetch a single clarify ticket. May include `skipReason` / `answerNote` projection when terminal.',
+    tags: ['clarify'],
+    request: { params: ClarifyTicketIdParam },
+    responses: {
+        200: {
+            description: 'The requested ticket (optionally with skipReason / answerNote projection).',
+            content: { 'application/json': { schema: ClarifyTicketWithProjection } },
+        },
+        404: NotFoundResponse,
+    },
+});
+const answerClarifyRoute = createRoute({
+    method: 'post',
+    path: '/{clarifyTicketId}/answer',
+    operationId: 'answerClarifyTicket',
+    summary: 'Reviewer answers a clarify ticket. Triggers `pending → answered` transition.',
+    tags: ['clarify'],
+    request: {
+        params: ClarifyTicketIdParam,
+        body: { content: { 'application/json': { schema: AnswerBody } } },
+    },
+    responses: {
+        200: {
+            description: 'The recorded Decision.',
+            content: { 'application/json': { schema: Decision } },
+        },
+        404: NotFoundResponse,
+    },
+});
+const applyClarifyRoute = createRoute({
+    method: 'patch',
+    path: '/{clarifyTicketId}',
+    operationId: 'markClarifyTicketApplied',
+    summary: 'Mark a clarify ticket applied. Optionally link the materialised Proposal.',
+    description: 'Called by the braid-clarify skill once it has wrapped the resolution into a Proposal (or determined there is no graph impact). Transitions `answered → applied`.',
+    tags: ['clarify'],
+    request: {
+        params: ClarifyTicketIdParam,
+        body: { content: { 'application/json': { schema: ApplyBody } } },
+    },
+    responses: {
+        200: {
+            description: 'The recorded Decision.',
+            content: { 'application/json': { schema: Decision } },
+        },
+        404: NotFoundResponse,
+    },
+});
+const skipClarifyRoute = createRoute({
+    method: 'post',
+    path: '/{clarifyTicketId}/skip',
+    operationId: 'skipClarifyTicket',
+    summary: 'Skip a clarify ticket with a reason. Triggers `pending → skipped` transition.',
+    tags: ['clarify'],
+    request: {
+        params: ClarifyTicketIdParam,
+        body: { content: { 'application/json': { schema: SkipBody } } },
+    },
+    responses: {
+        200: {
+            description: 'The recorded Decision.',
+            content: { 'application/json': { schema: Decision } },
+        },
+        404: NotFoundResponse,
+    },
 });
-const CreateBodySchema = ClarifyDraft.omit({ workspaceId: true });
 export function createClarifyRouter(deps) {
-    const router = new Hono();
-    // Skill-facing create. Body is the ClarifyDraft minus workspaceId (taken
-    // from the URL). Candidates' proposedOperations are NOT validated here;
-    // they are validated when a user picks one via answerClarifyTicket.
-    router.post('/', zValidator('json', CreateBodySchema), async (context) => {
+    const router = new OpenAPIHono();
+    // Answer / skip / mark-applied are HITL decisions — Owner + Maintainer
+    // only. Guests never see the tab but a direct curl still 403s here.
+    router.use('/:clarifyTicketId/answer', requirePermission('clarify.write'));
+    router.use('/:clarifyTicketId/skip', requirePermission('clarify.write'));
+    router.use('/:clarifyTicketId', requirePermission('clarify.write'));
+    router.openapi(createClarifyRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
         const body = context.req.valid('json');
-        const ticket = await deps.hitlService.submitClarifyTicket({ workspaceId, ...body });
+        const submitterId = getUserId(context);
+        const candidates = body.candidates.map(c => ({
+            ...c,
+            id: c.id ?? newClarifyCandidateId(),
+        }));
+        const ticket = await deps.hitlService.submitClarifyTicket({ ...body, workspaceId, candidates, submitterId });
         return context.json(ticket.toData(), 201);
     });
-    router.get('/', zValidator('query', ListQuerySchema), async (context) => {
+    router.openapi(listClarifyRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
-        const { status, limit, offset } = context.req.valid('query');
+        const { status, limit, offset, showAll } = context.req.valid('query');
         const statuses = status === undefined ? undefined : Array.isArray(status) ? status : [status];
-        const tickets = await deps.clarifyRepository.list({ workspaceId, statuses, limit, offset });
-        return context.json({ items: tickets.map(ticket => ticket.toData()) });
+        const viewer = getViewerContext(context);
+        const viewerId = (showAll && viewer?.effectiveRole === 'owner') ? undefined : getUserId(context);
+        const tickets = await deps.clarifyRepository.list({
+            workspaceId,
+            statuses,
+            limit,
+            offset,
+            ...(viewerId ? { viewerId } : {}),
+        });
+        return context.json({ items: tickets.map(ticket => ticket.toData()) }, 200);
     });
-    router.get('/:clarifyTicketId', async (context) => {
+    router.openapi(getClarifyRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
-        const ticketId = ClarifyTicketId.parse(context.req.param('clarifyTicketId'));
-        const ticket = await deps.clarifyRepository.load(ticketId);
-        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', ticketId);
-        return context.json(ticket.toData());
+        const { clarifyTicketId } = context.req.valid('param');
+        const ticket = await deps.clarifyRepository.load(clarifyTicketId);
+        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', clarifyTicketId);
+        const data = ticket.toData();
+        // Surface the reviewer's free-text rationale alongside the ticket
+        // so the UI can show it without a separate decisions fetch. The
+        // text lives only on the Decision; we read the latest matching one
+        // and add a projection field (`skipReason` or `answerNote`) for
+        // the relevant terminal status.
+        if (data.status === 'skipped') {
+            const reason = await latestRationale(deps.decisionRepository, workspaceId, clarifyTicketId, 'skipClarifyTicket');
+            if (reason)
+                return context.json({ ...data, skipReason: reason }, 200);
+        }
+        else if (data.status === 'answered' || data.status === 'applied') {
+            const note = await latestRationale(deps.decisionRepository, workspaceId, clarifyTicketId, 'answerClarifyTicket');
+            if (note)
+                return context.json({ ...data, answerNote: note }, 200);
+        }
+        return context.json(data, 200);
     });
-    router.post('/:clarifyTicketId/answer', zValidator('json', AnswerBodySchema), async (context) => {
+    router.openapi(answerClarifyRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
-        const ticketId = ClarifyTicketId.parse(context.req.param('clarifyTicketId'));
-        const { candidateId, userId } = context.req.valid('json');
-        const ticket = await deps.clarifyRepository.load(ticketId);
-        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', ticketId);
-        const decision = await deps.hitlService.answerClarifyTicket(ticketId, candidateId, userId);
-        return context.json(decision);
+        const { clarifyTicketId } = context.req.valid('param');
+        const body = context.req.valid('json');
+        const userId = body.userId ?? getUserId(context);
+        const ticket = await deps.clarifyRepository.load(clarifyTicketId);
+        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', clarifyTicketId);
+        const selection = body.candidateId
+            ? { kind: 'existing', candidateId: body.candidateId }
+            : { kind: 'custom', description: body.customCandidate.description };
+        const decision = await deps.hitlService.answerClarifyTicket({
+            clarifyTicketId,
+            selection,
+            userId,
+            ...(body.note ? { note: body.note } : {}),
+        });
+        return context.json(decision, 200);
     });
-    // Skill-facing: the braid-clarify skill calls this once it has wrapped
-    // an `answered` ticket's resolution into a Proposal. Transitions the
-    // ticket `answered → applied` and stamps the linking proposalId so the
-    // UI can navigate from a ticket back to its Proposal. No graph
-    // mutation happens here; the Proposal apply already covered that.
-    router.patch('/:clarifyTicketId', zValidator('json', LinkProposalBodySchema), async (context) => {
+    router.openapi(applyClarifyRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
-        const ticketId = ClarifyTicketId.parse(context.req.param('clarifyTicketId'));
-        const { proposalId, userId } = context.req.valid('json');
-        const ticket = await deps.clarifyRepository.load(ticketId);
-        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', ticketId);
-        const decision = await deps.hitlService.linkClarifyTicketToProposal(ticketId, proposalId, userId);
-        return context.json(decision);
+        const { clarifyTicketId } = context.req.valid('param');
+        const { proposalId, userId: bodyUserId } = context.req.valid('json');
+        const userId = bodyUserId ?? getUserId(context);
+        const ticket = await deps.clarifyRepository.load(clarifyTicketId);
+        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', clarifyTicketId);
+        const decision = await deps.hitlService.markClarifyTicketApplied(clarifyTicketId, userId, proposalId);
+        return context.json(decision, 200);
     });
-    router.post('/:clarifyTicketId/skip', zValidator('json', SkipBodySchema), async (context) => {
+    router.openapi(skipClarifyRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
-        const ticketId = ClarifyTicketId.parse(context.req.param('clarifyTicketId'));
-        const { reason, userId } = context.req.valid('json');
-        const ticket = await deps.clarifyRepository.load(ticketId);
-        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', ticketId);
-        const decision = await deps.hitlService.skipClarifyTicket(ticketId, reason, userId);
-        return context.json(decision);
+        const { clarifyTicketId } = context.req.valid('param');
+        const { reason, userId: bodyUserId } = context.req.valid('json');
+        const userId = bodyUserId ?? getUserId(context);
+        const ticket = await deps.clarifyRepository.load(clarifyTicketId);
+        assertEntityInWorkspace(workspaceId, ticket.workspaceId, 'ClarifyTicket', clarifyTicketId);
+        const decision = await deps.hitlService.skipClarifyTicket(clarifyTicketId, reason, userId);
+        return context.json(decision, 200);
     });
     return router;
 }

package/dist/routes/clarify.js.map

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

package/dist/routes/decisions.d.ts

@@ -1,7 +1,7 @@
 import type { DecisionRepository } from '@braidhq/core';
-import { Hono } from 'hono';
+import { OpenAPIHono } from '@hono/zod-openapi';
 export interface DecisionsRouterDeps {
     decisionRepository: DecisionRepository;
 }
-export declare function createDecisionsRouter(deps: DecisionsRouterDeps): Hono;
+export declare function createDecisionsRouter(deps: DecisionsRouterDeps): OpenAPIHono;
 //# sourceMappingURL=decisions.d.ts.map

package/dist/routes/decisions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/routes/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGvD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAW3B,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,kBAAkB,CAAA;CACvC;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAoBrE"}
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/routes/decisions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAmB/D,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,kBAAkB,CAAA;CACvC;AAqCD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAoB5E"}

package/dist/routes/decisions.js

@@ -1,29 +1,67 @@
-import { DecisionAction, DecisionId } from '@braidhq/schema';
-import { zValidator } from '@hono/zod-validator';
-import { Hono } from 'hono';
-import { z } from 'zod';
+import { Decision, DecisionAction, DecisionId } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
 import { getWorkspaceId } from '../middleware/workspaceId.js';
+import { NotFoundResponse, ValidationFailureResponse, WorkspaceIdParam } from './_shared.js';
 import { assertEntityInWorkspace } from './helpers.js';
-const ListQuerySchema = z.object({
-    action: z.union([DecisionAction, z.array(DecisionAction)]).optional(),
+const ListQuery = z.object({
+    action: z.union([DecisionAction, z.array(DecisionAction)]).optional().openapi({ description: 'Filter by decision action; pass one or many.' }),
     limit: z.coerce.number().int().positive().optional(),
     offset: z.coerce.number().int().nonnegative().optional(),
 });
+const DecisionIdParam = WorkspaceIdParam.extend({
+    decisionId: DecisionId.openapi({ param: { name: 'decisionId', in: 'path' } }),
+});
+const DecisionListResponse = z.object({
+    items: z.array(Decision),
+}).openapi('DecisionListResponse');
+const listDecisionsRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listDecisions',
+    summary: 'List apply / reject / answer / skip decisions for a workspace.',
+    tags: ['decisions'],
+    request: {
+        params: WorkspaceIdParam,
+        query: ListQuery,
+    },
+    responses: {
+        200: {
+            description: 'A page of matching decisions.',
+            content: { 'application/json': { schema: DecisionListResponse } },
+        },
+        400: ValidationFailureResponse,
+    },
+});
+const getDecisionRoute = createRoute({
+    method: 'get',
+    path: '/{decisionId}',
+    operationId: 'getDecision',
+    summary: 'Fetch a single decision by id.',
+    tags: ['decisions'],
+    request: { params: DecisionIdParam },
+    responses: {
+        200: {
+            description: 'The requested decision.',
+            content: { 'application/json': { schema: Decision } },
+        },
+        404: NotFoundResponse,
+    },
+});
 export function createDecisionsRouter(deps) {
-    const router = new Hono();
-    router.get('/', zValidator('query', ListQuerySchema), async (context) => {
+    const router = new OpenAPIHono();
+    router.openapi(listDecisionsRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
         const { action, limit, offset } = context.req.valid('query');
         const actions = action === undefined ? undefined : Array.isArray(action) ? action : [action];
         const decisions = await deps.decisionRepository.list({ workspaceId, actions, limit, offset });
-        return context.json({ items: decisions });
+        return context.json({ items: decisions }, 200);
     });
-    router.get('/:decisionId', async (context) => {
+    router.openapi(getDecisionRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
-        const decisionId = DecisionId.parse(context.req.param('decisionId'));
+        const { decisionId } = context.req.valid('param');
         const decision = await deps.decisionRepository.load(decisionId);
         assertEntityInWorkspace(workspaceId, decision.workspaceId, 'Decision', decisionId);
-        return context.json(decision);
+        return context.json(decision, 200);
     });
     return router;
 }

package/dist/routes/decisions.js.map

@@ -1 +1 @@
-{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../src/routes/decisions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAEtD,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAA;AAMF,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAA;IAEzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACtE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5D,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QAC5F,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7F,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3C,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;QACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/D,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;QAClF,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../src/routes/decisions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAEtD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;IAC9I,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAA;AAEF,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;CAC9E,CAAC,CAAA;AAEF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;CACzB,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAA;AAMlC,MAAM,kBAAkB,GAAG,WAAW,CAAC;IACrC,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,eAAe;IAC5B,OAAO,EAAE,gEAAgE;IACzE,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,OAAO,EAAE;QACP,MAAM,EAAE,gBAAgB;QACxB,KAAK,EAAE,SAAS;KACjB;IACD,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,+BAA+B;YAC5C,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE;SAClE;QACD,GAAG,EAAE,yBAAyB;KAC/B;CACF,CAAC,CAAA;AAEF,MAAM,gBAAgB,GAAG,WAAW,CAAC;IACnC,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE,gCAAgC;IACzC,IAAI,EAAE,CAAC,WAAW,CAAC;IACnB,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;IACpC,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;SACtD;QACD,GAAG,EAAE,gBAAgB;KACtB;CACF,CAAC,CAAA;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,MAAM,MAAM,GAAG,IAAI,WAAW,EAAE,CAAA;IAEhC,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACnD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5D,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QAC5F,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC7F,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;IAEF,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjD,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC/D,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;QAClF,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/routes/edges.d.ts

@@ -1,7 +1,7 @@
 import type { ModelService } from '@braidhq/core';
-import { Hono } from 'hono';
+import { OpenAPIHono } from '@hono/zod-openapi';
 export interface EdgesRouterDeps {
     modelService: ModelService;
 }
-export declare function createEdgesRouter(deps: EdgesRouterDeps): Hono;
+export declare function createEdgesRouter(deps: EdgesRouterDeps): OpenAPIHono;
 //# sourceMappingURL=edges.d.ts.map

package/dist/routes/edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../src/routes/edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAY3B,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAkB7D"}
+{"version":3,"file":"edges.d.ts","sourceRoot":"","sources":["../../src/routes/edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAkB/D,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,YAAY,CAAA;CAC3B;AAqBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAkBpE"}

package/dist/routes/edges.js

@@ -1,18 +1,40 @@
-import { EdgeTypeId, NodeId } from '@braidhq/schema';
-import { zValidator } from '@hono/zod-validator';
-import { Hono } from 'hono';
-import { z } from 'zod';
+import { EdgeTypeId, GraphEdge, NodeId } from '@braidhq/schema';
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
 import { getWorkspaceId } from '../middleware/workspaceId.js';
-const ListQuerySchema = z.object({
-    type: z.union([EdgeTypeId, z.array(EdgeTypeId)]).optional(),
-    fromNodeId: NodeId.optional(),
-    toNodeId: NodeId.optional(),
-    limit: z.coerce.number().int().positive().optional(),
-    offset: z.coerce.number().int().nonnegative().optional(),
+import { ValidationFailureResponse, WorkspaceIdParam } from './_shared.js';
+const ListQuery = z.object({
+    type: z.union([EdgeTypeId, z.array(EdgeTypeId)]).optional().openapi({ description: 'Filter by edge type id; pass one or many.' }),
+    fromNodeId: NodeId.optional()
+        .openapi({ description: 'Filter to edges originating from this node.' }),
+    toNodeId: NodeId.optional()
+        .openapi({ description: 'Filter to edges terminating at this node.' }),
+    limit: z.coerce.number().int().positive().optional().openapi({ description: 'Maximum number of edges to return.' }),
+    offset: z.coerce.number().int().nonnegative().optional().openapi({ description: 'Number of edges to skip before returning.' }),
+});
+const EdgeListResponse = z.object({
+    items: z.array(GraphEdge),
+}).openapi('EdgeListResponse');
+const listEdgesRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'listEdges',
+    summary: 'List edges in the graph, optionally filtered by type / endpoint / pagination.',
+    tags: ['edges'],
+    request: {
+        params: WorkspaceIdParam,
+        query: ListQuery,
+    },
+    responses: {
+        200: {
+            description: 'A page of matching edges.',
+            content: { 'application/json': { schema: EdgeListResponse } },
+        },
+        400: ValidationFailureResponse,
+    },
 });
 export function createEdgesRouter(deps) {
-    const router = new Hono();
-    router.get('/', zValidator('query', ListQuerySchema), async (context) => {
+    const router = new OpenAPIHono();
+    router.openapi(listEdgesRoute, async (context) => {
         const workspaceId = getWorkspaceId(context);
         const { type, fromNodeId, toNodeId, limit, offset } = context.req.valid('query');
         const types = type === undefined ? undefined : Array.isArray(type) ? type : [type];
@@ -23,7 +45,7 @@ export function createEdgesRouter(deps) {
             limit,
             offset,
         });
-        return context.json({ items: edges });
+        return context.json({ items: edges }, 200);
     });
     return router;
 }

package/dist/routes/edges.js.map

@@ -1 +1 @@
-{"version":3,"file":"edges.js","sourceRoot":"","sources":["../../src/routes/edges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAE7D,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAA;AAMF,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAA;IAEzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACtE,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAC3C,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAChF,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAClF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,WAAW,EAAE;YAC3D,KAAK;YACL,UAAU;YACV,QAAQ;YACR,KAAK;YACL,MAAM;SACP,CAAC,CAAA;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"edges.js","sourceRoot":"","sources":["../../src/routes/edges.ts"],"names":[],"mappings":"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"}

package/dist/routes/health.d.ts

@@ -1,3 +1,3 @@
-import { Hono } from 'hono';
-export declare const healthRouter: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+import { OpenAPIHono } from '@hono/zod-openapi';
+export declare const healthRouter: OpenAPIHono<import("hono").Env, {}, "/">;
 //# sourceMappingURL=health.d.ts.map

package/dist/routes/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,eAAO,MAAM,YAAY,4EAAa,CAAA"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAK,MAAM,mBAAmB,CAAA;AAsB/D,eAAO,MAAM,YAAY,0CAAoB,CAAA"}

package/dist/routes/health.js

@@ -1,6 +1,24 @@
-import { Hono } from 'hono';
-export const healthRouter = new Hono();
-healthRouter.get('/', (context) => {
+import { createRoute, OpenAPIHono, z } from '@hono/zod-openapi';
+const HealthResponse = z.object({
+    status: z.literal('ok'),
+    service: z.literal('braid-server'),
+    timestamp: z.string(),
+}).openapi('HealthResponse');
+const healthRoute = createRoute({
+    method: 'get',
+    path: '/',
+    operationId: 'health',
+    summary: 'Liveness probe',
+    tags: ['health'],
+    responses: {
+        200: {
+            description: 'Server is up.',
+            content: { 'application/json': { schema: HealthResponse } },
+        },
+    },
+});
+export const healthRouter = new OpenAPIHono();
+healthRouter.openapi(healthRoute, (context) => {
     return context.json({
         status: 'ok',
         service: 'braid-server',

package/dist/routes/health.js.map

@@ -1 +1 @@
-{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAE3B,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,IAAI,EAAE,CAAA;AAEtC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE;IAChC,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAE5B,MAAM,WAAW,GAAG,WAAW,CAAC;IAC9B,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,GAAG;IACT,WAAW,EAAE,QAAQ;IACrB,OAAO,EAAE,gBAAgB;IACzB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,SAAS,EAAE;QACT,GAAG,EAAE;YACH,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;SAC5D;KACF;CACF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAA;AAE7C,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,MAAM,EAAE,IAAa;QACrB,OAAO,EAAE,cAAuB;QAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}