openplanr 1.2.6 → 1.2.8

package/dist/services/cascade-service.js

@@ -0,0 +1,189 @@
+/**
+ * Cascade execution for `planr revise` (EPIC-003, FEAT-012).
+ *
+ * Responsibilities:
+ *
+ *   1. **Build cascade order** — top-down: epic → features → stories → tasks.
+ *      The artifact hierarchy is a strict tree; no cycle detection is needed.
+ *   2. **Execute the cascade** — for each artifact in order, call the
+ *      caller-provided `processOne` closure. The cascade stops on
+ *      SIGINT, `[q]uit`, or an unrecoverable agent error, and always
+ *      flushes audit entries immediately so an interrupted run leaves an
+ *      accurate record.
+ *   3. **Progress tracking** — emits a `CascadeProgress` snapshot before
+ *      each artifact, with a rolling ETA.
+ *
+ * This service owns NO rollback logic. Partial cascades that break the
+ * artifact graph are the concern of FEAT-013's post-flight rollback.
+ */
+import { logger } from '../utils/logger.js';
+import { listArtifacts, readArtifact } from './artifact-service.js';
+// ---------------------------------------------------------------------------
+// Cascade order (§1.0)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the cascade plan for a root artifact, walking its descendants in
+ * top-down order. For an epic root, the plan is:
+ *   EPIC → [features under epic] → [stories under those features] → [tasks under those stories]
+ * For a feature root, the EPIC level is empty and features contain only the root, etc.
+ */
+export async function buildCascadeOrder(projectDir, config, rootType, rootId) {
+    const levels = [
+        { type: 'epic', label: 'epic', artifactIds: [] },
+        { type: 'feature', label: 'features', artifactIds: [] },
+        { type: 'story', label: 'stories', artifactIds: [] },
+        { type: 'task', label: 'tasks', artifactIds: [] },
+    ];
+    if (rootType === 'epic') {
+        levels[0].artifactIds = [rootId];
+        const features = await listArtifacts(projectDir, config, 'feature');
+        for (const f of features) {
+            const featureArtifact = await readArtifact(projectDir, config, 'feature', f.id);
+            if (featureArtifact?.data.epicId === rootId) {
+                levels[1].artifactIds.push(f.id);
+            }
+        }
+        for (const featureId of levels[1].artifactIds) {
+            const stories = await listArtifacts(projectDir, config, 'story');
+            for (const s of stories) {
+                const storyArtifact = await readArtifact(projectDir, config, 'story', s.id);
+                if (storyArtifact?.data.featureId === featureId) {
+                    levels[2].artifactIds.push(s.id);
+                }
+            }
+        }
+        for (const storyId of levels[2].artifactIds) {
+            const tasks = await listArtifacts(projectDir, config, 'task');
+            for (const t of tasks) {
+                const taskArtifact = await readArtifact(projectDir, config, 'task', t.id);
+                if (taskArtifact?.data.storyId === storyId) {
+                    levels[3].artifactIds.push(t.id);
+                }
+            }
+        }
+    }
+    else if (rootType === 'feature') {
+        levels[1].artifactIds = [rootId];
+        const stories = await listArtifacts(projectDir, config, 'story');
+        for (const s of stories) {
+            const storyArtifact = await readArtifact(projectDir, config, 'story', s.id);
+            if (storyArtifact?.data.featureId === rootId) {
+                levels[2].artifactIds.push(s.id);
+            }
+        }
+        for (const storyId of levels[2].artifactIds) {
+            const tasks = await listArtifacts(projectDir, config, 'task');
+            for (const t of tasks) {
+                const taskArtifact = await readArtifact(projectDir, config, 'task', t.id);
+                if (taskArtifact?.data.storyId === storyId) {
+                    levels[3].artifactIds.push(t.id);
+                }
+            }
+        }
+    }
+    else if (rootType === 'story') {
+        levels[2].artifactIds = [rootId];
+        const tasks = await listArtifacts(projectDir, config, 'task');
+        for (const t of tasks) {
+            const taskArtifact = await readArtifact(projectDir, config, 'task', t.id);
+            if (taskArtifact?.data.storyId === rootId) {
+                levels[3].artifactIds.push(t.id);
+            }
+        }
+    }
+    else if (rootType === 'task') {
+        levels[3].artifactIds = [rootId];
+    }
+    else {
+        // Non-hierarchy types (quick, backlog, sprint, adr, checklist) — cascade
+        // is a no-op scope that only processes the root. We stash the id at the
+        // tasks level to avoid leaving the plan empty.
+        levels[3].artifactIds = [rootId];
+    }
+    const orderedIds = levels.flatMap((l) => l.artifactIds);
+    return { rootId, rootType, levels, orderedIds };
+}
+/**
+ * Drive the cascade plan through the provided processor. Installs a SIGINT
+ * handler for the duration of the run; on Ctrl+C it waits for the current
+ * artifact to finish (so no half-written files) and then stops. The SIGINT
+ * handler is removed on completion whether or not it fired.
+ */
+export async function executeCascade(options) {
+    const { plan, processor } = options;
+    const signalTarget = options.signalTarget ?? process;
+    const total = plan.orderedIds.length;
+    let completed = 0;
+    let interruptedByUser = false;
+    const sigintHandler = () => {
+        interruptedByUser = true;
+        logger.warn('\nSIGINT received — cascade will stop after current artifact completes.');
+    };
+    signalTarget.once('SIGINT', sigintHandler);
+    const started = Date.now();
+    try {
+        for (const level of plan.levels) {
+            for (const artifactId of level.artifactIds) {
+                if (interruptedByUser) {
+                    return {
+                        completed,
+                        total,
+                        interrupted: { reason: 'sigint', atArtifactId: artifactId },
+                    };
+                }
+                const progress = {
+                    completed,
+                    total,
+                    currentArtifactId: artifactId,
+                    currentLevelLabel: level.label,
+                    etaSeconds: estimateEta(started, completed, total),
+                };
+                options.onProgress?.(progress);
+                let outcome;
+                try {
+                    outcome = await processor({
+                        artifactId,
+                        levelLabel: level.label,
+                        progress,
+                    });
+                }
+                catch (err) {
+                    logger.error(`Cascade aborted at ${artifactId}: ${err instanceof Error ? err.message : String(err)}`);
+                    return {
+                        completed,
+                        total,
+                        interrupted: { reason: 'agent_error', atArtifactId: artifactId },
+                    };
+                }
+                completed++;
+                if (!outcome.continue) {
+                    return {
+                        completed,
+                        total,
+                        interrupted: {
+                            reason: outcome.stopReason === 'q' ? 'q' : 'agent_error',
+                            atArtifactId: artifactId,
+                        },
+                    };
+                }
+            }
+        }
+        return { completed, total };
+    }
+    finally {
+        signalTarget.removeListener('SIGINT', sigintHandler);
+    }
+}
+/**
+ * Estimate seconds remaining based on observed pace. Returns null for the
+ * first couple of samples so the UI doesn't print wildly unstable numbers.
+ */
+function estimateEta(startedMs, completed, total) {
+    if (completed < 2 || total === 0)
+        return null;
+    const elapsed = (Date.now() - startedMs) / 1000;
+    const perItem = elapsed / completed;
+    const remaining = Math.max(0, total - completed);
+    return Math.round(perItem * remaining);
+}
+//# sourceMappingURL=cascade-service.js.map

