openplanr 0.1.0 → 0.3.0

package/dist/models/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;AACvF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AACtD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,IAAK,SAAQ,YAAY;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,OAAQ,SAAQ,YAAY;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,40 @@
+/**
+ * High-level AI orchestration service.
+ *
+ * Bridges the gap between CLI commands and the AI provider layer.
+ * Handles provider initialization, streaming output, and structured
+ * JSON generation with Zod validation and retry logic.
+ */
+import type { ZodSchema } from 'zod';
+import type { AIProvider, AIMessage, AIRequestOptions } from '../ai/types.js';
+import type { OpenPlanrConfig } from '../models/types.js';
+/**
+ * Initialize an AI provider from project config.
+ * Dynamically imports the factory to keep non-AI commands fast.
+ */
+export declare function getAIProvider(config: OpenPlanrConfig): Promise<AIProvider>;
+/**
+ * Check whether AI is configured and available for a given project config.
+ */
+export declare function isAIConfigured(config: OpenPlanrConfig): boolean;
+/**
+ * Stream AI output to the terminal in real time.
+ * Returns the fully accumulated text once streaming completes.
+ */
+export declare function streamToTerminal(stream: AsyncIterable<string>): Promise<string>;
+/**
+ * Generate a validated JSON response from the AI.
+ *
+ * Flow:
+ * 1. Send messages with JSON mode hint
+ * 2. Parse response as JSON
+ * 3. Validate with Zod schema
+ * 4. On failure, retry once with error feedback
+ */
+export declare function generateJSON<T>(provider: AIProvider, messages: AIMessage[], schema: ZodSchema<T>, options?: AIRequestOptions): Promise<T>;
+/**
+ * Generate JSON with streaming — shows progress dots in the terminal
+ * while the AI generates, then parses the complete response.
+ */
+export declare function generateStreamingJSON<T>(provider: AIProvider, messages: AIMessage[], schema: ZodSchema<T>, options?: AIRequestOptions): Promise<T>;
+//# sourceMappingURL=ai-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-service.d.ts","sourceRoot":"","sources":["../../src/services/ai-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAoB,MAAM,gBAAgB,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBhF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE/D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CA+BZ;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CA8CZ"}

package/dist/services/ai-service.js

