mainsequence-metatable 0.1.10.dev20__tar.gz → 0.1.11__tar.gz

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/.agents/skills/client/metatables-local-development/SKILL.md

@@ -38,6 +38,20 @@ storage isolation. Require `local_mode: true`; after initialization also require
 stop the mutating work and select Local in Settings or restart with `serve --local`.
 Do not retry against automatic hosted discovery when a local connection fails.
 
+## One local runtime per laptop
+
+The local runtime is a single SQLite file, `~/.local/share/metatables/metatables.sqlite`
+by default, shared by every project, checkout and branch on the machine. Each project
+records it under `local` in its `.local/runtime-data-sources.json`.
+
+- A checkout that ran an earlier MetaTables release may still have its own
+  per-checkout file saved there; upgrading does not move it. To join the shared
+  runtime, select the shared file in Settings. The old file's tables are not copied:
+  run the application's migrations and fixtures again, and leave the old file in place.
+- The shared runtime is at the newest system migration any project applied. If
+  status reports an unsupported revision, upgrade the application's
+  `mainsequence-metatable` instead of selecting another database.
+
 ## Establish the development loop
 
 1. Work in the consuming application's Git checkout, with its commit and origin
@@ -120,9 +134,10 @@ or idempotent behavior. For a persistence claim, restart and read existing rows
 before seeding again. Recheck runtime state after any restart or mode/source change;
 do not switch modes while tests or producers are running.
 
-Local storage persists across launches and Git branches of the checkout. A new
-branch does not create a fresh test database. Use identifiable fixtures and clean
-up only the rows owned by the test. When a fresh database is necessary, select a
+Local storage persists across launches, and other projects' tables and fixtures share
+the same runtime. A new branch or project does not create a fresh test database. Use
+identifiable fixtures in the application's own namespace and clean up only the rows
+owned by the test. When a fresh database is necessary, select a
 separate temporary SQLite file through Settings and initialize it explicitly;
 restore the previous selection afterwards. Do not delete or replace a developer's
 existing database just to obtain a clean test run.

