27 minutes read

Roadmap

Offing H1 — Coverage & Proof · 2026-10-15 → 2027-04-15 · 21 phases, each its own milestone, run in order · project board

This file is generated from planning/roadmap/ by node planning/roadmap/roadmap-md.mjs. Edit the data, not this file. Scope changes still require an explicit decision recorded in docs/decisions/.

Direction

Offing's engineering is ahead of its data and its evidence. For the next six months the order is:

  1. Content before new surfaces. Lifecycle rules are generated from authoritative machine-readable sources and reviewed, not hand-written one by one.
  2. Independent proof. Accuracy is measured against ground truth Offing did not write: real migration commits, upstream changelogs, and differential testing.
  3. Agent-native by default. Agents check dependencies as they add them, and every push can run Offing through hooks.
  4. Standards, not a new format. Rules are keyed by PURL and VERS and exported as CLE (ECMA-428) and CycloneDX lifecycle data.
  5. Grow inside existing workflows. Offing ships into pipelines people already run and launches once, on a release that works.

The long-term goal is for Offing to be the first lifecycle reference agents and DevOps teams reach for. This roadmap builds the foundation: open evidence, standard formats, and presence in every common pipeline.

Releases before v1

v1 is a compatibility promise, so it should rest on how real people use Offing. One release comes first (decision):

  1. v0.8.0 — Adoption and visibility. Get Offing used, by developers and by agents: a clean package on external scorecards, a short README with demos, a first run that just works, setups for every common agent host and stack, organization-wide rollout, and five pilot users. Then get it known: contributors, one launch, open data, search, and proof.
  2. v1.0 — Hardening. Phase 37: contract audit, compatibility guarantees, threat model, and performance budget.

Ideas for after v1 are tracked as epics in the After v1 — Future milestone and are not scheduled.

v1 targets

Measure Today Target
Ecosystems and platforms detected 4 25+ (12 stable, the rest experimental)
Lifecycle signals imported with evidence 0 3,000+
Curated rules with migration packets 15 300+
Symbol-level API deprecation rules 0 100+
Independent ground-truth corpus 20 repositories, self-defined 300 repositories, ground truth not authored by Offing
Precision per stable detector 1.0 against own rules ≥ 0.95 against independent ground truth
Data freshness tied to package releases ≤ 7 days through a signed data channel
Distribution npm, skills.sh + MCP Registry, GitHub Marketplace, GitLab Catalog, Docker, pre-commit, MegaLinter, VS Code, Claude, Codex
External contributors with merged PRs 0 15+

Phases

Each phase is a GitHub milestone. A phase starts when the previous one is complete, and no task depends on a later phase.

Phase Window Issues
Phase 20 — Ready for contributors and real data 2026-10-15 → 2026-11-15 71
Phase 21 — Fresh data and agent guardrails 2026-11-16 → 2026-12-15 61
Phase 21.5 — Release 0.2: ship what is built 2026-10-17 → 2026-10-31 26
Phase 22 — Backend, cloud, and Kubernetes coverage 2026-12-16 → 2027-01-15 95
Phase 23 — Standards and precise code analysis 2027-01-16 → 2027-02-15 60
Phase 24 — Community ecosystems and open data 2027-02-16 → 2027-03-15 71
Phase 25 — Offing v1 2027-03-16 → 2027-04-15 4
Phase 26 — Offing checks itself 2026-10-23 → 2026-11-12 6
Phase 27 — Trust and accuracy 2026-11-13 → 2026-12-03 11
Phase 28 — Data freshness 2026-12-04 → 2026-12-24 6
Phase 29 — Agent-native 2026-12-25 → 2027-01-14 8
Phase 30 — Personal use 2027-01-15 → 2027-02-04 11
Phase 31 — Forecast and planning 2027-02-05 → 2027-02-25 9
Phase 32 — Fix and automation 2027-02-26 → 2027-03-18 6
Phase 33 — Team and DevOps 2027-03-19 → 2027-04-08 17
Phase 34 — Editor and guard 2027-04-09 → 2027-04-29 6
Phase 35 — Coverage: cloud, OS, and runtimes 2027-04-30 → 2027-05-20 12
Phase 36 — Interop and standards 2027-05-21 → 2027-06-10 12
v0.8.0 — Adoption and visibility 2026-10-28 → 2027-01-26 171
Phase 37 — Offing v1 hardening 2027-01-27 → 2027-02-23 16
After v1 — Future after v1, unscheduled 7

How work is organized

Every roadmap issue belongs to one phase milestone and is small enough for one pull request. Labels say who it suits:

