magmascript 3.3.0__tar.gz → 4.0.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. {magmascript-3.3.0 → magmascript-4.0.1}/PKG-INFO +30 -32
  2. {magmascript-3.3.0 → magmascript-4.0.1}/README.md +28 -29
  3. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/__init__.py +1 -1
  4. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/cli.py +9 -27
  5. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/commands.py +8 -35
  6. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/config.py +1 -1
  7. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/github.py +1 -2
  8. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/registry.py +1 -1
  9. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/rpc.py +2 -2
  10. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/runner.py +1 -1
  11. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/__init__.py +1 -1
  12. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/archive/__init__.py +1 -1
  13. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/archive/client.py +3 -130
  14. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/gh/__init__.py +1 -1
  15. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/gh/client.py +2 -2
  16. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/lastfm/__init__.py +1 -1
  17. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/lastfm/client.py +1 -1
  18. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mac/__init__.py +1 -1
  19. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mac/client.py +3 -3
  20. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mb/__init__.py +1 -1
  21. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mb/client.py +7 -7
  22. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mc1/__init__.py +1 -1
  23. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mc1/client.py +1 -1
  24. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mcp/__init__.py +1 -1
  25. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mcp/client.py +3 -3
  26. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/__init__.py +1 -1
  27. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/client.py +2 -2
  28. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/pi/__init__.py +1 -1
  29. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/pi/client.py +1 -1
  30. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/rights/__init__.py +1 -1
  31. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/rights/client.py +1 -1
  32. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/scores/__init__.py +1 -1
  33. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/search/__init__.py +1 -1
  34. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/search/client.py +5 -5
  35. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/domain_bridge.py +1 -1
  36. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/interpreter.py +5 -5
  37. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/lexer.py +1 -1
  38. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/parser.py +1 -1
  39. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/repl.py +1 -1
  40. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript.egg-info/PKG-INFO +30 -32
  41. {magmascript-3.3.0 → magmascript-4.0.1}/pyproject.toml +2 -3
  42. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_cli_regressions.py +1 -1
  43. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_commands.py +5 -18
  44. {magmascript-3.3.0 → magmascript-4.0.1}/LICENSE +0 -0
  45. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/codegen/__init__.py +0 -0
  46. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/codegen/c.py +0 -0
  47. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/__init__.py +0 -0
  48. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/cache.py +0 -0
  49. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/command_registry.py +0 -0
  50. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/exceptions.py +0 -0
  51. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/core/output.py +0 -0
  52. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/gh/tools.py +0 -0
  53. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mac/tools.py +0 -0
  54. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mc1/tools.py +0 -0
  55. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/mcp/tools.py +0 -0
  56. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/__init__.py +0 -0
  57. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/archive.py +0 -0
  58. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/met_museum.py +0 -0
  59. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/openverse.py +0 -0
  60. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/pexels.py +0 -0
  61. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/pixabay.py +0 -0
  62. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/providers/smithsonian.py +0 -0
  63. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/media/tools.py +0 -0
  64. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/pi/tools.py +0 -0
  65. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/rights/tools.py +0 -0
  66. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/scores/client.py +0 -0
  67. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/domains/scores/tools.py +0 -0
  68. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/__init__.py +0 -0
  69. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/ast_nodes.py +0 -0
  70. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/astheno/__init__.py +0 -0
  71. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/astheno/arena.py +0 -0
  72. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/astheno/dump.py +0 -0
  73. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/astheno/floorplan.py +0 -0
  74. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/astheno/numeric.py +0 -0
  75. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/builtins.py +0 -0
  76. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/environment.py +0 -0
  77. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/hypnagogia.py +0 -0
  78. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/pretty.py +0 -0
  79. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/pygments_mgs.py +0 -0
  80. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/tokens.py +0 -0
  81. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/util.py +0 -0
  82. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/lang/visitor.py +0 -0
  83. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript/scaffold/__init__.py +0 -0
  84. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript.egg-info/SOURCES.txt +0 -0
  85. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript.egg-info/dependency_links.txt +0 -0
  86. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript.egg-info/entry_points.txt +0 -0
  87. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript.egg-info/requires.txt +0 -0
  88. {magmascript-3.3.0 → magmascript-4.0.1}/magmascript.egg-info/top_level.txt +0 -0
  89. {magmascript-3.3.0 → magmascript-4.0.1}/setup.cfg +0 -0
  90. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_astheno.py +0 -0
  91. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_cache.py +0 -0
  92. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_classes.py +0 -0
  93. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_cli.py +0 -0
  94. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_domain_bridge.py +0 -0
  95. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_import.py +0 -0
  96. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_lang.py +0 -0
  97. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_mac.py +0 -0
  98. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_mc1.py +0 -0
  99. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_mcp_client.py +0 -0
  100. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_rpc.py +0 -0
  101. {magmascript-3.3.0 → magmascript-4.0.1}/tests/test_try_catch.py +0 -0
