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

package/dist/core/frontmatter.js

@@ -0,0 +1,178 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * YAML Frontmatter extraction and validation for doc-item .md files.
+ * Pure functions: no filesystem access, operates on string content.
+ *
+ * @see STORY-278
+ */
+import { z } from 'zod';
+import { stripBom } from '../utils/text-file.js';
+import { DIATAXIS_TYPES } from './heuristic-classify.js';
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+/** Pattern for valid DevSteps item IDs */
+const ITEM_ID_PATTERN = /^(STORY|TASK|BUG|EPIC|SPIKE|FEATURE|DOC|REQUIREMENT|TEST|DEC|QST)-\d+$/;
+/** Zod schema for doc-item YAML frontmatter */
+export const DocFrontmatterSchema = z
+    .object({
+    diataxis: z.enum(DIATAXIS_TYPES).optional(),
+    related_items: z
+        .array(z.string().regex(ITEM_ID_PATTERN, 'Invalid item ID format'))
+        .optional()
+        .default([]),
+    status: z.enum(['draft', 'approved', 'review']).optional(),
+    author: z.string().optional(),
+    tags: z.array(z.string()).optional().default([]),
+})
+    .strict();
+// ---------------------------------------------------------------------------
+// Known fields for warning detection
+// ---------------------------------------------------------------------------
+const KNOWN_FIELDS = new Set(['diataxis', 'related_items', 'status', 'author', 'tags']);
+// ---------------------------------------------------------------------------
+// Minimal YAML parser (covers flat scalars, simple arrays)
+// ---------------------------------------------------------------------------
+/**
+ * Parse a minimal YAML frontmatter string into a key-value object.
+ * Supports: scalar values, inline arrays `[a, b]`, and block arrays `- item`.
+ * Does NOT support nested objects, multi-line strings, or anchors.
+ *
+ * @throws Error if the YAML is malformed
+ */
+function parseSimpleYaml(yaml) {
+    const result = {};
+    const lines = yaml.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        // Skip empty lines and comments
+        if (line.trim() === '' || line.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const keyMatch = line.match(/^(\w[\w_]*):\s*(.*)/);
+        if (!keyMatch) {
+            throw new Error(`Invalid YAML at line ${i + 1}: "${line.trim()}"`);
+        }
+        const key = keyMatch[1];
+        const valuePart = keyMatch[2].trim();
+        // Inline array: key: [a, b, c]
+        if (valuePart.startsWith('[')) {
+            const inner = valuePart.slice(1, valuePart.lastIndexOf(']')).trim();
+            if (inner === '') {
+                result[key] = [];
+            }
+            else {
+                result[key] = inner.split(',').map((s) => unquote(s.trim()));
+            }
+            i++;
+            continue;
+        }
+        // Block array: key:\n  - item\n  - item
+        if (valuePart === '') {
+            // Could be a block array or empty value
+            const items = [];
+            let j = i + 1;
+            while (j < lines.length && lines[j].match(/^\s+-\s+/)) {
+                const itemMatch = lines[j].match(/^\s+-\s+(.*)/);
+                if (itemMatch) {
+                    items.push(unquote(itemMatch[1].trim()));
+                }
+                j++;
+            }
+            if (items.length > 0) {
+                result[key] = items;
+                i = j;
+                continue;
+            }
+            // Empty value
+            result[key] = undefined;
+            i++;
+            continue;
+        }
+        // Scalar value
+        result[key] = unquote(valuePart);
+        i++;
+    }
+    return result;
+}
+/** Remove surrounding quotes from a string value */
+function unquote(s) {
+    if ((s.startsWith('"') && s.endsWith('"')) || (s.startsWith("'") && s.endsWith("'"))) {
+        return s.slice(1, -1);
+    }
+    return s;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Extract and validate YAML frontmatter from doc-item markdown content.
+ *
+ * Rules:
+ * - Frontmatter is optional — files without `---` delimiters return `frontmatter: null`
+ * - All fields are optional
+ * - Invalid YAML syntax → throws Error
+ * - Invalid field values (e.g. unknown diataxis type) → throws Error with details
+ * - Unknown fields → warning (non-fatal, for forward-compatibility)
+ *
+ * @param content  Full markdown content (may or may not have frontmatter)
+ * @returns Parsed frontmatter, body text, and any warnings
+ * @throws Error if frontmatter is present but contains invalid YAML or invalid values
+ */
+export function extractFrontmatter(rawContent) {
+    // A Windows editor may have saved a UTF-8 byte-order mark in front of the delimiter
+    const content = stripBom(rawContent);
+    // Check for frontmatter delimiters
+    if (!content.startsWith('---')) {
+        return { frontmatter: null, body: content, warnings: [] };
+    }
+    // Find closing delimiter
+    const closingIndex = content.indexOf('\n---', 3);
+    if (closingIndex === -1) {
+        throw new Error('Frontmatter opening "---" found but no closing "---" delimiter');
+    }
+    const yamlBlock = content.slice(4, closingIndex); // skip opening "---\n"
+    const body = content.slice(closingIndex + 4).replace(/^\n/, ''); // skip closing "---\n"
+    // Parse YAML
+    let raw;
+    try {
+        raw = parseSimpleYaml(yamlBlock);
+    }
+    catch (err) {
+        throw new Error(`Invalid YAML in frontmatter: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // Detect unknown fields → warnings
+    const warnings = [];
+    for (const key of Object.keys(raw)) {
+        if (!KNOWN_FIELDS.has(key)) {
+            warnings.push({
+                field: key,
+                message: `Unknown frontmatter field "${key}" — will be ignored. Known fields: ${[...KNOWN_FIELDS].join(', ')}`,
+            });
+        }
+    }
+    // Validate with Zod (strict mode rejects unknown fields — strip them first)
+    const knownOnly = {};
+    for (const key of Object.keys(raw)) {
+        if (KNOWN_FIELDS.has(key)) {
+            knownOnly[key] = raw[key];
+        }
+    }
+    const parsed = DocFrontmatterSchema.safeParse(knownOnly);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((iss) => `  ${iss.path.join('.')}: ${iss.message}`)
+            .join('\n');
+        throw new Error(`Invalid frontmatter values:\n${issues}`);
+    }
+    return {
+        frontmatter: parsed.data,
+        body,
+        warnings,
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/core/frontmatter.js.map

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

package/dist/core/get-fields.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Several items, chosen fields (STORY-457). A coordinator checks status, relations and
+ * commits of a known ID set in one call instead of one full `get` per item. Without
+ * `description` in the projection no `<ID>.md` is opened (the TASK-914 metadata path).
+ */
+export declare const ITEM_FIELDS: readonly ['type', 'title', 'status', 'category', 'tags', 'linked_items', 'commits', 'updated', 'affected_paths', 'description', 'process_definition'];
+export type ItemField = (typeof ITEM_FIELDS)[number];
+/**
+ * Fields a projection returns when the caller names none: everything but the process definition,
+ * which a guide can make too large for one tool answer (BUG-161). Naming it returns it in full.
+ */
+export declare const DEFAULT_ITEM_FIELDS: readonly ItemField[];
+export interface ItemFieldsResult {
+    /** One row per readable item, in request order: `id` plus the chosen fields. */
+    items: Array<Record<string, unknown>>;
+    /** IDs that could not be read, each with its reason; the others are still answered. */
+    not_found: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/** Read `fields` of every ID in `ids`; without `fields`, the defaults including the description. */
+export declare function getItemFields(devstepsDir: string, ids: readonly string[], fields?: readonly ItemField[]): ItemFieldsResult;
+//# sourceMappingURL=get-fields.d.ts.map

package/dist/core/get-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-fields.d.ts","sourceRoot":"","sources":["../../src/core/get-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,WAAW,YACtB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,UAAU,EACV,MAAM,EACN,cAAc,EACd,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,oBAAoB,CACZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,SAAS,EAEnD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,uFAAuF;IACvF,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,oGAAoG;AACpG,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,MAAM,GAAE,SAAS,SAAS,EAAwB,GACjD,gBAAgB,CAqBlB"}

package/dist/core/get-fields.js

@@ -0,0 +1,60 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Several items, chosen fields (STORY-457). A coordinator checks status, relations and
+ * commits of a known ID set in one call instead of one full `get` per item. Without
+ * `description` in the projection no `<ID>.md` is opened (the TASK-914 metadata path).
+ */
+import { existsSync } from 'node:fs';
+import { readItem, readItemMetadata } from './item-store.js';
+export const ITEM_FIELDS = [
+    'type',
+    'title',
+    'status',
+    'category',
+    'tags',
+    'linked_items',
+    'commits',
+    'updated',
+    'affected_paths',
+    'description',
+    'process_definition',
+];
+/**
+ * Fields a projection returns when the caller names none: everything but the process definition,
+ * which a guide can make too large for one tool answer (BUG-161). Naming it returns it in full.
+ */
+export const DEFAULT_ITEM_FIELDS = ITEM_FIELDS.filter((field) => field !== 'process_definition');
+/** Read `fields` of every ID in `ids`; without `fields`, the defaults including the description. */
+export function getItemFields(devstepsDir, ids, fields = DEFAULT_ITEM_FIELDS) {
+    if (!existsSync(devstepsDir)) {
+        throw new Error('Project not initialized. Run devsteps-init first.');
+    }
+    const unknown = fields.filter((field) => !ITEM_FIELDS.includes(field));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown field(s): ${unknown.join(', ')}. Use: ${ITEM_FIELDS.join(', ')}`);
+    }
+    const withDescription = fields.includes('description');
+    const result = { items: [], not_found: [] };
+    for (const id of new Set(ids)) {
+        try {
+            const { metadata, description } = withDescription
+                ? readItem(devstepsDir, id)
+                : { ...readItemMetadata(devstepsDir, id), description: undefined };
+            result.items.push(project(id, metadata, description, fields));
+        }
+        catch (error) {
+            result.not_found.push({ id, error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    return result;
+}
+function project(id, metadata, description, fields) {
+    const row = { id };
+    for (const field of fields) {
+        row[field] = field === 'description' ? description : metadata[field];
+    }
+    return row;
+}
+//# sourceMappingURL=get-fields.js.map

package/dist/core/get-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-fields.js","sourceRoot":"","sources":["../../src/core/get-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,OAAO;IACP,QAAQ;IACR,UAAU;IACV,MAAM;IACN,cAAc;IACd,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,aAAa;IACb,oBAAoB;CACZ,CAAC;AAGX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAyB,WAAW,CAAC,MAAM,CACzE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,oBAAoB,CAC1C,CAAC;AASF,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,GAAsB,EACtB,MAAM,GAAyB,mBAAmB;IAElD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAE,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACvD,MAAM,MAAM,GAAqB,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC9D,KAAK,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,eAAe;gBAC/C,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC3B,CAAC,CAAC,EAAE,GAAG,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;YACrE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CACd,EAAU,EACV,QAAsB,EACtB,WAA+B,EAC/B,MAA4B;IAE5B,MAAM,GAAG,GAA4B,EAAE,EAAE,EAAE,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/get.d.ts

@@ -5,13 +5,47 @@
  * Core get-item operation
  * Reads and returns item metadata from the distributed file store.
  */
-import type { ItemMetadata } from '../schemas/index.js';
+import { EisenhowerQuadrant, ItemMetadata, ItemStatus, ItemType } from '../schemas/index.js';
+import { type ItemAttachment } from './item-paths.js';
+import { type FileStamp } from './item-store.js';
 export interface GetItemResult {
     metadata: ItemMetadata;
     description: string;
+    /** Stamp of the metadata file as read; guards a later write (STORY-428). */
+    stamp: FileStamp;
+    /** Files beside the master document in the item folder (STORY-427). */
+    attachments: ItemAttachment[];
 }
 /**
- * Core business logic for getting an item
+ * Core business logic for getting an item.
+ *
+ * Served by the item store (STORY-426): the files' stamps are checked on every
+ * call, so this is the item's current content — and a copy the caller may patch
+ * and write back.
  */
 export declare function getItem(devstepsDir: string, itemId: string): Promise<GetItemResult>;
+/**
+ * A metadata view that survives a schema violation (BUG-115 / STORY-391).
+ *
+ * `getItem()` is strict on purpose, but that strictness leaves an invalid item
+ * with no way out: archive, purge and doctor all went through it and threw, so a
+ * single over-long title produced a file nobody could read or remove. This view
+ * yields whatever is usable — enough to move the files and clean the indexes —
+ * and reports what is broken instead of throwing.
+ */
+export interface LenientItemMetadata {
+    id: string;
+    /** Present only when the value is a legal member of the enum. */
+    type?: ItemType;
+    status?: ItemStatus;
+    eisenhower?: EisenhowerQuadrant;
+    tags: string[];
+    /** Empty when the file satisfies `ItemMetadata`; one readable line per violation otherwise. */
+    schemaIssues: string[];
+}
+/**
+ * Read item metadata without enforcing the schema. Throws only when the file is
+ * absent or not valid JSON — a state no lenient projection could repair.
+ */
+export declare function readItemMetadataLenient(devstepsDir: string, itemId: string): LenientItemMetadata;
 //# sourceMappingURL=get.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/core/get.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBzF"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/core/get.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE7F,OAAO,EAAE,KAAK,cAAc,EAA8B,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,iBAAiB,CAAC;AAG3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAOzF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+FAA+F;IAC/F,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,CA+ChG"}

package/dist/core/get.js

@@ -6,30 +6,72 @@
  * Reads and returns item metadata from the distributed file store.
  */
 import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { parseItemId, TYPE_TO_DIRECTORY } from '../utils/index.js';
+import { EisenhowerQuadrant, ItemMetadata, ItemStatus, ItemType } from '../schemas/index.js';
+import { parseItemId } from '../utils/index.js';
+import { itemPaths, listAttachments } from './item-paths.js';
+import { readItem } from './item-store.js';
+import { describeZodIssues } from './item-validation.js';
 /**
- * Core business logic for getting an item
+ * Core business logic for getting an item.
+ *
+ * Served by the item store (STORY-426): the files' stamps are checked on every
+ * call, so this is the item's current content — and a copy the caller may patch
+ * and write back.
  */
 export async function getItem(devstepsDir, itemId) {
     if (!existsSync(devstepsDir)) {
         throw new Error('Project not initialized. Run devsteps-init first.');
     }
-    const parsed = parseItemId(itemId);
-    if (!parsed) {
+    const stored = readItem(devstepsDir, itemId);
+    return { ...stored, attachments: listAttachments(devstepsDir, itemId) };
+}
+function optionalEnum(options, value) {
+    return typeof value === 'string' && options.includes(value)
+        ? value
+        : undefined;
+}
+/**
+ * Read item metadata without enforcing the schema. Throws only when the file is
+ * absent or not valid JSON — a state no lenient projection could repair.
+ */
+export function readItemMetadataLenient(devstepsDir, itemId) {
+    const parsedId = parseItemId(itemId);
+    if (!parsedId) {
         throw new Error(`Invalid item ID: ${itemId}`);
     }
-    const typeFolder = TYPE_TO_DIRECTORY[parsed.type];
-    const metadataPath = join(devstepsDir, typeFolder, `${itemId}.json`);
-    const descriptionPath = join(devstepsDir, typeFolder, `${itemId}.md`);
+    const metadataPath = itemPaths(devstepsDir, itemId).metadata;
     if (!existsSync(metadataPath)) {
         throw new Error(`Item not found: ${itemId}`);
     }
-    const metadata = JSON.parse(readFileSync(metadataPath, 'utf-8'));
-    const description = existsSync(descriptionPath) ? readFileSync(descriptionPath, 'utf-8') : '';
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+    }
+    catch (error) {
+        throw new Error(`Item ${itemId} is not valid JSON (${metadataPath}): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const parsed = ItemMetadata.safeParse(raw);
+    if (parsed.success) {
+        return {
+            id: parsed.data.id,
+            type: parsed.data.type,
+            status: parsed.data.status,
+            eisenhower: parsed.data.eisenhower,
+            tags: parsed.data.tags,
+            schemaIssues: [],
+        };
+    }
+    const record = (raw !== null && typeof raw === 'object' ? raw : {});
+    const tags = Array.isArray(record.tags)
+        ? record.tags.filter((tag) => typeof tag === 'string')
+        : [];
     return {
-        metadata,
-        description,
+        id: typeof record.id === 'string' ? record.id : itemId,
+        type: optionalEnum(ItemType.options, record.type) ?? parsedId.type,
+        status: optionalEnum(ItemStatus.options, record.status),
+        eisenhower: optionalEnum(EisenhowerQuadrant.options, record.eisenhower),
+        tags,
+        schemaIssues: describeZodIssues(parsed.error.issues, raw),
     };
 }
 //# sourceMappingURL=get.js.map

package/dist/core/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/core/get.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAOnE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,WAAmB,EAAE,MAAc;IAC/D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IACrE,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;IAEtE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAiB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9F,OAAO;QACL,QAAQ;QACR,WAAW;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/core/get.ts"],"names":[],"mappings":"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"}

package/dist/core/guide-acceptance.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Durable guide acceptance progress records.
+ */
+import { type GuideAcceptanceCheckpoint as GuideAcceptanceCheckpointInput, type GuideAcceptanceStart as GuideAcceptanceStartInput, type GuideProgressRecord as GuideProgressRecordType } from '../schemas/guide-acceptance.js';
+export declare function redactGuideEvidence(value: string): string;
+export declare function verifyGuideDigest(content: string, expectedDigest: string): boolean;
+export declare function guideAcceptanceReportPath(devstepsDir: string, sessionId: string): string;
+export declare function startGuideAcceptance(devstepsDir: string, input: GuideAcceptanceStartInput, guideDirectory?: string): Promise<GuideProgressRecordType>;
+export declare function getGuideAcceptance(devstepsDir: string, sessionId: string): Promise<GuideProgressRecordType | null>;
+export declare function resumeGuideAcceptance(devstepsDir: string, sessionId: string, input: {
+    guide_digest: string;
+    fixture_id?: string;
+    run_marker?: string;
+    current_step?: string;
+}, guideDirectory?: string): Promise<GuideProgressRecordType>;
+export declare function recordGuideCheckpoint(devstepsDir: string, sessionId: string, input: GuideAcceptanceCheckpointInput): Promise<GuideProgressRecordType>;
+export declare function finalizeGuideAcceptance(devstepsDir: string, sessionId: string, status: 'completed' | 'failed' | 'aborted', reason?: string, cleanupConfirmed?: boolean, residualStateVerified?: boolean): Promise<GuideProgressRecordType>;
+//# sourceMappingURL=guide-acceptance.d.ts.map

package/dist/core/guide-acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-acceptance.d.ts","sourceRoot":"","sources":["../../src/core/guide-acceptance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAEL,KAAK,yBAAyB,IAAI,8BAA8B,EAEhE,KAAK,oBAAoB,IAAI,yBAAyB,EAEtD,KAAK,mBAAmB,IAAI,uBAAuB,EACpD,MAAM,gCAAgC,CAAC;AAiBxC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAGlF;AAiED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExF;AAwED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,yBAAyB,EAChC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,uBAAuB,CAAC,CA+ClC;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAGzC;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAChG,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAuBlC;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,uBAAuB,CAAC,CAwFlC;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,EAC1C,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,UAAQ,EACxB,qBAAqB,UAAQ,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAiClC"}