@bosun-sh/logbook 1.1.0 → 2.0.1

package/dist/context/delete.js.map

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

package/dist/context/get.d.ts

@@ -0,0 +1,20 @@
+import type { ToolResult } from "../shared/result.js";
+import { Effect } from "effect";
+import { type ContextEntry } from "./schema.js";
+type ContextRepositoryShape = {
+    create(entry: ContextEntry): Effect.Effect<ContextEntry, unknown>;
+    get(id: string): Effect.Effect<ContextEntry, unknown>;
+    list(): Effect.Effect<readonly ContextEntry[], unknown>;
+    listAll?(): Effect.Effect<readonly ContextEntry[], unknown>;
+    update(entry: ContextEntry): Effect.Effect<ContextEntry, unknown>;
+    tombstone(id: string): Effect.Effect<ContextEntry, unknown>;
+};
+export type GetContextEntryInput = {
+    readonly id: string;
+};
+type GetContextEntryResult = {
+    readonly contextEntry: ContextEntry;
+};
+export declare const getContextEntry: (input: GetContextEntryInput) => Effect.Effect<ToolResult<GetContextEntryResult>, never, ContextRepositoryShape>;
+export {};
+//# sourceMappingURL=get.d.ts.map

package/dist/context/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/context/get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAA;AAEnE,KAAK,sBAAsB,GAAG;IAC5B,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACrD,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;CAC5D,CAAA;AAID,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;CACpC,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,OAAO,oBAAoB,KAC1B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAmB7E,CAAA"}

package/dist/context/get.js

@@ -0,0 +1,55 @@
+import { Context, Effect } from "effect";
+import { ContextEntrySchema } from "./schema.js";
+const ContextRepository = Context.GenericTag("ContextRepository");
+export const getContextEntry = (input) => Effect.gen(function* () {
+    const repo = (yield* ContextRepository);
+    const entry = yield* Effect.either(repo.get(input.id));
+    if (entry._tag === "Left") {
+        return repositoryError(entry.left);
+    }
+    const parsed = ContextEntrySchema.safeParse(entry.right);
+    if (!parsed.success) {
+        return validationErrorFromIssues(parsed.error.issues.map((issue) => issue.message));
+    }
+    return {
+        ok: true,
+        data: {
+            contextEntry: parsed.data,
+        },
+    };
+});
+const validationErrorFromIssues = (issues) => ({
+    ok: false,
+    error: {
+        code: "validation_error",
+        message: issues[0] ?? "validation failed",
+        details: {
+            issues,
+        },
+    },
+});
+const repositoryError = (cause) => {
+    if (typeof cause === "object" && cause !== null && "_tag" in cause) {
+        const tagged = cause;
+        const details = Object.fromEntries(Object.entries(tagged).filter(([key]) => key !== "_tag" && key !== "message"));
+        const id = typeof tagged.id === "string" ? tagged.id : undefined;
+        return {
+            ok: false,
+            error: {
+                code: String(tagged._tag),
+                message: typeof tagged.message === "string" ? tagged.message : "repository operation failed",
+                ...(id === undefined || Object.hasOwn(details, "id")
+                    ? { details }
+                    : { details: { ...details, id } }),
+            },
+        };
+    }
+    return {
+        ok: false,
+        error: {
+            code: "storage_error",
+            message: "repository operation failed",
+        },
+    };
+};
+//# sourceMappingURL=get.js.map

package/dist/context/get.js.map

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

package/dist/context/list.d.ts

