@fractary/core 0.1.0 → 0.2.0

package/dist/common/yaml-config.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Unified YAML Configuration Loader
+ *
+ * Loads and parses `.fractary/core/config.yaml` with environment variable substitution.
+ * Provides a single source of truth for all plugin configurations.
+ */
+/**
+ * Work tracking configuration
+ */
+export interface WorkConfig {
+    active_handler: string;
+    handlers: Record<string, any>;
+    defaults?: Record<string, any>;
+    hooks?: Record<string, any>;
+    advanced?: Record<string, any>;
+}
+/**
+ * Repository management configuration
+ */
+export interface RepoConfig {
+    active_handler: string;
+    handlers: Record<string, any>;
+    defaults?: Record<string, any>;
+    faber_integration?: Record<string, any>;
+    hooks?: Record<string, any>;
+    platform_specific?: Record<string, any>;
+}
+/**
+ * Logs management configuration
+ */
+export interface LogsConfig {
+    schema_version: string;
+    storage?: Record<string, any>;
+    retention?: Record<string, any>;
+    session_logging?: Record<string, any>;
+    auto_backup?: Record<string, any>;
+    summarization?: Record<string, any>;
+    archive?: Record<string, any>;
+    search?: Record<string, any>;
+    integration?: Record<string, any>;
+    docs_integration?: Record<string, any>;
+}
+/**
+ * File storage configuration
+ */
+export interface FileConfig {
+    schema_version: string;
+    active_handler: string;
+    handlers: Record<string, any>;
+    global_settings?: Record<string, any>;
+}
+/**
+ * Specification management configuration
+ */
+export interface SpecConfig {
+    schema_version: string;
+    storage?: Record<string, any>;
+    naming?: Record<string, any>;
+    archive?: Record<string, any>;
+    integration?: Record<string, any>;
+    templates?: Record<string, any>;
+}
+/**
+ * Documentation management configuration
+ */
+export interface DocsConfig {
+    schema_version: string;
+    hooks?: Record<string, any>;
+    doc_types?: Record<string, any>;
+    output_paths?: Record<string, any>;
+    templates?: Record<string, any>;
+    frontmatter?: Record<string, any>;
+    validation?: Record<string, any>;
+    linking?: Record<string, any>;
+}
+/**
+ * Unified configuration structure for all Fractary Core plugins
+ */
+export interface CoreYamlConfig {
+    version: string;
+    work?: WorkConfig;
+    repo?: RepoConfig;
+    logs?: LogsConfig;
+    file?: FileConfig;
+    spec?: SpecConfig;
+    docs?: DocsConfig;
+}
+/**
+ * Configuration loading options
+ */
+export interface ConfigLoadOptions {
+    /** Project root directory (auto-detected if not provided) */
+    projectRoot?: string;
+    /** Warn about missing environment variables (default: true) */
+    warnMissingEnvVars?: boolean;
+    /** Throw error if config file doesn't exist (default: false) */
+    throwIfMissing?: boolean;
+}
+/**
+ * Load and parse `.fractary/core/config.yaml` with environment variable substitution
+ *
+ * @param options Configuration loading options
+ * @returns Parsed configuration object or null if not found
+ * @throws Error if config is invalid or throwIfMissing is true and file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const config = loadYamlConfig();
+ * if (config?.work) {
+ *   console.log('Work config:', config.work);
+ * }
+ * ```
+ */
+export declare function loadYamlConfig(options?: ConfigLoadOptions): CoreYamlConfig | null;
+/**
+ * Write unified configuration to `.fractary/core/config.yaml`
+ *
+ * @param config Configuration object to write
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ *
+ * @example
+ * ```typescript
+ * writeYamlConfig({
+ *   version: '2.0',
+ *   work: {
+ *     active_handler: 'github',
+ *     handlers: { ... }
+ *   }
+ * });
+ * ```
+ */
+export declare function writeYamlConfig(config: CoreYamlConfig, projectRoot?: string): void;
+/**
+ * Substitute ${ENV_VAR} placeholders with actual environment variables
+ *
+ * Supports:
+ * - ${VAR_NAME} - Replace with env var value
+ * - ${VAR_NAME:-default} - Replace with env var value or default if not set
+ *
+ * Security: Default values are limited to 1000 characters to prevent abuse.
+ * Variable names must match pattern: [A-Z_][A-Z0-9_]*
+ *
+ * @param content Content with environment variable placeholders
+ * @param warnMissing Whether to warn about missing environment variables
+ * @returns Content with substituted values
+ *
+ * @example
+ * ```typescript
+ * const content = 'token: ${GITHUB_TOKEN}';
+ * const result = substituteEnvVars(content);
+ * // result: 'token: ghp_xxxxx'
+ * ```
+ */
+export declare function substituteEnvVars(content: string, warnMissing?: boolean): string;
+/**
+ * Find project root by looking for .fractary directory or .git
+ *
+ * Walks up the directory tree from startDir until it finds:
+ * - A directory containing `.fractary/`
+ * - A directory containing `.git/`
+ * - The filesystem root
+ *
+ * Security: Normalizes paths and prevents traversal outside filesystem boundaries.
+ * Maximum of 100 directory levels to prevent infinite loops.
+ *
+ * @param startDir Directory to start searching from (default: current working directory)
+ * @returns Project root directory (normalized absolute path)
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * Check if a valid configuration file exists
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns true if `.fractary/core/config.yaml` exists
+ */
+export declare function configExists(projectRoot?: string): boolean;
+/**
+ * Get the configuration file path
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns Full path to configuration file
+ */
+export declare function getConfigPath(projectRoot?: string): string;
+/**
+ * Get the .fractary/core directory path
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns Full path to .fractary/core directory
+ */
+export declare function getCoreDir(projectRoot?: string): string;
+/**
+ * Validate that environment variables referenced in config exist
+ *
+ * @param config Configuration object to validate
+ * @returns Array of missing environment variable names
+ */
+export declare function validateEnvVars(config: CoreYamlConfig): string[];
+//# sourceMappingURL=yaml-config.d.ts.map

