Release 0.23.0

.dockerignore

@@ -1,7 +1,15 @@
+# Deny-all plus an allow-list, so a new top-level directory costs nothing until an
+# image actually needs it. Only the images whose build CONTEXT IS THE REPO ROOT read
+# this file -- docker/metasmith and docker/ecspr. docker/fabfos and docker/ecspr_bake
+# build from their own directory and are unaffected.
 **
 !/envs
 !/lib
-!/src
+!/src/metasmith
+!/src/bash_relay
 !/dist
-!/main/relay_agent/
 !metasmith_starter.ipynb
+# docker/ecspr: the package, its suite (the image runs it at --check), and tini.
+!/src/ecspr
+!/tests/ecspr
+!/docker/ecspr/load

.dvc/config

@@ -1,2 +1,2 @@
 [cache]
-    dir = ../../dvc-cache
+    type = "hardlink,symlink"

.gitignore

@@ -1,7 +1,10 @@
 /cache
 *.sif
 __pycache__
+# stamped from the source tree immediately before each build; committing one would
+# let a tag name a source state that is not the one in the tree
 /src/metasmith/build_hash.txt
+/src/ecspr/build_hash.txt
 .ipynb_checkpoints
 .virtual_documents
 /*.ipynb
@@ -11,22 +14,22 @@ __pycache__
 *.egg-info
 /lib/relay_agent/*.spec
 
-/data
-/scratch/*
-!/scratch/gui-main.dvc
-!/scratch/.gitignore
 /secrets
 /lib/*
-!/lib/local
 .secret
 .DS_Store
 
 /conda_build
-/conda_recipe/*
-!/conda_recipe/compile_recipe.py
-!/conda_recipe/meta_template.yaml
+/conda_recipe/*/*
+!/conda_recipe/*/compile_recipe.py
+!/conda_recipe/*/meta_template.yaml
 
+# A deployed agent home, under every spelling anyone has used for one. These are
+# deployment artifacts, never repo content, and a script that anchors its home on
+# cwd rather than on __file__ drops one wherever it was launched from.
 **/metasmith_home
+**/msm_home
+**/test_msm_home
 
 .pixi
 pixi.lock
@@ -39,34 +42,78 @@ pixi.toml
 # tests/e2e/agentic/ and left these rules pointing at the old path, which
 # would have committed the next sweep's transcripts.
 /.opencode-serve-*.log
-/tests/e2e/agentic/.runs/
-/tests/e2e/agentic/.cache/
+/tests/metasmith/e2e/agentic/.runs/
+/tests/metasmith/e2e/agentic/.cache/
 
 /src/metasmith/std/dtypes.yml
-/main/relay_agent/0x*
+/src/bash_relay/0x*
 
 *.acc
 local_home
 std_assembly_data
 .claude/
 
-# GUI: the frontend bundle is generated by ./dev.sh --build-gui, never committed
+# GUI: the frontend bundle is generated by ./dev/metasmith.sh --build-gui, never committed
 /src/metasmith/gui/static/
-/frontend/node_modules/
+/src/metasmith/frontend/node_modules/
 
-# the msm_solver binaries, staged here by ./dev.sh -be so the wheel can ship
+# the msm_solver binaries, staged here by ./dev/metasmith.sh -be so the wheel can ship
 # them. Same deal as gui/static/: generated, platform-specific, never committed.
 /src/metasmith/engine/
 
+# the vendored metasmith_libraries snapshot, staged here by
+# ./dev/metasmith.sh --vendor-library so the wheel/conda/docker build can ship
+# it. Same deal as engine/: generated, never committed.
+/src/metasmith/vendor/
+
+# fabfos's own bundled copy of the same library, staged by ./dev/fabfos.sh -b.
+/src/fabfos/_library/
+
 # GUI: `msm gui` writes its project directory into the cwd -- agents/,
 # workflows/<name>/, runs/<name>/ (store.py), plus the served config and
