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

package/dist/core/doctor-relations.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Relationship integrity checks: broken references, asymmetric links, invalid
+ * relation types, missing hierarchy parents, legacy structure, and orphans.
+ */
+import type { ItemMetadata, Methodology } from '../schemas/index.js';
+import type { CheckResult } from './doctor-types.js';
+export type ItemMap = ReadonlyMap<string, ItemMetadata>;
+export declare function detectLegacyRelationshipStructure(ids: readonly string[]): CheckResult;
+/** References to items that do not exist; an archived target still exists (BUG-173). */
+export declare function detectBrokenReferences(allItems: ItemMap, archivedIds?: ReadonlySet<string>): CheckResult;
+/** A→B recorded while B does not carry the inverse back to A. */
+export declare function detectAsymmetricLinks(allItems: ItemMap): CheckResult;
+/** Relation types the hierarchy rules of the methodology do not allow. */
+export declare function detectInvalidRelationships(allItems: ItemMap, methodology: Methodology): CheckResult;
+/** Hierarchy items whose expected parent link is still missing. */
+export declare function detectMissingHierarchyParents(allItems: ItemMap, methodology: Methodology): CheckResult;
+/**
+ * Open non-top-level items with no parent relationship at all. DOC items are
+ * placed by the documentation BOM, not by a parent, and decisions and questions
+ * relate to their epic or story (EPIC-059), so cross-cutting items are not orphans.
+ * blocks/blocked-by only holds an item up and names no parent (DEC-018).
+ */
+export declare function detectOrphanedItems(allItems: ItemMap): CheckResult;
+//# sourceMappingURL=doctor-relations.d.ts.map

package/dist/core/doctor-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-relations.d.ts","sourceRoot":"","sources":["../../src/core/doctor-relations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYrD,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAMxD,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAerF;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,EACjB,WAAW,GAAE,WAAW,CAAC,MAAM,CAAa,GAC3C,WAAW,CAoBb;AAED,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAgCpE;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,WAAW,GACvB,WAAW,CAmCb;AAED,mEAAmE;AACnE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,WAAW,GACvB,WAAW,CA4Bb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,WAAW,CAmBlE"}

package/dist/core/doctor-relations.js

