@nexusclawhq/cli 0.2.1

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

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaselineService = void 0;
+const state_helpers_1 = require("./state-helpers");
+const utils_1 = require("./utils");
+class BaselineService {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async setBaseline(environment, revisionId, setBy) {
+        return this.storage.update((data) => {
+            let targetRevisionId = revisionId;
+            if (!targetRevisionId) {
+                const latest = (0, state_helpers_1.queryRevisionsFromData)(data, {
+                    environment,
+                    limit: 1,
+                })[0];
+                if (latest) {
+                    targetRevisionId = latest.revisionId;
+                }
+                else {
+                    const current = (0, state_helpers_1.ensureEnvironmentState)(data, environment);
+                    const sourceStates = Object.values(current.sources);
+                    const packageStates = Object.values(current.packages);
+                    if (sourceStates.length === 0 && packageStates.length === 0) {
+                        throw (0, state_helpers_1.createRevisionLedgerError)('BASELINE_NOT_FOUND', `Cannot set baseline for ${environment}; no current state or historical revisions exist.`, { environment });
+                    }
+                    const snapshotRevision = {
+                        revisionId: (0, utils_1.generateRevisionId)(),
+                        timestamp: (0, utils_1.nowIso)(),
+                        environment,
+                        operationType: sourceStates.length > 0 ? 'source-pull' : 'package-install',
+                        componentChanges: (0, state_helpers_1.createSnapshotComponentChanges)(sourceStates, packageStates),
+                        metadata: {
+                            sourceStates,
+                            packageStates,
+                            notes: ['baseline current-state snapshot'],
+                        },
+                    };
+                    data.revisions.push(snapshotRevision);
+                    targetRevisionId = snapshotRevision.revisionId;
+                }
+            }
+            const exists = data.revisions.some((entry) => entry.environment === environment && entry.revisionId === targetRevisionId);
+            if (!exists) {
+                throw (0, state_helpers_1.createRevisionLedgerError)('REVISION_NOT_FOUND', `Revision ${targetRevisionId} was not found in environment ${environment}.`, { environment, revisionId: targetRevisionId });
+            }
+            const baselineRecord = {
+                environment,
+                revisionId: targetRevisionId,
+                setAt: (0, utils_1.nowIso)(),
+                setBy,
+            };
+            data.baselines[environment] = baselineRecord;
+            (0, state_helpers_1.updateBaselineHashes)(data, environment, baselineRecord);
+            return baselineRecord;
+        });
+    }
+    async getBaseline(environment) {
+        const data = this.storage.read();
+        return data.baselines[environment] ?? null;
+    }
+}
+exports.BaselineService = BaselineService;
+//# sourceMappingURL=baseline-service.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { LedgerStorage } from './ledger-storage';
+import { type DriftResult } from './types';
+export declare class DriftCalculator {
+    private readonly storage;
+    constructor(storage: LedgerStorage);
+    calculateDrift(environment: string): Promise<DriftResult>;
+}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriftCalculator = void 0;
+const state_helpers_1 = require("./state-helpers");
+class DriftCalculator {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async calculateDrift(environment) {
+        return (0, state_helpers_1.calculateDriftFromData)(this.storage.read(), environment);
+    }
+}
+exports.DriftCalculator = DriftCalculator;
+//# sourceMappingURL=drift-calculator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drift-calculator.js","sourceRoot":"","sources":["../../../../../src/services/revision-ledger/drift-calculator.ts"],"names":[],"mappings":";;;AACA,mDAAyD;AAGzD,MAAa,eAAe;IAC1B,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAEvD,KAAK,CAAC,cAAc,CAAC,WAAmB;QACtC,OAAO,IAAA,sCAAsB,EAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;IAClE,CAAC;CACF;AAND,0CAMC"}

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

@@ -0,0 +1,13 @@
+export * from './types';
+export * from './utils';
+export * from './state-helpers';
+export * from './ledger-storage';
+export * from './revision-service';
+export * from './migration-service';
+export * from './query-api';
+export * from './baseline-service';
+export * from './drift-calculator';
+export * from './rollback-service';
+export * from './source-tracking-bridge';
+export * from './initialize';
+export * from './page-source-baseline-store';

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

