0x0LearnReferenceLibrariesMigration0x0.jmp0x1b.com

0x0 Public Documentation And Website Migration Roadmap

This roadmap makes 0x0 the public successor to jmp0x1b/lang for language

documentation, learning material, static websites, and the library registry.

The target is not a copy of the old documentation. The target is a complete

0x0 public documentation system that describes only what 0x0 implements today,

clearly marks deferred work, and gives users a safe path away from

jmp0x1b/lang and jmp0x1b/libs.

Scope

In scope:

capabilities, runtime boundaries, release compatibility, and migration;

libraries, and production app surfaces;

reversible, documented way;

jmp0x1b.com with correct 0x0 successor messaging;

Out of scope:

space assurance, or mission I/O behavior as implemented 0x0 behavior;

behavior as core language/runtime features unless the current 0x0

implementation proves that slice;

paths, and smoke checks exist;

Replacement Definition

0x0 has reached documentation replacement parity when:

non-embedded page class;

artifacts, runtime boundaries, and app usage without reading jmp0x1b/lang;

release, and compatibility behavior without aspirational claims;

test evidence;

surfaces, with migration links to 0x0;

without relying on broad unsafe gates.

Session Safety Rules

The docs and website work must not repeat known session-breaking behavior.

resource-safe or replaced.

and explicit about which files they inspect.

inventory and dry-run publish plans.

caps and timeouts.

Documentation Truth Policy

Every public page must follow the 0x0 documentation standard:

features;

matching source, tests, and gates.

Standing Gates

These gates are introduced by the roadmap. Until the milestone that creates a

gate lands, the gate name is a target contract rather than a command to run.

Required safe gates:


make public-docs-inventory-check
make public-site-link-check
make public-reference-check
make public-best-practices-check
make public-cookbook-check
make libs-registry-site-check
make public-migration-check
make static-site-deploy-plan-check

Gate rules:

output;

by a resource-safe mode;

remains a deliberate release step.

Milestone 0: Documentation Parity Inventory And Safety Baseline

Status: complete.

Goal: turn the current analysis into a checked inventory that separates

required 0x0 public docs from embedded/deferred material and unsafe commands.

0.1 Source Inventory

Required work:

public docs;

and generated API docs;

- direct 0x0 equivalent exists;

- needs new 0x0 page;

- needs rewritten 0x0 page from current implementation;

- app-specific only;

- embedded/deferred;

- obsolete and should not be ported;

Artifacts:

Exit gate:


make public-docs-inventory-check

Completion rule: the gate must fail if an embedded-only old page is mapped to a

current 0x0 feature page.

0.2 Website Route Contract

Required work:

Libraries, Migration, and Release;

pages;

0x0.jmp0x1b.com.

Artifacts:

Exit gate:


make public-site-route-check

Completion rule: every planned public route must have a source file, redirect

rule, or explicit deferred reason.

0.3 Safe Docs Gate Contract

Required work:

Artifacts:

Exit gate:


make public-docs-safe-gates-check

Completion rule: the gate must prove that public docs verification does not

invoke make docs-check.

0.4 Remote Website Inventory

Required work:

ssh deploy@138.197.233.77;

deployment scripts for:

- lang.jmp0x1b.com;

- 0x0.jmp0x1b.com;

- libs.jmp0x1b.com;

- jmp0x1b.com;

Artifacts:

contain environment-specific details.

Exit gate:


make static-site-remote-inventory-check

Completion rule: no remote mutation command is part of the inventory gate.

Milestone 1: Static Website Foundation

Status: complete.

Goal: create the local static site structure and navigation for

0x0.jmp0x1b.com.

1.1 Site Directory Contract

Required work:

Required content:

program, and migration link;

Artifacts:

Exit gate:


make public-site-structure-check

Completion rule: the gate must fail if a required top-level site page is

missing.

1.2 Portal Asset Migration

Required work:

Artifacts:

Exit gate:


make public-site-assets-check

Completion rule: the site must render without external network dependencies.

1.3 Static Build Contract

Required work:

policy;

Artifacts:

Exit gate:


make public-site-build-check

Completion rule: site build must produce deterministic output paths and hashes.

1.4 Link And Navigation Gate

Required work:

Artifacts:

Exit gate:


