Repository navigation
Conversation
…pp, MXTK_APP First commit of the multi-app scope work, pushed early so the parallel quality-floor and ready-command branches can read the interface. Readers follow in later commits. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
…-app scaffold in init/sync
A repo holding several apps (apps/<App>/<App>.mpr, one mdlsource/ per app) is now reported per
app instead of "more than one .mpr; set MPR_FILE to choose, nothing checked".
- gate-check: --app <App> / MXTK_APP scopes a run; with none, Marketplace installs prints one
[App] line each (per-app fit-gap may FAIL; a shared fit-gap reads PENDING) and an Apps:
section with each app's model, scripts and LOOK debt. build-ready counts a FAIL.
- status.sh: one APP line per app (bin/lib/app-scope.sh, shared with gate-check).
- look-ledger: one ledger keyed by app (5th owed column only in a multi-app tree);
status --app <App>.
- init/sync: architecture/apps/<App>/{intake,triage}.md + architecture/apps/README.md, Wiring
rows naming the app selection. Module briefs stay in architecture/modules/ (every reader
looks there).
- skills/module-folder-convention.md § Several apps in one repo (baseline 64,984 -> 65,125).
Single-tree and two-tree: gate-check, status, init output, CLAUDE.local.md, owed.tsv and the
scaffolded tree are byte-identical to master (compared side by side on scratch projects).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
… finding prints once From the parent session's field run of #789 on a copy of a six-app repo: - status/gate-check said 'LOOK: no pages owed' per app on a checkout with ~78 built pages, because the LOOK ledger is git-ignored. Now: 'LOOK: no ledger here (N page(s) in its scripts)', 'no ledger row for this app', or 'no page in its scripts'. - the Marketplace check repeated one project-level fit-gap finding six times. Apps on the shared fit-gap are grouped by identical finding: '[all 6 apps, from the shared ...]'. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
…e from a field capture - bin/lib/app-scope.sh mxtk_app_register_notes: an apps/<App>/PROJECT.md (mxcli init per app) holding register lines (Entry mode, Current stage, Adopted at stage, CONFIRMED/ASSUMED rows) gets a warn-only line in gate-check's Apps section, status WATCH and a sync note. The root PROJECT.md stays the register gate-check reads. A plain template file is silent. - tests/wave2/fixtures/multi-app/tree.txt: the structural shape of a field repo (git ls-files, six apps, anonymised AppA..AppF; script counts 69/34/28/26/27/27; each app carries its own PROJECT.md and CLAUDE.md). Fixture adapted to six apps; new case A8. - skills/module-folder-convention.md: one sentence on app-level PROJECT.md (baseline 65,155). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
…ter project; review fixes From the independent review of #789 (HOLD) and the maintainer's decision: - project-bin/_common.sh: refinement of #489. An apps/<App>/ that is a project folder of its own (mxcli init: .claude/ + PROJECT.md) resolves to the OUTER project when that holds a register (## Current stage / ## Decisions / Entry mode), no root or app/ model, and the app folder holds a model. One register, one LOOK ledger, one set of gates. Any other nested project keeps its own root. No subshell on the walk's common path. - mxtk_apps: one line per app folder (<App>.mpr preferred, '-' when ambiguous); select refuses an ambiguous folder; a case-only clash gets its own message. - gate-check: an env MXTK_APP that does not apply is dropped; only --app errors. - app-scope.sh: app list computed once (mxtk_scope_init / MXTK_SCOPE_*), one find + one awk + one look-ledger call (new 'status --by-app'), register notes in one awk; np local; no global helper defined inside a function. Status on six apps 1.41 s -> 1.03 s. - marketplace-check: '-' apps reported, no 'from the shared' label without a shared fit-gap. - fixture: outer-project walk, no ledger split, per-folder dedupe, env MXTK_APP on single tree, no-fit-gap label. Single-tree and two-tree gate-check, status and look-ledger status: byte-identical to master. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
…; status.sh infers the project Field run of 40f8125 on the six-app copy: the root PROJECT.md is hand-written ('- Mode: requirements-driven'), so the register-lines test never fired and app folders kept their own roots. The outer folder now qualifies with any PROJECT.md beside two or more app folders holding a model (no root or app/ model); the register test stays as the one-app alternative. Nested projects elsewhere keep #489. status.sh with no project argument now finds the project from the current folder (mxtk_walk_root) instead of printing usage. Fixture: hand-written outer register from an app cwd; status.sh with no argument from apps/AppB/docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
# Conflicts: # CHANGELOG.md
…ge from #489) A single apps/X/ with its own .claude/ + PROJECT.md under an outer folder whose PROJECT.md holds a register (## Current stage) resolves to the outer folder; master keeps apps/X. Kept on purpose (one register), pinned per the #789 re-review. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
|
Review: MERGE-AFTER-FIX. This PR conflicts with master in Value: Fixes the field gap as reported. Without an app chosen, gate-check now reports per app ( This is DISCUSS-worthy. It adds a layout, overrides the #489 root rule for app folders ( Regression risk:
Correctness:
Context cost: 65,032 → 65,203 (+171 baseline, in Time cost: about 0 ms per build row. Sourcing Exact fixes required:
Generated by Claude Code |
# Conflicts: # CHANGELOG.md # project-bin/look-ledger.sh
This is the output of bin/cut-release.sh. The 24 entries under `## Unreleased` become `## v2026.11.17`. Included: #787, #788, #790, #791, #792 and #793. #789 is held. Review: MERGE — no findings (CHANGELOG heading only; the release section has no client names; CI green on 072e417) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…v2026.11.17 release merge The release (#794) turned ## Unreleased into ## v2026.11.17; the merge left #789's unreleased lines inside the released section. #789 is held and not in that release. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
|
Review: MERGE-AFTER-FIX (re-review at 9cbe111). Fix 1 landed through the master merges. Fixes 2–5 from the prior review have not: the commits since then are only merges and a CHANGELOG move. An orphaned Value: Unchanged; multi-app projects are now reported per app. It merges cleanly with origin/master (#788–#794, Release v2026.11.17). Regression risk:
Correctness: All fixtures were run in a detached worktree and all pass.
Still open: Context cost: 65,568 → 65,739 always-loaded words (+171, baseline). The Behaviour A/B is still NOT RUN. Time cost: ≈0 ms per row. On 9cbe111, Exact fixes required:
Generated by Claude Code |
…each READY
ready.sh marked every app NOT MEASURED ('the look ledger is not kept per app yet'), so a four-app
build could never be READY. A whole-project run now prints one app:<App> row per app from
look-ledger.sh status --by-app (K of N seen, unseen pages named) and needs every app's row;
--app <App> scopes the gate-check stage 5 and ledger steps to that app via MXTK_APP. Single-tree
output is byte-identical to 8aa2ac6. Fixture: test-ready.sh R11 (two apps).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
…after the cd
_XD="${0%/*}" stayed relative (../../bin); after exec.sh's cd to the project root the guard
[ -f "$_XD/_position.sh" ] failed in silence, so 'cd apps/Orders && ../../bin/exec.sh
../../mdlsource/x.mdl' wrote under Interview mode: auto while the same call by absolute path
was refused. A relative MDL script path broke every [ -f "$SCRIPT" ] guard the same way. Both
are made absolute before the cd, only when the caller is not at the project root, so a run from
the root is unchanged. Fixture: test-mode-contract.sh X.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
…p project Tier 2 of the root resolver returned the app folder for a copy installed inside it, so apps/<App>/bin/exec.sh read the app's own PROJECT.md and the outer register's plan rule never fired under auto. It now applies _mxtk_outer_project, the same rule as the root walk; an install in a nested project elsewhere keeps its own root (#489 R17g, checked). Fixture: test-mode-contract.sh X (in-app copy refused). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh
… rule (#795) `_XD="${0%/*}"` stayed relative (e.g. `../../bin`), and exec.sh then ran `cd "$PROJECT_ROOT"`. After the cd, the plan-rule guard `[ -f "$_XD/_position.sh" ]` failed silently, so under Interview mode auto a write before build-ready was not refused when exec.sh was called by a relative path from an app folder. `_XD` and a relative MDL script path are now made absolute before the cd, which also fixes the later `[ -f "$SCRIPT" ]` guards. A run from the project root is unchanged. The fixture is test-mode-contract case X. It was found by the independent review of #789. Review: MERGE — the fix is correct and complete; case X step 1 fails on unfixed master and passes here; the root path is unchanged (CI green on a2692c6) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Status
.claude/andPROJECT.mdnow resolves to the outer project.mxtk_appslists one line per app folder.MXTK_APPthat does not apply is dropped; an explicit--appstill errors.status.shon six apps went from 1.41 s to 1.03 s.status.shwith no argument finds the project from the current folder.CHANGELOG.mdconflicted, and both sides were kept.status.shwith no argument, run from an app subfolder, shows all six apps.Direct lane
What changed and why (one paragraph):
A repo holding several Mendix apps (
apps/<App>/<App>.mpr, onemdlsource/per app) was only partly supported:find_mprfound the models but refused to pick one, so the Marketplace check printed "more than one .mpr; set MPR_FILE to choose, nothing checked";In one field run the project had to hand-write an
MPR_FILEworkaround intoCLAUDE.local.md. In another, the lead dropped per-app intake and triage for one free-form brief, and that brief carried the spec violation that blocked the first grading.This PR adds a small resolver interface in
project-bin/_common.sh, and the shared readers report one line per app when no app is chosen. It never silently picks an app and never reports "nothing checked".Resolver interface (for T1
claude/quality-floorand T3claude/ready-command)mxtk_apps [root]<App>\t<apps/App/X.mpr>(path relative to root); the model is<App>.mprwhen the folder holds several, and-when it holds several and none is named for it; prints nothing and returns 1 on single-tree and two-tree projectsmxtk_app_count [root]mxtk_select_app <App> [root]MPR_FILE(absolute) andMXTK_APP; tries the exact name first, then any letter case; returns 1 with the reason when the name is unknown, matches two folders by letter case only, or names a folder whose model is-mxtk_app_of <path> [root]<App>when the path is underapps/<App>/MXTK_APP=<App>--app, read when_common.shis sourced; anMPR_FILEthe user set still wins; ignored when the project is not multi-appRule for readers: with
mxtk_app_count≥ 2 and no app selected, report one line per app.find_mpritself still refuses, because it answers "which model do I write".Readers
Resolving the root (refinement of _common.sh: installed and toolkit copies resolve different roots when cwd is inside app/ or apps/<X>/ #489):
mxcli initran in it resolves to the outer project.app/, and the app folder holds a model.PROJECT.mdmust either sit beside two or more app folders that hold a model (any content, including a hand-written register), or hold register lines (the one-app case).PROJECT.mdwith a real register (## Current stage,## Decisionsor an Entry mode line), a singleapps/X/with its own.claude/andPROJECT.mdnow resolves to the outer folder; master keepsapps/X. The intent is one register. Pinned by fixture case A1, "one app, outer register".gate-check: new
--app <App>(orMXTK_APP). With no app chosen, it printsMarketplace installs: per app (N apps), then:[App]line for each app with its ownarchitecture/apps/<App>/fit-gap.md; such an app can FAIL;[all N apps, from the shared architecture/fit-gap.md];A full run also prints an
Apps:section with each app's model, itsmdlsource/scripts and its LOOK debt. With no ledger, the LOOK part readsLOOK: no ledger here (N page(s) in its scripts), never "no pages owed".status.sh: one
APPline per app, in both the full screen and--brief, using the same helper as gate-check (bin/lib/app-scope.sh). With no argument, it finds the project from the current folder.look-ledger: one ledger keyed by app, not one per app folder, because:
seen.tsv.Owed rows get a 5th column, the app, and only in a multi-app tree.
status --app <App>keeps two apps' pages of the same name apart;status --by-applists every app's rows in one call.One register:
PROJECT.mdis the register; gate-check never reads an app's.PROJECT.mdfiles: one per app frommxcli init, plus the root.PROJECT.mdthat holds register lines gets a warn-only⚠ [App]line in gate-check, a status WATCH item and a sync note.init / sync:
architecture/apps/<App>/intake.mdandtriage.md, plus the indexarchitecture/apps/README.md.architecture/build-plan.mdwith a## App: <App>section per app.MXTK_APP/--app. On an existing project, sync prints the replacement rows and does not rewrite them.Convention — please confirm:
architecture/apps/<App>/, notapps/<App>/, becauseapps/<App>/is the Mendix project folder that Studio Pro commits and mxbuild packages.architecture/modules/<Module>/with an**App:** <App>line, because seven readers look there.skills/module-folder-convention.md§ Several apps in one repo.Impact
--app. A multi-app build-ready can now FAIL when a Buy in an app's own fit-gap is not installed; before this it was PENDING "nothing checked". The new planning files appear only in multi-app projects. The app-register warning is warn-only.project-bin/_common.sh(new functions, the root-walk refinement, one block that runs when it is sourced),bin/gate-check.sh,bin/lib/marketplace-check.sh,bin/status.sh,project-bin/look-ledger.sh(--app,--by-app),bin/init-project.sh,bin/sync-project.sh,bin/doctor.sh(two hint strings). New:bin/lib/app-scope.sh. Not touched:project-bin/exec.sh(T2), the obligation verdict logic (T1),bin/ready.sh(T3).render-routing.sh --check. All 171 words are inmodule-folder-convention.md(stages 4 and 5, architect and mdl roles).[ -d apps ]test, 0 s. Multi-app, six apps:status.sh1.03 s total; the per-app lines take 33 ms and the register notes 16 ms.Time cost: per gate/status run · ~0.05 s on Linux x86-64 container (6 apps) · can force rework: y (a per-app Buy FAIL) · offset: replaces a check that never ranByte-for-byte (single-tree, two-tree): master and this branch were run side by side on freshly scaffolded projects, at 6089d20 and again after the merge.
Identical, apart from the project name and toolkit sha: the
init-projectoutput,CLAUDE.local.md, the scaffolded file tree,status.shandlook-ledger status.Also identical:
gate-check --no-html, except for a "toolkit updated" note. That note comes from comparing two separate checkouts against the project's recorded commit.No client data anywhere in the diff (apps anonymised AppA..AppF; script names generated)
Size cap: over 400 lines. One PR, per the owner; the scaffold split waits for the trial.
Test tier: scenario checks run by hand on the materialised six-app capture, with a stub mxcli replaying captured SHOW MODULES output. The parent session ran a field check on the six-app copy.
tests/wave2/test-multi-app-scope.sh: the reviewer ran it at 6089d20, 69/0 on the unchanged captured tree. The one-app case added in d70a02e was checked by hand and still needs one fixture run.Golden input:
fixtures/multi-app/tree.txtis thegit ls-filesshape of the six-app field repo, anonymised (seePROVENANCE.txt); SHOW MODULES output comes from existing captures.Both layouts considered, plus the third. Bash 3.2: globs and builtins only. Git Bash: not run here.
CHANGELOG.mdlines appendedDo not merge before an independent review (CLAUDE.md "Merging a PR").
🤖 Generated with Claude Code
https://claude.ai/code/session_01HXpQSmcGH9hcq6GdHyLxdh