@kelpie/server 0.1.0

package/dist/modules/handbook/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/modules/handbook/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAGtE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAEjG,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAO3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAuC;IACrE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;IAC1D,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;IAC5E,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;CAC7E,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAA;AASjD,SAAS,aAAa,CAAC,WAAmB,EAAE,OAA4B;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtF,OAAO;QACL,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC;QAC1C,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/E,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;KACrF,CAAA;AACH,CAAC;AAED,mHAAmH;AACnH,MAAM,UAAU,SAAS,CACvB,EAAa,EACb,WAAmB,EACnB,OAA4B,EAC5B,MAAsC;IAEtC,OAAO,EAAE;SACN,MAAM,EAAE;SACR,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CACJ,GAAG,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CACvF;SACA,OAAO,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;SACnD,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAa,EACb,WAAmB,EACnB,EAAU;IAEV,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE;SACrB,MAAM,EAAE;SACR,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;SAChF,KAAK,CAAC,CAAC,CAAC,CAAA;IAEX,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAa,EACb,WAAmB;IAEnB,OAAO,EAAE;SACN,MAAM,EAAE;SACR,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;SACjD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,YAAY,CAC1B,EAAa,EACb,WAAmB,EACnB,QAAuB;IAEvB,OAAO,EAAE;SACN,MAAM,EAAE;SACR,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,EAC1C,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAC1F,CACF;SACA,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;AACjE,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAa,EAAE,WAAmB;IAChE,MAAM,IAAI,GAAG,MAAM,EAAE;SAClB,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC;SACpC,IAAI,CAAC,aAAa,CAAC;SACnB,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAA;IAEpD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAa,EACb,MAA2B;IAE3B,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAA;IAE3E,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,EAAa,EACb,WAAmB,EACnB,EAAU,EACV,OAAqC;IAErC,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE;SACvB,MAAM,CAAC,aAAa,CAAC;SACrB,GAAG,CAAC,OAAO,CAAC;SACZ,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;SAChF,SAAS,EAAE,CAAA;IAEd,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAa,EAAE,WAAmB,EAAE,EAAU;IAC7E,MAAM,OAAO,GAAG,MAAM,EAAE;SACrB,MAAM,CAAC,aAAa,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;SAChF,SAAS,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAA;IAEtC,OAAO,OAAO,CAAC,MAAM,CAAA;AACvB,CAAC"}

package/dist/modules/handbook/routes.d.ts

