reflectt-node 0.1.0

package/dist/reflections.js

@@ -0,0 +1,306 @@
+// SPDX-License-Identifier: Apache-2.0
+// Reflection entity: structured team learnings with evidence + task linkage
+import { getDb, safeJsonStringify, safeJsonParse } from './db.js';
+import { eventBus } from './events.js';
+// ── Constants ──
+export const ROLE_TYPES = ['human', 'agent', 'team'];
+export const SEVERITY_LEVELS = ['low', 'medium', 'high', 'critical'];
+export function validateReflection(body) {
+    const errors = [];
+    if (!body || typeof body !== 'object') {
+        return { valid: false, data: {}, errors: [{ field: 'body', message: 'Request body must be a JSON object' }] };
+    }
+    const b = body;
+    // Required string fields
+    const requiredStrings = ['pain', 'impact', 'went_well', 'suspected_why', 'proposed_fix', 'author'];
+    for (const field of requiredStrings) {
+        if (typeof b[field] !== 'string' || b[field].trim().length === 0) {
+            errors.push({ field, message: `${field} is required and must be a non-empty string` });
+        }
+    }
+    // Evidence: must be a non-empty array of strings
+    if (!Array.isArray(b.evidence) || b.evidence.length === 0) {
+        errors.push({ field: 'evidence', message: 'evidence is required and must be a non-empty array of strings' });
+    }
+    else {
+        const allStrings = b.evidence.every((e) => typeof e === 'string' && e.trim().length > 0);
+        if (!allStrings) {
+            errors.push({ field: 'evidence', message: 'each evidence entry must be a non-empty string' });
+        }
+    }
+    // Confidence: number 0–10
+    if (typeof b.confidence !== 'number' || b.confidence < 0 || b.confidence > 10 || !Number.isFinite(b.confidence)) {
+        errors.push({ field: 'confidence', message: 'confidence is required and must be a number between 0 and 10' });
+    }
+    // Role type
+    if (!ROLE_TYPES.includes(b.role_type)) {
+        errors.push({ field: 'role_type', message: `role_type is required and must be one of: ${ROLE_TYPES.join(', ')}` });
+    }
+    // Optional: severity
+    if (b.severity !== undefined && b.severity !== null && !SEVERITY_LEVELS.includes(b.severity)) {
+        errors.push({ field: 'severity', message: `severity must be one of: ${SEVERITY_LEVELS.join(', ')}` });
+    }
+    // Optional: task_id
+    if (b.task_id !== undefined && b.task_id !== null && typeof b.task_id !== 'string') {
+        errors.push({ field: 'task_id', message: 'task_id must be a string if provided' });
+    }
+    // Optional: tags
+    if (b.tags !== undefined && b.tags !== null) {
+        if (!Array.isArray(b.tags) || !b.tags.every((t) => typeof t === 'string')) {
+            errors.push({ field: 'tags', message: 'tags must be an array of strings if provided' });
+        }
+    }
+    // Optional: team_id
+    if (b.team_id !== undefined && b.team_id !== null && typeof b.team_id !== 'string') {
+        errors.push({ field: 'team_id', message: 'team_id must be a string if provided' });
+    }
+    // Optional: metadata
+    if (b.metadata !== undefined && b.metadata !== null && (typeof b.metadata !== 'object' || Array.isArray(b.metadata))) {
+        errors.push({ field: 'metadata', message: 'metadata must be a plain object if provided' });
+    }
+    if (errors.length > 0) {
+        return { valid: false, data: {}, errors };
+    }
+    const data = {
+        pain: b.pain.trim(),
+        impact: b.impact.trim(),
+        evidence: b.evidence.map(e => e.trim()),
+        went_well: b.went_well.trim(),
+        suspected_why: b.suspected_why.trim(),
+        proposed_fix: b.proposed_fix.trim(),
+        confidence: b.confidence,
+        role_type: b.role_type,
+        author: b.author.trim(),
+    };
+    if (b.severity)
+        data.severity = b.severity;
+    if (b.task_id)
+        data.task_id = b.task_id.trim();
+    if (b.tags && Array.isArray(b.tags))
+        data.tags = b.tags;
+    if (b.team_id)
+        data.team_id = b.team_id.trim();
+    if (b.metadata && typeof b.metadata === 'object')
+        data.metadata = b.metadata;
+    return { valid: true, data };
+}
+// ── Helpers ──
+function generateId() {
+    return `ref-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+}
+function rowToReflection(row) {
+    return {
+        id: row.id,
+        pain: row.pain,
+        impact: row.impact,
+        evidence: safeJsonParse(row.evidence) ?? [],
+        went_well: row.went_well,
+        suspected_why: row.suspected_why,
+        proposed_fix: row.proposed_fix,
+        confidence: row.confidence,
+        role_type: row.role_type,
+        severity: row.severity ?? undefined,
+        author: row.author,
+        task_id: row.task_id ?? undefined,
+        tags: safeJsonParse(row.tags),
+        team_id: row.team_id ?? undefined,
+        metadata: safeJsonParse(row.metadata),
+        created_at: row.created_at,
+        updated_at: row.updated_at,
+    };
+}
+// ── CRUD (standalone functions matching server.ts import) ──
+export function createReflection(input) {
+    const db = getDb();
+    const now = Date.now();
+    const id = generateId();
+    const reflection = { ...input, id, created_at: now, updated_at: now };
+    db.prepare(`
+    INSERT INTO reflections (
+      id, pain, impact, evidence, went_well, suspected_why,
+      proposed_fix, confidence, role_type, severity, author,
+      task_id, tags, team_id, metadata, created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, reflection.pain, reflection.impact, safeJsonStringify(reflection.evidence), reflection.went_well, reflection.suspected_why, reflection.proposed_fix, reflection.confidence, reflection.role_type, reflection.severity ?? null, reflection.author, reflection.task_id ?? null, safeJsonStringify(reflection.tags) ?? null, reflection.team_id ?? null, safeJsonStringify(reflection.metadata) ?? null, now, now);
+    // Link to task via comment if task_id provided
+    if (reflection.task_id) {
+        _linkToTask(reflection);
+    }
+    eventBus.emit({
+        id: `evt-reflection-${id}`,
+        type: 'reflection_created',
+        timestamp: Date.now(),
+        data: { kind: 'reflection:created', reflectionId: id, author: reflection.author },
+    });
+    return reflection;
+}
+export function getReflection(id) {
+    const db = getDb();
+    const row = db.prepare('SELECT * FROM reflections WHERE id = ?').get(id);
+    return row ? rowToReflection(row) : null;
+}
+export function listReflections(opts = {}) {
+    const db = getDb();
+    const where = [];
+    const params = [];
+    if (opts.author) {
+        where.push('author = ?');
+        params.push(opts.author);
+    }
+    if (opts.role_type) {
+        where.push('role_type = ?');
+        params.push(opts.role_type);
+    }
+    if (opts.severity) {
+        where.push('severity = ?');
+        params.push(opts.severity);
+    }
+    if (opts.task_id) {
+        where.push('task_id = ?');
+        params.push(opts.task_id);
+    }
+    if (opts.team_id) {
+        where.push('team_id = ?');
+        params.push(opts.team_id);
+    }
+    if (opts.since) {
+        where.push('created_at >= ?');
+        params.push(opts.since);
+    }
+    if (opts.before) {
+        where.push('created_at <= ?');
+        params.push(opts.before);
+    }
+    const whereClause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+    const limit = Math.min(opts.limit ?? 50, 200);
+    const offset = opts.offset ?? 0;
+    const rows = db.prepare(`SELECT * FROM reflections ${whereClause} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
+    return rows.map(rowToReflection);
+}
+export function countReflections(opts = {}) {
+    const db = getDb();
+    const where = [];
+    const params = [];
+    if (opts.author) {
+        where.push('author = ?');
+        params.push(opts.author);
+    }
+    if (opts.role_type) {
+        where.push('role_type = ?');
+        params.push(opts.role_type);
+    }
+    if (opts.severity) {
+        where.push('severity = ?');
+        params.push(opts.severity);
+    }
+    if (opts.task_id) {
+        where.push('task_id = ?');
+        params.push(opts.task_id);
+    }
+    if (opts.team_id) {
+        where.push('team_id = ?');
+        params.push(opts.team_id);
+    }
+    if (opts.since) {
+        where.push('created_at >= ?');
+        params.push(opts.since);
+    }
+    if (opts.before) {
+        where.push('created_at <= ?');
+        params.push(opts.before);
+    }
+    const whereClause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
+    const result = db.prepare(`SELECT COUNT(*) as c FROM reflections ${whereClause}`).get(...params);
+    return result.c;
+}
+export function reflectionStats() {
+    const db = getDb();
+    const total = db.prepare('SELECT COUNT(*) as c FROM reflections').get().c;
+    const byRole = db.prepare('SELECT role_type, COUNT(*) as c FROM reflections GROUP BY role_type').all();
+    const bySeverity = db.prepare("SELECT COALESCE(severity, 'unset') as severity, COUNT(*) as c FROM reflections GROUP BY severity").all();
+    const byAuthor = db.prepare('SELECT author, COUNT(*) as c FROM reflections GROUP BY author ORDER BY c DESC LIMIT 20').all();
+    return {
+        total,
+        by_role_type: Object.fromEntries(byRole.map(r => [r.role_type, r.c])),
+        by_severity: Object.fromEntries(bySeverity.map(r => [r.severity, r.c])),
+        by_author: Object.fromEntries(byAuthor.map(r => [r.author, r.c])),
+    };
+}
+// ── Task linkage ──
+function _linkToTask(reflection) {
+    try {
+        const db = getDb();
+        const commentId = `tcomment-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+        const content = `📝 Reflection linked: ${reflection.id}\n` +
+            `**Pain:** ${reflection.pain}\n` +
+            `**Impact:** ${reflection.impact}\n` +
+            `**Proposed fix:** ${reflection.proposed_fix}\n` +
+            `**Confidence:** ${reflection.confidence}/10\n` +
+            `**Evidence:** ${reflection.evidence.join(', ')}`;
+        // Apply comms_policy suppression if present on the task
+        let category = null;
+        let suppressed = 0;
+        let suppressedReason = null;
+        let suppressedRule = null;
+        try {
+            const taskRow = db.prepare('SELECT metadata FROM tasks WHERE id = ?').get(reflection.task_id);
+            const meta = taskRow?.metadata ? JSON.parse(taskRow.metadata) : null;
+            const rule = meta?.comms_policy?.rule;
+            if (rule === 'silent_until_restart_or_promote_due') {
+                suppressed = 1;
+                suppressedReason = 'missing_category';
+                suppressedRule = rule;
+            }
+        }
+        catch {
+            // Best-effort only
+        }
+        db.prepare(`
+      INSERT OR IGNORE INTO task_comments (
+        id, task_id, author, content, timestamp,
+        category, suppressed, suppressed_reason, suppressed_rule
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(commentId, reflection.task_id, reflection.author, content, reflection.created_at, category, suppressed, suppressedReason, suppressedRule);
+        db.prepare(`
+      UPDATE tasks SET comment_count = comment_count + 1, updated_at = ?
+      WHERE id = ?
+    `).run(reflection.created_at, reflection.task_id);
+    }
+    catch {
+        // Non-fatal: task may not exist
+    }
+}
+// ── Dedup helpers ──
+/**
+ * Best-effort duplicate counter for a canonical reflection.
+ * Used by POST /reflections dedup to leave an audit trail without creating new rows.
+ */
+export function recordReflectionDuplicate(canonicalReflectionId, duplicateAt = Date.now(), signature) {
+    const db = getDb();
+    const row = db.prepare('SELECT metadata FROM reflections WHERE id = ?').get(canonicalReflectionId);
+    const meta = row?.metadata ? (safeJsonParse(row.metadata) ?? {}) : {};
+    const rawDedup = meta.dedup;
+    const dedupObj = (rawDedup && typeof rawDedup === 'object' && !Array.isArray(rawDedup)) ? rawDedup : {};
+    const prev = typeof dedupObj.count === 'number' ? dedupObj.count : 0;
+    const nextCount = prev + 1;
+    const nextDedup = {
+        ...dedupObj,
+        count: nextCount,
+        last_duplicate_at: duplicateAt,
+        signature: signature ?? dedupObj.signature,
+    };
+    const nextMeta = { ...meta, dedup: nextDedup };
+    db.prepare('UPDATE reflections SET metadata = ?, updated_at = ? WHERE id = ?').run(safeJsonStringify(nextMeta) ?? null, duplicateAt, canonicalReflectionId);
+    return { ok: true, count: nextCount };
+}
+// ── Test helpers ──
+export function _clearReflectionStore() {
+    try {
+        const db = getDb();
+        db.prepare('DELETE FROM reflections').run();
+    }
+    catch {
+        // Table may not exist
+    }
+}
+//# sourceMappingURL=reflections.js.map

package/dist/reflections.js.map

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

package/dist/release.d.ts

@@ -0,0 +1,67 @@
+type RepoSnapshot = {
+    commit: string | null;
+    dirty: boolean;
+    branch: string | null;
+    capturedAt: number;
+};
+type DeployMarker = {
+    deployedAt: number;
+    deployedBy?: string;
+    note?: string;
+    commit?: string | null;
+    previousCommit?: string | null;
+};
+type ReleaseDiffCommit = {
+    sha: string;
+    subject: string;
+};
+export declare const releaseManager: {
+    getStartupSnapshot(): RepoSnapshot;
+    getCurrentSnapshot(): RepoSnapshot;
+    getDeployStatus(): Promise<{
+        stale: boolean;
+        reasons: string[];
+        startup: RepoSnapshot;
+        current: RepoSnapshot;
+        lastDeploy: DeployMarker | null;
+        timestamp: number;
+    }>;
+    markDeploy(deployedBy?: string, note?: string): Promise<DeployMarker>;
+    getReleaseDiff(options?: {
+        from?: string;
+        to?: string;
+        commitLimit?: number;
+    }): Promise<{
+        ok: boolean;
+        generatedAt: number;
+        liveSha: string;
+        previousDeploySha: string;
+        trackedPreviousDeploySha: string | null;
+        trackedCurrentDeploySha: string | null;
+        changedFiles: string[];
+        changedEndpoints: string[];
+        changedTests: string[];
+        commits: ReleaseDiffCommit[];
+        pullRequestLinks: string[];
+    }>;
+    getReleaseNotes(options?: {
+        since?: number;
+        limit?: number;
+    }): Promise<{
+        since: number;
+        generatedAt: number;
+        mergedTasks: {
+            id: string;
+            title: string;
+            assignee: string | undefined;
+            createdBy: string;
+            priority: "P0" | "P1" | "P2" | "P3" | undefined;
+            tags: string[] | undefined;
+            updatedAt: number;
+        }[];
+        endpointChanges: string[];
+        markdown: string;
+    }>;
+};
+export {};
+//# sourceMappingURL=release.d.ts.map

package/dist/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"AAUA,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,KAAK,iBAAiB,GAAG;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAkHD,eAAO,MAAM,cAAc;0BACH,YAAY;0BAIZ,YAAY;;;;;;;;;4BA6BJ,MAAM,SAAS,MAAM;6BAgBpB;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;8BAqEnD;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;CAqEnE,CAAA"}

package/dist/release.js

@@ -0,0 +1,275 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) Reflectt AI
+import { execSync } from 'child_process';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import { DATA_DIR } from './config.js';
+import { taskManager } from './tasks.js';
+const DEPLOY_MARKER_FILE = join(DATA_DIR, 'release.deploy.json');
+const SHA_RE = /^[a-fA-F0-9]{7,40}$/;
+function runGit(command) {
+    try {
+        return execSync(command, { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeSha(input) {
+    const raw = String(input || '').trim();
+    if (!raw)
+        return null;
+    return SHA_RE.test(raw) ? raw : null;
+}
+function captureRepoSnapshot() {
+    const commit = runGit('git rev-parse HEAD');
+    const branch = runGit('git rev-parse --abbrev-ref HEAD');
+    const dirtyOutput = runGit('git status --porcelain');
+    const dirty = Boolean(dirtyOutput && dirtyOutput.length > 0);
+    return {
+        commit,
+        dirty,
+        branch,
+        capturedAt: Date.now(),
+    };
+}
+const startupSnapshot = captureRepoSnapshot();
+function extractEndpointMentions(task) {
+    const haystack = [task.title, task.description || '', ...(task.done_criteria || [])].join('\n');
+    const endpointRegex = /\b(?:GET|POST|PATCH|PUT|DELETE)\s+(\/[A-Za-z0-9_:\/\-.?=&]+)\b/g;
+    const found = new Set();
+    let match;
+    while ((match = endpointRegex.exec(haystack)) !== null) {
+        found.add(match[1]);
+    }
+    return Array.from(found);
+}
+function extractEndpointsFromGitDiff(fromSha, toSha) {
+    const diff = runGit(`git diff --unified=0 ${fromSha} ${toSha} -- src`);
+    if (!diff)
+        return [];
+    const found = new Set();
+    const routeRegex = /^\+\s*app\.(get|post|patch|put|delete)\s*(?:<[^>]+>)?\(\s*['"`]([^'"`]+)['"`]/i;
+    for (const line of diff.split('\n')) {
+        const match = line.match(routeRegex);
+        if (!match)
+            continue;
+        found.add(`${match[1].toUpperCase()} ${match[2]}`);
+    }
+    return Array.from(found).sort();
+}
+function githubRepoBase() {
+    const remote = runGit('git remote get-url origin');
+    if (!remote)
+        return null;
+    const trimmed = remote.trim().replace(/\.git$/i, '');
+    if (trimmed.startsWith('https://github.com/')) {
+        return trimmed;
+    }
+    const sshMatch = trimmed.match(/^git@github\.com:(.+)$/i);
+    if (sshMatch) {
+        return `https://github.com/${sshMatch[1]}`;
+    }
+    return null;
+}
+function extractPullRequestLinks(commits) {
+    const repoBase = githubRepoBase();
+    if (!repoBase)
+        return [];
+    const prs = new Set();
+    for (const commit of commits) {
+        const matches = commit.subject.match(/#(\d+)/g) || [];
+        for (const token of matches) {
+            const num = parseInt(token.slice(1), 10);
+            if (Number.isFinite(num) && num > 0)
+                prs.add(num);
+        }
+    }
+    return Array.from(prs)
+        .sort((a, b) => a - b)
+        .map(num => `${repoBase}/pull/${num}`);
+}
+async function readDeployMarker() {
+    try {
+        const raw = await fs.readFile(DEPLOY_MARKER_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeDeployMarker(marker) {
+    await fs.mkdir(DATA_DIR, { recursive: true });
+    await fs.writeFile(DEPLOY_MARKER_FILE, JSON.stringify(marker, null, 2), 'utf-8');
+}
+export const releaseManager = {
+    getStartupSnapshot() {
+        return startupSnapshot;
+    },
+    getCurrentSnapshot() {
+        return captureRepoSnapshot();
+    },
+    async getDeployStatus() {
+        const current = captureRepoSnapshot();
+        const deployMarker = await readDeployMarker();
+        const reasons = [];
+        if (startupSnapshot.commit !== current.commit) {
+            reasons.push('commit changed since server start');
+        }
+        if (!startupSnapshot.dirty && current.dirty) {
+            reasons.push('working tree became dirty after server start');
+        }
+        if (startupSnapshot.branch !== current.branch) {
+            reasons.push('branch changed since server start');
+        }
+        return {
+            stale: reasons.length > 0,
+            reasons,
+            startup: startupSnapshot,
+            current,
+            lastDeploy: deployMarker,
+            timestamp: Date.now(),
+        };
+    },
+    async markDeploy(deployedBy, note) {
+        const current = captureRepoSnapshot();
+        const previousMarker = await readDeployMarker();
+        const marker = {
+            deployedAt: Date.now(),
+            deployedBy,
+            note,
+            commit: current.commit,
+            previousCommit: previousMarker?.commit ?? previousMarker?.previousCommit ?? null,
+        };
+        await writeDeployMarker(marker);
+        return marker;
+    },
+    async getReleaseDiff(options) {
+        try {
+            const current = captureRepoSnapshot();
+            const deployMarker = await readDeployMarker();
+            const rawToSha = normalizeSha(options?.to) || normalizeSha(current.commit);
+            const trackedPreviousDeploySha = normalizeSha(deployMarker?.previousCommit);
+            const fallbackTracked = normalizeSha(deployMarker?.commit);
+            const fallbackGitPrev = runGit('git rev-parse HEAD~1');
+            const rawFromSha = normalizeSha(options?.from) || trackedPreviousDeploySha || fallbackTracked || normalizeSha(fallbackGitPrev);
+            // Keep endpoint stable in shallow clones or constrained CI runners:
+            // if we cannot resolve either SHA, degrade to an empty diff against the live SHA.
+            const toSha = rawToSha || 'unknown';
+            const fromSha = rawFromSha || toSha;
+            const filesRaw = runGit(`git diff --name-only ${fromSha} ${toSha}`) || '';
+            const changedFiles = filesRaw
+                .split('\n')
+                .map(line => line.trim())
+                .filter(Boolean);
+            const changedTests = changedFiles.filter(path => path.startsWith('tests/') || path.includes('.test.'));
+            const changedEndpoints = extractEndpointsFromGitDiff(fromSha, toSha);
+            const commitLimit = Math.max(1, Math.min(options?.commitLimit ?? 100, 500));
+            const commitsRaw = runGit(`git log --pretty=format:%H%x09%s -n ${commitLimit} ${fromSha}..${toSha}`) || '';
+            const commits = commitsRaw
+                .split('\n')
+                .map(line => line.trim())
+                .filter(Boolean)
+                .map(line => {
+                const [sha, ...rest] = line.split('\t');
+                return { sha, subject: rest.join('\t') };
+            })
+                .filter(c => Boolean(c.sha) && Boolean(c.subject));
+            const pullRequestLinks = extractPullRequestLinks(commits);
+            return {
+                ok: true,
+                generatedAt: Date.now(),
+                liveSha: toSha,
+                previousDeploySha: fromSha,
+                trackedPreviousDeploySha,
+                trackedCurrentDeploySha: normalizeSha(deployMarker?.commit),
+                changedFiles,
+                changedEndpoints,
+                changedTests,
+                commits,
+                pullRequestLinks,
+            };
+        }
+        catch {
+            return {
+                ok: true,
+                generatedAt: Date.now(),
+                liveSha: 'unknown',
+                previousDeploySha: 'unknown',
+                trackedPreviousDeploySha: null,
+                trackedCurrentDeploySha: null,
+                changedFiles: [],
+                changedEndpoints: [],
+                changedTests: [],
+                commits: [],
+                pullRequestLinks: [],
+            };
+        }
+    },
+    async getReleaseNotes(options) {
+        const deployMarker = await readDeployMarker();
+        const fallbackSince = Date.now() - 24 * 60 * 60 * 1000;
+        const since = options?.since ?? deployMarker?.deployedAt ?? fallbackSince;
+        const limit = Math.max(1, Math.min(options?.limit ?? 25, 200));
+        const doneTasks = taskManager
+            .listTasks({ status: 'done' })
+            .filter(task => (task.updatedAt || task.createdAt) >= since)
+            .sort((a, b) => (b.updatedAt || b.createdAt) - (a.updatedAt || a.createdAt))
+            .slice(0, limit);
+        const endpointChanges = new Set();
+        for (const task of doneTasks) {
+            for (const endpoint of extractEndpointMentions(task)) {
+                endpointChanges.add(endpoint);
+            }
+        }
+        const markdownLines = [];
+        markdownLines.push('# Release Notes');
+        markdownLines.push('');
+        markdownLines.push(`Generated: ${new Date().toISOString()}`);
+        markdownLines.push(`Window start: ${new Date(since).toISOString()}`);
+        if (deployMarker?.deployedAt) {
+            markdownLines.push(`Last deploy marker: ${new Date(deployMarker.deployedAt).toISOString()}`);
+        }
+        markdownLines.push('');
+        markdownLines.push('## Merged Tasks');
+        markdownLines.push('');
+        if (doneTasks.length === 0) {
+            markdownLines.push('- No completed tasks in this window.');
+        }
+        else {
+            for (const task of doneTasks) {
+                const owner = task.assignee || task.createdBy;
+                const priority = task.priority || 'P3';
+                markdownLines.push(`- ${task.id} [${priority}] ${task.title} (owner: ${owner})`);
+            }
+        }
+        markdownLines.push('');
+        markdownLines.push('## Endpoint Changes (inferred)');
+        markdownLines.push('');
+        const endpoints = Array.from(endpointChanges).sort();
+        if (endpoints.length === 0) {
+            markdownLines.push('- None inferred from task metadata.');
+        }
+        else {
+            for (const endpoint of endpoints) {
+                markdownLines.push(`- ${endpoint}`);
+            }
+        }
+        return {
+            since,
+            generatedAt: Date.now(),
+            mergedTasks: doneTasks.map(task => ({
+                id: task.id,
+                title: task.title,
+                assignee: task.assignee,
+                createdBy: task.createdBy,
+                priority: task.priority,
+                tags: task.tags,
+                updatedAt: task.updatedAt,
+            })),
+            endpointChanges: endpoints,
+            markdown: markdownLines.join('\n'),
+        };
+    },
+};
+//# sourceMappingURL=release.js.map