@naturali/cli 0.28.0 → 0.28.2

package/README.md

@@ -88,6 +88,19 @@ pipeline.
 Hand-written source is limited to dispatch, flag parsing, credentials and help;
 there is no per-endpoint code.
 
+## Testing
+
+`pnpm test` runs the unit suite against a mocked `fetch` — flag parsing,
+dispatch, and help output, on every pull request.
+
+`pnpm e2e` (`tests/e2e/smoke.ts`) is different: it drives the *built* CLI
+binary (`bin/naturali`) as real subprocesses against the real, deployed API,
+using a `NATURALI_E2E_API_KEY` account-scoped key. It proves the one thing the
+mocked suite can't — that the CLI, the `@naturali/sdk` it bundles, and the live
+API actually agree — and it provisions and archives its own throwaway project.
+It costs real model-provider money, so it only runs as part of the `e2e` job in
+[`main.yml`](../../.github/workflows/main.yml), never on pull requests.
+
 ## Versioning
 
 Releases are automatic, and the version is **shared with the API and with

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.28.0";
+var version = "0.28.2";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -1299,7 +1299,7 @@ var Knowledge = class {
 	*/
 	static queryKnowledgeCollection(options) {
 		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/knowledge/collections/{collection_id}",
+			url: "/v1/projects/{project_id}/knowledge/collections/{collection_id}:query",
 			...options,
 			headers: {
 				"Content-Type": "application/json",
@@ -1362,7 +1362,7 @@ var Knowledge = class {
 	*/
 	static reingestKnowledgeDocument(options) {
 		return (options.client ?? client).post({
-			url: "/v1/projects/{project_id}/knowledge/collections/{collection_id}/documents/{document_id}",
+			url: "/v1/projects/{project_id}/knowledge/collections/{collection_id}/documents/{document_id}:reingest",
 			...options
 		});
 	}
@@ -2107,6 +2107,32 @@ const formatError = (args) => {
 	}, null, 2);
 };
 /**
+* Resolves the generated SDK method for a route, exiting with an error
+* envelope if the service class or the method itself cannot be found.
+*/
+const resolveServiceMethod = (route) => {
+	const serviceClass = resolveServiceClass(route.serviceClass);
+	if (!serviceClass) {
+		console.error(`SDK class "${route.serviceClass}" not found.`);
+		process.exit(1);
+	}
+	const method = serviceClass[route.operationId];
+	if (typeof method !== "function") {
+		console.error(`Method "${route.operationId}" not found on ${route.serviceClass}.`);
+		process.exit(1);
+	}
+	return method;
+};
+/** Builds the SDK call options from a resolved route call, omitting empty parts. */
+const buildCallOptions = (args) => {
+	const { client, call } = args;
+	const callOptions = { client };
+	if (Object.keys(call.path).length) callOptions["path"] = call.path;
+	if (Object.keys(call.query).length) callOptions["query"] = call.query;
+	if (Object.keys(call.body).length) callOptions["body"] = call.body;
+	return callOptions;
+};
+/**
 * Runs one generated command: parses its flags, resolves credentials, calls the
 * matching SDK method, and prints the result.
 *
@@ -2135,21 +2161,10 @@ const dispatchCommand = async (args) => {
 		console.error(`Missing required path parameter(s): ${built.missingPathParams.join(", ")}.\nProvide with ${flagsHint}.`);
 		process.exit(1);
 	}
-	const serviceClass = resolveServiceClass(route.serviceClass);
-	if (!serviceClass) {
-		console.error(`SDK class "${route.serviceClass}" not found.`);
-		process.exit(1);
-	}
-	const method = serviceClass[route.operationId];
-	if (typeof method !== "function") {
-		console.error(`Method "${route.operationId}" not found on ${route.serviceClass}.`);
-		process.exit(1);
-	}
-	const callOptions = { client: context.client };
-	if (Object.keys(built.call.path).length) callOptions["path"] = built.call.path;
-	if (Object.keys(built.call.query).length) callOptions["query"] = built.call.query;
-	if (Object.keys(built.call.body).length) callOptions["body"] = built.call.body;
-	const result = await method(callOptions) ?? {};
+	const result = await resolveServiceMethod(route)(buildCallOptions({
+		client: context.client,
+		call: built.call
+	})) ?? {};
 	if (result.error) {
 		console.error(formatError({
 			error: result.error,
@@ -3779,52 +3794,6 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"query-knowledge-collection": {
-		serviceClass: "Knowledge",
-		operationId: "queryKnowledgeCollection",
-		description: "Retrieval preview (API.md §4, K5): returns the chunks the collection would surface for a question — debuggable standalone, before any agent is bound to it. This is the `…:query` action; the path segment is `{collection_id}:query`.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
-		httpMethod: "post",
-		pathParams: ["project_id", "collection_id"],
-		queryParams: [],
-		flags: [
-			{
-				"name": "project_id",
-				"description": "Project public ID (proj_ prefix).",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "collection_id",
-				"description": "Knowledge collection public ID (kcol_ prefix).",
-				"required": true,
-				"type": "string",
-				"in": "path"
-			},
-			{
-				"name": "query",
-				"description": "The question to preview retrieval for.",
-				"required": true,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "top_k",
-				"description": "Maximum chunks to return.",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "min_score",
-				"description": "Drop chunks below this similarity score.",
-				"required": false,
-				"type": "number",
-				"in": "body"
-			}
-		]
-	},
 	"update-knowledge-collection": {
 		serviceClass: "Knowledge",
 		operationId: "updateKnowledgeCollection",
@@ -3886,6 +3855,52 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"query-knowledge-collection": {
+		serviceClass: "Knowledge",
+		operationId: "queryKnowledgeCollection",
+		description: "Retrieval preview (API.md §4, K5): returns the chunks the collection would surface for a question — debuggable standalone, before any agent is bound to it. This is the `…:query` action; the path segment is `{collection_id}:query`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
+		httpMethod: "post",
+		pathParams: ["project_id", "collection_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "collection_id",
+				"description": "Knowledge collection public ID (kcol_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "query",
+				"description": "The question to preview retrieval for.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "top_k",
+				"description": "Maximum chunks to return.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "min_score",
+				"description": "Drop chunks below this similarity score.",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			}
+		]
+	},
 	"list-knowledge-documents": {
 		serviceClass: "Knowledge",
 		operationId: "listKnowledgeDocuments",
@@ -4007,12 +4022,12 @@ const routes = {
 			}
 		]
 	},
-	"reingest-knowledge-document": {
+	"delete-knowledge-document": {
 		serviceClass: "Knowledge",
-		operationId: "reingestKnowledgeDocument",
-		description: "Re-run ingestion for a document against its stored source, resetting it to `pending` before re-processing — the recovery path for a `failed` ingest (API.md §4, K1). This is the `…:reingest` action; the path segment is `{document_id}:reingest`.",
+		operationId: "deleteKnowledgeDocument",
+		description: "Delete a document",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
-		httpMethod: "post",
+		httpMethod: "delete",
 		pathParams: [
 			"project_id",
 			"collection_id",
@@ -4043,12 +4058,12 @@ const routes = {
 			}
 		]
 	},
-	"delete-knowledge-document": {
+	"reingest-knowledge-document": {
 		serviceClass: "Knowledge",
-		operationId: "deleteKnowledgeDocument",
-		description: "Delete a document",
+		operationId: "reingestKnowledgeDocument",
+		description: "Re-run ingestion for a document against its stored source, resetting it to `pending` before re-processing — the recovery path for a `failed` ingest (API.md §4, K1). This is the `…:reingest` action; the path segment is `{document_id}:reingest`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
-		httpMethod: "delete",
+		httpMethod: "post",
 		pathParams: [
 			"project_id",
 			"collection_id",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.28.0",
+  "version": "0.28.2",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,12 +30,14 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.28.0"
+    "@naturali/sdk": "0.28.2"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",
     "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests",
     "test": "vitest run",
-    "build": "tsdown"
+    "build": "tsdown",
+    "e2e": "tsx tests/e2e/smoke.ts"
   }
 }