oasr 0.5.1__tar.gz → 0.6.0__tar.gz

{oasr-0.5.1 → oasr-0.6.0}/CHANGELOG.md

@@ -4,6 +4,75 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-02-03
+
+### Added
+- **🧭 Profile selection command** — New `oasr profile` command with interactive selector or explicit profile selection.
+- **📄 Profile file support** — Auto-load `~/.oasr/profile/*.toml` profiles with inline config overrides.
+- **🔧 Config subcommands** — `oasr config agent|validation|adapter|oasr|profiles` for focused views.
+- **✅ Config validation and reference** — `oasr config validate` and `oasr config man` helpers.
+- **Default profiles** — New built-ins: `strict`, `dev`, `unsafe`.
+
+### Changed
+- **Profiles subsystem** — New `profiles` subpackage with loaders, validation, and summary helpers.
+- **Config listing** — Lists profiles with compact capability summaries and completions setting.
+
+### Documentation
+- **Config + profile docs** — Updated configuration guides and new `docs/commands/PROFILE.md`.
+
+## [0.5.2] - 2026-02-02
+
+### Added
+- **⌨️ Shell Completion Support** — Intelligent tab completion for all major shells
+  - Cross-platform support: Bash, Zsh, Fish, PowerShell
+  - `oasr completion install` — Auto-detect shell and install completions
+  - `oasr completion <shell>` — Output completion script for specific shell
+  - Dynamic completions: skill names, agents, profiles fetched live from registry
+  - Command, subcommand, and flag completion for all OASR commands
+  - Smart shell detection (platform + $SHELL environment variable)
+  - Installation paths: `~/.bash_completion.d/`, `~/.zsh/completion/`, `~/.config/fish/completions/`, `~/.config/powershell/`
+  - Backup mechanism: existing completions backed up before overwrite
+  - `--force` and `--dry-run` flags for installation control
+  - `oasr completion uninstall` — Remove installed completions
+  - Configuration support: `oasr.completions` config option
+- **🧪 Comprehensive E2E Tests** — 16 new end-to-end tests covering all commands
+  - Registry subcommands (list, sync, prune)
+  - Diff, sync, info, validate, clean commands
+  - Adapter, find, help commands
+  - Total test count: 282 tests (all passing)
+  - Ensures no regressions in existing functionality
+- **⚠️ Exec Unsafe Pass-through** — Optional unsafe mode forwarding for agent CLIs
+  - `oasr exec --unsafe` forwards `--skip-git-repo-check` to Codex
+  - `oasr exec --unsafe` forwards `--dangerously-skip-permissions` to Claude
+  - Unsupported agents (Copilot/OpenCode) emit a warning with guidance
+
+### Documentation
+- **[docs/commands/COMPLETION.md](docs/commands/COMPLETION.md)**: Complete completion command reference
+  - Installation instructions for all shells
+  - Shell-specific configuration notes
+  - Troubleshooting guide
+  - Examples and usage patterns
+- **[README.md](README.md)**: Added Shell Completions section with quickstart
+- **[docs/commands/.INDEX.md](docs/commands/.INDEX.md)**: Added completion to command index
+- **[docs/commands/EXEC.md](docs/commands/EXEC.md)**: Documented `--unsafe` and trusted directory guidance
+
+### Technical
+- **New module**: `src/commands/completion.py` (259 lines) with shell detection and installation
+- **Completion scripts**: 4 shell-specific scripts (~691 lines total)
+  - `src/completions/bash.sh` (197 lines)
+  - `src/completions/zsh.sh` (259 lines) with descriptions
+  - `src/completions/fish.fish` (120 lines) with native Fish syntax
+  - `src/completions/powershell.ps1` (115 lines) with ArgumentCompleter
+- **45 new tests**: 29 completion tests + 16 E2E tests
+- **Dynamic completion**: Scripts invoke `oasr` commands for live data (registry list, config keys)
+- **Cross-platform**: Handles Windows, macOS, Linux path conventions
+
+### Quality of Life
+- Tab completion reduces typing and prevents typos
+- Discovery: see available skills, agents, and profiles at your fingertips
+- Professional UX: OASR now feels like a polished CLI tool
+- Backward compatible: no changes to existing commands
+
 ## [0.5.1] - 2026-02-02
 
 ### Added