make public-site-link-check

Completion rule: every site link is either resolvable, external-allowed, or a

documented redirect/deprecation target.

Milestone 2: Learn 0x0 Course

Status: complete.

Goal: replace the old learn-jmp0x1b path with a complete, truthful 0x0

learning path.

2.1 Course Scope And Lesson Contract

Required work:

agents;

lesson;

Artifacts:

Exit gate:


make learn-0x0-map-check

Completion rule: every lesson must name the implementation evidence it teaches.

2.2 Core Language Lessons

Required lessons:

doc, call arity, simple type checks;

manifests, lockfiles;

process, current enforcement, and current runtime limits.

Required behavior:

existing executable example.

Exit gate:


make learn-0x0-core-check

Completion rule: the gate must fail if a lesson documents syntax not accepted

by the current compiler.

2.3 Data, Libraries, And Workflow Lessons

Required lessons:

JSON-field, error, safe path, and safe file conventions;

helpers, and safe observable behavior;

contract, package import checks, and expected output;

API freshness checks;

docs, and current production compiler boundaries.

Exit gate:


make learn-0x0-workflow-check

Completion rule: each lesson must reference current repo artifacts, not old

jmp0x1b/lang files.

2.4 Runtime, Apps, And Migration Lessons

Required lessons:

boundary, production host, and fake adapter distinction;

corpus, source package build path, and app release artifacts;

release diagnostics;

resource-safe gates, and contribution discipline;

package mapping, unsupported features, and site migration.

Exit gate:


make learn-0x0-runtime-migration-check

Completion rule: app lessons must distinguish production app behavior from

test fakes and checker-owned behavior.

Milestone 3: Public Reference Documentation

Status: complete.

Goal: make 0x0 reference material complete enough that users do not need the

old language docs for non-embedded work.

3.1 Grammar And Syntax Reference

Required work:

imports, exports, annotations, capabilities, and supported builtins;

Artifacts:

Exit gate:


make public-syntax-reference-check

Completion rule: syntax reference must be checked against parser-owned forms.

3.2 Language Specification

Required work:

separate docs/language-spec.html;

semantic checks, value representations, runtime truth rules, and backend

differences;

Artifacts:

Exit gate:


make public-language-spec-check

Completion rule: the spec must not claim a complete type system until the

checker implements one.

3.3 Package And API Reference

Required work:

aliases, package validation, and standalone library rules;

Artifacts:

Exit gate:


make public-package-api-reference-check

Completion rule: package docs must fail if they reference missing lockfile or

manifest behavior.

3.4 Diagnostics Reference

Required work:

linker, runtime, and app diagnostics;

Artifacts:

Exit gate:


make public-diagnostics-reference-check

Completion rule: diagnostics pages must reference real diagnostic strings or

stable diagnostic categories.

3.5 Capability And Runtime Boundary Reference

Required work:

implementations;

do not exist;

implemented runtime surfaces;

behavior.

Artifacts:

Exit gate:


make public-runtime-reference-check

Completion rule: generic runtime docs must not rely on app-only fixtures as

proof of core runtime behavior.

3.6 Release And Compatibility Reference

Required work:

object/archive format, linker behavior, and runtime ABI;

Artifacts:

Exit gate:


make public-release-reference-check

Completion rule: release docs must name artifact hashes or manifests where

release claims depend on artifacts.

Milestone 4: Best Practices, Lint, And Safe Command Guidance

Status: complete.

Goal: make 0x0 style, lint, library, and command discipline explicit and

enforced by resource-safe checks.

4.1 Source Style Guide

Required work:

external protocol names;

constructor-like tagged values, and test names;

Artifacts:

Exit gate:


make public-style-guide-check

Completion rule: style docs must match the lint rules available in the repo.

4.2 Lint Rule Catalog

Required work:

balanced parentheses if those remain active;

Artifacts:

Exit gate:


make public-lint-reference-check

Completion rule: every active lint rule must have an executable check or be

marked documentation-only.

4.3 Safe Command Guide

Required work:

site checks;

the default safe path while it can break sessions.

Artifacts:

Exit gate:


make public-safe-command-check

Completion rule: public docs must not instruct default users to run known

session-breaking commands.

4.4 Standalone Library Contract

Required work:

