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

package/dist/core/coord-write.js

@@ -0,0 +1,210 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * `coord_write` (TASK-957): one action on one record. The server sets ID, status, times,
+ * version, expiry and writer; the state machines refuse illegal moves, and terminal records
+ * are immutable. A request is never refused for volume; designations and dispatches are capped.
+ */
+import { COORD_LIMITS, COORD_SCHEMA_VERSION, COORD_TERMINAL_STATUSES, } from '../schemas/coord.js';
+import { CoordRefusal, parseCoordWrite } from './coord-input.js';
+import { coordPaths } from './coord-paths.js';
+import { claimId, loadRecords, persistRecord } from './coord-store.js';
+import { coordHints, expiryFrom, isOpen } from './coord-summary.js';
+import { coordTargetKind } from './coord-target.js';
+import { readItemMetadata } from './item-store.js';
+export function coordWrite(devstepsDir, raw, options = {}) {
+    const action = parseCoordWrite(raw);
+    const paths = coordPaths(devstepsDir);
+    const { records, quarantined } = loadRecords(paths);
+    const now = (options.now ?? (() => new Date()))();
+    const retired = requireWriter(action, records);
+    const context = {
+        devstepsDir,
+        records,
+        writer: {
+            designation: action.designation,
+            client: options.client ?? 'unknown',
+            ...(retired ? { retired: true } : {}),
+        },
+        now: now.toISOString(),
+    };
+    const { record, previous, transition } = apply(action, context);
+    const id = previous === null ? claimId(paths, record.kind) : record.id;
+    const stored = { ...record, id, schema_version: COORD_SCHEMA_VERSION };
+    persistRecord(paths, stored, transition, previous);
+    const written = loadRecords(paths);
+    return {
+        record: stored,
+        transition,
+        hints: coordHints(written.records, now),
+        quarantined: [...quarantined, ...written.quarantined],
+    };
+}
+function apply(action, context) {
+    switch (action.kind) {
+        case 'designation':
+            if (action.action === 'register') {
+                if (openOf(context, 'designation').length >= COORD_LIMITS.openDesignations) {
+                    throw new CoordRefusal(`${COORD_LIMITS.openDesignations} designations are open; retire one first`);
+                }
+                if (findDesignation(context.records, action.fields.name)) {
+                    throw new CoordRefusal(`designation "${action.fields.name}" is already registered`);
+                }
+                refuseCaseTwin(context.records, action.fields.name);
+                return create(context, { kind: 'designation', status: 'open', ...action.fields }, 'register');
+            }
+            return nextVersion(context, target(context, action.fields.id, 'designation'), { status: 'retired' }, 'retire');
+        case 'handover': {
+            const current = context.records.find((record) => record.kind === 'handover' && record.slot === action.fields.slot);
+            const content = { kind: 'handover', status: 'current', ...action.fields };
+            return current
+                ? nextVersion(context, current, content, 'replace')
+                : create(context, content, 'write');
+        }
+        case 'request':
+            if (action.action === 'create') {
+                return create(context, { kind: 'request', status: 'open', ...action.fields }, 'create');
+            }
+            return acknowledge(context, action.fields);
+        case 'dispatch':
+            if (action.action === 'create')
+                return createDispatch(context, action.fields);
+            if (action.action === 'report')
+                return report(context, action.fields);
+            return nextVersion(context, target(context, action.fields.id, 'dispatch'), { status: 'closed' }, 'close');
+    }
+}
+function acknowledge(context, fields) {
+    const request = target(context, fields.id, 'request');
+    const needsTarget = fields.outcome === 'new-item' || fields.outcome === 'extends';
+    if (needsTarget && !fields.target_id) {
+        throw new CoordRefusal(`outcome ${fields.outcome} needs target_id, the item or record it went to`);
+    }
+    if (fields.target_id) {
+        const id = fields.target_id;
+        const kind = coordTargetKind(id);
+        if (id === request.id)
+            throw new CoordRefusal('a request cannot target itself');
+        if (fields.outcome === 'new-item' && kind !== 'item') {
+            throw new CoordRefusal('outcome new-item requires a work item as target_id');
+        }
+        if (kind === 'item')
+            requireItem(context, id, 'target_id');
+        else if (!kind) {
+            throw new CoordRefusal(`target_id ${id} is not a supported target; use an item, handover, request or dispatch, ` +
+                'never a designation');
+        }
+        else if (!context.records.some((record) => record.id === id && record.kind === kind)) {
+            throw new CoordRefusal(`target_id ${id} is not an existing ${kind} record`);
+        }
+    }
+    return nextVersion(context, request, { status: 'acknowledged', ...fields }, 'acknowledge');
+}
+function createDispatch(context, fields) {
+    if (!findDesignation(context.records, fields.holder)) {
+        throw new CoordRefusal(`holder "${fields.holder}" is not a registered open designation`);
+    }
+    requireItem(context, fields.item_id, 'item_id');
+    const open = openOf(context, 'dispatch');
+    const duplicate = open.find((d) => d.item_id === fields.item_id && d.holder === fields.holder);
+    if (duplicate) {
+        throw new CoordRefusal(`${duplicate.id} already dispatches ${fields.item_id}; report on it`);
+    }
+    if (open.length >= COORD_LIMITS.openDispatches) {
+        throw new CoordRefusal(`${COORD_LIMITS.openDispatches} dispatches are open; close finished ones first`);
+    }
+    return create(context, { kind: 'dispatch', status: 'dispatched', ...fields }, 'dispatch');
+}
+function report(context, fields) {
+    const dispatch = target(context, fields.id, 'dispatch');
+    if (fields.status_text === undefined && fields.verdict === undefined) {
+        throw new CoordRefusal('report needs status_text, verdict, or both');
+    }
+    if ((fields.verdict === 'DONE' || fields.verdict === 'PASS') && !fields.evidence_ref) {
+        throw new CoordRefusal(`${fields.verdict} needs evidence_ref: a commit SHA or an item ID`);
+    }
+    if (fields.evidence_ref && !/^[0-9a-f]{7,40}$/.test(fields.evidence_ref)) {
+        requireItem(context, fields.evidence_ref, 'evidence_ref');
+    }
+    const status = fields.verdict ? 'reported' : dispatch.status;
+    return nextVersion(context, dispatch, { ...fields, status }, fields.verdict ? 'report' : 'status');
+}
+function create(context, content, transition) {
+    const record = {
+        ...content,
+        id: 'pending',
+        created_at: context.now,
+        updated_at: context.now,
+        version: 1,
+        expires_at: null,
+        writer: context.writer,
+    };
+    return { record, previous: null, transition };
+}
+/** A new version of `current`; a move into a terminal status starts its retention. */
+export function nextVersion(context, current, changes, transition) {
+    if (COORD_TERMINAL_STATUSES.has(current.status)) {
+        throw new CoordRefusal(`${current.id} is ${current.status}; a finished record does not change`);
+    }
+    const { id: _id, ...content } = changes;
+    const status = content.status ?? current.status;
+    const record = {
+        ...current,
+        ...content,
+        updated_at: context.now,
+        version: current.version + 1,
+        expires_at: COORD_TERMINAL_STATUSES.has(status) ? expiryFrom(new Date(context.now)) : null,
+        writer: context.writer,
+    };
+    return { record, previous: current.version, transition };
+}
+/** Refuse an unknown writer; true when a retired designation writes its handover (BUG-200). */
+function requireWriter(action, records) {
+    // Only a coordinator registers itself: that is how the registry starts, and how a
+    // successor coordinator joins. Every other designation is registered by an open one.
+    const selfRegistration = action.kind === 'designation' &&
+        action.action === 'register' &&
+        action.fields.role === 'coordinator' &&
+        action.fields.name === action.designation;
+    if (selfRegistration || findDesignation(records, action.designation))
+        return false;
+    const retired = records.some((r) => r.kind === 'designation' && r.status === 'retired' && r.name === action.designation);
+    // The handover belongs to role and area, so a session that retired first still leaves it.
+    if (retired && action.kind === 'handover')
+        return true;
+    throw new CoordRefusal(retired
+        ? `designation "${action.designation}" is retired; it writes only its handover`
+        : `designation "${action.designation}" is not registered; the coordinator registers it ` +
+            '(kind designation, action register)');
+}
+function findDesignation(records, name) {
+    return records.find((r) => r.kind === 'designation' && r.status === 'open' && r.name === name);
+}
+/** One name per session (TASK-1008): a live designation differing only in case blocks it. */
+function refuseCaseTwin(records, name) {
+    const folded = name.toLowerCase();
+    const twin = records.find((r) => r.kind === 'designation' && r.status === 'open' && r.name.toLowerCase() === folded);
+    if (twin?.kind === 'designation') {
+        throw new CoordRefusal(`designation "${name}" differs from the live "${twin.name}" (${twin.id}) only in case; ` +
+            `use "${twin.name}"`);
+    }
+}
+function openOf(context, kind) {
+    return context.records.filter((record) => record.kind === kind && isOpen(record));
+}
+function target(context, id, kind) {
+    const record = context.records.find((candidate) => candidate.id === id);
+    if (!record || record.kind !== kind)
+        throw new CoordRefusal(`${id} is not a ${kind} record`);
+    return record;
+}
+function requireItem(context, id, field) {
+    try {
+        readItemMetadata(context.devstepsDir, id);
+    }
+    catch {
+        throw new CoordRefusal(`${field} ${id} is not an existing item`);
+    }
+}
+//# sourceMappingURL=coord-write.js.map

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

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