@@ -0,0 +1,150 @@
+/**
+ * High-level AI orchestration service.
+ *
+ * Bridges the gap between CLI commands and the AI provider layer.
+ * Handles provider initialization, streaming output, and structured
+ * JSON generation with Zod validation and retry logic.
+ */
+import { AIError } from '../ai/errors.js';
+import { resolveApiKey } from './credentials-service.js';
+/**
+ * Initialize an AI provider from project config.
+ * Dynamically imports the factory to keep non-AI commands fast.
+ */
+export async function getAIProvider(config) {
+    if (!config.ai) {
+        throw new AIError('AI is not configured. Run `planr init` or `planr config set-provider <name>`.', 'auth');
+    }
+    const apiKey = await resolveApiKey(config.ai.provider);
+    const providerConfig = {
+        provider: config.ai.provider,
+        model: config.ai.model,
+        apiKey,
+        baseUrl: config.ai.ollamaBaseUrl,
+    };
+    const { createAIProvider } = await import('../ai/provider-factory.js');
+    return createAIProvider(providerConfig);
+}
+/**
+ * Check whether AI is configured and available for a given project config.
+ */
+export function isAIConfigured(config) {
+    return config.ai != null && config.ai.provider != null;
+}
+/**
+ * Stream AI output to the terminal in real time.
+ * Returns the fully accumulated text once streaming completes.
+ */
+export async function streamToTerminal(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+        process.stdout.write(chunk);
+        chunks.push(chunk);
+    }
+    // Ensure a trailing newline after streaming
+    process.stdout.write('\n');
+    return chunks.join('');
+}
+/**
+ * Generate a validated JSON response from the AI.
+ *
+ * Flow:
+ * 1. Send messages with JSON mode hint
+ * 2. Parse response as JSON
+ * 3. Validate with Zod schema
+ * 4. On failure, retry once with error feedback
+ */
+export async function generateJSON(provider, messages, schema, options) {
+    const requestOptions = {
+        temperature: 0.5,
+        ...options,
+        jsonMode: true,
+    };
+    let rawResponse = await provider.chatSync(messages, requestOptions);
+    let parsed = tryParseAndValidate(rawResponse, schema);
+    if (parsed.success)
+        return parsed.data;
+    // Retry once with error feedback
+    const retryMessages = [
+        ...messages,
+        { role: 'assistant', content: rawResponse },
+        {
+            role: 'user',
+            content: `Your response was not valid JSON or failed validation:\n${parsed.error}\n\nPlease fix and return valid JSON only.`,
+        },
+    ];
+    rawResponse = await provider.chatSync(retryMessages, requestOptions);
+    parsed = tryParseAndValidate(rawResponse, schema);
+    if (parsed.success)
+        return parsed.data;
+    throw new AIError(`AI returned invalid JSON after retry: ${parsed.error}`, 'invalid_response');
+}
+/**
+ * Generate JSON with streaming — shows progress dots in the terminal
+ * while the AI generates, then parses the complete response.
+ */
+export async function generateStreamingJSON(provider, messages, schema, options) {
+    const requestOptions = {
+        temperature: 0.5,
+        ...options,
+        jsonMode: true,
+    };
+    // Stream the response, showing dots for progress
+    const chunks = [];
+    let dotCount = 0;
+    const stream = provider.chat(messages, requestOptions);
+    for await (const chunk of stream) {
+        chunks.push(chunk);
+        // Show a dot every ~200 chars of content
+        if (chunks.join('').length > (dotCount + 1) * 200) {
+            process.stdout.write('.');
+            dotCount++;
+        }
+    }
+    if (dotCount > 0)
+        process.stdout.write('\n');
+    const rawResponse = chunks.join('');
+    let parsed = tryParseAndValidate(rawResponse, schema);
+    if (parsed.success)
+        return parsed.data;
+    // Retry once with error feedback (non-streaming for retry)
+    const retryMessages = [
+        ...messages,
+        { role: 'assistant', content: rawResponse },
+        {
+            role: 'user',
+            content: `Your response was not valid JSON or failed validation:\n${parsed.error}\n\nPlease fix and return valid JSON only.`,
+        },
+    ];
+    const retryResponse = await provider.chatSync(retryMessages, requestOptions);
+    parsed = tryParseAndValidate(retryResponse, schema);
+    if (parsed.success)
+        return parsed.data;
+    throw new AIError(`AI returned invalid JSON after retry: ${parsed.error}`, 'invalid_response');
+}
+/** Extract JSON from a response that might contain markdown code fences. */
+function extractJSON(raw) {
+    // Strip markdown code fences if present
+    const fenceMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    if (fenceMatch)
+        return fenceMatch[1].trim();
+    return raw.trim();
+}
+function tryParseAndValidate(raw, schema) {
+    try {
+        const cleaned = extractJSON(raw);
+        const json = JSON.parse(cleaned);
+        const result = schema.safeParse(json);
+        if (result.success) {
+            return { success: true, data: result.data };
+        }
+        const errors = result.error.issues
+            .map((i) => `  ${i.path.join('.')}: ${i.message}`)
+            .join('\n');
+        return { success: false, error: `Validation errors:\n${errors}` };
+    }
+    catch (err) {
+        return { success: false, error: `JSON parse error: ${err.message}` };
+    }
+}
+//# sourceMappingURL=ai-service.js.map

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

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

