buninu-linux 0.2.0

package/initramfs/buninu/apps/bunmsh/LICENSE-MKSH

@@ -0,0 +1,295 @@
+Terms and Conditions - The MirBSD Korn Shell
+============================================
+
+The MirBSD Korn Shell (mksh) consists of a number of "source" files,
+which are provided by upstream in a number of places. This file will
+list the files belonging to mksh or being part of it and the licence
+terms and conditions that apply to them, in one single central place
+for packagers' convenience. This list aims to be authoritative. (Yet
+as it was compiled by a human, there may be bugs, please report them
+if any are found. We don't think so though.)
+
+All paths are relative to The MirOS Project's CVS repository.
+
+
+The following files form The MirBSD Korn Shell R59-current:
+- build system
+  * mksh/Build.sh
+  * mksh/FAQ2HTML.sh
+- testsuite driver
+  * mksh/check.pl
+- testsuite with code examples
+  * mksh/check.t
+- configuration with/and code examples (informal)
+  * mksh/dot.mkshrc
+  * contrib/hosted/tg/assockit.ksh
+  * contrib/hosted/tg/progress-bar
+  * contrib/hosted/tg/uhr
+- documentation
+  * mksh/lksh.1
+  * mksh/mksh.1
+  * mksh/mksh.faq
+- source code
+  * mksh/edit.c
+  * mksh/emacsfn.h
+  * mksh/eval.c
+  * mksh/exec.c
+  * mksh/expr.c
+  * mksh/exprtok.h
+  * mksh/funcs.c
+  * mksh/histrap.c
+  * mksh/jehanne.c
+  * mksh/jobs.c
+  * mksh/lalloc.c
+  * mksh/lex.c
+  * mksh/main.c
+  * mksh/mirhash.h
+  * mksh/misc.c
+  * mksh/os2.c
+  * mksh/rlimits.opt
+  * mksh/sh.h
+  * mksh/sh_flags.opt
+  * mksh/shf.c
+  * mksh/syn.c
+  * mksh/tree.c
+  * mksh/var.c
+  * mksh/var_spec.h
+- upstream provided packaging
+  * mksh/mksh.ico (application icon resource)
+  * mksh/Makefile (MirBSD only, not part of mksh)
+  * ports/shells/mksh/DEINSTALL
+  * ports/shells/mksh/DESCR (official)
+  * ports/shells/mksh/INSTALL
+  * ports/shells/mksh/Makefile
+  * ports/shells/mksh/PLIST
+  * ports/shells/mksh/distinfo (official)
+  * src/distrib/special/mksh/Makefile (for the MirBSD installer)
+- website (informal)
+  * www/files/TaC-mksh.txt (this file)
+  * www/pics/mksh.svg (logo source code)
+  * www/pics/mksh128x100.png (logo compiled version)
+  * www/src/mksh-faq.hts (supplemental documentation)
+  * www/src/mksh.hts (primary webpage)
+  * www/src/mksh_bld.hts (supplemental webpage)
+  * www/src/mksh_old.hts (supplemental webpage)
+
+All of these files are covered by The MirOS Licence (Appendix A) ex-
+cept the application icon resource, the terms for that are listed in
+Appendix D. Width data comes under those in Appendix E.
+
+The creator of mksh acknowledges the contributions of several people
+to the Public Domain Korn Shell as well as suggestions and work from
+packagers, other developers etc. and everyone else who helped making
+mksh what it is today. Thanks!  The MirBSD Korn Shell is sublicenced
+under a copyright licence fallback from the original pdsh author.
+
+The manpage portability glue excerpts from the UCB mdoc package, for
+interoperability patching; see Appendix B for terms of cited parts.
+
+
+The following files belong to mksh and are distributed inside of its
+distfile, but are not part of it. They are provided for convenience,
+because they are required on many operating environments for mksh or
+some of its features to function:
+- source code
+  * mksh/strlcpy.c (needed if not provided by the OS already)
+
+These files are covered by seperate licences in addition (Appendix C
+for now). Some operating environments already provide their functio-
+nality, such as the BSDs and OSX libc, or the Debian/freedesktop.org
+libbsd package. The files are not compiled into the resulting binary
+if their respective functionality is already provided.
+
+
+The following file is not part of mksh but can be used with it; it's
+also not included in the mksh distfile:
+- source code
+  * src/usr.bin/printf/printf.c (UCB printf(1) utility that has been
+    slightly modified, for an optional built-in printf, to be inclu-
+    ded for lksh-as-/bin/sh only and only when necessary)
+
+The printf.c file is covered by the UCB three-clause BSD licence, as
+shown in Appendix B below.
+
+
+The MirOS Licence also applies as a collective-work copyright on The
+MirBSD Korn Shell, an authorised derivate of the 1980s Public Domain
+V7/Bourne Shell.
+
+Note that these appendices may represent the terms and conditions of
+more than one file, hence the actual wording of the files was folded
+into one representation, with different copyright holders and years,
+separated if merging was undesirable.
+
+
+Appendix A - The MirOS Licence (OSI approved)
+==============================
+
+The MirBSD Korn Shell (mksh) is
+Copyright (c) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
+	      2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019,
+	      2020, 2021, 2022, 2023, 2024, 2025, 2026
+	mirabilos <m$(date +%Y)@mirbsd.de>
+Copyright (c) 2015, 2017, 2020
+	KO Myung-Hun <komh@chollian.net>
+Copyright (c) 2015
+	Daniel Richard G. <skunk@iSKUNK.ORG>
+Copyright (c) 2017
+	Giacomo Tesio <giacomo@tesio.it>
+All rights reserved.
+
+The mksh logo is
+Copyright (c) 2008, 2009
+	Lukas U. <smultron@midnightbsd.org>
+Copyright (c) 2008, 2009
+	mirabilos <m$(date +%Y)@mirbsd.de>
+
+
+Provided that these terms and disclaimer and all copyright notices
+are retained or reproduced in an accompanying document, permission
+is granted to deal in this work without restriction, including un-
+limited rights to use, publicly perform, distribute, sell, modify,
+merge, give away, or sublicence.
+
+This work is provided "AS IS" and WITHOUT WARRANTY of any kind, to
+the utmost extent permitted by applicable law, neither express nor
+implied; without malicious intent or gross negligence. In no event
+may a licensor, author or contributor be held liable for indirect,
+direct, other damage, loss, or other issues arising in any way out
+of dealing in the work, even if advised of the possibility of such
+damage or existence of a defect, except proven that it results out
+of said person's immediate fault when using the work as intended.
+
+
+Appendix B - The UCB (3-clause BSD) licence (OSI approved)
+===========================================
+
+GNU groff portability glue in the manual page source is
+Copyright (c) 1991, 1993
+	The Regents of the University of California.
+printf.c is
+Copyright (c) 1989
+	The Regents of the University of California.
+All rights reserved.
+
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the University nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.
+
+
+Appendix C - ISC Licence (OSI approved)
+========================
+
+strlcpy.c is
+Copyright (c) 2006, 2008, 2009, 2013
+	mirabilos <m$(date +%Y)@mirbsd.de>
+Copyright (c) 1998
+	Todd C. Miller <Todd.Miller@courtesan.com>
+
+
+Permission to use, copy, modify, and distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+Appendix D - Licence for mksh.ico (optional component)
+=================================
+
+The application icon resource comes in its preferred form
+of modification and is an unregistered trademark:
+
+Copyright (c) 2013 Michael Langguth <mail@michael-langguth.de>
+Copyright (c) 2006 Benny Siegert
+Copyright (c) 2005 mirabilos
+
+This icon may be used to refer to The MirBSD Korn Shell and
+its Win32 port. Distribution patches are acceptable as long
+as they modify $KSH_VERSION according to the guidelines that
+are published on the website; forks and works that are not
+derivates are not allowed to use it.
+
+As far as MirBSD is concerned, the files themselves are free
+to modification and distribution under BSD/MirOS Licence, the
+restriction on use stems only from a need to protect it or
+lose it: http://www.mckusick.com/beastie/mainpage/copyright.html
+
+The Shilouette daemon is Copyright (c) 2003 by Rick Collette.
+The MirOS Project may freely use the former ekkoBSD Logo,
+the shilouette Daemon, for MirBSD, on anything the project
+leader sees fit, so long as it pertains to MirBSD in some
+way and the leader gives credit for the original daemon to
+Marshall Kirk McKusick.
+
+The BSD daemon is Copyright (c) 1988 by Marshall Kirk McKusick.
+All Rights Reserved.  Individuals may use the daemon for their
+personal use within the bounds of good taste.  When reasonably
+possible, the text shown above is to be included.
+
+
+Appendix E - Unicode Data Files and Software Licence
+====================================================
+
+Copyright (c) 1991-2022 Unicode, Inc. All rights reserved.
+Distributed under the Terms of Use in https://www.unicode.org/copyright.html.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Unicode data files and any associated documentation
+(the "Data Files") or Unicode software and any associated documentation
+(the "Software") to deal in the Data Files or Software
+without restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, and/or sell copies of
+the Data Files or Software, and to permit persons to whom the Data Files
+or Software are furnished to do so, provided that either
+(a) this copyright and permission notice appear with all copies
+of the Data Files or Software, or
+(b) this copyright and permission notice appear in associated
+Documentation.
+
+THE DATA FILES AND SOFTWARE ARE 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 OF THIRD PARTY RIGHTS.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
+NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
+DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THE DATA FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder
+shall not be used in advertising or otherwise to promote the sale,
+use or other dealings in these Data Files or Software without prior
+written authorization of the copyright holder.
+
+
+__________________________________________________________________
+$MirOS: www/files/TaC-mksh.txt,v 1.40 2026/01/25 06:48:29 tg Exp $

