openplanr 1.2.6 → 1.2.8

package/dist/services/revise-service.js

@@ -0,0 +1,249 @@
+/**
+ * `planr revise` — core service (EPIC-003, FEAT-010 + FEAT-011).
+ *
+ * Exposes composable primitives; the CLI and future cascade service
+ * orchestrate them. Phase 1 (FEAT-010) ships `reviseArtifact` for dry-run
+ * decision generation; Phase 2 (FEAT-011) adds `applyDecision` for the
+ * write path and exposes the verifier context so callers can run
+ * `verifyDecision` against the same inputs the agent saw.
+ */
+import path from 'node:path';
+import { buildCodebaseContext, extractKeywords, formatCodebaseContext, } from '../ai/codebase/context-builder.js';
+import { buildRevisePrompt, } from '../ai/prompts/prompt-builder.js';
+import { aiReviseDecisionSchema } from '../ai/schemas/ai-response-schemas.js';
+import { TOKEN_BUDGETS } from '../ai/types.js';
+import { logger } from '../utils/logger.js';
+import { generateJSON } from './ai-service.js';
+import { findArtifactTypeById, getArtifactDir, getParentChain, listArtifacts, readArtifact, readArtifactRaw, resolveArtifactFilename, } from './artifact-service.js';
+import { atomicWriteFile } from './atomic-write-service.js';
+import { renderDiff } from './diff-service.js';
+import { getCanonicalSections } from './template-sections.js';
+/**
+ * Error thrown when an artifact id cannot be resolved to an artifact type or
+ * the artifact file does not exist on disk.
+ */
+export class ReviseArtifactNotFoundError extends Error {
+    artifactId;
+    constructor(artifactId, message) {
+        super(message);
+        this.name = 'ReviseArtifactNotFoundError';
+        this.artifactId = artifactId;
+    }
+}
+/**
+ * Revise a single artifact — Phase 1 dry-run.
+ *
+ * Does NOT write any files. The returned decision is the agent output after
+ * schema validation; evidence verification, diff preview, and write are all
+ * Phase 2 responsibilities (FEAT-011). Cascade, siblings, and declared
+ * sources are Phase 3 (FEAT-012) and onwards.
+ */
+export async function reviseArtifact(projectDir, config, provider, artifactId, options) {
+    const artifactType = findArtifactTypeById(artifactId);
+    if (!artifactType) {
+        throw new ReviseArtifactNotFoundError(artifactId, `Cannot determine artifact type from ID: ${artifactId}. Expected format: EPIC-001, FEAT-001, US-001, TASK-001.`);
+    }
+    const artifactRaw = await readArtifactRaw(projectDir, config, artifactType, artifactId);
+    if (artifactRaw === null) {
+        throw new ReviseArtifactNotFoundError(artifactId, `Artifact ${artifactId} not found under ${artifactType}/ directory.`);
+    }
+    const parents = await loadParentPromptArtifacts(projectDir, config, artifactType, artifactId);
+    const siblings = options.noSiblingContext
+        ? []
+        : await loadSiblingPromptArtifacts(projectDir, config, artifactType, artifactId, options.maxSiblings ?? 8);
+    let codebaseContextFormatted;
+    let codebaseCtx;
+    if (!options.noCodeContext) {
+        const keywords = extractKeywords(artifactRaw);
+        codebaseCtx = await buildCodebaseContext(projectDir, keywords);
+        codebaseContextFormatted = formatCodebaseContext(codebaseCtx);
+    }
+    const messages = buildRevisePrompt({
+        artifact: { id: artifactId, type: artifactType, content: artifactRaw },
+        parents,
+        siblings,
+        codebaseContextFormatted,
+        sources: [], // Declared-sources loader lands with the revise.yaml config work
+        writableScope: options.writableScope ?? 'all',
+        canonicalSections: getCanonicalSections(artifactType),
+    });
+    logger.debug(`reviseArtifact: calling AI for ${artifactId}`);
+    const result = await generateJSON(provider, messages, aiReviseDecisionSchema, {
+        maxTokens: TOKEN_BUDGETS.revise,
+    });
+    // resolveArtifactFilename strips the `.md` extension (other callers want the
+    // slug form). Revise must write to the full `.md` file, so append the
+    // extension explicitly. Defensive fallback if a future version ever returns
+    // a filename with the extension intact.
+    const filenameNoExt = await resolveArtifactFilename(projectDir, config, artifactType, artifactId);
+    const artifactDir = path.join(projectDir, getArtifactDir(config, artifactType));
+    const fullFilename = filenameNoExt.endsWith('.md') ? filenameNoExt : `${filenameNoExt}.md`;
+    const artifactPath = path.join(artifactDir, fullFilename);
+    const verifierContext = {
+        projectDir,
+        config,
+        artifactDir: path.dirname(artifactPath),
+        codebaseContextFormatted,
+        knownSourceRefs: [], // Phase 2 sources loader will populate
+        knownPatternRuleIds: codebaseCtx ? codebaseCtx.patternRules.map((r) => r.name) : [],
+    };
+    return {
+        decision: result.result,
+        usage: result.usage ?? { inputTokens: 0, outputTokens: 0 },
+        contextStats: {
+            parentsLoaded: parents.length,
+            siblingsLoaded: siblings.length,
+            codebaseContextIncluded: !!codebaseContextFormatted,
+            sourcesLoaded: 0,
+        },
+        artifactPath,
+        originalContent: artifactRaw,
+        verifierContext,
+    };
+}
+/**
+ * Apply a (verified) decision: write the artifact atomically when
+ * `action === 'revise'` and `dryRun` is false, emit an audit entry
+ * describing the outcome either way.
+ *
+ * Caller is expected to have already run `verifyDecision` — `applyDecision`
+ * trusts that whatever decision arrives is allowed to be written.
+ */
+export async function applyDecision(options) {
+    const { decision, audit, dryRun, originalContent, artifactPath, backupDir } = options;
+    const timestamp = new Date().toISOString();
+    if (decision.action === 'skip') {
+        audit.appendEntry({
+            artifactId: decision.artifactId,
+            artifactPath,
+            outcome: 'skipped-by-agent',
+            rationale: decision.rationale,
+            evidence: decision.evidence,
+            ambiguous: decision.ambiguous,
+            cascadeLevel: options.cascadeLevel,
+            timestamp,
+        });
+        return { outcome: 'skipped-by-agent', wrote: false, diff: '' };
+    }
+    if (decision.action === 'flag') {
+        audit.appendEntry({
+            artifactId: decision.artifactId,
+            artifactPath,
+            outcome: 'flagged',
+            rationale: decision.rationale,
+            evidence: decision.evidence,
+            ambiguous: decision.ambiguous,
+            cascadeLevel: options.cascadeLevel,
+            timestamp,
+        });
+        return { outcome: 'flagged', wrote: false, diff: '' };
+    }
+    // action === 'revise'
+    const diff = decision.revisedMarkdown
+        ? renderDiff(originalContent, decision.revisedMarkdown, {
+            color: false,
+            oldLabel: `${decision.artifactId} (before)`,
+            newLabel: `${decision.artifactId} (proposed)`,
+        })
+        : '';
+    if (dryRun) {
+        audit.appendEntry({
+            artifactId: decision.artifactId,
+            artifactPath,
+            outcome: 'would-apply',
+            rationale: decision.rationale,
+            evidence: decision.evidence,
+            ambiguous: decision.ambiguous,
+            cascadeLevel: options.cascadeLevel,
+            diff,
+            timestamp,
+        });
+        return { outcome: 'would-apply', wrote: false, diff };
+    }
+    // Real apply: atomic write + sidecar backup.
+    const backupPath = path.join(backupDir, `${decision.artifactId}.md.bak`);
+    await atomicWriteFile(artifactPath, decision.revisedMarkdown ?? '', { backupPath });
+    audit.appendEntry({
+        artifactId: decision.artifactId,
+        artifactPath,
+        outcome: 'applied',
+        rationale: decision.rationale,
+        evidence: decision.evidence,
+        ambiguous: decision.ambiguous,
+        cascadeLevel: options.cascadeLevel,
+        diff,
+        timestamp,
+    });
+    return { outcome: 'applied', wrote: true, diff };
+}
+/**
+ * Load immediate-sibling artifacts (same artifact type, same parent) as
+ * prompt entries. Lazy-reads each sibling's body only if it's going to be
+ * included — the listing check is cheap, the reads are budgeted by
+ * `maxSiblings` (default 8) so the prompt stays within token budget even on
+ * epics with many features.
+ *
+ * For epic scope, there are no siblings (epics live at the top). For types
+ * without a parent-id relationship (quick, backlog, etc.), returns empty.
+ */
+export async function loadSiblingPromptArtifacts(projectDir, config, type, id, maxSiblings) {
+    const parentFieldByType = {
+        feature: 'epicId',
+        story: 'featureId',
+        task: 'storyId',
+    };
+    const parentField = parentFieldByType[type];
+    if (!parentField)
+        return [];
+    const self = await readArtifact(projectDir, config, type, id);
+    if (!self)
+        return [];
+    const parentId = self.data[parentField];
+    if (!parentId)
+        return [];
+    const siblings = [];
+    const listing = await listArtifacts(projectDir, config, type);
+    for (const entry of listing) {
+        if (siblings.length >= maxSiblings)
+            break;
+        if (entry.id === id)
+            continue;
+        const sib = await readArtifact(projectDir, config, type, entry.id);
+        if (sib && sib.data[parentField] === parentId) {
+            siblings.push({ id: entry.id, type, content: sib.content });
+        }
+    }
+    return siblings;
+}
+/**
+ * Resolve the parent chain for an artifact and return it as the ordered
+ * `RevisePromptArtifact[]` the prompt builder expects (epic → feature →
+ * story). Empty array for top-level artifacts (epic scope).
+ */
+export async function loadParentPromptArtifacts(projectDir, config, type, id) {
+    const chain = await getParentChain(projectDir, config, type, id);
+    const parents = [];
+    if (chain.epic) {
+        parents.push({
+            id: String(chain.epic.data.id),
+            type: 'epic',
+            content: chain.epic.content,
+        });
+    }
+    if (chain.feature) {
+        parents.push({
+            id: String(chain.feature.data.id),
+            type: 'feature',
+            content: chain.feature.content,
+        });
+    }
+    if (chain.story) {
+        parents.push({
+            id: String(chain.story.data.id),
+            type: 'story',
+            content: chain.story.content,
+        });
+    }
+    return parents;
+}
+//# sourceMappingURL=revise-service.js.map

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

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

