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

package/dist/core/docs-map.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Doctor check for item attachments (STORY-427).
+ *
+ * The master document links its attachments by bare name — `![](screenshot.png)` —
+ * which is what VS Code's paste-image writes. A link like that whose file is not in
+ * the item folder is a finding; so is an attachment large enough to bloat the
+ * repository, since everything in `.devsteps/` is committed.
+ *
+ * Workspace-relative links (`packages/shared/src/x.ts`) and URLs are not attachment
+ * links and are left alone.
+ */
+import type { CheckResult } from './doctor-types.js';
+/** Attachments above this size draw a Git LFS hint. */
+export declare const LARGE_ATTACHMENT_BYTES: number;
+/** Markdown link or image targets: `[text](target)` and `![alt](target "title")`. */
+export declare const LINK_PATTERN: RegExp;
+/** The target of a LINK_PATTERN match: the angle-bracket form (spaces allowed) or the bare one. */
+export declare function linkTarget(match: ArrayLike<string | undefined>): string;
+/** Drop fenced code blocks and inline code, where link syntax is an example, not a link. */
+export declare function stripCode(markdown: string): string;
+/** The attachment name a link target refers to, or null when it is not an attachment link. */
+export declare function attachmentTarget(target: string): string | null;
+/** Attachment names the master document links to that are not in the item folder. */
+export declare function findBrokenAttachmentLinks(devstepsDir: string, id: string): string[];
+export declare function detectAttachmentProblems(devstepsDir: string, ids: Iterable<string>): CheckResult;
+//# sourceMappingURL=doctor-attachments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-attachments.d.ts","sourceRoot":"","sources":["../../src/core/doctor-attachments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAIlD,qFAAqF;AACrF,eAAO,MAAM,YAAY,QAAyE,CAAC;AAEnG,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAEvE;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnF;AAMD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAsChG"}

package/dist/core/doctor-attachments.js

