Skip to content

Commit bba2fbe

Browse files
committed
Merge origin/master into fix/lock-reap-tickets
exec.sh: keep master's watcher pause (#451) on the new shared lock: trap 'mxtk_resume_watchers; mxtk_lock_release "$LOCK"' EXIT, then mxtk_resume_leftover. CHANGELOG: both sides kept; the lock line now cites the macOS bench PASS from #390 and says the Git Bash run is still owed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013jQvaonym9V1wKKfAEPmRr
2 parents 9139841 + 6615869 commit bba2fbe

463 files changed

Lines changed: 34145 additions & 1610 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/checks.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,9 @@ jobs:
3333
- name: Routing tables in sync with skill-routing.tsv (render-routing.sh --check)
3434
run: bin/render-routing.sh --check
3535

36+
- name: MDL rules by kind cover every rule and match skills/generated (mdl-rules.sh --check)
37+
run: bin/mdl-rules.sh --check
38+
3639
- name: No macOS-only assumptions reintroduced (check-portability.sh)
3740
run: bin/check-portability.sh
3841

‎CHANGELOG.md‎

Lines changed: 127 additions & 1 deletion
Large diffs are not rendered by default.

‎CLAUDE.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ All gate decisions land in the consuming project's `PROJECT.md`, marked `CONFIRM
3232

3333
## Key skills and when to load them
3434

35-
Load skill files **on demand when the task calls for it** — not all upfront. Full routing table: `README.md` → "When to use which skill". The always-on set (`README.md` → "Baseline routing"): `query-the-model.md`, `learned-mdl-preflight.md`, `learned-microflow-patterns.md`, and `bin/bug-lookup.sh` (a CE code, BUG-n, keyword or the whole pasted error message → the matching ledger entries; `bug-logs/mxcli-bugs.md` itself is read on demand — it outgrew the always-on budget).
35+
Load skill files **on demand when the task calls for it** — not all upfront. Full routing table: `README.md` → "When to use which skill". The always-on set (`README.md` → "Baseline routing"): `query-the-model.md`, `learned-mdl-preflight.md` (the mdl helper instead runs `bin/mdl-rules.sh` for the statement kinds it writes; `learned-microflow-patterns.md` is on demand), and `bin/bug-lookup.sh` (a CE code, BUG-n, keyword or the whole pasted error message → the matching ledger entries; `bug-logs/mxcli-bugs.md` itself is read on demand — it outgrew the always-on budget).
3636