@@ -1,14 +1,13 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: magmascript
3
- Version: 3.3.0
3
+ Version: 4.0.1
4
4
  Summary: Scripting toolkit with domain-first subcommands
5
5
  Author: Jake McCoy
6
6
  License-Expression: MIT
7
7
  Project-URL: Homepage, https://magmacrunch.com/ware/magmascript/
8
8
  Project-URL: Documentation, https://magmacrunch.com/ware/magmascript/
9
- Project-URL: Funding, https://github.com/sponsors/magmacrunch-media
10
9
  Keywords: mcp,scripting,cli,magmacrunch
11
- Classifier: Development Status :: 3 - Alpha
10
+ Classifier: Development Status :: 5 - Production/Stable
12
11
  Classifier: Environment :: Console
13
12
  Classifier: Intended Audience :: Developers
14
13
  Classifier: Programming Language :: Python :: 3
@@ -214,11 +213,11 @@ throw fire toad("something went wrong")
214
213
  ```
215
214
 
216
215
  MagmaCrunch error vocabulary:
217
- - `haunter` — syntax/parse errors
218
- - `fire toad` — runtime errors
219
- - `devastate` — undefined variable errors
220
- - `contemplate` — type errors
221
- - `spooked` — warnings (non-fatal, prints to stderr)
216
+ - `haunter`: syntax/parse errors
217
+ - `fire toad`: runtime errors
218
+ - `devastate`: undefined variable errors
219
+ - `contemplate`: type errors
220
+ - `spooked`: warnings (non-fatal, prints to stderr)
222
221
 
223
222
  ```magmascript
224
223
  spooked("this is a warning")
@@ -368,13 +367,13 @@ See `scripts/examples/` for working examples:
368
367
  | `astheno-packing.mgs` | The same struct fields, two orderings, two sizes |
369
368
  | `astheno-faults.mgs` | Every memory fault, caught and named |
370
369
 
371
- ### The Asthenosphere — explicit memory
370
+ ### The Asthenosphere: explicit memory
372
371
 
373
372
  The layer beneath the lithosphere. A second tier where you manage memory
374
373
  yourself: a real byte arena, pointers, structs with visible padding, and
375
374
  integers that wrap like C's.
376
375
 
377
- It is not faster than the dynamic tier — an `i32` add still costs a Python
376
+ It is not faster than the dynamic tier: an `i32` add still costs a Python
378
377
  dispatch. What it gives you instead is the thing C cannot: the interpreter sees
379
378
  every memory operation, so it catches the use-after-free, names the line that
380
379
  leaked, and hex-dumps a struct with its fields labelled. **C's behavior, but
@@ -397,7 +396,7 @@ scorch(p) // release it
397
396
  ```
398
397
 
399
398
  Widths are `i8 i16 i32 i64 u8 u16 u32 u64 f32 f64`. There is no integer
400
- promotion — `i32 + u8` is an error pointing you at `osmosis()` — and `/`
399
+ promotion, `i32 + u8` is an error pointing you at `osmosis()`, and `/`
401
400
  truncates toward zero on integer widths, as C does.
402
401
 
403
402
  Mistakes are reported, not swallowed:
@@ -449,7 +448,7 @@ magmascript repl
449
448
 
450
449
  ## Domains
451
450
 
452
- ### MCP Domain — MusicBrainz, scores, Discogs, write operations
451
+ ### MCP Domain: MusicBrainz, scores, Discogs, write operations
453
452
  ```bash
454
453
  magmascript mcp scoreboards # game leaderboards
455
454
  magmascript mcp scores tetris # tetris scores
@@ -461,7 +460,7 @@ magmascript mcp mb-release <mbid> # get release details
461
460
  magmascript mcp mb-recording <mbid> # get recording details
462
461
  ```
463
462
 
464
- ### Pi Domain — Direct SSH to Raspberry Pi
463
+ ### Pi Domain: Direct SSH to Raspberry Pi
465
464
  ```bash
466
465
  magmascript pi status # all service statuses
467
466
  magmascript pi logs arcade-chat # service logs
@@ -472,7 +471,7 @@ magmascript pi backup musicbrainz # backup + commit to GitHub
472
471
  magmascript pi traffic # nginx traffic analysis
473
472
  ```
474
473
 
475
- ### MC1 Domain — Windows PC management (via SSH)
474
+ ### MC1 Domain: Windows PC management (via SSH)
476
475
  ```magmascript
477
476
  // In a .mgs script
478
477
  info = mc1.info()
@@ -491,15 +490,15 @@ Also on the CLI: `magmascript mc1 status`, `mc1 info`, `mc1 processes`,
491
490
  `mc1 restart <service>`, `mc1 power`, `mc1 set-power-mode <always-on|sleep>`,
