@fractary/core 0.3.3 → 0.5.0

package/dist/docs/type-registry.js

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * @fractary/core - Doc Type Registry
+ *
+ * Manages document type definitions for structured documentation.
+ * Loads core types from YAML/Markdown files and custom types from config.
+ *
+ * Doc types are stored as directories containing:
+ * - type.yaml: Type definition (schema, frontmatter rules, file naming)
+ * - template.md: Mustache template for document generation
+ * - standards.md: Standards and conventions for this type
+ */
+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.DocTypeRegistry = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+/**
+ * Convert raw YAML (snake_case) to DocType (camelCase)
+ */
+function convertYamlToDocType(raw, template, standards) {
+    return {
+        id: raw.id,
+        displayName: raw.display_name,
+        description: raw.description,
+        template,
+        outputPath: raw.output_path,
+        fileNaming: {
+            pattern: raw.file_naming.pattern,
+            autoNumber: raw.file_naming.auto_number,
+            numberFormat: raw.file_naming.number_format,
+            slugSource: raw.file_naming.slug_source,
+            slugMaxLength: raw.file_naming.slug_max_length,
+        },
+        frontmatter: {
+            requiredFields: raw.frontmatter.required_fields,
+            optionalFields: raw.frontmatter.optional_fields,
+            defaults: raw.frontmatter.defaults,
+        },
+        structure: raw.structure
+            ? {
+                requiredSections: raw.structure.required_sections,
+                optionalSections: raw.structure.optional_sections,
+                sectionOrder: raw.structure.section_order,
+            }
+            : undefined,
+        status: raw.status
+            ? {
+                allowedValues: raw.status.allowed_values,
+                default: raw.status.default,
+            }
+            : undefined,
+        indexConfig: raw.index_config
+            ? {
+                indexFile: raw.index_config.index_file,
+                sortBy: raw.index_config.sort_by,
+                sortOrder: raw.index_config.sort_order,
+                entryTemplate: raw.index_config.entry_template,
+            }
+            : undefined,
+        standards,
+    };
+}
+/**
+ * Doc Type Registry - Load and manage document type definitions
+ */
+class DocTypeRegistry {
+    coreTypes;
+    customTypes;
+    baseDir;
+    coreTypesPath;
+    constructor(config) {
+        this.baseDir = config?.baseDir || process.cwd();
+        this.coreTypes = new Map();
+        this.customTypes = new Map();
+        // Default to looking for templates/docs relative to package root
+        // When installed as a package, this should be resolved differently
+        this.coreTypesPath =
+            config?.coreTypesPath || this.findCoreTypesPath();
+        // Load core types unless explicitly skipped
+        if (!config?.skipCoreTypes) {
+            this.loadCoreTypes();
+        }
+        // Load custom types from manifest file if provided
+        if (config?.customManifestPath) {
+            this.loadCustomTypesFromManifest(config.customManifestPath);
+        }
+        // Load individual custom types if provided (can override manifest types)
+        if (config?.customTypes) {
+            this.loadCustomTypes(config.customTypes);
+        }
+    }
+    /**
+     * Find the core templates/docs directory (templates/docs)
+     */
+    findCoreTypesPath() {
+        // Try common locations
+        const candidates = [
+            // Development: relative to SDK source
+            path.resolve(__dirname, '../../../../templates/docs'),
+            // Development: from repo root
+            path.resolve(process.cwd(), 'templates/docs'),
+            // Installed package: look in parent directories
+            path.resolve(__dirname, '../../../../../templates/docs'),
+            path.resolve(__dirname, '../../../../../../templates/docs'),
+        ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(path.join(candidate, 'manifest.yaml'))) {
+                return candidate;
+            }
+        }
+        // Fallback - will fail later if types not found
+        return candidates[0];
+    }
+    /**
+     * Load all core doc types from the templates/docs directory
+     */
+    loadCoreTypes() {
+        const manifestPath = path.join(this.coreTypesPath, 'manifest.yaml');
+        if (!fs.existsSync(manifestPath)) {
+            console.warn(`Core doc types manifest not found: ${manifestPath}`);
+            return;
+        }
+        try {
+            const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
+            const manifest = yaml.load(manifestContent);
+            for (const entry of manifest.doc_types) {
+                const docType = this.loadDocTypeFromDirectory(entry.id, path.join(this.coreTypesPath, entry.path.replace('./', '')));
+                if (docType) {
+                    this.coreTypes.set(docType.id, docType);
+                }
+            }
+        }
+        catch (error) {
+            console.warn('Failed to load core doc types:', error);
+        }
+    }
+    /**
+     * Load custom doc types from a manifest file
+     * This is used when docs.custom_templates_path is set in config.yaml
+     */
+    loadCustomTypesFromManifest(manifestPath) {
+        // Resolve path relative to baseDir if not absolute
+        const resolvedPath = path.isAbsolute(manifestPath)
+            ? manifestPath
+            : path.join(this.baseDir, manifestPath);
+        if (!fs.existsSync(resolvedPath)) {
+            // Custom manifest is optional - don't warn if not found
+            return;
+        }
+        try {
+            const manifestContent = fs.readFileSync(resolvedPath, 'utf-8');
+            const manifest = yaml.load(manifestContent);
+            // Get the directory containing the manifest
+            const manifestDir = path.dirname(resolvedPath);
+            for (const entry of manifest.doc_types || []) {
+                // Resolve type directory relative to manifest location
+                const typeDirPath = path.join(manifestDir, entry.path.replace('./', ''));
+                const docType = this.loadDocTypeFromDirectory(entry.id, typeDirPath);
+                if (docType) {
+                    this.customTypes.set(docType.id, docType);
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Failed to load custom doc types from ${manifestPath}:`, error);
+        }
+    }
+    /**
+     * Load a doc type from a directory
+     */
+    loadDocTypeFromDirectory(id, dirPath) {
+        const typeYamlPath = path.join(dirPath, 'type.yaml');
+        const templatePath = path.join(dirPath, 'template.md');
+        const standardsPath = path.join(dirPath, 'standards.md');
+        if (!fs.existsSync(typeYamlPath)) {
+            console.warn(`Doc type definition not found: ${typeYamlPath}`);
+            return null;
+        }
+        try {
+            // Read type.yaml
+            const typeContent = fs.readFileSync(typeYamlPath, 'utf-8');
+            const rawType = yaml.load(typeContent);
+            // Read template.md
+            let template = '';
+            if (fs.existsSync(templatePath)) {
+                template = fs.readFileSync(templatePath, 'utf-8');
+            }
+            // Read standards.md
+            let standards = '';
+            if (fs.existsSync(standardsPath)) {
+                standards = fs.readFileSync(standardsPath, 'utf-8');
+            }
+            // Convert and validate
+            const docType = convertYamlToDocType(rawType, template, standards);
+            // Ensure ID matches
+            if (docType.id !== id) {
+                console.warn(`Doc type ID mismatch: expected ${id}, got ${docType.id}`);
+                docType.id = id;
+            }
+            return docType;
+        }
+        catch (error) {
+            console.warn(`Failed to load doc type ${id}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Load custom types from config paths
+     */
+    loadCustomTypes(configs) {
+        for (const config of configs) {
+            try {
+                if (config.path) {
+                    // Load from local directory
+                    const typePath = path.isAbsolute(config.path)
+                        ? config.path
+                        : path.join(this.baseDir, config.path);
+                    const docType = this.loadDocTypeFromDirectory(config.id, typePath);
+                    if (docType) {
+                        this.customTypes.set(docType.id, docType);
+                    }
+                }
+                else if (config.url) {
+                    // URL loading would be async - not supported in constructor
+                    // Users should use loadCustomTypeFromUrl() method instead
+                    console.warn(`URL-based doc type loading not supported in constructor. Use loadCustomTypeFromUrl() for ${config.id}`);
+                }
+            }
+            catch (error) {
+                console.warn(`Failed to load custom doc type ${config.id}:`, error);
+            }
+        }
+    }
+    /**
+     * Load a custom doc type from a URL (async)
+     * @param id - Type identifier
+     * @param baseUrl - Base URL to the type directory (should contain type.yaml, template.md, standards.md)
+     */
+    async loadCustomTypeFromUrl(id, baseUrl) {
+        try {
+            // Fetch type.yaml
+            const typeUrl = `${baseUrl}/type.yaml`;
+            const typeResponse = await fetch(typeUrl);
+            if (!typeResponse.ok) {
+                console.warn(`Failed to fetch doc type: ${typeUrl}`);
+                return null;
+            }
+            const typeContent = await typeResponse.text();
+            const rawType = yaml.load(typeContent);
+            // Fetch template.md
+            let template = '';
+            try {
+                const templateUrl = `${baseUrl}/template.md`;
+                const templateResponse = await fetch(templateUrl);
+                if (templateResponse.ok) {
+                    template = await templateResponse.text();
+                }
+            }
+            catch {
+                // Template is optional
+            }
+            // Fetch standards.md
+            let standards = '';
+            try {
+                const standardsUrl = `${baseUrl}/standards.md`;
+                const standardsResponse = await fetch(standardsUrl);
+                if (standardsResponse.ok) {
+                    standards = await standardsResponse.text();
+                }
+            }
+            catch {
+                // Standards is optional
+            }
+            const docType = convertYamlToDocType(rawType, template, standards);
+            docType.id = id;
+            this.customTypes.set(id, docType);
+            return docType;
+        }
+        catch (error) {
+            console.warn(`Failed to load doc type from URL ${baseUrl}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Get all available doc types (core + custom)
+     */
+    getAllTypes() {
+        const types = [];
+        // Add core types
+        for (const docType of this.coreTypes.values()) {
+            types.push(docType);
+        }
+        // Add custom types (may override core types)
+        for (const docType of this.customTypes.values()) {
+            const existingIndex = types.findIndex((t) => t.id === docType.id);
+            if (existingIndex >= 0) {
+                types[existingIndex] = docType;
+            }
+            else {
+                types.push(docType);
+            }
+        }
+        return types.sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Get a doc type by ID
+     */
+    getType(id) {
+        // Custom types take precedence
+        if (this.customTypes.has(id)) {
+            return this.customTypes.get(id);
+        }
+        return this.coreTypes.get(id) || null;
+    }
+    /**
+     * Check if a doc type exists
+     */
+    hasType(id) {
+        return this.coreTypes.has(id) || this.customTypes.has(id);
+    }
+    /**
+     * Get only core types
+     */
+    getCoreTypes() {
+        return Array.from(this.coreTypes.values()).sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Get only custom types
+     */
+    getCustomTypes() {
+        return Array.from(this.customTypes.values()).sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Register a custom type programmatically
+     */
+    registerType(docType) {
+        this.customTypes.set(docType.id, docType);
+    }
+    /**
+     * Unregister a custom type
+     */
+    unregisterType(id) {
+        return this.customTypes.delete(id);
+    }
+    /**
+     * Get the manifest URL for core types
+     */
+    static getCoreManifestUrl() {
+        return 'https://raw.githubusercontent.com/fractary/core/main/templates/docs/manifest.yaml';
+    }
+    /**
+     * Get the base URL for a specific core type
+     */
+    static getCoreTypeUrl(typeId) {
+        return `https://raw.githubusercontent.com/fractary/core/main/templates/docs/${typeId}`;
+    }
+}
+exports.DocTypeRegistry = DocTypeRegistry;
+//# sourceMappingURL=type-registry.js.map

package/dist/docs/type-registry.js.map

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

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"}