cleonos/docs/stage27.md

# Stage 27 - User Shell/Wine Split and Syscall Expansion

## Goal
- Expand user shell capability toward kernel-shell parity.
- Extend syscall ABI for richer process/runtime operations.
- Split CLeonOS-Wine implementation into maintainable modules.

## Implementation
- Added more user-facing commands in user shell around process/runtime control (`spawn`, `wait`, `sleep`, `yield`, `pid`, file ops under `/temp`).
- Extended syscall surface (process and runtime related IDs) and kept kernel/user syscall ID tables aligned.
- Added process argument/environment ABI (`EXEC_PATHV` / `SPAWN_PATHV` + `PROC_ARG*` / `PROC_ENV*`).
- Added user exception/fault reporting ABI (`PROC_LAST_SIGNAL` / `PROC_FAULT_*`) and signal-encoded exit status.
- Updated user runtime syscall wrappers to cover newly added syscall IDs.
- Refactored Wine codebase from single-file implementation into modular structure for CLI, ELF loader, syscall bridge, and runtime helpers.

## Acceptance Criteria
- User shell can complete process and temp-file workflows without falling back to kernel shell.
- User ELF can read `argc/argv/envp` through runtime startup path.
- `wait` can observe signal-encoded status for crashed user processes.
- New syscall IDs are available consistently in:
  - `clks/include/clks/syscall.h`
  - `cleonos/c/include/cleonos_syscall.h`
  - `cleonos/c/src/syscall.c`
- Wine entry remains runnable after split (`python cleonos_wine.py ...`) and supports process/argv/env/fault syscalls.

## Build Targets
- `make userapps`
- `make ramdisk`
- `make iso`
- `make run`

## QEMU Command
- `make run`

## Debug Notes
- If a user command reports `request failed`, verify syscall ID mapping first.
- If `wait`/`spawn` behavior is wrong, check `clks/kernel/exec.c` process table and pid stack.
- If Wine import fails after split, check package/module import paths and `__init__.py` exports.