@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/ports/cluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../../src/ports/cluster.ts"],"names":[],"mappings":"AAAA,oEAAoE"}

package/dist/ports/code-host.js

@@ -0,0 +1,6 @@
+// Where repositories live. fx never talks to a code host's API itself; a provider drives
+// the host's own CLI. Readability has four states, and the query methods are read-only
+// and no wider than `release` needs: branches, a range between two of them, one commit,
+// one file at a ref.
+export {};
+//# sourceMappingURL=code-host.js.map

package/dist/ports/code-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-host.js","sourceRoot":"","sources":["../../src/ports/code-host.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,uFAAuF;AACvF,wFAAwF;AACxF,qBAAqB"}

package/dist/ports/contribution-git.js

@@ -0,0 +1,4 @@
+// Contribution Git has a private-index write surface, separate from sync. It
+// constructs a named branch without checkout, merge or changes to the real index.
+export {};
+//# sourceMappingURL=contribution-git.js.map

package/dist/ports/contribution-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-git.js","sourceRoot":"","sources":["../../src/ports/contribution-git.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,kFAAkF"}

package/dist/ports/contribution-store.js

@@ -0,0 +1,4 @@
+// One workspace's contribution journal is replaced atomically while the
+// application holds its workspace/source leases. Absence is an empty journal.
+export {};
+//# sourceMappingURL=contribution-store.js.map

package/dist/ports/contribution-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-store.js","sourceRoot":"","sources":["../../src/ports/contribution-store.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,8EAA8E"}

package/dist/ports/contribution-transport.js

@@ -0,0 +1,4 @@
+// Source transport accepts an already verified personal-fork identity, then
+// rechecks local routing before asking or pushing one managed branch.
+export {};
+//# sourceMappingURL=contribution-transport.js.map

package/dist/ports/contribution-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution-transport.js","sourceRoot":"","sources":["../../src/ports/contribution-transport.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,sEAAsE"}

package/dist/ports/diagnostics.js

@@ -0,0 +1,4 @@
+// Structured diagnostic events cross layer boundaries through this port;
+// producers know neither output format nor whether verbose output is enabled.
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/ports/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/ports/diagnostics.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8EAA8E"}

package/dist/ports/error-tracker.js

@@ -0,0 +1,4 @@
+// Where runtime errors are collected: a platform that can also list what
+// is still unresolved in a project. `release` asks it that, and nothing else.
+export {};
+//# sourceMappingURL=error-tracker.js.map

package/dist/ports/error-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracker.js","sourceRoot":"","sources":["../../src/ports/error-tracker.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,8EAA8E"}

package/dist/ports/fs.js

@@ -0,0 +1,5 @@
+// The slice of a file system the use cases need: text and binary files,
+// directory copies and existence. An absent file reads as undefined rather than throwing, so
+// "optional document" is a plain branch, not an exception.
+export {};
+//# sourceMappingURL=fs.js.map

package/dist/ports/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/ports/fs.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6FAA6F;AAC7F,2DAA2D"}

package/dist/ports/git.js

@@ -0,0 +1,6 @@
+// Git as sync and status need it, and nothing more: there is deliberately no checkout,
+// reset, stash, rebase or merge here, so "sync never destroys work" holds at the type
+// level. A fast-forward on the checked-out branch is the one merge that can happen, and
+// only when the tree is clean; on any other branch only the branch ref moves.
+export {};
+//# sourceMappingURL=git.js.map

package/dist/ports/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/ports/git.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,sFAAsF;AACtF,wFAAwF;AACxF,8EAA8E"}

package/dist/ports/harness-state.js

@@ -0,0 +1,4 @@
+// Projection ownership survives process interruption independently of native
+// files. The caller holds the workspace lease around read/plan/write sequences.
+export {};
+//# sourceMappingURL=harness-state.js.map

package/dist/ports/harness-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-state.js","sourceRoot":"","sources":["../../src/ports/harness-state.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF"}

package/dist/ports/hook-handler.js

@@ -0,0 +1,4 @@
+// Event handlers own their scheduling policy and status description. Dispatch
+// owns validation and transport, so adding an event does not add a host branch.
+export {};
+//# sourceMappingURL=hook-handler.js.map

package/dist/ports/hook-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-handler.js","sourceRoot":"","sources":["../../src/ports/hook-handler.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF"}

package/dist/ports/hook-protocol.js

@@ -0,0 +1,4 @@
+// A host codec plans text without touching disk or running commands. The
+// caller owns locks, trust, posture and persistence for every host format.
+export {};
+//# sourceMappingURL=hook-protocol.js.map

package/dist/ports/hook-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-protocol.js","sourceRoot":"","sources":["../../src/ports/hook-protocol.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E"}

package/dist/ports/hook-state.js

@@ -0,0 +1,4 @@
+// Ownership and automatic-sync observations stay on the machine and are
+// excluded from exported profiles. Callers serialize compound updates.
+export {};
+//# sourceMappingURL=hook-state.js.map

package/dist/ports/hook-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-state.js","sourceRoot":"","sources":["../../src/ports/hook-state.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,uEAAuE"}

package/dist/ports/hook-tasks.js

@@ -0,0 +1,4 @@
+// Only the registered session-start background task can be launched. A
+// manifest command can never become a supervisor task or bypass its trust gate.
+export {};
+//# sourceMappingURL=hook-tasks.js.map

package/dist/ports/hook-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tasks.js","sourceRoot":"","sources":["../../src/ports/hook-tasks.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,gFAAgF"}

package/dist/ports/identifiers.js

@@ -0,0 +1,4 @@
+// Opaque operation identifiers keep branch allocation independent of time and
+// make allocation deterministic in decision tests.
+export {};
+//# sourceMappingURL=identifiers.js.map

package/dist/ports/identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../../src/ports/identifiers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mDAAmD"}

package/dist/ports/installer.js

@@ -0,0 +1,5 @@
+// How a companion tool gets onto the machine. An installer only assembles the vector;
+// running it is the use case's decision, after the dry-run and posture checks every
+// write goes through.
+export {};
+//# sourceMappingURL=installer.js.map

package/dist/ports/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/ports/installer.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,oFAAoF;AACpF,sBAAsB"}

package/dist/ports/lifecycle-runner.js

@@ -0,0 +1,4 @@
+// Supervised lifecycle workers return only a complete bounded payload.
+// A failed worker is an empty answer rather than a failed host session.
+export {};
+//# sourceMappingURL=lifecycle-runner.js.map

package/dist/ports/lifecycle-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-runner.js","sourceRoot":"","sources":["../../src/ports/lifecycle-runner.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE"}

package/dist/ports/lock.js

@@ -0,0 +1,4 @@
+// A lease serializes a resource across processes. A bounded unsuccessful
+// acquisition is a value, allowing lifecycle callers to skip rather than wait.
+export {};
+//# sourceMappingURL=lock.js.map

package/dist/ports/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/ports/lock.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+EAA+E"}

package/dist/ports/log-store.js

@@ -0,0 +1,3 @@
+// Where logs are searched.
+export {};
+//# sourceMappingURL=log-store.js.map

package/dist/ports/log-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-store.js","sourceRoot":"","sources":["../../src/ports/log-store.ts"],"names":[],"mappings":"AAAA,2BAA2B"}

package/dist/ports/manifest-source.js

@@ -0,0 +1,5 @@
+// Where a workspace's manifest comes from: a git repository, a directory whose files are
+// copied, or text on stdin. It is materialized into the workspace's source directory
+// under ~/.fx, never into the root. Only a repository source can refresh itself later.
+export {};
+//# sourceMappingURL=manifest-source.js.map

package/dist/ports/manifest-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-source.js","sourceRoot":"","sources":["../../src/ports/manifest-source.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qFAAqF;AACrF,uFAAuF"}

package/dist/ports/mcp-codec.js

@@ -0,0 +1,4 @@
+// Codecs transform one native entry with explicit prior ownership evidence.
+// A digest identifies only the entry bytes, never the surrounding user document.
+export {};
+//# sourceMappingURL=mcp-codec.js.map

package/dist/ports/mcp-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-codec.js","sourceRoot":"","sources":["../../src/ports/mcp-codec.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iFAAiF"}

package/dist/ports/metrics.js

@@ -0,0 +1,3 @@
+// Where service metrics are queried.
+export {};
+//# sourceMappingURL=metrics.js.map

package/dist/ports/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/ports/metrics.ts"],"names":[],"mappings":"AAAA,qCAAqC"}

package/dist/ports/platform.js

@@ -0,0 +1,5 @@
+// A platform instance from environments.yaml, alive: it turns the merged
+// variables of one environment into a coordinate. Each environment-scoped
+// capability names its own port so the registry can type them apart.
+export {};
+//# sourceMappingURL=platform.js.map

package/dist/ports/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/ports/platform.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,qEAAqE"}

package/dist/ports/process.js

@@ -0,0 +1,5 @@
+// The only way anything in fx starts a subprocess. Vectors go straight to
+// the executable as arguments. Windows batch shims require an adapter-owned
+// interpreter with escaping; callers cannot request raw shell evaluation.
+export {};
+//# sourceMappingURL=process.js.map

