omdev 0.0.45__tar.gz → 0.0.47__tar.gz

{omdev-0.0.45/omdev.egg-info → omdev-0.0.47}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omdev
-Version: 0.0.45
+Version: 0.0.47
 Summary: omdev
 Author: wrmsr
 License-Expression: BSD-3-Clause
@@ -14,31 +14,11 @@ Classifier: Programming Language :: Python :: 3.15
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: omcore==0.0.45
-Provides-Extra: all
-Requires-Dist: ominfra==0.0.45; extra == "all"
-Requires-Dist: omllm==0.0.45; extra == "all"
-Requires-Dist: black~=26.5; extra == "all"
-Requires-Dist: pycparser~=3.0; extra == "all"
-Requires-Dist: pcpp~=1.30; extra == "all"
-Requires-Dist: docutils~=0.23; extra == "all"
-Requires-Dist: markdown-it-py~=4.2; extra == "all"
-Requires-Dist: mdit-py-plugins~=0.6; extra == "all"
-Requires-Dist: pygments~=2.20; extra == "all"
-Requires-Dist: mypy~=2.3; extra == "all"
-Requires-Dist: pytesseract~=0.3; extra == "all"
-Requires-Dist: rapidocr-onnxruntime~=1.4; extra == "all"
-Requires-Dist: pillow~=12.3; extra == "all"
-Requires-Dist: gprof2dot~=2025.4; extra == "all"
-Requires-Dist: segno~=1.6; extra == "all"
-Requires-Dist: rich~=15.0; extra == "all"
-Requires-Dist: textual~=8.2; extra == "all"
-Requires-Dist: textual-dev~=1.8; extra == "all"
-Requires-Dist: textual-speedups~=0.2; extra == "all"
+Requires-Dist: omcore==0.0.47
 Provides-Extra: ominfra
-Requires-Dist: ominfra==0.0.45; extra == "ominfra"
+Requires-Dist: ominfra==0.0.47; extra == "ominfra"
 Provides-Extra: omllm
-Requires-Dist: omllm==0.0.45; extra == "omllm"
+Requires-Dist: omllm==0.0.47; extra == "omllm"
 Provides-Extra: black
 Requires-Dist: black~=26.5; extra == "black"
 Provides-Extra: c
@@ -48,7 +28,7 @@ Provides-Extra: doc
 Requires-Dist: docutils~=0.23; extra == "doc"
 Requires-Dist: markdown-it-py~=4.2; extra == "doc"
 Requires-Dist: mdit-py-plugins~=0.6; extra == "doc"
-Requires-Dist: pygments~=2.20; extra == "doc"
+Requires-Dist: pygments~=2.21; extra == "doc"
 Provides-Extra: mypy
 Requires-Dist: mypy~=2.3; extra == "mypy"
 Provides-Extra: ocr
@@ -62,9 +42,65 @@ Provides-Extra: qr
 Requires-Dist: segno~=1.6; extra == "qr"
 Provides-Extra: tui
 Requires-Dist: rich~=15.0; extra == "tui"
