@olhapi/maestro-darwin-x64 0.1.0 → 0.1.2
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/README.md +14 -5
- package/lib/maestro +0 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@ Docs: [maestro.olhapi.com/docs](https://maestro.olhapi.com/docs)
|
|
|
8
8
|
|
|
9
9
|
It combines a SQLite-backed tracker, an orchestrator that reads `WORKFLOW.md`, a private MCP daemon bridged by `maestro mcp`, and an HTTP server that serves the embedded dashboard plus JSON/WebSocket APIs.
|
|
10
10
|
|
|
11
|
-
Maestro stays local-first
|
|
11
|
+
Maestro stays local-first. External work is translated into Maestro projects and issues through the CLI, the embedded dashboard, or MCP prompts, then supervised through the same local queue, runtime state, MCP tools, and dashboard surfaces.
|
|
12
12
|
|
|
13
13
|
## Docs Website
|
|
14
14
|
|
|
@@ -106,7 +106,14 @@ maestro issue create "Fix auth bug" --project <project_id> --priority 1 --labels
|
|
|
106
106
|
maestro issue move ISS-1 ready
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
Projects
|
|
109
|
+
Projects use the local tracker only.
|
|
110
|
+
|
|
111
|
+
If you need to import work from another system, ask your MCP-capable agent to translate it into Maestro records. For example:
|
|
112
|
+
|
|
113
|
+
```text
|
|
114
|
+
Take my Jira issues from the "make a react todo app" epic and create the corresponding Maestro project, epics, and issues.
|
|
115
|
+
Use the current repo as the project repo path, keep the issues local, and mark the imported work ready.
|
|
116
|
+
```
|
|
110
117
|
|
|
111
118
|
Project descriptions are not just dashboard notes. Maestro passes `project.description` into every implementation, review, and done prompt by default, so use it for standing requirements, conventions, and validation expectations Codex should keep in mind for every issue.
|
|
112
119
|
|
|
@@ -158,6 +165,8 @@ If you built Maestro from source and did not add it to your `PATH`, replace `mae
|
|
|
158
165
|
|
|
159
166
|
`maestro mcp` is a stdio bridge into the live `maestro run` daemon for the same database. Start `maestro run` first, then let your coding agent invoke `maestro mcp`.
|
|
160
167
|
|
|
168
|
+
Paginated MCP list tools return a `pagination` object when more results remain. When `pagination.has_more` is true, call the exact `pagination.next_request` payload to fetch the next batch instead of guessing the next offset by hand.
|
|
169
|
+
|
|
161
170
|
### 5. Open the dashboard or use live CLI helpers
|
|
162
171
|
|
|
163
172
|
By default, `maestro run` serves:
|
|
@@ -184,7 +193,7 @@ maestro project stop <project_id> --api-url http://127.0.0.1:8787
|
|
|
184
193
|
|
|
185
194
|
`maestro run` is the long-lived process for a given database. It starts:
|
|
186
195
|
|
|
187
|
-
- the
|
|
196
|
+
- the local issue service and SQLite-backed store
|
|
188
197
|
- the orchestrator and agent runner
|
|
189
198
|
- a private MCP daemon used by `maestro mcp`
|
|
190
199
|
- the public HTTP server when `--port` is set or left at its default
|
|
@@ -224,7 +233,7 @@ maestro issue images list ISS-1
|
|
|
224
233
|
maestro issue images remove ISS-1 <image_id>
|
|
225
234
|
```
|
|
226
235
|
|
|
227
|
-
Image attachments are local-only
|
|
236
|
+
Image attachments are local-only for every issue. Maestro accepts PNG, JPEG, WEBP, and GIF files up to 10 MiB each and serves them back through the local HTTP API and dashboard.
|
|
228
237
|
|
|
229
238
|
Recurring automation:
|
|
230
239
|
|
|
@@ -292,7 +301,7 @@ Supported prompt-template variables are:
|
|
|
292
301
|
- `{{ attempt }}`
|
|
293
302
|
|
|
294
303
|
When a project has a description, Maestro's default implementation, review, and done prompts include it automatically under a `Project context:` section. Custom workflows can place `{{ project.description }}` wherever they want.
|
|
295
|
-
The default done prompt
|
|
304
|
+
The default done prompt now focuses on merge-back, PR readiness, and blocker reporting instead of asking for a preview artifact.
|
|
296
305
|
|
|
297
306
|
The checked-in [`WORKFLOW.md`](WORKFLOW.md) is this repository's own workflow example. It is not guaranteed to match fresh `workflow init` defaults exactly.
|
|
298
307
|
|
package/lib/maestro
CHANGED
|
Binary file
|