dataiku-sdk 0.12.7 → 1.1.0

package/packages/types/dist/index.d.ts

@@ -66,6 +66,7 @@ export declare const DatasetSummarySchema: import("@sinclair/typebox").TObject<{
     managed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
     params: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         connection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        uploadConnection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         schema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         catalog: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>>;
@@ -86,6 +87,7 @@ export declare const DatasetDetailsSchema: import("@sinclair/typebox").TObject<{
     managed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
     params: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         connection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        uploadConnection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         table: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         schema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -111,7 +113,7 @@ export declare const DatasetDetailsSchema: import("@sinclair/typebox").TObject<{
 export type DatasetDetails = Static<typeof DatasetDetailsSchema>;
 export declare const DatasetCreateOptionsSchema: import("@sinclair/typebox").TObject<{
     datasetName: import("@sinclair/typebox").TString;
-    connection: import("@sinclair/typebox").TString;
+    connection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     dsType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     table: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     dbSchema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -382,8 +384,8 @@ export declare const FlowZoneUpdateOptionsSchema: import("@sinclair/typebox").TO
 export type FlowZoneUpdateOptions = Static<typeof FlowZoneUpdateOptionsSchema>;
 export declare const FolderCreateOptionsSchema: import("@sinclair/typebox").TObject<{
     name: import("@sinclair/typebox").TString;
-    type: import("@sinclair/typebox").TString;
-    connection: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    connection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     params: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
     projectKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -677,6 +679,128 @@ export declare const FlowMapOptionsSchema: import("@sinclair/typebox").TObject<{
     includeRaw: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
 export type FlowMapOptions = Static<typeof FlowMapOptionsSchema>;
+/**
+ * Git working-copy status of a project. Stable fields are documented in the
+ * DSS 14.7.3 source; DSS additionally returns extension fields, which are
+ * preserved by `additionalProperties: true`.
+ */
+export declare const ProjectGitStatusSchema: import("@sinclair/typebox").TObject<{
+    currentBranch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    remotes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>>>;
+    trackingCount: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        ahead: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        behind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>>;
+    clean: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    hasUncommittedChanges: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    added: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    changed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    removed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    missing: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    modified: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    conflicting: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    untracked: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    untrackedFolders: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    originProjectKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    trackingCountWithOriginProject: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        ahead: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        behind: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    }>>;
+}>;
+export type ProjectGitStatus = Static<typeof ProjectGitStatusSchema>;
+export declare const ProjectGitRemoteSchema: import("@sinclair/typebox").TObject<{
+    url: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ProjectGitRemote = Static<typeof ProjectGitRemoteSchema>;
+/**
+ * Result of a Git mutation. DSS answers with HTTP 200 even for failures, so
+ * `success` is the field callers must inspect before trusting the operation.
+ */
+export declare const ProjectGitActionResultSchema: import("@sinclair/typebox").TObject<{
+    success: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    output: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    logs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    messages: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+}>;
+export type ProjectGitActionResult = Static<typeof ProjectGitActionResultSchema>;
+export declare const ProjectGitTagSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    shortName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    commit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    annotations: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    readOnly: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type ProjectGitTag = Static<typeof ProjectGitTagSchema>;
+export declare const ProjectGitTagsSchema: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    shortName: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    commit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    annotations: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    readOnly: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>>;
+export type ProjectGitTags = Static<typeof ProjectGitTagsSchema>;
+/**
+ * Paginated commit log. `nextCommit` is the cursor DSS expects back to fetch
+ * the following page; entries stay unpinned because commit payloads vary.
+ */
+export declare const ProjectGitLogResultSchema: import("@sinclair/typebox").TObject<{
+    entries: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>;
+    nextCommit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type ProjectGitLogResult = Static<typeof ProjectGitLogResultSchema>;
+/**
+ * Diff between two revisions. Stable fields are documented in the DSS 14.7.3
+ * source; DSS additionally returns extension fields, which are preserved by
+ * `additionalProperties: true`.
+ */
+export declare const ProjectGitDiffResultSchema: import("@sinclair/typebox").TObject<{
+    commitFrom: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    commitTo: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    addedLines: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    removedLines: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    changedFiles: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    entries: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+}>;
+export type ProjectGitDiffResult = Static<typeof ProjectGitDiffResultSchema>;
+export declare const ProjectGitLibrarySchema: import("@sinclair/typebox").TObject<{
+    repository: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    login: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    pathInGitRepository: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    localTargetPath: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    checkout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    addToPythonPath: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type ProjectGitLibrary = Static<typeof ProjectGitLibrarySchema>;
+export declare const ProjectGitLibrariesSchema: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+    repository: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    login: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    pathInGitRepository: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    localTargetPath: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    checkout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    addToPythonPath: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>>;
+export type ProjectGitLibraries = Static<typeof ProjectGitLibrariesSchema>;
+/** Handle returned by Git operations that run asynchronously as a DSS future. */
+export declare const ProjectGitFutureResponseSchema: import("@sinclair/typebox").TObject<{
+    jobId: import("@sinclair/typebox").TString;
+}>;
+export type ProjectGitFutureResponse = Static<typeof ProjectGitFutureResponseSchema>;
+export declare const ProjectGitFutureStateSchema: import("@sinclair/typebox").TObject<{
+    jobId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    hasResult: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    result: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+    alive: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    aborted: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    abortable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    unknown: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    startTime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    runningTime: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    error: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnknown>;
+}>;
+export type ProjectGitFutureState = Static<typeof ProjectGitFutureStateSchema>;
 export declare const ProjectSummaryArraySchema: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
     projectKey: import("@sinclair/typebox").TString;
     name: import("@sinclair/typebox").TString;
@@ -689,6 +813,7 @@ export declare const DatasetSummaryArraySchema: import("@sinclair/typebox").TArr
     managed: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
     params: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         connection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        uploadConnection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         schema: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         catalog: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     }>>;

package/packages/types/dist/index.js

@@ -123,6 +123,7 @@ export const DatasetSummarySchema = Type.Object({
     managed: Type.Optional(Type.Boolean()),
     params: Type.Optional(Type.Object({
         connection: Type.Optional(Type.String()),
+        uploadConnection: Type.Optional(Type.String()),
         schema: Type.Optional(Type.String()),
         catalog: Type.Optional(Type.String()),
     }, { additionalProperties: true, })),
@@ -141,6 +142,7 @@ export const DatasetDetailsSchema = Type.Object({
     managed: Type.Optional(Type.Boolean()),
     params: Type.Optional(Type.Object({
         connection: Type.Optional(Type.String()),
+        uploadConnection: Type.Optional(Type.String()),
         path: Type.Optional(Type.String()),
         table: Type.Optional(Type.String()),
         schema: Type.Optional(Type.String()),
@@ -159,7 +161,7 @@ export const DatasetDetailsSchema = Type.Object({
 }, { additionalProperties: true, });
 export const DatasetCreateOptionsSchema = Type.Object({
     datasetName: Type.String(),
-    connection: Type.String(),
+    connection: Type.Optional(Type.String()),
     dsType: Type.Optional(Type.String()),
     table: Type.Optional(Type.String()),
     dbSchema: Type.Optional(Type.String()),
@@ -393,8 +395,8 @@ export const FlowZoneUpdateOptionsSchema = Type.Object({
 // ---------------------------------------------------------------------------
 export const FolderCreateOptionsSchema = Type.Object({
     name: Type.String(),
-    type: Type.String(),
-    connection: Type.String(),
+    type: Type.Optional(Type.String()),
+    connection: Type.Optional(Type.String()),
     path: Type.Optional(Type.String()),
     params: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
     projectKey: Type.Optional(Type.String()),
@@ -642,6 +644,107 @@ export const FlowMapOptionsSchema = Type.Object({
     includeRaw: Type.Optional(Type.Boolean()),
 });
 // ---------------------------------------------------------------------------
+// Project Git
+// ---------------------------------------------------------------------------
+/**
+ * Git working-copy status of a project. Stable fields are documented in the
+ * DSS 14.7.3 source; DSS additionally returns extension fields, which are
+ * preserved by `additionalProperties: true`.
+ */
+export const ProjectGitStatusSchema = Type.Object({
+    currentBranch: Type.Optional(Type.String()),
+    remotes: Type.Optional(Type.Array(Type.Object({
+        name: Type.Optional(Type.String()),
+        url: Type.Optional(Type.String()),
+    }, { additionalProperties: true, }))),
+    trackingCount: Type.Optional(Type.Object({
+        ahead: Type.Optional(Type.Number()),
+        behind: Type.Optional(Type.Number()),
+    }, { additionalProperties: true, })),
+    clean: Type.Optional(Type.Boolean()),
+    hasUncommittedChanges: Type.Optional(Type.Boolean()),
+    added: Type.Optional(Type.Array(Type.String())),
+    changed: Type.Optional(Type.Array(Type.String())),
+    removed: Type.Optional(Type.Array(Type.String())),
+    missing: Type.Optional(Type.Array(Type.String())),
+    modified: Type.Optional(Type.Array(Type.String())),
+    conflicting: Type.Optional(Type.Array(Type.String())),
+    untracked: Type.Optional(Type.Array(Type.String())),
+    untrackedFolders: Type.Optional(Type.Array(Type.String())),
+    originProjectKey: Type.Optional(Type.String()),
+    trackingCountWithOriginProject: Type.Optional(Type.Object({
+        ahead: Type.Optional(Type.Number()),
+        behind: Type.Optional(Type.Number()),
+    }, { additionalProperties: true, })),
+}, { additionalProperties: true, });
+export const ProjectGitRemoteSchema = Type.Object({
+    url: Type.Optional(Type.String()),
+}, { additionalProperties: true, });
+/**
+ * Result of a Git mutation. DSS answers with HTTP 200 even for failures, so
+ * `success` is the field callers must inspect before trusting the operation.
+ */
+export const ProjectGitActionResultSchema = Type.Object({
+    success: Type.Optional(Type.Boolean()),
+    output: Type.Optional(Type.Unknown()),
+    logs: Type.Optional(Type.Unknown()),
+    messages: Type.Optional(Type.Unknown()),
+}, { additionalProperties: true, });
+export const ProjectGitTagSchema = Type.Object({
+    name: Type.Optional(Type.String()),
+    shortName: Type.Optional(Type.String()),
+    commit: Type.Optional(Type.Unknown()),
+    annotations: Type.Optional(Type.Unknown()),
+    readOnly: Type.Optional(Type.Boolean()),
+}, { additionalProperties: true, });
+export const ProjectGitTagsSchema = Type.Array(ProjectGitTagSchema);
+/**
+ * Paginated commit log. `nextCommit` is the cursor DSS expects back to fetch
+ * the following page; entries stay unpinned because commit payloads vary.
+ */
+export const ProjectGitLogResultSchema = Type.Object({
+    entries: Type.Array(Type.Unknown()),
+    nextCommit: Type.Optional(Type.String()),
+}, { additionalProperties: true, });
+/**
+ * Diff between two revisions. Stable fields are documented in the DSS 14.7.3
+ * source; DSS additionally returns extension fields, which are preserved by
+ * `additionalProperties: true`.
+ */
+export const ProjectGitDiffResultSchema = Type.Object({
+    commitFrom: Type.Optional(Type.Unknown()),
+    commitTo: Type.Optional(Type.Unknown()),
+    addedLines: Type.Optional(Type.Number()),
+    removedLines: Type.Optional(Type.Number()),
+    changedFiles: Type.Optional(Type.Number()),
+    entries: Type.Optional(Type.Array(Type.Unknown())),
+}, { additionalProperties: true, });
+export const ProjectGitLibrarySchema = Type.Object({
+    repository: Type.Optional(Type.String()),
+    login: Type.Optional(Type.String()),
+    pathInGitRepository: Type.Optional(Type.String()),
+    localTargetPath: Type.Optional(Type.String()),
+    checkout: Type.Optional(Type.String()),
+    addToPythonPath: Type.Optional(Type.Boolean()),
+}, { additionalProperties: true, });
+export const ProjectGitLibrariesSchema = Type.Array(ProjectGitLibrarySchema);
+/** Handle returned by Git operations that run asynchronously as a DSS future. */
+export const ProjectGitFutureResponseSchema = Type.Object({
+    jobId: Type.String(),
+}, { additionalProperties: true, });
+export const ProjectGitFutureStateSchema = Type.Object({
+    jobId: Type.Optional(Type.String()),
+    hasResult: Type.Optional(Type.Boolean()),
+    result: Type.Optional(Type.Unknown()),
+    alive: Type.Optional(Type.Boolean()),
+    aborted: Type.Optional(Type.Boolean()),
+    abortable: Type.Optional(Type.Boolean()),
+    unknown: Type.Optional(Type.Boolean()),
+    startTime: Type.Optional(Type.Number()),
+    runningTime: Type.Optional(Type.Number()),
+    error: Type.Optional(Type.Unknown()),
+}, { additionalProperties: true, });
+// ---------------------------------------------------------------------------
 // Array wrappers (for runtime validation of list() responses)
 // ---------------------------------------------------------------------------
 export const ProjectSummaryArraySchema = Type.Array(ProjectSummarySchema);

package/plugin.json

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
 	"name": "dataiku-sdk",
-	"version": "0.12.7",
+	"version": "1.1.0",
 	"description": "Dataiku DSS SDK and agent-oriented CLI for programmatic access to DSS REST APIs.",
 	"homepage": "https://github.com/clssck/dataiku-sdk",
 	"repository": "https://github.com/clssck/dataiku-sdk",

package/skills/dataiku-dss/SKILL.md

@@ -4,7 +4,7 @@ description: >-
   Agent-only JSON CLI for Dataiku DSS. Use to inspect or mutate DSS projects,
   datasets, recipes, jobs, scenarios, folders, notebooks, SQL, variables,
   code envs, and connections. Discover scoped command metadata with
-  dss commands run --fields RESOURCE.ACTION --json.
+  dss commands run --fields RESOURCE.ACTION.
 license: MIT
 compatibility: >-
   Requires the dss CLI, network access to a Dataiku DSS instance, and configured
@@ -19,30 +19,32 @@ If the installed `dss` binary is unavailable but the repository checkout is the
 
 ## Contract
 
-- Command results write exactly one JSON value to stdout, including `doctor`, `batch`, and `cleanup` failure reports; use the exit code and result fields.
-- Dispatch/runtime failures write one JSONL error event to stderr with `type:"error"`, `ok:false`, `error`, `code`, and `exitCode`, while stdout stays empty.
-- Non-fatal warnings and `--verbose` HTTP traces are JSONL stderr events (`type:"warning"` / `type:"trace"`), never prose.
+- Command results write exactly one compact JSON value to stdout; void success is `{ok:true}`. `doctor`, `batch`, and `cleanup` failure reports are their direct result objects on stdout with a nonzero exit code — use the exit code and result fields.
+- Dispatch/runtime failures write one compact structured error object on stdout (`type:"error"`, `ok:false`, `error`, `code`, `category`, `exitCode`) with a nonzero exit code; stderr carries JSONL diagnostics only.
+- Non-fatal warnings and `--verbose` HTTP traces are JSONL stderr events (`type:"warning"` / `type:"trace"`), flushed before both success and failure output, never prose.
 - No prompts, help screens, tables, banners, or prose output are part of the contract.
 - Exit codes: 0 success, 1 usage/configuration error, 2 DSS or internal error, 3 transient/retryable DSS error, 4 a failed long-running result or synchronous assertion.
-- Pass `--json` for compact single-line JSON on stdout; use it for agent discovery and other JSON results to minimize tokens. Without it, success JSON is pretty-printed.
-- `--raw` is the only stdout escape hatch: recipe payload commands emit raw bytes to stdout unless `--output PATH` is also set; with `--output`, stdout is the JSON string equal to `PATH` and the file receives exact raw bytes.
+- Every result is compact single-line JSON on stdout; output formatting is not configurable.
+- Recipe payload commands write the payload as a JSON string on stdout; with `--output PATH` the exact bytes go to a file and stdout carries the JSON string equal to `PATH`.
 - `--fields a,b,c` projects those fields from object or array-of-objects results; dotted paths (`a.b.c`) drill into nested objects, and missing fields become `null`; string and scalar results pass through unchanged.
 
 ## Discover commands
 
 ```text
-dss agent contract --fields protocol,agentContractVersion,cli,stdio,planning,compatibility --json
-dss commands run --fields dataset.create --json
-dss commands run --fields dataset.create.usage,dataset.create.description,dataset.create.flags,dataset.create.examples --json
-dss commands run --fields dataset --json
-dss agent contract --fields commands.actions --json
+dss commands run
+dss commands run --fields dataset
+dss commands run --fields dataset.create
+dss commands run --fields dataset.create.usage,dataset.create.description,dataset.create.flags,dataset.create.examples
+dss commands run --output commands.json
+dss agent contract --fields protocol,agentContractVersion,cli,stdio,planning,compatibility
+dss agent contract --fields commands.actions
 ```
 
-Bootstrap with the scoped `agent contract` call above: `protocol,agentContractVersion,cli,stdio,planning,compatibility` cover protocol/schema compatibility, stderr event semantics, preferred discovery commands, non-JSON escape hatches, planning rules, and compatibility guarantees in ~250 tokens. Request `schemas` (the JSON schemas) or `commands` (the contract's discovery section) only when you actually need them.
+`dss commands run` prints the compact resource/action summary — every resource keyed to its action names, about 1k tokens — and never dumps registry entries to stdout. Bootstrap with the scoped `agent contract` call above: `protocol,agentContractVersion,cli,stdio,planning,compatibility` cover protocol/schema compatibility, stdout/stderr stream semantics, preferred discovery commands, planning rules, and compatibility guarantees in ~250 tokens. Request `schemas` (the JSON schemas) or `commands` (the contract's discovery section) only when you actually need them.
 
-Before choosing command syntax, look the action up in the command registry: `--fields RESOURCE.ACTION` returns one complete entry, and appended `.FIELD` paths return only the metadata you need. Prefer the four-field projection `usage,description,flags,examples` by default — it is the smallest self-sufficient starting point for constructing an invocation. The registry entry is the canonical schema for flags, positional arguments, side effects, auth requirements, output shape, idempotency, dry-run support, structured examples, payload schemas, unsafe outputs, cleanup hints, and exit codes.
+Before choosing command syntax, look the action up in the command registry: `--fields RESOURCE.ACTION` returns one complete entry, `--fields RESOURCE` returns every action of one resource, and appended `.FIELD` paths return only the metadata you need. Prefer the four-field projection `usage,description,flags,examples` by default — it is the smallest self-sufficient starting point for constructing an invocation. The registry entry is the canonical schema for flags, positional arguments, side effects, auth requirements, output shape, idempotency, dry-run support, structured examples, payload schemas, unsafe outputs, cleanup hints, and exit codes.
 
-`--fields` takes a comma-separated list, so request several actions in one call. Each key is echoed exactly as requested (`--fields dataset.create` returns `{"dataset.create": {...}}`). Enumerate every resource and action with `dss agent contract --fields commands.actions --json` (~1k tokens); the hundreds-of-thousands-token unscoped registry is compatibility-only. An unknown resource or action exits with code 1 and a JSON error envelope on stderr containing the valid options.
+`--fields` takes a comma-separated list, so request several actions in one call. Each key is echoed exactly as requested (`--fields dataset.create` returns `{"dataset.create": {...}}`); an empty `--fields` is a usage error, never a silent full dump. The full registry (~220k tokens) is exported only via `--output PATH`: `dss commands run --output PATH` writes the registry, or the selected `--fields` subset, as compact JSON to `PATH`, and stdout carries the compact `{"path":"PATH"}` result — never the registry itself. An unknown resource or action exits with code 1 and a compact JSON error object on stdout containing the valid options.
 Credential lookup order is flags first, then `DATAIKU_*` environment variables, then saved credentials.
 Set `DATAIKU_DISABLE_ENV=1` when a test must ignore both `.env` files and `DATAIKU_*` environment variables.
 When `.env` loading is enabled, the CLI reads `.env` from the command's current working directory first and then the CLI build/root directory; the invocation directory wins on conflicting keys. Put test-specific `.env` files in the directory where you invoke `dss`.
@@ -55,7 +57,7 @@ For disposable agent tests, set `DSS_CONFIG_DIR` to a temporary directory so sav
 - When a create/upload action advertises `--record-cleanup`, pass `--record-cleanup cleanup.jsonl`. `dss cleanup --file cleanup.jsonl` previews the recorded cleanup steps in reverse order and does not mutate DSS; add `--apply` only after checking the preview.
 - For JSON payload actions, follow `inputContract`, `requiredFlags`, and `requiredOneOf`. Prefer `--data-file PATH` or `--stdin` when advertised instead of inline `--data`; this preserves exact JSON across shells and keeps large or sensitive payloads out of process arguments.
 - Authenticated actions advertise `--request-timeout MS` and `--retries N`; `--retries` applies to idempotent GET requests. Long-running actions separately advertise controls such as `--timeout MS`, `--poll-interval MS`, and log limits; use only the flags in that action's registry entry.
-- Before live mutation tests, use `dss fixtures --json` to discover compatible test resources instead of guessing project objects.
+- Before live mutation tests, use `dss fixtures` to discover compatible test resources instead of guessing project objects.
 
 ## Authentication
 
@@ -102,7 +104,7 @@ TLS flags: `--insecure` disables certificate verification; `--ca-cert PATH` adds
 dss version
 dss project list
 dss dataset list --project-key MYPROJ
-dss recipe get-payload compute_orders --raw --output code.py --project-key MYPROJ
+dss recipe get-payload compute_orders --output code.py --project-key MYPROJ
 dss recipe diff compute_orders --file code.py --project-key MYPROJ
 dss recipe set-payload compute_orders --file code.py --project-key MYPROJ
 dss job build-and-wait orders --include-logs --project-key MYPROJ
@@ -169,9 +171,14 @@ narrow and detect key-reuse races but cannot serialize the final check with the
 contain access-control identities; keep them mode `0600` and commit them only when repository
 policy permits.
 
+## Project Git
+
+UAT=`create-branch --duplicate-project`; pull=rebase; checkout=switch. Remotes: DSS Git rules and
+SSH/server credentials. `--password-env`; `future-wait`.
+
 ## Confirming mutations
 
-Mutations print a small JSON ack to stdout and exit 0 on success (e.g. `{"updated":"NAME","resource":"recipe"}`); on failure they print the error envelope to stderr and exit non-zero. The exit code is the source of truth.
+Mutations print a small JSON ack to stdout and exit 0 on success (e.g. `{"updated":"NAME","resource":"recipe"}`); on failure they print the error envelope to stdout and exit non-zero. The exit code is the source of truth.
 
 - For portable multi-step writes, prefer `dss batch` (payload: a JSON array of argv arrays). It runs fail-fast, returns one envelope with per-step `ok`/`result`/`error`, and exits non-zero if any step fails.
 - If separate processes are required, inspect each exit code and stop before launching the next step. Do not rely on shell chaining: syntax differs between POSIX shells, Windows PowerShell 5.1, PowerShell 7, and Command Prompt.
@@ -193,7 +200,7 @@ Mutations print a small JSON ack to stdout and exit 0 on success (e.g. `{"update
 
 ## Error envelope
 
-For dispatch/runtime failures, parse stderr as JSONL; the final line is an error event:
+For dispatch/runtime failures, stdout carries one compact error object:
 
 ```json
 {
@@ -208,6 +215,6 @@ For dispatch/runtime failures, parse stderr as JSONL; the final line is an error
 }
 ```
 
-`doctor`, `batch`, and `cleanup` report command-level failures on stdout and leave stderr empty. Use the exit code before choosing a stream.
+`doctor`, `batch`, and `cleanup` report command-level failures as their direct result object on stdout with a nonzero exit code; key off the exit code before interpreting the result.
 Use `code`, `category`, `exitCode`, `retryable`, `status`, and `details` for recovery logic. Do not scrape message text when a structured field is available.
 Treat `details.body` as sanitized metadata only: it contains at most `requestId`/`request_id`/`errorId`/`elapsedMs` plus locally trusted target/timing fields, not the arbitrary DSS response body. `details.statusText` is canonical text derived from the numeric status, not a remote reason phrase. Base recovery on top-level `code`, `category`, `status`, `retryable`, `requestId`, `hint`, and `details.dssCategory`; never parse or expose assumed server-body fields.