@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/dashboard-model.d.ts.map

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

package/dist/core/dashboard-model.js

@@ -0,0 +1,176 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Dashboard overview projection: what the dashboard's Overview tab, its trace search and its
+ * agent handoff read, computed in one pass over the item store.
+ *
+ * `listItems` carries neither `created` nor `affected_paths`, and widening it would raise the
+ * cost of every MCP `list` answer, so the dashboard reads `readAllItemMetadata` itself. The board
+ * lanes follow `getBoard` exactly: tag membership, store order and `WIP_LIMIT`; a test holds the
+ * two together. Every list is bounded: `total` is the true count and `items` holds at most the
+ * limit, so a project of 10K items never reaches the webview whole.
+ *
+ * @see STORY-365 TASK-846 STORY-422
+ */
+import { existsSync } from 'node:fs';
+import { WIP_LIMIT } from './focus-work.js';
+import { readAllItemMetadata } from './item-store.js';
+import { CLOSED_STATUSES } from './list-page.js';
+import { STALE_AFTER_DAYS } from './project-status.js';
+/** Rows per live list (in progress, blocked, stale, delivered, lanes). */
+export const DASHBOARD_LIST_LIMIT = 50;
+/** Rows per Next-up quadrant. */
+export const DASHBOARD_NEXT_UP_LIMIT = 100;
+/** Hits the trace search returns. */
+export const DASHBOARD_TRACE_HIT_LIMIT = 30;
+/** Affected paths a row carries; the rest is counted in `affected_paths_total`. */
+export const DASHBOARD_PATH_LIMIT = 2;
+export const DAY_MS = 24 * 3600 * 1000;
+const DELIVERED_WINDOW_MS = 7 * DAY_MS;
+const NEXT_UP_STATUSES = ['draft', 'planned', 'review'];
+export const QUADRANT_OF = {
+    'urgent-important': 'Q1',
+    'not-urgent-important': 'Q2',
+    'urgent-not-important': 'Q3',
+    'not-urgent-not-important': 'Q4',
+};
+/** Read the store once for the dashboard projections. */
+export function readDashboardItems(devstepsDir) {
+    if (!existsSync(devstepsDir)) {
+        throw new Error('DevSteps project not initialized. Run: devsteps init');
+    }
+    const { items, unreadable } = readAllItemMetadata(devstepsDir);
+    return { items: items.map((entry) => entry.metadata), unreadable };
+}
+export function isClosedStatus(status) {
+    return CLOSED_STATUSES.includes(status);
+}
+export function toDashboardItem(metadata, nowMs) {
+    const age = Math.floor((nowMs - Date.parse(metadata.updated)) / DAY_MS);
+    return {
+        id: metadata.id,
+        type: metadata.type,
+        title: metadata.title,
+        status: metadata.status,
+        eisenhower: metadata.eisenhower,
+        updated: metadata.updated,
+        days_since_update: Math.max(0, age),
+        affected_paths: metadata.affected_paths.slice(0, DASHBOARD_PATH_LIMIT),
+        affected_paths_total: metadata.affected_paths.length,
+    };
+}
+export const newestFirst = (a, b) => Date.parse(b.updated) - Date.parse(a.updated);
+const oldestFirst = (a, b) => -newestFirst(a, b);
+const hasTag = (tag) => (item) => item.tags.includes(tag);
+/** The first `limit` items as dashboard rows, with the true total. */
+export function boundedRows(items, limit, nowMs) {
+    return {
+        total: items.length,
+        items: items.slice(0, limit).map((item) => toDashboardItem(item, nowMs)),
+    };
+}
+function groupNextUp(items) {
+    const groups = { Q1: [], Q2: [], Q3: [], Q4: [] };
+    for (const item of items) {
+        if (item.type === 'story' && NEXT_UP_STATUSES.includes(item.status)) {
+            groups[QUADRANT_OF[item.eisenhower]].push(item);
+        }
+    }
+    for (const group of Object.values(groups))
+        group.sort(newestFirst);
+    return groups;
+}
+/** Project the Overview from item metadata; pure, so tests need no disk. */
+export function projectDashboardOverview(source, opts = {}) {
+    const now = opts.now ?? new Date();
+    const nowMs = now.getTime();
+    const listLimit = opts.listLimit ?? DASHBOARD_LIST_LIMIT;
+    const nextUpLimit = opts.nextUpLimit ?? DASHBOARD_NEXT_UP_LIMIT;
+    const { items } = source;
+    const rows = (list) => boundedRows(list, listLimit, nowMs);
+    const inProgress = items.filter((item) => item.status === 'in-progress').sort(newestFirst);
+    const stale = inProgress
+        .filter((item) => (nowMs - Date.parse(item.updated)) / DAY_MS > STALE_AFTER_DAYS)
+        .sort(oldestFirst);
+    const blocked = items.filter((item) => item.status === 'blocked').sort(newestFirst);
+    const delivered = items
+        .filter((item) => item.status === 'done' && nowMs - Date.parse(item.updated) < DELIVERED_WINDOW_MS)
+        .sort(newestFirst);
+    // Store order and plain tag membership, exactly as getBoard lists its lanes.
+    const nowLane = items.filter(hasTag('focus:now'));
+    const nextLane = items.filter(hasTag('focus:next'));
+    const groups = groupNextUp(items);
+    return {
+        generated_at: now.toISOString(),
+        pulse: {
+            in_progress: inProgress.length,
+            blocked: blocked.length,
+            stale: stale.length,
+            delivered_7d: delivered.length,
+            wip: { now: nowLane.length, limit: WIP_LIMIT, violated: nowLane.length > WIP_LIMIT },
+        },
+        in_progress: rows(inProgress),
+        blocked: rows(blocked),
+        stale: rows(stale),
+        delivered_7d: rows(delivered),
+        lanes: {
+            now: rows(nowLane),
+            next: rows(nextLane),
+            later_count: items.filter(hasTag('focus:later')).length,
+        },
+        next_up: {
+            Q1: boundedRows(groups.Q1, nextUpLimit, nowMs),
+            Q2: boundedRows(groups.Q2, nextUpLimit, nowMs),
+            Q3: boundedRows(groups.Q3, nextUpLimit, nowMs),
+            Q4: boundedRows(groups.Q4, nextUpLimit, nowMs),
+        },
+        unreadable: [...source.unreadable],
+    };
+}
+export function buildDashboardOverview(devstepsDir, opts = {}) {
+    return projectDashboardOverview(readDashboardItems(devstepsDir), opts);
+}
+const byId = (a, b) => a.id.localeCompare(b.id, 'en', { numeric: true });
+/**
+ * Trace-search hits: the exact ID first, then ID-prefix matches in ID order, then items whose
+ * ID and title together hold every query word ("STORY-365 dashboard"), newest update first. Every active item takes part, whatever its
+ * status; archived items are outside the store and outside the search (DEC-012).
+ */
+export function searchDashboardItems(items, query, limit = DASHBOARD_TRACE_HIT_LIMIT, nowMs = Date.now()) {
+    const needle = query.trim().toLowerCase();
+    if (needle === '' || limit <= 0)
+        return [];
+    const words = needle.split(/\s+/);
+    const exact = [];
+    const prefix = [];
+    const titled = [];
+    for (const item of items) {
+        const id = item.id.toLowerCase();
+        if (id === needle)
+            exact.push(item);
+        else if (id.startsWith(needle))
+            prefix.push(item);
+        else {
+            const text = `${id} ${item.title.toLowerCase()}`;
+            if (words.every((word) => text.includes(word)))
+                titled.push(item);
+        }
+    }
+    return [...exact, ...prefix.sort(byId), ...titled.sort(newestFirst)]
+        .slice(0, limit)
+        .map((item) => toDashboardItem(item, nowMs));
+}
+export function findDashboardItems(devstepsDir, query, limit = DASHBOARD_TRACE_HIT_LIMIT) {
+    return searchDashboardItems(readDashboardItems(devstepsDir).items, query, limit);
+}
+/**
+ * IDs of the focus:now lane in board order. Work-the-board reads them at click time, so the
+ * prompt never trusts a list the webview sent.
+ */
+export function nowLaneIds(devstepsDir) {
+    return readDashboardItems(devstepsDir)
+        .items.filter(hasTag('focus:now'))
+        .map((item) => item.id);
+}
+//# sourceMappingURL=dashboard-model.js.map

