@ginkoai/cli 1.0.0

package/dist/core/adapters/path-adapter.js

@@ -0,0 +1,245 @@
+/**
+ * @fileType: adapter
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [platform, paths, cross-platform, os-detection]
+ * @related: [path-config.ts, platform-adapter.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [path, os]
+ */
+import path from 'path';
+import os from 'os';
+export class PathAdapter {
+    platform;
+    platformPaths;
+    constructor() {
+        this.platform = this.detectPlatform();
+        this.platformPaths = this.getPlatformPaths();
+    }
+    /**
+     * Detect current platform
+     */
+    detectPlatform() {
+        const platform = os.platform();
+        switch (platform) {
+            case 'win32':
+                return 'windows';
+            case 'darwin':
+                return 'macos';
+            default:
+                return 'linux';
+        }
+    }
+    /**
+     * Get platform-specific paths
+     */
+    getPlatformPaths() {
+        const homeDir = os.homedir();
+        switch (this.platform) {
+            case 'windows':
+                return {
+                    home: homeDir,
+                    config: path.join(homeDir, 'AppData', 'Roaming'),
+                    cache: path.join(homeDir, 'AppData', 'Local'),
+                    temp: os.tmpdir(),
+                    separator: '\\',
+                    pathSeparator: ';'
+                };
+            case 'macos':
+                return {
+                    home: homeDir,
+                    config: path.join(homeDir, 'Library', 'Application Support'),
+                    cache: path.join(homeDir, 'Library', 'Caches'),
+                    temp: os.tmpdir(),
+                    separator: '/',
+                    pathSeparator: ':'
+                };
+            case 'linux':
+                return {
+                    home: homeDir,
+                    config: process.env.XDG_CONFIG_HOME || path.join(homeDir, '.config'),
+                    cache: process.env.XDG_CACHE_HOME || path.join(homeDir, '.cache'),
+                    temp: os.tmpdir(),
+                    separator: '/',
+                    pathSeparator: ':'
+                };
+        }
+    }
+    /**
+     * Get current platform
+     */
+    getPlatform() {
+        return this.platform;
+    }
+    /**
+     * Get platform paths
+     */
+    getPaths() {
+        return this.platformPaths;
+    }
+    /**
+     * Convert path to platform-appropriate format
+     */
+    adaptPath(inputPath) {
+        // Normalize separators for current platform
+        return path.normalize(inputPath);
+    }
+    /**
+     * Convert Windows path to Unix format (for cross-platform compatibility)
+     */
+    toUnixPath(inputPath) {
+        return inputPath.replace(/\\/g, '/');
+    }
+    /**
+     * Convert Unix path to Windows format
+     */
+    toWindowsPath(inputPath) {
+        return inputPath.replace(/\//g, '\\');
+    }
+    /**
+     * Join paths with platform-appropriate separators
+     */
+    joinPaths(...segments) {
+        return path.join(...segments);
+    }
+    /**
+     * Resolve path relative to current working directory
+     */
+    resolvePath(...segments) {
+        return path.resolve(...segments);
+    }
+    /**
+     * Get relative path between two absolute paths
+     */
+    getRelativePath(from, to) {
+        return path.relative(from, to);
+    }
+    /**
+     * Check if path is absolute
+     */
+    isAbsolute(inputPath) {
+        return path.isAbsolute(inputPath);
+    }
+    /**
+     * Get directory name from path
+     */
+    dirname(inputPath) {
+        return path.dirname(inputPath);
+    }
+    /**
+     * Get base name from path
+     */
+    basename(inputPath, ext) {
+        return path.basename(inputPath, ext);
+    }
+    /**
+     * Get file extension from path
+     */
+    extname(inputPath) {
+        return path.extname(inputPath);
+    }
+    /**
+     * Parse path into components
+     */
+    parsePath(inputPath) {
+        return path.parse(inputPath);
+    }
+    /**
+     * Format path from components
+     */
+    formatPath(pathObject) {
+        return path.format(pathObject);
+    }
+    /**
+     * Get user-specific application config directory
+     */
+    getConfigDir(appName) {
+        return path.join(this.platformPaths.config, appName);
+    }
+    /**
+     * Get user-specific application cache directory
+     */
+    getCacheDir(appName) {
+        return path.join(this.platformPaths.cache, appName);
+    }
+    /**
+     * Get temporary directory for application
+     */
+    getTempDir(appName) {
+        if (appName) {
+            return path.join(this.platformPaths.temp, appName);
+        }
+        return this.platformPaths.temp;
+    }
+    /**
+     * Expand tilde (~) to home directory
+     */
+    expandTilde(inputPath) {
+        if (inputPath.startsWith('~/')) {
+            return path.join(this.platformPaths.home, inputPath.slice(2));
+        }
+        return inputPath;
+    }
+    /**
+     * Convert absolute path to use tilde notation
+     */
+    toTildePath(inputPath) {
+        if (inputPath.startsWith(this.platformPaths.home)) {
+            return '~' + inputPath.slice(this.platformPaths.home.length);
+        }
+        return inputPath;
+    }
+    /**
+     * Validate path format for current platform
+     */
+    isValidPath(inputPath) {
+        try {
+            // Attempt to parse and normalize the path
+            const normalized = path.normalize(inputPath);
+            return normalized.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get environment-appropriate path separator
+     */
+    getPathSeparator() {
+        return this.platformPaths.pathSeparator;
+    }
+    /**
+     * Get environment-appropriate directory separator
+     */
+    getDirectorySeparator() {
+        return this.platformPaths.separator;
+    }
+    /**
+     * Split PATH environment variable
+     */
+    splitPath(pathEnv = process.env.PATH || '') {
+        return pathEnv.split(this.platformPaths.pathSeparator);
+    }
+    /**
+     * Join PATH environment variable
+     */
+    joinPath(pathArray) {
+        return pathArray.join(this.platformPaths.pathSeparator);
+    }
+}
+/**
+ * Global path adapter instance
+ */
+export const pathAdapter = new PathAdapter();
+/**
+ * Convenience functions
+ */
+export const adaptPath = (inputPath) => pathAdapter.adaptPath(inputPath);
+export const joinPaths = (...segments) => pathAdapter.joinPaths(...segments);
+export const resolvePath = (...segments) => pathAdapter.resolvePath(...segments);
+export const normalizePath = (inputPath) => pathAdapter.adaptPath(inputPath);
+export const expandTilde = (inputPath) => pathAdapter.expandTilde(inputPath);
+export const isAbsolutePath = (inputPath) => pathAdapter.isAbsolute(inputPath);
+export const getRelativePath = (from, to) => pathAdapter.getRelativePath(from, to);
+//# sourceMappingURL=path-adapter.js.map

package/dist/core/adapters/path-adapter.js.map

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

package/dist/core/command-shortcuts.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileType: config
+ * @status: current
+ * @updated: 2025-10-01
+ * @tags: [shortcuts, reflection, routing, universal-pattern]
+ * @related: [../commands/reflect.ts, ../index.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [chalk, reflection-pattern]
+ */
+/**
+ * Command Shortcuts Registry
+ *
+ * Maps direct commands to their reflector domains, enabling:
+ * - ginko capture "description" → ginko reflect --domain capture "description"
+ * - ginko ship "message" → ginko reflect --domain ship "message"
+ *
+ * This unified architecture means:
+ * 1. All commands use the Universal Reflection Pattern
+ * 2. Direct commands are convenience shortcuts
+ * 3. Both syntaxes work identically
+ * 4. Consistent quality templates and validation
+ */
+export interface ReflectorShortcut {
+    /** Domain identifier for the reflector */
+    domain: string;
+    /** Function to transform command arguments into reflector intent */
+    defaultIntent: (...args: any[]) => string;
+    /** Default options to merge with user-provided options */
+    options?: Record<string, any>;
+    /** Description for help text */
+    description?: string;
+    /** Argument pattern for CLI (e.g., "[description]", "[message]") */
+    argPattern?: string;
+}
+/**
+ * Command Shortcuts Registry
+ *
+ * Maps command names to their reflector configurations
+ */
+export declare const COMMAND_SHORTCUTS: Record<string, ReflectorShortcut>;
+/**
+ * Execute a command shortcut by delegating to the Universal Reflection Pattern
+ *
+ * @param command - The command name (e.g., 'capture', 'ship')
+ * @param args - Command arguments (last element is commander options object)
+ * @returns Promise resolving when reflection completes
+ */
+export declare function executeShortcut(command: string, args: any[]): Promise<void>;
+/**
+ * Check if a command has a shortcut registered
+ */
+export declare function hasShortcut(command: string): boolean;
+/**
+ * Get shortcut configuration for a command
+ */
+export declare function getShortcut(command: string): ReflectorShortcut | undefined;
+/**
+ * List all registered shortcut commands
+ */
+export declare function listShortcuts(): string[];
+//# sourceMappingURL=command-shortcuts.d.ts.map

package/dist/core/command-shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-shortcuts.d.ts","sourceRoot":"","sources":["../../src/core/command-shortcuts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,oEAAoE;IACpE,aAAa,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;IAE1C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAqE/D,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,GAAG,EAAE,GACV,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE1E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/core/command-shortcuts.js

@@ -0,0 +1,124 @@
+/**
+ * @fileType: config
+ * @status: current
+ * @updated: 2025-10-01
+ * @tags: [shortcuts, reflection, routing, universal-pattern]
+ * @related: [../commands/reflect.ts, ../index.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [chalk, reflection-pattern]
+ */
+/**
+ * Command Shortcuts Registry
+ *
+ * Maps command names to their reflector configurations
+ */
+export const COMMAND_SHORTCUTS = {
+    // Session management
+    start: {
+        domain: 'start',
+        defaultIntent: (sessionId) => sessionId || 'load session context',
+        options: { verbose: false },
+        description: 'Start or resume a session with AI-enhanced reflection',
+        argPattern: '[sessionId]'
+    },
+    handoff: {
+        domain: 'handoff',
+        defaultIntent: (message) => message || 'preserve session state',
+        options: { save: true },
+        description: 'Create a session handoff with AI-enhanced reflection',
+        argPattern: '[message]'
+    },
+    // Capture and document
+    capture: {
+        domain: 'capture',
+        defaultIntent: (description) => description || 'capture current context',
+        options: { save: true },
+        description: 'Capture a learning, discovery, or important context',
+        argPattern: '[description]'
+    },
+    // Development workflow
+    explore: {
+        domain: 'explore',
+        defaultIntent: (topic) => topic || 'explore problem space',
+        options: {},
+        description: 'Collaborative thinking mode for exploring problems and solutions',
+        argPattern: '[topic]'
+    },
+    architecture: {
+        domain: 'architecture',
+        defaultIntent: (decision) => decision || 'document architecture decision',
+        options: {},
+        description: 'Design mode for crafting Architecture Decision Records (ADRs)',
+        argPattern: '[decision]'
+    },
+    plan: {
+        domain: 'plan',
+        defaultIntent: (feature) => feature || 'create implementation plan',
+        options: { days: 5 },
+        description: 'Create phased implementation plan with acceptance criteria',
+        argPattern: '[feature]'
+    },
+    // Shipping and deployment
+    ship: {
+        domain: 'ship',
+        defaultIntent: (message) => message || 'prepare for deployment',
+        options: { commit: true, push: true },
+        description: 'AI-enhanced shipping with smart commit messages and PR descriptions',
+        argPattern: '[message]'
+    },
+    // Backlog management (has subcommands, but can also be direct)
+    backlog: {
+        domain: 'backlog',
+        defaultIntent: (description) => description || 'manage backlog',
+        options: {},
+        description: 'Manage product backlog with AI assistance',
+        argPattern: '[description]'
+    }
+};
+/**
+ * Execute a command shortcut by delegating to the Universal Reflection Pattern
+ *
+ * @param command - The command name (e.g., 'capture', 'ship')
+ * @param args - Command arguments (last element is commander options object)
+ * @returns Promise resolving when reflection completes
+ */
+export async function executeShortcut(command, args) {
+    const shortcut = COMMAND_SHORTCUTS[command];
+    if (!shortcut) {
+        throw new Error(`Unknown command shortcut: ${command}`);
+    }
+    // Last arg is always commander options object
+    const options = args[args.length - 1] || {};
+    const cmdArgs = args.slice(0, -1);
+    // Build intent from arguments
+    const intent = shortcut.defaultIntent(...cmdArgs);
+    // Merge default options with user-provided options
+    const mergedOptions = {
+        ...shortcut.options,
+        ...options,
+        domain: shortcut.domain
+    };
+    // Delegate to universal reflect command
+    const { reflectCommand } = await import('../commands/reflect.js');
+    return reflectCommand(intent, mergedOptions);
+}
+/**
+ * Check if a command has a shortcut registered
+ */
+export function hasShortcut(command) {
+    return command in COMMAND_SHORTCUTS;
+}
+/**
+ * Get shortcut configuration for a command
+ */
+export function getShortcut(command) {
+    return COMMAND_SHORTCUTS[command];
+}
+/**
+ * List all registered shortcut commands
+ */
+export function listShortcuts() {
+    return Object.keys(COMMAND_SHORTCUTS);
+}
+//# sourceMappingURL=command-shortcuts.js.map

package/dist/core/command-shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-shortcuts.js","sourceRoot":"","sources":["../../src/core/command-shortcuts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiCH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsC;IAClE,qBAAqB;IACrB,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,CAAC,SAAkB,EAAE,EAAE,CAAC,SAAS,IAAI,sBAAsB;QAC1E,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;QAC3B,WAAW,EAAE,uDAAuD;QACpE,UAAU,EAAE,aAAa;KAC1B;IAED,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,IAAI,wBAAwB;QACxE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;QACvB,WAAW,EAAE,sDAAsD;QACnE,UAAU,EAAE,WAAW;KACxB;IAED,uBAAuB;IACvB,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,CAAC,WAAoB,EAAE,EAAE,CAAC,WAAW,IAAI,yBAAyB;QACjF,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;QACvB,WAAW,EAAE,qDAAqD;QAClE,UAAU,EAAE,eAAe;KAC5B;IAED,uBAAuB;IACvB,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,IAAI,uBAAuB;QACnE,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,kEAAkE;QAC/E,UAAU,EAAE,SAAS;KACtB;IAED,YAAY,EAAE;QACZ,MAAM,EAAE,cAAc;QACtB,aAAa,EAAE,CAAC,QAAiB,EAAE,EAAE,CAAC,QAAQ,IAAI,gCAAgC;QAClF,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,+DAA+D;QAC5E,UAAU,EAAE,YAAY;KACzB;IAED,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,IAAI,4BAA4B;QAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;QACpB,WAAW,EAAE,4DAA4D;QACzE,UAAU,EAAE,WAAW;KACxB;IAED,0BAA0B;IAC1B,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,IAAI,wBAAwB;QACxE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QACrC,WAAW,EAAE,qEAAqE;QAClF,UAAU,EAAE,WAAW;KACxB;IAED,+DAA+D;IAC/D,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,CAAC,WAAoB,EAAE,EAAE,CAAC,WAAW,IAAI,gBAAgB;QACxE,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,2CAA2C;QACxD,UAAU,EAAE,eAAe;KAC5B;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,IAAW;IAEX,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,8CAA8C;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAElC,8BAA8B;IAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,CAAC;IAElD,mDAAmD;IACnD,MAAM,aAAa,GAAG;QACpB,GAAG,QAAQ,CAAC,OAAO;QACnB,GAAG,OAAO;QACV,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC;IAEF,wCAAwC;IACxC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAClE,OAAO,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,IAAI,iBAAiB,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACxC,CAAC"}

package/dist/core/config/config-aware-reflection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [reflection, config-aware, paths, documents, base-class]
+ * @related: [reflection-pattern.ts, config-loader.ts, reflectors]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [reflection-pattern, config-loader, fs-extra, path, path-config]
+ */
+import { ReflectionCommand } from '../reflection-pattern.js';
+import { GinkoConfig } from '../../types/config.js';
+/**
+ * Configuration-aware reflection base class
+ * Handles path resolution and document naming using pathManager
+ */
+export declare abstract class ConfigAwareReflectionCommand extends ReflectionCommand {
+    protected config: GinkoConfig | null;
+    constructor(domain: string);
+    /**
+     * Load configuration before executing
+     */
+    execute(intent: string, options?: any): Promise<void>;
+    /**
+     * Save artifact using configuration-based paths
+     */
+    saveArtifact(content: string, filename?: string): Promise<string>;
+    /**
+     * Get document path for this domain using pathManager
+     */
+    protected getDocumentPath(): Promise<string>;
+    /**
+     * Get fallback path when configuration fails - now using pathManager
+     */
+    protected getFallbackPath(): string;
+}
+//# sourceMappingURL=config-aware-reflection.d.ts.map

package/dist/core/config/config-aware-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-aware-reflection.d.ts","sourceRoot":"","sources":["../../../src/core/config/config-aware-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD;;;GAGG;AACH,8BAAsB,4BAA6B,SAAQ,iBAAiB;IAC1E,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAEhC,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBvE;;OAEG;cACa,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IA2BlD;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,MAAM;CAgBpC"}

package/dist/core/config/config-aware-reflection.js

@@ -0,0 +1,97 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [reflection, config-aware, paths, documents, base-class]
+ * @related: [reflection-pattern.ts, config-loader.ts, reflectors]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [reflection-pattern, config-loader, fs-extra, path, path-config]
+ */
+import { ReflectionCommand } from '../reflection-pattern.js';
+import { configLoader } from './config-loader.js';
+import { pathManager } from './path-config.js';
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+/**
+ * Configuration-aware reflection base class
+ * Handles path resolution and document naming using pathManager
+ */
+export class ConfigAwareReflectionCommand extends ReflectionCommand {
+    config = null;
+    constructor(domain) {
+        super(domain);
+    }
+    /**
+     * Load configuration before executing
+     */
+    async execute(intent, options = {}) {
+        // Load configuration
+        this.config = await configLoader.loadConfig();
+        // Call parent execute
+        await super.execute(intent, options);
+    }
+    /**
+     * Save artifact using configuration-based paths
+     */
+    async saveArtifact(content, filename) {
+        if (!this.config) {
+            throw new Error('Configuration not loaded');
+        }
+        // Get the configured path for this domain
+        const documentPath = await this.getDocumentPath();
+        await fs.ensureDir(documentPath);
+        // Generate filename if not provided
+        if (!filename) {
+            filename = await this.generateDocumentName(content);
+        }
+        const filePath = path.join(documentPath, filename);
+        await fs.writeFile(filePath, content, 'utf8');
+        console.log(chalk.green(`✓ Saved to: ${filePath}`));
+        return filePath;
+    }
+    /**
+     * Get document path for this domain using pathManager
+     */
+    async getDocumentPath() {
+        try {
+            // Map domain to configuration path using pathManager
+            const pathConfig = pathManager.getConfig();
+            const pathMapping = {
+                'prd': pathConfig.docs.prd,
+                'architecture': pathConfig.docs.adr,
+                'adr': pathConfig.docs.adr,
+                'sprint': pathConfig.docs.sprints,
+                'backlog': pathConfig.ginko.backlog,
+                'documentation': pathConfig.docs.root
+            };
+            const documentPath = pathMapping[this.domain];
+            if (!documentPath) {
+                throw new Error(`No path configured for domain: ${this.domain}`);
+            }
+            return documentPath;
+        }
+        catch (error) {
+            // Fallback to default paths if configuration fails
+            console.warn(chalk.yellow(`Warning: Using fallback path for ${this.domain}`));
+            return this.getFallbackPath();
+        }
+    }
+    /**
+     * Get fallback path when configuration fails - now using pathManager
+     */
+    getFallbackPath() {
+        const pathConfig = pathManager.getConfig();
+        const fallbackPaths = {
+            'prd': pathConfig.docs.prd,
+            'architecture': pathConfig.docs.adr,
+            'adr': pathConfig.docs.adr,
+            'sprint': pathConfig.docs.sprints,
+            'backlog': pathConfig.ginko.backlog,
+            'documentation': pathConfig.docs.root
+        };
+        return fallbackPaths[this.domain] || pathConfig.docs.root;
+    }
+}
+//# sourceMappingURL=config-aware-reflection.js.map

package/dist/core/config/config-aware-reflection.js.map

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