mainsequence 8.1.20.dev3__tar.gz → 8.1.20.dev4__tar.gz

{mainsequence-8.1.20.dev3/mainsequence.egg-info → mainsequence-8.1.20.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 8.1.20.dev3
+Version: 8.1.20.dev4
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-8.1.20.dev3 → mainsequence-8.1.20.dev4}/agent_scaffold/skills/data_publishing/meta_table_migrations/SKILL.md

@@ -17,11 +17,16 @@ platform-managed application tables outside the migration workflow.
 
 ## Read First
 
-1. `docs/tutorial/metatable_migrations.md`
-2. `docs/knowledge/meta_tables/migrations.md`
-3. `docs/knowledge/meta_tables/api.md`
-4. `docs/adr/0020-metatable-migration-artifact-registry.md`
-5. `docs/adr/0026-sdk-owned-migration-scaffolding.md`
+1. `docs/knowledge/meta_tables/migrations.md`
+2. `docs/knowledge/meta_tables/api.md`
+3. `docs/adr/0020-metatable-migration-artifact-registry.md`
+4. `docs/adr/0026-sdk-owned-migration-scaffolding.md`
+
+`docs/knowledge/meta_tables/migrations.md` is the authoritative SDK reference for
+provider behavior and migration contracts. The runnable beginner migration
+walkthrough is maintained in the separate canonical tutorial CodeRepository at
+<https://github.com/mainsequence-projects/mainsequence-sdk-tutorial>; read it
+only when a runnable end-to-end example is needed.
 
 ## Required Decisions
 

{mainsequence-8.1.20.dev3 → mainsequence-8.1.20.dev4}/agent_scaffold/skills/data_publishing/meta_tables/SKILL.md

@@ -49,15 +49,19 @@ If the user is still in the discovery process and does not yet know what data ex
 
 ## Read First
 
-1. `docs/tutorial/working_with_meta_tables.md`
-2. For migration work, use
+1. `docs/knowledge/meta_tables/index.md`
+2. `docs/knowledge/meta_tables/sqlalchemy.md`
+3. `docs/knowledge/meta_tables/compiled_sql.md`
+4. `docs/knowledge/meta_tables/migrations.md`
+5. `docs/knowledge/meta_tables/api.md`
+6. For migration work, use
    `.agents/skills/mainsequence/data_publishing/meta_table_migrations/SKILL.md`
-   and `docs/tutorial/metatable_migrations.md`
-3. `docs/knowledge/meta_tables/index.md`
-4. `docs/knowledge/meta_tables/sqlalchemy.md`
-5. `docs/knowledge/meta_tables/compiled_sql.md`
-6. `docs/knowledge/meta_tables/migrations.md`
-7. `docs/knowledge/meta_tables/api.md`
+
+The knowledge pages above are the authoritative SDK reference for MetaTables.
+The runnable beginner walkthrough is maintained in the separate canonical
+tutorial CodeRepository at
+<https://github.com/mainsequence-projects/mainsequence-sdk-tutorial>; read it
+only when a runnable end-to-end example is needed.
 
 ## Inputs This Skill Needs
 
@@ -310,7 +314,7 @@ asset_meta_table = MetaTable.register(asset_request)
 
 When doing migration work, use
 `.agents/skills/mainsequence/data_publishing/meta_table_migrations/SKILL.md`
-and read `docs/tutorial/metatable_migrations.md`. The migration skill owns the
+and read `docs/knowledge/meta_tables/migrations.md`. The migration skill owns the
 provider-based Alembic lifecycle.
 
 Do not apply in-place contract changes by changing a `PlatformManagedMetaTable`

{mainsequence-8.1.20.dev3 → mainsequence-8.1.20.dev4}/agent_scaffold/skills/platform_operations/access_control_and_sharing/SKILL.md

