@nexusclawhq/cli 0.2.1

package/dist/nexus-cli/src/services/revision-ledger/types.d.ts

@@ -0,0 +1,178 @@
+export type OperationType = 'source-push' | 'source-pull' | 'package-install' | 'package-upgrade' | 'package-rollback' | 'rollback';
+export type ComponentType = 'source-file' | 'package' | 'configuration';
+export interface ComponentChange {
+    componentKey: string;
+    componentType: ComponentType;
+    oldHash: string | null;
+    newHash: string | null;
+    contentDiffSummary?: string;
+}
+export interface SourceComponentState {
+    path: string;
+    componentKey: string;
+    track: 'metadata-runtime' | 'code-extension';
+    localHash: string;
+    remoteHash: string;
+    lastSyncedHash: string;
+    baselineHash: string | null;
+    content?: string | null;
+}
+export interface PackageComponentState {
+    packageName: string;
+    componentKey: string;
+    version: string | null;
+    manifest?: Record<string, unknown>;
+    packageDirectory?: string;
+    sourceUri?: string;
+    installSource?: string;
+    workspaceId?: string;
+    targetStateId?: string | null;
+}
+export interface OperationMetadata {
+    userId?: string;
+    targetOrg?: string;
+    force?: boolean;
+    dryRun?: boolean;
+    affectedPaths?: string[];
+    packageName?: string;
+    packageVersion?: string | null;
+    oldPackageVersion?: string | null;
+    rollbackTargetRevision?: string;
+    beforeRevision?: string;
+    afterRevision?: string;
+    workspaceId?: string;
+    installSource?: string;
+    sourceUri?: string;
+    packageDirectory?: string;
+    packageManifest?: Record<string, unknown>;
+    resultStatus?: string;
+    requestedPackage?: string;
+    affectedPackages?: string[];
+    baselineSource?: string | null;
+    sourceStates?: SourceComponentState[];
+    packageStates?: PackageComponentState[];
+    summary?: string[];
+    notes?: string[];
+    coreVersion?: string | null;
+    coreSha?: string | null;
+    deploymentHistoryId?: string;
+    componentIds?: string[];
+    rollbackResultId?: string;
+    rollbackResult?: string;
+    errorMessage?: string | null;
+}
+export interface RevisionEntry {
+    revisionId: string;
+    timestamp: string;
+    environment: string;
+    operationType: OperationType;
+    componentChanges: ComponentChange[];
+    metadata: OperationMetadata;
+}
+export interface BaselineRecord {
+    environment: string;
+    revisionId: string;
+    setAt: string;
+    setBy?: string;
+}
+export interface SourceTrackingLastSync {
+    remoteRevision?: string;
+    baselineRevision?: string | null;
+    syncedAt?: string;
+}
+export interface EnvironmentState {
+    sources: Record<string, SourceComponentState>;
+    packages: Record<string, PackageComponentState>;
+    sourceTracking?: SourceTrackingLastSync;
+}
+export interface PageBaselineEntry {
+    apiName: string;
+    remoteUpdatedAt: string;
+    localHash: string;
+    sidecarHash: string;
+}
+export interface SourceBaselines {
+    pages: PageBaselineEntry[];
+}
+export interface RevisionLedgerData {
+    schemaVersion: number;
+    workspaceRoot: string;
+    revisions: RevisionEntry[];
+    baselines: Record<string, BaselineRecord>;
+    environments: Record<string, EnvironmentState>;
+    sourceBaselines?: SourceBaselines;
+}
+export interface RevisionQueryFilter {
+    environment?: string;
+    operationType?: OperationType;
+    componentKey?: string;
+    startDate?: string;
+    endDate?: string;
+    packageName?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface DriftedComponent {
+    componentKey: string;
+    componentType: ComponentType;
+    currentHash: string;
+    baselineHash: string;
+}
+export interface DriftResult {
+    status: 'baseline-missing' | 'in-sync' | 'drifted';
+    totalChanges: number;
+    changesByType: Record<ComponentType, number>;
+    driftedComponents: DriftedComponent[];
+    humanSummary: string[];
+}
+export interface RevisionDiffEntry {
+    componentKey: string;
+    componentType: ComponentType;
+    revisionAHash: string | null;
+    revisionBHash: string | null;
+}
+export interface RevisionDiffResult {
+    revisionA: RevisionEntry;
+    revisionB: RevisionEntry;
+    changedComponents: RevisionDiffEntry[];
+}
+export interface RevisionLedgerError extends Error {
+    code: string;
+    details?: Record<string, unknown>;
+    originalError?: Error;
+}
+export interface LegacyTrackingFileEntry {
+    componentKey?: string;
+    track?: 'metadata-runtime' | 'code-extension';
+    localHash: string;
+    remoteHash: string;
+    lastPushedHash?: string;
+    lastSyncedHash?: string;
+    baselineHash?: string | null;
+}
+export interface LegacyTrackingData {
+    schemaVersion?: number;
+    workspaceRoot?: string;
+    lastSync?: SourceTrackingLastSync;
+    files?: Record<string, LegacyTrackingFileEntry>;
+}
+export interface MigrationResult {
+    success: boolean;
+    migratedEntries: number;
+    backupPath?: string;
+    error?: string;
+}
+export interface SourceTrackingProjectionEntry {
+    componentKey: string;
+    track: 'metadata-runtime' | 'code-extension';
+    localHash: string;
+    remoteHash: string;
+    lastSyncedHash: string;
+    baselineHash?: string | null;
+}
+export interface SourceTrackingProjection {
+    schemaVersion: number;
+    workspaceRoot: string;
+    lastSync?: SourceTrackingLastSync;
+    files: Record<string, SourceTrackingProjectionEntry>;
+}

package/dist/nexus-cli/src/services/revision-ledger/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/nexus-cli/src/services/revision-ledger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/services/revision-ledger/types.ts"],"names":[],"mappings":""}

package/dist/nexus-cli/src/services/revision-ledger/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveRevisionEnvironment(environment?: string): string;
+export declare function nowIso(now?: Date): string;
+export declare function cloneValue<T>(value: T): T;
+export declare function generateRevisionId(now?: Date): string;
+export declare function describePackageDelta(oldVersion: string | null, newVersion: string | null): string;

package/dist/nexus-cli/src/services/revision-ledger/utils.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRevisionEnvironment = resolveRevisionEnvironment;
+exports.nowIso = nowIso;
+exports.cloneValue = cloneValue;
+exports.generateRevisionId = generateRevisionId;
+exports.describePackageDelta = describePackageDelta;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const DEFAULT_ENVIRONMENT = 'dev';
+const UUID_EPOCH_MASK = BigInt('0xffffffffffff');
+let lastTimestamp = 0;
+let sequence = 0;
+function resolveRevisionEnvironment(environment) {
+    const candidate = environment ?? process.env.NEXUS_ENVIRONMENT ?? DEFAULT_ENVIRONMENT;
+    return candidate.trim() || DEFAULT_ENVIRONMENT;
+}
+function nowIso(now = new Date()) {
+    return now.toISOString();
+}
+function cloneValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function generateRevisionId(now = new Date()) {
+    const millis = now.getTime();
+    if (millis === lastTimestamp) {
+        sequence = (sequence + 1) & 0x0fff;
+    }
+    else {
+        lastTimestamp = millis;
+        sequence = node_crypto_1.default.randomInt(0, 0x1000);
+    }
+    const timestamp = BigInt(millis) & UUID_EPOCH_MASK;
+    const random = node_crypto_1.default.randomBytes(8);
+    const randA = ((sequence & 0x0fff) | 0x7000).toString(16).padStart(4, '0');
+    const variant = (((random[0] & 0x3f) | 0x80).toString(16).padStart(2, '0')) + random.subarray(1, 2).toString('hex');
+    const randB = random.subarray(2, 8).toString('hex');
+    const timeHex = timestamp.toString(16).padStart(12, '0');
+    return [
+        timeHex.slice(0, 8),
+        timeHex.slice(8, 12),
+        randA,
+        variant,
+        randB,
+    ].join('-');
+}
+function describePackageDelta(oldVersion, newVersion) {
+    if (!oldVersion && newVersion) {
+        return `installed ${newVersion}`;
+    }
+    if (oldVersion && !newVersion) {
+        return `removed ${oldVersion}`;
+    }
+    if (oldVersion && newVersion && oldVersion !== newVersion) {
+        return `${oldVersion} -> ${newVersion}`;
+    }
+    return newVersion ?? oldVersion ?? 'no change';
+}
+//# sourceMappingURL=utils.js.map

package/dist/nexus-cli/src/services/revision-ledger/utils.js.map

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

package/dist/nexus-cli/src/services/source-tracker.d.ts

@@ -0,0 +1,71 @@
+import { type SourceStatusFileRecord, type SourceStatusResult } from './api-client';
+export interface SourceTrackingEntry {
+    componentKey: string;
+    track: 'metadata-runtime' | 'code-extension';
+    localHash: string;
+    remoteHash: string;
+    lastSyncedHash: string;
+    baselineHash?: string | null;
+}
+export interface SourceTrackingData {
+    schemaVersion: number;
+    workspaceRoot: string;
+    lastSync?: {
+        remoteRevision?: string;
+        baselineRevision?: string | null;
+        syncedAt?: string;
+    };
+    files: Record<string, SourceTrackingEntry>;
+}
+export interface LocalSourceEntry {
+    path: string;
+    absolutePath: string;
+    content: string;
+    hash: string;
+    componentKey: string;
+    track: 'metadata-runtime' | 'code-extension';
+}
+export type SourceSyncStatus = 'synced' | 'local-new' | 'local-changed' | 'local-delete' | 'remote-new' | 'remote-changed' | 'remote-delete' | 'conflict';
+export type DriftStatus = 'baseline-missing' | 'in-sync' | 'drifted';
+export interface SourceStatusEntry {
+    path: string;
+    componentKey: string;
+    syncStatus: SourceSyncStatus;
+    driftStatus: DriftStatus;
+    localHash: string;
+    remoteHash: string;
+    lastSyncedHash: string;
+    baselineHash: string | null;
+}
+export declare function normalizeSourceSelectionPath(candidate: string): string;
+export declare function getTrackingFilePath(baseDir?: string): string;
+export declare function resolveTrackedFilePath(baseDir: string, trackedPath: string): string;
+export declare function deriveComponentKey(trackedPath: string): string;
+export declare function loadTrackingData(baseDir?: string): SourceTrackingData;
+export declare function saveTrackingData(baseDir: string, data: SourceTrackingData): void;
+export declare function collectLocalSourceFiles(baseDir?: string): string[];
+export declare function collectLocalSourceEntries(baseDir?: string): LocalSourceEntry[];
+export declare function readSourceFiles(baseDir?: string): Array<{
+    path: string;
+    content: string;
+}>;
+export declare function calculateSourceStatus(input: {
+    baseDir?: string;
+    remoteFiles?: SourceStatusFileRecord[];
+    baselineFiles?: SourceStatusFileRecord[];
+}): SourceStatusEntry[];
+export declare function writeTrackedSourceFile(baseDir: string, trackedPath: string, content: string): void;
+export declare function deleteTrackedSourceFile(baseDir: string, trackedPath: string): void;
+export declare function syncTrackingWithStatus(input: {
+    baseDir?: string;
+    status: SourceStatusResult;
+    targetPaths: string[];
+    syncedAt?: string;
+}): void;
+export declare function filterByMetadataSelector(statuses: SourceStatusEntry[], selectors: string[]): SourceStatusEntry[];
+export declare function filterByDirectory(statuses: SourceStatusEntry[], dirs: string[]): SourceStatusEntry[];
+export declare function refreshTrackingWithRemoteStatus(input: {
+    baseDir?: string;
+    status: SourceStatusResult;
+    targetPaths?: string[];
+}): void;