@@ -0,0 +1,30 @@
+import { type PageCursor as EncodedPageCursor } from "../shared/pagination.js";
+import type { ToolResult } from "../shared/result.js";
+import { Effect } from "effect";
+import { type ContextEntry } from "./schema.js";
+type ContextRepositoryShape = {
+    create(entry: ContextEntry): Effect.Effect<ContextEntry, unknown>;
+    get(id: string): Effect.Effect<ContextEntry, unknown>;
+    list(): Effect.Effect<readonly ContextEntry[], unknown>;
+    listAll?(): Effect.Effect<readonly ContextEntry[], unknown>;
+    update(entry: ContextEntry): Effect.Effect<ContextEntry, unknown>;
+    tombstone(id: string): Effect.Effect<ContextEntry, unknown>;
+};
+export type ListContextEntriesInput = {
+    readonly topic?: string | undefined;
+    readonly attachedTo?: {
+        readonly type: "epic" | "story" | "task" | "topic";
+        readonly id: string;
+    } | undefined;
+    readonly includeDeleted?: boolean | undefined;
+    readonly limit?: number | undefined;
+    readonly cursor?: EncodedPageCursor | undefined;
+};
+type ListContextEntriesResult = {
+    readonly items: readonly ContextEntry[];
+    readonly hasMore: boolean;
+    readonly nextCursor?: EncodedPageCursor | undefined;
+};
+export declare const listContextEntries: (input: ListContextEntriesInput) => Effect.Effect<ToolResult<ListContextEntriesResult>, never, ContextRepositoryShape>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/context/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/context/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAAc,MAAM,+BAA+B,CAAA;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAA;AAGnE,KAAK,sBAAsB,GAAG;IAC5B,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACrD,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;CAC5D,CAAA;AAID,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,UAAU,CAAC,EAChB;QACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;QAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KACpB,GACD,SAAS,CAAA;IACb,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAChD,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CACpD,CAAA;AAID,eAAO,MAAM,kBAAkB,GAC7B,OAAO,uBAAuB,KAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAmFhF,CAAA"}

package/dist/context/list.js