@@ -0,0 +1,179 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Relationship integrity checks: broken references, asymmetric links, invalid
+ * relation types, missing hierarchy parents, legacy structure, and orphans.
+ */
+import { isCrossCutting } from './decision-question.js';
+import { evaluateRelationshipCompleteness } from './relationship-completeness.js';
+import { INVERSE_RELATIONS } from './relationship-map.js';
+import { validateRelationship } from './validation.js';
+const MAX_REPORTED = 10;
+/** Top-level item types that don't need a parent */
+const TOP_LEVEL_TYPES = new Set(['epic', 'requirement']);
+const CLOSED_STATUSES = new Set(['cancelled', 'obsolete']);
+function linksOf(meta) {
+    return Object.entries(meta.linked_items ?? {});
+}
+export function detectLegacyRelationshipStructure(ids) {
+    if (ids.length === 0) {
+        return {
+            name: 'Legacy Relationship Structure',
+            status: 'pass',
+            message: 'All items contain the complete linked_items structure',
+        };
+    }
+    return {
+        name: 'Legacy Relationship Structure',
+        status: 'warn',
+        message: `${ids.length} item(s) use a partial or absent legacy linked_items structure`,
+        details: ids.slice(0, MAX_REPORTED),
+        fix: 'Use update, link, or unlink to hydrate existing structural keys with an intentional mutation',
+    };
+}
+/** References to items that do not exist; an archived target still exists (BUG-173). */
+export function detectBrokenReferences(allItems, archivedIds = new Set()) {
+    const broken = [];
+    for (const [id, meta] of allItems) {
+        for (const [relType, targets] of linksOf(meta)) {
+            for (const targetId of targets) {
+                if (allItems.has(targetId) || archivedIds.has(targetId))
+                    continue;
+                broken.push(`${id} →[${relType}]→ ${targetId} (not found)`);
+            }
+        }
+    }
+    if (broken.length === 0) {
+        return { name: 'Broken References', status: 'pass', message: 'No broken references found' };
+    }
+    return {
+        name: 'Broken References',
+        status: 'fail',
+        message: `${broken.length} broken reference(s) detected`,
+        details: broken.slice(0, MAX_REPORTED),
+        fix: 'Run: devsteps unlink <source> <relation> <target> to clean up',
+    };
+}
+/** A→B recorded while B does not carry the inverse back to A. */
+export function detectAsymmetricLinks(allItems) {
+    const asymmetric = [];
+    for (const [id, meta] of allItems) {
+        for (const [relType, targets] of linksOf(meta)) {
+            const expectedInverse = INVERSE_RELATIONS[relType];
+            if (!expectedInverse)
+                continue;
+            for (const targetId of targets) {
+                const targetMeta = allItems.get(targetId);
+                if (!targetMeta?.linked_items)
+                    continue;
+                const inverse = targetMeta.linked_items[expectedInverse];
+                if (!inverse?.includes(id)) {
+                    asymmetric.push(`${id} →[${relType}]→ ${targetId} but ${targetId} missing [${expectedInverse}]→ ${id}`);
+                }
+            }
+        }
+    }
+    if (asymmetric.length === 0) {
+        return {
+            name: 'Asymmetric Links',
+            status: 'pass',
+            message: 'All bidirectional links are consistent',
+        };
+    }
+    return {
+        name: 'Asymmetric Links',
+        status: 'warn',
+        message: `${asymmetric.length} asymmetric link(s) detected`,
+        details: asymmetric.slice(0, MAX_REPORTED),
+        fix: 'Run: devsteps link <source> <relation> <target> to re-create missing inverse',
+    };
+}
+/** Relation types the hierarchy rules of the methodology do not allow. */
+export function detectInvalidRelationships(allItems, methodology) {
+    const invalid = [];
+    for (const [id, meta] of allItems) {
+        for (const [relType, targets] of linksOf(meta)) {
+            for (const targetId of targets) {
+                const targetMeta = allItems.get(targetId);
+                if (!targetMeta)
+                    continue; // Broken refs handled separately
+                const result = validateRelationship({ id, type: meta.type }, { id: targetId, type: targetMeta.type }, relType, methodology);
+                if (!result.valid) {
+                    invalid.push(`${id}(${meta.type}) →[${relType}]→ ${targetId}(${targetMeta.type}): ${result.error}`);
+                }
+            }
+        }
+    }
+    if (invalid.length === 0) {
+        return {
+            name: 'Relationship Validation',
+            status: 'pass',
+            message: 'All relationship types are valid',
+        };
+    }
+    return {
+        name: 'Relationship Validation',
+        status: 'fail',
+        message: `${invalid.length} invalid relationship(s) detected`,
+        details: invalid.slice(0, MAX_REPORTED),
+        fix: 'Run: devsteps unlink <source> <relation> <target> then re-link with correct type',
+    };
+}
+/** Hierarchy items whose expected parent link is still missing. */
+export function detectMissingHierarchyParents(allItems, methodology) {
+    const missing = [...allItems.values()]
+        .filter((meta) => !CLOSED_STATUSES.has(meta.status))
+        .map((meta) => {
+        const parentTypes = Object.fromEntries(meta.linked_items.implements
+            .map((parentId) => [parentId, allItems.get(parentId)?.type])
+            .filter((entry) => entry[1] !== undefined));
+        return evaluateRelationshipCompleteness(meta, methodology, parentTypes);
+    })
+        .filter((result) => result.pending || result.invalid)
+        .map((result) => `${result.item_id} (${result.item_type}): ${result.message}`);
+    if (missing.length === 0) {
+        return {
+            name: 'Missing Hierarchy Parents',
+            status: 'pass',
+            message: 'All hierarchy items satisfy the active parent relationship model',
+        };
+    }
+    return {
+        name: 'Missing Hierarchy Parents',
+        status: 'warn',
+        message: `${missing.length} hierarchy relationship finding(s) detected`,
+        details: missing.slice(0, MAX_REPORTED),
+        fix: 'Run: devsteps link <child> implements <parent> after selecting the correct parent; blocks names no parent',
+    };
+}
+/**
+ * Open non-top-level items with no parent relationship at all. DOC items are
+ * placed by the documentation BOM, not by a parent, and decisions and questions
+ * relate to their epic or story (EPIC-059), so cross-cutting items are not orphans.
+ * blocks/blocked-by only holds an item up and names no parent (DEC-018).
+ */
+export function detectOrphanedItems(allItems) {
+    const orphaned = [];
+    for (const [id, meta] of allItems) {
+        if (TOP_LEVEL_TYPES.has(meta.type) || isCrossCutting(meta.type))
+            continue;
+        if (CLOSED_STATUSES.has(meta.status))
+            continue;
+        const linked = meta.linked_items;
+        const hasParent = (linked?.implements?.length ?? 0) > 0 || (linked?.tests?.length ?? 0) > 0;
+        if (!hasParent)
+            orphaned.push(`${id} (${meta.type}): ${meta.title}`);
+    }
+    if (orphaned.length === 0) {
+        return { name: 'Orphaned Items', status: 'pass', message: 'No orphaned items found' };
+    }
+    return {
+        name: 'Orphaned Items',
+        status: 'warn',
+        message: `${orphaned.length} orphaned item(s) with no parent relationship`,
+        details: orphaned.slice(0, MAX_REPORTED),
+        fix: 'Run: devsteps link <item> implements <parent> to assign parent',
+    };
+}
+//# sourceMappingURL=doctor-relations.js.map

