Session Write
@vcjdeboer/session-writev2026.06.27.1
01README
Governed parameter-fill of analysis templates: an AI fills only the typed parameter slots of a frozen template, and the validate method is the deterministic gate that asserts the structure was untouched and every fill satisfies its slot contract — bounded, validated, reproducible AI authoring. Author templates from a typed intent (round-tripped), and wire an R project to record its work (init).
02Models
@vcjdeboer/session-writev2026.06.27.1session_write.ts
fn init(projectPath: string, repoDir: string, fileName: string, swampBin: string, force: preprocess)
R-project on-ramp. Run from the project: SWAMP_REPO_DIR=<swamp> swamp model method run writer init --input projectPath="$PWD". Writes swamp.qmd + .claude/settings.local.json; arms swamprecord against the rec ledger. repoDir resolves from --input repoDir, else SWAMP_REPO_DIR env, else cwd (--repo-dir does NOT set it in-method).
| Argument | Type | Description |
|---|---|---|
| projectPath | string | |
| repoDir | string | |
| fileName | string | |
| swampBin | string | |
| force | preprocess |
fn validate(templatePath: string, filledPath: string, columns: string, strict: preprocess)
Assert the filled .qmd left the structure frozen and every parameter satisfies its slot contract
| Argument | Type | Description |
|---|---|---|
| templatePath | string | |
| filledPath | string | |
| columns | string | |
| strict | preprocess |
fn author(templateId: string, outPath: string, body: string, slots: array, title: string, domain: string, returns: record, columns: string, constants: preprocess, strict: preprocess)
Assemble a governed template from a typed authoring-intent and round-trip it: the all-samples fill must VALIDATE and every contract slot's antisample must be REJECTED; the .qmd is written to outPath ONLY on pass. Returns the verdict the factory's round-trip gate reads.
| Argument | Type | Description |
|---|---|---|
| templateId | string | |
| outPath | string | |
| body | string | |
| slots | array | |
| title | string | |
| domain | string | |
| returns | record | |
| columns | string | |
| constants | preprocess | |
| strict | preprocess |
Resources
validation(infinite)— Result of validating a filled template against its slot contracts
init(infinite)— Record of wiring an R project to the suite (the swamp.qmd written into it)
authoring(infinite)— Result of authoring a governed template — the round-trip verdict plus the emitted path + sha256
03Previous Versions
2026.06.24.1Jun 24, 2026
Modified 1 models
2026.06.22.1Jun 22, 2026
repoDir auto-resolves (explicit --input repoDir → SWAMP_REPO_DIR env → cwd) so the SWAMP_REPO_DIR= on-ramp form bakes the correct control-plane path into swamp.qmd; add resolveRepoDir unit test; surface the R-project on-ramp in description/labels.
Modified 1 models. updated labels
2026.06.21.6Jun 21, 2026
2026.06.21.5Jun 21, 2026
2026.06.21.4Jun 21, 2026
2026.06.21.3Jun 21, 2026
04Stats
A
100 / 100
Downloads
0
Archive size
55.6 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels