@naturali/cli 0.28.0 → 0.28.1

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.1";
 //#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
 		});
 	}
@@ -3779,52 +3779,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 +3840,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 +4007,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 +4043,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.1",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,12 +30,13 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.28.0"
+    "@naturali/sdk": "0.28.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "build": "tsdown"
+    "build": "tsdown",
+    "e2e": "tsx tests/e2e/smoke.ts"
   }
 }