492
491
  `mc1 wake <mac>`, `mc1 reboot`.
493
492
 
494
- > **Note:** MC1 commands connect over SSH. Don't run them on MC1 itself — they
493
+ > **Note:** MC1 commands connect over SSH. Don't run them on MC1 itself: they
495
494
  > will try to SSH into the configured host, which on MC1 means connecting to
496
495
  > itself and hanging. Use these from your Mac, Pi, or any other machine.
497
496
 
498
- ### Mac Domain — Mac management (via SSH)
497
+ ### Mac Domain: Mac management (via SSH)
499
498
  ```magmascript
500
499
  // In a .mgs script, or: magmascript mac info
501
500
  info = mac.info()
502
- print(f"{info.hostname} — {info.os_version}")
501
+ print(f"{info.hostname}, {info.os_version}")
503
502
  print(f"{info.cpu_name} ({info.cpu_cores} cores), {info.memory}")
504
503
 
505
504
  // Keep a checkout in sync
@@ -510,7 +509,7 @@ mac.git_pull()
510
509
  Also on the CLI: `magmascript mac info`, `mac processes`, `mac git-status`,
511
510
  `mac git-pull`, `mac run "<cmd>"`.
512
511
 
513
- ### GitHub Domain — Direct API access
512
+ ### GitHub Domain: Direct API access
514
513
  ```bash
515
514
  magmascript gh workflows # all workflow statuses
516
515
  magmascript gh trigger "Deploy to Pi" # trigger workflow
@@ -519,7 +518,7 @@ magmascript gh file path/to/file.txt # read file
519
518
  magmascript gh sync # diff + commit all data files
520
519
  ```
521
520
 
522
- ### Scores Domain — Game high scores
521
+ ### Scores Domain: Game high scores
523
522
  ```bash
524
523
  magmascript scores list # all game leaderboards
525
524
  magmascript scores get tetris # tetris scores
@@ -528,57 +527,56 @@ magmascript scores report --discord # Discord JSON payload
528
527
  magmascript scores reset tetris # reset one game (backup created)
529
528
  ```
530
529
 
531
- ### Archive Domain — Archive page operations
530
+ ### Archive Domain: Archive page operations
532
531
  ```bash
533
532
  magmascript archive check-format # validate HTML formatting
534
- magmascript archive bake-cache # inline MusicBrainz cache into pages
535
533
  magmascript archive generate-stubs # generate stub HTML for new entities
536
534
  ```
537
535
 
538
- ### MusicBrainz Domain — MusicBrainz API client
536
+ ### MusicBrainz Domain: MusicBrainz API client
539
537
  ```bash
540
538
  magmascript mb backup # full MusicBrainz backup
541
539
  magmascript mb backup --dry-run # preview backup
542
540
  magmascript mb backup --stale-only # only refresh stale caches
543
541
  ```
544
542
 
545
- ### Last.fm Domain — Last.fm API client
543
+ ### Last.fm Domain: Last.fm API client
546
544
  ```bash
547
545
  magmascript lastfm fetch # fetch play counts
548
546
  magmascript lastfm fetch --skip-existing # skip cached artists
549
547
  ```
550
548
 
551
- ### Search Domain — Site search index builder
549
+ ### Search Domain: Site search index builder
552
550
  ```bash
553
551
  magmascript search build-index # build search-index.json
554
552
  magmascript search preview 10 # preview first 10 entries
555
553
  ```
556
554
 
557
- ### Rights Domain — Music rights metadata (ISRC, ISWC, ASCAP)
555
+ ### Rights Domain: Music rights metadata (ISRC, ISWC, ASCAP)
558
556
  ```bash
559
557
  magmascript rights search "Farewell" # search by title, ISRC, ISWC, or ASCAP ID
560
558
  magmascript rights catalog "C.P. Rutledge" # full rights catalog for an artist
561
559
  magmascript rights export # TSV export for ASCAP forms
562
560
  ```
563
561
 
564
- ### Media Domain — Multi-provider media search
562
+ ### Media Domain: Multi-provider media search
565
563
  ```bash
566
564
  magmascript media search "sunset" # search all providers
567
565
  magmascript media providers # list available providers
568
566
  ```
569
567
 
570
- ### Cache Domain — Cache management
568
+ ### Cache Domain: Cache management
571
569
  ```bash
572
570
  magmascript cache stats # show cache statistics
573
571
  magmascript cache clear # clear all cache
574
572
  ```
575
573
 
576
- ### Magma — System status dashboard
574
+ ### Magma: System status dashboard
577
575
  ```bash
578
576
  magmascript magma # version, domains, cache stats
579
577
  ```
580
578
 
581
- ### Crunch — Batch pipeline
579
+ ### Crunch: Batch pipeline
582
580
  ```bash
583
581
  magmascript crunch mb # MusicBrainz backup
584
582
  magmascript crunch lastfm # Last.fm fetch