package/dist/core/dashboard-model.js.map

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

package/dist/core/decision-count.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Decision count of an epic (EPIC-059, design v6.1 §1). `add` cannot link, so a new decision
+ * belongs to no epic yet; the count is reported by `link`, once a decision joins a work item.
+ */
+import type { ItemMetadata } from '../schemas/index.js';
+/** The top of the implements chain above `item`, first parent first, with a visited set. */
+export declare function implementsRoot(devstepsDir: string, item: ItemMetadata): ItemMetadata;
+/** The decisions linked to `root` or to any item below it through implemented-by. */
+export declare function decisionIdsUnder(devstepsDir: string, root: ItemMetadata): Set<string>;
+/**
+ * The reminder of a link between a decision and a work item: the decision count of the epic
+ * (or requirement) the work item belongs to. Read after the link is written.
+ */
+export declare function decisionLinkReminders(devstepsDir: string, sourceId: string, targetId: string): string[];
+//# sourceMappingURL=decision-count.d.ts.map

package/dist/core/decision-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-count.d.ts","sourceRoot":"","sources":["../../src/core/decision-count.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiBxD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAUpF;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBrF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CASV"}

package/dist/core/decision-count.js

@@ -0,0 +1,74 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Decision count of an epic (EPIC-059, design v6.1 §1). `add` cannot link, so a new decision
+ * belongs to no epic yet; the count is reported by `link`, once a decision joins a work item.
+ */
+import { decisionCountReminder } from '../templates/reminders.js';
+import { parseItemId } from '../utils/index.js';
+import { isCrossCutting } from './decision-question.js';
+import { readItemMetadata } from './item-store.js';
+/** The top types of the two hierarchies: the items a decision count is reported for. */
+const TOP_TYPES = ['epic', 'requirement'];
+function metadataOf(devstepsDir, id) {
+    try {
+        return readItemMetadata(devstepsDir, id).metadata;
+    }
+    catch {
+        return null;
+    }
+}
+/** The top of the implements chain above `item`, first parent first, with a visited set. */
+export function implementsRoot(devstepsDir, item) {
+    const visited = new Set([item.id]);
+    let current = item;
+    for (;;) {
+        const parentId = (current.linked_items?.implements ?? []).find((id) => !visited.has(id));
+        const parent = parentId ? metadataOf(devstepsDir, parentId) : null;
+        if (!parent)
+            return current;
+        visited.add(parent.id);
+        current = parent;
+    }
+}
+/** The decisions linked to `root` or to any item below it through implemented-by. */
+export function decisionIdsUnder(devstepsDir, root) {
+    const decisions = new Set();
+    const visited = new Set();
+    const pending = [root];
+    for (let item = pending.pop(); item; item = pending.pop()) {
+        if (visited.has(item.id))
+            continue;
+        visited.add(item.id);
+        for (const ids of Object.values(item.linked_items ?? {})) {
+            for (const id of ids)
+                if (parseItemId(id)?.type === 'decision')
+                    decisions.add(id);
+        }
+        for (const childId of item.linked_items?.['implemented-by'] ?? []) {
+            const child = visited.has(childId) ? null : metadataOf(devstepsDir, childId);
+            if (child)
+                pending.push(child);
+        }
+    }
+    return decisions;
+}
+/**
+ * The reminder of a link between a decision and a work item: the decision count of the epic
+ * (or requirement) the work item belongs to. Read after the link is written.
+ */
+export function decisionLinkReminders(devstepsDir, sourceId, targetId) {
+    const source = metadataOf(devstepsDir, sourceId);
+    const target = metadataOf(devstepsDir, targetId);
+    if (!source || !target)
+        return [];
+    const [decision, other] = source.type === 'decision' ? [source, target] : [target, source];
+    if (decision.type !== 'decision' || isCrossCutting(other.type))
+        return [];
+    const root = implementsRoot(devstepsDir, other);
+    if (!TOP_TYPES.includes(root.type))
+        return [];
+    return [decisionCountReminder(root.id, decisionIdsUnder(devstepsDir, root).size)];
+}
+//# sourceMappingURL=decision-count.js.map

