dancerudiments 0.2.3__tar.gz → 0.2.4__tar.gz

dancerudiments-0.2.4/AGENTS.md

@@ -0,0 +1,9 @@
+# Agent instructions for DanceRudiments
+
+- Read README.md, docs/ and the binding examples. Check the native catalogue, integer-pip timing, compositions and the C++, Python, WASM and C# bindings before adding a pattern or adapter.
+- Use the relevant existing capabilities as fully as the task warrants. Always look for a useful improvement to this tool. Fix a reusable gap here rather than copying its engine or carrying a private workaround; record why no change is justified when that is the result.
+- Submit improvements as PRs to https://github.com/kieransimkin/DanceRudiments/pulls. Never leave a completed reusable improvement only in a local fork. Keep changes focused and preserve the tool's identity and compatibility contracts.
+- Add relevant regression coverage, documentation and a reproducible example when behaviour changes. Use tools/release_version.py and tools/check_release_version.py. Run the native and relevant binding tests from .github/workflows/ before packaging.
+- Keep credentials, account data, private media and rights records out of source, fixtures, logs and packages. Use synthetic fixtures or explicitly authorised public examples and preserve their provenance/licences.
+- Use [CONTRIBUTING.md](CONTRIBUTING.md) for review. Maintainers publish accepted, validated improvements as a fresh matching GitHub release and verify configured registry destinations. Preserve existing tags and release assets; publication and deployment remain subject to applicable authorisation.
+- Website: https://kieransimkin.co.uk/danceflow/

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.4 - 2026-10-08
+
+- Add explicit agent capability, improvement, validation and upstream PR guidance to the README and contributor instructions.
+
 ## 0.2.3 - 2026-10-08
 
 - Preserve the canonical My Songs author link in the branding guide and validate it in source checks as well as real archives. Fixes the 0.2.2 Python/native packaging guard failure; already published 0.2.2 assets remain immutable.

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.20)
-project(DanceRudiments VERSION 0.2.3
+project(DanceRudiments VERSION 0.2.4
   DESCRIPTION "Deterministic rhythmic position functions for DanceFlow. Music: https://kieransimkin.co.uk/my-songs/"
   HOMEPAGE_URL "https://kieransimkin.co.uk/my-songs/"
   LANGUAGES CXX)

dancerudiments-0.2.4/CONTRIBUTING.md

@@ -0,0 +1,12 @@
+# Contributing to DanceRudiments
+
+Agents and people are welcome to improve DanceRudiments. Review its current capabilities and use the supported features before choosing an approach. Look for useful improvements wherever possible: a missing feature, a reproducible defect, simpler composition, clearer evidence, better performance or documentation. Avoid changes that do not serve a concrete need.
+
+1. Read README.md, docs/ and the binding examples. Check the native catalogue, integer-pip timing, compositions and the C++, Python, WASM and C# bindings before adding a pattern or adapter.
+2. Start a focused branch from the current default branch. Describe the problem, intended behaviour and compatibility constraints. Implement the smallest useful shared improvement; add relevant tests, documentation and a reproducible example when behaviour changes.
+3. Use tools/release_version.py and tools/check_release_version.py. Run the native and relevant binding tests from .github/workflows/ before packaging. Report the commands, results and any genuine verification limits. Keep private inputs, credentials and generated caches out of the contribution.
+4. Open a pull request at https://github.com/kieransimkin/DanceRudiments/pulls. Include the problem, resulting behaviour, validation and any risks. Submit improvements upstream rather than leaving them only in a local fork; do not push directly to the default branch as a substitute for review.
+
+Maintainers review accepted changes, reserve a fresh version and publish a matching GitHub release from the validated source. They verify installable assets, checksums and each configured registry separately. Existing tags and release assets remain immutable. A submitted PR is a contribution awaiting review, not a published release or permission for unrelated deployment.
+
+Website: [https://kieransimkin.co.uk/danceflow/](https://kieransimkin.co.uk/danceflow/).

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dancerudiments
-Version: 0.2.3
+Version: 0.2.4
 Summary: Deterministic rhythmic position functions with C++, Python, TypeScript/WASM and C# bindings. https://kieransimkin.co.uk/my-songs/
 Author: Kieran Simkin
 License-Expression: MIT AND BSD-3-Clause AND CC0-1.0 AND CC-BY-4.0
@@ -31,6 +31,15 @@ By **[Kieran Simkin — My Songs](https://kieransimkin.co.uk/my-songs/)** · Par
 
 <a id="visualizer"></a>
 
+
+## Agents and contributors
+
+Agents using DanceRudiments should inspect its available capabilities, use them fully where they fit the task, and look for useful improvements wherever possible. When a required feature is missing, or a reusable reliability, usability, performance or documentation gap is found, improve this tool rather than maintaining a separate workaround. If no worthwhile change is justified, explain why.
+
+Submit every improvement as a pull request to [DanceRudiments](https://github.com/kieransimkin/DanceRudiments/pulls), with relevant tests, documentation and a reproducible example. Follow [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) for the contribution and validation workflow.
+
+Project website: [https://kieransimkin.co.uk/danceflow/](https://kieransimkin.co.uk/danceflow/).
+
 ## ▶ Try the pattern visualizer
 
 **[Download the self-contained visualizer — HTML](https://github.com/kieransimkin/DanceRudiments/raw/refs/heads/main/harness/index.html)**

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/README.md

@@ -13,6 +13,15 @@ By **[Kieran Simkin — My Songs](https://kieransimkin.co.uk/my-songs/)** · Par
 
 <a id="visualizer"></a>
 
+
+## Agents and contributors
+
+Agents using DanceRudiments should inspect its available capabilities, use them fully where they fit the task, and look for useful improvements wherever possible. When a required feature is missing, or a reusable reliability, usability, performance or documentation gap is found, improve this tool rather than maintaining a separate workaround. If no worthwhile change is justified, explain why.
+
+Submit every improvement as a pull request to [DanceRudiments](https://github.com/kieransimkin/DanceRudiments/pulls), with relevant tests, documentation and a reproducible example. Follow [CONTRIBUTING.md](CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) for the contribution and validation workflow.
+
+Project website: [https://kieransimkin.co.uk/danceflow/](https://kieransimkin.co.uk/danceflow/).
+
 ## ▶ Try the pattern visualizer
 
 **[Download the self-contained visualizer — HTML](https://github.com/kieransimkin/DanceRudiments/raw/refs/heads/main/harness/index.html)**

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/bindings/csharp/DanceRudiments/DanceRudiments.csproj

@@ -2,7 +2,7 @@
   <!-- Kieran Simkin / DanceFlow: https://kieransimkin.co.uk/my-songs/ -->
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
-    <Version>0.2.3</Version>
+    <Version>0.2.4</Version>
     <PackageId>DanceRudiments</PackageId>
     <Authors>Kieran Simkin</Authors>
     <Description>Deterministic rhythmic position functions with native C# bindings. Music: https://kieransimkin.co.uk/my-songs/</Description>

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/harness/index.html

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
-name: dancerudiments-0.2.3/harness/index.html
+name: dancerudiments-0.2.4/harness/index.html
 size: 36837222 bytes
 sha256: 8b85f3862a4dd3b131eaf5a9225dc421959b1707f7e272c3a22bad10c104173f

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@kieransimkin/dance-rudiments",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@kieransimkin/dance-rudiments",
-      "version": "0.2.3",
+      "version": "0.2.4",
       "devDependencies": {
         "typescript": "^5.9.0"
       },

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kieransimkin/dance-rudiments",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Deterministic rhythmic position functions with C++, Python, TypeScript/WASM and C# bindings. https://kieransimkin.co.uk/my-songs/",
   "license": "MIT AND BSD-3-Clause AND CC0-1.0 AND CC-BY-4.0",
   "type": "module",
@@ -45,7 +45,9 @@
     "docs/troubleshooting.md",
     "docs/csharp.md",
     "bindings/csharp/README.md",
-    "docs/branding/"
+    "docs/branding/",
+    "AGENTS.md",
+    "CONTRIBUTING.md"
   ],
   "repository": {
     "type": "git",

{dancerudiments-0.2.3 → dancerudiments-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "dancerudiments"
-version = "0.2.3"
+version = "0.2.4"
 description = "Deterministic rhythmic position functions with C++, Python, TypeScript/WASM and C# bindings. https://kieransimkin.co.uk/my-songs/"
 readme = "README.md"
 license = "MIT AND BSD-3-Clause AND CC0-1.0 AND CC-BY-4.0"
@@ -30,7 +30,7 @@ Issues = "https://github.com/kieransimkin/DanceRudiments/issues"
 [tool.scikit-build]
 cmake.args = ["-DDANCERUDIMENTS_BUILD_PYTHON=ON", "-DDANCERUDIMENTS_BUILD_TESTS=OFF"]
 wheel.packages = ["python/dancerudiments_authoring"]
-sdist.include = ["CMakeLists.txt", "include/**", "src/**", "bindings/python/**", "python/**", "tools/**", "collections/**", "harness/initial/**", "harness/initial-collection.html", ".gitattributes", "examples/patterns/**", "docs/authoring.md", "docs/default-library.md", "docs/dancefloor.md", "docs/release-demo.md", "cmake/**", "tests/**", "README.md", "AUTHORS.md", "packaging/**", "docs/images/**", "docs/branding/**", "docs/bindings.md", "docs/troubleshooting.md", "examples/bindings/**", "bindings/csharp/**", "docs/csharp.md"]
+sdist.include = ["AGENTS.md", "CONTRIBUTING.md", "CMakeLists.txt", "include/**", "src/**", "bindings/python/**", "python/**", "tools/**", "collections/**", "harness/initial/**", "harness/initial-collection.html", ".gitattributes", "examples/patterns/**", "docs/authoring.md", "docs/default-library.md", "docs/dancefloor.md", "docs/release-demo.md", "cmake/**", "tests/**", "README.md", "AUTHORS.md", "packaging/**", "docs/images/**", "docs/branding/**", "docs/bindings.md", "docs/troubleshooting.md", "examples/bindings/**", "bindings/csharp/**", "docs/csharp.md"]
 
 # Do not ship hand-off patches, credentials, or local example output in sdists.
 sdist.exclude = ["*.patch", "npm_recovery_codes.txt", "examples/bindings/typescript/dist/**", "bindings/csharp/**/bin/**", "bindings/csharp/**/obj/**", "tests/csharp/**/bin/**", "tests/csharp/**/obj/**", "examples/bindings/csharp/bin/**", "examples/bindings/csharp/obj/**"]