@@ -589,7 +587,7 @@ magmascript crunch gh # GitHub sync
589
587
  magmascript crunch all # Run all targets
590
588
  ```
591
589
 
592
- ### Texas — Full/heavy operation (same targets, no shortcuts)
590
+ ### Texas: Full/heavy operation (same targets, no shortcuts)
593
591
  ```bash
594
592
  magmascript texas mb # Full MusicBrainz backup
595
593
  magmascript texas lastfm # Full Last.fm fetch
@@ -600,7 +598,7 @@ magmascript texas gh # Full GitHub sync
600
598
  magmascript texas all # Full heavy run
601
599
  ```
602
600
 
603
- ### Toast — Burn/clear caches
601
+ ### Toast: Burn/clear caches
604
602
  ```bash
605
603
  magmascript toast cache # Clear general cache
606
604
  magmascript toast mb-cache # Clear MusicBrainz cache
@@ -637,7 +635,7 @@ g = tt.game({"title": "hello", "width": 400, "height": 300})
637
635
 
638
636
  A package may register the same class under several names this way; nothing
639
637
  stops it, and the clients stay independent. Note that none of this touches the
640
- `magmascript toast` CLI verb, which still clears caches — registry domains are
638
+ `magmascript toast` CLI verb, which still clears caches, registry domains are
641
639
  not dispatched as subcommands.
642
640
 
643
641
  ## Python Library
@@ -178,11 +178,11 @@ throw fire toad("something went wrong")
178
178
  ```
179
179
 
180
180
  MagmaCrunch error vocabulary:
181
- - `haunter` — syntax/parse errors
182
- - `fire toad` — runtime errors
183
- - `devastate` — undefined variable errors
184
- - `contemplate` — type errors
185
- - `spooked` — warnings (non-fatal, prints to stderr)
181
+ - `haunter`: syntax/parse errors
182
+ - `fire toad`: runtime errors
183
+ - `devastate`: undefined variable errors
184
+ - `contemplate`: type errors
185
+ - `spooked`: warnings (non-fatal, prints to stderr)
186
186
 
187
187
  ```magmascript
188
188
  spooked("this is a warning")
@@ -332,13 +332,13 @@ See `scripts/examples/` for working examples:
332
332
  | `astheno-packing.mgs` | The same struct fields, two orderings, two sizes |
333
333
  | `astheno-faults.mgs` | Every memory fault, caught and named |
334
334
 
335
- ### The Asthenosphere — explicit memory
335
+ ### The Asthenosphere: explicit memory
336
336
 
337
337
  The layer beneath the lithosphere. A second tier where you manage memory
338
338
  yourself: a real byte arena, pointers, structs with visible padding, and
339
339
  integers that wrap like C's.
340
340
 
341
- It is not faster than the dynamic tier — an `i32` add still costs a Python
341
+ It is not faster than the dynamic tier: an `i32` add still costs a Python
342
342
  dispatch. What it gives you instead is the thing C cannot: the interpreter sees
343
343
  every memory operation, so it catches the use-after-free, names the line that
344
344
  leaked, and hex-dumps a struct with its fields labelled. **C's behavior, but
@@ -361,7 +361,7 @@ scorch(p) // release it
361
361
  ```
362
362
 
363
363
  Widths are `i8 i16 i32 i64 u8 u16 u32 u64 f32 f64`. There is no integer
364
- promotion — `i32 + u8` is an error pointing you at `osmosis()` — and `/`
364
+ promotion, `i32 + u8` is an error pointing you at `osmosis()`, and `/`
365
365
  truncates toward zero on integer widths, as C does.
366
366
 
367
367
  Mistakes are reported, not swallowed:
@@ -413,7 +413,7 @@ magmascript repl
413
413
 
414
414
  ## Domains
415
415
 
416
- ### MCP Domain — MusicBrainz, scores, Discogs, write operations
416
+ ### MCP Domain: MusicBrainz, scores, Discogs, write operations
417
417
  ```bash
418
418
  magmascript mcp scoreboards # game leaderboards
419
419
  magmascript mcp scores tetris # tetris scores
@@ -425,7 +425,7 @@ magmascript mcp mb-release <mbid> # get release details
425
425
  magmascript mcp mb-recording <mbid> # get recording details
426
426
  ```
427
427
 
428
- ### Pi Domain — Direct SSH to Raspberry Pi
428
+ ### Pi Domain: Direct SSH to Raspberry Pi
429
429
  ```bash
430
430
  magmascript pi status # all service statuses
431
431
  magmascript pi logs arcade-chat # service logs
@@ -436,7 +436,7 @@ magmascript pi backup musicbrainz # backup + commit to GitHub
436
436
  magmascript pi traffic # nginx traffic analysis
437
437
  ```
438
438
 
439
- ### MC1 Domain — Windows PC management (via SSH)
439
+ ### MC1 Domain: Windows PC management (via SSH)
440
440
  ```magmascript
