@nepopsx/cli 0.0.3 → 0.0.5

package/dist/enrichment/workflow.js

@@ -0,0 +1,305 @@
+// @nepopsx/cli — Enrichment workflow: gate check + single-agent enrichment
+//
+// Architecture:
+//   scan command      → full workspace + agent enrichment (the only enrichment surface)
+//   install command   → checkEnrichmentGate() + enrichSingleAgent() if workspace already done
+//   sync command      → checkEnrichmentGate() only (fail fast if not enriched)
+//
+// This module exports:
+//   checkEnrichmentGate      — read-only check, no LLM, no push
+//   checkAgentEnrichmentGate — per-agent read-only check
+//   enrichSingleAgent        — enriches one agent when workspace is already enriched
+//   enrichAgentConfig        — raw LLM enrichment (also used by scan)
+//   buildAgentEnrichmentPrompt — prompt builder (also used by scan)
+//   readWorkspaceConfig      — shared helper
+//   writeAgentConfigFile     — shared helper
+//   buildConfigSchema        — shared helper
+import chalk from 'chalk';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parse, stringify } from 'yaml';
+import { confirm } from '@inquirer/prompts';
+import { validateWorkspaceConfig, } from '@nepopsx/core';
+import { getAgentConfigPath } from '../agents/configuration.js';
+import { loadLocalAgentConfig, pushRemoteAgentConfig, } from '../agents/remote-config.js';
+import { loadCustomInstructions } from '../customs/instructions.js';
+import { createEnrichmentMetadata, hashRecord, readLocalEnrichmentState, writeLocalEnrichmentState, } from './state.js';
+import { downloadBootstrapConfig } from '../licensing/installer.js';
+import { resolveScanConfig } from '../scan/config.js';
+import { createProvider } from '../scan/llm/factory.js';
+const WORKSPACE_CONFIG_PATH = '.nepopsx/workspace.yaml';
+// ─── checkEnrichmentGate ─────────────────────────────────────
+// Read-only check.  Never runs LLM.  Never pushes to backend.
+export function checkEnrichmentGate(rootDir) {
+    const localState = readLocalEnrichmentState(rootDir);
+    const config = readWorkspaceConfig(rootDir);
+    const currentHash = hashRecord(config);
+    const workspaceEnrichment = localState.workspace;
+    if (!workspaceEnrichment || workspaceEnrichment.status !== 'enriched') {
+        return {
+            ready: false,
+            reason: 'Workspace has not been scanned yet. Run `nepopsx scan` first.',
+            localState,
+            config,
+            workspaceEnrichment: null,
+        };
+    }
+    if (workspaceEnrichment.configHash !== currentHash) {
+        return {
+            ready: false,
+            reason: 'Workspace config has changed since the last scan. Run `nepopsx scan` to re-enrich.',
+            localState,
+            config,
+            workspaceEnrichment,
+        };
+    }
+    return {
+        ready: true,
+        localState,
+        config,
+        workspaceEnrichment,
+    };
+}
+export function checkAgentEnrichmentGate(localState, agentName, currentConfig) {
+    const saved = localState.agents[agentName];
+    if (!saved || saved.status !== 'enriched') {
+        return {
+            ready: false,
+            reason: `Agent "${agentName}" has not been enriched yet.`,
+        };
+    }
+    const currentHash = hashRecord(currentConfig);
+    if (saved.configHash !== currentHash) {
+        return {
+            ready: false,
+            reason: `Agent "${agentName}" config has changed since last enrichment. Re-run scan.`,
+        };
+    }
+    return { ready: true, enrichment: saved };
+}
+// ─── enrichSingleAgent ──────────────────────────────────────
+// Called by `install` when workspace is already enriched but
+// the specific agent hasn't been enriched yet.  Asks for user
+// confirmation before the LLM call and before the backend push.
+export async function enrichSingleAgent(rootDir, license, agentName, requestedVersion, workspaceConfig, localState, workspaceEnrichment, options) {
+    const customInstructions = loadCustomInstructions(resolve(rootDir, workspaceConfig.customs_dir ?? 'customs'));
+    const bootstrap = await downloadBootstrapConfig(rootDir, license, agentName, requestedVersion, customInstructions);
+    const currentConfig = loadLocalAgentConfig(rootDir, agentName, workspaceConfig.agents?.[agentName]) ?? bootstrap.config;
+    const currentHash = hashRecord(currentConfig);
+    const defaultHash = hashRecord(bootstrap.config);
+    console.log(chalk.bold.cyan(`\n🧠 Enriching ${agentName} config with LLM...\n`));
+    if (!options.yes) {
+        const proceed = await confirm({
+            message: `Enrich ${agentName} config using your LLM provider?`,
+            default: true,
+        });
+        if (!proceed) {
+            throw new Error('Agent enrichment cancelled by user.');
+        }
+    }
+    const resolvedScanConfig = await resolveScanConfig({ yes: true }, rootDir);
+    const provider = createProvider(resolvedScanConfig);
+    const providerRuntime = {
+        model: resolvedScanConfig.model,
+        providerName: provider.name,
+        chat: provider.chat.bind(provider),
+    };
+    console.log(chalk.dim(`  Using ${providerRuntime.providerName} (${providerRuntime.model})...`));
+    const enrichedConfig = await enrichAgentConfig(agentName, workspaceConfig, currentConfig, bootstrap.package, customInstructions, providerRuntime);
+    const enrichedHash = hashRecord(enrichedConfig);
+    if (enrichedHash === currentHash && currentHash === defaultHash) {
+        throw new Error(`${agentName} config is still at its default shape after enrichment. Cannot proceed.`);
+    }
+    const configPath = getAgentConfigPath(agentName, workspaceConfig.agents?.[agentName]);
+    writeAgentConfigFile(rootDir, configPath, enrichedConfig);
+    const enrichment = createEnrichmentMetadata(enrichedConfig, 'llm', new Date().toISOString(), providerRuntime.model);
+    localState.agents[agentName] = enrichment;
+    writeLocalEnrichmentState(rootDir, localState);
+    console.log(chalk.green(`  ✓ ${agentName} config enriched and saved locally.`));
+    // Backend push with confirmation
+    if (!options.yes) {
+        console.log(chalk.bold.cyan('\n📤 Push enriched agent config to backend?\n'));
+        console.log(`  • ${chalk.bold(agentName)} ` +
+            chalk.dim(`(model: ${enrichment.model ?? 'n/a'}, hash: ${enrichment.configHash.slice(0, 8)}…)`));
+        const pushOk = await confirm({
+            message: 'Push to backend?',
+            default: true,
+        });
+        if (!pushOk) {
+            console.warn(chalk.yellow('  Push skipped. Local enrichment is saved — you can push later with `scan`.'));
+            return { config: enrichedConfig, enrichment };
+        }
+    }
+    await pushRemoteAgentConfig(rootDir, license.key, agentName, enrichedConfig, license.workspace, enrichment);
+    console.log(chalk.green(`  ✓ ${agentName} config pushed to backend.\n`));
+    return { config: enrichedConfig, enrichment };
+}
+// ─── enrichAgentConfig (shared with scan) ────────────────────
+export async function enrichAgentConfig(agentName, workspaceConfig, currentConfig, packageManifest, customInstructions, provider) {
+    const schema = buildConfigSchema(currentConfig);
+    const response = await provider.chat({
+        systemPrompt: 'You are a senior AI agent configuration architect. Return ONLY valid JSON matching the provided schema exactly. Preserve the config structure, remove generic placeholders when they do not fit the repo, and specialize the config to the actual workspace.',
+        userPrompt: buildAgentEnrichmentPrompt(agentName, workspaceConfig, currentConfig, packageManifest, customInstructions),
+        jsonSchema: schema,
+        maxTokens: 4000,
+        temperature: 0.2,
+    });
+    let parsed;
+    try {
+        parsed = JSON.parse(stripCodeFences(response.content));
+    }
+    catch (error) {
+        throw new Error(`Agent config enrichment for ${agentName} returned invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!isRecord(parsed)) {
+        throw new Error(`Agent config enrichment for ${agentName} returned a non-object payload.`);
+    }
+    const merged = mergeObjects(currentConfig, parsed);
+    ensureServiceScope(merged, workspaceConfig);
+    return merged;
+}
+// ─── Prompt builder (shared with scan) ───────────────────────
+export function buildAgentEnrichmentPrompt(agentName, workspaceConfig, currentConfig, packageManifest, customInstructions) {
+    const serviceSummary = workspaceConfig.services
+        .map((service) => {
+        const commandSummary = service.commands
+            ? Object.entries(service.commands)
+                .map(([name, value]) => `${name}: ${value}`)
+                .join(', ')
+            : 'no commands declared';
+        return `- ${service.name} (${service.language}${service.framework ? `/${service.framework}` : ''}) at ${service.path}; maturity=${service.maturity}; port=${service.port ?? 'n/a'}; commands=${commandSummary}`;
+    })
+        .join('\n');
+    const customBlock = customInstructions.length === 0
+        ? 'None'
+        : customInstructions
+            .map((instruction) => {
+            const scope = instruction.scope ? ` scope=${instruction.scope}` : '';
+            const source = instruction.source ? ` source=${instruction.source}` : '';
+            return `- ${instruction.content}${scope}${source}`;
+        })
+            .join('\n');
+    return [
+        `Enrich the ${agentName} configuration for this workspace.`,
+        'Goal: produce a repo-specific config, not a default starter config.',
+        'Rules:',
+        '- Keep the same object shape and key structure as the current config.',
+        '- Use the actual workspace services, commands, maturity, ports, and conventions.',
+        '- Remove or replace generic placeholders when they are not justified by the workspace.',
+        '- Do not invent secrets, credentials, URLs, or commands that are not supported by the workspace context.',
+        '- If you cannot infer a field confidently, keep the current value rather than making up data.',
+        '- Prefer explicit scope.services over an empty list when the workspace already names services.',
+        '',
+        'Workspace config:',
+        '```yaml',
+        stringify(workspaceConfig, { lineWidth: 120 }).trimEnd(),
+        '```',
+        '',
+        'Service summary:',
+        serviceSummary,
+        '',
+        'Package manifest:',
+        '```json',
+        JSON.stringify(packageManifest, null, 2),
+        '```',
+        '',
+        'Current config:',
+        '```json',
+        JSON.stringify(currentConfig, null, 2),
+        '```',
+        '',
+        'Active custom instructions:',
+        customBlock,
+        '',
+        'Return the FULL enriched config as JSON only.',
+    ].join('\n');
+}
+// ─── Shared helpers ──────────────────────────────────────────
+export function readWorkspaceConfig(rootDir) {
+    const configPath = resolve(rootDir, WORKSPACE_CONFIG_PATH);
+    const raw = parse(readFileSync(configPath, 'utf-8'));
+    const validation = validateWorkspaceConfig(raw);
+    if (!validation.valid || !validation.config) {
+        throw new Error(`Workspace config is invalid: ${validation.errors.join('; ')}`);
+    }
+    return validation.config;
+}
+export function writeAgentConfigFile(rootDir, relativePath, config) {
+    const filePath = resolve(rootDir, relativePath);
+    const dirPath = resolve(filePath, '..');
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+    writeFileSync(filePath, stringify(config, { lineWidth: 120 }).trimEnd() + '\n', 'utf-8');
+}
+export function buildConfigSchema(sample) {
+    return {
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        ...schemaFromValue(sample),
+    };
+}
+// ─── Internal helpers ────────────────────────────────────────
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stripCodeFences(content) {
+    return content.replace(/^```(?:json)?\s*/i, '').replace(/\s*```$/, '').trim();
+}
+function schemaFromValue(value) {
+    if (Array.isArray(value)) {
+        return {
+            type: 'array',
+            items: value.length > 0 ? schemaFromValue(value[0]) : {},
+        };
+    }
+    if (typeof value === 'string') {
+        return { type: 'string' };
+    }
+    if (typeof value === 'number') {
+        return { type: Number.isInteger(value) ? 'integer' : 'number' };
+    }
+    if (typeof value === 'boolean') {
+        return { type: 'boolean' };
+    }
+    if (!isRecord(value)) {
+        return {};
+    }
+    const properties = {};
+    const required = [];
+    for (const [key, nestedValue] of Object.entries(value)) {
+        properties[key] = schemaFromValue(nestedValue);
+        required.push(key);
+    }
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        required,
+    };
+}
+function mergeObjects(base, override) {
+    const merged = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (isRecord(value) && isRecord(merged[key])) {
+            merged[key] = mergeObjects(merged[key], value);
+            continue;
+        }
+        merged[key] = value;
+    }
+    return merged;
+}
+function ensureServiceScope(config, workspaceConfig) {
+    const scope = isRecord(config.scope) ? config.scope : null;
+    if (!scope) {
+        return;
+    }
+    const services = Array.isArray(scope.services)
+        ? scope.services.filter((service) => typeof service === 'string' && service.length > 0)
+        : [];
+    if (services.length > 0 || workspaceConfig.services.length === 0) {
+        return;
+    }
+    scope.services = workspaceConfig.services.map((service) => service.name);
+    config.scope = scope;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/enrichment/workflow.js.map

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

package/dist/generator/builtin-templates.d.ts

@@ -2,11 +2,12 @@
  * Builtin templates that are generated for every workspace regardless of agents.
  * These provide the base workspace context files.
  */
+import type { WorkspaceConfig } from '@nepopsx/core';
 interface BuiltinTemplate {
     outputPath: string;
     template: string;
     source: string;
 }
-export declare function getBuiltinTemplates(): BuiltinTemplate[];
+export declare function getBuiltinTemplates(config?: WorkspaceConfig): BuiltinTemplate[];
 export {};
 //# sourceMappingURL=builtin-templates.d.ts.map

package/dist/generator/builtin-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-templates.d.ts","sourceRoot":"","sources":["../../src/generator/builtin-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,mBAAmB,IAAI,eAAe,EAAE,CAkBvD"}
+{"version":3,"file":"builtin-templates.d.ts","sourceRoot":"","sources":["../../src/generator/builtin-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAuC/E"}

package/dist/generator/builtin-templates.js

@@ -2,8 +2,8 @@
  * Builtin templates that are generated for every workspace regardless of agents.
  * These provide the base workspace context files.
  */
-export function getBuiltinTemplates() {
-    return [
+export function getBuiltinTemplates(config) {
+    const templates = [
         {
             outputPath: '.github/copilot-instructions.md',
             template: COPILOT_INSTRUCTIONS_TEMPLATE,
@@ -14,12 +14,31 @@ export function getBuiltinTemplates() {
             template: AGENTS_MD_TEMPLATE,
             source: 'builtin:agents-md',
         },
+        {
+            outputPath: 'CLAUDE.md',
+            template: CLAUDE_MD_TEMPLATE,
+            source: 'builtin:claude-md',
+        },
         {
             outputPath: 'Makefile',
             template: MAKEFILE_TEMPLATE,
             source: 'builtin:makefile',
         },
     ];
+    // Per-language instruction files (only for languages present in workspace)
+    if (config?.services) {
+        const languages = new Set(config.services.map((s) => s.language));
+        for (const [lang, tpl] of Object.entries(LANGUAGE_INSTRUCTIONS)) {
+            if (languages.has(lang)) {
+                templates.push({
+                    outputPath: `.github/instructions/${lang}.instructions.md`,
+                    template: tpl,
+                    source: `builtin:instructions-${lang}`,
+                });
+            }
+        }
+    }
+    return templates;
 }
 // ─── copilot-instructions.md ────────────────────────────────
 const COPILOT_INSTRUCTIONS_TEMPLATE = `# {{config.workspace.name}} — Copilot Instructions
@@ -41,6 +60,12 @@ const COPILOT_INSTRUCTIONS_TEMPLATE = `# {{config.workspace.name}} — Copilot I
 | {{name}} | {{language}} | {{#if framework}}{{framework}}{{else}}—{{/if}} | \`{{path}}/\` | {{maturityBadge maturity}} |
 {{/each}}
 
+{{#each config.services}}
+{{#if description}}
+**{{name}}**: {{description}}{{#if databases}} Uses: {{#each databases}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}.{{/if}}
+{{/if}}
+{{/each}}
+
 {{#if config.execution_order}}
 ### Multi-Service Change Order
 
@@ -138,6 +163,16 @@ const AGENTS_MD_TEMPLATE = `# AI Agent Instructions — {{config.workspace.name}
 | {{name}} | {{language}} | {{#if framework}}{{framework}}{{else}}—{{/if}} | \`{{path}}/\` | {{#if port}}{{port}}{{else}}—{{/if}} | {{maturityBadge maturity}} |
 {{/each}}
 
+{{#each config.services}}
+{{#if description}}
+### {{name}}
+
+{{description}}{{#if databases}}
+
+**Databases:** {{#each databases}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}{{/if}}
+{{/if}}
+{{/each}}
+
 ## Common Commands
 
 {{#each config.services}}
@@ -161,6 +196,22 @@ cd {{path}}
 # Lint
 {{commands.lint}}
 {{/if}}
+{{#if commands.format}}
+# Format
+{{commands.format}}
+{{/if}}
+{{#if commands.typecheck}}
+# Typecheck
+{{commands.typecheck}}
+{{/if}}
+{{#if commands.migrate}}
+# Migrate
+{{commands.migrate}}
+{{/if}}
+{{#if commands.seed}}
+# Seed
+{{commands.seed}}
+{{/if}}
 \`\`\`
 
 {{/each}}
@@ -248,4 +299,112 @@ env-state: ## Check service ports
 {{/if}}
 {{/each}}
 `;
+// ─── CLAUDE.md ──────────────────────────────────────────────
+const CLAUDE_MD_TEMPLATE = `# CLAUDE.md — {{config.workspace.name}}
+
+<!-- Auto-generated by NEPOPSX CLI ({{timestamp}}). Do not edit manually. -->
+<!-- Regenerate with: npx @nepopsx/cli sync -->
+
+@.github/copilot-instructions.md
+@AGENTS.md
+
+{{#if config.workspace.description}}
+## Overview
+
+{{config.workspace.description}}
+{{/if}}
+
+## Services
+
+{{#each config.services}}
+### {{name}} ({{language}}{{#if framework}}/{{framework}}{{/if}}) — \`{{path}}/\`
+
+{{#if description}}{{description}}{{/if}}
+
+{{#if commands.dev}}Dev: \`cd {{path}} && {{commands.dev}}\`{{/if}}
+{{#if commands.build}}Build: \`cd {{path}} && {{commands.build}}\`{{/if}}
+{{#if commands.test}}Test: \`cd {{path}} && {{commands.test}}\`{{/if}}
+{{#if commands.lint}}Lint: \`cd {{path}} && {{commands.lint}}\`{{/if}}
+{{#if commands.typecheck}}Typecheck: \`cd {{path}} && {{commands.typecheck}}\`{{/if}}
+{{#if commands.migrate}}Migrate: \`cd {{path}} && {{commands.migrate}}\`{{/if}}
+
+{{/each}}
+
+{{#if config.databases}}
+## Databases
+
+{{#each config.databases}}
+- **{{name}}** ({{type}}){{#if description}} — {{description}}{{/if}}
+{{/each}}
+{{/if}}
+
+{{#if config.execution_order}}
+## Change Order
+
+Modify services in this order: {{join config.execution_order " → "}}
+{{/if}}
+`;
+// ─── Per-language instruction templates ─────────────────────
+/* eslint-disable no-useless-escape */
+function langTemplate(applyTo, lang, standards) {
+    return [
+        '---',
+        `applyTo: "${applyTo}"`,
+        '---',
+        `# ${lang} Instructions — {{config.workspace.name}}`,
+        '',
+        '<!-- Auto-generated by NEPOPSX CLI. Regenerate with: npx @nepopsx/cli sync -->',
+        '',
+        `## ${lang} Services`,
+        '',
+        `{{#servicesByLang config.services "${lang.toLowerCase()}"}}`,
+        '### {{name}}{{#if framework}} ({{framework}}){{/if}}',
+        '',
+        '{{#if description}}{{description}}{{/if}}',
+        '- Path: `{{path}}/`',
+        '{{#if commands.build}}- Build: `cd {{path}} && {{commands.build}}`{{/if}}',
+        '{{#if commands.test}}- Test: `cd {{path}} && {{commands.test}}`{{/if}}',
+        '{{#if commands.lint}}- Lint: `cd {{path}} && {{commands.lint}}`{{/if}}',
+        '{{#if commands.typecheck}}- Typecheck: `cd {{path}} && {{commands.typecheck}}`{{/if}}',
+        '{{#if commands.format}}- Format: `cd {{path}} && {{commands.format}}`{{/if}}',
+        '',
+        '{{/servicesByLang}}',
+        '',
+        '## Standards',
+        '',
+        standards,
+    ].join('\n');
+}
+const LANGUAGE_INSTRUCTIONS = {
+    typescript: langTemplate('**/*.ts,**/*.tsx', 'TypeScript', [
+        '- Strict TypeScript — explicit return types on exported functions',
+        '- Prefer `unknown` over `any`, narrow with type guards',
+        '- Use path aliases where configured (e.g., `@/`)',
+        '- Named exports only (no default exports)',
+        '- Functional patterns, const assertions, immutable by default',
+    ].join('\n')),
+    python: langTemplate('**/*.py', 'Python', [
+        '- Type hints on all public functions and methods',
+        '- Follow PEP 8, use project formatter (Black/Ruff)',
+        '- Prefer dataclasses or Pydantic models over raw dicts',
+        '- Use `pathlib.Path` over string paths',
+    ].join('\n')),
+    go: langTemplate('**/*.go', 'Go', [
+        '- Standard project layout: `cmd/`, `internal/`, `pkg/`',
+        '- Wrap errors with context (`fmt.Errorf("...: %w", err)`)',
+        '- Return errors, don\'t panic',
+        '- Table-driven tests',
+        '- Use `gofmt` / `goimports` before commit',
+    ].join('\n')),
+    java: langTemplate('**/*.java,**/*.kt', 'Java', [
+        '- Follow framework conventions (Spring Boot, etc.)',
+        '- Use dependency injection',
+        '- Prefer immutable types where possible',
+    ].join('\n')),
+    rust: langTemplate('**/*.rs', 'Rust', [
+        '- Use clippy for linting: `cargo clippy`',
+        '- Prefer `Result` over `unwrap()`/`expect()` in library code',
+        '- Use `thiserror` for error types',
+    ].join('\n')),
+};
 //# sourceMappingURL=builtin-templates.js.map

package/dist/generator/builtin-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-templates.js","sourceRoot":"","sources":["../../src/generator/builtin-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL;YACE,UAAU,EAAE,iCAAiC;YAC7C,QAAQ,EAAE,6BAA6B;YACvC,MAAM,EAAE,8BAA8B;SACvC;QACD;YACE,UAAU,EAAE,WAAW;YACvB,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,mBAAmB;SAC5B;QACD;YACE,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,iBAAiB;YAC3B,MAAM,EAAE,kBAAkB;SAC3B;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAE/D,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsGrC,CAAC;AAEF,+DAA+D;AAE/D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgE1B,CAAC;AAEF,+DAA+D;AAE/D,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDzB,CAAC"}
+{"version":3,"file":"builtin-templates.js","sourceRoot":"","sources":["../../src/generator/builtin-templates.ts"],"names":[],"mappings":"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"}

package/dist/generator/package-renderer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Package renderer — maps already-rendered agent bundles into WriteOperations.
+ *
+ * Two rendering modes:
+ *   renderBundleForInstall  — all files land under .github/ (preserves bundle layout)
+ *   renderAgentBundle       — remaps schemas to openspec/ (used by sync)
+ *
+ * Backend bundles are already rendered server-side. The CLI only remaps paths.
+ */
+import type { TemplateBundle } from '../licensing/index.js';
+import type { WriteOperation } from './writer.js';
+/**
+ * Render a downloaded agent bundle for `nepopsx install`.
+ *
+ * All files are written under `.github/<relativePath>` with .hbs stripped.
+ * This preserves the bundle's directory layout (agents/, prompts/, schemas/,
+ * partials/) exactly as the agent author designed.
+ *
+ * Decrypted .hbs source is kept in memory only — never touches disk.
+ */
+export declare function renderBundleForInstall(bundle: TemplateBundle): WriteOperation[];
+/**
+ * Render all templates from an agent bundle for `nepopsx sync`.
+ *
+ * Uses prefix-based remapping so schemas land in openspec/ and
+ * generated agent/prompt files land under .github/.
+ */
+export declare function renderAgentBundle(bundle: TemplateBundle): WriteOperation[];
+//# sourceMappingURL=package-renderer.d.ts.map

package/dist/generator/package-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-renderer.d.ts","sourceRoot":"","sources":["../../src/generator/package-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CAqBlB;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,GACrB,cAAc,EAAE,CAmElB"}