package/dist/services/cascade-service.js.map

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

package/dist/services/context-pack-service.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Assemble stakeholder report context from `.planr/` artifacts and optional GitHub signals.
+ */
+import type { OpenPlanrConfig, StakeholderReportContext, StakeholderReportType } from '../models/types.js';
+export interface BuildContextOptions {
+    reportType: StakeholderReportType;
+    days: number;
+    sprintId?: string;
+    includeGitHub: boolean;
+}
+export declare function buildStakeholderReportContext(projectDir: string, config: OpenPlanrConfig, opts: BuildContextOptions): Promise<StakeholderReportContext>;
+//# sourceMappingURL=context-pack-service.d.ts.map

package/dist/services/context-pack-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pack-service.d.ts","sourceRoot":"","sources":["../../src/services/context-pack-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,eAAe,EAIf,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,qBAAqB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAaD,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,wBAAwB,CAAC,CAmHnC"}

package/dist/services/context-pack-service.js

@@ -0,0 +1,155 @@
+/**
+ * Assemble stakeholder report context from `.planr/` artifacts and optional GitHub signals.
+ */
+import { listArtifacts, readArtifact } from './artifact-service.js';
+import { fetchRecentCommits, fetchRecentPullRequests } from './github-service.js';
+function statusOf(data) {
+    const s = data.status ?? data.Status;
+    return typeof s === 'string' ? s : 'unknown';
+}
+function titleOf(meta, data) {
+    const t = data.title;
+    if (typeof t === 'string' && t.trim())
+        return t;
+    return meta.title;
+}
+export async function buildStakeholderReportContext(projectDir, config, opts) {
+    const generatedAt = new Date().toISOString();
+    const epicsMeta = await listArtifacts(projectDir, config, 'epic');
+    const featuresMeta = await listArtifacts(projectDir, config, 'feature');
+    const storiesMeta = await listArtifacts(projectDir, config, 'story');
+    const tasksMeta = await listArtifacts(projectDir, config, 'task');
+    const epics = [];
+    for (const m of epicsMeta) {
+        const a = await readArtifact(projectDir, config, 'epic', m.id);
+        const data = (a?.data ?? {});
+        epics.push({
+            id: m.id,
+            title: titleOf(m, data),
+            status: statusOf(data),
+            type: 'epic',
+        });
+    }
+    const features = [];
+    for (const m of featuresMeta) {
+        const a = await readArtifact(projectDir, config, 'feature', m.id);
+        const data = (a?.data ?? {});
+        features.push({
+            id: m.id,
+            title: titleOf(m, data),
+            status: statusOf(data),
+            type: 'feature',
+        });
+    }
+    const stories = [];
+    for (const m of storiesMeta) {
+        const a = await readArtifact(projectDir, config, 'story', m.id);
+        const data = (a?.data ?? {});
+        stories.push({
+            id: m.id,
+            title: titleOf(m, data),
+            status: statusOf(data),
+            type: 'story',
+        });
+    }
+    const tasks = [];
+    for (const m of tasksMeta) {
+        const a = await readArtifact(projectDir, config, 'task', m.id);
+        const data = (a?.data ?? {});
+        tasks.push({
+            id: m.id,
+            title: titleOf(m, data),
+            status: statusOf(data),
+            type: 'task',
+        });
+    }
+    let sprint;
+    if (opts.sprintId) {
+        const s = await readArtifact(projectDir, config, 'sprint', opts.sprintId);
+        if (s) {
+            const data = s.data;
+            const rawGoals = data.goals;
+            const goals = Array.isArray(rawGoals) ? rawGoals.map(String) : [];
+            const rawTaskIds = data.taskIds;
+            const taskIds = Array.isArray(rawTaskIds) ? rawTaskIds.map(String) : [];
+            sprint = {
+                sprintId: opts.sprintId,
+                name: String(data.name ?? opts.sprintId),
+                status: statusOf(data),
+                startDate: String(data.startDate ?? ''),
+                endDate: String(data.endDate ?? ''),
+                goals,
+                taskIds,
+            };
+        }
+    }
+    let github;
+    let noGitHub = !opts.includeGitHub;
+    if (opts.includeGitHub) {
+        const [cRes, pRes] = await Promise.all([
+            fetchRecentCommits({ days: opts.days, limit: 30 }),
+            fetchRecentPullRequests({ days: opts.days, limit: 20 }),
+        ]);
+        const warn = [cRes.warning, pRes.warning].filter(Boolean).join(' ');
+        github = {
+            commits: cRes.commits,
+            pullRequests: pRes.pullRequests,
+            warning: warn || undefined,
+            fetchedAt: generatedAt,
+        };
+        noGitHub = Boolean(warn) && cRes.commits.length === 0 && pRes.pullRequests.length === 0;
+    }
+    const doneStories = stories.filter((x) => /done|closed/i.test(x.status));
+    const anchorStories = doneStories.length > 0 ? doneStories.slice(0, 15) : stories.slice(0, 15);
+    const evidence = buildEvidenceList(github, anchorStories);
+    const branding = config.reports;
+    return {
+        projectName: config.projectName,
+        generatedAt,
+        reportType: opts.reportType,
+        daysLookback: opts.days,
+        sprint,
+        artifacts: { epics, features, stories, tasks },
+        github,
+        branding,
+        placeholders: {
+            noSprint: !sprint,
+            noGitHub: noGitHub,
+            noStoriesCompleted: doneStories.length === 0,
+        },
+        evidence,
+    };
+}
+function buildEvidenceList(github, stories) {
+    const out = [];
+    for (const s of stories) {
+        out.push({
+            id: `artifact-${s.id}`,
+            kind: 'artifact',
+            label: `${s.id}: ${s.title}`,
+            detail: `Status: ${s.status}`,
+        });
+    }
+    if (github) {
+        for (const c of github.commits.slice(0, 20)) {
+            out.push({
+                id: `commit-${c.shortSha}`,
+                kind: 'commit',
+                label: c.message,
+                url: c.url,
+                detail: `${c.authorLogin} · ${c.committedDate}`,
+            });
+        }
+        for (const p of github.pullRequests.slice(0, 15)) {
+            out.push({
+                id: `pr-${p.number}`,
+                kind: 'pull_request',
+                label: `PR #${p.number}: ${p.title}`,
+                url: p.url,
+                detail: `${p.state} · ${p.authorLogin}`,
+            });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=context-pack-service.js.map

package/dist/services/context-pack-service.js.map

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

package/dist/services/diff-service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Colored diff preview for revise (EPIC-003, FEAT-011 §4.2).
+ *
+ * Wraps the pure `unifiedDiff` utility with chalk formatting. The returned
+ * string is what the CLI prints before asking the user to apply / skip /
+ * edit / re-view / quit.
+ */
+import { type UnifiedDiffOptions } from '../utils/diff.js';
+export interface RenderDiffOptions extends UnifiedDiffOptions {
+    /** Set to false to skip ANSI color codes (useful for tests / non-TTY output). */
+    color?: boolean;
+}
+/**
+ * Produce a unified diff between `oldText` and `newText`, color-coded for
+ * terminal display. Returns the empty string when the two are identical.
+ */
+export declare function renderDiff(oldText: string, newText: string, options?: RenderDiffOptions): string;
+//# sourceMappingURL=diff-service.d.ts.map

package/dist/services/diff-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-service.d.ts","sourceRoot":"","sources":["../../src/services/diff-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,kBAAkB,CAAC;AAExE,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAeR"}

package/dist/services/diff-service.js

@@ -0,0 +1,35 @@
+/**
+ * Colored diff preview for revise (EPIC-003, FEAT-011 §4.2).
+ *
+ * Wraps the pure `unifiedDiff` utility with chalk formatting. The returned
+ * string is what the CLI prints before asking the user to apply / skip /
+ * edit / re-view / quit.
+ */
+import chalk from 'chalk';
+import { unifiedDiff } from '../utils/diff.js';
+/**
+ * Produce a unified diff between `oldText` and `newText`, color-coded for
+ * terminal display. Returns the empty string when the two are identical.
+ */
+export function renderDiff(oldText, newText, options = {}) {
+    const raw = unifiedDiff(oldText, newText, options);
+    if (raw.length === 0)
+        return '';
+    if (options.color === false)
+        return raw;
+    return raw
+        .split('\n')
+        .map((line) => {
+        if (line.startsWith('+++') || line.startsWith('---'))
+            return chalk.bold(line);
+        if (line.startsWith('@@'))
+            return chalk.cyan(line);
+        if (line.startsWith('+'))
+            return chalk.green(line);
+        if (line.startsWith('-'))
+            return chalk.red(line);
+        return chalk.dim(line);
+    })
+        .join('\n');
+}
+//# sourceMappingURL=diff-service.js.map

package/dist/services/diff-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-service.js","sourceRoot":"","sources":["../../src/services/diff-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA2B,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOxE;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,OAAe,EACf,UAA6B,EAAE;IAE/B,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IAExC,OAAO,GAAG;SACP,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/services/distribution-service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Delivery channels for stakeholder reports (GitHub issue push; Slack webhooks; email stub).
+ */
+import type { DistributionResult, OpenPlanrConfig } from '../models/types.js';
+export declare function pushReportAsGitHubIssue(args: {
+    title: string;
+    body: string;
+    dryRun: boolean;
+}): Promise<DistributionResult>;
+export declare function pushReportToSlack(config: OpenPlanrConfig, markdown: string, args?: {
+    dryRun?: boolean;
+}): Promise<DistributionResult>;
+export declare function pushReportByEmail(_config: OpenPlanrConfig, _args: {
+    to: string[];
+    subject: string;
+    body: string;
+}): Promise<DistributionResult>;
+//# sourceMappingURL=distribution-service.d.ts.map

package/dist/services/distribution-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribution-service.d.ts","sourceRoot":"","sources":["../../src/services/distribution-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAW9E,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwB9B;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CA0D7B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}

package/dist/services/distribution-service.js

@@ -0,0 +1,104 @@
+/**
+ * Delivery channels for stakeholder reports (GitHub issue push; Slack webhooks; email stub).
+ */
+import { createIssue, ensureLabel } from './github-service.js';
+const SLACK_TEXT_MAX = 12000;
+function truncateForSlack(text) {
+    const t = text.trim();
+    if (t.length <= SLACK_TEXT_MAX)
+        return t;
+    return `${t.slice(0, SLACK_TEXT_MAX)}\n\n…(truncated; full report saved locally)`;
+}
+export async function pushReportAsGitHubIssue(args) {
+    if (args.dryRun) {
+        return {
+            channel: 'github_issue',
+            ok: true,
+            message: 'Dry run: would create GitHub issue with stakeholder report body.',
+        };
+    }
+    try {
+        await ensureLabel('planr:report');
+        const { url } = await createIssue(args.title, args.body, ['planr:report']);
+        return {
+            channel: 'github_issue',
+            ok: true,
+            message: 'Created GitHub issue with report.',
+            url,
+        };
+    }
+    catch (err) {
+        return {
+            channel: 'github_issue',
+            ok: false,
+            message: err.message,
+        };
+    }
+}
+export async function pushReportToSlack(config, markdown, args) {
+    const url = config.distribution?.slackWebhookUrl;
+    if (args?.dryRun) {
+        if (!url) {
+            return {
+                channel: 'slack',
+                ok: true,
+                message: 'Dry run: no Slack webhook in config (no POST). Add `distribution.slackWebhookUrl` to .planr/config.json, then run without --dry-run to send.',
+            };
+        }
+        return {
+            channel: 'slack',
+            ok: true,
+            message: `Dry run: would POST ~${Math.min(markdown.length, SLACK_TEXT_MAX)} chars to your Slack webhook (no request sent).`,
+        };
+    }
+    if (!url) {
+        return {
+            channel: 'slack',
+            ok: false,
+            message: 'Slack is not configured. Set `distribution.slackWebhookUrl` in .planr/config.json (or use --push github).',
+        };
+    }
+    try {
+        const payload = { text: truncateForSlack(markdown) };
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        const bodyText = await res.text().catch(() => '');
+        if (!res.ok) {
+            return {
+                channel: 'slack',
+                ok: false,
+                message: `Slack webhook failed (${res.status}): ${bodyText || res.statusText}. Check the webhook URL and app permissions.`,
+            };
+        }
+        return {
+            channel: 'slack',
+            ok: true,
+            message: 'Posted report to Slack.',
+        };
+    }
+    catch (err) {
+        return {
+            channel: 'slack',
+            ok: false,
+            message: `Slack request failed: ${err.message}`,
+        };
+    }
+}
+export async function pushReportByEmail(_config, _args) {
+    if (!_config.distribution?.emailSmtpHost) {
+        return {
+            channel: 'email',
+            ok: false,
+            message: 'Email is not configured. Set `distribution.emailSmtpHost` and related fields in .planr/config.json.',
+        };
+    }
+    return {
+        channel: 'email',
+        ok: false,
+        message: 'SMTP delivery is not implemented in this build.',
+    };
+}
+//# sourceMappingURL=distribution-service.js.map

package/dist/services/distribution-service.js.map

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

package/dist/services/evidence-service.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Evidence linking and validation for stakeholder reports.
+ */
+import type { ClaimValidationResult, EvidenceSummary, ReportEvidenceItem, StakeholderReportType } from '../models/types.js';
+export declare function countEvidenceAnchors(markdown: string): number;
+export interface ValidateClaimsOptions {
+    /** Included for forward-compatible per-report tuning; reserved for future use. */
+    reportType?: StakeholderReportType;
+}
+export declare function validateClaimsHaveAnchors(markdown: string, minAnchors: number, options?: ValidateClaimsOptions): ClaimValidationResult[];
+export declare function validateRemoteEvidence(items: ReportEvidenceItem[]): Promise<{
+    inaccessible: ReportEvidenceItem[];
+    repoOk: boolean;
+    repoMessage: string;
+}>;
+export declare function summarizeEvidenceItem(item: ReportEvidenceItem): EvidenceSummary;
+//# sourceMappingURL=evidence-service.d.ts.map

package/dist/services/evidence-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-service.d.ts","sourceRoot":"","sources":["../../src/services/evidence-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAM5B,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,UAAU,CAAC,EAAE,qBAAqB,CAAC;CACpC;AAcD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,qBAAqB,EAAE,CAkCzB;AAED,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC;IACjF,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAeD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CAM/E"}