new library
verbmutateScaffold a library of commons: its folder, manifest, about.ts, specification kit, tools, tsconfig and LICENSE, and make what needs it again.
Program repoctl-contributor. Origin repoctl.
Governance: the action
What the verb is and may do, as governance says it. Each annotation is expressed by the surfaces or says why it is not.
| Property | Value |
|---|---|
kind | action |
effect | mutate |
idempotent | false |
audience | both |
tier | contributor |
dryRun | true |
check | false |
reachChannels | local, mcp |
reachReadOnly | false |
reachNeedsTty | false |
reachRunsAs | caller |
reachConfirmation | none |
Operands
| Operand | Meaning |
|---|---|
NAME | The name of the library: lower-case letters, digits and hyphens, starting with a letter. |
Options
| Option | Meaning | Properties |
|---|---|---|
--summary | What the library is, in a sentence or two: its first sentence is its row in the README. | type=value, required=true, standard=false, humanOnly=false, valueName=TEXT |
--role | Where the README puts it: foundation, pattern, program or standard. | type=value, required=false, standard=false, humanOnly=false, valueName=ROLE, default=program |
--json | Write one JSON document and nothing else for a person. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--quiet | Show only how it ended. | type=flag, short=q, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--verbose | Show every step as it happens. | type=flag, short=v, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--color | Use colour where the terminal shows it (--no-color turns it off). | type=flag, required=false, standard=true, humanOnly=false, negatable=true, default=true |
--non-interactive | Never ask a question: where one is needed, fail and say so. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
--dry-run | Show what would change and change nothing. | type=flag, required=false, standard=true, humanOnly=false, negatable=false, default=false |
Examples
repoctl new library widget --summary Widgets, made by the book. # Scaffold the library widget in the libraries' folder with its manifest, spec kit, tools and LICENSE.
repoctl new library widget --summary Widgets. --dry-run # List the files that would be made, and write nothing.Physical: what it is drawn as
repoctl new library
cli-command. Scaffold a library of commons: its folder, manifest, about.ts, specification kit, tools, tsconfig and LICENSE, and make what needs it again.
| Property | Value |
|---|---|
usage | repoctl new library |
words | new, library |
tier | contributor |
repoctl_new_library
mcp-tool. Scaffold a library of commons: its folder, manifest, about.ts, specification kit, tools, tsconfig and LICENSE, and make what needs it again. (action, effect mutate.)
| Property | Value |
|---|---|
title | repoctl new library |
toolName | repoctl_new_library |
readOnlyHint | false |
destructiveHint | false |
idempotentHint | false |
inputs | summary, role, dryRun, NAME |
required | summary, NAME |
tier | contributor |
Not drawn
- rest: its reach policy does not name the rest channel