crewly 1.20.153 → 1.20.155

package/dist/backend/backend/src/services/project-tickets/ticket-file.js

@@ -0,0 +1,468 @@
+/**
+ * Project ticket file format — parse and edit one `<ID>-<slug>.md` file
+ * (specs/2026-09-28-project-tickets.md §2).
+ *
+ * The file is owned by humans as much as by Crewly: people edit the body
+ * freely, add frontmatter keys, write comments. So the writer here never
+ * re-renders a file. It edits in place:
+ * - frontmatter: only the keys in {@link OWNED_TICKET_FIELDS} are set, through
+ *   the `yaml` Document API, so unknown keys, key order and comments survive;
+ *   when no owned key changes, the frontmatter bytes are kept as they were;
+ * - body: lines are appended to the `## Log` section, and the Description /
+ *   Acceptance sections are replaced only when a caller explicitly asks.
+ * Everything else is preserved byte-for-byte.
+ *
+ * @module services/project-tickets/ticket-file
+ */
+import { Document, parseDocument, isMap } from 'yaml';
+import { PROJECT_TICKET_CONSTANTS } from '../../constants.js';
+import { OWNED_TICKET_FIELDS, isProjectTicketStatus, normalizeProjectTicketPriority, } from '../../types/project-ticket.types.js';
+/** `---` frontmatter at the very start of the file (optional BOM). */
+const FRONTMATTER_RE = /^(\uFEFF?---[ \t]*\r?\n)(?:([\s\S]*?)\r?\n)?(---[ \t]*)(\r?\n|$)/;
+/** Ticket ids: `<KEY>-<n>` */
+export const TICKET_ID_RE = /^[A-Za-z0-9]+-\d+$/;
+/** A level-1 or level-2 markdown heading line. */
+const HEADING_RE = /^(#{1,2})\s+(.+?)\s*#*\s*$/;
+/** A fenced code block delimiter line. */
+const FENCE_RE = /^\s*(```|~~~)/;
+/** Checkbox / bullet lines of the acceptance section. */
+const CHECKBOX_RE = /^\s*[-*]\s+\[( |x|X)\]\s+(.*)$/;
+const BULLET_RE = /^\s*[-*]\s+(.*)$/;
+/** Placeholder written into an empty section. */
+const EMPTY_SECTION_TEXT = '_None yet._';
+/**
+ * Split a file into frontmatter and body.
+ *
+ * @param content - Whole file
+ * @returns The parts, or null when there is no frontmatter
+ */
+function splitFrontmatter(content) {
+    const m = FRONTMATTER_RE.exec(content);
+    if (!m)
+        return null;
+    return {
+        prefix: m[1],
+        yamlText: m[2] ?? '',
+        closer: m[3],
+        closerEol: m[4],
+        body: content.slice(m[0].length),
+        eol: content.includes('\r\n') ? '\r\n' : '\n',
+    };
+}
+/**
+ * Read an optional string field (null/absent → null; numbers are stringified).
+ *
+ * @param value - Raw frontmatter value
+ * @param name - Field name (for the error)
+ * @returns The string or null
+ * @throws When the value is neither a string, a number nor null
+ */
+function optionalString(value, name) {
+    if (value === undefined || value === null || value === '')
+        return null;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number')
+        return String(value);
+    throw new Error(`${name} must be a string`);
+}
+/**
+ * Read the labels field: a list, or a comma-separated string.
+ *
+ * @param value - Raw frontmatter value
+ * @returns Labels (trimmed, non-empty)
+ */
+function readLabels(value) {
+    if (value === undefined || value === null)
+        return [];
+    const list = Array.isArray(value) ? value : String(value).split(',');
+    return list.map((l) => String(l).trim()).filter((l) => l.length > 0);
+}
+/**
+ * Validate and normalise the owned fields of a frontmatter object.
+ *
+ * @param data - Frontmatter as plain JS
+ * @returns The fields
+ * @throws When a required field is missing or invalid
+ */
+function readFields(data) {
+    const id = data.id;
+    if (typeof id !== 'string' || !TICKET_ID_RE.test(id))
+        throw new Error('id must look like KEY-12');
+    const title = data.title;
+    if (typeof title !== 'string' || title.trim().length === 0)
+        throw new Error('title is required');
+    if (!isProjectTicketStatus(data.status)) {
+        throw new Error(`status must be one of ${PROJECT_TICKET_CONSTANTS.STATUSES.join(', ')}`);
+    }
+    const priority = data.priority === undefined || data.priority === null
+        ? PROJECT_TICKET_CONSTANTS.DEFAULT_PRIORITY
+        : normalizeProjectTicketPriority(data.priority);
+    if (!priority)
+        throw new Error('priority must be P0, P1, P2 or P3');
+    const ownerReview = data.ownerReview === true || data.ownerReview === 'true';
+    return {
+        id,
+        title: title.trim(),
+        status: data.status,
+        priority,
+        assignee: optionalString(data.assignee, 'assignee'),
+        team: optionalString(data.team, 'team'),
+        labels: readLabels(data.labels),
+        ownerReview,
+        createdAt: optionalString(data.createdAt, 'createdAt') ?? '',
+        updatedAt: optionalString(data.updatedAt, 'updatedAt') ?? '',
+        workItemId: optionalString(data.workItemId, 'workItemId'),
+        requestId: optionalString(data.requestId, 'requestId'),
+        source: optionalString(data.source, 'source'),
+        migratedFrom: optionalString(data.migratedFrom, 'migratedFrom'),
+    };
+}
+/**
+ * Locate the level-1/2 sections of a markdown body, ignoring headings inside
+ * fenced code blocks.
+ *
+ * @param body - Markdown body
+ * @returns Sections in order
+ */
+function locateSections(body) {
+    const sections = [];
+    let inFence = false;
+    let pos = 0;
+    while (pos <= body.length) {
+        const nl = body.indexOf('\n', pos);
+        const lineEnd = nl === -1 ? body.length : nl;
+        const rawLine = body.slice(pos, lineEnd);
+        const line = rawLine.endsWith('\r') ? rawLine.slice(0, -1) : rawLine;
+        if (FENCE_RE.test(line)) {
+            inFence = !inFence;
+        }
+        else if (!inFence) {
+            const h = HEADING_RE.exec(line);
+            if (h) {
+                if (sections.length > 0)
+                    sections[sections.length - 1].end = pos;
+                sections.push({
+                    title: h[2].trim(),
+                    start: pos,
+                    headingEnd: pos + line.length,
+                    contentStart: nl === -1 ? body.length : nl + 1,
+                    end: body.length,
+                });
+            }
+        }
+        if (nl === -1)
+            break;
+        pos = nl + 1;
+    }
+    return sections;
+}
+/**
+ * Find a section by heading text (case-insensitive).
+ *
+ * @param body - Markdown body
+ * @param title - Heading text
+ * @returns The section, or undefined
+ */
+function findSection(body, title) {
+    const want = title.toLowerCase();
+    return locateSections(body).find((s) => s.title.toLowerCase() === want);
+}
+/**
+ * Parse the acceptance criteria lines of a section.
+ *
+ * @param text - Section content
+ * @returns Criteria
+ */
+function parseCriteria(text) {
+    const out = [];
+    for (const line of text.split(/\r?\n/)) {
+        const cb = CHECKBOX_RE.exec(line);
+        if (cb) {
+            out.push({ text: cb[2].trim(), done: cb[1].toLowerCase() === 'x' });
+            continue;
+        }
+        const b = BULLET_RE.exec(line);
+        if (b && b[1].trim())
+            out.push({ text: b[1].trim(), done: false });
+    }
+    return out;
+}
+/**
+ * Render acceptance criteria as checkbox lines.
+ *
+ * @param criteria - Criteria
+ * @param eol - Line ending
+ * @returns Section content
+ */
+export function renderCriteria(criteria, eol = '\n') {
+    if (criteria.length === 0)
+        return EMPTY_SECTION_TEXT;
+    return criteria.map((c) => `- [${c.done ? 'x' : ' '}] ${c.text.replace(/\r?\n/g, ' ').trim()}`).join(eol);
+}
+/**
+ * Read a section's text (trimmed) from a body.
+ *
+ * @param body - Markdown body
+ * @param title - Heading text
+ * @returns Content, or '' when the section is absent
+ */
+function sectionText(body, title) {
+    const s = findSection(body, title);
+    return s ? body.slice(s.contentStart, s.end).trim() : '';
+}
+/**
+ * Parse a ticket file. Never throws: an unreadable file comes back as
+ * `{ ok: false, error }` so callers can skip it with a warning.
+ *
+ * @param content - Whole file content
+ * @returns The parsed ticket, or the reason it is not one
+ *
+ * @example
+ * ```typescript
+ * const r = parseTicketFile(await fs.readFile(p, 'utf8'));
+ * if (r.ok) console.log(r.file.fields.status);
+ * ```
+ */
+export function parseTicketFile(content) {
+    const split = splitFrontmatter(content);
+    if (!split)
+        return { ok: false, error: 'missing YAML frontmatter' };
+    const doc = parseDocument(split.yamlText);
+    if (doc.errors.length > 0)
+        return { ok: false, error: `invalid YAML: ${doc.errors[0].message.split('\n')[0]}` };
+    const data = doc.toJS();
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        return { ok: false, error: 'frontmatter must be a mapping' };
+    }
+    let fields;
+    try {
+        fields = readFields(data);
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    const owned = new Set(OWNED_TICKET_FIELDS);
+    const extra = {};
+    for (const [k, v] of Object.entries(data)) {
+        if (!owned.has(k))
+            extra[k] = v;
+    }
+    const { SECTIONS } = PROJECT_TICKET_CONSTANTS;
+    const description = sectionText(split.body, SECTIONS.DESCRIPTION);
+    const acceptanceText = sectionText(split.body, SECTIONS.ACCEPTANCE);
+    const logText = sectionText(split.body, SECTIONS.LOG);
+    return {
+        ok: true,
+        file: {
+            fields,
+            extra,
+            body: split.body,
+            description: description === EMPTY_SECTION_TEXT ? '' : description,
+            acceptance: acceptanceText === EMPTY_SECTION_TEXT ? [] : parseCriteria(acceptanceText),
+            log: logText
+                .split(/\r?\n/)
+                .filter((l) => /^\s*-\s+/.test(l))
+                .map((l) => l.replace(/^\s*-\s+/, '')),
+        },
+    };
+}
+/**
+ * Whether two owned-field values are equal (arrays compared element-wise).
+ *
+ * @param a - Current value
+ * @param b - New value
+ * @returns True when unchanged
+ */
+function sameValue(a, b) {
+    if (Array.isArray(a) && Array.isArray(b))
+        return a.length === b.length && a.every((x, i) => x === b[i]);
+    return (a ?? null) === (b ?? null);
+}
+/**
+ * Set one owned key on a YAML document (flow style for arrays).
+ *
+ * @param doc - Document
+ * @param key - Field name
+ * @param value - New value
+ */
+function setField(doc, key, value) {
+    if (Array.isArray(value)) {
+        doc.set(key, doc.createNode(value, { flow: true }));
+    }
+    else {
+        doc.set(key, value === undefined ? null : value);
+    }
+}
+/**
+ * Append lines to the Log section (creating it at the end when missing).
+ *
+ * @param body - Markdown body
+ * @param lines - Lines without `- `
+ * @param eol - Line ending
+ * @returns New body
+ */
+function appendLog(body, lines, eol) {
+    if (lines.length === 0)
+        return body;
+    const rendered = lines.map((l) => `- ${l.replace(/\r?\n/g, ' ')}`).join(eol);
+    const sec = findSection(body, PROJECT_TICKET_CONSTANTS.SECTIONS.LOG);
+    if (!sec) {
+        const lead = body.length === 0 ? eol : body.endsWith('\n') ? eol : eol + eol;
+        return `${body}${lead}## ${PROJECT_TICKET_CONSTANTS.SECTIONS.LOG}${eol}${eol}${rendered}${eol}`;
+    }
+    const content = body.slice(sec.contentStart, sec.end);
+    const trimmedLen = content.replace(/\s+$/, '').length;
+    if (trimmedLen === 0) {
+        // Empty section: put the lines right under the heading, keep what followed.
+        const tail = body.slice(sec.headingEnd);
+        const needsEol = sec.end === body.length && !/\n/.test(tail);
+        return `${body.slice(0, sec.headingEnd)}${eol}${eol}${rendered}${needsEol ? eol : ''}${tail}`;
+    }
+    const at = sec.contentStart + trimmedLen;
+    return `${body.slice(0, at)}${eol}${rendered}${body.slice(at)}`;
+}
+/**
+ * Replace (or insert) a section's content. Insertion goes before the Log
+ * section, else at the end.
+ *
+ * @param body - Markdown body
+ * @param title - Heading text
+ * @param content - New content (without heading)
+ * @param eol - Line ending
+ * @returns New body
+ */
+function replaceSection(body, title, content, eol) {
+    const text = content.trim().length > 0 ? content.trim() : EMPTY_SECTION_TEXT;
+    const sec = findSection(body, title);
+    if (sec) {
+        const hasNext = sec.end < body.length;
+        return `${body.slice(0, sec.contentStart)}${sec.contentStart === body.length ? eol : ''}${eol}${text}${eol}${hasNext ? eol : ''}${body.slice(sec.end)}`;
+    }
+    const block = `## ${title}${eol}${eol}${text}${eol}`;
+    const log = findSection(body, PROJECT_TICKET_CONSTANTS.SECTIONS.LOG);
+    if (log)
+        return `${body.slice(0, log.start)}${block}${eol}${body.slice(log.start)}`;
+    const lead = body.length === 0 ? eol : body.endsWith('\n') ? eol : eol + eol;
+    return `${body}${lead}${block}`;
+}
+/**
+ * Apply changes to a ticket file, touching only owned frontmatter keys and
+ * the sections asked for.
+ *
+ * @param content - Current file content
+ * @param changes - What to change
+ * @returns New file content (identical to `content` when nothing changes)
+ * @throws When the file has no parseable frontmatter mapping
+ *
+ * @example
+ * ```typescript
+ * const next = applyTicketChanges(text, { fields: { status: 'ready' }, logLines: ['… · owner · ready'] });
+ * ```
+ */
+export function applyTicketChanges(content, changes) {
+    const split = splitFrontmatter(content);
+    if (!split)
+        throw new Error('missing YAML frontmatter');
+    const { eol } = split;
+    let yamlOut = split.yamlText;
+    let frontmatterChanged = false;
+    if (changes.fields && Object.keys(changes.fields).length > 0) {
+        const doc = parseDocument(split.yamlText);
+        if (doc.errors.length > 0 || !isMap(doc.contents))
+            throw new Error('frontmatter is not a YAML mapping');
+        const current = doc.toJS();
+        for (const key of OWNED_TICKET_FIELDS) {
+            if (!(key in changes.fields))
+                continue;
+            const value = changes.fields[key];
+            if (sameValue(current[key], value))
+                continue;
+            setField(doc, key, value);
+            frontmatterChanged = true;
+        }
+        if (frontmatterChanged) {
+            yamlOut = doc.toString({ lineWidth: 0 }).replace(/\n$/, '').replace(/\n/g, eol);
+        }
+    }
+    let body = split.body;
+    const { SECTIONS } = PROJECT_TICKET_CONSTANTS;
+    if (changes.description !== undefined)
+        body = replaceSection(body, SECTIONS.DESCRIPTION, changes.description, eol);
+    if (changes.acceptance !== undefined) {
+        body = replaceSection(body, SECTIONS.ACCEPTANCE, renderCriteria(changes.acceptance, eol), eol);
+    }
+    if (changes.logLines && changes.logLines.length > 0)
+        body = appendLog(body, changes.logLines, eol);
+    if (!frontmatterChanged && body === split.body)
+        return content;
+    const closerEol = split.closerEol === '' && body.length > 0 ? eol : split.closerEol;
+    const yamlBlock = yamlOut.length > 0 ? `${yamlOut}${eol}` : '';
+    return `${split.prefix}${yamlBlock}${split.closer}${closerEol}${body}`;
+}
+/**
+ * Render a brand-new ticket file.
+ *
+ * @param content - Fields, description, criteria and the first log lines
+ * @returns File content
+ */
+export function renderNewTicketFile(content) {
+    const doc = new Document({});
+    for (const key of OWNED_TICKET_FIELDS) {
+        const value = content.fields[key];
+        if (key === 'migratedFrom' && value === null)
+            continue;
+        setField(doc, key, value);
+    }
+    const yamlText = doc.toString({ lineWidth: 0 });
+    const { SECTIONS } = PROJECT_TICKET_CONSTANTS;
+    const description = content.description.trim().length > 0 ? content.description.trim() : EMPTY_SECTION_TEXT;
+    const logLines = content.logLines.map((l) => `- ${l.replace(/\r?\n/g, ' ')}`).join('\n');
+    return [
+        '---',
+        yamlText.replace(/\n$/, ''),
+        '---',
+        '',
+        `## ${SECTIONS.DESCRIPTION}`,
+        '',
+        description,
+        '',
+        `## ${SECTIONS.ACCEPTANCE}`,
+        '',
+        renderCriteria(content.acceptance),
+        '',
+        `## ${SECTIONS.LOG}`,
+        '',
+        logLines,
+        '',
+    ].join('\n');
+}
+/**
+ * A file-name slug for a title (`Export as CSV!` → `export-as-csv`).
+ *
+ * @param title - Ticket title
+ * @returns Slug (never empty)
+ */
+export function slugifyTitle(title) {
+    const slug = title
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, PROJECT_TICKET_CONSTANTS.MAX_SLUG_LENGTH)
+        .replace(/-+$/g, '');
+    return slug.length > 0 ? slug : 'ticket';
+}
+/**
+ * Format one Log line: `<iso> · <actor> · <message>`.
+ *
+ * @param actor - Who did it (`owner`, a session name, `system`)
+ * @param message - What happened
+ * @param at - Timestamp (defaults to now)
+ * @returns The line (without `- `)
+ */
+export function formatLogLine(actor, message, at = new Date().toISOString()) {
+    return `${at} · ${actor} · ${message.replace(/\r?\n/g, ' ').trim()}`;
+}
+//# sourceMappingURL=ticket-file.js.map

