sf-aidev 1.0.0

package/messages/aidev.list.md

@@ -0,0 +1,92 @@
+# summary
+
+List all AI development artifacts in your project.
+
+# description
+
+Display a unified view of all agents, skills, prompts, and instruction files. Artifacts are grouped by type with checkboxes indicating installation status:
+
+- Checked box (checked) - artifact exists locally
+- Unchecked box (unchecked) - artifact is available from source but not installed
+
+In interactive mode (TTY), use arrow keys to navigate and Escape to exit. Press Enter on an artifact to toggle its inline description display - the description will be fetched from the source and shown in grey below the item.
+
+Merges artifacts found locally with those available from configured source repositories.
+
+# flags.source.summary
+
+Filter available artifacts by source repository.
+
+# examples
+
+- List all artifacts:
+
+  <%= config.bin %> <%= command.id %>
+
+- List artifacts from a specific source:
+
+  <%= config.bin %> <%= command.id %> --source owner/repo
+
+- Get JSON output:
+
+  <%= config.bin %> <%= command.id %> --json
+
+# prompt.Select
+
+Select an artifact (use arrow keys, Enter to select, Escape to exit):
+
+# prompt.Action
+
+Select an action:
+
+# info.Installing
+
+Installing "%s"...
+
+# info.Installed
+
+Successfully installed "%s" to %s.
+
+# info.Removing
+
+Removing "%s"...
+
+# info.Removed
+
+Successfully removed "%s".
+
+# info.CannotInstallInstruction
+
+Instruction files cannot be installed from sources. Create them manually in your project.
+
+# info.CannotRemoveInstruction
+
+Instruction files are managed manually. Delete the file directly if you want to remove it.
+
+# warning.SourceFailed
+
+Failed to fetch artifacts from source "%s": %s
+
+# warning.InstallFailed
+
+Failed to install "%s": %s
+
+# warning.RemoveFailed
+
+Failed to remove "%s": %s
+
+# info.FetchingDetails
+
+Fetching artifact details from source...
+
+# info.NoSourceForDetails
+
+No source repository configured for this artifact.
+
+# warning.FailedToFetchDetails
+
+Could not fetch artifact details: %s
+
+# info.NoArtifacts
+
+No artifacts found. Add a source repository with 'sf aidev source add' to see available artifacts.

package/messages/aidev.list.skills.md

@@ -0,0 +1,76 @@
+# summary
+
+List skill artifacts in your project.
+
+# description
+
+Display all skills with checkboxes indicating installation status:
+
+- Checked box (checked) - skill exists locally
+- Unchecked box (unchecked) - skill is available from source but not installed
+
+In interactive mode (TTY), use arrow keys to navigate, Enter to select, and Escape to exit.
+
+Merges skills found locally with those available from configured source repositories.
+
+# flags.source.summary
+
+Filter available skills by source repository.
+
+# examples
+
+- List all skills:
+
+  <%= config.bin %> <%= command.id %>
+
+- List skills from a specific source:
+
+  <%= config.bin %> <%= command.id %> --source owner/repo
+
+- Get JSON output:
+
+  <%= config.bin %> <%= command.id %> --json
+
+# prompt.Select
+
+Select a skill (use arrow keys, Enter to select, Escape to exit):
+
+# info.NoSkills
+
+No skills found.
+
+# info.Installing
+
+Installing "%s"...
+
+# info.Installed
+
+Successfully installed "%s" to %s.
+
+# info.Removing
+
+Removing "%s"...
+
+# info.Removed
+
+Successfully removed "%s".
+
+# warning.SourceFailed
+
+Failed to fetch skills from source "%s": %s
+
+# warning.InstallFailed
+
+Failed to install "%s": %s
+
+# warning.RemoveFailed
+
+Failed to remove "%s": %s
+
+# info.FetchingDetails
+
+Fetching skill details from source...
+
+# warning.FailedToFetchDetails
+
+Could not fetch skill details: %s

package/messages/aidev.remove.agent.md

