Skip to content

plurigrid/asi / ies/music-topos/.opencode/skill/tailscale-file-transfer

tailscale-file-transfer

Verified

Tailscale mesh VPN file transfer with open games semantics (play/coplay) and bidirectional lens optics

FileKindSize
INSTALL.mdmarkdown6.6 KB
README.mdmarkdown4.2 KB
SKILL.mdskill md8.9 KB
# Tailscale File Transfer Skill

**Status**: ✅ Production Ready
**Framework**: Jules Hedges' Compositional Game Theory
**Language**: Ruby (HedgesOpenGames module)
**Integration**: Amp, Codex, Music-Topos CRDT
**Trit**: +1 (Covariant - receiver perspective)

## Quick Start

```ruby
require 'tailscale_file_transfer'

# Create skill
skill = TailscaleFileTransferSkill.new

# Send file to collaborator
result = skill.play(
  file_path: "learned_model.jl",
  recipient: "alice@coplay",
  strategy: :parallel
)

# Receive acknowledgment
ack = skill.coplay(
  transfer_id: result[:transfer_id],
  delivered: true,
  bytes_received: result[:bytes_sent],
  transfer_time: result[:transfer_time]
)

puts "Transfer complete. Utility: #{ack[:utility]}"
```

## Files in This Directory

| File | Purpose |
|------|---------|
| `SKILL.md` | Skill registration (frontmatter + documentation) |
| `INSTALL.md` | Installation guide for amp, codex, music-topos |
| `README.md` | This file - quick overview |

## Installation

### For Amp
```bash
cp /Users/bob/ies/music-topos/lib/tailscale_file_transfer_skill.rb \
  ~/.local/share/amp/skills/
```

### For Codex
```bash
cp /Users/bob/ies/music-topos/lib/tailscale_file_transfer_skill.rb \
  ~/.topos/codex/codex-rs/core/src/skills/
```

### For Music-Topos
Already located at: `lib/tailscale_file_transfer_skill.rb`

## Key Features

- **Bidirectional Lens Optics**: Play (forward) + coplay (backward) semantics
- **Three Transfer Strategies**: sequential, parallel, adaptive
- **Mesh Network Discovery**: Automatic Tailscale peer discovery
- **Utility Scoring**: Quality bonuses for speed and completeness
- **Open Games Composition**: Compose with verification, payment, encryption games
- **GF(3) Trit Semantics**: Covariant (+1) for receiver perspective

## Performance

| Metric | Value |
|--------|-------|
| Sequential Throughput | 1706 KB/s |
| Parallel Throughput | 1706 KB/s (4 threads) |
| Adaptive Throughput | 538 KB/s (dynamic) |
| Test Coverage | 5 scenarios, 100% passing |
| Code Size | 576 lines (production) + 540+ (documentation) |

## Integration Points

**With HedgesOpenGames**:
- Lens-based bidirectional optics
- Composition operators (>> and *)
- Strategy space and utility functions

**With Music-Topos**:
- Transfer learned PLR color models
- Distribute harmonic analysis for CRDT merge
- Broadcast to multiple collaborators

**With SplitMixTernary**:
- Seed-based deterministic network simulation
- GF(3) trit generation

## Verify Installation

```bash
cd /Users/bob/ies/music-topos
ruby lib/tailscale_file_transfer_skill.rb
# Output: ✓ All tests completed
```

## Documentation

For detailed information, see:
- `INSTALL.md` - Installation and setup
- `TAILSCALE_SKILL_DOCUMENTATION.md` - Complete API reference
- `TAILSCALE_SKILL_QUICKREF.md` - Quick reference guide

## Common Use Cases

### 1. Share Learned Models
```ruby
skill.play(file_path: "network.jl", recipient: "collaborator@coplay", strategy: :parallel)
```

### 2. Distribute Analysis Results
```ruby
peers.each do |peer|
  skill.play(file_path: "analysis.json", recipient: "#{peer}@coplay")
end
```

### 3. Compose with Verification
```ruby
game = skill.create_open_game
verify_game = create_verification_game
composed = skill.compose_with_other_game(verify_game, composition_type: :sequential)
```

### 4. Monitor Transfer Stats
```ruby
stats = skill.transfer_stats
puts "Success Rate: #{stats[:success_rate]}%"
puts "Avg Throughput: #{stats[:average_throughput_kbps]} KB/s"
```

## Requirements

- Ruby 2.7+
- Tailscale installed and running
- hedges_open_games.rb (included)
- splitmix_ternary.rb (included)

## Support

For issues or questions:
1. Check `INSTALL.md` troubleshooting section
2. Review `TAILSCALE_SKILL_QUICKREF.md` common patterns
3. Run test suite: `ruby lib/tailscale_file_transfer_skill.rb`
4. Check transfer log: `skill.transfer_history.inspect`

## Contributing

To improve this skill:
1. Fork music-topos repository
2. Make changes to `lib/tailscale_file_transfer_skill.rb`
3. Run tests: `ruby lib/tailscale_file_transfer_skill.rb`
4. Update documentation
5. Submit pull request

## License

Part of music-topos project. See LICENSE file.

---

**Last Updated**: 2025-12-21
**Version**: 1.0 (Production)
**Status**: Ready for Deployment ✅
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall