refactor: hard-fork GSD -> MSD (Make Software Done)
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
This commit is contained in:
@@ -1,17 +1,17 @@
|
||||
# Long-running operations and async external jobs
|
||||
|
||||
> **Reference** (Diátaxis). The operation-classification policy and the async
|
||||
> external-job contract that GSD executors use when a task legitimately exceeds
|
||||
> external-job contract that MSD executors use when a task legitimately exceeds
|
||||
> a child-agent timeout. The producer is the default-off `external-job`
|
||||
> Capability (#1164, part of #1105); the core loop consumes the manifest
|
||||
> (#1165 — `external_job_waiting`).
|
||||
|
||||
## 1. The problem
|
||||
|
||||
Heavy GSD phases (HPC solvers, model training, large simulations) can
|
||||
Heavy MSD phases (HPC solvers, model training, large simulations) can
|
||||
legitimately exceed short child-agent timeouts. Raising the timeout alone is
|
||||
not sufficient: it prevents legitimate subagents from being killed, but it
|
||||
also lets truly hung commands consume the whole agent budget. GSD must
|
||||
also lets truly hung commands consume the whole agent budget. MSD must
|
||||
distinguish legitimate heavy work from suspicious hangs, keep safety nets
|
||||
finite, and avoid blocking an agent turn on hours-long compute.
|
||||
|
||||
@@ -112,9 +112,9 @@ The `external-job` Capability declares its config keys in
|
||||
|---|---|---|---|
|
||||
| `external_job.enabled` | `false` | — | Capability gate (`when` on both contributions). Master toggle; default-off. |
|
||||
| `external_job.backend` | `slurm` | — | Pluggability seam (LSF/PBS/K8s future). Core never interprets it. |
|
||||
| `external_job.artifact_dir` | `Artifacts/jobs` | `GSD_EXTERNAL_JOB_ARTIFACT_DIR` | Adapter surfaces the resolved root in `submit` output. |
|
||||
| `external_job.submit_timeout_ms` | `30000` | `GSD_SLURM_SUBMIT_TIMEOUT_MS` | Adapter bounds the `sbatch` subprocess. |
|
||||
| `external_job.poll_timeout_ms` | `15000` | `GSD_SLURM_POLL_TIMEOUT_MS` | Adapter bounds the `squeue`/`sacct` subprocess. |
|
||||
| `external_job.artifact_dir` | `Artifacts/jobs` | `MSD_EXTERNAL_JOB_ARTIFACT_DIR` | Adapter surfaces the resolved root in `submit` output. |
|
||||
| `external_job.submit_timeout_ms` | `30000` | `MSD_SLURM_SUBMIT_TIMEOUT_MS` | Adapter bounds the `sbatch` subprocess. |
|
||||
| `external_job.poll_timeout_ms` | `15000` | `MSD_SLURM_POLL_TIMEOUT_MS` | Adapter bounds the `squeue`/`sacct` subprocess. |
|
||||
|
||||
Config keys live nested under `external_job` in `.planning/config.json`, e.g.:
|
||||
|
||||
@@ -131,5 +131,5 @@ to the registry default rather than producing `NaN` (no guessing).
|
||||
- **How-To:** [`../how-to/async-external-jobs.md`](../how-to/async-external-jobs.md) — using the SLURM adapter.
|
||||
- **Contract:** [`planning-artifacts.md`](./planning-artifacts.md) — the manifest stability contract.
|
||||
- **Capability manifest:** [`../../capabilities/external-job/capability.json`](../../capabilities/external-job/capability.json).
|
||||
- **Pure module:** `gsd-core/src/external-job.cts` → `gsd-core/bin/lib/external-job.cjs`.
|
||||
- **Pure module:** `msd-core/src/external-job.cts` → `msd-core/bin/lib/external-job.cjs`.
|
||||
- **Operator CLI:** `scripts/slurm-adapter.cjs`.
|
||||
|
||||
Reference in New Issue
Block a user