@angelmsger/fx 0.13.0 → 0.15.0

package/skills/fx-workspace/references/commands.md

@@ -339,8 +339,9 @@ copies. Foreign replacements require confirmation and backup. Uninstall removes
 recognized copies after confirmation (`--yes` for noninteractive execution), keeps
 foreign paths and leaves agent selection unchanged; later sync can reinstall a copy.
 
-`skill install/uninstall` return collection rows with `action`, `status`, `version`
-and target fields. Status is `planned` for previews; execution distinguishes
+`skill install/update/uninstall` return collection rows with `action`, `status`,
+`version` and target fields; update's `action` is `refresh` for an older copy and
+`skip` for every other target. Status is `planned` for previews; execution distinguishes
 `installed`, `removed`, `not_installed`, `foreign`, `skipped`, `failed` and
 `not_started`. On interruption, stdout retains the partial collection with each
 row's `observed` state and failure envelope; stderr preserves the original error.
@@ -409,7 +410,11 @@ available `failure` and `next_steps` fields.
 After resolving the blocker, repeat the same invocation: setup verifies current
 state before rerunning actions. Parse stdout on a nonzero exit whenever it is
 present. `self update` also captures installer output so its stdout remains
-parseable; inspect the returned installer `code`.
+parseable; inspect the returned installer `code`, and `skill_refresh` for the new
+installation's refresh of this Skill. `tool install/update` rows add `skill`:
+`installed`, `planned`, `failed`, `not_started` (an earlier Skill command could not
+start; the error's partial result keeps these rows), `blocked` (awaiting approval) or
+`none`.
 
 Retain the original task, repository/environment and readiness query while
 repairing prerequisites. Authorization already given in this session persists;

package/skills/fx-workspace/references/workspace-tasks.md

@@ -122,7 +122,7 @@ stand in for `fx`; `self update` cannot repair an entry that cannot execute.
 | Find service diagnostics                   | `fx where <repo> --env <env>`                                                            |
 | Check tools/access                         | `fx can <capability-or-tool>`; `fx doctor --tool <tool>`                                 |
 | Inspect repository release criteria        | `fx release check <repo> --only merge --details`                                         |
-| Install/update a companion                 | `fx tool install <tool> --dry-run`; `fx tool update <tool> --dry-run`                    |
+| Install/update a companion and its Skill   | `fx tool install <tool> --dry-run`; `fx tool update <tool>\|--all --dry-run`             |
 | Review tool provenance                     | `fx tool history [tool]`; `fx tool inventory`                                            |
 | Inspect host resources                     | `fx agent skills`; `fx hook list`; `fx mcp list/show`                                    |
 | Inspect declarations                       | `fx manifest validate --strict`; `fx manifest explain '<path>'`; `fx manifest providers` |
@@ -160,6 +160,9 @@ It never checks out, resets, stashes, merges or rebases. Dirty or diverged work
 reported as `skip_dirty` / `skip_diverged`; inspect repository and resource outcomes.
 An empty upstream is skipped with outcome `empty_remote`; one lacking the tracked branch
 is skipped with `no_remote_branch` and still blocks readiness. Neither is a failure.
+An update that would replace local untracked or ignored files (for example `.env`) is
+skipped with `local_files_in_the_way`, lists them in `files_in_the_way` and blocks
+readiness; ask before moving them aside.
 
 The workspace root is a plain directory. Do not initialize or run Git there.
 Write output that belongs to no repository under `.workbench/` as the derived
@@ -215,5 +218,5 @@ native context conflicts and scoped login.
 `self info` reports the Registry fx updates from and its `registry_source`;
 [update notices](commands.md#update-notices) explains how it is chosen.
 `FX_OUTDATED` and `MANIFEST_OUTDATED` are advisory. Update within the user's scope,
-then rediscover the running version and read its bundled Skill. `fx skill install`
-refreshes installed copies explicitly.
+then rediscover the running version and read its bundled Skill. `fx self update`
+refreshes the installed copies of this Skill; `fx skill update` does so on its own.