package/dist/core/doctor-relations.js.map

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

package/dist/core/doctor-schema-normalize.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Closed repair vocabulary; no inferred priority, local timezone or missing date.
+ */
+import type { EisenhowerQuadrant } from '../schemas/index.js';
+export declare function normalizePriorityAlias(value: string): EisenhowerQuadrant | undefined;
+interface TimestampNormalization {
+    value?: string;
+    error?: string;
+}
+/** Validate components before conversion: Date's rollover is never accepted as repair. */
+export declare function normalizeOffsetTimestamp(input: string): TimestampNormalization;
+export {};
+//# sourceMappingURL=doctor-schema-normalize.d.ts.map

package/dist/core/doctor-schema-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-normalize.d.ts","sourceRoot":"","sources":["../../src/core/doctor-schema-normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAS9D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEpF;AAED,UAAU,sBAAsB;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,0FAA0F;AAC1F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAwC9E"}

package/dist/core/doctor-schema-normalize.js

@@ -0,0 +1,63 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Closed repair vocabulary; no inferred priority, local timezone or missing date.
+ */
+const PRIORITY_ALIASES = new Map([
+    ['important-urgent', 'urgent-important'],
+    ['important-not-urgent', 'not-urgent-important'],
+    ['not-important-urgent', 'urgent-not-important'],
+    ['not-important-not-urgent', 'not-urgent-not-important'],
+]);
+export function normalizePriorityAlias(value) {
+    return PRIORITY_ALIASES.get(value);
+}
+const OFFSET_TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d+)?([+-])(\d{2}):(\d{2})$/;
+function daysInMonth(year, month) {
+    if (month === 2)
+        return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0) ? 29 : 28;
+    return [4, 6, 9, 11].includes(month) ? 30 : 31;
+}
+/** Validate components before conversion: Date's rollover is never accepted as repair. */
+export function normalizeOffsetTimestamp(input) {
+    const match = OFFSET_TIMESTAMP.exec(input);
+    if (!match) {
+        return { error: 'requires YYYY-MM-DDTHH:mm:ss[.fraction] with an explicit ±HH:mm offset' };
+    }
+    const [, yearText, monthText, dayText, hourText, minuteText, secondText, fraction, sign] = match;
+    const [year, month, day, hour, minute, second, offsetHour, offsetMinute] = [
+        yearText,
+        monthText,
+        dayText,
+        hourText,
+        minuteText,
+        secondText,
+        match[9],
+        match[10],
+    ].map(Number);
+    if (month < 1 || month > 12 || day < 1 || day > daysInMonth(year, month)) {
+        return { error: 'offset timestamp has an invalid calendar date' };
+    }
+    if (hour > 23 || minute > 59 || second > 59) {
+        return { error: 'offset timestamp has an invalid time' };
+    }
+    if (offsetHour > 23 || offsetMinute > 59) {
+        return { error: 'offset timestamp has an invalid UTC offset' };
+    }
+    if (sign === '-' && offsetHour === 0 && offsetMinute === 0) {
+        return { error: 'negative zero offset does not identify a known UTC offset' };
+    }
+    // Date.UTC remaps years 00..99 to 1900..1999; setUTCFullYear preserves the stored year.
+    const local = new Date(0);
+    local.setUTCFullYear(year, month - 1, day);
+    local.setUTCHours(hour, minute, second, 0);
+    const offset = (offsetHour * 60 + offsetMinute) * 60_000 * (sign === '+' ? 1 : -1);
+    const utc = new Date(local.getTime() - offset).toISOString();
+    if (!/^\d{4}-/.test(utc)) {
+        return { error: 'UTC conversion falls outside the supported four-digit year range' };
+    }
+    // Convert whole seconds and reattach the original fraction without millisecond truncation.
+    return { value: utc.replace('.000Z', `${fraction ?? ''}Z`) };
+}
+//# sourceMappingURL=doctor-schema-normalize.js.map

