@duckcodeailabs/dql-core 1.13.1 → 1.13.3

package/dist/apps/app-build-draft.d.ts

@@ -0,0 +1,236 @@
+import type { DashboardDocument, DashboardFilter, DashboardGridItem, DashboardGridLayout } from './dashboard-document.js';
+export type AppBuildAuthoringMode = 'ai' | 'manual';
+export type AppBuildSourcePolicy = 'governed_only' | 'include_review_required';
+export type AppBuildTemplateId = 'executive_brief' | 'operational_dashboard' | 'investigation' | 'blank';
+export interface AppBuildClarification {
+    id: string;
+    question: string;
+    choices: Array<{
+        id: string;
+        label: string;
+        description?: string;
+    }>;
+    required: boolean;
+    answerId?: string;
+}
+export interface AppBuildFrame {
+    goal: string;
+    decision?: string;
+    audience?: string;
+    metrics: string[];
+    dimensions: string[];
+    grain?: string;
+    timeRange?: string;
+    comparison?: string;
+    filters: string[];
+    desiredOutput?: string;
+    clarificationQuestions?: AppBuildClarification[];
+}
+export interface AppBuildRequirement {
+    id: string;
+    question: string;
+    role: 'kpi' | 'trend' | 'breakdown' | 'detail' | 'narrative' | 'evidence';
+    required: boolean;
+    measures: string[];
+    dimensions: string[];
+    filters: string[];
+    grain?: string;
+}
+export interface AppBuildRequirementCoverage {
+    requirementId: string;
+    status: 'covered' | 'partial' | 'gap';
+    sourceIds: string[];
+    componentIds: string[];
+    reasons: string[];
+}
+export type AppBuildDraftSourceKind = 'block' | 'certified_block' | 'governed_semantic' | 'review_block' | 'review_dql' | 'text'
+/** v1 read compatibility; new drafts use governed_semantic. */
+ | 'semantic_query'
+/** v1 read compatibility; generated exploration is materialized as review_dql. */
+ | 'exploratory_sql';
+export type AppBuildSourceLifecycle = 'certified' | 'review' | 'draft' | 'pending_recertification' | 'deprecated' | 'unknown';
+export interface AppBuildSourceCapabilities {
+    measures: string[];
+    dimensions: string[];
+    outputs: string[];
+    filters: string[];
+    grain?: string;
+    chartType?: string;
+    allowedVisualizations?: string[];
+    parameters: Array<{
+        name: string;
+        type?: string;
+        required: boolean;
+        hasDefault: boolean;
+    }>;
+}
+export type AppBuildDraftSource = {
+    /** Canonical, path-disambiguated source id used by tiles and coverage. */
+    id: string;
+    kind: AppBuildDraftSourceKind;
+    /** Legacy display/execution reference retained for v1/v2 readers. */
+    sourceRef: string;
+    qualifiedIdentity?: string;
+    sourcePath?: string;
+    executionRef?: string;
+    snapshotId?: string;
+    sourceRevision?: string;
+    sourceFingerprint?: string;
+    receiptId?: string;
+    lifecycle?: AppBuildSourceLifecycle;
+    capabilities?: AppBuildSourceCapabilities;
+    trustState: 'certified' | 'review_required' | 'draft_ready';
+    reviewStatus: 'not_required' | 'required' | 'approved';
+};
+export interface AppBuildReviewTask {
+    id: string;
+    message: string;
+    status: 'open' | 'resolved';
+    sourceId?: string;
+    pageId?: string;
+    tileId?: string;
+}
+export interface AppBuildRunReceipt {
+    id: string;
+    pageId: string;
+    revision: number;
+    snapshotId: string;
+    filterFingerprint: string;
+    resultFingerprint: string;
+    createdAt: string;
+}
+export interface AppBuildPreflightReceipt {
+    id: string;
+    revision: number;
+    proposalHash: string;
+    sourceFingerprint: string;
+    createdAt: string;
+}
+/**
+ * The one durable authoring aggregate for AI, manual, CLI, and Copilot work.
+ * Drafts are local-only. Git-owned App source is produced only by explicit
+ * Publish to Project and is never used as the mutable editor backing store.
+ */
+export interface AppBuildDraft {
+    version: 3;
+    id: string;
+    appId: string;
+    name: string;
+    baseApp?: {
+        appId: string;
+        fingerprint: string;
+    };
+    revision: number;
+    proposalHash: string;
+    authoringMode: AppBuildAuthoringMode;
+    template: AppBuildTemplateId;
+    sourcePolicy: AppBuildSourcePolicy;
+    state: 'local_draft' | 'clarification_required' | 'preflight_ready' | 'project_published';
+    frame: AppBuildFrame;
+    requirements: AppBuildRequirement[];
+    coverage: AppBuildRequirementCoverage[];
+    sources: AppBuildDraftSource[];
+    pages: DashboardDocument[];
+    reviewTasks: AppBuildReviewTask[];
+    /** One settled run receipt per page. Any content edit invalidates the set. */
+    previewReceipts?: AppBuildRunReceipt[];
+    /** @deprecated Early v2 alias for the most recently run page. */
+    previewReceipt?: AppBuildRunReceipt;
+    preflightReceipt?: AppBuildPreflightReceipt;
+    publishedFingerprint?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type AppBuildDraftOperation = {
+    type: 'set_name';
+    name: string;
+} | {
+    type: 'set_template';
+    template: AppBuildTemplateId;
+} | {
+    type: 'set_frame';
+    frame: AppBuildFrame;
+} | {
+    type: 'set_source_policy';
+    sourcePolicy: AppBuildSourcePolicy;
+} | {
+    type: 'set_requirements';
+    requirements: AppBuildRequirement[];
+    coverage?: AppBuildRequirementCoverage[];
+} | {
+    type: 'set_coverage';
+    coverage: AppBuildRequirementCoverage[];
+} | {
+    type: 'upsert_source';
+    source: AppBuildDraftSource;
+} | {
+    type: 'remove_source';
+    sourceId: string;
+} | {
+    type: 'upsert_page';
+    page: DashboardDocument;
+} | {
+    type: 'remove_page';
+    pageId: string;
+} | {
+    type: 'add_tile';
+    pageId: string;
+    tile: DashboardGridItem;
+} | {
+    type: 'update_tile';
+    pageId: string;
+    tileId: string;
+    patch: Partial<DashboardGridItem>;
+} | {
+    type: 'remove_tile';
+    pageId: string;
+    tileId: string;
+} | {
+    type: 'set_filter';
+    pageId: string;
+    filter: DashboardFilter;
+} | {
+    type: 'remove_filter';
+    pageId: string;
+    filterId: string;
+} | {
+    type: 'set_layout';
+    pageId: string;
+    layout: DashboardGridLayout & {
+        responsive?: DashboardDocument['layout']['responsive'];
+    };
+} | {
+    type: 'set_review_task';
+    task: AppBuildReviewTask;
+} | {
+    type: 'remove_review_task';
+    taskId: string;
+} | {
+    type: 'set_preview_receipt';
+    receipt: AppBuildRunReceipt;
+};
+export declare function createAppBuildDraft(input: {
+    id: string;
+    appId: string;
+    name?: string;
+    baseApp?: AppBuildDraft['baseApp'];
+    authoringMode: AppBuildAuthoringMode;
+    template?: AppBuildTemplateId;
+    sourcePolicy?: AppBuildSourcePolicy;
+    frame: AppBuildFrame;
+    requirements?: AppBuildRequirement[];
+    coverage?: AppBuildRequirementCoverage[];
+    sources?: AppBuildDraftSource[];
+    pages?: DashboardDocument[];
+    reviewTasks?: AppBuildReviewTask[];
+    now?: string;
+}): AppBuildDraft;
+export declare function applyAppBuildDraftOperations(draft: AppBuildDraft, expectedRevision: number, operations: AppBuildDraftOperation[], now?: string): AppBuildDraft;
+export declare function appBuildDraftHash(value: unknown): string;
+/**
+ * Produce a compact, non-overlapping row layout while preserving the author's
+ * visual reading order. App Studio uses this after every explicit edit so
+ * imported or stale geometry can never place a tile outside the active grid.
+ */
+export declare function packDashboardLayoutItems(items: DashboardDocument['layout']['items'], cols: number): DashboardDocument['layout']['items'];
+//# sourceMappingURL=app-build-draft.d.ts.map

package/dist/apps/app-build-draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-build-draft.d.ts","sourceRoot":"","sources":["../../src/apps/app-build-draft.ts"],"names":[],"mappings":"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"}

package/dist/apps/app-build-draft.js

@@ -0,0 +1,281 @@
+import { createHash } from 'node:crypto';
+export function createAppBuildDraft(input) {
+    const now = input.now ?? new Date().toISOString();
+    const clarifications = input.frame.clarificationQuestions ?? [];
+    const needsClarification = clarifications.some((question) => question.required && !question.answerId);
+    const draftWithoutHash = {
+        version: 3,
+        id: input.id,
+        appId: input.appId,
+        name: input.name?.trim() || input.frame.goal.trim() || input.appId,
+        ...(input.baseApp ? { baseApp: input.baseApp } : {}),
+        revision: 1,
+        authoringMode: input.authoringMode,
+        template: input.template ?? 'blank',
+        sourcePolicy: input.sourcePolicy ?? 'governed_only',
+        state: needsClarification ? 'clarification_required' : 'local_draft',
+        frame: input.frame,
+        requirements: input.requirements ?? [],
+        coverage: input.coverage ?? [],
+        sources: input.sources ?? [],
+        pages: input.pages ?? [],
+        reviewTasks: input.reviewTasks ?? [],
+        createdAt: now,
+        updatedAt: now,
+    };
+    assertAppBuildDraftPolicy(draftWithoutHash);
+    return { ...draftWithoutHash, proposalHash: appBuildDraftHash(draftWithoutHash) };
+}
+export function applyAppBuildDraftOperations(draft, expectedRevision, operations, now = new Date().toISOString()) {
+    if (draft.revision !== expectedRevision) {
+        throw new Error(`APP_BUILD_REVISION_CONFLICT: expected ${expectedRevision}, current ${draft.revision}`);
+    }
+    if (operations.length === 0)
+        return draft;
+    let next = structuredClone(draft);
+    for (const operation of operations)
+        next = applyOperation(next, operation);
+    next = reconcileCoverageReferences(next);
+    const contentChanged = operations.some((operation) => operation.type !== 'set_preview_receipt');
+    const settledDataChanged = operations.some((operation) => !operationPreservesSettledData(draft, operation));
+    next.updatedAt = now;
+    if (contentChanged) {
+        next.revision += 1;
+        if (settledDataChanged) {
+            delete next.previewReceipts;
+            delete next.previewReceipt;
+        }
+        else {
+            if (next.previewReceipts)
+                next.previewReceipts = next.previewReceipts.map((receipt) => ({ ...receipt, revision: next.revision }));
+            if (next.previewReceipt)
+                next.previewReceipt = { ...next.previewReceipt, revision: next.revision };
+        }
+        delete next.preflightReceipt;
+        delete next.publishedFingerprint;
+        const needsClarification = (next.frame.clarificationQuestions ?? [])
+            .some((question) => question.required && !question.answerId);
+        next.state = needsClarification ? 'clarification_required' : 'local_draft';
+        next.proposalHash = appBuildDraftHash({ ...next, proposalHash: undefined });
+    }
+    assertAppBuildDraftPolicy(next);
+    return next;
+}
+/**
+ * Coverage is part of the aggregate, not an independent planner memo. Keep its
+ * references aligned after source/page/tile mutations so a removed component
+ * can never remain reported as covered or block publication as a ghost gap.
+ */
+function reconcileCoverageReferences(draft) {
+    const sourceIds = new Set(draft.sources.map((source) => source.id));
+    const componentIds = new Set(draft.pages.flatMap((page) => page.layout.items.map((item) => item.i)));
+    return {
+        ...draft,
+        coverage: draft.coverage.map((item) => {
+            const validSourceIds = item.sourceIds.filter((sourceId) => sourceIds.has(sourceId));
+            const validComponentIds = item.componentIds.filter((componentId) => componentIds.has(componentId));
+            return {
+                ...item,
+                sourceIds: validSourceIds,
+                componentIds: validComponentIds,
+                status: validSourceIds.length > 0 && validComponentIds.length > 0 ? item.status : 'gap',
+            };
+        }),
+    };
+}
+function operationPreservesSettledData(draft, operation) {
+    if (operation.type === 'set_preview_receipt')
+        return true;
+    if (operation.type === 'update_tile') {
+        const presentationKeys = new Set(['title', 'viz', 'display', 'x', 'y', 'w', 'h', 'sectionId']);
+        return Object.keys(operation.patch).every((key) => presentationKeys.has(key));
+    }
+    if (operation.type !== 'set_layout')
+        return false;
+    const page = draft.pages.find((candidate) => candidate.id === operation.pageId);
+    if (!page || page.layout.items.length !== operation.layout.items.length)
+        return false;
+    const currentById = new Map(page.layout.items.map((item) => [item.i, item]));
+    return operation.layout.items.every((item) => {
+        const current = currentById.get(item.i);
+        return current !== undefined && JSON.stringify(withoutTileGeometry(item)) === JSON.stringify(withoutTileGeometry(current));
+    });
+}
+function withoutTileGeometry(item) {
+    const { x: _x, y: _y, w: _w, h: _h, ...contract } = item;
+    return contract;
+}
+export function appBuildDraftHash(value) {
+    return `sha256:${createHash('sha256').update(JSON.stringify(value)).digest('hex')}`;
+}
+function applyOperation(draft, operation) {
+    switch (operation.type) {
+        case 'set_name': {
+            const name = operation.name.trim();
+            if (!name)
+                throw new Error('App name is required');
+            return { ...draft, name };
+        }
+        case 'set_template': return { ...draft, template: operation.template };
+        case 'set_frame': return { ...draft, frame: operation.frame };
+        case 'set_source_policy': return { ...draft, sourcePolicy: operation.sourcePolicy };
+        case 'set_requirements': return { ...draft, requirements: operation.requirements, coverage: operation.coverage ?? draft.coverage };
+        case 'set_coverage': return { ...draft, coverage: operation.coverage };
+        case 'upsert_source': return { ...draft, sources: upsertById(draft.sources, operation.source) };
+        case 'remove_source': return {
+            ...draft,
+            sources: draft.sources.filter((source) => source.id !== operation.sourceId),
+            coverage: draft.coverage.map((item) => ({ ...item, sourceIds: item.sourceIds.filter((id) => id !== operation.sourceId) })),
+        };
+        case 'upsert_page': return { ...draft, pages: upsertById(draft.pages, normalizeEditedPage(operation.page)) };
+        case 'remove_page': return { ...draft, pages: draft.pages.filter((page) => page.id !== operation.pageId) };
+        case 'set_review_task': return { ...draft, reviewTasks: upsertById(draft.reviewTasks, operation.task) };
+        case 'remove_review_task': return { ...draft, reviewTasks: draft.reviewTasks.filter((task) => task.id !== operation.taskId) };
+        case 'set_preview_receipt': return {
+            ...draft,
+            previewReceipt: operation.receipt,
+            previewReceipts: upsertReceiptByPage(draft.previewReceipts ?? (draft.previewReceipt ? [draft.previewReceipt] : []), operation.receipt),
+        };
+        default:
+            return updatePage(draft, operation.pageId, (page) => {
+                if (operation.type === 'add_tile') {
+                    if (page.layout.items.some((tile) => tile.i === operation.tile.i))
+                        throw new Error(`Tile already exists: ${operation.tile.i}`);
+                    return { ...page, layout: { ...page.layout, items: [...page.layout.items, operation.tile] } };
+                }
+                if (operation.type === 'update_tile') {
+                    return { ...page, layout: { ...page.layout, items: page.layout.items.map((tile) => tile.i === operation.tileId ? { ...tile, ...operation.patch, i: tile.i } : tile) } };
+                }
+                if (operation.type === 'remove_tile') {
+                    return { ...page, layout: { ...page.layout, items: page.layout.items.filter((tile) => tile.i !== operation.tileId) } };
+                }
+                if (operation.type === 'set_filter') {
+                    return { ...page, filters: upsertById(page.filters ?? [], operation.filter) };
+                }
+                if (operation.type === 'remove_filter') {
+                    return { ...page, filters: (page.filters ?? []).filter((filter) => filter.id !== operation.filterId) };
+                }
+                return { ...page, layout: operation.layout };
+            });
+    }
+}
+function updatePage(draft, pageId, update) {
+    let found = false;
+    const pages = draft.pages.map((page) => {
+        if (page.id !== pageId)
+            return page;
+        found = true;
+        return normalizeEditedPage(update(page));
+    });
+    if (!found)
+        throw new Error(`Page not found: ${pageId}`);
+    return { ...draft, pages };
+}
+/** A v1 page is upgraded only when an explicit App Studio edit reaches it. */
+function normalizeEditedPage(page) {
+    const items = packDashboardLayoutItems(page.layout.items, 12);
+    return {
+        ...page,
+        version: 2,
+        layout: {
+            ...page.layout,
+            items,
+            responsive: projectResponsiveLayouts(items, page.layout.rowHeight),
+        },
+    };
+}
+/**
+ * Produce a compact, non-overlapping row layout while preserving the author's
+ * visual reading order. App Studio uses this after every explicit edit so
+ * imported or stale geometry can never place a tile outside the active grid.
+ */
+export function packDashboardLayoutItems(items, cols) {
+    const columnCount = Math.max(1, Math.floor(cols));
+    let x = 0;
+    let y = 0;
+    let currentRowHeight = 0;
+    return items
+        .map((item, index) => ({ item, index }))
+        .sort((left, right) => left.item.y - right.item.y || left.item.x - right.item.x || left.index - right.index)
+        .map(({ item }) => {
+        const width = Math.min(columnCount, Math.max(1, Math.floor(item.w)));
+        const height = Math.max(1, Math.floor(item.h));
+        if (x + width > columnCount) {
+            x = 0;
+            y += currentRowHeight || height;
+            currentRowHeight = 0;
+        }
+        const next = { ...item, x, y, w: width, h: height };
+        x += width;
+        currentRowHeight = Math.max(currentRowHeight, height);
+        if (x >= columnCount) {
+            x = 0;
+            y += currentRowHeight;
+            currentRowHeight = 0;
+        }
+        return next;
+    });
+}
+function projectResponsiveLayouts(items, rowHeight) {
+    const project = (cols) => {
+        const projected = items.map((item) => {
+            const width = cols === 1 ? 1 : Math.min(cols, Math.max(2, Math.ceil(item.w / 2)));
+            return { ...item, w: width };
+        });
+        return packDashboardLayoutItems(projected, cols);
+    };
+    return {
+        wide: { kind: 'grid', cols: 12, rowHeight, items: packDashboardLayoutItems(items, 12) },
+        medium: { kind: 'grid', cols: 6, rowHeight, items: project(6) },
+        narrow: { kind: 'grid', cols: 1, rowHeight, items: project(1) },
+    };
+}
+function upsertById(values, next) {
+    return values.some((value) => value.id === next.id)
+        ? values.map((value) => value.id === next.id ? next : value)
+        : [...values, next];
+}
+function upsertReceiptByPage(values, next) {
+    return values.some((value) => value.pageId === next.pageId)
+        ? values.map((value) => value.pageId === next.pageId ? next : value)
+        : [...values, next];
+}
+function assertAppBuildDraftPolicy(draft) {
+    if (!draft.id.trim() || !draft.appId.trim())
+        throw new Error('App Build Draft requires id and appId');
+    if (!draft.name.trim())
+        throw new Error('App Build Draft requires a name');
+    if (!draft.frame.goal.trim())
+        throw new Error('App Build Frame requires a goal');
+    const sourceIds = new Set();
+    for (const source of draft.sources) {
+        if (sourceIds.has(source.id))
+            throw new Error(`Duplicate App source id: ${source.id}`);
+        sourceIds.add(source.id);
+        if (source.sourceRevision && source.sourceFingerprint && source.sourceRevision !== source.sourceFingerprint) {
+            throw new Error(`Source ${source.id} has conflicting revision fingerprints`);
+        }
+    }
+    for (const coverage of draft.coverage) {
+        for (const sourceId of coverage.sourceIds) {
+            if (!sourceIds.has(sourceId))
+                throw new Error(`Coverage ${coverage.requirementId} references missing source ${sourceId}`);
+        }
+    }
+    for (const page of draft.pages) {
+        for (const tile of page.layout.items) {
+            if (tile.sourceId && !sourceIds.has(tile.sourceId)) {
+                throw new Error(`Tile ${page.id}/${tile.i} references missing source ${tile.sourceId}`);
+            }
+        }
+    }
+    if (draft.sourcePolicy === 'governed_only') {
+        const reviewSource = draft.sources.find((source) => (source.kind === 'block' && source.trustState !== 'certified')
+            || source.kind === 'review_block'
+            || source.kind === 'review_dql'
+            || source.kind === 'exploratory_sql');
+        if (reviewSource)
+            throw new Error(`Source ${reviewSource.id} requires include_review_required policy`);
+    }
+}
+//# sourceMappingURL=app-build-draft.js.map

package/dist/apps/app-build-draft.js.map

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

package/dist/apps/dashboard-document.d.ts

@@ -22,12 +22,34 @@ export type DashboardParam = {
 };
 export type DashboardFilter = {
     id: string;
-    type: 'string' | 'number' | 'boolean' | 'date' | 'daterange' | 'select';
+    type: 'string' | 'number' | 'boolean' | 'date' | 'daterange' | 'relative_date' | 'select' | 'multiselect' | 'search' | 'number_range';
+    label?: string;
     default?: unknown;
     /** For 'select': allowed values. */
     options?: string[];
     /** Optional dimension reference the filter binds to. */
     bindsTo?: string;
+    /** Qualified identity; display names alone are never sufficient binding proof. */
+    field?: {
+        name: string;
+        relation?: string;
+        semanticModel?: string;
+        provider?: string;
+    };
+    required?: boolean;
+    multiple?: boolean;
+    scope?: {
+        page?: string;
+        tileIds?: string[];
+    };
+    optionSource?: {
+        mode: 'static' | 'distinct_query';
+        sourceRef?: string;
+        field?: string;
+        snapshotId?: string;
+        limit?: number;
+    };
+    dependsOn?: string[];
 };
 export type DashboardBlockRef = {
     blockId: string;
@@ -65,13 +87,15 @@ export type DashboardTileFilterBinding = {
     /** Physical column/expression or semantic field this filter can bind to. */
     binding?: string;
     /** Whether this becomes a block parameter or an outer predicate at execution time. */
-    mode?: 'parameter' | 'predicate';
+    mode?: 'parameter' | 'predicate' | 'semantic';
     /** Block parameter names controlled by this app filter. */
     paramNames?: string[];
     /** If true, the tile should warn when the filter is missing. */
     required?: boolean;
     /** Populated when a global filter intentionally does not apply to this tile. */
     unsupportedReason?: string;
+    /** Explicit capability prevents a global filter from appearing silently partial. */
+    capability?: 'supported' | 'unsupported' | 'preflight_required';
 };
 export type DashboardTileParameterBinding = {
     /** Block parameter name. */
@@ -193,6 +217,13 @@ export type DashboardGridItem = {
     y: number;
     w: number;
     h: number;
+    /**
+     * Canonical AppBuildDraft source binding. App Studio v3 writes this for
+     * every data tile; legacy published dashboards remain readable without it.
+     */
+    sourceId?: string;
+    /** Snapshot-bound source revision selected by App Studio. */
+    sourceRevision?: string;
     /** Certified/shared block source. Existing dashboards use this shape. */
     block?: DashboardBlockRef;
     /** Local narrative/section text tile. */
@@ -236,8 +267,20 @@ export type DashboardSection = {
     narrative?: string;
     order: number;
 };
+export type DashboardGridLayout = {
+    kind: 'grid';
+    cols: number;
+    rowHeight: number;
+    items: DashboardGridItem[];
+};
+export type DashboardResponsiveLayouts = {
+    /** Canonical authoring geometry. Existing v1 layout is treated as `wide`. */
+    wide?: DashboardGridLayout;
+    medium?: DashboardGridLayout;
+    narrow?: DashboardGridLayout;
+};
 export interface DashboardDocument {
-    version: 1;
+    version: 1 | 2;
     id: string;
     metadata: {
         title: string;
@@ -262,11 +305,8 @@ export interface DashboardDocument {
     sections?: DashboardSection[];
     /** Runtime story evidence contract. Result-specific prose is never persisted. */
     story?: DashboardStoryEvidencePlan;
-    layout: {
-        kind: 'grid';
-        cols: number;
-        rowHeight: number;
-        items: DashboardGridItem[];
+    layout: DashboardGridLayout & {
+        responsive?: DashboardResponsiveLayouts;
     };
 }
 export interface DashboardParseError {