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

package/dist/core/workflow-v2-loader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Loader for compiled workflow definitions (schema_version "2.0") on TEST and TASK items.
+ * Checks the item contract; the compiler checks the definition itself.
+ */
+import type { GetItemResult } from './get.js';
+export declare class WorkflowV2LoadError extends Error {
+    readonly code: 'NOT_WORKFLOW_ITEM' | 'MISSING_DEFINITION' | 'MISSING_TEST_SCOPE';
+    constructor(code: WorkflowV2LoadError['code'], message: string);
+}
+export type LoadedWorkflowV2Item = Readonly<{
+    item: GetItemResult;
+    definitionId: string;
+    /** Authored definition as stored; compile it for a host profile before use. */
+    rawDefinition: unknown;
+    /** `metadata.workflow_revision` when the item pins one. */
+    pinnedRevision?: string;
+}>;
+/** The persisted contract is `process_definition`; the early nested spelling stays readable. */
+export declare function authoredWorkflowDefinition(item: GetItemResult): unknown;
+export declare function workflowSchemaVersionOf(definition: unknown): string | undefined;
+export declare function isWorkflowV2Item(item: GetItemResult): boolean;
+export declare function loadWorkflowV2Item(item: GetItemResult): LoadedWorkflowV2Item;
+//# sourceMappingURL=workflow-v2-loader.d.ts.map

package/dist/core/workflow-v2-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-loader.d.ts","sourceRoot":"","sources":["../../src/core/workflow-v2-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,IAAI,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;IAExF,YAAmB,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAIpE;CACF;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,gGAAgG;AAChG,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,CA6B5E"}

package/dist/core/workflow-v2-loader.js

@@ -0,0 +1,50 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Loader for compiled workflow definitions (schema_version "2.0") on TEST and TASK items.
+ * Checks the item contract; the compiler checks the definition itself.
+ */
+export class WorkflowV2LoadError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'WorkflowV2LoadError';
+        this.code = code;
+    }
+}
+/** The persisted contract is `process_definition`; the early nested spelling stays readable. */
+export function authoredWorkflowDefinition(item) {
+    return item.metadata.process_definition ?? item.metadata.metadata?.workflow_definition;
+}
+export function workflowSchemaVersionOf(definition) {
+    if (!definition || typeof definition !== 'object')
+        return undefined;
+    const version = definition.schema_version;
+    return typeof version === 'string' ? version : undefined;
+}
+export function isWorkflowV2Item(item) {
+    return workflowSchemaVersionOf(authoredWorkflowDefinition(item)) === '2.0';
+}
+export function loadWorkflowV2Item(item) {
+    const { id, type } = item.metadata;
+    if (type !== 'test' && type !== 'task') {
+        throw new WorkflowV2LoadError('NOT_WORKFLOW_ITEM', `Item ${id} is a ${type}; workflow definitions live on TEST or TASK items`);
+    }
+    if (type === 'test' && item.metadata.linked_items.tests.length === 0) {
+        throw new WorkflowV2LoadError('MISSING_TEST_SCOPE', `TEST ${id} must declare direct tests relationships`);
+    }
+    const rawDefinition = authoredWorkflowDefinition(item);
+    if (workflowSchemaVersionOf(rawDefinition) !== '2.0') {
+        throw new WorkflowV2LoadError('MISSING_DEFINITION', `${id} has no workflow definition with schema_version "2.0"`);
+    }
+    const revision = item.metadata.metadata
+        ?.workflow_revision;
+    return {
+        item,
+        definitionId: id,
+        rawDefinition,
+        pinnedRevision: typeof revision === 'string' && revision.length > 0 ? revision : undefined,
+    };
+}
+//# sourceMappingURL=workflow-v2-loader.js.map

