@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/core/context-render.js

@@ -0,0 +1,228 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Text renderers for project context: the plain-text form the MCP resource and
+ * prompts embed, and the PROJECT.md generator behind `devsteps context generate`.
+ *
+ * @see STORY-121 TASK-272, TASK-275
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { analyzePackages } from './context.js';
+import { getItemCounts, getRecentUpdates } from './context-items.js';
+/**
+ * Format a ContextResponse as readable plain text for embedding in AI prompts
+ * (used by MCP resource devsteps://project-context).
+ * @see STORY-121 TASK-275
+ */
+export function formatContextAsText(ctx) {
+    const lines = [];
+    lines.push('# DevSteps Project Context');
+    lines.push('');
+    if (ctx.static_context) {
+        const sc = ctx.static_context;
+        if (sc.project_type) {
+            lines.push(`**Project Type:** ${sc.project_type}`);
+            lines.push('');
+        }
+        if (sc.tech_stack && Object.keys(sc.tech_stack).length > 0) {
+            lines.push('## Tech Stack');
+            for (const [key, val] of Object.entries(sc.tech_stack)) {
+                lines.push(`- **${key}:** ${val}`);
+            }
+            lines.push('');
+        }
+    }
+    // Packages
+    if (ctx.dynamic_context.packages.length > 0) {
+        lines.push('## Packages');
+        for (const pkg of ctx.dynamic_context.packages) {
+            lines.push(`- **${pkg.name}:** ${pkg.purpose}`);
+        }
+        lines.push('');
+    }
+    // Item summary
+    const counts = ctx.dynamic_context.active_items;
+    lines.push('## Project Status');
+    lines.push(`Total items: ${counts.total}`);
+    if (counts.by_status) {
+        const statusParts = Object.entries(counts.by_status)
+            .filter(([, n]) => n > 0)
+            .map(([s, n]) => `${s}: ${n}`)
+            .join(', ');
+        if (statusParts)
+            lines.push(`By status: ${statusParts}`);
+    }
+    lines.push('');
+    // Recent updates
+    if (ctx.dynamic_context.recent_updates.length > 0) {
+        lines.push('## Recent Activity (last 7 days)');
+        for (const u of ctx.dynamic_context.recent_updates.slice(0, 5)) {
+            lines.push(`- [${u.id}] ${u.title} (${u.type}, updated ${u.updated.slice(0, 10)})`);
+        }
+        lines.push('');
+    }
+    // Staleness warning
+    if (ctx.context_meta?.is_stale) {
+        lines.push(`⚠️ Context may be stale (PROJECT.md is ${ctx.context_meta.project_md_age_hours.toFixed(1)}h old). Run \`devsteps context generate\` to refresh.`);
+        lines.push('');
+    }
+    // Conventions
+    lines.push('## DevSteps Conventions');
+    lines.push('- Never edit .devsteps/ directly — use MCP tools or CLI');
+    lines.push('- Item hierarchy: Epic → Story|Spike → Task|Bug');
+    lines.push('- Status flow: draft → planned → in-progress → review → done');
+    lines.push('- Git: `type(scope): subject` + footer `Implements: ID`');
+    return lines.join('\n');
+}
+/**
+ * Generate PROJECT.md content from live project state.
+ * Used by `devsteps context generate` CLI command.
+ * @see STORY-121 TASK-272
+ */
+export async function generateProjectMd(projectDir, devstepsDir) {
+    const [packages, counts, recentUpdates] = await Promise.all([
+        analyzePackages(projectDir),
+        getItemCounts(devstepsDir),
+        getRecentUpdates(devstepsDir, 14),
+    ]);
+    let projectName = path.basename(projectDir);
+    let methodology = 'scrum';
+    let projectDescription = '';
+    try {
+        const configRaw = await fs.readFile(path.join(devstepsDir, 'config.json'), 'utf-8');
+        const config = JSON.parse(configRaw);
+        projectName = config.project_name || projectName;
+        methodology = config.settings?.methodology || methodology;
+        projectDescription = config.description || '';
+    }
+    catch {
+        // config missing - use defaults
+    }
+    if (!projectDescription) {
+        try {
+            const readme = await fs.readFile(path.join(projectDir, 'README.md'), 'utf-8');
+            const firstPara = readme
+                .split('\n\n')
+                .find((p) => p.trim() && !p.startsWith('#') && !p.startsWith('<!--'));
+            projectDescription = firstPara?.trim().replace(/\n/g, ' ').slice(0, 300) || '';
+        }
+        catch {
+            // No README
+        }
+    }
+    // Check README.md age and regenerate if needed
+    const readmePath = path.join(projectDir, 'README.md');
+    try {
+        const readmeStats = await fs.stat(readmePath);
+        const ageInMs = Date.now() - readmeStats.mtimeMs;
+        const twoMonthsInMs = 60 * 24 * 60 * 60 * 1000;
+        if (ageInMs > twoMonthsInMs) {
+            // Regenerate README.md here (implementation depends on your regeneration logic)
+            // Example: await regenerateReadme(projectDir);
+        }
+    }
+    catch {
+        // No README to age-check
+    }
+    const techLines = [];
+    // BUG-185: the runtime is the project's own declared Node range, never a fixed number.
+    let nodeRange = '';
+    try {
+        const rootPkg = await fs.readFile(path.join(projectDir, 'package.json'), 'utf-8');
+        const root = JSON.parse(rootPkg);
+        if (typeof root.engines?.node === 'string')
+            nodeRange = root.engines.node.trim();
+        const allDeps = { ...root.dependencies, ...root.devDependencies };
+        const knownStack = [
+            [/@modelcontextprotocol\/sdk/, 'MCP SDK (@modelcontextprotocol/sdk)'],
+            [/\bzod\b/, 'Zod (schema validation)'],
+            [/\bcommander\b/, 'Commander (CLI framework)'],
+            [/\bchalk\b/, 'Chalk (terminal styling)'],
+            [/\bora\b/, 'Ora (spinners)'],
+            [/\bpino\b/, 'Pino (structured logging)'],
+            [/@prometheus-io\/client/, 'Prometheus client (metrics)'],
+            [/@biomejs\/biome/, 'Biome (lint + format)'],
+            [/\bvitest\b/, 'Vitest (unit testing)'],
+            [/\besbuild\b/, 'esbuild (bundler)'],
+            [/\btypescript\b/, 'TypeScript'],
+        ];
+        for (const [pattern, label] of knownStack) {
+            if (Object.keys(allDeps).some((k) => pattern.test(k))) {
+                techLines.push(`- ${label}`);
+            }
+        }
+    }
+    catch {
+        // No root package.json
+    }
+    const inProgressCount = counts.by_status['in-progress'] || 0;
+    const openCount = counts.total -
+        (counts.by_status.done || 0) -
+        (counts.by_status.cancelled || 0) -
+        (counts.by_status.obsolete || 0);
+    const lines = [];
+    lines.push(`# ${projectName}`);
+    lines.push('');
+    if (projectDescription) {
+        lines.push('## Description');
+        lines.push('');
+        lines.push(projectDescription);
+        lines.push('');
+    }
+    if (techLines.length > 0 || nodeRange) {
+        lines.push('## Tech Stack');
+        lines.push('');
+        if (nodeRange)
+            lines.push(`- **Runtime:** Node.js ${nodeRange}`);
+        lines.push(`- **Methodology:** ${methodology}`);
+        for (const t of techLines) {
+            lines.push(t);
+        }
+        lines.push('');
+    }
+    lines.push('## Project Type');
+    lines.push('');
+    lines.push(methodology.charAt(0).toUpperCase() + methodology.slice(1));
+    lines.push('');
+    if (packages.length > 0) {
+        lines.push('## Package Structure');
+        lines.push('');
+        for (const pkg of packages) {
+            lines.push(`- **${pkg.name}:** ${pkg.purpose}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Status');
+    lines.push('');
+    lines.push(`Total items: ${counts.total} | Open: ${openCount} | In-progress: ${inProgressCount}`);
+    if (counts.by_type) {
+        const typeSummary = Object.entries(counts.by_type)
+            .filter(([, n]) => n > 0)
+            .map(([t, n]) => `${t}: ${n}`)
+            .join(', ');
+        if (typeSummary)
+            lines.push(`By type: ${typeSummary}`);
+    }
+    lines.push('');
+    if (recentUpdates.length > 0) {
+        lines.push('## Active Work');
+        lines.push('');
+        for (const u of recentUpdates.slice(0, 10)) {
+            lines.push(`- [${u.id}] ${u.title} (${u.type})`);
+        }
+        lines.push('');
+    }
+    lines.push('## Conventions');
+    lines.push('');
+    lines.push('- **WorkDir:** `.devsteps/` -- managed by DevSteps tools only');
+    lines.push('- **Hierarchy:** Epic -> Story|Spike -> Task|Bug');
+    lines.push('- **Status flow:** draft -> planned -> in-progress -> review -> done');
+    lines.push('- **Commits:** `type(scope): subject` + footer `Implements: ID`');
+    lines.push('- **Quality:** Build + tests must pass before marking done');
+    lines.push('');
+    lines.push(`_Generated by \`devsteps context generate\` at ${new Date().toISOString()}_`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=context-render.js.map

package/dist/core/context-render.js.map

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

package/dist/core/context.d.ts

@@ -3,28 +3,19 @@
  * Licensed under the Apache License, Version 2.0
  *
  * Context generation for AI-assisted development
- * Builds structured project context at quick/standard/deep levels.
+ * Builds structured project context at quick/standard levels. Item-derived data
+ * lives in `context-items.ts`, text rendering in `context-render.ts`.
  *
  * @see STORY-085 Context Command
  * @see STORY-121 Layered AI Context Auto-Delivery
  */
 import type { ContextLevel, QuickContext } from '../schemas/project.js';
-interface PackageInfo {
+import { type ItemCounts, type RecentUpdate } from './context-items.js';
+export interface PackageInfo {
     name: string;
     purpose: string;
     dependencies: string[];
 }
-interface ItemCounts {
-    total: number;
-    by_type: Record<string, number>;
-    by_status: Record<string, number>;
-}
-interface RecentUpdate {
-    id: string;
-    type: string;
-    title: string;
-    updated: string;
-}
 /**
  * Metadata about the freshness and origin of a context response.
  * Included in all context responses (quick, standard, deep).
@@ -42,7 +33,7 @@ export interface ContextMeta {
     /** Whether this response was served from in-memory cache */
     cache_hit: boolean;
 }
-interface ContextResponse {
+export interface ContextResponse {
     context_level: ContextLevel;
     tokens_used: number;
     static_context?: unknown;
@@ -58,14 +49,6 @@ interface ContextResponse {
  * Analyze packages from workspace (with caching)
  */
 export declare function analyzePackages(projectDir: string): Promise<PackageInfo[]>;
-/**
- * Get item counts from index (with caching)
- */
-export declare function getItemCounts(devstepsDir: string): Promise<ItemCounts>;
-/**
- * Get recent updates (last N days) (with caching)
- */
-export declare function getRecentUpdates(devstepsDir: string, days: number): Promise<RecentUpdate[]>;
 /**
  * Read PROJECT.md if exists (with caching)
  */
@@ -91,17 +74,4 @@ export declare function buildContextMeta(devstepsDir: string, level: ContextLeve
  * @see STORY-121 TASK-273
  */
 export declare function getStandardContext(projectDir: string, devstepsDir: string): Promise<ContextResponse>;
-/**
- * Format a ContextResponse as readable plain text for embedding in AI prompts
- * (used by MCP resource devsteps://project-context).
- * @see STORY-121 TASK-275
- */
-export declare function formatContextAsText(ctx: ContextResponse): string;
-/**
- * Generate PROJECT.md content from live project state.
- * Used by `devsteps context generate` CLI command.
- * @see STORY-121 TASK-272
- */
-export declare function generateProjectMd(projectDir: string, devstepsDir: string): Promise<string>;
-export {};
 //# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGxE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE;QACf,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,YAAY,EAAE,UAAU,CAAC;QACzB,cAAc,EAAE,YAAY,EAAE,CAAC;KAChC,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAcD;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyChF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmC5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAwCjG;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkDrF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AACD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAmDD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAwD1B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAoEhE;AACD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAwIjB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE;QACf,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,YAAY,EAAE,UAAU,CAAC;QACzB,cAAc,EAAE,YAAY,EAAE,CAAC;KAChC,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyChF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkDrF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAuC1B;AACD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA8D1B"}