@decibelsystems/tools 2.2.0-beta.0 → 3.1.0

package/dist/domain/issueRepository.js

@@ -0,0 +1,296 @@
+// ============================================================================
+// Issue repository — EPIC-0038 Phase 3
+// ============================================================================
+// The seam between "what an issue is" and "where issues live".
+//
+// Callers ask for issues by id and get back canonical Issue objects. They do
+// not learn whether a record was markdown-with-frontmatter or bare YAML, which
+// directory it came from, or how its id was resolved. That is the whole point:
+// Phase 5 converges the on-disk format and should be a change to the codec and
+// this file only, and a future SupabaseIssueRepository should be a sibling
+// rather than a rewrite of every caller.
+//
+// Resolution is the subtle part. An id can name more than one record — four
+// duplicate groups existed before Phase 2 repaired them — and the historical
+// failure mode was `files.find(...)` picking whichever the directory listing
+// happened to yield first, so writers had an undefined target and reported
+// success either way. Ambiguity is therefore an error here, never a guess.
+// ============================================================================
+import { promises as fs } from 'fs';
+import path from 'path';
+import { writeFileAtomic } from '../lib/atomicWrite.js';
+import { allocateAndWriteIssue } from '../lib/recordIdAllocator.js';
+import { listDirOrThrow } from '../tools/shared/storeRead.js';
+import { isLive, newUid, } from './issue.js';
+import { decodeIssue, encodeIssue, } from './issueCodec.js';
+export class AmbiguousIssueIdError extends Error {
+    issueId;
+    candidates;
+    code = 'AMBIGUOUS_ISSUE_ID';
+    constructor(issueId, candidates) {
+        super(`Issue id ${issueId} matches ${candidates.length} records: ${candidates.join(', ')}. ` +
+            `Name one by filename, or by its uid, to disambiguate.`);
+        this.issueId = issueId;
+        this.candidates = candidates;
+        this.name = 'AmbiguousIssueIdError';
+    }
+}
+export class IssueNotFoundError extends Error {
+    issueId;
+    code = 'ISSUE_NOT_FOUND';
+    constructor(issueId) {
+        super(`Issue ${issueId} not found.`);
+        this.issueId = issueId;
+        this.name = 'IssueNotFoundError';
+    }
+}
+const RECORD_RE = /\.(md|ya?ml)$/i;
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 50);
+}
+export class FsIssueRepository {
+    issuesDir;
+    constructor(issuesDir) {
+        this.issuesDir = issuesDir;
+    }
+    async readAll() {
+        // ISS-0153. ENOENT is the only error that means "empty": a directory that
+        // was never created is what an untouched project looks like. EACCES,
+        // EPERM, EIO and the rest mean the issues may well be there and this
+        // process cannot see them — returning [] there reported "no issues" for a
+        // store it could not open, and list_issues is the read most likely to be
+        // believed.
+        const names = await listDirOrThrow(this.issuesDir, (f) => RECORD_RE.test(f));
+        const out = [];
+        for (const filename of names) {
+            const full = path.join(this.issuesDir, filename);
+            let content;
+            try {
+                content = await fs.readFile(full, 'utf-8');
+            }
+            catch {
+                continue; // Unreadable record: skip rather than fail the whole listing.
+            }
+            const decoded = decodeIssue(filename, content);
+            out.push({
+                issue: decoded.issue,
+                filename,
+                path: full,
+                format: decoded.format,
+                warnings: decoded.warnings,
+            });
+        }
+        return out;
+    }
+    /**
+     * Duplicate detection deliberately runs over EVERY record, never a filtered
+     * subset: a closed twin still makes an id ambiguous for writers, so filtering
+     * it out of a listing must not filter it out of the collision report.
+     */
+    async integrity() {
+        const all = await this.readAll();
+        const malformed = [];
+        const degraded = [];
+        const claims = new Map();
+        for (const r of all) {
+            const unparseable = r.warnings.some((w) => w.includes('did not parse'));
+            if (unparseable)
+                malformed.push(r.filename);
+            else if (r.warnings.length > 0)
+                degraded.push({ filename: r.filename, warnings: r.warnings });
+            const key = r.issue.id.toUpperCase();
+            claims.set(key, [...(claims.get(key) ?? []), r.filename]);
+        }
+        const duplicateIds = {};
+        for (const [id, files] of claims)
+            if (files.length > 1)
+                duplicateIds[id] = files;
+        return { malformed, degraded, duplicateIds };
+    }
+    async list(filter = {}) {
+        // A record that did not parse is not an issue — returning it would hand
+        // callers a husk built from filename fallbacks. It is still counted by
+        // integrity(), so the file is reported rather than silently dropped.
+        let all = (await this.readAll()).filter((r) => !r.warnings.some((w) => w.includes('did not parse')));
+        if (filter.status)
+            all = all.filter((r) => r.issue.status === filter.status);
+        if (filter.liveOnly)
+            all = all.filter((r) => isLive(r.issue.status));
+        if (filter.epicId)
+            all = all.filter((r) => r.issue.epicId === filter.epicId);
+        return all;
+    }
+    /**
+     * Resolve an id to exactly one record, in tiers of decreasing specificity.
+     *
+     * Only the first non-empty tier is considered, and ambiguity is reported
+     * within a tier rather than across tiers — so naming a record by its filename
+     * stays a reliable way to pick one member of a duplicate pair even while the
+     * shared ISS-NNNN remains ambiguous. uid is checked first because it is the
+     * only identifier guaranteed unique by construction.
+     */
+    async resolve(idOrFilename) {
+        const all = await this.readAll();
+        const needle = idOrFilename.trim();
+        const upper = needle.toUpperCase();
+        const byUid = all.filter((r) => r.issue.uid && r.issue.uid === needle);
+        if (byUid.length > 0)
+            return byUid;
+        const byFilename = all.filter((r) => r.filename.toUpperCase() === upper);
+        if (byFilename.length > 0)
+            return byFilename;
+        // Filename without the extension, which is how list output used to name records.
+        const byStem = all.filter((r) => r.filename.replace(RECORD_RE, '').toUpperCase() === upper.replace(RECORD_RE, ''));
+        if (byStem.length > 0)
+            return byStem;
+        // ISS-NNNN, requiring the id to end at a separator or the extension. A bare
+        // startsWith made "ISS-011" swallow ISS-0110, ISS-0112 and ISS-0119.
+        const byId = all.filter((r) => {
+            if (r.issue.id.toUpperCase() === upper)
+                return true;
+            const base = r.filename.toUpperCase();
+            if (!base.startsWith(upper))
+                return false;
+            const rest = base.slice(upper.length);
+            return rest === '' || rest.startsWith('-') || /^\.(MD|YA?ML)$/.test(rest);
+        });
+        if (byId.length > 0)
+            return byId;
+        // Last tier: a partial id like "ISS-011", which is a prefix of ISS-0110,
+        // ISS-0112 and ISS-0119. The boundary rule above deliberately refuses to
+        // resolve it, but refusing is not the same as saying nothing is there —
+        // "not found" would be a misleading answer when three records obviously
+        // start with it. So a loose prefix is reported as a collision when it spans
+        // several records, and is NEVER resolved to a single one: silently picking
+        // one is the swallow bug this whole tier system exists to prevent.
+        const loose = all.filter((r) => r.filename.toUpperCase().startsWith(upper));
+        return loose.length > 1 ? loose : [];
+    }
+    async get(idOrFilename) {
+        const matches = await this.resolve(idOrFilename);
+        if (matches.length === 0)
+            return null;
+        if (matches.length > 1) {
+            throw new AmbiguousIssueIdError(idOrFilename, matches.map((m) => m.filename));
+        }
+        return matches[0];
+    }
+    async requireOne(idOrFilename) {
+        const found = await this.get(idOrFilename);
+        if (!found)
+            throw new IssueNotFoundError(idOrFilename);
+        return found;
+    }
+    async create(spec) {
+        const now = new Date().toISOString();
+        const slug = slugify(spec.title);
+        // Allocation and write happen under one cross-process lock (Phase 1). Every
+        // new record gets a uid at birth, so the backfill only ever has to deal
+        // with records that predate this path.
+        const issue = {
+            uid: newUid(),
+            id: 'ISS-PENDING',
+            title: spec.title,
+            status: 'open',
+            severity: spec.severity,
+            priority: spec.priority,
+            tags: spec.tags,
+            assignee: spec.assignee,
+            team: spec.team,
+            epicId: spec.epicId,
+            project: spec.project,
+            details: spec.details,
+            created_at: now,
+        };
+        const build = (issueId) => {
+            const body = [
+                // First line only — a heading ends at the newline, so the rest would
+                // land in the body as stray prose. encodeIssue writes the whole title
+                // to frontmatter when it does not fit here.
+                `# ${spec.title.split(/\r?\n/)[0]}`,
+                '',
+                `**Severity:** ${spec.severity}`,
+                `**Status:** open`,
+                ...(spec.epicId ? [`**Epic:** ${spec.epicId}`] : []),
+                '',
+                '## Details',
+                '',
+                spec.details,
+                '',
+            ].join('\n');
+            const decoded = {
+                issue: { ...issue, id: issueId },
+                format: 'md',
+                raw: { data: {}, body },
+                warnings: [],
+            };
+            return encodeIssue(decoded);
+        };
+        const allocated = await allocateAndWriteIssue(this.issuesDir, 'md', slug, build);
+        return this.requireOne(allocated.filename);
+    }
+    async update(idOrFilename, changes) {
+        const current = await this.requireOne(idOrFilename);
+        const content = await fs.readFile(current.path, 'utf-8');
+        const decoded = decodeIssue(current.filename, content);
+        const updated = {
+            ...decoded,
+            issue: {
+                ...decoded.issue,
+                ...changes,
+                // Identity is not editable through update. Renumbering is a migration.
+                uid: decoded.issue.uid ?? changes.uid,
+                id: decoded.issue.id,
+                updated_at: new Date().toISOString(),
+            },
+        };
+        await writeFileAtomic(current.path, encodeIssue(updated));
+        return this.requireOne(current.filename);
+    }
+    /**
+     * Close a record, or report that it was already closed without touching what
+     * the first close recorded.
+     *
+     * A re-close used to overwrite `resolution` and move `closed_at` forward
+     * (ISS-0168). That is data loss, and silent: the resolution field is the only
+     * place the reasoning behind a fix survives outside a commit message, and the
+     * caller was told "closed" either way. The trigger was operator error — a
+     * `Closes:` trailer naming an already-closed issue — but the failure mode is
+     * not: citing the issue a piece of follow-up work came from is normal, and
+     * every such citation destroyed the original reasoning.
+     *
+     * So a record that is already terminal AND already carries a resolution keeps
+     * both. A status move between closed and wontfix is still honoured, since
+     * that is a real decision; a missing `closed_at` is filled in, since that only
+     * adds. When nothing is left to change the file is not rewritten at all, so a
+     * re-close does not even bump `updated_at`.
+     *
+     * Amending a resolution on purpose is `update`, which says what it does.
+     */
+    async close(idOrFilename, resolution, status = 'closed') {
+        const current = await this.requireOne(idOrFilename);
+        const wasTerminal = current.issue.status === 'closed' || current.issue.status === 'wontfix';
+        const existingResolution = (current.issue.resolution ?? '').trim();
+        const now = new Date().toISOString();
+        if (wasTerminal && existingResolution) {
+            const changes = {};
+            if (current.issue.status !== status)
+                changes.status = status;
+            if (!current.issue.closed_at)
+                changes.closed_at = now;
+            const stored = Object.keys(changes).length > 0
+                ? await this.update(idOrFilename, changes)
+                : current;
+            return { stored, preservedResolution: true };
+        }
+        return {
+            stored: await this.update(idOrFilename, { status, resolution, closed_at: now }),
+            preservedResolution: false,
+        };
+    }
+}
+//# sourceMappingURL=issueRepository.js.map