@@ -0,0 +1,30 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);
+__exportStar(require("./state-helpers"), exports);
+__exportStar(require("./ledger-storage"), exports);
+__exportStar(require("./revision-service"), exports);
+__exportStar(require("./migration-service"), exports);
+__exportStar(require("./query-api"), exports);
+__exportStar(require("./baseline-service"), exports);
+__exportStar(require("./drift-calculator"), exports);
+__exportStar(require("./rollback-service"), exports);
+__exportStar(require("./source-tracking-bridge"), exports);
+__exportStar(require("./initialize"), exports);
+__exportStar(require("./page-source-baseline-store"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/services/revision-ledger/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,0CAAwB;AACxB,kDAAgC;AAChC,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,8CAA4B;AAC5B,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,2DAAyC;AACzC,+CAA6B;AAC7B,+DAA6C"}

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

@@ -0,0 +1 @@
+export declare function ensureRevisionLedgerInitialized(baseDir?: string, environment?: string): Promise<void>;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureRevisionLedgerInitialized = ensureRevisionLedgerInitialized;
+const ledger_storage_1 = require("./ledger-storage");
+const migration_service_1 = require("./migration-service");
+const state_helpers_1 = require("./state-helpers");
+async function ensureRevisionLedgerInitialized(baseDir = '.', environment = 'dev') {
+    const storage = new ledger_storage_1.LedgerStorage(baseDir);
+    if (storage.exists()) {
+        storage.read();
+        return;
+    }
+    const migrationService = new migration_service_1.MigrationService(storage);
+    if (migrationService.detectLegacyTracking(baseDir)) {
+        const result = await migrationService.migrateToLedger(baseDir, environment);
+        if (!result.success) {
+            throw new Error(result.error ?? 'Revision ledger migration failed.');
+        }
+        return;
+    }
+    await storage.write((0, state_helpers_1.createEmptyLedgerData)('.'));
+}
+//# sourceMappingURL=initialize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.js","sourceRoot":"","sources":["../../../../../src/services/revision-ledger/initialize.ts"],"names":[],"mappings":";;AAIA,0EAoBC;AAxBD,qDAAiD;AACjD,2DAAuD;AACvD,mDAAwD;AAEjD,KAAK,UAAU,+BAA+B,CACnD,OAAO,GAAG,GAAG,EACb,WAAW,GAAG,KAAK;IAEnB,MAAM,OAAO,GAAG,IAAI,8BAAa,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,oCAAgB,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,gBAAgB,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,mCAAmC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,KAAK,CAAC,IAAA,qCAAqB,EAAC,GAAG,CAAC,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,14 @@
+import { type RevisionLedgerData } from './types';
+export declare const REVISION_LEDGER_FILE = ".nexus-revision-ledger.json";
+export declare class LedgerStorage {
+    private readonly baseDir;
+    readonly filePath: string;
+    constructor(baseDir?: string);
+    exists(): boolean;
+    read(): RevisionLedgerData;
+    write(data: RevisionLedgerData): Promise<void>;
+    update<T>(mutator: (current: RevisionLedgerData) => T | Promise<T>): Promise<T>;
+    writeSync(data: RevisionLedgerData): void;
+    updateSync<T>(mutator: (current: RevisionLedgerData) => T): T;
+    private enqueueWrite;
+}

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

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerStorage = exports.REVISION_LEDGER_FILE = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const state_helpers_1 = require("./state-helpers");
+exports.REVISION_LEDGER_FILE = '.nexus-revision-ledger.json';
+const writeQueues = new Map();
+class LedgerStorage {
+    constructor(baseDir = '.') {
+        this.baseDir = baseDir;
+        this.filePath = node_path_1.default.join(node_path_1.default.resolve(baseDir), exports.REVISION_LEDGER_FILE);
+    }
+    exists() {
+        return node_fs_1.default.existsSync(this.filePath);
+    }
+    read() {
+        if (!this.exists()) {
+            return (0, state_helpers_1.createEmptyLedgerData)('.');
+        }
+        try {
+            const parsed = JSON.parse(node_fs_1.default.readFileSync(this.filePath, 'utf-8'));
+            (0, state_helpers_1.assertSchemaVersion)(parsed);
+            parsed.revisions ??= [];
+            parsed.baselines ??= {};
+            parsed.environments ??= {};
+            parsed.sourceBaselines ??= { pages: [] };
+            return parsed;
+        }
+        catch (error) {
+            throw (0, state_helpers_1.createRevisionLedgerError)('LEDGER_READ_FAILED', `Failed to read revision ledger at ${this.filePath}.`, { filePath: this.filePath }, error instanceof Error ? error : undefined);
+        }
+    }
+    write(data) {
+        (0, state_helpers_1.assertSchemaVersion)(data);
+        return this.enqueueWrite(async () => {
+            this.writeSync(data);
+        });
+    }
+    async update(mutator) {
+        let result;
+        await this.enqueueWrite(async () => {
+            const current = this.read();
+            result = await mutator(current);
+            this.writeSync(current);
+        });
+        return result;
+    }
+    writeSync(data) {
+        (0, state_helpers_1.assertSchemaVersion)(data);
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(this.filePath), { recursive: true });
+        const tempPath = `${this.filePath}.${process.pid}.${Date.now()}.tmp`;
+        const ordered = {
+            schemaVersion: data.schemaVersion,
+            workspaceRoot: data.workspaceRoot,
+            revisions: data.revisions,
+            baselines: data.baselines,
+            environments: data.environments,
+            sourceBaselines: data.sourceBaselines ?? { pages: [] },
+        };
+        node_fs_1.default.writeFileSync(tempPath, `${JSON.stringify(ordered, null, 2)}\n`, 'utf-8');
+        node_fs_1.default.renameSync(tempPath, this.filePath);
+    }
+    updateSync(mutator) {
+        const current = this.read();
+        const result = mutator(current);
+        this.writeSync(current);
+        return result;
+    }
+    enqueueWrite(operation) {
+        const previous = writeQueues.get(this.filePath) ?? Promise.resolve();
+        let resolveQueue;
+        const next = new Promise((resolve) => {
+            resolveQueue = resolve;
+        });
+        writeQueues.set(this.filePath, previous.then(() => next));
+        return previous
+            .then(() => operation())
+            .finally(() => {
+            resolveQueue?.();
+            if (writeQueues.get(this.filePath) === next) {
+                writeQueues.delete(this.filePath);
+            }
+        });
+    }
+}
+exports.LedgerStorage = LedgerStorage;
+//# sourceMappingURL=ledger-storage.js.map

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

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

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

@@ -0,0 +1,8 @@
+import { LedgerStorage } from './ledger-storage';
+import { type MigrationResult } from './types';
+export declare class MigrationService {
+    private readonly storage;
+    constructor(storage: LedgerStorage);
+    detectLegacyTracking(baseDir?: string): boolean;
+    migrateToLedger(baseDir: string | undefined, environment: string): Promise<MigrationResult>;
+}

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

@@ -0,0 +1,115 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MigrationService = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const source_tracker_1 = require("../source-tracker");
+const state_helpers_1 = require("./state-helpers");
+const utils_1 = require("./utils");
+const LEGACY_TRACKING_FILE = '.nexus-source-tracking.json';
+function inferTrackFromPath(filePath) {
+    return filePath.replace(/\\/g, '/').startsWith('src/')
+        ? 'code-extension'
+        : 'metadata-runtime';
+}
+class MigrationService {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    detectLegacyTracking(baseDir = '.') {
+        return node_fs_1.default.existsSync(node_path_1.default.join(node_path_1.default.resolve(baseDir), LEGACY_TRACKING_FILE));
+    }
+    async migrateToLedger(baseDir = '.', environment) {
+        const legacyPath = node_path_1.default.join(node_path_1.default.resolve(baseDir), LEGACY_TRACKING_FILE);
+        if (!node_fs_1.default.existsSync(legacyPath)) {
+            return {
+                success: true,
+                migratedEntries: 0,
+            };
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(node_fs_1.default.readFileSync(legacyPath, 'utf-8'));
+        }
+        catch (error) {
+            return {
+                success: false,
+                migratedEntries: 0,
+                error: `Failed to parse legacy tracking file: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        if (parsed.schemaVersion !== undefined && parsed.schemaVersion !== 2) {
+            return {
+                success: false,
+                migratedEntries: 0,
+                error: `Legacy tracking schema version ${parsed.schemaVersion} is not supported; expected version 2.`,
+            };
+        }
+        const sourceStates = Object.entries(parsed.files ?? {}).map(([trackedPath, entry]) => ({
+            path: trackedPath,
+            componentKey: entry.componentKey ?? (0, source_tracker_1.deriveComponentKey)(trackedPath),
+            track: entry.track ?? inferTrackFromPath(trackedPath),
+            localHash: entry.localHash,
+            remoteHash: entry.remoteHash,
+            lastSyncedHash: entry.lastSyncedHash ?? entry.lastPushedHash ?? '',
+            baselineHash: entry.baselineHash ?? null,
+        }));
+        const revision = {
+            revisionId: (0, utils_1.generateRevisionId)(),
+            timestamp: parsed.lastSync?.syncedAt ?? (0, utils_1.nowIso)(),
+            environment,
+            operationType: 'source-pull',
+            componentChanges: sourceStates.map((state) => ({
+                componentKey: state.componentKey,
+                componentType: 'source-file',
+                oldHash: null,
+                newHash: state.lastSyncedHash || null,
+                contentDiffSummary: state.path,
+            })),
+            metadata: {
+                sourceStates,
+                beforeRevision: parsed.lastSync?.baselineRevision ?? undefined,
+                afterRevision: parsed.lastSync?.remoteRevision,
+                notes: ['migrated from legacy source tracking file'],
+            },
+        };
+        try {
+            (0, state_helpers_1.validateRevisionEntry)(revision, new Set());
+            const backupPath = `${legacyPath}.backup`;
+            node_fs_1.default.copyFileSync(legacyPath, backupPath);
+            const data = (0, state_helpers_1.createEmptyLedgerData)('.');
+            data.revisions.push(revision);
+            const envState = (0, state_helpers_1.ensureEnvironmentState)(data, environment);
+            envState.sourceTracking = parsed.lastSync;
+            for (const sourceState of sourceStates) {
+                envState.sources[sourceState.path] = sourceState;
+            }
+            if (parsed.lastSync?.baselineRevision) {
+                data.baselines[environment] = {
+                    environment,
+                    revisionId: revision.revisionId,
+                    setAt: parsed.lastSync.syncedAt ?? revision.timestamp,
+                };
+                (0, state_helpers_1.updateBaselineHashes)(data, environment, data.baselines[environment]);
+            }
+            await this.storage.write(data);
+            return {
+                success: true,
+                migratedEntries: sourceStates.length,
+                backupPath,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                migratedEntries: 0,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+exports.MigrationService = MigrationService;
+//# sourceMappingURL=migration-service.js.map

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

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

package/dist/nexus-cli/src/services/revision-ledger/page-source-baseline-store.d.ts

@@ -0,0 +1,10 @@
+import { type LedgerStorage } from './ledger-storage';
+import { type PageBaselineEntry } from './types';
+export declare class PageSourceBaselineStore {
+    private readonly storage;
+    constructor(storage: LedgerStorage);
+    list(): PageBaselineEntry[];
+    getByApiName(apiName: string): PageBaselineEntry | undefined;
+    upsert(entry: PageBaselineEntry): void;
+    remove(apiName: string): void;
+}

package/dist/nexus-cli/src/services/revision-ledger/page-source-baseline-store.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageSourceBaselineStore = void 0;
+class PageSourceBaselineStore {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    list() {
+        const data = this.storage.read();
+        return [...(data.sourceBaselines?.pages ?? [])];
+    }
+    getByApiName(apiName) {
+        const data = this.storage.read();
+        return (data.sourceBaselines?.pages ?? []).find((entry) => entry.apiName === apiName);
+    }
+    upsert(entry) {
+        this.storage.updateSync((data) => {
+            data.sourceBaselines ??= { pages: [] };
+            const index = data.sourceBaselines.pages.findIndex((existing) => existing.apiName === entry.apiName);
+            if (index >= 0) {
+                data.sourceBaselines.pages[index] = { ...entry };
+            }
+            else {
+                data.sourceBaselines.pages.push({ ...entry });
+            }
+        });
+    }
+    remove(apiName) {
+        this.storage.updateSync((data) => {
+            data.sourceBaselines ??= { pages: [] };
+            data.sourceBaselines.pages = data.sourceBaselines.pages.filter((entry) => entry.apiName !== apiName);
+        });
+    }
+}
+exports.PageSourceBaselineStore = PageSourceBaselineStore;
+//# sourceMappingURL=page-source-baseline-store.js.map

package/dist/nexus-cli/src/services/revision-ledger/page-source-baseline-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-source-baseline-store.js","sourceRoot":"","sources":["../../../../../src/services/revision-ledger/page-source-baseline-store.ts"],"names":[],"mappings":";;;AAQA,MAAa,uBAAuB;IAClC,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAEvD,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CACrC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAwB;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/B,IAAI,CAAC,eAAe,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,CAChD,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CACjD,CAAC;YACF,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/B,IAAI,CAAC,eAAe,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAC5D,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CACrC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AArCD,0DAqCC"}

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

@@ -0,0 +1,4 @@
+import { type RevisionLedgerData, type RevisionEntry, type RevisionQueryFilter } from './types';
+export declare class RevisionQueryApi {
+    queryRevisions(data: RevisionLedgerData, filter: RevisionQueryFilter): RevisionEntry[];
+}

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RevisionQueryApi = void 0;
+const state_helpers_1 = require("./state-helpers");
+class RevisionQueryApi {
+    queryRevisions(data, filter) {
+        return (0, state_helpers_1.queryRevisionsFromData)(data, filter);
+    }
+}
+exports.RevisionQueryApi = RevisionQueryApi;
+//# sourceMappingURL=query-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-api.js","sourceRoot":"","sources":["../../../../../src/services/revision-ledger/query-api.ts"],"names":[],"mappings":";;;AACA,mDAAyD;AAEzD,MAAa,gBAAgB;IAC3B,cAAc,CAAC,IAAwB,EAAE,MAA2B;QAClE,OAAO,IAAA,sCAAsB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;CACF;AAJD,4CAIC"}

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

@@ -0,0 +1 @@
+export {};