@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/cli/commands/init/resolver.js

@@ -0,0 +1,273 @@
+/**
+ * Options resolver for `generacy init`.
+ *
+ * Merges CLI flags, existing config, interactive prompts, auto-detection,
+ * and hard-coded defaults into a fully resolved `InitOptions` object.
+ *
+ * Priority chain (highest → lowest):
+ *   CLI flags > existing config > interactive prompts > auto-detection > defaults
+ */
+import * as crypto from 'node:crypto';
+import { basename } from 'node:path';
+import * as p from '@clack/prompts';
+import { loadConfig } from '../../../config/index.js';
+import { getLogger } from '../../utils/logger.js';
+import { runInteractivePrompts } from './prompts.js';
+import { detectPrimaryRepo, normalizeRepoUrl } from './repo-utils.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a `github.com/owner/repo` config-format string to `owner/repo`
+ * shorthand. Returns the input unchanged if parsing fails.
+ */
+function configRepoToShorthand(configUrl) {
+    try {
+        return normalizeRepoUrl(configUrl).shorthand;
+    }
+    catch {
+        return configUrl;
+    }
+}
+/**
+ * Load defaults from an existing `.generacy/config.yaml` if one is present.
+ * Returns an empty partial on any failure (missing file, invalid schema, etc.).
+ */
+function loadExistingDefaults(gitRoot) {
+    const logger = getLogger();
+    try {
+        const config = loadConfig({ startDir: gitRoot });
+        const defaults = {
+            projectId: config.project.id,
+            projectName: config.project.name,
+            primaryRepo: configRepoToShorthand(config.repos.primary),
+            agent: config.defaults?.agent,
+            baseBranch: config.defaults?.baseBranch,
+        };
+        if (config.repos.dev && config.repos.dev.length > 0) {
+            defaults.devRepos = config.repos.dev.map(configRepoToShorthand);
+        }
+        if (config.repos.clone && config.repos.clone.length > 0) {
+            defaults.cloneRepos = config.repos.clone.map(configRepoToShorthand);
+        }
+        if (config.cluster?.variant) {
+            defaults.variant = config.cluster.variant;
+        }
+        logger.debug({ defaults }, 'Loaded existing config defaults for re-init');
+        return defaults;
+    }
+    catch {
+        logger.debug('No existing config found or config is invalid — starting fresh');
+        return {};
+    }
+}
+/**
+ * Extract typed flag values from the raw Commander options object.
+ * Only keys that are explicitly set are included in the result.
+ */
+function extractFlags(flags) {
+    const partial = {};
+    if (typeof flags.projectId === 'string')
+        partial.projectId = flags.projectId;
+    if (typeof flags.projectName === 'string')
+        partial.projectName = flags.projectName;
+    if (typeof flags.primaryRepo === 'string')
+        partial.primaryRepo = flags.primaryRepo;
+    if (typeof flags.agent === 'string')
+        partial.agent = flags.agent;
+    if (typeof flags.baseBranch === 'string')
+        partial.baseBranch = flags.baseBranch;
+    if (typeof flags.releaseStream === 'string') {
+        partial.releaseStream = flags.releaseStream;
+    }
+    if (typeof flags.variant === 'string') {
+        partial.variant = flags.variant;
+    }
+    // Variadic flags come as string arrays from Commander
+    if (Array.isArray(flags.devRepo)) {
+        partial.devRepos = flags.devRepo.filter((v) => typeof v === 'string');
+    }
+    if (Array.isArray(flags.cloneRepo)) {
+        partial.cloneRepos = flags.cloneRepo.filter((v) => typeof v === 'string');
+    }
+    // Boolean flags
+    if (typeof flags.force === 'boolean')
+        partial.force = flags.force;
+    if (typeof flags.dryRun === 'boolean')
+        partial.dryRun = flags.dryRun;
+    if (typeof flags.skipGithubCheck === 'boolean')
+        partial.skipGithubCheck = flags.skipGithubCheck;
+    if (typeof flags.yes === 'boolean')
+        partial.yes = flags.yes;
+    return partial;
+}
+/**
+ * Check whether all required interactive fields have been resolved.
+ */
+function isFullySpecified(partial) {
+    return (partial.projectName !== undefined &&
+        partial.primaryRepo !== undefined);
+}
+/**
+ * Validate a `--project-id` value: must match `proj_` prefix followed by
+ * lowercase alphanumeric characters and be at least 12 characters long.
+ */
+function validateProjectId(id) {
+    if (!/^proj_[a-z0-9]+$/.test(id)) {
+        throw new ResolverError(`Invalid project ID "${id}". Must match format: proj_{alphanumeric} (e.g. proj_abc123).`);
+    }
+    if (id.length < 12) {
+        throw new ResolverError(`Invalid project ID "${id}". Must be at least 12 characters long.`);
+    }
+}
+/**
+ * Generate a local placeholder project ID.
+ * Format: `proj_local<8 random hex chars>` (e.g. proj_locala1b2c3d4)
+ * Matches config schema regex: /^proj_[a-z0-9]+$/
+ */
+function generateLocalProjectId() {
+    const hex = crypto.randomBytes(4).toString('hex');
+    return `proj_local${hex}`;
+}
+/**
+ * Normalize a single repo URL to `owner/repo` shorthand.
+ * Throws a `ResolverError` with a user-friendly message on failure.
+ */
+function normalizeRepo(input) {
+    try {
+        return normalizeRepoUrl(input).shorthand;
+    }
+    catch (err) {
+        throw new ResolverError(err instanceof Error ? err.message : `Invalid repository URL: ${input}`);
+    }
+}
+/**
+ * Validate that no repository appears in more than one role.
+ * Compares normalized `owner/repo` strings.
+ */
+function validateNoDuplicateRepos(primaryRepo, devRepos, cloneRepos) {
+    const seen = new Map(); // repo → role
+    seen.set(primaryRepo, 'primary');
+    for (const repo of devRepos) {
+        const existing = seen.get(repo);
+        if (existing) {
+            throw new ResolverError(`Duplicate repository "${repo}" — it appears in both "${existing}" and "dev" lists. ` +
+                'Each repository can only appear once across primary, dev, and clone lists.');
+        }
+        seen.set(repo, 'dev');
+    }
+    for (const repo of cloneRepos) {
+        const existing = seen.get(repo);
+        if (existing) {
+            throw new ResolverError(`Duplicate repository "${repo}" — it appears in both "${existing}" and "clone" lists. ` +
+                'Each repository can only appear once across primary, dev, and clone lists.');
+        }
+        seen.set(repo, 'clone');
+    }
+}
+// ---------------------------------------------------------------------------
+// Error type
+// ---------------------------------------------------------------------------
+/**
+ * Error thrown when the resolver cannot produce valid `InitOptions`.
+ * Callers should catch this to display the message and exit with code 1.
+ */
+export class ResolverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ResolverError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a fully populated `InitOptions` from CLI flags, existing config,
+ * interactive prompts, auto-detection, and defaults.
+ *
+ * @param flags - Raw option values from Commander.js (`command.opts()`).
+ * @param gitRoot - Absolute path to the git repository root (already validated).
+ * @returns Fully resolved `InitOptions` — every field is concrete.
+ * @throws {ResolverError} If resolution fails (missing required values,
+ *   invalid project ID, non-TTY without `--yes`, duplicate repos, etc.).
+ */
+export async function resolveOptions(flags, gitRoot) {
+    const logger = getLogger();
+    // ── 1. Extract typed CLI flags ────────────────────────────────────────
+    const cliFlags = extractFlags(flags);
+    logger.debug({ cliFlags }, 'Parsed CLI flags');
+    // ── 2. Load existing config as fallback defaults ──────────────────────
+    const existingConfig = loadExistingDefaults(gitRoot);
+    logger.debug({ existingConfig }, 'Existing config defaults');
+    // Merge: CLI flags take priority over existing config
+    const merged = { ...existingConfig, ...cliFlags };
+    // ── 3. Determine resolution strategy ──────────────────────────────────
+    const useYes = merged.yes === true;
+    if (useYes) {
+        // Auto-derive missing values from context
+        if (merged.projectName === undefined) {
+            merged.projectName = basename(gitRoot);
+            p.log.warn(`Auto-derived project name: "${merged.projectName}"`);
+        }
+        if (merged.primaryRepo === undefined) {
+            const detected = detectPrimaryRepo(gitRoot);
+            if (!detected) {
+                throw new ResolverError('Cannot auto-detect primary repository — no git remote "origin" found. ' +
+                    'Provide --primary-repo explicitly.');
+            }
+            merged.primaryRepo = detected;
+            p.log.warn(`Auto-derived primary repo: ${merged.primaryRepo}`);
+        }
+        // Default arrays
+        if (merged.devRepos === undefined)
+            merged.devRepos = [];
+        if (merged.cloneRepos === undefined)
+            merged.cloneRepos = [];
+    }
+    else if (!isFullySpecified(merged)) {
+        // Interactive mode needed — check TTY
+        if (!process.stdin.isTTY) {
+            throw new ResolverError('Interactive prompts are not available in this environment (non-TTY). ' +
+                'Use --yes to accept defaults, or provide all required flags ' +
+                '(--project-name, --primary-repo).');
+        }
+        // Run interactive prompts, passing already-resolved values as defaults
+        const prompted = await runInteractivePrompts(merged, gitRoot);
+        Object.assign(merged, prompted);
+    }
+    // ── 4. Project ID ─────────────────────────────────────────────────────
+    let projectId;
+    if (merged.projectId !== undefined) {
+        validateProjectId(merged.projectId);
+        projectId = merged.projectId;
+    }
+    else {
+        projectId = generateLocalProjectId();
+        logger.debug({ projectId }, 'Generated local placeholder project ID');
+    }
+    // ── 5. Normalize repo URLs ────────────────────────────────────────────
+    const primaryRepo = normalizeRepo(merged.primaryRepo);
+    const devRepos = (merged.devRepos ?? []).map(normalizeRepo);
+    const cloneRepos = (merged.cloneRepos ?? []).map(normalizeRepo);
+    // ── 6. Validate no duplicate repo names ───────────────────────────────
+    validateNoDuplicateRepos(primaryRepo, devRepos, cloneRepos);
+    // ── 7. Assemble final InitOptions ─────────────────────────────────────
+    const resolved = {
+        projectId,
+        projectName: merged.projectName,
+        primaryRepo,
+        devRepos,
+        cloneRepos,
+        agent: merged.agent ?? 'claude-code',
+        baseBranch: merged.baseBranch ?? 'main',
+        releaseStream: merged.releaseStream ?? 'stable',
+        variant: merged.variant ?? 'standard',
+        force: merged.force ?? false,
+        dryRun: merged.dryRun ?? false,
+        skipGithubCheck: merged.skipGithubCheck ?? false,
+        yes: merged.yes ?? false,
+    };
+    logger.debug({ resolved }, 'Resolved init options');
+    return resolved;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/cli/commands/init/resolver.js.map

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

package/dist/cli/commands/init/summary.d.ts

@@ -0,0 +1,21 @@
+import type { ClusterVariant } from '@generacy-ai/templates';
+import type { FileResult } from './types.js';
+/**
+ * Print a summary table of all file operations.
+ *
+ * Each file is displayed with its action label, relative path, and size.
+ * In dry-run mode, actions are prefixed with "Would" (e.g. "Would create").
+ * A totals line follows showing counts of each action type.
+ *
+ * @param results - Array of file results from `writeFiles()`.
+ * @param dryRun  - Whether this was a dry-run (preview) invocation.
+ * @param variant - The selected cluster variant.
+ */
+export declare function printSummary(results: FileResult[], dryRun: boolean, variant: ClusterVariant): void;
+/**
+ * Print actionable next steps after a successful initialization.
+ *
+ * Displayed as a styled note box via `@clack/prompts`.
+ */
+export declare function printNextSteps(): void;
+//# sourceMappingURL=summary.d.ts.map

package/dist/cli/commands/init/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/summary.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmC7C;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAwClG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAWrC"}

package/dist/cli/commands/init/summary.js

@@ -0,0 +1,100 @@
+/**
+ * Completion summary and next steps for `generacy init`.
+ *
+ * After files are written (or previewed in dry-run mode), this module
+ * prints a styled summary table showing each file's action and size,
+ * followed by actionable next steps for the developer.
+ */
+import * as p from '@clack/prompts';
+// ---------------------------------------------------------------------------
+// Action label mapping
+// ---------------------------------------------------------------------------
+/** Human-readable labels for cluster variants. */
+const VARIANT_LABELS = {
+    standard: 'Standard (DooD)',
+    microservices: 'Microservices (DinD)',
+};
+/** Display labels for each file action (normal and dry-run variants). */
+const ACTION_LABELS = {
+    created: { normal: 'Created', dryRun: 'Would create' },
+    overwritten: { normal: 'Overwritten', dryRun: 'Would overwrite' },
+    merged: { normal: 'Merged', dryRun: 'Would merge' },
+    skipped: { normal: 'Skipped', dryRun: 'Would skip' },
+};
+// ---------------------------------------------------------------------------
+// Size formatting
+// ---------------------------------------------------------------------------
+/** Format a byte count for display, omitting for zero-size (skipped) files. */
+function formatSize(bytes) {
+    if (bytes === 0)
+        return '';
+    if (bytes < 1024)
+        return ` (${bytes} bytes)`;
+    return ` (${(bytes / 1024).toFixed(1)} KB)`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Print a summary table of all file operations.
+ *
+ * Each file is displayed with its action label, relative path, and size.
+ * In dry-run mode, actions are prefixed with "Would" (e.g. "Would create").
+ * A totals line follows showing counts of each action type.
+ *
+ * @param results - Array of file results from `writeFiles()`.
+ * @param dryRun  - Whether this was a dry-run (preview) invocation.
+ * @param variant - The selected cluster variant.
+ */
+export function printSummary(results, dryRun, variant) {
+    if (results.length === 0) {
+        p.log.warn('No files were generated.');
+        return;
+    }
+    p.log.info(`Cluster variant: ${VARIANT_LABELS[variant]}`);
+    // Find the longest action label for alignment
+    const actionVariant = dryRun ? 'dryRun' : 'normal';
+    const maxLabelLen = Math.max(...results.map((r) => ACTION_LABELS[r.action][actionVariant].length));
+    // Print each file result
+    for (const result of results) {
+        const label = ACTION_LABELS[result.action][actionVariant].padEnd(maxLabelLen);
+        const size = formatSize(result.size);
+        p.log.step(`${label}  ${result.path}${size}`);
+    }
+    // Build totals
+    const counts = {};
+    for (const result of results) {
+        counts[result.action] = (counts[result.action] ?? 0) + 1;
+    }
+    const parts = [];
+    if (counts.created)
+        parts.push(`${counts.created} created`);
+    if (counts.overwritten)
+        parts.push(`${counts.overwritten} overwritten`);
+    if (counts.merged)
+        parts.push(`${counts.merged} merged`);
+    if (counts.skipped)
+        parts.push(`${counts.skipped} skipped`);
+    const totalLine = parts.join(', ');
+    if (dryRun) {
+        p.log.info(`Dry run: ${totalLine} (no files were written)`);
+    }
+    else {
+        p.log.success(`Done: ${totalLine}`);
+    }
+}
+/**
+ * Print actionable next steps after a successful initialization.
+ *
+ * Displayed as a styled note box via `@clack/prompts`.
+ */
+export function printNextSteps() {
+    p.note([
+        '1. Review the generated files',
+        '2. Copy .devcontainer/.env.template to .devcontainer/.env and fill in credentials',
+        '3. Copy .generacy/generacy.env.template to .generacy/generacy.env and fill in credentials',
+        '4. Run `generacy doctor` to verify system requirements',
+        '5. Commit the generated files to your repository',
+    ].join('\n'), 'Next steps');
+}
+//# sourceMappingURL=summary.js.map

package/dist/cli/commands/init/summary.js.map

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

package/dist/cli/commands/init/types.d.ts

@@ -0,0 +1,53 @@
+import type { ClusterVariant } from '@generacy-ai/templates';
+/** Fully resolved options for the `generacy init` command. */
+export interface InitOptions {
+    /** Server-issued project ID, or a generated local placeholder. */
+    projectId: string;
+    /** Human-readable project display name. */
+    projectName: string;
+    /** Primary repository, normalized to `owner/repo` shorthand. */
+    primaryRepo: string;
+    /** Development repositories, each normalized to `owner/repo`. */
+    devRepos: string[];
+    /** Clone-only repositories, each normalized to `owner/repo`. */
+    cloneRepos: string[];
+    /** Default agent for task execution (e.g. `claude-code`). */
+    agent: string;
+    /** Default base branch for PRs (e.g. `main`). */
+    baseBranch: string;
+    /** Release stream: stable for production, preview for early access. */
+    releaseStream: 'stable' | 'preview';
+    /** Cluster variant: "standard" (DooD) or "microservices" (DinD). */
+    variant: ClusterVariant;
+    /** Overwrite all existing files without prompting. */
+    force: boolean;
+    /** Preview generated files without writing to disk. */
+    dryRun: boolean;
+    /** Skip GitHub API access validation. */
+    skipGithubCheck: boolean;
+    /** Accept all defaults without interactive prompts. */
+    yes: boolean;
+}
+/** Per-file conflict resolution action. */
+export type FileAction = 'overwrite' | 'skip' | 'merge';
+/** Result of writing (or skipping) a single file. */
+export interface FileResult {
+    /** Relative path from the git root. */
+    path: string;
+    /** Action that was taken. */
+    action: 'created' | 'overwritten' | 'merged' | 'skipped';
+    /** Written file size in bytes (0 for skipped files). */
+    size: number;
+}
+/** Result of checking GitHub API access for a single repository. */
+export interface RepoAccessResult {
+    /** Repository in `owner/repo` format. */
+    repo: string;
+    /** Whether the repo exists and the token has read access. */
+    accessible: boolean;
+    /** Whether the token has push (write) access. */
+    writable: boolean;
+    /** Error message if the check failed (e.g. 404, 401). */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/commands/init/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IAEpB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IAEd,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IAEnB,uEAAuE;IACvE,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IAEpC,oEAAoE;IACpE,OAAO,EAAE,cAAc,CAAC;IAExB,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAC;IAEf,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;IAEhB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IAEzB,uDAAuD;IACvD,GAAG,EAAE,OAAO,CAAC;CACd;AAMD,2CAA2C;AAC3C,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAMxD,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEzD,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;IAEpB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAElB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/cli/commands/init/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/commands/init/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/commands/init/types.ts"],"names":[],"mappings":""}

package/dist/cli/commands/init/writer.d.ts

@@ -0,0 +1,22 @@
+import type { FileAction, FileResult } from './types.js';
+/**
+ * Write rendered template files to disk, respecting per-file actions and dry-run mode.
+ *
+ * @param files   - Map of relative path → generated content (from `renderProject`).
+ * @param actions - Map of relative path → resolved `FileAction` (from `resolveConflicts`).
+ * @param gitRoot - Absolute path to the git repository root.
+ * @param dryRun  - When true, record actions without writing to disk.
+ * @returns Array of `FileResult` describing what happened to each file.
+ */
+export declare function writeFiles(files: Map<string, string>, actions: Map<string, FileAction>, gitRoot: string, dryRun: boolean): Promise<FileResult[]>;
+/**
+ * Collect existing files that support smart merge via `renderProject`.
+ *
+ * Currently reads `.vscode/extensions.json` if present, so the template engine
+ * can merge existing VS Code extension recommendations with generated ones.
+ *
+ * @param gitRoot - Absolute path to the git repository root.
+ * @returns Map of relative path → existing file content.
+ */
+export declare function collectExistingFiles(gitRoot: string): Map<string, string>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/cli/commands/init/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init/writer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAazD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,UAAU,EAAE,CAAC,CA8CvB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBzE"}

package/dist/cli/commands/init/writer.js

@@ -0,0 +1,96 @@
+/**
+ * File writer for `generacy init`.
+ *
+ * Writes rendered template files to disk (or previews them in dry-run mode).
+ * Also provides a helper to collect existing files that need smart-merge
+ * support (e.g. `.vscode/extensions.json`) before template rendering.
+ */
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { getLogger } from '../../utils/logger.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Files that support smart merge via `renderProject`'s `existingFiles` param. */
+const MERGEABLE_FILES = ['.vscode/extensions.json'];
+// ---------------------------------------------------------------------------
+// File writer
+// ---------------------------------------------------------------------------
+/**
+ * Write rendered template files to disk, respecting per-file actions and dry-run mode.
+ *
+ * @param files   - Map of relative path → generated content (from `renderProject`).
+ * @param actions - Map of relative path → resolved `FileAction` (from `resolveConflicts`).
+ * @param gitRoot - Absolute path to the git repository root.
+ * @param dryRun  - When true, record actions without writing to disk.
+ * @returns Array of `FileResult` describing what happened to each file.
+ */
+export async function writeFiles(files, actions, gitRoot, dryRun) {
+    const logger = getLogger();
+    const results = [];
+    for (const [relativePath, content] of files) {
+        const action = actions.get(relativePath) ?? 'overwrite';
+        const fullPath = join(gitRoot, relativePath);
+        const size = Buffer.byteLength(content, 'utf-8');
+        // Skip
+        if (action === 'skip') {
+            logger.debug({ path: relativePath }, 'Skipping file');
+            results.push({ path: relativePath, action: 'skipped', size: 0 });
+            continue;
+        }
+        // Determine the result action label
+        const fileExists = existsSync(fullPath);
+        const resultAction = action === 'merge' ? 'merged' : fileExists ? 'overwritten' : 'created';
+        // Dry-run: record without writing
+        if (dryRun) {
+            logger.debug({ path: relativePath, size, action: resultAction }, 'Dry-run: would write file');
+            results.push({ path: relativePath, action: resultAction, size });
+            continue;
+        }
+        // Create parent directories
+        const dir = dirname(fullPath);
+        mkdirSync(dir, { recursive: true });
+        // Write file
+        writeFileSync(fullPath, content, 'utf-8');
+        // Make shell scripts executable
+        if (relativePath.endsWith('.sh')) {
+            chmodSync(fullPath, 0o755);
+        }
+        logger.debug({ path: relativePath, size, action: resultAction }, 'Wrote file');
+        results.push({ path: relativePath, action: resultAction, size });
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Existing file collector
+// ---------------------------------------------------------------------------
+/**
+ * Collect existing files that support smart merge via `renderProject`.
+ *
+ * Currently reads `.vscode/extensions.json` if present, so the template engine
+ * can merge existing VS Code extension recommendations with generated ones.
+ *
+ * @param gitRoot - Absolute path to the git repository root.
+ * @returns Map of relative path → existing file content.
+ */
+export function collectExistingFiles(gitRoot) {
+    const logger = getLogger();
+    const existing = new Map();
+    for (const relativePath of MERGEABLE_FILES) {
+        const fullPath = join(gitRoot, relativePath);
+        if (existsSync(fullPath)) {
+            try {
+                const content = readFileSync(fullPath, 'utf-8');
+                existing.set(relativePath, content);
+                logger.debug({ path: relativePath }, 'Collected existing file for merge');
+            }
+            catch {
+                // If we can't read it (permissions, etc.), skip — the template engine
+                // will treat it as absent and generate fresh content
+                logger.debug({ path: relativePath }, 'Could not read existing file, skipping merge');
+            }
+        }
+    }
+    return existing;
+}
+//# sourceMappingURL=writer.js.map

package/dist/cli/commands/init/writer.js.map

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

package/dist/cli/commands/orchestrator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Orchestrator command implementation.
+ * Starts the orchestrator HTTP server for worker coordination.
+ * Optionally enables label monitoring to watch GitHub repos for process:* labels.
+ */
+import { Command } from 'commander';
+/**
+ * Create the orchestrator command
+ */
+export declare function orchestratorCommand(): Command;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/cli/commands/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAqK7C"}