chore: release cli-core 0.17.0

CHANGELOG.md

@@ -7,15 +7,15 @@ Versions before 0.8.0 are in the [git tags](https://github.com/leemour/cli-core/
 Every entry says what changed as a caller sees it, why, and what to watch for — the rules are
 [`docs/dev/CONVENTIONS.md`](docs/dev/CONVENTIONS.md#the-changelog).
 
-## Unreleased
+## 0.17.0 — 03.10.2026
 
 ### Changed — may break callers
 
 - Consumers switching exhaustively over `SchemaNode` or API parameter locations must handle explicit unions and RPC body parameters. Existing HTTP models generate the same artifacts.
 
 ### Added
 
-- API generators preserve explicit unions and Boolean literals, validate nested references, and emit schema definitions for shared command input traversal. RPC parameters can belong to the JSON body; multipart references retain their format.
+- API generators preserve explicit unions and Boolean literals, validate nested references, and emit schema definitions for shared command input traversal. RPC parameters can belong to the JSON body; multipart references retain their format. Source adapters can mark secret fields so consumers keep them out of generated CLI arguments.
 
 ## 0.16.0 — 02.10.2026
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leemour/cli-core",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "The parts every command line tool needs: output modes, terminal rendering, error model, exit codes, credentials, clocks",
   "license": "MIT",
   "author": "Viacheslav Ptsarev",

src/codegen/manifest.ts

@@ -15,12 +15,13 @@ export interface ManifestOperation {
   parameters: readonly {
     name: string
     in: "path" | "query" | "header" | "body"
+    sensitive?: boolean
     required: boolean
     description?: string
     schema: SchemaNode
   }[]
   request?: { required: boolean; confidence: Confidence; schema?: string }
-  response?: { confidence: Confidence; schema?: string }
+  response?: { confidence: Confidence; schema?: string; sensitive?: boolean }
 }
 
 const withoutUndefined = <T extends object>(value: T): T =>
@@ -45,7 +46,11 @@ const toManifest = (operation: ApiOperation, tree: SchemaTree): ManifestOperatio
         })
       : undefined,
     response: operation.response
-      ? withoutUndefined({ confidence: operation.response.confidence, schema: tree.responseName(operation.id) })
+      ? withoutUndefined({
+          confidence: operation.response.confidence,
+          schema: tree.responseName(operation.id),
+          sensitive: operation.response.schema?.sensitive,
+        })
       : undefined,
   })
 

src/codegen/model.ts

@@ -30,6 +30,7 @@ export interface RpcBinding {
 export type Binding = HttpBinding | RpcBinding
 
 interface SchemaCommon {
+  sensitive?: boolean
   description?: string
   nullable?: boolean
   deprecated?: boolean
@@ -82,6 +83,7 @@ export interface ApiSchema {
 export interface ApiParameter {
   name: string
   in: "path" | "query" | "header" | "body"
+  sensitive?: boolean
   required: boolean
   description?: string
   schema: SchemaNode

src/codegen/unions.test.ts

@@ -18,7 +18,7 @@ const model: ApiModel = {
   source: { kind: "other" },
   schemas: [
     { id: "Address", schema: { type: "union", of: [{ type: "integer", format: "int64" }, { type: "string" }] } },
-    { id: "File", schema: { type: "string", format: "binary" } },
+    { id: "File", schema: { type: "string", format: "binary", sensitive: true } },
     {
       id: "Node",
       schema: {
@@ -40,7 +40,7 @@ const model: ApiModel = {
       binding: { kind: "rpc", name: "readNode" },
       tags: [],
       parameters: [{ name: "address", in: "body", required: true, schema: { type: "ref", ref: "Address" } }],
-      response: { required: true, confidence: "contract", schema: { type: "ref", ref: "Node" } },
+      response: { required: true, confidence: "contract", schema: { type: "ref", ref: "Node", sensitive: true } },
       effect: "read",
       source: { location: "methods/readNode" },
     },
@@ -103,9 +103,10 @@ describe("generated unions", () => {
 
   it("emits runtime definitions with source formats and resolves response references", async () => {
     const { definitions } = await import(join(root, "definitions.ts"))
-    expect(definitions.File).toEqual({ type: "string", format: "binary" })
+    expect(definitions.File).toEqual({ type: "string", format: "binary", sensitive: true })
     const { operations } = await import(join(root, "manifest.ts"))
     expect(operations[0].response.schema).toBe("Node")
+    expect(operations[0].response.sensitive).toBe(true)
     expect(definitions.Node.type).toBe("union")
   })