package/dist/core/decision-count.js.map

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

package/dist/core/decision-question-status.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Status rules of decision (DEC) and question (QST) items (EPIC-059): the status vocabulary of
+ * each type, the start status, and the reminders `updateItem` returns for a status change.
+ */
+import type { ItemMetadata, ItemStatus, ItemType } from '../schemas/index.js';
+/** The statuses a decision takes, with their meaning. */
+export declare const DECISION_STATUSES: Readonly<Partial<Record<ItemStatus, string>>>;
+/** The statuses a question takes, with their meaning. */
+export declare const QUESTION_STATUSES: Readonly<Partial<Record<ItemStatus, string>>>;
+/** The statuses of a type with meaning, or undefined for a type with the general lifecycle. */
+export declare function statusVocabulary(type: string): Readonly<Partial<Record<ItemStatus, string>>> | undefined;
+/** The status an added item starts in: an AI-written decision is a proposal, so `review`. */
+export declare function initialStatus(type: ItemType): ItemStatus;
+/** The part of an update the status reminders read. */
+export interface StatusChange {
+    status?: ItemStatus;
+    superseded_by?: string;
+}
+type ReminderItem = Pick<ItemMetadata, 'id' | 'type' | 'linked_items' | 'superseded_by'>;
+/**
+ * EPIC-059, design v6.1 §1: the status rules of a decision or question, as reminders on a status
+ * the type does not use, a question answered without an `## Answer` section, a decision accepted
+ * with incomplete fields, and a decision set obsolete without a newer decision that supersedes it.
+ * The status change is written either way. `description` is the master document after the write.
+ */
+export declare function decisionQuestionStatusReminders(item: ReminderItem, change: StatusChange, description: string): string[];
+/**
+ * The hint `add` returns for a decision or question: statuses, the link add cannot make, the
+ * decision filter of design v6.1 §1, and the body template.
+ */
+export declare function decisionQuestionAddHint(type: 'decision' | 'question', id: string, description: string, hadDescription: boolean): string;
+export {};
+//# sourceMappingURL=decision-question-status.d.ts.map