-Requires-Dist: textual~=8.2; extra == "tui"
-Requires-Dist: textual-dev~=1.8; extra == "tui"
-Requires-Dist: textual-speedups~=0.2; extra == "tui"
+Provides-Extra: tui-syntax
+Requires-Dist: tree-sitter~=0.26; extra == "tui-syntax"
+Requires-Dist: tree-sitter-bash~=0.24; extra == "tui-syntax"
+Requires-Dist: tree-sitter-css~=0.25; extra == "tui-syntax"
+Requires-Dist: tree-sitter-go~=0.25; extra == "tui-syntax"
+Requires-Dist: tree-sitter-html~=0.23; extra == "tui-syntax"
+Requires-Dist: tree-sitter-java~=0.23; extra == "tui-syntax"
+Requires-Dist: tree-sitter-javascript~=0.25; extra == "tui-syntax"
+Requires-Dist: tree-sitter-json~=0.24; extra == "tui-syntax"
+Requires-Dist: tree-sitter-markdown~=0.5; extra == "tui-syntax"
+Requires-Dist: tree-sitter-python~=0.25; extra == "tui-syntax"
+Requires-Dist: tree-sitter-regex~=0.25; extra == "tui-syntax"
+Requires-Dist: tree-sitter-rust~=0.24; extra == "tui-syntax"
+Requires-Dist: tree-sitter-sql~=0.3; extra == "tui-syntax"
+Requires-Dist: tree-sitter-toml~=0.7; extra == "tui-syntax"
+Requires-Dist: tree-sitter-xml~=0.7; extra == "tui-syntax"
+Requires-Dist: tree-sitter-yaml~=0.7; extra == "tui-syntax"
+Provides-Extra: cext
+Requires-Dist: omdev-cext==0.0.47; extra == "cext"
+Provides-Extra: rs
+Requires-Dist: omdev-rs==0.0.47; extra == "rs"
+Provides-Extra: cli
+Requires-Dist: omdev-cli==0.0.47; extra == "cli"
+Provides-Extra: all
+Requires-Dist: ominfra==0.0.47; extra == "all"
+Requires-Dist: omllm==0.0.47; extra == "all"
+Requires-Dist: black~=26.5; extra == "all"
+Requires-Dist: pycparser~=3.0; extra == "all"
+Requires-Dist: pcpp~=1.30; extra == "all"
+Requires-Dist: docutils~=0.23; extra == "all"
+Requires-Dist: markdown-it-py~=4.2; extra == "all"
+Requires-Dist: mdit-py-plugins~=0.6; extra == "all"
+Requires-Dist: pygments~=2.21; extra == "all"
+Requires-Dist: mypy~=2.3; extra == "all"
+Requires-Dist: pytesseract~=0.3; extra == "all"
+Requires-Dist: rapidocr-onnxruntime~=1.4; extra == "all"
+Requires-Dist: pillow~=12.3; extra == "all"
+Requires-Dist: gprof2dot~=2025.4; extra == "all"
+Requires-Dist: segno~=1.6; extra == "all"
+Requires-Dist: rich~=15.0; extra == "all"
+Requires-Dist: tree-sitter~=0.26; extra == "all"
+Requires-Dist: tree-sitter-bash~=0.24; extra == "all"
+Requires-Dist: tree-sitter-css~=0.25; extra == "all"
+Requires-Dist: tree-sitter-go~=0.25; extra == "all"
+Requires-Dist: tree-sitter-html~=0.23; extra == "all"
+Requires-Dist: tree-sitter-java~=0.23; extra == "all"
+Requires-Dist: tree-sitter-javascript~=0.25; extra == "all"
+Requires-Dist: tree-sitter-json~=0.24; extra == "all"
+Requires-Dist: tree-sitter-markdown~=0.5; extra == "all"
+Requires-Dist: tree-sitter-python~=0.25; extra == "all"
+Requires-Dist: tree-sitter-regex~=0.25; extra == "all"
+Requires-Dist: tree-sitter-rust~=0.24; extra == "all"
+Requires-Dist: tree-sitter-sql~=0.3; extra == "all"
+Requires-Dist: tree-sitter-toml~=0.7; extra == "all"
+Requires-Dist: tree-sitter-xml~=0.7; extra == "all"
+Requires-Dist: tree-sitter-yaml~=0.7; extra == "all"
+Requires-Dist: omdev-cext==0.0.47; extra == "all"
+Requires-Dist: omdev-rs==0.0.47; extra == "all"
+Requires-Dist: omdev-cli==0.0.47; extra == "all"
 Dynamic: license-file
 
 # Overview

{omdev-0.0.45 → omdev-0.0.47}/omdev/.om-manifests.json

@@ -343,7 +343,7 @@
     "module": ".tools.cloc",
     "attr": "_CLI_MODULE",
     "file": "omdev/tools/cloc.py",
-    "line": 248,
+    "line": 260,
     "value": {
       "!.cli.types.CliModule": {
         "name": "cloc",
@@ -585,21 +585,6 @@
       }
     }
   },