441
441
  // In a .mgs script
442
442
  info = mc1.info()
@@ -455,15 +455,15 @@ Also on the CLI: `magmascript mc1 status`, `mc1 info`, `mc1 processes`,
455
455
  `mc1 restart <service>`, `mc1 power`, `mc1 set-power-mode <always-on|sleep>`,
456
456
  `mc1 wake <mac>`, `mc1 reboot`.
457
457
 
458
- > **Note:** MC1 commands connect over SSH. Don't run them on MC1 itself — they
458
+ > **Note:** MC1 commands connect over SSH. Don't run them on MC1 itself: they
459
459
  > will try to SSH into the configured host, which on MC1 means connecting to
460
460
  > itself and hanging. Use these from your Mac, Pi, or any other machine.
461
461
 
462
- ### Mac Domain — Mac management (via SSH)
462
+ ### Mac Domain: Mac management (via SSH)
463
463
  ```magmascript
464
464
  // In a .mgs script, or: magmascript mac info
465
465
  info = mac.info()
466
- print(f"{info.hostname} — {info.os_version}")
466
+ print(f"{info.hostname}, {info.os_version}")
467
467
  print(f"{info.cpu_name} ({info.cpu_cores} cores), {info.memory}")
468
468
 
469
469
  // Keep a checkout in sync
@@ -474,7 +474,7 @@ mac.git_pull()
474
474
  Also on the CLI: `magmascript mac info`, `mac processes`, `mac git-status`,
475
475
  `mac git-pull`, `mac run "<cmd>"`.
476
476
 
477
- ### GitHub Domain — Direct API access
477
+ ### GitHub Domain: Direct API access
478
478
  ```bash
479
479
  magmascript gh workflows # all workflow statuses
480
480
  magmascript gh trigger "Deploy to Pi" # trigger workflow
@@ -483,7 +483,7 @@ magmascript gh file path/to/file.txt # read file
483
483
  magmascript gh sync # diff + commit all data files
484
484
  ```
485
485
 
486
- ### Scores Domain — Game high scores
486
+ ### Scores Domain: Game high scores
487
487
  ```bash
488
488
  magmascript scores list # all game leaderboards
489
489
  magmascript scores get tetris # tetris scores
@@ -492,57 +492,56 @@ magmascript scores report --discord # Discord JSON payload
492
492
  magmascript scores reset tetris # reset one game (backup created)
493
493
  ```
494
494
 
495
- ### Archive Domain — Archive page operations
495
+ ### Archive Domain: Archive page operations
496
496
  ```bash
497
497
  magmascript archive check-format # validate HTML formatting
498
- magmascript archive bake-cache # inline MusicBrainz cache into pages
499
498
  magmascript archive generate-stubs # generate stub HTML for new entities
500
499
  ```
501
500
 
502
- ### MusicBrainz Domain — MusicBrainz API client
501
+ ### MusicBrainz Domain: MusicBrainz API client
503
502
  ```bash
504
503
  magmascript mb backup # full MusicBrainz backup
505
504
  magmascript mb backup --dry-run # preview backup
506
505
  magmascript mb backup --stale-only # only refresh stale caches
507
506
  ```
508
507
 
509
- ### Last.fm Domain — Last.fm API client
508
+ ### Last.fm Domain: Last.fm API client
510
509
  ```bash
511
510
  magmascript lastfm fetch # fetch play counts
512
511
  magmascript lastfm fetch --skip-existing # skip cached artists
513
512
  ```
514
513
 
515
- ### Search Domain — Site search index builder
514
+ ### Search Domain: Site search index builder
516
515
  ```bash
517
516
  magmascript search build-index # build search-index.json
518
517
  magmascript search preview 10 # preview first 10 entries
519
518
  ```
520
519
 
521
- ### Rights Domain — Music rights metadata (ISRC, ISWC, ASCAP)
520
+ ### Rights Domain: Music rights metadata (ISRC, ISWC, ASCAP)
522
521
  ```bash
523
522
  magmascript rights search "Farewell" # search by title, ISRC, ISWC, or ASCAP ID
524
523
  magmascript rights catalog "C.P. Rutledge" # full rights catalog for an artist
525
524
  magmascript rights export # TSV export for ASCAP forms
526
525
  ```
527
526
 
528
- ### Media Domain — Multi-provider media search
527
+ ### Media Domain: Multi-provider media search
529
528
  ```bash
530
529
  magmascript media search "sunset" # search all providers
531
530
  magmascript media providers # list available providers
532
531
  ```
533
532
 
534
- ### Cache Domain — Cache management
533
+ ### Cache Domain: Cache management
535
534
  ```bash
536
535
  magmascript cache stats # show cache statistics
537
536
  magmascript cache clear # clear all cache
