@solidnumber/cli 1.6.5 → 1.7.0

package/dist/__tests__/commands/deploy.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deploy (preview) command tests
+ *
+ * Tests preview creation, listing, promotion to live,
+ * expiration, and the shareable URL contract.
+ */
+export {};
+//# sourceMappingURL=deploy.test.d.ts.map

package/dist/__tests__/commands/deploy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/commands/deploy.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/commands/deploy.test.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Deploy (preview) command tests
+ *
+ * Tests preview creation, listing, promotion to live,
+ * expiration, and the shareable URL contract.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_client_1 = require("../../lib/api-client");
+jest.mock('../../lib/api-client', () => ({
+    apiClient: {
+        previewCreate: jest.fn(),
+        previewList: jest.fn(),
+        previewGet: jest.fn(),
+        previewPromote: jest.fn(),
+        previewExpire: jest.fn(),
+    },
+    handleApiError: jest.fn((e) => ({ message: e?.message || 'Error', status: 500 })),
+}));
+const mockApi = api_client_1.apiClient;
+describe('deploy commands', () => {
+    beforeEach(() => jest.clearAllMocks());
+    // ── Preview Create ────────────────────────────────────────────────
+    describe('deploy create', () => {
+        it('creates a preview deployment with shareable URL', async () => {
+            mockApi.previewCreate.mockResolvedValue({
+                data: {
+                    success: true,
+                    preview: {
+                        preview_token: 'abc123def456',
+                        page_count: 5,
+                        kb_count: 12,
+                        status: 'active',
+                        expires_at: '2026-04-01T00:00:00Z',
+                    },
+                    preview_url: 'https://app.solidnumber.com/preview/abc123def456',
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.previewCreate({ title: 'Spring Redesign', ttl_hours: 48 });
+            expect(mockApi.previewCreate).toHaveBeenCalledWith({ title: 'Spring Redesign', ttl_hours: 48 });
+            expect(result.data.preview_url).toContain('preview/');
+            expect(result.data.preview.page_count).toBe(5);
+            expect(result.data.preview.status).toBe('active');
+        });
+        it('supports pages-only preview', async () => {
+            mockApi.previewCreate.mockResolvedValue({
+                data: { success: true, preview: { page_count: 3, kb_count: 0 }, preview_url: 'https://app.solidnumber.com/preview/xyz' },
+                status: 200,
+                success: true,
+            });
+            await mockApi.previewCreate({ pages_only: true });
+            expect(mockApi.previewCreate).toHaveBeenCalledWith({ pages_only: true });
+        });
+        it('supports kb-only preview', async () => {
+            mockApi.previewCreate.mockResolvedValue({
+                data: { success: true, preview: { page_count: 0, kb_count: 8 }, preview_url: 'https://app.solidnumber.com/preview/xyz' },
+                status: 200,
+                success: true,
+            });
+            await mockApi.previewCreate({ kb_only: true });
+            expect(mockApi.previewCreate).toHaveBeenCalledWith({ kb_only: true });
+        });
+        it('supports custom TTL', async () => {
+            mockApi.previewCreate.mockResolvedValue({
+                data: { success: true, preview: { expires_at: '2026-04-28T00:00:00Z' }, preview_url: 'url' },
+                status: 200,
+                success: true,
+            });
+            await mockApi.previewCreate({ ttl_hours: 720 }); // 30 days
+            expect(mockApi.previewCreate).toHaveBeenCalledWith({ ttl_hours: 720 });
+        });
+    });
+    // ── Preview List ──────────────────────────────────────────────────
+    describe('deploy list', () => {
+        it('lists all preview deployments', async () => {
+            mockApi.previewList.mockResolvedValue({
+                data: {
+                    previews: [
+                        { preview_token: 'tok1', status: 'active', title: 'Spring', page_count: 5, created_at: '2026-03-28T00:00:00Z' },
+                        { preview_token: 'tok2', status: 'promoted', title: 'Winter', page_count: 3, created_at: '2026-03-20T00:00:00Z' },
+                        { preview_token: 'tok3', status: 'expired', title: null, page_count: 2, created_at: '2026-03-15T00:00:00Z' },
+                    ],
+                    count: 3,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.previewList(undefined, 20);
+            expect(result.data.previews).toHaveLength(3);
+            expect(result.data.previews[0].status).toBe('active');
+        });
+        it('filters by status', async () => {
+            mockApi.previewList.mockResolvedValue({
+                data: { previews: [{ status: 'active' }], count: 1 },
+                status: 200,
+                success: true,
+            });
+            await mockApi.previewList('active', 20);
+            expect(mockApi.previewList).toHaveBeenCalledWith('active', 20);
+        });
+        it('returns empty when no previews exist', async () => {
+            mockApi.previewList.mockResolvedValue({
+                data: { previews: [], count: 0 },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.previewList(undefined, 20);
+            expect(result.data.previews).toHaveLength(0);
+        });
+    });
+    // ── Preview Get ───────────────────────────────────────────────────
+    describe('deploy get', () => {
+        it('gets full preview details including snapshots', async () => {
+            mockApi.previewGet.mockResolvedValue({
+                data: {
+                    preview_token: 'tok1',
+                    status: 'active',
+                    page_count: 5,
+                    kb_count: 12,
+                    pages_snapshot: [{ slug: 'home', title: 'Home' }],
+                    kb_snapshot: [{ title: 'FAQ', category: 'support' }],
+                    settings_snapshot: { name: 'Acme Corp' },
+                    preview_url: 'https://app.solidnumber.com/preview/tok1',
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.previewGet('tok1');
+            expect(mockApi.previewGet).toHaveBeenCalledWith('tok1');
+            expect(result.data.pages_snapshot).toHaveLength(1);
+            expect(result.data.kb_snapshot).toHaveLength(1);
+        });
+    });
+    // ── Preview Promote ───────────────────────────────────────────────
+    describe('deploy promote', () => {
+        it('promotes a preview to production', async () => {
+            mockApi.previewPromote.mockResolvedValue({
+                data: {
+                    success: true,
+                    message: 'Preview promoted to live: 5 pages, 12 KB entries',
+                    pages_promoted: 5,
+                    kb_promoted: 12,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.previewPromote('tok1');
+            expect(mockApi.previewPromote).toHaveBeenCalledWith('tok1');
+            expect(result.data.pages_promoted).toBe(5);
+            expect(result.data.kb_promoted).toBe(12);
+        });
+        it('rejects promotion of non-active preview', async () => {
+            mockApi.previewPromote.mockRejectedValue({
+                response: { status: 400, data: { detail: 'Preview is expired, not active' } },
+            });
+            await expect(mockApi.previewPromote('expired_tok')).rejects.toBeDefined();
+        });
+    });
+    // ── Preview Expire ────────────────────────────────────────────────
+    describe('deploy expire', () => {
+        it('expires/cancels a preview deployment', async () => {
+            mockApi.previewExpire.mockResolvedValue({
+                data: { success: true, message: 'Preview expired' },
+                status: 200,
+                success: true,
+            });
+            await mockApi.previewExpire('tok1');
+            expect(mockApi.previewExpire).toHaveBeenCalledWith('tok1');
+        });
+    });
+    // ── Security ──────────────────────────────────────────────────────
+    describe('preview security', () => {
+        it('preview token is the only access key for public preview', () => {
+            // The public endpoint /api/v1/preview/{token} requires no auth
+            // Token IS the key — this is by design for shareable links
+            // Security: tokens are 32-byte URL-safe random strings
+            const token = 'abc123def456ghi789jkl012mno345pq';
+            expect(token.length).toBeGreaterThanOrEqual(20);
+        });
+        it('preview operations require auth (except public preview)', () => {
+            // create, list, get (detailed), promote, expire all require JWT
+            // Only the public render endpoint is unauthenticated
+            expect(mockApi.previewCreate).toBeDefined();
+            expect(mockApi.previewPromote).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=deploy.test.js.map

package/dist/__tests__/commands/deploy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.test.js","sourceRoot":"","sources":["../../../src/__tests__/commands/deploy.test.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAEH,qDAAiD;AAEjD,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,SAAS,EAAE;QACT,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;QACxB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;QACtB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;QACrB,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE;QACzB,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;KACzB;IACD,cAAc,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;CACvF,CAAC,CAAC,CAAC;AAEJ,MAAM,OAAO,GAAG,sBAA0C,CAAC;AAE3D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAEvC,qEAAqE;IAErE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YAC/D,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;gBACtC,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP,aAAa,EAAE,cAAc;wBAC7B,UAAU,EAAE,CAAC;wBACb,QAAQ,EAAE,EAAE;wBACZ,MAAM,EAAE,QAAQ;wBAChB,UAAU,EAAE,sBAAsB;qBACnC;oBACD,WAAW,EAAE,kDAAkD;iBAChE;gBACD,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;YACxF,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;YAChG,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAC/D,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;gBACtC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACxH,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;YACxC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;gBACtC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACxH,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACnC,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;gBACtC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,sBAAsB,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;gBAC5F,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU;YAC3D,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qEAAqE;IAErE,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;YAC7C,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC;gBACpC,IAAI,EAAE;oBACJ,QAAQ,EAAE;wBACR,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,sBAAsB,EAAE;wBAC/G,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,sBAAsB,EAAE;wBACjH,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,sBAAsB,EAAE;qBAC7G;oBACD,KAAK,EAAE,CAAC;iBACT;gBACD,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACxD,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;YACjC,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC;gBACpC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;gBACpD,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACxC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC;gBACpC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;gBAChC,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACxD,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qEAAqE;IAErE,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;gBACnC,IAAI,EAAE;oBACJ,aAAa,EAAE,MAAM;oBACrB,MAAM,EAAE,QAAQ;oBAChB,UAAU,EAAE,CAAC;oBACb,QAAQ,EAAE,EAAE;oBACZ,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;oBACjD,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;oBACpD,iBAAiB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;oBACxC,WAAW,EAAE,0CAA0C;iBACxD;gBACD,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC5D,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qEAAqE;IAErE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YAChD,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC;gBACvC,IAAI,EAAE;oBACJ,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,kDAAkD;oBAC3D,cAAc,EAAE,CAAC;oBACjB,WAAW,EAAE,EAAE;iBAChB;gBACD,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YAC5D,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpD,MAAM,CAAE,MAAM,CAAC,IAAY,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC;gBACvC,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,gCAAgC,EAAE,EAAE;aAC9E,CAAC,CAAC;YAEH,MAAM,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qEAAqE;IAErE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC;gBACtC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,EAAE;gBACnD,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qEAAqE;IAErE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,+DAA+D;YAC/D,2DAA2D;YAC3D,uDAAuD;YACvD,MAAM,KAAK,GAAG,kCAAkC,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,gEAAgE;YAChE,qDAAqD;YACrD,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/commands/history.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * History + Rollback command tests
+ *
+ * Tests version history listing, page version retrieval,
+ * rollback execution, and KB version history.
+ */
+export {};
+//# sourceMappingURL=history.test.d.ts.map

package/dist/__tests__/commands/history.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/commands/history.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/commands/history.test.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * History + Rollback command tests
+ *
+ * Tests version history listing, page version retrieval,
+ * rollback execution, and KB version history.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_client_1 = require("../../lib/api-client");
+jest.mock('../../lib/api-client', () => ({
+    apiClient: {
+        historyPages: jest.fn(),
+        historyKB: jest.fn(),
+        historyPageVersion: jest.fn(),
+        rollbackPage: jest.fn(),
+        rollbackKB: jest.fn(),
+        createSnapshot: jest.fn(),
+    },
+    handleApiError: jest.fn((e) => ({ message: e?.message || 'Error', status: 500 })),
+}));
+const mockApi = api_client_1.apiClient;
+describe('history commands', () => {
+    beforeEach(() => jest.clearAllMocks());
+    // ── Page History ──────────────────────────────────────────────────
+    describe('history pages — list all', () => {
+        it('fetches recent page versions across all pages', async () => {
+            mockApi.historyPages.mockResolvedValue({
+                data: {
+                    versions: [
+                        { version: 3, slug: 'home', title: 'Home', source: 'cli', created_at: '2026-03-28T12:00:00Z' },
+                        { version: 2, slug: 'about', title: 'About Us', source: 'dashboard', created_at: '2026-03-27T10:00:00Z' },
+                        { version: 1, slug: 'home', title: 'Home', source: 'vibe', created_at: '2026-03-26T08:00:00Z' },
+                    ],
+                    count: 3,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.historyPages(undefined, 50);
+            expect(mockApi.historyPages).toHaveBeenCalledWith(undefined, 50);
+            expect(result.data.versions).toHaveLength(3);
+            expect(result.data.count).toBe(3);
+        });
+        it('returns empty array when no versions exist', async () => {
+            mockApi.historyPages.mockResolvedValue({
+                data: { versions: [], count: 0 },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.historyPages(undefined, 50);
+            expect(result.data.versions).toHaveLength(0);
+        });
+    });
+    describe('history pages — specific page', () => {
+        it('fetches version history for a specific page by slug', async () => {
+            mockApi.historyPages.mockResolvedValue({
+                data: {
+                    page: { id: 10, slug: 'home', title: 'Home', current_version: 5 },
+                    versions: [
+                        { version: 5, title: 'Home v5', source: 'cli', change_summary: 'Updated hero', created_at: '2026-03-28T12:00:00Z' },
+                        { version: 4, title: 'Home v4', source: 'cli', change_summary: 'Before push', created_at: '2026-03-28T11:59:00Z' },
+                        { version: 3, title: 'Home v3', source: 'vibe', change_summary: null, created_at: '2026-03-27T10:00:00Z' },
+                    ],
+                    count: 3,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.historyPages('home', 10);
+            expect(mockApi.historyPages).toHaveBeenCalledWith('home', 10);
+            expect(result.data.page.current_version).toBe(5);
+            expect(result.data.versions).toHaveLength(3);
+        });
+        it('respects limit parameter', async () => {
+            mockApi.historyPages.mockResolvedValue({
+                data: { versions: [{ version: 1 }], count: 1 },
+                status: 200,
+                success: true,
+            });
+            await mockApi.historyPages('home', 1);
+            expect(mockApi.historyPages).toHaveBeenCalledWith('home', 1);
+        });
+    });
+    describe('history pages — specific version detail', () => {
+        it('fetches full snapshot of a specific version', async () => {
+            mockApi.historyPageVersion.mockResolvedValue({
+                data: {
+                    version: 3,
+                    slug: 'home',
+                    title: 'Home v3',
+                    layout_json: { sections: [{ type: 'hero', content: { heading: 'Welcome' } }] },
+                    is_published: true,
+                    source: 'cli',
+                    change_summary: 'Added hero section',
+                    created_at: '2026-03-27T10:00:00Z',
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.historyPageVersion('home', 3);
+            expect(mockApi.historyPageVersion).toHaveBeenCalledWith('home', 3);
+            expect(result.data.layout_json.sections).toHaveLength(1);
+            expect(result.data.layout_json.sections[0].type).toBe('hero');
+        });
+    });
+    // ── KB History ────────────────────────────────────────────────────
+    describe('history KB — list all', () => {
+        it('fetches recent KB entry versions', async () => {
+            mockApi.historyKB.mockResolvedValue({
+                data: {
+                    versions: [
+                        { version: 2, kb_entry_id: 42, title: 'FAQ', category: 'support', source: 'cli' },
+                        { version: 1, kb_entry_id: 42, title: 'FAQ', category: 'general', source: 'import' },
+                    ],
+                    count: 2,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.historyKB(undefined, 50);
+            expect(result.data.versions).toHaveLength(2);
+        });
+    });
+    describe('history KB — specific entry', () => {
+        it('fetches version history for a specific KB entry by ID', async () => {
+            mockApi.historyKB.mockResolvedValue({
+                data: {
+                    entry: { id: 42, title: 'FAQ', category: 'support' },
+                    versions: [
+                        { version: 2, title: 'FAQ', content: 'Updated content', source: 'cli' },
+                        { version: 1, title: 'FAQ', content: 'Original content', source: 'cli' },
+                    ],
+                    count: 2,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.historyKB(42, 10);
+            expect(mockApi.historyKB).toHaveBeenCalledWith(42, 10);
+            expect(result.data.entry.id).toBe(42);
+            expect(result.data.versions).toHaveLength(2);
+        });
+    });
+    // ── Rollback ──────────────────────────────────────────────────────
+    describe('rollback page', () => {
+        it('rolls back a page to a specific version', async () => {
+            mockApi.rollbackPage.mockResolvedValue({
+                data: {
+                    success: true,
+                    message: "Page 'home' rolled back to version 2",
+                    page: { id: 10, slug: 'home', title: 'Home v2', version: 6 },
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.rollbackPage('home', 2);
+            expect(mockApi.rollbackPage).toHaveBeenCalledWith('home', 2);
+            expect(result.data.success).toBe(true);
+            expect(result.data.page.version).toBe(6); // version increments
+        });
+        it('auto-saves current state before rollback', async () => {
+            // The backend auto-snapshots before overwriting — this is critical
+            // We verify the API contract: rollback response confirms success
+            mockApi.rollbackPage.mockResolvedValue({
+                data: { success: true, message: "Page 'home' rolled back to version 1" },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.rollbackPage('home', 1);
+            expect(result.data.success).toBe(true);
+        });
+    });
+    describe('rollback KB', () => {
+        it('rolls back a KB entry to a specific version', async () => {
+            mockApi.rollbackKB.mockResolvedValue({
+                data: {
+                    success: true,
+                    message: "KB entry 'FAQ' rolled back to version 1",
+                    entry: { id: 42, title: 'FAQ', category: 'general' },
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.rollbackKB(42, 1);
+            expect(mockApi.rollbackKB).toHaveBeenCalledWith(42, 1);
+            expect(result.data.success).toBe(true);
+        });
+    });
+    // ── Snapshot ───────────────────────────────────────────────────────
+    describe('createSnapshot', () => {
+        it('creates a snapshot of current state', async () => {
+            mockApi.createSnapshot.mockResolvedValue({
+                data: { success: true, message: 'Snapshot created: 5 pages, 12 KB entries', pages: 5, kb_entries: 12 },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.createSnapshot('cli', 'Before push');
+            expect(mockApi.createSnapshot).toHaveBeenCalledWith('cli', 'Before push');
+            expect(result.data.pages).toBe(5);
+            expect(result.data.kb_entries).toBe(12);
+        });
+        it('tracks source of snapshot (cli, dashboard, vibe)', async () => {
+            mockApi.createSnapshot.mockResolvedValue({
+                data: { success: true },
+                status: 200,
+                success: true,
+            });
+            await mockApi.createSnapshot('vibe', 'Vibe modification');
+            expect(mockApi.createSnapshot).toHaveBeenCalledWith('vibe', 'Vibe modification');
+        });
+    });
+});
+//# sourceMappingURL=history.test.js.map

package/dist/__tests__/commands/history.test.js.map

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

package/dist/__tests__/commands/logs.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Agent logs command tests
+ */
+export {};
+//# sourceMappingURL=logs.test.d.ts.map

package/dist/__tests__/commands/logs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/commands/logs.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/commands/logs.test.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Agent logs command tests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_client_1 = require("../../lib/api-client");
+jest.mock('../../lib/api-client', () => ({
+    apiClient: {
+        agentLogs: jest.fn(),
+        agentErrors: jest.fn(),
+    },
+    handleApiError: jest.fn((e) => ({ message: e?.message || 'Error', status: 500 })),
+}));
+const mockApi = api_client_1.apiClient;
+describe('logs command', () => {
+    beforeEach(() => jest.clearAllMocks());
+    describe('all agent logs', () => {
+        it('fetches unified activity log across all agents', async () => {
+            mockApi.agentLogs.mockResolvedValue({
+                data: {
+                    logs: [
+                        { timestamp: '2026-03-28T14:30:00Z', event_type: 'execution', agent_type: 'customer_service', action: 'chat_response', success: true, latency_ms: 450, tokens_used: 120 },
+                        { timestamp: '2026-03-28T14:29:00Z', event_type: 'task', agent_type: null, action: 'Process refund request', success: true, latency_ms: 1200 },
+                        { timestamp: '2026-03-28T14:28:00Z', event_type: 'communication', action: 'delegation', from_agent_id: 12, to_agent_id: 1 },
+                    ],
+                    count: 3,
+                    period_hours: 24,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.agentLogs(undefined, { hours: 24, limit: 50 });
+            expect(mockApi.agentLogs).toHaveBeenCalledWith(undefined, { hours: 24, limit: 50 });
+            expect(result.data.logs).toHaveLength(3);
+            expect(result.data.logs[0].event_type).toBe('execution');
+        });
+    });
+    describe('agent-specific logs', () => {
+        it('fetches logs for a specific agent with stats', async () => {
+            mockApi.agentLogs.mockResolvedValue({
+                data: {
+                    agent_type: 'customer_service',
+                    logs: [
+                        { event_type: 'execution', action: 'chat_response', success: true, latency_ms: 300 },
+                    ],
+                    count: 1,
+                    stats: {
+                        total_executions: 50,
+                        successes: 48,
+                        errors: 2,
+                        success_rate: 0.96,
+                        avg_latency_ms: 320,
+                        total_tokens: 15000,
+                    },
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.agentLogs('customer_service', { hours: 24, limit: 100 });
+            expect(result.data.stats.success_rate).toBe(0.96);
+            expect(result.data.stats.total_tokens).toBe(15000);
+        });
+    });
+    describe('agent errors', () => {
+        it('fetches errors only for a specific agent', async () => {
+            mockApi.agentErrors.mockResolvedValue({
+                data: {
+                    agent_type: 'customer_service',
+                    errors: [
+                        { timestamp: '2026-03-28T14:00:00Z', action: 'kb_lookup', error: 'KB entry not found', latency_ms: 50 },
+                    ],
+                    count: 1,
+                },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.agentErrors('customer_service', 24, 50);
+            expect(mockApi.agentErrors).toHaveBeenCalledWith('customer_service', 24, 50);
+            expect(result.data.errors).toHaveLength(1);
+            expect(result.data.errors[0].error).toContain('not found');
+        });
+        it('returns empty when no errors exist', async () => {
+            mockApi.agentErrors.mockResolvedValue({
+                data: { agent_type: 'customer_service', errors: [], count: 0 },
+                status: 200,
+                success: true,
+            });
+            const result = await mockApi.agentErrors('customer_service', 24, 50);
+            expect(result.data.errors).toHaveLength(0);
+        });
+    });
+    describe('event type filtering', () => {
+        it('filters by execution events', async () => {
+            mockApi.agentLogs.mockResolvedValue({
+                data: { logs: [{ event_type: 'execution' }], count: 1 },
+                status: 200,
+                success: true,
+            });
+            await mockApi.agentLogs(undefined, { event_type: 'execution' });
+            expect(mockApi.agentLogs).toHaveBeenCalledWith(undefined, { event_type: 'execution' });
+        });
+        it('filters by task events', async () => {
+            mockApi.agentLogs.mockResolvedValue({
+                data: { logs: [{ event_type: 'task' }], count: 1 },
+                status: 200,
+                success: true,
+            });
+            await mockApi.agentLogs(undefined, { event_type: 'task' });
+            expect(mockApi.agentLogs).toHaveBeenCalledWith(undefined, { event_type: 'task' });
+        });
+    });
+    describe('time range', () => {
+        it('supports custom hour range', async () => {
+            mockApi.agentLogs.mockResolvedValue({
+                data: { logs: [], count: 0, period_hours: 72 },
+                status: 200,
+                success: true,
+            });
+            await mockApi.agentLogs(undefined, { hours: 72 });
+            expect(mockApi.agentLogs).toHaveBeenCalledWith(undefined, { hours: 72 });
+        });
+    });
+});
+//# sourceMappingURL=logs.test.js.map

package/dist/__tests__/commands/logs.test.js.map

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

package/dist/__tests__/commands/migrate.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migrate command tests
+ *
+ * Tests company-to-company migration: dry-run preview,
+ * execution, overwrite behavior, selective migration,
+ * and security (reserved IDs, membership checks).
+ */
+export {};
+//# sourceMappingURL=migrate.test.d.ts.map

package/dist/__tests__/commands/migrate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/commands/migrate.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}