-  {
-    "module": ".tui.apps.markdown.__main__",
-    "attr": "_CLI_MODULE",
-    "file": "omdev/tui/apps/markdown/__main__.py",
-    "line": 4,
-    "value": {
-      "!.cli.types.CliModule": {
-        "name": [
-          "tui/markdown",
-          "tui/md"
-        ],
-        "module": "omdev.tui.apps.markdown.__main__"
-      }
-    }
-  },
   {
     "module": ".tui.rich.diff.__main__",
     "attr": "_CLI_MODULE",

{omdev-0.0.45 → omdev-0.0.47}/omdev/__about__.py

@@ -37,7 +37,7 @@ class Project(ProjectBase):
             'markdown-it-py ~= 4.2',
             'mdit-py-plugins ~= 0.6',
 
-            'pygments ~= 2.20',
+            'pygments ~= 2.21',
         ],
 
         'mypy': [
@@ -64,9 +64,25 @@ class Project(ProjectBase):
 
         'tui': [
             'rich ~= 15.0',
-            'textual ~= 8.2',  # [syntax]
-            'textual-dev ~= 1.8',
-            'textual-speedups ~= 0.2',
+        ],
+
+        'tui-syntax': [
+            'tree-sitter ~= 0.26',
+            'tree-sitter-bash ~= 0.24',
+            'tree-sitter-css ~= 0.25',
+            'tree-sitter-go ~= 0.25',
+            'tree-sitter-html ~= 0.23',
+            'tree-sitter-java ~= 0.23',
+            'tree-sitter-javascript ~= 0.25',
+            'tree-sitter-json ~= 0.24',
+            'tree-sitter-markdown ~= 0.5',
+            'tree-sitter-python ~= 0.25',
+            'tree-sitter-regex ~= 0.25',
+            'tree-sitter-rust ~= 0.24',
+            'tree-sitter-sql ~= 0.3',
+            'tree-sitter-toml ~= 0.7',
+            'tree-sitter-xml ~= 0.7',
+            'tree-sitter-yaml ~= 0.7',
         ],
     }
 

omdev-0.0.47/omdev/dockerdev/discovery.py

@@ -0,0 +1,35 @@
+"""
+Finding running dockerdev containers, and building a process-manager target to exec into one. This is the seam a
+higher-level "run command X in dev container Y and stream it" API (in omllm) will sit on.
+"""
+
+from omcore.docker import cli as docker_cli
+
+from .run import LABEL_PREFIX
+
+
+##
+
+
+def find_dev_containers() -> list[docker_cli.PsItem]:
+    """Running containers launched by dockerdev (carrying the `om.dockerdev` label), newest docker order."""
+
+    return [
+        pi
+        for pi in docker_cli.cli_ps()
+        if LABEL_PREFIX in (pi.labels or '')
+    ]
+
+
+def find_dev_container_id(name: str | None = None) -> str | None:
+    """
+    The id of a single running dev container, or None if there isn't exactly one match. With `name`, matches a
+    container whose names contain it (dockerdev does not set `--name` today, so this usually matches on id prefix).
+    """
+
+    cs = find_dev_containers()
+    if name is not None:
+        cs = [c for c in cs if name in c.names or c.id.startswith(name)]
+    if len(cs) != 1:
+        return None
+    return cs[0].id

{omdev-0.0.45 → omdev-0.0.47}/omdev/dockerdev/resources/.python-versions.json

