xiaoju
ae757e4d44
CI / check (pull_request) Successful in 2m52s
Closes #147. Changes default behavior of `uwf thread list` to show only active threads (idle + running). Adds `--all` flag to opt into the previous full-list behavior. Explicit `--status` still wins over `--all`. - cmdThreadList gains a `showAll: boolean` parameter (default false) - CLI registers `--all` option and passes it through - Test suite includes new `default behavior (issue #147)` describe block covering 9 scenarios; existing tests updated where they implicitly relied on the old "show everything" behavior - README, cli-reference, and usage-reference updated to document the new default and the `--all` flag Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
95 lines
4.1 KiB
TypeScript
95 lines
4.1 KiB
TypeScript
// MAINTENANCE: This string must be kept in sync with the actual uwf CLI commands.
|
|
// Update whenever commands are added, removed, or their signatures change.
|
|
export function generateCliReference(): string {
|
|
return `# uwf CLI Reference
|
|
|
|
## Setup
|
|
|
|
\`\`\`
|
|
uwf setup # interactive setup wizard
|
|
uwf setup --provider <name> --base-url <url> \\
|
|
--api-key <key> --model <name> # non-interactive setup
|
|
[--agent <name>] # optional: default agent alias
|
|
\`\`\`
|
|
|
|
## Workflow Commands
|
|
|
|
\`\`\`
|
|
uwf workflow add <file> # register a workflow from YAML file
|
|
uwf workflow show <id> # show workflow by name or CAS hash
|
|
uwf workflow list # list all registered workflows
|
|
\`\`\`
|
|
|
|
## Thread Commands
|
|
|
|
\`\`\`
|
|
uwf thread start <workflow> -p <prompt> # create a thread (no execution)
|
|
uwf thread exec <thread-id> # execute one moderator→agent→extract cycle
|
|
[--agent <cmd>] # override agent command
|
|
[-c, --count <number>] # run multiple steps (default: 1)
|
|
[--background] # run in background
|
|
uwf thread show <thread-id> # show thread head pointer
|
|
uwf thread list # list active threads (idle + running)
|
|
[--all] # include completed/cancelled/suspended
|
|
[--status <status>] # filter: idle, running, suspended, completed, cancelled, active
|
|
uwf thread read <thread-id> # render thread context as markdown
|
|
[--quota <chars>] # max output characters (default 32000)
|
|
[--before <step-hash>] # load steps before this hash (exclusive)
|
|
[--start] # include start step in output
|
|
uwf thread stop <thread-id> # stop background execution (keep thread active)
|
|
uwf thread cancel <thread-id> # cancel thread (stop + move to history)
|
|
\`\`\`
|
|
|
|
## Step Commands
|
|
|
|
\`\`\`
|
|
uwf step list <thread-id> # list all steps in a thread
|
|
uwf step show <step-hash> # show details of a specific step
|
|
uwf step fork <step-hash> # fork a thread from a specific step
|
|
\`\`\`
|
|
|
|
## CAS Commands
|
|
|
|
Use the \`ocas\` CLI for direct CAS operations (\`~/.ocas/\` store, shared with \`uwf\`):
|
|
|
|
\`\`\`
|
|
ocas get <hash> # read a CAS node (type + payload)
|
|
[--timestamp] # include timestamp in output
|
|
ocas put <type-hash> <data> # store a node, print its hash
|
|
# <data>: JSON file path or inline JSON string
|
|
ocas has <hash> # check if a hash exists
|
|
ocas refs <hash> # list direct CAS references from a node
|
|
ocas walk <hash> # recursive traversal from a node
|
|
ocas reindex # rebuild type index from all CAS nodes
|
|
ocas schema list # list all registered schemas
|
|
ocas schema get <hash> # show a schema by its type hash
|
|
\`\`\`
|
|
|
|
## Log Commands
|
|
|
|
\`\`\`
|
|
uwf log list # list log files with sizes
|
|
uwf log show # show all log entries
|
|
[--thread <thread-id>] # filter by thread ID
|
|
[--process <pid>] # filter by process ID
|
|
[--date <YYYY-MM-DD>] # filter by date
|
|
uwf log clean --before <date> # delete log files before given date
|
|
\`\`\`
|
|
|
|
## Global Options
|
|
|
|
\`\`\`
|
|
uwf --format <fmt> # output format: json (default) or yaml
|
|
uwf -V, --version # print version
|
|
\`\`\`
|
|
|
|
## Key Concepts
|
|
|
|
- **Workflow**: YAML definition with roles, conditions, and a routing graph; stored as a CAS node identified by its XXH64 hash.
|
|
- **Thread**: A running instance of a workflow; points to a chain of CAS step nodes.
|
|
- **Step**: One moderator→agent→extract cycle; stored as a CAS node with output + detail refs.
|
|
- **Turn**: Agent-internal interaction (within a single step); stored per-turn in the detail node.
|
|
- **CAS**: Content-addressable store; every artifact (workflows, steps, details, turns) is hashed.
|
|
`;
|
|
}
|