@theglitchking/hit-em-with-the-docs 2.0.0

package/dist/generators/scaffold.d.ts

@@ -0,0 +1,30 @@
+import { type Domain } from '../core/domains/constants.js';
+export interface ScaffoldOptions {
+    rootPath: string;
+    overwrite?: boolean;
+    domains?: Domain[];
+    silent?: boolean;
+}
+export interface ScaffoldResult {
+    success: boolean;
+    created: string[];
+    skipped: string[];
+    errors: string[];
+}
+/**
+ * Create the complete documentation scaffold
+ */
+export declare function createScaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
+/**
+ * Check if scaffold already exists
+ */
+export declare function scaffoldExists(rootPath: string): Promise<boolean>;
+/**
+ * Get scaffold status
+ */
+export declare function getScaffoldStatus(rootPath: string): Promise<{
+    exists: boolean;
+    domains: Domain[];
+    missingDomains: Domain[];
+}>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/generators/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/generators/scaffold.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAQxF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAsDtF;AA6KD;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC,CA4BD"}

package/dist/generators/scaffold.js

@@ -0,0 +1,213 @@
+import { mkdir, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { DOMAINS, DOMAIN_DEFINITIONS } from '../core/domains/constants.js';
+import { generateRootIndex } from './index-generator.js';
+import { generateRootRegistry } from './registry-generator.js';
+import { generateDomainIndex } from './templates/domain-index.js';
+import { generateDomainRegistry } from './templates/domain-registry.js';
+import { logger } from '../utils/logger.js';
+import { pathExists } from '../utils/glob.js';
+/**
+ * Create the complete documentation scaffold
+ */
+export async function createScaffold(options) {
+    const { rootPath, overwrite = false, domains = [...DOMAINS], silent = false, } = options;
+    const result = {
+        success: true,
+        created: [],
+        skipped: [],
+        errors: [],
+    };
+    if (!silent) {
+        logger.header('Creating Documentation Scaffold');
+        logger.info(`Root path: ${rootPath}`);
+        logger.info(`Domains: ${domains.length}`);
+    }
+    try {
+        // Create root directory
+        await createDirectory(rootPath, result, overwrite);
+        // Create root files
+        await createRootFiles(rootPath, result, overwrite);
+        // Create domain directories and files
+        for (const domain of domains) {
+            await createDomainStructure(rootPath, domain, result, overwrite);
+        }
+        // Create special directories
+        await createSpecialDirectories(rootPath, result, overwrite);
+        if (!silent) {
+            logger.newline();
+            logger.success(`Scaffold created successfully!`);
+            logger.info(`Created: ${result.created.length} files/directories`);
+            if (result.skipped.length > 0) {
+                logger.warn(`Skipped: ${result.skipped.length} (already exist)`);
+            }
+        }
+    }
+    catch (error) {
+        result.success = false;
+        const message = error instanceof Error ? error.message : String(error);
+        result.errors.push(message);
+        if (!silent) {
+            logger.error(`Failed to create scaffold: ${message}`);
+        }
+    }
+    return result;
+}
+/**
+ * Create a directory if it doesn't exist
+ */
+async function createDirectory(path, result, overwrite) {
+    const exists = await pathExists(path);
+    if (exists && !overwrite) {
+        result.skipped.push(path);
+        return;
+    }
+    await mkdir(path, { recursive: true });
+    result.created.push(path);
+}
+/**
+ * Create a file if it doesn't exist
+ */
+async function createFile(path, content, result, overwrite) {
+    const exists = await pathExists(path);
+    if (exists && !overwrite) {
+        result.skipped.push(path);
+        return;
+    }
+    await writeFile(path, content, 'utf-8');
+    result.created.push(path);
+}
+/**
+ * Create root-level files
+ */
+async function createRootFiles(rootPath, result, overwrite) {
+    // INDEX.md
+    const indexContent = generateRootIndex();
+    await createFile(join(rootPath, 'INDEX.md'), indexContent, result, overwrite);
+    // REGISTRY.md
+    const registryContent = generateRootRegistry();
+    await createFile(join(rootPath, 'REGISTRY.md'), registryContent, result, overwrite);
+    // README.md
+    const readmeContent = generateRootReadme();
+    await createFile(join(rootPath, 'README.md'), readmeContent, result, overwrite);
+}
+/**
+ * Create domain directory structure
+ */
+async function createDomainStructure(rootPath, domain, result, overwrite) {
+    const domainPath = join(rootPath, domain);
+    const def = DOMAIN_DEFINITIONS[domain];
+    // Create domain directory
+    await createDirectory(domainPath, result, overwrite);
+    // Create INDEX.md
+    const indexContent = generateDomainIndex(domain, def);
+    await createFile(join(domainPath, 'INDEX.md'), indexContent, result, overwrite);
+    // Create REGISTRY.md
+    const registryContent = generateDomainRegistry(domain, def);
+    await createFile(join(domainPath, 'REGISTRY.md'), registryContent, result, overwrite);
+}
+/**
+ * Create special directories (drafts, reports)
+ */
+async function createSpecialDirectories(rootPath, result, overwrite) {
+    // Drafts directory
+    await createDirectory(join(rootPath, 'drafts'), result, overwrite);
+    // Reports directory
+    await createDirectory(join(rootPath, 'reports'), result, overwrite);
+    // Create .gitkeep files to preserve empty directories
+    await createFile(join(rootPath, 'drafts', '.gitkeep'), '# This file ensures the drafts directory is tracked by git\n', result, overwrite);
+    await createFile(join(rootPath, 'reports', '.gitkeep'), '# This file ensures the reports directory is tracked by git\n', result, overwrite);
+}
+/**
+ * Generate root README content
+ */
+function generateRootReadme() {
+    return `# Documentation
+
+This documentation system uses a hierarchical 15-domain structure for optimal organization and discoverability.
+
+## Quick Navigation
+
+- **[INDEX.md](INDEX.md)** - Complete document listing with metadata
+- **[REGISTRY.md](REGISTRY.md)** - Quick reference tables
+
+## Domains
+
+| Domain | Description |
+|--------|-------------|
+${DOMAINS.map((d) => `| [${d}](${d}/) | ${DOMAIN_DEFINITIONS[d].description} |`).join('\n')}
+
+## Adding New Documentation
+
+1. Identify the correct domain for your document
+2. Create the file in the domain directory
+3. Add YAML frontmatter with required metadata
+4. Run \`npx hit-em-with-the-docs integrate <file>\` to register
+
+## Metadata Schema
+
+Every document should include:
+
+\`\`\`yaml
+---
+title: "Document Title"
+tier: guide|standard|example|reference|admin
+domains: [primary-domain]
+status: draft|active|deprecated|archived
+last_updated: 'YYYY-MM-DD'
+version: '1.0.0'
+---
+\`\`\`
+
+## Maintenance
+
+Run weekly maintenance with:
+
+\`\`\`bash
+npx hit-em-with-the-docs maintain
+\`\`\`
+
+This will:
+- Sync metadata across all documents
+- Check for broken links
+- Audit compliance
+- Generate health reports
+`;
+}
+/**
+ * Check if scaffold already exists
+ */
+export async function scaffoldExists(rootPath) {
+    const indexPath = join(rootPath, 'INDEX.md');
+    return pathExists(indexPath);
+}
+/**
+ * Get scaffold status
+ */
+export async function getScaffoldStatus(rootPath) {
+    const exists = await scaffoldExists(rootPath);
+    if (!exists) {
+        return {
+            exists: false,
+            domains: [],
+            missingDomains: [...DOMAINS],
+        };
+    }
+    const presentDomains = [];
+    const missingDomains = [];
+    for (const domain of DOMAINS) {
+        const domainPath = join(rootPath, domain);
+        if (await pathExists(domainPath)) {
+            presentDomains.push(domain);
+        }
+        else {
+            missingDomains.push(domain);
+        }
+    }
+    return {
+        exists: true,
+        domains: presentDomains,
+        missingDomains,
+    };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/generators/scaffold.js.map

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

package/dist/generators/templates/document.d.ts

@@ -0,0 +1,14 @@
+import type { Domain } from '../../core/domains/constants.js';
+import type { Tier } from '../../core/domains/classifier.js';
+export interface DocumentTemplateOptions {
+    title: string;
+    tier?: Tier;
+    domain?: Domain;
+    author?: string;
+    tags?: string[];
+}
+/**
+ * Generate a new document template with frontmatter
+ */
+export declare function generateDocumentTemplate(options: DocumentTemplateOptions): string;
+//# sourceMappingURL=document.d.ts.map

package/dist/generators/templates/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/generators/templates/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAG7D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAkCjF"}

package/dist/generators/templates/document.js

@@ -0,0 +1,305 @@
+import { formatDate } from '../../core/metadata/generator.js';
+/**
+ * Generate a new document template with frontmatter
+ */
+export function generateDocumentTemplate(options) {
+    const { title, tier = 'guide', domain = 'features', author, tags = [], } = options;
+    const now = formatDate(new Date());
+    let frontmatter = `---
+title: "${title}"
+tier: ${tier}
+domains:
+  - ${domain}
+audience:
+  - all
+tags:
+${tags.length > 0 ? tags.map((t) => `  - ${t}`).join('\n') : '  []'}
+status: draft
+last_updated: '${now}'
+version: '1.0.0'
+`;
+    if (author) {
+        frontmatter += `author: "${author}"\n`;
+    }
+    frontmatter += `---`;
+    const body = getTemplateBody(tier, title);
+    return `${frontmatter}\n\n${body}`;
+}
+/**
+ * Get tier-specific template body
+ */
+function getTemplateBody(tier, title) {
+    switch (tier) {
+        case 'guide':
+            return getGuideTemplate(title);
+        case 'standard':
+            return getStandardTemplate(title);
+        case 'example':
+            return getExampleTemplate(title);
+        case 'reference':
+            return getReferenceTemplate(title);
+        case 'admin':
+            return getAdminTemplate(title);
+        default:
+            return getGuideTemplate(title);
+    }
+}
+function getGuideTemplate(title) {
+    return `# ${title}
+
+## Overview
+
+[Brief description of what this guide covers and who it's for.]
+
+## Prerequisites
+
+- [ ] Prerequisite 1
+- [ ] Prerequisite 2
+
+## Steps
+
+### Step 1: [First Step Title]
+
+[Instructions for the first step.]
+
+\`\`\`bash
+# Example command
+\`\`\`
+
+### Step 2: [Second Step Title]
+
+[Instructions for the second step.]
+
+### Step 3: [Third Step Title]
+
+[Instructions for the third step.]
+
+## Verification
+
+To verify the setup is correct:
+
+1. [Verification step 1]
+2. [Verification step 2]
+
+## Troubleshooting
+
+### Common Issue 1
+
+**Problem:** [Description]
+
+**Solution:** [How to fix]
+
+### Common Issue 2
+
+**Problem:** [Description]
+
+**Solution:** [How to fix]
+
+## Related Documentation
+
+- [Related Doc 1](path/to/doc1.md)
+- [Related Doc 2](path/to/doc2.md)
+`;
+}
+function getStandardTemplate(title) {
+    return `# ${title}
+
+## Overview
+
+[Description of what this standard covers and why it exists.]
+
+## Rules
+
+### Rule 1: [Rule Name]
+
+**DO:**
+- [Correct approach]
+
+**DON'T:**
+- [Incorrect approach]
+
+**Example:**
+
+\`\`\`typescript
+// Good
+const example = 'correct';
+
+// Bad
+const example = 'incorrect';
+\`\`\`
+
+### Rule 2: [Rule Name]
+
+[Rule description and rationale.]
+
+## Exceptions
+
+[Any exceptions to these rules and when they apply.]
+
+## Enforcement
+
+- [ ] Automated by linter
+- [ ] Checked in code review
+- [ ] Manual verification required
+
+## References
+
+- [External Reference 1](https://example.com)
+- [Related Standard](path/to/standard.md)
+`;
+}
+function getExampleTemplate(title) {
+    return `# ${title}
+
+## Overview
+
+[Brief description of what this example demonstrates.]
+
+## Use Case
+
+[When you would use this pattern/approach.]
+
+## Code Example
+
+\`\`\`typescript
+// Example implementation
+function example() {
+  // Your code here
+}
+\`\`\`
+
+## Explanation
+
+1. **Line X:** [Explanation of what this part does]
+2. **Line Y:** [Explanation of what this part does]
+
+## Variations
+
+### Variation 1: [Name]
+
+\`\`\`typescript
+// Alternative approach
+\`\`\`
+
+## Related Examples
+
+- [Related Example 1](path/to/example1.md)
+- [Related Example 2](path/to/example2.md)
+`;
+}
+function getReferenceTemplate(title) {
+    return `# ${title}
+
+## Overview
+
+[Description of what this reference documents.]
+
+## API Reference
+
+### Method/Function Name
+
+\`\`\`typescript
+function methodName(param1: Type, param2: Type): ReturnType
+\`\`\`
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| param1 | Type | Yes | Description |
+| param2 | Type | No | Description |
+
+**Returns:**
+
+\`ReturnType\` - Description of return value.
+
+**Example:**
+
+\`\`\`typescript
+const result = methodName('value1', 'value2');
+\`\`\`
+
+## Types
+
+### TypeName
+
+\`\`\`typescript
+interface TypeName {
+  property1: string;
+  property2: number;
+}
+\`\`\`
+
+## Constants
+
+| Name | Value | Description |
+|------|-------|-------------|
+| CONSTANT_1 | 'value' | Description |
+
+## See Also
+
+- [Related Reference](path/to/reference.md)
+`;
+}
+function getAdminTemplate(title) {
+    return `# ${title}
+
+## Overview
+
+[Description of this administrative procedure.]
+
+## Prerequisites
+
+- [ ] Required access/permissions
+- [ ] Required tools installed
+
+## Configuration
+
+### Setting 1
+
+\`\`\`yaml
+# Configuration example
+setting: value
+\`\`\`
+
+## Procedures
+
+### Procedure 1: [Name]
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Procedure 2: [Name]
+
+1. [Step 1]
+2. [Step 2]
+
+## Monitoring
+
+[How to monitor this system/service.]
+
+## Backup & Recovery
+
+### Backup Procedure
+
+1. [Backup step 1]
+2. [Backup step 2]
+
+### Recovery Procedure
+
+1. [Recovery step 1]
+2. [Recovery step 2]
+
+## Troubleshooting
+
+| Symptom | Cause | Resolution |
+|---------|-------|------------|
+| [Symptom] | [Cause] | [Fix] |
+
+## Related Documentation
+
+- [Related Admin Doc](path/to/admin.md)
+`;
+}
+//# sourceMappingURL=document.js.map

package/dist/generators/templates/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/generators/templates/document.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAU9D;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAgC;IACvE,MAAM,EACJ,KAAK,EACL,IAAI,GAAG,OAAO,EACd,MAAM,GAAG,UAAU,EACnB,MAAM,EACN,IAAI,GAAG,EAAE,GACV,GAAG,OAAO,CAAC;IAEZ,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAEnC,IAAI,WAAW,GAAG;UACV,KAAK;QACP,IAAI;;MAEN,MAAM;;;;EAIV,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;;iBAElD,GAAG;;CAEnB,CAAC;IAEA,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,IAAI,YAAY,MAAM,KAAK,CAAC;IACzC,CAAC;IAED,WAAW,IAAI,KAAK,CAAC;IAErB,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAE1C,OAAO,GAAG,WAAW,OAAO,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAU,EAAE,KAAa;IAChD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,UAAU;YACb,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACnC,KAAK,WAAW;YACd,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACrC,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjC;YACE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDlB,CAAC;AACF,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ClB,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoClB,CAAC;AACF,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDlB,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DlB,CAAC;AACF,CAAC"}

package/dist/generators/templates/domain-index.d.ts

@@ -0,0 +1,6 @@
+import type { Domain, DomainDefinition } from '../../core/domains/constants.js';
+/**
+ * Generate initial domain INDEX.md content
+ */
+export declare function generateDomainIndex(domain: Domain, def: DomainDefinition): string;
+//# sourceMappingURL=domain-index.d.ts.map

package/dist/generators/templates/domain-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-index.d.ts","sourceRoot":"","sources":["../../../src/generators/templates/domain-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGhF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CA+DjF"}

package/dist/generators/templates/domain-index.js

@@ -0,0 +1,68 @@
+import { formatDate } from '../../core/metadata/generator.js';
+/**
+ * Generate initial domain INDEX.md content
+ */
+export function generateDomainIndex(domain, def) {
+    const now = formatDate(new Date());
+    return `---
+title: ${def.name} Documentation Index
+tier: reference
+domains:
+  - ${domain}
+status: active
+last_updated: '${now}'
+version: '1.0.0'
+purpose: Complete listing of ${domain} documentation
+---
+
+# ${def.name} Documentation
+
+> ${def.description}
+
+## Overview
+
+- **Domain:** \`${domain}/\`
+- **Category:** ${def.category}
+- **Load Priority:** ${def.loadPriority}/10
+
+## Documents
+
+*No documents in this domain yet.*
+
+### Adding Documents
+
+1. Create a markdown file in this directory
+2. Add YAML frontmatter with required metadata:
+
+\`\`\`yaml
+---
+title: "Your Document Title"
+tier: guide
+domains:
+  - ${domain}
+status: draft
+last_updated: '${now}'
+version: '1.0.0'
+---
+\`\`\`
+
+3. Run \`npx hit-em-with-the-docs integrate <file>\` to register
+
+## Keywords
+
+This domain covers topics related to:
+
+${def.keywords.map((k) => `- ${k}`).join('\n')}
+
+## Related Resources
+
+- [Domain Registry](REGISTRY.md) - Quick reference
+- [Root Index](../INDEX.md) - All documentation
+- [Standards](../standards/) - Coding standards
+
+---
+
+*Last updated: ${now}*
+`;
+}
+//# sourceMappingURL=domain-index.js.map

package/dist/generators/templates/domain-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-index.js","sourceRoot":"","sources":["../../../src/generators/templates/domain-index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,GAAqB;IACvE,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAEnC,OAAO;SACA,GAAG,CAAC,IAAI;;;MAGX,MAAM;;iBAEK,GAAG;;+BAEW,MAAM;;;IAGjC,GAAG,CAAC,IAAI;;IAER,GAAG,CAAC,WAAW;;;;kBAID,MAAM;kBACN,GAAG,CAAC,QAAQ;uBACP,GAAG,CAAC,YAAY;;;;;;;;;;;;;;;;MAgBjC,MAAM;;iBAEK,GAAG;;;;;;;;;;;EAWlB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;iBAU7B,GAAG;CACnB,CAAC;AACF,CAAC"}

package/dist/generators/templates/domain-registry.d.ts

@@ -0,0 +1,6 @@
+import type { Domain, DomainDefinition } from '../../core/domains/constants.js';
+/**
+ * Generate initial domain REGISTRY.md content
+ */
+export declare function generateDomainRegistry(domain: Domain, def: DomainDefinition): string;
+//# sourceMappingURL=domain-registry.d.ts.map

package/dist/generators/templates/domain-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-registry.d.ts","sourceRoot":"","sources":["../../../src/generators/templates/domain-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGhF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAsDpF"}