@archora/forge-cli 1.4.0 → 2.0.0

package/dist/internal.d.ts

@@ -0,0 +1,363 @@
+import { ContractDiffReport, ForgeDiagnostic, SchemaCoverageMatrix, GenerationPlan } from '@archora/forge-core';
+import { ResolvedForgeConfig } from '@archora/forge-config';
+
+declare function printPendingPhaseMessage(command: string, detail: string): void;
+declare const logger: {
+    title(): void;
+    line(message?: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};
+
+declare function writeReportFile(path: string, content: string): Promise<string>;
+
+type SchemaRequestCliOptions = {
+    schemaHeader?: string | string[];
+};
+declare function parseSchemaRequestHeaders(value: string | string[] | undefined): Record<string, string>;
+
+type DiagnosticLike = {
+    severity?: string;
+    code?: string;
+    message?: string;
+    location?: string;
+    suggestion?: string;
+};
+type DriftLike = {
+    path?: string;
+    kind?: string;
+};
+type SchemaLike = {
+    name?: string;
+    schema?: string;
+    configPath?: string | null;
+    healthScore?: number;
+    health?: {
+        score?: number;
+        endpointCount?: number;
+        schemaCount?: number;
+        tagCount?: number;
+        crudCandidateCount?: number;
+    };
+    resourceCount?: number;
+    resources?: unknown[] | number;
+    generatedFiles?: number;
+    protectedFiles?: number;
+    diagnosticsCount?: number;
+    failedChecks?: string[];
+    coverage?: CoverageLike;
+};
+type CoverageLike = {
+    operations?: {
+        total?: number;
+        generated?: number;
+        diagnosticOnly?: number;
+        byKind?: Record<string, number>;
+        byRequestShape?: Record<string, number>;
+        byResponseShape?: Record<string, number>;
+    };
+    schemas?: {
+        total?: number;
+        unsupportedConstructs?: Record<string, number>;
+    };
+    cases?: {
+        generated?: number;
+        skipped?: number;
+        fallback?: number;
+        diagnosticOnly?: number;
+    };
+};
+type HtmlReportPayload = {
+    ok?: boolean;
+    schema?: string;
+    configPath?: string | null;
+    healthScore?: number;
+    health?: {
+        score?: number;
+        endpointCount?: number;
+        schemaCount?: number;
+        tagCount?: number;
+        crudCandidateCount?: number;
+    };
+    resources?: unknown[] | number;
+    resourceCount?: number;
+    generatedFiles?: number;
+    protectedFiles?: number;
+    failedChecks?: string[];
+    readiness?: {
+        status?: string;
+        decision?: string;
+        gate?: {
+            result?: string;
+            recommendedCiMode?: string;
+            reason?: string;
+        };
+        blockers?: string[];
+        warnings?: string[];
+        nextActions?: string[];
+        reviewerChecklist?: string[];
+    };
+    drift?: DriftLike[];
+    diagnostics?: DiagnosticLike[];
+    schemas?: SchemaLike[];
+    files?: {
+        create?: number;
+        update?: number;
+        protected?: number;
+    };
+    changes?: Array<{
+        severity?: string;
+        code?: string;
+        message?: string;
+        location?: string;
+    }>;
+    affectedResources?: string[];
+    affectedFiles?: string[];
+    summary?: {
+        breaking?: number;
+        warnings?: number;
+        nonBreaking?: number;
+        total?: number;
+    };
+    decision?: {
+        status?: string;
+        mergeRisk?: string;
+        reason?: string;
+    };
+    impactedSurface?: {
+        operationIds?: string[];
+        clientMethods?: string[];
+        queryHooks?: string[];
+    };
+    migrationHints?: string[];
+    prSummary?: string;
+    resourceExplorer?: Array<{
+        name?: string;
+        operations?: Array<{
+            id?: string;
+            method?: string;
+            path?: string;
+            kind?: string;
+        }>;
+        generatedFiles?: string[];
+    }>;
+    coverage?: CoverageLike;
+    sourceUsages?: Array<{
+        path?: string;
+        matches?: string[];
+        lines?: number[];
+    }>;
+};
+declare function createHtmlReport(title: string, payload: HtmlReportPayload): string;
+
+type SourceUsage = {
+    path: string;
+    matches: string[];
+    lines: number[];
+};
+type ImpactPayload = ContractDiffReport & {
+    ok: boolean;
+    base?: string;
+    oldSchema: string;
+    newSchema: string;
+    sourceUsages?: SourceUsage[];
+};
+declare function formatImpactReport(format: 'json' | 'markdown' | 'html', payload: ImpactPayload): string;
+declare function formatImpactMarkdown(payload: ImpactPayload): string;
+declare function formatPullRequestComment(payload: ImpactPayload): string;
+declare function formatSourceUsageLines(usages: SourceUsage[]): string[];
+declare function scanSourceUsages(repo: string, report: ContractDiffReport): Promise<SourceUsage[]>;
+
+type AuditOptions = {
+    config?: string;
+    out?: string;
+    json?: boolean;
+    skipTypecheck?: boolean;
+    minHealthScore?: string | number;
+} & SchemaRequestCliOptions;
+type TypecheckResult = {
+    status: 'passed' | 'failed' | 'skipped';
+    command: string;
+    workspace: string;
+    errors: string[];
+};
+type AuditEntry = {
+    name: string;
+    schema: string;
+    configPath: string | null;
+    healthScore: number;
+    resources: number;
+    generatedFiles: number;
+    protectedFiles: number;
+    drift: Array<{
+        path: string;
+        kind: string;
+    }>;
+    diagnostics: ForgeDiagnostic[];
+    coverage: SchemaCoverageMatrix;
+    plan: GenerationPlan;
+    resourceExplorer: ResourceExplorerEntry[];
+};
+type ResourceExplorerEntry = {
+    name: string;
+    entity: string;
+    kind: string;
+    operations: Array<{
+        method: string;
+        path: string;
+        operationId: string | null;
+        kind: string;
+    }>;
+    generatedFiles: string[];
+};
+declare function runAuditPackage(schema: string | undefined, options: AuditOptions): Promise<{
+    outDir: string;
+    entries: AuditEntry[];
+    payload: {
+        ok: boolean;
+        schema: string;
+        schemas: {
+            name: string;
+            schema: string;
+            configPath: string | null;
+            healthScore: number;
+            resources: number;
+            generatedFiles: number;
+            protectedFiles: number;
+            driftCount: number;
+            diagnosticsCount: number;
+            coverage: SchemaCoverageMatrix;
+        }[];
+        audit: {
+            outDir: string;
+            generatedPreview: string;
+            artifacts: string[];
+        };
+        healthScore: number;
+        resources: number;
+        generatedFiles: number;
+        protectedFiles: number;
+        failedChecks: string[];
+        scorecard: {
+            frontendReadiness: number;
+            typeSafety: number;
+            resourceCoverage: number;
+            driftSafety: number;
+            ciAdoption: number;
+        };
+        generator: {
+            status: string;
+            version: string;
+            files: {
+                total: number;
+                missingMetadata: {
+                    path: string;
+                }[];
+                versionMismatches: never[];
+                schemaHashMismatches: never[];
+                configHashMismatches: never[];
+            };
+        };
+        coverage: SchemaCoverageMatrix;
+        typecheck: TypecheckResult;
+        resourceExplorer: ResourceExplorerEntry[];
+        fixSuggestions: {
+            code: string;
+            count: number;
+            suggestion: string;
+        }[];
+        readiness: {
+            status: string;
+            gate: {
+                result: "pass";
+                recommendedCiMode: "block";
+                reason: string;
+            } | {
+                result: "warn";
+                recommendedCiMode: "comment";
+                reason: string;
+            } | {
+                result: "fail";
+                recommendedCiMode: "block";
+                reason: string;
+            };
+            decision: string;
+            blockers: string[];
+            warnings: string[];
+            nextActions: string[];
+            reviewerChecklist: string[];
+            summary: {
+                healthScore: number;
+                resources: number;
+                generatedFiles: number;
+                protectedFiles: number;
+                diagnostics: number;
+                drift: number;
+                failedChecks: number;
+            };
+        };
+        drift: {
+            path: string;
+            kind: string;
+        }[];
+        diagnostics: ForgeDiagnostic[];
+    };
+}>;
+
+type GitBaseSchema = {
+    path: string;
+    label: string;
+    base: string;
+    cleanup: () => Promise<void>;
+};
+declare function readGitBaseSchema(schemaPath: string, options: {
+    base: string;
+    repo?: string;
+}): Promise<GitBaseSchema>;
+
+type CliConfigResult = {
+    name?: string;
+    config: ResolvedForgeConfig;
+    schema: string;
+    configPath: string | null;
+    cwd: string;
+};
+declare function loadCliConfig(schema: string | undefined, options?: ({
+    config?: string;
+    force?: boolean;
+} & SchemaRequestCliOptions)): Promise<CliConfigResult>;
+declare function loadCliConfigSet(schema: string | undefined, options?: ({
+    config?: string;
+    force?: boolean;
+} & SchemaRequestCliOptions)): Promise<CliConfigResult[]>;
+
+type LicensePlan = 'trial' | 'pilot' | 'team' | 'organization';
+type LicensePayload = {
+    licenseId: string;
+    customer: string;
+    issuedAt: string;
+    expiresAt: string;
+    plan: LicensePlan;
+};
+type LicenseValidation = {
+    status: 'active' | 'expired' | 'invalid' | 'clockRollback' | 'missing' | 'missingPublicKey';
+    payload: LicensePayload | null;
+    message: string;
+};
+declare function isLicenseEnforcementConfigured(): boolean;
+declare function activateLicenseKey(licenseKey: string, options?: {
+    now?: Date;
+}): Promise<LicenseValidation>;
+declare function getStoredLicenseStatus(options?: {
+    now?: Date;
+}): Promise<LicenseValidation>;
+declare function removeStoredLicense(): Promise<void>;
+declare function requireCommercialLicense(command: string): Promise<void>;
+declare function validateLicenseKey(licenseKey: string, options?: {
+    now?: Date;
+    lastSeenAt?: string | null;
+    publicKey?: JsonWebKey | null;
+}): Promise<LicenseValidation>;
+
+export { type AuditOptions, type CliConfigResult, type GitBaseSchema, type ImpactPayload, type LicensePayload, type LicensePlan, type LicenseValidation, type SchemaRequestCliOptions, type SourceUsage, activateLicenseKey, createHtmlReport, formatImpactMarkdown, formatImpactReport, formatPullRequestComment, formatSourceUsageLines, getStoredLicenseStatus, isLicenseEnforcementConfigured, loadCliConfig, loadCliConfigSet, logger, parseSchemaRequestHeaders, printPendingPhaseMessage, readGitBaseSchema, removeStoredLicense, requireCommercialLicense, runAuditPackage, scanSourceUsages, validateLicenseKey, writeReportFile };

package/dist/internal.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import {
+  activateLicenseKey,
+  createHtmlReport,
+  formatImpactMarkdown,
+  formatImpactReport,
+  formatPullRequestComment,
+  formatSourceUsageLines,
+  getStoredLicenseStatus,
+  isLicenseEnforcementConfigured,
+  loadCliConfig,
+  loadCliConfigSet,
+  logger,
+  parseSchemaRequestHeaders,
+  printPendingPhaseMessage,
+  removeStoredLicense,
+  requireCommercialLicense,
+  runAuditPackage,
+  scanSourceUsages,
+  validateLicenseKey,
+  writeReportFile
+} from "./chunk-RL23SDLM.js";
+
+// src/git-base-schema.ts
+import { execFile } from "child_process";
+import { mkdtemp, rm, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { isAbsolute, relative, resolve, sep } from "path";
+import { promisify } from "util";
+var execFileAsync = promisify(execFile);
+async function readGitBaseSchema(schemaPath, options) {
+  const repo = resolve(options.repo ?? process.cwd());
+  const absoluteSchemaPath = isAbsolute(schemaPath) ? resolve(schemaPath) : resolve(repo, schemaPath);
+  const repoRelativePath = relative(repo, absoluteSchemaPath).split(sep).join("/");
+  if (!repoRelativePath || repoRelativePath.startsWith("..") || isAbsolute(repoRelativePath)) {
+    throw new Error(`Schema path must be inside the repository when using --base: ${schemaPath}`);
+  }
+  let stdout;
+  try {
+    const result = await execFileAsync("git", ["-C", repo, "show", `${options.base}:${repoRelativePath}`], {
+      maxBuffer: 20 * 1024 * 1024,
+      timeout: 15e3
+    });
+    stdout = result.stdout;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Cannot read ${repoRelativePath} from git ref "${options.base}". ${message}`);
+  }
+  const tempDir = await mkdtemp(resolve(tmpdir(), "archora-forge-base-"));
+  const tempPath = resolve(tempDir, repoRelativePath.replace(/\//g, "__"));
+  await writeFile(tempPath, stdout, "utf8");
+  return {
+    path: tempPath,
+    label: `${options.base}:${repoRelativePath}`,
+    base: options.base,
+    cleanup: () => rm(tempDir, { recursive: true, force: true })
+  };
+}
+export {
+  activateLicenseKey,
+  createHtmlReport,
+  formatImpactMarkdown,
+  formatImpactReport,
+  formatPullRequestComment,
+  formatSourceUsageLines,
+  getStoredLicenseStatus,
+  isLicenseEnforcementConfigured,
+  loadCliConfig,
+  loadCliConfigSet,
+  logger,
+  parseSchemaRequestHeaders,
+  printPendingPhaseMessage,
+  readGitBaseSchema,
+  removeStoredLicense,
+  requireCommercialLicense,
+  runAuditPackage,
+  scanSourceUsages,
+  validateLicenseKey,
+  writeReportFile
+};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@archora/forge-cli",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "description": "CLI for generating typed frontend resource contracts from OpenAPI contracts.",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/archora-dev/archora-forge.git"
@@ -21,6 +21,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
     }
   },
   "files": [
@@ -40,9 +44,9 @@
     "@types/node": "^22.15.17",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "@archora/forge-adapters": "1.4.0",
-    "@archora/forge-core": "1.4.0",
-    "@archora/forge-config": "1.4.0"
+    "@archora/forge-adapters": "2.0.0",
+    "@archora/forge-config": "2.0.0",
+    "@archora/forge-core": "2.0.0"
   },
   "scripts": {
     "build": "tsup",