package/dist/ports/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/ports/process.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E"}

package/dist/ports/projection.js

@@ -0,0 +1,4 @@
+// Managed files are observed before planning and rechecked at application.
+// Foreign includes links and directories: a codec only receives regular text.
+export {};
+//# sourceMappingURL=projection.js.map

package/dist/ports/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/ports/projection.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E"}

package/dist/ports/prompter.js

@@ -0,0 +1,5 @@
+// Asking a person something. Every method fails with INPUT_REQUIRED instead of hanging
+// when there is no person to ask, so a use case can ask freely and an agent still gets a
+// structured answer.
+export {};
+//# sourceMappingURL=prompter.js.map

package/dist/ports/prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompter.js","sourceRoot":"","sources":["../../src/ports/prompter.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,yFAAyF;AACzF,qBAAqB"}

package/dist/ports/provider.js

@@ -0,0 +1,6 @@
+// A provider is one implementation of a capability's port plus what fx needs to know to
+// wire it: the facts a manifest is read against, the tools it drives, the variables the
+// manifest must supply, and the setup steps it brings. Every adapter directory exports one
+// descriptor; the registry collects them.
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/ports/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ports/provider.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wFAAwF;AACxF,2FAA2F;AAC3F,0CAA0C"}

package/dist/ports/registry.js

@@ -0,0 +1,5 @@
+// The configured package registry, asked one thing: the newest
+// released version of a package. Any failure is thrown; the caller decides
+// how quiet to be about it.
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/ports/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/ports/registry.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2EAA2E;AAC3E,4BAA4B"}

package/dist/ports/replace-files.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=replace-files.js.map

package/dist/ports/replace-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-files.js","sourceRoot":"","sources":["../../src/ports/replace-files.ts"],"names":[],"mappings":""}

package/dist/ports/reporter.js

@@ -0,0 +1,3 @@
+// Format-independent workflow notices and progress events.
+export {};
+//# sourceMappingURL=reporter.js.map

package/dist/ports/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/ports/reporter.ts"],"names":[],"mappings":"AAAA,2DAA2D"}

package/dist/ports/service-protocol.js

@@ -0,0 +1,4 @@
+// Decode a companion's public service plan without exposing its response format
+// to preparation workflows. Only approved public changes cross this boundary.
+export {};
+//# sourceMappingURL=service-protocol.js.map

package/dist/ports/service-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-protocol.js","sourceRoot":"","sources":["../../src/ports/service-protocol.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E"}

package/dist/ports/snapshot-views.js

@@ -0,0 +1,4 @@
+// A candidate view exposes only captured bytes. It cannot fall through to a
+// checkout or provide write methods to manifest inspection.
+export {};
+//# sourceMappingURL=snapshot-views.js.map

package/dist/ports/snapshot-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-views.js","sourceRoot":"","sources":["../../src/ports/snapshot-views.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4DAA4D"}

package/dist/ports/stores.js

@@ -0,0 +1,3 @@
+// Ports for personal configuration, workspace selections, command trust and caches.
+export {};
+//# sourceMappingURL=stores.js.map

package/dist/ports/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../src/ports/stores.ts"],"names":[],"mappings":"AAAA,oFAAoF"}

package/dist/ports/tool-history.js

@@ -0,0 +1,3 @@
+// Durable append-only installation checkpoints, shared by workspaces under one FX_HOME.
+export {};
+//# sourceMappingURL=tool-history.js.map

package/dist/ports/tool-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-history.js","sourceRoot":"","sources":["../../src/ports/tool-history.ts"],"names":[],"mappings":"AAAA,wFAAwF"}

package/package.json

