@fractary/core 0.3.2 → 0.4.0

package/dist/docs/types.d.ts

@@ -7,6 +7,12 @@
  * Documentation format types
  */
 export type DocFormat = 'markdown' | 'html' | 'pdf' | 'text';
+/**
+ * Metadata storage mode
+ * - 'frontmatter': Metadata embedded in YAML frontmatter at start of markdown files (recommended)
+ * - 'sidecar': Metadata stored in separate .meta.yaml files alongside content files (legacy)
+ */
+export type MetadataMode = 'frontmatter' | 'sidecar';
 /**
  * Documentation metadata
  */
@@ -39,6 +45,14 @@ export interface DocMetadata {
      * Tags for categorization
      */
     tags?: string[];
+    /**
+     * Document type (e.g., 'adr', 'api', 'architecture')
+     */
+    docType?: string;
+    /**
+     * Document status (e.g., 'draft', 'published', 'deprecated')
+     */
+    status?: string;
     /**
      * Custom metadata
      */
@@ -85,6 +99,10 @@ export interface DocSearchQuery {
      * Filter by author
      */
     author?: string;
+    /**
+     * Filter by document type
+     */
+    docType?: string;
     /**
      * Filter by date range
      */
@@ -109,5 +127,80 @@ export interface DocsManagerConfig {
      * Default format for new documents
      */
     defaultFormat?: DocFormat;
+    /**
+     * Metadata storage mode (default: 'frontmatter' for markdown, 'sidecar' for others)
+     */
+    metadataMode?: MetadataMode;
+}
+/**
+ * Document type definition
+ */
+export interface DocType {
+    /**
+     * Type identifier (e.g., 'adr', 'api', 'architecture')
+     */
+    id: string;
+    /**
+     * Human-readable name
+     */
+    displayName: string;
+    /**
+     * Description of this document type
+     */
+    description: string;
+    /**
+     * Mustache template for document content
+     */
+    template: string;
+    /**
+     * Default output path relative to docs directory
+     */
+    outputPath: string;
+    /**
+     * File naming configuration
+     */
+    fileNaming: {
+        pattern: string;
+        autoNumber?: boolean;
+        numberFormat?: string;
+        slugSource?: string;
+        slugMaxLength?: number;
+    };
+    /**
+     * Frontmatter field configuration
+     */
+    frontmatter: {
+        requiredFields: string[];
+        optionalFields?: string[];
+        defaults?: Record<string, unknown>;
+    };
+    /**
+     * Document structure requirements
+     */
+    structure?: {
+        requiredSections?: string[];
+        optionalSections?: string[];
+        sectionOrder?: string[];
+    };
+    /**
+     * Status field configuration
+     */
+    status?: {
+        allowedValues: string[];
+        default: string;
+    };
+    /**
+     * Index configuration
+     */
+    indexConfig?: {
+        indexFile: string;
+        sortBy?: string;
+        sortOrder?: 'asc' | 'desc';
+        entryTemplate?: string;
+    };
+    /**
+     * Documentation standards (markdown content)
+     */
+    standards?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,IAAI,CAAC;QACZ,EAAE,CAAC,EAAE,IAAI,CAAC;KACX,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docs/types.ts"],"names":[],"mappings":"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"}

package/dist/factories.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fractary/core - Manager Factories
+ *
+ * Factory functions for creating authenticated managers.
+ * Provides a convenient way to create WorkManager and RepoManager
+ * with automatic configuration loading and authentication.
+ */
+import { WorkManager } from './work';
+import { RepoManager } from './repo';
+import { LoadedConfig } from './config/loader';
+/**
+ * Options for creating managers
+ */
+export interface CreateManagerOptions {
+    /** Pre-loaded configuration (optional - will load if not provided) */
+    config?: LoadedConfig;
+    /** Working directory for repository operations */
+    cwd?: string;
+    /** Skip authentication (use existing gh CLI auth instead) */
+    skipAuth?: boolean;
+}
+/**
+ * Create an authenticated WorkManager
+ *
+ * Loads configuration automatically and creates a WorkManager
+ * with proper authentication.
+ *
+ * @param options Creation options
+ * @returns Configured WorkManager instance
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - auto-loads config and auth
+ * const workManager = await createWorkManager();
+ * const issues = await workManager.searchIssues('bug');
+ *
+ * // With pre-loaded config
+ * const config = await loadConfig();
+ * const workManager = await createWorkManager({ config });
+ * ```
+ */
+export declare function createWorkManager(options?: CreateManagerOptions): Promise<WorkManager>;
+/**
+ * Create an authenticated RepoManager
+ *
+ * Loads configuration automatically and creates a RepoManager
+ * with proper authentication.
+ *
+ * @param options Creation options
+ * @returns Configured RepoManager instance
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - auto-loads config and auth
+ * const repoManager = await createRepoManager();
+ * const status = repoManager.getStatus();
+ *
+ * // With explicit working directory
+ * const repoManager = await createRepoManager({ cwd: '/path/to/repo' });
+ *
+ * // With pre-loaded config
+ * const config = await loadConfig();
+ * const repoManager = await createRepoManager({ config });
+ * ```
+ */
+export declare function createRepoManager(options?: CreateManagerOptions): Promise<RepoManager>;
+/**
+ * Create both WorkManager and RepoManager with shared config
+ *
+ * Useful when you need both managers and want to share
+ * configuration and authentication.
+ *
+ * @param options Creation options
+ * @returns Object with both managers
+ *
+ * @example
+ * ```typescript
+ * const { work, repo } = await createManagers();
+ *
+ * // Fetch issue and create branch
+ * const issue = await work.fetchIssue(123);
+ * await repo.createBranch(`feature/${issue.number}-${slug(issue.title)}`);
+ * ```
+ */
+export declare function createManagers(options?: CreateManagerOptions): Promise<{
+    work: WorkManager;
+    repo: RepoManager;
+}>;
+//# sourceMappingURL=factories.d.ts.map

package/dist/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../src/factories.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAc,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA0C3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkFD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAwBnD"}

package/dist/factories.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * @fractary/core - Manager Factories
+ *
+ * Factory functions for creating authenticated managers.
+ * Provides a convenient way to create WorkManager and RepoManager
+ * with automatic configuration loading and authentication.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkManager = createWorkManager;
+exports.createRepoManager = createRepoManager;
+exports.createManagers = createManagers;
+const work_1 = require("./work");
+const repo_1 = require("./repo");
+const loader_1 = require("./config/loader");
+const errors_1 = require("./common/errors");
+/** Regex pattern for valid GitHub owner/repo format */
+const PROJECT_FORMAT_REGEX = /^[a-zA-Z0-9_.-]+\/[a-zA-Z0-9_.-]+$/;
+/**
+ * Validate and parse project string into owner/repo
+ *
+ * @param project Project string in "owner/repo" format
+ * @returns Tuple of [owner, repo] or null if invalid
+ * @throws ConfigurationError if format is invalid
+ */
+function parseProject(project) {
+    if (!project || typeof project !== 'string') {
+        throw new errors_1.ConfigurationError('Invalid project configuration: project must be a non-empty string', { project });
+    }
+    const trimmed = project.trim();
+    if (!PROJECT_FORMAT_REGEX.test(trimmed)) {
+        throw new errors_1.ConfigurationError(`Invalid project format: "${project}". Expected "owner/repo" format (e.g., "fractary/core")`, { project });
+    }
+    const parts = trimmed.split('/');
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new errors_1.ConfigurationError(`Invalid project format: "${project}". Expected exactly one "/" separator`, { project });
+    }
+    return [parts[0], parts[1]];
+}
+/**
+ * Build WorkConfig from LoadedConfig
+ *
+ * @param config Loaded configuration
+ * @param token Token from token provider (if available)
+ * @returns WorkConfig for WorkManager
+ * @throws ConfigurationError if project format is invalid
+ */
+function buildWorkConfig(config, token) {
+    // Get platform from work config or default to github
+    const workConfig = config.work;
+    const activeHandler = workConfig?.active_handler || 'github';
+    // Map active_handler to platform
+    const platform = activeHandler;
+    // Get handler-specific config
+    const handlerConfig = workConfig?.handlers?.[activeHandler] || {};
+    // Extract owner/repo from project string if needed
+    let owner = handlerConfig.owner;
+    let repo = handlerConfig.repo;
+    const project = handlerConfig.project || config.github?.project;
+    // Parse and validate project format if we need to extract owner/repo
+    if (!owner && !repo && project) {
+        [owner, repo] = parseProject(project);
+    }
+    return {
+        platform,
+        owner,
+        repo,
+        project: project,
+        token: token || handlerConfig.token || config.github?.token,
+    };
+}
+/**
+ * Build RepoConfig from LoadedConfig
+ *
+ * @param config Loaded configuration
+ * @param token Token from token provider (if available)
+ * @returns RepoConfig for RepoManager
+ * @throws ConfigurationError if project format is invalid
+ */
+function buildRepoConfig(config, token) {
+    // Get platform from repo config or default to github
+    const repoConfig = config.repo;
+    const activeHandler = repoConfig?.active_handler || 'github';
+    // Map active_handler to platform
+    const platform = activeHandler;
+    // Get handler-specific config
+    const handlerConfig = repoConfig?.handlers?.[activeHandler] || {};
+    // Get defaults
+    const defaults = repoConfig?.defaults || {};
+    // Extract owner/repo from project string if needed
+    let owner = handlerConfig.owner;
+    let repo = handlerConfig.repo;
+    const project = handlerConfig.project || config.github?.project;
+    // Parse and validate project format if we need to extract owner/repo
+    if (!owner && !repo && project) {
+        [owner, repo] = parseProject(project);
+    }
+    return {
+        platform,
+        owner,
+        repo,
+        defaultBranch: defaults.default_branch || handlerConfig.default_branch,
+        token: token || handlerConfig.token || config.github?.token,
+        branchPrefixes: defaults.branch_naming?.prefixes,
+    };
+}
+/**
+ * Create an authenticated WorkManager
+ *
+ * Loads configuration automatically and creates a WorkManager
+ * with proper authentication.
+ *
+ * @param options Creation options
+ * @returns Configured WorkManager instance
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - auto-loads config and auth
+ * const workManager = await createWorkManager();
+ * const issues = await workManager.searchIssues('bug');
+ *
+ * // With pre-loaded config
+ * const config = await loadConfig();
+ * const workManager = await createWorkManager({ config });
+ * ```
+ */
+async function createWorkManager(options = {}) {
+    const { config: providedConfig, skipAuth = false } = options;
+    // Load config if not provided
+    const config = providedConfig || await (0, loader_1.loadConfig)({ skipAuth });
+    // Get token from provider if available
+    let token;
+    if (!skipAuth && config.tokenProvider) {
+        try {
+            token = await config.tokenProvider.getToken();
+        }
+        catch {
+            // Token provider failed - continue without token
+            // The manager will fall back to gh CLI auth
+        }
+    }
+    // Build WorkConfig
+    const workConfig = buildWorkConfig(config, token);
+    return new work_1.WorkManager(workConfig);
+}
+/**
+ * Create an authenticated RepoManager
+ *
+ * Loads configuration automatically and creates a RepoManager
+ * with proper authentication.
+ *
+ * @param options Creation options
+ * @returns Configured RepoManager instance
+ *
+ * @example
+ * ```typescript
+ * // Simple usage - auto-loads config and auth
+ * const repoManager = await createRepoManager();
+ * const status = repoManager.getStatus();
+ *
+ * // With explicit working directory
+ * const repoManager = await createRepoManager({ cwd: '/path/to/repo' });
+ *
+ * // With pre-loaded config
+ * const config = await loadConfig();
+ * const repoManager = await createRepoManager({ config });
+ * ```
+ */
+async function createRepoManager(options = {}) {
+    const { config: providedConfig, cwd, skipAuth = false } = options;
+    // Load config if not provided
+    const config = providedConfig || await (0, loader_1.loadConfig)({ skipAuth });
+    // Get token from provider if available
+    let token;
+    if (!skipAuth && config.tokenProvider) {
+        try {
+            token = await config.tokenProvider.getToken();
+        }
+        catch {
+            // Token provider failed - continue without token
+            // The manager will fall back to gh CLI auth
+        }
+    }
+    // Build RepoConfig
+    const repoConfig = buildRepoConfig(config, token);
+    return new repo_1.RepoManager(repoConfig, cwd);
+}
+/**
+ * Create both WorkManager and RepoManager with shared config
+ *
+ * Useful when you need both managers and want to share
+ * configuration and authentication.
+ *
+ * @param options Creation options
+ * @returns Object with both managers
+ *
+ * @example
+ * ```typescript
+ * const { work, repo } = await createManagers();
+ *
+ * // Fetch issue and create branch
+ * const issue = await work.fetchIssue(123);
+ * await repo.createBranch(`feature/${issue.number}-${slug(issue.title)}`);
+ * ```
+ */
+async function createManagers(options = {}) {
+    const { config: providedConfig, cwd, skipAuth = false } = options;
+    // Load config once
+    const config = providedConfig || await (0, loader_1.loadConfig)({ skipAuth });
+    // Get token once
+    let token;
+    if (!skipAuth && config.tokenProvider) {
+        try {
+            token = await config.tokenProvider.getToken();
+        }
+        catch {
+            // Token provider failed - continue without token
+        }
+    }
+    // Build configs
+    const workConfig = buildWorkConfig(config, token);
+    const repoConfig = buildRepoConfig(config, token);
+    return {
+        work: new work_1.WorkManager(workConfig),
+        repo: new repo_1.RepoManager(repoConfig, cwd),
+    };
+}
+//# sourceMappingURL=factories.js.map

package/dist/factories.js.map

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

package/dist/file/factory.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fractary/core - Storage Factory
+ *
+ * Factory function for creating storage backends based on configuration.
+ * Supports automatic configuration loading from .fractary/config.yaml.
+ */
+import { Storage, StorageConfig, StorageType, SourceConfig } from './types';
+/**
+ * Create a storage backend from configuration
+ *
+ * @param config - Storage configuration
+ * @returns Storage instance
+ */
+export declare function createStorage(config: StorageConfig): Storage;
+/**
+ * Convert a source configuration from config.yaml to a StorageConfig
+ *
+ * @param source - Source configuration from config.yaml
+ * @returns StorageConfig for creating a storage backend
+ */
+export declare function sourceConfigToStorageConfig(source: SourceConfig): StorageConfig;
+/**
+ * Create a storage backend from a named source in config.yaml
+ *
+ * @param sourceName - Name of the source (e.g., 'specs', 'logs')
+ * @param fileConfig - File plugin configuration from config.yaml
+ * @returns Storage instance
+ */
+export declare function createStorageFromSource(sourceName: string, fileConfig: {
+    sources?: Record<string, SourceConfig>;
+}): Storage;
+/**
+ * Get the default storage type based on configuration
+ *
+ * @param fileConfig - File plugin configuration
+ * @returns Default storage type
+ */
+export declare function getDefaultStorageType(fileConfig?: {
+    sources?: Record<string, SourceConfig>;
+}): StorageType;
+//# sourceMappingURL=factory.d.ts.map

package/dist/file/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/file/factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,OAAO,EACP,aAAa,EACb,WAAW,EAMX,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAqB5D;AA8ED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAsD/E;AAiBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GACrD,OAAO,CAaT;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GACtD,WAAW,CAQb"}