-# whatever library it pulled in. `./dev.sh --gui` puts that under
-# scratch/gui-main/ (already ignored via /scratch); these rules are the guard
-# for anyone who runs it from the repo root anyway.
+# whatever library it pulled in. `./dev/metasmith.sh --gui` puts that under
+# src/metasmith/scratch/gui-main/ (already ignored via src/metasmith/.gitignore);
+# these rules are the guard for anyone who runs it from the repo root anyway.
 /agents/
 /workflows/
 /runs/
 /.metasmith_gui.yml
 /.cache/
 /MetasmithLibraries/
 /example_resources/
+
+# _metadata/ under the standard library and under fabfos's own algorithm
+# library is a build product (`metasmith build all`), not source -- compiled
+# from data_types/*.yml + the transform Python by dev/libraries.sh -bm (the
+# standard library) or dev/fabfos.sh -bm (fabfos's own, since it sits inside
+# the package and is not reached by --vendor-library). A stale or missing
+# copy is silent (the library loads and resolves nothing, no error anywhere),
+# which is what _assert_metadata_present in ops/build.py now guards against
+# at vendor time. See AGENTS.md > "The build is not optional".
+/src/metasmith_libraries/resources/*/_metadata/
+/src/metasmith_libraries/transforms/*/_metadata/
+# staged in from envs/metasmith_libraries by `dev/libraries.sh --stage-envs`
+/src/metasmith_libraries/envs/
+/src/fabfos/algorithm/_metadata/
+
+# The vendored copy of src/ecspr that build_references/build.sh stages as
+# `buildlib::ecspr`. Generated from the source tree immediately before the
+# metadata compile, so committing it would be committing a second copy of a
+# package this repository already holds -- and one that can disagree with it.
+# build_references/_metadata IS tracked; this is the one build product under it
+# that is not.
+/src/fabfos/build_references/resources/buildlib/ecspr/
+
+# A deployed agent home is a build product of running something, not repo
+# content. `/msm_home/` is the current spelling and the one the ignore rules
+# missed -- they named two older ones. The tests' own home sits one directory
+# deeper and is named by tests/metasmith_libraries/conftest.py.
+/msm_home/
+/tests/metasmith_libraries/test_msm_home/
+
+# authoring aid: `build_templates.py --dag` renders here, never committed
+/src/metasmith_libraries/results/
+# the frozen reference library (`python -m fabfos.refs freeze`). Generated, and
+# its manifest holds ABSOLUTE paths, so a committed copy would be wrong on every
+# other machine -- the ids inside it are not, which is the point.
+/data/fabfos/refs.xgdb/

.readthedocs.yaml

@@ -11,8 +11,8 @@ build:
     python: "mambaforge-22.9" # https://hub.docker.com/r/condaforge/mambaforge/tags
 
 conda:
-  environment: envs/docs.yml
+  environment: envs/metasmith/docs.yml
 
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:
-   configuration: docs/source/conf.py
+   configuration: docs/metasmith/source/conf.py

.vscode/settings.json

@@ -1,17 +1,17 @@
 {
     "python.autoComplete.extraPaths": [
-        "${workspaceFolder}/lib",
+        "${workspaceFolder}/src/metasmith/lib",
         "${workspaceFolder}/src",
     ],
     "python.analysis.extraPaths": [
-        "${workspaceFolder}/lib",
+        "${workspaceFolder}/src/metasmith/lib",
         "${workspaceFolder}/src",
     ],
     "python.analysis.exclude": [
         "**/cache",
     ],
     "terminal.integrated.env.linux": {
-        "PYTHONPATH": "${workspaceFolder}/lib:${workspaceFolder}/src",
+        "PYTHONPATH": "${workspaceFolder}/src/metasmith/lib:${workspaceFolder}/src",
         "ws": "${workspaceFolder}",
     },
     "esbonio.server.enabled": false,