@@ -0,0 +1,45 @@
+# summary
+
+Remove an installed agent.
+
+# description
+
+Remove a previously installed agent from your project. The agent files will be deleted and unregistered from the sf-aidev configuration. By default, a confirmation prompt is shown before removal.
+
+# flags.name.summary
+
+Name of the agent to remove.
+
+# flags.no-prompt.summary
+
+Skip the confirmation prompt.
+
+# examples
+
+- Remove an agent named "my-agent":
+
+  <%= config.bin %> <%= command.id %> --name my-agent
+
+- Remove without confirmation:
+
+  <%= config.bin %> <%= command.id %> --name my-agent --no-prompt
+
+# prompt.ConfirmRemove
+
+Are you sure you want to remove agent "%s"?
+
+# error.NotInstalled
+
+Agent "%s" is not installed.
+
+# error.RemoveFailed
+
+Failed to remove agent "%s": %s
+
+# info.AgentRemoved
+
+Successfully removed agent "%s".
+
+# info.Cancelled
+
+Removal cancelled.

package/messages/aidev.remove.command.md

@@ -0,0 +1,45 @@
+# summary
+
+Remove an installed command.
+
+# description
+
+Remove a command that was previously installed. By default, prompts for confirmation before removing. Use --no-prompt to skip the confirmation.
+
+# flags.name.summary
+
+Name of the command to remove.
+
+# flags.no-prompt.summary
+
+Skip confirmation prompt before removing.
+
+# examples
+
+- Remove a command:
+
+  <%= config.bin %> <%= command.id %> --name my-command
+
+- Remove without confirmation:
+
+  <%= config.bin %> <%= command.id %> --name my-command --no-prompt
+
+# error.NotInstalled
+
+Command "%s" is not installed.
+
+# error.RemoveFailed
+
+Failed to remove command "%s": %s
+
+# info.CommandRemoved
+
+Successfully removed command "%s"
+
+# info.Cancelled
+
+Command removal cancelled.
+
+# prompt.ConfirmRemove
+
+Are you sure you want to remove command "%s"?

package/messages/aidev.remove.md

@@ -0,0 +1,57 @@
+# summary
+
+Interactively select and remove installed artifacts.
+
+# description
+
+Browse all installed artifacts grouped by category (Agents, Skills, Prompts) and select multiple items to remove at once. This command requires an interactive terminal; for non-interactive use, use the subcommands: `sf aidev remove skill --name X`, `sf aidev remove agent --name X`, or `sf aidev remove prompt --name X`.
+
+# flags.no-prompt.summary
+
+Disable interactive mode. This flag is not supported for the parent command; use subcommands instead.
+
+# examples
+
+- Interactively select artifacts to remove:
+
+  <%= config.bin %> <%= command.id %>
+
+# prompt.Select
+
+Select artifacts to remove (use Space to select, Enter to confirm, Escape to cancel):
+
+# prompt.Confirm
+
+Remove %s artifact(s)? This action cannot be undone.
+
+# error.NonInteractive
+
+This command requires an interactive terminal.
+
+# error.NonInteractiveActions
+
+Use subcommands for non-interactive mode: `sf aidev remove skill --name X`, `sf aidev remove agent --name X`, or `sf aidev remove prompt --name X`.
+
+# info.NoArtifacts
+
+No installed artifacts found.
+
+# info.NoneSelected
+
+No artifacts selected for removal.
+
+# info.Cancelled
+
+Removal cancelled.
+
+# info.Removing
+
+Removing %s artifact(s)...
+
+# info.Removed
+
+Successfully removed %s artifact(s):
+
+# warning.Failed
+
+Failed to remove %s artifact(s):

package/messages/aidev.remove.prompt.md

@@ -0,0 +1,45 @@
+# summary
+
+Remove an installed prompt.
+
+# description
+
+Remove a previously installed prompt from your project. The prompt file will be deleted and unregistered from the sf-aidev configuration. By default, a confirmation prompt is shown before removal.
+
+# flags.name.summary
+
+Name of the prompt to remove.
+
+# flags.no-prompt.summary
+
+Skip the confirmation prompt.
+
+# examples
+
+- Remove a prompt named "my-prompt":
+
+  <%= config.bin %> <%= command.id %> --name my-prompt
+
+- Remove without confirmation:
+
+  <%= config.bin %> <%= command.id %> --name my-prompt --no-prompt
+
+# prompt.ConfirmRemove
+
+Are you sure you want to remove prompt "%s"?
+
+# error.NotInstalled
+
+Prompt "%s" is not installed.
+
+# error.RemoveFailed
+
+Failed to remove prompt "%s": %s
+
+# info.PromptRemoved
+
+Successfully removed prompt "%s".
+
+# info.Cancelled
+
+Removal cancelled.