@@ -0,0 +1,172 @@
+import { PageCursor } from "../shared/pagination.js";
+import { Context, Effect } from "effect";
+import { ContextEntrySchema } from "./schema.js";
+import { normalizeTopic } from "./topics.js";
+const ContextRepository = Context.GenericTag("ContextRepository");
+const DEFAULT_LIMIT = 200;
+export const listContextEntries = (input) => Effect.gen(function* () {
+    const normalizedTopic = input.topic === undefined ? undefined : normalizeTopic(input.topic);
+    if (normalizedTopic !== undefined && !normalizedTopic.ok) {
+        return normalizedTopic;
+    }
+    if (input.attachedTo !== undefined && input.attachedTo.id.trim().length === 0) {
+        return validationError("attachedTo.id must not be empty", { field: "attachedTo.id" });
+    }
+    const topicFilter = normalizedTopic === undefined || !normalizedTopic.ok ? undefined : normalizedTopic.data;
+    const repo = (yield* ContextRepository);
+    const entries = input.includeDeleted === true ? yield* loadAllEntries(repo) : yield* loadActiveEntries(repo);
+    if (!entries.ok) {
+        return entries;
+    }
+    const filtered = entries.data
+        .map((entry) => ContextEntrySchema.safeParse(entry))
+        .filter((parsed) => parsed.success)
+        .map((parsed) => parsed.data)
+        .filter((entry) => matchesFilters(entry, input, topicFilter))
+        .sort(compareContextEntriesForList);
+    const afterCursor = sliceAfterCursor(filtered, input.cursor);
+    if (!afterCursor.ok) {
+        return afterCursor;
+    }
+    const limit = normalizeListLimit(input.limit);
+    const items = afterCursor.data.slice(0, limit);
+    const hasMore = afterCursor.data.length > items.length;
+    if (!hasMore) {
+        return {
+            ok: true,
+            data: {
+                items,
+                hasMore: false,
+            },
+        };
+    }
+    const last = items[items.length - 1];
+    if (last === undefined) {
+        return {
+            ok: true,
+            data: {
+                items,
+                hasMore: false,
+            },
+        };
+    }
+    const nextCursor = PageCursor.encode({
+        kind: "context.list",
+        lastId: last.id,
+        lastSort: [last.updatedAt, last.id],
+    });
+    if (!nextCursor.ok) {
+        return nextCursor;
+    }
+    return {
+        ok: true,
+        data: {
+            items,
+            hasMore: true,
+            nextCursor: nextCursor.data,
+        },
+        warnings: [
+            {
+                code: "has_more",
+                message: "Additional records are available through a cursor",
+                details: {
+                    cursor: nextCursor.data,
+                },
+            },
+        ],
+    };
+});
+const loadActiveEntries = (repo) => Effect.map(Effect.either(repo.list()), (result) => result._tag === "Left" ? repositoryError(result.left) : { ok: true, data: result.right });
+const loadAllEntries = (repo) => {
+    if (repo.listAll !== undefined) {
+        return Effect.map(Effect.either(repo.listAll()), (result) => result._tag === "Left" ? repositoryError(result.left) : { ok: true, data: result.right });
+    }
+    return Effect.succeed({
+        ok: false,
+        error: {
+            code: "validation_error",
+            message: "includeDeleted requires repository listAll support",
+            details: {
+                field: "includeDeleted",
+                supported: false,
+            },
+        },
+    });
+};
+const sliceAfterCursor = (entries, cursor) => {
+    if (cursor === undefined) {
+        return { ok: true, data: entries };
+    }
+    const decoded = PageCursor.decode(cursor, {
+        kind: "context.list",
+        sortShape: ["string", "string"],
+    });
+    if (!decoded.ok) {
+        return decoded;
+    }
+    const [updatedAt, id] = decoded.data.lastSort;
+    return {
+        ok: true,
+        data: entries.filter((entry) => compareEntryToCursor(entry, updatedAt, id) > 0),
+    };
+};
+const compareContextEntriesForList = (left, right) => {
+    if (left.updatedAt !== right.updatedAt) {
+        return right.updatedAt.localeCompare(left.updatedAt);
+    }
+    return left.id.localeCompare(right.id);
+};
+const compareEntryToCursor = (entry, updatedAt, id) => {
+    if (entry.updatedAt !== updatedAt) {
+        return updatedAt.localeCompare(entry.updatedAt);
+    }
+    return entry.id.localeCompare(id);
+};
+const matchesFilters = (entry, input, topic) => {
+    const topicMatch = topic === undefined || entry.topics.includes(topic);
+    const attachmentMatch = input.attachedTo === undefined ||
+        entry.attachedTo.some((attachment) => attachment.kind === input.attachedTo?.type && attachment.id === input.attachedTo.id);
+    return topicMatch && attachmentMatch;
+};
+const normalizeListLimit = (limit) => {
+    if (limit === undefined) {
+        return DEFAULT_LIMIT;
+    }
+    if (!Number.isInteger(limit) || limit <= 0) {
+        return DEFAULT_LIMIT;
+    }
+    return Math.min(limit, DEFAULT_LIMIT);
+};
+const validationError = (message, details) => ({
+    ok: false,
+    error: {
+        code: "validation_error",
+        message,
+        ...(details === undefined ? {} : { details }),
+    },
+});
+const repositoryError = (cause) => {
+    if (typeof cause === "object" && cause !== null && "_tag" in cause) {
+        const tagged = cause;
+        const details = Object.fromEntries(Object.entries(tagged).filter(([key]) => key !== "_tag" && key !== "message"));
+        const id = typeof tagged.id === "string" ? tagged.id : undefined;
+        return {
+            ok: false,
+            error: {
+                code: String(tagged._tag),
+                message: typeof tagged.message === "string" ? tagged.message : "repository operation failed",
+                ...(id === undefined || Object.hasOwn(details, "id")
+                    ? { details }
+                    : { details: { ...details, id } }),
+            },
+        };
+    }
+    return {
+        ok: false,
+        error: {
+            code: "storage_error",
+            message: "repository operation failed",
+        },
+    };
+};
+//# sourceMappingURL=list.js.map

package/dist/context/list.js.map

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

package/dist/context/schema.d.ts

