@mboucher/ffe-setup 0.1.0 → 0.1.2

package/README.md

@@ -10,7 +10,7 @@ remain separate.
 After the skill and setup packages are published to npm, run:
 
 ```sh
-npx @mboucher/ffe-setup --client vscode
+npx @mboucher/ffe-setup
 ```
 
 Setup checks Node.js, npm, and `az version` before installing anything. Missing
@@ -31,23 +31,30 @@ Only an explicit yes starts the CLI's secure Adobe credential flow, with termina
 input/output inherited directly. Setup does not collect or store credentials.
 Declining, passing `--no-login`, or running without a TTY prints `ffe auth login`
 for later instead. A failed or cancelled login exits unsuccessfully but leaves
-the installation in place. Azure storage authentication is separate: run
-`az login` before storage commands. No Azure login runs automatically.
+the installation in place. Cloud storage authentication is separate: use
+`az login` for Azure, or your AWS CLI credential/SSO flow for S3. Neither cloud
+login runs automatically.
 
 For automated installs, skip the login prompt explicitly:
 
 ```sh
-npx @mboucher/ffe-setup --client vscode --no-login
+npx @mboucher/ffe-setup --no-login
 ```
 
 To install only the portable skill without checking Azure CLI or installing FFE:
 
 ```sh
-npx @mboucher/ffe-setup --client vscode --skill-only
+npx @mboucher/ffe-setup --skill-only
 ```
 
-The default is workspace scope in the current directory. Choose a different
-project or install for your user explicitly:
+The skill is installed globally for your user at
+`~/.agents/skills/ffe-template-validation-skill`. No client selection is required,
+and the installation is shared across projects. Assistants must support discovery
+from `~/.agents/skills`; for assistants that do not, use an explicit client or
+`--skills-dir` override.
+
+Optional client-specific destinations remain available. When `--client` is
+explicitly supplied, workspace scope in the current directory remains the default:
 
 ```sh
 npx @mboucher/ffe-setup --client vscode --workspace /path/to/project
@@ -73,6 +80,27 @@ Reload skill discovery in your assistant after installation. No skill is
 installed merely by adding this npm package as a dependency; installation is an
 explicit command, not a `postinstall` side effect.
 
+## Storage Providers
+
+The installed CLI supports Azure Blob Storage and AWS S3. The validation skill
+asks which provider to use before a local PSD upload, unless already selected
+for that validation. Its optional MCP `ffe_storage_providers` tool returns
+guidance; the harness asks the question. Upload/job authorization is separate.
+
+Full setup currently always validates Azure CLI and does not install or validate
+AWS CLI. For an AWS-only environment without Azure CLI, install AWS CLI and FFE
+CLI separately, then run `npx @mboucher/ffe-setup --skill-only`. Configure cloud
+credentials in the local CLI, not in chat. Existing URLs or supplied manifests
+do not require a storage-provider choice.
+
+```sh
+ffe storage upload ./document.psd --provider aws --bucket my-inputs --region us-east-1 --aws-profile production
+```
+
+The skill's Markdown and HTML reports use absolute file links. Report generation
+and provider prompting belong to the skill, not the setup command. Setup does
+not register MCP or generate reports; reload skill/tool discovery after updates.
+
 ## Existing Installations
 
 The installer copies the skill entry point, references, README, and license.
@@ -92,8 +120,9 @@ node bin/run.js --help
 ```
 
 `dev:link` links the sibling `ffe-template-validation-skill` package without
-changing dependency specifications. To try the installer locally, use
-`node bin/run.js --client vscode --workspace /path/to/project`.
+changing dependency specifications. `node bin/run.js --skill-only` installs into
+your global skills directory. For an isolated trial, use
+`node bin/run.js --skills-dir /path/to/test/skills --skill-only`.
 
 Tests install into temporary directories, not your personal skills directory.
 They cover metadata discovery, destination selection, complete copies,
@@ -103,8 +132,9 @@ install global packages or start real authentication.
 
 ## Release
 
-Publish `@mboucher/ffe-template-validation-skill` 0.1.0 first. Then, from this
-repository:
+Publish a skill version compatible with the setup package's declared dependency
+range first. Increment versions for new releases; published npm versions cannot
+be overwritten. Then, from this repository:
 
 ```sh
 npm install

package/bin/run.js

@@ -14,7 +14,7 @@ try {
     help: {type: 'boolean', short: 'h'},
   }, allowPositionals: false})
   if (values.help) {
-    console.log('Usage: ffe-setup --client vscode|claude-code [--scope workspace|user] [--workspace PATH]\n       ffe-setup --skills-dir PATH\n\nChecks Node.js 22.13+, npm, and Azure CLI, installs FFE CLI globally and the\nvalidation skill, then offers to run "ffe auth login" in interactive terminals.\nWorkspace scope is the default. Does not install Azure CLI or register MCP.\n\nOptions:\n  --skill-only  Install only the skill; skip external tools and authentication.\n  --no-login    Install normally without prompting for Adobe login.')
+    console.log('Usage: ffe-setup [--skill-only] [--no-login]\n       ffe-setup --client vscode|claude-code [--scope workspace|user] [--workspace PATH]\n       ffe-setup --skills-dir PATH\n\nChecks Node.js 22.13+, npm, and Azure CLI, installs FFE CLI globally and the\nvalidation skill, then offers to run "ffe auth login" in interactive terminals.\nThe skill is installed globally to ~/.agents/skills by default; no client is required.\nExplicit --client options retain their workspace default.\nDoes not install Azure CLI or register MCP.\n\nOptions:\n  --skill-only  Install only the skill; skip external tools and authentication.\n  --no-login    Install normally without prompting for Adobe login.')
   } else {
     const directory = skillsDirectory({
       client: values.client, scope: values.scope, workspace: values.workspace, skillsDir: values['skills-dir'],

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mboucher/ffe-setup",
-    "version": "0.1.0",
+    "version": "0.1.2",
     "description": "Dependency validation, FFE CLI installation, and portable skill setup",
     "license": "MIT",
     "type": "module",

package/src/install-skill.js

@@ -5,13 +5,19 @@ import {fileURLToPath} from 'node:url'
 
 export const SKILL_NAME = 'ffe-template-validation-skill'
 
-export function skillsDirectory({client, scope, workspace, skillsDir, home = homedir()}) {
+export function skillsDirectory({client, scope, workspace, skillsDir, home = homedir()} = {}) {
   if (skillsDir !== undefined) {
     if (!skillsDir.trim() || client !== undefined || scope !== undefined || workspace !== undefined) {
       throw new Error('Use --skills-dir PATH alone, without --client, --scope, or --workspace.')
     }
     return resolve(skillsDir)
   }
+  if (client === undefined) {
+    if (workspace !== undefined || (scope !== undefined && scope !== 'user')) {
+      throw new Error('Global installation is the default. Specify --client for --workspace or --scope workspace.')
+    }
+    return join(home, '.agents', 'skills')
+  }
   if (!['vscode', 'claude-code'].includes(client)) {
     throw new Error('Select --client vscode or --client claude-code, or supply --skills-dir PATH.')
   }