package/dist/services/standup-parser.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Heuristic parsing of a standup transcript into yesterday / today / blockers.
+ */
+export interface TranscriptSegment {
+    section: 'yesterday' | 'today' | 'blockers' | 'note';
+    text: string;
+    /** Placeholder for future audio/text sync (milliseconds from clip start) */
+    audioOffsetMs?: number;
+}
+export interface ParsedStandup {
+    yesterday: string[];
+    today: string[];
+    blockers: string[];
+    incomplete: boolean;
+    notes: string[];
+    /** Best-effort line segments (no audio yet — offsets unused until capture exists) */
+    segments: TranscriptSegment[];
+}
+export declare function parseStandupTranscript(raw: string): ParsedStandup;
+export declare function formatStandupMarkdown(parsed: ParsedStandup): string;
+//# sourceMappingURL=standup-parser.d.ts.map

package/dist/services/standup-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standup-parser.d.ts","sourceRoot":"","sources":["../../src/services/standup-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qFAAqF;IACrF,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAMD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CA0EjE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAoBnE"}

package/dist/services/standup-parser.js

@@ -0,0 +1,104 @@
+/**
+ * Heuristic parsing of a standup transcript into yesterday / today / blockers.
+ */
+const YDAY = /^(yesterday|last day|previously|done)\s*[:-]?\s*(.+)$/i;
+const TODAY = /^(today|now|this session|working on)\s*[:-]?\s*(.+)$/i;
+const BLOCK = /^(blockers?|blocked|impediments?)\s*[:-]?\s*(.+)$/i;
+export function parseStandupTranscript(raw) {
+    const yesterday = [];
+    const today = [];
+    const blockers = [];
+    const notes = [];
+    const segments = [];
+    const lines = raw
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter(Boolean);
+    let mode = null;
+    for (const line of lines) {
+        let m = line.match(YDAY);
+        if (m) {
+            mode = 'y';
+            const t = m[2].trim();
+            yesterday.push(t);
+            segments.push({ section: 'yesterday', text: t });
+            continue;
+        }
+        m = line.match(TODAY);
+        if (m) {
+            mode = 't';
+            const t = m[2].trim();
+            today.push(t);
+            segments.push({ section: 'today', text: t });
+            continue;
+        }
+        m = line.match(BLOCK);
+        if (m) {
+            mode = 'b';
+            const t = m[2].trim();
+            blockers.push(t);
+            segments.push({ section: 'blockers', text: t });
+            continue;
+        }
+        if (/^[-*]\s+/.test(line)) {
+            const item = line.replace(/^[-*]\s+/, '').trim();
+            if (mode === 'y') {
+                yesterday.push(item);
+                segments.push({ section: 'yesterday', text: item });
+            }
+            else if (mode === 't') {
+                today.push(item);
+                segments.push({ section: 'today', text: item });
+            }
+            else if (mode === 'b') {
+                blockers.push(item);
+                segments.push({ section: 'blockers', text: item });
+            }
+            else {
+                notes.push(item);
+                segments.push({ section: 'note', text: item });
+            }
+            continue;
+        }
+        if (mode === 'y') {
+            yesterday.push(line);
+            segments.push({ section: 'yesterday', text: line });
+        }
+        else if (mode === 't') {
+            today.push(line);
+            segments.push({ section: 'today', text: line });
+        }
+        else if (mode === 'b') {
+            blockers.push(line);
+            segments.push({ section: 'blockers', text: line });
+        }
+        else {
+            notes.push(line);
+            segments.push({ section: 'note', text: line });
+        }
+    }
+    const incomplete = yesterday.length === 0 || today.length === 0;
+    return { yesterday, today, blockers, incomplete, notes, segments };
+}
+export function formatStandupMarkdown(parsed) {
+    const sec = (title, items) => {
+        const body = items.length > 0 ? items.map((i) => `- ${i}`).join('\n') : '_— none recorded —_';
+        return `## ${title}\n\n${body}`;
+    };
+    return [
+        '# Standup',
+        '',
+        sec('Yesterday', parsed.yesterday),
+        '',
+        sec('Today', parsed.today),
+        '',
+        sec('Blockers', parsed.blockers),
+        parsed.notes.length > 0 ? `\n## Notes\n\n${parsed.notes.map((n) => `- ${n}`).join('\n')}` : '',
+        parsed.incomplete
+            ? '\n> **Note:** Some standup sections look incomplete. Fill in missing parts before sending.\n'
+            : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+//# sourceMappingURL=standup-parser.js.map

package/dist/services/standup-parser.js.map

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

package/dist/services/story-standup-service.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Append generated standup markdown to a user story file.
+ */
+import type { OpenPlanrConfig } from '../models/types.js';
+export declare function injectStandupSection(raw: string, standupMarkdown: string, date: string): string;
+export declare function appendStandupToStory(projectDir: string, config: OpenPlanrConfig, storyId: string, standupMarkdown: string): Promise<void>;
+//# sourceMappingURL=story-standup-service.d.ts.map

package/dist/services/story-standup-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-standup-service.d.ts","sourceRoot":"","sources":["../../src/services/story-standup-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAe/F;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/services/story-standup-service.js

@@ -0,0 +1,27 @@
+/**
+ * Append generated standup markdown to a user story file.
+ */
+import { readArtifactRaw, updateArtifact } from './artifact-service.js';
+const STANDUP_SECTION = '## Standup notes';
+export function injectStandupSection(raw, standupMarkdown, date) {
+    const block = `\n### ${date}\n\n${standupMarkdown.trim()}\n`;
+    if (raw.includes(STANDUP_SECTION)) {
+        const idx = raw.indexOf(STANDUP_SECTION) + STANDUP_SECTION.length;
+        return `${raw.slice(0, idx)}${block}${raw.slice(idx)}`;
+    }
+    const tasksMatch = /\n## Tasks\b/m.exec(raw);
+    if (tasksMatch?.index !== undefined) {
+        const i = tasksMatch.index;
+        return `${raw.slice(0, i)}\n\n${STANDUP_SECTION}\n${block}\n${raw.slice(i)}`;
+    }
+    return `${raw.trimEnd()}\n\n${STANDUP_SECTION}\n${block}\n`;
+}
+export async function appendStandupToStory(projectDir, config, storyId, standupMarkdown) {
+    const raw = await readArtifactRaw(projectDir, config, 'story', storyId);
+    if (!raw)
+        throw new Error(`Story ${storyId} not found.`);
+    const date = new Date().toISOString().split('T')[0];
+    const next = injectStandupSection(raw, standupMarkdown, date);
+    await updateArtifact(projectDir, config, 'story', storyId, next);
+}
+//# sourceMappingURL=story-standup-service.js.map

package/dist/services/story-standup-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story-standup-service.js","sourceRoot":"","sources":["../../src/services/story-standup-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAE3C,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,eAAuB,EAAE,IAAY;IACrF,MAAM,KAAK,GAAG,SAAS,IAAI,OAAO,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC;IAE7D,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC;QAClE,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAU,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;QAC3B,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,eAAe,KAAK,KAAK,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,CAAC;IAED,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,eAAe,KAAK,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,MAAuB,EACvB,OAAe,EACf,eAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,aAAa,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAC9D,MAAM,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACnE,CAAC"}

package/dist/services/template-sections.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Canonical section lists per artifact type (EPIC-003, FEAT-014 follow-up).
+ *
+ * The revise prompt uses these to give the agent a *soft* conformance hint:
+ * "these are the sections a ${type} artifact canonically has — don't invent
+ * new ones; flag instead." This prevents the failure mode where the agent
+ * helpfully adds something like `## Relevant Files` to an epic (a task-level
+ * convention) when there is no drift justifying it.
+ *
+ * The lists mirror what the Handlebars templates in `src/templates/<type>/`
+ * actually emit. Kept hardcoded rather than parsed from the .hbs files at
+ * runtime because:
+ *
+ *   1. Handlebars templates contain `{{ }}` interpolation that would need
+ *      stripping before we could grep `## ` headings.
+ *   2. If a template gains a new section, we want an explicit review step
+ *      in this file, not silent pickup.
+ *   3. Parsing templates would couple revise to handlebars internals.
+ *
+ * When you add or rename a template section, update the matching entry here.
+ */
+import type { ArtifactType } from '../models/types.js';
+/**
+ * Return the canonical section list for an artifact type, or `undefined`
+ * when the type has no enforced convention (e.g., `backlog`).
+ */
+export declare function getCanonicalSections(type: ArtifactType): readonly string[] | undefined;
+//# sourceMappingURL=template-sections.d.ts.map

package/dist/services/template-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-sections.d.ts","sourceRoot":"","sources":["../../src/services/template-sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA6BvD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAEtF"}

package/dist/services/template-sections.js

@@ -0,0 +1,55 @@
+/**
+ * Canonical section lists per artifact type (EPIC-003, FEAT-014 follow-up).
+ *
+ * The revise prompt uses these to give the agent a *soft* conformance hint:
+ * "these are the sections a ${type} artifact canonically has — don't invent
+ * new ones; flag instead." This prevents the failure mode where the agent
+ * helpfully adds something like `## Relevant Files` to an epic (a task-level
+ * convention) when there is no drift justifying it.
+ *
+ * The lists mirror what the Handlebars templates in `src/templates/<type>/`
+ * actually emit. Kept hardcoded rather than parsed from the .hbs files at
+ * runtime because:
+ *
+ *   1. Handlebars templates contain `{{ }}` interpolation that would need
+ *      stripping before we could grep `## ` headings.
+ *   2. If a template gains a new section, we want an explicit review step
+ *      in this file, not silent pickup.
+ *   3. Parsing templates would couple revise to handlebars internals.
+ *
+ * When you add or rename a template section, update the matching entry here.
+ */
+const CANONICAL_SECTIONS = {
+    epic: [
+        'Business Value',
+        'Target Users',
+        'Problem Statement',
+        'Solution Overview',
+        'Success Criteria',
+        'Key Features',
+        'Dependencies',
+        'Risks',
+        'Features',
+    ],
+    feature: [
+        'Overview',
+        'Functional Requirements',
+        'User Stories',
+        'Dependencies',
+        'Technical Considerations',
+        'Risks',
+        'Success Metrics',
+    ],
+    story: ['User Story', 'Acceptance Criteria', 'Additional Notes', 'Tasks'],
+    task: ['Artifact Sources', 'Tasks', 'Acceptance Criteria Mapping', 'Relevant Files', 'Notes'],
+    // `quick`, `backlog`, `sprint`, `adr`, `checklist` — no canonical list
+    // enforced. Revise will skip the template-structure hint for these types.
+};
+/**
+ * Return the canonical section list for an artifact type, or `undefined`
+ * when the type has no enforced convention (e.g., `backlog`).
+ */
+export function getCanonicalSections(type) {
+    return CANONICAL_SECTIONS[type];
+}
+//# sourceMappingURL=template-sections.js.map

package/dist/services/template-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-sections.js","sourceRoot":"","sources":["../../src/services/template-sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,kBAAkB,GAAqD;IAC3E,IAAI,EAAE;QACJ,gBAAgB;QAChB,cAAc;QACd,mBAAmB;QACnB,mBAAmB;QACnB,kBAAkB;QAClB,cAAc;QACd,cAAc;QACd,OAAO;QACP,UAAU;KACX;IACD,OAAO,EAAE;QACP,UAAU;QACV,yBAAyB;QACzB,cAAc;QACd,cAAc;QACd,0BAA0B;QAC1B,OAAO;QACP,iBAAiB;KAClB;IACD,KAAK,EAAE,CAAC,YAAY,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,OAAO,CAAC;IACzE,IAAI,EAAE,CAAC,kBAAkB,EAAE,OAAO,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,OAAO,CAAC;IAC7F,uEAAuE;IACvE,0EAA0E;CAC3E,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACrD,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../src/services/template-service.ts"],"names":[],"mappings":"AAyBA,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,sCAAsC;AACrE,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB"}
+{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../src/services/template-service.ts"],"names":[],"mappings":"AA2BA,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,sCAAsC;AACrE,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/services/template-service.js

@@ -13,6 +13,7 @@ Handlebars.registerHelper('checkboxList', (items) => {
 });
 Handlebars.registerHelper('join', (arr, sep) => Array.isArray(arr) ? arr.join(typeof sep === 'string' ? sep : ', ') : '');
 Handlebars.registerHelper('eq', (a, b) => a === b);
+Handlebars.registerHelper('length', (arr) => (Array.isArray(arr) ? arr.length : 0));
 /** Compile and render a Handlebars template, checking the override directory first. */
 export async function renderTemplate(templatePath, data, // Template data is inherently untyped
 overrideDir) {

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

@@ -1 +1 @@
-{"version":3,"file":"template-service.js","sourceRoot":"","sources":["../../src/services/template-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsC,CAAC;AAEpE,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhF,UAAU,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CACrD,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CACjD,CAAC;AAEF,UAAU,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC,KAAe,EAAE,EAAE;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC,CAAC,CAAC;AAEH,UAAU,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,GAAa,EAAE,GAAY,EAAE,EAAE,CAChE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CACzE,CAAC;AAEF,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAU,EAAE,CAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAErE,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,IAA6B,EAAE,sCAAsC;AACrE,WAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACtE,IAAI,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,YAAoB,EAAE,WAAoB;IAC3E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC1D,IAAI,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"template-service.js","sourceRoot":"","sources":["../../src/services/template-service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,12 @@
+/**
+ * Voice-oriented standup workflow: consume transcript text from file or stdin.
+ * Live microphone capture can be added later without changing the parser.
+ */
+import type { VoiceStandupSession } from '../models/types.js';
+export declare function loadTranscriptFromFile(path: string): Promise<VoiceStandupSession>;
+export declare function transcriptToStandupMarkdown(transcript: string): string;
+/** Read transcript from `--file` or stdin (must not be empty). */
+export declare function readStandupTranscriptSource(opts: {
+    file?: string;
+}): Promise<string>;
+//# sourceMappingURL=voice-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-service.d.ts","sourceRoot":"","sources":["../../src/services/voice-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAWvF;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,kEAAkE;AAClE,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAe1F"}

package/dist/services/voice-service.js

@@ -0,0 +1,42 @@
+/**
+ * Voice-oriented standup workflow: consume transcript text from file or stdin.
+ * Live microphone capture can be added later without changing the parser.
+ */
+import { readFile } from 'node:fs/promises';
+import { formatStandupMarkdown, parseStandupTranscript } from './standup-parser.js';
+export async function loadTranscriptFromFile(path) {
+    try {
+        const transcript = await readFile(path, 'utf-8');
+        return { status: 'done', transcript: transcript.trim() };
+    }
+    catch (err) {
+        return {
+            status: 'error',
+            transcript: '',
+            errorMessage: err.message,
+        };
+    }
+}
+export function transcriptToStandupMarkdown(transcript) {
+    const parsed = parseStandupTranscript(transcript);
+    return formatStandupMarkdown(parsed);
+}
+/** Read transcript from `--file` or stdin (must not be empty). */
+export async function readStandupTranscriptSource(opts) {
+    if (opts.file) {
+        const session = await loadTranscriptFromFile(opts.file);
+        if (session.status === 'error') {
+            throw new Error(session.errorMessage || 'Failed to read transcript file');
+        }
+        return session.transcript;
+    }
+    const chunks = [];
+    for await (const c of process.stdin)
+        chunks.push(c);
+    const text = Buffer.concat(chunks).toString('utf-8').trim();
+    if (!text) {
+        throw new Error('Provide --file <path> or pipe transcript text on stdin.');
+    }
+    return text;
+}
+//# sourceMappingURL=voice-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-service.js","sourceRoot":"","sources":["../../src/services/voice-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEpF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY;IACvD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,EAAE;YACd,YAAY,EAAG,GAAa,CAAC,OAAO;SACrC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAAkB;IAC5D,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAuB;IACvE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,gCAAgC,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}