Changelog¶

0.0.1-alpha.206 (2026-08-19)¶

Bug Fixes¶

packaging: the linopy extra resolves again after upstream merged v1 (#1073) (aafac01)

0.0.1-alpha.205 (2026-08-18)¶

Features¶

api: diagnostics says which parameters arrived short of their dims (#1067) (c904400)

0.0.1-alpha.204 (2026-08-18)¶

Bug Fixes¶

compat: the eager lane's edge fills the shift's own vacated slot (#1050) (3f965f7)
engine: a per-entity offset's edge is per entity (#1053) (53fc3f7)

0.0.1-alpha.203 (2026-08-18)¶

Features¶

ports: a data column decides which boundary regime a storage obeys (#1038) (9879cde)

0.0.1-alpha.202 (2026-08-18)¶

Bug Fixes¶

tests: the golden objective reaches the grouping the walk does (#1056) (db7b3fb)

Refactoring¶

ports: a pre-horizon state of zero is an edge, not a block (#1057) (dd12a37)

Documentation¶

typeset: every construct is on one page, as the math it prints (#1039) (8c6bcca)

0.0.1-alpha.201 (2026-08-18)¶

Bug Fixes¶

language: a divisor that adds is refused at load, not at build (#1048) (4153653)
typeset: an objective term is shown summed over the dims it carries (#1045) (3e29596)

0.0.1-alpha.200 (2026-08-18)¶

Features¶

ports: a risk preference is three variables and two rows (#1035) (c3972ff)
ports: capacity is chosen once and dispatch once per future (#1033) (96a4572)

0.0.1-alpha.199 (2026-08-18)¶

Bug Fixes¶

api: a bridge out of a bare install says which extra to add (#1029) (ce60c03)

Documentation¶

ceiling: a tracked-metric vocabulary is a dimension and a named expression (#1031) (ab9d241)

0.0.1-alpha.198 (2026-08-18)¶

Bug Fixes¶

engine: a group with no members caps a row instead of refusing it (#1027) (31ab50a)

0.0.1-alpha.197 (2026-08-18)¶

Features¶

api: a badly scaled model says which declaration is badly scaled (#993) (ab92e2e)
data: a declared dtype is what the column has to be (#1022) (acbe2e6)

0.0.1-alpha.196 (2026-08-18)¶

Features¶

language: a translation stops at the edge of its own group (#1023) (aa747b5)

0.0.1-alpha.195 (2026-08-18)¶

Features¶

language: a boundary names its position inside each group (#1013) (f6ccac4)

Refactoring¶

language: by= names a lookup, and an offset has a word of its own (#1016) (ce13026)

0.0.1-alpha.194 (2026-08-18)¶

Bug Fixes¶

data: a fractional offset no longer truncates to the position below it (#1005) (b453c51)

0.0.1-alpha.193 (2026-08-18)¶

Documentation¶

language: one home for the binding rule, one page for the two grammars (#1010) (e004661)

0.0.1-alpha.192 (2026-08-18)¶

Bug Fixes¶

data: a row carrying no value is refused on both lanes (#1001) (795b26f)

0.0.1-alpha.191 (2026-08-18)¶

Bug Fixes¶

examples: every seeding clause names the position, not the label (#1004) (4f57d5a)

0.0.1-alpha.190 (2026-08-18)¶

Features¶

language: a boundary seed survives the index being relabelled (#904) (ca76c5a)
ports: what may be built in a period depends on the period before (#995) (208e9e7)

Bug Fixes¶

tests: the boundary suite binds its index the way sources does (#1002) (9da3b02)

Documentation¶

linopy: the one construct the eager lane accepts and cannot build (#990) (e25af73)

0.0.1-alpha.189 (2026-08-17)¶

Features¶

ports: a committed unit whose capacity is built declares its big-M (#991) (98fd368)

Bug Fixes¶

engine: a pullback through a null lookup no longer binds its row at zero (#988) (578868c)

Refactoring¶

examples: an edge leg is named for the edge set it belongs to (#973) (810a702)

0.0.1-alpha.188 (2026-08-17)¶

Features¶

ports: an asset exists for the periods its lifetime covers (#975) (0b33d9f)

0.0.1-alpha.187 (2026-08-17)¶

Features¶

ports: a global limit is a sum over a selected set (#967) (42f6e57)

0.0.1-alpha.186 (2026-08-17)¶

Features¶

ports: a link may deliver later than it withdrew (#980) (6e599eb)

0.0.1-alpha.185 (2026-08-17)¶

Bug Fixes¶

compat: at() through a label that maps nowhere drops the row, not the coordinate (#969) (89587ce)
engine: a row a propagated absence deleted is an omission too (#981) (0851444)

Documentation¶

benchmarks: the published peak says which arm pays the allocator (#970) (c84b394)

0.0.1-alpha.184 (2026-08-17)¶

Features¶

ports: a transmission loss is a fan of tangents, not a piecewise curve (#964) (3fb4079)

0.0.1-alpha.183 (2026-08-17)¶

Documentation¶

language: a propagated absence is a different event from an emptied row (#945) (409cea0)

0.0.1-alpha.182 (2026-08-17)¶

Features¶

language: a variable declares whether its absence is zero or undefined (#950) (adfcd8b)

0.0.1-alpha.181 (2026-08-17)¶

Features¶

api: a dimension's labels arrive in sources, like every other input (#956) (d30890f)

0.0.1-alpha.180 (2026-08-17)¶

Features¶

ports: integrality is one declaration and nothing above it cares (#943) (f14b5fc)

0.0.1-alpha.179 (2026-08-17)¶

Features¶

ports: a committed unit must stay on for its own window (#941) (051797a)

0.0.1-alpha.178 (2026-08-17)¶

Bug Fixes¶

examples: the ports row is one row, not three merges of it (#958) (eb7926b)

0.0.1-alpha.177 (2026-08-17)¶

Features¶

ports: a Store is one signed power with no rating of its own (#940) (5f4b775)

0.0.1-alpha.176 (2026-08-17)¶

Features¶

ports: storage that may spill has a second sink (#939) (d457b0e)

0.0.1-alpha.175 (2026-08-17)¶

Features¶

ports: a dispatch or a capacity fixed by data pins only the rows it has (#938) (d2a27d5)

0.0.1-alpha.174 (2026-08-17)¶

Features¶

ports: an energy total over the whole horizon is a bound (#936) (33fee41)

0.0.1-alpha.173 (2026-08-17)¶

Features¶

ports: capacity that comes in whole modules is an integer count (#935) (e55603f)

0.0.1-alpha.172 (2026-08-17)¶

Bug Fixes¶

language: a lookup's map says how labels map, not which exist (#937) (c50596f)

0.0.1-alpha.171 (2026-08-17)¶

Documentation¶

examples: a model beside the ladder is not listed as a rung (#947) (470eaf1)

0.0.1-alpha.170 (2026-08-16)¶

Features¶

language: a dimension's index has one home, declared or supplied (#908) (170e58a), closes #907 #895

0.0.1-alpha.169 (2026-08-16)¶

Refactoring¶

plan: the relational lane spells a lookup the way the language does (#903) (f1a4b76)

Documentation¶

data: the precedence list and its closing line agree on how many steps there are (#902) (2c801e0)

0.0.1-alpha.168 (2026-08-16)¶

Bug Fixes¶

compat: a grouped sum lands on the dimension it declares (#900) (f104206), closes #756

0.0.1-alpha.167 (2026-08-16)¶

Bug Fixes¶

typeset: a description sets as text, not as markup (#883) (b7f383b)

0.0.1-alpha.166 (2026-08-16)¶

Documentation¶

nav: the gallery section says it holds examples (#890) (a4bf53b)

0.0.1-alpha.165 (2026-08-16)¶

Refactoring¶

gallery: a description is written when it says something (#889) (2792313)

0.0.1-alpha.164 (2026-08-16)¶

Features¶

language: a dimension takes its labels from an index, never from the data (#884) (13aa444)
language: a window's width is a column, not a run of shifts (#871) (7a90400)
language: an offset that differs per entity is a column, not a literal (#862) (7a3ba7b)

Bug Fixes¶

packaging: the linopy extra installs a linopy that speaks v1 (#880) (69d95ff)

Documentation¶

language: the data contract says what binding refuses and what it cannot see (#881) (24926f8)

0.0.1-alpha.163 (2026-08-16)¶

Bug Fixes¶

compat: a dimension index is a table on both lanes, and a defect in one reads the same (#877) (cb7af0a)

0.0.1-alpha.162 (2026-08-16)¶

Bug Fixes¶

bench: the floor reads the lookup by the name the model gives it (#874) (799fa85)

0.0.1-alpha.161 (2026-08-16)¶

Bug Fixes¶

bench: the eager arm hands over tables the lane still reads (#872) (97ab607)

0.0.1-alpha.160 (2026-08-16)¶

Features¶

compat: a dimension the parameters already span needs no second declaration (#869) (cf02ffa)

0.0.1-alpha.159 (2026-08-16)¶

Features¶

compat: choosing the linopy lane is an import, not a different call (#864) (0a74aac)

Bug Fixes¶

compat: a construct the streaming lane refuses is refused on the linopy lane too (#865) (48ca92e)

Documentation¶

architecture: the linopy lane names its verbs instead of counting them (#866) (9f93d84)

0.0.1-alpha.158 (2026-08-16)¶

Refactoring¶

package: the table boundary is not the engine's, and stops living under it (#860) (a5fc98f)

0.0.1-alpha.157 (2026-08-16)¶

Features¶

language: a file with no objective is a feasibility problem (#859) (6ddfb5b)

0.0.1-alpha.156 (2026-08-16)¶

Features¶

api: a parameter may be written out in Python, not only handed over as a table (#853) (b8cf21f)
compat: the linopy lane reads every table the product path reads (#857) (c39bd5d)

Refactoring¶

compat: the linopy lane constructs a model, it does not attach to one (#846) (e268b0b)

0.0.1-alpha.155 (2026-08-16)¶

Features¶

api: both lanes read the same tables, and neither reads a dense array (#855) (4afc9a7)

Documentation¶

ceiling: data prep computes what the compiler cannot derive (#854) (add8c3d)

0.0.1-alpha.154 (2026-08-16)¶

Bug Fixes¶

typeset: a boolean mask says which rows are true, not which exist (#848) (85feab0)

Documentation¶

ledger: a per-generator minimum up time is sayable (#844) (0cc51da)

0.0.1-alpha.153 (2026-08-16)¶

Documentation¶

the reference speaks to a caller, and the internals sit under about (#831) (a105582)

0.0.1-alpha.152 (2026-08-16)¶

Documentation¶

ports: a claim is checked against the instance before a file is written (#841) (7a40f1b)

0.0.1-alpha.151 (2026-08-16)¶

Features¶

language: a small relation is declared, not supplied (#771) (3be93de)
language: a where reads a lookup (#768) (ab584f2)

Bug Fixes¶

language: a declared lookup map holds labels of the declared dtype (#781) (5ec2c2f)
language: two lookups are comparable only where their labels are (#780) (b2e2742)

0.0.1-alpha.150 (2026-08-16)¶

Bug Fixes¶

typeset: every operator renders, and SPEC §7 proves it (#837) (6454f72)

0.0.1-alpha.149 (2026-08-16)¶

Features¶

gallery: a model proves every many-to-many shape load-bearing (#747) (bb75a1a)
language: a coordinate is a named top-level lookup (#742) (a326026)
language: a lookup addresses itself, and the sibling kwarg is gone (#759) (01c243c)

Bug Fixes¶

typeset: the pullback test states its coordinate as a lookup (#835) (fb74811)

Documentation¶

gallery: a model that uses at() says so in the constructs matrix (#749) (af2a3db)

0.0.1-alpha.148 (2026-08-16)¶

Features¶

api: a solve says how much of the session it keeps (#815) (4cd43f5)

Bug Fixes¶

typeset: a translated index shows every operator that moved it (#830) (4c45e6b)

0.0.1-alpha.147 (2026-08-15)¶

Refactoring¶

bench: one comparison table, and it renders the same bytes twice (#806) (28a39fa)
bench: the harness stops carrying what no longer measures anything (#804) (441de0f)

0.0.1-alpha.146 (2026-08-15)¶

Features¶

gallery: a fuel curve is a floor per piece (#808) (c2b0ef6)

Documentation¶

gallery: every model says what it is, and so does every declaration in it (#825) (28eae9b)

0.0.1-alpha.145 (2026-08-15)¶

Documentation¶

gallery: the model list names every model (#819) (6a78fcc)

0.0.1-alpha.144 (2026-08-15)¶

Features¶

language: a declaration says what it is, and the legend reads it (#812) (6b31278)
language: a file says what model it is (#813) (6c081e1)
language: a named expression can say what it counts (#814) (d57aad1)

0.0.1-alpha.143 (2026-08-15)¶

Features¶

gallery: an operational life is a window read from data (#805) (7071fc0)

0.0.1-alpha.142 (2026-08-15)¶

Features¶

gallery: two connections may join one depot and centre (#790) (80d1949)

0.0.1-alpha.141 (2026-08-15)¶

Features¶

gallery: a path serves one call and crosses many arcs (#789) (640558b)

0.0.1-alpha.140 (2026-08-15)¶

Documentation¶

site: the notebook pages say it once (#798) (fd32ad1)

0.0.1-alpha.139 (2026-08-15)¶

Bug Fixes¶

bench: the floor's parity check runs again (#799) (9f240ba)

0.0.1-alpha.138 (2026-08-15)¶

Features¶

api: a named expression is readable after a solve (#726) (e41fbe1)
gallery: a generator sits on a bus and burns a carrier (#783) (5334608)
strategy: a sweep reads the quantity its model names (#748) (1268fb5)

0.0.1-alpha.137 (2026-08-15)¶

Documentation¶

examples: a notebook changes a model without a modelling API (#788) (50dd21f)

0.0.1-alpha.136 (2026-08-15)¶

Features¶

api: a solve says what it started from, and can be forced cold (#728) (dcf760e)

0.0.1-alpha.135 (2026-08-15)¶

Documentation¶

agents: a bug fix has to prove the bug was there (#784) (5de3b49)

0.0.1-alpha.134 (2026-08-15)¶

Bug Fixes¶

tests: the harness reads a model through the product's loader (#778) (bf9e8f6)

0.0.1-alpha.133 (2026-08-14)¶

Bug Fixes¶

bench: a second benchmark refuses to share the machine (#723) (f92d676)

0.0.1-alpha.132 (2026-08-14)¶

Refactoring¶

language: the code spells the builtins the way the docs do (#754) (799c98b)

0.0.1-alpha.131 (2026-08-14)¶

Bug Fixes¶

typeset: a symbol table says which notation it is written in (#740) (9e392ab)

0.0.1-alpha.130 (2026-08-14)¶

Documentation¶

examples: the corpus still spells what the language replaced (#739) (98ba17c)

0.0.1-alpha.129 (2026-08-14)¶

Features¶

language: a variable declares its domain, not a pair of flags (#720) (690cba1)

0.0.1-alpha.128 (2026-08-14)¶

Features¶

api: a slow build says where the time went (#717) (bab22b0)
api: a solved constraint row says its activity (#716) (63205d4)

0.0.1-alpha.127 (2026-08-14)¶

Documentation¶

the builtins have one name and a derived dimension states its cost (#715) (916cd8d)

0.0.1-alpha.126 (2026-08-14)¶

Bug Fixes¶

engine: a coordinate may target a dimension nothing spans yet (#714) (f93969e)
tests: the coordinate-target fixture speaks the current objective surface (#734) (5d18833)

0.0.1-alpha.125 (2026-08-14)¶

Features¶

language: a second objective is unsayable, not caught (#729) (6c9d986)

0.0.1-alpha.124 (2026-08-14)¶

Documentation¶

design: the ceiling's indicator row names its live issue (#712) (81facb4)

0.0.1-alpha.123 (2026-08-14)¶

Performance¶

engine: a coefficient of zero stops reaching the solver (#685) (6a6c026)
engine: a share stops carrying its zeros through the sort (#686) (ca7b54e)

Documentation¶

spec: the indicator and lp rows cite the issues that hold them (#696) (2aa70c9)

0.0.1-alpha.122 (2026-08-14)¶

Features¶

api: diagnostics say what the sink added to the model it was handed (#689) (0e6c75a)
language: a piecewise curve may name its formulation (#688) (d420c8b)
language: a variable may declare a special-ordered set over one of its dims (#687) (94cc18e)

Performance¶

engine: a set costs a fraction of the variable it is declared over (#691) (413d493)

0.0.1-alpha.121 (2026-08-13)¶

Documentation¶

models: both tabs start from the same tables (#678) (dc50136)
models: every teaching model is verified and reads in linopy (#680) (613a8e8)
models: the journey from files to the shared tables has one page (#679) (bdc636d)
models: the linopy tabs read as linopy users write, types said where hidden (#681) (840e79e)
models: the model files speak as a modeller, the pages teach the language (#682) (07c58b4)

0.0.1-alpha.120 (2026-08-13)¶

Documentation¶

models: the gallery shows the modelling, not the harness (#673) (6adba43)

0.0.1-alpha.119 (2026-08-13)¶

Refactoring¶

dead code, one-entry registries and re-export shims are gone (#675) (a1f61df)

0.0.1-alpha.118 (2026-08-13)¶

Refactoring¶

a value crossing a module boundary names its fields (#667) (51b5249)

0.0.1-alpha.117 (2026-08-13)¶

Documentation¶

models: the teaching models are verified, read in linopy, and show their call (#671) (83ab265)

0.0.1-alpha.116 (2026-08-13)¶

Documentation¶

models: each verified reference reads as a tab beside the model (#665) (9497594)

0.0.1-alpha.115 (2026-08-13)¶

Documentation¶

agents: a guard nobody can delete unseen is the coverage bar (#662) (4b90f6e)

0.0.1-alpha.114 (2026-08-13)¶

Features¶

api: a built model takes new numbers without being rebuilt (#626) (5123215)

Performance¶

strategy: a serial sweep binds one model instead of building each slice (#627) (cfdcc95)

0.0.1-alpha.113 (2026-08-13)¶

Documentation¶

agents: AGENTS.md scans as rules rather than paragraphs (#657) (f5bba8e)

0.0.1-alpha.112 (2026-08-13)¶

Performance¶

engine: a solver reads the row vectors instead of scattering them (#651) (ba1587d)

0.0.1-alpha.111 (2026-08-13)¶

Performance¶

engine: constants stop doubling the cost of a constraint's rows (#650) (a89a2c9)
sinks: a row's comparison crosses to the solver as a code, not a string (#648) (b0bb8c3)
sinks: the solver's column vectors stop being walked five times (#649) (98d604d)

0.0.1-alpha.110 (2026-08-12)¶

Bug Fixes¶

engine: a variable and a constraint may share a name (#645) (e4329cf)

0.0.1-alpha.109 (2026-08-12)¶

Documentation¶

agents: the package's docstrings have one checkable form (#632) (bdc301f)

0.0.1-alpha.108 (2026-08-12)¶

Documentation¶

agents: what is non-negotiable, and what is a default you may argue with (#624) (526c11a)

0.0.1-alpha.107 (2026-08-12)¶

Refactoring¶

every claim lives where it is read, not in a comment (#612) (a5404d7)

0.0.1-alpha.106 (2026-08-12)¶

Bug Fixes¶

bench: the marginal-cost caption is rendered, and says what it measures (#621) (93cd5fe)

0.0.1-alpha.105 (2026-08-12)¶

Documentation¶

agents: a number leaves only with a pointer, and vagueness is not a conclusion (#618) (5489607)

0.0.1-alpha.104 (2026-08-12)¶

Documentation¶

agents: a PR with no intent line shows the prompt that produced it (#616) (aa134ab)

0.0.1-alpha.103 (2026-08-11)¶

Performance¶

examples: the benders loop parses each model once (#613) (5f03dbd)

0.0.1-alpha.102 (2026-08-11)¶

Features¶

strategy: one model solved over scenarios, windows and pathways (#459) (5d4c4ce)

0.0.1-alpha.101 (2026-08-11)¶

Documentation¶

agents: a claim belongs in the message that prints (#608) (d0b1e86)

0.0.1-alpha.100 (2026-08-11)¶

Documentation¶

agents: a reader can tell the maintainer's voice from an agent's (#605) (b987971)

0.0.1-alpha.99 (2026-08-11)¶

Documentation¶

AGENTS.md carries how we work, CLAUDE.md just imports it (#599) (e815252)

0.0.1-alpha.98 (2026-08-11)¶

Documentation¶

the copyright line names whoever wrote it, and that was never PyPSA (#601) (06fb7d5)

0.0.1-alpha.97 (2026-08-11)¶

Documentation¶

the surface is Calliope's, the vocabulary is linopy's — say so (#598) (a1042fc)

0.0.1-alpha.96 (2026-08-11)¶

Refactoring¶

cut the prose, keep the facts (#592) (dcc279b)

Documentation¶

design: decomposition, as evidence rather than as a feature (#597) (c736da9)

0.0.1-alpha.95 (2026-08-11)¶

Bug Fixes¶

engine: a returned frame speaks String, so it joins the caller's own (#593) (69b9ad2)

0.0.1-alpha.94 (2026-08-11)¶

Refactoring¶

one answer per question (#589) (8a831cc)

0.0.1-alpha.93 (2026-08-11)¶

Bug Fixes¶

api: a closed result says it was closed (#587) (45cc1d0)

0.0.1-alpha.92 (2026-08-11)¶

Bug Fixes¶

data: an empty index keeps the dimension's declared dtype (#585) (b5bd409)

0.0.1-alpha.91 (2026-08-11)¶

Performance¶

engine: the objective keeps the hash count — bought order was a shape-dependent bet (#581) (d30598f)

0.0.1-alpha.90 (2026-08-11)¶

Refactoring¶

engine: ask the data, not the declarations (#520) (17f8e5d)

0.0.1-alpha.89 (2026-08-11)¶

Bug Fixes¶

plan: a divisor under a pullback is still named (#571) (2591995)

0.0.1-alpha.88 (2026-08-11)¶

Performance¶

engine: the bound attach reads the ordinal off the Enum, not a dictionary (#568) (6847419)

0.0.1-alpha.87 (2026-08-11)¶

Performance¶

engine: a bound dense over the variable product is attached, not joined (#511) (8efd207)

0.0.1-alpha.86 (2026-08-11)¶

Features¶

language: a coordinate may declare its own label space (#557) (220fd8a)
language: a row with no variable terms is not built, and is reported (#561) (4cf2ea5), closes #556

0.0.1-alpha.85 (2026-08-10)¶

Performance¶

engine: the matrix stops repeating itself — CSR at assembly (#550) (903c8c2)

0.0.1-alpha.84 (2026-08-10)¶

Features¶

language: a comparison's constant side may not be sparse (#554) (20cb72e), closes #537 #549

0.0.1-alpha.83 (2026-08-10)¶

Bug Fixes¶

engine: a zero edge writes its rows, like every other fill (#551) (af1ce64)

0.0.1-alpha.82 (2026-08-10)¶

Bug Fixes¶

engine: a nested shift keeps its presence's own dims (#546) (c7cb8a0), closes #544

0.0.1-alpha.81 (2026-08-10)¶

Bug Fixes¶

language: the bare-shift refusal names a pair, not three alternatives (#540) (96bbbaa)

Performance¶

engine: a string dimension speaks its own Enum, everywhere at once (#541) (8517945)

0.0.1-alpha.80 (2026-08-10)¶

Bug Fixes¶

api: one exception tree, whichever door built the model (#538) (52cdb8b), closes #527
linopy: extend() passes the borrowed names to its own expansion (#542) (282a2d3)

0.0.1-alpha.79 (2026-08-10)¶

Bug Fixes¶

language: a Model validates itself, however it was built (#533) (6b987a6)

0.0.1-alpha.78 (2026-08-10)¶

Refactoring¶

api: Model, and a model that can be written back out (#522) (ccefd98)

0.0.1-alpha.77 (2026-08-09)¶

Documentation¶

lp: the presort's cost is unmeasured, not settled (#517) (5ca09f0)

0.0.1-alpha.76 (2026-08-09)¶

Features¶

language: version: on a model file, and 0 means unstable (#515) (7d37589)

0.0.1-alpha.75 (2026-08-09)¶

Refactoring¶

language: edge takes a quoted keyword, edge='wrap' (#512) (d20d44e)

0.0.1-alpha.74 (2026-08-09)¶

Documentation¶

roll is not a spelling — shift(edge=wrap) is (#509) (6f1f98a)

0.0.1-alpha.73 (2026-08-09)¶

Performance¶

lp: the constraint stream sorts on one key, carrying nothing else (#492) (e7085ca)

0.0.1-alpha.72 (2026-08-09)¶

Bug Fixes¶

docs: install uv on Read the Docs without asdf (#501) (13e095e)

0.0.1-alpha.71 (2026-08-09)¶

Refactoring¶

language: group_sum becomes sum(group_by=) (#491) (fb14dd2)

0.0.1-alpha.70 (2026-08-09)¶

Features¶

language: at() — the pullback of group_sum (#489) (e7ce036)

Performance¶

polars: two group_sums collide only where the coordinates meet, and the matrix leaves in row order (#487) (53621b1)

0.0.1-alpha.69 (2026-08-09)¶

Bug Fixes¶

language: quoted literals in a where, and a dtype guard on comparisons (#485) (968861b)

0.0.1-alpha.68 (2026-08-09)¶

Documentation¶

cli: the typeset shell front is not a command line under construction (#483) (72b8ced)

0.0.1-alpha.67 (2026-08-09)¶

Bug Fixes¶

engine: a masked-out scalar variable takes its row with it (#480) (2e6f329)

0.0.1-alpha.66 (2026-08-09)¶

Documentation¶

roadmap: motivation and end state; the detail moves to issues (#474) (ebff8b0)

0.0.1-alpha.65 (2026-08-09)¶

Documentation¶

contributing: issues cite behaviour, and two labels carry order (#466) (86398fd)

0.0.1-alpha.64 (2026-08-09)¶

Documentation¶

models: monthly_budget — group_sum over time, not just space (#461) (ab8d71f)

0.0.1-alpha.63 (2026-08-09)¶

Documentation¶

api: Gurobi Compute Server, Instant Cloud and WLS already work (#458) (4f18e89)

0.0.1-alpha.62 (2026-08-01)¶

Documentation¶

bench: plot the results, and fold the tables under them (#451) (042c2ad)

0.0.1-alpha.61 (2026-07-31)¶

Bug Fixes¶

bench: the default arm clears the engine it did not select (#452) (6e4e3a3)

0.0.1-alpha.60 (2026-07-31)¶

Refactoring¶

bench: the harness is pytest; drop the custom runner (#448) (d460ca6)

0.0.1-alpha.59 (2026-07-31)¶

Performance¶

engine: the read-back reads the label order rather than re-imposing it (#446) (53f8eb8)

0.0.1-alpha.58 (2026-07-31)¶

Documentation¶

bench: re-measure at 98f382d, and correct a claim the harness bug made (#441) (6d0e195)

0.0.1-alpha.57 (2026-07-31)¶

Performance¶

sinks: a solution is a vector, not a vector beside its own index (#439) (76600ab)

0.0.1-alpha.56 (2026-07-31)¶

Bug Fixes¶

bench: compare like with like, and add a gurobi arm (#438) (ea15cb4)

0.0.1-alpha.55 (2026-07-31)¶

Performance¶

engine: cols is positional, and the order is produced rather than repaired (#433) (22bb9c7)

0.0.1-alpha.54 (2026-07-31)¶

Performance¶

sinks: a row is seated the way a column is, for both solvers (#421) (31ba48c)

0.0.1-alpha.53 (2026-07-31)¶

Performance¶

gurobi: hand the matrix over in one call (#434) (3d13d50)

0.0.1-alpha.52 (2026-07-31)¶

Features¶

sinks: gurobi, and the two families it revealed (#418) (8730498)

0.0.1-alpha.51 (2026-07-31)¶

Documentation¶

breaking changes are free while we are 0.0.1aN (#420) (ae1389a)

0.0.1-alpha.50 (2026-07-31)¶

Performance¶

polars: a constraint over distinct variables has nothing to collapse (#408) (8e725de)
polars: a fragment is not restricted by its own absence (#413) (8ac3a0d)
polars: a mask joins for what it is certain of (#415) (68d95e2)
polars: a solve is read back by position, not by key (#414) (cba01c4)
polars: an existence join does not deduplicate what it asks about (#412) (c008154)

0.0.1-alpha.49 (2026-07-31)¶

Bug Fixes¶

bench: the build profiler names steps that still exist (#406) (e771686)

0.0.1-alpha.48 (2026-07-31)¶

Bug Fixes¶

bench: the regression harness builds again (#400) (291f714)

0.0.1-alpha.47 (2026-07-31)¶

Refactoring¶

relational: the contract at the top, engines one level down (#395) (fb4b2de)

0.0.1-alpha.46 (2026-07-31)¶

Features¶

rename LinopyYamlError to LpspecError (#394) (5f72731)

0.0.1-alpha.45 (2026-07-31)¶

Documentation¶

quadratic is planned, not refused — and the ceiling is relational ∩ local (#388) (2a8c172)

0.0.1-alpha.44 (2026-07-31)¶

Documentation¶

fix five stale claims, and cut what git already remembers (#386) (6562c15)

0.0.1-alpha.43 (2026-07-31)¶

Documentation¶

ceiling: the plan cannot loop, the process can — scope the refusal (#378) (55d238c)

0.0.1-alpha.42 (2026-07-31)¶

Documentation¶

architecture: the consumers diagram carries the shape, not the list (#377) (fb06b82)

0.0.1-alpha.41 (2026-07-31)¶

Documentation¶

architecture: show the public surface, and pin it (#375) (bdb6b11)

0.0.1-alpha.40 (2026-07-31)¶

Refactoring¶

architecture: four directories, four enforced fences (#373) (f5e2c09)

0.0.1-alpha.39 (2026-07-31)¶

Refactoring¶

language: the front end is a package, and degree 1 lives in it (#371) (0bcfd1b)
relational: binding produces a value, and the live registry is visibly the exception (#370) (70e13ba)

0.0.1-alpha.38 (2026-07-31)¶

Refactoring¶

relational: labels and the result are modules, not regions of the executor (#368) (7c8604a)
three small simplifications in the eager lane and piecewise (#366) (b8a5d3e)

0.0.1-alpha.37 (2026-07-31)¶

Documentation¶

architecture: the CLI ships, and the typeset spike is a package (#363) (f0b6cf1)

0.0.1-alpha.36 (2026-07-31)¶

Refactoring¶

one near-miss clause, one fold, and comments that restate their line (#361) (48464fc)

0.0.1-alpha.35 (2026-07-31)¶

Features¶

language: one shift(over=, offset=, edge=), replacing roll and shift (#359) (8473a24)

0.0.1-alpha.34 (2026-07-30)¶

Performance¶

relational: coordinate validation rides the aggregate already running (#357) (093a694), closes #273

0.0.1-alpha.33 (2026-07-30)¶

Refactoring¶

relational: one data-validation module for this lane (#355) (4b19fe4)

0.0.1-alpha.32 (2026-07-30)¶

Bug Fixes¶

relational: refuse a source label the dimension does not have (#352) (5600cd8), closes #350

0.0.1-alpha.31 (2026-07-30)¶

Bug Fixes¶

relational: a mask survives a broadcast into a reduction (#348) (3515fd6)

0.0.1-alpha.30 (2026-07-30)¶

Bug Fixes¶

bench: migrate the bench corpus off equations:, and gate it (#346) (72818b2), closes #343

0.0.1-alpha.29 (2026-07-30)¶

Documentation¶

the corpus teaches shift for the acyclic boundary, and names what repeats (#342) (586daa3)

0.0.1-alpha.28 (2026-07-30)¶

Bug Fixes¶

relational: the empty coordinate — scalar rows, columns and values (#339) (15c2892)

0.0.1-alpha.27 (2026-07-30)¶

Refactoring¶

rename the package to lpspec, drop the farkas branding (#336) (0dd27d4)

0.0.1-alpha.26 (2026-07-30)¶

Bug Fixes¶

parser: the inf literal needs a word boundary (#335) (c34bf1a), closes #302

0.0.1-alpha.25 (2026-07-30)¶

Documentation¶

the ten laws at the head of SPEC, one evidence page, the ceiling as its own note (#333) (71ae5f7)

0.0.1-alpha.24 (2026-07-29)¶

Features¶

one rule per constraint, named by the file rather than by position (#329) (1ff53b3)

0.0.1-alpha.23 (2026-07-29)¶

Bug Fixes¶

api: read-back by an unknown name says what the model actually built (#327) (018b1ff)

0.0.1-alpha.22 (2026-07-29)¶

Documentation¶

spec: when a fill belongs in the language, and when it is data prep (#325) (5f71da8)

0.0.1-alpha.21 (2026-07-29)¶

Documentation¶

the home page shows the model it sets, as math (#317) (4094fb9)
typeset: say that symbols= takes a dict, not only a path (#323) (e9f2102)

0.0.1-alpha.20 (2026-07-29)¶

Bug Fixes¶

linopy: refuse a missing bound at build, with the native lane's message (#319) (0e75754)

0.0.1-alpha.19 (2026-07-29)¶

Bug Fixes¶

a divisor must be defined where the model divides by it (#318) (d7ad809)
relational: absence propagates into a reduction, and laws to hold it there (#314) (f4bb63b)

0.0.1-alpha.18 (2026-07-29)¶

Documentation¶

typeset every model page from the model it shows (#280) (d6eda33)

0.0.1-alpha.17 (2026-07-29)¶

Features¶

typeset a validated model — LaTeX and Typst (spike) (#269) (3cbd79a)

Bug Fixes¶

ci: the PR-title check must report on every head, or it blocks the merge (#308) (ecbdb13)

0.0.1-alpha.16 (2026-07-29)¶

Documentation¶

releasing: the alpha stream is 0.0.1, and say what actually holds it (#306) (de597a6)

0.0.1-alpha.15 (2026-07-29)¶

Bug Fixes¶

ci: check out the manifest the version guard reads (#303) (911b9ed)

0.0.1-alpha.14 (2026-07-29)¶

Documentation¶

models: fold long expressions onto one term per line (#299) (826eaaa)

0.0.1-alpha.13 (2026-07-29)¶

⚠ BREAKING CHANGES¶

linopy: importing farkas.linopy sets linopy.options['semantics'] to 'v1' process-wide. Models built through this lane change answer wherever a variable is masked or shifted — that is the point, and it is the answer the native engine has always given.
a bare shift() now drops the row at the vacated coordinate instead of contributing zero there, and shift() over a variable-free expression is a load error. Add fill=0 for the previous behaviour.

Features¶

shift() creates absence, as linopy v1 says it does (#291) (b394e70)

Bug Fixes¶

linopy: the lane selects v1 on import, and fill= takes the identity of its position (#293) (451c354)
release: put the version back on the alpha stream, and make the pin real (#295) (8ef60a5)

0.0.1-alpha.12 (2026-07-29)¶

Documentation¶

spec: three behaviours a consumer could only reach by probing (#288) (50b087c)

0.0.1-alpha.11 (2026-07-29)¶

Bug Fixes¶

docs: readable mermaid diagrams in dark mode, and the site icons (#285) (b21d5d8)

0.0.1-alpha.10 (2026-07-28)¶

Documentation¶

publish the site with mkdocs-material (#283) (1ec55ac)

0.0.1-alpha.9 (2026-07-28)¶

Bug Fixes¶

result: read the solution back in label order (#278) (11bf86d)

0.0.1-alpha.8 (2026-07-28)¶

Bug Fixes¶

piecewise: emit foreach in declaration order, not set order (#271) (c06907b)
where: a declared dimension on a comparison RHS is a load error (#272) (5b1784e)

0.0.1-alpha.7 (2026-07-28)¶

Documentation¶

the AST as a narrow waist — one contract, many consumers (#266) (688c6df)

0.0.1-alpha.6 (2026-07-28)¶

Documentation¶

say what examples/ is, and point it at the explained version (#263) (aab7617)

0.0.1-alpha.5 (2026-07-28)¶

Documentation¶

move the three root docs, add a guide, make the index a path (#260) (bfbfbec)

0.0.1-alpha.4 (2026-07-28)¶

Documentation¶

a model gallery, with a construct matrix read off the plan (#257) (e9cf410)

0.0.1-alpha.3 (2026-07-28)¶

Documentation¶

a CONTRIBUTING.md, and move procedure out of the corpus page (#255) (d3d5f96)

0.0.1-alpha.2 (2026-07-28)¶

Refactoring¶

bench: retire the duckdb arm, and the docs it was holding up (#253) (6eaef1e)

0.0.1-alpha.1 (2026-07-28)¶

⚠ BREAKING CHANGES¶

rebuild the relational engine on polars (#189)

Features¶

rebuild the relational engine on polars (#189) (c11a0dd)

Chores¶

re-cut as 0.0.1-alpha.1, and refresh the chart page from the results (#250) (f62d434)

0.0.0-alpha.33 (2026-07-28)¶

⚠ BREAKING CHANGES¶

absence propagates and drops the row, plus defined(v) (#239)

Features¶

absence propagates and drops the row, plus defined(v) (#239) (5eb5943)

0.0.0-alpha.32 (2026-07-28)¶

Features¶

compat: answer linopy's v1 convention where the position knows the answer (#236) (facee3f), closes #8

0.0.0-alpha.31 (2026-07-28)¶

Documentation¶

alpha.30 credited a perf fix it does not contain (#230) (5afb004)

0.0.0-alpha.30 (2026-07-28)¶

Documentation¶

pin all three label paths, and write the row-major order down (#152) (3d8c725)

No functional change: this release is alpha.29 plus tests and a paragraph of docs/ARCHITECTURE.md. The commit subject says perf: and claims a speed-up, which is wrong — that optimisation shipped in alpha.29 as #178. #152 was retitled after it had already been merged and released, too late for the squash subject.

0.0.0-alpha.29 (2026-07-28)¶

Performance¶

compute variable labels arithmetically when the mask factors (#178) (5d4745f)

0.0.0-alpha.28 (2026-07-28)¶

Bug Fixes¶

three ways an objective or a scalar parameter answered quietly (#223) (ee08d5d)

0.0.0-alpha.27 (2026-07-28)¶

Bug Fixes¶

refuse a parameter source that carries a coordinate twice (#201) (fffee97)

0.0.0-alpha.26 (2026-07-27)¶

Documentation¶

bench: correct the label-optimisation numbers, and say how to get them (#188) (bf84fd1)

0.0.0-alpha.25 (2026-07-27)¶

Performance¶

sink: size the hand-off by nonzeros, under one budget and one chunking rule (#195) (c31beaf)

0.0.0-alpha.24 (2026-07-27)¶

Performance¶

sink: hand Arrow to numpy directly, not through to_pydict (#193) (ac64f26)

0.0.0-alpha.23 (2026-07-27)¶

Performance¶

skip the objective's GROUP BY where a column cannot repeat (#179) (787b1ce)

0.0.0-alpha.22 (2026-07-27)¶

Performance¶

lp: render doubles with ::VARCHAR instead of printf('%.17g') (#190) (b1df538)

0.0.0-alpha.21 (2026-07-27)¶

Performance¶

relational: a label is a position, so compute it instead of counting it (#186) (a31645b)

0.0.0-alpha.20 (2026-07-27)¶

Bug Fixes¶

the HiGHS sink's column ingest was an unbounded global sort (#181) (271b0d7)

0.0.0-alpha.19 (2026-07-27)¶

Features¶

expose duals on the solve path (sol.dual) (#156) (284df79)

0.0.0-alpha.18 (2026-07-27)¶

Features¶

bench: a performance harness the published numbers come from (#143) (144713a)

0.0.0-alpha.17 (2026-07-27)¶

Features¶

forward solver_options, and gate reads on an actual incumbent (#169) (493a5e6)

0.0.0-alpha.16 (2026-07-27)¶

Documentation¶

the memory invariant says what it actually guarantees (#150) (8ffe339)

0.0.0-alpha.15 (2026-07-27)¶

⚠ BREAKING CHANGES¶

documentation only — the suggested alias is now fk. import farkas was and remains the actual import.

Chores¶

the import alias is fk, because the package is farkas (#154) (fac76f0)

0.0.0-alpha.14 (2026-07-27)¶

⚠ BREAKING CHANGES¶

Solution is now Result; status returns the coarse axis (ok) rather than the solver's wording (Optimal) — termination_condition carries that, and is_ok is what most call sites meant. objective is nan and primal/to_* raise NoSolutionError when the solve produced nothing.

Features¶

a solve result tells you whether it has one (#148) (30a91c8)

0.0.0-alpha.13 (2026-07-26)¶

Bug Fixes¶

quote caller-supplied paths in SQL (#139) (61dfe5b)

0.0.0-alpha.12 (2026-07-26)¶

Bug Fixes¶

a null coordinate means "no group", not a typo (#135) (9a672b4)

0.0.0-alpha.11 (2026-07-26)¶

Documentation¶

lead with what the package is; YAML is the format we ship, not the interface (#132) (5bd5240)

0.0.0-alpha.10 (2026-07-26)¶

Bug Fixes¶

py.typed ships with the package it describes (#131) (52529de)

0.0.0-alpha.9 (2026-07-26)¶

⚠ BREAKING CHANGES¶

the import path is now farkas; the compat lane is farkas.linopy and its extra is [linopy].

Refactoring¶

rename the package to farkas, and compat/ to linopy/ (#127) (5fae345)

0.0.0-alpha.8 (2026-07-26)¶

Refactoring¶

one lazy import left, and it is the only real cycle (#117) (ecad711)

0.0.0-alpha.7 (2026-07-26)¶

Refactoring¶

the package moves under src/, so CI tests the artifact (#118) (7eb39a6)

0.0.0-alpha.6 (2026-07-26)¶

Features¶

accept any Arrow-compatible table as a source (#104) (e8a699e)

Refactoring¶

three modules in the engine, one per box in the diagram (#107) (f6b30b2)

Documentation¶

the seam's level is decided, so stop pointing at an open issue (#111) (7d1a992)

0.0.0-alpha.5 (2026-07-26)¶

⚠ BREAKING CHANGES¶

a file declaring more than one objective no longer loads.
a Series or DataArray whose index names are not the declared dims is now a DataError; previously the names were discarded.
a dimension declares the coordinates its labels carry (#100)
every IR, AST and schema class is renamed, and fk.LanguageError no longer covers data-binding failures — those are fk.DataError. Both remain under fk.LinopyYamlError, as does the deprecated RelationalBuildError alias.

Features¶

a dimension declares the coordinates its labels carry (#100) (49b790b)

Bug Fixes¶

a bool parameter is a mask, on both lanes (#47) (#96) (a3f3926)
a declared coordinate must be its declared dtype (#65) (#101) (5349991)
a named index binds by name, not by position (#91) (#98) (3e14be8)
a second objective is a load error, not a silent drop (#49) (#97) (24f5849)
one place per language rule, and formulations judged like the rest (#99) (3137fbc)

Refactoring¶

names say what they mean, and errors are one tree (#94) (0c1300c)
the compat lane is a directory, so the fence is structural (#95) (4015131)

Documentation¶

consolidate the doc set and cut it by two thirds (#87) (0a89d7d)
runnable architecture walkthrough, one stage at a time (#54) (0f0910f)
say plainly that breaking changes land without a deprecation cycle (#102) (6131342)
split sink capability from the expressive ceiling (#88) (4e58227)
the composition seam exists, and value-only re-solve has a precondition (#93) (2dffd89)

0.0.0-alpha.4 (2026-07-25)¶

⚠ BREAKING CHANGES¶

unknown YAML keys are an error, not a silent default (#72)
sum/roll/shift/group_sum over a dim the operand does not carry, a where dim outside the frame, a bound parameter dim outside foreach, and a constraint whose expression dims differ from its foreach are all load errors. Each previously built a model that solved and was wrong, or larger than the file read as.

Features¶

Result.to_xarray() — the labelled form, one call away (#75) (7df73b4)
static dim checking — the type is a set of dim names (#68) (f96bcb4)

Bug Fixes¶

dim checking runs on both lanes, and binary ops union (#70) (2072cfa)
read YAML 1.2 booleans, and refuse duplicate keys (#77) (b12af91)
unknown YAML keys are an error, not a silent default (#72) (909bc4c)

Documentation¶

an objective totals its dims, so the examples stop pretending otherwise (#74) (f090c8c)
the axes the expressiveness taxonomy does not rank (#76) (bcfcdee)

0.0.0-alpha.3 (2026-07-25)¶

⚠ BREAKING CHANGES¶

where: "<dimension>" is a load error. It never did anything except in the case where it broke.
an unknown name in a where string is a load error rather than a False mask; parameter-vs-parameter where comparisons are rejected; and names may no longer collide across kinds. Each was a way to build a model that solved and was silently wrong.
a variable declared without bounds.lower was silently non-negative; it is now unbounded below, matching linopy's add_variables(lower=-inf). Models relying on the implicit >= 0 must write lower: 0. An LP that was bounded only by that implicit constraint will now report as unbounded.

Bug Fixes¶

a bare dimension name in a where is a load error (#64) (1a89fef)
both lanes agree on where-comparisons over dimensions, and on ** (#52) (7bec431)
check() enforces degree 1; README stops promising a fallback (#55) (d0b008c)

Refactoring¶

cut back the accumulated surface (#56) (1802dd0)
finish the lane split — where_parser keeps grammar, not evaluation (#59) (a30f7ec)
let the annotations say what the parsers already guarantee (#61) (49387d4)
name resolution is a pass, not a backend detail (#62) (8622fa6)

Documentation¶

cross-language vocabulary map, and a procedure for the ceiling (#63) (7f535cd)
SPEC catches up with the code it describes (#57) (50edfb6)

0.0.0-alpha.2 (2026-07-24)¶

Bug Fixes¶

name-check dimension kwargs at load time; restore docs lost at merge (#48) (4c6bfc9)

0.0.0-alpha.1 (2026-07-24)¶

Features¶

API polish — check(), write(), LanguageError, Result lifecycle (#36) (fc36af5)