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

package/dist/core/update.js

@@ -5,32 +5,58 @@
  * Core update-item operation
  * Patches item metadata fields and synchronizes the distributed index.
  */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
 import { RELATIONSHIP_TYPE, STATUS } from '../constants/index.js';
-import { getCurrentTimestamp, normalizeMarkdown, parseItemId, TYPE_TO_DIRECTORY } from '../utils/index.js';
+import { prepareWorkflowRunRevisions, } from '../runtime/workflow-v2-revise-open.js';
+import { writeFileAtomic } from '../utils/atomic-write.js';
+import { getCurrentTimestamp, normalizeMarkdown, parseItemId } from '../utils/index.js';
+import { validateProcessDefinitionShape } from './add.js';
+import { coordinationTextWarning, detectAddedCoordinationText, handoverTagWarning, isWorkItemType, projectSlugFromDevstepsDir, } from './coordination-text.js';
+import { applyDescriptionPatch, assertDescriptionModes, hasDescriptionPatch, } from './description-patch.js';
 import { getItem } from './get.js';
-import { updateItemInIndex } from './index-refs.js';
+import { withGuideStepList } from './guide-step-list.js';
+import { itemPaths } from './item-paths.js';
+import { assertItemStamps, assertItemUnchanged, readItem, writeItemDescription, } from './item-store.js';
+import { assertValidItemMetadata } from './item-validation.js';
+import { writeMetadataAfterDescription } from './item-write-pair.js';
+import { resolveCategoryForUpdate } from './update-category.js';
+import { requireMoveReceipt } from './update-category-receipt.js';
+import { updateReminders } from './update-reminders.js';
+import { assertAuthoredWorkflowV2, } from './workflow-v2-authoring.js';
+const FULL_COMMIT_HASH = /^[0-9a-f]{40}$/i;
+function normalizeCommitHash(commitHash) {
+    const normalized = commitHash.trim().toLowerCase();
+    if (!FULL_COMMIT_HASH.test(normalized)) {
+        throw new Error('commit_hash must be a canonical full Git commit SHA');
+    }
+    return normalized;
+}
 /**
  * Core business logic for updating an item
  */