@@ -0,0 +1,38 @@
+import type { Hono } from 'hono';
+import { z } from 'zod';
+import type { CredentialDependencies } from '../auth/credentials.ts';
+import type { CreateHandbookPageInput, HandbookPageView, HandbookService, UpdateHandbookPageInput } from './service.ts';
+/**
+ * `slug` is optional on both verbs and stays put on a rename.
+ *
+ * The mockup rewrites a page's slug every time its title is edited. Agent tasks
+ * name handbook pages by slug (`agent-tasks.md`), so a slug that follows the
+ * title would break a task definition the first time somebody fixes a typo. This
+ * is the rule pipeline stages already follow: the label renames, the import alias
+ * does not. Moving a slug on purpose is a separate field in the same request.
+ */
+export declare const createBody: z.ZodObject<{
+    title: z.ZodString;
+    body: z.ZodDefault<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * `parent_id` and `sort_order` are the move. `null` on `parent_id` lifts a page
+ * to the top level, which is what `api.md` says null means on a nullable field.
+ */
+export declare const updateBody: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    sort_order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export interface HandbookRoutesDependencies extends CredentialDependencies {
+    readonly service: HandbookService;
+}
+export declare function toCreateInput(body: z.infer<typeof createBody>): CreateHandbookPageInput;
+export declare function toUpdateInput(body: z.infer<typeof updateBody>): UpdateHandbookPageInput;
+export declare function handbookPageResponse(page: HandbookPageView): Record<string, unknown>;
+export declare function mountHandbookRoutes(router: Hono, dependencies: HandbookRoutesDependencies): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/modules/handbook/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/modules/handbook/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,MAAM,CAAA;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACxB,MAAM,cAAc,CAAA;AAarB;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;kBAKrB,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;kBAQX,CAAA;AAEZ,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAClC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,GAAG,uBAAuB,CAOvF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,GAAG,uBAAuB,CAQvF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYpF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,0BAA0B,GAAG,IAAI,CAmDhG"}

package/dist/modules/handbook/routes.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { pageBody, readIdFilter, readJsonBody, readListParameters } from '../../lib/http.js';
+import { resolveActorFrom } from '../auth/credentials.js';
+import { MAX_SLUG_LENGTH, SLUG_PATTERN } from './slugs.js';
+/**
+ * Wire shapes for `/v1/handbook_pages`. Bodies are strict; an unknown field is a
+ * 422, per `api.md`.
+ */
+const slugField = z
+    .string()
+    .min(1)
+    .max(MAX_SLUG_LENGTH)
+    .regex(SLUG_PATTERN, 'Use lowercase words joined by hyphens');
+/**
+ * `slug` is optional on both verbs and stays put on a rename.
+ *
+ * The mockup rewrites a page's slug every time its title is edited. Agent tasks
+ * name handbook pages by slug (`agent-tasks.md`), so a slug that follows the
+ * title would break a task definition the first time somebody fixes a typo. This
+ * is the rule pipeline stages already follow: the label renames, the import alias
+ * does not. Moving a slug on purpose is a separate field in the same request.
+ */
+export const createBody = z.strictObject({
+    title: z.string().min(1),
+    body: z.string().default(''),
+    slug: slugField.optional(),
+    parent_id: z.string().min(1).nullable().default(null),
+});
+/**
+ * `parent_id` and `sort_order` are the move. `null` on `parent_id` lifts a page
+ * to the top level, which is what `api.md` says null means on a nullable field.
+ */
+export const updateBody = z
+    .strictObject({
+    title: z.string().min(1),
+    body: z.string(),
+    slug: slugField,
+    parent_id: z.string().min(1).nullable(),
+    sort_order: z.number().int().min(0),
+})
+    .partial();
+export function toCreateInput(body) {
+    return {
+        title: body.title,
+        body: body.body,
+        slug: body.slug,
+        parentId: body.parent_id,
+    };
+}
+export function toUpdateInput(body) {
+    return {
+        ...(body.title === undefined ? {} : { title: body.title }),
+        ...(body.body === undefined ? {} : { body: body.body }),
+        ...(body.slug === undefined ? {} : { slug: body.slug }),
+        ...(body.parent_id === undefined ? {} : { parentId: body.parent_id }),
+        ...(body.sort_order === undefined ? {} : { sortOrder: body.sort_order }),
+    };
+}
+export function handbookPageResponse(page) {
+    return {
+        id: page.id,
+        title: page.title,
+        slug: page.slug,
+        parent_id: page.parentId,
+        sort_order: page.sortOrder,
+        body: page.body,
+        updated_by: page.updatedBy,
+        created_at: page.createdAt.toISOString(),
+        updated_at: page.updatedAt.toISOString(),
+    };
+}
+export function mountHandbookRoutes(router, dependencies) {
+    const requireActor = (context) => resolveActorFrom(dependencies, context);
+    router.get('/handbook_pages', async (context) => {
+        const page = await dependencies.service.list(await requireActor(context), {
+            term: context.req.query('q'),
+            // `readIdFilter` despite these being slugs: the shape is the one it
+            // enforces — repeatable, blank refused, capped at a page of them — and a
+            // task resolving its `handbookSlugs` asks about a set exactly that way.
+            slugs: readIdFilter(context, 'slug'),
+        }, readListParameters(context));
+        return context.json(pageBody(page, handbookPageResponse));
+    });
+    router.post('/handbook_pages', async (context) => {
+        const body = await readJsonBody(context, createBody);
+        const page = await dependencies.service.create(await requireActor(context), toCreateInput(body));
+        return context.json(handbookPageResponse(page), 201);
+    });
+    router.get('/handbook_pages/:id', async (context) => {
+        const page = await dependencies.service.get(await requireActor(context), context.req.param('id'));
+        return context.json(handbookPageResponse(page));
+    });
+    router.patch('/handbook_pages/:id', async (context) => {
+        const body = await readJsonBody(context, updateBody);
+        const page = await dependencies.service.update(await requireActor(context), context.req.param('id'), toUpdateInput(body));
+        return context.json(handbookPageResponse(page));
+    });
+    router.delete('/handbook_pages/:id', async (context) => {
+        await dependencies.service.remove(await requireActor(context), context.req.param('id'));
+        return context.body(null, 204);
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/modules/handbook/routes.js.map

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

package/dist/modules/handbook/schema.d.ts

@@ -0,0 +1,206 @@
+/**
+ * The company brain: nested markdown pages agents read over the same API as CRM
+ * records.
+ *
+ * Depth (max 4) and the no-descendant-cycles rule are enforced in the service
+ * layer; a self-referencing foreign key can express the tree but not its bounds.
+ */
+export declare const handbookPages: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "handbook_pages";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        workspaceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "workspace_id";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        title: import("drizzle-orm/pg-core").PgColumn<{
+            name: "title";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        slug: import("drizzle-orm/pg-core").PgColumn<{
+            name: "slug";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        parentId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "parent_id";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sortOrder: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sort_order";
+            tableName: "handbook_pages";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        body: import("drizzle-orm/pg-core").PgColumn<{
+            name: "body";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedBy: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_by";
+            tableName: "handbook_pages";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "handbook_pages";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updatedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "handbook_pages";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        searchVector: import("drizzle-orm/pg-core").PgColumn<{
+            name: string;
+            tableName: "handbook_pages";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: {
+                type: 'always';
+            };
+        }, {}, {
+            pgColumnBuilderBrand: 'PgCustomColumnBuilderBrand';
+        }>;
+    };
+    dialect: 'pg';
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/handbook/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/handbook/schema.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BzB,CAAA"}

package/dist/modules/handbook/schema.js

@@ -0,0 +1,37 @@
+import { index, integer, pgTable, text, unique } from 'drizzle-orm/pg-core';
+import { createdAt, primaryId, searchVector, updatedAt } from '../../lib/columns.js';
+import { workspaceMembers, workspaces } from '../workspace/schema.js';
+/**
+ * The company brain: nested markdown pages agents read over the same API as CRM
+ * records.
+ *
+ * Depth (max 4) and the no-descendant-cycles rule are enforced in the service
+ * layer; a self-referencing foreign key can express the tree but not its bounds.
+ */
+export const handbookPages = pgTable('handbook_pages', {
+    id: primaryId(),
+    workspaceId: text('workspace_id')
+        .notNull()
+        .references(() => workspaces.id, { onDelete: 'cascade' }),
+    title: text('title').notNull(),
+    slug: text('slug').notNull(),
+    parentId: text('parent_id').references(() => handbookPages.id, { onDelete: 'cascade' }),
+    sortOrder: integer('sort_order').notNull(),
+    body: text('body').notNull().default(''),
+    updatedBy: text('updated_by').references(() => workspaceMembers.id, { onDelete: 'set null' }),
+    createdAt: createdAt(),
+    updatedAt: updatedAt(),
+    // The body is markdown, and it is indexed as-is. Postgres tokenises `##` and
+    // `**` as punctuation, so the syntax costs nothing and stripping it first
+    // would mean a second copy of every page to keep in step.
+    searchVector: searchVector(() => [
+        { column: handbookPages.title, weight: 'A' },
+        { column: handbookPages.slug, weight: 'B' },
+        { column: handbookPages.body, weight: 'B' },
+    ]),
+}, (table) => [
+    unique('handbook_pages_workspace_slug_key').on(table.workspaceId, table.slug),
+    index('handbook_pages_parent_idx').on(table.workspaceId, table.parentId),
+    index('handbook_pages_search_idx').using('gin', table.searchVector),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/modules/handbook/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/modules/handbook/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE7F,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAEpF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAClC,gBAAgB,EAChB;IACE,EAAE,EAAE,SAAS,EAAE;IACf,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;SAC9B,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC3D,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,GAAgB,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACpG,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAC7F,SAAS,EAAE,SAAS,EAAE;IACtB,SAAS,EAAE,SAAS,EAAE;IACtB,6EAA6E;IAC7E,0EAA0E;IAC1E,0DAA0D;IAC1D,YAAY,EAAE,YAAY,CAAC,GAAgC,EAAE,CAAC;QAC5D,EAAE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;QAC5C,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;QAC3C,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;KAC5C,CAAC;CACH,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,MAAM,CAAC,mCAAmC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC;IAC7E,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC;IACxE,KAAK,CAAC,2BAA2B,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;CACpE,CACF,CAAA"}

package/dist/modules/handbook/service.d.ts

@@ -0,0 +1,59 @@
+import type { Database } from '../../lib/database.ts';
+import type { IdFactory } from '../../lib/ids.ts';
+import type { ListQueryParameters, Page } from '../../lib/pagination.ts';
+import type { TransactionScope } from '../../runtime/transaction.ts';
+import type { Actor } from '../auth/actor.ts';
+import type { HandbookPageFilters, HandbookPageRecord } from './repository.ts';
+/**
+ * The handbook: nested markdown pages, read by people in a sidebar and by agents
+ * over the same endpoints.
+ *
+ * This service owns the two rules the schema cannot hold. Depth and the
+ * no-descendant-cycles rule are checked here because a self-referencing foreign
+ * key expresses the shape of a tree and nothing about its bounds. Sibling order
+ * is kept contiguous from 0 for the same reason a pipeline's is: it is what lets
+ * a PATCHed `sort_order` mean "position in the sidebar" rather than an opaque
+ * number a client has to guess a gap in.
+ */
+export interface HandbookDependencies {
+    readonly db: Database;
+    readonly transaction: TransactionScope;
+    readonly createId: IdFactory;
+    readonly now: () => Date;
+}
+/** A page as the API returns one: the stored row minus the tenancy column. */
+export type HandbookPageView = Omit<HandbookPageRecord, 'workspaceId'>;
+export interface CreateHandbookPageInput {
+    readonly title: string;
+    /** Absent means empty. A page is created before it is written, which is the point of "Add subpage". */
+    readonly body: string;
+    /** Absent means derived from the title, with a numeric suffix if that is taken. */
+    readonly slug: string | undefined;
+    /** Null means top level. */
+    readonly parentId: string | null;
+}
+/**
+ * PATCH semantics: an absent field is left alone.
+ *
+ * `parentId` and `sortOrder` are the move; `title`, `body` and `slug` are the
+ * edit. A request may carry both, and the two are applied in that order so the
+ * page ends up where it was put with what it was given.
+ */
+export interface UpdateHandbookPageInput {
+    readonly title?: string | undefined;
+    readonly body?: string | undefined;
+    readonly slug?: string | undefined;
+    /** Null moves the page to the top level. */
+    readonly parentId?: string | null | undefined;
+    /** The page's new position among its siblings, 0-based. */
+    readonly sortOrder?: number | undefined;
+}
+export interface HandbookService {
+    list(actor: Actor, filters: HandbookPageFilters, query: ListQueryParameters): Promise<Page<HandbookPageView>>;
+    get(actor: Actor, id: string): Promise<HandbookPageView>;
+    create(actor: Actor, input: CreateHandbookPageInput): Promise<HandbookPageView>;
+    update(actor: Actor, id: string, changes: UpdateHandbookPageInput): Promise<HandbookPageView>;
+    remove(actor: Actor, id: string): Promise<void>;
+}
+export declare function createHandbookService(dependencies: HandbookDependencies): HandbookService;
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/handbook/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/handbook/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACjF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAI7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAK9E;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAA;AAEtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uGAAuG;IACvG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CACF,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAClC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACxD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC/E,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7F,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AA4BD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,oBAAoB,GAAG,eAAe,CAsSzF"}