3737
| Task | Read this file |
3838
|------|---------------|
@@ -67,6 +67,7 @@ Migration assessment (`assess-migration`) is **bundled with mxcli** (`.ai-contex
6767
| OutSystems | `pipelines/outsystems/` | `cd pipelines/outsystems/pipeline && npm install` — see its `README.md` / `pipeline-guide.html` |
6868
| Java + Angular / Spring Boot | `pipelines/java-angular/` | `cd pipelines/java-angular/pipeline && npm install` — see its `README.md` |
6969
| Node/Express + React | `pipelines/node-express-react/` — **regex-based, proven on one source shape only; read its README's "Known gap" sections first** | `cd pipelines/node-express-react/pipeline && npm install` |
70+
| Mendix (an existing `.mpr`, rehost or move a module) | `pipelines/mendix-mpr/` — **build-green on a small app only; read its README's "Field runs" first** | `MXCLI=/path/to/mxcli pipelines/mendix-mpr/rehost-extract.sh <source.mpr> <target.mpr> <out-dir>` — Python 3 stdlib, no `npm install`; see its `README.md` |
7071

7172
`node_modules/` is gitignored — `npm install` locally per pipeline. Set local paths in `pipelines/<x>/pipeline/config.json`; **never commit real local paths**. Curated sample outputs live under each pipeline.
7273

‎CONVERSION-RUNBOOK.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ git clone https://github.com/MendixMau/mxcli-project-toolkit.git ~/Mendix/mxcli-
1515

1616
`<project-root>` is your project's own folder (usually its git repo) — scaffolding, analysis output, architecture, and the `.mpr` all live **inside** it. Never create a sibling `analysis/<project>/` next to the project.
1717

18-
Then open your agent (Claude Code or equivalent) in the workspace and say what you're starting from. The agent picks the **entry mode** (`skills/conversion-runbook.md` → "Entry Modes"):
18+
Then open your agent (Claude Code or equivalent) in `<project-root>` and say what you're starting from. The agent picks the **entry mode** (`skills/conversion-runbook.md` → "Entry Modes"):
1919

2020
| Starting from | Mode | Stages |
2121
|---|---|---|

‎README.md‎

Lines changed: 138 additions & 60 deletions
Large diffs are not rendered by default.

‎ROUTING.md‎

Lines changed: 20 additions & 9 deletions
Large diffs are not rendered by default.

‎agents/architect-agent.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,8 @@ This table is your whole list. The baseline table in the project's CLAUDE.local.
5858
| `project-bin/check-prototype-links.js` | Before wireframes pass to the build loop, and with --brd before a BRD is signed off: dead #/route links, orphan screens, controls with no data-bind and no data-cut, BRD routes no screen has, screens no use case walks (design-artifacts.md Step 3c, brd-validation.md check 8) |
5959
| `skills/cloud-dev-environment.md` | Setting up or resuming an mxcli project in a cloud/ephemeral container |
6060
| `skills/existing-app-change.md` | Changing an EXISTING Mendix app |
61+
| `skills/decompose-app.md` | Splitting an existing Mendix monolith into several apps |
62+
| `skills/mendix-service-seam.md` | Wiring a service seam between two Mendix apps |
6163
| `project-bin/app-facts.sh` | Collecting the facts an app dossier is written from: forces a full catalog build, module edges through the real module column, strongly connected components, describes every loop-containing microflow and parses the loop bodies; exit 2 on a stale, fast-mode or schema-incomplete catalog, never a verdict |
6264
| `skills/app-analysis.md` | Building or refreshing the standing dossier of an EXISTING app before changing it: inventory, module dependency shape, loop risk patterns, each section with a verdict and a fault where nothing was measured (a standing document; nothing else in the toolkit reads it yet) |
6365
| `skills/layering-review.md` | Checking whether an EXISTING app's module boundaries still hold: the layer map (bin/app-layer-map.sh) computes the order the modules would stack in and draws only the edges that point back up, so one tangle of N mutually reachable modules becomes a named list of edges with a weight and a ref kind; Stage 3 in existing-app-change mode, and the honest blast radius for a slice |
@@ -66,17 +68,20 @@ This table is your whole list. The baseline table in the project's CLAUDE.local.
6668
| `skills/architecture-blueprint.md` | Diagramming target architecture |
6769
| `skills/modularize-domain.md` | Deciding module boundaries before "create module" |
6870
| `skills/design-artifacts.md` | Designing the brand and ONE ANNOTATED WIREFRAME PER SCREEN before building pages |
71+
| `skills/process-map.md` | At Stage 2 close (draft, before the questions are raised) and again after the wireframes (Stage 3 re-render), when a reviewer cannot tell where the open questions and ASSUMED decisions fit: one swimlane map per process, each step on its wireframe, every question pinned to a step (project-bin/process-map.js validate, anchor, build) |
6972
| `skills/interaction-model.md` | Stage 3, after the role model is CONFIRMED and BEFORE THE FIRST WIREFRAME |
7073
| `skills/brd-to-build-plan.md` | Turning BRDs plus architecture into a numbered, dependency-ordered build plan |
7174
| `skills/coverage-ledger.md` | Building the Stage 4 coverage ledger |
7275
| `bin/coverage-check.sh` | Checking a coverage ledger against its BRD |
76+
| `skills/learned-multilingual-app.md` | Adding a second language, a language picker or a translation script |
7377
| `skills/mendix-agents.md` | Building a Mendix AI agent |
7478
| `skills/company-brain.md` | Setting up or wiring a COMPANY BRAIN |
7579
| `skills/close-the-loop.md` | Cutover and retrospective |
7680
| `skills/measured-claims.md` | Before citing ANY behavioural claim about the harness, the Mendix runtime or a test tool as evidence, or counting tokens from transcripts |
7781
| `skills/agent-permission-friction.md` | Any refused, denied or blocked command |
7882
| `project-bin/build-plan-status.sh` | After marking a module done, or any time "how much is built vs proven" is asked |
7983
| `skills/workflow-structure-rules.md` | Designing or reviewing a Workflow's SHAPE before or after the MDL |
84+
| `skills/rest-between-mendix-apps.md` | App-to-app REST or microservices: two or more Mendix apps you build that read each other over REST |
8085
| `skills/mendix-epics-api.md` | Working with the Mendix Epics board programmatically |
8186
| `skills/upstream-feedback.md` | About to open an issue, PR or discussion against mxcli or the toolkit |
8287
| `skills/doctor-triage.md` | doctor.sh reports FAIL or WARN, or someone asks whether a red setup line blocks them |

‎agents/ba-agent.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,7 @@ This table is your whole list. The baseline table in the project's CLAUDE.local.
7575
| `skills/layering-review.md` | Checking whether an EXISTING app's module boundaries still hold: the layer map (bin/app-layer-map.sh) computes the order the modules would stack in and draws only the edges that point back up, so one tangle of N mutually reachable modules becomes a named list of edges with a weight and a ref kind; Stage 3 in existing-app-change mode, and the honest blast radius for a slice |
7676
| `skills/assess-migration.md` | Assessing or planning a migration up front, before any pipeline is chosen |
7777
| `skills/migration-pipeline.md` | Running the extraction pipeline |
78+
| `skills/rehost-app.md` | Rehosting an existing Mendix .mpr into a fresh app |
7879
| `skills/migrate-general.md` | Migrating from a stack that has no dedicated pipeline |
7980
| `skills/migrate-outsystems.md` | Migrating an OutSystems app |
8081
| `skills/source-os11.md` | Understanding OutSystems 11 source |
@@ -104,7 +105,7 @@ This table is your whole list. The baseline table in the project's CLAUDE.local.
104105
- Run the full interview protocol from `conversion-runbook.md` §1 at every gate: homework first, 2-4 options with evidence, assumptions stated out loud, user answers in the terminal, decision written to the stage HTML *and* `PROJECT.md`, unknowns default + `ASSUMED` + proceed.
105106
- Never invent legacy intent from code alone — that's what Path C (the SME interview) is for. Log it as an open question if no SME is available, don't guess.
106107
- **Logging an open question is half the job. Raising it is the other half** — see the Open-questions batch below. A question written to a BRD and never put in the chat is not "logged", it is buried.
107-
- **Read `interview-protocol.md` before raising anything.** Every question you hand over carries two named options and your recommendation; a bare question moves your analysis onto the user. Generate `docs/open-questions.html` with `bin/questions-report.sh` and give them the path.
108+
- **Read `interview-protocol.md` before raising anything.** Every question you hand over carries two named options and your recommendation; a bare question moves your analysis onto the user. Generate `analysis/brd-report.html` with `bin/brd-report.sh` and give them the path.
108109
- `✋` gates (Stages 0 and 7) do not resolve to `ASSUMED` — they need an explicit `CONFIRMED` answer before the run proceeds.
109110

110111
## Workflow

‎agents/gate-agent.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ This table is your whole list. The baseline table in the project's CLAUDE.local.
4545
| `skills/learned-detection-gaps.md` | Before trusting a green check/exec/DESCRIBE result as proof, or when a runtime symptom appears over a fully green model — the register of constructs that pass early rungs and fail later ones |
4646
| `skills/security-is-not-a-later-script.md` | Creating any entity, or calling a module security-ready — entity and grants land in one script, and ready means SHOW SECURITY MATRIX proves it |
4747
| `bin/bug-lookup.sh` | A CE error (mx check or mxbuild: CE0066, CE0117…), a cited BUG-n, or behavior that looks like a known mxcli quirk rather than a modeling mistake — `bin/bug-lookup.sh CE0117` / `BUG-102` / "keyword" / the whole pasted error message (ranked top 3) prints the matching ledger entries, so the session reads one entry, not the whole ledger |
48+
| `bin/file-bugs.sh` | You hit, or worked around, a bug in mxcli or the toolkit — `bin/file-bugs.sh` (the `--add` line is in learned-detection-gaps.md) keeps docs/bugs.jsonl, redacts, shows duplicates, is filed only by a human with `!` (`--file PBUG-NN`, y/N, denied to agents), or prints new-issue links (`--links`, `--json`) |
4849
| `bin/status.sh` | The first command of every session, and any time someone asks "where are we" or "what next" — one screen: stage, done/overdue, the ONE next action, from the instruments, never from memory |
4950
| `skills/teamserver-alignment.md` | Any session that will push a model to Mendix Team Server, and BEFORE telling the user a Team Server push is blocked — which remote is authoritative, settle-then-push order, and the four checks that have to fail first |
5051
| `skills/retesting-learned-rules.md` | Before obeying any learned-* STOP or workaround that costs a detour — probe the binary you actually have, then stamp the verdict back into the rule |

0 commit comments

Comments
 (0)