@@ -0,0 +1,156 @@
+import { z } from "zod";
+export declare const ContextEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    schemaVersion: z.ZodLiteral<"2">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deletedAt: z.ZodOptional<z.ZodString>;
+} & {
+    kind: z.ZodLiteral<"context_entry">;
+    title: z.ZodEffects<z.ZodString, string, string>;
+    body: z.ZodString;
+    topics: z.ZodArray<z.ZodString, "many">;
+    source: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["manual", "file", "url", "sync", "task_comment"]>;
+        uri: z.ZodOptional<z.ZodString>;
+        recordId: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "sync" | "manual" | "file" | "url" | "task_comment";
+        uri?: string | undefined;
+        recordId?: string | undefined;
+    }, {
+        type: "sync" | "manual" | "file" | "url" | "task_comment";
+        uri?: string | undefined;
+        recordId?: string | undefined;
+    }>>;
+    attachedTo: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<["epic", "story", "task", "topic"]>;
+        id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: "epic" | "story" | "task" | "topic";
+    }, {
+        id: string;
+        kind: "epic" | "story" | "task" | "topic";
+    }>, "many">;
+    relevanceHints: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    schemaVersion: "2";
+    kind: "context_entry";
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    body: string;
+    topics: string[];
+    attachedTo: {
+        id: string;
+        kind: "epic" | "story" | "task" | "topic";
+    }[];
+    relevanceHints: string[];
+    deletedAt?: string | undefined;
+    source?: {
+        type: "sync" | "manual" | "file" | "url" | "task_comment";
+        uri?: string | undefined;
+        recordId?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    schemaVersion: "2";
+    kind: "context_entry";
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    body: string;
+    topics: string[];
+    attachedTo: {
+        id: string;
+        kind: "epic" | "story" | "task" | "topic";
+    }[];
+    relevanceHints: string[];
+    deletedAt?: string | undefined;
+    source?: {
+        type: "sync" | "manual" | "file" | "url" | "task_comment";
+        uri?: string | undefined;
+        recordId?: string | undefined;
+    } | undefined;
+}>;
+export type ContextEntry = z.infer<typeof ContextEntrySchema>;
+export declare const ExternalLinkSchema: z.ZodObject<{
+    id: z.ZodString;
+    schemaVersion: z.ZodLiteral<"2">;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    deletedAt: z.ZodOptional<z.ZodString>;
+} & {
+    kind: z.ZodLiteral<"external_link">;
+    provider: z.ZodString;
+    localRecord: z.ZodObject<{
+        kind: z.ZodEnum<["epic", "story", "task", "context_entry"]>;
+        id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        kind: "epic" | "story" | "task" | "context_entry";
+    }, {
+        id: string;
+        kind: "epic" | "story" | "task" | "context_entry";
+    }>;
+    remoteRecord: z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<["issue", "comment", "project", "milestone", "label", "cycle"]>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        type: "project" | "milestone" | "issue" | "comment" | "label" | "cycle";
+        url?: string | undefined;
+    }, {
+        id: string;
+        type: "project" | "milestone" | "issue" | "comment" | "label" | "cycle";
+        url?: string | undefined;
+    }>;
+    lastSyncedAt: z.ZodOptional<z.ZodString>;
+    lastSeenRemoteVersion: z.ZodOptional<z.ZodString>;
+    lastPushedLocalVersion: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    schemaVersion: "2";
+    provider: string;
+    kind: "external_link";
+    createdAt: string;
+    updatedAt: string;
+    localRecord: {
+        id: string;
+        kind: "epic" | "story" | "task" | "context_entry";
+    };
+    remoteRecord: {
+        id: string;
+        type: "project" | "milestone" | "issue" | "comment" | "label" | "cycle";
+        url?: string | undefined;
+    };
+    deletedAt?: string | undefined;
+    lastSyncedAt?: string | undefined;
+    lastSeenRemoteVersion?: string | undefined;
+    lastPushedLocalVersion?: string | undefined;
+}, {
+    id: string;
+    schemaVersion: "2";
+    provider: string;
+    kind: "external_link";
+    createdAt: string;
+    updatedAt: string;
+    localRecord: {
+        id: string;
+        kind: "epic" | "story" | "task" | "context_entry";
+    };
+    remoteRecord: {
+        id: string;
+        type: "project" | "milestone" | "issue" | "comment" | "label" | "cycle";
+        url?: string | undefined;
+    };
+    deletedAt?: string | undefined;
+    lastSyncedAt?: string | undefined;
+    lastSeenRemoteVersion?: string | undefined;
+    lastPushedLocalVersion?: string | undefined;
+}>;
+export type ExternalLink = z.infer<typeof ExternalLinkSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/context/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/context/schema.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAepB,CAAA;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcpB,CAAA;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/context/schema.js

