@otea/cli 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +661 -0
- package/README.es.md +151 -0
- package/README.md +252 -2
- package/THIRD_PARTY_NOTICES.md +114 -0
- package/bin/otea.mjs +28 -0
- package/dist/app/agent-detail.js +26 -0
- package/dist/app/agent-draft.js +429 -0
- package/dist/app/agent-prompts.js +52 -0
- package/dist/app/agents.js +77 -0
- package/dist/app/asking.js +43 -0
- package/dist/app/board-archive.js +243 -0
- package/dist/app/board-migration.js +272 -0
- package/dist/app/boards.js +870 -0
- package/dist/app/branch-owner.js +48 -0
- package/dist/app/brief.js +53 -0
- package/dist/app/choices.js +61 -0
- package/dist/app/collections.js +101 -0
- package/dist/app/context.js +1 -0
- package/dist/app/crop.js +56 -0
- package/dist/app/devices.js +62 -0
- package/dist/app/draft-request.js +82 -0
- package/dist/app/events.js +12 -0
- package/dist/app/evidence.js +287 -0
- package/dist/app/gates.js +610 -0
- package/dist/app/guide.js +37 -0
- package/dist/app/home.js +145 -0
- package/dist/app/init-boards.js +36 -0
- package/dist/app/intake.js +25 -0
- package/dist/app/item-search.js +141 -0
- package/dist/app/items.js +318 -0
- package/dist/app/keep-waiting.js +44 -0
- package/dist/app/land-order.js +107 -0
- package/dist/app/language.js +52 -0
- package/dist/app/launcher.js +56 -0
- package/dist/app/lease-take.js +54 -0
- package/dist/app/leases.js +86 -0
- package/dist/app/machine.js +39 -0
- package/dist/app/merged.js +89 -0
- package/dist/app/migrate.js +171 -0
- package/dist/app/next.js +1637 -0
- package/dist/app/notes.js +319 -0
- package/dist/app/notify-targets.js +113 -0
- package/dist/app/opened.js +25 -0
- package/dist/app/owner-only.js +34 -0
- package/dist/app/performance.js +28 -0
- package/dist/app/phone.js +97 -0
- package/dist/app/presence.js +596 -0
- package/dist/app/preset-views.js +25 -0
- package/dist/app/presets.js +129 -0
- package/dist/app/priority.js +156 -0
- package/dist/app/profile.js +86 -0
- package/dist/app/project.js +247 -0
- package/dist/app/proofs.js +179 -0
- package/dist/app/questions.js +215 -0
- package/dist/app/reader-filter.js +58 -0
- package/dist/app/relations.js +164 -0
- package/dist/app/relay.js +98 -0
- package/dist/app/repos.js +176 -0
- package/dist/app/restart.js +92 -0
- package/dist/app/set-aside.js +64 -0
- package/dist/app/system-locale.js +6 -0
- package/dist/app/tailscale-cli.js +77 -0
- package/dist/app/tailscale-testing.js +41 -0
- package/dist/app/tailscale.js +177 -0
- package/dist/app/tips.js +30 -0
- package/dist/app/topics-everywhere.js +53 -0
- package/dist/app/topics.js +453 -0
- package/dist/app/undo.js +52 -0
- package/dist/app/validate.js +131 -0
- package/dist/app/watch.js +48 -0
- package/dist/cli/command.js +44 -0
- package/dist/cli/commands.js +3303 -0
- package/dist/cli/exit-codes.js +70 -0
- package/dist/cli/forge.js +176 -0
- package/dist/cli/format.js +340 -0
- package/dist/cli/gh.js +17 -0
- package/dist/cli/gitrepo.js +489 -0
- package/dist/cli/help.js +101 -0
- package/dist/cli/hooks.js +232 -0
- package/dist/cli/main.js +37 -0
- package/dist/cli/merged-outside.js +58 -0
- package/dist/cli/names.js +154 -0
- package/dist/cli/opener.js +21 -0
- package/dist/cli/owner.js +154 -0
- package/dist/cli/phone.js +221 -0
- package/dist/cli/ports.js +24 -0
- package/dist/cli/probe.js +18 -0
- package/dist/cli/run.js +246 -0
- package/dist/cli/serve-file.js +21 -0
- package/dist/cli/stats.js +55 -0
- package/dist/cli/version.js +3 -0
- package/dist/core/agent-guide.js +31 -0
- package/dist/core/agent-prompts.js +139 -0
- package/dist/core/authority.js +94 -0
- package/dist/core/board/analysis.js +86 -0
- package/dist/core/board/choices.js +100 -0
- package/dist/core/board/compile.js +362 -0
- package/dist/core/board/engine.js +523 -0
- package/dist/core/board/hints.js +46 -0
- package/dist/core/board/history.js +146 -0
- package/dist/core/board/ids.js +87 -0
- package/dist/core/board/joins.js +30 -0
- package/dist/core/board/mentions.js +68 -0
- package/dist/core/board/merged.js +18 -0
- package/dist/core/board/model.js +135 -0
- package/dist/core/board/next.js +1116 -0
- package/dist/core/board/notes.js +298 -0
- package/dist/core/board/performance.js +218 -0
- package/dist/core/board/plan.js +299 -0
- package/dist/core/board/problems.js +232 -0
- package/dist/core/board/proofs.js +84 -0
- package/dist/core/board/questions.js +114 -0
- package/dist/core/board/reading.js +220 -0
- package/dist/core/board/readings.js +534 -0
- package/dist/core/board/schema.js +335 -0
- package/dist/core/board/shape-words.js +179 -0
- package/dist/core/board/template-words.js +23 -0
- package/dist/core/board/templates-catalogue.js +965 -0
- package/dist/core/board/templates-coverage.js +261 -0
- package/dist/core/board/templates-flows.js +779 -0
- package/dist/core/board/templates.js +586 -0
- package/dist/core/brief.js +93 -0
- package/dist/core/diagram.js +80 -0
- package/dist/core/errors.js +12 -0
- package/dist/core/evidence.js +33 -0
- package/dist/core/fields.js +129 -0
- package/dist/core/hierarchy.js +30 -0
- package/dist/core/icons.js +181 -0
- package/dist/core/image-crop.js +166 -0
- package/dist/core/item.js +49 -0
- package/dist/core/lease.js +31 -0
- package/dist/core/modules.js +318 -0
- package/dist/core/notify/planner.js +117 -0
- package/dist/core/notify/signals.js +66 -0
- package/dist/core/notify/text.js +60 -0
- package/dist/core/path-key.js +22 -0
- package/dist/core/placement.js +161 -0
- package/dist/core/preset-labels.js +66 -0
- package/dist/core/preset-notes.js +109 -0
- package/dist/core/preset.js +541 -0
- package/dist/core/profile.js +55 -0
- package/dist/core/project-id.js +20 -0
- package/dist/core/refusal.js +1 -0
- package/dist/core/relations.js +208 -0
- package/dist/core/repo.js +54 -0
- package/dist/core/samples.js +161 -0
- package/dist/core/search-words.js +68 -0
- package/dist/core/test-report.js +120 -0
- package/dist/core/time.js +8 -0
- package/dist/core/validation.js +60 -0
- package/dist/core/views.js +171 -0
- package/dist/core/workflow.js +51 -0
- package/dist/mcp/commands.js +101 -0
- package/dist/mcp/server.js +239 -0
- package/dist/mcp/words.js +95 -0
- package/dist/server/boards.js +232 -0
- package/dist/server/changes.js +42 -0
- package/dist/server/diff-tip.js +83 -0
- package/dist/server/drift.js +87 -0
- package/dist/server/errors.js +87 -0
- package/dist/server/evidence.js +82 -0
- package/dist/server/hosts.js +6 -0
- package/dist/server/hub.js +98 -0
- package/dist/server/lan-access.js +62 -0
- package/dist/server/lan.js +164 -0
- package/dist/server/listen.js +70 -0
- package/dist/server/notifier.js +156 -0
- package/dist/server/notify-api.js +151 -0
- package/dist/server/pairing.js +124 -0
- package/dist/server/projects.js +191 -0
- package/dist/server/push.js +199 -0
- package/dist/server/server.js +960 -0
- package/dist/server/session.js +43 -0
- package/dist/server/stream.js +36 -0
- package/dist/server/test-push.js +38 -0
- package/dist/server/token.js +37 -0
- package/dist/server/transports.js +54 -0
- package/dist/server/ui.js +44 -0
- package/dist/server/writes.js +361 -0
- package/dist/server/wrong-address.js +36 -0
- package/dist/store/boards.js +111 -0
- package/dist/store/database.js +45 -0
- package/dist/store/machine.js +77 -0
- package/dist/store/migrations.js +493 -0
- package/dist/store/queries.js +585 -0
- package/dist/store/registry.js +72 -0
- package/package.json +73 -4
- package/presets/architecture/playbook.md +69 -0
- package/presets/architecture/preset.yaml +80 -0
- package/presets/architecture/samples.yaml +23 -0
- package/presets/bug-triage/playbook.md +129 -0
- package/presets/bug-triage/preset.yaml +127 -0
- package/presets/bug-triage/samples/wall-slide-after.png +0 -0
- package/presets/bug-triage/samples/wall-slide-before.png +0 -0
- package/presets/bug-triage/samples.yaml +72 -0
- package/presets/change/playbook.md +115 -0
- package/presets/change/preset.yaml +141 -0
- package/presets/change/samples.yaml +62 -0
- package/presets/review/playbook.md +51 -0
- package/presets/review/preset.yaml +62 -0
- package/presets/review/samples.yaml +27 -0
- package/presets/tasks/playbook.md +78 -0
- package/presets/tasks/preset.yaml +61 -0
- package/presets/tasks/samples.yaml +46 -0
- package/schemas/board.schema.json +764 -0
- package/ui/dist/THIRD_PARTY_NOTICES.md +114 -0
- package/ui/dist/assets/dm-mono-latin-400-normal--0xN8mdc.woff +0 -0
- package/ui/dist/assets/dm-mono-latin-400-normal-4GdczIuU.woff2 +0 -0
- package/ui/dist/assets/dm-mono-latin-500-normal-CN8Miw6E.woff +0 -0
- package/ui/dist/assets/dm-mono-latin-500-normal-DRMDZjhP.woff2 +0 -0
- package/ui/dist/assets/dm-mono-latin-ext-400-normal-1aZr6b2b.woff +0 -0
- package/ui/dist/assets/dm-mono-latin-ext-400-normal-C2zvOubV.woff2 +0 -0
- package/ui/dist/assets/dm-mono-latin-ext-500-normal-BtRyHRi6.woff2 +0 -0
- package/ui/dist/assets/dm-mono-latin-ext-500-normal-Dw3M13d8.woff +0 -0
- package/ui/dist/assets/index-C3OzJope.js +103 -0
- package/ui/dist/assets/index-COdEjckQ.css +1 -0
- package/ui/dist/assets/newsreader-latin-ext-opsz-italic-CSPGnFdO.woff2 +0 -0
- package/ui/dist/assets/newsreader-latin-ext-opsz-normal-BQn1nviT.woff2 +0 -0
- package/ui/dist/assets/newsreader-latin-opsz-italic-kJKFiXvB.woff2 +0 -0
- package/ui/dist/assets/newsreader-latin-opsz-normal-s-izfB6B.woff2 +0 -0
- package/ui/dist/assets/newsreader-vietnamese-opsz-italic-DTr-ymY4.woff2 +0 -0
- package/ui/dist/assets/newsreader-vietnamese-opsz-normal-BjhtXyW2.woff2 +0 -0
- package/ui/dist/assets/pdf-YwugTw7Y.js +54 -0
- package/ui/dist/assets/pdf-engine-CkBopwck.js +1 -0
- package/ui/dist/assets/pdf-rELvHkft.js +56 -0
- package/ui/dist/assets/pdf.worker.min-B5Yc7dP4.mjs +27 -0
- package/ui/dist/assets/pdf.worker.min-B7U8ptvh.js +1 -0
- package/ui/dist/assets/pdf.worker.min-CIqJB0yW.mjs +28 -0
- package/ui/dist/assets/pdf.worker.min-UqOn5EDC.js +1 -0
- package/ui/dist/assets/schibsted-grotesk-latin-ext-wght-normal-hsMS0n0O.woff2 +0 -0
- package/ui/dist/assets/schibsted-grotesk-latin-wght-normal-Bb8VGrTG.woff2 +0 -0
- package/ui/dist/icons/apple-touch-icon.png +0 -0
- package/ui/dist/icons/otea-192.png +0 -0
- package/ui/dist/icons/otea-512.png +0 -0
- package/ui/dist/icons/otea-badge.png +0 -0
- package/ui/dist/icons/otea-maskable-512.png +0 -0
- package/ui/dist/index.html +25 -0
- package/ui/dist/manifest.webmanifest +24 -0
- package/ui/dist/otea-idle.svg +5 -0
- package/ui/dist/otea-working.svg +5 -0
- package/ui/dist/otea-yours-working.svg +5 -0
- package/ui/dist/otea-yours.svg +5 -0
- package/ui/dist/sw.js +1 -0
|
@@ -0,0 +1,764 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"type": "object",
|
|
4
|
+
"properties": {
|
|
5
|
+
"schema": {
|
|
6
|
+
"anyOf": [
|
|
7
|
+
{
|
|
8
|
+
"type": "number",
|
|
9
|
+
"const": 1
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"type": "number",
|
|
13
|
+
"const": 2
|
|
14
|
+
}
|
|
15
|
+
],
|
|
16
|
+
"description": "The version of the board format: write 2",
|
|
17
|
+
"examples": [2]
|
|
18
|
+
},
|
|
19
|
+
"name": {
|
|
20
|
+
"type": "string",
|
|
21
|
+
"description": "The name of the board",
|
|
22
|
+
"examples": ["Bugs"]
|
|
23
|
+
},
|
|
24
|
+
"item": {
|
|
25
|
+
"type": "string",
|
|
26
|
+
"description": "What one item of the board is called",
|
|
27
|
+
"examples": ["Bug"]
|
|
28
|
+
},
|
|
29
|
+
"icon": {
|
|
30
|
+
"type": "string",
|
|
31
|
+
"description": "The icon of the board and its items, one of: layers, checkbox, list, stack, inbox, flag, milestone, target, rocket, clipboard, calendar, clock, hourglass, checklist, briefcase, chart, bug, git-branch, git-merge, terminal, code, brackets, database, server, plug, cpu, package, gear, wrench, shield, lock, key, cloud, browser, mobile, test-tube, gauge, image, film, camera, play, music, palette, brush, pen, ruler, shapes, eye, frame, sparkle, pen-nib, layout, type, cube, book, doc, note, chat-bubble, question, lightbulb, megaphone, bookmark, quote, link, mail, diagram, compare, paw, feather, bone, egg, fish, bird, leaf, sprout, tree, mountain, flame, drop, moon, sun, crystal, sword, shieldcrest, potion, map, compass, dice, controller, heart, star, skull, crown, ghost, puzzle, beaker, magnet, bolt, anchor, hook, trophy, gift, tag, pin, globe, home, user, users, robot, cart, coins, building",
|
|
32
|
+
"examples": ["bug"]
|
|
33
|
+
},
|
|
34
|
+
"title": {
|
|
35
|
+
"type": "string",
|
|
36
|
+
"description": "The name of the title field every item has",
|
|
37
|
+
"examples": ["Title"]
|
|
38
|
+
},
|
|
39
|
+
"parts": {
|
|
40
|
+
"type": "object",
|
|
41
|
+
"propertyNames": {
|
|
42
|
+
"type": "string",
|
|
43
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
44
|
+
},
|
|
45
|
+
"additionalProperties": {
|
|
46
|
+
"type": "object",
|
|
47
|
+
"properties": {
|
|
48
|
+
"id": {
|
|
49
|
+
"type": "string",
|
|
50
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
51
|
+
"description": "The hidden id of the part: its key in parts",
|
|
52
|
+
"examples": ["fsteps"]
|
|
53
|
+
},
|
|
54
|
+
"name": {
|
|
55
|
+
"type": "string",
|
|
56
|
+
"description": "What the field or evidence is called",
|
|
57
|
+
"examples": ["Steps to reproduce"]
|
|
58
|
+
},
|
|
59
|
+
"kind": {
|
|
60
|
+
"type": "string",
|
|
61
|
+
"enum": [
|
|
62
|
+
"text",
|
|
63
|
+
"long",
|
|
64
|
+
"check",
|
|
65
|
+
"choice",
|
|
66
|
+
"multi",
|
|
67
|
+
"level",
|
|
68
|
+
"number",
|
|
69
|
+
"date",
|
|
70
|
+
"yesno",
|
|
71
|
+
"url",
|
|
72
|
+
"branch",
|
|
73
|
+
"images",
|
|
74
|
+
"video",
|
|
75
|
+
"audio",
|
|
76
|
+
"code",
|
|
77
|
+
"log",
|
|
78
|
+
"diagram",
|
|
79
|
+
"file"
|
|
80
|
+
],
|
|
81
|
+
"description": "A field (text, long, check, choice, multi, level, number, date, yesno, url, branch) or evidence (images, video, audio, code, log, diagram, file)",
|
|
82
|
+
"examples": ["long", "images"]
|
|
83
|
+
},
|
|
84
|
+
"hint": {
|
|
85
|
+
"type": "string",
|
|
86
|
+
"description": "What goes here: the line agents read",
|
|
87
|
+
"examples": ["The commands that show the bug", ""]
|
|
88
|
+
},
|
|
89
|
+
"options": {
|
|
90
|
+
"type": "array",
|
|
91
|
+
"items": {
|
|
92
|
+
"type": "object",
|
|
93
|
+
"properties": {
|
|
94
|
+
"id": {
|
|
95
|
+
"type": "string",
|
|
96
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
97
|
+
"description": "The hidden id of the choice",
|
|
98
|
+
"examples": ["chigh"]
|
|
99
|
+
},
|
|
100
|
+
"name": {
|
|
101
|
+
"type": "string",
|
|
102
|
+
"description": "What the choice reads",
|
|
103
|
+
"examples": ["High"]
|
|
104
|
+
}
|
|
105
|
+
},
|
|
106
|
+
"required": ["id", "name"],
|
|
107
|
+
"additionalProperties": false,
|
|
108
|
+
"description": "A choice of the field",
|
|
109
|
+
"examples": [
|
|
110
|
+
{
|
|
111
|
+
"id": "chigh",
|
|
112
|
+
"name": "High"
|
|
113
|
+
}
|
|
114
|
+
]
|
|
115
|
+
},
|
|
116
|
+
"description": "The choices of a choice, multi or check field; empty for any other kind",
|
|
117
|
+
"examples": [
|
|
118
|
+
[
|
|
119
|
+
{
|
|
120
|
+
"id": "chigh",
|
|
121
|
+
"name": "High"
|
|
122
|
+
}
|
|
123
|
+
],
|
|
124
|
+
[]
|
|
125
|
+
]
|
|
126
|
+
},
|
|
127
|
+
"show": {
|
|
128
|
+
"type": "string",
|
|
129
|
+
"description": "How evidence shows: images as gallery, one or ba; video as strip or player",
|
|
130
|
+
"examples": ["gallery"]
|
|
131
|
+
},
|
|
132
|
+
"initial": {
|
|
133
|
+
"type": "string",
|
|
134
|
+
"description": "The value a new item starts with: a choice id, a level (low, medium, high, critical), yes or no",
|
|
135
|
+
"examples": ["chigh"]
|
|
136
|
+
},
|
|
137
|
+
"guard": {
|
|
138
|
+
"type": "object",
|
|
139
|
+
"properties": {
|
|
140
|
+
"push": {
|
|
141
|
+
"type": "array",
|
|
142
|
+
"items": {
|
|
143
|
+
"type": "string",
|
|
144
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
145
|
+
},
|
|
146
|
+
"description": "The steps (ids) during which the branch may be pushed",
|
|
147
|
+
"examples": [["simplement"]]
|
|
148
|
+
},
|
|
149
|
+
"repo": {
|
|
150
|
+
"type": "string",
|
|
151
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
152
|
+
"description": "The field (part id) the repository is read from",
|
|
153
|
+
"examples": ["frepo"]
|
|
154
|
+
},
|
|
155
|
+
"base": {
|
|
156
|
+
"type": "string",
|
|
157
|
+
"description": "The base branch Otea protects too: agents push or merge into it only to bring in an item that is Done",
|
|
158
|
+
"examples": ["main"]
|
|
159
|
+
}
|
|
160
|
+
},
|
|
161
|
+
"required": ["push"],
|
|
162
|
+
"additionalProperties": false,
|
|
163
|
+
"description": "A branch field only: Otea protects the branch",
|
|
164
|
+
"examples": [
|
|
165
|
+
{
|
|
166
|
+
"push": ["simplement"],
|
|
167
|
+
"repo": "frepo",
|
|
168
|
+
"base": "main"
|
|
169
|
+
}
|
|
170
|
+
]
|
|
171
|
+
},
|
|
172
|
+
"proof": {
|
|
173
|
+
"type": "boolean",
|
|
174
|
+
"description": "A checklist only (\"pide prueba\"): each ticked point needs a proof in the round (an attached file, a line of an attached log, or a test that passes in an attached report) before the step that hands it is handed off",
|
|
175
|
+
"examples": [true]
|
|
176
|
+
}
|
|
177
|
+
},
|
|
178
|
+
"required": ["id", "name", "kind", "hint", "options"],
|
|
179
|
+
"additionalProperties": false,
|
|
180
|
+
"description": "A field (something to fill) or a piece of evidence (something to show)",
|
|
181
|
+
"examples": [
|
|
182
|
+
{
|
|
183
|
+
"id": "fsteps",
|
|
184
|
+
"name": "Steps to reproduce",
|
|
185
|
+
"kind": "long",
|
|
186
|
+
"hint": "",
|
|
187
|
+
"options": []
|
|
188
|
+
}
|
|
189
|
+
]
|
|
190
|
+
},
|
|
191
|
+
"description": "The fields and evidence of the board, by id",
|
|
192
|
+
"examples": [
|
|
193
|
+
{
|
|
194
|
+
"fsteps": {
|
|
195
|
+
"id": "fsteps",
|
|
196
|
+
"name": "Steps to reproduce",
|
|
197
|
+
"kind": "long",
|
|
198
|
+
"hint": "",
|
|
199
|
+
"options": []
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
]
|
|
203
|
+
},
|
|
204
|
+
"form": {
|
|
205
|
+
"type": "array",
|
|
206
|
+
"items": {
|
|
207
|
+
"type": "object",
|
|
208
|
+
"properties": {
|
|
209
|
+
"ref": {
|
|
210
|
+
"type": "string",
|
|
211
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
212
|
+
"description": "A field (id) the creation form asks for",
|
|
213
|
+
"examples": ["fsteps"]
|
|
214
|
+
},
|
|
215
|
+
"required": {
|
|
216
|
+
"type": "boolean",
|
|
217
|
+
"description": "Whether the form requires it",
|
|
218
|
+
"examples": [true]
|
|
219
|
+
}
|
|
220
|
+
},
|
|
221
|
+
"required": ["ref", "required"],
|
|
222
|
+
"additionalProperties": false,
|
|
223
|
+
"description": "A field of the creation form",
|
|
224
|
+
"examples": [
|
|
225
|
+
{
|
|
226
|
+
"ref": "fsteps",
|
|
227
|
+
"required": true
|
|
228
|
+
}
|
|
229
|
+
]
|
|
230
|
+
},
|
|
231
|
+
"description": "The creation form besides the title, in order",
|
|
232
|
+
"examples": [
|
|
233
|
+
[
|
|
234
|
+
{
|
|
235
|
+
"ref": "fsteps",
|
|
236
|
+
"required": true
|
|
237
|
+
}
|
|
238
|
+
]
|
|
239
|
+
]
|
|
240
|
+
},
|
|
241
|
+
"steps": {
|
|
242
|
+
"type": "array",
|
|
243
|
+
"items": {
|
|
244
|
+
"type": "object",
|
|
245
|
+
"properties": {
|
|
246
|
+
"id": {
|
|
247
|
+
"type": "string",
|
|
248
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
249
|
+
"description": "The hidden id of the step",
|
|
250
|
+
"examples": ["sfix"]
|
|
251
|
+
},
|
|
252
|
+
"name": {
|
|
253
|
+
"type": "string",
|
|
254
|
+
"description": "What the step is called",
|
|
255
|
+
"examples": ["Fix"]
|
|
256
|
+
},
|
|
257
|
+
"doer": {
|
|
258
|
+
"type": "string",
|
|
259
|
+
"enum": ["you", "any"],
|
|
260
|
+
"description": "Who does the step: \"you\" (the person) or \"any\" agent",
|
|
261
|
+
"examples": ["any", "you"]
|
|
262
|
+
},
|
|
263
|
+
"reviewer": {
|
|
264
|
+
"type": "string",
|
|
265
|
+
"enum": ["none", "you", "any"],
|
|
266
|
+
"description": "Who reviews the step: \"none\", \"you\" (the person) or \"any\" agent, never the one that did it in that round",
|
|
267
|
+
"examples": ["you", "any"]
|
|
268
|
+
},
|
|
269
|
+
"hand": {
|
|
270
|
+
"type": "array",
|
|
271
|
+
"items": {
|
|
272
|
+
"type": "object",
|
|
273
|
+
"properties": {
|
|
274
|
+
"ref": {
|
|
275
|
+
"type": "string",
|
|
276
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
277
|
+
"description": "The part (id) the step hands off, or title",
|
|
278
|
+
"examples": ["fsteps"]
|
|
279
|
+
},
|
|
280
|
+
"req": {
|
|
281
|
+
"type": "string",
|
|
282
|
+
"enum": ["always", "when", "no"],
|
|
283
|
+
"description": "Whether it is required: always, only when another part has a value, or no",
|
|
284
|
+
"examples": ["always"]
|
|
285
|
+
},
|
|
286
|
+
"when": {
|
|
287
|
+
"type": "object",
|
|
288
|
+
"properties": {
|
|
289
|
+
"part": {
|
|
290
|
+
"type": "string",
|
|
291
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
292
|
+
"description": "The choice, multi, level or yesno part (id) it reads",
|
|
293
|
+
"examples": ["fseverity"]
|
|
294
|
+
},
|
|
295
|
+
"value": {
|
|
296
|
+
"type": "string",
|
|
297
|
+
"description": "The value that makes it required: a choice id, a level, yes or no",
|
|
298
|
+
"examples": ["high"]
|
|
299
|
+
}
|
|
300
|
+
},
|
|
301
|
+
"required": ["part", "value"],
|
|
302
|
+
"additionalProperties": false,
|
|
303
|
+
"description": "With req \"when\": which part and value make it required",
|
|
304
|
+
"examples": [
|
|
305
|
+
{
|
|
306
|
+
"part": "fseverity",
|
|
307
|
+
"value": "high"
|
|
308
|
+
}
|
|
309
|
+
]
|
|
310
|
+
},
|
|
311
|
+
"fresh": {
|
|
312
|
+
"type": "boolean",
|
|
313
|
+
"description": "Evidence only: new in each round, so a send-back empties it",
|
|
314
|
+
"examples": [false]
|
|
315
|
+
}
|
|
316
|
+
},
|
|
317
|
+
"required": ["ref", "req", "fresh"],
|
|
318
|
+
"additionalProperties": false,
|
|
319
|
+
"description": "One thing the step hands off",
|
|
320
|
+
"examples": [
|
|
321
|
+
{
|
|
322
|
+
"ref": "fsteps",
|
|
323
|
+
"req": "always",
|
|
324
|
+
"fresh": false
|
|
325
|
+
}
|
|
326
|
+
]
|
|
327
|
+
},
|
|
328
|
+
"description": "What the step hands off",
|
|
329
|
+
"examples": [
|
|
330
|
+
[
|
|
331
|
+
{
|
|
332
|
+
"ref": "fsteps",
|
|
333
|
+
"req": "always",
|
|
334
|
+
"fresh": false
|
|
335
|
+
}
|
|
336
|
+
]
|
|
337
|
+
]
|
|
338
|
+
},
|
|
339
|
+
"ways": {
|
|
340
|
+
"type": "array",
|
|
341
|
+
"items": {
|
|
342
|
+
"type": "string",
|
|
343
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
344
|
+
},
|
|
345
|
+
"description": "Ways out besides the next step: a later step (id) or done, or an earlier step to take the item back to",
|
|
346
|
+
"examples": [["done"], []]
|
|
347
|
+
},
|
|
348
|
+
"back": {
|
|
349
|
+
"type": "string",
|
|
350
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
351
|
+
"description": "Where a send-back lands: same (this step) or an earlier step id",
|
|
352
|
+
"examples": ["same"]
|
|
353
|
+
},
|
|
354
|
+
"instructions": {
|
|
355
|
+
"type": "object",
|
|
356
|
+
"properties": {
|
|
357
|
+
"take": {
|
|
358
|
+
"type": "string",
|
|
359
|
+
"description": "What an agent reads when it takes the step",
|
|
360
|
+
"examples": ["Reproduce it first."]
|
|
361
|
+
},
|
|
362
|
+
"before": {
|
|
363
|
+
"type": "string",
|
|
364
|
+
"description": "What an agent reads before it hands the step off",
|
|
365
|
+
"examples": ["Run the tests."]
|
|
366
|
+
},
|
|
367
|
+
"review": {
|
|
368
|
+
"type": "string",
|
|
369
|
+
"description": "What an agent reviewing the step reads",
|
|
370
|
+
"examples": ["Check the test fails first."]
|
|
371
|
+
}
|
|
372
|
+
},
|
|
373
|
+
"required": ["take", "before", "review"],
|
|
374
|
+
"additionalProperties": false,
|
|
375
|
+
"description": "The instructions agents read on the step; mention a step or part as @[id], its id, which agents read as its name",
|
|
376
|
+
"examples": [
|
|
377
|
+
{
|
|
378
|
+
"take": "Reproduce it first.",
|
|
379
|
+
"before": "Run the tests.",
|
|
380
|
+
"review": ""
|
|
381
|
+
}
|
|
382
|
+
]
|
|
383
|
+
},
|
|
384
|
+
"note": {
|
|
385
|
+
"default": {
|
|
386
|
+
"req": "no",
|
|
387
|
+
"hint": ""
|
|
388
|
+
},
|
|
389
|
+
"description": "The note the doer writes with each handoff",
|
|
390
|
+
"examples": [
|
|
391
|
+
{
|
|
392
|
+
"req": "no",
|
|
393
|
+
"hint": ""
|
|
394
|
+
}
|
|
395
|
+
],
|
|
396
|
+
"type": "object",
|
|
397
|
+
"properties": {
|
|
398
|
+
"req": {
|
|
399
|
+
"type": "string",
|
|
400
|
+
"enum": ["no", "always"],
|
|
401
|
+
"description": "Whether each handoff needs a note",
|
|
402
|
+
"examples": ["always"]
|
|
403
|
+
},
|
|
404
|
+
"hint": {
|
|
405
|
+
"type": "string",
|
|
406
|
+
"description": "What goes in the note",
|
|
407
|
+
"examples": ["What you ran and what you saw"]
|
|
408
|
+
}
|
|
409
|
+
},
|
|
410
|
+
"required": ["req", "hint"],
|
|
411
|
+
"additionalProperties": false
|
|
412
|
+
},
|
|
413
|
+
"waits": {
|
|
414
|
+
"default": [],
|
|
415
|
+
"description": "What the step waits for before it is handed off: its parts closed, its blockers closed",
|
|
416
|
+
"examples": [["blockers"], []],
|
|
417
|
+
"type": "array",
|
|
418
|
+
"items": {
|
|
419
|
+
"type": "string",
|
|
420
|
+
"enum": ["parts", "blockers"]
|
|
421
|
+
}
|
|
422
|
+
},
|
|
423
|
+
"skipWhenReady": {
|
|
424
|
+
"default": false,
|
|
425
|
+
"type": "boolean",
|
|
426
|
+
"description": "First step nobody reviews only: an item created with all it hands off starts at the next step",
|
|
427
|
+
"examples": [false]
|
|
428
|
+
},
|
|
429
|
+
"doerMayDrop": {
|
|
430
|
+
"default": false,
|
|
431
|
+
"type": "boolean",
|
|
432
|
+
"description": "Whether an agent doing it may drop the item, saying why",
|
|
433
|
+
"examples": [false]
|
|
434
|
+
},
|
|
435
|
+
"lead": {
|
|
436
|
+
"type": "object",
|
|
437
|
+
"properties": {
|
|
438
|
+
"to": {
|
|
439
|
+
"type": "string",
|
|
440
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
441
|
+
"description": "Where it leads instead of the next step: a later step id or done",
|
|
442
|
+
"examples": ["done"]
|
|
443
|
+
},
|
|
444
|
+
"when": {
|
|
445
|
+
"type": "object",
|
|
446
|
+
"properties": {
|
|
447
|
+
"part": {
|
|
448
|
+
"type": "string",
|
|
449
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
450
|
+
"description": "The choice, multi, level or yesno part (id) it reads",
|
|
451
|
+
"examples": ["fmine"]
|
|
452
|
+
},
|
|
453
|
+
"value": {
|
|
454
|
+
"type": "string",
|
|
455
|
+
"description": "The value that makes it lead there: a choice id, a level, yes or no",
|
|
456
|
+
"examples": ["yes"]
|
|
457
|
+
}
|
|
458
|
+
},
|
|
459
|
+
"required": ["part", "value"],
|
|
460
|
+
"additionalProperties": false,
|
|
461
|
+
"description": "Which part and value make it lead there",
|
|
462
|
+
"examples": [
|
|
463
|
+
{
|
|
464
|
+
"part": "fmine",
|
|
465
|
+
"value": "yes"
|
|
466
|
+
}
|
|
467
|
+
]
|
|
468
|
+
}
|
|
469
|
+
},
|
|
470
|
+
"required": ["to", "when"],
|
|
471
|
+
"additionalProperties": false,
|
|
472
|
+
"description": "While a part holds a value, the way the step takes instead of the next step; the next step is then a way only if ways lists it",
|
|
473
|
+
"examples": [
|
|
474
|
+
{
|
|
475
|
+
"to": "done",
|
|
476
|
+
"when": {
|
|
477
|
+
"part": "fmine",
|
|
478
|
+
"value": "yes"
|
|
479
|
+
}
|
|
480
|
+
}
|
|
481
|
+
]
|
|
482
|
+
}
|
|
483
|
+
},
|
|
484
|
+
"required": ["id", "name", "doer", "reviewer", "hand", "ways", "back", "instructions"],
|
|
485
|
+
"additionalProperties": false,
|
|
486
|
+
"description": "A step of the board, in order",
|
|
487
|
+
"examples": []
|
|
488
|
+
},
|
|
489
|
+
"description": "The steps, in order: the default way out of each is the next one, and done after the last",
|
|
490
|
+
"examples": []
|
|
491
|
+
},
|
|
492
|
+
"anytime": {
|
|
493
|
+
"type": "array",
|
|
494
|
+
"items": {
|
|
495
|
+
"type": "string",
|
|
496
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
497
|
+
},
|
|
498
|
+
"description": "Parts (ids) that can be filled at any step",
|
|
499
|
+
"examples": [["fbranch"], []]
|
|
500
|
+
},
|
|
501
|
+
"layout": {
|
|
502
|
+
"type": "object",
|
|
503
|
+
"propertyNames": {
|
|
504
|
+
"type": "string",
|
|
505
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
506
|
+
},
|
|
507
|
+
"additionalProperties": {
|
|
508
|
+
"type": "string",
|
|
509
|
+
"enum": ["top", "main", "side", "hidden"]
|
|
510
|
+
},
|
|
511
|
+
"description": "Where each part (or rounds, or parts) shows on the item page: top, main, side, hidden",
|
|
512
|
+
"examples": [
|
|
513
|
+
{
|
|
514
|
+
"fsteps": "main",
|
|
515
|
+
"rounds": "side"
|
|
516
|
+
}
|
|
517
|
+
]
|
|
518
|
+
},
|
|
519
|
+
"row": {
|
|
520
|
+
"type": "array",
|
|
521
|
+
"items": {
|
|
522
|
+
"type": "string",
|
|
523
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
524
|
+
},
|
|
525
|
+
"description": "The parts (ids) the list row shows, in order",
|
|
526
|
+
"examples": [["fseverity"], []]
|
|
527
|
+
},
|
|
528
|
+
"about": {
|
|
529
|
+
"type": "string",
|
|
530
|
+
"description": "About this board: what it is for",
|
|
531
|
+
"examples": ["Bugs found in the app, until fixed."]
|
|
532
|
+
},
|
|
533
|
+
"idle": {
|
|
534
|
+
"type": "string",
|
|
535
|
+
"description": "What an agent does when the board has nothing for it",
|
|
536
|
+
"examples": ["Look for new bugs."]
|
|
537
|
+
},
|
|
538
|
+
"cap": {
|
|
539
|
+
"type": "object",
|
|
540
|
+
"properties": {
|
|
541
|
+
"on": {
|
|
542
|
+
"type": "boolean",
|
|
543
|
+
"description": "Whether agents add items only while few wait for the person",
|
|
544
|
+
"examples": [false]
|
|
545
|
+
},
|
|
546
|
+
"n": {
|
|
547
|
+
"type": "number",
|
|
548
|
+
"description": "How many may wait for the person",
|
|
549
|
+
"examples": [3]
|
|
550
|
+
}
|
|
551
|
+
},
|
|
552
|
+
"required": ["on", "n"],
|
|
553
|
+
"additionalProperties": false,
|
|
554
|
+
"description": "The cap on the items agents add",
|
|
555
|
+
"examples": [
|
|
556
|
+
{
|
|
557
|
+
"on": false,
|
|
558
|
+
"n": 3
|
|
559
|
+
}
|
|
560
|
+
]
|
|
561
|
+
},
|
|
562
|
+
"samples": {
|
|
563
|
+
"type": "array",
|
|
564
|
+
"items": {
|
|
565
|
+
"type": "string"
|
|
566
|
+
},
|
|
567
|
+
"description": "Titles of the sample items previews draw",
|
|
568
|
+
"examples": [["Login fails on Safari"], []]
|
|
569
|
+
},
|
|
570
|
+
"template": {
|
|
571
|
+
"type": "string",
|
|
572
|
+
"description": "The template it was copied from, for the record",
|
|
573
|
+
"examples": ["bugs"]
|
|
574
|
+
},
|
|
575
|
+
"split": {
|
|
576
|
+
"type": "object",
|
|
577
|
+
"properties": {
|
|
578
|
+
"board": {
|
|
579
|
+
"type": "string",
|
|
580
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
581
|
+
"description": "The board (hidden id) its items divide into, or same",
|
|
582
|
+
"examples": ["same"]
|
|
583
|
+
},
|
|
584
|
+
"always": {
|
|
585
|
+
"type": "boolean",
|
|
586
|
+
"description": "Whether a part is never created alone",
|
|
587
|
+
"examples": [false]
|
|
588
|
+
}
|
|
589
|
+
},
|
|
590
|
+
"required": ["board", "always"],
|
|
591
|
+
"additionalProperties": false,
|
|
592
|
+
"description": "\"Se divide en\": the board each item divides into",
|
|
593
|
+
"examples": [
|
|
594
|
+
{
|
|
595
|
+
"board": "same",
|
|
596
|
+
"always": false
|
|
597
|
+
}
|
|
598
|
+
]
|
|
599
|
+
},
|
|
600
|
+
"madeWith": {
|
|
601
|
+
"type": "array",
|
|
602
|
+
"items": {
|
|
603
|
+
"type": "string",
|
|
604
|
+
"pattern": "^[a-z][a-z0-9_]*$"
|
|
605
|
+
},
|
|
606
|
+
"description": "The boards (hidden ids) a template made with this one",
|
|
607
|
+
"examples": [["bbugs"]]
|
|
608
|
+
},
|
|
609
|
+
"analysis": {
|
|
610
|
+
"type": "object",
|
|
611
|
+
"properties": {
|
|
612
|
+
"effort": {
|
|
613
|
+
"type": "string",
|
|
614
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
615
|
+
"description": "The field (part id) that says how much work an item is",
|
|
616
|
+
"examples": ["feffort"]
|
|
617
|
+
},
|
|
618
|
+
"risk": {
|
|
619
|
+
"type": "string",
|
|
620
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
621
|
+
"description": "The field (part id) that says how risky an item is to do",
|
|
622
|
+
"examples": ["frisk"]
|
|
623
|
+
},
|
|
624
|
+
"impact": {
|
|
625
|
+
"type": "string",
|
|
626
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
627
|
+
"description": "The field (part id) that says how much an item matters",
|
|
628
|
+
"examples": ["fseverity"]
|
|
629
|
+
},
|
|
630
|
+
"area": {
|
|
631
|
+
"type": "string",
|
|
632
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
633
|
+
"description": "The field (part id) that says where an item belongs",
|
|
634
|
+
"examples": ["farea"]
|
|
635
|
+
},
|
|
636
|
+
"due": {
|
|
637
|
+
"type": "string",
|
|
638
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
639
|
+
"description": "The date field (part id) an item is due by",
|
|
640
|
+
"examples": ["fdue"]
|
|
641
|
+
}
|
|
642
|
+
},
|
|
643
|
+
"additionalProperties": false,
|
|
644
|
+
"description": "Which field plays each role of the analysis views: effort, risk and impact read a level, a number or a choice (its options in order are the scale); area a choice, several or a short text; due a date. The matrix shows once two of effort, risk and impact are mapped",
|
|
645
|
+
"examples": [
|
|
646
|
+
{
|
|
647
|
+
"effort": "feffort",
|
|
648
|
+
"risk": "frisk",
|
|
649
|
+
"impact": "fseverity"
|
|
650
|
+
}
|
|
651
|
+
]
|
|
652
|
+
},
|
|
653
|
+
"drop": {
|
|
654
|
+
"default": {
|
|
655
|
+
"by": "anyone",
|
|
656
|
+
"motives": []
|
|
657
|
+
},
|
|
658
|
+
"description": "Who may drop an item, and the motives a drop names",
|
|
659
|
+
"examples": [
|
|
660
|
+
{
|
|
661
|
+
"by": "anyone",
|
|
662
|
+
"motives": []
|
|
663
|
+
}
|
|
664
|
+
],
|
|
665
|
+
"type": "object",
|
|
666
|
+
"properties": {
|
|
667
|
+
"by": {
|
|
668
|
+
"type": "string",
|
|
669
|
+
"enum": ["page", "anyone"],
|
|
670
|
+
"description": "Who may drop an item: only from its page, or anyone (an agent too, asked to)",
|
|
671
|
+
"examples": ["anyone"]
|
|
672
|
+
},
|
|
673
|
+
"motives": {
|
|
674
|
+
"type": "array",
|
|
675
|
+
"items": {
|
|
676
|
+
"type": "object",
|
|
677
|
+
"properties": {
|
|
678
|
+
"id": {
|
|
679
|
+
"type": "string",
|
|
680
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
681
|
+
"description": "The hidden id of the motive",
|
|
682
|
+
"examples": ["wont_fix"]
|
|
683
|
+
},
|
|
684
|
+
"name": {
|
|
685
|
+
"type": "string",
|
|
686
|
+
"description": "What the motive reads",
|
|
687
|
+
"examples": ["Won't fix"]
|
|
688
|
+
}
|
|
689
|
+
},
|
|
690
|
+
"required": ["id", "name"],
|
|
691
|
+
"additionalProperties": false,
|
|
692
|
+
"description": "A motive a drop names",
|
|
693
|
+
"examples": [
|
|
694
|
+
{
|
|
695
|
+
"id": "wont_fix",
|
|
696
|
+
"name": "Won't fix"
|
|
697
|
+
}
|
|
698
|
+
]
|
|
699
|
+
},
|
|
700
|
+
"description": "The motives a drop names",
|
|
701
|
+
"examples": [
|
|
702
|
+
[
|
|
703
|
+
{
|
|
704
|
+
"id": "duplicate",
|
|
705
|
+
"name": "Duplicate"
|
|
706
|
+
}
|
|
707
|
+
],
|
|
708
|
+
[]
|
|
709
|
+
]
|
|
710
|
+
}
|
|
711
|
+
},
|
|
712
|
+
"required": ["by", "motives"],
|
|
713
|
+
"additionalProperties": false
|
|
714
|
+
},
|
|
715
|
+
"list": {
|
|
716
|
+
"default": {
|
|
717
|
+
"as": "list"
|
|
718
|
+
},
|
|
719
|
+
"description": "How the published list shows its items",
|
|
720
|
+
"examples": [
|
|
721
|
+
{
|
|
722
|
+
"as": "list"
|
|
723
|
+
}
|
|
724
|
+
],
|
|
725
|
+
"type": "object",
|
|
726
|
+
"properties": {
|
|
727
|
+
"as": {
|
|
728
|
+
"type": "string",
|
|
729
|
+
"enum": ["list", "table"],
|
|
730
|
+
"description": "How the published list shows its items",
|
|
731
|
+
"examples": ["list"]
|
|
732
|
+
},
|
|
733
|
+
"group": {
|
|
734
|
+
"type": "string",
|
|
735
|
+
"pattern": "^[a-z][a-z0-9_]*$",
|
|
736
|
+
"description": "What it groups by: a choice, level or yesno part (id), step or motive",
|
|
737
|
+
"examples": ["step"]
|
|
738
|
+
}
|
|
739
|
+
},
|
|
740
|
+
"required": ["as"],
|
|
741
|
+
"additionalProperties": false
|
|
742
|
+
}
|
|
743
|
+
},
|
|
744
|
+
"required": [
|
|
745
|
+
"schema",
|
|
746
|
+
"name",
|
|
747
|
+
"item",
|
|
748
|
+
"icon",
|
|
749
|
+
"title",
|
|
750
|
+
"parts",
|
|
751
|
+
"form",
|
|
752
|
+
"steps",
|
|
753
|
+
"anytime",
|
|
754
|
+
"layout",
|
|
755
|
+
"row",
|
|
756
|
+
"about",
|
|
757
|
+
"idle",
|
|
758
|
+
"cap",
|
|
759
|
+
"samples"
|
|
760
|
+
],
|
|
761
|
+
"additionalProperties": false,
|
|
762
|
+
"title": "Otea board",
|
|
763
|
+
"description": "A board definition (board.json): what `otea board draft <id>` prints and `otea board draft <id> --file board.json` reads."
|
|
764
|
+
}
|