Label Meaning
lane: strong-agent Codex or Claude (or an experienced contributor)
lane: free-agent Freebuff, Kilo Code, or any contributor
lane: maintainer Maintainer only (accounts, submissions, releases, outreach)
size: XS / S / M Under an hour / a few hours / about a day
good first issue A complete brief, isolated change, and fixtures — a good first contribution
type: epic Tracking issue that lists its tasks

Pick any open task whose dependencies are closed. Each task includes an agent brief with files, steps, commands, and a done-check. See CONTRIBUTING.md.

Phase 20 — Ready for contributors and real data

2026-10-15 → 2026-11-15 · 68 tasks · milestone

When this phase is complete, Offing has:

  • AGENTS.md, issue forms, PR template, CODEOWNERS, dev container, and a 30-minute first-contribution path
  • Lifecycle rule format v2 keyed by PURL and VERS, with provenance and freshness; all bundled registries migrated
  • SHA-pinned GitHub Actions classified instead of silently ignored
  • Importer framework plus importers for Node.js, Python, npm, PyPI, GitHub Actions runtimes, and runner images
  • Independent ground truth from real migration commits; 10 new GitHub Actions corpus repositories; weekly corpus runs
  • Shared detector conformance suite run by every built-in detector
  • CI on Linux, Windows, and macOS with Node 22 and 24; npm trusted publishing with provenance
  • 40+ new curated npm, Python, and GitHub Actions rules; weekly adoption measurement

Epics

Phase 21 — Fresh data and agent guardrails

2026-11-16 → 2026-12-15 · 57 tasks · milestone

When this phase is complete, Offing has:

  • Signed lifecycle data bundle with offing data update and offing data status; scans stay offline
  • Agent guardrail: offing check, the check_dependency MCP tool, and hooks for Claude Code and Codex, with setups for Cursor, Gemini CLI, Copilot, and Kilo Code
  • MCP resources, prompts, and typed outputs; listing in the official MCP Registry; llms.txt
  • offing init --agents --hooks with a git pre-push hook and a pre-commit hook
  • SARIF output and GitHub Code Scanning upload
  • Detector scaffolding generator; Go and container base-image detection
  • Scheduled importers opening data PRs; differential testing against Renovate and xeol; 50-repository corpus

Epics

Phase 21.5 — Release 0.2: ship what is built

2026-10-17 → 2026-10-31 · 21 tasks · milestone

When this phase is complete, Offing has:

  • Offing 0.2.0 on npm with trusted publishing, provenance, and a post-publish smoke test
  • The first signed data bundle and the first scheduled importer run
  • Agent host setups verified in live hosts; Offing listed in the official MCP Registry
  • Bounded monorepo discovery, proven on monorepos in the public corpus
  • Go detection wired and documented; a full corpus run on the current rules

Epics

Phase 22 — Backend, cloud, and Kubernetes coverage

2026-12-16 → 2027-01-15 · 85 tasks · milestone

When this phase is complete, Offing has:

  • Rust, Java and Kotlin, .NET, Kubernetes API, and serverless runtime (AWS Lambda, Azure Functions, Google Cloud) detection
  • Polished one-step GitHub Action published in GitHub Marketplace; container image on GHCR; README badge
  • Expiring, machine-readable suppression reasons
  • Detector maturity levels and a generated coverage matrix; 100-repository corpus with regression thresholds
  • Public reference page for every lifecycle rule, with JSON-LD and a sitemap
  • Integrations: GitHub starter workflow, MegaLinter, reviewdog, and trunk

Epics

Phase 23 — Standards and precise code analysis

2027-01-16 → 2027-02-15 · 55 tasks · milestone

When this phase is complete, Offing has:

  • tree-sitter usage analysis for JavaScript, TypeScript, and Python, replacing regex matching
  • Symbol-level API deprecation rules for Node.js and Python
  • CLE (ECMA-428) export, CycloneDX lifecycle enrichment, and CycloneDX/SPDX SBOM input
  • Agent migration benchmark with published results
  • Terraform and Android detection; community-led Dart/Flutter and Swift detection
  • Lifecycle rules for Django, Angular, Vue, React Native, Next.js, and Spring Boot

Epics

Phase 24 — Community ecosystems and open data

2027-02-16 → 2027-03-15 · 65 tasks · milestone

When this phase is complete, Offing has:

  • Community-led PHP, Ruby, C/C++, Shell/PowerShell, database, and CI runner-image detection
  • Lifecycle rules for Rails and Laravel
  • GitLab CI/CD component published in the GitLab CI/CD Catalog
  • Open lifecycle dataset with a static JSON API, and maintainer-declared lifecycle read from CLE files
  • Public governance, RFC process, detector owners, and Code of Conduct
  • VS Code extension with inline diagnostics

