DOWNLOAD_FORM names come from the server. safeDownloadName keeps the last path
segment only (either separator), strips control characters and refuses empty,
. and ..; qqq process run writes with flag wx and takes name-1.ext, name-2.ext
when the name is taken. Tested with traversal names.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Keeps both export sets in the kernel index, renumbers the process findings to
13 and 14 after the query-gaps findings, and regenerates the parity matrix from
the merged STATUS table.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The kernel gains a screen model (process/screen): each step's components in
declared order become neutral blocks both heads render - HELP_TEXT and HTML as
text, VIEW_FORM pairs on every step, RECORD_LIST paged through GET .../records,
the validation review with its preview and summary, PROCESS_SUMMARY_RESULTS
lines, DOWNLOAD_FORM references (GET /download), WIDGET through the widget
render model, and step help content.
The runner presents each screen, asks the provider on every input step
(validation review included), restarts at backStep with isStepBack=true when
the provider returns BACK, cancels on an abort signal with POST .../cancel,
and checks min/max input records before init. A step whose components are
only a VIEW_FORM no longer counts its formFields as inputs.
qqq process run prints intermediate screens to stderr and the last as its
output, asks validate-or-skip and Submit? on a terminal, saves downloads to
--out-dir, and turns Ctrl-C into a server cancel (exit 130). Verified live on
sleepInteractive, greetInteractive, clonePeople, simpleThrow, placeAddressPick
and person.bulkEdit's review screen; findings 11 and 12 recorded.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Export checks the format and field names before the request (the server
answers 500 for both), takes the format from --out, writes to stdout with
--out -, and can drop the header row.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The runner sends a file as a multipart part with the first step whose form has that BLOB
field, and treats a pending file as a provided value. Verified against the sample's
person.bulkInsert upload step once the sample accepts uploads (finding 10).
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
session/profiles.ts keeps named profiles (server, note, default) in ~/.config/qqq/config.json
and resolves --profile, QQQ_PROFILE, --server, QQQ_SERVER or the default. session/keyring.ts
stores secrets without native modules: macOS Keychain through security, Linux Secret Service
through secret-tool, Windows DPAPI through PowerShell, and a 0600 file otherwise or with
QQQ_KEYRING=file. The CLI's session store moves onto them, imports the 0.1 credentials file
once, and adds --profile plus qqq config show and config profile list|add|use|remove.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
metadata/cache.ts keeps GET /metaData and table definitions on disk per server (five-minute
TTL, offline reads, refresh and clear). Listings and table commands read through it, so a
cached query round-trips in tens of milliseconds. qqq completion bash|zsh|fish|pwsh prints a
small script that calls the hidden qqq __complete, which answers from the command tree and
the cache: nouns, verbs, options, tables, processes, widgets, reports, fields after --where,
--order, --fields and --set, output formats, and operation ids for qqq api.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
widgets/render-model.ts turns any WidgetData shape into neutral blocks (heading, stat, table,
series, pairs, steps, alert, link, rule, children) and prints them for a terminal: one-dataset
charts as bars, several datasets as a labels-by-datasets table, html through its text sibling or
stripped, composites nested, permission refusals as a warning. qqq widget get renders or
exports --csv; report run saves a report; prefs list/get/set/action and help-search wrap the
preferences and help operations. docs/server-findings.md lists the candidate qqq issues found
so far.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The kernel gains forms/: field dependencies (possibleValueSourceDependsOn or ${input.x} in a
filter), DISABLE_UNTIL_SET semantics, dependents cleared transitively when a dependency
changes, possible-value search with the dependency values, resolution of typed text by id,
exact label or unique partial (with a client-side fallback when the source matches
case-sensitively), server-mirroring validation (required, type, length, range, pattern),
behaviors, form adjusters (onLoad and onChange, 404 means none), and a FormSession that
both heads drive. process/runner.ts runs init and every step through a provider callback,
polling async jobs. The CLI's table create/update and process run go through the session:
--set and -v accept labels, -i prompts on a terminal with choices that narrow after each
answer, and invalid values fail with exit 6 before any request.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
qqq <noun> <verb> for table (list, describe, query, count, get, create, update, delete, export),
process (list, describe, run) and job (list, get, logs, cancel, retry), with the 0.1 flat
commands kept as hidden aliases. Global --output json|table|text|csv|yaml, --json, --query
(JMESPath), --fields, --yes and --trace work before or after the subcommand. Filters take
--where, --group (AND/OR with parentheses), --or, --order, --filter-json, --print-filter and
--count; queries page with --limit, --skip and --all. qqq api <operationId> calls any
operation from the generated index (--path, --param, --body-json, --form, --bytes, --out).
Exit codes: 2 usage and bad filters, 3 auth, 4 unreachable or rate limited, 5 not found,
6 validation, 70 server error. The realtime stream can carry a session cookie for tail.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The client gains getAuthenticationMetaData, createSession (reads the HttpOnly sessionUUID
cookie) and a sessionCookie option; UI_API_VERSION is 1.8.0. qqq login branches on the
server's authentication type and stores a server session for MOCK and FULLY_ANONYMOUS; the
device flow stays for OAUTH2 and AUTH_0. The session goes as a cookie because a bearer
session cannot continue asynchronous process steps on the 4.1.0-SNAPSHOT sample server.
scripts/dev/qqq.sh runs the CLI from source so every commit is testable without a build.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- @qrun-io/qqq-ui-api-client: typed client generated (openapi-typescript +
openapi-fetch) from the merged UI API document; device-flow sign-in, refresh,
UiApiError (BasicErrorResponseV1), SSE reader
- @qrun-io/qqq-cli: qqq login/whoami/apps/tables/query/get/run/jobs/tail,
only through /qqq/v1 with Authorization: Bearer
- @qrun-io/qqq-ui-api-conformance: black-box suite + qqq-dev-idp
- scripts/merge-spec.mjs, Prism mock, CI and GitHub Packages publish workflows
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>