@millstone/synapse-cli 0.1.0

package/dist/lib/homepage.js

@@ -0,0 +1,172 @@
+import fsExtra from 'fs-extra';
+import * as path from 'path';
+import glob from 'fast-glob';
+import { getDocTypes, TEMPLATE_REGISTRY } from './types.generated.js';
+import { expectedFolder } from './naming.js';
+const fs = fsExtra;
+/**
+ * Count markdown files in a directory
+ */
+async function countMarkdownFiles(dirPath) {
+    try {
+        const files = await glob(['**/*.md'], {
+            cwd: dirPath,
+            absolute: false,
+            onlyFiles: true,
+            ignore: ['**/Examples/*.md', '**/templates/**']
+        });
+        return files.length;
+    }
+    catch (error) {
+        // Directory might not exist yet, which is fine
+        return 0;
+    }
+}
+/**
+ * Generate homepage content with navigation and getting started sections
+ */
+export async function generateHomepage(options = {}) {
+    const { contentDir = path.resolve(process.cwd(), 'content'), outputPath = path.join(contentDir, 'index.md') } = options;
+    console.log('Generating homepage...');
+    // Define the sections based on doc types
+    const sections = [];
+    // Get type config from registry with proper pluralization
+    const typeConfig = Object.entries(TEMPLATE_REGISTRY).reduce((acc, [type, metadata]) => {
+        // Special pluralization rules
+        let pluralLabel = metadata.displayLabel;
+        if (pluralLabel.endsWith('y') && !pluralLabel.endsWith('ey')) {
+            pluralLabel = pluralLabel.slice(0, -1) + 'ies'; // Policy -> Policies
+        }
+        else if (pluralLabel.endsWith('s') || pluralLabel.endsWith('x') || pluralLabel.endsWith('ch')) {
+            pluralLabel += 'es'; // Process -> Processes
+        }
+        else {
+            pluralLabel += 's'; // Standard -> Standards
+        }
+        acc[type] = {
+            label: pluralLabel,
+            collection: metadata.cmsCollection
+        };
+        return acc;
+    }, {});
+    // Build sections for each doc type
+    for (const docType of getDocTypes()) {
+        const folder = expectedFolder(docType);
+        const config = typeConfig[docType];
+        if (config && folder) {
+            // Remove 'content/' prefix since contentDir already contains it
+            const relativeFolderPath = folder.replace(/^content\//, '');
+            const folderPath = path.join(contentDir, relativeFolderPath);
+            const count = await countMarkdownFiles(folderPath);
+            // Debug logging
+            if (count > 0) {
+                console.log(`  ${config.label}: ${count} documents in ${folder}`);
+            }
+            sections.push({
+                type: docType,
+                label: config.label,
+                folder,
+                collection: config.collection,
+                count
+            });
+        }
+    }
+    // Build homepage content
+    let content = `# Synapse Documentation Framework
+
+Welcome to your centralized documentation hub. This framework provides a structured approach to managing technical and operational documentation.
+
+## Quick Navigation
+
+Navigate to documentation by type:
+
+`;
+    // Group sections by category for better organization
+    const policyGroup = sections.filter(s => ['policy', 'standard'].includes(s.type));
+    const processGroup = sections.filter(s => ['process', 'sop', 'runbook'].includes(s.type));
+    const meetingGroup = sections.filter(s => ['meeting', 'scorecard'].includes(s.type));
+    const architectureGroup = sections.filter(s => ['adr', 'tdd'].includes(s.type));
+    const productGroup = sections.filter(s => ['prd'].includes(s.type));
+    const systemGroup = sections.filter(s => ['system', 'capability'].includes(s.type));
+    // Add Policy & Standards section
+    if (policyGroup.length > 0) {
+        content += `### Governance & Standards\n\n`;
+        for (const section of policyGroup) {
+            content += `- **${section.label}** (${section.count}): [[${section.folder}]] • [Edit in CMS](/admin/#/collections/${section.collection})\n`;
+        }
+        content += '\n';
+    }
+    // Add Process & Operations section
+    if (processGroup.length > 0) {
+        content += `### Processes & Operations\n\n`;
+        for (const section of processGroup) {
+            content += `- **${section.label}** (${section.count}): [[${section.folder}]] • [Edit in CMS](/admin/#/collections/${section.collection})\n`;
+        }
+        content += '\n';
+    }
+    // Add Meetings & Assessments section
+    if (meetingGroup.length > 0) {
+        content += `### Meetings & Assessments\n\n`;
+        for (const section of meetingGroup) {
+            content += `- **${section.label}** (${section.count}): [[${section.folder}]] • [Edit in CMS](/admin/#/collections/${section.collection})\n`;
+        }
+        content += '\n';
+    }
+    // Add Architecture section
+    if (architectureGroup.length > 0) {
+        content += `### Architecture\n\n`;
+        for (const section of architectureGroup) {
+            content += `- **${section.label}** (${section.count}): [[${section.folder}]] • [Edit in CMS](/admin/#/collections/${section.collection})\n`;
+        }
+        content += '\n';
+    }
+    // Add Products section
+    if (productGroup.length > 0) {
+        content += `### Products\n\n`;
+        for (const section of productGroup) {
+            content += `- **${section.label}** (${section.count}): [[${section.folder}]] • [Edit in CMS](/admin/#/collections/${section.collection})\n`;
+        }
+        content += '\n';
+    }
+    // Add Systems & Capabilities section
+    if (systemGroup.length > 0) {
+        content += `### Systems & Capabilities\n\n`;
+        for (const section of systemGroup) {
+            content += `- **${section.label}** (${section.count}): [[${section.folder}]] • [Edit in CMS](/admin/#/collections/${section.collection})\n`;
+        }
+        content += '\n';
+    }
+    // Add Getting Started section
+    content += `## Getting Started
+
+New to the framework? Start here:
+
+- **[[00_Guides/Authoring Guide]]**: Learn how to create and maintain documentation
+- **[[00_Guides/Examples]]**: Browse example documents for each type
+
+## Recent Activity
+
+_This section will be automatically updated with recent changes._
+
+## Statistics
+
+Total documents: **${sections.reduce((sum, s) => sum + s.count, 0)}**
+
+| Type | Count |
+|------|-------|
+${sections.map(s => `| ${s.label} | ${s.count} |`).join('\n')}
+
+---
+
+_Last updated: ${new Date().toISOString()}_
+`;
+    // Ensure the output directory exists
+    await fs.ensureDir(path.dirname(outputPath));
+    // Write the homepage
+    await fs.writeFile(outputPath, content, 'utf-8');
+    console.log(`Homepage generated at: ${outputPath}`);
+    // Log summary
+    const totalDocs = sections.reduce((sum, s) => sum + s.count, 0);
+    console.log(`Total documents indexed: ${totalDocs}`);
+}
+//# sourceMappingURL=homepage.js.map

package/dist/lib/homepage.js.map

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

package/dist/lib/markdown.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Shared utilities for parsing and processing markdown documents
+ */
+import type { Root, Content } from 'mdast';
+/**
+ * Extracts raw frontmatter and body from markdown content
+ * @param content - The markdown content to parse
+ * @returns Object with raw frontmatter string, body, and line numbers
+ */
+export declare function extractFrontmatter(content: string): {
+    frontmatter: string;
+    body: string;
+    startLine: number;
+    endLine: number;
+};
+/**
+ * Parses markdown content into frontmatter data and body
+ * @param content - The markdown content to parse
+ * @returns Object with parsed frontmatter data and body
+ */
+export declare function parseDocument(content: string): {
+    frontmatter: any;
+    body: string;
+    raw: {
+        frontmatter: string;
+        startLine: number;
+        endLine: number;
+    };
+    error?: string;
+};
+/**
+ * Extracts wikilinks from markdown content
+ * @param content - The markdown content to parse
+ * @returns Array of wikilink targets (without the brackets)
+ */
+export declare function extractWikilinks(content: string): string[];
+/**
+ * Validates that a wikilink target exists in the vault
+ * @param linkTarget - The target of the wikilink (without brackets)
+ * @param existingFiles - Set of existing file paths in the vault
+ * @returns true if the target exists, false otherwise
+ */
+export declare function validateWikilinkExists(linkTarget: string, existingFiles: Set<string>): boolean;
+/**
+ * Extracts all {{placeholder}} references from template text
+ * Used primarily for template linting
+ */
+export declare function extractPlaceholders(text: string): Set<string>;
+/**
+ * Parses frontmatter keys from raw frontmatter string
+ * Used for template analysis without full YAML parsing
+ */
+export declare function parseFrontmatterKeys(frontmatter: string): Set<string>;
+/**
+ * Checks if a string value needs YAML quoting
+ * Returns true if the string contains characters that could cause YAML parsing issues
+ */
+export declare function needsYamlQuoting(value: string): boolean;
+/**
+ * Represents a section node extracted from the AST
+ */
+export interface SectionNode {
+    /** Section ID (normalized from title) */
+    id: string;
+    /** Original heading text */
+    title: string;
+    /** Heading depth (2 for H2, 3 for H3, etc.) */
+    depth: number;
+    /** Line number where the heading appears */
+    line: number;
+    /** Column number where the heading starts */
+    column: number;
+    /** AST nodes that are children of this section */
+    content: Content[];
+    /** Start position in the document */
+    position?: {
+        start: {
+            line: number;
+            column: number;
+            offset?: number;
+        };
+        end: {
+            line: number;
+            column: number;
+            offset?: number;
+        };
+    };
+}
+/**
+ * Parses markdown body text into an AST
+ * @param body - The markdown body content (without frontmatter)
+ * @returns The parsed AST root node
+ */
+export declare function parseMarkdown(body: string): Root;
+/**
+ * Finds all H2 sections in the AST and extracts their content
+ * @param ast - The parsed markdown AST
+ * @returns Array of section nodes with their content
+ */
+export declare function findSections(ast: Root): SectionNode[];
+/**
+ * Stringifies an AST back to markdown
+ * @param ast - The AST to stringify
+ * @returns The markdown string
+ */
+export declare function stringifyMarkdown(ast: Root): string;
+//# sourceMappingURL=markdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/lib/markdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,IAAI,EAAW,OAAO,EAAmB,MAAM,OAAO,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAkCA;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAC9C,WAAW,EAAE,GAAG,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE;QACH,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA0BA;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAe1D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,OAAO,CAwBT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAgC7D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAarE;AAGD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAiBvD;AAcD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,GAAG,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxD,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIhD;AAuDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,WAAW,EAAE,CA0CrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAQnD"}

package/dist/lib/markdown.js

@@ -0,0 +1,318 @@
+/**
+ * Shared utilities for parsing and processing markdown documents
+ */
+import * as yaml from 'js-yaml';
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import remarkStringify from 'remark-stringify';
+/**
+ * Extracts raw frontmatter and body from markdown content
+ * @param content - The markdown content to parse
+ * @returns Object with raw frontmatter string, body, and line numbers
+ */
+export function extractFrontmatter(content) {
+    const lines = content.split('\n');
+    let startLine = -1;
+    let endLine = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            if (startLine === -1) {
+                startLine = i;
+            }
+            else {
+                endLine = i;
+                break;
+            }
+        }
+    }
+    if (startLine === -1 || endLine === -1) {
+        return {
+            frontmatter: '',
+            body: content,
+            startLine: 0,
+            endLine: 0
+        };
+    }
+    const frontmatter = lines.slice(startLine + 1, endLine).join('\n');
+    const body = lines.slice(endLine + 1).join('\n');
+    return {
+        frontmatter,
+        body,
+        startLine: startLine + 1,
+        endLine
+    };
+}
+/**
+ * Parses markdown content into frontmatter data and body
+ * @param content - The markdown content to parse
+ * @returns Object with parsed frontmatter data and body
+ */
+export function parseDocument(content) {
+    const extracted = extractFrontmatter(content);
+    let frontmatterData = {};
+    let parseError;
+    if (extracted.frontmatter) {
+        try {
+            frontmatterData = yaml.load(extracted.frontmatter) || {};
+        }
+        catch (error) {
+            // Capture the error but still return empty frontmatter
+            parseError = error instanceof Error ? error.message : String(error);
+            console.warn('Failed to parse frontmatter YAML:', error);
+        }
+    }
+    return {
+        frontmatter: frontmatterData,
+        body: extracted.body,
+        raw: {
+            frontmatter: extracted.frontmatter,
+            startLine: extracted.startLine,
+            endLine: extracted.endLine
+        },
+        error: parseError
+    };
+}
+/**
+ * Extracts wikilinks from markdown content
+ * @param content - The markdown content to parse
+ * @returns Array of wikilink targets (without the brackets)
+ */
+export function extractWikilinks(content) {
+    const wikilinks = [];
+    // Match [[Link]] and [[Link|Display Text]] patterns
+    const wikilinkRegex = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
+    let match;
+    while ((match = wikilinkRegex.exec(content)) !== null) {
+        const linkTarget = match[1].trim();
+        if (linkTarget && !wikilinks.includes(linkTarget)) {
+            wikilinks.push(linkTarget);
+        }
+    }
+    return wikilinks;
+}
+/**
+ * Validates that a wikilink target exists in the vault
+ * @param linkTarget - The target of the wikilink (without brackets)
+ * @param existingFiles - Set of existing file paths in the vault
+ * @returns true if the target exists, false otherwise
+ */
+export function validateWikilinkExists(linkTarget, existingFiles) {
+    // Normalize the link target to handle various cases
+    const normalizedTarget = linkTarget.toLowerCase().replace(/\s+/g, '-');
+    // Check if any file matches the link target
+    for (const file of existingFiles) {
+        const normalizedFile = file.toLowerCase();
+        const fileBasename = normalizedFile.split('/').pop() || '';
+        const fileWithoutExt = fileBasename.replace(/\.md$/, '');
+        // Check various matching patterns
+        if (normalizedFile.endsWith(`/${normalizedTarget}.md`) ||
+            normalizedFile.endsWith(`-${normalizedTarget}.md`) ||
+            normalizedFile.endsWith(`/${normalizedTarget}`) ||
+            normalizedFile.endsWith(`-${normalizedTarget}`) ||
+            fileWithoutExt === normalizedTarget ||
+            fileWithoutExt.endsWith(`-${normalizedTarget}`) ||
+            normalizedFile === `${normalizedTarget}.md` ||
+            normalizedFile === normalizedTarget) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extracts all {{placeholder}} references from template text
+ * Used primarily for template linting
+ */
+export function extractPlaceholders(text) {
+    const placeholders = new Set();
+    // Match {{variable}} or {{#helper variable}} or {{/helper}}
+    const regex = /\{\{(?:#|\/)?([^}#/\s]+)(?:\s+([^}]+))?\}\}/g;
+    let match;
+    while ((match = regex.exec(text)) !== null) {
+        const [fullMatch, helper, args] = match;
+        // Skip closing tags
+        if (fullMatch.startsWith('{{/')) {
+            continue;
+        }
+        // For block helpers like {{#each}}, extract the variable being iterated
+        if (fullMatch.startsWith('{{#')) {
+            if (args) {
+                // Extract the variable name from the arguments
+                const varName = args.trim().split(/\s+/)[0];
+                if (varName && !varName.includes('}')) {
+                    placeholders.add(varName);
+                }
+            }
+        }
+        else {
+            // Regular placeholder - skip default helpers
+            if (!isDefaultHelper(helper)) {
+                placeholders.add(helper);
+            }
+        }
+    }
+    return placeholders;
+}
+/**
+ * Parses frontmatter keys from raw frontmatter string
+ * Used for template analysis without full YAML parsing
+ */
+export function parseFrontmatterKeys(frontmatter) {
+    const keys = new Set();
+    const lines = frontmatter.split('\n');
+    for (const line of lines) {
+        // Match 'key: value' pattern at the start of a line
+        const match = line.match(/^(\w+):/);
+        if (match) {
+            keys.add(match[1]);
+        }
+    }
+    return keys;
+}
+// Helper function for placeholder extraction
+/**
+ * Checks if a string value needs YAML quoting
+ * Returns true if the string contains characters that could cause YAML parsing issues
+ */
+export function needsYamlQuoting(value) {
+    if (typeof value !== 'string')
+        return false;
+    // Check for problematic patterns
+    const problematicPatterns = [
+        /:/, // Colons can be interpreted as key-value separator
+        /\n/, // Newlines need proper handling
+        /^['"]/, // Starting quotes
+        /^[!&*]/, // YAML special characters
+        /^-\s/, // Looks like a list item
+        /^\s/, // Leading whitespace
+        /\s$/, // Trailing whitespace
+        /^(true|false|null|yes|no|on|off)$/i, // YAML keywords
+        /^\d+$/, // Pure numbers
+    ];
+    return problematicPatterns.some(pattern => pattern.test(value));
+}
+/**
+ * Checks if a helper name is a default Handlebars helper
+ */
+function isDefaultHelper(name) {
+    const DEFAULT_HELPERS = ['now', 'each', 'unless', 'if', 'with'];
+    return DEFAULT_HELPERS.includes(name);
+}
+/**
+ * Parses markdown body text into an AST
+ * @param body - The markdown body content (without frontmatter)
+ * @returns The parsed AST root node
+ */
+export function parseMarkdown(body) {
+    const processor = unified().use(remarkParse).use(remarkGfm);
+    const ast = processor.parse(body);
+    return ast;
+}
+/**
+ * Extracts heading text from a heading node, stripping HTML anchors
+ * @param heading - The heading node from the AST
+ * @returns The clean heading text
+ */
+function extractHeadingText(heading) {
+    let text = '';
+    for (const child of heading.children) {
+        if (child.type === 'text') {
+            text += child.value;
+        }
+        else if (child.type === 'html') {
+            // Skip HTML anchor tags like <a id="summary"/>
+            continue;
+        }
+        else if ('children' in child) {
+            // Handle nested inline elements (emphasis, strong, etc.)
+            text += extractInlineText(child.children);
+        }
+    }
+    return text.trim();
+}
+/**
+ * Extracts text from phrasing content (inline elements)
+ */
+function extractInlineText(children) {
+    let text = '';
+    for (const child of children) {
+        if (child.type === 'text') {
+            text += child.value;
+        }
+        else if ('children' in child) {
+            text += extractInlineText(child.children);
+        }
+    }
+    return text;
+}
+/**
+ * Normalizes a section title to an ID
+ * @param title - The section title
+ * @returns The normalized section ID
+ */
+function normalizeSectionId(title) {
+    return title
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '') // Remove special characters
+        .replace(/\s+/g, '-') // Replace spaces with dashes
+        .replace(/-+/g, '-') // Replace multiple dashes with single dash
+        .replace(/^-+|-+$/g, ''); // Remove leading/trailing dashes
+}
+/**
+ * Finds all H2 sections in the AST and extracts their content
+ * @param ast - The parsed markdown AST
+ * @returns Array of section nodes with their content
+ */
+export function findSections(ast) {
+    const sections = [];
+    const children = ast.children;
+    let currentSection = null;
+    for (let i = 0; i < children.length; i++) {
+        const node = children[i];
+        // Check if this is an H2 heading
+        if (node.type === 'heading' && node.depth === 2) {
+            // Save the previous section if it exists
+            if (currentSection) {
+                sections.push(currentSection);
+            }
+            // Start a new section
+            const title = extractHeadingText(node);
+            const id = normalizeSectionId(title);
+            currentSection = {
+                id,
+                title,
+                depth: node.depth,
+                line: node.position?.start.line || 0,
+                column: node.position?.start.column || 0,
+                content: [],
+                position: node.position
+            };
+        }
+        else if (currentSection) {
+            // Add content to the current section
+            currentSection.content.push(node);
+        }
+        // Ignore content before the first H2 section
+    }
+    // Add the last section
+    if (currentSection) {
+        sections.push(currentSection);
+    }
+    return sections;
+}
+/**
+ * Stringifies an AST back to markdown
+ * @param ast - The AST to stringify
+ * @returns The markdown string
+ */
+export function stringifyMarkdown(ast) {
+    const processor = unified().use(remarkStringify, {
+        bullet: '-',
+        emphasis: '_',
+        fences: true,
+        incrementListMarker: true,
+    });
+    return processor.stringify(ast);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/lib/markdown.js.map

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

package/dist/lib/mode-detection.d.ts

@@ -0,0 +1,10 @@
+export type InstallMode = 'fork' | 'npm' | 'unknown';
+/**
+ * Detect whether the current project is using fork-based or npm-based distribution.
+ *
+ * - Fork mode: `.synapse-upstream` file exists in project root
+ * - NPM mode: `@synapse/schemas` is resolvable via require.resolve
+ * - Unknown: neither detected
+ */
+export declare function detectInstallMode(cwd?: string): InstallMode;
+//# sourceMappingURL=mode-detection.d.ts.map

package/dist/lib/mode-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detection.d.ts","sourceRoot":"","sources":["../../src/lib/mode-detection.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAmB3D"}

package/dist/lib/mode-detection.js

@@ -0,0 +1,29 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { createRequire } from 'module';
+/**
+ * Detect whether the current project is using fork-based or npm-based distribution.
+ *
+ * - Fork mode: `.synapse-upstream` file exists in project root
+ * - NPM mode: `@synapse/schemas` is resolvable via require.resolve
+ * - Unknown: neither detected
+ */
+export function detectInstallMode(cwd) {
+    const rootDir = cwd ?? process.cwd();
+    // Fork mode: .synapse-upstream tracking file exists
+    const upstreamPath = path.join(rootDir, '.synapse-upstream');
+    if (fs.existsSync(upstreamPath)) {
+        return 'fork';
+    }
+    // NPM mode: @synapse/schemas is resolvable
+    try {
+        const require = createRequire(path.join(rootDir, 'package.json'));
+        require.resolve('@synapse/schemas/package.json');
+        return 'npm';
+    }
+    catch {
+        // Package not installed
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=mode-detection.js.map