package/dist/core/decision-question-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-question-status.d.ts","sourceRoot":"","sources":["../../src/core/decision-question-status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAW9E,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAK3E,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAI3E,CAAC;AAEF,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAI3D;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAExD;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,cAAc,GAAG,eAAe,CAAC,CAAC;AAuCzF;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,YAAY,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAqBV;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,OAAO,GACtB,MAAM,CAkBR"}

package/dist/core/decision-question-status.js

@@ -0,0 +1,106 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Status rules of decision (DEC) and question (QST) items (EPIC-059): the status vocabulary of
+ * each type, the start status, and the reminders `updateItem` returns for a status change.
+ */
+import { DECISION_FILTER } from '../templates/reminders.js';
+import { answerSection, DECISION_TEMPLATE, decisionFieldProblems, isDecisionOrQuestion, parseDecisionFields, QUESTION_TEMPLATE, } from './decision-question.js';
+/** The statuses a decision takes, with their meaning. */
+export const DECISION_STATUSES = {
+    review: 'proposed',
+    done: 'accepted',
+    cancelled: 'rejected',
+    obsolete: 'replaced, once a newer decision supersedes it',
+};
+/** The statuses a question takes, with their meaning. */
+export const QUESTION_STATUSES = {
+    draft: 'open',
+    done: 'answered, with an ## Answer section',
+    cancelled: 'dropped',
+};
+/** The statuses of a type with meaning, or undefined for a type with the general lifecycle. */
+export function statusVocabulary(type) {
+    if (type === 'decision')
+        return DECISION_STATUSES;
+    if (type === 'question')
+        return QUESTION_STATUSES;
+    return undefined;
+}
+/** The status an added item starts in: an AI-written decision is a proposal, so `review`. */
+export function initialStatus(type) {
+    return type === 'decision' ? 'review' : 'draft';
+}
+function vocabularyText(type) {
+    const entries = Object.entries(statusVocabulary(type) ?? {});
+    return `A ${type} takes these statuses: ${entries.map(([s, m]) => `${s} (${m})`).join(', ')}.`;
+}
+function reminder(message, template) {
+    return `${message}\n\n${template}`;
+}
+function decisionReminders(item, change, description) {
+    if (change.status === 'obsolete') {
+        const replaced = (item.linked_items?.['superseded-by']?.length ?? 0) > 0 ||
+            Boolean(change.superseded_by ?? item.superseded_by);
+        if (replaced)
+            return [];
+        return [
+            reminder(`${item.id} is obsolete, but no newer decision supersedes it: link the newer one with "link <DEC-n> supersedes ${item.id}"; cancelled is the status that rejects a decision.`, vocabularyText('decision')),
+        ];
+    }
+    if (change.status !== 'done')
+        return [];
+    const problems = decisionFieldProblems(parseDecisionFields(description), description);
+    if (problems.length === 0)
+        return [];
+    return [
+        reminder(`${item.id} is accepted with incomplete fields: ${problems.join(' ')} Complete them through update description.`, DECISION_TEMPLATE),
+    ];
+}
+/**
+ * EPIC-059, design v6.1 §1: the status rules of a decision or question, as reminders on a status
+ * the type does not use, a question answered without an `## Answer` section, a decision accepted
+ * with incomplete fields, and a decision set obsolete without a newer decision that supersedes it.
+ * The status change is written either way. `description` is the master document after the write.
+ */
+export function decisionQuestionStatusReminders(item, change, description) {
+    if (!change.status || !isDecisionOrQuestion(item.type))
+        return [];
+    const vocabulary = statusVocabulary(item.type) ?? {};
+    if (!(change.status in vocabulary)) {
+        return [
+            reminder(`${item.id} now has status "${change.status}", which a ${item.type} does not use.`, vocabularyText(item.type)),
+        ];
+    }
+    if (item.type === 'decision')
+        return decisionReminders(item, change, description);
+    if (change.status === 'done' && !answerSection(description)) {
+        return [
+            reminder(`${item.id} is answered without an "## Answer" section: add one that names the chosen option through update description or append_description.`, QUESTION_TEMPLATE),
+        ];
+    }
+    return [];
+}
+/**
+ * The hint `add` returns for a decision or question: statuses, the link add cannot make, the
+ * decision filter of design v6.1 §1, and the body template.
+ */
+export function decisionQuestionAddHint(type, id, description, hadDescription) {
+    const link = type === 'decision'
+        ? `Not linked yet: link it to its epic or story with "link ${id} relates-to <EPIC-n or STORY-n>".`
+        : `Not linked yet: link it to the epic or story it concerns with "link ${id} relates-to <ID>", or with blocks instead when it holds that item up.`;
+    const body = hadDescription
+        ? 'Your description was kept.'
+        : `The ${type} skeleton is in the description; fill it in through update.`;
+    const problems = type === 'decision' && hadDescription
+        ? decisionFieldProblems(parseDecisionFields(description), description)
+        : [];
+    return [
+        `${vocabularyText(type)} It starts in ${initialStatus(type)}. ${link} ${body}`,
+        ...(type === 'decision' ? [DECISION_FILTER] : []),
+        ...(problems.length > 0 ? [`Field problems: ${problems.join(' ')}`] : []),
+        type === 'decision' ? DECISION_TEMPLATE : QUESTION_TEMPLATE,
+    ].join('\n');
+}
+//# sourceMappingURL=decision-question-status.js.map

