@planu/cli 0.96.4 → 0.97.0

package/dist/engine/generate-tests/generators/property-based-generator.js

@@ -0,0 +1,159 @@
+// engine/generate-tests/generators/property-based-generator.ts — SPEC-315
+// High-level generator: produces a full test file string from spec + context.
+import { extractPropertyTests, detectPropertyFramework } from '../../property-test-generator.js';
+// ---------------------------------------------------------------------------
+// File header builders per framework
+// ---------------------------------------------------------------------------
+function buildFastCheckHeader(specTitle) {
+    return `// Property-based tests for: ${specTitle}
+// Generated by Planu SDD — strategy:property-based (SPEC-315)
+// Framework: fast-check
+
+import * as fc from 'fast-check';
+import { describe, it } from 'vitest';
+
+describe('${specTitle} — property-based tests', () => {`;
+}
+function buildHypothesisHeader(specTitle) {
+    return `# Property-based tests for: ${specTitle}
+# Generated by Planu SDD — strategy:property-based (SPEC-315)
+# Framework: hypothesis
+
+from hypothesis import given, settings, HealthCheck
+from hypothesis import strategies as st
+
+
+class Test${specTitle.replace(/[^a-zA-Z0-9]/g, '')}Properties:
+    """Property-based tests for ${specTitle}."""
+`;
+}
+function buildJqwikHeader(specTitle) {
+    const className = specTitle.replace(/[^a-zA-Z0-9]/g, '');
+    return `// Property-based tests for: ${specTitle}
+// Generated by Planu SDD — strategy:property-based (SPEC-315)
+// Framework: jqwik
+
+import net.jqwik.api.*;
+import static org.assertj.core.api.Assertions.assertThat;
+
+class ${className}PropertyTest {`;
+}
+function buildGenericHeader(specTitle) {
+    return `# Property-based tests for: ${specTitle}
+# Generated by Planu SDD — strategy:property-based (SPEC-315)
+# Framework: generic (adapt to your property testing library)
+#
+# Each property below describes an invariant that must hold for ALL valid inputs.
+# Implement using your project's property testing framework.
+`;
+}
+// ---------------------------------------------------------------------------
+// Test block builders per framework
+// ---------------------------------------------------------------------------
+function buildFastCheckBlock(test, index) {
+    return `
+  it('property ${index + 1}: ${test.invariant}', () => {
+    // Input domain: ${test.inputDomain}
+    // Shrink: ${test.shrinkStrategy}
+    ${test.generatorCode}
+  });`;
+}
+function buildHypothesisBlock(test, _index) {
+    return `
+    ${test.generatorCode}
+`;
+}
+function buildJqwikBlock(test, _index) {
+    return `
+    // Input domain: ${test.inputDomain}
+    // Shrink: ${test.shrinkStrategy}
+    ${test.generatorCode}
+`;
+}
+function buildGenericBlock(test, index) {
+    return `
+# Property ${index + 1}
+${test.generatorCode}
+`;
+}
+// ---------------------------------------------------------------------------
+// File footer builders
+// ---------------------------------------------------------------------------
+function buildFastCheckFooter() {
+    return '\n});\n';
+}
+function buildJqwikFooter() {
+    return '\n}\n';
+}
+function buildNoFooter() {
+    return '\n';
+}
+// ---------------------------------------------------------------------------
+// No-properties fallback
+// ---------------------------------------------------------------------------
+function buildFallbackContent(specTitle, language) {
+    if (language === 'python') {
+        return `# Property-based tests for: ${specTitle}
+# Generated by Planu SDD — strategy:property-based (SPEC-315)
+# No invariants detected in acceptance criteria.
+# Add criteria with keywords: "must be positive", "idempotent", "for any input", etc.
+`;
+    }
+    return `// Property-based tests for: ${specTitle}
+// Generated by Planu SDD — strategy:property-based (SPEC-315)
+// No invariants detected in acceptance criteria.
+// Add criteria with keywords: "must be positive", "idempotent", "for any input", etc.
+`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generate a complete property-based test file as a string.
+ * Adapts output to fast-check (JS/TS), hypothesis (Python), jqwik (Java/Kotlin),
+ * or pseudo-code generic format based on detected framework.
+ *
+ * @param spec - The spec metadata (title, id used for file naming/headers).
+ * @param context - Project knowledge (language, stack) for framework detection.
+ * @param criteria - Acceptance criteria strings extracted from spec.md by the caller.
+ */
+export function generatePropertyBasedTests(spec, context, criteria = []) {
+    const framework = detectPropertyFramework(context.language, context.stack);
+    const tests = extractPropertyTests({
+        criteria,
+        language: context.language,
+        stack: context.stack,
+    });
+    if (tests.length === 0) {
+        return buildFallbackContent(spec.title, context.language);
+    }
+    // Build header
+    let header;
+    let blockBuilder;
+    let footer;
+    switch (framework) {
+        case 'fast-check':
+            header = buildFastCheckHeader(spec.title);
+            blockBuilder = buildFastCheckBlock;
+            footer = buildFastCheckFooter();
+            break;
+        case 'hypothesis':
+            header = buildHypothesisHeader(spec.title);
+            blockBuilder = buildHypothesisBlock;
+            footer = buildNoFooter();
+            break;
+        case 'jqwik':
+            header = buildJqwikHeader(spec.title);
+            blockBuilder = buildJqwikBlock;
+            footer = buildJqwikFooter();
+            break;
+        case 'generic':
+            header = buildGenericHeader(spec.title);
+            blockBuilder = buildGenericBlock;
+            footer = buildNoFooter();
+            break;
+    }
+    const blocks = tests.map((test, i) => blockBuilder(test, i)).join('');
+    return `${header}${blocks}${footer}`;
+}
+//# sourceMappingURL=property-based-generator.js.map

package/dist/engine/generate-tests/generators/property-based-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-based-generator.js","sourceRoot":"","sources":["../../../../src/engine/generate-tests/generators/property-based-generator.ts"],"names":[],"mappings":"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"}

package/dist/engine/jira-exporter.d.ts

@@ -0,0 +1,39 @@
+import type { JiraConfig, JiraIssueRef, JiraApiIssue, Spec } from '../types/index.js';
+/**
+ * Map a Planu spec status to a Jira status name.
+ */
+export declare function mapSpecStatusToJira(specStatus: string): string;
+export declare class JiraClient {
+    private readonly config;
+    private readonly authHeader;
+    private readonly baseUrl;
+    constructor(config: JiraConfig);
+    /**
+     * Create an Epic in Jira from a spec.
+     * Returns a JiraIssueRef with the new issue details.
+     */
+    createEpic(spec: Spec): Promise<JiraIssueRef>;
+    /**
+     * Create a Story in Jira linked to a parent Epic.
+     * Returns a JiraIssueRef for the created story.
+     */
+    createStory(specId: string, criterionText: string, epicKey: string): Promise<JiraIssueRef>;
+    /**
+     * Fetch a Jira issue by key.
+     * Returns the issue or null if not found.
+     */
+    getIssue(key: string): Promise<JiraApiIssue | null>;
+    /**
+     * Transition a Jira issue to a target status name.
+     * Looks up available transitions and applies the matching one.
+     */
+    updateIssueStatus(issueKey: string, targetStatus: string): Promise<void>;
+    private getTransitions;
+    private postJson;
+}
+/**
+ * Build a minimal Atlassian Document Format (ADF) document.
+ * Used for Jira issue descriptions in the REST API v3.
+ */
+export declare function buildAtlassianDoc(heading: string, bodyText: string): Record<string, unknown>;
+//# sourceMappingURL=jira-exporter.d.ts.map

package/dist/engine/jira-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-exporter.d.ts","sourceRoot":"","sources":["../../src/engine/jira-exporter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EAEZ,IAAI,EACL,MAAM,mBAAmB,CAAC;AAc3B;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAMD,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEJ,MAAM,EAAE,UAAU;IAM/C;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;IA0BnD;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA2BhG;;;OAGG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAqBzD;;;OAGG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAgChE,cAAc;YAkBd,QAAQ;CAmBvB;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB"}

package/dist/engine/jira-exporter.js

@@ -0,0 +1,190 @@
+// ---------------------------------------------------------------------------
+// Status mapping: Planu spec status → Jira issue status name
+// ---------------------------------------------------------------------------
+const SPEC_STATUS_TO_JIRA = {
+    draft: 'To Do',
+    review: 'In Review',
+    approved: 'Approved',
+    implementing: 'In Progress',
+    done: 'Done',
+};
+/**
+ * Map a Planu spec status to a Jira status name.
+ */
+export function mapSpecStatusToJira(specStatus) {
+    return SPEC_STATUS_TO_JIRA[specStatus] ?? 'To Do';
+}
+// ---------------------------------------------------------------------------
+// Jira REST API client
+// ---------------------------------------------------------------------------
+export class JiraClient {
+    config;
+    authHeader;
+    baseUrl;
+    constructor(config) {
+        this.config = config;
+        const credentials = `${config.email}:${config.apiToken}`;
+        this.authHeader = `Basic ${Buffer.from(credentials).toString('base64')}`;
+        this.baseUrl = `https://${config.domain}.atlassian.net/rest/api/3`;
+    }
+    /**
+     * Create an Epic in Jira from a spec.
+     * Returns a JiraIssueRef with the new issue details.
+     */
+    async createEpic(spec) {
+        const summary = `${spec.id}: ${spec.title}`;
+        const description = buildAtlassianDoc(spec.title, `Planu spec ${spec.id} — status: ${spec.status}`);
+        const payload = {
+            fields: {
+                project: { key: this.config.projectKey },
+                issuetype: { name: 'Epic' },
+                summary,
+                description,
+                labels: ['planu-spec'],
+            },
+        };
+        const data = await this.postJson('/issue', payload);
+        const issueUrl = `https://${this.config.domain}.atlassian.net/browse/${data.key}`;
+        return {
+            specId: spec.id,
+            issueKey: data.key,
+            issueUrl,
+            summary,
+            issueType: 'Epic',
+        };
+    }
+    /**
+     * Create a Story in Jira linked to a parent Epic.
+     * Returns a JiraIssueRef for the created story.
+     */
+    async createStory(specId, criterionText, epicKey) {
+        const summary = criterionText.slice(0, 255);
+        const description = buildAtlassianDoc('Acceptance Criterion', criterionText);
+        const payload = {
+            fields: {
+                project: { key: this.config.projectKey },
+                issuetype: { name: 'Story' },
+                summary,
+                description,
+                labels: ['planu-spec'],
+                'Epic Link': epicKey,
+            },
+        };
+        const data = await this.postJson('/issue', payload);
+        const issueUrl = `https://${this.config.domain}.atlassian.net/browse/${data.key}`;
+        return {
+            specId,
+            issueKey: data.key,
+            issueUrl,
+            summary,
+            issueType: 'Story',
+        };
+    }
+    /**
+     * Fetch a Jira issue by key.
+     * Returns the issue or null if not found.
+     */
+    async getIssue(key) {
+        const url = `${this.baseUrl}/issue/${encodeURIComponent(key)}`;
+        const response = await globalThis.fetch(url, {
+            headers: {
+                Authorization: this.authHeader,
+                'Content-Type': 'application/json',
+            },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            throw new Error(`Jira getIssue failed: ${response.status} ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Transition a Jira issue to a target status name.
+     * Looks up available transitions and applies the matching one.
+     */
+    async updateIssueStatus(issueKey, targetStatus) {
+        const transitions = await this.getTransitions(issueKey);
+        const match = transitions.find((t) => t.name.toLowerCase() === targetStatus.toLowerCase());
+        if (match === undefined) {
+            // Status not available — skip silently (workflow may differ per project)
+            return;
+        }
+        const url = `${this.baseUrl}/issue/${encodeURIComponent(issueKey)}/transitions`;
+        const response = await globalThis.fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: this.authHeader,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ transition: { id: match.id } }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok) {
+            const errText = await response.text();
+            throw new Error(`Jira updateIssueStatus failed: ${response.status} — ${errText}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    async getTransitions(issueKey) {
+        const url = `${this.baseUrl}/issue/${encodeURIComponent(issueKey)}/transitions`;
+        const response = await globalThis.fetch(url, {
+            headers: {
+                Authorization: this.authHeader,
+                'Content-Type': 'application/json',
+            },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok) {
+            return [];
+        }
+        const data = (await response.json());
+        return data.transitions;
+    }
+    async postJson(path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await globalThis.fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: this.authHeader,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!response.ok) {
+            const errText = await response.text();
+            throw new Error(`Jira POST ${path} failed: ${response.status} — ${errText}`);
+        }
+        return (await response.json());
+    }
+}
+// ---------------------------------------------------------------------------
+// Atlassian Document Format (ADF) builder
+// ---------------------------------------------------------------------------
+/**
+ * Build a minimal Atlassian Document Format (ADF) document.
+ * Used for Jira issue descriptions in the REST API v3.
+ */
+export function buildAtlassianDoc(heading, bodyText) {
+    return {
+        version: 1,
+        type: 'doc',
+        content: [
+            {
+                type: 'heading',
+                attrs: { level: 2 },
+                content: [{ type: 'text', text: heading }],
+            },
+            {
+                type: 'paragraph',
+                content: [{ type: 'text', text: bodyText }],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=jira-exporter.js.map

package/dist/engine/jira-exporter.js.map

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

package/dist/engine/linear-exporter.d.ts

@@ -0,0 +1,32 @@
+import type { LinearConfig, LinearIssueRef, Spec } from '../types/index.js';
+/**
+ * Map a Planu spec status to a Linear workflow state name.
+ */
+export declare function mapSpecStatusToLinear(specStatus: string): string;
+export declare class LinearClient {
+    private readonly config;
+    constructor(config: LinearConfig);
+    /**
+     * Create a Linear project (as an issue group / label) from a spec.
+     * Since Linear uses issues as primary entities, each spec becomes an issue.
+     * Returns a LinearIssueRef with the created issue details.
+     */
+    createProject(spec: Spec): Promise<LinearIssueRef>;
+    /**
+     * Create a sub-issue in Linear for a single acceptance criterion.
+     * Returns a LinearIssueRef for the created issue.
+     */
+    createIssue(specId: string, criterionText: string, parentId?: string): Promise<LinearIssueRef>;
+    /**
+     * Update the workflow state (status) of a Linear issue.
+     * Looks up the state ID by name within the team, then applies it.
+     */
+    updateIssueStatus(issueId: string, stateName: string): Promise<void>;
+    private findStateId;
+    private graphql;
+}
+/**
+ * Build a Markdown description for a Linear issue from a spec.
+ */
+export declare function buildLinearDescription(spec: Spec): string;
+//# sourceMappingURL=linear-exporter.d.ts.map

package/dist/engine/linear-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-exporter.d.ts","sourceRoot":"","sources":["../../src/engine/linear-exporter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EAId,IAAI,EACL,MAAM,mBAAmB,CAAC;AAgB3B;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AAMD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAEjD;;;;OAIG;IACG,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IAqCxD;;;OAGG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC;IAsC1B;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B5D,WAAW;YAuBX,OAAO;CA6BtB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASzD"}

package/dist/engine/linear-exporter.js

@@ -0,0 +1,184 @@
+const LINEAR_GRAPHQL_URL = 'https://api.linear.app/graphql';
+// ---------------------------------------------------------------------------
+// Status mapping: Planu spec status → Linear workflow state name
+// ---------------------------------------------------------------------------
+const SPEC_STATUS_TO_LINEAR = {
+    draft: 'Todo',
+    review: 'In Review',
+    approved: 'Todo',
+    implementing: 'In Progress',
+    done: 'Done',
+};
+/**
+ * Map a Planu spec status to a Linear workflow state name.
+ */
+export function mapSpecStatusToLinear(specStatus) {
+    return SPEC_STATUS_TO_LINEAR[specStatus] ?? 'Todo';
+}
+// ---------------------------------------------------------------------------
+// Linear GraphQL client
+// ---------------------------------------------------------------------------
+export class LinearClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Create a Linear project (as an issue group / label) from a spec.
+     * Since Linear uses issues as primary entities, each spec becomes an issue.
+     * Returns a LinearIssueRef with the created issue details.
+     */
+    async createProject(spec) {
+        const title = `${spec.id}: ${spec.title}`;
+        const description = buildLinearDescription(spec);
+        const mutation = `
+      mutation CreateIssue($input: IssueCreateInput!) {
+        issueCreate(input: $input) {
+          success
+          issue {
+            id
+            url
+            title
+          }
+        }
+      }
+    `;
+        const variables = {
+            input: {
+                teamId: this.config.teamId,
+                title,
+                description,
+                labelNames: ['planu-spec'],
+            },
+        };
+        const data = await this.graphql(mutation, variables);
+        const issue = data.issueCreate.issue;
+        return {
+            specId: spec.id,
+            issueId: issue.id,
+            issueUrl: issue.url,
+            title: issue.title,
+        };
+    }
+    /**
+     * Create a sub-issue in Linear for a single acceptance criterion.
+     * Returns a LinearIssueRef for the created issue.
+     */
+    async createIssue(specId, criterionText, parentId) {
+        const title = criterionText.slice(0, 255);
+        const mutation = `
+      mutation CreateIssue($input: IssueCreateInput!) {
+        issueCreate(input: $input) {
+          success
+          issue {
+            id
+            url
+            title
+          }
+        }
+      }
+    `;
+        const input = {
+            teamId: this.config.teamId,
+            title,
+            description: criterionText,
+            labelNames: ['planu-spec'],
+        };
+        if (parentId !== undefined) {
+            input.parentId = parentId;
+        }
+        const data = await this.graphql(mutation, { input });
+        const issue = data.issueCreate.issue;
+        return {
+            specId,
+            issueId: issue.id,
+            issueUrl: issue.url,
+            title: issue.title,
+        };
+    }
+    /**
+     * Update the workflow state (status) of a Linear issue.
+     * Looks up the state ID by name within the team, then applies it.
+     */
+    async updateIssueStatus(issueId, stateName) {
+        const stateId = await this.findStateId(stateName);
+        if (stateId === null) {
+            // State not found — skip silently
+            return;
+        }
+        const mutation = `
+      mutation UpdateIssue($id: String!, $input: IssueUpdateInput!) {
+        issueUpdate(id: $id, input: $input) {
+          success
+        }
+      }
+    `;
+        const data = await this.graphql(mutation, {
+            id: issueId,
+            input: { stateId },
+        });
+        if (!data.issueUpdate.success) {
+            throw new Error(`Linear updateIssueStatus failed for issue ${issueId}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    async findStateId(stateName) {
+        const query = `
+      query WorkflowStates($teamId: String!) {
+        workflowStates(filter: { team: { id: { eq: $teamId } } }) {
+          nodes {
+            id
+            name
+          }
+        }
+      }
+    `;
+        const data = await this.graphql(query, {
+            teamId: this.config.teamId,
+        });
+        const match = data.workflowStates.nodes.find((s) => s.name.toLowerCase() === stateName.toLowerCase());
+        return match?.id ?? null;
+    }
+    async graphql(query, variables) {
+        const response = await globalThis.fetch(LINEAR_GRAPHQL_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.config.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ query, variables }),
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!response.ok) {
+            const errText = await response.text();
+            throw new Error(`Linear GraphQL request failed: ${response.status} — ${errText}`);
+        }
+        const json = (await response.json());
+        if (json.errors !== undefined && json.errors.length > 0) {
+            const messages = json.errors.map((e) => e.message).join('; ');
+            throw new Error(`Linear GraphQL errors: ${messages}`);
+        }
+        if (json.data === undefined) {
+            throw new Error('Linear GraphQL returned no data');
+        }
+        return json.data;
+    }
+}
+// ---------------------------------------------------------------------------
+// Description builder
+// ---------------------------------------------------------------------------
+/**
+ * Build a Markdown description for a Linear issue from a spec.
+ */
+export function buildLinearDescription(spec) {
+    const lines = [
+        `## ${spec.id}: ${spec.title}`,
+        '',
+        `**Status:** ${spec.status}`,
+        `**Source:** Planu spec`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=linear-exporter.js.map

package/dist/engine/linear-exporter.js.map

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

package/dist/engine/planu-config-writer.d.ts

@@ -1,8 +1,19 @@
-import type { PlanuConfig } from '../types/index.js';
+import type { PlanuConfig, WorkMode } from '../types/index.js';
 /**
  * Create a new PlanuConfig with defaults. Always uses modern spec location.
+ * SPEC-313: Accepts optional workMode to embed in the generated config.
  */
-export declare function createPlanuConfig(): PlanuConfig;
+export declare function createPlanuConfig(workMode?: WorkMode): PlanuConfig;
+/**
+ * SPEC-313: Read planu.json, update workMode, and write back.
+ * Accepts injected readFile/writeFile to keep this function pure/testable.
+ */
+export declare function updatePlanuConfigWorkMode(planuConfigPath: string, workMode: WorkMode, readFile: (path: string, enc: 'utf-8') => Promise<string>, writeFile: (path: string, data: string, enc: 'utf-8') => Promise<void>): Promise<void>;
+/**
+ * SPEC-313: Read and parse planu.json to retrieve its config (best-effort).
+ * Returns null if the file is absent or malformed.
+ */
+export declare function readPlanuConfig(planuConfigPath: string, readFile: (path: string, enc: 'utf-8') => Promise<string>): Promise<PlanuConfig | null>;
 /**
  * Serialize PlanuConfig to JSON string.
  */

package/dist/engine/planu-config-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planu-config-writer.d.ts","sourceRoot":"","sources":["../../src/engine/planu-config-writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAU/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAKA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE9D"}
+{"version":3,"file":"planu-config-writer.d.ts","sourceRoot":"","sources":["../../src/engine/planu-config-writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK/D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAWlE;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,EACzD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GACrE,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,GACxD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAO7B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAKA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAE9D"}