@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/config/schema.d.ts

@@ -0,0 +1,304 @@
+import { z } from 'zod';
+/**
+ * Project configuration schema
+ * Defines project metadata and link to generacy.ai
+ */
+export declare const ProjectConfigSchema: z.ZodObject<{
+    /**
+     * Unique project ID from generacy.ai
+     * Format: proj_{alphanumeric}, minimum 12 characters total
+     * Example: "proj_abc123"
+     */
+    id: z.ZodString;
+    /**
+     * Human-readable project name
+     * Maximum 255 characters
+     */
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+}, {
+    id: string;
+    name: string;
+}>;
+export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
+/**
+ * Repository configuration schema
+ * Defines repository relationships for the project
+ */
+export declare const ReposConfigSchema: z.ZodObject<{
+    /**
+     * Primary repository (the "main" repo for the project)
+     * This is the repository where the onboarding PR will be created
+     */
+    primary: z.ZodEffects<z.ZodString, string, string>;
+    /**
+     * Development repositories (optional)
+     * These repos are cloned for active development and can receive PRs
+     * Default: empty array
+     */
+    dev: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>>;
+    /**
+     * Clone-only repositories (optional)
+     * These repos are cloned for reference/reading only (no PRs created)
+     * Default: empty array
+     */
+    clone: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    primary: string;
+    dev: string[];
+    clone: string[];
+}, {
+    primary: string;
+    dev?: string[] | undefined;
+    clone?: string[] | undefined;
+}>;
+export type ReposConfig = z.infer<typeof ReposConfigSchema>;
+/**
+ * Workflow defaults schema
+ * Defines default settings for workflow execution
+ */
+export declare const DefaultsConfigSchema: z.ZodObject<{
+    /**
+     * Default agent to use for workflow execution
+     * Format: kebab-case (e.g., "claude-code", "cursor-agent")
+     */
+    agent: z.ZodOptional<z.ZodString>;
+    /**
+     * Default base branch for creating feature branches
+     * No validation of branch existence (checked at runtime)
+     */
+    baseBranch: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    agent?: string | undefined;
+    baseBranch?: string | undefined;
+}, {
+    agent?: string | undefined;
+    baseBranch?: string | undefined;
+}>;
+export type DefaultsConfig = z.infer<typeof DefaultsConfigSchema>;
+/**
+ * Orchestrator settings schema
+ * Defines runtime settings for the orchestrator
+ */
+export declare const OrchestratorSettingsSchema: z.ZodObject<{
+    /**
+     * Polling interval in milliseconds
+     * Minimum 5000ms (5 seconds)
+     */
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Maximum number of concurrent workers
+     * Range: 1-20
+     */
+    workerCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    pollIntervalMs?: number | undefined;
+    workerCount?: number | undefined;
+}, {
+    pollIntervalMs?: number | undefined;
+    workerCount?: number | undefined;
+}>;
+export type OrchestratorSettings = z.infer<typeof OrchestratorSettingsSchema>;
+/**
+ * Cluster configuration schema
+ * Defines the development cluster topology
+ */
+export declare const ClusterConfigSchema: z.ZodObject<{
+    /**
+     * Cluster variant determines the Docker topology
+     * - standard: Docker-outside-of-Docker (DooD) — for apps that don't run containers
+     * - microservices: Docker-in-Docker (DinD) — each worker can run isolated container stacks
+     */
+    variant: z.ZodDefault<z.ZodEnum<["standard", "microservices"]>>;
+}, "strip", z.ZodTypeAny, {
+    variant: "standard" | "microservices";
+}, {
+    variant?: "standard" | "microservices" | undefined;
+}>;
+export type ClusterConfig = z.infer<typeof ClusterConfigSchema>;
+/**
+ * Complete Generacy configuration schema
+ * Root configuration object for .generacy/config.yaml
+ */
+export declare const GeneracyConfigSchema: z.ZodObject<{
+    /**
+     * Schema version (optional)
+     * Defaults to "1" if omitted
+     * Used for future migration support
+     */
+    schemaVersion: z.ZodDefault<z.ZodString>;
+    /**
+     * Project configuration (required)
+     */
+    project: z.ZodObject<{
+        /**
+         * Unique project ID from generacy.ai
+         * Format: proj_{alphanumeric}, minimum 12 characters total
+         * Example: "proj_abc123"
+         */
+        id: z.ZodString;
+        /**
+         * Human-readable project name
+         * Maximum 255 characters
+         */
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+    }, {
+        id: string;
+        name: string;
+    }>;
+    /**
+     * Repository configuration (required)
+     */
+    repos: z.ZodObject<{
+        /**
+         * Primary repository (the "main" repo for the project)
+         * This is the repository where the onboarding PR will be created
+         */
+        primary: z.ZodEffects<z.ZodString, string, string>;
+        /**
+         * Development repositories (optional)
+         * These repos are cloned for active development and can receive PRs
+         * Default: empty array
+         */
+        dev: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>>;
+        /**
+         * Clone-only repositories (optional)
+         * These repos are cloned for reference/reading only (no PRs created)
+         * Default: empty array
+         */
+        clone: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        primary: string;
+        dev: string[];
+        clone: string[];
+    }, {
+        primary: string;
+        dev?: string[] | undefined;
+        clone?: string[] | undefined;
+    }>;
+    /**
+     * Workflow defaults (optional)
+     */
+    defaults: z.ZodOptional<z.ZodObject<{
+        /**
+         * Default agent to use for workflow execution
+         * Format: kebab-case (e.g., "claude-code", "cursor-agent")
+         */
+        agent: z.ZodOptional<z.ZodString>;
+        /**
+         * Default base branch for creating feature branches
+         * No validation of branch existence (checked at runtime)
+         */
+        baseBranch: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        agent?: string | undefined;
+        baseBranch?: string | undefined;
+    }, {
+        agent?: string | undefined;
+        baseBranch?: string | undefined;
+    }>>;
+    /**
+     * Orchestrator settings (optional)
+     */
+    orchestrator: z.ZodOptional<z.ZodObject<{
+        /**
+         * Polling interval in milliseconds
+         * Minimum 5000ms (5 seconds)
+         */
+        pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+        /**
+         * Maximum number of concurrent workers
+         * Range: 1-20
+         */
+        workerCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        pollIntervalMs?: number | undefined;
+        workerCount?: number | undefined;
+    }, {
+        pollIntervalMs?: number | undefined;
+        workerCount?: number | undefined;
+    }>>;
+    /**
+     * Cluster configuration (optional)
+     * Defines the development cluster Docker topology
+     */
+    cluster: z.ZodOptional<z.ZodObject<{
+        /**
+         * Cluster variant determines the Docker topology
+         * - standard: Docker-outside-of-Docker (DooD) — for apps that don't run containers
+         * - microservices: Docker-in-Docker (DinD) — each worker can run isolated container stacks
+         */
+        variant: z.ZodDefault<z.ZodEnum<["standard", "microservices"]>>;
+    }, "strip", z.ZodTypeAny, {
+        variant: "standard" | "microservices";
+    }, {
+        variant?: "standard" | "microservices" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    repos: {
+        primary: string;
+        dev: string[];
+        clone: string[];
+    };
+    schemaVersion: string;
+    project: {
+        id: string;
+        name: string;
+    };
+    orchestrator?: {
+        pollIntervalMs?: number | undefined;
+        workerCount?: number | undefined;
+    } | undefined;
+    defaults?: {
+        agent?: string | undefined;
+        baseBranch?: string | undefined;
+    } | undefined;
+    cluster?: {
+        variant: "standard" | "microservices";
+    } | undefined;
+}, {
+    repos: {
+        primary: string;
+        dev?: string[] | undefined;
+        clone?: string[] | undefined;
+    };
+    project: {
+        id: string;
+        name: string;
+    };
+    orchestrator?: {
+        pollIntervalMs?: number | undefined;
+        workerCount?: number | undefined;
+    } | undefined;
+    schemaVersion?: string | undefined;
+    defaults?: {
+        agent?: string | undefined;
+        baseBranch?: string | undefined;
+    } | undefined;
+    cluster?: {
+        variant?: "standard" | "microservices" | undefined;
+    } | undefined;
+}>;
+export type GeneracyConfig = z.infer<typeof GeneracyConfigSchema>;
+/**
+ * Validate a configuration object against the schema
+ *
+ * @param config - Unknown configuration object to validate
+ * @returns Validated and typed configuration
+ * @throws ZodError if validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = validateConfig({
+ *   project: { id: 'proj_abc123', name: 'My Project' },
+ *   repos: { primary: 'github.com/acme/main' }
+ * });
+ * ```
+ */
+export declare function validateConfig(config: unknown): GeneracyConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;OAIG;;IAKH;;;OAGG;;;;;;;;EAIH,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAiBhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;OAIG;;;;;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;IAQH;;;OAGG;;;;;;;;EAIH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IACrC;;;OAGG;;IAMH;;;OAGG;;;;;;;;EAMH,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;OAIG;;;;;;EAEH,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;OAIG;;IAGH;;OAEG;;QAlJH;;;;WAIG;;QAKH;;;WAGG;;;;;;;;;IAyIH;;OAEG;;QA/GH;;;WAGG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;;;;;;;;;;IAiGH;;OAEG;;QAxFH;;;WAGG;;QAQH;;;WAGG;;;;;;;;;IA6EH;;OAEG;;QAlEH;;;WAGG;;QAMH;;;WAGG;;;;;;;;;IAyDH;;;OAGG;;QA7CH;;;;WAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2CH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAE9D"}

package/dist/config/schema.js

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+/**
+ * Project configuration schema
+ * Defines project metadata and link to generacy.ai
+ */
+export const ProjectConfigSchema = z.object({
+    /**
+     * Unique project ID from generacy.ai
+     * Format: proj_{alphanumeric}, minimum 12 characters total
+     * Example: "proj_abc123"
+     */
+    id: z.string()
+        .regex(/^proj_[a-z0-9]+$/, 'Project ID must match format: proj_{alphanumeric}')
+        .min(12, 'Project ID must be at least 12 characters'),
+    /**
+     * Human-readable project name
+     * Maximum 255 characters
+     */
+    name: z.string()
+        .min(1, 'Project name cannot be empty')
+        .max(255, 'Project name cannot exceed 255 characters'),
+});
+/**
+ * Repository URL schema
+ * Format: github.com/{owner}/{repo}
+ * Protocol-agnostic (no https:// or ssh://, no .git suffix)
+ */
+const RepositoryUrlSchema = z.string()
+    .regex(/^github\.com\/[a-zA-Z0-9_-]+\/[a-zA-Z0-9._-]+$/, 'Repository URL must match format: github.com/{owner}/{repo}')
+    .refine((url) => !url.endsWith('.git'), 'Repository URL must not end with .git suffix');
+/**
+ * Repository configuration schema
+ * Defines repository relationships for the project
+ */
+export const ReposConfigSchema = z.object({
+    /**
+     * Primary repository (the "main" repo for the project)
+     * This is the repository where the onboarding PR will be created
+     */
+    primary: RepositoryUrlSchema,
+    /**
+     * Development repositories (optional)
+     * These repos are cloned for active development and can receive PRs
+     * Default: empty array
+     */
+    dev: z.array(RepositoryUrlSchema).optional().default([]),
+    /**
+     * Clone-only repositories (optional)
+     * These repos are cloned for reference/reading only (no PRs created)
+     * Default: empty array
+     */
+    clone: z.array(RepositoryUrlSchema).optional().default([]),
+});
+/**
+ * Workflow defaults schema
+ * Defines default settings for workflow execution
+ */
+export const DefaultsConfigSchema = z.object({
+    /**
+     * Default agent to use for workflow execution
+     * Format: kebab-case (e.g., "claude-code", "cursor-agent")
+     */
+    agent: z.string()
+        .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'Agent name must be kebab-case format (lowercase alphanumeric with hyphens)')
+        .optional(),
+    /**
+     * Default base branch for creating feature branches
+     * No validation of branch existence (checked at runtime)
+     */
+    baseBranch: z.string()
+        .min(1, 'Base branch cannot be empty')
+        .optional(),
+});
+/**
+ * Orchestrator settings schema
+ * Defines runtime settings for the orchestrator
+ */
+export const OrchestratorSettingsSchema = z.object({
+    /**
+     * Polling interval in milliseconds
+     * Minimum 5000ms (5 seconds)
+     */
+    pollIntervalMs: z.number()
+        .int('Poll interval must be an integer')
+        .min(5000, 'Poll interval must be at least 5000ms (5 seconds)')
+        .optional(),
+    /**
+     * Maximum number of concurrent workers
+     * Range: 1-20
+     */
+    workerCount: z.number()
+        .int('Worker count must be an integer')
+        .min(1, 'Worker count must be at least 1')
+        .max(20, 'Worker count cannot exceed 20')
+        .optional(),
+});
+/**
+ * Cluster configuration schema
+ * Defines the development cluster topology
+ */
+export const ClusterConfigSchema = z.object({
+    /**
+     * Cluster variant determines the Docker topology
+     * - standard: Docker-outside-of-Docker (DooD) — for apps that don't run containers
+     * - microservices: Docker-in-Docker (DinD) — each worker can run isolated container stacks
+     */
+    variant: z.enum(['standard', 'microservices']).default('standard'),
+});
+/**
+ * Complete Generacy configuration schema
+ * Root configuration object for .generacy/config.yaml
+ */
+export const GeneracyConfigSchema = z.object({
+    /**
+     * Schema version (optional)
+     * Defaults to "1" if omitted
+     * Used for future migration support
+     */
+    schemaVersion: z.string().default('1'),
+    /**
+     * Project configuration (required)
+     */
+    project: ProjectConfigSchema,
+    /**
+     * Repository configuration (required)
+     */
+    repos: ReposConfigSchema,
+    /**
+     * Workflow defaults (optional)
+     */
+    defaults: DefaultsConfigSchema.optional(),
+    /**
+     * Orchestrator settings (optional)
+     */
+    orchestrator: OrchestratorSettingsSchema.optional(),
+    /**
+     * Cluster configuration (optional)
+     * Defines the development cluster Docker topology
+     */
+    cluster: ClusterConfigSchema.optional(),
+});
+/**
+ * Validate a configuration object against the schema
+ *
+ * @param config - Unknown configuration object to validate
+ * @returns Validated and typed configuration
+ * @throws ZodError if validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = validateConfig({
+ *   project: { id: 'proj_abc123', name: 'My Project' },
+ *   repos: { primary: 'github.com/acme/main' }
+ * });
+ * ```
+ */
+export function validateConfig(config) {
+    return GeneracyConfigSchema.parse(config);
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/config/validator.d.ts

@@ -0,0 +1,60 @@
+import type { GeneracyConfig } from './schema.js';
+/**
+ * Validation error class for semantic validation failures
+ */
+export declare class ConfigValidationError extends Error {
+    readonly conflictingRepos?: string[] | undefined;
+    readonly locations?: string[] | undefined;
+    constructor(message: string, conflictingRepos?: string[] | undefined, locations?: string[] | undefined);
+}
+/**
+ * Check for duplicate repositories across primary, dev, and clone lists
+ *
+ * This function implements detailed duplicate detection with clear error messages
+ * indicating exactly which repositories conflict and in which lists they appear.
+ *
+ * Validation rules:
+ * - Primary repo cannot appear in dev list
+ * - Primary repo cannot appear in clone list
+ * - No repository can appear in both dev and clone lists
+ * - No repository can appear twice within the same list (dev or clone)
+ *
+ * @param config - Validated Generacy configuration
+ * @throws ConfigValidationError if duplicates are found, with details about the conflict
+ *
+ * @example
+ * ```typescript
+ * // Valid configuration - no duplicates
+ * validateNoDuplicateRepos({
+ *   repos: {
+ *     primary: 'github.com/acme/main',
+ *     dev: ['github.com/acme/lib'],
+ *     clone: ['github.com/acme/docs']
+ *   }
+ * });
+ *
+ * // Invalid - throws with details about which lists conflict
+ * validateNoDuplicateRepos({
+ *   repos: {
+ *     primary: 'github.com/acme/main',
+ *     dev: ['github.com/acme/main'], // Conflict!
+ *     clone: []
+ *   }
+ * });
+ * ```
+ */
+export declare function validateNoDuplicateRepos(config: GeneracyConfig): void;
+/**
+ * Perform all semantic validations on a configuration
+ *
+ * @param config - Validated Generacy configuration
+ * @throws ConfigValidationError if any semantic validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = validateConfig(rawConfig);
+ * validateSemantics(config); // Throws if semantic rules violated
+ * ```
+ */
+export declare function validateSemantics(config: GeneracyConfig): void;
+//# sourceMappingURL=validator.d.ts.map

package/dist/config/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/config/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,gBAAgB,CAAC,EAAE,MAAM,EAAE;aAC3B,SAAS,CAAC,EAAE,MAAM,EAAE;gBAFpC,OAAO,EAAE,MAAM,EACC,gBAAgB,CAAC,EAAE,MAAM,EAAE,YAAA,EAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,YAAA;CAKvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAwDrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE9D"}

package/dist/config/validator.js

@@ -0,0 +1,112 @@
+/**
+ * Validation error class for semantic validation failures
+ */
+export class ConfigValidationError extends Error {
+    conflictingRepos;
+    locations;
+    constructor(message, conflictingRepos, locations) {
+        super(message);
+        this.conflictingRepos = conflictingRepos;
+        this.locations = locations;
+        this.name = 'ConfigValidationError';
+    }
+}
+/**
+ * Check for duplicate repositories across primary, dev, and clone lists
+ *
+ * This function implements detailed duplicate detection with clear error messages
+ * indicating exactly which repositories conflict and in which lists they appear.
+ *
+ * Validation rules:
+ * - Primary repo cannot appear in dev list
+ * - Primary repo cannot appear in clone list
+ * - No repository can appear in both dev and clone lists
+ * - No repository can appear twice within the same list (dev or clone)
+ *
+ * @param config - Validated Generacy configuration
+ * @throws ConfigValidationError if duplicates are found, with details about the conflict
+ *
+ * @example
+ * ```typescript
+ * // Valid configuration - no duplicates
+ * validateNoDuplicateRepos({
+ *   repos: {
+ *     primary: 'github.com/acme/main',
+ *     dev: ['github.com/acme/lib'],
+ *     clone: ['github.com/acme/docs']
+ *   }
+ * });
+ *
+ * // Invalid - throws with details about which lists conflict
+ * validateNoDuplicateRepos({
+ *   repos: {
+ *     primary: 'github.com/acme/main',
+ *     dev: ['github.com/acme/main'], // Conflict!
+ *     clone: []
+ *   }
+ * });
+ * ```
+ */
+export function validateNoDuplicateRepos(config) {
+    const { primary, dev = [], clone = [] } = config.repos;
+    const allDuplicates = new Set();
+    const locations = new Set();
+    // Check if primary is in dev list
+    if (dev.includes(primary)) {
+        allDuplicates.add(primary);
+        locations.add('primary').add('dev');
+    }
+    // Check if primary is in clone list
+    if (clone.includes(primary)) {
+        allDuplicates.add(primary);
+        locations.add('primary').add('clone');
+    }
+    // Check for duplicates within dev list
+    const devSeen = new Set();
+    for (const repo of dev) {
+        if (devSeen.has(repo)) {
+            allDuplicates.add(repo);
+            locations.add('dev');
+        }
+        devSeen.add(repo);
+    }
+    // Check for duplicates within clone list
+    const cloneSeen = new Set();
+    for (const repo of clone) {
+        if (cloneSeen.has(repo)) {
+            allDuplicates.add(repo);
+            locations.add('clone');
+        }
+        cloneSeen.add(repo);
+    }
+    // Check for overlaps between dev and clone lists
+    for (const repo of clone) {
+        if (devSeen.has(repo)) {
+            allDuplicates.add(repo);
+            locations.add('dev').add('clone');
+        }
+    }
+    // Report duplicates if found
+    if (allDuplicates.size > 0) {
+        const dupeList = Array.from(allDuplicates).join(', ');
+        const locationList = Array.from(locations);
+        throw new ConfigValidationError(`Duplicate repositories found: ${dupeList}. ` +
+            'Each repository can only appear once across primary, dev, and clone lists.', Array.from(allDuplicates), locationList);
+    }
+}
+/**
+ * Perform all semantic validations on a configuration
+ *
+ * @param config - Validated Generacy configuration
+ * @throws ConfigValidationError if any semantic validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = validateConfig(rawConfig);
+ * validateSemantics(config); // Throws if semantic rules violated
+ * ```
+ */
+export function validateSemantics(config) {
+    validateNoDuplicateRepos(config);
+}
+//# sourceMappingURL=validator.js.map

package/dist/config/validator.js.map

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