openplanr 1.2.8 → 1.3.0

package/dist/services/linear/strategy-context.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Epic-mapping strategy resolution + descendant-propagation context.
+ *
+ * `StrategyContext` is the read-only bundle that a single-scope push
+ * (feature / story / tasklist / QT / BL) needs to attach descendant issues
+ * into Linear correctly: `projectId` is always set, `milestoneId` / `labelId`
+ * are populated per the epic's strategy. The epic-scope push also builds a
+ * context on first push (interactive mapping prompt or `--as` flag) — that
+ * builder lives inside `pushEpicScope` because it performs Linear mutations.
+ */
+import type { LinearClient } from '@linear/sdk';
+import type { Epic, LinearMappingStrategy, OpenPlanrConfig } from '../../models/types.js';
+/**
+ * Type → Linear label name for auto-applied GitHub-style filters. Users
+ * can override names via `linear.typeLabels` in `.planr/config.json`.
+ */
+export type LinearLabeledArtifactType = 'feature' | 'story' | 'task' | 'quick' | 'backlog';
+export declare function resolveTypeLabelName(config: OpenPlanrConfig, type: LinearLabeledArtifactType): string;
+export interface StrategyContext {
+    strategy: LinearMappingStrategy;
+    /** Always set — the Linear project that contains the epic's descendants. */
+    projectId: string;
+    /** Set when strategy === 'milestone-of' — written to every descendant issue. */
+    milestoneId?: string;
+    /** Set when strategy === 'label-on' — merged into every descendant issue's labelIds. */
+    labelId?: string;
+}
+/**
+ * Validate a stored `linearMappingStrategy` frontmatter value at the type
+ * boundary. Returns `undefined` for anything that isn't one of the three
+ * known strategies — the caller falls back to `'project'` in that case.
+ */
+export declare function toOptionalStrategy(v: unknown): LinearMappingStrategy | undefined;
+/** Resolve the epic-mapping strategy for an already-pushed epic (read-only). */
+export declare function strategyFromEpic(epic: Epic, config: OpenPlanrConfig): LinearMappingStrategy;
+/**
+ * Build the descendant-propagation context for a feature/story/tasklist push
+ * **without** invoking any Linear mutation. Used by granular push scopes
+ * (FEAT/US/TASK/QT/BL) where the epic is already mapped — the strategy is
+ * whatever the epic's frontmatter says it is, and the containing projectId
+ * + milestoneId + labelId are read-only from that frontmatter.
+ */
+export declare function contextFromMappedEpic(epic: Epic, config: OpenPlanrConfig): StrategyContext;
+/**
+ * Read an issue's existing labelIds from Linear so we can merge (not stomp)
+ * when the push re-applies the epic's label. Only called in the `label-on`
+ * branch, so the extra round-trip is isolated to that strategy.
+ */
+export declare function readExistingLabelIds(client: LinearClient, issueId: string): Promise<string[]>;
+/** Dedupe helper — merges `extra` into `base`, preserving order. */
+export declare function mergeLabelIds(base: string[], extra: string | undefined): string[];
+/**
+ * Idempotent team label for a given OpenPlanr artifact type. Ensures the
+ * label exists in Linear (creates or reuses by name), caches the result
+ * per-push so cascades don't call the API once per item. Used by every
+ * push worker to tag issues with a GitHub-style `feature` / `story` /
+ * `task` / `quick-task` / `backlog` label.
+ */
+export declare function ensureTypeLabel(client: LinearClient, teamId: string, config: OpenPlanrConfig, type: LinearLabeledArtifactType): Promise<string>;
+/**
+ * In-process cache keyed by artifact type. Avoids round-tripping
+ * `ensureIssueLabel` once per item in a cascade (`pushEpicScope` with many
+ * features / stories / tasks / QTs / BLs hits Linear once per type).
+ */
+export declare function createTypeLabelCache(client: LinearClient, teamId: string, config: OpenPlanrConfig): (type: LinearLabeledArtifactType) => Promise<string>;
+//# sourceMappingURL=strategy-context.d.ts.map

