Skip to content

Commit be750cd

Browse files
committed
nit
1 parent dea9102 commit be750cd

1 file changed

Lines changed: 28 additions & 13 deletions

File tree

‎docs/runner/roadmap.md‎

Lines changed: 28 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ Tracks the remaining work required to achieve full compatibility between the Rus
99
The compatibility oracle is **live GitHub runs** first, then local aksh, using the `preloopdev/aksh-conformance-sample` repository workflows.
1010

1111
### Phase 1: Script/Job Semantics
12+
1213
- **07-step-failure.yml**:
1314
- Failed step outcome/conclusion propagation.
1415
- Skip remaining steps unless `always()` / `failure()` is met.
@@ -24,7 +25,8 @@ The compatibility oracle is **live GitHub runs** first, then local aksh, using t
2425
- Runner busy/idle state transitions on `/message` polling.
2526
- Matrix/strategy variables in runner-side context.
2627

27-
### Phase 2: Actions & Composite Lifecycle
28+
### Phase 2: Actions & Composite Lifecycle
29+
2830
- **10-uses-checkout.yml**:
2931
- Actions download via `ActionDownloadInfo` endpoints.
3032
- Tarball extraction with official path layout.
@@ -38,6 +40,7 @@ The compatibility oracle is **live GitHub runs** first, then local aksh, using t
3840
- Relative path resolution inside composite steps.
3941

4042
### Phase 3: Runtime Services
43+
4144
- **11-cache-roundtrip.yml**:
4245
- Cache protocol client (`_apis/artifactcache`).
4346
- Cache reserve, upload, commit, and restore.
@@ -50,50 +53,62 @@ The compatibility oracle is **live GitHub runs** first, then local aksh, using t
5053
- `ACTIONS_ID_TOKEN_REQUEST_URL` / `TOKEN`.
5154

5255
### Phase 4: Diagnostics
56+
5357
- **14-annotations.yml**:
5458
- `::error::` / `::warning::` / `::notice::` parsing and mapping.
5559
- Problem matcher regex matching against log streams.
5660

5761
---
5862

59-
## 2. Execution Subsystems & Gaps
63+
## 2. Execution Subsystems & Gaps
6064

6165
### Shell Parity
66+
6267
- Implement shell resolving for `sh`, `python`, `pwsh`, `cmd`, and Windows PowerShell.
6368
- Match quoting rules and script file extensions per target OS/shell.
6469

65-
### Windows Support
66-
- Path translation (`\` vs `/`).
67-
- Environment variable case-insensitivity.
68-
- Windows-specific process tree termination.
69-
- Windows shell execution (`cmd.exe`, `powershell.exe`).
7070

71-
### Containers & Services
72-
- Job-level docker containers (`container:`).
71+
72+
### Containers & Services
73+
74+
- Job-level docker containers (`container:`) or microvms.
7375
- Service container lifetime management.
7476
- Network, volume, and port mappings.
7577

76-
### Live Logs & Twirp Results
78+
### Live Logs & Twirp Results
79+
7780
- Websocket live logs (live console streaming).
7881
- Progressive step status updates via Twirp.
7982
- Signed blob upload for job/step logs.
8083

81-
### Cancellation & Hardening
84+
### Cancellation & Hardening
85+
8286
- SIGINT/SIGTERM graceful cleanup.
8387
- Process group signal propagation.
8488
- Step timeout enforcement (`timeout-minutes`).
8589

86-
### Pre-bundled & Offline Support
90+
### Pre-bundled & Offline Support
91+
8792
- Skip-if-present check: check for existing `externals/node20/bin/node` before triggering dynamic download at configure time.
8893
- Add `--offline` flag to `aksh-runner configure` to fail early if local `externals/` are missing, blocking any network fetch.
8994
- Archive-level packaging: bundle the compiled binary and pre-downloaded Node binaries for the target OS/Arch into a single release archive (`aksh-runner-bundle-<os>-<arch>.tar.gz`).
95+
9096
---
9197

92-
## Legend & Status
98+
## Legend &amp; Status
9399

94100
- **GitHub Live Conformance**:
95101
- `06-multi-step.yml` — **Passed** ✅
96102
- Others — **Pending** ❌
97103
- **Local aksh Parity**:
98104
- `06-multi-step.yml` — **Passed** ✅
99105
- Others — **Pending** ❌
106+
107+
108+
Windows Support(much later ignored for now)
109+
110+
- Path translation (`\` vs `/`).
111+
- Environment variable case-insensitivity.
112+
- Windows-specific process tree termination.
113+
- Windows shell execution (`cmd.exe`, `powershell.exe`).
114+

0 commit comments

Comments
 (0)