Roadmap search

Versions, deliverables, workstreams, tasks, and pages

Beskid

Jump to a Beskid service

HomeSpecificationBookpckgTrackerNexus

Delivery version

v0.2: Analysis, packages, and platform spec

v0.2 ships the typed analysis/doc pipeline, hierarchical api.json as the pckg docs contract, platform-spec cutover on beskid-lang.org, trudoc verification, compiler LSP workspace/project graph, macro/composition HIR, abfall GC integration, Open VSX extension CI, and book/tutorial waves (2026-04-23 → 2026-05-22).

Released
Tasks completed

102

of 102 tracked

Commits tracked

102

from catalog provenance

Deliverables completed

10

of 10

In progress

0

0 in backlog

Deliverables

  • api.json primary contract

    Closed 2026-05-20 on superrepo f57377a (v0.2 delivery tip).

    Compiler emits hierarchical api.json (types, members, compiler-derived signatures, typeRef links for resolved symbols). pckg requires structured api.json on publish and renders PackageDocs from that JSON—not parallel ad-hoc grouping.

    Workstreams: pckg-registry, analysis-pipeline, ci-release, codegen-runtime. 13 catalog tasks anchor this deliverable (milestoneId: v02-api-json-contract).

    Provenance

    • 09542b2 (pckg) — fix(pckg): auto-provision workspace member packages on publish
    • 21a7be7 (pckg) — feat(docs): Microsoft Docs-style library tree for API reference
    • 5ff3d07 (compiler) — feat(analysis): structured API doc snapshot and registry doc pipeline
    • 9ca5da3 (compiler) — feat(compiler): macro expand pass and HIR legality integration
    • f9d2b48 (pckg) — fix(dashboard): unify data-grid row actions and registry activity layout
    • 2c0be25 (pckg) — feat(pckg): structured api.json docs UI and readonly source editor
    • 010981f (compiler) — fix(ci): corelib root resolution, ABI snapshot, format golden
    • 88ee828 (pckg) — Raise structured api.json size limit for corelib-scale packages.
    • …and 5 more seed tasks with provenance commits.

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-api-json-contract — api.json primary contract

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for api.json primary contract.

    13 / 13 tasks done

  • Book tutorial rollout

    Closed 2026-05-05 on superrepo f57377a (v0.2 delivery tip).

    Early v0.2 language book chapters, corelib naming on the public site, file-scoped module semantics in book/reference material, and trudoc/bootstrap wiring ahead of the May platform-spec cutover.

    Workstreams: docs-site. 3 catalog tasks anchor this deliverable (milestoneId: v02-book-tutorial-wave).

    Provenance

    • cc46568 (beskid) — Website update
    • 6140c7c (beskid) — docs: corelib naming across site, workstreams, and CI notes
    • 94240a3 (beskid) — site: add language book and align module docs with file-scoped semantics

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-book-tutorial-wave — Book tutorial rollout

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for Book tutorial rollout.

    3 / 3 tasks done

  • CI workflows and deploy infra

    Closed 2026-05-20 on superrepo f57377a (v0.2 delivery tip).

    Nox logging centralization, workflow refinements, site image bun lockfile, Coolify compose fixes, compiler CLI GitHub Releases publishing, and rolling version sync to the downloads page.

    Workstreams: ci-release, dev-experience. 15 catalog tasks anchor this deliverable (milestoneId: v02-ci-deploy-infra).

    Provenance

    • d63f938 (compiler) — ci: move CLI publishing to GitHub Releases action
    • 0c97fde (beskid) — fix(deploy): use monorepo bun lockfile in site image build
    • 44aed91 (compiler) — chore(deps): bump rustls/rustls-webpki/rand to clear cargo-audit advisories
    • f97e8e7 (compiler) — chore(corelib): bump submodule for CI checkout submodules fix.
    • 5fba2e9 (beskid) — fix(deploy): skip inactive bsharp submodule on Coolify shallow clone
    • f1ba649 (beskid) — ci: upgrade nox baseline and bump compiler submodule
    • f793c45 (beskid) — chore(compiler): bump submodule for corelib publish CI
    • 0b36871 (beskid) — chore(ci): refine workflows and agents guidance
    • …and 7 more seed tasks with provenance commits.

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-ci-deploy-infra — CI workflows and deploy infra

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for CI workflows and deploy infra.

    15 / 15 tasks done

  • Composition HIR & macro expansion

    Closed 2026-05-20 on superrepo f57377a (v0.2 delivery tip).

    Composition collect/graph/pass, mod-host query bridge, macro registry and expand passes, type-check context wiring, and structured api.json signatures in the compiler by May 20.

    Workstreams: analysis-pipeline. 3 catalog tasks anchor this deliverable (milestoneId: v02-composition-macros-hir).

    Provenance

    • efb67a5 (compiler) — feat(compiler): composition, macros, structured API docs, and resolver fixes
    • 760098d (compiler) — feat(compiler): extend macro expand and type-check context wiring
    • 2518c48 (compiler) — fix(compiler): refine macro substitution implementation

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-composition-macros-hir — Composition HIR & macro expansion

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for Composition HIR & macro expansion.

    3 / 3 tasks done

  • Fibers, channels, and GC runtime

    Closed 2026-05-20 on superrepo f57377a (v0.2 delivery tip).

    Spawn/fiber runtime surfaces, channel primitives, vendored abfall GC heap integration, runtime module alignment, and platform-spec GC/interop alignment.

    Workstreams: codegen-runtime. 9 catalog tasks anchor this deliverable (milestoneId: v02-concurrency-runtime).

    Provenance

    • 12ee673 (compiler) — feat: spawn/fiber runtime, channels, and split System I/O surfaces
    • 3a9a083 (corelib) — corelib: syscall surfaces, docs, and tests
    • 0ded628 (compiler) — compiler: runtime/ABI updates, doc command, corelib submodule bump, tests
    • 6ecd493 (compiler) — feat(runtime): vendored abfall GC and Beskid heap integration
    • 6db12d2 (corelib) — fix(ci): run corelib prelude lowering tests on an 8 MiB stack
    • ee3d83d (corelib) — feat(corelib): expand syscall coverage and stdlib tests
    • 2ddddb3 (corelib) — test(corelib): extend concurrency tests and align concurrency packages
    • 4e5bfca (compiler) — docs(abfall): document Beskid vendoring and upstream repository link
    • …and 1 more seed tasks with provenance commits.

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-concurrency-runtime — Fibers, channels, and GC runtime

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for Fibers, channels, and GC runtime.

    9 / 9 tasks done

  • Corelib workspace publish hardening

    Closed 2026-05-21 on superrepo f57377a (v0.2 delivery tip).

    Corelib workspace package.json metadata, api.json tree validation before publish, bundle filtering for non-docs artifacts, prelude lowering CI (stack and release profile), and publish CI submodule coordination.

    Workstreams: pckg-registry, ci-release. 3 catalog tasks anchor this deliverable (milestoneId: v02-corelib-workspace-publish).

    Provenance

    • 483e7f4 (corelib) — fix(corelib): exclude non-docs .beskid files from workspace publish bundle
    • 361e370 (corelib) — ci: validate api.json library tree before corelib publish
    • 3845ef3 (corelib) — chore(corelib): add workspace.package.json member metadata for pckg publish

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-corelib-workspace-publish — Corelib workspace publish hardening

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for Corelib workspace publish hardening.

    3 / 3 tasks done

  • VS Code extension & Open VSX

    Closed 2026-05-22 on superrepo f57377a (v0.2 delivery tip).

    Wire beskid_vscode into the superrepo, green Open VSX CI with platform LSP matrix, LSP client/outline/status UX, modular extension runtime, and engine-aligned @types/vscode pin.

    Workstreams: editor-extension, dev-experience. 9 catalog tasks anchor this deliverable (milestoneId: v02-editor-extension).

    Provenance

    • 7a775e2 (beskid_vscode) — docs: document superrepo submodule and centralized Open VS X CI
    • d58dd44 (beskid) — feat(ci): add beskid_vscode submodule and init for Open VS X publish
    • 264a3c0 (beskid) — chore: bump compiler and pckg submodules; VS Code extension runtime, LSP client, outline, status
    • f6eceb6 (beskid_vscode) — refactor: modular extension runtime, commands, and package workflow UI
    • 6444332 (beskid) — ci: green pipelines for docs site, Open VSX publish, and Rust audit
    • 9d7891f (beskid) — fix(vscode): track extension packages sources; pckg package tree
    • a12e285 (beskid) — fix(git): pin beskid_vscode submodule to canonical GitHub URL
    • e174369 (beskid) — ci(open-vsx): publish darwin-arm64 VSIX and cross-build Intel LSP
    • …and 1 more seed tasks with provenance commits.

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-editor-extension — VS Code extension & Open VSX

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for VS Code extension & Open VSX.

    9 / 9 tasks done

  • LSP workspace & project graph

    Closed 2026-05-22 on superrepo f57377a (v0.2 delivery tip).

    Compiler LSP: rename, code actions, inlay hints, signature help, workspace symbols, workspace templates, project explorer, and project graph pipeline—consumed by VS Code extension client middleware.

    Workstreams: analysis-pipeline. 3 catalog tasks anchor this deliverable (milestoneId: v02-lsp-workspace).

    Provenance

    • 582170b (compiler) — compiler: LSP rename feature and corelib bump
    • 158215a (compiler) — LSP: code actions, inlay hints, signature help, workspace symbols; protocol and session updates
    • 6ae272b (compiler) — feat: workspace templates, LSP project explorer, and project graph pipeline

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-lsp-workspace — LSP workspace & project graph

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for LSP workspace & project graph.

    3 / 3 tasks done

  • Registry dashboard and package docs foundation

    Closed 2026-04-24 on superrepo f57377a (v0.2 delivery tip).

    Registry dashboard, public package pages, package source explorer with BlazorMonaco preview, registry activity log, registry-assigned semver on publish, and unified Fluent data-grid row actions.

    Workstreams: pckg-registry. 10 catalog tasks anchor this deliverable (milestoneId: v02-pckg-registry-foundation).

    Provenance

    • 067d53a (pckg) — fix(pckg): show grid action overflow row without VisibleOnLoad trap
    • adff57b (pckg) — feat: add moderation safeguards and public package pages
    • 52dc7c9 (pckg) — pckg: package source explorer, docs/structured API, BlazorMonaco preview, artifact explorer
    • f47efb7 (pckg) — feat(admin): registry activity log, publish observability
    • 71c5ec1 (pckg) — pckg: unify docs as PackageDocs, remove markdown browser and dialog
    • d003507 (pckg) — feat(docs): package docs browser, API, and Fluent UI polish
    • 126e8ca (compiler) — feat(pckg): publish UX, streamed upload, API success hardening
    • 459e018 (compiler) — feat(pckg): upload publishes with registry-assigned semver
    • …and 2 more seed tasks with provenance commits.

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-pckg-registry-foundation — Registry dashboard and package docs foundation

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for Registry dashboard and package docs foundation.

    10 / 10 tasks done

  • Platform-spec cutover

    Closed 2026-05-06 on superrepo f57377a (v0.2 delivery tip).

    Retired legacy Starlight guide trees; /platform-spec/ is the sole normative documentation area on beskid-lang.org (alongside the Book). Stabilized website container builds with monorepo lockfile and trudoc package bootstrap.

    Workstreams: platform-spec, analysis-pipeline, docs-site, ci-release. 8 catalog tasks anchor this deliverable (milestoneId: v02-platform-spec-cutover).

    Provenance

    • 139166f (beskid) — feat(trudoc): platform-spec frontmatter verification
    • dfe8ace (compiler) — feat(compiler): add member item resolution and docs pipeline updates
    • 98aa6bc (compiler) — Test harness, formatter, CLI/LSP integration, and CI hardening.
    • 6c5f200 (beskid) — fix(docs-ui): platform-spec home UX — tabs, map height, zoom, typography
    • e16f55a (compiler) — Improve ast_reflect_gen Mod SDK syntax emission and bump corelib.
    • 19745d4 (beskid) — consolidate platform-spec cutover and stabilize website container build
    • 8aa2813 (beskid) — feat(docs+ci): add trudoc/docs UI packages and workflow updates
    • 2cd54c5 (compiler) — Compiler: array type lowering, services split, pipeline crate, rustdoc sweep, Mod SDK regen.

    Catalog scope

    • Delivery version: v0.2 (Analysis, packages, and platform spec)
    • Deliverable: v02-platform-spec-cutover — Platform-spec cutover

    Relation

    Groups the v0.2 seed tasks linked via milestoneId for Platform-spec cutover.

    8 / 8 tasks done