package/initramfs/buninu/apps/bunmsh/PORTING.md

@@ -0,0 +1,192 @@
+# mksh to Bun porting status
+
+This document tracks detailed implementation boundaries. bunmsh 0.1.8 is a
+clean JavaScript shell inspired by mksh's user-facing model; it is useful as a
+command shell, but it is not a drop-in mksh or fully POSIX-compatible shell.
+The README describes user-facing commands and flags. This file focuses on
+semantic coverage, architecture, platform behaviour, and remaining work.
+
+## Implemented core
+
+| Area | Current status |
+| --- | --- |
+| CLI | Interactive mode, stdin, script files, `-c`, already-quoted `-cc`, `-i`, `--mouse`, `--builtin-only`, help, version, README display, and standalone build entry points |
+| JavaScript | Raw lines beginning with `Bun.` bypass shell parsing and use awaited JavaScript `eval`; this also works inside command substitution and script files |
+| Lexing and lists | Comments at word boundaries, single/double quotes, escapes, newline and `;` lists, `&&`, `||`, pipelines, and `!` negation |
+| Compound grammar | One-line and multiline `if`/`elif`/`else`, `case`, `while`, `until`, `for`, shell functions, and parenthesised subshells |
+| Expansion | Parameters and common POSIX operators, mksh-style replacement, command substitution, legacy backticks, arithmetic expansion, IFS field splitting, tilde expansion, brace alternatives, and standard pathname globs |
+| Redirection | Streamed stdin/stdout/stderr truncate and append redirects, `<<`/`<<-` here-documents, `<<<` here-strings, redirects on pipelines and compound commands, and common descriptor duplication such as `2>&1` |
+| Pipelines | Stages run concurrently with Web Streams and `Bun.spawn`; large output is not collected, early-closing consumers stop upstream producers, and pipeline status comes from the final stage |
+| Commands | Aliases, functions, regular builtins, PATH lookup, system-first fallback builtins, Bun Shell fallbacks, explicit paths, and `command`/`builtin` lookup controls |
+| State | cwd tabs with shared shell state, environment and assignments, positional arguments, readonly names, aliases, functions, last/exit status, and pipeline state isolation |
+| Interactive | Readline editing, saved/Bash/Fish history import, automatic append-only history save (concurrent-session-safe, every 60s/on exit/on SIGTERM/SIGHUP) plus manual `tab s`/`tab save`/`tab s d` control, Up/Down recall, command/file completion, ghost suggestions, keyboard shortcuts, optional SGR mouse interaction, terminal-aware prompt layout, `PS2` continuation prompting for here-documents/open quotes/unfinished compound bodies, and interactive Ctrl-C/Ctrl-D/SIGTERM/SIGHUP handling |
+| Platforms | Forward-slash shell paths with native conversion on Windows, platform PATH delimiters, Windows executable suffix handling, Linux/Android dynamic-linker re-execution, and inherited `LD_LIBRARY_PATH` |
+| Packaging | Source execution and standalone Bun executables, including compiled self-spawn paths used by pipelines and reflected `bunmsh` commands |
+
+The automated suite compares core expansion, builtins, grep/sed behaviour,
+pipelines, and redirects with `/bin/sh` or system utilities where their intended
+semantics overlap. Platform-specific behaviour also has focused unit and
+pseudo-terminal tests.
+
+## Current semantic boundaries
+
+### Grammar and execution
+
+- Background jobs (`&`), job control, coprocesses, and asynchronous command
+  lists are not implemented.
+- Brace command groups, `select`, arithmetic commands, and `[[ ... ]]` are
+  not implemented.
+- Functions and subshells cover practical cases but do not yet reproduce every
+  mksh scoping, local-variable, trap, and diagnostic edge case.
+- Pipelines isolate builtin/function state through subprocess copies. Changes
+  made by a pipeline stage do not mutate the parent shell, matching the common
+  shell model but not every mksh optimisation detail.
+- There is no process-group based foreground/background job-control layer yet.
+  Foreground TUI commands do receive the terminal directly while bunmsh pauses
+  readline and temporarily disables its own mouse reporting.
+
+### Expansion
+
+- Common parameter defaults, alternatives, lengths, trimming, and replacement
+  are supported, but arrays, associative arrays, namerefs, mksh transforms,
+  and `${| ...; }` are not.
+- Standard `*`, `?`, and bracket pathname patterns are supported. Extended glob
+  operators and process substitution are not.
+- Brace alternatives are supported; the implementation is not a complete
+  reproduction of every mksh brace-range and nested edge case.
+- Arithmetic expansion supports shell variables and common integer operators,
+  not the complete mksh arithmetic language.
+
+### Redirection and processes
+
+- `<`, `>`, `>>`, `2>`, `2>>`, `<<`/`<<-` here-documents, `<<<` here-strings,
+  and common output descriptor duplication are implemented with streaming I/O.
+  An unquoted and unescaped heredoc delimiter expands parameters, command, and
+  arithmetic substitution in the body like a double-quoted string; a quoted or
+  backslash-escaped delimiter leaves the body literal. Like dash and bash, a
+  script that ends before a heredoc's terminator line appears uses whatever
+  was read as the body instead of raising a syntax error.
+- `<<<word` expands `word` as mksh's `DOHERESTR | DOSCALAR` do: parameter,
+  command, and arithmetic substitution run, but there is no field splitting,
+  pathname expansion, or tilde expansion, and a trailing newline is appended.
+  It follows the same dash/`/bin/sh` comparison harness as everything else in
+  this codebase, except `<<<` itself, since dash does not implement it.
+- Arbitrary descriptor allocation/manipulation, descriptor variables,
+  heredocs targeting a descriptor other than stdin, and every ordering edge
+  case remain incomplete.
+- External processes use `Bun.spawn`; regular and fallback builtins may execute
+  in-process or in a self-spawned bunmsh pipeline child depending on streaming
+  and state-isolation requirements.
+- The reflected `bunmsh` launcher preserves dynamic-linker invocation on Linux
+  and Android for `ld-linux`, `ld-musl`, `linker`, and `linker64` forms, and
+  preserves `LD_LIBRARY_PATH`. Unusual launch wrappers may still require
+  additional platform handling.
+
+### Signals and job control
+
+- Interactive bunmsh catches SIGINT instead of allowing Ctrl-C to terminate
+  the shell. At the prompt it abandons the current edit and starts a fresh
+  prompt with status 130. A foreground `serve` handles the same signal by
+  stopping its server, returning status 130, and handing control back to the
+  interactive loop.
+- Ctrl-D on an empty readline input sends EOF and exits the interactive shell.
+  This is deliberately distinct from Ctrl-C, following the same high-level
+  editor/main-loop separation used by mksh.
+- The current implementation handles SIGINT through readline while editing and
+  through a process signal listener while a foreground operation owns the
+  terminal. It does not yet have mksh's general pending-signal table and safe
+  trap checkpoints.
+- There is no `trap` builtin or support for user handlers for signals, `EXIT`,
+  or `ERR`. Signal handlers therefore cannot yet execute shell source, be
+  listed, ignored, reset, or inherited with POSIX/mksh semantics.
+- Status 130 is defined for an interrupted `serve`, and its SIGTERM path uses
+  143. Signal-derived statuses are not yet normalised consistently for every
+  external command, builtin, pipeline stage, and command substitution.
+- Interactive mode catches SIGTERM and SIGHUP while waiting at the prompt: it
+  flushes history (see the history-saving row in the Implemented core table)
+  and exits with the conventional 128+signal status. While a foreground
+  command owns the terminal, receiving either only flushes history
+  immediately — it does not stop that command, since there is no
+  process-group job-control layer yet to do that safely (see below); the
+  shell actually exits once the command finishes on its own. Neither has
+  mksh's complete interactive policies otherwise; SIGQUIT does not have a
+  handler at all; SIGCHLD does not maintain a job table; and SIGWINCH is not
+  integrated into a general signal subsystem.
+- Terminal control characters are currently mediated by Bun readline. bunmsh
+  does not read termios `VINTR`, `VQUIT`, or `VEOF`, so remapping those keys
+  with `stty` is not guaranteed to match mksh.
+- Long-running JavaScript builtins need command-specific cancellation today.
+  `serve` implements it, while there is not yet a common abort context that can
+  interrupt every asynchronous builtin safely.
+- Pipeline shutdown handles practical early-closing consumers and stops
+  upstream producers, but SIGPIPE status/disposition is not yet integrated
+  with a full process-group and job-control model.
+- Background execution, process groups, terminal foreground ownership, job
+  tables, `jobs`, `fg`, `bg`, `wait`, and Ctrl-Z/SIGTSTP handling remain
+  unimplemented. SIGTTIN and SIGTTOU policies consequently remain absent too.
+
+### Builtins and utilities
+
+- The README's builtin tables are the source of truth for currently supported
+  command flags. Most implementations intentionally cover common usage rather
+  than every POSIX, GNU, or mksh option.
+- `printf`, `print`, `read`, `test`, `getopts`, `kill`, `sed`, `grep`, `find`,
+  and other utilities have documented subsets and are not complete clones.
+- Fallback builtins normally yield to an executable of the same name in PATH.
+  `builtin NAME` forces bunmsh's implementation; builtin-only mode suppresses
+  direct PATH dispatch while the explicit `which` query still searches PATH.
+- Bun Shell fallback behaviour is version-dependent. See
+  [bunshell.md](bunshell.md) for the tested compatibility snapshot.
+
+### Interactive behaviour
+
+- History is loaded at startup and saved automatically (every 60s and once
+  more on exit), appending only this session's own new commands to a JSON
+  Lines file — never rewriting it — so concurrent bunmsh sessions saving
+  around the same time cannot overwrite each other's history. `tab s`/
+  `tab save` trigger that same append immediately; `tab s d`/`tab save dedupe`
+  is a separate, explicit whole-file rewrite that drops duplicates and
+  reports if another session's write raced it. A pre-existing history file in
+  bunmsh's older single-JSON-array format is read correctly and silently
+  upgraded to JSON Lines the next time anything is saved. `fc` is not
+  implemented.
+- Completion uses a periodically refreshed sorted PATH index plus live cwd file
+  reads. It is practical rather than a byte-for-byte mksh completion engine.
+- Ghost suggestions use imported/saved history and filesystem matches after
+  filtering terminal control characters.
+- Full Emacs/Vi editing-mode compatibility, user-defined key bindings, and
+  programmable completion are not yet implemented. `PS2` continuation
+  prompting (here-documents, open quotes/substitutions, unfinished compound
+  bodies) is implemented; see the Implemented core table above.
+- Mouse tracking is opt-in because terminal application tracking interferes
+  with normal scrollback in Termux, xterm, and similar terminals.
+
+### Platform scope
+
+- Linux, Android/Termux, macOS, and Windows are the intended platforms. Windows
+  users see forward slashes at the shell layer; bunmsh converts executable and
+  filesystem paths at native API boundaries.
+- When Windows does not define `HOME`, bunmsh derives it from `USERPROFILE` or
+  `HOMEDRIVE` plus `HOMEPATH`, so `cd`, `~`, and prompt home shortening use the
+  same user directory conventions as history storage.
+- Prompt home shortening treats Android's `/data/data/PACKAGE` and
+  `/data/user/0/PACKAGE` app-sandbox paths as equivalent, while preserving the
+  actual cwd spelling used for filesystem operations.
+- Windows command discovery recognises common executable suffixes internally;
+  full `PATHEXT` emulation is intentionally not implemented.
+- OS/2, EBCDIC, MirBSD-specific, and legacy lksh modes are out of scope.
+
+## Remaining major work
+
+1. Background jobs, process groups, complete signal-status handling, traps,
+   general builtin cancellation, and `jobs`/`fg`/`bg`/`wait`.
+2. Shell options such as `errexit`, `nounset`, `pipefail`, `xtrace`, and POSIX
+   mode, plus startup/login/restricted-shell files and modes.
+3. Brace groups, `[[ ... ]]`, arithmetic commands,
+   extended globs, process substitution, and fuller mksh expansion semantics.
+4. Arrays, associative arrays, namerefs, `typeset`/scope semantics, and more
+   complete special builtins.
+5. Programmable completion, multiline editing, editing modes, key bindings,
+   `fc`, and automatic history policy.
+6. Broader POSIX conformance testing, mksh `check.t` coverage, exact diagnostics,
+   and exit-status compatibility for edge cases.