package/dist/core/workflow-v2-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-loader.js","sourceRoot":"","sources":["../../src/core/workflow-v2-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5B,IAAI,CAAoE;IAExF,YAAmB,IAAiC,EAAE,OAAe;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAWD,gGAAgG;AAChG,MAAM,UAAU,0BAA0B,CAAC,IAAmB;IAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAmB;IACzD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpE,MAAM,OAAO,GAAI,UAAsC,CAAC,cAAc,CAAC;IACvE,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,OAAO,uBAAuB,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAmB;IACpD,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;IACnC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,MAAM,IAAI,mBAAmB,CAC3B,mBAAmB,EACnB,QAAQ,EAAE,SAAS,IAAI,mDAAmD,CAC3E,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,mBAAmB,CAC3B,oBAAoB,EACpB,QAAQ,EAAE,0CAA0C,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,uBAAuB,CAAC,aAAa,CAAC,KAAK,KAAK,EAAE,CAAC;QACrD,MAAM,IAAI,mBAAmB,CAC3B,oBAAoB,EACpB,GAAG,EAAE,uDAAuD,CAC7D,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAQ,CAAC,QAAgD;QAC9E,EAAE,iBAAiB,CAAC;IACtB,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,EAAE;QAChB,aAAa;QACb,cAAc,EAAE,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC3F,CAAC;AACJ,CAAC"}

package/dist/core/write-diagnostics.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Write-time diagnostics (EPIC-059): pure rules that read an item as add or update leaves it and
+ * answer with a reminder. They never refuse a write; their messages go into the warnings.
+ */
+import type { ItemStatus } from '../schemas/index.js';
+export type WriteDiagnosticCode = 'EPIC_SECTIONS' | 'STORY_SECTIONS' | 'APPROACH_SECTION' | 'BATCH_RUN' | 'TITLE_LENGTH';
+export interface WriteDiagnostic {
+    code: WriteDiagnosticCode;
+    message: string;
+}
+/** An item as the write leaves it, with what the write changed. */
+export interface WriteEvent {
+    operation: 'add' | 'update';
+    item: {
+        id: string;
+        type: string;
+        status: ItemStatus;
+        title?: string;
+    };
+    /** True when the write set the title; always true on add. Absent skips TITLE_LENGTH. */
+    titleChanged?: boolean;
+    /** The status before an update; absent on add. */
+    previousStatus?: ItemStatus;
+    /** The master document as it reads after the write. */
+    description: string;
+    /** True when the write set or appended the description; always true on add. */
+    descriptionChanged: boolean;
+    /** Nonempty appended findings distinguish a reviewer reopen from an engineer start. */
+    descriptionAppended?: boolean;
+    /** Every work item in review after the write, this one included; absent skips BATCH_RUN. */
+    reviewQueue?: readonly string[];
+}
+export type WriteRule = (event: WriteEvent) => WriteDiagnostic | null;
+/** True when an update moved the item to `status`; add never moves. */
+export declare function enteredStatus(event: WriteEvent, status: ItemStatus): boolean;
+/** A work item counted in a review batch: decisions, questions and docs are left out. */
+export declare function isBatchWorkItem(type: string): boolean;
+/**
+ * EPIC_SECTIONS: an epic names its missing template sections when it is added, when its
+ * description changes, and when it moves to an open status. Closing an epic stays quiet.
+ */
+export declare const epicSectionsRule: WriteRule;
+/**
+ * STORY_SECTIONS: a story written from the story template names the required parts it still
+ * leaves empty — its opening user story and its acceptance criteria — when it is added and when
+ * its description changes. A story in its own words, and every status change, stay quiet.
+ */
+export declare const storySectionsRule: WriteRule;
+/** True when the document holds a heading named Approach, at any level, with content. */
+export declare function hasApproachSection(markdown: string): boolean;
+/** APPROACH_SECTION: a story, task or bug moved to in-progress without an Approach section. */
+export declare const approachSectionRule: WriteRule;
+/** BATCH_RUN for a queue of review items: one reminder once two or more wait together. */
+export declare function batchRunDiagnostic(queue: readonly string[]): WriteDiagnostic | null;
+/** BATCH_RUN: a work item moved to review while other work items already wait there. */
+export declare const batchRunRule: WriteRule;
+/** Above this many code points a title reads as more than a headline (STORY-504). */
+export declare const TITLE_WARN_LENGTH = 100;
+/** TITLE_LENGTH: a title set by add or update that runs past a headline; it never refuses. */
+export declare const titleLengthRule: WriteRule;
+/** The rules add and update run, in the order their messages appear. */
+export declare const WRITE_RULES: readonly WriteRule[];
+export declare function writeDiagnostics(event: WriteEvent, rules?: readonly WriteRule[]): WriteDiagnostic[];
+/** The diagnostics as the warning strings add and update return. */
+export declare function diagnosticMessages(diagnostics: readonly WriteDiagnostic[]): string[];
+//# sourceMappingURL=write-diagnostics.d.ts.map

