Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@

## Safety invariants

- Preview is the default. Remote writes require the explicit `-Apply` switch.
- Preview is the default. Remote writes require the explicit `-apply` switch. Parameter names are case-insensitive; `-Apply` is the same switch.
- Default preview and `-apply` write instruction files only. A `codexConfig` block is inert until `-settings` is passed. `-settings` previews or applies the semantic Codex projection and must not copy instruction files in the same run.
- `-init` may write only a local starter config. It never connects or changes a remote host, and it must not overwrite an existing config.
- Destination paths remain relative to the remote user's home directory. Reject absolute paths, drive-qualified paths, empty segments, and `..` traversal.
- Stage every payload before replacing any destination.
- Fence each replacement with the hash observed during preview. A changed destination must fail closed.
Expand All @@ -20,7 +22,7 @@
## Development

- Use PowerShell 7.2 or newer.
- Keep `Sync-AgentGuidance` as the only public command unless a new public surface has a clear operator need.
- Keep `Sync-AgentGuidance` as the only public command unless a new public surface has a clear operator need. `ag-sync` is an allowed alias of that command, not a second engine.
- Verify harness paths and precedence against current first-party documentation before changing compatibility claims or examples.
- Run `pwsh -NoProfile -File tests/Test-AgentGuidanceSync.ps1` after behavior changes.
- Tests must cover configuration validation and transaction failure paths, not only the happy path.
Expand Down
6 changes: 3 additions & 3 deletions AgentGuidanceSync/AgentGuidanceSync.psd1
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
@{
RootModule = 'AgentGuidanceSync.psm1'
ModuleVersion = '0.3.2'
ModuleVersion = '0.4.0'
GUID = 'e20e5784-ce55-49dc-be7d-a8f0ef648664'
Author = 'Austin Arlt'
Copyright = '(c) 2026 Austin Arlt. Licensed under the MIT License.'
Expand All @@ -10,11 +10,11 @@
FunctionsToExport = @('Sync-AgentGuidance')
CmdletsToExport = @()
VariablesToExport = @()
AliasesToExport = @()
AliasesToExport = @('ag-sync')

PrivateData = @{
PSData = @{
Tags = @('Codex', 'Claude', 'Pi', 'OhMyPi', 'OpenCode', 'SSH', 'Configuration', 'PowerShell')
Tags = @('Codex', 'Claude', 'Grok', 'Pi', 'OhMyPi', 'OpenCode', 'SSH', 'Configuration', 'PowerShell')
LicenseUri = 'https://opensource.org/license/mit'
}
}
Expand Down
Loading