You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 304487b
Browse filesBrowse the repository at this point in the historyBrowse files
2026.10.31.1: features in every envelope, program in self env; #868; #866/#867 follow-ups; canary build steps; --pkg-format polyglot; ldflags files as link inputs (#869)
* design 2026-10-30 part 2: mcpp plugins and mcppls -- layers, the project's mcpp, mcppls's contract, entries, test cases, the manifest's rules as LSP, CLion native, distribution; one file for every system (#849): the APE and polyglot probes, the polyglot carrier model
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* 2026.10.31.1: `features` in --protocol-version and every envelope, `program` in self env, and how a tool runs mcpp for a project (docs/50)
A client gates on a feature (`target-sets`, `pkg-format-list`) rather than a
version number; every envelope's `mcpp` field carries the list beside the
version, so one `self env` gives both and a job's envelope says when either
changed. `self env` names the file that is running, so a tool that ran `mcpp`
through a shim in a project's directory reads which mcpp the project uses.
Design 2026-10-30 part 2 §4.0, §4.3.
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* a workspace's lock entry is keyed the same way whatever members a command plans (#868)
Two members spelling one dependency two ways (`tinyhttps.workspace = true` and
`[dependencies.mcpplibs] tinyhttps.workspace = true`) made `-p` of each write
its own key and hash. The key is now the workspace's spelling: its
`[dependencies]`, `[workspace.dependencies]`, then every member in the order
`members` lists them, selected or not (docs/07, e2e 990).
Closes#868
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* the follow-ups of #866 and #867: a bare partial requirement is a caret; the TOML writer escapes every control character
#866: a bare requirement is a caret, so "0" and "0.0" take the wildcard
bounds as well (<1.0.0, <0.1.0); a unit test pins bare against caret, docs/05
states it in both languages.
#867: with \b, \f and \uXXXX read, a value may hold any control character;
escape_string escapes U+0000-U+001F and U+007F (short forms where TOML has one,
\uXXXX elsewhere, never the reader's \0), so serialize writes TOML. A round
trip test covers every control character.
Design 2026-10-30 part 2 §17.
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* release canaries print the longest build steps of every build they made
A canary's time is mostly its project's build (xlings: 1750 s of 47 min); each
canary now ends with the 20 longest steps read from every .ninja_log beneath
it, and `release_canaries.py steps <dir>` prints them for any tree. Design
2026-10-30 part 2 §11.
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* a file [build] ldflags names by absolute path is a link input
A replaced prebuilt archive named in [build] ldflags did not relink the
program: the word reached the linker but no link edge depended on it, and the
clangd ok-image probe deleted its image to take a new library. A word that names
an existing file by absolute path is now an implicit input of every non-archive
link that carries it (docs/04, e2e 991). Design 2026-10-30 part 2 §25.3 C1.
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* one file for several systems: --pkg-format polyglot (SPEC-014 2.1 §5.3, #849)
An ok image's single files of every leg and system (--systems all unless
stated) are assembled into one <name>-<version>.exe. The Windows program leads:
its DOS header is a shell assignment (MZqFpD='...') followed by a two-line
script, the PE header moves down by a multiple of the file alignment and the
offsets it holds move with it; the other systems' programs follow unchanged, and
the POSIX script last. Windows starts the file as the PE it is (Authenticode
signs it); Linux and macOS start it through sh, which copies the system's
program to the single-file cache by SPEC-014 §5.2's rules, checks its sha256 and
executes it. Without Windows the file is a #!/bin/sh script.
The carriers are signed before assembly (the Windows one excepted) and the file
after. polyglot is not in a --pkg-format list, a native target is refused, and
mcpp emit xpkg names the file it refuses. mcpp run --pkg-format single-file and
polyglot run the file directly (polyglot through sh on POSIX); they were refused
as unknown formats; tar, zip and dir are refused as containers.
Design 2026-10-30 part 2 §19.6; e2e 992, unit test_pack_polyglot.
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* CI: the new e2e tests' durations in the Linux shards; e2e 992 also in the wine job, where its file runs as a Windows program
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* the binary states 2026.10.31.1; #868 reads each member's manifest as written
The version module still named 2026.10.30.1 (help, version and the subsystem
contract test compare it with mcpp.toml). Loading every member through
load_member_manifest for its spelling of a dependency also ran the inheritance a
planned member receives, whose position-reading notes then reached the root's
own build (e2e 911 R5); the manifests are now read as written, the way
workspace_members reads them.
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* a tree's POSIX launcher names macOS's quarantine mark on its runner, with the command that removes it
A package a browser downloaded carries com.apple.quarantine on every file, and
macOS refuses to start an unsigned runner so marked; the launcher says so before
it starts the runner (SPEC-014 §4.3; mcpp design 2026-10-30 part 2 §10 D6).
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
* docs: the part 2 design is active and indexed; docs/50's heading for how a tool runs mcpp is a noun phrase
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
---------
Co-authored-by: speak-agent <248744407+speak-agent@users.noreply.github.com>
Copy file name to clipboardExpand all lines: docs/10-pack-and-release.md
+41-5Lines changed: 41 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -63,7 +63,7 @@ A pack is decided by three independent choices and a set of legs (2026.10.27.1+)
63
63
|---|---|---|---|
64
64
| linkage |`--linkage`| are the libraries inside the program or beside it |`static`, `shared`|
65
65
| closure |`--mode`| what the machine that runs the package provides |`system`, `vendored` (default), `self-contained`|
66
-
| container |`--pkg-format`| what is delivered |`tar`, `zip`, `dir`, `single-file`, a format a package provides, or a list of containers of one tree (`tar,okb`); unstated: `zip` for a Windows program, `tar` elsewhere |
66
+
| container |`--pkg-format`| what is delivered |`tar`, `zip`, `dir`, `single-file`, `polyglot`, a format a package provides, or a list of containers of one tree (`tar,okb`); unstated: `zip` for a Windows program, `tar` elsewhere |
67
67
| legs |`--target`, repeatable | which targets the pack covers | targets and target sets (`x86_64-openkal`, `openkal`, `linux-musl`) |
68
68
| systems |`--systems`| which systems a self-contained package's runners, or single files, are for |`linux`, `linux-aarch64`, `all`|
69
69
@@ -135,7 +135,9 @@ choices:
135
135
| several images of a platform that states no `runner`, not as single files | one pack per target, or `--pkg-format single-file`|
136
136
|`--target` outside the platform's targets | a target the platform serves |
137
137
| a target set that expands to nothing, or whose rows select different platforms | a target, or another set |
138
-
|`dir` or `single-file` in a `--pkg-format` list; a list with `-o` naming one file; a list on `mcpp run`| one format, or `-o <directory>/`|
138
+
|`dir`, `single-file` or `polyglot` in a `--pkg-format` list; a list with `-o` naming one file; a list on `mcpp run`| one format, or `-o <directory>/`|
139
+
|`--pkg-format polyglot` for a program of one system (a native target) |`--pkg-format single-file`, or `--target openkal`|
140
+
|`mcpp run --pkg-format tar`, `zip` or `dir`|`--pkg-format single-file` or `polyglot`, or a format a package provides |
139
141
|`--mode self-contained` of an image with `okb` as the only format |`--pkg-format tar,okb`: okb holds the images alone, and the runner would be dropped |
140
142
| a tree that runs nowhere (`runs_on` empty) |`--mode self-contained --systems <a system this mcpp builds for>`|
141
143
| a dispatched format for a `lib` or `shared` target | the library route, [12](12-binary-distribution.md)|
@@ -910,6 +912,36 @@ A WebAssembly target has no single file: `--pkg-format single-file` with
910
912
`--target wasm32-emscripten` is refused before anything compiles
911
913
(2026.10.29.1+), and its page is the `dist-web` provider's format.
912
914
915
+
### One file for several systems (`polyglot`, mcpp 2026.10.31.1+)
916
+
917
+
`--pkg-format polyglot` assembles an image's single files of every leg and
918
+
system (`--systems all` unless `--systems` says otherwise) into one file,
0 commit comments