package/dist/core/write-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/write-diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBtD,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,WAAW,GACX,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,wFAAwF;IACxF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,eAAe,GAAG,IAAI,CAAC;AAKtE,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAI5E;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAS9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAU/B,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK5D;AAED,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,EAAE,SASjC,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,GAAG,IAAI,CAEnF;AAED,wFAAwF;AACxF,eAAO,MAAM,YAAY,EAAE,SAI1B,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,MAAM,CAAC;AASrC,8FAA8F;AAC9F,eAAO,MAAM,eAAe,EAAE,SAO7B,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAM3C,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,KAAK,GAAE,SAAS,SAAS,EAAgB,GACxC,eAAe,EAAE,CAInB;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,EAAE,CAEpF"}

package/dist/core/write-diagnostics.js

@@ -0,0 +1,126 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Write-time diagnostics (EPIC-059): pure rules that read an item as add or update leaves it and
+ * answer with a reminder. They never refuse a write; their messages go into the warnings.
+ */
+import { approachReminder, batchRunReminder, epicSectionsReminder, storySectionsReminder, titleLengthReminder, } from '../templates/reminders.js';
+import { STORY_SECTIONS, STORY_TEMPLATE_MARKER } from '../templates/story.js';
+import { isCrossCutting } from './decision-question.js';
+import { hasContent, markdownSections, missingEpicSections, missingSections, normalizeHeading, openingText, } from './epic-sections.js';
+const TERMINAL = ['done', 'cancelled', 'obsolete'];
+const APPROACH_TYPES = ['story', 'task', 'bug'];
+/** True when an update moved the item to `status`; add never moves. */
+export function enteredStatus(event, status) {
+    return (event.operation === 'update' && event.item.status === status && event.previousStatus !== status);
+}
+/** A work item counted in a review batch: decisions, questions and docs are left out. */
+export function isBatchWorkItem(type) {
+    return !isCrossCutting(type);
+}
+/**
+ * EPIC_SECTIONS: an epic names its missing template sections when it is added, when its
+ * description changes, and when it moves to an open status. Closing an epic stays quiet.
+ */
+export const epicSectionsRule = (event) => {
+    if (event.item.type !== 'epic')
+        return null;
+    const statusChanged = event.operation === 'update' && event.previousStatus !== event.item.status;
+    const opened = statusChanged && !TERMINAL.includes(event.item.status);
+    if (event.operation === 'update' && !event.descriptionChanged && !opened)
+        return null;
+    const missing = missingEpicSections(event.description);
+    if (missing.length === 0)
+        return null;
+    const headings = missing.map((spec) => spec.heading);
+    return { code: 'EPIC_SECTIONS', message: epicSectionsReminder(event.item.id, headings) };
+};
+/**
+ * STORY_SECTIONS: a story written from the story template names the required parts it still
+ * leaves empty — its opening user story and its acceptance criteria — when it is added and when
+ * its description changes. A story in its own words, and every status change, stay quiet.
+ */
+export const storySectionsRule = (event) => {
+    if (event.item.type !== 'story')
+        return null;
+    if (event.operation === 'update' && !event.descriptionChanged)
+        return null;
+    if (!event.description.includes(STORY_TEMPLATE_MARKER))
+        return null;
+    const empty = [
+        ...(openingText(event.description) === '' ? ['the opening user story'] : []),
+        ...missingSections(event.description, STORY_SECTIONS).map((spec) => spec.heading),
+    ];
+    if (empty.length === 0)
+        return null;
+    return { code: 'STORY_SECTIONS', message: storySectionsReminder(event.item.id, empty) };
+};
+/** True when the document holds a heading named Approach, at any level, with content. */
+export function hasApproachSection(markdown) {
+    return markdownSections(markdown).some((section) => {
+        const heading = normalizeHeading(section.heading);
+        return (heading === 'approach' || heading.startsWith('approach ')) && hasContent(section);
+    });
+}
+/** APPROACH_SECTION: a story, task or bug moved to in-progress without an Approach section. */
+export const approachSectionRule = (event) => {
+    if (!APPROACH_TYPES.includes(event.item.type) || !enteredStatus(event, 'in-progress')) {
+        return null;
+    }
+    if (event.descriptionAppended && ['review', 'done'].includes(event.previousStatus ?? '')) {
+        return null;
+    }
+    if (hasApproachSection(event.description))
+        return null;
+    return { code: 'APPROACH_SECTION', message: approachReminder(event.item.id) };
+};
+/** BATCH_RUN for a queue of review items: one reminder once two or more wait together. */
+export function batchRunDiagnostic(queue) {
+    return queue.length > 1 ? { code: 'BATCH_RUN', message: batchRunReminder(queue) } : null;
+}
+/** BATCH_RUN: a work item moved to review while other work items already wait there. */
+export const batchRunRule = (event) => {
+    if (!event.reviewQueue || !isBatchWorkItem(event.item.type))
+        return null;
+    if (!enteredStatus(event, 'review'))
+        return null;
+    return batchRunDiagnostic(event.reviewQueue);
+};
+/** Above this many code points a title reads as more than a headline (STORY-504). */
+export const TITLE_WARN_LENGTH = 100;
+const TITLE_OVERFLOW = [
+    [/\bso that\b/i, 'the "so that" clause'],
+    [/\band\b/i, 'the list joined with "and"'],
+    [/[()]/, 'the parentheses'],
+    [/\b(or|vs|versus)\b/i, 'the options'],
+];
+/** TITLE_LENGTH: a title set by add or update that runs past a headline; it never refuses. */
+export const titleLengthRule = (event) => {
+    const title = event.item.title;
+    if (!event.titleChanged || title === undefined)
+        return null;
+    const length = [...title].length;
+    if (length <= TITLE_WARN_LENGTH)
+        return null;
+    const parts = TITLE_OVERFLOW.filter(([pattern]) => pattern.test(title)).map(([, part]) => part);
+    return { code: 'TITLE_LENGTH', message: titleLengthReminder(event.item.id, length, parts) };
+};
+/** The rules add and update run, in the order their messages appear. */
+export const WRITE_RULES = [
+    titleLengthRule,
+    epicSectionsRule,
+    storySectionsRule,
+    approachSectionRule,
+    batchRunRule,
+];
+export function writeDiagnostics(event, rules = WRITE_RULES) {
+    return rules
+        .map((rule) => rule(event))
+        .filter((found) => found !== null);
+}
+/** The diagnostics as the warning strings add and update return. */
+export function diagnosticMessages(diagnostics) {
+    return diagnostics.map((diagnostic) => diagnostic.message);
+}
+//# sourceMappingURL=write-diagnostics.js.map

