cc-agentic-framework 1.14.1

package/dist/commands/build.js

@@ -0,0 +1,116 @@
+/**
+ * Build Command
+ *
+ * Unified validation command that provides compile-time-like checking for
+ * framework markdown files with YAML frontmatter.
+ *
+ * Consolidates:
+ * - Schema validation (agents, skills)
+ * - Link validation (internal, external)
+ * - Cross-reference validation (capabilities, delegates-to)
+ * - IDE schema generation
+ *
+ * @module commands/build
+ */
+import { Command } from 'commander';
+import * as path from 'path';
+import chalk from 'chalk';
+import { BuildEngine, formatBuildOutput } from '../lib/build/build-engine.js';
+import { CliContext } from '../lib/cli-context.js';
+import { recordCLICommand } from '../lib/telemetry/instrumentation/cli-instrumentation.js';
+/**
+ * Create the build command
+ */
+export function createBuildCommand() {
+    return new Command('build')
+        .description('Validate framework artifacts with compile-time-like checking')
+        .option('-p, --path <path>', 'Project path', '.')
+        .option('-q, --quick', 'Quick mode: schema validation only (skip links)')
+        .option('--external-links', 'Also check external URLs (slower)')
+        .option('--emit-schemas', 'Generate JSON schemas for WebStorm/IDE')
+        .option('--schema-dir <dir>', 'Output directory for JSON schemas')
+        .option('--json', 'Output results as JSON')
+        .option('-v, --verbose', 'Show detailed output with suggestions')
+        .option('--ci', 'CI mode: minimal output, strict exit codes')
+        .action(buildCommand);
+}
+/**
+ * Execute the build command
+ */
+async function buildCommand(options) {
+    const startTime = Date.now();
+    const ctx = options.path && options.path !== '.'
+        ? await CliContext.create({ path: options.path })
+        : await CliContext.require();
+    const projectPath = ctx.projectRoot;
+    // Determine framework path for self-dev projects
+    let frameworkPath = projectPath;
+    // Use manifest from context if available
+    if (ctx.manifest?.paths?.source) {
+        frameworkPath = path.join(projectPath, ctx.manifest.paths.source);
+    }
+    // Show header unless in JSON/CI mode
+    if (!options.json && !options.ci) {
+        console.log('');
+        console.log(chalk.bold('Building framework...'));
+        if (options.quick) {
+            console.log(chalk.dim('Quick mode: schema validation only'));
+        }
+        console.log('');
+    }
+    // Build options
+    const buildOptions = {
+        projectPath,
+        frameworkPath,
+        quick: options.quick,
+        externalLinks: options.externalLinks,
+        emitSchemas: options.emitSchemas,
+        schemaOutputDir: options.schemaDir,
+        verbose: options.verbose,
+    };
+    // Run build
+    const engine = new BuildEngine(buildOptions);
+    const result = await engine.build();
+    // Output results
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else if (options.ci) {
+        // CI mode: minimal output
+        if (result.success) {
+            console.log(`✓ Build passed (${result.stats.agentsChecked} agents, ${result.stats.skillsChecked} skills)`);
+        }
+        else {
+            console.log(`✗ Build failed: ${result.errorCount} errors, ${result.warningCount} warnings`);
+            // Show just the error messages
+            for (const issue of result.issues) {
+                if (issue.severity === 'error') {
+                    const loc = issue.line ? `:${issue.line}` : '';
+                    console.log(`  ${issue.file}${loc}: ${issue.message}`);
+                }
+            }
+        }
+    }
+    else {
+        // Standard output
+        console.log(formatBuildOutput(result, options.verbose ?? false));
+    }
+    // Record telemetry
+    const durationMs = Date.now() - startTime;
+    recordCLICommand('build', undefined, { quick: options.quick, externalLinks: options.externalLinks, emitSchemas: options.emitSchemas, ci: options.ci }, {
+        files_checked: result.stats.filesChecked,
+        agents_checked: result.stats.agentsChecked,
+        skills_checked: result.stats.skillsChecked,
+        errors: result.errorCount,
+        warnings: result.warningCount
+    }, durationMs, result.success).catch(() => { });
+    // Exit with appropriate code
+    if (!result.success) {
+        process.exit(1);
+    }
+    else if (result.warningCount > 0 && options.ci) {
+        // In CI mode, warnings are exit code 0 but noted
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

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

package/dist/commands/bump-version.d.ts

@@ -0,0 +1,61 @@
+import { Command } from "commander";
+export interface BumpVersionOptions {
+    projectRoot: string;
+    type?: "major" | "minor" | "patch";
+    version?: string;
+    dryRun: boolean;
+    /** Auto-detect affected modules and bump them */
+    auto?: boolean;
+    /** Specific module to bump (independent versioning) */
+    module?: string;
+    /** Stage files after update (for pre-commit hook) */
+    stage?: boolean;
+    /** Base branch for auto-detection (default: main) */
+    baseBranch?: string;
+    /** Only bump package.json, not module versions (for CI releases) */
+    packageOnly?: boolean;
+}
+export interface ModuleBumpResult {
+    moduleId: string;
+    currentVersion: string;
+    newVersion: string;
+    moduleJsonPath: string;
+}
+export interface BumpVersionResult {
+    /** For backward compat - CLI package version */
+    currentVersion: string;
+    newVersion: string;
+    filesUpdated: number;
+    dryRun: boolean;
+    updatedFiles: string[];
+    /** Module-specific results for independent versioning */
+    moduleBumps?: ModuleBumpResult[];
+    /** Whether auto-detection was used */
+    autoDetected?: boolean;
+}
+export interface VersionParts {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Parse semantic version string into components
+ */
+export declare function parseVersion(versionStr: string): VersionParts;
+/**
+ * Validate version format (strict semver)
+ */
+export declare function validateVersionFormat(version: string): boolean;
+/**
+ * Increment version based on bump type
+ */
+export declare function incrementVersion(version: string, bumpType: "major" | "minor" | "patch"): string;
+/**
+ * Main version bump logic (updated to support independent versioning)
+ */
+export declare function bumpVersion(options: BumpVersionOptions): Promise<BumpVersionResult>;
+/**
+ * Create the bump-version command
+ */
+export declare function createBumpVersionCommand(): Command;
+//# sourceMappingURL=bump-version.d.ts.map

package/dist/commands/bump-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump-version.d.ts","sourceRoot":"","sources":["../../src/commands/bump-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yDAAyD;IACzD,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CA8C7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAK9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GACpC,MAAM,CAaR;AAmTD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAyU5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAmIlD"}