package/dist/core/doctor-schema-normalize.js.map

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

package/dist/core/doctor-schema-repair-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Explicit, bounded schema-repair preview and apply contract (TASK-1069).
+ */
+export type SchemaRepairField = 'eisenhower' | 'created' | 'updated' | 'reviewed_at';
+import type { EisenhowerQuadrant } from '../schemas/index.js';
+export interface SchemaRepairSet {
+    eisenhower?: EisenhowerQuadrant;
+    created?: string;
+    updated?: string;
+    reviewed_at?: string;
+}
+export type SchemaRepairChange = {
+    field: SchemaRepairField;
+    before: string;
+    after: string;
+    operation?: never;
+} | {
+    field: SchemaRepairField;
+    before: null;
+    after: string;
+    operation: 'insert';
+};
+export interface SchemaRepairResult {
+    item_id: string;
+    mode: 'preview' | 'apply';
+    applied: boolean;
+    can_apply: boolean;
+    changes: SchemaRepairChange[];
+    /** Schema issues in the stored object before normalization. */
+    schema_issues: string[];
+    /** Remaining candidate issues or facts for which repair must not guess. */
+    unresolved: string[];
+}
+//# sourceMappingURL=doctor-schema-repair-types.d.ts.map

package/dist/core/doctor-schema-repair-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-repair-types.d.ts","sourceRoot":"","sources":["../../src/core/doctor-schema-repair-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,GACD;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEN,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/core/doctor-schema-repair-types.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Explicit, bounded schema-repair preview and apply contract (TASK-1069).
+ */
+export {};
+//# sourceMappingURL=doctor-schema-repair-types.js.map

package/dist/core/doctor-schema-repair-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-repair-types.js","sourceRoot":"","sources":["../../src/core/doctor-schema-repair-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/doctor-schema-repair.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic schema repair: inspect by default, publish only a fully valid candidate.
+ */
+import type { SchemaRepairResult, SchemaRepairSet } from './doctor-schema-repair-types.js';
+export type { SchemaRepairChange, SchemaRepairField, SchemaRepairResult, SchemaRepairSet, } from './doctor-schema-repair-types.js';
+/**
+ * Apply always loads and recomputes a fresh plan; it does not approve a historical preview.
+ * The exact loaded source and stamp are checked immediately before every rename attempt.
+ */
+export declare function repairItemSchema(devstepsDir: string, itemId: string, options?: {
+    apply?: boolean;
+    set?: SchemaRepairSet;
+}): SchemaRepairResult;
+//# sourceMappingURL=doctor-schema-repair.d.ts.map

package/dist/core/doctor-schema-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-repair.d.ts","sourceRoot":"","sources":["../../src/core/doctor-schema-repair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAEV,kBAAkB,EAClB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAQzC,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAyEzC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,eAAe,CAAA;CAAO,GACvD,kBAAkB,CAwBpB"}

package/dist/core/doctor-schema-repair.js

