@millstone/synapse-cli 0.1.0

package/dist/lib/schemas.js

@@ -0,0 +1,248 @@
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import fsExtra from 'fs-extra';
+const fs = fsExtra;
+import * as path from 'path';
+import { createRequire } from 'module';
+import { DOC_TYPES } from './types.generated.js';
+export { isDocType, DOC_TYPES } from './types.generated.js';
+// Cache for compiled schemas to improve performance
+const schemaCache = new Map();
+/**
+ * Resolve the frontmatter schema directory using a cascade:
+ * 1. Local project override: {projectRoot}/schemas/frontmatter/
+ * 2. @synapse/schemas npm package
+ * 3. Error with helpful message
+ */
+function getDefaultSchemaDir() {
+    // Priority 1: Local project override
+    const localPaths = [
+        path.resolve(process.cwd(), 'schemas/frontmatter'),
+        path.resolve(process.cwd(), '../schemas/frontmatter'),
+        path.resolve(process.cwd(), '../../schemas/frontmatter'),
+    ];
+    for (const schemaPath of localPaths) {
+        if (fs.existsSync(schemaPath)) {
+            try {
+                const files = fs.readdirSync(schemaPath);
+                const hasSchemas = files.some(f => f.endsWith('.schema.json'));
+                if (hasSchemas) {
+                    return schemaPath;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    // Priority 2: @synapse/schemas package
+    try {
+        const require = createRequire(import.meta.url);
+        const pkgPath = require.resolve('@synapse/schemas/package.json');
+        const pkgDir = path.dirname(pkgPath);
+        const frontmatterDir = path.join(pkgDir, 'frontmatter');
+        if (fs.existsSync(frontmatterDir)) {
+            return frontmatterDir;
+        }
+    }
+    catch {
+        // Package not installed
+    }
+    // Priority 3: Error with helpful message
+    throw new Error('Could not find frontmatter schemas. Either place schemas in {projectRoot}/schemas/frontmatter/ ' +
+        'or install the @synapse/schemas package: npm install @synapse/schemas');
+}
+/**
+ * Load a schema for a specific document type
+ * Resolves $ref references to base.schema.json automatically
+ */
+export async function loadSchema(type, dir) {
+    const schemaDir = dir || getDefaultSchemaDir();
+    const schemaPath = path.join(schemaDir, `${type}.schema.json`);
+    const cacheKey = `${schemaDir}:${type}`;
+    // Return cached schema if available
+    if (schemaCache.has(cacheKey)) {
+        return schemaCache.get(cacheKey);
+    }
+    try {
+        // Read the schema file
+        const schemaContent = await fs.readFile(schemaPath, 'utf-8');
+        const schema = JSON.parse(schemaContent);
+        // If schema has allOf with $ref to base.schema.json, resolve it
+        if (schema.allOf && Array.isArray(schema.allOf)) {
+            const resolvedAllOf = await Promise.all(schema.allOf.map(async (item) => {
+                if (item.$ref === 'base.schema.json') {
+                    const basePath = path.join(schemaDir, 'base.schema.json');
+                    const baseContent = await fs.readFile(basePath, 'utf-8');
+                    return JSON.parse(baseContent);
+                }
+                return item;
+            }));
+            // Merge base schema properties with type-specific schema
+            const mergedSchema = {
+                ...schema,
+                properties: {
+                    ...resolvedAllOf[0]?.properties || {},
+                    ...schema.properties || {}
+                },
+                required: [
+                    ...(resolvedAllOf[0]?.required || []),
+                    ...(schema.required || [])
+                ].filter((v, i, a) => a.indexOf(v) === i) // Remove duplicates
+            };
+            // Remove allOf since we've resolved it
+            delete mergedSchema.allOf;
+            schemaCache.set(cacheKey, mergedSchema);
+            return mergedSchema;
+        }
+        // Cache and return schema as-is if no allOf
+        schemaCache.set(cacheKey, schema);
+        return schema;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Schema file not found for type '${type}' at path: ${schemaPath}`);
+        }
+        throw new Error(`Failed to load schema for type '${type}': ${error.message}`);
+    }
+}
+/**
+ * List all available schema types in the schema directory
+ */
+export async function listSchemas(dir) {
+    const schemaDir = dir || getDefaultSchemaDir();
+    try {
+        const files = await fs.readdir(schemaDir);
+        // Filter for .schema.json files and extract type names
+        const schemaTypes = files
+            .filter(file => file.endsWith('.schema.json') && file !== 'base.schema.json')
+            .map(file => file.replace('.schema.json', ''))
+            .sort();
+        return schemaTypes;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Schema directory not found: ${schemaDir}`);
+        }
+        throw new Error(`Failed to list schemas: ${error.message}`);
+    }
+}
+/**
+ * Validate frontmatter data against a JSON schema
+ */
+export function validateFrontmatter(data, schema) {
+    // Create a temporary Ajv instance for validation
+    // Remove the $schema property to avoid draft version conflicts
+    const cleanSchema = { ...schema };
+    delete cleanSchema.$schema;
+    delete cleanSchema.$id;
+    const ajv = new Ajv({
+        allErrors: true,
+        strict: false,
+        validateSchema: false // Don't validate the schema itself
+    });
+    // Add format validation support
+    addFormats(ajv);
+    try {
+        const validate = ajv.compile(cleanSchema);
+        const valid = validate(data);
+        if (valid) {
+            return { valid: true };
+        }
+        else {
+            // Format errors to be more human-readable
+            const formattedErrors = (validate.errors || []).map(error => {
+                const path = error.instancePath || '/';
+                let message = error.message || 'validation error';
+                // Add more context for specific error types
+                if (error.keyword === 'required') {
+                    const missingProp = error.params.missingProperty;
+                    message = `missing required property '${missingProp}'`;
+                }
+                else if (error.keyword === 'type') {
+                    const expectedType = error.params.type;
+                    message = `must be ${expectedType}`;
+                }
+                else if (error.keyword === 'const') {
+                    const expectedValue = error.params.allowedValue;
+                    message = `must be equal to constant '${expectedValue}'`;
+                }
+                return { path, message };
+            });
+            return {
+                valid: false,
+                errors: formattedErrors
+            };
+        }
+    }
+    catch (error) {
+        // If compilation fails, return as validation error
+        return {
+            valid: false,
+            errors: [{
+                    path: '/',
+                    message: `Schema compilation failed: ${error.message}`
+                }]
+        };
+    }
+}
+/**
+ * Validate that all expected document types have schemas
+ * Returns an object with validation results
+ */
+export async function validateSchemasCoverage(dir) {
+    // Use generated DOC_TYPES instead of hardcoded list
+    const expectedTypes = [...DOC_TYPES];
+    const errors = [];
+    try {
+        const foundTypes = await listSchemas(dir);
+        // Check for missing schemas
+        const missing = expectedTypes.filter(type => !foundTypes.includes(type));
+        // Check for extra schemas (not in expected list)
+        const extra = foundTypes.filter(type => !expectedTypes.includes(type));
+        // Validate each schema can be loaded and compiled
+        for (const type of expectedTypes) {
+            if (foundTypes.includes(type)) {
+                try {
+                    const schema = await loadSchema(type, dir);
+                    // Basic validation that schema has required structure
+                    if (!schema.properties) {
+                        errors.push(`Schema for '${type}' is missing 'properties' field`);
+                    }
+                    if (!schema.properties.type) {
+                        errors.push(`Schema for '${type}' is missing 'type' property definition`);
+                    }
+                    else if (schema.properties.type.const !== type) {
+                        errors.push(`Schema for '${type}' has mismatched type const: expected '${type}', got '${schema.properties.type.const}'`);
+                    }
+                }
+                catch (error) {
+                    errors.push(`Failed to load schema for '${type}': ${error.message}`);
+                }
+            }
+        }
+        return {
+            success: missing.length === 0 && errors.length === 0,
+            coverage: {
+                expected: expectedTypes,
+                found: foundTypes,
+                missing,
+                extra
+            },
+            errors
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            coverage: {
+                expected: expectedTypes,
+                found: [],
+                missing: expectedTypes,
+                extra: []
+            },
+            errors: [`Failed to validate schema coverage: ${error.message}`]
+        };
+    }
+}
+//# sourceMappingURL=schemas.js.map

package/dist/lib/schemas.js.map

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

package/dist/lib/templateLint.d.ts

@@ -0,0 +1,21 @@
+import { type JSONSchema } from './schemas.js';
+export interface TemplateLintIssue {
+    type: 'error' | 'warning';
+    message: string;
+    field?: string;
+    line?: number;
+}
+export interface TemplateLintResult {
+    templatePath: string;
+    errors: TemplateLintIssue[];
+    warnings: TemplateLintIssue[];
+}
+/**
+ * Analyzes a template file and checks it against its schema
+ */
+export declare function analyzeTemplate(templatePath: string, schema?: JSONSchema, schemaDir?: string): Promise<TemplateLintResult>;
+/**
+ * Lint all templates in a directory
+ */
+export declare function lintTemplatesDirectory(templatesDir: string, schemaDir?: string): Promise<TemplateLintResult[]>;
+//# sourceMappingURL=templateLint.d.ts.map

package/dist/lib/templateLint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateLint.d.ts","sourceRoot":"","sources":["../../src/lib/templateLint.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAO3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AA0ID;;GAEG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,CAAC,CA8G7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkB/B"}

package/dist/lib/templateLint.js

@@ -0,0 +1,243 @@
+import fsExtra from 'fs-extra';
+const fs = fsExtra;
+import * as path from 'path';
+import { loadSchema } from './schemas.js';
+import { isDocType } from './types.generated.js';
+import { extractFrontmatter, extractPlaceholders, parseFrontmatterKeys } from './markdown.js';
+// Default Handlebars helpers that are always available
+const DEFAULT_HELPERS = ['now', 'each', 'unless', 'if', 'with'];
+// Default Handlebars helpers that are always available
+/**
+ * Gets the document type from the template path or frontmatter
+ */
+function getDocTypeFromTemplate(templatePath, frontmatter) {
+    // Try to extract from frontmatter first
+    const typeMatch = frontmatter.match(/^type:\s*([a-zA-Z_]+)/m);
+    if (typeMatch && isDocType(typeMatch[1])) {
+        return typeMatch[1];
+    }
+    // Try to infer from filename
+    const basename = path.basename(templatePath, '.hbs').toLowerCase();
+    if (isDocType(basename)) {
+        return basename;
+    }
+    // Map common variations to doc types
+    const typeMap = {
+        'adr': 'adr',
+        'capability': 'capability',
+        'policy': 'policy',
+        'prd': 'prd',
+        'process': 'process',
+        'runbook': 'runbook',
+        'sop': 'sop',
+        'standard': 'standard',
+        'system': 'system',
+        'tdd': 'tdd'
+    };
+    return typeMap[basename] || null;
+}
+/**
+ * Gets required fields from the merged schema
+ */
+async function getRequiredFields(type, schemaDir) {
+    const requiredFields = new Set();
+    // For custom schema directories (like in tests), bypass loadSchema to avoid caching issues
+    if (schemaDir && !schemaDir.includes('content/schemas')) {
+        try {
+            // Load base schema
+            const baseSchemaPath = path.join(schemaDir, 'base.schema.json');
+            if (await fs.pathExists(baseSchemaPath)) {
+                const baseSchema = await fs.readJSON(baseSchemaPath);
+                if (baseSchema.required && Array.isArray(baseSchema.required)) {
+                    baseSchema.required.forEach((field) => requiredFields.add(field));
+                }
+            }
+            // Load type-specific schema
+            const typeSchemaPath = path.join(schemaDir, `${type}.schema.json`);
+            if (await fs.pathExists(typeSchemaPath)) {
+                const typeSchema = await fs.readJSON(typeSchemaPath);
+                if (typeSchema.required && Array.isArray(typeSchema.required)) {
+                    typeSchema.required.forEach((field) => requiredFields.add(field));
+                }
+            }
+        }
+        catch (error) {
+            // Schema loading failed
+        }
+        return requiredFields;
+    }
+    // For production schemas, use the cached loadSchema function
+    try {
+        const schema = await loadSchema(type, schemaDir);
+        if (schema.required && Array.isArray(schema.required)) {
+            schema.required.forEach((field) => requiredFields.add(field));
+        }
+    }
+    catch (error) {
+        // Schema might not exist yet
+    }
+    return requiredFields;
+}
+/**
+ * Gets all valid properties from the merged schema
+ */
+async function getAllSchemaProperties(type, schemaDir) {
+    const allProperties = new Set();
+    // For custom schema directories (like in tests), bypass loadSchema to avoid caching issues
+    if (schemaDir && !schemaDir.includes('content/schemas')) {
+        try {
+            // Load base schema properties
+            const baseSchemaPath = path.join(schemaDir, 'base.schema.json');
+            if (await fs.pathExists(baseSchemaPath)) {
+                const baseSchema = await fs.readJSON(baseSchemaPath);
+                if (baseSchema.properties) {
+                    Object.keys(baseSchema.properties).forEach(prop => allProperties.add(prop));
+                }
+            }
+            // Load type-specific schema properties
+            const typeSchemaPath = path.join(schemaDir, `${type}.schema.json`);
+            if (await fs.pathExists(typeSchemaPath)) {
+                const typeSchema = await fs.readJSON(typeSchemaPath);
+                if (typeSchema.properties) {
+                    Object.keys(typeSchema.properties).forEach(prop => allProperties.add(prop));
+                }
+            }
+        }
+        catch (error) {
+            // Schema loading failed
+        }
+        return allProperties;
+    }
+    // For production schemas, use the cached loadSchema function
+    try {
+        const schema = await loadSchema(type, schemaDir);
+        if (schema.properties) {
+            Object.keys(schema.properties).forEach(prop => allProperties.add(prop));
+        }
+    }
+    catch (error) {
+        // Schema might not exist yet
+    }
+    return allProperties;
+}
+/**
+ * Analyzes a template file and checks it against its schema
+ */
+export async function analyzeTemplate(templatePath, schema, schemaDir) {
+    const errors = [];
+    const warnings = [];
+    try {
+        // Read template content
+        const templateContent = await fs.readFile(templatePath, 'utf-8');
+        // Extract frontmatter
+        const { frontmatter, body, startLine } = extractFrontmatter(templateContent);
+        if (!frontmatter) {
+            errors.push({
+                type: 'error',
+                message: 'Template missing frontmatter block'
+            });
+            return { templatePath, errors, warnings };
+        }
+        // Get document type
+        const docType = getDocTypeFromTemplate(templatePath, frontmatter);
+        if (!docType) {
+            errors.push({
+                type: 'error',
+                message: 'Unable to determine document type from template'
+            });
+            return { templatePath, errors, warnings };
+        }
+        // Check for type const in frontmatter
+        const typePattern = new RegExp(`^type:\\s*${docType}\\s*$`, 'm');
+        if (!typePattern.test(frontmatter)) {
+            errors.push({
+                type: 'error',
+                message: `Frontmatter missing type constant field with value '${docType}'`,
+                field: 'type',
+                line: startLine
+            });
+        }
+        // Parse frontmatter keys
+        const frontmatterKeys = parseFrontmatterKeys(frontmatter);
+        // Extract all placeholders from entire template
+        const allPlaceholders = new Set([
+            ...extractPlaceholders(frontmatter),
+            ...extractPlaceholders(body)
+        ]);
+        // Get required fields from schema
+        const requiredFields = await getRequiredFields(docType, schemaDir);
+        // Check for missing required fields
+        for (const requiredField of requiredFields) {
+            // Skip 'type' as it should be a constant
+            if (requiredField === 'type')
+                continue;
+            // Check if field is in frontmatter or referenced as placeholder
+            if (!frontmatterKeys.has(requiredField) && !allPlaceholders.has(requiredField)) {
+                // Special case: 'now' helper can satisfy created/updated fields
+                if ((requiredField === 'created' || requiredField === 'updated') &&
+                    allPlaceholders.has('now')) {
+                    continue;
+                }
+                warnings.push({
+                    type: 'warning',
+                    message: `Required schema property '${requiredField}' is neither set nor referenced in template`,
+                    field: requiredField
+                });
+            }
+        }
+        // Get all valid schema properties
+        const allSchemaProperties = await getAllSchemaProperties(docType, schemaDir);
+        // Check for unknown placeholders
+        for (const placeholder of allPlaceholders) {
+            // Skip if it's a known helper
+            if (DEFAULT_HELPERS.includes(placeholder))
+                continue;
+            // Skip @-prefixed variables (Handlebars built-ins like @last, @index)
+            if (placeholder.startsWith('@'))
+                continue;
+            // Skip 'this' keyword
+            if (placeholder === 'this')
+                continue;
+            // Check if it's a valid schema property
+            if (!allSchemaProperties.has(placeholder)) {
+                warnings.push({
+                    type: 'warning',
+                    message: `Unknown placeholder '${placeholder}' not found in schema properties or registered helpers`,
+                    field: placeholder
+                });
+            }
+        }
+    }
+    catch (error) {
+        errors.push({
+            type: 'error',
+            message: `Failed to analyze template: ${error instanceof Error ? error.message : String(error)}`
+        });
+    }
+    return {
+        templatePath,
+        errors,
+        warnings
+    };
+}
+/**
+ * Lint all templates in a directory
+ */
+export async function lintTemplatesDirectory(templatesDir, schemaDir) {
+    const results = [];
+    try {
+        const templateFiles = await fs.readdir(templatesDir);
+        for (const file of templateFiles) {
+            if (file.endsWith('.hbs')) {
+                const templatePath = path.join(templatesDir, file);
+                const result = await analyzeTemplate(templatePath, undefined, schemaDir);
+                results.push(result);
+            }
+        }
+    }
+    catch (error) {
+        // Directory might not exist
+    }
+    return results;
+}
+//# sourceMappingURL=templateLint.js.map

package/dist/lib/templateLint.js.map

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

package/dist/lib/templates.d.ts

@@ -0,0 +1,53 @@
+import Handlebars from 'handlebars';
+/**
+ * Register custom Handlebars helpers
+ */
+export declare function registerHelpers(helpers: Record<string, Handlebars.HelperDelegate>): void;
+/**
+ * Register default helpers for Synapse templates
+ */
+export declare function registerDefaultHelpers(): void;
+/**
+ * Compile a single Handlebars template from file path
+ */
+export declare function compileTemplate(templatePath: string): Promise<HandlebarsTemplateDelegate>;
+/**
+ * Render a template with provided data
+ */
+export declare function renderTemplate(templatePath: string, data: Record<string, any>): Promise<string>;
+/**
+ * Discover all .hbs template files in a directory
+ */
+export declare function discoverTemplates(baseDir: string): Promise<string[]>;
+/**
+ * Compile and validate all templates, returning a report
+ */
+export declare function compileAllTemplates(templateDir: string): Promise<{
+    success: boolean;
+    templates: Array<{
+        path: string;
+        name: string;
+        compiled: boolean;
+        error?: string;
+    }>;
+}>;
+/**
+ * Get template metadata including required fields from analysis
+ */
+export declare function getTemplateMetadata(templatePath: string): Promise<{
+    name: string;
+    path: string;
+    variables: string[];
+    helpers: string[];
+}>;
+declare const _default: {
+    compileTemplate: typeof compileTemplate;
+    renderTemplate: typeof renderTemplate;
+    registerHelpers: typeof registerHelpers;
+    registerDefaultHelpers: typeof registerDefaultHelpers;
+    discoverTemplates: typeof discoverTemplates;
+    compileAllTemplates: typeof compileAllTemplates;
+    getTemplateMetadata: typeof getTemplateMetadata;
+};
+export default _default;
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/lib/templates.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AASpC;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAIxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAoB7C;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAO/F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAO1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ,CAAC,CA4BD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAwBD;;;;;;;;;;AAED,wBAQE"}