documented imports, exported API, and expected output;

Artifacts:

Exit gate:


make public-standalone-libraries-check

Completion rule: every listed public library must have a smoke test or an

explicit non-public/deferred reason.

4.5 Contribution And Review Discipline

Required work:

changes;

Artifacts:

Exit gate:


make public-contribution-docs-check

Completion rule: contribution docs must link to safe commands and current

implementation docs.

Milestone 5: Cookbook, Tutorials, And Task Index

Status: complete.

Goal: turn the current examples, libraries, and app surfaces into practical

public workflows.

5.1 Example And Library Recipe Inventory

Required work:

cost;

Artifacts:

Exit gate:


make public-cookbook-inventory-check

Completion rule: every recipe must point to a real source file or be marked as

planned/deferred.

5.2 Core Language Cookbook

Required recipes:

Artifacts:

Exit gate:


make public-core-cookbook-check

Completion rule: each recipe must be either executable or explicitly marked

read-only/reference.

5.3 Package And Library Cookbook

Required recipes:

Artifacts:

Exit gate:


make public-package-cookbook-check

Completion rule: package recipes must not require access to old

jmp0x1b/libs.

5.4 Runtime Cookbook

Required recipes:

Artifacts:

Exit gate:


make public-runtime-cookbook-check

Completion rule: runtime recipes must clearly distinguish production adapters

from fake test adapters.

5.5 App Cookbook

Required recipes:

Artifacts:

Exit gate:


make public-app-cookbook-check

Completion rule: app recipes must not claim production completeness where

apps/real-rewrite-gap.tsv still marks behavior incomplete.

5.6 Task Index

Required tasks:

Artifacts:

Exit gate:


make public-task-index-check

Completion rule: each task must link to a command, reference page, or explicit

manual procedure.

Milestone 6: Library Registry Site

Status: complete.

Goal: make libs.jmp0x1b.com describe the 0x0 libraries and retire the old

jmp0x1b/libs registry.

6.1 Registry Metadata Inventory

Required work:

doc coverage, smoke status, compatibility name, and public/deferred status;

preserved public package names;

scaffold-only, or obsolete.

Artifacts:

Exit gate:


make libs-registry-inventory-check

Completion rule: every directory under libs/ must appear exactly once in the

registry metadata.

6.2 Package Naming And Alias Policy

Required work:

names or get 0x0-native aliases;

display names;

- remove from active index;

- mark archived;

- redirect to 0x0 replacement;

- preserve tombstone metadata.

Artifacts:

Exit gate:


make libs-registry-naming-check

Completion rule: old names must have an alias, preservation decision, or

deprecation/tombstone entry.

6.3 Registry Static Site

Required work:

Artifacts:

Exit gate:


make libs-registry-site-check

Completion rule: every public registry page must be backed by local 0x0 source

and registry metadata.

6.4 Registry Smoke Evidence

Required work:

Artifacts:

Exit gate:


make libs-registry-smoke-evidence-check

Completion rule: public libraries without evidence must fail the gate unless

they are explicitly marked deferred.

6.5 Old Registry Unregistration Plan

Required work:

for audit.

Artifacts:

Exit gate:


make libs-registry-unregistration-plan-check

Completion rule: unregistration may not proceed without rollback and tombstone

metadata.

Milestone 7: Top-Level Migration And Obsolescence Docs

Status: complete.

Goal: make the replacement relationship between jmp0x1b/lang, 0x0, and the

public domains clear.

7.1 Obsolescence Statement

Required work:

work;

Artifacts:

Exit gate:


make public-obsolescence-docs-check

Completion rule: obsolescence docs must not delete historical context needed

for migration.

7.2 Command Mapping

Required work:

workflows.

Artifacts:

Exit gate:


make public-command-map-check

Completion rule: every command table entry must be marked current, renamed,

deferred, or removed.

7.3 Syntax And Package Migration

Required work:

library data representation changes;

Artifacts:

Exit gate:


make public-syntax-migration-check

Completion rule: migration examples must be valid 0x0 or explicitly marked

pseudocode.

7.4 Feature Support Matrix

Required work:

compiler outputs, libraries, runtime boundaries, apps, web/runtime, release,

and embedded;

- implemented;

- implemented for app/runtime boundary only;