@@ -1,6 +1,135 @@
 {
   "name": "@angelmsger/fx",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.10.1",
+  "description": "Manifest-driven multi-repository workspaces for people and coding agents",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "fx": "bin/fx.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "defaults",
+    "skills",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "volta": {
+    "node": "24.14.0",
+    "npm": "11.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.all.json --noEmit",
+    "lint": "prettier --check . && eslint . && npm run check:examples",
+    "format": "prettier --write .",
+    "test": "vitest run test/unit",
+    "test:bun": "bun run --bun vitest run test/unit",
+    "test:e2e": "npm run build && vitest run test/e2e --maxWorkers=4",
+    "test:contract": "node scripts/test-contract.mjs",
+    "check:windows": "node scripts/check-windows.mjs",
+    "docs:gen": "npm run build && node scripts/gen-cli-docs.mjs",
+    "docs:check": "npm run build && node scripts/gen-cli-docs.mjs --check",
+    "prepublishOnly": "node scripts/guard-registry.mjs && npm run build && node scripts/check-package.mjs",
+    "site:build": "npm --prefix docs/website run build",
+    "site:check": "npm --prefix docs/website run check",
+    "site:dev": "npm --prefix docs/website run dev",
+    "check:examples": "node scripts/check-public-examples.mjs"
+  },
+  "dependencies": {
+    "@oclif/core": "^5.0.0",
+    "cross-spawn": "7.0.6",
+    "jsonc-parser": "^3.3.1",
+    "smol-toml": "^1.8.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "6.0.6",
+    "@types/node": "^22.20.1",
+    "ajv": "^8.20.0",
+    "eslint": "^10.9.1",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "prettier": "^3.9.6",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.69.0",
+    "vitest": "^4.1.11"
+  },
+  "oclif": {
+    "bin": "fx",
+    "dirname": "fx",
+    "commands": {
+      "strategy": "explicit",
+      "target": "./dist/cli/commands/index.js",
+      "identifier": "COMMANDS"
+    },
+    "topicSeparator": " ",
+    "helpClass": "./dist/cli/help.js",
+    "topics": {
+      "repo": {
+        "description": "Repositories: list, show, pick, register, fork, open"
+      },
+      "env": {
+        "description": "Environments: list, show, pick"
+      },
+      "agent": {
+        "description": "Coding agents: discover, select globally, inspect workspace Skills"
+      },
+      "skill": {
+        "description": "Bundled fx companion Skill: install, inspect and remove without a workspace"
+      },
+      "tool": {
+        "description": "Companion tools: definitions, installation, inventory and history"
+      },
+      "member": {
+        "description": "People: list them, show who a name refers to"
+      },
+      "manifest": {
+        "description": "Shared manifest: validate, explain, edit repository fields and record probe evidence"
+      },
+      "config": {
+        "description": "Personal settings in ~/.fx/config.yaml, and carrying them to another machine"
+      },
+      "self": {
+        "description": "The fx tool itself: info, update"
+      },
+      "hook": {
+        "description": "Workspace lifecycle hooks: inspect, enable and disable"
+      },
+      "mcp": {
+        "description": "Workspace MCP resources, projections and readiness"
+      },
+      "source": {
+        "description": "Source contributions: validate selected files and propose a pull request"
+      },
+      "workspace": {
+        "description": "Workspace identities: discover, inspect, relocate, rebind and unregister"
+      }
+    }
+  },
+  "keywords": [
+    "cli",
+    "workspace",
+    "multi-repo",
+    "git",
+    "manifest",
+    "coding-agents"
+  ],
+  "homepage": "https://angelmsger.github.io/fx-devkit/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AngelMsger/fx-devkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AngelMsger/fx-devkit/issues"
+  }
+}

package/skills/fx-workspace/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: fx-workspace
+version: 0.10.1
+description: 'Use only when the user explicitly asks for the fx workspace CLI or manifest, or the current task is inside an fx-managed workspace or routed by its fx-derived AGENTS.md. Drive workspace init and sync, repository status and selection, manifest validation and editing, companion tools and login, doctor, agent Skills, repository ownership, environment coordinates and readiness through can/where, and release checks across dependencies, branches, builds and errors. Do not use for generic Sentry, OpenObserve, Jenkins, Kubernetes, logs, errors or builds outside an fx-managed workspace.'
+metadata:
+  requires:
+    bins: ['fx']
+  cliHelp: 'fx --help; fx <command> --help'
+---
+
+# fx workspace
+
+Use fx for a manifest-managed workspace. Companion tools own their service APIs
+and credentials. Outside a managed workspace, use the relevant product tool
+unless the user explicitly asks for fx.
+
+Run `fx self info --format json` once when the running version is not yet known.
+Keep that executable prefix; its `initialization_guide` and `bundled_skill`
+identify the instructions shipped with this version.
+
+Choose the guide for the user's task:
+
+| Task                                                                                          | Guide                                            |
+| --------------------------------------------------------------------------------------------- | ------------------------------------------------ |
+| Prepare a workspace from a manifest, or resume unfinished preparation                         | [Initialization](references/initialization.md)   |
+| Query, synchronize or maintain an existing workspace; route a service task; edit the manifest | [Workspace tasks](references/workspace-tasks.md) |
+| Interpret a particular response field or advanced recovery contract                           | [Response contracts](references/commands.md)     |
+
+For initialization, the source and target directory are sufficient. Follow the
+initialization guide and `preparation.next`; it already includes verification.
+Continue the user's original task on `complete`, or hand off the named missing
+prerequisites. A list of other fx capabilities is not an initialization checklist.
+No Skill-loaded declaration is needed for initialization. Read the other guides
+only when that task or a specific failure needs them.