@@ -1,9 +1,9 @@
 {
   "8": "3.8.20",
   "9": "3.9.25",
-  "10": "3.10.20",
-  "11": "3.11.15",
-  "12": "3.12.13",
+  "10": "3.10.21",
+  "11": "3.11.16",
+  "12": "3.12.14",
   "13": "3.13.15",
   "13d": "3.13.15d",
   "13t": "3.13.15t",

{omdev-0.0.45 → omdev-0.0.47}/omdev/dockerdev/resources/depsets/system.toml

@@ -85,6 +85,8 @@ deps = [
   'libgdbm6',
   'libpq-dev',
   'libsqlite3-dev',
+  'mysql-server',
+  'postgresql',
   'postgresql-client',
   'redis',
   'sqlite3',

omdev-0.0.47/omdev/dockerdev/resources/scripts/run-mysql

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -ex
+
+if ! sudo test -d /var/lib/mysql/mysql; then
+    sudo mysqld --initialize-insecure --user=mysql
+fi
+
+sudo install -d -o mysql -g mysql -m 0755 /var/run/mysqld
+
+sudo tee /var/run/mysqld/init.sql > /dev/null <<'SQL'
+ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'om';
+CREATE USER IF NOT EXISTS 'root'@'%' IDENTIFIED BY 'om';
+ALTER USER 'root'@'%' IDENTIFIED WITH caching_sha2_password BY 'om';
+GRANT ALL ON *.* TO 'root'@'%' WITH GRANT OPTION;
+CREATE USER IF NOT EXISTS 'om'@'%' IDENTIFIED BY 'om';
+ALTER USER 'om'@'%' IDENTIFIED WITH caching_sha2_password BY 'om';
+SQL
+
+# --skip-log-error overrides the packaged config's log_error file and sends the error log to stderr instead. dumb-init
+# rewrites SIGINT to SIGTERM, as mysqld ignores SIGINT but shuts down cleanly on SIGTERM.
+exec sudo dumb-init --rewrite 2:15 mysqld --user=mysql --init-file=/var/run/mysqld/init.sql --skip-log-error

omdev-0.0.47/omdev/dockerdev/resources/scripts/run-postgres

@@ -0,0 +1,16 @@
+#!/bin/bash
+set -ex
+
+PG_VERSION=$(ls /usr/lib/postgresql | sort -n | tail -n 1)
+PG_BIN=/usr/lib/postgresql/$PG_VERSION/bin
+
+if ! pg_lsclusters -h | grep -q "^$PG_VERSION main "; then
+    sudo pg_createcluster "$PG_VERSION" main
+fi
+
+echo "ALTER USER postgres PASSWORD 'om';" | sudo runuser -u postgres -- "$PG_BIN/postgres" --single \
+    -D "/var/lib/postgresql/$PG_VERSION/main" \
+    -c "config_file=/etc/postgresql/$PG_VERSION/main/postgresql.conf" \
+    postgres
+
+exec sudo pg_ctlcluster "$PG_VERSION" main start --foreground

{omdev-0.0.45 → omdev-0.0.47}/omdev/pyproject/pkg.py

@@ -336,7 +336,21 @@ class PyprojectPackageGenerator(BasePyprojectPackageGenerator):
     def file_contents(self) -> FileContents:
         specs = self.build_specs()
 
-        #
+        ##
+
+        st = dict(specs.setuptools)
+
+        children = [
+            k
+            for k in [
+                'cext',
+                'mypyc',
+                'rs',
+            ]
+            if bool(st.pop(k, None))
+        ]
+
+        ##
 
         pyp_dct = {}
 
@@ -348,17 +362,35 @@ class PyprojectPackageGenerator(BasePyprojectPackageGenerator):
         prj = specs.pyproject
         prj['name'] += self._pkg_suffix
 
+        if prj.pop('cli-scripts', None):
+            children.append('cli')
+
         pyp_dct['project'] = prj
 
-        self._move_dict_key(prj, 'optional-dependencies', pyp_dct, extrask := 'project.optional-dependencies')
+        self._move_dict_key(
+            prj,
+            'optional-dependencies',
+            pyp_dct,
+            extrask := 'project.optional-dependencies',
+        )
+
+        if children:
+            pyp_dct[extrask] = {
+                **(pyp_dct.get(extrask, {})),
+                **{
+                    ext: [f'{prj["name"]}-{ext} == {prj["version"]}']
+                    for ext in children
+                },
+            }
+
         if (extras := pyp_dct.get(extrask)):
             pyp_dct[extrask] = {
+                **extras,
                 'all': [
                     e
                     for lst in extras.values()
                     for e in lst
                 ],
-                **extras,
             }
 
         if (eps := prj.pop('entry-points', None)):
@@ -367,20 +399,10 @@ class PyprojectPackageGenerator(BasePyprojectPackageGenerator):
         if (scs := prj.pop('scripts', None)):
             pyp_dct['project.scripts'] = scs
 
-        prj.pop('cli-scripts', None)
-
         ##
 
-        st = dict(specs.setuptools)
         pyp_dct['tool.setuptools'] = st
 
-        for k in [
-            'cext',
-            'mypyc',
-            'rs',
-        ]:
-            st.pop(k, None)
-
         #
 
         # TODO: default

{omdev-0.0.45 → omdev-0.0.47}/omdev/scripts/pyproject.py

@@ -156,7 +156,7 @@ def __om_amalg__():  # noqa
             dict(path='../interp/providers/system.py', sha1='5b337476498d3187d4a8774f04f9e634f60972fb'),
             dict(path='../interp/pyenv/install.py', sha1='c2e2a6c9ebb36b1dd09482662bdafdb59c75ae81'),
             dict(path='../interp/uv/provider.py', sha1='fcb5939d4038b41c1a3e887feb10cfcb0924107c'),
-            dict(path='pkg.py', sha1='0d7711930ff032230b9fd6b27f9ce6dacaaf9d85'),
+            dict(path='pkg.py', sha1='0662a0ee6a75a207d76cccd69f48fedb4eda3df8'),
             dict(path='../interp/providers/inject.py', sha1='558f0761ce1bd375136f9e733c8674895eec9e62'),
             dict(path='../interp/pyenv/provider.py', sha1='2d9ef6be0b9dd151361a6e8604a682fa74f9920c'),
             dict(path='../interp/uv/inject.py', sha1='86cc5b6b8fa88beaa9f468bf05c078f8af330a23'),
@@ -12959,7 +12959,21 @@ class PyprojectPackageGenerator(BasePyprojectPackageGenerator):
     def file_contents(self) -> FileContents:
         specs = self.build_specs()
 
-        #
+        ##
+
+        st = dict(specs.setuptools)
+
+        children = [
+            k
+            for k in [
+                'cext',
+                'mypyc',
+                'rs',
+            ]
+            if bool(st.pop(k, None))
+        ]
+
+        ##
 
         pyp_dct = {}
 
@@ -12971,17 +12985,35 @@ class PyprojectPackageGenerator(BasePyprojectPackageGenerator):
         prj = specs.pyproject
         prj['name'] += self._pkg_suffix
 
+        if prj.pop('cli-scripts', None):
+            children.append('cli')
+
         pyp_dct['project'] = prj
 
-        self._move_dict_key(prj, 'optional-dependencies', pyp_dct, extrask := 'project.optional-dependencies')
+        self._move_dict_key(
+            prj,
+            'optional-dependencies',
+            pyp_dct,
+            extrask := 'project.optional-dependencies',
+        )
+
+        if children:
+            pyp_dct[extrask] = {
+                **(pyp_dct.get(extrask, {})),
+                **{
+                    ext: [f'{prj["name"]}-{ext} == {prj["version"]}']
+                    for ext in children
+                },
+            }
+
         if (extras := pyp_dct.get(extrask)):
             pyp_dct[extrask] = {
+                **extras,
                 'all': [
                     e
                     for lst in extras.values()
                     for e in lst
                 ],
-                **extras,
             }
 
         if (eps := prj.pop('entry-points', None)):
@@ -12990,20 +13022,10 @@ class PyprojectPackageGenerator(BasePyprojectPackageGenerator):
         if (scs := prj.pop('scripts', None)):
             pyp_dct['project.scripts'] = scs
 
-        prj.pop('cli-scripts', None)
-
         ##
 
-        st = dict(specs.setuptools)
         pyp_dct['tool.setuptools'] = st
 
-        for k in [
-            'cext',
-            'mypyc',
-            'rs',
-        ]:
-            st.pop(k, None)
-
         #
 
         # TODO: default

{omdev-0.0.45 → omdev-0.0.47}/omdev/specs/jsonschema/codegen/ir.py

@@ -119,7 +119,7 @@ class EmptyTypeDef(lang.Final):
     name: str
 
 
-TypeDef: ta.TypeAlias = ta.Union[  # noqa
+TypeDef: ta.TypeAlias = ta.Union[  # noqa: UP007
     ObjectTypeDef,
     StringEnumTypeDef,
     DiscriminatedUnionTypeDef,

{omdev-0.0.45 → omdev-0.0.47}/omdev/tools/cloc.py

@@ -41,9 +41,21 @@ _LANG = [
         comment_pats=(r'//', r'/\*', r'\*/'),
     ),
 
+    Lang(
+        'rust',
+        {'.rs'},
+        comment_pats=(r'//', r'/\*', r'\*/'),
+    ),
+
     Lang(
         'javascript',
-        {'.js'},
+        {'.js', '.mjs'},
+        comment_pats=(r'//', r'/\*', r'\*/'),
+    ),
+
+    Lang(
+        'typescript',
+        {'.ts'},
         comment_pats=(r'//', r'/\*', r'\*/'),
     ),
 ]

{omdev-0.0.45 → omdev-0.0.47}/omdev/tools/git/cli.py

@@ -122,7 +122,7 @@ class Cli(ap.Cli):
         except FileNotFoundError:
             return dc.asdict(self.Config())  # noqa
 
-        return yaml.safe_load(buf) or {}
+        return yaml.loads(buf) or {}
 
     class _NOT_SET(lang.Marker):  # noqa
         pass
@@ -143,7 +143,7 @@ class Cli(ap.Cli):
     )
     def print_cfg(self) -> None:
         cfg = self.load_config(self._args.dir)
-        print(yaml.dump(msh.marshal(cfg)))
+        print(yaml.dumps(msh.marshal(cfg)))
 
     #
 

omdev-0.0.47/omdev/tui/minitui/README.md

@@ -0,0 +1,57 @@
+# minitui
+
+A zero-dependency TUI library built around being a good terminal citizen: app output is a **log plus a live tail**.
+Finalized content commits into the terminal's own scrollback (native scrolling, tmux-friendly, survives exit); only the
+bottom few rows - the streaming tail, a vim-powered input, a status bar - are retained-frame diffed and redrawn in place
+on the main screen. No alternate screen required (one exists for genuinely-fullscreen apps), no CSS, no reactive layer,
+no DOM, no string-eval dispatch: dataclasses, direct calls, and typed events throughout.
+
+Built primarily for llm coding-agent chat TUIs, deliberately generalized for any interactive-repl-ish thing.
+
+## Try it
+
+```bash
+./python -m omdev.tui.minitui.apps.chatdemo               # streaming markdown chat: tool cards (f10/f2), /help, history, search
+./python -m omdev.tui.minitui.apps.chatdemo --md=pdcmark  # swap the streaming markdown backend (internal|pdcmark|markdown-it)
+./python -m omdev.tui.minitui.apps.chatdemo --mouse       # + click-to-expand cards / click suggestions (trades wheel scrollback)
+./python -m omdev.tui.minitui.apps.inputdemo              # minimal typing-while-streaming proof
+./python -m omdev.tui.minitui.apps.streamdemo             # the bare commit model, no input
+./python -m omdev.tui.minitui.apps.vimdemo f.py           # fullscreen vim clone (:w/:q, ctrl+v blocks, %/~/zz), tree-sitter highlighted
+```
+
+Run them in tmux and scroll back; add `--visualize-redraws` to streamdemo to watch damage regions.
+
+## Architecture (dependencies point strictly inward)
+
+    apps -> runtime -> controls -> { surfaces, events, docs+vim } -> screens -> text
+
+- **text/** - structured `Style`/`Color` (+ depth downgrade), styled segments, word wrap, width measurement, SGR
+  emit/parse, streaming markdown with swappable backends (zero-dep internal / omcore pdcmark / markdown-it) over a
+  shared block model, the `Highlighter` protocol with python (stdlib tokenize) and diff highlighters.
+- **screens/** - `Cell`/`Line`/`Frame` and retained-frame diffing: the correctness ground truth. Spurious redraws cost a
+  re-render and an empty diff, never visible output.
+- **surfaces/** - `InlineSurface` (the commit model: relative cursor tracking, `\r\n`-forced scrolling, commit-above
+  re-anchoring, CPR origin negotiation) and `AltSurface` (fullscreen, absolute addressing). Terminfo for output
+  capabilities; hardcoded-xterm fallbacks; runtime-negotiated extras (kitty keys, bracketed paste, sync output).
+- **events/** - typed `Key`/events, a generator escape-sequence parser with clock-free cooperative timeouts, keymap trie
+  with vim's two-timeout semantics, SGR mouse / CPR / DECRQM / kitty decoding.
+- **docs/** - `Document` mutated only through range edits (`TextEdit`, tree-sitter/LSP-shaped) carrying exact inverses;
+  position remapping; cursor-tuple groundwork for multi-cursor; smartcase search; the incremental highlighter protocol
+  with the (optional, quarantined) tree-sitter implementation riding those same edits.
+- **vim/** - the modal engine (grown from `x/vibes/minivim`): motions/operators/text objects/registers, edit-group
+  undo/redo, CMDLINE mode with incremental search, blockwise visual (ctrl+v) with live multi-cursor I/A/c replication,
+  `%`/`~`, `status()`/`decorations()` as its only outputs. Never renders, never reads a keyboard.
+- **controls/** - small and passive: `TextArea` (a scrolled vim window - grows to a max height, then the viewport
+  follows the cursor; optional syntax highlighting under engine decorations; ctrl+d/u, zz/zt/zb, H/M/L viewport ops),
+  status bar, statics, spinner, suggestions popup, markdown tail, lifecycle cards, input history, stack layout with
+  mouse hit regions.
+- **runtime/** - `SyncDriver` (poll + self-pipe) and `AsyncDriver` (asyncio; `post()` is the sole thread-safe entry).
+  Both share the `App` contract: `render(width, max_height) -> Frame` + `handle_event(event)`, with coalescing
+  invalidation.
+
+## Notes
+
+- `_devdocs/` holds the design docs and the running dev journal - read `intro.md` first.
+- Files with PSF license headers derive from cpython via `x/term/pyrepl`; they stay coherent units.
+- Tests run against the `omcore.term.vt100` emulator (screen + scrollback assertions on real emitted bytes) plus
+  pty-level end-to-end runs of the demo apps.