Commit Graph
12 Commits
Author SHA1 Message Date
james.maesandClaude Fable 5.1 ffedcbb2ff core+cli: never write a server-named download outside --out-dir or over a file
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>
2026-10-31 17:50:20 -05:00
james.maesandClaude Fable 5.1 0ef9bfb364 Merge feat/m1-kernel-cli into feat/m1-process-components
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>
2026-10-31 17:49:50 -05:00
james.maesandClaude Fable 5.1 e4916c2971 core+cli: every process step component, review prompt, cancel, back, min/max records
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>
2026-10-31 17:47:38 -05:00
james.maesandClaude Fable 5.1 b68ca47c62 cli: table get --key, table copy, --search, apps show, report list, help show; export hardening
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>
2026-10-31 17:46:29 -05:00
james.maesandClaude Fable 5.1 06a78d87b5 core+cli: files for BLOB process fields (qqq process run --file field=path)
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>
2026-10-31 17:34:29 -05:00
james.maesandClaude Fable 5.1 bbbcbff6e9 core+cli: profiles and an OS keyring for sign-ins
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>
2026-10-31 17:24:56 -05:00
james.maesandClaude Fable 5.1 b29903c177 core+cli: metadata cache and shell completion
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>
2026-10-31 17:21:15 -05:00
james.maesandClaude Fable 5.1 c228ec1abc core+cli: widget render model; widget, report, prefs and help-search commands
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>
2026-10-31 17:18:23 -05:00
james.maesandClaude Fable 5.1 4383c87e42 core+cli: form engine with contingent fields, possible-value labels, local validation, prompts
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>
2026-10-31 17:14:25 -05:00
james.maesandClaude Fable 5.1 8ed694cd2f cli: noun-verb grammar on the kernel, output formats, JMESPath, CRUD, api escape hatch
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>
2026-10-31 17:03:18 -05:00
james.maesandClaude Fable 5.1 ff27af2f9e cli: session sign-in for MOCK and anonymous servers, sent as a cookie; qqq launcher
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>
2026-10-31 16:21:02 -05:00
james.maesandClaude Opus 5.5 ea79ddeb78 feat: reference CLI, generated UI API client, conformance suite and dev IdP
- @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>
2026-10-15 11:47:12 -05:00