package/dist/services/artifact-gathering.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Shared artifact-gathering utilities for task generation prompts.
+ *
+ * Collects all related artifacts (stories, gherkin, ADRs, epic, feature)
+ * into a single context object that `buildTasksPrompt()` consumes.
+ */
+import type { OpenPlanrConfig } from '../models/types.js';
+export interface TasksPromptContext {
+    /** One or more user stories to generate tasks from. */
+    stories: Array<{
+        id: string;
+        raw: string;
+    }>;
+    /** Gherkin acceptance criteria for stories. */
+    gherkinScenarios: Array<{
+        storyId: string;
+        content: string;
+    }>;
+    /** Parent feature raw markdown. */
+    featureRaw?: string;
+    /** Parent epic raw markdown. */
+    epicRaw?: string;
+    /** Architecture decision records. */
+    adrs: Array<{
+        id: string;
+        content: string;
+    }>;
+    /** Formatted codebase context (tech stack, folder tree, related files). */
+    codebaseContext?: string;
+    /** Creation scope hint for AI task naming. */
+    scope?: {
+        type: 'feature';
+        id: string;
+    } | {
+        type: 'story';
+        id: string;
+    };
+}
+/**
+ * Gather all context for a single user story.
+ * Used by `--story` flag and `planr plan` per-story generation.
+ */
+export declare function gatherStoryArtifacts(projectDir: string, config: OpenPlanrConfig, storyId: string): Promise<TasksPromptContext>;
+/**
+ * Gather all context for a feature — all stories + gherkin + ADRs + parent epic.
+ * Used by `--feature` flag.
+ */
+export declare function gatherFeatureArtifacts(projectDir: string, config: OpenPlanrConfig, featureId: string): Promise<TasksPromptContext>;
+//# sourceMappingURL=artifact-gathering.d.ts.map

package/dist/services/artifact-gathering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-gathering.d.ts","sourceRoot":"","sources":["../../src/services/artifact-gathering.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,gBAAgB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAmC7B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/services/artifact-gathering.js