538
537
  ```
539
538
 
540
- ### Magma — System status dashboard
539
+ ### Magma: System status dashboard
541
540
  ```bash
542
541
  magmascript magma # version, domains, cache stats
543
542
  ```
544
543
 
545
- ### Crunch — Batch pipeline
544
+ ### Crunch: Batch pipeline
546
545
  ```bash
547
546
  magmascript crunch mb # MusicBrainz backup
548
547
  magmascript crunch lastfm # Last.fm fetch
@@ -553,7 +552,7 @@ magmascript crunch gh # GitHub sync
553
552
  magmascript crunch all # Run all targets
554
553
  ```
555
554
 
556
- ### Texas — Full/heavy operation (same targets, no shortcuts)
555
+ ### Texas: Full/heavy operation (same targets, no shortcuts)
557
556
  ```bash
558
557
  magmascript texas mb # Full MusicBrainz backup
559
558
  magmascript texas lastfm # Full Last.fm fetch
@@ -564,7 +563,7 @@ magmascript texas gh # Full GitHub sync
564
563
  magmascript texas all # Full heavy run
565
564
  ```
566
565
 
567
- ### Toast — Burn/clear caches
566
+ ### Toast: Burn/clear caches
568
567
  ```bash
569
568
  magmascript toast cache # Clear general cache
570
569
  magmascript toast mb-cache # Clear MusicBrainz cache
@@ -601,7 +600,7 @@ g = tt.game({"title": "hello", "width": 400, "height": 300})
601
600
 
602
601
  A package may register the same class under several names this way; nothing
603
602
  stops it, and the clients stay independent. Note that none of this touches the
604
- `magmascript toast` CLI verb, which still clears caches — registry domains are
603
+ `magmascript toast` CLI verb, which still clears caches, registry domains are
605
604
  not dispatched as subcommands.
606
605
 
607
606
  ## Python Library
@@ -1,4 +1,4 @@
1
- """magmascript — a scripting toolkit with domain-first subcommands."""
1
+ """magmascript: a scripting toolkit with domain-first subcommands."""
2
2
 
3
3
  # The version lives in pyproject.toml alone. It was also a literal here, and the
4
4
  # two drifted: 3.2.3 shipped reporting itself as 3.2.2, in the REPL banner and
@@ -279,7 +279,7 @@ Options:
279
279
 
280
280
 
281
281
  def usage():
