Skip to content

Man1Lab v1.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@maniac1um maniac1um released this 30 Jun 09:12
1.1.0
35fbf0b

Man1Lab v1.1.0 — Foundation Release

Release date: 2026-06-30
Codename: Foundation
Repository: https://github.com/maniac1um/Man1Lab

Overview

v1.1.0 is not a feature-expansion release. It completes Platform Foundation — the infrastructure and architectural substrate on which future Man1Lab capabilities will be built.

v1.0.0 delivered an end-to-end MVP reproduction pipeline. v1.1.0 refactors and hardens that pipeline: canonical analysis artifact, external infrastructure adoption via ports and adapters, experiment tracking, and documentation governance.

Milestone: Foundation Complete
Next: Platform Capability (v1.2)

Highlights

  • Analysis pipeline refactor — PaperReproductionAnalysis replaces PaperModel as the sole domain object (ADR-0009)
  • Docling default parsing — structured Markdown via ports & adapters (ADR-0008)
  • Hydra configuration layer — composed settings behind SettingsProvider (ADR-0010)
  • Pixi developer environment — lockfile-driven repo environment (ADR-0011)
  • MLflow experiment tracking — thin tracking via ExperimentTracker (ADR-0012)
  • Documentation governance — public docs/ for decisions; local private/ for research process
  • Infrastructure governance — infrastructure.md adoption matrix

Architecture Changes

Canonical domain object

Before (v1.0.0) After (v1.1.0)
Flat PaperModel Modular PaperReproductionAnalysis
WorkflowHistory.paper WorkflowHistory.analysis
Reader → flat fields Reader → goal / resources / method / evaluation / gaps

All downstream agents (Planner, Coder, Reviewer, Reporter) consume the analysis artifact through structured context views.

Layered pipeline

Paper (PDF)
    ↓ Parsing (Docling / PyMuPDF)     → ParsedDocument
    ↓ Analysis (Reader)              → PaperReproductionAnalysis
    ↓ Planning                         → TaskModel
    ↓ Implementation (Coder)           → Workspace
    ↓ Execution (Runner)               → ExecutionResult
    ↓ Verification → Review → Report
    ↓ Experiment Tracking (MLflow)     → parent run + nested stage runs

Infrastructure layers attach via Provider / Adapter — business agents do not import Docling, Hydra, Pixi, or MLflow.

Infrastructure Adoption

Capability Tool Status ADR
Paper Parsing Docling (+ PyMuPDF fallback) Adopted ADR-0008
Configuration Hydra Adopted ADR-0010
Environment Pixi Adopted ADR-0011
Experiment Tracking MLflow Adopted ADR-0012
Dataset Versioning DVC Pending —
Workflow Engine TBD Research —

See infrastructure.md for the full adoption matrix.

Governance

Change Detail
Public documentation ADRs, architecture, API, guides, current status — in Git
Private documentation Adoption reviews, audits, benchmarks, roadmaps — private/ (gitignored)
Decision rule Technology reviews inform ADRs; ADRs are the durable public record
ADR index ADR-0001 through ADR-0012

Breaking Changes

Change Migration
Reader.run() returns PaperReproductionAnalysis ADR-0009 supersedes ADR-0002 return type
WorkflowHistory.paper removed Use WorkflowHistory.analysis
PaperModel removed from runtime pipeline Legacy test files retained only
Composition root wires TrackedWorkflowOrchestrator Tracking disable: TRACKING_BACKEND=noop

No change to TaskModel, Workspace, or orchestrator stage order.

Compatibility

Area Status
Pixi (recommended) pixi install + pixi run test
pip legacy requirements.txt still supported
Parser fallback PARSER_BACKEND=pymupdf
Tracking opt-out TRACKING_ENABLED=false or TRACKING_BACKEND=noop
LLM providers OpenAI-compatible + Anthropic unchanged

Tests: 172 passing (pixi run test)

Product limitations from v1.0.0 remain — see CURRENT_STATUS.md.

Native Platform Components (v1.1.0)

These remain Man1Lab-native — not replaced by infrastructure tools:

Component Role
Analysis Reader → PaperReproductionAnalysis
Planning Planner → TaskModel
Coding Coder → Workspace (+ GQ-1, RAG)
Review Reviewer + PatchPlanner
Report Reporter → ReportModel
Orchestration WorkflowOrchestrator (topology frozen, ADR-0001)

Future Roadmap — Platform Capability (v1.2)

Foundation complete. Next milestone focuses on platform capabilities, not infrastructure:

Capability Direction
Repository Discovery Consume reproduction_gaps + metadata
Environment Generation Beyond workspace venv bootstrap
Verification Deeper alignment with analysis evaluation module
Failure Recovery Close review loop — re-invoke Coder/Runner
DVC Dataset versioning (pending adoption review)
Workflow Engine Research only — Man1Lab orchestrator remains native

Working roadmap: private/roadmap/ (local).

Quick Start

git clone https://github.com/maniac1um/Man1Lab.git
cd Man1Lab
pixi install
pixi run test
pixi run run

Optional MLflow UI:

mlflow ui --backend-store-uri sqlite:///mlruns/mlflow.db

Full guide: GETTING_STARTED.md

Related Documents

Document Purpose
CURRENT_STATUS.md Live capabilities and benchmarks
ARCHITECTURE.md Platform architecture
CHANGELOG.md Version history
v1.0.0 release notes MVP baseline
Assets 2
Loading