levelset/src/ at main · russ.fugl.dev/levelset · Tangled

russ.fugl.dev / levelset

0

A functional toolkit for authoring resource-leveling algorithms — compose constraint and scoring blocks, enumerate feasible schedules

0

levelset / src /

at main 10 folders 7 files

Russ T. Fugal feat(conf): serializeConf, lintRegistryForConf, round-trip guarantee 6d ago

feat(conf): serializeConf, lintRegistryForConf, round-trip guarantee serializeConf renders a RunConfig to canonical TOML (hand-rolled, byte-exact goldens): fixed section order, default flags omitted, deterministic key order. Empty and scalar arrays render inline; object arrays become array-of-tables; nested objects become dotted keys. Options: header comment lines and annotate (each block's rendered assumptionTemplate as a comment). The round trip is value-lossless: parseConf(serializeConf(c)) reproduces c through the schema — asserted over the goldens, every standard block at its defaultShadow, and a deterministic generated corpus (random subsets, weights incl. "report"/null, lexicographic tiers). A schema-coverage test pins runConfigSchema's top-level keys so a future addition fails loudly. An integration test runs a project, serializes the filled config, reparses, and reruns — identical schedule, scores, and embedded provenance. lintRegistryForConf flags conf-inexpressible blocks (reserved-key param collisions, null-admitting or unrenderable schemas); the standard registry is clean.

6 days ago

feat(csv): CSV writer with RFC 4180 quoting and injection defense Export a ProjectFile's tasks to CSV. Quoting follows RFC 4180 and triggers on a bare CR as well as comma/quote/LF, since a lone CR can desync strict parsers. Fields beginning with a formula trigger (=, +, -, @) are defanged with a leading apostrophe per OWASP guidance, and the trigger set is a named constant so the policy is auditable in one place. Adds shared test helpers (parseCsv, makeMinimalProject) reused by the CSV, XLSX, and library suites.

4 months ago

feat(leveling): embed run provenance in materialized projects Every LevelingRun.materialize output now carries a levelset metadata block: engine version, the filled run config (rerunnable — the reproducibility artifact), seed, achieved scorer values, analysis warnings, and search annotations. ProjectFileSchema gains the optional field and the JSON reader/writer round-trips it (non-parsing provenance is dropped on read rather than failing the file). Answers "why does this schedule look like this?" from the file itself, spaCy config.cfg-style.

6 days ago

feat(conf): parseConf — TOML pipeline configs (levelset/conf) New levelset/conf subpath: parseConf reads a .conf (TOML 1.0) file — a text projection of RunConfig — into a raw RunConfig. Sections map [levelset]/ [resolve]/[pipeline]/[blocks.<id>]/[weights]/[objective] onto the config; reserved block keys (code/enabled/provenance/shadow) peel off as instance fields, everything else is a param (dotted keys nest, array-of-tables become object arrays, "report" ⇄ null). Every framework section is strict. Coded issues E301–E308: TOML syntax (line/column), config shape (conf-path), missing/unsupported format, datetime literal, reserved-key collision, non-finite number, and registry validation (instanceId-attributed). With a registry, parse also runs validateGraph + the shared checkRunConfigRefs (extracted from fillRunConfig so the two can't drift). Adds smol-toml as a regular dependency and the ./conf export. Grammar goldens (fixture .conf ⇄ raw config JSON) plus one error fixture per code.

6 days ago

feat(level-blocks): add Gate feasibility-gate collector block Gate keeps only schedules that satisfy every limit, where a limit bounds one scorer's value by max and/or min (an absent bound is unbounded on that side, never Infinity; at least one bound is required per limit). When at least one schedule passes, the passing set (order-preserving) is the result. When none pass, fallback decides: "none" yields the empty set; "leastBad" yields the single least-bad schedule. Least-bad compares schedules lexicographically by per-limit violation in the limits' declared order (first limit = binding). Violations of different scorers are not commensurable, so they are prioritized by order, never summed across scorers. Extends the Collector ADT with the Gate variant and GateLimit — the exhaustive collectorScorerRefs / collectors() switches (guarded by assertNeverCollector) force both dispatch sites to handle it. Adds the pure selectGate engine, levelset.Gate.v1 registration, leveling.ts re-exports, and README. Gate execution collects the stream once and filters/falls back in memory.

6 days ago

feat(model): entity interfaces via z.infer re-export The model-layer entity types (Task, Resource, Assignment, Calendar, Relation, ProjectFile/ProjectProperties) as thin z.infer re-exports of the schemas, so there is no hand-written interface to keep in sync with the validators. Project.ts also provides createEmptyProject for building a minimal valid ProjectFile.

4 months ago

feat(mpp): variant detection, MPP14 extraction, public reader MppVariant scores the CFB root paths to detect the MPP format variant, Mpp14Reader extracts tasks/resources/assignments from MPP14 through a FieldMap of binary offsets, and MppReader is the public entry point that loads the CFB container. MppReader takes an ArrayBuffer rather than a path, so it carries no filesystem dependency and runs anywhere. Unsupported versions (< 14) and invalid or missing containers produce clear, typed errors instead of obscure binary-parsing failures.

4 months ago

feat(mspdi): MSPDI reader, writer, and XSD duration Read and write Microsoft Project's MSPDI XML format. XsdDuration handles the xsd:duration parse/format the format uses for every duration field. The reader and writer cover the scheduling and work fields (including actualWork), and the writer emits a trailing newline. A finish expressed as an end-of-workday time (e.g. Friday 17:00) is normalized so it round-trips consistently with the day-indexed scheduling model.

4 months ago

fix(provenance): preserve unknown levelset keys across the JSON round trip RunProvenanceSchema (and its warning items) parsed with key-stripping z.object, so a levelset block written by a newer levelset version — or annotated by app tooling — was silently truncated to this version's fields on read → write. Parse with z.looseObject so unknown keys survive the round trip; garbage that fails the known-field contract is still dropped whole, as documented.

6 days ago

refactor(xlsx): keep writeWithGantt's public signature stable The SheetSpec work had grown writeWithGantt a 4th optional parameter, leaking composition plumbing into a pre-existing public method. The shared body moves to a private composeGanttWorkbook that both writeWithGantt and writeWithGanttAndSheets delegate to, and the buffer-wrapping repeated across write/writeSheets/the empty-gantt path collapses into one toBuffer helper.

1 month ago

feat(conf): serializeConf, lintRegistryForConf, round-trip guarantee serializeConf renders a RunConfig to canonical TOML (hand-rolled, byte-exact goldens): fixed section order, default flags omitted, deterministic key order. Empty and scalar arrays render inline; object arrays become array-of-tables; nested objects become dotted keys. Options: header comment lines and annotate (each block's rendered assumptionTemplate as a comment). The round trip is value-lossless: parseConf(serializeConf(c)) reproduces c through the schema — asserted over the goldens, every standard block at its defaultShadow, and a deterministic generated corpus (random subsets, weights incl. "report"/null, lexicographic tiers). A schema-coverage test pins runConfigSchema's top-level keys so a future addition fails loudly. An integration test runs a project, serializes the filled config, reparses, and reruns — identical schedule, scores, and embedded provenance. lintRegistryForConf flags conf-inexpressible blocks (reserved-key param collisions, null-admitting or unrenderable schemas); the standard registry is clean.

6 days ago

feat(dates): DST-safe project date parse/format helpers parseProjectDate / formatProjectDate centralize conversion between project date strings and timestamps. Parsing guards against NaN so a malformed date surfaces as a clear failure rather than a silent Invalid Date, and the arithmetic is DST-safe so a date round-trips across spring-forward and fall-back boundaries.

4 months ago

feat(xlsx): Excel writer with Gantt stacked-bar chart Export a ProjectFile to XLSX, and writeWithGantt additionally emits a hidden data sheet plus a horizontal stacked-bar Gantt chart. The chart uses two series — a transparent date-offset series and a visible duration series colored per phase — to fake a Gantt bar from a stacked bar. ExcelJS does not emit charts natively, so a JSZip post-pass injects the chart and drawing XML with matching content-type overrides. An ambient declaration (exceljs.d.ts) bridges an ExcelJS Buffer type incompatibility under Bun. The bar primitive is named in render-neutral terms (bar/item).

4 months ago

feat(test-support): JSON-baseline fixture helpers Helpers for comparing reader output against a committed JSON baseline, used by the integration suite to assert parser fidelity against reference fixtures.

4 months ago

feat(xlsx): declarative SheetSpec layer with formulas and named ranges Adds writeSheets() and writeWithGanttAndSheets() driven by CellSpec/SheetSpec: formula cells written without cached results so Excel/LibreOffice recalculate on open, workbook named ranges, cell notes, row outlines, and header/input/derived/muted/internal style hooks. Formula strings stay opaque to the writer — pricing semantics live in the consuming app's emitter. Spec sheets append after the Gantt sheet so chart-injection sheet indices stay stable. The named-range recalc test (row insertion absorbed by an open slot) runs under LibreOffice headless when soffice is available.

1 month ago

feat(level-blocks): derived block metadata (deriveBlockMeta/dumpBlockMeta) Port a zod→JSON-Schema walk into src/level-blocks/meta.ts, minus all Blockly assembly: deriveBlockMeta flattens a block's input schema into editable scalar fields (date/number/slider/dropdown/checkbox with labels/bounds/defaults), variadic scalar-array params, and complex (field-less) params, alongside the block's family/tier/doc/shadow and its JSON-Schema. dumpBlockMeta wraps the whole registry with the composition grammar. Exports the ISO-date pattern both sides agree on by construction. Zod-only, exported from levelset/leveling.

6 days ago

feat(leveling): declarative RunConfig with runFromConfig One JSON document now fully describes a leveling run — resolve options, blocks by versioned registry code (reusing the PipelineGraph format as the config's pipeline section), and objective weights (null = compute and report but don't optimize). runFromConfig fills the config (block-schema defaults expanded, levelset version stamped — the filled config is the persistable artifact), resolves the project, compiles blocks with instanceIds doubling as constraint names for attribution, statically analyzes the run (throwing coded RunAnalysisError on errors), and returns a live run: stream/best/scores/materialize plus the combined weightedScorer objective. Framework-owned config sections are strict so a typo'd key is an error, not a silently unconstrained run. Graph instances gain an optional enabled lever (undefined = enabled, so existing graphs and constructors stay valid).

6 days ago