@chief-clancy/core 0.1.0

package/dist/board/notion/api/helpers.js

@@ -0,0 +1,175 @@
+/** Notion REST API base URL. */
+export const NOTION_API = 'https://api.notion.com/v1';
+/** Notion API version for all requests. */
+const NOTION_VERSION = '2022-06-28';
+/**
+ * Build standard Notion request headers.
+ *
+ * @param token - The Notion integration token.
+ * @returns Headers object for Notion API requests.
+ */
+export function notionHeaders(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        'Notion-Version': NOTION_VERSION,
+        'Content-Type': 'application/json',
+    };
+}
+// ─── Property extraction ─────────────────────────────────────────────────────
+/**
+ * Extract a single-value property (status, select, title, rich_text).
+ *
+ * @param page - The Notion page object.
+ * @param propName - The property name to look up.
+ * @param propType - The expected property type.
+ * @returns The extracted string value, or `undefined`.
+ */
+export function getStringProperty(page, propName, propType) {
+    const prop = page.properties[propName];
+    if (!prop || prop.type !== propType)
+        return undefined;
+    // Safe casts: type guard on prop.type guarantees the shape
+    switch (propType) {
+        case 'status': {
+            const p = prop;
+            return p.status?.name;
+        }
+        case 'select': {
+            const p = prop;
+            return p.select?.name;
+        }
+        case 'title': {
+            const p = prop;
+            return p.title.map((t) => t.plain_text).join('');
+        }
+        case 'rich_text': {
+            const p = prop;
+            return p.rich_text.map((t) => t.plain_text).join('');
+        }
+    }
+}
+/**
+ * Extract an array-value property (multi_select, relation, people).
+ *
+ * @param page - The Notion page object.
+ * @param propName - The property name to look up.
+ * @param propType - The expected property type.
+ * @returns Array of string values, or `undefined`.
+ */
+export function getArrayProperty(page, propName, propType) {
+    const prop = page.properties[propName];
+    if (!prop || prop.type !== propType)
+        return undefined;
+    // Safe: prop.type === propType narrows the union, but TS can't follow the
+    // dynamic propType parameter — each branch casts to the known shape.
+    switch (propType) {
+        case 'multi_select': {
+            const p = prop;
+            return p.multi_select.map((o) => o.name);
+        }
+        case 'relation': {
+            const p = prop;
+            return p.relation.map((r) => r.id);
+        }
+        case 'people': {
+            const p = prop;
+            return p.people.map((u) => u.id);
+        }
+    }
+}
+// ─── Key helpers ─────────────────────────────────────────────────────────────
+/**
+ * Build a short key from a Notion page UUID.
+ *
+ * @param pageId - The full page UUID.
+ * @returns Short key like `notion-ab12cd34`.
+ */
+export function buildNotionKey(pageId) {
+    const shortId = pageId.replace(/-/g, '').slice(0, 8);
+    return `notion-${shortId}`;
+}
+/**
+ * Extract the short ID from a Notion key.
+ *
+ * @param key - The key (e.g., `'notion-ab12cd34'`).
+ * @returns The 8-char short ID, or `undefined` if invalid.
+ */
+export function parseNotionShortId(key) {
+    const shortId = key.replace('notion-', '');
+    return shortId.length === 8 ? shortId : undefined;
+}
+// ─── Status helpers ──────────────────────────────────────────────────────────
+/** Done-like status names (case-insensitive). */
+const COMPLETE_STATUSES = new Set(['done', 'complete', 'completed', 'closed']);
+/**
+ * Check whether a status name indicates completion.
+ *
+ * @param statusName - The status name to check.
+ * @returns `true` if the status is a done-like state.
+ */
+export function isCompleteStatus(statusName) {
+    return COMPLETE_STATUSES.has(statusName.toLowerCase());
+}
+/**
+ * Extract description text from a page's rich_text properties.
+ *
+ * Tries common property names: Description, description, Body, body.
+ *
+ * @param page - The Notion page object.
+ * @returns The description text, or `undefined`.
+ */
+export function getDescriptionText(page) {
+    const names = ['Description', 'description', 'Body', 'body'];
+    return names
+        .map((name) => getStringProperty(page, name, 'rich_text'))
+        .find(Boolean);
+}
+/**
+ * Extract the title from a page (first title-type property).
+ *
+ * @param page - The Notion page object.
+ * @returns The title text, or empty string.
+ */
+export function getPageTitle(page) {
+    const titleEntry = Object.entries(page.properties).find(([, prop]) => prop.type === 'title');
+    if (!titleEntry)
+        return '';
+    return getStringProperty(page, titleEntry[0], 'title') ?? '';
+}
+/**
+ * Get the status of a page (tries status type, falls back to select).
+ *
+ * @param page - The Notion page object.
+ * @param statusProp - The property name.
+ * @returns The status name, or `undefined`.
+ */
+export function getPageStatus(page, statusProp) {
+    return (getStringProperty(page, statusProp, 'status') ??
+        getStringProperty(page, statusProp, 'select'));
+}
+/**
+ * Check if a page is incomplete (not in a done-like state).
+ *
+ * @param page - The Notion page object.
+ * @param statusProp - The status property name.
+ * @returns `true` if incomplete.
+ */
+export function isPageIncomplete(page, statusProp) {
+    const status = getPageStatus(page, statusProp);
+    return !status || !isCompleteStatus(status);
+}
+/**
+ * Find a property by name with case-insensitive fallback.
+ *
+ * @param page - The Notion page object.
+ * @param name - The property name to search for.
+ * @returns The property value, or `undefined`.
+ */
+export function findPropertyByName(page, name) {
+    if (page.properties[name])
+        return page.properties[name];
+    const lowerName = name.toLowerCase();
+    const match = Object.entries(page.properties).find(([key]) => key.toLowerCase() === lowerName);
+    return match?.[1];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/board/notion/api/helpers.js.map

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

package/dist/board/notion/api/index.d.ts

@@ -0,0 +1,4 @@
+export { fetchPage, findPageByKey, pingNotion, queryAllPages, queryDatabase, updatePage, } from './api.js';
+export { buildNotionKey, findPropertyByName, getArrayProperty, getDescriptionText, getPageStatus, getPageTitle, isCompleteStatus, isPageIncomplete, } from './helpers.js';
+export type { NotionCtx } from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/notion/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/notion/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/board/notion/api/index.js

@@ -0,0 +1,3 @@
+export { fetchPage, findPageByKey, pingNotion, queryAllPages, queryDatabase, updatePage, } from './api.js';
+export { buildNotionKey, findPropertyByName, getArrayProperty, getDescriptionText, getPageStatus, getPageTitle, isCompleteStatus, isPageIncomplete, } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/board/notion/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/notion/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/board/notion/index.d.ts

@@ -0,0 +1,3 @@
+export { createNotionBoard } from './notion-board.js';
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/notion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/board/notion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/board/notion/index.js

@@ -0,0 +1,3 @@
+export { createNotionBoard } from './notion-board.js';
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+//# sourceMappingURL=index.js.map

package/dist/board/notion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/board/notion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/board/notion/labels/index.d.ts

@@ -0,0 +1,2 @@
+export { addLabel, removeLabel } from './labels.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/notion/labels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/notion/labels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/board/notion/labels/index.js

@@ -0,0 +1,2 @@
+export { addLabel, removeLabel } from './labels.js';
+//# sourceMappingURL=index.js.map

package/dist/board/notion/labels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/notion/labels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/board/notion/labels/labels.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Notion page label (multi_select) operations.
+ *
+ * Uses read-modify-write via {@link modifyLabelList}. Labels are stored
+ * as multi_select options which auto-create on first PATCH.
+ */
+import type { NotionCtx } from '../api/index.js';
+/** Options for label operations. */
+type LabelOpts = {
+    readonly ctx: NotionCtx;
+    readonly issueKey: string;
+    readonly label: string;
+    readonly labelsProp: string;
+};
+/**
+ * Add a label to a Notion page (best-effort).
+ *
+ * @param opts - Connection context, issue key, label, and property name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function addLabel(opts: LabelOpts): Promise<void>;
+/**
+ * Remove a label from a Notion page (best-effort).
+ *
+ * @param opts - Connection context, issue key, label, and property name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function removeLabel(opts: LabelOpts): Promise<void>;
+export {};
+//# sourceMappingURL=labels.d.ts.map

package/dist/board/notion/labels/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/board/notion/labels/labels.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,oCAAoC;AACpC,KAAK,SAAS,GAAG;IACf,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAsBF;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7D;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhE"}

package/dist/board/notion/labels/labels.js

@@ -0,0 +1,56 @@
+import { modifyLabelList, safeLabel } from '../../../shared/label-helpers/index.js';
+import { findPageByKey, getArrayProperty, updatePage } from '../api/index.js';
+/** Write updated labels to a page via PATCH. */
+async function writeLabels(opts, labels) {
+    await updatePage({
+        token: opts.ctx.token,
+        pageId: opts.pageId,
+        properties: {
+            [opts.labelsProp]: {
+                multi_select: labels.map((name) => ({ name })),
+            },
+        },
+        fetcher: opts.ctx.fetcher,
+    });
+}
+/**
+ * Add a label to a Notion page (best-effort).
+ *
+ * @param opts - Connection context, issue key, label, and property name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function addLabel(opts) {
+    const { ctx, issueKey, label, labelsProp } = opts;
+    await safeLabel(async () => {
+        const page = await findPageByKey(ctx, issueKey);
+        if (!page)
+            return;
+        await modifyLabelList({
+            fetchCurrent: () => Promise.resolve(getArrayProperty(page, labelsProp, 'multi_select') ?? []),
+            writeUpdated: (labels) => writeLabels({ ctx, pageId: page.id, labelsProp }, labels),
+            target: label,
+            mode: 'add',
+        });
+    }, 'addLabel');
+}
+/**
+ * Remove a label from a Notion page (best-effort).
+ *
+ * @param opts - Connection context, issue key, label, and property name.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function removeLabel(opts) {
+    const { ctx, issueKey, label, labelsProp } = opts;
+    await safeLabel(async () => {
+        const page = await findPageByKey(ctx, issueKey);
+        if (!page)
+            return;
+        await modifyLabelList({
+            fetchCurrent: () => Promise.resolve(getArrayProperty(page, labelsProp, 'multi_select') ?? []),
+            writeUpdated: (labels) => writeLabels({ ctx, pageId: page.id, labelsProp }, labels),
+            target: label,
+            mode: 'remove',
+        });
+    }, 'removeLabel');
+}
+//# sourceMappingURL=labels.js.map

package/dist/board/notion/labels/labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../../src/board/notion/labels/labels.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAU9E,gDAAgD;AAChD,KAAK,UAAU,WAAW,CACxB,IAGC,EACD,MAAyB;IAEzB,MAAM,UAAU,CAAC;QACf,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,UAAU,EAAE;YACV,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;gBACjB,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;aAC/C;SACF;QACD,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAe;IAC5C,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAElD,MAAM,SAAS,CAAC,KAAK,IAAI,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,eAAe,CAAC;YACpB,YAAY,EAAE,GAAG,EAAE,CACjB,OAAO,CAAC,OAAO,CACb,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,CACzD;YACH,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CACvB,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC;YAC3D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAe;IAC/C,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAElD,MAAM,SAAS,CAAC,KAAK,IAAI,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,eAAe,CAAC;YACpB,YAAY,EAAE,GAAG,EAAE,CACjB,OAAO,CAAC,OAAO,CACb,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,CACzD;YACH,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CACvB,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC;YAC3D,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC,EAAE,aAAa,CAAC,CAAC;AACpB,CAAC"}

package/dist/board/notion/notion-board.d.ts

@@ -0,0 +1,12 @@
+import type { NotionEnv } from '../../schemas/index.js';
+import type { Fetcher } from '../../shared/http/index.js';
+import type { Board } from '../../types/index.js';
+/**
+ * Create a Board implementation for Notion.
+ *
+ * @param env - The validated Notion environment variables.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns A Board object that delegates to Notion API functions.
+ */
+export declare function createNotionBoard(env: NotionEnv, fetcher?: Fetcher): Board;
+//# sourceMappingURL=notion-board.d.ts.map

package/dist/board/notion/notion-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion-board.d.ts","sourceRoot":"","sources":["../../../src/board/notion/notion-board.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAkC,MAAM,oBAAoB,CAAC;AAqKhF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAyD1E"}

package/dist/board/notion/notion-board.js

@@ -0,0 +1,156 @@
+import { buildNotionKey, getArrayProperty, getDescriptionText, getPageTitle, pingNotion, queryDatabase, updatePage, } from './api/index.js';
+import { addLabel, removeLabel } from './labels/index.js';
+import { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+/** Default property names for Notion databases. */
+const DEFAULTS = {
+    status: 'Status',
+    labels: 'Labels',
+    parent: 'Epic',
+    todo: 'To-do',
+};
+/** UUID pattern for NOTION_DATABASE_ID validation. */
+const UUID_PATTERN = /^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$/i;
+/** Convert a Notion page to a FetchedTicket. */
+function pageToFetchedTicket(page, props) {
+    const parentRelations = getArrayProperty(page, props.parentProp, 'relation');
+    const hasParent = parentRelations && parentRelations.length > 0;
+    const parentInfo = hasParent ? buildNotionKey(parentRelations[0]) : 'none';
+    return {
+        key: buildNotionKey(page.id),
+        title: getPageTitle(page),
+        description: getDescriptionText(page) ?? '',
+        parentInfo,
+        blockers: 'None',
+        issueId: page.id,
+        labels: getArrayProperty(page, props.labelsProp, 'multi_select') ?? [],
+        status: props.todoName,
+    };
+}
+/** Fetch and normalise Notion pages into FetchedTickets. */
+async function fetchNotionTickets(opts) {
+    const { ctx, fetchOpts, props, defaultLabel } = opts;
+    const filter = {
+        property: props.statusProp,
+        status: { equals: props.todoName },
+    };
+    const result = await queryDatabase({ ctx, filter });
+    if (!result)
+        return [];
+    const hitlFiltered = fetchOpts.excludeHitl
+        ? result.results.filter((page) => {
+            const labels = getArrayProperty(page, props.labelsProp, 'multi_select');
+            return !labels?.includes('clancy:hitl');
+        })
+        : [...result.results];
+    const requiredLabel = fetchOpts.buildLabel ?? defaultLabel;
+    const labelFiltered = requiredLabel
+        ? hitlFiltered.filter((page) => {
+            const labels = getArrayProperty(page, props.labelsProp, 'multi_select');
+            return labels?.includes(requiredLabel);
+        })
+        : hitlFiltered;
+    return labelFiltered
+        .slice(0, 5)
+        .map((page) => pageToFetchedTicket(page, props));
+}
+/** Transition a page's status (tries status type, falls back to select). */
+async function doTransition(opts) {
+    const { token, ticket, status, statusProp, fetcher } = opts;
+    const pageId = ticket.issueId;
+    if (!pageId)
+        return false;
+    const ok = await updatePage({
+        token,
+        pageId,
+        properties: { [statusProp]: { status: { name: status } } },
+        fetcher,
+    });
+    if (ok) {
+        console.log(`  → Transitioned to ${status}`);
+        return true;
+    }
+    const fallbackOk = await updatePage({
+        token,
+        pageId,
+        properties: { [statusProp]: { select: { name: status } } },
+        fetcher,
+    });
+    if (fallbackOk)
+        console.log(`  → Transitioned to ${status}`);
+    return fallbackOk;
+}
+/** Build transition opts from context and props. */
+function buildTransitionOpts(ctx, props) {
+    return {
+        token: ctx.token,
+        statusProp: props.statusProp,
+        fetcher: ctx.fetcher,
+    };
+}
+/** Build connection context from env. */
+function buildCtx(env, fetcher) {
+    return {
+        token: env.NOTION_TOKEN,
+        databaseId: env.NOTION_DATABASE_ID,
+        fetcher,
+    };
+}
+/** Resolve property names from env with defaults. */
+function buildProps(env) {
+    return {
+        statusProp: env.CLANCY_NOTION_STATUS ?? DEFAULTS.status,
+        labelsProp: env.CLANCY_NOTION_LABELS ?? DEFAULTS.labels,
+        parentProp: env.CLANCY_NOTION_PARENT ?? DEFAULTS.parent,
+        todoName: env.CLANCY_NOTION_TODO ?? DEFAULTS.todo,
+    };
+}
+/**
+ * Create a Board implementation for Notion.
+ *
+ * @param env - The validated Notion environment variables.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns A Board object that delegates to Notion API functions.
+ */
+export function createNotionBoard(env, fetcher) {
+    const ctx = buildCtx(env, fetcher);
+    const props = buildProps(env);
+    const transitionOpts = buildTransitionOpts(ctx, props);
+    const doFetch = (fetchOpts) => fetchNotionTickets({
+        ctx,
+        fetchOpts,
+        props,
+        defaultLabel: env.CLANCY_LABEL,
+    });
+    return {
+        ping: () => pingNotion(ctx.token, ctx.fetcher),
+        validateInputs() {
+            if (!UUID_PATTERN.test(env.NOTION_DATABASE_ID)) {
+                return '✗ NOTION_DATABASE_ID does not look like a valid UUID';
+            }
+            return undefined;
+        },
+        fetchTicket: async (opts) => (await doFetch(opts))[0],
+        fetchTickets: doFetch,
+        fetchBlockerStatus: (ticket) => ticket.issueId
+            ? fetchBlockerStatus({
+                ctx,
+                pageId: ticket.issueId,
+                statusProp: props.statusProp,
+            })
+            : Promise.resolve(false),
+        fetchChildrenStatus: (parentKey) => fetchChildrenStatus({
+            ctx,
+            parentKey,
+            parentProp: props.parentProp,
+            statusProp: props.statusProp,
+        }),
+        transitionTicket: (ticket, status) => doTransition({ ...transitionOpts, ticket, status }),
+        ensureLabel: async () => {
+            // No-op — Notion multi_select options auto-create on first PATCH.
+        },
+        addLabel: (issueKey, label) => addLabel({ ctx, issueKey, label, labelsProp: props.labelsProp }),
+        removeLabel: (issueKey, label) => removeLabel({ ctx, issueKey, label, labelsProp: props.labelsProp }),
+        sharedEnv: () => env,
+    };
+}
+//# sourceMappingURL=notion-board.js.map

package/dist/board/notion/notion-board.js.map

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

package/dist/board/notion/relations/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/notion/relations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/notion/relations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/board/notion/relations/index.js

@@ -0,0 +1,2 @@
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations.js';
+//# sourceMappingURL=index.js.map

package/dist/board/notion/relations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/notion/relations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/board/notion/relations/relations.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Notion page relationship functions.
+ *
+ * Checks blocker status (via "Blocked by" relation + description text)
+ * and children status (dual-mode: description text + relation property).
+ */
+import type { NotionCtx } from '../api/index.js';
+import type { ChildrenStatus } from '../../../types/index.js';
+/** Options for {@link fetchBlockerStatus}. */
+type BlockerStatusOpts = {
+    readonly ctx: NotionCtx;
+    readonly pageId: string;
+    readonly statusProp: string;
+};
+/**
+ * Check whether a Notion page is blocked by unresolved blockers.
+ *
+ * Checks "Blocked by" relation property first, then falls back to
+ * description text search for "Blocked by notion-{shortId}" references.
+ *
+ * @param opts - Connection context, page ID, and status property name.
+ * @returns `true` if any blocker is unresolved, `false` otherwise.
+ */
+export declare function fetchBlockerStatus(opts: BlockerStatusOpts): Promise<boolean>;
+/** Options for {@link fetchChildrenStatus}. */
+type ChildrenStatusOpts = {
+    readonly ctx: NotionCtx;
+    readonly parentKey: string;
+    readonly parentProp: string;
+    readonly statusProp: string;
+};
+/**
+ * Fetch the children status of a parent page (dual-mode).
+ *
+ * Mode 1: Search descriptions for `Epic: notion-{shortId}` text.
+ * Mode 2: Query by parent relation property as fallback.
+ *
+ * @param opts - Connection context, parent key, and property names.
+ * @returns The children status, or `undefined` on failure.
+ */
+export declare function fetchChildrenStatus(opts: ChildrenStatusOpts): Promise<ChildrenStatus | undefined>;
+export {};
+//# sourceMappingURL=relations.d.ts.map

package/dist/board/notion/relations/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../../src/board/notion/relations/relations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAsBzD,8CAA8C;AAC9C,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAclB;AAiED,+CAA+C;AAC/C,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAwBrC"}