package/dist/core/write-diagnostics.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
  * Licensed under the Apache License, Version 2.0
  *
  * Shared package public API
@@ -8,7 +8,13 @@
 export * from './constants/index.js';
 export { HIERARCHY_TYPE, ITEM_TYPE, METHODOLOGY, RELATIONSHIP_TYPE, STATUS, } from './constants/index.js';
 export * from './core/index.js';
+export * from './runtime/index.js';
 export * from './schemas/index.js';
+export * from './templates/diataxis.js';
+export * from './templates/epic.js';
+export * from './templates/madr.js';
+export * from './templates/reminders.js';
+export * from './templates/task-workflow.js';
 export * from './types/index.js';
 export * from './utils/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
  * Licensed under the Apache License, Version 2.0
  *
  * Shared package public API
@@ -8,7 +8,13 @@
 export * from './constants/index.js';
 export { HIERARCHY_TYPE, ITEM_TYPE, METHODOLOGY, RELATIONSHIP_TYPE, STATUS, } from './constants/index.js';
 export * from './core/index.js';
+export * from './runtime/index.js';
 export * from './schemas/index.js';
+export * from './templates/diataxis.js';
+export * from './templates/epic.js';
+export * from './templates/madr.js';
+export * from './templates/reminders.js';
+export * from './templates/task-workflow.js';
 export * from './types/index.js';
 export * from './utils/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/runtime/controls.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Runtime execution controls
