@ordewell/cli 0.10.12 → 0.11.0

package/AUTHORS.md

@@ -0,0 +1,37 @@
+# Authors
+
+Ordewell is copyright 2026 Alessandro Costanzo Ciano and the Ordewell
+contributors, and is released under the Apache License 2.0 (see [LICENSE](LICENSE)).
+
+This repository starts from a single commit. The project was developed over a
+longer private history, and that history is not published — so this file is the
+record of who built what, rather than `git log`.
+
+## Author and maintainer
+
+- **Alessandro Costanzo Ciano** ([@ac-ciano](https://github.com/ac-ciano)) —
+  author, maintainer and copyright owner. Wrote the core, the planner, the
+  orchestrator, the verification engine, the VS Code extension, the terminal UI
+  and the API server.
+
+## Contributors
+
+- **Luca Palumbo** ([@LucaPalumbo](https://github.com/LucaPalumbo)) — strict
+  typing across the monorepo, the ESLint configuration, and the original CI
+  workflow.
+- [@directsol](https://github.com/directsol) — verified the Codex transcript
+  reader against a live rollout store (#16) and made the VS Code chat panel
+  follow light themes (#20).
+- **Mayuri** ([@mayuriphad](https://github.com/mayuriphad)) — diagnosed and fixed the
+  planner's duplicated usage-limit message (#79, #96).
+- [@haltingstate](https://github.com/haltingstate) — made the terminal UI's
+  stepper say what a saved step does next, instead of encoding it in a
+  sentinel index (#123).
+
+Thank you. Contributions are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Acknowledgements
+
+The deep-interview planning workflows — `grill-me`, PRD drafting, and TDD task
+augmentation — are adapted from
+[Matt Pocock's skills](https://github.com/mattpocock/skills) (MIT).

package/NOTICE

@@ -0,0 +1,71 @@
+Ordewell
+Copyright 2026 Alessandro Costanzo Ciano and the Ordewell contributors
+
+This product includes software developed by Alessandro Costanzo Ciano and the
+Ordewell contributors, licensed under the Apache License, Version 2.0. See the
+LICENSE file for the full terms, and AUTHORS.md for who contributed.
+
+--------------------------------------------------------------------------------
+TRADEMARKS AND BRAND ASSETS
+--------------------------------------------------------------------------------
+
+The Apache License grants rights to the *software*. It does not grant rights to
+the project's identity, and Section 6 of that License explicitly withholds them.
+
+The name "Ordewell", the Ordewell wordmark, and the Ordewell logos — including
+the image files distributed in `assets/readme/` and `packages/vscode/media/` —
+are not licensed under Apache-2.0 and remain the property of Alessandro
+Costanzo Ciano.
+
+You may:
+
+  - Use the name and logos to refer to this project accurately, including in
+    articles, talks, comparisons, and package listings.
+  - Redistribute the project unmodified, brand assets included.
+
+You may not, without written permission:
+
+  - Use the name or logos for a modified or derivative distribution in a way
+    that suggests it is the official Ordewell, or that it is endorsed by or
+    affiliated with this project.
+  - Use them as, or as part of, your own product name, company name, domain
+    name, or logo.
+
+If you fork and rebrand, replace the assets in `assets/readme/` and
+`packages/vscode/media/`. If you are unsure whether a use is fine, ask —
+the answer is usually yes.
+
+--------------------------------------------------------------------------------
+THIRD-PARTY ATTRIBUTION
+--------------------------------------------------------------------------------
+
+The deep-interview planning workflows (`grill-me`, PRD drafting, and TDD task
+augmentation) are adapted from Matt Pocock's skills
+(https://github.com/mattpocock/skills), licensed MIT, and rebuilt as prompt
+blocks inside Ordewell's planner and runner prompts. The MIT licence requires
+its notice to travel with derivative works, so it is reproduced in full here:
+
+    MIT License
+
+    Copyright (c) 2026 Matt Pocock
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+
+Runtime dependencies carry their own licences; see the `node_modules` tree of
+an installed copy, or each package's entry on npm.

package/README.md

@@ -1,9 +1,13 @@
 # @ordewell/cli
 
 The command line and terminal UI for **[Ordewell](https://ordewell.ai)**, task
-orchestration for coding agents. One goal becomes an ordered plan of tasks, each on
-its own runner, model and branch. Ordewell executes the plan, verifies every task
-from evidence, and leaves the final merge to you.
+orchestration for coding agents. One goal becomes an editable plan with a runner
+and model assigned to each AI task. With worktree isolation enabled, code tasks
+run in separate worktrees; ops and script tasks run at the workspace root.
+Ordewell records task outcomes and combines code changes for review and merging.
+
+This README describes 0.11.0. See the [published releases](https://github.com/ordewell/ordewell/releases)
+for versions available to install and their release notes.
 
 ## Installation
 
@@ -11,29 +15,38 @@ from evidence, and leaves the final merge to you.
 npm install -g @ordewell/cli        # or: npm install -g ordewell
 ```
 
-**Requirements:** Node.js 20 or newer, at least one of Claude Code, Codex or
+**Requirements:** Node.js 20.3 or newer, at least one of Claude Code, Codex or
 OpenCode, and git for task isolation. Linux, macOS and Windows are supported;
 on Windows, run the terminal UI under WSL.
 
 ## Usage
 
 Run `ordewell` in your project to open the terminal UI: the conversation on the
-left, the live plan on the right. The first run lets you pick a planner and runners
+left, the live plan on the right (or beneath it, below 70 columns). The first run lets you pick a planner and runners
 with `/planner` (Harness › Model › Effort, each step saved as you go) and `/runners`, and no API key is needed if you plan with a coding
 agent you already use.
-The welcome screen says it plainly: nothing runs until you approve the plan (unless autorun is on).
+By default, submitted build plans wait for your approval. Autorun can start them
+automatically; research tasks and consented script tasks can start during planning.
+Automatic merging is optional, and an Act supervisor can also merge.
+The welcome screen lists the repositories and branches code tasks will use, and
+whether they get isolated worktrees.
 
 `/settings` walks autonomy, supervisor, merge automatically, autorun and parallel
-in one panel and saves only what you changed. `/planner` walks harness, model and
+(research uses the same Parallel slots) in one panel and saves only what you changed. `/planner` walks harness, model and
 effort in one flow, so there is no separate model or effort command. Press `?` in
 the plan pane for the full key sheet; the footer shows only the keys that apply
 to the selected task.
 
-Every command in the terminal UI is also a subcommand, except `/settings`: it is
-a panel over headless commands that remain for scripts (`ordewell auto`,
-`supervisor`, `automerge`, `autorun` and `parallel`). `/planner` has its own
-`ordewell planner`, and its model and effort steps are `ordewell model` and
-`ordewell planner-effort`.
+Most commands in the terminal UI are also subcommands. The exceptions: `/help`
+is `ordewell --help`; `/quit`, `/new` (every `ordewell plan` starts a fresh
+session) and `/save` (plans persist as they change) have no subcommand; `/load`
+and `/delete` are `ordewell sessions load|delete`; `/open` opens a task's view
+in the full-screen terminal, where a shell has no view to switch to
+(`ordewell checkpoint` answers from one); `/mouse` configures that terminal; and
+`/settings` is a panel over headless commands that remain for scripts
+(`ordewell auto`, `supervisor`, `automerge`, `autorun` and `parallel`);
+`ordewell supervisor reads` and `ordewell trailer` have no panel row. `/planner` has its own `ordewell planner`, and its model and effort
+steps are `ordewell model` and `ordewell planner-effort`.
 
 ```bash
 export AI_PROVIDER=claude-code      # plan with Claude Code, Codex or OpenCode
@@ -44,8 +57,8 @@ ordewell handoff review             # read the diff
 ordewell handoff merge              # bring it onto your branch
 ```
 
-Run `ordewell --help` for the full list, or `ordewell setup` for guided
-configuration.
+Run `ordewell --help` for the full list, or `ordewell setup` to write a
+starter `.env` file.
 
 Type `/name` in the conversation to load a skill, and use `ordewell skills` to
 list the ones a workspace sees and `ordewell task-skills` to attach them to a

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,92 @@
+# Third-party notices
+
+This artifact bundles the third-party packages listed below. Each entry reproduces the
+licence text the installed package ships, as its licence requires; the packages are also
+reachable through the dependency tree recorded in `package-lock.json`.
+
+Generated by `scripts/generate-third-party-notices.mjs` from the installed dependency
+tree; do not edit by hand.
+
+---
+
+## ansi-regex 6.2.2
+
+Licence: MIT
+
+```text
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+
+---
+
+## emoji-regex 10.6.0
+
+Licence: MIT
+Homepage: https://mths.be/emoji-regex
+
+The package declares MIT but installs no licence file; the identifier above is the licence it grants.
+
+---
+
+## get-east-asian-width 1.6.0
+
+Licence: MIT
+
+```text
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+
+---
+
+## string-width 7.2.0
+
+Licence: MIT
+
+```text
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+
+---
+
+## strip-ansi 7.2.0
+
+Licence: MIT
+
+```text
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (https://sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```