@nexusclawhq/cli 0.2.1

package/dist/nexus-cli/src/services/workspace-dx.js

@@ -0,0 +1,168 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRuntimeComposerInput = buildRuntimeComposerInput;
+exports.validateWorkspaceContract = validateWorkspaceContract;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const workspace_contract_1 = require("./workspace-contract");
+const package_manifest_1 = require("./package-manifest");
+function toComposerRef(ref) {
+    return {
+        packageName: ref.packageName,
+        version: ref.version,
+        packageType: ref.packageType,
+        source: ref.source,
+    };
+}
+function normalizeComposerSourceRef(ref) {
+    return toComposerRef({
+        packageName: ref.packageName,
+        version: ref.version,
+        packageType: ref.packageType ?? 'extension-pack',
+        source: ref.source,
+    });
+}
+function buildRuntimeComposerInput(workspaceDir = '.', environmentName) {
+    const workspace = (0, workspace_contract_1.loadWorkspaceManifest)(workspaceDir);
+    const { descriptorPath, descriptor } = (0, workspace_contract_1.loadEnvironmentDescriptor)(workspaceDir, environmentName);
+    const packageStack = descriptor.packageStack;
+    const tenantId = descriptor.target.workspaceId || process.env.NEXUS_WORKSPACE_ID || process.env.NEXUS_WORKSPACE;
+    if (!tenantId) {
+        throw new Error(`Environment ${descriptor.name} does not declare target.workspaceId and no NEXUS_WORKSPACE_ID override was provided.`);
+    }
+    return {
+        workspaceId: descriptor.target.workspaceId,
+        descriptorPath,
+        input: {
+            tenantId,
+            baseline: normalizeComposerSourceRef(packageStack.baseline),
+            genericOverlay: packageStack.genericOverlay ? normalizeComposerSourceRef(packageStack.genericOverlay) : null,
+            industryOverlay: packageStack.industryOverlay ? normalizeComposerSourceRef(packageStack.industryOverlay) : null,
+            extensionPacks: (packageStack.extensionPacks ?? []).map((entry) => normalizeComposerSourceRef(entry)),
+            demoPack: packageStack.demoPack ? normalizeComposerSourceRef(packageStack.demoPack) : null,
+            environmentProfile: packageStack.environmentProfile ? normalizeComposerSourceRef(packageStack.environmentProfile) : null,
+        },
+        registryRootDirectories: workspace.manifest.registry?.rootDirectory
+            ? [path.resolve(workspace.workspaceRoot, workspace.manifest.registry.rootDirectory)]
+            : [],
+    };
+}
+function validateWorkspaceContract(workspaceDir = '.') {
+    const workspace = (0, workspace_contract_1.loadWorkspaceManifest)(workspaceDir);
+    const workspaceValidation = (0, workspace_contract_1.validateWorkspaceManifest)(workspace.manifest);
+    const sourceLayoutValidation = (0, workspace_contract_1.validateWorkspaceSourceLayout)(workspace.workspaceRoot, workspace.manifest);
+    const environments = workspace.manifest.environments.map((environmentRef) => {
+        const descriptorPath = path.join(workspace.workspaceRoot, environmentRef.path);
+        if (!fs.existsSync(descriptorPath)) {
+            return {
+                path: descriptorPath,
+                descriptor: {
+                    schemaVersion: 'dx-environment/v1',
+                    name: environmentRef.name,
+                    type: 'custom',
+                    target: {},
+                    packageStack: {
+                        baseline: { packageName: '', packageType: 'core-baseline' },
+                    },
+                },
+                valid: false,
+                errors: [`Missing environment descriptor: ${environmentRef.path}`],
+                warnings: [],
+            };
+        }
+        const loaded = (0, workspace_contract_1.loadEnvironmentDescriptor)(workspace.workspaceRoot, environmentRef.name);
+        const validation = (0, workspace_contract_1.validateEnvironmentDescriptor)(loaded.descriptor);
+        return {
+            path: loaded.descriptorPath,
+            descriptor: loaded.descriptor,
+            valid: validation.valid,
+            errors: validation.errors,
+            warnings: validation.warnings,
+        };
+    });
+    const packageEntries = workspace.manifest.localPackages
+        .map((localPackage) => path.join(workspace.workspaceRoot, localPackage.path))
+        .filter((packageDirectory) => fs.existsSync(packageDirectory))
+        .map((packageDirectory) => {
+        const loaded = (0, package_manifest_1.loadPackageManifest)(packageDirectory);
+        const validation = (0, package_manifest_1.validateLocalPackageManifest)(loaded.manifest, {
+            packageDirectory: loaded.packageDirectory,
+        });
+        return {
+            manifestPath: loaded.manifestPath,
+            packageDirectory: loaded.packageDirectory,
+            manifest: loaded.manifest,
+            valid: validation.valid,
+            errors: validation.errors,
+            warnings: validation.warnings,
+        };
+    });
+    const manifestDrift = (0, workspace_contract_1.checkManifestSingleSource)(workspace.workspaceRoot);
+    const errors = [
+        ...workspaceValidation.errors,
+        ...sourceLayoutValidation.errors,
+        ...environments.flatMap((environment) => environment.errors),
+        ...packageEntries.flatMap((pkg) => pkg.errors),
+        ...(manifestDrift.inSync ? [] : [manifestDrift.message]),
+    ];
+    const warnings = [
+        ...workspace.warnings,
+        ...workspaceValidation.warnings,
+        ...sourceLayoutValidation.warnings,
+        ...environments.flatMap((environment) => environment.warnings),
+        ...packageEntries.flatMap((pkg) => pkg.warnings),
+        ...((!manifestDrift.inSync || manifestDrift.yamlMissing) && manifestDrift.inSync
+            ? [manifestDrift.message]
+            : []),
+    ];
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        summary: [
+            `workspace=${workspace.manifest.projectName}`,
+            `sourceRoots=${workspace.manifest.sourceRoots.length}`,
+            `sourceLayout=${sourceLayoutValidation.valid ? 'valid' : 'invalid'}`,
+            `manifestSync=${manifestDrift.inSync ? 'in-sync' : 'drifted'}`,
+            `environments=${environments.length}`,
+            `localPackages=${packageEntries.length}`,
+        ],
+        workspace,
+        environments,
+        packages: packageEntries,
+    };
+}
+//# sourceMappingURL=workspace-dx.js.map

