daycare-cli 0.0.0-canary.00a24ac

package/dist/engine/observations/topographyEvents.spec.js

@@ -0,0 +1,374 @@
+import { describe, expect, it } from "vitest";
+import { storageOpenTest } from "../../storage/storageOpenTest.js";
+import { TOPO_EVENT_TYPES, TOPO_SOURCE_AGENTS, TOPO_SOURCE_CHANNELS, TOPO_SOURCE_CRONS, TOPO_SOURCE_EXPOSES, TOPO_SOURCE_FRIENDS, TOPO_SOURCE_SECRETS, TOPO_SOURCE_SIGNALS, TOPO_SOURCE_SUBUSERS, TOPO_SOURCE_TASKS, TOPO_SOURCE_WEBHOOKS, topographyObservationEmit } from "./topographyEvents.js";
+function topographyEmitCase(input) {
+    return input;
+}
+describe("topographyObservationEmit", () => {
+    it("emits all typed topography events with persisted data and scope IDs", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const cases = [
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.AGENT_CREATED,
+                    source: TOPO_SOURCE_AGENTS,
+                    message: "Agent created: worker",
+                    details: "details",
+                    data: {
+                        agentId: "agent-1",
+                        userId: "user-1",
+                        pathKind: "sub",
+                        label: "worker",
+                        parentAgentId: "parent-1"
+                    },
+                    scopeIds: ["user-1", "parent-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.AGENT_UPDATED,
+                    source: TOPO_SOURCE_AGENTS,
+                    message: "Agent updated: worker",
+                    details: "details",
+                    data: {
+                        agentId: "agent-1",
+                        userId: "user-1",
+                        pathKind: "sub",
+                        label: "worker"
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.AGENT_LIFECYCLE,
+                    source: TOPO_SOURCE_AGENTS,
+                    message: "Agent sleeping: worker",
+                    details: "details",
+                    data: {
+                        agentId: "agent-1",
+                        userId: "user-1",
+                        lifecycle: "sleeping",
+                        label: "worker"
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.TASK_CREATED,
+                    source: TOPO_SOURCE_TASKS,
+                    message: "Task created: backup",
+                    details: "details",
+                    data: { taskId: "task-1", userId: "user-1", title: "backup", description: "daily backup" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.TASK_UPDATED,
+                    source: TOPO_SOURCE_TASKS,
+                    message: "Task updated: backup",
+                    details: "details",
+                    data: {
+                        taskId: "task-1",
+                        userId: "user-1",
+                        title: "backup",
+                        description: "daily backup",
+                        changes: ["title", "description"]
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.TASK_DELETED,
+                    source: TOPO_SOURCE_TASKS,
+                    message: "Task deleted: backup",
+                    details: "details",
+                    data: { taskId: "task-1", userId: "user-1", title: "backup" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CRON_ADDED,
+                    source: TOPO_SOURCE_CRONS,
+                    message: "Cron added: backup",
+                    details: "details",
+                    data: {
+                        cronId: "cron-1",
+                        taskId: "task-1",
+                        userId: "user-1",
+                        schedule: "0 * * * *",
+                        timezone: "UTC"
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CRON_DELETED,
+                    source: TOPO_SOURCE_CRONS,
+                    message: "Cron deleted: backup",
+                    details: "details",
+                    data: { cronId: "cron-1", taskId: "task-1", userId: "user-1" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CRON_ENABLED,
+                    source: TOPO_SOURCE_CRONS,
+                    message: "Cron enabled: backup",
+                    details: "details",
+                    data: { cronId: "cron-1", taskId: "task-1", userId: "user-1" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CRON_DISABLED,
+                    source: TOPO_SOURCE_CRONS,
+                    message: "Cron disabled: backup",
+                    details: "details",
+                    data: { cronId: "cron-1", taskId: "task-1", userId: "user-1" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.WEBHOOK_ADDED,
+                    source: TOPO_SOURCE_WEBHOOKS,
+                    message: "Webhook added: backup",
+                    details: "details",
+                    data: {
+                        webhookId: "wh-1",
+                        taskId: "task-1",
+                        userId: "user-1",
+                        routeTemplate: "/v1/webhooks/:token"
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.WEBHOOK_DELETED,
+                    source: TOPO_SOURCE_WEBHOOKS,
+                    message: "Webhook deleted: backup",
+                    details: "details",
+                    data: { webhookId: "wh-1", taskId: "task-1", userId: "user-1" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.SIGNAL_SUBSCRIBED,
+                    source: TOPO_SOURCE_SIGNALS,
+                    message: "Signal subscribed: build:*",
+                    details: "details",
+                    data: { agentId: "agent-1", userId: "user-1", pattern: "build:*", silent: true },
+                    scopeIds: ["user-1", "agent-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.SIGNAL_UNSUBSCRIBED,
+                    source: TOPO_SOURCE_SIGNALS,
+                    message: "Signal unsubscribed: build:*",
+                    details: "details",
+                    data: { agentId: "agent-1", userId: "user-1", pattern: "build:*" },
+                    scopeIds: ["user-1", "agent-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CHANNEL_CREATED,
+                    source: TOPO_SOURCE_CHANNELS,
+                    message: "Channel created: dev",
+                    details: "details",
+                    data: { channelId: "channel-1", userId: "user-1", name: "dev", leader: "leader-agent" },
+                    scopeIds: ["user-1", "channel-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CHANNEL_DELETED,
+                    source: TOPO_SOURCE_CHANNELS,
+                    message: "Channel deleted: dev",
+                    details: "details",
+                    data: { channelId: "channel-1", userId: "user-1", name: "dev", memberCount: 2 },
+                    scopeIds: ["user-1", "channel-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CHANNEL_MEMBER_JOINED,
+                    source: TOPO_SOURCE_CHANNELS,
+                    message: "Channel member joined: alice -> dev",
+                    details: "details",
+                    data: {
+                        channelId: "channel-1",
+                        userId: "user-1",
+                        name: "dev",
+                        agentId: "agent-1",
+                        username: "alice"
+                    },
+                    scopeIds: ["user-1", "channel-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.CHANNEL_MEMBER_LEFT,
+                    source: TOPO_SOURCE_CHANNELS,
+                    message: "Channel member left: alice -> dev",
+                    details: "details",
+                    data: {
+                        channelId: "channel-1",
+                        userId: "user-1",
+                        name: "dev",
+                        agentId: "agent-1",
+                        username: "alice"
+                    },
+                    scopeIds: ["user-1", "channel-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.EXPOSE_CREATED,
+                    source: TOPO_SOURCE_EXPOSES,
+                    message: "Expose created: app.example.com",
+                    details: "details",
+                    data: {
+                        exposeId: "expose-1",
+                        userId: "user-1",
+                        domain: "app.example.com",
+                        target: "port:3000",
+                        provider: "provider-a",
+                        mode: "public",
+                        authenticated: true
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.EXPOSE_REMOVED,
+                    source: TOPO_SOURCE_EXPOSES,
+                    message: "Expose removed: app.example.com",
+                    details: "details",
+                    data: { exposeId: "expose-1", userId: "user-1", domain: "app.example.com" },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.EXPOSE_UPDATED,
+                    source: TOPO_SOURCE_EXPOSES,
+                    message: "Expose updated: app.example.com",
+                    details: "details",
+                    data: {
+                        exposeId: "expose-1",
+                        userId: "user-1",
+                        domain: "app.example.com",
+                        target: "port:3000",
+                        provider: "provider-a",
+                        mode: "public",
+                        authenticated: false
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.SECRET_ADDED,
+                    source: TOPO_SOURCE_SECRETS,
+                    message: "Secret added: OpenAI Key",
+                    details: "details",
+                    data: {
+                        userId: "user-1",
+                        name: "openai-key",
+                        displayName: "OpenAI Key",
+                        variableNames: ["OPENAI_API_KEY"]
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.SECRET_REMOVED,
+                    source: TOPO_SOURCE_SECRETS,
+                    message: "Secret removed: OpenAI Key",
+                    details: "details",
+                    data: {
+                        userId: "user-1",
+                        name: "openai-key",
+                        displayName: "OpenAI Key"
+                    },
+                    scopeIds: ["user-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.SUBUSER_CREATED,
+                    source: TOPO_SOURCE_SUBUSERS,
+                    message: "Subuser created: helper",
+                    details: "details",
+                    data: {
+                        subuserId: "subuser-1",
+                        ownerUserId: "owner-1",
+                        name: "helper",
+                        nametag: "swift-owl-11",
+                        gatewayAgentId: "agent-9"
+                    },
+                    scopeIds: ["owner-1", "subuser-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.SUBUSER_CONFIGURED,
+                    source: TOPO_SOURCE_SUBUSERS,
+                    message: "Subuser configured: helper",
+                    details: "details",
+                    data: {
+                        subuserId: "subuser-1",
+                        ownerUserId: "owner-1",
+                        name: "helper",
+                        gatewayAgentId: "agent-9"
+                    },
+                    scopeIds: ["owner-1", "subuser-1"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.FRIEND_REQUESTED,
+                    source: TOPO_SOURCE_FRIENDS,
+                    message: "Friend request sent to swift-fox-42",
+                    details: "details",
+                    data: { fromUserId: "user-1", toUserId: "user-2", toNametag: "swift-fox-42" },
+                    scopeIds: ["user-1", "user-2"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.FRIEND_ACCEPTED,
+                    source: TOPO_SOURCE_FRIENDS,
+                    message: "Friend accepted: swift-fox-42",
+                    details: "details",
+                    data: { userAId: "user-1", userBId: "user-2", nametag: "swift-fox-42" },
+                    scopeIds: ["user-1", "user-2"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.FRIEND_REMOVED,
+                    source: TOPO_SOURCE_FRIENDS,
+                    message: "Friend removed: swift-fox-42",
+                    details: "details",
+                    data: { userAId: "user-1", userBId: "user-2", nametag: "swift-fox-42" },
+                    scopeIds: ["user-1", "user-2"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.FRIEND_SUBUSER_SHARED,
+                    source: TOPO_SOURCE_FRIENDS,
+                    message: "Subuser shared: helper -> swift-fox-42",
+                    details: "details",
+                    data: {
+                        subuserId: "subuser-1",
+                        subuserName: "helper",
+                        ownerUserId: "user-1",
+                        friendUserId: "user-2",
+                        friendNametag: "swift-fox-42"
+                    },
+                    scopeIds: ["user-1", "user-2"]
+                }),
+                topographyEmitCase({
+                    type: TOPO_EVENT_TYPES.FRIEND_SUBUSER_UNSHARED,
+                    source: TOPO_SOURCE_FRIENDS,
+                    message: "Subuser unshared: helper -> swift-fox-42",
+                    details: "details",
+                    data: {
+                        subuserId: "subuser-1",
+                        subuserName: "helper",
+                        ownerUserId: "user-1",
+                        friendUserId: "user-2",
+                        friendNametag: "swift-fox-42"
+                    },
+                    scopeIds: ["user-1", "user-2"]
+                })
+            ];
+            for (const event of cases) {
+                await topographyObservationEmit(storage.observationLog, {
+                    userId: "user-1",
+                    type: event.type,
+                    source: event.source,
+                    message: event.message,
+                    details: event.details,
+                    data: event.data,
+                    scopeIds: event.scopeIds
+                });
+            }
+            const observations = await storage.observationLog.findMany({ userId: "user-1", agentId: "agent-1" });
+            expect(observations).toHaveLength(cases.length);
+            for (const event of cases) {
+                const found = observations.find((entry) => entry.type === event.type);
+                expect(found).toBeDefined();
+                expect(found?.source).toBe(event.source);
+                expect(found?.message).toBe(event.message);
+                expect(found?.details).toBe(event.details);
+                expect(found?.data).toEqual(event.data);
+                expect(found?.scopeIds).toEqual(event.scopeIds);
+            }
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+});
+//# sourceMappingURL=topographyEvents.spec.js.map

package/dist/engine/observations/topographyEvents.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topographyEvents.spec.js","sourceRoot":"","sources":["../../../sources/engine/observations/topographyEvents.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/people/peopleDocumentFrontmatterAssert.d.ts

@@ -0,0 +1,21 @@
+import type { Context } from "@/types";
+type PeopleDocumentFrontmatterAssertOptions = {
+    ctx: Context;
+    documents: {
+        findById: (ctx: Context, id: string) => Promise<{
+            id: string;
+            slug: string;
+            version?: number | null;
+        } | null>;
+        findParentId: (ctx: Context, id: string) => Promise<string | null>;
+    };
+    parentId: string | null;
+    body: string;
+};
+/**
+ * Validates YAML frontmatter for writes inside the `~/people` tree.
+ * Expects: slug/body represent the next persisted state for the target document.
+ */
+export declare function peopleDocumentFrontmatterAssert(options: PeopleDocumentFrontmatterAssertOptions): Promise<void>;
+export {};
+//# sourceMappingURL=peopleDocumentFrontmatterAssert.d.ts.map

package/dist/engine/people/peopleDocumentFrontmatterAssert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleDocumentFrontmatterAssert.d.ts","sourceRoot":"","sources":["../../../sources/engine/people/peopleDocumentFrontmatterAssert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAKvC,KAAK,sCAAsC,GAAG;IAC1C,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE;QACP,QAAQ,EAAE,CACN,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,MAAM,KACT,OAAO,CAAC;YACT,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAC3B,GAAG,IAAI,CAAC,CAAC;QACV,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;KACtE,CAAC;IACF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,OAAO,EAAE,sCAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpH"}

package/dist/engine/people/peopleDocumentFrontmatterAssert.js

@@ -0,0 +1,44 @@
+import matter from "gray-matter";
+import { documentChainResolve } from "../../storage/documentChainResolve.js";
+const PEOPLE_ROOT_SLUG = "people";
+/**
+ * Validates YAML frontmatter for writes inside the `~/people` tree.
+ * Expects: slug/body represent the next persisted state for the target document.
+ */
+export async function peopleDocumentFrontmatterAssert(options) {
+    if (!(await peopleDocumentInTreeIs(options.ctx, options.documents, options.parentId))) {
+        return;
+    }
+    const parsed = matter(options.body);
+    const firstName = frontmatterTextResolve(parsed.data, "firstName");
+    if (!firstName) {
+        throw new Error("People documents require YAML frontmatter with a non-empty `firstName` field.");
+    }
+    if ("lastName" in parsed.data) {
+        const lastName = frontmatterTextResolve(parsed.data, "lastName");
+        if (!lastName) {
+            throw new Error("People document `lastName` frontmatter must be a non-empty string when provided.");
+        }
+    }
+}
+async function peopleDocumentInTreeIs(ctx, documents, parentId) {
+    if (parentId === null) {
+        return false;
+    }
+    const chain = await documentChainResolve(ctx, parentId, documents);
+    if (!chain || chain.length === 0) {
+        return false;
+    }
+    return chain[0]?.slug === PEOPLE_ROOT_SLUG;
+}
+function frontmatterTextResolve(data, field) {
+    if (!data || typeof data !== "object") {
+        return "";
+    }
+    const value = data[field];
+    if (typeof value !== "string") {
+        return "";
+    }
+    return value.trim();
+}
+//# sourceMappingURL=peopleDocumentFrontmatterAssert.js.map

package/dist/engine/people/peopleDocumentFrontmatterAssert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleDocumentFrontmatterAssert.js","sourceRoot":"","sources":["../../../sources/engine/people/peopleDocumentFrontmatterAssert.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAmBlC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAA+C;IACjG,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACpF,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnE,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACrG,CAAC;IAED,IAAI,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACxG,CAAC;IACL,CAAC;AACL,CAAC;AAED,KAAK,UAAU,sBAAsB,CACjC,GAAY,EACZ,SAA8D,EAC9D,QAAuB;IAEvB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,gBAAgB,CAAC;AAC/C,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAa,EAAE,KAAa;IACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAI,IAAgC,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/engine/people/peopleDocumentFrontmatterAssert.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=peopleDocumentFrontmatterAssert.spec.d.ts.map

package/dist/engine/people/peopleDocumentFrontmatterAssert.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleDocumentFrontmatterAssert.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/people/peopleDocumentFrontmatterAssert.spec.ts"],"names":[],"mappings":""}

package/dist/engine/people/peopleDocumentFrontmatterAssert.spec.js

@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+import { storageOpenTest } from "../../storage/storageOpenTest.js";
+import { contextForUser } from "../agents/context.js";
+import { peopleDocumentFrontmatterAssert } from "./peopleDocumentFrontmatterAssert.js";
+describe("peopleDocumentFrontmatterAssert", () => {
+    it("skips non-people documents", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const ctx = contextForUser({ userId: "user-1" });
+            await expect(peopleDocumentFrontmatterAssert({
+                ctx,
+                documents: storage.documents,
+                parentId: null,
+                body: "no frontmatter needed"
+            })).resolves.toBeUndefined();
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("requires firstName frontmatter for documents inside ~/people", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const ctx = contextForUser({ userId: "user-1" });
+            await storage.documents.create(ctx, {
+                id: "people",
+                slug: "people",
+                title: "People",
+                description: "People root",
+                body: "root",
+                createdAt: 1,
+                updatedAt: 1
+            });
+            await expect(peopleDocumentFrontmatterAssert({
+                ctx,
+                documents: storage.documents,
+                parentId: "people",
+                body: "# Ada"
+            })).rejects.toThrow("firstName");
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("accepts valid people frontmatter and optional lastName", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const ctx = contextForUser({ userId: "user-1" });
+            await storage.documents.create(ctx, {
+                id: "people",
+                slug: "people",
+                title: "People",
+                description: "People root",
+                body: "root",
+                createdAt: 1,
+                updatedAt: 1
+            });
+            await expect(peopleDocumentFrontmatterAssert({
+                ctx,
+                documents: storage.documents,
+                parentId: "people",
+                body: "---\nfirstName: Ada\n---\nEngineer."
+            })).resolves.toBeUndefined();
+            await expect(peopleDocumentFrontmatterAssert({
+                ctx,
+                documents: storage.documents,
+                parentId: "people",
+                body: "---\nfirstName: Grace\nlastName: Hopper\n---\nComputer scientist."
+            })).resolves.toBeUndefined();
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("rejects empty lastName when provided", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const ctx = contextForUser({ userId: "user-1" });
+            await storage.documents.create(ctx, {
+                id: "people",
+                slug: "people",
+                title: "People",
+                description: "People root",
+                body: "root",
+                createdAt: 1,
+                updatedAt: 1
+            });
+            await expect(peopleDocumentFrontmatterAssert({
+                ctx,
+                documents: storage.documents,
+                parentId: "people",
+                body: '---\nfirstName: Ada\nlastName: ""\n---\nEngineer.'
+            })).rejects.toThrow("lastName");
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+    it("does not require person frontmatter for the ~/people root document", async () => {
+        const storage = await storageOpenTest();
+        try {
+            const ctx = contextForUser({ userId: "user-1" });
+            await expect(peopleDocumentFrontmatterAssert({
+                ctx,
+                documents: storage.documents,
+                parentId: null,
+                body: "root instructions"
+            })).resolves.toBeUndefined();
+        }
+        finally {
+            storage.connection.close();
+        }
+    });
+});
+//# sourceMappingURL=peopleDocumentFrontmatterAssert.spec.js.map

package/dist/engine/people/peopleDocumentFrontmatterAssert.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleDocumentFrontmatterAssert.spec.js","sourceRoot":"","sources":["../../../sources/engine/people/peopleDocumentFrontmatterAssert.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/people/peopleRootDocumentEnsure.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "@/types";
+import type { Storage } from "../../storage/storage.js";
+/**
+ * Ensures the root `~/people` document exists for the provided user context.
+ * Expects: storage migrations are applied and ctx.userId is valid.
+ */
+export declare function peopleRootDocumentEnsure(ctx: Context, storage: Storage): Promise<{
+    id: string;
+    created: boolean;
+}>;
+//# sourceMappingURL=peopleRootDocumentEnsure.d.ts.map

package/dist/engine/people/peopleRootDocumentEnsure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peopleRootDocumentEnsure.d.ts","sourceRoot":"","sources":["../../../sources/engine/people/peopleRootDocumentEnsure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAKxD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,OAAO,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA+B3C"}

package/dist/engine/people/peopleRootDocumentEnsure.js

@@ -0,0 +1,40 @@
+import { createId } from "@paralleldrive/cuid2";
+import { agentPromptBundledRead } from "../agents/ops/agentPromptBundledRead.js";
+const PEOPLE_ROOT_SLUG = "people";
+/**
+ * Ensures the root `~/people` document exists for the provided user context.
+ * Expects: storage migrations are applied and ctx.userId is valid.
+ */
+export async function peopleRootDocumentEnsure(ctx, storage) {
+    const existing = await storage.documents.findBySlugAndParent(ctx, PEOPLE_ROOT_SLUG, null);
+    if (existing) {
+        return { id: existing.id, created: false };
+    }
+    const now = Date.now();
+    const body = await agentPromptBundledRead("people/PEOPLE_ROOT.md");
+    try {
+        const created = await storage.documents.create(ctx, {
+            id: createId(),
+            slug: PEOPLE_ROOT_SLUG,
+            title: "People",
+            description: "Structured people profiles with YAML frontmatter.",
+            body,
+            createdAt: now,
+            updatedAt: now,
+            parentId: null
+        });
+        return { id: created.id, created: true };
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        if (!detail.includes("slug is already used")) {
+            throw error;
+        }
+        const raced = await storage.documents.findBySlugAndParent(ctx, PEOPLE_ROOT_SLUG, null);
+        if (!raced) {
+            throw error;
+        }
+        return { id: raced.id, created: false };
+    }
+}
+//# sourceMappingURL=peopleRootDocumentEnsure.js.map