@planu/cli 0.96.5 → 0.97.1

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":"AAaA,MAAM,kBAAkB,GAAG,gCAAgC,CAAC;AAE5D,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,MAAM,qBAAqB,GAA2B;IACpD,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,WAAW;IACnB,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,aAAa;IAC3B,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,qBAAqB,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC;AACrD,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAErD;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,IAAU;QAC5B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG;;;;;;;;;;;KAWhB,CAAC;QAEF,MAAM,SAAS,GAAG;YAChB,KAAK,EAAE;gBACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC1B,KAAK;gBACL,WAAW;gBACX,UAAU,EAAE,CAAC,YAAY,CAAC;aAC3B;SACF,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA2B,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAErC,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,QAAQ,EAAE,KAAK,CAAC,GAAG;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,MAAc,EACd,aAAqB,EACrB,QAAiB;QAEjB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG;;;;;;;;;;;KAWhB,CAAC;QAEF,MAAM,KAAK,GAA4B;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,KAAK;YACL,WAAW,EAAE,aAAa;YAC1B,UAAU,EAAE,CAAC,YAAY,CAAC;SAC3B,CAAC;QAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC5B,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA2B,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAErC,OAAO;YACL,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,QAAQ,EAAE,KAAK,CAAC,GAAG;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,SAAiB;QACxD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,kCAAkC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG;;;;;;KAMhB,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA2B,QAAQ,EAAE;YAClE,EAAE,EAAE,OAAO;YACX,KAAK,EAAE,EAAE,OAAO,EAAE;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAEtE,KAAK,CAAC,WAAW,CAAC,SAAiB;QACzC,MAAM,KAAK,GAAG;;;;;;;;;KASb,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAA4B,KAAK,EAAE;YAChE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;SAC3B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CACxD,CAAC;QAEF,OAAO,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,OAAO,CAAI,KAAa,EAAE,SAAkC;QACxE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,kBAAkB,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;gBAC7C,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAC1C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiD,CAAC;QAErF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAC/C,MAAM,KAAK,GAAa;QACtB,MAAM,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE;QAC9B,EAAE;QACF,eAAe,IAAI,CAAC,MAAM,EAAE;QAC5B,wBAAwB;KACzB,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/property-test-generator.d.ts

@@ -0,0 +1,14 @@
+import type { PropertyTest, PropertyTestExtractionResult, PropertyTestFrameworkTarget, PropertyBasedGeneratorInput } from '../types/property-testing.js';
+/** Map a language/stack to the best property-based test framework. */
+export declare function detectPropertyFramework(language: string, stack?: string[]): PropertyTestFrameworkTarget;
+/**
+ * Extract PropertyTest objects from acceptance criteria strings.
+ * Each criterion is analyzed against known invariant patterns.
+ * Criteria with no detected pattern are skipped.
+ */
+export declare function extractPropertyTests(input: PropertyBasedGeneratorInput): PropertyTest[];
+/**
+ * Full extraction with metadata: detected framework and analyzed criteria list.
+ */
+export declare function extractPropertyTestsWithMeta(input: PropertyBasedGeneratorInput): PropertyTestExtractionResult;
+//# sourceMappingURL=property-test-generator.d.ts.map

package/dist/engine/property-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-test-generator.d.ts","sourceRoot":"","sources":["../../src/engine/property-test-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,YAAY,EACZ,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAE5B,MAAM,8BAA8B,CAAC;AAMtC,sEAAsE;AACtE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAM,EAAO,GACnB,2BAA2B,CAyB7B;AA0KD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,2BAA2B,GAAG,YAAY,EAAE,CAuBvF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,2BAA2B,GACjC,4BAA4B,CAS9B"}

package/dist/engine/property-test-generator.js

@@ -0,0 +1,223 @@
+// engine/property-test-generator.ts — SPEC-315
+// Extracts invariants from acceptance criteria and generates PropertyTest objects.
+// ---------------------------------------------------------------------------
+// Framework detection
+// ---------------------------------------------------------------------------
+/** Map a language/stack to the best property-based test framework. */
+export function detectPropertyFramework(language, stack = []) {
+    const lang = language.toLowerCase();
+    const stackLower = stack.map((s) => s.toLowerCase());
+    if (stackLower.includes('fast-check') || stackLower.includes('fastcheck')) {
+        return 'fast-check';
+    }
+    if (stackLower.includes('hypothesis')) {
+        return 'hypothesis';
+    }
+    if (stackLower.includes('jqwik')) {
+        return 'jqwik';
+    }
+    if (lang === 'typescript' || lang === 'javascript') {
+        return 'fast-check';
+    }
+    if (lang === 'python') {
+        return 'hypothesis';
+    }
+    if (lang === 'java' || lang === 'kotlin') {
+        return 'jqwik';
+    }
+    return 'generic';
+}
+// ---------------------------------------------------------------------------
+// Invariant pattern matchers
+// ---------------------------------------------------------------------------
+const INVARIANT_PATTERNS = [
+    {
+        // "price must be positive" / "amount should be positive" / "value must be >= 0"
+        pattern: /(?:price|amount|value|cost|total|balance)\s+(?:must|should)\s+be\s+(?:positive|>?\s*0|greater than 0)/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — output is always > 0`,
+            inputDomain: 'positive floats (min: 0.01)',
+        }),
+    },
+    {
+        // "must never be negative" / "should never be negative"
+        pattern: /(?:must|should)\s+never\s+be\s+negative/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — result is never negative`,
+            inputDomain: 'non-negative floats (min: 0)',
+        }),
+    },
+    {
+        // "idempotent" / "idempotente"
+        pattern: /idempoten(?:t|te)/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — applying N times equals applying once`,
+            inputDomain: 'arbitrary valid inputs',
+        }),
+    },
+    {
+        // "commutative" / "conmutativo"
+        pattern: /commutativ(?:e|ity)|conmutativ(?:o|idad)/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — f(a,b) === f(b,a)`,
+            inputDomain: 'pairs of arbitrary values',
+        }),
+    },
+    {
+        // "always returns / always produces"
+        pattern: /always\s+(?:returns?|produces?|yields?)\s+(.+)/i,
+        extract: (m, raw) => ({
+            invariant: `${raw.trim()} — output is always ${m[1] ?? 'defined'}`,
+            inputDomain: 'arbitrary valid inputs',
+        }),
+    },
+    {
+        // "must not be empty" / "should not be empty"
+        pattern: /(?:must|should)\s+not\s+be\s+empty/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — result is never empty`,
+            inputDomain: 'non-empty strings or arrays',
+        }),
+    },
+    {
+        // "for any input" / "for all inputs" / "para cualquier" / "para todos"
+        pattern: /(?:for\s+(?:any|all)\s+(?:valid\s+)?input|para\s+(?:cualquier|todos))/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — holds for all valid inputs`,
+            inputDomain: 'arbitrary valid inputs',
+        }),
+    },
+    {
+        // "length must be between X and Y"
+        pattern: /length\s+must\s+be\s+(?:between\s+)?(\d+)\s+and\s+(\d+)/i,
+        extract: (m, raw) => ({
+            invariant: `${raw.trim()} — length is within [${m[1] ?? '0'}, ${m[2] ?? '∞'}]`,
+            inputDomain: `strings of length ${m[1] ?? '0'}..${m[2] ?? '100'}`,
+        }),
+    },
+    {
+        // "must be unique" / "should be unique"
+        pattern: /(?:must|should)\s+be\s+unique/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — no duplicates in output`,
+            inputDomain: 'arrays of arbitrary comparable values',
+        }),
+    },
+    {
+        // "must be sorted" / "should be sorted" / "maintains order"
+        pattern: /(?:must|should)\s+be\s+sorted|maintains?\s+(?:sort\s+)?order/i,
+        extract: (_m, raw) => ({
+            invariant: `${raw.trim()} — output is sorted`,
+            inputDomain: 'arrays of comparable values',
+        }),
+    },
+];
+// ---------------------------------------------------------------------------
+// Code generators per framework
+// ---------------------------------------------------------------------------
+function buildFastCheckCode(invariant, inputDomain) {
+    return `fc.assert(
+  fc.property(
+    fc.float({ min: 0.01, noNaN: true }), // ${inputDomain}
+    (input) => {
+      const result = functionUnderTest(input);
+      // ${invariant}
+      return result !== null && result !== undefined;
+    },
+  ),
+);`;
+}
+function buildHypothesisCode(invariant, inputDomain) {
+    const safeName = invariant.toLowerCase().replace(/[^a-z0-9]/g, '_').slice(0, 40);
+    return `@given(st.floats(min_value=0.01, allow_nan=False))  # ${inputDomain}
+@settings(max_examples=100, deadline=None)
+def test_${safeName}(input_value: float) -> None:
+    """${invariant}"""
+    result = function_under_test(input_value)
+    assert result is not None`;
+}
+function buildJqwikCode(invariant, inputDomain) {
+    const safeName = invariant.replace(/[^a-zA-Z0-9]/g, '').slice(0, 40);
+    return `@Property
+boolean ${safeName}(@ForAll @Positive double input) {
+    // ${inputDomain}
+    // ${invariant}
+    Object result = functionUnderTest(input);
+    return result != null;
+}`;
+}
+function buildGenericCode(invariant, inputDomain) {
+    return `// Property: ${invariant}
+// Input domain: ${inputDomain}
+// For each arbitrary valid input in the domain:
+//   1. Generate input using your framework's generator
+//   2. Call the function under test
+//   3. Assert: ${invariant}`;
+}
+function buildGeneratorCode(framework, invariant, inputDomain) {
+    switch (framework) {
+        case 'fast-check':
+            return buildFastCheckCode(invariant, inputDomain);
+        case 'hypothesis':
+            return buildHypothesisCode(invariant, inputDomain);
+        case 'jqwik':
+            return buildJqwikCode(invariant, inputDomain);
+        case 'generic':
+            return buildGenericCode(invariant, inputDomain);
+    }
+}
+function getShrinkStrategy(framework) {
+    switch (framework) {
+        case 'fast-check':
+            return 'automatic (built-in shrinker reduces to minimal failing case)';
+        case 'hypothesis':
+            return 'automatic (Hypothesis shrinks via @settings(deriving=True))';
+        case 'jqwik':
+            return 'automatic (jqwik shrinks @ForAll parameters)';
+        case 'generic':
+            return 'manual (implement shrink by binary search or domain reduction)';
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Extract PropertyTest objects from acceptance criteria strings.
+ * Each criterion is analyzed against known invariant patterns.
+ * Criteria with no detected pattern are skipped.
+ */
+export function extractPropertyTests(input) {
+    const framework = detectPropertyFramework(input.language, input.stack);
+    const shrinkStrategy = getShrinkStrategy(framework);
+    const results = [];
+    for (const criterion of input.criteria) {
+        for (const { pattern, extract } of INVARIANT_PATTERNS) {
+            const match = criterion.match(pattern);
+            if (match) {
+                const { invariant, inputDomain } = extract(match, criterion);
+                results.push({
+                    invariant,
+                    inputDomain,
+                    generatorCode: buildGeneratorCode(framework, invariant, inputDomain),
+                    framework,
+                    shrinkStrategy,
+                });
+                break; // one pattern per criterion
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Full extraction with metadata: detected framework and analyzed criteria list.
+ */
+export function extractPropertyTestsWithMeta(input) {
+    const detectedFramework = detectPropertyFramework(input.language, input.stack);
+    const tests = extractPropertyTests(input);
+    return {
+        tests,
+        detectedFramework,
+        analyzedCriteria: input.criteria,
+    };
+}
+//# sourceMappingURL=property-test-generator.js.map