Epics

  • PHP lifecycle detection — Detect evidence-backed PHP lifecycle risks at exact locations and produce migration packets, built from small independent tasks. (12 tasks) (community-led; may slip without blocking v1)

  • Ruby lifecycle detection — Detect evidence-backed Ruby lifecycle risks at exact locations and produce migration packets, built from small independent tasks. (12 tasks) (community-led; may slip without blocking v1)

  • C and C++ lifecycle detection — Detect evidence-backed C and C++ lifecycle risks at exact locations and produce migration packets, built from small independent tasks. (10 tasks) (community-led; may slip without blocking v1)

  • Shell and PowerShell lifecycle detection — Detect evidence-backed Shell and PowerShell lifecycle risks at exact locations and produce migration packets, built from small independent tasks. (9 tasks) (community-led; may slip without blocking v1)

  • Database runtimes lifecycle detection — Detect evidence-backed Database runtimes lifecycle risks at exact locations and produce migration packets, built from small independent tasks. (10 tasks) (community-led; may slip without blocking v1)

  • CI runner images (GitLab, CircleCI, Azure Pipelines) lifecycle detection — Detect evidence-backed CI runner images (GitLab, CircleCI, Azure Pipelines) lifecycle risks at exact locations and produce migration packets, built from small independent tasks. (10 tasks) (community-led; may slip without blocking v1)

    Also in this phase, from epics listed in other phases:

Phase 25 — Offing v1

2027-03-16 → 2027-04-15 · 3 tasks · milestone

When this phase is complete, Offing has:

  • Offing v1 with published compatibility guarantees and release notes
  • Public accuracy and performance dashboard; 300-repository independent corpus
  • Tested playbooks for CLI, agents, GitHub, and GitLab
  • Threat model, parser fuzzing, SLSA provenance, and a 100k-file monorepo benchmark
  • Persian README and quickstart
  • Demo video, case studies, and the v1 launch

Epics

Phase 26 — Offing checks itself

2026-10-23 → 2026-11-12 · 6 tasks · milestone

When this phase is complete, Offing has:

  • Offing scans its own repository in CI and fails on new findings
  • Its own Actions and dependencies are pinned and monitored with Offing
  • Every self-scan finding is triaged, and the released CLI is smoke-tested on this repository

Epics

Also in this phase, from epics listed in other phases:

Phase 27 — Trust and accuracy

2026-11-13 → 2026-12-03 · 10 tasks · milestone

When this phase is complete, Offing has:

  • Detectors promoted from experimental to beta on measured recall and precision
  • Independent corpus, differential testing, and a regression gate on every pull request
  • Confidence levels, report-issue, and per-detector accuracy tables

Epics

Phase 28 — Data freshness

2026-12-04 → 2026-12-24 · 5 tasks · milestone

When this phase is complete, Offing has:

  • Scheduled end-of-life rules for Node.js, Python, Go, and PostgreSQL
  • Importers that open reviewed rule PRs, and recorded future end-of-life dates
  • Curated framework rules with migration packets

Epics

Phase 29 — Agent-native

2026-12-25 → 2027-01-14 · 8 tasks · milestone

When this phase is complete, Offing has:

  • One-command setup that configures every agent host
  • Compact, stable, machine-readable output with documented error codes
  • A repository lifecycle status file agents can read, and one focused Skill per ecosystem

Epics

Also in this phase, from epics listed in other phases:

Phase 30 — Personal use

2027-01-15 → 2027-02-04 · 11 tasks · milestone

When this phase is complete, Offing has:

  • Scan many projects at once, and check the tools installed on this machine
  • A standalone binary, a friendly first run, a terminal browser, and an HTML report
  • A global pre-push hook and a weekly digest for personal projects

Epics

Also in this phase, from epics listed in other phases:

Phase 31 — Forecast and planning

2027-02-05 → 2027-02-25 · 9 tasks · milestone

When this phase is complete, Offing has:

  • offing forecast and --as-of show what becomes end of life next
  • Upgrade paths, replacement compatibility checks, and a lifecycle risk score
  • Transitive dependencies with the path that pulls them in, and an exposure timeline from git history

Epics

Also in this phase, from epics listed in other phases:

Phase 32 — Fix and automation

2027-02-26 → 2027-03-18 · 6 tasks · milestone

When this phase is complete, Offing has:

  • offing fix --dry-run prints deterministic patches
  • Fixers for Actions versions and runtime pins, and codemod packs for common replacements
  • Verify-after-fix, and tested playbooks for CLI, agents, GitHub, and GitLab

Epics

Also in this phase, from epics listed in other phases:

Phase 33 — Team and DevOps

2027-03-19 → 2027-04-08 · 16 tasks · milestone

When this phase is complete, Offing has:

  • GitLab CI/CD component in the Catalog, with Code Quality reports
  • Pre-commit, MegaLinter, trunk, and starter-workflow integrations
  • Pull-request summaries, offing diff, owner routing, and scheduled lifecycle-watch workflows