+ * Owns retry limits, stale-run detection, and parallel-run policy.
+ * These checks protect a run before a caller attempts another transition.
+ */
+import type { ProcessDefinition, ProcessRun } from './index.js';
+export declare class RuntimeControlError extends Error {
+    readonly code: 'RETRY_EXHAUSTED' | 'PARALLEL_RUN' | 'STALE_RUN';
+    constructor(code: RuntimeControlError['code'], message: string);
+}
+export type RunFreshness = Readonly<{
+    current: boolean;
+    reason?: 'definition_revision' | 'definition_digest' | 'workspace_fingerprint';
+}>;
+export declare function checkRunFreshness(run: ProcessRun, expected: Readonly<{
+    definitionRevision: string;
+    definitionDigest: string;
+    workspaceFingerprint: string;
+}>): RunFreshness;
+export declare function prepareRetry(definition: ProcessDefinition, run: ProcessRun, updatedAt: string): ProcessRun;
+export declare function markRunStale(run: ProcessRun, reason: string, updatedAt: string): ProcessRun;
+export declare function assertParallelRunAllowed(definition: ProcessDefinition, activeRuns: readonly ProcessRun[]): void;
+//# sourceMappingURL=controls.d.ts.map

package/dist/runtime/controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.d.ts","sourceRoot":"","sources":["../../src/runtime/controls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGhE,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,IAAI,EAAE,iBAAiB,GAAG,cAAc,GAAG,WAAW,CAAC;IAEvE,YAAmB,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAIpE;CACF;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,uBAAuB,CAAC;CAChF,CAAC,CAAC;AAEH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC,GACD,YAAY,CAWd;AAED,wBAAgB,YAAY,CAC1B,UAAU,EAAE,iBAAiB,EAC7B,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,MAAM,GAChB,UAAU,CAYZ;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAK3F;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,EAC7B,UAAU,EAAE,SAAS,UAAU,EAAE,GAChC,IAAI,CAON"}

package/dist/runtime/controls.js

@@ -0,0 +1,54 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Runtime execution controls
+ * Owns retry limits, stale-run detection, and parallel-run policy.
+ * These checks protect a run before a caller attempts another transition.
+ */
+import { sameWorkspaceFingerprint } from './workspace-fingerprint.js';
+export class RuntimeControlError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'RuntimeControlError';
+        this.code = code;
+    }
+}
+export function checkRunFreshness(run, expected) {
+    if (run.definition_revision !== expected.definitionRevision) {
+        return { current: false, reason: 'definition_revision' };
+    }
+    if (run.definition_digest !== expected.definitionDigest) {
+        return { current: false, reason: 'definition_digest' };
+    }
+    if (!sameWorkspaceFingerprint(run.workspace_fingerprint, expected.workspaceFingerprint)) {
+        return { current: false, reason: 'workspace_fingerprint' };
+    }
+    return { current: true };
+}
+export function prepareRetry(definition, run, updatedAt) {
+    if (run.attempt >= definition.max_attempts) {
+        throw new RuntimeControlError('RETRY_EXHAUSTED', `Retry limit reached for run ${run.run_id}`);
+    }
+    return {
+        ...run,
+        state: 'ready',
+        attempt: run.attempt + 1,
+        updated_at: updatedAt,
+        version: run.version + 1,
+        terminal: false,
+    };
+}
+export function markRunStale(run, reason, updatedAt) {
+    if (reason.length === 0) {
+        throw new RuntimeControlError('STALE_RUN', 'A stale run requires a reason');
+    }
+    return { ...run, state: 'stale', updated_at: updatedAt, version: run.version + 1 };
+}
+export function assertParallelRunAllowed(definition, activeRuns) {
+    if (!definition.allow_parallel_runs && activeRuns.some((candidate) => !candidate.terminal)) {
+        throw new RuntimeControlError('PARALLEL_RUN', 'An active run already exists for this definition');
+    }
+}
+//# sourceMappingURL=controls.js.map

