agent (cont.)

+0:48
  • read_file{"Path":"~/work/lowmarch/docs/vroid.md"}

    input

    {
      "Path": "~/work/lowmarch/docs/vroid.md"
    }

    result, 272 lines

    Showing lines 1-271 of 271
    1: # VRoid base models
    2: 
    3: **Status (2026-11-09):** current. The files carry 57 expression shapes (2.14 exports) or 56 (older), not the 54 below. Licence terms were read by hand on 11-09: see "Licence, read 2026-11-09" below, which replaces the licence notes further down (led #1443).
    4: 
    5: ## Licence, read 2026-11-09
    6: 
    7: Read by hand from pixiv's own pages on 2026-11-09 (headless browser, no login). Page copies and text dumps are in
    8: `~/citadel-render/workers/handoff/overnight-1109/lowmarch-prep/pages/`. This is a reading of the terms, not legal advice.
    9: The English terms of use are a translation; pixiv says the Japanese original prevails.
    10: 
    11: Sources, with the date each page gives:
    12: - **[G]** VRoid Studio guidelines, edited 2023-12-21: <https://vroid.com/en/studio/guidelines>
    13: - **[T]** VRoid Studio terms of use, revised 2026-06-24 (articles renumbered then): <https://policies.pixiv.net/en.html#vroidstudio>
    14: - **[AZ]** "VRoidPreset_A - Z", the page the 2.14 samples point at, updated 2024-12-26: <https://vroid.pixiv.help/hc/en-us/articles/4402394424089>
    15: - **[SC]** "Do VRoid Studio's sample models come with conditions of use?", undated: <https://vroid.pixiv.help/hc/en-us/articles/4402614652569>
    16: - **[F]** FAQ "Can I use the models created with VRoid Studio Stable Ver. for commercial purposes?": <https://vroid.pixiv.help/hc/en-us/articles/4405813333657>
    17: - **[β1 to β4]** <https://vroid.pixiv.help/hc/en-us/articles/360012381793>, `.../360014900273`, `.../360014900113`, `.../360014900233`
    18: - **[SF]** Sakurada Fumiriya <https://vroid.pixiv.help/hc/en-us/articles/360014788554>; **[SS]** Sendagaya Shino <https://vroid.pixiv.help/hc/en-us/articles/360013482714>
    19: - **[H]** VRoid Hub terms <https://policies.pixiv.net/en.html#vroidhub>, and the official VRoid Project account's model licences
    20:   (read from `hub.vroid.com/api/character_models/<id>`, the same JSON the model page shows)
    21: 
    22: ### What we hold, and whose terms apply
    23: 
    24: | Our folder | What it is | pixiv's terms |
    25: |---|---|---|
    26: | `avatarsample_d` to `_g` (OpenGameArt) | Not the 2.14 D to G. They are β Ver AvatarSample_1 to 4: Sendagaya Shibu, Vivi, Vita, Victoria Rubin (file titles match the Japanese β pages) | CC0 [β1 to β4]. The official Hub copy of β1 also allows everything, credit unnecessary [H] |
    27: | `sakurada_fumiriya`, `sendagaya_shino` | VRoid's mascots | CC0 [SF] [SS]. Official Hub copies allow everything, credit unnecessary [H] |
    28: | `hairsample_male`, `hairsample_female` | alpha-era hair samples | CC0 [SC] |
    29: | `base_male`, `base_female` (OpenGameArt) | alpha-era bases, Studio 0.14 exports | **Unclear.** [SC] lists "Base models" under CC0, as a picture of the 2021 bases. [G] says "All content provided by pixiv, including the base models when creating a new avatar, is not CC0." Either way [T] Art. 13 licenses them for any purpose |
    30: | `samples_2_14/avatarsample_a` to `_z` | VRoidPreset A to Z, from Studio 2.14 | [AZ]: not CC0, any use, no credit, a list of prohibited acts (below) |
    31: | `lowmarch_bodies/base_masc`, `base_fem` | Studio 2.14 new-model bases | Provided Content under [T] Art. 13: any purpose, not CC0 [G] |
    32: | `faces/face_sexy.vrm`, our armory bodies | our own outputs | Ours, except the pixiv content inside them, which keeps its own terms [T] Art. 11 |
    33: 
    34: The armory bodies are built on `base_masc`/`base_fem` with A to Z faces and hair, so [T] and [AZ] are the terms that
    35: matter for them.
    36: 
    37: ### 1. A character made in VRoid Studio from scratch
    38: 
    39: Allowed: ship it in a game, sell the game, show it on a public page, post renders on a public blog, change it in code.
    40: - Rights: "The copyright and other rights for textures and hair meshes you created from scratch on VRoid Studio or other
    41:   tools belong to you, the creator." The body and clothing meshes and presets are pixiv's, licensed "so that you can use
    42:   it for as wide a range of purposes as possible." [G]
    43: - Licence: pixiv grants "a non-exclusive, perpetual, worldwide, non-transferable, non-sublicensable license to use,
    44:   duplicate, archive, modify, and display Provided Content ... for (1) any purpose and (2) any use, except where
    45:   different license conditions are specified and displayed for individual items" [T] Art. 13.
    46: - Games, sale, web pages, renders: "You can use images and videos of models created with VRoid Studio and generate
    47:   profit from videos, books, ... games, applications, software, collections of materials, websites" and "You can sell
    48:   the model data exported from VRoid Studio." [G]
    49: - Changing it in code: "You can edit and use the model data exported from VRoid Studio using software other than VRoid
    50:   Studio." [G]
    51: - Limits: items with their own clause keep it ("When using items that display special licensing terms, please observe
    52:   those specific terms" [G]); nothing may suggest pixiv backs it ("refrain from creating any publication or video
    53:   production that leads people to believe it was created in collaboration with VRoid Studio or pixiv Inc." [G]); and
    54:   the character-creator rule in 3.
    55: 
    56: ### 2. The sample avatars
    57: 
    58: - **β 1 to 4 (our old D to G), Sakurada Fumiriya, Sendagaya Shino:** all of the above, with no conditions. "The CC
    59:   license* for this model is CC0. This model can be edited and used freely." [β1] [SF] [SS]
    60: - **A to Z (2.14):** game, sale, public page, blog renders and code changes are allowed. "This model's .vroid and VRM
    61:   files can be used by anyone in any kind of activity, be it for-profit or not." Examples given: "Edit its texture and
    62:   parameters, and create an original 3D character" and "Edit its texture and parameters, upload it to BOOTH for sale to
    63:   others." [AZ] Prohibited, among others [AZ]:
    64:   - "Distributing a sample model or its VRM file to a third party by setting the 'Redistribution and alteration'
    65:     conditions of use to 'Copyright Disclaimer (CC0)'."
    66:   - "Development of a character creation service using data contained in the sample model, or diversion of data
    67:     contained in the sample model to an existing character creation service."
    68:   - "Redistributing the .vroid or VRM file of the sample model (or other data such as image data within the model) in
    69:     exchange for a fee."
    70:   - "Acts that can lure people into thinking that the Company supports or recommends some product/event."
    71:   - pixiv may narrow the terms later: "it's possible that the conditions of use may be limited if there are incidents".
    72: - **Unclear:** whether a paid game that ships a sample's textures unedited (our faces keep each sample's iris,
    73:   highlight, brow and eyeline drawings as they are) counts as redistributing "image data within the model" for a fee.
    74:   Edited and sold is allowed; how much editing is enough isn't said.
    75: - **Metadata against the page:** for our use, pixiv's page wins. The licence fields in our 2.14 exports
    76:   (`Redistribution_Prohibited`, `OnlyAuthor`, commercial `Disallow`) were set at our export, not by pixiv: "Users will
    77:   be licensed to set licenses freely for VRM data constituting Output Items, as long as they do not breach the license
    78:   conditions for Provided Content" [T] Art. 12. They bind whoever receives our file, not us. pixiv's own terms for its
    79:   items apply to us: "Where the Company has specified and displayed license conditions for individual items of Provided
    80:   Content, Users will use such Provided Content in accordance therewith" [T] Art. 13. No page states a precedence rule
    81:   in so many words; this is a reading of those two articles. The OpenGameArt files carry pixiv's own metadata (a VRoid
    82:   Hub licence allowing everything, or CC0), which agrees with the pages.
    83: - If we ever hand out VRM files built on A to Z, their licence field must not be CC0 [AZ].
    84: 
    85: ### 3. A player-facing character creator
    86: 
    87: Confirmed: it needs a separate licence from pixiv, and pixiv may refuse.
    88: - "Users are not licensed to use Provided Content, or 3D models or Output Items containing Provided Content, to create
    89:   applications having functions that allow avatars, items, or other 3D models to be created by deforming meshes or
    90:   combining meshes or textures. When a User wishes to create an application containing such a function, they must
    91:   receive a separate license from the Company; provided, however, that this does not apply when the User is creating
    92:   the application for personal use." [T] Art. 13; also a prohibited act in [T] Art. 7.
    93: - "Please contact us if you'd like an application creation license. It's possible that we may decline granting you a
    94:   license." [G] [F]
    95: - [AZ] prohibits a creator built on A to Z data outright and names no licence route.
    96: - So our own build tools are fine (personal use), and baked characters in a game are fine. A creator in the game, built
    97:   on anything from Studio 2.x or A to Z, needs pixiv's licence.
    98: - **Unclear:** whether CC0 parts alone (β 1 to 4, the mascots, the hair samples) would escape this. CC0 waives
    99:   copyright, but [T] is a contract we agreed to by using Studio, and our exports pass through it. Not settled by the
    100:   pages.
    101: 
    102: ### 4. Credit lines
    103: 
    104: None required.
    105: - A to Z: "There is no need to credit the original creator when using this sample model." [AZ]
    106: - CC0 models: "Copyright is waived, and there is no particular limit when using them." [β1]
    107: - Official VRoid Hub copies: `credit: unnecessary` [H].
    108: - Studio outputs: [G] and [T] ask for none (none found). [G] asks only that nothing implies pixiv's backing, and notes
    109:   "VRoid is a trademark or registered trademark of pixiv Inc."
    110: 
    111: ### Superseded
    112: 
    113: The licence notes further down (the table's "Licence in the file", the yomox9 D to Z note, "That page is behind a
    114: Cloudflare check and wasn't read") predate this read. Where they differ, this section holds.
    115: 
    116: Since 2026-10-08 our portraits (and later battle sprites) are rendered from VRoid sample models
    117: through our own pipeline. VRoid supplies a professionally built anime head, hair, body, skeleton and
    118: 54 expression shapes. Pose, archetype reshaping, hair swaps, colours, shading, outlines and the
    119: reduction to GBA pixels are ours.
    120: 
    121: ## Where they live
    122: 
    123: `~/.local/share/lowmarch/vroid/<name>/*.vrm` (override with `LOWMARCH_VROID`). They are 11–17 MB
    124: each and stay out of the repo. Source: <https://opengameart.org/content/vroid-studio-cc0-models>.
    125: 
    126: | Model | Licence in the file |
    127: |---|---|
    128: | Base_Male, Base_Female, HairSample_Male, HairSample_Female | CC0 |
    129: | AvatarSample D–G, Sakurada Fumiriya, Sendagaya Shino | VRoid Hub licence: everyone, commercial use allowed, modification allowed, redistribution allowed, credit unnecessary |
    130: 
    131: The last two are VRoid's mascot characters. Use their parts (hair), not their look. Our characters
    132: are built from the CC0 bodies.
    133: 
    134: **AvatarSample A–Z (researched 2026-10-09):** exported by `tools/winvroid` into `samples_2_14/avatarsample_<x>/` (apart from the older D–G above, which are other characters).
    135: All 26 were exported on 2026-10-10 (VRM 0.0, VRoid Studio 2.14, 15 to 22 MB each). They are clothed
    136: exports, so VRoid has deleted the body skin under their clothes: use their heads and hair, not their bodies.
    137: 
    138: **VRoid's own bases, unclothed (2026-10-10):** `lowmarch_bodies/base_masc.vrm` and `base_fem.vrm`: a new
    139: character from the Masc or Fem base at default settings, every outfit category set to none, exported as
    140: VRM 0.0 (`python3 tools/winvroid/winvroid.py bases`). They keep all their skin (10,934 body triangles;
    141: the old `base_male/Base_Male.vrm` export has 7,340). The briefs and band are painted on the skin texture,
    142: not geometry. `tools/mass.py` builds on `base_masc.vrm`.
    143:  VRoid Studio 2.1.0 and later ship 26
    144: sample avatars. The VRoid Project account on VRoid Hub publishes A–C with VRoid Hub's licence:
    145: - everyone may use them;
    146: - corporate commercial use is allowed;
    147: - modification and redistribution are allowed;
    148: - no credit is needed.
    149: 
    150: D–Z are on VRoid Hub only as exports by another user (yomox9, character 2175138617022572467). Their
    151: files carry the same terms in VRM 1.0 metadata (`commercialUsage: corporation`,
    152: `allowModificationRedistribution`, credit unnecessary), pointing at pixiv's "AvatarSample A-Z" help page.
    153: That page is behind a Cloudflare check and wasn't read. Take them from VRoid Studio itself, or the
    154: official account where it has them.
    155: 
    156: What the set offers:
    157: - about 9 male and 17 female faces, all young and slim, two of them adult men (T, V);
    158: - different eye drawings, hair and outfits.
    159: 
    160: **VRoid Studio's guidelines** (vroid.com/en/studio/guidelines, read 2026-10-09):
    161: - **Allowed:** models made in VRoid Studio may be sold, edited in other software, and used in games.
    162: - **Restricted:** "You cannot create an application that can generate or output 3D models, avatars,
    163:   or items consisting of deformed or combined meshes and textures that were created in VRoid Studio"
    164:   without a separate licence from pixiv. Tools meant only for your own use are exempt.
    165: - **For us:** our build pipeline (the graft, the costume kit) is for our own use, and shipping baked
    166:   characters in the game is fine. A player-facing character creator built on VRoid parts would need
    167:   pixiv's licence.
    168: 
    169: ## Heads (`tools/heads.py`, 2026-10-13)
    170: 
    171: The armory's bodies all wore VRoid's base face. A head is now one of the 26 samples' faces on our base:
    172: - **One template:** every VRoid face mesh has the same skin, eye-white and mouth triangles and texture coordinates
    173:   (4,232 skin triangles in each), so a face moves vertex for vertex. The irises, highlights, brows and eyelines are
    174:   each sample's own geometry: that is where its eye drawing lives, and it comes along whole.
    175: - **Only the face is taken:** eyes, nose, mouth, cheeks and jaw, fading out up the forehead, toward the ears and toward
    176:   the seam with the body. VRoid's face mesh is the head's front; the back of the skull is in the body mesh, and the
    177:   seam between them runs from the neck to the crown. Taking a sample's whole front set its skull against the base's
    178:   back, and VRoid's hair base (the short cap) couldn't sit on both. The base's skull, ears, seam and cap stay.
    179: - **Also taken:** the sample's 57 expressions (the same names, in the same order, in every model), its skin weights
    180:   mapped by bone name, its eye bones (so the eyes turn about their own centres), and its eye, brow, eyeline and mouth
    181:   materials. The face skin keeps the base's texture, so the skin tone matches the body.
    182: - **Sculpted in the file:** the face controls of `tools/vroid_portrait.py` (lower-face length, jaw, chin, cheek, brow
    183:   ridge, nose, eye size and tilt, iris, mouth), with one rule for the face and the neck so the seam holds. The checks
    184:   then measure the face that is shown.
    185: - **Blends:** a face spec's `sample` may be several samples with weights; the face's shape is their weighted mean
    186:   (one template, so a blend stays coherent from every angle) and the first gives the eye drawing and expressions.
    187: - **Not fitted (2026-10-13):** `heads.fitted` can move the lower face's length, the cheeks and the eye size until a
    188:   face archetype's ratios pass (`docs/proportions.md`), but the armory doesn't use it. Those ratios were measured on
    189:   the study's paintings, mostly seen from the front; held to them, faces were stretched (lower faces up to 17%
    190:   longer, eyes 20% larger) and read too sharp from the side and too wide from the front. VRoid's faces all set the
    191:   eyes low (0.56 to 0.64 of the head down from the crown), the young look; the study's adults have them at 0.40 to
    192:   0.58. The armory's faces are VRoid's as built, chosen and blended by look, and the ratios are reported.
    193: - **Then the cage** (`tools/cage.py`, a spec's `face`) builds the body on the headed base and sizes the head to its
    194:   reference's, so head size stays held in metres.
    195: 
    196: What the face rests in (a frown, half-closed eyes) and age lines are drawn when the figure is built, not in the file.
    197: 
    198: ## Tools
    199: 
    200: - `tools/vrm.py`: VRM/glTF loader (meshes, materials, textures, morph targets, skins) and a numpy
    201:   z-buffer rasterizer with alpha testing.
    202: - `tools/vroid_portrait.py`: `Portrait(model, morphs, pose, shape, hair_from)` and `.render(yaw)`
    203:   give a 96×80 char grid; `image(char, palette=...)` gives a PNG; `smooth_view()` shows the 3D model.
    204: - `tools/outfit.py`: costume pieces generated in code and fitted to the posed body (`COSTUMES`).
    205: - `art/cast/cast.py`: one entry per character (base model, hair donor, shape controls, colours, costume).
    206: 
    207: ## Notes
    208: 
    209: - VRoid models face −z; `FLIP` turns them toward the camera. Character's left is −x.
    210: - They stand in a T-pose. `BUST_POSE` lowers the arms through linear blend skinning.
    211: - Expression names end in `Fcl_EYE_Close`, `Fcl_MTH_A`, `Fcl_ALL_Joy` and so on; match the suffix
    212:   exactly (`_Close` also prefixes `_Close_L`).
    213: - The eyeline texture is a thick graded band over the iris. Only texels darker than `LID_CORE`
    214:   count as the lash line, or the eyes read as half shut at 1×.
    215: 
    216: ## Review tooling
    217: 
    218: `python3 review/vroid-02/build.py aldric` builds the model viewer: `bust`/`battle` GLB models
    219: (`tools/export_glb.py`), pixel frames every 15°, and `camera.json` so the three.js orthographic
    220: camera matches the pixel camera exactly. `tools/poses.py` holds poses (BUST, BATTLE_IDLE, `fist`),
    221: `tools/terrain.py` holds battle ground (`plains`).
    222: 
    223: ## Hair (`tools/heads.py`, 2026-10-13)
    224: 
    225: A head spec's `hair` names a sample whose hairstyle goes on. Every VRoid head matches point for point (the face skin,
    226: and the 562 vertices of skull in the body mesh, by texture coordinates), so the style is warped from its sample's
    227: head onto ours (a similarity plus the matched points' residuals spread by inverse distance) and held 1.5 mm off the
    228: skin. It keeps its hair base (HairBack), which replaces the base's; its hair bones (only those its mesh moves with:
    229: the samples' skins list accessory ears too, and the weightless end bones that say where a lock's last bone points);
    230: its spring groups; and its head's collision sphere, warped onto our head. `tools/cage.py` scales the head's sphere
    231: and the hair's spring radius with the head. Hair colour is the character's.
    232: 
    233: **Collision (`tools/collide.py`, 2026-10-13).** Spring bones collide only with spheres the model carries
    234: (`secondaryAnimation.colliderGroups`); every runtime that plays a VRM (UniVRM, three-vrm, the review page) runs
    235: those and nothing else, so what the hair can't pass through is set here, not by the engine. The samples' body
    236: spheres were sized for VRoid's slim sample bodies, with none over the back or bust, and v11's hair sank up to
    237: 6 cm into our bodies' upper backs, shoulders and napes. Now, on each finished body, `tools/cage.py` calls
    238: `collide.hair`:
    239: - **Spheres fitted to the skin:** medial balls (each touching the skin at a point, as large as fits inside), chosen
    240:   greedily until all the skin the hair can reach (within a lock's length below its joints; the shoulders and upper
    241:   arms whole once the hair reaches them) stands within 1 cm of one. Each rides the bone most of its skin is
    242:   weighted to, the breasts' spring bones included. They stand 2 cm out from the skin: a lock's bone runs down its
    243:   middle, and VRoid's locks stand a median 2.3 cm round it, so a bone held at the skin left the lock in it. That
    244:   comes to 30 to 60 spheres per body.
    245: - **The hair draped at rest:** each lock's bones, root to tip, keep their own way unless the body is in it. A bone
    246:   is turned until its whole length (not only its tail: the body bulges between two joints) is out of the spheres
    247:   and the mesh it carries stands off the skin, and what no turn can lift (points the head carries) is pushed off.
    248:   That is the bind pose, so the hair starts where it rests, not inside the body.
    249: - **The check:** `tools/hair_check.py` replays the page's spring bones (Still, Twist, Bounce; arms out or down) and
    250:   counts hair vertices inside the skin.
    251: 
    252: ## Designing faces in VRoid Studio (first session, 2026-10-13)
    253: 
    254: - **The face editor** (Face tab) has 89 sliders: eye size, position and slant, eyelids, droopy and scornful eyes,
    255:   iris size, brows, nose, mouth and lips, teeth, ears, jaw, chin and cheeks, and masculine and feminine blends of
    256:   each feature. Its **Face Sets** are presets that set many sliders and textures at once (eye, lash and brow
    257:   drawings, lips, blush). Several read more adult than any of the 26 samples.
    258: - **The sliders are subtle:** a step of 0.2 to 0.3 barely shows at full-head zoom. Presets move the face far more.
    259: - **A face made there transplants like a sample:** export it (`winvroid.export_vrm`) to `faces/` under
    260:   `LOWMARCH_VROID`, and name it in a head spec (`cast._head(face="faces/....vrm", makeup=True)`; `makeup` keeps its
    261:   lips, blush and eye shadow, which live on the face's skin texture).
    262: - **First result:** one face, the sexy woman's, from preset 11 (lashes, almond eyes, fuller lips) with a longer chin,
    263:   sunken cheeks, heavier lids and upturned corners. In the painted renderer its glossy eyes and blush read cuter,
    264:   not sultrier, so it was kept aside (`faces/face_sexy.vrm`). Next time: start from a narrower-eyed preset (3 or 5)
    265:   and change the iris to one with small highlights.
    266: - **The driver** (`tools/winvroid`): the parameter panel scrolls smoothly and is long (89 rows), so a row search
    267:   waits for it to settle and scrolls 140 ticks to the top. A notification toast took the foreground from VRoid
    268:   repeatedly and Windows refused to give it back; `front()` now falls back to a real click on VRoid's own title bar,
    269:   checked to be VRoid's window. **That change stopped the session:** it rebuilt the driver's helper DLL (V.dll), and
    270:   Windows' application control ("An Application Control policy has blocked this file") refuses to load the new,
    271:   unsigned build. The PC's owner has to allow it before the driver works again.
  • read_file{"Path":"~/work/lowmarch/docs/map.md"}

    input

    {
      "Path": "~/work/lowmarch/docs/map.md"
    }

    result, 70 lines

    Showing lines 1-69 of 69
    1: # Map of the repo
    2: 
    3: What's current, what's stale, where the big files are. Checked 2026-11-08 at `c4f1015`. Nothing was moved or deleted.
    4: "Live" means the armory build or the first-session kit reaches it. Reach was read from imports, including the
    5: `__import__` calls in `outfit.py`, not from running every path.
    6: 
    7: ## Docs
    8: 
    9: | File | Status |
    10: |---|---|
    11: | `handbook.md` | **Start here** |
    12: | `map.md`, `todos-2026-11-08.md` | Current; suggestions only |
    13: | `portrait-guide.md` | Detail log, 40 lessons. True when written, some since contradicted; marks are in the handbook |
    14: | `vroid.md` | Current. Says 54 expression shapes at the top; the files carry 57 (2.14) and 56 (older). Licence: see #1443 |
    15: | `anthro.md` | Current for bodies |
    16: | `proportions.md` | Bodies current; face ratios are reported, not held, since lesson 30 |
    17: | `makehuman.md` | Current: references for the cage |
    18: | `study.md` | Current; one clause is guessed (handbook, Things that don't bend) |
    19: | `quaternius.md` | Stale: a spike that lost (lesson 21) |
    20: 
    21: ## Tools
    22: 
    23: **First-session kit (new):** `tools/session/` (`frame.py`, `rows.py`, `smoke.sh`, `smoke_spec.json`), `review/frame/index.html`.
    24: 
    25: **Render scripts (copied in 11-08 from `~/Projects/lowmarch-bench/kit`, which still has the originals):** `tools/shots/`:
    26: `arm_shoot.py` (ran 11-08), `variant_build.py`, `all14.sh`, `all14_sheet.py`, `expr_build_tiles.py`, `expr_page.html`. Only
    27: `all14.sh` changed, to find its own folder.
    28: 
    29: | Status | Files |
    30: |---|---|
    31: | Live: the armory | `cage`, `heads`, `fit`, `proportions`, `anthro`, `makehuman`, `collide`, `vroid_portrait`, `vrm`, `export_glb`, `poses`, `rig`, `fitting`; `review/vroid-02/build.py`, `sheets.py`, `index.html`; `art/cast/cast.py`, `expressions.txt` |
    32: | Live checks | `lash_check`, `lash_shots`, `checks`, `regress`, `review/vroid-02/snapshot.py` (keeps the baseline `regress` reads), `review/vroid-02/duel_check.py` (build imports `chars_for` from it), `hair_check` (standalone, nothing imports it) |
    33: | Kept for later: costumes and motion on old bases, reached from the build | `outfit`, `plates`, `gear`, `mobs`, `hair`, `clips`, `duel`, `terrain`, `saber_study` (benchmark, not for the game). Not unused: the armory's inspection shorts come from `mobs.underwear` and the hair texture from `hair` |
    34: | Spike that lost, still imported by the build | `mass`, `quaternius` |
    35: | Pixel era, abandoned; still imported | `head3d`, `pix`, `vecpix`, `study` |
    36: | Blocked | `tools/winvroid` (V.dll, #1105) |
    37: | Looks dead: nothing imports it | `features.py`, `compare.py` (study side-by-sides) |
    38: | Looks dead: old one-off tests, nothing imports them | `review/vroid-02/`: `battle_test`, `closeup_test`, `costume_test`, `fit_test`, `pose_test`, `mouths` |
    39: | Stale pages | `review/rowan-01/`, `art/portraits/rowan*`, `art/templates/`, `review/vroid-02/base_spike_notes.html`, `mh_workshop_notes.html` |
    40: 
    41: `vroid_portrait.py` is named for the abandoned pixel renderer, but the build still uses its `Portrait` class. Don't edit it
    42: lightly: it's in cage's cache key, and so are the other cache-key files listed in the handbook.
    43: 
    44: **Scripts that live outside the repo:**
    45: 
    46: - `~/Projects/lowmarch-bench/kit/`: the benchmark's kit, including `front_sheet.py`, `build_expr.sh`, `blind_sheet.py`, `terra_review.sh`.
    47: - `~/.local/share/lowmarch/trials/*/scripts` and loose scripts there, such as `patch_lens_flattice.py` (a perspective lens for the painted page). Copy one in if it's needed again.
    48: 
    49: ## Big files
    50: 
    51: The repo's tracked files are small: `.git` is 5 MB. Everything below is outside git.
    52: 
    53: | Where | Size | What |
    54: |---|---|---|
    55: | `~/.local/share/lowmarch/vroid/lowmarch_bodies` | 14 GB | Built bodies and heads; holds cage's cache (`fits.json`). The bulk of everything |
    56: | `~/.local/share/lowmarch/vroid/samples_2_14` | 466 MB | The 26 VRoid samples |
    57: | `~/.local/share/lowmarch/makehuman` | 1.7 GB | MakeHuman data |
    58: | `~/.local/share/lowmarch/trials` | 1.9 GB | Sheets and shots; `combined-2026-10-31` is 1.8 GB |
    59: | `~/.local/share/lowmarch/tools` | 1.5 GB | Portable Blender 4.5, tar included. Unused since the spike |
    60: | `~/.local/share/lowmarch/winvroid` | 803 MB | VRoid driver data |
    61: | `~/.local/share/lowmarch/refs3d`, `study`, `quaternius`, `blender-base-meshes`, `refs`, `anthro` | 1.2 GB together | Study and spike data. References stay out of the repo |
    62: | `~/.local/share/lowmarch/sessions` | new | First-session folders from `rows.py` |
    63: | `~/Projects/lowmarch-bench/work` | 4.9 GB | Benchmark builds; `e` is 3 GB. Transcripts and judging keep the benchmark's record |
    64: | `review/out/` (git-ignored) | 1.1 GB | `versions` 410 MB, `vroid-02` 249, `base-spike` 206, `armory` 115, `mh-workshop` 89, `frozen` 14 |
    65: | `~/.local/opt/blender-5.2.3-linux-x64` | | Blender 5.2.3, unused by the pipeline |
    66: 
    67: If space is ever needed, the safest candidates to discuss are the Blender 4.5 tar, `review/out/versions` and
    68: `review/out/base-spike`. Nothing has been removed. Ask first, and check `~/Projects/lowmarch-bench/README.md`: the
    69: benchmark's raw material is being kept for a blog post (#1141).
  • read_file{"Path":"~/work/lowmarch/docs/todos-2026-11-08.md"}

    input

    {
      "Path": "~/work/lowmarch/docs/todos-2026-11-08.md"
    }

    result, 66 lines

    Showing lines 1-65 of 65
    1: # Open todos, sorted for the restart
    2: 
    3: Suggestions only. Nothing has been closed. 33 open and 4 someday on 2026-11-08, read from `led ls all`. Any of these can
    4: change once the owner has shown their picture.
    5: 
    6: ## Still matters (10)
    7: 
    8: | # | What | Why |
    9: |---|---|---|
    10: | 1443 | VRoid sample licence metadata; pixiv's help page unread | Needed before anything ships. Owner reads it by hand |
    11: | 1105 | Owner allows the VRoid driver's V.dll | Blocks any new VRoid face or body session |
    12: | 735 | Study how VRoid sample hair is built | Open since 10-08. Part done by the 11-08 research; the owner asked for this directly |
    13: | 768 | Heads: variety in shape, modelled age | Recurring complaint, never solved. Reword it for one character's face |
    14: | 1128 | A drawn lip line that follows every shape | Closed frowns are weak on any VRoid face; studios draw these as lines |
    15: | 733 | Fabric textures | "We should look into fabric textures too, but that can come later" (10-08) |
    16: | 1192 | Braids, coils and locks in the hair kit | Waits on the owner. Range work, so after one character |
    17: | 1193 | Half-day Blender trial of built-in hair nodes | Waits on the owner. No install needed |
    18: | 1141 | Blog post on the benchmark | The owner wants it later. Doesn't depend on the restart |
    19: | 714 | Battle stage | Close to "one game frame", but later: the first session only needs a flat stand-in |
    20: 
    21: ## Depends on what the restart keeps (14)
    22: 
    23: These only matter if the current bodies or VRoid faces carry over. Suggest parking them until the first session has settled that.
    24: 
    25: | # | What | Depends on |
    26: |---|---|---|
    27: | 1123 | Average woman's ear and hair slice | Sample A's hair. The dark under-layer idea is in the first-session plan either way |
    28: | 770 | Mature faces in VRoid's editor | A mature character being wanted; also needs #1105 |
    29: | 1121 | Flattice once scenes have a camera | The frame's camera. Nothing to do under orthographic |
    30: | 761 | Neck, wrist and ankle thickness: style or fix | The current bodies; needs the owner's call |
    31: | 765 | Brute's dark wedge at the deltoid | The brute |
    32: | 766 | Faint crescent under inflated busts | The current women |
    33: | 767 | Bodies 2 to 4 cm tall from VRoid's feet | The current bodies |
    34: | 759 | Dark slit in the inspection shorts | Bare inspection bodies; goes away once dressed |
    35: | 1129 | Expression picker in the armory | The armory staying the review page |
    36: | 1181 | Youth's closed lid at 0.8 of his lash | The youth's face |
    37: | 1184 | Angry mouth thins to a hairline on four women | Those faces; #1128 would likely cover it |
    38: | 1185 | Pale tick at the end of smug's mouth | Those faces |
    39: | 1186 | Shut lids follow texture steps | VRoid's painted lids |
    40: | 715 | Plate edges and contact shadows | Armour returning. The kit is still there |
    41: 
    42: ## Dead given the restart (9 open, 4 someday)
    43: 
    44: Suggest closing or moving to someday. All of these are about retired characters or old bases.
    45: 
    46: | # | What | Why |
    47: |---|---|---|
    48: | 718 | Elaine follow-ups | Elaine is retired |
    49: | 727 | Attack clip puts the arm in the chest | Those clips and characters are retired; motion restarts on a new character |
    50: | 729 | Saber study follow-ups | "Let's leave saber alone" (10-08) |
    51: | 730 | Redesign Elaine as a knight-princess | Dead as written. The idea survives only as my default first character, and that's the owner's pick |
    52: | 732 | Saber's tassets clip | Same as #729 |
    53: | 737 | Enemies: arms in heavy builds, more classes | Mobs on old bases, far from one character |
    54: | 743 | Main viewer rebuild for the soldiers | Old viewer, old soldiers |
    55: | 748 | Polearm attack; settle battle presentation | The attack is dead; the owner's picture answers the presentation question |
    56: | 1119 | Inked lid crease (optional) | Optional, already dropped once, tied to VRoid's overlay |
    57: | 749 | Someday: polearm elbow flip | Old clip |
    58: | 755 | Someday: fit VRoid-native bodies | That line was removed on the owner's say, 10-11 |
    59: | 756 | Someday: pale band at the MakeHuman neck graft | The graft is gone |
    60: | 1112 | Someday: proxy face normals | Already done, #1114 |
    61: 
    62: ## Not mine
    63: 
    64: - #981 sortie pilot from this pipeline: belongs to the mech tab, which is restarting too. It depends on whatever this restart keeps.
    65: - #1369 project trackers: the trackers session's.