package/messages/aidev.remove.skill.md

@@ -0,0 +1,45 @@
+# summary
+
+Remove an installed skill.
+
+# description
+
+Remove a previously installed skill from your project. The skill file will be deleted and unregistered from the sf-aidev configuration. By default, a confirmation prompt is shown before removal.
+
+# flags.name.summary
+
+Name of the skill to remove.
+
+# flags.no-prompt.summary
+
+Skip the confirmation prompt.
+
+# examples
+
+- Remove a skill named "my-skill":
+
+  <%= config.bin %> <%= command.id %> --name my-skill
+
+- Remove without confirmation:
+
+  <%= config.bin %> <%= command.id %> --name my-skill --no-prompt
+
+# prompt.ConfirmRemove
+
+Are you sure you want to remove skill "%s"?
+
+# error.NotInstalled
+
+Skill "%s" is not installed.
+
+# error.RemoveFailed
+
+Failed to remove skill "%s": %s
+
+# info.SkillRemoved
+
+Successfully removed skill "%s".
+
+# info.Cancelled
+
+Removal cancelled.

package/messages/aidev.source.add.md

@@ -0,0 +1,65 @@
+# summary
+
+Add a new source repository.
+
+# description
+
+Adds a new GitHub repository as a source for AI artifacts. The repository should contain a `manifest.json` file at the root. If no manifest is found, the CLI will attempt to auto-discover artifacts from well-known paths (e.g., `.claude/`, `.github/`, `agents/`, `skills/`, `prompts/`).
+
+# args.repo.summary
+
+GitHub repository in owner/repo format.
+
+# flags.repo.summary
+
+GitHub repository in owner/repo format.
+
+# flags.set-default.summary
+
+Set this source as the default.
+
+# examples
+
+- Add a new source repository:
+
+  <%= config.bin %> <%= command.id %> owner/repo
+
+- Add a source and set it as default:
+
+  <%= config.bin %> <%= command.id %> owner/repo --set-default
+
+- Using the --repo flag (alternative syntax):
+
+  <%= config.bin %> <%= command.id %> --repo owner/repo
+
+# error.InvalidRepoFormat
+
+Invalid repository format "%s". Use owner/repo format.
+
+# error.SourceAlreadyExists
+
+Source repository "%s" is already configured.
+
+# error.ManifestNotFound
+
+Could not find a valid manifest in repository "%s". Ensure the repository contains a manifest.json file.
+
+# info.SourceAdded
+
+Successfully added source "%s" with %s artifacts available.
+
+# info.SetAsDefault
+
+Source "%s" has been set as the default.
+
+# error.RepoRequired
+
+Repository is required. Provide it as a positional argument or use the --repo flag.
+
+# info.AutoDiscovered
+
+No manifest.json found in "%s". Auto-discovered %s artifacts from well-known paths.
+
+# error.NoArtifactsDiscovered
+
+No manifest.json found and no artifacts discovered in well-known paths in repository "%s".

package/messages/aidev.source.list.md

@@ -0,0 +1,21 @@
+# summary
+
+List all configured source repositories.
+
+# description
+
+Lists all source repositories configured for artifact installation. Shows the repository name, whether it is the default source, and when it was added.
+
+# examples
+
+- List all configured sources:
+
+  <%= config.bin %> <%= command.id %>
+
+- List sources with JSON output:
+
+  <%= config.bin %> <%= command.id %> --json
+
+# info.NoSources
+
+No source repositories configured. Use "sf aidev source add --repo <owner/repo>" to add one.

package/messages/aidev.source.refresh.md