package/dist/core/coordination-text.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Detector for coordination text in work items (BUG-153, TASK-958).
+ *
+ * A work item holds what stays true after the work ends. Queue order, dispatch state,
+ * rosters, session addresses, handovers, and messages between sessions are valid only
+ * until the next step; they belong in the role's handover doc (a `doc` tagged
+ * `handover`). This module finds such text so `add`, `update`, and `doctor` can warn
+ * in band. It never refuses a write: every finding is a warning.
+ */
+export type CoordinationFindingKind = 'session-log-section' | 'session-address' | 'roster-line' | 'message-header';
+export interface CoordinationFinding {
+    kind: CoordinationFindingKind;
+    /** 1-based line number within the scanned text. */
+    line: number;
+    /** The offending line, trimmed and shortened. */
+    text: string;
+}
+/** The item tag that marks a role's handover record. */
+export declare const HANDOVER_TAG = "handover";
+/**
+ * The slug Claude Code derives a session address from: the workspace folder name,
+ * lowercased (`devsteps` → addresses `devsteps-cf`).
+ */
+export declare function projectSlugFromDevstepsDir(devstepsDir: string): string;
+/**
+ * Find coordination text in Markdown: session-log headings, session addresses,
+ * roster lines (three or more role designations, or a designation bound with `=`), and
+ * pasted message header lines.
+ */
+export declare function detectCoordinationText(markdown: string, options?: {
+    projectSlug?: string;
+}): CoordinationFinding[];
+/**
+ * Findings in `next` whose line does not already occur in `previous`. Compares the full line,
+ * because a finding's `text` is cut to MAX_TEXT for display (TASK-958).
+ */
+export declare function detectAddedCoordinationText(previous: string, next: string, options?: {
+    projectSlug?: string;
+}): CoordinationFinding[];
+/** True when an item of this type is a work item the detector applies to. */
+export declare function isWorkItemType(type: string): boolean;
+/** P1: the handover tag on a non-doc item, as one warning sentence, or null. */
+export declare function handoverTagWarning(id: string, type: string, tags: readonly string[]): string | null;
+/** P2: one warning sentence summarising the findings in a work item, or null. */
+export declare function coordinationTextWarning(id: string, findings: readonly CoordinationFinding[]): string | null;
+//# sourceMappingURL=coordination-text.d.ts.map