package/dist/backend/backend/src/services/project-tickets/ticket-file.js.map

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

package/dist/backend/backend/src/services/project-tickets/ticket-folder-lock.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Locking and id allocation for a project's tickets folder
+ * (specs/2026-09-28-project-tickets.md §2 "Concurrency").
+ *
+ * Two layers, because writers live in more than one process (the backend,
+ * a `crewly tickets migrate` run, a second backend on the same machine):
+ * - an in-process operation lock keyed on the folder, so concurrent async
+ *   callers in one process queue up instead of polling the lockfile;
+ * - a lockfile created with `O_EXCL` (`wx`), so other processes wait too. A
+ *   lockfile older than {@link PROJECT_TICKET_CONSTANTS.LOCK_STALE_MS} was left
+ *   by a crashed writer and is taken over.
+ *
+ * @module services/project-tickets/ticket-folder-lock
+ */
+/** Counter file shape. */
+export interface TicketCounter {
+    prefix: string;
+    next: number;
+}
+/**
+ * Run `fn` while holding the folder's in-process and cross-process locks.
+ * Creates the folder (and its own `.gitignore` for the lock and temp files)
+ * when missing.
+ *
+ * @param dir - Absolute tickets folder
+ * @param fn - Critical section
+ * @returns Whatever `fn` returns
+ * @throws When the lock cannot be taken, or whatever `fn` throws
+ *
+ * @example
+ * ```typescript
+ * await withTicketFolderLock(dir, async () => writeTicket(...));
+ * ```
+ */
+export declare function withTicketFolderLock<T>(dir: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Derive a ticket id prefix from a project name: up to four letters/digits,
+ * preferring word initials for multi-word names.
+ *
+ * @param projectName - Project display name
+ * @returns Uppercase prefix (never empty)
+ *
+ * @example
+ * ```typescript
+ * derivePrefix('crewly');           // 'CREW'
+ * derivePrefix('Steam Fun Portal'); // 'SFP'
+ * ```
+ */
+export declare function derivePrefix(projectName: string): string;
+/**
+ * Read the counter file (missing or corrupt → null).
+ *
+ * @param dir - Tickets folder
+ * @returns Counter, or null
+ */
+export declare function readCounter(dir: string): Promise<TicketCounter | null>;
+/**
+ * Allocate the next ticket id. MUST be called while holding
+ * {@link withTicketFolderLock} for the same folder.
+ *
+ * Takes `max(counter.next, highest used + 1)` so ids that arrive through a
+ * git merge are never reused, then advances the counter.
+ *
+ * @param dir - Tickets folder
+ * @param projectName - Used to derive the prefix the first time
+ * @returns The new id, e.g. `CREW-13`
+ */
+export declare function allocateTicketId(dir: string, projectName: string): Promise<string>;
+//# sourceMappingURL=ticket-folder-lock.d.ts.map

package/dist/backend/backend/src/services/project-tickets/ticket-folder-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ticket-folder-lock.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/project-tickets/ticket-folder-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AA6CD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAY3F;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUxD;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAS5E;AA0BD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxF"}