package/dist/nexus-cli/src/services/workspace-dx.js.map

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

package/dist/nexus-cli/src/services/workspace-health.d.ts

@@ -0,0 +1,140 @@
+import { type ApiClient } from './api-client';
+import { resolveRegistryRoot, validateRegistryInstall } from './pack-registry';
+import { calculateSourceStatus } from './source-tracker';
+import { loadEnvironmentDescriptor, loadWorkspaceManifest, validateWorkspaceManifest } from './workspace-contract';
+export type HealthStatus = 'healthy' | 'warning' | 'error' | 'skipped';
+export interface HealthCheckContext {
+    workspaceRoot: string;
+    environmentName?: string;
+    workspaceId?: string;
+    verbose?: boolean;
+}
+export interface HealthCheckResult {
+    dimensionName: string;
+    status: HealthStatus;
+    errors: string[];
+    warnings: string[];
+    metadata?: Record<string, unknown>;
+    skipped?: boolean;
+    skipReason?: string;
+}
+export interface HealthReportSummary {
+    totalErrors: number;
+    totalWarnings: number;
+    healthyDimensions: number;
+    warningDimensions: number;
+    errorDimensions: number;
+    skippedDimensions: number;
+}
+export interface HealthReport {
+    timestamp: string;
+    workspaceRoot: string;
+    environmentName?: string;
+    workspaceId?: string;
+    overallStatus: Exclude<HealthStatus, 'skipped'>;
+    dimensions: HealthCheckResult[];
+    errors: string[];
+    warnings: string[];
+    summary: HealthReportSummary;
+}
+export interface AuditTrail {
+    timestamp: string;
+    workspaceRoot: string;
+    environmentName?: string;
+    workspaceId?: string;
+    overallStatus: Exclude<HealthStatus, 'skipped'>;
+    dimensions: Array<{
+        dimensionName: string;
+        status: HealthStatus;
+        skipped: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+    summary: HealthReportSummary;
+}
+export interface HealthCheckProvider {
+    readonly dimensionName: string;
+    check(context: HealthCheckContext): Promise<HealthCheckResult>;
+}
+export interface WorkspaceHealthServiceOptions {
+    now?: () => Date;
+}
+interface ManifestValidatorProviderDeps {
+    loadWorkspaceManifest: typeof loadWorkspaceManifest;
+    validateWorkspaceManifest: typeof validateWorkspaceManifest;
+}
+interface PackageDriftDetectorProviderDeps {
+    loadWorkspaceManifest: typeof loadWorkspaceManifest;
+    resolveRegistryRoot: typeof resolveRegistryRoot;
+    validateRegistryInstall: typeof validateRegistryInstall;
+    apiClientFactory: () => Pick<ApiClient, 'listInstalledMetadataPackages'>;
+}
+interface SourceDriftDetectorProviderDeps {
+    calculateSourceStatus: typeof calculateSourceStatus;
+    apiClientFactory: () => Pick<ApiClient, 'getSourceStatus'>;
+}
+interface EnvironmentStackAnalyzerProviderDeps {
+    loadEnvironmentDescriptor: typeof loadEnvironmentDescriptor;
+}
+export interface SourceHealthCounts {
+    synced: number;
+    'local-new': number;
+    'local-changed': number;
+    'local-delete': number;
+    'remote-new': number;
+    'remote-changed': number;
+    'remote-delete': number;
+    conflict: number;
+    drifted: number;
+    'baseline-missing': number;
+}
+export interface HealthFormatterColors {
+    healthy: (value: string) => string;
+    warning: (value: string) => string;
+    error: (value: string) => string;
+    skipped: (value: string) => string;
+}
+export interface FormatHealthReportOptions {
+    verbose?: boolean;
+    colors?: HealthFormatterColors;
+}
+export declare class WorkspaceHealthService {
+    private readonly providers;
+    private readonly now;
+    constructor(options?: WorkspaceHealthServiceOptions);
+    registerProvider(provider: HealthCheckProvider): void;
+    getProviders(): HealthCheckProvider[];
+    checkHealth(context: HealthCheckContext): Promise<HealthReport>;
+    aggregateResults(context: HealthCheckContext, dimensionResults: HealthCheckResult[]): HealthReport;
+    createAuditTrail(report: HealthReport): AuditTrail;
+}
+export declare function computeOverallHealthStatus(dimensionResults: Pick<HealthCheckResult, 'status'>[]): Exclude<HealthStatus, 'skipped'>;
+export declare class ManifestValidatorProvider implements HealthCheckProvider {
+    readonly dimensionName = "manifest";
+    private readonly deps;
+    constructor(deps?: Partial<ManifestValidatorProviderDeps>);
+    check(context: HealthCheckContext): Promise<HealthCheckResult>;
+}
+export declare class PackageDriftDetectorProvider implements HealthCheckProvider {
+    readonly dimensionName = "package-drift";
+    private readonly deps;
+    constructor(deps?: Partial<PackageDriftDetectorProviderDeps>);
+    check(context: HealthCheckContext): Promise<HealthCheckResult>;
+}
+export declare class SourceDriftDetectorProvider implements HealthCheckProvider {
+    readonly dimensionName = "source-drift";
+    private readonly deps;
+    constructor(deps?: Partial<SourceDriftDetectorProviderDeps>);
+    check(context: HealthCheckContext): Promise<HealthCheckResult>;
+}
+export declare class EnvironmentStackAnalyzerProvider implements HealthCheckProvider {
+    readonly dimensionName = "environment-stack";
+    private readonly deps;
+    constructor(deps?: Partial<EnvironmentStackAnalyzerProviderDeps>);
+    check(context: HealthCheckContext): Promise<HealthCheckResult>;
+}
+export declare function createWorkspaceHealthService(options?: WorkspaceHealthServiceOptions): WorkspaceHealthService;
+export declare function formatHealthReportAsJson(report: HealthReport): string;
+export declare function formatHealthReport(report: HealthReport, options?: FormatHealthReportOptions): string;
+export declare function persistAuditTrail(auditTrail: AuditTrail, workspaceRoot: string): string;
+export {};