package/dist/core/coordination-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination-text.d.ts","sourceRoot":"","sources":["../../src/core/coordination-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,uBAAuB,GAC/B,qBAAqB,GACrB,iBAAiB,GACjB,aAAa,GACb,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wDAAwD;AACxD,eAAO,MAAM,YAAY,aAAa,CAAC;AAsCvC;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAItE;AA2ED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,mBAAmB,EAAE,CAWvB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,mBAAmB,EAAE,CAMvB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,GAAG,IAAI,CAGf;AAWD,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GACvC,MAAM,GAAG,IAAI,CAQf"}

package/dist/core/coordination-text.js

@@ -0,0 +1,159 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Detector for coordination text in work items (BUG-153, TASK-958).
+ *
+ * A work item holds what stays true after the work ends. Queue order, dispatch state,
+ * rosters, session addresses, handovers, and messages between sessions are valid only
+ * until the next step; they belong in the role's handover doc (a `doc` tagged
+ * `handover`). This module finds such text so `add`, `update`, and `doctor` can warn
+ * in band. It never refuses a write: every finding is a warning.
+ */
+import { basename, dirname } from 'node:path';
+/** The item tag that marks a role's handover record. */
+export const HANDOVER_TAG = 'handover';
+const ROLE_WORD = '(?:coordinator|koordinator|architect|architekt|engineer|integrator|liaison|session)';
+const LOG_KEYWORD = String.raw `(?:handover|takeover|dispatch(?:\s+log)?|check-in|pending\s+reports?|queue|assignments|next\s+steps|roster|requests)`;
+/**
+ * A heading whose subject is session state: `## Dispatch (K7)`, `## Queue / merge order`,
+ * `## Coordinator 5 dispatch log`, `## Handover E2 (…)`, `## Batch 2 on main`. The keyword
+ * leads the heading or follows a role word, and is followed by nothing, punctuation, a
+ * date, a designation, or a preposition — so `## Event Bus Dispatch`, `## Routing Logic`,
+ * or `### Handover items` (product subjects) do not match.
+ */
+const SESSION_LOG_HEADING = new RegExp(String.raw `^#{2,3}\s+(?:[\p{L}-]*${ROLE_WORD}\s+(?:[\p{L}\d]{1,3}\s+)?)?${LOG_KEYWORD}\s*(?:$|[(:/—–\-~]|\d|[EK]-?\d|(?:to|for|from|and|of)\b)|^#{2,3}\s+batch(?:es)?\b.*\bon main\b`, 'iu');
+/** The header line of a cross-session message: `DS Koordinator K8 → E2 · TASK-1 · DONE`. */
+const MESSAGE_HEADER = /^\S.*? · [A-Z]+-\d+ · (?:ACK|DONE|PASS|FAIL|BLOCKED|DECIDE)\b/;
+/** A role designation with its role word: `Coordinator K7`, `Engineer E1`, `Liaison L1`. */
+const ROLE_DESIGNATION = /\b(?:coordinator|koordinator|architect|architekt|engineer|liaison|integrator)\s+[A-Z]{1,2}-?[0-9][0-9a-z]?\b/giu;
+/**
+ * `E1 = …` or `Coordinator K7 = …`: a designation bound to an address or a lane. Short
+ * forms are limited to engineers and coordinators, case-sensitive, so levels like
+ * `L1 = …` or tokens like `k8s` never match.
+ */
+const DESIGNATION_ASSIGNMENT = /(?:\b[EK]-?[0-9][0-9a-z]?|\b(?:[Cc]oordinator|[Kk]oordinator|[Aa]rchitect|[Aa]rchitekt|[Ee]ngineer|[Ll]iaison)\s+[A-Z]{1,2}-?[0-9][0-9a-z]?)\s*=\s*\S/u;
+const MAX_TEXT = 100;
+/** Three designations on one line make a roster; two are an ordinary sentence. */
+const MIN_ROSTER_DESIGNATIONS = 3;
+/**
+ * The slug Claude Code derives a session address from: the workspace folder name,
+ * lowercased (`devsteps` → addresses `devsteps-cf`).
+ */
+export function projectSlugFromDevstepsDir(devstepsDir) {
+    return basename(dirname(devstepsDir))
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-');
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+const SESSION_CONTEXT = new RegExp(`${ROLE_WORD}|→|\\baddress\\b`, 'iu');
+const PROVENANCE_VERB = '(?:reviewed|reported|verified|accepted|authored|implemented|identified|assessed|confirmed|observed|recorded|noted)';
+const LIVE_COORDINATION = /[→=]|\b(?:owns?|assigned|assignments?|dispatch|routes?|send|address|handover|contact|waiting|pending)\b|\bnext\s+(?:steps?|sessions?|assignments?|dispatch)\b/iu;
+function sessionAddressPatterns(projectSlug) {
+    if (!projectSlug)
+        return null;
+    const slug = escapeRegExp(projectSlug);
+    return {
+        lettered: new RegExp(`(?<![\\w-])${slug}-(?=[0-9a-f]*[a-f])[0-9a-f]{2}(?![\\w-])`, 'i'),
+        numeric: new RegExp(`(?<![\\w-])${slug}-[0-9]{2}(?![\\w-])`, 'i'),
+    };
+}
+function hasSessionAddress(prose, address) {
+    if (!address)
+        return false;
+    return (address.lettered.test(prose) || (address.numeric.test(prose) && SESSION_CONTEXT.test(prose)));
+}
+/** Remove only attributed historical addresses, leaving other addresses on the line visible. */
+function withoutProvenance(prose, address) {
+    if (!address || LIVE_COORDINATION.test(prose))
+        return prose;
+    const token = `(?:${address.lettered.source}|${address.numeric.source})`;
+    const attributed = new RegExp(`(\\b${PROVENANCE_VERB}\\s+(?:by|from)\\s+(?:${ROLE_WORD}\\s+)?|\\b(?:source|provenance):\\s*)${token}`, 'gi');
+    const reporting = new RegExp(`${token}(\\s+${PROVENANCE_VERB}\\b)`, 'gi');
+    return prose.replace(attributed, '$1').replace(reporting, '$1');
+}
+/** Lines inside fenced code blocks are examples, not coordination state. */
+function codeFenceMask(lines) {
+    const mask = [];
+    let inFence = false;
+    for (const line of lines) {
+        const fence = /^\s*(```|~~~)/.test(line);
+        mask.push(inFence || fence);
+        if (fence)
+            inFence = !inFence;
+    }
+    return mask;
+}
+function classifyLine(line, address) {
+    if (SESSION_LOG_HEADING.test(line))
+        return 'session-log-section';
+    if (MESSAGE_HEADER.test(line))
+        return 'message-header';
+    // Inline code quotes an example (`devsteps-fa`), not a live address or roster.
+    const prose = line.replace(/`[^`\n]*`/g, '');
+    if (hasSessionAddress(withoutProvenance(prose, address), address))
+        return 'session-address';
+    if (DESIGNATION_ASSIGNMENT.test(prose))
+        return 'roster-line';
+    const designations = new Set((prose.match(ROLE_DESIGNATION) ?? []).map((match) => match.split(/\s+/).pop() ?? match));
+    return designations.size >= MIN_ROSTER_DESIGNATIONS ? 'roster-line' : null;
+}
+/**
+ * Find coordination text in Markdown: session-log headings, session addresses,
+ * roster lines (three or more role designations, or a designation bound with `=`), and
+ * pasted message header lines.
+ */
+export function detectCoordinationText(markdown, options = {}) {
+    const address = sessionAddressPatterns(options.projectSlug);
+    const lines = markdown.split(/\r?\n/);
+    const inCode = codeFenceMask(lines);
+    const findings = [];
+    lines.forEach((line, index) => {
+        if (inCode[index])
+            return;
+        const kind = classifyLine(line, address);
+        if (kind)
+            findings.push({ kind, line: index + 1, text: line.trim().slice(0, MAX_TEXT) });
+    });
+    return findings;
+}
+/**
+ * Findings in `next` whose line does not already occur in `previous`. Compares the full line,
+ * because a finding's `text` is cut to MAX_TEXT for display (TASK-958).
+ */
+export function detectAddedCoordinationText(previous, next, options = {}) {
+    const known = new Set(previous.split(/\r?\n/).map((line) => line.trim()));
+    const nextLines = next.split(/\r?\n/);
+    return detectCoordinationText(next, options).filter((finding) => !known.has((nextLines[finding.line - 1] ?? '').trim()));
+}
+/** True when an item of this type is a work item the detector applies to. */
+export function isWorkItemType(type) {
+    return type !== 'doc';
+}
+/** P1: the handover tag on a non-doc item, as one warning sentence, or null. */
+export function handoverTagWarning(id, type, tags) {
+    if (!isWorkItemType(type) || !tags.includes(HANDOVER_TAG))
+        return null;
+    return `${id} is a ${type} tagged "${HANDOVER_TAG}"; a role's handover lives in a doc item tagged "${HANDOVER_TAG}" (add type "doc", tags ["${HANDOVER_TAG}"]), and the work item keeps decisions, evidence, and commits.`;
+}
+const KIND_LABEL = {
+    'session-log-section': 'session-log heading',
+    'session-address': 'session address',
+    'roster-line': 'roster line',
+    'message-header': 'message header',
+};
+const MAX_LISTED = 3;
+/** P2: one warning sentence summarising the findings in a work item, or null. */
+export function coordinationTextWarning(id, findings) {
+    if (findings.length === 0)
+        return null;
+    const listed = findings
+        .slice(0, MAX_LISTED)
+        .map((finding) => `${KIND_LABEL[finding.kind]} at line ${finding.line} "${finding.text}"`)
+        .join('; ');
+    const more = findings.length > MAX_LISTED ? ` and ${findings.length - MAX_LISTED} more` : '';
+    return `${id} received coordination text (${listed}${more}); queue order, dispatch state, rosters, and handovers belong in the role's handover doc (a doc tagged "${HANDOVER_TAG}"), and the work item keeps decisions, evidence, and commits.`;
+}
+//# sourceMappingURL=coordination-text.js.map

package/dist/core/coordination-text.js.map

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

package/dist/core/counter-lock-owner.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Internal ownership/path inspection for the counter-store protocol (DEC-092).
+ */
+import type { CounterLockOwner, CounterLockStatus } from './counter-lock-types.js';
+export declare const OWNER_FILE = "owner.json";
+export type Store = {
+    devstepsDir: string;
+    index: string;
+    rootId: string;
+    indexId: string;
+    realRoot: string;
+    realIndex: string;
+};
+export type Owned = {
+    id: string;
+    ownerId: string;
+    owner: CounterLockOwner;
+};
+export declare class OwnershipTurnoverError extends Error {
+}
+export declare function missing(error: unknown): boolean;
+export declare function errorText(error: unknown): string;
+export declare function pathExists(path: string): boolean;
+export declare function plainDirectory(path: string): string;
+export declare function captureStore(devstepsDir: string): Store;
+export declare function assertStore(store: Store): void;
+export declare function inspectOwned(store: Store, path: string): Owned;
+export declare function verifyOwned(store: Store, path: string, expected: Owned): void;
+export declare function baseStatus(devstepsDir: string): CounterLockStatus;
+//# sourceMappingURL=counter-lock-owner.d.ts.map

package/dist/core/counter-lock-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-lock-owner.d.ts","sourceRoot":"","sources":["../../src/core/counter-lock-owner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEnF,eAAO,MAAM,UAAU,eAAe,CAAC;AAUvC,MAAM,MAAM,KAAK,GAAG;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,MAAM,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAC7E,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AAIpD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE/C;AACD,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQhD;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AACD,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAWvD;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAS9C;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAgD9D;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,CAQ7E;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CASjE"}

package/dist/core/counter-lock-owner.js

@@ -0,0 +1,129 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Internal ownership/path inspection for the counter-store protocol (DEC-092).
+ */
+import { closeSync, constants, fstatSync, lstatSync, openSync, readdirSync, readFileSync, realpathSync, } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { z } from 'zod';
+export const OWNER_FILE = 'owner.json';
+const ownerSchema = z.strictObject({
+    schema_version: z.literal(1),
+    token: z.string().regex(/^[0-9a-f]{64}$/),
+    pid: z.number().int().positive(),
+    process_nonce: z.string().regex(/^[0-9a-f]{64}$/),
+    hostname: z.string().min(1).max(255),
+    started_at: z.string().datetime(),
+});
+export class OwnershipTurnoverError extends Error {
+}
+function id(stat) {
+    return `${stat.dev}:${stat.ino}`;
+}
+export function missing(error) {
+    return error?.code === 'ENOENT';
+}
+export function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function pathExists(path) {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch (error) {
+        if (missing(error))
+            return false;
+        throw error;
+    }
+}
+export function plainDirectory(path) {
+    const stat = lstatSync(path, { bigint: true });
+    if (stat.isSymbolicLink() || !stat.isDirectory())
+        throw new Error(`Not a plain directory: ${path}`);
+    return id(stat);
+}
+export function captureStore(devstepsDir) {
+    const root = resolve(devstepsDir), index = join(root, 'index');
+    return {
+        devstepsDir: root,
+        index,
+        rootId: plainDirectory(root),
+        indexId: plainDirectory(index),
+        realRoot: realpathSync(root),
+        realIndex: realpathSync(index),
+    };
+}
+export function assertStore(store) {
+    if (plainDirectory(store.devstepsDir) !== store.rootId ||
+        plainDirectory(store.index) !== store.indexId ||
+        realpathSync(store.devstepsDir) !== store.realRoot ||
+        realpathSync(store.index) !== store.realIndex) {
+        throw new Error(`Physical counter store identity changed: ${store.index}`);
+    }
+}
+export function inspectOwned(store, path) {
+    assertStore(store);
+    const directoryId = plainDirectory(path);
+    const names = readdirSync(path);
+    if (names.length !== 1 || names[0] !== OWNER_FILE)
+        throw new Error(`Unexpected ownership contents at ${path}; expected only ${OWNER_FILE}`);
+    const ownerPath = join(path, OWNER_FILE);
+    const before = lstatSync(ownerPath, { bigint: true });
+    if (before.isSymbolicLink() || !before.isFile() || before.nlink !== 1n || before.size > 4096n)
+        throw new Error(`Unsafe owner file: ${ownerPath}`);
+    const fd = openSync(ownerPath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+    let owner;
+    try {
+        const opened = fstatSync(fd, { bigint: true });
+        if (id(opened) !== id(before) ||
+            opened.size !== before.size ||
+            opened.mtimeNs !== before.mtimeNs ||
+            opened.ctimeNs !== before.ctimeNs) {
+            if (plainDirectory(path) !== directoryId)
+                throw new OwnershipTurnoverError(`Ownership directory changed: ${path}`);
+            throw new Error(`Owner file identity changed without directory turnover: ${ownerPath}`);
+        }
+        owner = ownerSchema.parse(JSON.parse(readFileSync(fd, 'utf8')));
+        const after = fstatSync(fd, { bigint: true });
+        if (id(after) !== id(before) ||
+            after.size !== before.size ||
+            after.mtimeNs !== before.mtimeNs ||
+            after.ctimeNs !== before.ctimeNs) {
+            if (plainDirectory(path) !== directoryId)
+                throw new OwnershipTurnoverError(`Ownership directory changed: ${path}`);
+            throw new Error(`Owner changed during read: ${ownerPath}`);
+        }
+    }
+    finally {
+        closeSync(fd);
+    }
+    if (plainDirectory(path) !== directoryId)
+        throw new OwnershipTurnoverError(`Ownership directory changed: ${path}`);
+    if (id(lstatSync(ownerPath, { bigint: true })) !== id(before)) {
+        if (plainDirectory(path) !== directoryId)
+            throw new OwnershipTurnoverError(`Ownership directory changed: ${path}`);
+        throw new Error(`Ownership file changed: ${path}`);
+    }
+    assertStore(store);
+    return { id: directoryId, ownerId: id(before), owner };
+}
+export function verifyOwned(store, path, expected) {
+    const observed = inspectOwned(store, path);
+    if (observed.id !== expected.id ||
+        observed.ownerId !== expected.ownerId ||
+        JSON.stringify(observed.owner) !== JSON.stringify(expected.owner))
+        throw new Error(`Ownership identity changed: ${path}`);
+}
+export function baseStatus(devstepsDir) {
+    return {
+        state: 'unlocked',
+        lockPath: join(resolve(devstepsDir), 'index', 'counters.lock'),
+        issues: [],
+        orphans: [],
+        orphansOmitted: 0,
+        hint: 'No counter lock is held. Status never removes ownership or orphan paths.',
+    };
+}
+//# sourceMappingURL=counter-lock-owner.js.map

package/dist/core/counter-lock-owner.js.map

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