@@ -61,11 +61,16 @@ This skill only reasons about access to deployed resources such as `ResourceRele
 
 ## Read First
 
-1. `docs/tutorial/role_based_access_control.md`
-2. `docs/knowledge/infrastructure/users_and_access.md`
-3. `docs/knowledge/infrastructure/constants_and_secrets.md`
+1. `docs/knowledge/infrastructure/users_and_access.md`
+2. `docs/knowledge/infrastructure/constants_and_secrets.md`
 
-If the task is specifically about a resource type, also read the corresponding knowledge or tutorial page for that resource.
+If the task is specifically about a resource type, also read the corresponding knowledge or CLI page for that resource.
+
+The knowledge pages above are the authoritative SDK reference for access control
+and sharing. The runnable beginner walkthrough is maintained in the separate
+canonical tutorial CodeRepository at
+<https://github.com/mainsequence-projects/mainsequence-sdk-tutorial>; read it
+only when a runnable end-to-end example is needed.
 
 ## Inputs This Skill Needs
 

{mainsequence-8.1.20.dev3 → mainsequence-8.1.20.dev4/mainsequence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 8.1.20.dev3
+Version: 8.1.20.dev4
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-8.1.20.dev3 → mainsequence-8.1.20.dev4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence"
-version = "8.1.20.dev3"
+version = "8.1.20.dev4"
 description = "Main Sequence SDK "
 readme = "README.md"
 requires-python = ">=3.13"

{mainsequence-8.1.20.dev3 → mainsequence-8.1.20.dev4}/tests/test_code_repository_documentation_contract.py

@@ -23,6 +23,14 @@ STREAMLIT_REMOVAL_LINK_PATHS = {
     Path("docs/SUMMARY.md"),
     Path("docs/index.md"),
 }
+SKILL_ROOT = REPOSITORY_ROOT / "agent_scaffold" / "skills"
+# Skills ship inside the wheel but reference repository documentation by its
+# repository-relative path, so every referenced path must exist in the tree that
+# produced the release.
+SKILL_DOCUMENTATION_REFERENCE = re.compile(r"`(docs/[A-Za-z0-9_./-]+\.md)`")
+# Skills are copied into a CodeRepository under `.agents/skills/<namespace>/`, so
+# a cross-skill reference maps back to a shipped `agent_scaffold/skills` path.
+SKILL_CROSS_REFERENCE = re.compile(r"`\.agents/skills/[A-Za-z0-9_]+/([A-Za-z0-9_./-]+/SKILL\.md)`")
 RETIRED_PUBLIC_IDENTIFIERS = {
     "project_context": re.compile(r"(?<![A-Za-z0-9_])project_context(?![A-Za-z0-9_])"),
     "project-context": re.compile(r"(?<![A-Za-z0-9_])project-context(?![A-Za-z0-9_])"),
@@ -46,6 +54,10 @@ RETIRED_PUBLIC_IDENTIFIERS = {
 }
 
 
+def _skill_files() -> tuple[Path, ...]:
+    return tuple(sorted(SKILL_ROOT.rglob("SKILL.md")))
+
+
 def _documentation_files() -> tuple[Path, ...]:
     files = {REPOSITORY_ROOT / "README.md", REPOSITORY_ROOT / "CHANGELOG.md"}
     for root in DOCUMENTATION_ROOTS:
@@ -74,10 +86,7 @@ def test_current_documentation_excludes_retired_project_identifiers(path: Path)
 
 def test_code_repository_context_adr_describes_the_current_cutover() -> None:
     adr = (
-        REPOSITORY_ROOT
-        / "docs"
-        / "adr"
-        / "0031-process-lifetime-code-repository-branch-context.md"
+        REPOSITORY_ROOT / "docs" / "adr" / "0031-process-lifetime-code-repository-branch-context.md"
     ).read_text(encoding="utf-8")
 
     assert "get_code_repository_context()" in adr
@@ -121,3 +130,43 @@ def test_current_documentation_does_not_advertise_streamlit_support(path: Path)
     assert "streamlit" not in text.lower()
     assert "create_dashboard" not in text
     assert "delete_dashboard" not in text
+
+
+@pytest.mark.parametrize(
+    "path",
+    _skill_files(),
+    ids=lambda path: str(path.relative_to(REPOSITORY_ROOT)),
+)
+def test_skill_documentation_references_resolve(path: Path) -> None:
+    relative_path = path.relative_to(REPOSITORY_ROOT)
+    text = path.read_text(encoding="utf-8")
+
+    missing = sorted(
+        {
+            reference
+            for reference in SKILL_DOCUMENTATION_REFERENCE.findall(text)
+            if not (REPOSITORY_ROOT / reference).is_file()
+        }
+    )
+
+    assert not missing, f"{relative_path} references documentation that does not exist: {missing}"
+
+
+@pytest.mark.parametrize(
+    "path",
+    _skill_files(),
+    ids=lambda path: str(path.relative_to(REPOSITORY_ROOT)),
+)
+def test_skill_cross_references_resolve(path: Path) -> None:
+    relative_path = path.relative_to(REPOSITORY_ROOT)
+    text = path.read_text(encoding="utf-8")
+
+    missing = sorted(
+        {
+            reference
+            for reference in SKILL_CROSS_REFERENCE.findall(text)
+            if not (SKILL_ROOT / reference).is_file()
+        }
+    )
+
+    assert not missing, f"{relative_path} references skills that are not shipped: {missing}"