{mainsequence_metatable-0.1.10.dev20/src/mainsequence_metatable.egg-info → mainsequence_metatable-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence-metatable
-Version: 0.1.10.dev20
+Version: 0.1.11
 Summary: Main Sequence MetaTables Python client and standalone API
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: MIT

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/docs/client/installation-and-connection.md

@@ -93,6 +93,11 @@ guide/example snapshots in each skill's `references/` folder. The installed clie
 version is recorded in `PINNED_FROM.txt`. Skills for API implementation or
 MetaTables project development are outside this bundle.
 
+Running the command again replaces the whole `metatables` namespace: folders the
+installed client does not ship, including any added there, are removed. Keep the
+application's own skills in another `.agents/skills/` namespace; the copy never
+changes it.
+
 Use `metatables-upgrade-legacy-app` when replacing older MainSequence/MetaTables
 imports, declared SQL scopes or API-owned application migration setup. The
 [legacy application upgrade guide](upgrade-legacy-app.md) explains the current

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/docs/operations/configuration.md

@@ -10,7 +10,7 @@ implement a second platform HTTP client or token exchange.
 | `runtime_database` in the API's `configuration.yaml` | Hosted API, migration Job, launcher in Hosted mode | Declares the hosted runtime database: engine, the Environment Secret holding its URI, schema and TLS. See [hosted runtime](hosted-runtime.md#declare-the-runtime-database). |
 | `METATABLES_LOCAL_TOKEN` | Local launcher and client | Private ASCII token of at least 40 characters. |
 | `METATABLES_LOCAL_ALLOWED_ORIGINS` | Local API | Comma-separated exact loopback HTTP(S) origins with explicit ports; empty by default. |
-| `METATABLES_LOCAL_STORAGE_DIR` | Local API | Root for the checkout's local runtime SQLite file, shared across Git branches; defaults to `~/.local/share/metatables`. |
+| `METATABLES_LOCAL_STORAGE_DIR` | Local API | Directory of the laptop's single local runtime SQLite file, shared by every checkout and branch; defaults to `~/.local/share/metatables`. |
 
 Client discovery uses the name derived from the API automatic-deployment file
 and the caller's resolved Organization Environment. Identical names in other

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/docs/operations/local-runtime.md

@@ -99,20 +99,30 @@ Shared hosted deployments disable local mode. Switching affects the whole API in
 The default file is:
 
 ```text
-~/.local/share/metatables/<workspace-uid>/metatables.sqlite
+~/.local/share/metatables/metatables.sqlite
 ```
 
-`METATABLES_LOCAL_STORAGE_DIR` changes the root before workspace selection. Settings
-can configure an absolute SQLite file. The default workspace identity uses the
-checkout and repository, excluding Git branch, ref and commit. The selected file is
-stored under the single `local` entry in `.local/runtime-data-sources.json`. Branch
-changes and restarts reuse it, its credentials and its DataSource UID. Git context
-still describes the running code; changing that context requires restarting the API.
-
-Existing files retain their paths, storage markers and IDs. A single legacy saved
-file is adopted intact and its selection is rewritten to `local`. When multiple
-legacy files exist, choose the intended file in Settings; startup does not guess,
-merge catalogs or create an empty replacement. Old unselected files are preserved.
+The local runtime is one per laptop: every checkout, repository and branch uses the
+same file. `METATABLES_LOCAL_STORAGE_DIR` changes its directory. Settings can
+configure another absolute SQLite file. A new file's identity derives from its
+location; an existing file keeps the identity recorded in its scope marker, so a file
+moved together with its marker keeps its DataSource UID and run logs. The selected
+file is stored under the single `local` entry in `.local/runtime-data-sources.json`.
+Branch changes and restarts reuse it, its credentials and its DataSource UID. Git
+context still describes the running code; changing that context requires restarting
+the API.
+
+Existing files retain their paths, storage markers and IDs. A checkout that saved a
+per-checkout file under an earlier release keeps using it after an upgrade; select
+the shared file in Settings to join the laptop runtime. Its tables are not copied, so
+run the application's migrations and fixtures again. A single legacy saved file is
+adopted intact and its selection is rewritten to `local`. When multiple legacy files
+exist, choose the intended file in Settings; startup does not guess, merge catalogs
+or create an empty replacement. Old unselected files are preserved.
+
+Every project opening the shared file needs a MetaTables release that includes the
+file's system migrations. An older client reports an unsupported revision; upgrade
+its `mainsequence-metatable` rather than selecting another database.
 
 The runtime source remains fixed while active. The Data Sources page displays it but
 cannot retarget, disable or delete it. Source selection belongs to Settings, where the

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence-metatable"
-version = "0.1.10.dev20"
+version = "0.1.11"
 description = "Main Sequence MetaTables Python client and standalone API"
 readme = "README.md"
 requires-python = ">=3.13"

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11/src/mainsequence_metatable.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence-metatable
-Version: 0.1.10.dev20
+Version: 0.1.11
 Summary: Main Sequence MetaTables Python client and standalone API
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: MIT

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/src/metatables/api/backend/integrations/local_workspace.py

@@ -1,4 +1,4 @@
-"""One API-owned local runtime per checkout, independent of Git branches."""
+"""One API-owned local runtime per laptop, shared by every checkout and branch."""
 
 from __future__ import annotations
 
@@ -157,21 +157,20 @@ def select_local_workspace(
         raise RuntimeError(
             "LOCAL_DATA_SOURCES_FILE is retired; configure API-owned SQLite storage instead."
         )
-    identity = json.dumps(
-        [
-            str(source.repository_root.resolve()),
-            source.canonical_repository_identity,
-        ],
-        separators=(",", ":"),
-    )
-    uid = uuid5(NAMESPACE_URL, "metatables:workspace:" + identity)
+    if values.get("METATABLES_CATALOG_DATABASE_URL") or values.get("METATABLES_LOCAL_TABLES_FILE"):
+        raise RuntimeError("Separate catalog/table overrides are retired. Configure the runtime DataSource in Settings.")
     root = (
         Path(values.get("METATABLES_LOCAL_STORAGE_DIR") or Path.home() / ".local/share/metatables")
         .expanduser()
         .resolve()
     )
-    directory = root / str(uid)
-    if values.get("METATABLES_CATALOG_DATABASE_URL") or values.get("METATABLES_LOCAL_TABLES_FILE"):
-        raise RuntimeError("Separate catalog/table overrides are retired. Configure the runtime DataSource in Settings.")
-    path = directory / "metatables.sqlite"
+    # The local runtime belongs to the laptop, not to a checkout: every project
+    # shares this file. A new file's identity follows its location; an existing
+    # file keeps the identity in its scope marker, so a moved runtime stays itself.
+    path = root / "metatables.sqlite"
+    marker = _read_marker(path.with_name(path.name + ".metatables-scope.json"))
+    if marker and marker.get("purpose") == "runtime":
+        uid = UUID(marker["workspace_uid"])
+    else:
+        uid = uuid5(NAMESPACE_URL, "metatables:local-runtime:" + str(path))
     return LocalWorkspace(uid, source, path)

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/tests/integrations/test_local_data_sources.py

@@ -1,6 +1,7 @@
-"""One local runtime survives branch changes without falling back to platform sources."""
+"""One local runtime per laptop survives checkout and branch changes without platform sources."""
+import json
 from dataclasses import replace
-from uuid import uuid4
+from uuid import uuid4, uuid5
 
 import pytest
 from mainsequence.code_repository_context import GitCodeRepositorySourceContext
@@ -35,12 +36,25 @@ def test_workspace_survives_branch_and_commit_changes(scope):
         assert other.data_source.display_name == 'Local MetaTables'
 
 
-def test_separate_checkouts_have_independent_defaults(scope):
+def test_checkouts_share_the_laptop_runtime(scope, tmp_path):
     source, values = scope
     first = select_local_workspace(source=source, values=values)
-    other = select_local_workspace(source=replace(source, repository_root=source.repository_root / 'another'), values=values)
-    assert other.uid != first.uid
-    assert other.catalog_path != first.catalog_path
+    other = select_local_workspace(source=replace(source, repository_root=tmp_path / 'another',
+        canonical_repository_identity='https://example.test/org/other'), values=values)
+    assert other.uid == first.uid
+    assert other.data_source.uid == first.data_source.uid
+    assert other.catalog_path == first.catalog_path == tmp_path / 'stores' / 'metatables.sqlite'
+
+
+def test_existing_laptop_runtime_keeps_its_marker_identity(scope, tmp_path):
+    source, values = scope
+    moved = uuid4()
+    marker = tmp_path / 'stores' / 'metatables.sqlite.metatables-scope.json'
+    marker.parent.mkdir(parents=True)
+    marker.write_text(json.dumps({'workspace_uid': str(moved), 'purpose': 'runtime'}))
+    workspace = select_local_workspace(source=replace(source, repository_root=tmp_path / 'new-project'), values=values)
+    assert workspace.uid == moved
+    assert workspace.data_source.uid == uuid5(moved, 'tables')
 
 
 @pytest.mark.parametrize('setting,value', [

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/tests/packaging/test_client_skills.py

@@ -46,7 +46,7 @@ def test_dry_run_reports_version_and_destinations_without_creating_project(tmp_p
     assert not project.exists()
 
 
-def test_copy_and_refresh_preserve_other_namespaces_and_deliver_portable_references(tmp_path, monkeypatch):
+def test_copy_and_refresh_replace_only_the_metatables_namespace_with_portable_references(tmp_path, monkeypatch):
     monkeypatch.chdir(tmp_path)
     unrelated = tmp_path / ".agents/skills/mainsequence/custom/SKILL.md"
     unrelated.parent.mkdir(parents=True)
@@ -64,7 +64,8 @@ def test_copy_and_refresh_preserve_other_namespaces_and_deliver_portable_referen
     assert second.exit_code == 0, second.output
     assert not stale.exists()
     assert unrelated.read_text() == "consumer instructions"
-    assert custom.read_text() == "custom"
+    # The SDK owns the whole namespace: folders the client does not ship are removed.
+    assert not custom.parent.exists()
     pin = (bundle / "PINNED_FROM.txt").read_text()
     assert f"pinned_version={version('mainsequence-metatable')}" in pin
     assert "library_name=mainsequence-metatable" in pin

{mainsequence_metatable-0.1.10.dev20 → mainsequence_metatable-0.1.11}/uv.lock

@@ -632,7 +632,7 @@ server = [
 
 [[package]]
 name = "mainsequence-metatable"
-version = "0.1.10"
+version = "0.1.11"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },