@dataparade/cli 0.0.7 → 0.0.8

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dataparade/cli",
-    "version": "0.0.7",
+    "version": "0.0.8",
     "description": "dataPARADE CLI — scan codebases for privacy and security data flows",
     "publishConfig": {
         "access": "public",
@@ -8,7 +8,7 @@
     },
     "license": "GPL-3.0-or-later",
     "author": "DataParade",
-    "homepage": "https://app.dataparade.com/docs/cli-import-and-zip",
+    "homepage": "https://dataparade.io",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/DataParade-io/dataparade-cli.git"

package/dist/src/ai-enrichment/providers/families/chat-completions-family.js

@@ -103,7 +103,10 @@ class ChatCompletionsFamilyProvider {
         const body = {
             model,
             messages: [
-                { role: "system", content: provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT },
+                {
+                    role: "system",
+                    content: request.systemPrompt ?? provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT,
+                },
                 { role: "user", content: request.prompt },
             ],
             temperature: request.temperature ?? 0.1,

package/dist/src/ai-enrichment/providers/families/generate-content-family.js

@@ -34,7 +34,9 @@ class GenerateContentFamilyProvider {
                 "content-type": "application/json",
             },
             body: JSON.stringify({
-                systemInstruction: { parts: [{ text: provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT }] },
+                systemInstruction: {
+                    parts: [{ text: request.systemPrompt ?? provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT }],
+                },
                 contents: [
                     {
                         role: "user",

package/dist/src/ai-enrichment/providers/families/messages-family.js

@@ -33,7 +33,7 @@ class MessagesFamilyProvider {
                 model,
                 max_tokens: maxTokens,
                 temperature: request.temperature ?? 0.1,
-                system: (0, provider_enrichment_prompts_1.buildAnthropicEnrichmentSystemPrompt)(),
+                system: request.systemPrompt ?? (0, provider_enrichment_prompts_1.buildAnthropicEnrichmentSystemPrompt)(),
                 messages: [{ role: "user", content: request.prompt }],
             }),
         });

package/dist/src/ai-enrichment/providers/families/ollama-generate-family.js

@@ -23,7 +23,7 @@ class OllamaGenerateFamilyProvider {
             },
             body: JSON.stringify({
                 model,
-                prompt: `${provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT}\n\nUser payload:\n${request.prompt}`,
+                prompt: `${request.systemPrompt ?? provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT}\n\nUser payload:\n${request.prompt}`,
                 stream: false,
                 options: {
                     temperature: request.temperature ?? 0.1,

package/dist/src/ai-enrichment/providers/types.d.ts

@@ -6,6 +6,12 @@ export interface AiProviderRequest {
     endpoint?: string;
     temperature?: number;
     maxTokens?: number;
+    /**
+     * Overrides the bundled enrichment system prompt (DP-P0-CLI-3813).
+     * Set by the DataParade backend on the Platform AI path so the server owns
+     * the system role. Unset for BYOK, which keeps the CLI-bundled prompt.
+     */
+    systemPrompt?: string;
 }
 export interface AiProviderUsage {
     inputTokens: number;

package/dist/src/cli.js

@@ -155,6 +155,7 @@ function createProgram() {
         let sentryScanRoot;
         let sentryAiMode;
         let sentryAiProvider;
+        const isInteractive = process.stdout.isTTY;
         const workspaceApiKey = options.workspaceApiKey?.trim() ||
             options.apiKey?.trim() ||
             (0, scan_env_1.resolveWorkspaceApiKey)(process.env);
@@ -182,7 +183,6 @@ function createProgram() {
                 process.exitCode = 2;
                 return;
             }
-            const isInteractive = process.stdout.isTTY;
             const [{ scan, createDefaultScanConfiguration }, { buildDiagramGraphFromScanResult }] = await Promise.all([
                 Promise.resolve().then(() => __importStar(require("./core/pipeline/orchestrator"))),
                 Promise.resolve().then(() => __importStar(require("./core/pipeline/graph-mapping"))),
@@ -482,26 +482,37 @@ function createProgram() {
                     failureMessage: exitFailed ? "CLI scan did not complete successfully" : undefined,
                 });
                 quotaCompletionReported = true;
+                if (isInteractive) {
+                    // eslint-disable-next-line no-console
+                    console.log("[scan] Scan finished — you can start a new scan now.");
+                }
             }
         }
         catch (err) {
             const message = err instanceof Error ? err.message : "Unknown error during scan.";
             fallbackFailureMessage = message;
-            const { CliScanQuotaExceededError } = await Promise.resolve().then(() => __importStar(require("./platform-api/scan-quota-client")));
+            const { CliScanQuotaExceededError, CliScanAlreadyRunningError } = await Promise.resolve().then(() => __importStar(require("./platform-api/scan-quota-client")));
             const quotaBlocked = err instanceof CliScanQuotaExceededError;
+            const scanInProgress = err instanceof CliScanAlreadyRunningError;
             await (0, scan_sentry_1.reportScanCliError)({
                 error: err,
                 scanRoot: sentryScanRoot,
                 jobId: cliQuotaJobId,
                 aiMode: sentryAiMode,
                 aiProvider: sentryAiProvider,
-                failurePhase: quotaBlocked ? "preflight" : "scan_command",
-                failureCode: quotaBlocked ? "scan_quota_exceeded" : "scan_exception",
+                failurePhase: quotaBlocked || scanInProgress ? "preflight" : "scan_command",
+                failureCode: quotaBlocked
+                    ? "scan_quota_exceeded"
+                    : scanInProgress
+                        ? "scan_already_running"
+                        : "scan_exception",
             });
             // eslint-disable-next-line no-console
             console.error(quotaBlocked
                 ? `[scan] workspace quota: ${message}`
-                : `Scan failed: ${message}`);
+                : scanInProgress
+                    ? `[scan] scan in progress: ${message}`
+                    : `Scan failed: ${message}`);
             process.exitCode = 1;
         }
         finally {
@@ -516,6 +527,10 @@ function createProgram() {
                         failureMessage: fallbackFailureMessage,
                     });
                     quotaCompletionReported = true;
+                    if (isInteractive) {
+                        // eslint-disable-next-line no-console
+                        console.log("[scan] Scan finished — you can start a new scan now.");
+                    }
                 }
                 catch {
                     // Quota report failure must not mask the original scan error.

package/dist/src/platform-api/read-cli-api-error-message.d.ts

@@ -0,0 +1,18 @@
+type NestedApiError = {
+    code?: string;
+    message?: string;
+};
+export type CliApiErrorBody = {
+    code?: string;
+    message?: string | string[] | NestedApiError;
+    statusCode?: number;
+};
+export declare function parseCliApiErrorBody(body: unknown): {
+    code?: string;
+    message?: string;
+};
+export declare function readCliApiErrorMessage(body: unknown, fallback: string): {
+    code?: string;
+    message: string;
+};
+export {};

package/dist/src/platform-api/read-cli-api-error-message.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCliApiErrorBody = parseCliApiErrorBody;
+exports.readCliApiErrorMessage = readCliApiErrorMessage;
+function parseCliApiErrorBody(body) {
+    if (!body || typeof body !== "object") {
+        return {};
+    }
+    const parsed = body;
+    if (typeof parsed.message === "string") {
+        return { code: parsed.code, message: parsed.message };
+    }
+    if (Array.isArray(parsed.message)) {
+        return { code: parsed.code, message: parsed.message.join(", ") };
+    }
+    if (parsed.message && typeof parsed.message === "object") {
+        const nested = parsed.message;
+        return {
+            code: nested.code ?? parsed.code,
+            message: typeof nested.message === "string" ? nested.message : undefined,
+        };
+    }
+    return { code: parsed.code };
+}
+function readCliApiErrorMessage(body, fallback) {
+    const parsed = parseCliApiErrorBody(body);
+    return {
+        code: parsed.code,
+        message: parsed.message ?? fallback,
+    };
+}

package/dist/src/platform-api/scan-quota-client.d.ts

@@ -3,6 +3,11 @@ export declare class CliScanQuotaExceededError extends Error {
     readonly code: "scan_quota_exceeded";
     constructor(message: string);
 }
+/** Thrown when preflight is rejected with HTTP 409 scan_already_running. */
+export declare class CliScanAlreadyRunningError extends Error {
+    readonly code: "scan_already_running";
+    constructor(message: string);
+}
 export type CliScanPreflightResponse = {
     allowed: boolean;
     jobId: string;

package/dist/src/platform-api/scan-quota-client.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliScanQuotaExceededError = void 0;
+exports.CliScanAlreadyRunningError = exports.CliScanQuotaExceededError = void 0;
 exports.cliScanPreflight = cliScanPreflight;
 exports.cliScanComplete = cliScanComplete;
 const dataparade_api_base_url_1 = require("./dataparade-api-base-url");
+const read_cli_api_error_message_1 = require("./read-cli-api-error-message");
 /** Thrown when preflight/complete is rejected with HTTP 403 scan_quota_exceeded. */
 class CliScanQuotaExceededError extends Error {
     constructor(message) {
@@ -13,6 +14,15 @@ class CliScanQuotaExceededError extends Error {
     }
 }
 exports.CliScanQuotaExceededError = CliScanQuotaExceededError;
+/** Thrown when preflight is rejected with HTTP 409 scan_already_running. */
+class CliScanAlreadyRunningError extends Error {
+    constructor(message) {
+        super(message);
+        this.code = "scan_already_running";
+        this.name = "CliScanAlreadyRunningError";
+    }
+}
+exports.CliScanAlreadyRunningError = CliScanAlreadyRunningError;
 function buildHeaders(apiKey) {
     return {
         Authorization: `Bearer ${apiKey}`,
@@ -31,15 +41,14 @@ async function cliScanPreflight(input) {
         }),
     });
     if (!res.ok) {
-        let message = `Scan preflight failed (${res.status})`;
+        const fallback = `Scan preflight failed (${res.status})`;
         let code;
+        let message = fallback;
         try {
-            const body = (await res.json());
-            code = body.code;
-            if (typeof body.message === "string")
-                message = body.message;
-            else if (Array.isArray(body.message))
-                message = body.message.join(", ");
+            const body = await res.json();
+            const parsed = (0, read_cli_api_error_message_1.readCliApiErrorMessage)(body, fallback);
+            code = parsed.code;
+            message = parsed.message;
         }
         catch {
             // ignore
@@ -47,6 +56,9 @@ async function cliScanPreflight(input) {
         if (res.status === 403 && code === "scan_quota_exceeded") {
             throw new CliScanQuotaExceededError(message);
         }
+        if (res.status === 409 && code === "scan_already_running") {
+            throw new CliScanAlreadyRunningError(message);
+        }
         throw new Error(message);
     }
     return (await res.json());
@@ -63,13 +75,11 @@ async function cliScanComplete(input) {
         }),
     });
     if (!res.ok) {
-        let message = `Scan complete report failed (${res.status})`;
+        const fallback = `Scan complete report failed (${res.status})`;
+        let message = fallback;
         try {
-            const body = (await res.json());
-            if (typeof body.message === "string")
-                message = body.message;
-            else if (Array.isArray(body.message))
-                message = body.message.join(", ");
+            const body = await res.json();
+            message = (0, read_cli_api_error_message_1.readCliApiErrorMessage)(body, fallback).message;
         }
         catch {
             // ignore

package/dist/tests/unit/ai-enrichment/provider-prompt-backend-contract.spec.d.ts

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

package/dist/tests/unit/ai-enrichment/provider-prompt-backend-contract.spec.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const provider_prompt_1 = require("../../../src/ai-enrichment/provider-prompt");
+/**
+ * Backend contract guard (DP-P0-CLI-3810).
+ *
+ * The backend validates every platform infer prompt against
+ * backend/src/scans/scan-cli-infer-prompt.schema.ts:
+ * - instructions: non-empty string
+ * - agent: tpAgent | propertyAgent | directionAgent | interactionAgent
+ * - candidates: non-empty array, each with id (string) + candidateType (enum)
+ * - componentContext: object
+ * - canonicalComponentIds: string[]
+ *
+ * If buildProviderPromptPayload stops satisfying this shape, platform AI scans
+ * will be rejected with 400 invalid_infer_prompt. Keep both sides in sync.
+ */
+const AGENTS = [
+    "tpAgent",
+    "propertyAgent",
+    "directionAgent",
+    "interactionAgent",
+];
+const CANDIDATE_TYPES = new Set([
+    "third_party",
+    "node_property",
+    "flow_direction",
+    "missing_interaction",
+]);
+function makeComponent() {
+    return {
+        id: "tp_1",
+        name: "Acme API",
+        type: "third_party",
+        confidence: 0.9,
+        detectedFrom: [],
+        sourceLocations: [{ filePath: "src/lib/acme.ts", startLine: 1, endLine: 5 }],
+        properties: { vendor: null },
+    };
+}
+function makeCandidate() {
+    return {
+        id: "cand-1",
+        candidateType: "node_property",
+        priority: 1,
+        componentId: "tp_1",
+        missingFields: ["vendor"],
+        rationale: "sparse properties",
+        hints: [],
+    };
+}
+function assertMatchesBackendContract(payload) {
+    expect(typeof payload.instructions).toBe("string");
+    expect(payload.instructions.length).toBeGreaterThan(0);
+    expect(AGENTS).toContain(payload.agent);
+    expect(Array.isArray(payload.candidates)).toBe(true);
+    const candidates = payload.candidates;
+    expect(candidates.length).toBeGreaterThan(0);
+    for (const cand of candidates) {
+        expect(typeof cand.id).toBe("string");
+        expect(cand.id.length).toBeGreaterThan(0);
+        expect(CANDIDATE_TYPES.has(cand.candidateType)).toBe(true);
+    }
+    expect(payload.componentContext).toBeDefined();
+    expect(typeof payload.componentContext).toBe("object");
+    expect(Array.isArray(payload.componentContext)).toBe(false);
+    expect(Array.isArray(payload.canonicalComponentIds)).toBe(true);
+    for (const id of payload.canonicalComponentIds) {
+        expect(typeof id).toBe("string");
+    }
+    if (payload.relevantFileContents !== undefined) {
+        for (const value of Object.values(payload.relevantFileContents)) {
+            expect(typeof value).toBe("string");
+        }
+    }
+    // The wire format is JSON.stringify(payload); it must round-trip.
+    expect(() => JSON.parse(JSON.stringify(payload))).not.toThrow();
+}
+describe("buildProviderPromptPayload backend contract (DP-P0-CLI-3810)", () => {
+    it.each(AGENTS)("output for %s satisfies the backend infer schema", (agent) => {
+        const payload = (0, provider_prompt_1.buildProviderPromptPayload)({
+            agent,
+            queue: [makeCandidate()],
+            components: [makeComponent()],
+            dataFlows: [],
+        });
+        assertMatchesBackendContract(payload);
+    });
+    it("output with file excerpts still satisfies the contract", () => {
+        const payload = (0, provider_prompt_1.buildProviderPromptPayload)({
+            agent: "propertyAgent",
+            queue: [makeCandidate()],
+            components: [makeComponent()],
+            dataFlows: [],
+            files: [
+                {
+                    path: "src/lib/acme.ts",
+                    name: "acme.ts",
+                    content: 'import { acme } from "acme";',
+                    language: "typescript",
+                    size: 30,
+                },
+            ],
+        });
+        assertMatchesBackendContract(payload);
+    });
+    it("flow-only candidates (empty componentContext) still satisfy the contract", () => {
+        const payload = (0, provider_prompt_1.buildProviderPromptPayload)({
+            agent: "directionAgent",
+            queue: [
+                {
+                    id: "cand-flow",
+                    candidateType: "flow_direction",
+                    priority: 1,
+                    flowId: "flow_1",
+                    missingFields: [],
+                    rationale: "ambiguous direction",
+                    hints: [],
+                },
+            ],
+            components: [makeComponent()],
+            dataFlows: [
+                {
+                    id: "flow_1",
+                    type: "api_call",
+                    confidence: 0.8,
+                    sourceComponentId: "tp_1",
+                    targetComponentId: "tp_1",
+                },
+            ],
+        });
+        assertMatchesBackendContract(payload);
+    });
+});

package/dist/tests/unit/ai-enrichment/providers/system-prompt-override.spec.d.ts

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

package/dist/tests/unit/ai-enrichment/providers/system-prompt-override.spec.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chat_completions_family_1 = require("../../../../src/ai-enrichment/providers/families/chat-completions-family");
+const messages_family_1 = require("../../../../src/ai-enrichment/providers/families/messages-family");
+const resolve_provider_1 = require("../../../../src/ai-enrichment/providers/resolve-provider");
+const provider_enrichment_prompts_1 = require("../../../../src/ai-enrichment/prompts/provider-enrichment-prompts");
+/**
+ * DP-P0-CLI-3813: provider families must honor a caller-supplied `systemPrompt`
+ * (the DataParade backend owns it on the Platform AI path) and fall back to the
+ * bundled prompt when none is given (BYOK path unchanged).
+ */
+const OVERRIDE = "SERVER-OWNED SYSTEM PROMPT (override)";
+function jsonOk(body) {
+    return {
+        ok: true,
+        status: 200,
+        json: async () => body,
+        text: async () => JSON.stringify(body),
+    };
+}
+function lastRequestBody(fetchMock) {
+    const init = fetchMock.mock.calls[0][1];
+    return JSON.parse(String(init.body));
+}
+describe("provider system prompt override (DP-P0-CLI-3813)", () => {
+    const originalFetch = global.fetch;
+    const userPrompt = JSON.stringify({ agent: "propertyAgent", candidates: [] });
+    afterEach(() => {
+        global.fetch = originalFetch;
+        jest.resetAllMocks();
+    });
+    describe("OpenAI chat-completions", () => {
+        it("uses the override when systemPrompt is set", async () => {
+            const fetchMock = jest.fn(async () => jsonOk({ choices: [{ message: { content: '{"proposals":[]}' } }] }));
+            global.fetch = fetchMock;
+            const provider = new chat_completions_family_1.ChatCompletionsFamilyProvider((0, resolve_provider_1.resolveProviderConfig)("openai", { apiKey: "sk-test" }));
+            await provider.infer({
+                prompt: userPrompt,
+                model: "gpt-4o-mini",
+                apiKey: "sk-test",
+                systemPrompt: OVERRIDE,
+            });
+            const body = lastRequestBody(fetchMock);
+            const messages = body.messages;
+            expect(messages[0]).toEqual({ role: "system", content: OVERRIDE });
+        });
+        it("falls back to the bundled prompt when systemPrompt is absent (BYOK)", async () => {
+            const fetchMock = jest.fn(async () => jsonOk({ choices: [{ message: { content: '{"proposals":[]}' } }] }));
+            global.fetch = fetchMock;
+            const provider = new chat_completions_family_1.ChatCompletionsFamilyProvider((0, resolve_provider_1.resolveProviderConfig)("openai", { apiKey: "sk-test" }));
+            await provider.infer({
+                prompt: userPrompt,
+                model: "gpt-4o-mini",
+                apiKey: "sk-test",
+            });
+            const body = lastRequestBody(fetchMock);
+            const messages = body.messages;
+            expect(messages[0]).toEqual({
+                role: "system",
+                content: provider_enrichment_prompts_1.AI_PROVIDER_SYSTEM_PROMPT,
+            });
+        });
+    });
+    describe("Anthropic messages", () => {
+        it("uses the override when systemPrompt is set", async () => {
+            const fetchMock = jest.fn(async () => jsonOk({ content: [{ type: "text", text: '{"proposals":[]}' }] }));
+            global.fetch = fetchMock;
+            const provider = new messages_family_1.MessagesFamilyProvider((0, resolve_provider_1.resolveProviderConfig)("anthropic", { apiKey: "sk-ant" }));
+            await provider.infer({
+                prompt: userPrompt,
+                model: "claude-haiku-4-5",
+                apiKey: "sk-ant",
+                systemPrompt: OVERRIDE,
+            });
+            const body = lastRequestBody(fetchMock);
+            expect(body.system).toBe(OVERRIDE);
+        });
+        it("falls back to the bundled Anthropic prompt when absent (BYOK)", async () => {
+            const fetchMock = jest.fn(async () => jsonOk({ content: [{ type: "text", text: '{"proposals":[]}' }] }));
+            global.fetch = fetchMock;
+            const provider = new messages_family_1.MessagesFamilyProvider((0, resolve_provider_1.resolveProviderConfig)("anthropic", { apiKey: "sk-ant" }));
+            await provider.infer({
+                prompt: userPrompt,
+                model: "claude-haiku-4-5",
+                apiKey: "sk-ant",
+            });
+            const body = lastRequestBody(fetchMock);
+            expect(body.system).toBe((0, provider_enrichment_prompts_1.buildAnthropicEnrichmentSystemPrompt)());
+        });
+    });
+});

package/dist/tests/unit/cli/scan-command-diagram-graph.spec.js

@@ -12,7 +12,16 @@ describe("cli scan command - DP-P0-CLI-402 integration", () => {
     it("writes a valid dataflow.json wrapper to the output path", async () => {
         const fixturesRoot = path_1.default.join(__dirname, "..", "..", "fixtures", "typescript-basic");
         const outputPath = path_1.default.join(os_1.default.tmpdir(), `dataparade-scan-${Date.now()}.json`);
-        await (0, cli_1.run)(["node", "cli", "scan", fixturesRoot, "--output", outputPath]);
+        await (0, cli_1.run)([
+            "node",
+            "cli",
+            "scan",
+            fixturesRoot,
+            "--output",
+            outputPath,
+            "--no-ai-inference",
+            "--skip-auto-upload",
+        ]);
         const contents = fs_1.default.readFileSync(outputPath, "utf8");
         const parsed = JSON.parse(contents);
         const validation = (0, dataflow_wrapper_schema_1.validateDataflowJson)(parsed);

package/dist/tests/unit/cli/scan-command-exit-code.spec.js

@@ -107,6 +107,7 @@ describe("cli scan command - exit codes", () => {
             fixturesRoot,
             "--output",
             tmpOutputPath(),
+            "--no-ai-inference",
         ]);
         expect(process.exitCode).toBe(1);
         expect(outputJson.writeDataflowJson).toHaveBeenCalled();
@@ -144,6 +145,7 @@ describe("cli scan command - exit codes", () => {
             fixturesRoot,
             "--output",
             outputPath,
+            "--no-ai-inference",
         ]);
         expect(process.exitCode).toBe(1);
         expect(outputJson.writeDataflowJson).not.toHaveBeenCalled();

package/dist/tests/unit/cli/scan-quota-flow.spec.js

@@ -49,6 +49,20 @@ describe("scan quota flow", () => {
         expect(errorSpy).toHaveBeenCalledWith("[scan] workspace quota: No scan slots remaining in this workspace.");
         errorSpy.mockRestore();
     });
+    it("prints scan in progress message when preflight is blocked by running job", async () => {
+        process.env.DATAPARADE_WORKSPACE_API_KEY = "dp_live_test";
+        const errorSpy = jest.spyOn(console, "error").mockImplementation(() => { });
+        fetchMock.mockResolvedValueOnce(jsonResponse({
+            statusCode: 409,
+            message: {
+                code: "scan_already_running",
+                message: "Scan in progress — start a new scan after the current one completes.",
+            },
+        }, 409));
+        await (0, cli_1.run)(["node", "cli", "scan", tempRoot, "--ai-inference"]);
+        expect(errorSpy).toHaveBeenCalledWith("[scan] scan in progress: Scan in progress — start a new scan after the current one completes.");
+        errorSpy.mockRestore();
+    });
     it("reports failed completion when preflight succeeds but config validation fails", async () => {
         process.env.DATAPARADE_WORKSPACE_API_KEY = "dp_live_test";
         fetchMock
@@ -75,4 +89,33 @@ describe("scan quota flow", () => {
         expect(String(fetchMock.mock.calls[1][0])).toContain("/api/scans/cli/job-123/complete");
         expect(JSON.parse(String(fetchMock.mock.calls[1][1]?.body))).toEqual(expect.objectContaining({ status: "failed", failureCode: "scan_failed" }));
     });
+    it("prints ready-for-new-scan message after platform scan completes", async () => {
+        process.env.DATAPARADE_WORKSPACE_API_KEY = "dp_live_test";
+        process.env.DATAPARADE_SKIP_AUTO_UPLOAD = "true";
+        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
+        const isTty = Object.getOwnPropertyDescriptor(process.stdout, "isTTY");
+        Object.defineProperty(process.stdout, "isTTY", {
+            value: true,
+            configurable: true,
+        });
+        fetchMock
+            .mockResolvedValueOnce(jsonResponse({
+            allowed: true,
+            jobId: "job-456",
+            scansRemaining: 2,
+            aiTokensRemaining: 1000,
+            suggestedAiBudgetTokens: 100,
+            aiDelivery: "platform_proxy",
+        }))
+            .mockResolvedValueOnce(jsonResponse({ ok: true }));
+        await (0, cli_1.run)(["node", "cli", "scan", tempRoot, "--ai-inference"]);
+        expect(logSpy).toHaveBeenCalledWith("[scan] Scan finished — you can start a new scan now.");
+        if (isTty) {
+            Object.defineProperty(process.stdout, "isTTY", isTty);
+        }
+        else {
+            delete process.stdout.isTTY;
+        }
+        logSpy.mockRestore();
+    });
 });

package/dist/tests/unit/platform-api/read-cli-api-error-message.spec.d.ts

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

package/dist/tests/unit/platform-api/read-cli-api-error-message.spec.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const read_cli_api_error_message_1 = require("../../../src/platform-api/read-cli-api-error-message");
+describe("readCliApiErrorMessage", () => {
+    it("reads flat quota error body", () => {
+        expect((0, read_cli_api_error_message_1.readCliApiErrorMessage)({
+            code: "scan_quota_exceeded",
+            message: "No scan slots remaining in this workspace.",
+        }, "fallback")).toEqual({
+            code: "scan_quota_exceeded",
+            message: "No scan slots remaining in this workspace.",
+        });
+    });
+    it("reads nested Nest conflict error body", () => {
+        expect((0, read_cli_api_error_message_1.readCliApiErrorMessage)({
+            statusCode: 409,
+            message: {
+                code: "scan_already_running",
+                message: "Scan in progress — start a new scan after the current one completes.",
+            },
+        }, "fallback")).toEqual({
+            code: "scan_already_running",
+            message: "Scan in progress — start a new scan after the current one completes.",
+        });
+    });
+    it("joins validation message arrays", () => {
+        expect((0, read_cli_api_error_message_1.parseCliApiErrorBody)({
+            message: ["field is required", "field must be a string"],
+        })).toEqual({
+            message: "field is required, field must be a string",
+        });
+    });
+    it("falls back when message is missing", () => {
+        expect((0, read_cli_api_error_message_1.readCliApiErrorMessage)({}, "Scan preflight failed (500)")).toEqual({
+            message: "Scan preflight failed (500)",
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dataparade/cli",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "dataPARADE CLI — scan codebases for privacy and security data flows",
   "publishConfig": {
     "access": "public",
@@ -8,7 +8,7 @@
   },
   "license": "GPL-3.0-or-later",
   "author": "DataParade",
-  "homepage": "https://app.dataparade.com/docs/cli-import-and-zip",
+  "homepage": "https://dataparade.io",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DataParade-io/dataparade-cli.git"