282
- print("""magmascript — scripting toolkit with domain-first subcommands
282
+ print("""magmascript, scripting toolkit with domain-first subcommands
283
283
 
284
284
  Usage:
285
285
  magmascript <script.mgs> [args...] Run a MagmaScript file directly
@@ -385,7 +385,6 @@ Rights:
385
385
 
386
386
  Archive:
387
387
  check-format Validate archive HTML formatting
388
- bake-cache [--dry-run] Inlines MusicBrainz cache into HTML pages
389
388
  generate-stubs Generate stub HTML for new archive entities
390
389
 
391
390
  MusicBrainz:
@@ -1119,7 +1118,7 @@ def _dispatch_scores(action: str, args: list[str], client, fmt: str):
1119
1118
  else:
1120
1119
  # Generate markdown report
1121
1120
  report = client.report()
1122
- lines = [f"# Weekly High Scores — {report.generated_at}", ""]
1121
+ lines = [f"# Weekly High Scores: {report.generated_at}", ""]
1123
1122
  lines.append("## Leaderboards")
1124
1123
  lines.append("")
1125
1124
  for board in report.scoreboards:
@@ -1166,7 +1165,7 @@ def _dispatch_scores(action: str, args: list[str], client, fmt: str):
1166
1165
  gh = GHClient(config)
1167
1166
  try:
1168
1167
  date = datetime.now().strftime("%Y-%m-%d")
1169
- title = f"Weekly High Scores — {date}"
1168
+ title = f"Weekly High Scores: {date}"
1170
1169
  result = gh.create_discussion(title, markdown, "high-scores")
1171
1170
  print(result)
1172
1171
  finally:
@@ -1335,8 +1334,6 @@ def _dispatch_archive(action: str, args: list[str], client, fmt: str):
1335
1334
 
1336
1335
  Usage:
1337
1336
  magmascript archive check-format Validate archive HTML formatting
1338
- magmascript archive bake-cache Inlines MusicBrainz cache into HTML pages
1339
- magmascript archive bake-cache --dry-run Preview changes without writing
1340
1337
  magmascript archive generate-stubs Generate stub HTML for new archive entities
1341
1338
  """)
1342
1339
  sys.exit(0)
@@ -1356,20 +1353,6 @@ Usage:
1356
1353
  if warnings:
1357
1354
  sys.exit(1)
1358
1355
 
1359
- elif action == "bake-cache":
1360
- dry_run = "--dry-run" in args
1361
- result = client.bake_cache(dry_run=dry_run)
1362
- if fmt == "json":
1363
- print(json.dumps({"baked": result.baked, "skipped": result.skipped, "errors": result.errors}, indent=2))
1364
- else:
1365
- print(f"\nDone! {result.baked} pages baked, {result.skipped} skipped.")
1366
- if dry_run:
1367
- print("(dry run — no files were written)")
1368
- if result.errors:
1369
- print(f"\nErrors:")
1370
- for err in result.errors:
1371
- print(f" {err}")
1372
-
1373
1356
  elif action == "generate-stubs":
1374
1357
  result = client.generate_stubs()
1375
1358
  if fmt == "json":
@@ -1708,7 +1691,7 @@ Usage:
1708
1691
 
1709
1692
 
1710
1693
  def _dispatch_magma(action: str, fmt: str):
1711
- """Dispatch magma subcommands — system status dashboard."""
1694
+ """Dispatch magma subcommands: system status dashboard."""
1712
1695
  from magmascript.core.commands import magma
1713
1696
 
1714
1697
  if not action or action == "--help":
@@ -1752,7 +1735,7 @@ def _format_size(size_bytes: int) -> str:
1752
1735
 
1753
1736
 
1754
1737
  def _dispatch_crunch(action: str, args: list[str], fmt: str):
1755
- """Dispatch crunch subcommands — pipeline runner."""
1738
+ """Dispatch crunch subcommands: pipeline runner."""
1756
1739
  from magmascript.core.commands import crunch, CrunchResult
1757
1740
 
1758
1741
  if not action or action == "--help":
@@ -1766,7 +1749,6 @@ Targets:
1766
1749
  mb MusicBrainz backup
1767
1750
  lastfm Last.fm play count fetch
1768
1751
  search Search index rebuild
1769
- archive Bake MB cache into HTML stubs
1770
1752
  scores Generate scores report
1771
1753
  gh Diff + commit local vs GitHub
1772
1754
  all Run all pipelines sequentially
@@ -1785,7 +1767,7 @@ Targets:
1785
1767
 
1786
1768
 
1787
1769
  def _dispatch_texas(action: str, args: list[str], fmt: str):
1788
- """Dispatch texas subcommands — full/heavy operations."""
1770
+ """Dispatch texas subcommands: full/heavy operations."""
1789
1771
  from magmascript.core.commands import texas
1790
1772
 
1791
1773
  if not action or action == "--help":
@@ -1798,8 +1780,8 @@ Usage:
1798
1780
  Targets:
1799
1781
  mb Full MB backup (no skip-existing, no stale-only)
1800
1782
  lastfm Full Last.fm fetch (no skip-existing)
1801
- search Search index rebuild + archive bake
1802
- archive Full pipeline: stubs -> bake -> format check
1783
+ search Search index rebuild
1784
+ archive Full pipeline: stubs -> format check
1803
1785
  scores Full report (post to Discussion + Discord)
1804
1786
  gh Full sync with custom message
1805
1787
  all Everything, no shortcuts
@@ -1818,7 +1800,7 @@ Targets:
1818
1800
 
1819
1801
 
1820
1802
  def _dispatch_toast(action: str, args: list[str], fmt: str):
1821
- """Dispatch toast subcommands — burn/clear caches."""
1803
+ """Dispatch toast subcommands: burn/clear caches."""
1822
1804
  from magmascript.core.commands import toast
1823
1805
 
1824
1806
  if not action or action == "--help":
@@ -1,4 +1,4 @@
1
- """Core commands — magma, crunch, texas, toast."""
1
+ """Core commands: magma, crunch, texas, toast."""
2
2
 
3
3
  from __future__ import annotations
4
4
 
@@ -88,8 +88,6 @@ def crunch(target: str, *, dry_run: bool = False) -> CrunchResult:
88
88
  return _crunch_lastfm(dry_run=dry_run)
89
89
  elif target == "search":
90
90
  return _crunch_search()
91
- elif target == "archive":
92
- return _crunch_archive(dry_run=dry_run)
93
91
  elif target == "scores":
94
92
  return _crunch_scores()
95
93
  elif target == "gh":
@@ -97,7 +95,7 @@ def crunch(target: str, *, dry_run: bool = False) -> CrunchResult:
97
95
  elif target == "all":
98
96
  return _crunch_all(dry_run=dry_run)
99
97
  else:
100
- raise ValueError(f"Unknown crunch target: {target!r}. Available: mb, lastfm, search, archive, scores, gh, all")
98
+ raise ValueError(f"Unknown crunch target: {target!r}. Available: mb, lastfm, search, scores, gh, all")
101
99
 
102
100
 
103
101
  def _crunch_mb(*, dry_run: bool = False) -> CrunchResult:
@@ -148,20 +146,6 @@ def _crunch_search() -> CrunchResult:
148
146
  )
149
147
 
150
148
 
151
- def _crunch_archive(*, dry_run: bool = False) -> CrunchResult:
152
- from magmascript.domains.archive import ArchiveClient
153
-
154
- root = _get_project_root()
155
- client = ArchiveClient(project_root=root)
156
- result = client.bake_cache(dry_run=dry_run)
157
- return CrunchResult(
158
- target="archive",
159
- completed=result.baked,
160
- skipped=result.skipped,
161
- errors=result.errors,
162
- )
163
-
164
-
165
149
  def _crunch_scores() -> CrunchResult:
166
150
  from magmascript.domains.scores import ScoresClient
167
151
 
@@ -191,7 +175,7 @@ def _crunch_gh(*, dry_run: bool = False) -> CrunchResult:
191
175
 
192
176
 
193
177
  def _crunch_all(*, dry_run: bool = False) -> CrunchResult:
194
- targets = ["mb", "lastfm", "archive", "search", "gh"]
178
+ targets = ["mb", "lastfm", "search", "gh"]
195
179
  total_completed = 0
196
180
  total_errors: list[str] = []
197
181
 
@@ -266,25 +250,15 @@ def _texas_lastfm(*, dry_run: bool = False) -> CrunchResult:
266
250
 
267
251
  def _texas_search(*, dry_run: bool = False) -> CrunchResult:
268
252
  from magmascript.domains.search import SearchClient
269
- from magmascript.domains.archive import ArchiveClient
270
-
271
- root = _get_project_root()
272
-
273
- search_client = SearchClient(project_root=root)
274
- search_result = search_client.build()
275
253
 
276
- archive_client = ArchiveClient(project_root=root)
277
- bake_result = archive_client.bake_cache(dry_run=dry_run)
254
+ search_result = SearchClient(project_root=_get_project_root()).build()
278
255
 
279
256
  return CrunchResult(
280
257
  target="search",
281
- completed=search_result.total_entries + bake_result.baked,
282
- skipped=bake_result.skipped,
283
- errors=bake_result.errors,
258
+ completed=search_result.total_entries,
284
259
  details={
285
260
  "search_entries": search_result.total_entries,
286
261
  "deduplicated": search_result.deduplicated,
287
- "baked": bake_result.baked,
288
262
  },
289
263
  )
290
264
 
@@ -295,15 +269,14 @@ def _texas_archive(*, dry_run: bool = False) -> CrunchResult:
295
269
  root = _get_project_root()
296
270
  client = ArchiveClient(project_root=root)
297
271
 
272
+ # No bake step: archive pages fetch archive/_cache at load time, and the
273
+ # website's CI refuses a page carrying an inline copy (retired 2026-10-18).
298
274
  stubs = client.generate_stubs()
299
- bake = client.bake_cache(dry_run=dry_run)
300
275
  fmt = client.check_format()
301
276
 
302
277
  return CrunchResult(
303
278
  target="archive",
304
- completed=bake.baked,
305
- skipped=bake.skipped,
306
- errors=bake.errors + (fmt.get("warnings", []) if isinstance(fmt, dict) else []),
279
+ errors=fmt.get("warnings", []) if isinstance(fmt, dict) else [],
307
280
  details={"stubs": stubs, "format_warnings": fmt},
308
281
  )
309
282
 
@@ -11,7 +11,7 @@ from pathlib import Path
11
11
 
12
12
 
13
13
  # The MCP server is a public endpoint, so it stays a usable default. SSH
14
- # host/user defaults are intentionally empty — a fresh install must be told
14
+ # host/user defaults are intentionally empty: a fresh install must be told
15
15
  # which machines to reach rather than probing someone else's network.
16
16
  DEFAULT_MCP_URL = "https://magmacrunch.duckdns.org/mcp"
17
17
  CONFIG_DIR = Path.home() / ".config" / "magmascript"
@@ -1,4 +1,4 @@
1
- """Shared GitHub API client — used by the gh domain and potentially other domains."""
1
+ """Shared GitHub API client: used by the gh domain and potentially other domains."""
2
2
 
3
3
  from __future__ import annotations
4
4
 
@@ -17,7 +17,6 @@ WORKFLOWS: dict[str, str] = {
17
17
  "Check Pi Services": "check-services.yml",
18
18
  "Rebuild Search Index": "rebuild-search-index.yml",
19
19
  "Generate Archive Stubs": "generate-stubs.yml",
20
- "Bake Cache": "bake-cache.yml",
21
20
  "Weekly High Scores": "weekly-scores.yml",
22
21
  "Arcade Smoke Test": "smoke-test.yml",
23
22
  "MusicBrainz Backup": "backup-musicbrainz.yml",
@@ -1,4 +1,4 @@
1
- """Module registry — domains register themselves here for CLI and DSL discovery."""
1
+ """Module registry: domains register themselves here for CLI and DSL discovery."""
2
2
 
3
3
  from __future__ import annotations
4
4