@@ -0,0 +1,128 @@
+/**
+ * Shared artifact-gathering utilities for task generation prompts.
+ *
+ * Collects all related artifacts (stories, gherkin, ADRs, epic, feature)
+ * into a single context object that `buildTasksPrompt()` consumes.
+ */
+import path from 'node:path';
+import { readArtifact, readArtifactRaw, listArtifacts, getArtifactDir, } from './artifact-service.js';
+import { readFile, listFiles } from '../utils/fs.js';
+/**
+ * Gather all context for a single user story.
+ * Used by `--story` flag and `planr plan` per-story generation.
+ */
+export async function gatherStoryArtifacts(projectDir, config, storyId) {
+    const storyRaw = await readArtifactRaw(projectDir, config, 'story', storyId);
+    if (!storyRaw)
+        throw new Error(`Story ${storyId} not found.`);
+    const stories = [{ id: storyId, raw: storyRaw }];
+    // Read gherkin for this story
+    const gherkinScenarios = [];
+    const gherkinContent = await findGherkinContent(projectDir, config, storyId);
+    if (gherkinContent) {
+        gherkinScenarios.push({ storyId, content: gherkinContent });
+    }
+    // Read parent feature + epic
+    const storyData = await readArtifact(projectDir, config, 'story', storyId);
+    const featureId = storyData?.data.featureId;
+    let featureRaw;
+    let epicRaw;
+    if (featureId) {
+        featureRaw = (await readArtifactRaw(projectDir, config, 'feature', featureId)) || undefined;
+        const featureData = await readArtifact(projectDir, config, 'feature', featureId);
+        const epicId = featureData?.data.epicId;
+        if (epicId) {
+            epicRaw = (await readArtifactRaw(projectDir, config, 'epic', epicId)) || undefined;
+        }
+    }
+    // Read ADRs
+    const adrs = await readAllADRs(projectDir, config);
+    // Build codebase context
+    const codebaseContext = await buildCodebaseStr(projectDir, storyRaw + (featureRaw || ''));
+    return { stories, gherkinScenarios, featureRaw, epicRaw, adrs, codebaseContext };
+}
+/**
+ * Gather all context for a feature — all stories + gherkin + ADRs + parent epic.
+ * Used by `--feature` flag.
+ */
+export async function gatherFeatureArtifacts(projectDir, config, featureId) {
+    const featureRaw = await readArtifactRaw(projectDir, config, 'feature', featureId);
+    if (!featureRaw)
+        throw new Error(`Feature ${featureId} not found.`);
+    // Read parent epic
+    const featureData = await readArtifact(projectDir, config, 'feature', featureId);
+    const epicId = featureData?.data.epicId;
+    let epicRaw;
+    if (epicId) {
+        epicRaw = (await readArtifactRaw(projectDir, config, 'epic', epicId)) || undefined;
+    }
+    // Find all stories under this feature
+    const allStories = await listArtifacts(projectDir, config, 'story');
+    const stories = [];
+    const gherkinScenarios = [];
+    for (const s of allStories) {
+        const data = await readArtifact(projectDir, config, 'story', s.id);
+        if (data && data.data.featureId === featureId) {
+            const raw = await readArtifactRaw(projectDir, config, 'story', s.id);
+            if (raw) {
+                stories.push({ id: s.id, raw });
+                const gherkin = await findGherkinContent(projectDir, config, s.id);
+                if (gherkin) {
+                    gherkinScenarios.push({ storyId: s.id, content: gherkin });
+                }
+            }
+        }
+    }
+    if (stories.length === 0) {
+        throw new Error(`No user stories found for feature ${featureId}. Create stories first with: planr story create --feature ${featureId}`);
+    }
+    // Read ADRs
+    const adrs = await readAllADRs(projectDir, config);
+    // Build codebase context from all story + feature content
+    const allText = stories.map((s) => s.raw).join('\n') + '\n' + featureRaw;
+    const codebaseContext = await buildCodebaseStr(projectDir, allText);
+    return { stories, gherkinScenarios, featureRaw, epicRaw, adrs, codebaseContext };
+}
+/**
+ * Read a gherkin file for a given story ID. Returns content or null.
+ */
+async function findGherkinContent(projectDir, config, storyId) {
+    const storyDir = path.join(projectDir, getArtifactDir(config, 'story'));
+    const files = await listFiles(storyDir, new RegExp(`^${storyId}-gherkin\\.feature$`));
+    if (files.length === 0)
+        return null;
+    return readFile(path.join(storyDir, files[0]));
+}
+/**
+ * Read all ADR artifacts in the project.
+ */
+async function readAllADRs(projectDir, config) {
+    const adrs = [];
+    try {
+        const allAdrs = await listArtifacts(projectDir, config, 'adr');
+        for (const a of allAdrs) {
+            const raw = await readArtifactRaw(projectDir, config, 'adr', a.id);
+            if (raw)
+                adrs.push({ id: a.id, content: raw });
+        }
+    }
+    catch {
+        // ADRs may not exist — graceful fallback
+    }
+    return adrs;
+}
+/**
+ * Build formatted codebase context string from text content.
+ */
+async function buildCodebaseStr(projectDir, textContent) {
+    try {
+        const { buildCodebaseContext, formatCodebaseContext, extractKeywords } = await import('../ai/codebase/index.js');
+        const keywords = extractKeywords(textContent);
+        const ctx = await buildCodebaseContext(projectDir, keywords);
+        return formatCodebaseContext(ctx);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=artifact-gathering.js.map

package/dist/services/artifact-gathering.js.map

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

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

@@ -14,4 +14,51 @@ export declare function readArtifact(projectDir: string, config: OpenPlanrConfig
     content: string;
     filePath: string;
 } | null>;
+/**
+ * Read the full raw content of an artifact file (frontmatter + body).
+ * Useful for passing the complete artifact text to AI prompts.
+ */
+export declare function readArtifactRaw(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string): Promise<string | null>;
+/**
+ * Overwrite an existing artifact file in place.
+ */
+export declare function updateArtifact(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string, content: string): Promise<void>;
+/**
+ * Resolve an artifact ID to its actual filename (without path).
+ * Returns the filename like "EPIC-002-markdown-to-kanban-board.md"
+ * or falls back to "ID.md" if the file can't be found.
+ */
+export declare function resolveArtifactFilename(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string): Promise<string>;
+/**
+ * Add a child reference link to a parent artifact's markdown file.
+ *
+ * Replaces the "No X created yet" placeholder with a link list,
+ * or appends to existing links in the appropriate section.
+ *
+ * @param childId    e.g. "FEAT-002"
+ * @param childTitle e.g. "Markdown Task Parser Engine"
+ * @param childType  e.g. "feature"
+ */
+export declare function addChildReference(projectDir: string, config: OpenPlanrConfig, parentType: ArtifactType, parentId: string, childType: ArtifactType, childId: string, childTitle: string): Promise<void>;
+/**
+ * Determine artifact type from an ID prefix.
+ */
+export declare function findArtifactTypeById(id: string): ArtifactType | null;
+/**
+ * Read the parent chain for an artifact (story → feature → epic).
+ */
+export declare function getParentChain(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string): Promise<{
+    epic?: {
+        data: Record<string, unknown>;
+        content: string;
+    };
+    feature?: {
+        data: Record<string, unknown>;
+        content: string;
+    };
+    story?: {
+        data: Record<string, unknown>;
+        content: string;
+    };
+}>;
 //# sourceMappingURL=artifact-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"artifact-service.d.ts","sourceRoot":"","sources":["../../src/services/artifact-service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWxE,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAElF;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAqB3C;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAgBjE;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAStF"}
+{"version":3,"file":"artifact-service.d.ts","sourceRoot":"","sources":["../../src/services/artifact-service.ts"],"names":[],"mappings":"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"}

package/dist/services/artifact-service.js

@@ -4,6 +4,7 @@ import { slugify } from '../utils/slugify.js';
 import { parseMarkdown } from '../utils/markdown.js';
 import { getNextId } from './id-service.js';
 import { renderTemplate } from './template-service.js';
+import { logger } from '../utils/logger.js';
 const ARTIFACT_DIR_MAP = {
     epic: 'epics',
     feature: 'features',
@@ -32,6 +33,7 @@ export async function createArtifact(projectDir, config, type, templateFile, dat
         projectName: config.projectName,
     }, config.templateOverrides);
     await writeFile(filePath, content);
+    logger.debug(`Created ${type} artifact: ${id} → ${filePath}`);
     return { id, filePath };
 }
 export async function listArtifacts(projectDir, config, type) {
@@ -56,8 +58,175 @@ export async function readArtifact(projectDir, config, type, id) {
     if (files.length === 0)
         return null;
     const filePath = path.join(dir, files[0]);
+    logger.debug(`Reading ${type} artifact: ${id} ← ${filePath}`);
     const raw = await readFile(filePath);
     const parsed = parseMarkdown(raw);
     return { ...parsed, filePath };
 }
+/**
+ * Read the full raw content of an artifact file (frontmatter + body).
+ * Useful for passing the complete artifact text to AI prompts.
+ */
+export async function readArtifactRaw(projectDir, config, type, id) {
+    const dir = path.join(projectDir, getArtifactDir(config, type));
+    const files = await listFiles(dir, new RegExp(`^${id}-.*\\.md$`));
+    if (files.length === 0)
+        return null;
+    return readFile(path.join(dir, files[0]));
+}
+/**
+ * Overwrite an existing artifact file in place.
+ */
+export async function updateArtifact(projectDir, config, type, id, content) {
+    const dir = path.join(projectDir, getArtifactDir(config, type));
+    const files = await listFiles(dir, new RegExp(`^${id}-.*\\.md$`));
+    if (files.length === 0)
+        throw new Error(`Artifact ${id} not found.`);
+    const filePath = path.join(dir, files[0]);
+    await writeFile(filePath, content);
+}
+/**
+ * Resolve an artifact ID to its actual filename (without path).
+ * Returns the filename like "EPIC-002-markdown-to-kanban-board.md"
+ * or falls back to "ID.md" if the file can't be found.
+ */
+export async function resolveArtifactFilename(projectDir, config, type, id) {
+    const dir = path.join(projectDir, getArtifactDir(config, type));
+    const files = await listFiles(dir, new RegExp(`^${id}-.*\\.md$`));
+    if (files.length > 0)
+        return files[0].replace(/\.md$/, '');
+    return id;
+}
+/**
+ * Add a child reference link to a parent artifact's markdown file.
+ *
+ * Replaces the "No X created yet" placeholder with a link list,
+ * or appends to existing links in the appropriate section.
+ *
+ * @param childId    e.g. "FEAT-002"
+ * @param childTitle e.g. "Markdown Task Parser Engine"
+ * @param childType  e.g. "feature"
+ */
+export async function addChildReference(projectDir, config, parentType, parentId, childType, childId, childTitle) {
+    const parentRaw = await readArtifactRaw(projectDir, config, parentType, parentId);
+    if (!parentRaw)
+        return;
+    const childFilename = await resolveArtifactFilename(projectDir, config, childType, childId);
+    const relDir = ARTIFACT_DIR_MAP[childType] || childType;
+    const link = `- [${childId}: ${childTitle}](../${relDir}/${childFilename}.md)`;
+    // Pattern to match placeholder lines like "_No X created yet..._" or "_Run `planr ...` to generate..._"
+    const placeholderPattern = /^_(?:No .+ created yet\.|Run .+ to (?:generate|create)).+_$/m;
+    let updated;
+    if (placeholderPattern.test(parentRaw)) {
+        // Replace placeholder with the first child link
+        updated = parentRaw.replace(placeholderPattern, link);
+    }
+    else {
+        // Append after the last existing child link in the same section
+        // Find the section heading for children (## Features, ## User Stories, ## Tasks)
+        const sectionMap = {
+            feature: '## Features',
+            story: '## User Stories',
+            task: '## Tasks',
+        };
+        const sectionHeading = sectionMap[childType];
+        if (!sectionHeading)
+            return;
+        const sectionIdx = parentRaw.indexOf(sectionHeading);
+        if (sectionIdx === -1)
+            return;
+        // Find the end of the child links block (last line starting with "- [")
+        const afterSection = parentRaw.slice(sectionIdx);
+        const lines = afterSection.split('\n');
+        let lastLinkLineIdx = -1;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i].startsWith('- [')) {
+                lastLinkLineIdx = i;
+            }
+            else if (lines[i].startsWith('#') || (lastLinkLineIdx > -1 && lines[i].trim() !== '')) {
+                break;
+            }
+        }
+        if (lastLinkLineIdx > -1) {
+            // Insert after the last link line
+            lines.splice(lastLinkLineIdx + 1, 0, link);
+            updated = parentRaw.slice(0, sectionIdx) + lines.join('\n');
+        }
+        else {
+            // No links found after heading, add after the heading line
+            lines.splice(1, 0, link);
+            updated = parentRaw.slice(0, sectionIdx) + lines.join('\n');
+        }
+    }
+    await updateArtifact(projectDir, config, parentType, parentId, updated);
+}
+/**
+ * Determine artifact type from an ID prefix.
+ */
+export function findArtifactTypeById(id) {
+    const prefix = id.split('-')[0];
+    const map = {
+        EPIC: 'epic',
+        FEAT: 'feature',
+        US: 'story',
+        TASK: 'task',
+        ADR: 'adr',
+    };
+    return map[prefix] || null;
+}
+/**
+ * Read the parent chain for an artifact (story → feature → epic).
+ */
+export async function getParentChain(projectDir, config, type, id) {
+    const result = {};
+    const artifact = await readArtifact(projectDir, config, type, id);
+    if (!artifact)
+        return result;
+    if (type === 'task') {
+        const storyId = artifact.data.storyId;
+        if (storyId) {
+            const story = await readArtifact(projectDir, config, 'story', storyId);
+            if (story) {
+                result.story = { data: story.data, content: story.content };
+                const featureId = story.data.featureId;
+                if (featureId) {
+                    const feature = await readArtifact(projectDir, config, 'feature', featureId);
+                    if (feature) {
+                        result.feature = { data: feature.data, content: feature.content };
+                        const epicId = feature.data.epicId;
+                        if (epicId) {
+                            const epic = await readArtifact(projectDir, config, 'epic', epicId);
+                            if (epic)
+                                result.epic = { data: epic.data, content: epic.content };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    else if (type === 'story') {
+        const featureId = artifact.data.featureId;
+        if (featureId) {
+            const feature = await readArtifact(projectDir, config, 'feature', featureId);
+            if (feature) {
+                result.feature = { data: feature.data, content: feature.content };
+                const epicId = feature.data.epicId;
+                if (epicId) {
+                    const epic = await readArtifact(projectDir, config, 'epic', epicId);
+                    if (epic)
+                        result.epic = { data: epic.data, content: epic.content };
+                }
+            }
+        }
+    }
+    else if (type === 'feature') {
+        const epicId = artifact.data.epicId;
+        if (epicId) {
+            const epic = await readArtifact(projectDir, config, 'epic', epicId);
+            if (epic)
+                result.epic = { data: epic.data, content: epic.content };
+        }
+    }
+    return result;
+}
 //# sourceMappingURL=artifact-service.js.map