sketchi 0.4.0 → 0.4.2

package/README.md

@@ -45,9 +45,26 @@ persists the editable result, then writes `<generated-id>.png` in the current
 directory:
 
 ```sh
+sketchi generate
+
+# Direct and noninteractive:
 sketchi generate --prompt "Map release approval with pass and revise branches"
 ```
 
+With no `--prompt`, Sketchi opens a short wizard only when both standard input
+and standard output are human terminals, output is text, and CI is absent. It
+asks for prompt text, flowchart (the default) or mind map, and where to save the
+PNG. The choices are the current directory, a `diagrams/` folder under exactly
+the directory where Sketchi was run, or a custom path with the same semantics as
+`--dest`. Sketchi does not inspect Git, and it creates `diagrams/` only after
+generation succeeds. An explicit `--type` or file `--dest` presets and skips
+that wizard question. Explicit `--format png` may proceed; another format or
+`--dest -` requires `--prompt` because the interactive wizard writes PNG files.
+
+Scripts, pipes, redirected streams, CI, and `--output json` never prompt or
+block. They must pass `--prompt`; omitting it retains the deterministic usage
+error. Passing `--prompt` is always direct and noninteractive.
+
 The PNG is rendered locally from the returned validated artifacts and is not
 written back into the record. Choose another artifact or destination explicitly:
 
@@ -230,6 +247,9 @@ Agents can use
 `--output json`, complete noninteractive input through `--json` or `--file`, and
 raw artifact output through `export --dest -` without prompts.
 
+Agents must pass `--prompt` to `generate`. Interactive prompting is restricted
+to human text TTYs and is never enabled by JSON output, pipes, redirects, or CI.
+
 After exporting PNG to a file, agents can follow the returned hint to display
 that path as an inline Markdown image for the user.
 
@@ -258,6 +278,13 @@ sketchi pull --help
 sketchi restore --help
 ```
 
+The root screen is deliberately progressive: it leads with `generate`, one
+copyable prompt, and the few commands used to continue working with a diagram.
+`sketchi docs` is the complete command and automation map; targeted
+`COMMAND --help` pages retain every flag and example. Interactive terminals get
+the Sketchi pencil lockup and restrained brand color. Pipes, `NO_COLOR`, and
+JSON output remain plain and contain no ANSI control sequences.
+
 Source, issue tracking, and architecture documentation live in the
 [Sketchi repository](https://github.com/shpitdev/sketchi).
 

package/THIRD_PARTY_NOTICES

@@ -41,6 +41,67 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+Terminal presentation dependency tree
+-------------------------------------
+
+The CLI bundles the following terminal presentation packages under the MIT
+License:
+
+- @clack/prompts 1.7.0 and @clack/core 1.4.3
+- fast-string-width 3.0.2, fast-wrap-ansi 0.2.2, and sisteransi 1.0.5
+- chalk 6.0.0
+- string-width 8.2.2, get-east-asian-width 1.6.0, and strip-ansi 7.2.0
+- wrap-ansi 10.0.0 and ansi-styles 6.2.3
+
+Copyright (c) 2025-Present Bombshell contributors
+Copyright (c) 2024-present Fabio Spampinato
+Copyright (c) 2025 James Garbutt
+Copyright (c) 2018 Terkel Gjervig Nielsen
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+CI detection dependency tree
+----------------------------
+
+The CLI bundles is-ci 4.1.0 and ci-info 4.4.0 under the MIT License.
+
+Copyright (c) Thomas Watson Steen <w@tson.dk> (https://twitter.com/wa7son)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
 pako 2.0.3
 -----------
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sketchi",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Local Sketchi authoring CLI with six offline authoring and recovery commands plus three credential-free network commands for generation and encrypted Excalidraw sharing.",
   "keywords": [
     "sketchi",