package/dist/domain/issueRepository.js.map

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

package/dist/domain/uid.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A stable identifier that survives everything the human-facing id does not.
+ *
+ * ISS-NNNN is a display name: it is derived from a directory scan, it is
+ * reassigned when duplicates are repaired (four were, in Phase 2), and it is
+ * allocated independently per checkout — which is exactly how the same issue
+ * came to exist as ISS-0112 on one volume and ISS-0115 on another with nothing
+ * in the data connecting them. `uid` is the identity; `id` is the label.
+ *
+ * UUIDv7 rather than v4 because it is time-ordered: records sort by creation
+ * without consulting a timestamp field, and a Postgres index on it stays local
+ * rather than scattering writes across the tree when this reaches HQ sync.
+ */
+export declare function newUid(now?: number): string;
+export declare function isUid(value: unknown): value is string;
+//# sourceMappingURL=uid.d.ts.map

package/dist/domain/uid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.d.ts","sourceRoot":"","sources":["../../src/domain/uid.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM,CAgBvD;AAID,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAErD"}

package/dist/domain/uid.js

@@ -0,0 +1,43 @@
+// ============================================================================
+// Record identity
+// ============================================================================
+//
+// Lives apart from issue.ts because it is not an issue concept. ADRs need it
+// too, and the daemon->Supabase projector (EPIC-0039) keys on it for every
+// artifact type: a label like ISS-NNNN or ADR-NNNN is allocated per checkout
+// and reissued, so two different records can wear the same one. This repo has
+// two different ADRs both claiming ADR-0004.
+// ============================================================================
+import { randomBytes } from 'crypto';
+/**
+ * A stable identifier that survives everything the human-facing id does not.
+ *
+ * ISS-NNNN is a display name: it is derived from a directory scan, it is
+ * reassigned when duplicates are repaired (four were, in Phase 2), and it is
+ * allocated independently per checkout — which is exactly how the same issue
+ * came to exist as ISS-0112 on one volume and ISS-0115 on another with nothing
+ * in the data connecting them. `uid` is the identity; `id` is the label.
+ *
+ * UUIDv7 rather than v4 because it is time-ordered: records sort by creation
+ * without consulting a timestamp field, and a Postgres index on it stays local
+ * rather than scattering writes across the tree when this reaches HQ sync.
+ */
+export function newUid(now = Date.now()) {
+    const bytes = randomBytes(16);
+    // 48-bit big-endian millisecond timestamp.
+    bytes[0] = (now / 2 ** 40) & 0xff;
+    bytes[1] = (now / 2 ** 32) & 0xff;
+    bytes[2] = (now / 2 ** 24) & 0xff;
+    bytes[3] = (now / 2 ** 16) & 0xff;
+    bytes[4] = (now / 2 ** 8) & 0xff;
+    bytes[5] = now & 0xff;
+    bytes[6] = (bytes[6] & 0x0f) | 0x70; // version 7
+    bytes[8] = (bytes[8] & 0x3f) | 0x80; // RFC 4122 variant
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+const UID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+export function isUid(value) {
+    return typeof value === 'string' && UID_RE.test(value);
+}
+//# sourceMappingURL=uid.js.map

package/dist/domain/uid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uid.js","sourceRoot":"","sources":["../../src/domain/uid.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAC/E,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,6CAA6C;AAC7C,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,MAAM,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAE9B,2CAA2C;IAC3C,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IAEtB,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,YAAY;IACjD,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,mBAAmB;IAExD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7G,CAAC;AAED,MAAM,MAAM,GAAG,wEAAwE,CAAC;AAExF,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/facades/definitions.d.ts

@@ -1,6 +1,5 @@
 import type { FacadeSpec } from './types.js';
 export declare const coreFacades: FacadeSpec[];
 export declare const proFacades: FacadeSpec[];
-export declare const appFacades: FacadeSpec[];
 export declare const allFacadeDefinitions: FacadeSpec[];
 //# sourceMappingURL=definitions.d.ts.map

package/dist/facades/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/facades/definitions.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,eAAO,MAAM,WAAW,EAAE,UAAU,EAmanC,CAAC;AAMF,eAAO,MAAM,UAAU,EAAE,UAAU,EA0ElC,CAAC;AAMF,eAAO,MAAM,UAAU,EAAE,UAAU,EAkHlC,CAAC;AAMF,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAAmD,CAAC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/facades/definitions.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,eAAO,MAAM,WAAW,EAAE,UAAU,EA4enC,CAAC;AAMF,eAAO,MAAM,UAAU,EAAE,UAAU,EAmHlC,CAAC;AAqCF,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAAoC,CAAC"}