package/dist/core/decision-question-status.js.map

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

package/dist/core/decision-question.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Decision (DEC) and question (QST) items (EPIC-059, design v6.1 §1): the cross-cutting types, the
+ * body templates, the body field parser and renderer, and the deviation tag. The status rules live in
+ * `decision-question-status.ts`.
+ */
+import type { ItemType } from '../schemas/index.js';
+/** Types outside the implements hierarchy: they link through relates-to, blocks or documents. */
+export declare const CROSS_CUTTING_TYPES: readonly ItemType[];
+/** True for doc, decision and question: exempt from the hierarchy and never an orphan. */
+export declare function isCrossCutting(type: string): boolean;
+/** True for the two types whose body carries fields and whose statuses carry a meaning. */
+export declare function isDecisionOrQuestion(type: string): type is 'decision' | 'question';
+export declare const DECISION_FIELDS: readonly ['Why', 'Rejected', 'Check'];
+export type DecisionField = (typeof DECISION_FIELDS)[number];
+export type DecisionFields = Partial<Record<DecisionField, string>>;
+export declare const QUESTION_FIELDS: readonly ['Recommendation'];
+export type QuestionField = (typeof QUESTION_FIELDS)[number];
+/** The tag that marks a decision as a deviation; its priority (eisenhower) ranks it. */
+export declare const DEVIATION_TAG = "deviation";
+/** One option line `a) …` of a question. */
+export interface QuestionOption {
+    key: string;
+    text: string;
+}
+export interface QuestionFields extends Partial<Record<QuestionField, string>> {
+    /** The `a) b) c)` options, in body order. */
+    options: QuestionOption[];
+    /** The text of the `## Answer` section, absent while the question is open. */
+    answer?: string;
+}
+/** The DEC body fields as `add` returns them in its hint and a reminder carries them. */
+export declare const DECISION_TEMPLATE: string;
+/** The QST body: the options, the recommendation and the answer section. */
+export declare const QUESTION_TEMPLATE: string;
+/** The body `add` writes for a decision without a description; placeholders are comments. */
+export declare function decisionSkeleton(title: string): string;
+/** The body `add` writes for a question without a description; placeholders are comments. */
+export declare function questionSkeleton(title: string): string;
+/** The skeleton `add` writes for a decision or question without a description, else undefined. */
+export declare function bodySkeleton(type: string, title: string): string | undefined;
+/** The text of the first H2+ section whose heading matches, bullets joined with `; `. */
+export declare function sectionText(markdown: string, heading: RegExp): string | undefined;
+/** The fields of a decision body: bullets first, then the matching section; empty ones left out. */
+export declare function parseDecisionFields(markdown: string): DecisionFields;
+/** The text of the `## Answer` section up to the next H1 or H2, or undefined when empty. */
+export declare function answerSection(markdown: string): string | undefined;
+/** The fields, options and answer of a question body; fields and options precede the answer. */
+export declare function parseQuestionFields(markdown: string): QuestionFields;
+/** A deviation is a decision tagged `deviation` (design v6.1 §1). */
+export declare function isDeviation(item: {
+    type: string;
+    tags: readonly string[];
+}): boolean;
+/** What a decision body lacks, one sentence each; empty when it is complete. */
+export declare function decisionFieldProblems(fields: DecisionFields, markdown?: string): string[];
+/** A decision body in the template's order: title, statement, then the fields that are set. */
+export declare function renderDecisionBody(input: {
+    title: string;
+    text?: string;
+    fields: DecisionFields;
+}): string;
+/** A question body: title, question, options, the recommendation, and the answer. */
+export declare function renderQuestionBody(input: {
+    title: string;
+    text?: string;
+    fields: Partial<Record<QuestionField, string>>;
+    options?: readonly QuestionOption[];
+    answer?: string;
+}): string;
+//# sourceMappingURL=decision-question.d.ts.map

package/dist/core/decision-question.d.ts.map

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