package/dist/services/linear/strategy-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-context.d.ts","sourceRoot":"","sources":["../../../src/services/linear/strategy-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI1F;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AA0B3F,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,yBAAyB,GAC9B,MAAM,CAER;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAGhF;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,GAAG,eAAe,CAS1F;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB;AAED,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAIjF;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,MAAM,CAAC,CASjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,eAAe,GACtB,CAAC,IAAI,EAAE,yBAAyB,KAAK,OAAO,CAAC,MAAM,CAAC,CAStD"}

package/dist/services/linear/strategy-context.js

@@ -0,0 +1,121 @@
+/**
+ * Epic-mapping strategy resolution + descendant-propagation context.
+ *
+ * `StrategyContext` is the read-only bundle that a single-scope push
+ * (feature / story / tasklist / QT / BL) needs to attach descendant issues
+ * into Linear correctly: `projectId` is always set, `milestoneId` / `labelId`
+ * are populated per the epic's strategy. The epic-scope push also builds a
+ * context on first push (interactive mapping prompt or `--as` flag) — that
+ * builder lives inside `pushEpicScope` because it performs Linear mutations.
+ */
+import { ensureIssueLabel } from '../linear-service.js';
+import { withLinearRetry } from './errors.js';
+const DEFAULT_TYPE_LABEL_NAMES = {
+    feature: 'feature',
+    story: 'story',
+    task: 'task',
+    quick: 'quick-task',
+    backlog: 'backlog',
+};
+const TYPE_LABEL_COLORS = {
+    feature: '#5E6AD2', // Linear's indigo
+    story: '#4CB782', // green
+    task: '#F2994A', // orange
+    quick: '#BB87FC', // purple
+    backlog: '#888888', // grey (unchanged — matches pre-refactor default)
+};
+const TYPE_LABEL_DESCRIPTIONS = {
+    feature: 'OpenPlanr features (auto-applied by `planr linear push FEAT-*`).',
+    story: 'OpenPlanr user stories (auto-applied by `planr linear push US-*`).',
+    task: 'OpenPlanr task lists (auto-applied by `planr linear push TASK-*`).',
+    quick: 'OpenPlanr quick tasks (auto-applied by `planr linear push QT-*`).',
+    backlog: 'OpenPlanr backlog items (auto-applied by `planr linear push BL-*`).',
+};
+export function resolveTypeLabelName(config, type) {
+    return config.linear?.typeLabels?.[type] ?? DEFAULT_TYPE_LABEL_NAMES[type];
+}
+/**
+ * Validate a stored `linearMappingStrategy` frontmatter value at the type
+ * boundary. Returns `undefined` for anything that isn't one of the three
+ * known strategies — the caller falls back to `'project'` in that case.
+ */
+export function toOptionalStrategy(v) {
+    if (v === 'project' || v === 'milestone-of' || v === 'label-on')
+        return v;
+    return undefined;
+}
+/** Resolve the epic-mapping strategy for an already-pushed epic (read-only). */
+export function strategyFromEpic(epic, config) {
+    return epic.linearMappingStrategy ?? config.linear?.defaultEpicStrategy ?? 'project';
+}
+/**
+ * Build the descendant-propagation context for a feature/story/tasklist push
+ * **without** invoking any Linear mutation. Used by granular push scopes
+ * (FEAT/US/TASK/QT/BL) where the epic is already mapped — the strategy is
+ * whatever the epic's frontmatter says it is, and the containing projectId
+ * + milestoneId + labelId are read-only from that frontmatter.
+ */
+export function contextFromMappedEpic(epic, config) {
+    const strategy = strategyFromEpic(epic, config);
+    const projectId = epic.linearProjectId ?? '';
+    return {
+        strategy,
+        projectId,
+        milestoneId: strategy === 'milestone-of' ? epic.linearMilestoneId : undefined,
+        labelId: strategy === 'label-on' ? epic.linearLabelId : undefined,
+    };
+}
+/**
+ * Read an issue's existing labelIds from Linear so we can merge (not stomp)
+ * when the push re-applies the epic's label. Only called in the `label-on`
+ * branch, so the extra round-trip is isolated to that strategy.
+ */
+export async function readExistingLabelIds(client, issueId) {
+    return withLinearRetry('read label ids', async () => {
+        const issue = await client.issue(issueId);
+        const ids = issue?.labelIds;
+        return Array.isArray(ids) ? ids : [];
+    });
+}
+/** Dedupe helper — merges `extra` into `base`, preserving order. */
+export function mergeLabelIds(base, extra) {
+    if (!extra)
+        return [...base];
+    if (base.includes(extra))
+        return [...base];
+    return [...base, extra];
+}
+/**
+ * Idempotent team label for a given OpenPlanr artifact type. Ensures the
+ * label exists in Linear (creates or reuses by name), caches the result
+ * per-push so cascades don't call the API once per item. Used by every
+ * push worker to tag issues with a GitHub-style `feature` / `story` /
+ * `task` / `quick-task` / `backlog` label.
+ */
+export async function ensureTypeLabel(client, teamId, config, type) {
+    const name = resolveTypeLabelName(config, type);
+    const label = await ensureIssueLabel(client, {
+        teamId,
+        name,
+        color: TYPE_LABEL_COLORS[type],
+        description: TYPE_LABEL_DESCRIPTIONS[type],
+    });
+    return label.id;
+}
+/**
+ * In-process cache keyed by artifact type. Avoids round-tripping
+ * `ensureIssueLabel` once per item in a cascade (`pushEpicScope` with many
+ * features / stories / tasks / QTs / BLs hits Linear once per type).
+ */
+export function createTypeLabelCache(client, teamId, config) {
+    const cache = new Map();
+    return (type) => {
+        const hit = cache.get(type);
+        if (hit)
+            return hit;
+        const promise = ensureTypeLabel(client, teamId, config, type);
+        cache.set(type, promise);
+        return promise;
+    };
+}
+//# sourceMappingURL=strategy-context.js.map

