feat: positive-marker repo detection and scaffold auto-registration (#75)

Harden the tool-scaffolding subsystem so a repo cannot be born wrong,
born unknown, or born unregistered.

- _detect_repo_type keys on positive manifest markers (.cursor-plugin/
  plugin.json => cursor-plugin; package.json => mcp-server) instead of
  incidental directory presence. An mcp-server rendered with skills/ now
  classifies correctly instead of flipping to unknown and silently losing
  required-workflow enforcement. Adds package.json to SPARSE_PATHS so
  mode=all detection sees the marker.
- create-tool.py registers every generated repo in registry.json by
  default and regenerates derived artifacts via the shared sync_all code
  path; --no-register is the escape hatch. The live registry is untouched.
- Canonical generation logic factored into importable scaffold/generator.py
  (generate_repo / build_registry_entry / register_in_registry) so a second
  generator can delegate instead of reimplement. create-tool.py is a thin CLI.
- standards/born-green-contract.md codifies the born-green acceptance
  criterion (C1-C6) any generator must satisfy.
- Born-green test extended with the previously-breaking shapes (mcp-server
  with skills, empty cursor-plugin) and a registration round-trip against a
  temp registry root.

Bumps VERSION 1.16.3 -> 1.17.0.

Signed-off-by: fOuttaMyPaint <154358121+TMHSDigital@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: TMHSDigital

.github/workflows/validate.yml

@@ -99,16 +99,20 @@ jobs:
         run: pip install Jinja2 PyYAML
 
       - name: Check scaffold syntax
-        run: python3 -m py_compile scaffold/create-tool.py
+        run: python3 -m py_compile scaffold/create-tool.py scaffold/generator.py
 
       - name: Test scaffold dry run
+        # --no-register: this is a throwaway probe; it must not mutate the
+        # checkout's registry.json (registration is covered hermetically by
+        # tests/test_scaffold_born_green.py against a temp registry root).
         run: |
           python3 scaffold/create-tool.py \
             --name "CI Test Plugin" \
             --description "Automated test" \
             --mcp-server \
             --skills 2 \
             --rules 1 \
+            --no-register \
             --output /tmp/scaffold-test
 
           test -f /tmp/scaffold-test/ci-test-plugin/.cursor-plugin/plugin.json

README.md

@@ -106,6 +106,7 @@ Documented conventions for building new developer tools. All docs in [`standards
 | [AGENTS.md Template](standards/agents-template.md) | AI agent guidance file structure |
 | [Versioning](standards/versioning.md) | Semver management and automated release flow |
 | [Release-doc-sync](standards/release-doc-sync.md) | Composite action contract for keeping CHANGELOG, CLAUDE, and ROADMAP in sync after auto-release |
+| [Born-Green Contract](standards/born-green-contract.md) | Acceptance criterion every repo generator must satisfy |
 | [Testing](standards/testing.md) | Test frameworks, coverage bar, and CI wiring |
 | [Skills](standards/skills.md) | `SKILL.md` structure and frontmatter |
 | [Rules](standards/rules.md) | `.mdc` structure, globs, and the secrets rule pattern |

VERSION

@@ -1 +1 @@
-1.16.3
+1.17.0