@bluefly/openstandardagents 0.3.2 → 0.3.3

package/dist/config/defaults.js

@@ -0,0 +1,223 @@
+/**
+ * OSSA Default Configuration
+ *
+ * Centralized default values for all OSSA CLI commands.
+ * All defaults can be overridden via environment variables.
+ *
+ * DRY: Single source of truth for all default values
+ * SOLID: Configuration separated from business logic
+ *
+ * @module config/defaults
+ */
+/**
+ * Get default agent version
+ * Can be overridden via OSSA_DEFAULT_AGENT_VERSION env var
+ */
+export function getDefaultAgentVersion() {
+    return process.env.OSSA_DEFAULT_AGENT_VERSION || '1.0.0';
+}
+/**
+ * Get default agent type
+ * Can be overridden via OSSA_DEFAULT_AGENT_TYPE env var
+ */
+export function getDefaultAgentType() {
+    return process.env.OSSA_DEFAULT_AGENT_TYPE || 'worker';
+}
+/**
+ * Get default LLM provider
+ * Can be overridden via OSSA_DEFAULT_LLM_PROVIDER env var
+ */
+export function getDefaultLLMProvider() {
+    return process.env.OSSA_DEFAULT_LLM_PROVIDER || 'openai';
+}
+/**
+ * Get default LLM model (with environment variable pattern)
+ * Can be overridden via OSSA_DEFAULT_LLM_MODEL env var
+ */
+export function getDefaultLLMModel() {
+    const defaultModel = process.env.OSSA_DEFAULT_LLM_MODEL || 'gpt-4';
+    return `\${LLM_MODEL:-${defaultModel}}`;
+}
+/**
+ * Get default agent kind
+ * Can be overridden via OSSA_DEFAULT_AGENT_KIND env var
+ */
+export function getDefaultAgentKind() {
+    return process.env.OSSA_DEFAULT_AGENT_KIND || 'Agent';
+}
+/**
+ * Get default agent name fallback
+ * Can be overridden via OSSA_DEFAULT_AGENT_NAME_FALLBACK env var
+ */
+export function getDefaultAgentNameFallback() {
+    return process.env.OSSA_DEFAULT_AGENT_NAME_FALLBACK || 'agent';
+}
+/**
+ * Get default scaffold agent name
+ * Can be overridden via OSSA_DEFAULT_SCAFFOLD_NAME env var
+ */
+export function getDefaultScaffoldName() {
+    return process.env.OSSA_DEFAULT_SCAFFOLD_NAME || 'my-agent';
+}
+/**
+ * Get default output directory
+ * Can be overridden via OSSA_DEFAULT_OUTPUT_DIR env var
+ */
+export function getDefaultOutputDir() {
+    return process.env.OSSA_DEFAULT_OUTPUT_DIR || '.agents';
+}
+/**
+ * Get default workspace directory
+ * Can be overridden via OSSA_DEFAULT_WORKSPACE_DIR env var
+ */
+export function getDefaultWorkspaceDir() {
+    return process.env.OSSA_DEFAULT_WORKSPACE_DIR || '.agents-workspace';
+}
+/**
+ * Get supported agent types with their configurations
+ */
+export function getAgentTypeConfigs() {
+    const typesEnv = process.env.OSSA_AGENT_TYPES;
+    if (typesEnv) {
+        try {
+            return JSON.parse(typesEnv);
+        }
+        catch {
+            // Fall through to defaults
+        }
+    }
+    return {
+        worker: {
+            type: 'worker',
+            capabilityName: '',
+            description: 'Standard worker agent',
+        },
+        orchestrator: {
+            type: 'orchestrator',
+            capabilityName: 'orchestration',
+            description: 'Multi-agent workflow coordination',
+        },
+        judge: {
+            type: 'judge',
+            capabilityName: 'evaluation',
+            description: 'Agent output evaluation and scoring',
+        },
+    };
+}
+/**
+ * Get default role template
+ * Can be overridden via OSSA_DEFAULT_ROLE_TEMPLATE env var
+ * Template supports {name} placeholder
+ */
+export function getDefaultRoleTemplate(agentName) {
+    const template = process.env.OSSA_DEFAULT_ROLE_TEMPLATE ||
+        'You are {name}, a helpful AI agent.';
+    if (agentName) {
+        return template.replace('{name}', agentName);
+    }
+    return template.replace('{name}', 'an AI agent');
+}
+/**
+ * Get default description template
+ * Can be overridden via OSSA_DEFAULT_DESCRIPTION_TEMPLATE env var
+ * Template supports {name} placeholder
+ */
+export function getDefaultDescriptionTemplate(agentName) {
+    const template = process.env.OSSA_DEFAULT_DESCRIPTION_TEMPLATE ||
+        '{name} - OSSA-compliant agent';
+    return template.replace('{name}', agentName);
+}
+/**
+ * Get required workspace subdirectories
+ * Can be overridden via OSSA_REQUIRED_WORKSPACE_DIRS env var (comma-separated)
+ */
+export function getRequiredWorkspaceDirs() {
+    const envDirs = process.env.OSSA_REQUIRED_WORKSPACE_DIRS;
+    if (envDirs) {
+        return envDirs.split(',').map(d => d.trim()).filter(Boolean);
+    }
+    return ['registry', 'policies', 'orchestration', 'shared-context', 'logs'];
+}
+/**
+ * Get workspace registry file path
+ * Can be overridden via OSSA_WORKSPACE_REGISTRY_PATH env var
+ */
+export function getWorkspaceRegistryPath() {
+    return process.env.OSSA_WORKSPACE_REGISTRY_PATH || 'registry/index.yaml';
+}
+/**
+ * Get workspace policy file path
+ * Can be overridden via OSSA_WORKSPACE_POLICY_PATH env var
+ */
+export function getWorkspacePolicyPath() {
+    return process.env.OSSA_WORKSPACE_POLICY_PATH || 'policies/tool-allowlist.yaml';
+}
+/**
+ * Get DNS-1123 name validation regex
+ */
+export function getDNS1123Regex() {
+    return /^[a-z0-9]([-a-z0-9]*[a-z0-9])?$/;
+}
+/**
+ * Get semantic version validation regex
+ */
+export function getSemanticVersionRegex() {
+    return /^\d+\.\d+\.\d+/;
+}
+/**
+ * Get maximum DNS-1123 name length
+ */
+export function getMaxDNS1123Length() {
+    return parseInt(process.env.OSSA_MAX_DNS1123_LENGTH || '63', 10);
+}
+/**
+ * Get default agent discovery patterns
+ * Can be overridden via OSSA_DISCOVERY_PATTERNS env var (comma-separated)
+ */
+export function getDefaultDiscoveryPatterns() {
+    const envPatterns = process.env.OSSA_DISCOVERY_PATTERNS;
+    if (envPatterns) {
+        return envPatterns.split(',').map(p => p.trim()).filter(Boolean);
+    }
+    const outputDir = getDefaultOutputDir();
+    return [
+        `${outputDir}/**/*.ossa.yaml`,
+        `${outputDir}/**/manifest.ossa.yaml`,
+    ];
+}
+/**
+ * Get default discovery strategy
+ * Can be overridden via OSSA_DISCOVERY_STRATEGY env var
+ */
+export function getDefaultDiscoveryStrategy() {
+    return process.env.OSSA_DISCOVERY_STRATEGY || 'filesystem';
+}
+/**
+ * Get default discovery refresh mode
+ * Can be overridden via OSSA_DISCOVERY_REFRESH env var
+ */
+export function getDefaultDiscoveryRefresh() {
+    return process.env.OSSA_DISCOVERY_REFRESH || 'on-demand';
+}
+/**
+ * Get default registry kind
+ * Can be overridden via OSSA_REGISTRY_KIND env var
+ */
+export function getDefaultRegistryKind() {
+    return process.env.OSSA_REGISTRY_KIND || 'AgentRegistry';
+}
+/**
+ * Get default policy kind
+ * Can be overridden via OSSA_POLICY_KIND env var
+ */
+export function getDefaultPolicyKind() {
+    return process.env.OSSA_POLICY_KIND || 'ToolPolicy';
+}
+/**
+ * Get default API version for OSSA resources
+ * Can be overridden via OSSA_API_VERSION env var
+ */
+export function getDefaultOSSAAPIVersion() {
+    return process.env.OSSA_API_VERSION || 'ossa.dev/v1';
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

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

package/dist/dev-cli/schemas/spec.schema.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Spec Generation Zod Schemas
+ *
+ * Generated from OpenAPI spec: openapi/dev-cli.openapi.yml
+ * DRY: Single source of truth for spec validation
+ */
+import { z } from 'zod';
+export declare const SpecGenerateRequestSchema: z.ZodObject<{
+    outputDir: z.ZodDefault<z.ZodString>;
+    validate: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const SpecValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const SpecGenerateResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    outputPath: z.ZodString;
+    filesGenerated: z.ZodArray<z.ZodString>;
+    validation: z.ZodOptional<z.ZodObject<{
+        valid: z.ZodBoolean;
+        errors: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SpecGenerateRequest = z.infer<typeof SpecGenerateRequestSchema>;
+export type SpecGenerateResponse = z.infer<typeof SpecGenerateResponseSchema>;
+export type SpecValidationResult = z.infer<typeof SpecValidationResultSchema>;
+export declare const SpecValidateRequestSchema: z.ZodObject<{
+    specPath: z.ZodString;
+}, z.core.$strip>;
+export declare const SpecValidateResponseSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type SpecValidateRequest = z.infer<typeof SpecValidateRequestSchema>;
+export type SpecValidateResponse = z.infer<typeof SpecValidateResponseSchema>;
+//# sourceMappingURL=spec.schema.d.ts.map

package/dist/dev-cli/schemas/spec.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.schema.d.ts","sourceRoot":"","sources":["../../../src/dev-cli/schemas/spec.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,eAAO,MAAM,yBAAyB;;iBAEpC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/dev-cli/schemas/spec.schema.js

@@ -0,0 +1,36 @@
+/**
+ * Spec Generation Zod Schemas
+ *
+ * Generated from OpenAPI spec: openapi/dev-cli.openapi.yml
+ * DRY: Single source of truth for spec validation
+ */
+import { z } from 'zod';
+// ============================================================================
+// Spec Generation
+// ============================================================================
+export const SpecGenerateRequestSchema = z.object({
+    outputDir: z.string().default('spec/'),
+    validate: z.boolean().default(true),
+});
+export const SpecValidationResultSchema = z.object({
+    valid: z.boolean(),
+    errors: z.array(z.string()),
+});
+export const SpecGenerateResponseSchema = z.object({
+    success: z.boolean(),
+    outputPath: z.string(),
+    filesGenerated: z.array(z.string()),
+    validation: SpecValidationResultSchema.optional(),
+});
+// ============================================================================
+// Spec Validation
+// ============================================================================
+export const SpecValidateRequestSchema = z.object({
+    specPath: z.string(),
+});
+export const SpecValidateResponseSchema = z.object({
+    valid: z.boolean(),
+    errors: z.array(z.string()),
+    warnings: z.array(z.string()),
+});
+//# sourceMappingURL=spec.schema.js.map

package/dist/dev-cli/schemas/spec.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.schema.js","sourceRoot":"","sources":["../../../src/dev-cli/schemas/spec.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,UAAU,EAAE,0BAA0B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAMH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC"}

package/dist/dev-cli/schemas/version.schema.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Version Management Zod Schemas
+ *
+ * Generated from OpenAPI spec: openapi/dev-cli.openapi.yml
+ * DRY: Single source of truth for version validation
+ */
+import { z } from 'zod';
+export declare const VersionReleaseRequestSchema: z.ZodObject<{
+    bumpType: z.ZodEnum<{
+        major: "major";
+        minor: "minor";
+        patch: "patch";
+    }>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    skipValidation: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const VersionReleaseResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    oldVersion: z.ZodString;
+    newVersion: z.ZodString;
+    changes: z.ZodArray<z.ZodString>;
+    nextSteps: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type VersionReleaseRequest = z.infer<typeof VersionReleaseRequestSchema>;
+export type VersionReleaseResponse = z.infer<typeof VersionReleaseResponseSchema>;
+export declare const VersionValidateResponseSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type VersionValidateResponse = z.infer<typeof VersionValidateResponseSchema>;
+export declare const HardcodedVersionFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodNumber;
+    content: z.ZodString;
+    suggested: z.ZodString;
+}, z.core.$strip>;
+export declare const VersionAuditResponseSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodNumber;
+        content: z.ZodString;
+        suggested: z.ZodString;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    fixed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type HardcodedVersionFile = z.infer<typeof HardcodedVersionFileSchema>;
+export type VersionAuditResponse = z.infer<typeof VersionAuditResponseSchema>;
+export declare const VersionSyncRequestSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodString>;
+    files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const VersionSyncResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    filesUpdated: z.ZodNumber;
+    files: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type VersionSyncRequest = z.infer<typeof VersionSyncRequestSchema>;
+export type VersionSyncResponse = z.infer<typeof VersionSyncResponseSchema>;
+export declare const VersionConfigSchema: z.ZodObject<{
+    current: z.ZodString;
+    latest_stable: z.ZodString;
+    spec_version: z.ZodString;
+    spec_path: z.ZodString;
+    schema_file: z.ZodString;
+}, z.core.$strip>;
+export type VersionConfig = z.infer<typeof VersionConfigSchema>;
+/**
+ * Pattern for matching semantic versions
+ */
+export declare const SEMVER_PATTERN: RegExp;
+/**
+ * Pattern for matching {{VERSION}} placeholder
+ */
+export declare const VERSION_PLACEHOLDER_PATTERN: RegExp;
+/**
+ * Pattern for matching hardcoded versions in files
+ */
+export declare const HARDCODED_VERSION_PATTERN: RegExp;
+//# sourceMappingURL=version.schema.d.ts.map

package/dist/dev-cli/schemas/version.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.schema.d.ts","sourceRoot":"","sources":["../../../src/dev-cli/schemas/version.schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,2BAA2B;;;;;;;;iBAItC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;iBAMvC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAMlF,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAMpF,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;iBAIrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE;;GAEG;AACH,eAAO,MAAM,cAAc,QAA+C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,2BAA2B,QAAqB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAkF,CAAC"}

package/dist/dev-cli/schemas/version.schema.js

@@ -0,0 +1,83 @@
+/**
+ * Version Management Zod Schemas
+ *
+ * Generated from OpenAPI spec: openapi/dev-cli.openapi.yml
+ * DRY: Single source of truth for version validation
+ */
+import { z } from 'zod';
+// ============================================================================
+// Version Release
+// ============================================================================
+export const VersionReleaseRequestSchema = z.object({
+    bumpType: z.enum(['patch', 'minor', 'major']),
+    dryRun: z.boolean().default(false),
+    skipValidation: z.boolean().default(false),
+});
+export const VersionReleaseResponseSchema = z.object({
+    success: z.boolean(),
+    oldVersion: z.string(),
+    newVersion: z.string(),
+    changes: z.array(z.string()),
+    nextSteps: z.array(z.string()),
+});
+// ============================================================================
+// Version Validation
+// ============================================================================
+export const VersionValidateResponseSchema = z.object({
+    valid: z.boolean(),
+    errors: z.array(z.string()),
+    warnings: z.array(z.string()),
+    details: z.record(z.string(), z.string()).optional(),
+});
+// ============================================================================
+// Version Audit
+// ============================================================================
+export const HardcodedVersionFileSchema = z.object({
+    path: z.string(),
+    line: z.number(),
+    content: z.string(),
+    suggested: z.string(),
+});
+export const VersionAuditResponseSchema = z.object({
+    files: z.array(HardcodedVersionFileSchema),
+    total: z.number(),
+    fixed: z.number().optional(),
+});
+// ============================================================================
+// Version Sync
+// ============================================================================
+export const VersionSyncRequestSchema = z.object({
+    version: z.string().optional(),
+    files: z.array(z.string()).optional(),
+});
+export const VersionSyncResponseSchema = z.object({
+    success: z.boolean(),
+    filesUpdated: z.number(),
+    files: z.array(z.string()),
+});
+// ============================================================================
+// Version Config (from .version.json)
+// ============================================================================
+export const VersionConfigSchema = z.object({
+    current: z.string(),
+    latest_stable: z.string(),
+    spec_version: z.string(),
+    spec_path: z.string(),
+    schema_file: z.string(),
+});
+// ============================================================================
+// Version Pattern Matching
+// ============================================================================
+/**
+ * Pattern for matching semantic versions
+ */
+export const SEMVER_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9.]+))?$/;
+/**
+ * Pattern for matching {{VERSION}} placeholder
+ */
+export const VERSION_PLACEHOLDER_PATTERN = /\{\{VERSION\}\}/g;
+/**
+ * Pattern for matching hardcoded versions in files
+ */
+export const HARDCODED_VERSION_PATTERN = /(?:version|VERSION|v)\s*[:=]\s*["']?(\d+\.\d+\.\d+(?:-[a-zA-Z0-9.]+)?)["']?/gi;
+//# sourceMappingURL=version.schema.js.map

package/dist/dev-cli/schemas/version.schema.js.map

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

package/dist/dev-cli/services/version-audit.service.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Version Audit Service
+ *
+ * Finds all hardcoded versions (not using {{VERSION}} placeholder).
+ * SOLID: Single Responsibility - Audit version usage
+ * DRY: Reuses Zod schemas from schemas/version.schema.ts
+ */
+import { VersionAuditResponse } from '../schemas/version.schema.js';
+export declare class VersionAuditService {
+    private readonly rootDir;
+    private readonly excludePatterns;
+    constructor(rootDir?: string);
+    /**
+     * Audit for hardcoded versions
+     * CRUD: Read operation (audits files)
+     */
+    audit(fix?: boolean): Promise<VersionAuditResponse>;
+    /**
+     * Audit a single file for hardcoded versions
+     */
+    private auditFile;
+    /**
+     * Check if line is a comment or example
+     */
+    private isCommentOrExample;
+    /**
+     * Fix files by replacing hardcoded versions with {{VERSION}}
+     */
+    private fixFiles;
+}
+//# sourceMappingURL=version-audit.service.d.ts.map

package/dist/dev-cli/services/version-audit.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-audit.service.d.ts","sourceRoot":"","sources":["../../../src/dev-cli/services/version-audit.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EACL,oBAAoB,EAIrB,MAAM,8BAA8B,CAAC;AAEtC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;gBAE/B,OAAO,GAAE,MAAsB;IAc3C;;;OAGG;IACG,KAAK,CAAC,GAAG,GAAE,OAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAwChE;;OAEG;IACH,OAAO,CAAC,SAAS;IAgDjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;YACW,QAAQ;CA6CvB"}