package/dist/runtime/controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.js","sourceRoot":"","sources":["../../src/runtime/controls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5B,IAAI,CAAmD;IAEvE,YAAmB,IAAiC,EAAE,OAAe;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAOD,MAAM,UAAU,iBAAiB,CAC/B,GAAe,EACf,QAIE;IAEF,IAAI,GAAG,CAAC,mBAAmB,KAAK,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,GAAG,CAAC,iBAAiB,KAAK,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,qBAAqB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACxF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,UAA6B,EAC7B,GAAe,EACf,SAAiB;IAEjB,IAAI,GAAG,CAAC,OAAO,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,+BAA+B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO;QACL,GAAG,GAAG;QACN,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC;QACxB,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC;QACxB,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAe,EAAE,MAAc,EAAE,SAAiB;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,mBAAmB,CAAC,WAAW,EAAE,+BAA+B,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,UAA6B,EAC7B,UAAiC;IAEjC,IAAI,CAAC,UAAU,CAAC,mBAAmB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,mBAAmB,CAC3B,cAAc,EACd,kDAAkD,CACnD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/runtime/dispatcher.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic workflow dispatcher.
+ * Selects only authored steps and never discovers or substitutes tools at runtime.
+ */
+import type { WorkflowExecutionManifest } from '../core/workflow-compiler.js';
+import type { WorkflowStep } from '../schemas/workflow-definition-v2.js';
+import { type WorkflowPredicateResult } from './predicates.js';
+import { type StepDisplayText } from './workflow-v2-step-text.js';
+export { renderWorkflowTemplate, WorkflowDispatchError } from './workflow-template.js';
+export type WorkflowDispatchInput = Readonly<{
+    completed_step_ids: ReadonlySet<string>;
+    variables?: Readonly<Record<string, unknown>>;
+    outputs?: Readonly<Record<string, unknown>>;
+}>;
+export type WorkflowDispatch = Readonly<{
+    step_id: string;
+    kind: WorkflowStep['kind'];
+    host_tool_name: string;
+    arguments: Readonly<Record<string, unknown>>;
+    timeout_seconds: number;
+    expected_results: readonly string[];
+    browser_procedure?: WorkflowStep['browser'];
+    /** The step-level why, stop, instruction and expected_observation, filled where values allow. */
+    display?: StepDisplayText;
+}>;
+export type WorkflowReceipt = Readonly<{
+    step_id: string;
+    host_tool_name: string;
+    arguments: Readonly<Record<string, unknown>>;
+    status: 'succeeded' | 'failed' | 'blocked' | 'inconclusive';
+    artifact_types?: readonly string[];
+    artifacts?: readonly Readonly<{
+        type: string;
+        path: string;
+        digest: string;
+    }>[];
+    browser_issue?: 'unexpected-dialog' | 'selector-drift';
+    browser_steps?: readonly Readonly<{
+        name: string;
+        status: 'passed' | 'failed' | 'skipped';
+    }>[];
+}>;
+export type WorkflowReceiptVerification = Readonly<{
+    valid: boolean;
+    provenance: 'complete' | 'reduced';
+    status?: WorkflowReceipt['status'];
+}>;
+export type WorkflowDispatchEvaluation = Readonly<{
+    verification: WorkflowReceiptVerification;
+    predicates: readonly WorkflowPredicateResult[];
+    route: string;
+    browser_disposition?: 'fail' | 'repair' | 'escalate';
+}>;
+/**
+ * What a dry run offers (BUG-160). `routed`: the step `on.<slot>` leads to from the first step,
+ * through the slot every completed step carries in `outputs`. `not-routed`: a completed step on the
+ * way carries no slot, so the step is the first ready one in definition order — a guess that can
+ * lie on a branch the run never takes.
+ */
+export type WorkflowDispatchPreview = Readonly<{
+    dispatch?: WorkflowDispatch;
+    preview: 'routed' | 'not-routed';
+}>;
+/** The step a dry run offers, and whether the routes or definition order chose it. */
+export declare function previewWorkflowDispatch(manifest: WorkflowExecutionManifest, input: WorkflowDispatchInput): WorkflowDispatchPreview;
+export declare function nextWorkflowDispatch(manifest: WorkflowExecutionManifest, input: WorkflowDispatchInput): WorkflowDispatch | undefined;
+export declare function stableJson(value: unknown): string;
+export declare function verifyWorkflowReceipt(dispatch: WorkflowDispatch, receipt: WorkflowReceipt | undefined): WorkflowReceiptVerification;
+export declare function evaluateWorkflowDispatchReceipt(manifest: WorkflowExecutionManifest, dispatch: WorkflowDispatch, receipt: WorkflowReceipt | undefined, subjects?: Readonly<Record<string, unknown>>): WorkflowDispatchEvaluation;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/runtime/dispatcher.d.ts.map

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