@@ -0,0 +1,113 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic schema repair: inspect by default, publish only a fully valid candidate.
+ */
+import { EisenhowerQuadrant, ItemMetadata } from '../schemas/index.js';
+import { writeFileAtomic } from '../utils/atomic-write.js';
+import { parseItemId } from '../utils/index.js';
+import { normalizeOffsetTimestamp, normalizePriorityAlias } from './doctor-schema-normalize.js';
+import { explicitSchemaRepairChanges, validateSchemaRepairSet } from './doctor-schema-set.js';
+import { patchMetadataStringTokens, rootMetadataTokens } from './doctor-schema-tokens.js';
+import { itemPaths } from './item-paths.js';
+import { assertRawItemSnapshot, readRawItemSnapshot } from './item-raw.js';
+import { invalidateItem } from './item-store.js';
+import { describeZodIssues } from './item-validation.js';
+function issuesFor(raw) {
+    const parsed = ItemMetadata.safeParse(raw);
+    return parsed.success ? [] : describeZodIssues(parsed.error.issues, raw);
+}
+function identityIssues(raw, id) {
+    const issues = [];
+    if (raw.id !== id)
+        issues.push(`id must identify the requested item ${id}; identity is not inferred`);
+    if (raw.type !== parseItemId(id)?.type) {
+        issues.push(`type must match the requested item ${id}; type is not inferred`);
+    }
+    if (raw.eisenhower === undefined)
+        issues.push('eisenhower is missing; priority is not inferred');
+    if (raw.status === undefined)
+        issues.push('status is missing; lifecycle intent is not inferred');
+    if (typeof raw.doc_id === 'string' && (raw.id === undefined || raw.type === undefined)) {
+        issues.push('BOM-node-shaped metadata requires guided reconstruction; no item facts are inferred');
+    }
+    return issues;
+}
+function priorityChange(raw, unresolved) {
+    if (typeof raw.eisenhower !== 'string' || EisenhowerQuadrant.safeParse(raw.eisenhower).success) {
+        return [];
+    }
+    const after = normalizePriorityAlias(raw.eisenhower);
+    if (after)
+        return [{ field: 'eisenhower', before: raw.eisenhower, after }];
+    unresolved.push('eisenhower has no enumerated unambiguous alias; choose a canonical priority');
+    return [];
+}
+function timestampChanges(raw, unresolved) {
+    const changes = [];
+    for (const field of ['created', 'updated', 'reviewed_at']) {
+        const before = raw[field];
+        if (typeof before !== 'string' || ItemMetadata.shape[field].safeParse(before).success)
+            continue;
+        const normalized = normalizeOffsetTimestamp(before);
+        if (normalized.value)
+            changes.push({ field, before, after: normalized.value });
+        else
+            unresolved.push(`${field}: ${normalized.error}`);
+    }
+    return changes;
+}
+function planRepair(raw, text, id, set) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { changes: [], unresolved: ['metadata must be a JSON object'], text };
+    }
+    const record = raw;
+    const unresolved = [];
+    for (const key of rootMetadataTokens(text).duplicateKeys) {
+        unresolved.push(`duplicate metadata field ${JSON.stringify(key)} is ambiguous`);
+    }
+    const changes = explicitSchemaRepairChanges(record, set, unresolved);
+    // Explicit choices own their fields, including refused choices and identical no-ops.
+    const automatic = { ...record };
+    for (const field of Object.keys(set ?? {}))
+        delete automatic[field];
+    changes.push(...priorityChange(automatic, unresolved), ...timestampChanges(automatic, unresolved));
+    const patched = patchMetadataStringTokens(text, changes);
+    // Validate the actual candidate source. Never publish Zod's stripped/defaulted parsed.data.
+    const candidate = JSON.parse(patched);
+    unresolved.push(...identityIssues(candidate, id), ...issuesFor(candidate));
+    return { changes, unresolved: [...new Set(unresolved)], text: patched };
+}
+/**
+ * Apply always loads and recomputes a fresh plan; it does not approve a historical preview.
+ * The exact loaded source and stamp are checked immediately before every rename attempt.
+ */
+export function repairItemSchema(devstepsDir, itemId, options = {}) {
+    const set = validateSchemaRepairSet(options.set);
+    const snapshot = readRawItemSnapshot(devstepsDir, itemId);
+    const plan = planRepair(snapshot.raw, snapshot.text, itemId, set);
+    const canApply = plan.unresolved.length === 0 && plan.changes.length > 0;
+    const result = {
+        item_id: itemId,
+        mode: options.apply ? 'apply' : 'preview',
+        applied: false,
+        can_apply: canApply,
+        changes: plan.changes,
+        schema_issues: issuesFor(snapshot.raw),
+        unresolved: plan.unresolved,
+    };
+    if (!options.apply || !canApply)
+        return result;
+    try {
+        writeFileAtomic(itemPaths(devstepsDir, itemId).metadata, plan.text, {
+            beforeRename: () => assertRawItemSnapshot(devstepsDir, itemId, snapshot),
+        });
+        result.applied = true;
+        return result;
+    }
+    finally {
+        invalidateItem(devstepsDir, itemId);
+    }
+}
+//# sourceMappingURL=doctor-schema-repair.js.map

package/dist/core/doctor-schema-repair.js.map

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

package/dist/core/doctor-schema-set.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Explicit operator facts for bounded schema repair (TASK-1071).
+ */
+import type { SchemaRepairChange, SchemaRepairSet } from './doctor-schema-repair-types.js';
+/** Check controls before reading or planning any stored metadata. No values are inferred. */
+export declare function validateSchemaRepairSet(input: unknown): SchemaRepairSet | undefined;
+export declare function explicitSchemaRepairChanges(raw: Record<string, unknown>, set: SchemaRepairSet | undefined, unresolved: string[]): SchemaRepairChange[];
+//# sourceMappingURL=doctor-schema-set.d.ts.map