package/dist/common/yaml-config.d.ts.map

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

package/dist/common/yaml-config.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * Unified YAML Configuration Loader
+ *
+ * Loads and parses `.fractary/core/config.yaml` with environment variable substitution.
+ * Provides a single source of truth for all plugin configurations.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadYamlConfig = loadYamlConfig;
+exports.writeYamlConfig = writeYamlConfig;
+exports.substituteEnvVars = substituteEnvVars;
+exports.findProjectRoot = findProjectRoot;
+exports.configExists = configExists;
+exports.getConfigPath = getConfigPath;
+exports.getCoreDir = getCoreDir;
+exports.validateEnvVars = validateEnvVars;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+/**
+ * Load and parse `.fractary/core/config.yaml` with environment variable substitution
+ *
+ * @param options Configuration loading options
+ * @returns Parsed configuration object or null if not found
+ * @throws Error if config is invalid or throwIfMissing is true and file doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const config = loadYamlConfig();
+ * if (config?.work) {
+ *   console.log('Work config:', config.work);
+ * }
+ * ```
+ */
+function loadYamlConfig(options = {}) {
+    const { projectRoot, warnMissingEnvVars = true, throwIfMissing = false, } = options;
+    const root = projectRoot || findProjectRoot();
+    const configPath = path.join(root, '.fractary', 'core', 'config.yaml');
+    if (!fs.existsSync(configPath)) {
+        if (throwIfMissing) {
+            throw new Error(`Configuration file not found: ${configPath}\n` +
+                `Run 'fractary-core:init' to create it.`);
+        }
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const substituted = substituteEnvVars(content, warnMissingEnvVars);
+        const parsed = yaml.load(substituted);
+        // Validate basic structure
+        if (!parsed || typeof parsed !== 'object') {
+            throw new Error('Invalid configuration: must be a YAML object');
+        }
+        if (!parsed.version) {
+            console.warn(`Warning: Configuration missing version field in ${configPath}`);
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Failed to load config from ${configPath}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Write unified configuration to `.fractary/core/config.yaml`
+ *
+ * @param config Configuration object to write
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ *
+ * @example
+ * ```typescript
+ * writeYamlConfig({
+ *   version: '2.0',
+ *   work: {
+ *     active_handler: 'github',
+ *     handlers: { ... }
+ *   }
+ * });
+ * ```
+ */
+function writeYamlConfig(config, projectRoot) {
+    const root = projectRoot || findProjectRoot();
+    const fractaryDir = path.join(root, '.fractary', 'core');
+    const configPath = path.join(fractaryDir, 'config.yaml');
+    // Ensure directory exists
+    if (!fs.existsSync(fractaryDir)) {
+        fs.mkdirSync(fractaryDir, { recursive: true });
+    }
+    // Convert to YAML with proper formatting
+    const yamlContent = yaml.dump(config, {
+        indent: 2,
+        lineWidth: 100,
+        noRefs: true,
+        sortKeys: false,
+    });
+    fs.writeFileSync(configPath, yamlContent, 'utf-8');
+}
+/**
+ * Substitute ${ENV_VAR} placeholders with actual environment variables
+ *
+ * Supports:
+ * - ${VAR_NAME} - Replace with env var value
+ * - ${VAR_NAME:-default} - Replace with env var value or default if not set
+ *
+ * Security: Default values are limited to 1000 characters to prevent abuse.
+ * Variable names must match pattern: [A-Z_][A-Z0-9_]*
+ *
+ * @param content Content with environment variable placeholders
+ * @param warnMissing Whether to warn about missing environment variables
+ * @returns Content with substituted values
+ *
+ * @example
+ * ```typescript
+ * const content = 'token: ${GITHUB_TOKEN}';
+ * const result = substituteEnvVars(content);
+ * // result: 'token: ghp_xxxxx'
+ * ```
+ */
+function substituteEnvVars(content, warnMissing = true) {
+    // Input validation
+    if (typeof content !== 'string') {
+        throw new TypeError('Content must be a string');
+    }
+    // Maximum length for default values to prevent abuse
+    const MAX_DEFAULT_LENGTH = 1000;
+    return content.replace(/\$\{([A-Z_][A-Z0-9_]*)(:-([^}]+))?\}/g, (match, varName, _, defaultValue) => {
+        // Validate variable name format
+        if (!/^[A-Z_][A-Z0-9_]*$/.test(varName)) {
+            console.warn(`Warning: Invalid environment variable name: ${varName}`);
+            return match;
+        }
+        const value = process.env[varName];
+        if (value !== undefined) {
+            return value;
+        }
+        if (defaultValue !== undefined) {
+            // Validate default value length
+            if (defaultValue.length > MAX_DEFAULT_LENGTH) {
+                console.warn(`Warning: Default value for ${varName} exceeds maximum length (${MAX_DEFAULT_LENGTH} chars). ` +
+                    `Truncating to prevent abuse.`);
+                return defaultValue.substring(0, MAX_DEFAULT_LENGTH);
+            }
+            return defaultValue;
+        }
+        if (warnMissing) {
+            console.warn(`Warning: Environment variable ${varName} not set. ` +
+                `Using placeholder value.`);
+        }
+        // Keep original placeholder if no value found
+        return match;
+    });
+}
+/**
+ * Find project root by looking for .fractary directory or .git
+ *
+ * Walks up the directory tree from startDir until it finds:
+ * - A directory containing `.fractary/`
+ * - A directory containing `.git/`
+ * - The filesystem root
+ *
+ * Security: Normalizes paths and prevents traversal outside filesystem boundaries.
+ * Maximum of 100 directory levels to prevent infinite loops.
+ *
+ * @param startDir Directory to start searching from (default: current working directory)
+ * @returns Project root directory (normalized absolute path)
+ */
+function findProjectRoot(startDir = process.cwd()) {
+    // Input validation and normalization
+    if (typeof startDir !== 'string') {
+        throw new TypeError('startDir must be a string');
+    }
+    // Normalize and resolve to absolute path to prevent path traversal
+    let currentDir = path.resolve(path.normalize(startDir));
+    // Get filesystem root for comparison
+    const fsRoot = path.parse(currentDir).root;
+    // Safety limit: maximum 100 directory levels to prevent infinite loops
+    const MAX_LEVELS = 100;
+    let levels = 0;
+    while (currentDir !== fsRoot && levels < MAX_LEVELS) {
+        try {
+            // Check for .fractary directory
+            if (fs.existsSync(path.join(currentDir, '.fractary'))) {
+                return currentDir;
+            }
+            // Check for .git directory
+            if (fs.existsSync(path.join(currentDir, '.git'))) {
+                return currentDir;
+            }
+            // Move up one directory
+            const parentDir = path.dirname(currentDir);
+            // Safety check: ensure we're actually moving up
+            if (parentDir === currentDir) {
+                // Reached filesystem root
+                break;
+            }
+            currentDir = parentDir;
+            levels++;
+        }
+        catch (error) {
+            // Handle permission errors or invalid paths gracefully
+            console.warn(`Warning: Error accessing directory ${currentDir}: ${error}`);
+            break;
+        }
+    }
+    if (levels >= MAX_LEVELS) {
+        console.warn(`Warning: Exceeded maximum directory depth (${MAX_LEVELS} levels) while searching for project root`);
+    }
+    // If no marker found, return the normalized starting directory
+    return path.resolve(path.normalize(startDir));
+}
+/**
+ * Check if a valid configuration file exists
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns true if `.fractary/core/config.yaml` exists
+ */
+function configExists(projectRoot) {
+    const root = projectRoot || findProjectRoot();
+    const configPath = path.join(root, '.fractary', 'core', 'config.yaml');
+    return fs.existsSync(configPath);
+}
+/**
+ * Get the configuration file path
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns Full path to configuration file
+ */
+function getConfigPath(projectRoot) {
+    const root = projectRoot || findProjectRoot();
+    return path.join(root, '.fractary', 'core', 'config.yaml');
+}
+/**
+ * Get the .fractary/core directory path
+ *
+ * @param projectRoot Project root directory (auto-detected if not provided)
+ * @returns Full path to .fractary/core directory
+ */
+function getCoreDir(projectRoot) {
+    const root = projectRoot || findProjectRoot();
+    return path.join(root, '.fractary', 'core');
+}
+/**
+ * Validate that environment variables referenced in config exist
+ *
+ * @param config Configuration object to validate
+ * @returns Array of missing environment variable names
+ */
+function validateEnvVars(config) {
+    const content = yaml.dump(config);
+    const missing = [];
+    // Find all ${VAR_NAME} references
+    const matches = content.matchAll(/\$\{([A-Z_][A-Z0-9_]*)(:-[^}]+)?\}/g);
+    for (const match of matches) {
+        const varName = match[1];
+        const hasDefault = match[2] !== undefined;
+        // Only check if no default value provided
+        if (!hasDefault && process.env[varName] === undefined) {
+            if (!missing.includes(varName)) {
+                missing.push(varName);
+            }
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=yaml-config.js.map

package/dist/common/yaml-config.js.map

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

package/dist/common/yaml-config.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for unified YAML configuration loader
+ */
+export {};
+//# sourceMappingURL=yaml-config.test.d.ts.map

package/dist/common/yaml-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-config.test.d.ts","sourceRoot":"","sources":["../../src/common/yaml-config.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}