@@ -0,0 +1,95 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Doctor check for item attachments (STORY-427).
+ *
+ * The master document links its attachments by bare name — `![](screenshot.png)` —
+ * which is what VS Code's paste-image writes. A link like that whose file is not in
+ * the item folder is a finding; so is an attachment large enough to bloat the
+ * repository, since everything in `.devsteps/` is committed.
+ *
+ * Workspace-relative links (`packages/shared/src/x.ts`) and URLs are not attachment
+ * links and are left alone.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { itemPaths, listAttachments } from './item-paths.js';
+/** Attachments above this size draw a Git LFS hint. */
+export const LARGE_ATTACHMENT_BYTES = 1024 * 1024;
+const MAX_REPORTED = 10;
+/** Markdown link or image targets: `[text](target)` and `![alt](target "title")`. */
+export const LINK_PATTERN = /!?\[[^\]]*\]\(\s*(?:<([^>\n]+)>|<?([^)\s>]+)>?)(?:\s+"[^"]*")?\s*\)/g;
+/** The target of a LINK_PATTERN match: the angle-bracket form (spaces allowed) or the bare one. */
+export function linkTarget(match) {
+    return match[1] ?? match[2] ?? '';
+}
+/** Drop fenced code blocks and inline code, where link syntax is an example, not a link. */
+export function stripCode(markdown) {
+    return markdown.replace(/```[\s\S]*?```|~~~[\s\S]*?~~~/g, '').replace(/`[^`\n]*`/g, '');
+}
+/** The attachment name a link target refers to, or null when it is not an attachment link. */
+export function attachmentTarget(target) {
+    const bare = target.replace(/^\.\//, '').replace(/[?#].*$/, '');
+    if (bare === '' || bare.includes('/') || bare.includes('\\') || bare.includes(':'))
+        return null;
+    try {
+        return decodeURIComponent(bare);
+    }
+    catch {
+        return bare;
+    }
+}
+/** Attachment names the master document links to that are not in the item folder. */
+export function findBrokenAttachmentLinks(devstepsDir, id) {
+    const paths = itemPaths(devstepsDir, id);
+    if (!existsSync(paths.description))
+        return [];
+    const broken = new Set();
+    for (const match of stripCode(readFileSync(paths.description, 'utf-8')).matchAll(LINK_PATTERN)) {
+        const name = attachmentTarget(linkTarget(match));
+        if (name && !existsSync(join(paths.dir, name)))
+            broken.add(name);
+    }
+    return [...broken];
+}
+function formatBytes(bytes) {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+export function detectAttachmentProblems(devstepsDir, ids) {
+    const broken = [];
+    const large = [];
+    for (const id of ids) {
+        for (const name of findBrokenAttachmentLinks(devstepsDir, id)) {
+            broken.push(`${id}: links ${name}, which is not in the item folder`);
+        }
+        for (const attachment of listAttachments(devstepsDir, id)) {
+            if (attachment.size > LARGE_ATTACHMENT_BYTES) {
+                large.push(`${id}/${attachment.name}: ${formatBytes(attachment.size)}`);
+            }
+        }
+    }
+    if (broken.length === 0 && large.length === 0) {
+        return { name: 'Attachments', status: 'pass', message: 'Every attachment link resolves' };
+    }
+    const parts = [];
+    if (broken.length > 0)
+        parts.push(`${broken.length} broken attachment link(s)`);
+    if (large.length > 0)
+        parts.push(`${large.length} attachment(s) above 1 MB`);
+    const details = [...broken, ...large];
+    return {
+        name: 'Attachments',
+        status: 'warn',
+        message: parts.join(', '),
+        details: details.length > MAX_REPORTED
+            ? [...details.slice(0, MAX_REPORTED), `… and ${details.length - MAX_REPORTED} more`]
+            : details,
+        ...(large.length > 0
+            ? {
+                fix: 'Track large binaries with Git LFS, e.g. `.gitattributes`: `.devsteps/items/**/*.png filter=lfs diff=lfs merge=lfs -text`',
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=doctor-attachments.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Classification drift: open items of required types without a registry
+ * category, proposed nodes nobody confirmed, and nodes hardly anyone uses.
+ *
+ * @see STORY-421 TASK-839
+ */
+import type { ItemMetadata } from '../schemas/index.js';
+import { type ClassificationRegistry } from './classification-registry.js';
+import type { CheckResult } from './doctor-types.js';
+export declare function detectClassificationDrift(items: Map<string, ItemMetadata>, registry: ClassificationRegistry | null, now?: number): CheckResult;
+//# sourceMappingURL=doctor-classification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-classification.d.ts","sourceRoot":"","sources":["../../src/core/doctor-classification.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,sBAAsB,EAAgB,MAAM,8BAA8B,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAChC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,EACvC,GAAG,SAAa,GACf,WAAW,CA0Cb"}

package/dist/core/doctor-classification.js

@@ -0,0 +1,55 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Classification drift: open items of required types without a registry
+ * category, proposed nodes nobody confirmed, and nodes hardly anyone uses.
+ *
+ * @see STORY-421 TASK-839
+ */
+import { UNCLASSIFIED } from './classification-registry.js';
+const MAX_REPORTED = 10;
+const PROPOSED_STALE_DAYS = 30;
+const OPEN = new Set(['draft', 'planned', 'in-progress', 'review', 'blocked']);
+export function detectClassificationDrift(items, registry, now = Date.now()) {
+    if (registry?.source !== 'project') {
+        return {
+            name: 'Classification',
+            status: 'pass',
+            message: 'No .devsteps/classification.json; nothing to check',
+        };
+    }
+    const required = new Set(registry.required.category ?? []);
+    const nodes = registry.category;
+    const details = [];
+    const usage = new Map(Object.keys(nodes).map((n) => [n, 0]));
+    for (const meta of items.values()) {
+        if (usage.has(meta.category))
+            usage.set(meta.category, (usage.get(meta.category) ?? 0) + 1);
+        if (!required.has(meta.type) || !OPEN.has(meta.status))
+            continue;
+        if (meta.category === UNCLASSIFIED || !(meta.category in nodes)) {
+            details.push(`${meta.id} (${meta.type}) category "${meta.category}" is not a registry node`);
+        }
+    }
+    const cutoff = now - PROPOSED_STALE_DAYS * 86_400_000;
+    for (const [name, spec] of Object.entries(nodes)) {
+        if (spec.status === 'proposed' && spec.created && new Date(spec.created).getTime() < cutoff) {
+            details.push(`node "${name}" has been proposed for more than ${PROPOSED_STALE_DAYS} days`);
+        }
+        if (spec.status !== 'deprecated' && (usage.get(name) ?? 0) <= 1) {
+            details.push(`node "${name}" carries ${usage.get(name) ?? 0} item(s)`);
+        }
+    }
+    if (details.length === 0) {
+        return { name: 'Classification', status: 'pass', message: 'Categories match the registry' };
+    }
+    return {
+        name: 'Classification',
+        status: 'warn',
+        message: `${details.length} classification finding(s)`,
+        details: details.slice(0, MAX_REPORTED),
+        fix: 'Set category with update; confirm, rename or deprecate nodes with the classification tool (CLI: devsteps classification <action> <name>)',
+    };
+}
+//# sourceMappingURL=doctor-classification.js.map

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

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

package/dist/core/doctor-commit-evidence-git.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bounded, offline Git inspection for persisted commit evidence (TASK-1072).
+ * Keep separate from closeout's runner: diagnostics never import or write objects.
+ */
+export declare const MAX_COMMIT_EVIDENCE_HASHES = 10000;
+export type CommitEvidenceState = 'normal' | 'archive' | 'local-only' | 'unresolvable' | 'incomplete';
+export interface CommitEvidenceFinding {
+    state: CommitEvidenceState;
+    reason?: string;
+}
+/**
+ * Inspect only the served root's local repository. Throws on any unavailable/incomplete query;
+ * callers report a warning, never reinterpret an execution failure as object absence.
+ */
+export declare function inspectCommitEvidence(workspaceRoot: string, hashes: readonly string[]): Map<string, CommitEvidenceFinding>;
+//# sourceMappingURL=doctor-commit-evidence-git.d.ts.map

package/dist/core/doctor-commit-evidence-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-commit-evidence-git.d.ts","sourceRoot":"","sources":["../../src/core/doctor-commit-evidence-git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAOjD,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0OD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CA2DpC"}

package/dist/core/doctor-commit-evidence-git.js

@@ -0,0 +1,278 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Bounded, offline Git inspection for persisted commit evidence (TASK-1072).
+ * Keep separate from closeout's runner: diagnostics never import or write objects.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, realpathSync, statSync } from 'node:fs';
+import { devNull } from 'node:os';
+import { join, relative, resolve } from 'node:path';
+export const MAX_COMMIT_EVIDENCE_HASHES = 10_000;
+const MAX_REFS = 20_000;
+const MAX_BUFFER = 8 * 1024 * 1024;
+const INSPECTION_TIMEOUT_MS = 15_000;
+const SHA = /^[0-9a-f]{40}$/;
+const ARCHIVE_PREFIXES = ['refs/tags/archive/', 'refs/archive/', 'refs/heads/rescue/'];
+/** Remove routing, tracing and caller config injection, including Windows' case-insensitive env. */
+function inspectionEnvironment() {
+    const env = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.toUpperCase().startsWith('GIT_')));
+    return {
+        ...env,
+        GIT_CONFIG_NOSYSTEM: '1',
+        GIT_CONFIG_GLOBAL: devNull,
+        GIT_OPTIONAL_LOCKS: '0',
+        GIT_TERMINAL_PROMPT: '0',
+        GIT_NO_LAZY_FETCH: '1',
+        GIT_NO_REPLACE_OBJECTS: '1',
+        GIT_ALLOW_PROTOCOL: '',
+        LC_ALL: 'C',
+    };
+}
+/** Every call shares one deadline and refuses incomplete output, including successful warnings. */
+function inspector(cwd) {
+    const deadline = Date.now() + INSPECTION_TIMEOUT_MS;
+    const env = inspectionEnvironment();
+    return (stage, args, input, allowAbsent = false) => {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            throw new Error(`Inspection time limit reached during ${stage}`);
+        const result = spawnSync('git', [
+            '--no-replace-objects',
+            '-c',
+            'core.longpaths=true',
+            '-c',
+            'core.quotepath=false',
+            '-c',
+            'protocol.allow=never',
+            '-c',
+            'core.commitGraph=false',
+            '-c',
+            'trace2.eventTarget=0',
+            '-c',
+            'trace2.perfTarget=0',
+            '-c',
+            'trace2.normalTarget=0',
+            ...args,
+        ], {
+            cwd,
+            env,
+            input,
+            encoding: 'utf8',
+            maxBuffer: MAX_BUFFER,
+            timeout: remaining,
+            windowsHide: true,
+        });
+        if (result.error) {
+            const code = result.error.code;
+            const reason = code === 'ENOENT'
+                ? 'Git executable unavailable'
+                : code === 'ETIMEDOUT'
+                    ? 'Inspection time limit reached'
+                    : code === 'ENOBUFS'
+                        ? 'Inspection output limit reached'
+                        : 'Git could not complete';
+            throw new Error(`${reason} during ${stage}`);
+        }
+        if ((result.status !== 0 && !(allowAbsent && result.status === 1)) ||
+            result.stderr.length > 0) {
+            // Never echo Git stderr: it can contain arbitrary configuration or repository content.
+            throw new Error(`Git could not complete ${stage}`);
+        }
+        return { status: result.status ?? -1, stdout: result.stdout };
+    };
+}
+function outputLine(output) {
+    if (!output.endsWith('\n') || output.slice(0, -1).includes('\n')) {
+        throw new Error('Git returned an unsupported repository context');
+    }
+    return output.slice(0, -1);
+}
+/** Configuration probes precede cat-file, revision peeling, graph traversal and worktree listing. */
+function assertCompleteClone(git) {
+    const partial = git('partial-clone configuration', ['config', '--get', 'extensions.partialClone'], undefined, true);
+    if (partial.status === 0) {
+        throw new Error('Partial-clone inspection is unavailable without risking an object import');
+    }
+    const promisor = git('promisor configuration', ['config', '--type=bool', '--null', '--get-regexp', '^remote\\..*\\.promisor$'], undefined, true);
+    for (const record of promisor.stdout.split('\0').filter(Boolean)) {
+        const separator = record.indexOf('\n');
+        const value = record.slice(separator + 1);
+        if (separator < 0 || (value !== 'true' && value !== 'false')) {
+            throw new Error('Promisor configuration could not be verified');
+        }
+        if (value === 'true') {
+            throw new Error('Promisor-clone inspection is unavailable without risking an object import');
+        }
+    }
+}
+function verifyRepository(cwd, git) {
+    const top = outputLine(git('repository root', ['rev-parse', '--show-toplevel']).stdout);
+    if (relative(cwd, realpathSync.native(top)) !== '') {
+        throw new Error('Served workspace is not the Git repository root; parent history was not inspected');
+    }
+    assertCompleteClone(git);
+    const worktrees = git('registered workspace', ['worktree', 'list', '--porcelain', '-z']).stdout;
+    const registered = worktrees.split('\0').some((field) => {
+        if (!field.startsWith('worktree '))
+            return false;
+        try {
+            return relative(cwd, realpathSync.native(field.slice(9))) === '';
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!registered)
+        throw new Error('Served workspace is not registered with this Git repository');
+    const format = outputLine(git('object format', ['rev-parse', '--show-object-format']).stdout);
+    if (format !== 'sha1')
+        throw new Error('Only SHA-1 commit evidence is supported');
+    const common = outputLine(git('repository metadata', ['rev-parse', '--git-common-dir']).stdout);
+    const grafts = join(resolve(cwd, common), 'info', 'grafts');
+    if (existsSync(grafts) && statSync(grafts).size > 0) {
+        throw new Error('Legacy grafted history cannot establish original commit reachability');
+    }
+    const shallow = outputLine(git('shallow-history state', ['rev-parse', '--is-shallow-repository']).stdout);
+    if (shallow !== 'true' && shallow !== 'false')
+        throw new Error('Shallow-history state is unavailable');
+    return shallow === 'true';
+}
+function snapshotRefs(git) {
+    const snapshot = { normal: new Set(), archive: new Set() };
+    const refs = new Set();
+    const output = git('reference inventory', [
+        'for-each-ref',
+        '--format=%(refname)%00%(objectname)',
+    ]).stdout;
+    const lines = output === '' ? [] : output.replace(/\n$/, '').split('\n');
+    if (lines.length > MAX_REFS)
+        throw new Error('Reference inventory exceeds the 20,000-ref limit');
+    for (const line of lines) {
+        const [name, hash, extra] = line.split('\0');
+        if (!name?.startsWith('refs/') || !hash || !SHA.test(hash) || extra !== undefined) {
+            throw new Error('Reference inventory is incomplete');
+        }
+        refs.add(name);
+        if (name.startsWith('refs/replace/'))
+            continue;
+        const bucket = ARCHIVE_PREFIXES.some((prefix) => name.startsWith(prefix))
+            ? snapshot.archive
+            : snapshot.normal;
+        bucket.add(hash);
+    }
+    const head = git('HEAD reference', ['rev-parse', '--verify', '--quiet', 'HEAD'], undefined, true);
+    if (head.status === 0) {
+        const hash = outputLine(head.stdout);
+        if (!SHA.test(hash))
+            throw new Error('HEAD reference is not a canonical SHA-1');
+        snapshot.normal.add(hash);
+    }
+    else {
+        const symbolic = git('unborn HEAD', ['symbolic-ref', '--quiet', 'HEAD']);
+        const name = outputLine(symbolic.stdout);
+        if (!name.startsWith('refs/heads/') || refs.has(name))
+            throw new Error('HEAD reference is unreadable');
+    }
+    return snapshot;
+}
+function objectTypes(git, queries) {
+    if (queries.length === 0)
+        return [];
+    const output = git('local object types', ['cat-file', '--batch-check=%(objectname) %(objecttype)'], `${queries.join('\n')}\n`).stdout;
+    const lines = output.replace(/\n$/, '').split('\n');
+    if (lines.length !== queries.length)
+        throw new Error('Local object inventory is incomplete');
+    return lines.map((line, index) => {
+        if (line === `${queries[index]} missing`)
+            return null;
+        const match = /^([0-9a-f]{40}) (commit|tree|blob|tag)$/.exec(line);
+        if (!match)
+            throw new Error('Local object inventory is incomplete');
+        if (SHA.test(queries[index]) && match[1] !== queries[index]) {
+            throw new Error('Local object inventory returned a different object');
+        }
+        return { hash: match[1], type: match[2] };
+    });
+}
+function reachable(git, roots, requested) {
+    if (roots.size === 0)
+        return new Set();
+    const output = git('commit graph', ['rev-list', '--stdin'], `${[...roots].join('\n')}\n`).stdout;
+    const found = new Set();
+    for (const line of output.split('\n')) {
+        if (line === '')
+            continue;
+        if (!SHA.test(line))
+            throw new Error('Commit graph inventory is incomplete');
+        if (requested.has(line))
+            found.add(line);
+    }
+    return found;
+}
+/**
+ * Inspect only the served root's local repository. Throws on any unavailable/incomplete query;
+ * callers report a warning, never reinterpret an execution failure as object absence.
+ */
+export function inspectCommitEvidence(workspaceRoot, hashes) {
+    const requested = new Set(hashes);
+    if (requested.size > MAX_COMMIT_EVIDENCE_HASHES || hashes.some((hash) => !SHA.test(hash))) {
+        throw new Error('Commit evidence exceeds the supported canonical SHA-1 inspection bounds');
+    }
+    if (requested.size === 0)
+        return new Map();
+    const cwd = realpathSync.native(workspaceRoot);
+    if (/[\r\n\0]/.test(cwd))
+        throw new Error('Repository paths containing line breaks are unsupported');
+    const git = inspector(cwd);
+    const shallow = verifyRepository(cwd, git);
+    const refs = snapshotRefs(git);
+    const rootHashes = [...new Set([...refs.normal, ...refs.archive])];
+    // ^{} peels annotated/nested tags, while valid tree/blob tags remain noncommit roots.
+    const roots = objectTypes(git, rootHashes.map((hash) => `${hash}^{}`));
+    const normalRoots = new Set();
+    const archiveRoots = new Set();
+    roots.forEach((object, index) => {
+        if (!object)
+            throw new Error('A reference target is not available locally');
+        if (object.type !== 'commit')
+            return;
+        if (refs.normal.has(rootHashes[index]))
+            normalRoots.add(object.hash);
+        if (refs.archive.has(rootHashes[index]))
+            archiveRoots.add(object.hash);
+    });
+    const normal = reachable(git, normalRoots, requested);
+    const archive = reachable(git, archiveRoots, requested);
+    const queried = [...requested];
+    const types = objectTypes(git, queried);
+    return new Map(queried.map((hash, index) => {
+        const object = types[index];
+        if ((normal.has(hash) || archive.has(hash)) && object?.type !== 'commit') {
+            throw new Error('Commit graph and local object inventory disagree');
+        }
+        const finding = normal.has(hash)
+            ? { state: 'normal' }
+            : archive.has(hash)
+                ? { state: 'archive' }
+                : shallow
+                    ? {
+                        state: 'incomplete',
+                        reason: 'Shallow history cannot establish negative reachability',
+                    }
+                    : object?.type === 'commit'
+                        ? {
+                            state: 'local-only',
+                            reason: 'No inspected ref reaches this commit; reflogs were not inspected',
+                        }
+                        : {
+                            state: 'unresolvable',
+                            reason: object
+                                ? `Local object is ${object.type}, not a commit`
+                                : 'Object is not available in the inspected local repository',
+                        };
+        return [hash, finding];
+    }));
+}
+//# sourceMappingURL=doctor-commit-evidence-git.js.map

package/dist/core/doctor-commit-evidence-git.js.map

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

package/dist/core/doctor-commit-evidence.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Read-only persisted commit-evidence diagnostics (TASK-1072 / STORY-526).
+ */
+import type { ItemMetadata } from '../schemas/index.js';
+import type { CheckResult } from './doctor-types.js';
+/** Shared doctor integration passes only schema-valid live items; archived item files are excluded. */
+export declare function detectCommitEvidence(devstepsDir: string, items: ReadonlyMap<string, Pick<ItemMetadata, 'commits'>>): Promise<CheckResult>;
+//# sourceMappingURL=doctor-commit-evidence.d.ts.map

package/dist/core/doctor-commit-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-commit-evidence.d.ts","sourceRoot":"","sources":["../../src/core/doctor-commit-evidence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqBrD,uGAAuG;AACvG,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,GACxD,OAAO,CAAC,WAAW,CAAC,CA8HtB"}