Workstreams

  • Analysis & pipeline

    Typed compiler spine for v0.2: beskid_pipeline progress phases, beskid_analysis services split, composition and macro HIR passes, structured api.json emission, ast_reflect_gen Mod SDK regen, and LSP workspace/project-graph integration aligned with the platform spec.

    • Pipeline crate owns shared lower → resolve → normalize → type progress.
    • Registry doc pipeline feeds hierarchical api.json for pckg ingest.
    • Macro registry, expand pass, and resolver fixes land before May 20 composition wave.
    Overview
  • Platform specification

    Normative platform-spec tree on beskid-lang.org: cutover from legacy Starlight guides, home browse/map UX, build-pipeline and conformance guide sync, language-meta interop and file-scoped module articles, assembly/DI/macro hubs, submodule-aligned api.json and LSP chapters, trudoc frontmatter verification, and GC/runtime alignment with compiler work.

    • /platform-spec/ is the sole normative docs area beside the Book.
    • Spec leads code: hub updates track compiler and pckg submodule bumps.
    Overview
  • Package registry

    pckg registry and package documentation: dashboard and public package pages, structured api.json ingest with publish gates, Microsoft Docs–style library tree UI, workspace publish with auto-provision, corelib workspace publish hardening, Fluent grid row actions, and registry-assigned semver on upload.

    • api.json is the primary contract for PackageDocs (types, members, typeRef links).
    • Publish validation rejects packages missing hierarchical API metadata.
    Overview
  • Docs site

    Public docs site (site/website): trudoc + @beskid/docs-ui, platform-spec reader chrome (tabs, map, Giscus), early language book and corelib naming, tutorial/ADR routing, registry API reference MDX, and end-of-window trudoc verify plus book frontmatter hardening.

    • Bun prebuild runs trudoc verify; container builds may skip full verify with BESKID_SKIP_TRUDOC_VERIFY.
    • Book and platform-spec share platform-spec-nav chrome tokens.
    Overview
  • Codegen & runtime

    Execution surfaces for v0.2: spawn/fiber runtime and channels, vendored abfall GC heap integration, runtime/ABI module alignment, and lowering-test CI stack hardening on the compiler side.

    • Syscall-backed I/O remains under corelib System split surfaces.
    • GC spec chapters align with abfall vendoring and heap integration commits.
    Overview
  • Editor & Open VSX

    beskid_vscode submodule, Open VSX publish matrix with cross-arch LSP bundles, extension runtime modularization, and CLI-driven language client launch (beskid lsp).

    • darwin-x64 jobs cross-build Intel LSP when CI runs on Apple Silicon.
    • Extension tracks package workflow UI and LSP outline/status integration.
    Overview
  • CI & release pipelines

    GitHub Actions and Nox workflows: docs site, Open VSX, Rust audit, compiler CLI GitHub Releases (cli-latest + versioned tags), and superrepo workflow hardening.

    • Rolling CLI semver syncs to website via sync:cli-version.
    • Submodule bumps coordinate compiler, pckg, corelib, and vscode pins.
    Overview
  • Superrepo & deploy ergonomics

    Superrepo ergonomics: submodule pins (vscode, bsharp references), Coolify shallow-clone fixes, monorepo bun lockfile in site image builds, and AGENTS/workflow guidance refinements.

    • Deploy paths skip inactive references/bsharp when not initialized.
    • Canonical vscode submodule URL prevents drift across clones.
    Overview

Recent tasks