@schnick371/devsteps-shared 0.0.1 → 0.5.0

package/dist/utils/cache.d.ts

@@ -0,0 +1,80 @@
+export interface CacheStats {
+    size: number;
+    keys: string[];
+    hits: number;
+    misses: number;
+    hitRate: number;
+}
+/**
+ * Cache configuration
+ */
+export declare const CACHE_CONFIG: {
+    PROJECT_MD_TTL: number;
+    PACKAGE_ANALYSIS_TTL: number;
+    ITEM_COUNTS_TTL: number;
+    RECENT_UPDATES_TTL: number;
+    MAX_CACHE_SIZE: number;
+};
+/**
+ * Smart context cache with TTL and file-based invalidation
+ */
+export declare class ContextCache {
+    private cache;
+    private hits;
+    private misses;
+    /**
+     * Get cached value
+     * @param key Cache key
+     * @param maxAge Maximum age in milliseconds
+     * @param filePath Optional file path for mtime-based invalidation
+     * @returns Cached value or null if invalid/expired
+     */
+    get<T>(key: string, maxAge: number, filePath?: string): T | null;
+    /**
+     * Set cached value
+     * @param key Cache key
+     * @param data Data to cache
+     * @param filePath Optional file path for mtime tracking
+     */
+    set<T>(key: string, data: T, filePath?: string): void;
+    /**
+     * Check if key exists and is valid
+     * @param key Cache key
+     * @param maxAge Maximum age in milliseconds
+     * @param filePath Optional file path for mtime-based invalidation
+     * @returns true if valid cached value exists
+     */
+    has(key: string, maxAge: number, filePath?: string): boolean;
+    /**
+     * Clear entire cache
+     */
+    clear(): void;
+    /**
+     * Clear specific cache key
+     * @param key Cache key to clear
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear cache entries matching pattern
+     * @param pattern Regex pattern to match keys
+     */
+    clearPattern(pattern: RegExp): number;
+    /**
+     * Get cache statistics
+     * @returns Cache statistics including hit rate
+     */
+    stats(): CacheStats;
+    /**
+     * Reset hit/miss counters
+     */
+    resetStats(): void;
+}
+/**
+ * Get or create global cache instance
+ */
+export declare function getCache(): ContextCache;
+/**
+ * Clear global cache
+ */
+export declare function clearGlobalCache(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;CAMxB,CAAC;AAEF;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAoChE;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IA0BrD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAI5D;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWrC;;;OAGG;IACH,KAAK,IAAI,UAAU;IAanB;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB;AAKD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,YAAY,CAKvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC"}

package/dist/utils/cache.js

@@ -0,0 +1,169 @@
+import { statSync } from 'node:fs';
+/**
+ * Cache configuration
+ */
+export const CACHE_CONFIG = {
+    PROJECT_MD_TTL: 60 * 60 * 1000, // 1 hour
+    PACKAGE_ANALYSIS_TTL: 30 * 60 * 1000, // 30 minutes
+    ITEM_COUNTS_TTL: 5 * 60 * 1000, // 5 minutes
+    RECENT_UPDATES_TTL: 1 * 60 * 1000, // 1 minute
+    MAX_CACHE_SIZE: 1000, // Maximum number of cache entries
+};
+/**
+ * Smart context cache with TTL and file-based invalidation
+ */
+export class ContextCache {
+    cache = new Map();
+    hits = 0;
+    misses = 0;
+    /**
+     * Get cached value
+     * @param key Cache key
+     * @param maxAge Maximum age in milliseconds
+     * @param filePath Optional file path for mtime-based invalidation
+     * @returns Cached value or null if invalid/expired
+     */
+    get(key, maxAge, filePath) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return null;
+        }
+        // Check file modification time
+        if (filePath && entry.mtime !== undefined) {
+            try {
+                const currentMtime = statSync(filePath).mtimeMs;
+                if (currentMtime > entry.mtime) {
+                    this.cache.delete(key);
+                    this.misses++;
+                    return null;
+                }
+            }
+            catch {
+                // File doesn't exist anymore, invalidate cache
+                this.cache.delete(key);
+                this.misses++;
+                return null;
+            }
+        }
+        // Check TTL
+        if (Date.now() - entry.timestamp > maxAge) {
+            this.cache.delete(key);
+            this.misses++;
+            return null;
+        }
+        this.hits++;
+        return entry.data;
+    }
+    /**
+     * Set cached value
+     * @param key Cache key
+     * @param data Data to cache
+     * @param filePath Optional file path for mtime tracking
+     */
+    set(key, data, filePath) {
+        // Enforce max cache size (simple LRU: remove oldest)
+        if (this.cache.size >= CACHE_CONFIG.MAX_CACHE_SIZE) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+        let mtime;
+        if (filePath) {
+            try {
+                mtime = statSync(filePath).mtimeMs;
+            }
+            catch {
+                // File doesn't exist, don't track mtime
+                mtime = undefined;
+            }
+        }
+        this.cache.set(key, {
+            data,
+            timestamp: Date.now(),
+            mtime,
+        });
+    }
+    /**
+     * Check if key exists and is valid
+     * @param key Cache key
+     * @param maxAge Maximum age in milliseconds
+     * @param filePath Optional file path for mtime-based invalidation
+     * @returns true if valid cached value exists
+     */
+    has(key, maxAge, filePath) {
+        return this.get(key, maxAge, filePath) !== null;
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Clear specific cache key
+     * @param key Cache key to clear
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear cache entries matching pattern
+     * @param pattern Regex pattern to match keys
+     */
+    clearPattern(pattern) {
+        let cleared = 0;
+        for (const key of this.cache.keys()) {
+            if (pattern.test(key)) {
+                this.cache.delete(key);
+                cleared++;
+            }
+        }
+        return cleared;
+    }
+    /**
+     * Get cache statistics
+     * @returns Cache statistics including hit rate
+     */
+    stats() {
+        const total = this.hits + this.misses;
+        const hitRate = total > 0 ? this.hits / total : 0;
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys()),
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: Math.round(hitRate * 100) / 100,
+        };
+    }
+    /**
+     * Reset hit/miss counters
+     */
+    resetStats() {
+        this.hits = 0;
+        this.misses = 0;
+    }
+}
+// Global singleton instance
+let globalCache = null;
+/**
+ * Get or create global cache instance
+ */
+export function getCache() {
+    if (!globalCache) {
+        globalCache = new ContextCache();
+    }
+    return globalCache;
+}
+/**
+ * Clear global cache
+ */
+export function clearGlobalCache() {
+    if (globalCache) {
+        globalCache.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,72 @@
+import type { ItemType, Methodology } from '../schemas/index.js';
+export { ContextCache, CACHE_CONFIG, getCache, clearGlobalCache, type CacheStats, } from './cache.js';
+/**
+ * Type to plural directory mapping
+ */
+export declare const TYPE_TO_DIRECTORY: Record<ItemType, string>;
+/**
+ * Get methodology configuration
+ */
+export declare function getMethodologyConfig(methodology: Methodology): {
+    item_types: ItemType[];
+    item_prefixes: {
+        epic: string;
+        story: string;
+        task: string;
+        bug: string;
+        spike: string;
+        test: string;
+    };
+    directories: string[];
+} | {
+    item_types: ItemType[];
+    item_prefixes: {
+        requirement: string;
+        feature: string;
+        task: string;
+        bug: string;
+        test: string;
+    };
+    directories: string[];
+} | {
+    item_types: ItemType[];
+    item_prefixes: {
+        epic: string;
+        story: string;
+        requirement: string;
+        feature: string;
+        task: string;
+        bug: string;
+        spike: string;
+        test: string;
+    };
+    directories: string[];
+};
+/**
+ * Generates a new item ID with proper prefix and number
+ */
+export declare function generateItemId(type: string, counter: number, prefixes?: Record<string, string>): string;
+/**
+ * Parses an item ID into type and number
+ */
+export declare function parseItemId(id: string): {
+    type: ItemType;
+    number: number;
+} | null;
+/**
+ * Formats a date for display
+ */
+export declare function formatDate(date: string | Date): string;
+/**
+ * Gets current timestamp in ISO format
+ */
+export declare function getCurrentTimestamp(): string;
+/**
+ * Validates email format
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Sanitizes a string for use in filenames
+ */
+export declare function sanitizeFilename(name: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAStD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW;gBAGU,QAAQ,EAAE;;;;;;;;;;;gBAYV,QAAQ,EAAE;;;;;;;;;;gBAoBtE,QAAQ,EAAE;;;;;;;;;;;;EAyBpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAmBjF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/utils/index.js

@@ -0,0 +1,148 @@
+// Export cache utilities
+export { ContextCache, CACHE_CONFIG, getCache, clearGlobalCache, } from './cache.js';
+/**
+ * Type to plural directory mapping
+ */
+export const TYPE_TO_DIRECTORY = {
+    epic: 'epics',
+    story: 'stories',
+    task: 'tasks',
+    requirement: 'requirements',
+    feature: 'features',
+    bug: 'bugs',
+    spike: 'spikes',
+    test: 'tests',
+};
+/**
+ * Get methodology configuration
+ */
+export function getMethodologyConfig(methodology) {
+    const configs = {
+        scrum: {
+            item_types: ['epic', 'story', 'task', 'bug', 'spike', 'test'],
+            item_prefixes: {
+                epic: 'EPIC',
+                story: 'STORY',
+                task: 'TASK',
+                bug: 'BUG',
+                spike: 'SPIKE',
+                test: 'TEST',
+            },
+            directories: ['epics', 'stories', 'tasks', 'bugs', 'spikes', 'tests'],
+        },
+        waterfall: {
+            item_types: ['requirement', 'feature', 'task', 'bug', 'test'],
+            item_prefixes: {
+                requirement: 'REQ',
+                feature: 'FEAT',
+                task: 'TASK',
+                bug: 'BUG',
+                test: 'TEST',
+            },
+            directories: ['requirements', 'features', 'tasks', 'bugs', 'tests'],
+        },
+        hybrid: {
+            item_types: [
+                'epic',
+                'story',
+                'requirement',
+                'feature',
+                'task',
+                'bug',
+                'spike',
+                'test',
+            ],
+            item_prefixes: {
+                epic: 'EPIC',
+                story: 'STORY',
+                requirement: 'REQ',
+                feature: 'FEAT',
+                task: 'TASK',
+                bug: 'BUG',
+                spike: 'SPIKE',
+                test: 'TEST',
+            },
+            directories: [
+                'epics',
+                'stories',
+                'requirements',
+                'features',
+                'tasks',
+                'bugs',
+                'spikes',
+                'tests',
+            ],
+        },
+    };
+    return configs[methodology];
+}
+/**
+ * Generates a new item ID with proper prefix and number
+ */
+export function generateItemId(type, counter, prefixes) {
+    const defaultPrefixes = {
+        epic: 'EPIC',
+        story: 'STORY',
+        task: 'TASK',
+        requirement: 'REQ',
+        feature: 'FEAT',
+        bug: 'BUG',
+        spike: 'SPIKE',
+        test: 'TEST',
+    };
+    const prefixMap = prefixes || defaultPrefixes;
+    const prefix = prefixMap[type] || 'ITEM';
+    const paddedNumber = counter.toString().padStart(3, '0');
+    return `${prefix}-${paddedNumber}`;
+}
+/**
+ * Parses an item ID into type and number
+ */
+export function parseItemId(id) {
+    const match = id.match(/^(EPIC|STORY|TASK|REQ|FEAT|BUG|SPIKE|TEST)-(\d+)$/);
+    if (!match)
+        return null;
+    const typeMap = {
+        EPIC: 'epic',
+        STORY: 'story',
+        TASK: 'task',
+        REQ: 'requirement',
+        FEAT: 'feature',
+        BUG: 'bug',
+        SPIKE: 'spike',
+        TEST: 'test',
+    };
+    return {
+        type: typeMap[match[1]],
+        number: Number.parseInt(match[2], 10),
+    };
+}
+/**
+ * Formats a date for display
+ */
+export function formatDate(date) {
+    const d = typeof date === 'string' ? new Date(date) : date;
+    return d.toISOString();
+}
+/**
+ * Gets current timestamp in ISO format
+ */
+export function getCurrentTimestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Validates email format
+ */
+export function isValidEmail(email) {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+}
+/**
+ * Sanitizes a string for use in filenames
+ */
+export function sanitizeFilename(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/package.json

@@ -1,18 +1,9 @@
 {
   "name": "@schnick371/devsteps-shared",
-  "version": "0.0.1",
-  "description": "Reserved for DevSteps project - Never Code Alone. Shared types, schemas, and utilities for AI-assisted developer task tracking.",
-  "keywords": [
-    "devsteps",
-    "task-tracking",
-    "project-management",
-    "agile",
-    "scrum",
-    "waterfall",
-    "ai-assisted",
-    "development-workflow"
-  ],
-  "author": "Thomas Hertel <thomas.hantke@devcrumbs.dev>",
+  "version": "0.5.0",
+  "license": "Apache-2.0",
+  "description": "Never Code Alone. Shared types, schemas, and utilities for DevSteps task tracking.",
+  "author": "Thomas Hertel <thomas.hantke@devsteps.dev>",
   "homepage": "https://devsteps.dev",
   "repository": {
     "type": "git",
@@ -22,9 +13,51 @@
   "bugs": {
     "url": "https://github.com/Schnick371/devsteps/issues"
   },
-  "license": "Apache-2.0",
+  "keywords": [
+    "devsteps",
+    "task-tracking",
+    "project-management",
+    "agile",
+    "scrum",
+    "waterfall"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "default": "./dist/schemas/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE.md"
+  ],
   "publishConfig": {
     "access": "public"
   },
-  "main": "index.js"
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "zod": "latest"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "latest"
+  }
 }

package/src/core/add.js.map

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