package/dist/core/doctor-schema-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-set.d.ts","sourceRoot":"","sources":["../../src/core/doctor-schema-set.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAElB,eAAe,EAChB,MAAM,iCAAiC,CAAC;AAIzC,6FAA6F;AAC7F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAuBnF;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,EAAE,GACnB,kBAAkB,EAAE,CAsBtB"}

package/dist/core/doctor-schema-set.js

@@ -0,0 +1,57 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Explicit operator facts for bounded schema repair (TASK-1071).
+ */
+import { ItemMetadata } from '../schemas/index.js';
+const FIELDS = ['eisenhower', 'created', 'updated', 'reviewed_at'];
+/** Check controls before reading or planning any stored metadata. No values are inferred. */
+export function validateSchemaRepairSet(input) {
+    if (input === undefined)
+        return undefined;
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error('set must be a nonempty object of canonical priority or UTC-Z dates');
+    }
+    const entries = Object.entries(input);
+    if (entries.length === 0)
+        throw new Error('set must not be empty');
+    for (const [key, value] of entries) {
+        if (!FIELDS.includes(key)) {
+            throw new Error('set supports only eisenhower, created, updated and reviewed_at');
+        }
+        if (typeof value !== 'string' ||
+            !ItemMetadata.shape[key].safeParse(value).success) {
+            throw new Error(`set.${key} must be ${key === 'eisenhower' ? 'a canonical priority' : 'a canonical UTC-Z datetime'}`);
+        }
+    }
+    // Retain only the validated own string values; inherited properties and getters
+    // must not introduce unchecked controls when planning reads them a second time.
+    return Object.fromEntries(entries);
+}
+export function explicitSchemaRepairChanges(raw, set, unresolved) {
+    const changes = [];
+    for (const field of FIELDS) {
+        const after = set?.[field];
+        if (after === undefined)
+            continue;
+        if (!Object.hasOwn(raw, field)) {
+            changes.push({ field, before: null, after, operation: 'insert' });
+            continue;
+        }
+        const before = raw[field];
+        if (before === after)
+            continue;
+        if (typeof before !== 'string') {
+            unresolved.push(`${field}: explicit repair supports only stored strings or absent fields`);
+        }
+        else if (ItemMetadata.shape[field].safeParse(before).success) {
+            unresolved.push(`${field} already satisfies the schema; changing a valid value is outside schema repair`);
+        }
+        else {
+            changes.push({ field, before, after });
+        }
+    }
+    return changes;
+}
+//# sourceMappingURL=doctor-schema-set.js.map

package/dist/core/doctor-schema-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-set.js","sourceRoot":"","sources":["../../src/core/doctor-schema-set.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOnD,MAAM,MAAM,GAAiC,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AAEjG,6FAA6F;AAC7F,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACnE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAwB,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QACD,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,YAAY,CAAC,KAAK,CAAC,GAAwB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EACtE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,OAAO,GAAG,YAAY,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,4BAA4B,EAAE,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,gFAAgF;IAChF,gFAAgF;IAChF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAoB,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,GAA4B,EAC5B,GAAgC,EAChC,UAAoB;IAEpB,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClE,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,MAAM,KAAK,KAAK;YAAE,SAAS;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,iEAAiE,CAAC,CAAC;QAC7F,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/D,UAAU,CAAC,IAAI,CACb,GAAG,KAAK,gFAAgF,CACzF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/doctor-schema-tokens.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Locate root JSON string tokens so repair preserves every unrelated source byte.
+ * JSON syntax is validated by the raw reader before this scanner is used.
+ */
+import type { SchemaRepairChange } from './doctor-schema-repair-types.js';
+interface StringToken {
+    start: number;
+    end: number;
+}
+interface RootTokens {
+    strings: Map<string, StringToken>;
+    duplicateKeys: string[];
+}
+export declare function rootMetadataTokens(text: string): RootTokens;
+/** Replace selected strings and insert explicit absent fields, retaining all other bytes. */
+export declare function patchMetadataStringTokens(text: string, changes: readonly SchemaRepairChange[]): string;
+export {};
+//# sourceMappingURL=doctor-schema-tokens.d.ts.map

package/dist/core/doctor-schema-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema-tokens.d.ts","sourceRoot":"","sources":["../../src/core/doctor-schema-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAgBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAuB3D;AAED,6FAA6F;AAC7F,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,MAAM,CAkCR"}