claude-code-workflow 6.1.3 → 6.2.1

package/dist/tools/write-file.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,11 @@
+export interface ServerConfig {
+    port: number;
+    host: string;
+    open: boolean;
+}
+export interface McpConfig {
+    enabledTools: string[] | null;
+    serverName: string;
+    serverVersion: string;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tool.js';
+export * from './session.js';
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+export * from './tool.js';
+export * from './session.js';
+export * from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/session.d.ts

@@ -0,0 +1,20 @@
+export type SessionStatus = 'active' | 'paused' | 'completed' | 'archived';
+export type SessionType = 'workflow' | 'review' | 'tdd' | 'test' | 'docs' | 'lite-plan' | 'lite-fix';
+export type ContentType = 'session' | 'plan' | 'task' | 'summary' | 'process' | 'chat' | 'brainstorm' | 'review-dim' | 'review-iter' | 'review-fix' | 'todo' | 'context';
+export interface SessionMetadata {
+    id: string;
+    type: SessionType;
+    status: SessionStatus;
+    description?: string;
+    project?: string;
+    created: string;
+    updated: string;
+}
+export interface SessionOperationResult {
+    success: boolean;
+    sessionId?: string;
+    path?: string;
+    data?: unknown;
+    error?: string;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AACrG,MAAM,MAAM,WAAW,GACnB,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GACvC,SAAS,GAAG,MAAM,GAAG,YAAY,GACjC,YAAY,GAAG,aAAa,GAAG,YAAY,GAC3C,MAAM,GAAG,SAAS,CAAC;AAEvB,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":""}

package/dist/types/tool.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export declare const ToolParamSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        array: "array";
+    }>;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodAny>;
+    enum: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ToolParam = z.infer<typeof ToolParamSchema>;
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ToolResult<T = unknown> {
+    success: boolean;
+    result?: T;
+    error?: string;
+}
+export type ToolHandler<TParams = Record<string, unknown>, TResult = unknown> = (params: TParams) => Promise<ToolResult<TResult>>;
+export interface ToolRegistration<TParams = Record<string, unknown>> {
+    schema: ToolSchema;
+    handler: ToolHandler<TParams>;
+}
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAO1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAGxD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAGD,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,IAC1E,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAGpD,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC/B"}

package/dist/types/tool.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+// Tool parameter schema for Zod validation
+export const ToolParamSchema = z.object({
+    name: z.string(),
+    type: z.enum(['string', 'number', 'boolean', 'object', 'array']),
+    description: z.string(),
+    required: z.boolean().default(false),
+    default: z.any().optional(),
+    enum: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=tool.js.map

package/dist/types/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/types/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/dist/utils/browser-launcher.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Launch a URL or file in the default browser
+ * Cross-platform compatible (Windows/macOS/Linux)
+ * @param urlOrPath - HTTP URL or path to HTML file
+ * @returns Promise that resolves when browser is launched
+ */
+export declare function launchBrowser(urlOrPath: string): Promise<void>;
+/**
+ * Check if we're running in a headless/CI environment
+ * @returns True if running in headless environment
+ */
+export declare function isHeadlessEnvironment(): boolean;
+//# sourceMappingURL=browser-launcher.d.ts.map

package/dist/utils/browser-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../src/utils/browser-launcher.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCpE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAQ/C"}

package/dist/utils/browser-launcher.js

@@ -0,0 +1,60 @@
+import open from 'open';
+import { platform } from 'os';
+import { resolve } from 'path';
+/**
+ * Launch a URL or file in the default browser
+ * Cross-platform compatible (Windows/macOS/Linux)
+ * @param urlOrPath - HTTP URL or path to HTML file
+ * @returns Promise that resolves when browser is launched
+ */
+export async function launchBrowser(urlOrPath) {
+    // Check if it's already a URL (http:// or https://)
+    if (urlOrPath.startsWith('http://') || urlOrPath.startsWith('https://')) {
+        try {
+            await open(urlOrPath);
+            return;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to open browser: ${message}`);
+        }
+    }
+    // It's a file path - convert to file:// URL
+    const absolutePath = resolve(urlOrPath);
+    // Construct file:// URL based on platform
+    let url;
+    if (platform() === 'win32') {
+        // Windows: file:///C:/path/to/file.html
+        url = `file:///${absolutePath.replace(/\\/g, '/')}`;
+    }
+    else {
+        // Unix: file:///path/to/file.html
+        url = `file://${absolutePath}`;
+    }
+    try {
+        // Use the 'open' package which handles cross-platform browser launching
+        await open(url);
+    }
+    catch (error) {
+        // Fallback: try opening the file path directly
+        try {
+            await open(absolutePath);
+        }
+        catch (fallbackError) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to open browser: ${message}`);
+        }
+    }
+}
+/**
+ * Check if we're running in a headless/CI environment
+ * @returns True if running in headless environment
+ */
+export function isHeadlessEnvironment() {
+    return !!(process.env.CI ||
+        process.env.CONTINUOUS_INTEGRATION ||
+        process.env.GITHUB_ACTIONS ||
+        process.env.GITLAB_CI ||
+        process.env.JENKINS_URL);
+}
+//# sourceMappingURL=browser-launcher.js.map

package/dist/utils/browser-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-launcher.js","sourceRoot":"","sources":["../../src/utils/browser-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,oDAAoD;IACpD,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAExC,0CAA0C;IAC1C,IAAI,GAAW,CAAC;IAChB,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC3B,wCAAwC;QACxC,GAAG,GAAG,WAAW,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,kCAAkC;QAClC,GAAG,GAAG,UAAU,YAAY,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,CAAC;QACH,wEAAwE;QACxE,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,aAAa,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,CAAC,CACP,OAAO,CAAC,GAAG,CAAC,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAClC,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,OAAO,CAAC,GAAG,CAAC,SAAS;QACrB,OAAO,CAAC,GAAG,CAAC,WAAW,CACxB,CAAC;AACJ,CAAC"}

package/dist/utils/file-utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Safely read a JSON file
+ * @param filePath - Path to JSON file
+ * @returns Parsed JSON or null on error
+ */
+export declare function readJsonFile(filePath: string): unknown | null;
+/**
+ * Safely read a text file
+ * @param filePath - Path to text file
+ * @returns File contents or null on error
+ */
+export declare function readTextFile(filePath: string): string | null;
+/**
+ * Write content to a file
+ * @param filePath - Path to file
+ * @param content - Content to write
+ */
+export declare function writeTextFile(filePath: string, content: string): void;
+/**
+ * Check if a path exists
+ * @param filePath - Path to check
+ * @returns True if path exists
+ */
+export declare function pathExists(filePath: string): boolean;
+//# sourceMappingURL=file-utils.d.ts.map

package/dist/utils/file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAO7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/utils/file-utils.js

@@ -0,0 +1,48 @@
+import { readFileSync, existsSync, writeFileSync } from 'fs';
+/**
+ * Safely read a JSON file
+ * @param filePath - Path to JSON file
+ * @returns Parsed JSON or null on error
+ */
+export function readJsonFile(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Safely read a text file
+ * @param filePath - Path to text file
+ * @returns File contents or null on error
+ */
+export function readTextFile(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write content to a file
+ * @param filePath - Path to file
+ * @param content - Content to write
+ */
+export function writeTextFile(filePath, content) {
+    writeFileSync(filePath, content, 'utf8');
+}
+/**
+ * Check if a path exists
+ * @param filePath - Path to check
+ * @returns True if path exists
+ */
+export function pathExists(filePath) {
+    return existsSync(filePath);
+}
+//# sourceMappingURL=file-utils.js.map

package/dist/utils/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../src/utils/file-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAG7D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/path-resolver.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Validation result for path operations
+ */
+export interface PathValidationResult {
+    valid: boolean;
+    path: string | null;
+    error: string | null;
+}
+/**
+ * Options for path validation
+ */
+export interface ValidatePathOptions {
+    baseDir?: string | null;
+    mustExist?: boolean;
+    allowHome?: boolean;
+}
+/**
+ * Resolve a path, handling ~ for home directory
+ * @param inputPath - Path to resolve
+ * @returns Absolute path
+ */
+export declare function resolvePath(inputPath: string): string;
+/**
+ * Validate and sanitize a user-provided path
+ * Prevents path traversal attacks and validates path is within allowed boundaries
+ * @param inputPath - User-provided path
+ * @param options - Validation options
+ * @returns Validation result with path or error
+ */
+export declare function validatePath(inputPath: string, options?: ValidatePathOptions): PathValidationResult;
+/**
+ * Validate output file path for writing
+ * @param outputPath - Output file path
+ * @param defaultDir - Default directory if path is relative
+ * @returns Validation result with path or error
+ */
+export declare function validateOutputPath(outputPath: string, defaultDir?: string): PathValidationResult;
+/**
+ * Get potential template locations
+ * @returns Array of existing template directories
+ */
+export declare function getTemplateLocations(): string[];
+/**
+ * Find a template file in known locations
+ * @param templateName - Name of template file (e.g., 'workflow-dashboard.html')
+ * @returns Path to template or null if not found
+ */
+export declare function findTemplate(templateName: string): string | null;
+/**
+ * Ensure directory exists, creating if necessary
+ * @param dirPath - Directory path to ensure
+ */
+export declare function ensureDir(dirPath: string): void;
+/**
+ * Normalize path for display (handle Windows backslashes)
+ * @param filePath - Path to normalize
+ * @returns Normalized path with forward slashes
+ */
+export declare function normalizePathForDisplay(filePath: string): string;
+/**
+ * Get recent project paths
+ * @returns Array of recent paths
+ */
+export declare function getRecentPaths(): string[];
+/**
+ * Track a project path (add to recent paths)
+ * @param projectPath - Path to track
+ */
+export declare function trackRecentPath(projectPath: string): void;
+/**
+ * Clear recent paths
+ */
+export declare function clearRecentPaths(): void;
+/**
+ * Remove a specific path from recent paths
+ * @param pathToRemove - Path to remove
+ * @returns True if removed, false if not found
+ */
+export declare function removeRecentPath(pathToRemove: string): boolean;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/utils/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/path-resolver.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,oBAAoB,CAiEvG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAsB,GAAG,oBAAoB,CAmC/G;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAO/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWhE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AA2BD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAYzC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAqBzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAoB9D"}

package/dist/utils/path-resolver.js

@@ -0,0 +1,260 @@
+import { resolve, join, relative, isAbsolute } from 'path';
+import { existsSync, mkdirSync, realpathSync, statSync, readFileSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
+import { StoragePaths, ensureStorageDir, LegacyPaths } from '../config/storage-paths.js';
+/**
+ * Resolve a path, handling ~ for home directory
+ * @param inputPath - Path to resolve
+ * @returns Absolute path
+ */
+export function resolvePath(inputPath) {
+    if (!inputPath)
+        return process.cwd();
+    // Handle ~ for home directory
+    if (inputPath.startsWith('~')) {
+        return join(homedir(), inputPath.slice(1));
+    }
+    return resolve(inputPath);
+}
+/**
+ * Validate and sanitize a user-provided path
+ * Prevents path traversal attacks and validates path is within allowed boundaries
+ * @param inputPath - User-provided path
+ * @param options - Validation options
+ * @returns Validation result with path or error
+ */
+export function validatePath(inputPath, options = {}) {
+    const { baseDir = null, mustExist = false, allowHome = true } = options;
+    // Check for empty/null input
+    if (!inputPath || typeof inputPath !== 'string') {
+        return { valid: false, path: null, error: 'Path is required' };
+    }
+    // Trim whitespace
+    const trimmedPath = inputPath.trim();
+    // Check for suspicious patterns (null bytes, control characters)
+    if (/[\x00-\x1f]/.test(trimmedPath)) {
+        return { valid: false, path: null, error: 'Path contains invalid characters' };
+    }
+    // Resolve the path
+    let resolvedPath;
+    try {
+        resolvedPath = resolvePath(trimmedPath);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { valid: false, path: null, error: `Invalid path: ${message}` };
+    }
+    // Check if path exists when required
+    if (mustExist && !existsSync(resolvedPath)) {
+        return { valid: false, path: null, error: `Path does not exist: ${resolvedPath}` };
+    }
+    // Get real path if it exists (resolves symlinks)
+    let realPath = resolvedPath;
+    if (existsSync(resolvedPath)) {
+        try {
+            realPath = realpathSync(resolvedPath);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { valid: false, path: null, error: `Cannot resolve path: ${message}` };
+        }
+    }
+    // Check if within base directory when specified
+    if (baseDir) {
+        const resolvedBase = resolvePath(baseDir);
+        const relativePath = relative(resolvedBase, realPath);
+        // Path traversal detection: relative path should not start with '..'
+        if (relativePath.startsWith('..') || isAbsolute(relativePath)) {
+            return {
+                valid: false,
+                path: null,
+                error: `Path must be within ${resolvedBase}`
+            };
+        }
+    }
+    // Check home directory restriction
+    if (!allowHome) {
+        const home = homedir();
+        if (realPath === home || realPath.startsWith(home + '/') || realPath.startsWith(home + '\\')) {
+            // This is fine, we're just checking if it's explicitly the home dir itself
+        }
+    }
+    return { valid: true, path: realPath, error: null };
+}
+/**
+ * Validate output file path for writing
+ * @param outputPath - Output file path
+ * @param defaultDir - Default directory if path is relative
+ * @returns Validation result with path or error
+ */
+export function validateOutputPath(outputPath, defaultDir = process.cwd()) {
+    if (!outputPath || typeof outputPath !== 'string') {
+        return { valid: false, path: null, error: 'Output path is required' };
+    }
+    const trimmedPath = outputPath.trim();
+    // Check for suspicious patterns
+    if (/[\x00-\x1f]/.test(trimmedPath)) {
+        return { valid: false, path: null, error: 'Output path contains invalid characters' };
+    }
+    // Resolve the path
+    let resolvedPath;
+    try {
+        resolvedPath = isAbsolute(trimmedPath) ? trimmedPath : join(defaultDir, trimmedPath);
+        resolvedPath = resolve(resolvedPath);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { valid: false, path: null, error: `Invalid output path: ${message}` };
+    }
+    // Ensure it's not a directory
+    if (existsSync(resolvedPath)) {
+        try {
+            const stat = statSync(resolvedPath);
+            if (stat.isDirectory()) {
+                return { valid: false, path: null, error: 'Output path is a directory, expected a file' };
+            }
+        }
+        catch {
+            // Ignore stat errors
+        }
+    }
+    return { valid: true, path: resolvedPath, error: null };
+}
+/**
+ * Get potential template locations
+ * @returns Array of existing template directories
+ */
+export function getTemplateLocations() {
+    const locations = [
+        join(homedir(), '.claude', 'templates'),
+        join(process.cwd(), '.claude', 'templates')
+    ];
+    return locations.filter(loc => existsSync(loc));
+}
+/**
+ * Find a template file in known locations
+ * @param templateName - Name of template file (e.g., 'workflow-dashboard.html')
+ * @returns Path to template or null if not found
+ */
+export function findTemplate(templateName) {
+    const locations = getTemplateLocations();
+    for (const loc of locations) {
+        const templatePath = join(loc, templateName);
+        if (existsSync(templatePath)) {
+            return templatePath;
+        }
+    }
+    return null;
+}
+/**
+ * Ensure directory exists, creating if necessary
+ * @param dirPath - Directory path to ensure
+ */
+export function ensureDir(dirPath) {
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Normalize path for display (handle Windows backslashes)
+ * @param filePath - Path to normalize
+ * @returns Normalized path with forward slashes
+ */
+export function normalizePathForDisplay(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+// Recent paths storage - uses centralized storage with backward compatibility
+const MAX_RECENT_PATHS = 10;
+/**
+ * Get the recent paths file location
+ * Uses new location but falls back to legacy location for backward compatibility
+ */
+function getRecentPathsFile() {
+    const newPath = StoragePaths.global.recentPaths();
+    const legacyPath = LegacyPaths.recentPaths();
+    // Backward compatibility: use legacy if it exists and new doesn't
+    if (!existsSync(newPath) && existsSync(legacyPath)) {
+        return legacyPath;
+    }
+    return newPath;
+}
+/**
+ * Get recent project paths
+ * @returns Array of recent paths
+ */
+export function getRecentPaths() {
+    try {
+        const recentPathsFile = getRecentPathsFile();
+        if (existsSync(recentPathsFile)) {
+            const content = readFileSync(recentPathsFile, 'utf8');
+            const data = JSON.parse(content);
+            return Array.isArray(data.paths) ? data.paths : [];
+        }
+    }
+    catch {
+        // Ignore errors, return empty array
+    }
+    return [];
+}
+/**
+ * Track a project path (add to recent paths)
+ * @param projectPath - Path to track
+ */
+export function trackRecentPath(projectPath) {
+    try {
+        const normalized = normalizePathForDisplay(resolvePath(projectPath));
+        let paths = getRecentPaths();
+        // Remove if already exists (will be added to front)
+        paths = paths.filter(p => normalizePathForDisplay(p) !== normalized);
+        // Add to front
+        paths.unshift(normalized);
+        // Limit to max
+        paths = paths.slice(0, MAX_RECENT_PATHS);
+        // Save to new centralized location
+        const recentPathsFile = StoragePaths.global.recentPaths();
+        ensureStorageDir(StoragePaths.global.config());
+        writeFileSync(recentPathsFile, JSON.stringify({ paths }, null, 2), 'utf8');
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Clear recent paths
+ */
+export function clearRecentPaths() {
+    try {
+        const recentPathsFile = StoragePaths.global.recentPaths();
+        ensureStorageDir(StoragePaths.global.config());
+        writeFileSync(recentPathsFile, JSON.stringify({ paths: [] }, null, 2), 'utf8');
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Remove a specific path from recent paths
+ * @param pathToRemove - Path to remove
+ * @returns True if removed, false if not found
+ */
+export function removeRecentPath(pathToRemove) {
+    try {
+        const normalized = normalizePathForDisplay(resolvePath(pathToRemove));
+        let paths = getRecentPaths();
+        const originalLength = paths.length;
+        // Filter out the path to remove
+        paths = paths.filter(p => normalizePathForDisplay(p) !== normalized);
+        if (paths.length < originalLength) {
+            // Save updated list to new centralized location
+            const recentPathsFile = StoragePaths.global.recentPaths();
+            ensureStorageDir(StoragePaths.global.config());
+            writeFileSync(recentPathsFile, JSON.stringify({ paths }, null, 2), 'utf8');
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=path-resolver.js.map