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

package/dist/core/decision-question.js

@@ -0,0 +1,203 @@
+/**
+ * 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 { markdownSections } from './epic-sections.js';
+/** Types outside the implements hierarchy: they link through relates-to, blocks or documents. */
+export const CROSS_CUTTING_TYPES = ['doc', 'decision', 'question'];
+/** True for doc, decision and question: exempt from the hierarchy and never an orphan. */
+export function isCrossCutting(type) {
+    return CROSS_CUTTING_TYPES.includes(type);
+}
+/** True for the two types whose body carries fields and whose statuses carry a meaning. */
+export function isDecisionOrQuestion(type) {
+    return type === 'decision' || type === 'question';
+}
+export const DECISION_FIELDS = ['Why', 'Rejected', 'Check'];
+export const QUESTION_FIELDS = ['Recommendation'];
+/** The tag that marks a decision as a deviation; its priority (eisenhower) ranks it. */
+export const DEVIATION_TAG = 'deviation';
+const DECISION_FIELD_HELP = {
+    Why: 'the rationale; for a deviation, the constraint it departs from',
+    Rejected: 'optional: the alternatives that lost, and why',
+    Check: 'optional: the test, lint or command that verifies it',
+};
+const RECOMMENDATION_HELP = 'the recommended option, and why';
+const PLACES = 'The paths it concerns go into affected_paths; the person who answers or owns it into assignee.';
+const OPTION_KEYS = ['a', 'b', 'c'];
+/** The DEC body fields as `add` returns them in its hint and a reminder carries them. */
+export const DECISION_TEMPLATE = [
+    ...DECISION_FIELDS.map((field) => `- ${field}: ${DECISION_FIELD_HELP[field]}`),
+    `A deviation carries the tag ${DEVIATION_TAG}, and its priority ranks it. ${PLACES}`,
+].join('\n');
+/** The QST body: the options, the recommendation and the answer section. */
+export const QUESTION_TEMPLATE = [
+    ...OPTION_KEYS.map((key) => `${key}) an option`),
+    `- Recommendation: ${RECOMMENDATION_HELP}`,
+    '## Answer, a section that names the chosen option and why; status done expects it',
+    PLACES,
+].join('\n');
+/** The body `add` writes for a decision without a description; placeholders are comments. */
+export function decisionSkeleton(title) {
+    const fields = DECISION_FIELDS.map((field) => `- ${field}: <!-- ${DECISION_FIELD_HELP[field]} -->`);
+    return `# ${title}\n\n<!-- The decision in one or two sentences. -->\n\n${fields.join('\n')}\n`;
+}
+/** The body `add` writes for a question without a description; placeholders are comments. */
+export function questionSkeleton(title) {
+    const lines = [
+        ...OPTION_KEYS.map((key) => `${key}) <!-- an option -->`),
+        `- Recommendation: <!-- ${RECOMMENDATION_HELP} -->`,
+    ];
+    return `# ${title}\n\n<!-- The question in one or two sentences. -->\n\n${lines.join('\n')}\n`;
+}
+/** The skeleton `add` writes for a decision or question without a description, else undefined. */
+export function bodySkeleton(type, title) {
+    if (type === 'decision')
+        return decisionSkeleton(title);
+    if (type === 'question')
+        return questionSkeleton(title);
+    return undefined;
+}
+/** Blank HTML comments and fenced code, so placeholders and examples never read as fields. */
+function readableLines(markdown) {
+    const lines = markdown
+        .replace(/<!--[\s\S]*?-->/g, (comment) => comment.replace(/[^\r\n]/g, ''))
+        .split(/\r?\n/);
+    let fence = false;
+    return lines.map((line) => {
+        if (/^\s*(```|~~~)/.test(line)) {
+            fence = !fence;
+            return '';
+        }
+        return fence ? '' : line;
+    });
+}
+/**
+ * Every `- Key: value` bullet, or `Key: value` line, with a value; the first occurrence of a key
+ * wins. Both forms are in use, and a decision written `Why: …` has its Why (EPIC-060).
+ */
+function parseBullets(lines) {
+    const fields = new Map();
+    for (const line of lines) {
+        const match = /^(?:- )?([A-Za-z]+):\s*(.*)$/.exec(line);
+        const value = match?.[2].trim();
+        if (match && value && !fields.has(match[1]))
+            fields.set(match[1], value);
+    }
+    return fields;
+}
+/** The headings a decision field falls back to when its bullet is absent (BUG-239). */
+const FIELD_SECTIONS = {
+    Why: /^(?:why|rationale)(?:\s*\([^\n)]+\)|\s*[:—–-]\s+.+)?$/i,
+    Rejected: /^(?:(?:considered )?options|alternatives|rejected(?: alternatives)?)$/i,
+    Check: /^(?:check|verification)$/i,
+};
+/** The text of the first H2+ section whose heading matches, bullets joined with `; `. */
+export function sectionText(markdown, heading) {
+    const body = readableLines(markdown).join('\n');
+    for (const section of markdownSections(body)) {
+        if (section.level < 2 || !heading.test(section.heading.trim()))
+            continue;
+        const lines = section.body
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+        const bullets = lines.some((line) => /^(?:[-*+]|\d+[.)])\s/.test(line));
+        const items = lines.map((line) => line.replace(/^(?:[-*+]|\d+[.)])\s+/, ''));
+        const text = items.join(bullets ? '; ' : ' ').trim();
+        if (text)
+            return text;
+    }
+    return undefined;
+}
+/** The fields of a decision body: bullets first, then the matching section; empty ones left out. */
+export function parseDecisionFields(markdown) {
+    const bullets = parseBullets(readableLines(markdown));
+    const fields = {};
+    for (const field of DECISION_FIELDS) {
+        const value = bullets.get(field) || sectionText(markdown, FIELD_SECTIONS[field]);
+        if (value)
+            fields[field] = value;
+    }
+    return fields;
+}
+const ANSWER_HEADING = /^##\s+Answer\s*$/i;
+/** The text of the `## Answer` section up to the next H1 or H2, or undefined when empty. */
+export function answerSection(markdown) {
+    const lines = readableLines(markdown);
+    const start = lines.findIndex((line) => ANSWER_HEADING.test(line));
+    if (start < 0)
+        return undefined;
+    const rest = lines.slice(start + 1);
+    const end = rest.findIndex((line) => /^#{1,2}\s/.test(line));
+    const text = (end < 0 ? rest : rest.slice(0, end)).join('\n').trim();
+    return text || undefined;
+}
+/** The fields, options and answer of a question body; fields and options precede the answer. */
+export function parseQuestionFields(markdown) {
+    const all = readableLines(markdown);
+    const answerAt = all.findIndex((line) => ANSWER_HEADING.test(line));
+    const lines = answerAt < 0 ? all : all.slice(0, answerAt);
+    const bullets = parseBullets(lines);
+    const result = { options: [] };
+    for (const field of QUESTION_FIELDS) {
+        const value = bullets.get(field);
+        if (value)
+            result[field] = value;
+    }
+    for (const line of lines) {
+        const match = /^(?:- )?([a-z])\)\s+(.*)$/.exec(line);
+        const text = match?.[2].trim();
+        if (match && text)
+            result.options.push({ key: match[1], text });
+    }
+    const answer = answerSection(markdown);
+    if (answer)
+        result.answer = answer;
+    return result;
+}
+/** A deviation is a decision tagged `deviation` (design v6.1 §1). */
+export function isDeviation(item) {
+    return item.type === 'decision' && item.tags.includes(DEVIATION_TAG);
+}
+/** What a decision body lacks, one sentence each; empty when it is complete. */
+export function decisionFieldProblems(fields, markdown) {
+    if (fields.Why)
+        return [];
+    if (markdown === undefined)
+        return ['Why is missing.'];
+    const readable = readableLines(markdown);
+    const at = readable.findIndex((line) => {
+        const heading = /^#{2,6}\s+(.+?)\s*#*\s*$/.exec(line);
+        return (/^(?:- )?Why:\s*/i.test(line) ||
+            (heading !== null && FIELD_SECTIONS.Why.test(heading[1].trim())));
+    });
+    const location = at >= 0
+        ? ` Empty rationale at line ${at + 1}: "${markdown.split(/\r?\n/)[at].trim().slice(0, 100)}".`
+        : ` No populated Why field or heading in lines 1-${readable.length}.`;
+    return [`Why is missing.${location}`];
+}
+/** A decision body in the template's order: title, statement, then the fields that are set. */
+export function renderDecisionBody(input) {
+    const fields = DECISION_FIELDS.filter((field) => input.fields[field]?.trim()).map((field) => `- ${field}: ${input.fields[field]?.trim()}`);
+    return joinBody(input.title, input.text, [fields]);
+}
+/** A question body: title, question, options, the recommendation, and the answer. */
+export function renderQuestionBody(input) {
+    const recommendation = input.fields.Recommendation?.trim();
+    const options = (input.options ?? []).map((option) => `${option.key}) ${option.text.trim()}`);
+    const answer = input.answer?.trim() ? [`## Answer\n\n${input.answer.trim()}`] : [];
+    return joinBody(input.title, input.text, [
+        [...options, ...(recommendation ? [`- Recommendation: ${recommendation}`] : [])],
+        answer,
+    ]);
+}
+function joinBody(title, text, blocks) {
+    const parts = [`# ${title}`, text?.trim() ?? '', ...blocks.map((block) => block.join('\n'))];
+    return `${parts.filter((part) => part.length > 0).join('\n\n')}\n`;
+}
+//# sourceMappingURL=decision-question.js.map

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

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

package/dist/core/decision-round-actions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Decision round actions (EPIC-060): answer and drop a question, accept and reject a decision.
+ * Each is one `updateItem` with a plain status, never refused for the status the item is in
+ * (DEC-004), and returns the warnings of the update. An answer is the chosen option and the
+ * free text in an `## Answer` section (DEC-049); a question that already has one gets it
+ * replaced, so the section stays single. The prompt hands the round to the decision-round skill.
+ */
+import type { ItemStatus } from '../schemas/index.js';
+import type { RoundOption } from './decision-round-types.js';
+export type RoundIntentKind = 'answer' | 'drop' | 'accept' | 'reject';
+export type RoundIntent = {
+    kind: 'answer';
+    id: string;
+    option?: string;
+    text?: string;
+} | {
+    kind: 'drop' | 'accept' | 'reject';
+    id: string;
+};
+export interface RoundActionResult {
+    id: string;
+    kind: RoundIntentKind;
+    status: ItemStatus;
+    /** The in-band warnings of the update, empty when it has none. */
+    warnings: string[];
+}
+/** An intent that does not fit its item: wrong type, an unknown option, an empty answer. */
+export declare class RoundIntentError extends Error {
+    constructor(message: string);
+}
+/** The skill that turns a round's answers into decisions. */
+export declare const DECISION_ROUND_SKILL = "sdevsteps-decision-round";
+/** The longest free text an answer carries. */
+export declare const ANSWER_TEXT_MAX = 4000;
+/** The text of an answer: `b) option text`, the free text, or both. */
+export declare function answerText(options: readonly RoundOption[], option: string | undefined, text: string | undefined): string;
+/** The body with its `## Answer` section's text replaced, or undefined when it has none. */
+export declare function replaceAnswerSection(markdown: string, answer: string): string | undefined;
+/**
+ * Apply one round intent as a plain status update. A write that meets another writer's change
+ * (STORY-428) is read and applied once more, because a round runs while Claude writes items.
+ */
+export declare function applyRoundIntent(devstepsDir: string, intent: RoundIntent): Promise<RoundActionResult>;
+/** The prompt a chat without a monitor gets: run the skill over the answers of the round. */
+export declare function decisionRoundPrompt(scope?: string): string;
+//# sourceMappingURL=decision-round-actions.d.ts.map

package/dist/core/decision-round-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-round-actions.d.ts","sourceRoot":"","sources":["../../src/core/decision-round-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAI7D,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4FAA4F;AAC5F,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAE/D,+CAA+C;AAC/C,eAAO,MAAM,eAAe,OAAO,CAAC;AAWpC,uEAAuE;AACvE,wBAAgB,UAAU,CACxB,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,CAYR;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQzF;AAqCD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAO5B;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAO1D"}

package/dist/core/decision-round-actions.js

@@ -0,0 +1,114 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Decision round actions (EPIC-060): answer and drop a question, accept and reject a decision.
+ * Each is one `updateItem` with a plain status, never refused for the status the item is in
+ * (DEC-004), and returns the warnings of the update. An answer is the chosen option and the
+ * free text in an `## Answer` section (DEC-049); a question that already has one gets it
+ * replaced, so the section stays single. The prompt hands the round to the decision-round skill.
+ */
+import { questionOptions } from './decision-round-text.js';
+import { readItem, StaleItemError } from './item-store.js';
+import { updateItem } from './update.js';
+/** An intent that does not fit its item: wrong type, an unknown option, an empty answer. */
+export class RoundIntentError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RoundIntentError';
+    }
+}
+/** The skill that turns a round's answers into decisions. */
+export const DECISION_ROUND_SKILL = 'sdevsteps-decision-round';
+/** The longest free text an answer carries. */
+export const ANSWER_TEXT_MAX = 4000;
+const TARGETS = {
+    answer: { type: 'question', status: 'done' },
+    drop: { type: 'question', status: 'cancelled' },
+    accept: { type: 'decision', status: 'done' },
+    reject: { type: 'decision', status: 'cancelled' },
+};
+const ANSWER_HEADING = /^##\s+Answer\s*$/i;
+/** The text of an answer: `b) option text`, the free text, or both. */
+export function answerText(options, option, text) {
+    const chosen = option ? options.find((candidate) => candidate.key === option) : undefined;
+    if (option && !chosen)
+        throw new RoundIntentError(`The question has no option ${option}).`);
+    const raw = (text ?? '').trim();
+    if (raw.length > ANSWER_TEXT_MAX) {
+        throw new RoundIntentError(`An answer carries at most ${ANSWER_TEXT_MAX} characters of text.`);
+    }
+    // A line of free text that starts with `#` stays text: as a heading it would end the section.
+    const note = raw.replace(/^(\s*)(#)/gm, '$1\\$2');
+    const answer = [chosen ? `${chosen.key}) ${chosen.text}` : '', note].filter(Boolean).join('\n\n');
+    if (!answer)
+        throw new RoundIntentError('An answer names an option or carries text.');
+    return answer;
+}
+/** The body with its `## Answer` section's text replaced, or undefined when it has none. */
+export function replaceAnswerSection(markdown, answer) {
+    const lines = markdown.replace(/\r\n?/g, '\n').split('\n');
+    const start = lines.findIndex((line) => ANSWER_HEADING.test(line));
+    if (start < 0)
+        return undefined;
+    const rest = lines.slice(start + 1);
+    const next = rest.findIndex((line) => /^#{1,2}\s/.test(line));
+    const tail = next < 0 ? [] : ['', ...rest.slice(next)];
+    return [...lines.slice(0, start + 1), '', answer, ...tail].join('\n').replace(/\n*$/, '\n');
+}
+/** The description patch of an answer: a replaced section, or one appended after a blank line. */
+function answerPatch(description, answer) {
+    const replaced = replaceAnswerSection(description, answer);
+    if (replaced !== undefined)
+        return { description: replaced };
+    const gap = description.endsWith('\n\n') ? '' : description.endsWith('\n') ? '\n' : '\n\n';
+    return { append_description: `${description ? gap : ''}## Answer\n\n${answer}\n` };
+}
+async function applyOnce(devstepsDir, intent) {
+    const target = TARGETS[intent.kind];
+    const item = readItem(devstepsDir, intent.id);
+    const { type } = item.metadata;
+    if (type !== target.type) {
+        throw new RoundIntentError(`${intent.id} is a ${type}; ${intent.kind} applies to a ${target.type}.`);
+    }
+    const args = { id: intent.id, status: target.status };
+    if (intent.kind === 'answer') {
+        const answer = answerText(questionOptions(item.description), intent.option, intent.text);
+        Object.assign(args, answerPatch(item.description, answer));
+    }
+    // BUG-199: the update refuses when the item changed after this read, so the answer is
+    // rebuilt on the fresh description instead of overwriting the other writer's change.
+    const result = await updateItem(devstepsDir, args, {
+        expected: { metadata: item.stamp, description: item.descriptionStamp },
+    });
+    return {
+        id: intent.id,
+        kind: intent.kind,
+        status: result.metadata.status,
+        warnings: result.warnings ?? [],
+    };
+}
+/**
+ * Apply one round intent as a plain status update. A write that meets another writer's change
+ * (STORY-428) is read and applied once more, because a round runs while Claude writes items.
+ */
+export async function applyRoundIntent(devstepsDir, intent) {
+    try {
+        return await applyOnce(devstepsDir, intent);
+    }
+    catch (error) {
+        if (!(error instanceof StaleItemError))
+            throw error;
+        return applyOnce(devstepsDir, intent);
+    }
+}
+/** The prompt a chat without a monitor gets: run the skill over the answers of the round. */
+export function decisionRoundPrompt(scope) {
+    const round = scope ? `the decision round of ${scope}` : 'the decision round';
+    return [
+        `Evaluate ${round} with the ${DECISION_ROUND_SKILL} skill.`,
+        'Turn each answered question without a linked decision into a decision, link it, and update the recommendations of the questions that depend on it.',
+        'Then summarise the round, propose follow-up items for my approval, and list conflicts of the accepted decisions with each other and with the epic constraints.',
+    ].join(' ');
+}
+//# sourceMappingURL=decision-round-actions.js.map

package/dist/core/decision-round-actions.js.map

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

package/dist/core/decision-round-owner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Where a decision or question belongs in a decision round (EPIC-060), and what applies there.
+ * The owner is the most specific epic or story it is linked to: a story, spike or feature before
+ * an epic or requirement, the lowest ID within a level, and a linked task, bug or test stands for
+ * the nearest of them on its implements chain. The compass of a group is the owner chain's source
+ * sections and accepted decisions, the parts of the compass block a card adds to the round.
+ */
+import type { ItemMetadata, ItemType } from '../schemas/index.js';
+import type { RoundCompass, RoundRef } from './decision-round-types.js';
+/** The accepted decisions a group compass lists at most. */
+export declare const ROUND_COMPASS_DECISIONS_MAX = 5;
+export type MetadataReader = (id: string) => ItemMetadata | undefined;
+/** A reader over the item store that remembers each answer for one round build. */
+export declare function metadataReader(devstepsDir: string): MetadataReader;
+export declare function roundRef(item: ItemMetadata): RoundRef;
+export declare function ownerLevel(type: ItemType): number | undefined;
+/** Every owner an item is linked to, the one its group follows first. */
+export declare function ownerCandidates(devstepsDir: string, read: MetadataReader, item: ItemMetadata): ItemMetadata[];
+/** The owner first, then its implements chain up to the top item. */
+export declare function ownerChain(devstepsDir: string, owner: ItemMetadata): ItemMetadata[];
+/**
+ * What applies to a group's items: the constraint and out-of-scope lines of the owner chain's top
+ * item, capped as in the compass block, and its accepted decisions; undefined when none apply.
+ */
+export declare function groupCompass(devstepsDir: string, chain: readonly ItemMetadata[]): RoundCompass | undefined;
+//# sourceMappingURL=decision-round-owner.d.ts.map

package/dist/core/decision-round-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-round-owner.d.ts","sourceRoot":"","sources":["../../src/core/decision-round-owner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKlE,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAgBxE,4DAA4D;AAC5D,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;AAEtE,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAYlE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAErD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAE7D;AAoBD,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,YAAY,GACjB,YAAY,EAAE,CAYhB;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,CAEnF;AAuBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,YAAY,GAAG,SAAS,CAwB1B"}

package/dist/core/decision-round-owner.js

@@ -0,0 +1,130 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Where a decision or question belongs in a decision round (EPIC-060), and what applies there.
+ * The owner is the most specific epic or story it is linked to: a story, spike or feature before
+ * an epic or requirement, the lowest ID within a level, and a linked task, bug or test stands for
+ * the nearest of them on its implements chain. The compass of a group is the owner chain's source
+ * sections and accepted decisions, the parts of the compass block a card adds to the round.
+ */
+import { parseItemId } from '../utils/index.js';
+import { COMPASS_MAX_CONSTRAINTS, COMPASS_MAX_OUT_OF_SCOPE } from './compass.js';
+import { linkedDecisionsAndQuestions, walkCompassChain } from './compass-chain.js';
+import { isDeviation } from './decision-question.js';
+import { findEpicSection, sectionLines } from './epic-sections.js';
+import { readItem, readItemMetadata } from './item-store.js';
+/** Owner levels: 0 is a story, spike or feature, 1 an epic or requirement. */
+const OWNER_LEVELS = {
+    story: 0,
+    spike: 0,
+    feature: 0,
+    epic: 1,
+    requirement: 1,
+};
+/** Linked types that stand for the owner on their implements chain. */
+const WALK_UP_TYPES = ['task', 'bug', 'test'];
+/** The accepted decisions a group compass lists at most. */
+export const ROUND_COMPASS_DECISIONS_MAX = 5;
+/** A reader over the item store that remembers each answer for one round build. */
+export function metadataReader(devstepsDir) {
+    const cache = new Map();
+    return (id) => {
+        if (!cache.has(id)) {
+            try {
+                cache.set(id, readItemMetadata(devstepsDir, id).metadata);
+            }
+            catch {
+                cache.set(id, null);
+            }
+        }
+        return cache.get(id) ?? undefined;
+    };
+}
+export function roundRef(item) {
+    return { id: item.id, type: item.type, title: item.title, status: item.status };
+}
+export function ownerLevel(type) {
+    return OWNER_LEVELS[type];
+}
+function idNumber(id) {
+    return parseItemId(id)?.number ?? Number.MAX_SAFE_INTEGER;
+}
+function compareOwners(a, b) {
+    const level = (ownerLevel(a.type) ?? 9) - (ownerLevel(b.type) ?? 9);
+    if (level !== 0)
+        return level;
+    const number = idNumber(a.id) - idNumber(b.id);
+    return number !== 0 ? number : a.id.localeCompare(b.id);
+}
+/** The nearest owner on the implements chain of a linked task, bug or test. */
+function nearestOwner(devstepsDir, item) {
+    if (!WALK_UP_TYPES.includes(item.type))
+        return undefined;
+    const chain = walkCompassChain(devstepsDir, item).items.slice(1);
+    return chain.find((member) => ownerLevel(member.type) !== undefined);
+}
+/** Every owner an item is linked to, the one its group follows first. */
+export function ownerCandidates(devstepsDir, read, item) {
+    const found = new Map();
+    for (const ids of Object.values(item.linked_items)) {
+        for (const id of ids ?? []) {
+            const linked = read(id);
+            if (!linked)
+                continue;
+            const owner = ownerLevel(linked.type) !== undefined ? linked : nearestOwner(devstepsDir, linked);
+            if (owner && owner.id !== item.id)
+                found.set(owner.id, owner);
+        }
+    }
+    return [...found.values()].sort(compareOwners);
+}
+/** The owner first, then its implements chain up to the top item. */
+export function ownerChain(devstepsDir, owner) {
+    return walkCompassChain(devstepsDir, owner).items;
+}
+function descriptionOf(devstepsDir, id) {
+    try {
+        return readItem(devstepsDir, id).description;
+    }
+    catch {
+        return '';
+    }
+}
+function acceptedDecisions(devstepsDir, chain) {
+    return linkedDecisionsAndQuestions(devstepsDir, chain)
+        .map((record) => record.metadata)
+        .filter((metadata) => metadata.type === 'decision' && metadata.status === 'done')
+        .sort((a, b) => a.updated === b.updated ? idNumber(b.id) - idNumber(a.id) : a.updated < b.updated ? 1 : -1)
+        .map((metadata) => ({ ...roundRef(metadata), deviation: isDeviation(metadata) }));
+}
+/**
+ * What applies to a group's items: the constraint and out-of-scope lines of the owner chain's top
+ * item, capped as in the compass block, and its accepted decisions; undefined when none apply.
+ */
+export function groupCompass(devstepsDir, chain) {
+    const top = chain[chain.length - 1];
+    if (!top)
+        return undefined;
+    const description = descriptionOf(devstepsDir, top.id);
+    const lines = (key) => sectionLines(findEpicSection(description, key)?.body ?? '');
+    const constraints = lines('constraints');
+    const outOfScope = lines('out-of-scope');
+    const decisions = acceptedDecisions(devstepsDir, chain);
+    if (constraints.length + outOfScope.length + decisions.length === 0)
+        return undefined;
+    const more = Math.max(0, constraints.length - COMPASS_MAX_CONSTRAINTS) +
+        Math.max(0, outOfScope.length - COMPASS_MAX_OUT_OF_SCOPE) +
+        Math.max(0, decisions.length - ROUND_COMPASS_DECISIONS_MAX);
+    return {
+        source: roundRef(top),
+        via: chain.slice(1, -1).map((member) => member.id),
+        constraints: constraints
+            .slice(0, COMPASS_MAX_CONSTRAINTS)
+            .map((line) => (line.check ? { text: line.text, check: line.check } : { text: line.text })),
+        outOfScope: outOfScope.slice(0, COMPASS_MAX_OUT_OF_SCOPE).map((line) => line.text),
+        decisions: decisions.slice(0, ROUND_COMPASS_DECISIONS_MAX),
+        more,
+    };
+}
+//# sourceMappingURL=decision-round-owner.js.map

package/dist/core/decision-round-owner.js.map

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

package/dist/core/decision-round-text.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * The card texts of a decision round (EPIC-060), read from a question or decision body: the
+ * prose before the fields, the options with their consequences, the option a recommendation
+ * names, the evidence lines, and the decision fields. The field parsing itself is
+ * `decision-question.ts`; this module adds what a card shows beside the fields.
+ */
+import type { RoundOption } from './decision-round-types.js';
+/** The longest text a card carries for one field; the item itself holds the rest. */
+export declare const ROUND_TEXT_MAX = 2000;
+/** The evidence lines a question card shows at most. */
+export declare const ROUND_SOURCES_MAX = 8;
+/** The question in prose: the body before its options and fields. */
+export declare function questionText(markdown: string): string | undefined;
+/** The options of a question, each with the consequence it names split off. */
+export declare function questionOptions(markdown: string): RoundOption[];
+/** The option key a recommendation names first (`b)`, `b.`, `b,` or `b ` …), if it is one. */
+export declare function recommendedOption(recommendation: string | undefined, options: readonly RoundOption[]): string | undefined;
+/** The evidence of a question: an Evidence or Sources section, and `Source:` lines. */
+export declare function questionSources(markdown: string): string[];
+export interface QuestionCardText {
+    text?: string;
+    options: RoundOption[];
+    recommendation?: string;
+    recommended?: string;
+    sources: string[];
+}
+/** Everything a question card shows from the body. */
+export declare function questionCardText(markdown: string): QuestionCardText;
+export interface DecisionCardText {
+    text?: string;
+    deviates?: string;
+    why?: string;
+    rejected?: string;
+    check?: string;
+    sources: string[];
+    consequences?: string;
+}
+/** Everything a decision card shows from the body: the decision, Deviates and the fields. */
+export declare function decisionCardText(markdown: string): DecisionCardText;
+//# sourceMappingURL=decision-round-text.d.ts.map

package/dist/core/decision-round-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-round-text.d.ts","sourceRoot":"","sources":["../../src/core/decision-round-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,qFAAqF;AACrF,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAyDnC,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ/D;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,MAAM,GAAG,SAAS,CAGpB;AAUD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAe1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAYnE;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAoBnE"}