@@ -0,0 +1,34 @@
+import { ContextAttachmentSchema, EntityMetaSchema, IsoDateTimeSchema, LocalRecordRefSchema, TitleSchema, } from "../shared/schema/value-objects.js";
+import { z } from "zod";
+export const ContextEntrySchema = EntityMetaSchema.extend({
+    kind: z.literal("context_entry"),
+    title: TitleSchema,
+    body: z.string(),
+    topics: z.array(z.string()),
+    source: z
+        .object({
+        type: z.enum(["manual", "file", "url", "sync", "task_comment"]),
+        uri: z.string().optional(),
+        recordId: z.string().min(1).optional(),
+    })
+        .strict()
+        .optional(),
+    attachedTo: z.array(ContextAttachmentSchema),
+    relevanceHints: z.array(z.string()),
+}).strict();
+export const ExternalLinkSchema = EntityMetaSchema.extend({
+    kind: z.literal("external_link"),
+    provider: z.string().min(1),
+    localRecord: LocalRecordRefSchema,
+    remoteRecord: z
+        .object({
+        id: z.string().min(1),
+        url: z.string().url().optional(),
+        type: z.enum(["issue", "comment", "project", "milestone", "label", "cycle"]),
+    })
+        .strict(),
+    lastSyncedAt: IsoDateTimeSchema.optional(),
+    lastSeenRemoteVersion: z.string().min(1).optional(),
+    lastPushedLocalVersion: z.string().min(1).optional(),
+}).strict();
+//# sourceMappingURL=schema.js.map

package/dist/context/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/context/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,GACZ,MAAM,yCAAyC,CAAA;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,KAAK,EAAE,WAAW;IAClB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAC/D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KACvC,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAC,MAAM,EAAE,CAAA;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,WAAW,EAAE,oBAAoB;IACjC,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC;QACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACrB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAChC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;KAC7E,CAAC;SACD,MAAM,EAAE;IACX,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnD,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC,MAAM,EAAE,CAAA"}

package/dist/context/search.d.ts

@@ -0,0 +1,27 @@
+import { type PageCursor as EncodedPageCursor } from "../shared/pagination.js";
+import type { ToolResult } from "../shared/result.js";
+import { Effect } from "effect";
+import { type ContextEntry } from "./schema.js";
+type ContextRepositoryShape = {
+    create(entry: ContextEntry): Effect.Effect<ContextEntry, unknown>;
+    get(id: string): Effect.Effect<ContextEntry, unknown>;
+    list(): Effect.Effect<readonly ContextEntry[], unknown>;
+    listAll?(): Effect.Effect<readonly ContextEntry[], unknown>;
+    update(entry: ContextEntry): Effect.Effect<ContextEntry, unknown>;
+    tombstone(id: string): Effect.Effect<ContextEntry, unknown>;
+};
+export type SearchContextEntriesInput = {
+    readonly taskId?: string | undefined;
+    readonly topic?: string | undefined;
+    readonly query?: string | undefined;
+    readonly limit?: number | undefined;
+    readonly cursor?: EncodedPageCursor | undefined;
+};
+type SearchContextEntriesResult = {
+    readonly items: readonly ContextEntry[];
+    readonly hasMore: boolean;
+    readonly nextCursor?: EncodedPageCursor | undefined;
+};
+export declare const searchContextEntries: (input: SearchContextEntriesInput) => Effect.Effect<ToolResult<SearchContextEntriesResult>, never, ContextRepositoryShape>;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/context/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/context/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAAc,MAAM,+BAA+B,CAAA;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAW,MAAM,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAA;AAGnE,KAAK,sBAAsB,GAAG;IAC5B,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACrD,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,CAAA;IACvD,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,YAAY,EAAE,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;CAC5D,CAAA;AAID,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CAChD,CAAA;AAED,KAAK,0BAA0B,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;CACpD,CAAA;AAkBD,eAAO,MAAM,oBAAoB,GAC/B,OAAO,yBAAyB,KAC/B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,KAAK,EAAE,sBAAsB,CAyElF,CAAA"}