- test adapter only;

- partial;

- deferred;

- obsolete;

Artifacts:

Exit gate:


make public-feature-matrix-check

Completion rule: implemented rows must have evidence links.

7.5 Domain Update Plan

Required work:

Artifacts:

Exit gate:


make public-domain-migration-plan-check

Completion rule: every public domain must have current, target, publish, verify,

and rollback entries.

Milestone 8: Static Site Deployment And Remote Cutover

Status: complete.

Goal: publish the new public docs and migration pages safely.

8.1 Local Release Bundle

Required work:

Artifacts:

Exit gate:


make static-site-release-bundle-check

Completion rule: every file in the release bundle must have a checksum and

target domain.

8.2 Remote Dry Run

Required work:

Artifacts:

Exit gate:


make static-site-deploy-plan-check

Completion rule: dry run must show all remote changes before any publish step.

8.3 Publish 0x0 Docs Site

Required work:

release pages;

Artifacts:

Exit gate:


make static-site-0x0-smoke-check

Completion rule: smoke checks must fetch public pages and compare expected

content markers.

8.4 Publish Library Registry Site

Required work:

Artifacts:

Exit gate:


make static-site-libs-smoke-check

Completion rule: public registry smoke must prove that old active entries no

longer appear as current packages.

8.5 Publish Lang Archive And Top-Level Update

Required work:

Artifacts:

Exit gate:


make static-site-top-level-smoke-check

Completion rule: public smoke must verify that users can navigate from

jmp0x1b.com and lang.jmp0x1b.com to 0x0.

Milestone 9: Public UX, Search, And Metadata

Status: complete.

Goal: make the published static sites usable as public documentation, not just

raw Markdown.

9.1 Metadata And Discoverability

Required work:

Artifacts:

Exit gate:


make public-site-metadata-check

Completion rule: every public page must have title and canonical route

metadata.

9.2 Redirect And Link Preservation

Required work:

Artifacts:

Exit gate:


make public-redirect-check

Completion rule: every redirect must terminate in one hop or an explicitly

accepted chain.

9.3 Public Search Index

Required work:

descriptions;

Artifacts:

Exit gate:


make public-search-index-check

Completion rule: search index generation must be bounded and not crawl the

whole repository unexpectedly.

Milestone 10: Acceptance, Maintenance, And Release Discipline

Status: complete.

Goal: keep public docs, static sites, and registry content current after the

initial migration.

10.1 Public Documentation Acceptance Matrix

Required work:

migration pages, and domain behavior;

Artifacts:

Exit gate:


make public-docs-acceptance-check

Completion rule: public claims without evidence must fail unless marked as

limitation or deferred.

10.2 Release Checklist Integration

Required work:

Artifacts:

Exit gate:


make public-docs-release-check

Completion rule: a release that changes public behavior must update docs or

explicitly record why docs are unchanged.

10.3 Drift Detection

Required work:

Artifacts:

Exit gate:


make public-docs-drift-check

Completion rule: drift checks must be bounded and safe for normal sessions.

10.4 Completion Evidence

Required work:

Artifacts:

Exit gate:


make public-docs-website-completion-check

Completion rule: completion evidence must prove the user can start at

jmp0x1b.com, reach current 0x0 docs, learn 0x0, browse 0x0 libraries, and see

that old jmp0x1b/lang and jmp0x1b/libs are obsolete or archived.

Recommended Implementation Order

1. Complete Milestone 0 so the work is classified and safe.

2. Create the site/ skeleton and local link gate in Milestone 1.

3. Write the Learn path in Milestone 2.

4. Fill reference docs in Milestone 3.

5. Add best-practice, lint, standalone library, and safe command docs in

Milestone 4.

6. Build cookbook/tutorial/task content in Milestone 5.

7. Build library registry metadata and site pages in Milestone 6.

8. Write migration and obsolescence docs in Milestone 7.

9. Publish with dry-run, manifest, smoke, and rollback discipline in

Milestone 8.

10. Add metadata/search and maintenance checks in Milestones 9 and 10.

Blockers To Resolve Before Deployment

ids or receive 0x0-native aliases;

Completion Signal

This roadmap is complete when:

equivalent;

pages are published;

jmp0x1b/libs as current;

as implemented.