@@ -0,0 +1,71 @@
+# summary
+
+Refresh cached manifests for source repositories.
+
+# description
+
+Re-fetches manifests from configured source repositories and updates the local disk cache. For repositories without a manifest.json, re-runs auto-discovery to find artifacts in well-known paths.
+
+Use this command when source repositories have been updated and you want to fetch the latest artifact information without removing and re-adding the source.
+
+# args.repo.summary
+
+GitHub repository in owner/repo format to refresh. If omitted, refreshes all configured sources.
+
+# flags.repo.summary
+
+GitHub repository in owner/repo format to refresh.
+
+# examples
+
+- Refresh all configured sources:
+
+  <%= config.bin %> <%= command.id %>
+
+- Refresh a specific source:
+
+  <%= config.bin %> <%= command.id %> owner/repo
+
+- Using the --repo flag:
+
+  <%= config.bin %> <%= command.id %> --repo owner/repo
+
+# error.RepoNotConfigured
+
+Source repository "%s" is not configured. Add it first with `sf aidev source add`.
+
+# error.NoSourcesConfigured
+
+No source repositories configured. Add one with `sf aidev source add owner/repo`.
+
+# info.RefreshingAll
+
+Refreshing %s source repositories...
+
+# info.RefreshingSingle
+
+Refreshing manifest for "%s"...
+
+# info.RefreshSuccess
+
+Successfully refreshed "%s" - %s artifacts found.
+
+# info.RefreshSuccessAutoDiscovered
+
+Successfully refreshed "%s" - %s artifacts auto-discovered from well-known paths.
+
+# info.RefreshFailed
+
+Failed to refresh "%s": %s
+
+# info.Summary
+
+Refreshed %s of %s sources successfully.
+
+# info.CacheStale
+
+Cache for "%s" is stale (older than 1 week).
+
+# info.NoChanges
+
+No changes detected in "%s".

package/messages/aidev.source.remove.md

@@ -0,0 +1,57 @@
+# summary
+
+Remove a configured source repository.
+
+# description
+
+Removes a source repository from the configuration. If the source is currently set as the default, a new default will be automatically selected from the remaining sources.
+
+# args.repo.summary
+
+GitHub repository in owner/repo format to remove.
+
+# flags.repo.summary
+
+GitHub repository in owner/repo format to remove.
+
+# flags.no-prompt.summary
+
+Skip the confirmation prompt.
+
+# examples
+
+- Remove a source repository:
+
+  <%= config.bin %> <%= command.id %> owner/repo
+
+- Remove without confirmation:
+
+  <%= config.bin %> <%= command.id %> owner/repo --no-prompt
+
+- Using the --repo flag (alternative syntax):
+
+  <%= config.bin %> <%= command.id %> --repo owner/repo
+
+# error.SourceNotFound
+
+Source repository "%s" is not configured.
+
+# prompt.ConfirmRemove
+
+Are you sure you want to remove source "%s"?
+
+# info.Cancelled
+
+Operation cancelled.
+
+# info.SourceRemoved
+
+Successfully removed source "%s".
+
+# info.NewDefaultSet
+
+Source "%s" is now set as the default.
+
+# error.RepoRequired
+
+Repository is required. Provide it as a positional argument or use the --repo flag.

package/messages/aidev.source.set-default.md

@@ -0,0 +1,41 @@
+# summary
+
+Set a source repository as the default.
+
+# description
+
+Sets the specified source repository as the default for artifact installation. The source must already be configured.
+
+# args.repo.summary
+
+GitHub repository in owner/repo format to set as default.
+
+# flags.repo.summary
+
+GitHub repository in owner/repo format to set as default.
+
+# examples
+
+- Set a source as the default:
+
+  <%= config.bin %> <%= command.id %> owner/repo
+
+- Using the --repo flag (alternative syntax):
+
+  <%= config.bin %> <%= command.id %> --repo owner/repo
+
+- Using short flag:
+
+  <%= config.bin %> <%= command.id %> -r owner/repo
+
+# error.SourceNotConfigured
+
+Source repository "%s" is not configured. Add it first with "sf aidev source add".
+
+# info.DefaultSet
+
+Source "%s" is now set as the default.
+
+# error.RepoRequired
+
+Repository is required. Provide it as a positional argument or use the --repo flag.

package/messages/messages.json

@@ -0,0 +1,3 @@
+{
+  "commands": {}
+}