package/dist/services/linear/strategy-context.js.map

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

package/dist/services/linear-mapping-service.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Local-only Linear ↔ OpenPlanr mapping table for `planr linear status`.
+ */
+import type { LinearMappingTableRow, OpenPlanrConfig } from '../models/types.js';
+/**
+ * Collect mapping rows from local frontmatter only (no Linear API).
+ * With `scopeEpicId`, only that epic and descendants (features, stories, tasks in cascade + tasks with `featureId` in scope).
+ */
+export declare function collectLinearMappingTable(projectDir: string, config: OpenPlanrConfig, scopeEpicId?: string): Promise<LinearMappingTableRow[]>;
+export declare function formatLinearMappingTable(rows: LinearMappingTableRow[]): string;
+//# sourceMappingURL=linear-mapping-service.d.ts.map

package/dist/services/linear-mapping-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-mapping-service.d.ts","sourceRoot":"","sources":["../../src/services/linear-mapping-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA4GjF;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAqHlC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAwB9E"}

package/dist/services/linear-mapping-service.js

@@ -0,0 +1,220 @@
+/**
+ * Local-only Linear ↔ OpenPlanr mapping table for `planr linear status`.
+ */
+import { listArtifacts, readArtifact } from './artifact-service.js';
+import { buildCascadeOrder } from './cascade-service.js';
+import { isLikelyLinearIssueId } from './linear-service.js';
+/**
+ * Flag frontmatter values that don't parse as a plausible Linear issue id —
+ * typos like `ENG42` (no hyphen), truncations, or values copied from other
+ * tools. Linear issue ids accept two legitimate shapes: UUID v4 (canonical
+ * API form) and `ENG-42` identifier form; both return `undefined` here.
+ * Anything else gets flagged so the status table highlights it clearly.
+ *
+ * Note: earlier versions also flagged UUID-shaped values as "looks like a
+ * workflow state id" — removed in Gap D because every pushed Linear issue id
+ * is a UUID, so that check fired on healthy data.
+ */
+function staleNoteForIssueId(raw) {
+    if (!raw?.trim()) {
+        return undefined;
+    }
+    if (!isLikelyLinearIssueId(raw)) {
+        return 'stale-id (value does not look like a Linear issue id; re-run `planr linear push`)';
+    }
+    return undefined;
+}
+function cell(s, max = 48) {
+    const t = s.trim() || '—';
+    return t.length <= max ? t : `${t.slice(0, max - 1)}…`;
+}
+function toStr(v) {
+    if (typeof v !== 'string')
+        return undefined;
+    const t = v.trim();
+    return t.length > 0 ? t : undefined;
+}
+function rowForEpic(openPlanrId, d) {
+    const pid = toStr(d.linearProjectId);
+    if (!pid) {
+        return {
+            kind: 'epic',
+            openPlanrId,
+            linearIdentifier: '(not pushed)',
+            linearUrl: '—',
+            lastKnownState: '—',
+        };
+    }
+    const strategy = toStr(d.linearMappingStrategy) ?? 'project';
+    const url = toStr(d.linearProjectUrl) ?? '—';
+    let identifier;
+    if (strategy === 'milestone-of') {
+        const mid = toStr(d.linearMilestoneId);
+        identifier = mid ? `milestone:${mid.slice(0, 8)}` : 'milestone:(pending)';
+    }
+    else if (strategy === 'label-on') {
+        const lid = toStr(d.linearLabelId);
+        identifier = lid ? `label:${lid.slice(0, 8)}` : 'label:(pending)';
+    }
+    else {
+        identifier = toStr(d.linearProjectIdentifier) ?? `project:${pid.slice(0, 8)}`;
+    }
+    return {
+        kind: 'epic',
+        openPlanrId,
+        linearIdentifier: identifier,
+        linearUrl: url,
+        lastKnownState: '—',
+    };
+}
+/**
+ * Generic row builder for issue-shaped artifacts (feature / story / task /
+ * quick / backlog). All five have the same frontmatter fields
+ * (`linearIssueId`, `linearIssueIdentifier`, `linearIssueUrl`) so a single
+ * implementation handles them — only the `kind` label differs.
+ */
+function rowForIssueArtifact(kind, openPlanrId, d) {
+    const issueId = toStr(d.linearIssueId);
+    const stale = staleNoteForIssueId(issueId);
+    const usable = Boolean(issueId && !stale);
+    return {
+        kind,
+        openPlanrId,
+        linearIdentifier: usable
+            ? (toStr(d.linearIssueIdentifier) ?? issueId.slice(0, 8))
+            : issueId
+                ? issueId.slice(0, 8)
+                : '(not pushed)',
+        linearUrl: usable ? (toStr(d.linearIssueUrl) ?? '—') : '—',
+        lastKnownState: String(d.status ?? '—'),
+        note: stale,
+    };
+}
+async function pushTaskRow(projectDir, config, rows, taskId) {
+    const a = await readArtifact(projectDir, config, 'task', taskId);
+    if (!a)
+        return;
+    rows.push(rowForIssueArtifact('task', taskId, a.data));
+}
+/**
+ * Collect mapping rows from local frontmatter only (no Linear API).
+ * With `scopeEpicId`, only that epic and descendants (features, stories, tasks in cascade + tasks with `featureId` in scope).
+ */
+export async function collectLinearMappingTable(projectDir, config, scopeEpicId) {
+    const rows = [];
+    if (scopeEpicId) {
+        const plan = await buildCascadeOrder(projectDir, config, 'epic', scopeEpicId);
+        const featureIdsInScope = new Set(plan.levels[1]?.artifactIds ?? []);
+        const storyIdsInScope = new Set(plan.levels[2]?.artifactIds ?? []);
+        const taskIdsCascade = new Set(plan.levels[3]?.artifactIds ?? []);
+        const ep = await readArtifact(projectDir, config, 'epic', scopeEpicId);
+        if (ep) {
+            rows.push(rowForEpic(scopeEpicId, ep.data));
+        }
+        for (const fid of [...featureIdsInScope].sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))) {
+            const a = await readArtifact(projectDir, config, 'feature', fid);
+            if (a) {
+                rows.push(rowForIssueArtifact('feature', fid, a.data));
+            }
+        }
+        for (const sid of [...storyIdsInScope].sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))) {
+            const a = await readArtifact(projectDir, config, 'story', sid);
+            if (a) {
+                rows.push(rowForIssueArtifact('story', sid, a.data));
+            }
+        }
+        for (const tid of [...taskIdsCascade].sort((a, b) => a.localeCompare(b, undefined, { numeric: true }))) {
+            await pushTaskRow(projectDir, config, rows, tid);
+        }
+        const allTasks = await listArtifacts(projectDir, config, 'task');
+        for (const t of allTasks.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+            if (taskIdsCascade.has(t.id))
+                continue;
+            const ta = await readArtifact(projectDir, config, 'task', t.id);
+            const feat = ta?.data.featureId;
+            if (feat && featureIdsInScope.has(feat)) {
+                await pushTaskRow(projectDir, config, rows, t.id);
+            }
+        }
+        // Linked QT / BL artifacts (`epicId` or `parentEpic` pointing at this epic).
+        const quicks = await listArtifacts(projectDir, config, 'quick');
+        for (const q of quicks.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+            const a = await readArtifact(projectDir, config, 'quick', q.id);
+            if (!a)
+                continue;
+            const linked = toStr(a.data.epicId) ?? toStr(a.data.parentEpic);
+            if (linked === scopeEpicId) {
+                rows.push(rowForIssueArtifact('quick', q.id, a.data));
+            }
+        }
+        const backlogs = await listArtifacts(projectDir, config, 'backlog');
+        for (const b of backlogs.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+            const a = await readArtifact(projectDir, config, 'backlog', b.id);
+            if (!a)
+                continue;
+            const linked = toStr(a.data.epicId) ?? toStr(a.data.parentEpic);
+            if (linked === scopeEpicId) {
+                rows.push(rowForIssueArtifact('backlog', b.id, a.data));
+            }
+        }
+        return rows;
+    }
+    const epics = await listArtifacts(projectDir, config, 'epic');
+    for (const e of epics.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+        const a = await readArtifact(projectDir, config, 'epic', e.id);
+        if (a) {
+            rows.push(rowForEpic(e.id, a.data));
+        }
+    }
+    const features = await listArtifacts(projectDir, config, 'feature');
+    for (const f of features.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+        const a = await readArtifact(projectDir, config, 'feature', f.id);
+        if (a) {
+            rows.push(rowForIssueArtifact('feature', f.id, a.data));
+        }
+    }
+    const stories = await listArtifacts(projectDir, config, 'story');
+    for (const s of stories.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+        const a = await readArtifact(projectDir, config, 'story', s.id);
+        if (a) {
+            rows.push(rowForIssueArtifact('story', s.id, a.data));
+        }
+    }
+    const tasks = await listArtifacts(projectDir, config, 'task');
+    for (const t of tasks.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+        await pushTaskRow(projectDir, config, rows, t.id);
+    }
+    const quicks = await listArtifacts(projectDir, config, 'quick');
+    for (const q of quicks.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+        const a = await readArtifact(projectDir, config, 'quick', q.id);
+        if (a)
+            rows.push(rowForIssueArtifact('quick', q.id, a.data));
+    }
+    const backlogs = await listArtifacts(projectDir, config, 'backlog');
+    for (const b of backlogs.sort((a, b) => a.id.localeCompare(b.id, undefined, { numeric: true }))) {
+        const a = await readArtifact(projectDir, config, 'backlog', b.id);
+        if (a)
+            rows.push(rowForIssueArtifact('backlog', b.id, a.data));
+    }
+    return rows;
+}
+export function formatLinearMappingTable(rows) {
+    const lines = [];
+    const kindW = 7;
+    const idW = 14;
+    const idenW = 22;
+    const stW = 14;
+    const noteW = 40;
+    // URL goes LAST and is printed in full (no truncation). Clickable URLs are
+    // the primary value of this table; truncating them to a fixed width made
+    // them useless for copy-paste. Rows with long URLs now trail off freely
+    // without disturbing earlier columns.
+    lines.push(`${'Kind'.padEnd(kindW)}  ${'OpenPlanr id'.padEnd(idW)}  ${'Linear id'.padEnd(idenW)}  ${'State'.padEnd(stW)}  ${'Note'.padEnd(noteW)}  URL`);
+    lines.push(`${'─'.repeat(kindW)}  ${'─'.repeat(idW)}  ${'─'.repeat(idenW)}  ${'─'.repeat(stW)}  ${'─'.repeat(noteW)}  ───`);
+    for (const r of rows) {
+        const note = r.note ? cell(r.note, noteW) : '';
+        lines.push(`${r.kind.padEnd(kindW)}  ${r.openPlanrId.padEnd(idW)}  ${cell(r.linearIdentifier, idenW).padEnd(idenW)}  ${cell(r.lastKnownState, stW).padEnd(stW)}  ${note.padEnd(noteW)}  ${r.linearUrl}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=linear-mapping-service.js.map

package/dist/services/linear-mapping-service.js.map

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

package/dist/services/linear-pull-service.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Linear → OpenPlanr pull-direction sync.
+ *
+ * Two concerns consolidated here because both are strictly pull and share
+ * the same client lifecycle and auth surface:
+ *
+ *   1. **Workflow-status sync**: for Features and Stories with a stored
+ *      `linearIssueId`, fetch the current Linear workflow state name and
+ *      write OpenPlanr `status` frontmatter when mapped.
+ *
+ *   2. **Task checkbox sync**: bidirectional 3-way merge between local
+ *      TASK markdown and Linear TaskList issue description bodies.
+ *      Pull-side lives here; push-side lives in `linear-push-service.ts`.
+ *
+ * Keeping them in one module reduces call-site noise for
+ * `planr linear sync` and gives the next reader one file to understand
+ * everything that pulls state from Linear.
+ */
+import type { LinearClient } from '@linear/sdk';
+import type { ParsedSubtask } from '../agents/task-parser.js';
+import type { BacklogStatus, OpenPlanrConfig, TaskStatus } from '../models/types.js';
+export declare function buildNameToStatusMap(user: Record<string, string> | undefined): Map<string, TaskStatus>;
+export declare function mapLinearNameToTaskStatus(stateName: string, byName: Map<string, TaskStatus>): TaskStatus | undefined;
+export declare function buildNameToBacklogStatusMap(user: Record<string, string> | undefined): Map<string, BacklogStatus>;
+export declare function mapLinearNameToBacklogStatus(stateName: string, byName: Map<string, BacklogStatus>): BacklogStatus | undefined;
+export interface LinearStatusSyncSummary {
+    /** Local artifacts overwritten with Linear's state (the pull direction). */
+    updated: number;
+    /** Linear issues updated from local state (the push-on-sync direction). */
+    pushedToLinear: number;
+    /** Local and Linear already agree — no write either direction. */
+    unchanged: number;
+    /** Per-artifact conflicts resolved via `--on-conflict` (includes non-interactive defaults). */
+    conflictDecisions: number;
+    /** Linear returned a state name we don't know how to map. */
+    unmapped: number;
+    /** Artifact had no `linearIssueId` or an unparseable one. */
+    skippedNoId: number;
+    /** Linear didn't return the issue (deleted / no access). */
+    missingFromApi: number;
+    /** Push-back to Linear failed (API error); local frontmatter left unchanged. */
+    pushFailures: number;
+}
+/**
+ * Shared three-way merge strategy — governs how both checkbox sync and
+ * status sync resolve conflicts. Reused from the existing checkbox merge
+ * so users get one flag (`--on-conflict`) for both.
+ */
+export type ConflictStrategy = 'prompt' | 'local' | 'linear';
+/**
+ * One side of a three-way status decision. Analogous to the `CheckboxConflict`
+ * record used by the task-checkbox merge, but scalar (single `status` value
+ * per artifact, not per-checkbox).
+ */
+export interface StatusConflict {
+    base: string | undefined;
+    local: string;
+    remote: string;
+}
+/**
+ * Pure three-way merge decision for a single artifact's workflow status.
+ *
+ * Mirrors `resolveTaskCheckboxFinalStates` but on a scalar. Returns
+ * `side='unchanged'` when local and remote already agree (counter path),
+ * `side='linear'` when the remote changed and should be pulled, `side='local'`
+ * when the local changed and should be pushed back to Linear. True
+ * conflicts (both diverged from base, or no base and they disagree) are
+ * resolved per `strategy`.
+ */
+export declare function resolveStatusFinalState(c: StatusConflict, strategy: ConflictStrategy): {
+    final: string;
+    side: 'unchanged' | 'local' | 'linear';
+    conflictDecisions: number;
+    isTrueConflict: boolean;
+};
+export declare function syncLinearStatusIntoArtifacts(projectDir: string, config: OpenPlanrConfig, client: LinearClient, options?: {
+    dryRun?: boolean;
+    onConflict?: ConflictStrategy;
+}): Promise<LinearStatusSyncSummary>;
+export declare function formatLinearStatusSyncLine(s: LinearStatusSyncSummary): string;
+export type TaskCheckboxConflictStrategy = 'prompt' | 'local' | 'linear';
+export interface LinearTaskCheckboxSyncSummary {
+    filesProcessed: number;
+    filesUpdatedLocal: number;
+    linearIssuesUpdated: number;
+    /** Number of per-id decisions for divergent local vs Linear (includes non-interactive defaults). */
+    conflictDecisions: number;
+    skippedNoIssue: number;
+    /** Artifacts whose `linearIssueId` frontmatter was present but malformed (H1). */
+    skippedStaleId: number;
+}
+/**
+ * Rebuild a `ParsedSubtask` list in document order: local file order, then any ids only in remote, then apply `final` done flags.
+ */
+export declare function mergeByIdForFormat(local: ParsedSubtask[], remote: ParsedSubtask[], final: ReadonlyMap<string, boolean>): ParsedSubtask[];
+/** Merged issue body: return text for an artifact’s section, or the whole body when a single file owns the issue. */
+export declare function extractTaskSectionFromMergedDescription(merged: string, taskFileId: string, siblingFileCount: number): string;
+export declare function replaceTaskSectionInMergedDescription(merged: string, taskFileId: string, newSectionBody: string): string;
+export interface CheckboxConflict {
+    id: string;
+    base: boolean | undefined;
+    local: boolean | undefined;
+    remote: boolean | undefined;
+}
+/**
+ * One auto-resolved conflict entry (M4). Captured when a non-interactive
+ * default picks the Linear or local side so the user can review decisions
+ * after the fact in `.planr/reports/linear-sync-conflicts-<date>.md`.
+ */
+export interface AutoResolvedConflict {
+    label: string;
+    id: string;
+    base: boolean | undefined;
+    local: boolean | undefined;
+    remote: boolean | undefined;
+    chosen: 'local' | 'linear';
+    timestamp: string;
+}
+/**
+ * Three-way merge for checkbox `id -> done` and presence. A key is **absent** in a version when the task line is not in that side’s parse.
+ * Exported for unit tests.
+ */
+export declare function resolveTaskCheckboxFinalStates(local: Map<string, boolean>, remote: Map<string, boolean>, base: Map<string, boolean>, strategy: TaskCheckboxConflictStrategy, label: string, onAutoResolve?: (entry: AutoResolvedConflict) => void): Promise<{
+    final: Map<string, boolean>;
+    conflictDecisions: number;
+}>;
+/** Drop checkbox lines for ids that should be absent, apply done states, append new lines for ids in `rebuilt` that are still missing. */
+export declare function applyCheckboxMergeToLocalBody(body: string, final: ReadonlyMap<string, boolean>, rebuilt: ParsedSubtask[]): string;
+/**
+ * For each `task` artifact with `linearIssueId`, load the shared Linear description (once per issue id),
+ * reconcile checkboxes with the local file using three-way merge, then write back local and/or Linear.
+ */
+export declare function runLinearTaskCheckboxSync(projectDir: string, config: OpenPlanrConfig, client: LinearClient, opts?: {
+    onConflict?: TaskCheckboxConflictStrategy;
+    dryRun?: boolean;
+}): Promise<LinearTaskCheckboxSyncSummary>;
+//# sourceMappingURL=linear-pull-service.d.ts.map

package/dist/services/linear-pull-service.d.ts.map

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