From b6f8cf1eef539dd22b44c33ef6b02c6ddcff5410 Mon Sep 17 00:00:00 2001 From: Rafael Richards Date: Mon, 11 May 2026 10:14:57 -0400 Subject: [PATCH] docs: add index README and YAML frontmatter to every doc Add docs/README.md indexing every document in docs/ with a shared TYPE/CONNECTION vocabulary used consistently across all m-dev-tools repos. Add YAML frontmatter (created, last_modified, revisions, doc_type) to every existing doc. Existing frontmatter is merged, not replaced. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/README.md | 84 ++++++++++++++++++ docs/guides/m-doc-grammar.md | 4 + docs/guides/m-tdd-guide.md | 4 + docs/guides/users-guide.md | 4 + docs/modules/index.md | 7 ++ docs/modules/stdargs.md | 4 + docs/modules/stdassert.md | 4 + docs/modules/stdb64.md | 4 + docs/modules/stdcache.md | 4 + docs/modules/stdcoll.md | 4 + docs/modules/stdcompress.md | 4 + docs/modules/stdcrypto.md | 4 + docs/modules/stdcsprng.md | 4 + docs/modules/stdcsv.md | 4 + docs/modules/stddate.md | 4 + docs/modules/stdenv.md | 4 + docs/modules/stdfix.md | 4 + docs/modules/stdfmt.md | 4 + docs/modules/stdfs.md | 4 + docs/modules/stdhex.md | 4 + docs/modules/stdhttp.md | 4 + docs/modules/stdjson.md | Bin 11112 -> 11193 bytes docs/modules/stdlog.md | 4 + docs/modules/stdmath.md | 4 + docs/modules/stdmock.md | 4 + docs/modules/stdos.md | 4 + docs/modules/stdprof.md | 4 + docs/modules/stdregex.md | 4 + docs/modules/stdseed.md | 4 + docs/modules/stdsemver.md | 4 + docs/modules/stdsnap.md | 4 + docs/modules/stdstr.md | 4 + docs/modules/stdtoml.md | 4 + docs/modules/stdurl.md | 4 + docs/modules/stduuid.md | 4 + docs/modules/stdxfrm.md | 4 + docs/modules/stdxml.md | 4 + .../plans/discoverability-and-tooling-plan.md | 4 + docs/plans/future-modules-plan.md | 4 + docs/plans/m-libraries-remediation.md | 4 + docs/plans/m-stdlib-implementation-plan.md | 4 + docs/plans/tdd-orchestration-plan.md | 4 + docs/testing/modern-m-corpus-test-results.md | Bin 30235 -> 30329 bytes docs/testing/realcode-validation.md | 4 + docs/testing/vista-corpus-lint-results.md | 4 + docs/tracking/README.md | 4 + docs/tracking/TODO.md | 7 ++ docs/tracking/changelog.md | 7 ++ docs/tracking/discoverability-tracker.md | 4 + docs/tracking/discoveries.md | 7 ++ docs/tracking/module-tracker.md | 4 + docs/tracking/parallel-tracks.md | 4 + 52 files changed, 292 insertions(+) create mode 100644 docs/README.md diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..23efdd5 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,84 @@ +--- +created: 2026-05-11 +last_modified: 2026-05-11 +revisions: 0 +doc_type: [REFERENCE] +--- + +# m-stdlib — Documentation Index + +> First-pass index generated 2026-05-11. Labels follow the shared vocabulary below; the same vocabulary is used across all m-dev-tools repos. + +## Vocabulary + +Each doc is labeled `[TYPE · type? · connection · connection?]`. + +**Types** — `HISTORY` · `ARCHITECTURE` · `DESIGN` · `ADR` · `SPEC` · `REFERENCE` · `GUIDE` · `TUTORIAL` · `ROADMAP` · `PLAN` · `RESEARCH` · `SURVEY` · `GAP-ANALYSIS` · `STATUS` · `EXPLAINER` · `NOTES` · `WORKED-EXAMPLE` · `SETUP` · `INTEGRATION` · `PROPOSAL` · `BUILD-LOG` · `CHANGELOG` · `POSTMORTEM` + +**Repo connections** — `history` · `function` · `design` · `architecture` · `planning` · `implementation` + +## `guides/` — User and contributor how-to docs + +- **`guides/m-doc-grammar.md`** — `[SPEC · function]` Normative grammar for the structured `; doc:` tags that drive the manifest, per-module markdown, and downstream tooling. +- **`guides/m-tdd-guide.md`** — `[GUIDE · function]` Operational TDD guide covering the m-stdlib primitives, the `m test` runner, and the inner-loop / release-gate commands. +- **`guides/users-guide.md`** — `[GUIDE · function]` Deep user reference for m-stdlib — purpose, non-goals, acceptance gate, and per-module usage notes. + +## `modules/` — Per-module reference docs + +- **`modules/index.md`** — `[REFERENCE · architecture · function]` Canonical released-module catalogue, organised by phase, with cross-module runtime dependencies and conformance corpora. +- **`modules/stdargs.md`** — `[REFERENCE · function]` Reference for the STDARGS module — argparse with long/short/grouped flags, positionals, sub-commands, and `--` terminator. +- **`modules/stdassert.md`** — `[REFERENCE · function]` Reference for the STDASSERT module — assertion library with nine extrinsics and `^TESTRUN`-compatible output protocol. +- **`modules/stdb64.md`** — `[REFERENCE · function]` Reference for the STDB64 module — RFC-4648 Base64 with standard and URL-safe alphabets. +- **`modules/stdcache.md`** — `[REFERENCE · function]` Reference for the STDCACHE module — LRU + TTL cache over a caller-owned array. +- **`modules/stdcoll.md`** — `[REFERENCE · function]` Reference for the STDCOLL module — Set / Map / Stack / Queue / Deque / Heap / OrderedDict collections. +- **`modules/stdcompress.md`** — `[REFERENCE · function]` Reference for the STDCOMPRESS module — gzip / deflate / zstd compress and decompress via libz + libzstd callouts. +- **`modules/stdcrypto.md`** — `[REFERENCE · function]` Reference for the STDCRYPTO module — SHA-256/384/512 and HMAC-SHA-256/384/512 via libcrypto callouts. +- **`modules/stdcsprng.md`** — `[REFERENCE · function]` Reference for the STDCSPRNG module — crypto random bytes / hex / base64 / token / int / uuid4 over the kernel CSPRNG. +- **`modules/stdcsv.md`** — `[REFERENCE · function]` Reference for the STDCSV module — RFC-4180 CSV parser and writer with optional file I/O. +- **`modules/stddate.md`** — `[REFERENCE · function]` Reference for the STDDATE module — ISO-8601 datetime and duration arithmetic over the proleptic Gregorian calendar. +- **`modules/stdenv.md`** — `[REFERENCE · function]` Reference for the STDENV module — `.env` loader plus typed accessors (`getInt` / `getBool` / `getFloat`). +- **`modules/stdfix.md`** — `[REFERENCE · function]` Reference for the STDFIX module — fixture lifecycle with `with` / `invoke` one-shot transactional scopes. +- **`modules/stdfmt.md`** — `[REFERENCE · function]` Reference for the STDFMT module — printf-style formatter, subset of Python `str.format` syntax. +- **`modules/stdfs.md`** — `[REFERENCE · function]` Reference for the STDFS module — file-system primitives plus byte-faithful I/O via libc callouts. +- **`modules/stdhex.md`** — `[REFERENCE · function]` Reference for the STDHEX module — RFC-4648 §8 hex encoding with lowercase default and case-insensitive decode. +- **`modules/stdhttp.md`** — `[REFERENCE · function]` Reference for the STDHTTP module — HTTP/1.1 client with pure-M wire-format helpers and libcurl-backed verbs. +- **`modules/stdjson.md`** — `[REFERENCE · function]` Reference for the STDJSON module — RFC 8259 JSON parser and serialiser with one M-tree node per JSON value. +- **`modules/stdlog.md`** — `[REFERENCE · function]` Reference for the STDLOG module — structured `key=value` logger with five levels and four sinks. +- **`modules/stdmath.md`** — `[REFERENCE · function]` Reference for the STDMATH module — numeric helpers (clamp / min / max / sum / count / mean) over caller-owned arrays. +- **`modules/stdmock.md`** — `[REFERENCE · function]` Reference for the STDMOCK module — test-time call interception with `register` / `invoke` / `resolve` / `called` / `args`. +- **`modules/stdos.md`** — `[REFERENCE · function]` Reference for the STDOS module — process / env / cmdline helpers (env / pid / cmdline / argv / cwd / user / hostname). +- **`modules/stdprof.md`** — `[REFERENCE · function]` Reference for the STDPROF module — wall-clock profiler with `$ZHOROLOG`-microsecond resolution. +- **`modules/stdregex.md`** — `[REFERENCE · function]` Reference for the STDREGEX module — Thompson-NFA regex engine with literals, classes, groups, alternation, and greedy quantifiers. +- **`modules/stdseed.md`** — `[REFERENCE · function]` Reference for the STDSEED module — declarative TSV / JSON manifest loader for FileMan record fixtures. +- **`modules/stdsemver.md`** — `[REFERENCE · function]` Reference for the STDSEMVER module — SemVer 2.0.0 validate / parse / compare / match with range syntax. +- **`modules/stdsnap.md`** — `[REFERENCE · function]` Reference for the STDSNAP module — snapshot testing with canonical line-per-leaf dump via `$QUERY` walk. +- **`modules/stdstr.md`** — `[REFERENCE · function]` Reference for the STDSTR module — ASCII string helpers (pad / trim / replaceAll / split / startsWith / endsWith). +- **`modules/stdtoml.md`** — `[REFERENCE · function]` Reference for the STDTOML module — TOML 1.0 subset with top-level pairs, `[section]` tables, and scalar values. +- **`modules/stdurl.md`** — `[REFERENCE · function]` Reference for the STDURL module — RFC 3986 URI parse / build / encode / decode / valid / normalize / resolve. +- **`modules/stduuid.md`** — `[REFERENCE · function]` Reference for the STDUUID module — RFC-4122 v4 and RFC-9562 v7 UUID generation. +- **`modules/stdxfrm.md`** — `[REFERENCE · function]` Reference for the STDXFRM module — higher-order array transforms (map / filter / reduce) via XECUTE-evaluated lambdas. +- **`modules/stdxml.md`** — `[REFERENCE · function]` Reference for the STDXML module — XML 1.0 parser plus XPath 1.0 subset with namespaces, predicates, and functions. + +## `plans/` — Implementation and roadmap plans + +- **`plans/discoverability-and-tooling-plan.md`** — `[PLAN · planning]` Phased plan to turn m-stdlib into a first-class discoverable surface across the source, CLI, VS Code, and AI consumption channels. +- **`plans/future-modules-plan.md`** — `[PROPOSAL · planning]` Parking lot for module candidates that haven't crossed TDD-red yet, with priority and promotion process. +- **`plans/m-libraries-remediation.md`** — `[ROADMAP · planning · design]` Background remediation strategy and prioritised roadmap derived from the M libraries survey — decisions locked. +- **`plans/m-stdlib-implementation-plan.md`** — `[PLAN · planning · implementation]` Live per-module work plan with phase status, non-negotiables, and per-module specs for v0.0.1 through v0.4.0. +- **`plans/tdd-orchestration-plan.md`** — `[PLAN · planning · architecture]` Cross-project coordination plan sequencing m-stdlib TDD primitives against the matching m-cli capability work. + +## `testing/` — Validation results across real-world corpora + +- **`testing/modern-m-corpus-test-results.md`** — `[RESEARCH · GAP-ANALYSIS · function]` Findings from running m-stdlib against five active non-VistA OSS M projects, focused on library-fit substitution opportunities. +- **`testing/realcode-validation.md`** — `[RESEARCH · function]` Toolchain-side validation of m-stdlib against the m-modern-corpus snapshot — collision sweep and lint-pass matrix. +- **`testing/vista-corpus-lint-results.md`** — `[RESEARCH · function]` Lint-pass results from running m-cli's rule profiles against the 39,375-routine VistA corpus. + +## `tracking/` — Live trackers for in-flight work + +- **`tracking/README.md`** — `[REFERENCE · architecture · planning]` Existing index for the tracking/ subdir — defines the four-bucket doc model (planning / implementation / discoveries / tracking). +- **`tracking/changelog.md`** — `[CHANGELOG · history]` Keep-a-Changelog release history; one entry per tag with thin pointers into trackers and per-module History sections. +- **`tracking/discoverability-tracker.md`** — `[STATUS · implementation · planning]` Wave A–D implementation tracker for the discoverability and tooling plan, with tabular summary and per-task narrative. +- **`tracking/discoveries.md`** — `[NOTES · history · implementation]` Discoveries register — every issue not anticipated in a locked plan but addressed during implementation, internal and external. +- **`tracking/module-tracker.md`** — `[STATUS · implementation]` Master per-module tracker — Summary table, closed-tickets archaeology (T1–T30), and Must-know section. +- **`tracking/parallel-tracks.md`** — `[STATUS · architecture · implementation]` Dispatch view across L1–L27 / H1–H3 / m-cli companion C-tracks with the cross-module dependency map. +- **`tracking/TODO.md`** — `[STATUS · implementation]` Resume-here pointer — thin index over the trackers with current release status and live work board. diff --git a/docs/guides/m-doc-grammar.md b/docs/guides/m-doc-grammar.md index 4cf1732..c62bd23 100644 --- a/docs/guides/m-doc-grammar.md +++ b/docs/guides/m-doc-grammar.md @@ -9,6 +9,10 @@ plan: docs/plans/discoverability-and-tooling-plan.md (the design rationale — this guide is the normative spec implementing § 3.1) tracker: docs/tracking/discoverability-tracker.md (WA1 closes when this guide is reviewed; WA2 is the backfill that brings src/ into compliance) +created: 2026-05-08 +last_modified: 2026-05-08 +revisions: 1 +doc_type: [SPEC] --- # m-stdlib — M-doc tag grammar diff --git a/docs/guides/m-tdd-guide.md b/docs/guides/m-tdd-guide.md index a477656..b01eecc 100644 --- a/docs/guides/m-tdd-guide.md +++ b/docs/guides/m-tdd-guide.md @@ -2,6 +2,10 @@ title: M Test Driven Development Guide audience: M developers building or maintaining test suites on top of m-stdlib's TDD primitives. companion: users-guide.md (general m-stdlib usage). modules/index.md (per-module reference). +created: 2026-05-08 +last_modified: 2026-05-10 +revisions: 4 +doc_type: [GUIDE] --- # M Test Driven Development Guide diff --git a/docs/guides/users-guide.md b/docs/guides/users-guide.md index 79cda73..3f341ec 100644 --- a/docs/guides/users-guide.md +++ b/docs/guides/users-guide.md @@ -3,6 +3,10 @@ title: m-stdlib — user's guide status: live audience: M developers (VistA, FIS-GT.M heritage projects, IRIS sites) who want a runtime-library substrate so they don't have to re-invent assertions, JSON, regex, datetime, logging, CSV, URL parsing, file I/O, HTTP, crypto digests, and the rest at every site. companion: modules/index.md (canonical inventory); module-tracker.md (live work board); m-stdlib-implementation-plan.md (per-module specs); m-tdd-guide.md (operational TDD guide for projects building tests on top of m-stdlib's TDD primitives). +created: 2026-05-05 +last_modified: 2026-05-10 +revisions: 17 +doc_type: [GUIDE] --- # m-stdlib — user's guide diff --git a/docs/modules/index.md b/docs/modules/index.md index 5019760..a3cac3a 100644 --- a/docs/modules/index.md +++ b/docs/modules/index.md @@ -1,3 +1,10 @@ +--- +created: 2026-05-05 +last_modified: 2026-05-10 +revisions: 6 +doc_type: [REFERENCE] +--- + # m-stdlib modules Regenerated at the **v0.4.0** release (2026-05-08). One row per diff --git a/docs/modules/stdargs.md b/docs/modules/stdargs.md index 41e2565..8817ef3 100644 --- a/docs/modules/stdargs.md +++ b/docs/modules/stdargs.md @@ -9,6 +9,10 @@ labels: ['addflag', 'addpos', 'addsub', 'free', 'help', 'new', 'parse'] errors: ['U-STDARGS-MISSING-POSITIONAL', 'U-STDARGS-MISSING-VALUE', 'U-STDARGS-UNKNOWN-ACTION', 'U-STDARGS-UNKNOWN-FLAG', 'U-STDARGS-UNKNOWN-SUBCOMMAND'] conformance: [] see_also: [] +created: 2026-05-05 +last_modified: 2026-05-08 +revisions: 3 +doc_type: [REFERENCE] --- # `STDARGS` — argparse diff --git a/docs/modules/stdassert.md b/docs/modules/stdassert.md index 90f204d..65b7d5b 100644 --- a/docs/modules/stdassert.md +++ b/docs/modules/stdassert.md @@ -9,6 +9,10 @@ labels: ['contains', 'eq', 'false', 'len', 'ne', 'near', 'raises', 'report', 'st errors: [] conformance: [] see_also: ['STDSNAP'] +created: 2026-04-30 +last_modified: 2026-05-08 +revisions: 5 +doc_type: [REFERENCE] --- # `STDASSERT` — assertion library diff --git a/docs/modules/stdb64.md b/docs/modules/stdb64.md index faa35bb..4d4ce63 100644 --- a/docs/modules/stdb64.md +++ b/docs/modules/stdb64.md @@ -9,6 +9,10 @@ labels: ['decode', 'encode', 'urldecode', 'urlencode', 'valid'] errors: [] conformance: ['tests/conformance/b64/'] see_also: ['STDCSPRNG'] +created: 2026-05-05 +last_modified: 2026-05-08 +revisions: 3 +doc_type: [REFERENCE] --- # `STDB64` — RFC-4648 Base64 diff --git a/docs/modules/stdcache.md b/docs/modules/stdcache.md index b6e7670..32893c0 100644 --- a/docs/modules/stdcache.md +++ b/docs/modules/stdcache.md @@ -9,6 +9,10 @@ labels: ['capacity', 'clear', 'get', 'has', 'new', 'put', 'remove', 'size'] errors: [] conformance: [] see_also: [] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 4 +doc_type: [REFERENCE] --- # `STDCACHE` — LRU + TTL cache diff --git a/docs/modules/stdcoll.md b/docs/modules/stdcoll.md index 0ccce5e..ae6e274 100644 --- a/docs/modules/stdcoll.md +++ b/docs/modules/stdcoll.md @@ -9,6 +9,10 @@ labels: ['dequeClear', 'dequePeekBack', 'dequePeekFront', 'dequePopBack', 'deque errors: [] conformance: [] see_also: [] +created: 2026-05-05 +last_modified: 2026-05-08 +revisions: 3 +doc_type: [REFERENCE] --- # `STDCOLL` — collections diff --git a/docs/modules/stdcompress.md b/docs/modules/stdcompress.md index aae3614..719b058 100644 --- a/docs/modules/stdcompress.md +++ b/docs/modules/stdcompress.md @@ -9,6 +9,10 @@ labels: ['available', 'deflate', 'gunzip', 'gzip', 'inflate', 'zstdCompress', 'z errors: ['U-STDCOMPRESS-BAD-LEVEL', 'U-STDCOMPRESS-CALLOUT-MISSING', 'U-STDCOMPRESS-LIBZ-FAIL', 'U-STDCOMPRESS-LIBZSTD-FAIL'] conformance: [] see_also: [] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 7 +doc_type: [REFERENCE] --- # `STDCOMPRESS` — gzip / deflate / zstd compression diff --git a/docs/modules/stdcrypto.md b/docs/modules/stdcrypto.md index 234e0bb..c40b961 100644 --- a/docs/modules/stdcrypto.md +++ b/docs/modules/stdcrypto.md @@ -9,6 +9,10 @@ labels: ['available', 'hmacSha256', 'hmacSha256Bytes', 'hmacSha384', 'hmacSha384 errors: ['U-STDCRYPTO-CALLOUT-MISSING', 'U-STDCRYPTO-DIGEST-FAIL', 'U-STDCRYPTO-HMAC-FAIL'] conformance: [] see_also: [] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 7 +doc_type: [REFERENCE] --- # `STDCRYPTO` — Cryptographic digests + HMAC diff --git a/docs/modules/stdcsprng.md b/docs/modules/stdcsprng.md index d61a196..85794bc 100644 --- a/docs/modules/stdcsprng.md +++ b/docs/modules/stdcsprng.md @@ -9,6 +9,10 @@ labels: ['available', 'base64', 'bytes', 'hex', 'int', 'token', 'useCallout', 'u errors: ['U-STDCSPRNG-BAD-COUNT', 'U-STDCSPRNG-BAD-RANGE', 'U-STDCSPRNG-OPEN-FAIL'] conformance: [] see_also: ['STDB64', 'STDHEX', 'STDUUID'] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 6 +doc_type: [REFERENCE] --- # `STDCSPRNG` — Cryptographic random diff --git a/docs/modules/stdcsv.md b/docs/modules/stdcsv.md index 9d3f2b1..3b4d895 100644 --- a/docs/modules/stdcsv.md +++ b/docs/modules/stdcsv.md @@ -9,6 +9,10 @@ labels: ['parse', 'parseFile', 'write', 'writeFile'] errors: ['U-STDCSV-OPEN-FAIL'] conformance: ['tests/conformance/csv/'] see_also: [] +created: 2026-05-05 +last_modified: 2026-05-08 +revisions: 3 +doc_type: [REFERENCE] --- # `STDCSV` — RFC-4180 CSV diff --git a/docs/modules/stddate.md b/docs/modules/stddate.md index 2581e9f..7eec42f 100644 --- a/docs/modules/stddate.md +++ b/docs/modules/stddate.md @@ -9,6 +9,10 @@ labels: ['add', 'diff', 'fromh', 'now', 'strftime', 'strptime', 'toh'] errors: ['U-STDDATE-BAD-DUR', 'U-STDDATE-BAD-HOROLOG', 'U-STDDATE-BAD-ISO'] conformance: [] see_also: ['STDLOG'] +created: 2026-05-05 +last_modified: 2026-05-10 +revisions: 6 +doc_type: [REFERENCE] --- # `STDDATE` — ISO-8601 datetime + duration arithmetic diff --git a/docs/modules/stdenv.md b/docs/modules/stdenv.md index 53fb26e..9c944ba 100644 --- a/docs/modules/stdenv.md +++ b/docs/modules/stdenv.md @@ -9,6 +9,10 @@ labels: ['get', 'getBool', 'getFloat', 'getInt', 'has', 'parse', 'parseFile', 'v errors: ['U-STDFS-OPEN-FAIL'] conformance: [] see_also: ['STDFS'] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 4 +doc_type: [REFERENCE] --- # `STDENV` — `.env` loader + typed accessors diff --git a/docs/modules/stdfix.md b/docs/modules/stdfix.md index 3a45879..494f7c6 100644 --- a/docs/modules/stdfix.md +++ b/docs/modules/stdfix.md @@ -9,6 +9,10 @@ labels: ['active', 'cleanup', 'invoke', 'register', 'with'] errors: ['U-STDFIX-EMPTY-TAG', 'U-STDFIX-UNREGISTERED-TAG'] conformance: [] see_also: [] +created: 2026-05-05 +last_modified: 2026-05-10 +revisions: 7 +doc_type: [REFERENCE] --- # `STDFIX` — fixture lifecycle and per-test isolation diff --git a/docs/modules/stdfmt.md b/docs/modules/stdfmt.md index 207e4c2..bfcb6a6 100644 --- a/docs/modules/stdfmt.md +++ b/docs/modules/stdfmt.md @@ -9,6 +9,10 @@ labels: ['f', 'fn'] errors: ['U-STDFMT-MISSING-ARG', 'U-STDFMT-UNCLOSED-BRACE', 'U-STDFMT-UNESCAPED-RBRACE', 'U-STDFMT-UNKNOWN-TYPE'] conformance: [] see_also: [] +created: 2026-05-05 +last_modified: 2026-05-10 +revisions: 5 +doc_type: [REFERENCE] --- # `STDFMT` — printf-style formatter diff --git a/docs/modules/stdfs.md b/docs/modules/stdfs.md index b168466..f632255 100644 --- a/docs/modules/stdfs.md +++ b/docs/modules/stdfs.md @@ -9,6 +9,10 @@ labels: ['append', 'appendBytes', 'available', 'basename', 'dirname', 'exists', errors: ['U-STDFS-NOT-WIRED', 'U-STDFS-OPEN-FAIL', 'U-STDFS-READ-TRUNCATED', 'U-STDFS-REMOVE-FAIL'] conformance: [] see_also: ['STDENV', 'STDSNAP'] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 7 +doc_type: [REFERENCE] --- # `STDFS` — File-system primitives diff --git a/docs/modules/stdhex.md b/docs/modules/stdhex.md index d46c9b8..6c95171 100644 --- a/docs/modules/stdhex.md +++ b/docs/modules/stdhex.md @@ -9,6 +9,10 @@ labels: ['decode', 'encode', 'encodeu', 'valid'] errors: [] conformance: [] see_also: ['STDCSPRNG'] +created: 2026-05-05 +last_modified: 2026-05-08 +revisions: 3 +doc_type: [REFERENCE] --- # `STDHEX` — RFC-4648 §8 hex encoding diff --git a/docs/modules/stdhttp.md b/docs/modules/stdhttp.md index 2c6a95d..6616309 100644 --- a/docs/modules/stdhttp.md +++ b/docs/modules/stdhttp.md @@ -9,6 +9,10 @@ labels: ['available', 'buildRequest', 'formatHeaders', 'get', 'parseHeader', 'pa errors: [] conformance: [] see_also: ['STDURL'] +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 6 +doc_type: [REFERENCE] --- # `STDHTTP` — HTTP/1.1 client (libcurl callout) diff --git a/docs/modules/stdjson.md b/docs/modules/stdjson.md index e2bfca9a42f6b1234fd005cbf94dc5ed89f00176..205206a04ac912a964fbb544ec0e359c7f9e0492 100644 GIT binary patch delta 92 zcmaD6wljP~5Tk!`QEFmIYKoPDk%5t!u7N2Kapfcym&E7hr(~vOqR3cq6{VJC7H8(? j61A# delta 12 TcmdlP{vvEc5aZ^>jAB{^A#tDx%J2G070su7J27~|r diff --git a/docs/testing/realcode-validation.md b/docs/testing/realcode-validation.md index 07eb9bd..32f7775 100644 --- a/docs/testing/realcode-validation.md +++ b/docs/testing/realcode-validation.md @@ -3,6 +3,10 @@ title: m-stdlib — real-code validation against m-modern-corpus status: live (2026-05-05) corpus: ~/projects/m-modern-corpus (5 projects, 4,215 routines, ~14 MB) companion: users-guide.md (§6.5 "Portability open questions") +created: 2026-05-05 +last_modified: 2026-05-08 +revisions: 3 +doc_type: [RESEARCH] --- # Real-code validation — m-stdlib against m-modern-corpus diff --git a/docs/testing/vista-corpus-lint-results.md b/docs/testing/vista-corpus-lint-results.md index 7b5438e..14d7809 100644 --- a/docs/testing/vista-corpus-lint-results.md +++ b/docs/testing/vista-corpus-lint-results.md @@ -4,6 +4,10 @@ status: live (2026-05-06) corpus: ~/projects/vista-meta/vista/vista-m-host/Packages (39,375 routines, 176 packages) companion: modern-m-corpus-test-results.md (non-VA companion) informs: m-cli profile tuning (xindex / vista / sac / default), tree-sitter-m grammar gaps +created: 2026-05-06 +last_modified: 2026-05-10 +revisions: 4 +doc_type: [RESEARCH] --- # VistA corpus — lint pass results diff --git a/docs/tracking/README.md b/docs/tracking/README.md index 8579c5e..bf04884 100644 --- a/docs/tracking/README.md +++ b/docs/tracking/README.md @@ -8,6 +8,10 @@ audience: anyone landing or proposing work in m-stdlib, or coordinating cross-project work that surfaces m-stdlib changes. companions: docs/plans/ (forward-looking specs that get locked before implementation starts). +created: 2026-05-10 +last_modified: 2026-05-10 +revisions: 2 +doc_type: [REFERENCE] --- # m-stdlib — tracking conventions diff --git a/docs/tracking/TODO.md b/docs/tracking/TODO.md index e39f000..8eca724 100644 --- a/docs/tracking/TODO.md +++ b/docs/tracking/TODO.md @@ -1,3 +1,10 @@ +--- +created: 2026-04-30 +last_modified: 2026-05-10 +revisions: 14 +doc_type: [STATUS] +--- + # m-stdlib — resume-here TODO **Status:** **`v0.4.0` shipped 2026-05-08** (tag `53ecf70`). 32 diff --git a/docs/tracking/changelog.md b/docs/tracking/changelog.md index e26549b..0274adb 100644 --- a/docs/tracking/changelog.md +++ b/docs/tracking/changelog.md @@ -1,3 +1,10 @@ +--- +created: 2026-04-30 +last_modified: 2026-05-10 +revisions: 38 +doc_type: [CHANGELOG] +--- + # Changelog All notable changes to m-stdlib are documented here. Format follows diff --git a/docs/tracking/discoverability-tracker.md b/docs/tracking/discoverability-tracker.md index dd7e3ee..d67c550 100644 --- a/docs/tracking/discoverability-tracker.md +++ b/docs/tracking/discoverability-tracker.md @@ -11,6 +11,10 @@ sibling: docs/tracking/module-tracker.md (the module-level tracker; deferred decisions D1/D2/D3 there originated in the same plan) audience: anyone executing or proposing work against the discoverability plan, including AI agents asked to "complete phase X" +created: 2026-05-08 +last_modified: 2026-05-10 +revisions: 22 +doc_type: [STATUS] --- # m-stdlib — discoverability & tooling implementation tracker diff --git a/docs/tracking/discoveries.md b/docs/tracking/discoveries.md index 68e2ced..898a91d 100644 --- a/docs/tracking/discoveries.md +++ b/docs/tracking/discoveries.md @@ -1,3 +1,10 @@ +--- +created: 2026-05-10 +last_modified: 2026-05-10 +revisions: 1 +doc_type: [NOTES] +--- + # Discoveries register > **Note (2026-05-10).** This file was renamed from `TOOLCHAIN-FINDINGS.md` diff --git a/docs/tracking/module-tracker.md b/docs/tracking/module-tracker.md index 6789d6c..4e6abbb 100644 --- a/docs/tracking/module-tracker.md +++ b/docs/tracking/module-tracker.md @@ -8,6 +8,10 @@ companions: docs/tracking/README.md (the four-bucket doc model this tracker foll docs/plans/future-modules-plan.md (proposal pipeline; promote rows from there into Table 1 here), docs/tracking/parallel-tracks.md (dispatch view), docs/plans/m-stdlib-implementation-plan.md (per-module specs and §9 acceptance gate), docs/modules/index.md (canonical released-module index). +created: 2026-05-07 +last_modified: 2026-05-10 +revisions: 37 +doc_type: [STATUS] --- # m-stdlib — master module development tracker diff --git a/docs/tracking/parallel-tracks.md b/docs/tracking/parallel-tracks.md index 038339e..7de8e1c 100644 --- a/docs/tracking/parallel-tracks.md +++ b/docs/tracking/parallel-tracks.md @@ -3,6 +3,10 @@ title: m-stdlib — parallel execution tracks status: live (2026-05-06) companion: tdd-orchestration-plan.md (joint milestone narrative) implementation: m-stdlib-implementation-plan.md (per-module specs) +created: 2026-05-05 +last_modified: 2026-05-10 +revisions: 31 +doc_type: [STATUS] --- # m-stdlib — parallel execution tracks