{oasr-0.5.1 → oasr-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oasr
-Version: 0.5.1
+Version: 0.6.0
 Summary: CLI for managing agent skills across IDE integrations
 Project-URL: Homepage, https://github.com/jgodau/asr
 Project-URL: Repository, https://github.com/jgodau/asr
@@ -210,6 +210,7 @@ Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Python: >=3.10
 Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.0.1
 Requires-Dist: tomli-w>=1.0.0
 Requires-Dist: tomli>=2.0.0; python_version < '3.11'
 Provides-Extra: dev
@@ -219,7 +220,7 @@ Description-Content-Type: text/markdown
 
 # OASR
 
-**Open Agent Skill Registry** — Manage reusable AI agent skills across IDEs without drift.
+**Open Agent Skill Registry** — Register, sync, and reuse AI agent skills across IDEs with a single source of truth.
 
 ---
 
@@ -229,16 +230,22 @@ You've built useful skills for your AI coding assistant. They work great in Curs
 
 Each tool expects skills in different locations with different formats:
 
-- Cursor: `.cursor/skills/`
-- Windsurf: `.windsurf/skills/`
+- Cursor: `.cursor/commands/`
+- Windsurf: `.windsurf/workflows/`
 - Claude: `.claude/commands/`
-- Copilot: `.github/.md`
+- Copilot: `.github/prompts/`
 
 So you copy your skills everywhere. Then you improve one. Now the copies are stale. You forget which version is current. Some break silently. This is **skill drift**.
 
 ## The Solution
 
-ASR keeps your skills in one place and generates thin adapters for each IDE.
+ASR keeps your skills in a registry, syncs local and remote sources, and generates thin adapters for each IDE.
+It also lets you execute skills safely with policy profiles.
+
+Key capabilities:
+- Register skills once (local folders or GitHub/GitLab URLs)
+- Sync and track drift across sources
+- Generate IDE adapters and run skills via `oasr exec`
 
 ```text
 ┌─────────────────────────────────────────────────────────┐
@@ -267,12 +274,15 @@ No copying. No drift. One source of truth.
 
 ```bash
 # Register local skills
-oasr add ~/skills/git-commit
-oasr add ~/skills/code-review
+oasr registry add ~/skills/git-commit
+oasr registry add ~/skills/code-review
+
+# List registered skills
+oasr registry list
 
 # Register remote skills from GitHub/GitLab
-oasr add https://github.com/user/skills-repo/tree/main/my-skill
-oasr add https://gitlab.com/org/project/tree/main/cool-skill
+oasr registry add https://github.com/user/skills-repo/tree/main/my-skill
+oasr registry add https://gitlab.com/org/project/tree/main/cool-skill
 
 # Generate adapters for a project
 oasr adapter --output-dir ~/projects/my-app
@@ -294,16 +304,16 @@ ASR supports registering skills directly from GitHub and GitLab repositories:
 
 ```bash
 # Add a skill from GitHub
-oasr add https://github.com/user/repo/tree/main/skills/my-skill
+oasr registry add https://github.com/user/repo/tree/main/skills/my-skill
 
 # Add a skill from GitLab
-oasr add https://gitlab.com/org/project/tree/dev/cool-skill
+oasr registry add https://gitlab.com/org/project/tree/dev/cool-skill
 
 # Sync remote skills (check for updates)
-oasr sync
+oasr registry sync
 
 # Use remote skills
-oasr use my-skill -d ./output
+oasr clone my-skill -d ./output
 ```
 
 **Authentication** (optional, for private repos and higher rate limits):
@@ -313,7 +323,27 @@ export GITHUB_TOKEN=ghp_your_token_here
 export GITLAB_TOKEN=glpat_your_token_here
 ```
 
-Remote skills are fetched on-demand during `adapter` and `use` operations. The registry stores the URL, and `sync` checks if the remote source has changed.
+Remote skills are fetched on-demand during `adapter` and `clone` operations. The registry stores the URL, and `oasr registry sync` checks if the remote source has changed.
+
+---
+
+## Shell Completions
+
+OASR supports intelligent tab completion for Bash, Zsh, Fish, and PowerShell:
+
+```bash
+# Install for your current shell
+oasr completion install
+
+# Now try it:
+oasr <TAB>          # Complete commands
+oasr info <TAB>     # Complete skill names
+oasr exec --<TAB>   # Complete flags
+```
+
+Completions are **dynamic** — skill names, agents, and profiles are fetched live from your registry.
+
+See [`oasr completion --help`](docs/commands/COMPLETION.md) for details.
 
 ---
 
@@ -325,7 +355,7 @@ Remote skills are fetched on-demand during `adapter` and `use` operations. The r
 
 ---
 
-## Supported `asr adapter` IDEs
+## Supported `oasr adapter` IDEs
 
 | IDE            | Adapter    | Output                        |
 |----------------|------------|-------------------------------|
@@ -347,11 +377,11 @@ See [LICENSE](LICENSE).
 
 | Command | Screenshot |
 |---------|-----------|
-| **oasr list** | ![list](docs/.images/list.png) |
-| **oasr add** (local) | ![add](docs/.images/add.png) |
-| **oasr add** (remote) | ![add-remote](docs/.images/add-remote.png) |
-| **oasr sync** | ![sync](docs/.images/sync.png) |
-| **oasr status** | ![status](docs/.images/status.png) |
+| **oasr registry list** | ![list](docs/.images/list.png) |
+| **oasr registry add** (local) | ![add](docs/.images/add.png) |
+| **oasr registry add** (remote) | ![add-remote](docs/.images/add-remote.png) |
+| **oasr registry sync** | ![sync](docs/.images/sync.png) |
+| **oasr registry -v** | ![status](docs/.images/status.png) |
 | **oasr find** | ![find](docs/.images/find.png) |
 | **oasr adapter** | ![adapter](docs/.images/adapter.png) |
 

{oasr-0.5.1 → oasr-0.6.0}/README.md

@@ -1,6 +1,6 @@
 # OASR
 
-**Open Agent Skill Registry** — Manage reusable AI agent skills across IDEs without drift.
+**Open Agent Skill Registry** — Register, sync, and reuse AI agent skills across IDEs with a single source of truth.
 
 ---
 
@@ -10,16 +10,22 @@ You've built useful skills for your AI coding assistant. They work great in Curs
 
 Each tool expects skills in different locations with different formats:
 
-- Cursor: `.cursor/skills/`
-- Windsurf: `.windsurf/skills/`
+- Cursor: `.cursor/commands/`
+- Windsurf: `.windsurf/workflows/`
 - Claude: `.claude/commands/`
-- Copilot: `.github/.md`
+- Copilot: `.github/prompts/`
 
 So you copy your skills everywhere. Then you improve one. Now the copies are stale. You forget which version is current. Some break silently. This is **skill drift**.
 
 ## The Solution
 
-ASR keeps your skills in one place and generates thin adapters for each IDE.
+ASR keeps your skills in a registry, syncs local and remote sources, and generates thin adapters for each IDE.
+It also lets you execute skills safely with policy profiles.
+
+Key capabilities:
+- Register skills once (local folders or GitHub/GitLab URLs)
+- Sync and track drift across sources
+- Generate IDE adapters and run skills via `oasr exec`
 
 ```text
 ┌─────────────────────────────────────────────────────────┐
@@ -48,12 +54,15 @@ No copying. No drift. One source of truth.
 
 ```bash
 # Register local skills
-oasr add ~/skills/git-commit
-oasr add ~/skills/code-review
+oasr registry add ~/skills/git-commit
+oasr registry add ~/skills/code-review
+
+# List registered skills
+oasr registry list
 
 # Register remote skills from GitHub/GitLab
-oasr add https://github.com/user/skills-repo/tree/main/my-skill
-oasr add https://gitlab.com/org/project/tree/main/cool-skill
+oasr registry add https://github.com/user/skills-repo/tree/main/my-skill
+oasr registry add https://gitlab.com/org/project/tree/main/cool-skill
 
 # Generate adapters for a project
 oasr adapter --output-dir ~/projects/my-app
@@ -75,16 +84,16 @@ ASR supports registering skills directly from GitHub and GitLab repositories:
 
 ```bash
 # Add a skill from GitHub
-oasr add https://github.com/user/repo/tree/main/skills/my-skill
+oasr registry add https://github.com/user/repo/tree/main/skills/my-skill
 
 # Add a skill from GitLab
-oasr add https://gitlab.com/org/project/tree/dev/cool-skill
+oasr registry add https://gitlab.com/org/project/tree/dev/cool-skill
 
 # Sync remote skills (check for updates)
-oasr sync
+oasr registry sync
 
 # Use remote skills
-oasr use my-skill -d ./output
+oasr clone my-skill -d ./output
 ```
 
 **Authentication** (optional, for private repos and higher rate limits):
@@ -94,7 +103,27 @@ export GITHUB_TOKEN=ghp_your_token_here
 export GITLAB_TOKEN=glpat_your_token_here
 ```
 
-Remote skills are fetched on-demand during `adapter` and `use` operations. The registry stores the URL, and `sync` checks if the remote source has changed.
+Remote skills are fetched on-demand during `adapter` and `clone` operations. The registry stores the URL, and `oasr registry sync` checks if the remote source has changed.
+
+---
+
+## Shell Completions
+
+OASR supports intelligent tab completion for Bash, Zsh, Fish, and PowerShell:
+
+```bash
+# Install for your current shell
+oasr completion install
+
+# Now try it:
+oasr <TAB>          # Complete commands
+oasr info <TAB>     # Complete skill names
+oasr exec --<TAB>   # Complete flags
+```
+
+Completions are **dynamic** — skill names, agents, and profiles are fetched live from your registry.
+
+See [`oasr completion --help`](docs/commands/COMPLETION.md) for details.
 
 ---
 
@@ -106,7 +135,7 @@ Remote skills are fetched on-demand during `adapter` and `use` operations. The r
 
 ---
 
-## Supported `asr adapter` IDEs
+## Supported `oasr adapter` IDEs
 
 | IDE            | Adapter    | Output                        |
 |----------------|------------|-------------------------------|
@@ -128,11 +157,11 @@ See [LICENSE](LICENSE).
 
 | Command | Screenshot |
 |---------|-----------|
-| **oasr list** | ![list](docs/.images/list.png) |
-| **oasr add** (local) | ![add](docs/.images/add.png) |
-| **oasr add** (remote) | ![add-remote](docs/.images/add-remote.png) |
-| **oasr sync** | ![sync](docs/.images/sync.png) |
-| **oasr status** | ![status](docs/.images/status.png) |
+| **oasr registry list** | ![list](docs/.images/list.png) |
+| **oasr registry add** (local) | ![add](docs/.images/add.png) |
+| **oasr registry add** (remote) | ![add-remote](docs/.images/add-remote.png) |
+| **oasr registry sync** | ![sync](docs/.images/sync.png) |
+| **oasr registry -v** | ![status](docs/.images/status.png) |
 | **oasr find** | ![find](docs/.images/find.png) |
 | **oasr adapter** | ![adapter](docs/.images/adapter.png) |
 

{oasr-0.5.1 → oasr-0.6.0}/docs/commands/.INDEX.md

@@ -7,8 +7,10 @@
 - [oasr diff](DIFF.md) - Show status of tracked skills
 - [oasr sync](SYNC.md) - Refresh outdated tracked skills
 - [oasr config](CONFIG.md) - Manage configuration (NEW in v0.4.0)
+- [oasr profile](PROFILE.md) - Select execution profile (NEW in v0.6.0)
 - [oasr clone](CLONE.md) - Clone skill(s) to target directory (NEW in v0.4.0)
 - [oasr exec](EXEC.md) - Execute skills as CLI tools (NEW in v0.4.0)
+- [oasr completion](COMPLETION.md) - Shell tab completion (NEW in v0.6.0)
 - [oasr find](FIND.md) - Find/discover skills in your file system
 - [oasr validate](VALIDATE.md) - Validate a skill
 - [oasr adapter](ADAPTER.md) - Generate IDE/Tooling adapters

{oasr-0.5.1 → oasr-0.6.0}/docs/commands/CLONE.md

@@ -11,6 +11,7 @@ Clone skills from the registry to a target directory. Supports glob patterns and
 oasr clone skill-name
 oasr clone skill-name -d /path/to/project
 oasr clone "git-*"                    # Glob pattern
+oasr clone "*"                        # Clone all skills (quote to avoid shell expansion)
 oasr clone skill-one skill-two        # Multiple skills
 ```
 
@@ -28,8 +29,11 @@ Clone multiple skills matching a pattern:
 ```bash
 oasr clone "python-*"     # All Python-related skills
 oasr clone "*-api"        # All API-related skills
+oasr clone "*"            # All skills in registry
 ```
 
+> **Note:** Always quote `*` or glob patterns to prevent your shell from expanding them before OASR receives the pattern.
+
 ### Remote Skill Fetching
 
 Remote skills are automatically fetched during clone: