@h-rig/planning-plugin 0.0.6-alpha.135 → 0.0.6-alpha.136

package/dist/src/index.js

@@ -12,6 +12,76 @@ async function plan(planSpec, ports) {
 async function specClarifyPlan(input, context, ports) {
   return plan(await clarify(await spec(input, ports), context, ports), ports);
 }
+var PLAN_SPEC_SYSTEM = "You are an engineering architect. Convert a PRD into a structured spec. Capture WHAT and WHY, not the tech stack. Surface every ambiguity as an open question. Decompose into ordered, dependency-aware tasks. Reply ONLY with a single JSON object.";
+function planSpecUser(input) {
+  return [
+    `PRD title: ${input.title}`,
+    `PRD:
+"""${input.body}"""`,
+    "",
+    'Reply with JSON of exactly this shape: { "userStories": [{"id":"US1","title":"...","priority":1}], "functionalRequirements": [{"id":"FR-001","text":"..."}], "openQuestions": [{"id":"Q1","question":"..."}], "tasks": [{"localId":"task-1","title":"...","description":"...","acceptance":["..."],"scope":["path"],"validationKeys":[],"dependsOn":[],"parent":null,"parallelizable":true}] }',
+    "Mark as open any underspecified data shape, edge case, non-functional limit, or integration point. Use dependsOn (localIds) to order tasks. The task graph must be acyclic."
+  ].join(`
+`);
+}
+function extractJsonObject(text) {
+  const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+  const raw = fenced?.[1] ?? text;
+  const start = raw.indexOf("{");
+  const end = raw.lastIndexOf("}");
+  if (start < 0 || end <= start)
+    throw new Error("model output contained no JSON object");
+  return JSON.parse(raw.slice(start, end + 1));
+}
+function createLlmPlanningProvider(chat, now) {
+  return {
+    spec: async (input) => {
+      const parsed = extractJsonObject(await chat(PLAN_SPEC_SYSTEM, planSpecUser(input)));
+      const stories = Array.isArray(parsed.userStories) ? parsed.userStories : [];
+      const reqs = Array.isArray(parsed.functionalRequirements) ? parsed.functionalRequirements : [];
+      const questions = Array.isArray(parsed.openQuestions) ? parsed.openQuestions : [];
+      const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+      return {
+        prdTitle: input.title,
+        userStories: stories.filter((s) => s.title).map((s, i) => ({ id: s.id ?? `US${i + 1}`, title: String(s.title), priority: typeof s.priority === "number" ? s.priority : i + 1 })),
+        functionalRequirements: reqs.filter((r) => r.text).map((r, i) => ({ id: r.id ?? `FR-${String(i + 1).padStart(3, "0")}`, text: String(r.text) })),
+        openQuestions: questions.filter((q) => q.question).map((q, i) => ({ id: q.id ?? `Q${i + 1}`, question: String(q.question), status: "open", resolution: null })),
+        tasks: tasks.filter((t) => typeof t.title === "string").map((t, i) => ({
+          localId: typeof t.localId === "string" ? t.localId : `task-${i + 1}`,
+          title: String(t.title),
+          description: typeof t.description === "string" ? t.description : "",
+          acceptance: Array.isArray(t.acceptance) ? t.acceptance.map(String) : [],
+          scope: Array.isArray(t.scope) ? t.scope.map(String) : [],
+          validationKeys: Array.isArray(t.validationKeys) ? t.validationKeys.map(String) : [],
+          dependsOn: Array.isArray(t.dependsOn) ? t.dependsOn.map(String) : [],
+          parent: typeof t.parent === "string" ? t.parent : null,
+          parallelizable: t.parallelizable !== false
+        })),
+        generatedAt: now()
+      };
+    },
+    clarify: (planSpec) => planSpec,
+    plan: (planSpec) => planSpec
+  };
+}
+function openAiChat(apiKey, model = "gpt-4o-mini") {
+  return async (system, user) => {
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${apiKey}` },
+      body: JSON.stringify({
+        model,
+        messages: [{ role: "system", content: system }, { role: "user", content: user }],
+        temperature: 0.2,
+        response_format: { type: "json_object" }
+      })
+    });
+    if (!res.ok)
+      throw new Error(`OpenAI ${res.status}: ${(await res.text()).slice(0, 300)}`);
+    const data = await res.json();
+    return data.choices?.[0]?.message?.content ?? "{}";
+  };
+}
 function taskByLocalId(tasks) {
   return new Map(tasks.map((task) => [task.localId, task]));
 }
@@ -138,7 +208,9 @@ export {
   spec,
   planningPlugin,
   plan,
+  openAiChat,
   materialize,
+  createLlmPlanningProvider,
   clarify,
   PLANNING_PLUGIN_NAME
 };

package/dist/src/planning.d.ts

@@ -28,6 +28,10 @@ export declare function spec(input: PrdInput, ports: Pick<PlanningProviderPorts,
 export declare function clarify(planSpec: PlanSpec, context: ClarificationContext, ports: Pick<PlanningProviderPorts, "clarify">): Promise<PlanSpec>;
 export declare function plan(planSpec: PlanSpec, ports: Pick<PlanningProviderPorts, "plan">): Promise<PlanSpec>;
 export declare function specClarifyPlan(input: PrdInput, context: ClarificationContext, ports: PlanningProviderPorts): Promise<PlanSpec>;
+export type ChatComplete = (system: string, user: string) => Promise<string>;
+export declare function createLlmPlanningProvider(chat: ChatComplete, now: () => string): PlanningProviderPorts;
+/** OpenAI chat-completions port via fetch (no SDK). */
+export declare function openAiChat(apiKey: string, model?: string): ChatComplete;
 export declare function materialize(planSpec: PlanSpec, source: Pick<RegisteredTaskSource, "list" | "create">, options?: {
     readonly planId?: string;
 }): Promise<MaterializePlanResult>;

package/dist/src/planning.js

@@ -12,6 +12,76 @@ async function plan(planSpec, ports) {
 async function specClarifyPlan(input, context, ports) {
   return plan(await clarify(await spec(input, ports), context, ports), ports);
 }
+var PLAN_SPEC_SYSTEM = "You are an engineering architect. Convert a PRD into a structured spec. Capture WHAT and WHY, not the tech stack. Surface every ambiguity as an open question. Decompose into ordered, dependency-aware tasks. Reply ONLY with a single JSON object.";
+function planSpecUser(input) {
+  return [
+    `PRD title: ${input.title}`,
+    `PRD:
+"""${input.body}"""`,
+    "",
+    'Reply with JSON of exactly this shape: { "userStories": [{"id":"US1","title":"...","priority":1}], "functionalRequirements": [{"id":"FR-001","text":"..."}], "openQuestions": [{"id":"Q1","question":"..."}], "tasks": [{"localId":"task-1","title":"...","description":"...","acceptance":["..."],"scope":["path"],"validationKeys":[],"dependsOn":[],"parent":null,"parallelizable":true}] }',
+    "Mark as open any underspecified data shape, edge case, non-functional limit, or integration point. Use dependsOn (localIds) to order tasks. The task graph must be acyclic."
+  ].join(`
+`);
+}
+function extractJsonObject(text) {
+  const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+  const raw = fenced?.[1] ?? text;
+  const start = raw.indexOf("{");
+  const end = raw.lastIndexOf("}");
+  if (start < 0 || end <= start)
+    throw new Error("model output contained no JSON object");
+  return JSON.parse(raw.slice(start, end + 1));
+}
+function createLlmPlanningProvider(chat, now) {
+  return {
+    spec: async (input) => {
+      const parsed = extractJsonObject(await chat(PLAN_SPEC_SYSTEM, planSpecUser(input)));
+      const stories = Array.isArray(parsed.userStories) ? parsed.userStories : [];
+      const reqs = Array.isArray(parsed.functionalRequirements) ? parsed.functionalRequirements : [];
+      const questions = Array.isArray(parsed.openQuestions) ? parsed.openQuestions : [];
+      const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+      return {
+        prdTitle: input.title,
+        userStories: stories.filter((s) => s.title).map((s, i) => ({ id: s.id ?? `US${i + 1}`, title: String(s.title), priority: typeof s.priority === "number" ? s.priority : i + 1 })),
+        functionalRequirements: reqs.filter((r) => r.text).map((r, i) => ({ id: r.id ?? `FR-${String(i + 1).padStart(3, "0")}`, text: String(r.text) })),
+        openQuestions: questions.filter((q) => q.question).map((q, i) => ({ id: q.id ?? `Q${i + 1}`, question: String(q.question), status: "open", resolution: null })),
+        tasks: tasks.filter((t) => typeof t.title === "string").map((t, i) => ({
+          localId: typeof t.localId === "string" ? t.localId : `task-${i + 1}`,
+          title: String(t.title),
+          description: typeof t.description === "string" ? t.description : "",
+          acceptance: Array.isArray(t.acceptance) ? t.acceptance.map(String) : [],
+          scope: Array.isArray(t.scope) ? t.scope.map(String) : [],
+          validationKeys: Array.isArray(t.validationKeys) ? t.validationKeys.map(String) : [],
+          dependsOn: Array.isArray(t.dependsOn) ? t.dependsOn.map(String) : [],
+          parent: typeof t.parent === "string" ? t.parent : null,
+          parallelizable: t.parallelizable !== false
+        })),
+        generatedAt: now()
+      };
+    },
+    clarify: (planSpec) => planSpec,
+    plan: (planSpec) => planSpec
+  };
+}
+function openAiChat(apiKey, model = "gpt-4o-mini") {
+  return async (system, user) => {
+    const res = await fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: { "content-type": "application/json", authorization: `Bearer ${apiKey}` },
+      body: JSON.stringify({
+        model,
+        messages: [{ role: "system", content: system }, { role: "user", content: user }],
+        temperature: 0.2,
+        response_format: { type: "json_object" }
+      })
+    });
+    if (!res.ok)
+      throw new Error(`OpenAI ${res.status}: ${(await res.text()).slice(0, 300)}`);
+    const data = await res.json();
+    return data.choices?.[0]?.message?.content ?? "{}";
+  };
+}
 function taskByLocalId(tasks) {
   return new Map(tasks.map((task) => [task.localId, task]));
 }
@@ -119,6 +189,8 @@ export {
   specClarifyPlan,
   spec,
   plan,
+  openAiChat,
   materialize,
+  createLlmPlanningProvider,
   clarify
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/planning-plugin",
-  "version": "0.0.6-alpha.135",
+  "version": "0.0.6-alpha.136",
   "type": "module",
   "description": "First-party PRD-to-plan plugin for Rig task sources.",
   "license": "UNLICENSED",
@@ -29,7 +29,7 @@
   "module": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.135",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.135"
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.136",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.136"
   }
 }