Epics

Phase 34 — Editor and guard

2027-04-09 → 2027-04-29 · 5 tasks · milestone

When this phase is complete, Offing has:

  • VS Code extension on the Marketplace and Open VSX
  • A language server that shows lifecycle diagnostics in any editor, and a JetBrains plugin
  • offing guard blocks end-of-life packages before npm, pip, or uv installs them

Epics

  • VS Code extension — Show lifecycle findings inline in the editor using the local CLI. (7 tasks)

Phase 35 — Coverage: cloud, OS, and runtimes

2027-04-30 → 2027-05-20 · 12 tasks · milestone

When this phase is complete, Offing has:

  • Scan built container images, kubectl dumps, Terraform plan JSON, and rendered Helm output
  • Managed Kubernetes and Azure and Google Cloud database engines
  • Elixir, Scala, Deno, and Bun detection, and runtime pins in Dockerfile RUN lines

Epics

Also in this phase, from epics listed in other phases:

Phase 36 — Interop and standards

2027-05-21 → 2027-06-10 · 11 tasks · milestone

When this phase is complete, Offing has:

  • CLE (ECMA-428) export and validation, CycloneDX enrichment, and CycloneDX and SPDX input
  • Maintainer-declared lifecycle read from dependencies
  • Renovate presets and OSV cross-reference for unpatched exposure

Epics

v0.8.0 — Adoption and visibility

2026-10-28 → 2027-01-26 · 152 tasks · milestone

When this phase is complete, Offing has:

  • A clean npm package: no dependency alerts from a shipped fixture, provenance, and passing OpenSSF Scorecard and Best Practices checks
  • The documentation site on Slipway with every existing URL preserved, and Offing scanning Slipway and the maintainer's other repositories
  • A shorter README with reproducible demos a few seconds long
  • A first run that works from the published package on Linux, macOS, and Windows
  • Install paths and daily-loop setups for Claude Code, Codex, Cursor, Copilot, Windsurf, Cline, and Aider
  • Starter kits for common stacks and an organization-wide rollout workflow
  • Pipeline integrations people already run, and five pilot users with written feedback
  • A five-minute contributor path, governance, and a steady supply of good first issues
  • The launch kit, demo video, one launch, and recurring end-of-life posts
  • The open lifecycle dataset, a public lookup page, and a "State of EOL" report
  • Rule pages that rank in search, comparison pages, and listings where developers look
  • Agent migration benchmark results and real migration case studies
  • Monthly star, contributor, and repeat-use numbers from public signals only

Epics

Phase 37 — Offing v1 hardening

2027-01-27 → 2027-02-23 · 12 tasks · milestone

When this phase is complete, Offing has:

  • Contract and surface audit, compatibility guarantees, and v1 release notes
  • Threat model, parser fuzzing, bounded parser input, and reproducible builds
  • An enforced performance budget on a large-monorepo benchmark

Epics

After v1 — Future

after v1, unscheduled · 0 tasks · milestone

When this phase is complete, Offing has:

  • A local, in-browser playground, shareable outputs and badges, and better feedback capture
  • A Rule-a-thon contribution event, talks and podcasts, standards and upstream presence, and translated docs

Epics

  • Local in-browser playground — Try Offing without installing anything: the scan runs in the browser and nothing is uploaded. (0 tasks)
  • Outputs people share — Every user can show Offing to others. (0 tasks)
  • Less friction, more feedback — Every time a user gets stuck, the project learns about it and fixes it. (0 tasks)
  • Rule-a-thon contribution event — A two-week event where contributors add rules and fixtures. (0 tasks)
  • Talks, podcasts, and meetups — Present Offing to real audiences. (0 tasks)
  • Standards and upstream presence — Credibility through work with established projects. (0 tasks)
  • Homebrew in homebrew-core — brew install offing with no tap. Start when the project meets homebrew-core's notability bar for a self-submitted formula (about 75 stars, 30 forks, 30 watchers and a repository older than 30 days; check the current Acceptable Formulae page first) and has a stable release. The formula installs the npm tarball, so it needs a brew test and an audit --new --strict pass. There is no tap and no deploy key before then. (0 tasks)
  • Multilingual reach — Reach large non-English developer communities, with native-speaker review. (0 tasks)

Not in this roadmap

  • A hosted service, accounts, or dashboards that require uploading source code.
  • Telemetry in the core (see the privacy ADR in M6; any opt-in design is post-v1).
  • Vulnerability scanning or CVE remediation.
  • Lifecycle claims without an authoritative, versioned source.

Earlier roadmaps

View Markdown

Use with an agent
View Markdown

Open in