-export async function updateItem(devstepsDir, args) {
+export async function updateItem(devstepsDir, args, options = {}) {
+    assertDescriptionModes(args);
+    const patchDescription = hasDescriptionPatch(args);
     if (!existsSync(devstepsDir)) {
         throw new Error('Project not initialized. Run devsteps-init first.');
     }
-    const parsed = parseItemId(args.id);
-    if (!parsed) {
-        throw new Error(`Invalid item ID: ${args.id}`);
-    }
-    const typeFolder = TYPE_TO_DIRECTORY[parsed.type];
-    const metadataPath = join(devstepsDir, typeFolder, `${args.id}.json`);
-    const descriptionPath = join(devstepsDir, typeFolder, `${args.id}.md`);
-    if (!existsSync(metadataPath)) {
+    const paths = itemPaths(devstepsDir, args.id);
+    if (!existsSync(paths.metadata)) {
         throw new Error(`Item not found: ${args.id}`);
     }
-    // Read and update metadata
-    const { metadata } = await getItem(devstepsDir, args.id);
+    // Read and update metadata; `stamp` guards the write against a concurrent writer (STORY-428)
+    const current = await getItem(devstepsDir, args.id);
+    const { metadata, stamp } = current;
     const oldStatus = metadata.status;
+    let diagnostics = [];
+    let revisions;
+    if (args.process_definition !== undefined) {
+        validateProcessDefinitionShape(metadata.type, args.process_definition);
+        diagnostics = await assertAuthoredWorkflowV2(devstepsDir, args.process_definition, args.id);
+        // BUG-112 refused any change under an open run. STORY-465: a v2 run takes the revision when
+        // its recorded steps stay as they were judged; every open run is checked before the write.
+        revisions = await prepareWorkflowRunRevisions(devstepsDir, current, args.process_definition, options.runActor ?? { actor: 'agent' });
+    }
     // Validate status transitions (parent-child rules)
     if (args.status === STATUS.DONE) {
         // Helper function to validate children are complete
@@ -80,34 +106,162 @@ export async function updateItem(devstepsDir, args) {
         metadata.title = args.title;
     if (args.assignee !== undefined)
         metadata.assignee = args.assignee;
+    if (args.category !== undefined) {
+        const target = resolveCategoryForUpdate(devstepsDir, metadata.type, args.category);
+        if (!options.skipLeafReceipt) {
+            await requireMoveReceipt(devstepsDir, { id: args.id, type: metadata.type, from: metadata.category, target }, args.leaf_receipt);
+        }
+        metadata.category = target;
+    }
     if (args.tags)
         metadata.tags = args.tags;
     if (args.affected_paths)
         metadata.affected_paths = args.affected_paths;
-    metadata.updated = getCurrentTimestamp();
-    writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
-    // Update description
-    if (args.description && args.append_description) {
-        throw new Error('Cannot use both description and append_description simultaneously');
+    if (args.process_definition !== undefined) {
+        metadata.process_definition = args.process_definition;
     }
+    if (args.commit_hash) {
+        const commitHash = normalizeCommitHash(args.commit_hash);
+        metadata.commits = metadata.commits.includes(commitHash)
+            ? metadata.commits
+            : [...metadata.commits, commitHash];
+    }
+    // reviewed_at: auto-set on review→done; explicit override via args
+    if (args.reviewed_at) {
+        metadata.reviewed_at = args.reviewed_at;
+    }
+    else if (oldStatus === STATUS.REVIEW && args.status === STATUS.DONE) {
+        metadata.reviewed_at = getCurrentTimestamp();
+    }
+    // BUG-115: validate the patched metadata before any file is touched — including
+    // the description below, which must not be written for an update that is rejected.
+    assertValidItemMetadata(metadata);
+    // STORY-428: refuse the whole update when another process wrote the item since it
+    // was read — checked before the description is touched, so the pair stays consistent.
+    assertItemUnchanged(devstepsDir, args.id, stamp);
+    const patchRead = patchDescription ? readItem(devstepsDir, args.id) : undefined;
+    const expected = options.expected ??
+        (patchRead ? { metadata: stamp, description: patchRead.descriptionStamp } : undefined);
+    if (expected)
+        assertItemStamps(devstepsDir, args.id, expected);
+    const writeDescription = (text) => expected
+        ? writeItemDescription(devstepsDir, args.id, text, expected)
+        : writeFileAtomic(paths.description, text);
+    const hadDescription = existsSync(paths.description);
+    const existing = (args.description ||
+        args.append_description ||
+        patchDescription ||
+        args.process_definition !== undefined) &&
+        hadDescription
+        ? (patchRead?.description ?? readFileSync(paths.description, 'utf-8'))
+        : '';
+    let added = '';
+    let written;
+    let descriptionChanges;
     if (args.description) {
         // Replace entire description — normalize escape sequences from MCP clients (BUG-056)
-        writeFileSync(descriptionPath, normalizeMarkdown(args.description));
+        added = normalizeMarkdown(args.description);
+        written = added;
     }
     else if (args.append_description) {
         // Append to existing (or create new if doesn't exist)
-        const existing = existsSync(descriptionPath) ? readFileSync(descriptionPath, 'utf-8') : '';
-        writeFileSync(descriptionPath, existing + normalizeMarkdown(args.append_description));
+        added = normalizeMarkdown(args.append_description);
+        written = existing + added;
     }
-    // Update index (auto-migration ensures refs-style always available)
-    // Only update if status or eisenhower changed (triggers re-indexing)
-    if (args.status || args.eisenhower) {
-        updateItemInIndex(devstepsDir, args.id, oldStatus, args.status, undefined, // oldEisenhower - we don't track changes
-        args.eisenhower);
+    else if (patchDescription) {
+        const patched = applyDescriptionPatch(existing, args);
+        written = patched.text;
+        descriptionChanges = patched.changes;
+        added = written;
     }
+    // BUG-213: a guide's description carries the step list generated from its definition.
+    let wrote;
+    if (written !== undefined || args.process_definition !== undefined) {
+        const listed = patchDescription
+            ? (written ?? existing)
+            : withGuideStepList(written ?? existing, metadata.process_definition);
+        if (written !== undefined || listed !== existing) {
+            writeDescription(listed);
+            wrote = { text: listed, before: hadDescription ? existing : undefined };
+        }
+    }
+    metadata.updated = getCurrentTimestamp();
+    // BUG-182: a failed metadata write puts the description back, so the pair stays consistent.
+    writeMetadataAfterDescription(devstepsDir, metadata, stamp, wrote);
+    const revised = revisions ? await revisions.commit() : [];
+    const warnings = [
+        ...coordinationWarnings(devstepsDir, metadata, existing, added, !!args.tags),
+        ...updateReminders(devstepsDir, {
+            metadata,
+            oldStatus,
+            status: args.status,
+            superseded_by: args.superseded_by,
+            descriptionChanged: Boolean(args.description || args.append_description || patchDescription),
+            descriptionAppended: Boolean(args.append_description?.trim()),
+            titleChanged: args.title !== undefined,
+            descriptionPath: paths.description,
+            batchReminder: options.batchReminder !== false,
+        }),
+    ];
     return {
         metadata,
         oldStatus,
+        // BUG-162: a compiled definition always reports its diagnostics, an empty list included.
+        ...(args.process_definition !== undefined || diagnostics.length > 0 ? { diagnostics } : {}),
+        ...(warnings.length > 0 ? { warnings } : {}),
+        ...(revised.length > 0 ? { revised_runs: revised.map((run) => run.run_id) } : {}),
+        ...(descriptionChanges !== undefined ? { description_changes: descriptionChanges } : {}),
     };
 }
+/**
+ * BUG-153: warn in band when an update puts coordination state into a work item —
+ * the `handover` tag (P1) or newly added session-log, address, or roster text (P2).
+ */
+function coordinationWarnings(devstepsDir, metadata, existing, added, tagsChanged) {
+    if (!isWorkItemType(metadata.type))
+        return [];
+    const warnings = [];
+    if (tagsChanged) {
+        const tagWarning = handoverTagWarning(metadata.id, metadata.type, metadata.tags);
+        if (tagWarning)
+            warnings.push(tagWarning);
+    }
+    if (added) {
+        const findings = detectAddedCoordinationText(existing, added, {
+            projectSlug: projectSlugFromDevstepsDir(devstepsDir),
+        });
+        const textWarning = coordinationTextWarning(metadata.id, findings);
+        if (textWarning)
+            warnings.push(textWarning);
+    }
+    return warnings;
+}
+/** Append one canonical commit reference to every existing target item. */
+export async function addCommitReferences(devstepsDir, ids, commitHash) {
+    const normalized = normalizeCommitHash(commitHash);
+    const uniqueIds = [...new Set(ids)];
+    const failed = [];
+    for (const id of uniqueIds) {
+        try {
+            await getItem(devstepsDir, id);
+        }
+        catch (error) {
+            failed.push({ id, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    if (failed.length > 0) {
+        return { success: [], failed, commit_hash: normalized };
+    }
+    const success = [];
+    for (const id of uniqueIds) {
+        try {
+            await updateItem(devstepsDir, { id, commit_hash: normalized });
+            success.push(id);
+        }
+        catch (error) {
+            failed.push({ id, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    return { success, failed, commit_hash: normalized };
+}
 //# sourceMappingURL=update.js.map

package/dist/core/update.js.map

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

package/dist/core/validation.d.ts

@@ -14,6 +14,7 @@ export interface ValidationResult {
     valid: boolean;
     error?: string;
     suggestion?: string;
+    conflicting_relation?: string;
 }
 /**
  * Minimal work item info needed for validation
@@ -36,11 +37,12 @@ export declare function validateRelationship(source: WorkItem, target: WorkItem,
 /**
  * Validate that no conflicting relation types exist between the same source and target.
  *
- * Blocks:
- * - hierarchy + any other type to same target
+ * Refuses:
+ * - hierarchy + any other type to same target, except blocks/blocked-by
  * - multiple hierarchy types to same target
  *
  * Allows:
+ * - blocks/blocked-by beside any relation, implements included
  * - bidirectional symmetric flexible relations (e.g. relates-to)
  * - multiple flexible types to same target (e.g. depends-on + relates-to)
  *

package/dist/core/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,gBAAgB,CA2DlB;AAmLD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,WAAW,GACzB,gBAAgB,CAoClB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAI9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,gBAAgB,CA+DlB;AA8MD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,WAAW,GACzB,gBAAgB,CAuClB"}

package/dist/core/validation.js

@@ -8,6 +8,7 @@
  */
 import { ITEM_TYPE, METHODOLOGY, RELATIONSHIP_TYPE } from '../constants/index.js';
 import { isFlexibleRelation, isHierarchyRelation } from '../schemas/relationships.js';
+import { isCrossCutting } from './decision-question.js';
 /**
  * Validate relationship between two items based on methodology
  * Only validates "implements" relationships - all other relations are flexible
@@ -19,6 +20,16 @@ import { isFlexibleRelation, isHierarchyRelation } from '../schemas/relationship
  * @returns ValidationResult with valid flag and optional error/suggestion
  */
 export function validateRelationship(source, target, relationType, methodology) {
+    // Doc → doc via documents/documented-by is forbidden — BOM is the only valid doc-to-doc structure
+    if ((relationType === 'documents' || relationType === 'documented-by') &&
+        source.type === ITEM_TYPE.DOC &&
+        target.type === ITEM_TYPE.DOC) {
+        return {
+            valid: false,
+            error: 'Doc-to-doc links via documents/documented-by are not allowed',
+            suggestion: 'Use docs-map.json BOM structure (parent_id) for doc-to-doc relationships. Run devsteps_docs_bom_commit to establish doc-to-doc hierarchy.',
+        };
+    }
     // Flexible relationships always allowed
     if (isFlexibleRelation(relationType)) {
         return { valid: true };
@@ -27,20 +38,13 @@ export function validateRelationship(source, target, relationType, methodology)
     if (!isHierarchyRelation(relationType)) {
         return { valid: false, error: `Unknown relationship type: ${relationType}` };
     }
-    // Special case: blocks relation (Jira 2025 - hybrid flexible/hierarchy)
-    // Non-Bug blocks: Flexible (Story→Story, Task→Task allowed)
-    // Bug blocks: Hierarchy validation (Bug→Epic/Story/Requirement/Feature only)
-    if (relationType === RELATIONSHIP_TYPE.BLOCKS) {
-        if (source.type !== ITEM_TYPE.BUG) {
-            return { valid: true }; // Flexible for non-Bug types
-        }
-        // Bug blocks: validate as hierarchy below
-    }
-    // Only validate "implements" direction (implemented-by, blocked-by are automatic reverse)
-    if (relationType === RELATIONSHIP_TYPE.IMPLEMENTED_BY ||
-        relationType === RELATIONSHIP_TYPE.BLOCKED_BY) {
-        return { valid: true }; // Reverse relationships auto-created, no validation needed
+    // Only validate the "implements" direction (implemented-by is the automatic reverse)
+    if (relationType === RELATIONSHIP_TYPE.IMPLEMENTED_BY) {
+        return { valid: true };
     }
+    // Doc, decision and question are cross-cutting: no implements hierarchy (EPIC-059)
+    if (isCrossCutting(source.type))
+        return crossCuttingRefusal(source.type);
     // Validate based on methodology
     if (methodology === METHODOLOGY.SCRUM) {
         return validateScrumHierarchy(source, target);
@@ -67,10 +71,28 @@ export function validateRelationship(source, target, relationType, methodology)
         error: `Unknown methodology: ${methodology}`,
     };
 }
+/** The refusal of `implements` from a cross-cutting item, with the relation it uses instead. */
+function crossCuttingRefusal(type) {
+    if (type === ITEM_TYPE.DOC) {
+        return {
+            valid: false,
+            error: 'Doc items are cross-cutting and do not use the implements hierarchy',
+            suggestion: 'Use "documents" relation: DOC documents TARGET, or TARGET documented-by DOC',
+        };
+    }
+    const label = type === ITEM_TYPE.DECISION ? 'Decision' : 'Question';
+    return {
+        valid: false,
+        error: `${label} items are cross-cutting and do not use the implements hierarchy`,
+        suggestion: type === ITEM_TYPE.DECISION
+            ? 'Use "relates-to": DEC relates-to the epic or story it decides for'
+            : 'Use "relates-to": QST relates-to the epic or story it asks about, plus "blocks" when it blocks it',
+    };
+}
 /**
  * Validate Scrum hierarchy rules
- * Epic → Story|Spike → Task
- * Bug/Test can implement Epic or Story
+ * Epic → Story|Spike → Task, Story → Bug → Task
+ * Test can implement Epic or Story
  */
 function validateScrumHierarchy(source, target) {
     const { type: sourceType } = source;
@@ -110,15 +132,15 @@ function validateScrumHierarchy(source, target) {
             suggestion: `Change ${target.id} to an Epic or create an Epic first, then link Spike → Epic`,
         };
     }
-    // Bug → Story only (Jira 2025)
+    // Bug → Story only (DEC-018: a bug implements its parent like every other type)
     if (sourceType === ITEM_TYPE.BUG) {
         if (targetType === ITEM_TYPE.STORY) {
             return { valid: true };
         }
         return {
             valid: false,
-            error: 'Bugs can only implement/block Stories in Scrum',
-            suggestion: `Link Bug → Story. Bug is always a child of Story, never Epic. Use Task to implement the fix (Task implements Bug).`,
+            error: 'Bugs can only implement Stories in Scrum',
+            suggestion: `Link Bug implements Story: a bug is a child of its Story, never of an Epic. Use Task to implement the fix (Task implements Bug).`,
         };
     }
     // Test → Epic or Story (flexible)
@@ -148,8 +170,8 @@ function validateScrumHierarchy(source, target) {
 }
 /**
  * Validate Waterfall hierarchy rules
- * Requirement → Feature|Spike → Task
- * Bug/Test can implement Requirement or Feature
+ * Requirement → Feature|Spike → Task, Feature → Bug → Task
+ * Test can implement Requirement or Feature
  */
 function validateWaterfallHierarchy(source, target) {
     const { type: sourceType } = source;
@@ -189,15 +211,15 @@ function validateWaterfallHierarchy(source, target) {
             suggestion: `Change ${target.id} to a Requirement or create a Requirement first, then link Spike → Requirement`,
         };
     }
-    // Bug → Feature only (Jira 2025)
+    // Bug → Feature only (DEC-018: a bug implements its parent like every other type)
     if (sourceType === ITEM_TYPE.BUG) {
         if (targetType === ITEM_TYPE.FEATURE) {
             return { valid: true };
         }
         return {
             valid: false,
-            error: 'Bugs can only implement/block Requirements or Features in Waterfall',
-            suggestion: `Link Bug → Requirement (requirement-level defect) or Bug → Feature (feature-level defect). Use Task to implement the fix (Task implements Bug).`,
+            error: 'Bugs can only implement Features in Waterfall',
+            suggestion: `Link Bug implements Feature: a bug is a child of its Feature, never of a Requirement. Use Task to implement the fix (Task implements Bug).`,
         };
     }
     // Test → Requirement or Feature (flexible)
@@ -225,14 +247,20 @@ function validateWaterfallHierarchy(source, target) {
         suggestion: 'Check Waterfall hierarchy: Requirement → Feature|Spike → Task',
     };
 }
+/** Holding an item up says nothing about its parent, so blocks sits beside any relation (DEC-018). */
+const BLOCKING_RELATIONS = new Set([
+    RELATIONSHIP_TYPE.BLOCKS,
+    RELATIONSHIP_TYPE.BLOCKED_BY,
+]);
 /**
  * Validate that no conflicting relation types exist between the same source and target.
  *
- * Blocks:
- * - hierarchy + any other type to same target
+ * Refuses:
+ * - hierarchy + any other type to same target, except blocks/blocked-by
  * - multiple hierarchy types to same target
  *
  * Allows:
+ * - blocks/blocked-by beside any relation, implements included
  * - bidirectional symmetric flexible relations (e.g. relates-to)
  * - multiple flexible types to same target (e.g. depends-on + relates-to)
  *
@@ -242,24 +270,27 @@ function validateWaterfallHierarchy(source, target) {
  * @returns ValidationResult indicating conflict or success
  */
 export function validateRelationConflict(targetId, newRelationType, existingLinks) {
+    if (BLOCKING_RELATIONS.has(newRelationType))
+        return { valid: true };
     const newIsHierarchy = isHierarchyRelation(newRelationType);
     for (const [existingType, targetIds] of Object.entries(existingLinks)) {
-        // Skip same type — duplicate check is handled separately
-        if (existingType === newRelationType)
+        // Skip same type (duplicates are handled separately) and blocks/blocked-by
+        if (existingType === newRelationType || BLOCKING_RELATIONS.has(existingType))
             continue;
         // Skip if target not in this relation list
         if (!Array.isArray(targetIds) || !targetIds.includes(targetId))
             continue;
         const existingIsHierarchy = isHierarchyRelation(existingType);
-        // Block: both hierarchy types to same target
+        // Refuse: both hierarchy types to same target
         if (newIsHierarchy && existingIsHierarchy) {
             return {
                 valid: false,
                 error: `Cannot add "${newRelationType}" to ${targetId} — already has hierarchy relation "${existingType}" to same target`,
                 suggestion: `Remove the existing "${existingType}" link first, or use a different target`,
+                conflicting_relation: existingType,
             };
         }
-        // Block: hierarchy mixed with any flexible type to same target
+        // Refuse: hierarchy mixed with any flexible type to same target
         if (newIsHierarchy || existingIsHierarchy) {
             const hierarchyType = newIsHierarchy ? newRelationType : existingType;
             const flexibleType = newIsHierarchy ? existingType : newRelationType;
@@ -267,6 +298,7 @@ export function validateRelationConflict(targetId, newRelationType, existingLink
                 valid: false,
                 error: `Cannot mix hierarchy relation "${hierarchyType}" with flexible relation "${flexibleType}" to same target ${targetId}`,
                 suggestion: `Use only "${hierarchyType}" (hierarchy takes precedence) and remove "${flexibleType}", or use a different target`,
+                conflicting_relation: existingType,
             };
         }
         // Multiple flexible types to same target: allowed

package/dist/core/validation.js.map

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

package/dist/core/workflow-compiler-host-rules.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Host rules of the authoring-time workflow compiler.
+ * Bindings must name a tool of the selected host profile, human steps must use a transport that
+ * profile renders, script steps carry a command, and destructive steps should depend on approval.
+ */
+import type { WorkflowDefinitionV2 as WorkflowDefinition, WorkflowHumanTransport } from '../schemas/workflow-definition-v2.js';
+import type { DiagnosticSink } from './workflow-compiler-rules.js';
+import { type ResolvedHostProfile } from './workflow-host-profiles.js';
+/** Every binding names a tool the profile declares for the step's kind. */
+export declare function checkBindingsAgainstProfile(definition: WorkflowDefinition, resolved: ResolvedHostProfile, report: DiagnosticSink): void;
+/**
+ * Resolve the transport of every human step for the profile. The authored transport must be the
+ * profile's or `conversation`; `on_unavailable: declared-fallback` falls back to `conversation`.
+ */
+export declare function resolveHumanTransports(definition: WorkflowDefinition, resolved: ResolvedHostProfile | undefined, report: DiagnosticSink): Record<string, WorkflowHumanTransport>;
+export declare function checkScriptSteps(definition: WorkflowDefinition, report: DiagnosticSink): void;
+/** Warn when a destructive, mutating, credentialed, or irreversible step has no approval dependency. */
+export declare function checkApprovalDependencies(definition: WorkflowDefinition, report: DiagnosticSink): void;
+/**
+ * A step the executor discharges by reporting what they observed has no structured tool output, so
+ * a predicate that can only read such output is refused while the guide is written rather than
+ * failing halfway through a run. Two ways a predicate gives itself away: its kind can only judge a
+ * structured result, or it points at a field only a receipt carries. The kind alone is not enough —
+ * `number-compare` is harmless until it targets `outputs.<step>.exit_code`.
+ */
+export declare function checkExecutorPredicates(definition: WorkflowDefinition, report: DiagnosticSink): void;
+/** A secret written into a template is an authoring error; pass it as a secret-reference variable. */
+export declare function checkSecretLiterals(definition: WorkflowDefinition, report: DiagnosticSink): void;
+//# sourceMappingURL=workflow-compiler-host-rules.d.ts.map

package/dist/core/workflow-compiler-host-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-compiler-host-rules.d.ts","sourceRoot":"","sources":["../../src/core/workflow-compiler-host-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,oBAAoB,IAAI,kBAAkB,EAE1C,sBAAsB,EAEvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAoCrC,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,cAAc,GACrB,IAAI,CAwBN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,mBAAmB,GAAG,SAAS,EACzC,MAAM,EAAE,cAAc,GACrB,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAiCxC;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAsB7F;AAED,wGAAwG;AACxG,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,cAAc,GACrB,IAAI,CAiBN;AA0ED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,cAAc,GACrB,IAAI,CAuBN;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAYhG"}