Proofline

English · Tiếng Việt · 日本語

Proofline shows which immutable evidence justified an engineering decision and warns when the cited evidence changes.

%%{init: {"theme":"base","themeVariables":{"background":"#FFFFFF","fontFamily":"Arial, sans-serif","lineColor":"#667085","primaryTextColor":"#172B4D"}}}%%
flowchart LR
    S["Source version<br/>Nguồn / ソース"]:::yellow
    P["Exact span<br/>Dòng trích / 引用範囲"]:::blue
    D["Decision<br/>Quyết định / 判断"]:::purple
    C["Deterministic check<br/>Kiểm tra / 検証"]:::green
    R["Review warning<br/>Cảnh báo / 警告"]:::pink
    S --> P --> D --> C
    C -->|changed| R
    classDef yellow fill:#FFF4A3,stroke:#C9A227,stroke-width:2px,color:#172B4D
    classDef blue fill:#D9EAFD,stroke:#4C78A8,stroke-width:2px,color:#172B4D
    classDef purple fill:#E9DDF7,stroke:#8064A2,stroke-width:2px,color:#172B4D
    classDef green fill:#DDF5E3,stroke:#4F9D69,stroke-width:2px,color:#172B4D
    classDef pink fill:#FFE1E6,stroke:#C96A7B,stroke-width:2px,color:#172B4D

Loading

English

Proofline is a local-first Engineering Decision Memory for evidence-backed ADRs. It preserves source identity, source version and exact cited spans, exports self-contained Decision Evidence Packages, and performs deterministic stale-decision checks without requiring an AI provider.

Requirements: Python 3.11+, Node.js 20+ and npm.

make setup
.venv/bin/proofline demo stale-decision
.venv/bin/proofline verify-package proofline-demo-stale-decision/evidence.zip
make test
make check

The current boundary is a single-user local workflow with recoverable data. Hosted sync, shared workspaces, signatures and permission-aware connector fleets are not implemented.

Current technical references: architecture, operations, security and v1.0.0 release notes.

Tiếng Việt

Proofline là bộ nhớ quyết định kỹ thuật local-first dành cho ADR có bằng chứng. Hệ thống giữ định danh nguồn, phiên bản nguồn và đúng đoạn trích; xuất Decision Evidence Package độc lập; đồng thời kiểm tra quyết định lỗi thời theo cách xác định mà không cần nhà cung cấp AI.

Yêu cầu: Python 3.11+, Node.js 20+ và npm. Dùng các lệnh ở phần English để cài đặt, chạy demo và kiểm thử. Phạm vi hiện tại là quy trình local cho một người dùng; chưa có đồng bộ hosted, workspace dùng chung, chữ ký hoặc hệ connector phân quyền.

日本語

Proofline は、根拠付き ADR のためのローカルファーストな Engineering Decision Memory です。ソース識別子、ソース版、正確な引用範囲を保持し、独立検証可能な Decision Evidence Package を出力します。AI プロバイダーなしで、判断が古くなったかを決定的に検査できます。

必要環境は Python 3.11 以上、Node.js 20 以上、npm です。セットアップ、デモ、テストには English セクションのコマンドを使用してください。現在は単一ユーザーのローカル利用が対象で、ホスト同期、共有ワークスペース、署名、権限対応コネクター群は未実装です。

Released under the MIT License.