@cassiomc1/forgeloop 1.14.0 → 2.0.0-rc.4

package/LICENSE

@@ -1,21 +1,133 @@
-MIT License
-
-Copyright (c) 2026 Cassio
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.
+
+Required Notice: Copyright (c) 2026 Cassio Marques Campos

package/LOOP_SYSTEM_DESIGN.md

@@ -24,7 +24,7 @@ The system should use every guide that materially helps the task without loading
 - The loop continues while safe progress is possible. Repetition without new evidence triggers hypothesis reassessment or a blocked result, not infinite retries.
 - Third-party provenance and reuse boundaries remain part of every portable copy.
 - Qwen-MM-Plugins is an optional, task-scoped capability extension: the agent checks native support first, installs the smallest missing capability when needed, and verifies it before use; it is not a package or runtime dependency.
-- Canonical documents are installed under `.forgeloop/kit/`; root native adapters remain small discovery shims; project-scoped configuration remains under `.forgeloop/`; and modern mutable task protocol state is isolated under `.forgeloop/task-state/<taskKey>/`.
+- Canonical documents are installed under `.forgeloop/kit/`; root native adapters remain small discovery shims; project-scoped configuration remains under `.forgeloop/`; operational task records use `.forgeloop/state.sqlite` in SQLite mode. `.forgeloop/task-state/<taskKey>/` remains the logical and portable export path for task artifacts. Legacy filesystem mode remains a separate compatibility path, and SQLite capability still reports `soleSQLiteWriter: false` while legacy writers remain.
 - `PREFLIGHT_READY` is a resumable protocol checkpoint reconciled with work state, activation events, fingerprints, and the append-only hash chain.
 
 ## Alternatives considered
@@ -446,15 +446,15 @@ The validator also exercises seven routing scenarios:
 The npm CLI installs the kit into the current directory or an existing
 directory selected with `--path` when the package is available in the npm
 registry. If it is not available yet, the same commands can run as
-`node src/cli.js ...` from a repository checkout. The CLI maps canonical
-documents into `.forgeloop/kit/`, keeps only native instruction shims at the
-target root, and leaves project-scoped configuration under `.forgeloop/` while
-isolating modern mutable task protocol state (contract, route, gate, state,
-event, preflight, receipt, and recovery artifacts) under
-`.forgeloop/task-state/<taskKey>/`. Legacy singleton artifacts remain under
-`.forgeloop/` for compatibility and migration only. Manual copying must
-preserve that target layout; copying package-source root files directly is not
-equivalent to `forgeloop init`.
+`node src/cli.js ...` from a repository checkout. The CLI maps canonical documents into `.forgeloop/kit/`, keeps only native
+instruction shims at the target root, and leaves project-scoped configuration
+under `.forgeloop/`. In SQLite mode, mutable task records are stored in
+`.forgeloop/state.sqlite`; `.forgeloop/task-state/<taskKey>/` is the logical
+task-artifact and portable export path, not a claim that each artifact exists
+as a live filesystem file. Legacy filesystem mode remains a separate
+compatibility path, and SQLite mode must not share writable operational state
+with it. Manual copying must preserve the target layout; copying package-source
+root files directly is not equivalent to `forgeloop init`.
 
 Recovery uses a relational state model: `work-state.json` owns the lifecycle
 phase, `task.json` retains historical claims, `recovery.json` records current

package/README.md

@@ -1,7 +1,7 @@
 # ForgeLoop — Verifiable Engineering Protocol
 
 <p align="center">
-  <img src="./docs/assets/forgeloop-architecture.svg" alt="ForgeLoop Architecture" width="100%">
+  <img src="./docs/assets/forgeloop-architecture.png" alt="ForgeLoop architecture infographic" width="100%">
 </p>
 
 [![CodeQL](https://github.com/cassiomc1/forgeloop/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/cassiomc1/forgeloop/actions/workflows/codeql.yml)
@@ -11,16 +11,9 @@
 [![Package smoke](https://github.com/cassiomc1/forgeloop/actions/workflows/package-smoke.yml/badge.svg?branch=main)](https://github.com/cassiomc1/forgeloop/actions/workflows/package-smoke.yml)
 [![Release notes](https://github.com/cassiomc1/forgeloop/actions/workflows/release-notes.yml/badge.svg?branch=main)](https://github.com/cassiomc1/forgeloop/actions/workflows/release-notes.yml)
 
-ForgeLoop is the deterministic governor for AI-assisted engineering. Jev is the
-mandatory bounded System One semantic input; the host coding model is System Two
-implementation. ForgeLoop alone owns lifecycle, claims, gates, evidence,
-completion, recovery, and publication truth.
+ForgeLoop governs AI-assisted engineering. Jev supplies bounded semantic input; the host model implements changes. ForgeLoop owns lifecycle, claims, gates, evidence, completion, recovery, and publication truth.
 
-Operational sources are indexed in [`DOCS_INDEX.md`](./DOCS_INDEX.md).
-[`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md) is canonical;
-[`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md) defines discovery,
-[`PROJECT_PROFILE.md`](./PROJECT_PROFILE.md) stores project facts, and
-[`GUIDE_ROUTER.md`](./GUIDE_ROUTER.md) selects relevant guides.
+Sources: [`DOCS_INDEX.md`](./DOCS_INDEX.md); canonical [`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md); discovery [`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md); project facts [`PROJECT_PROFILE.md`](./PROJECT_PROFILE.md); guides [`GUIDE_ROUTER.md`](./GUIDE_ROUTER.md).
 
 ## Where should I start?
 
@@ -40,14 +33,10 @@ Operational sources are indexed in [`DOCS_INDEX.md`](./DOCS_INDEX.md).
 - **Troubleshooting & error codes** → [`docs/TROUBLESHOOTING.md`](./docs/TROUBLESHOOTING.md)
 - **Code attestation & revision coverage** → [`docs/CODE_ATTESTATION.md`](./docs/CODE_ATTESTATION.md)
 - **System architecture & safety** → [`LOOP_SYSTEM_DESIGN.md`](./LOOP_SYSTEM_DESIGN.md) & [`THREAT_MODEL.md`](./THREAT_MODEL.md)
-- **Documentation index & ownership** → [`DOCS_INDEX.md`](./DOCS_INDEX.md)
 
 ## Real execution proof
 
-The repository-only [execution PoC](https://github.com/cassiomc1/forgeloop/blob/main/poc/README.md) covers workload, protocol
-artifacts, trusted provenance, receipts, evidence, and audit. It reached
-validator-backed `COMPLETE / VALID` and preserves a later
-`E_RECEIPT_PATH_MISMATCH` after publication changed the repository.
+The repository-only [execution PoC](https://github.com/cassiomc1/forgeloop/blob/main/poc/README.md) demonstrates workload, protocol artifacts, trusted provenance, receipts, evidence, audit, and validator-backed `COMPLETE / VALID`.
 
 - [Canonical technical audit](https://github.com/cassiomc1/forgeloop/blob/main/poc/reports/poc-20260826-real-execution-technical-audit-v2.md)
 - [Evidence package](https://github.com/cassiomc1/forgeloop/tree/main/poc/evidence/poc-20260826-real-execution/)
@@ -76,29 +65,40 @@ validator-backed `COMPLETE / VALID` and preserves a later
 | SQL | [guide](./ENG/sql-development-eng.md) |
 | Go | [guide](./ENG/go-development-eng.md) |
 | TypeScript | [guide](./ENG/typescript-development-eng.md) |
+| Python | [guide](./ENG/python-development-eng.md) |
 | PHP | [guide](./ENG/php-development-eng.md) |
 | Swift | [guide](./ENG/swift-development-eng.md) |
 | Structural quality feedback | [`docs/STRUCTURAL_QUALITY.md`](./docs/STRUCTURAL_QUALITY.md) |
 
-Routing uses bounded structural evidence for Flutter, .NET, Node.js, Rust, C,
-C++, Java, Go, TypeScript, PHP, and Swift; SQL is a scoped schema/query/
-migration overlay. Source extensions, build tooling, lockfiles, compiler/JDK/
-runtime images, and prose alone fail where the specialist contract requires
-stronger project identity. The public project-evidence schema remains v1.
+Routing uses bounded structural evidence; SQL remains a schema/query/migration
+overlay. Extensions, tool files, lockfiles, runtime images, and prose alone do
+not establish project identity. Public project evidence remains v1.
+
+## Distribution and license
+
+GitHub hosts source and issues. The core npm package is publicly available;
+the MCP companion retains restricted distribution. The owner-selected default
+`latest` channel targets `2.0.0-rc.2`, which remains a release candidate with
+incomplete stable SQLite acceptance.
+ForgeLoop-owned source and documentation are licensed under the
+[PolyForm Noncommercial License 1.0.0](./LICENSE). Commercial use is not granted
+by this license. Third-party notices are documented in
+[`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md).
 
 ## Quickstart
 
 ### Installation
 
-Install the ForgeLoop CLI globally to make the `forgeloop` command available
-in your terminal:
+After your organization grants access, configure npm authentication and install:
 
 ```bash
 npm install --global @cassiomc1/forgeloop
 forgeloop --version
 ```
 
-Then, inside your project repository:
+Requires Node 24.19.0+ with `node:sqlite`. Migrate legacy state explicitly.
+
+Inside your project:
 
 ```bash
 forgeloop init
@@ -106,13 +106,6 @@ forgeloop doctor
 forgeloop search "example"
 ```
 
-If you prefer not to install globally, use `npx`:
-
-```bash
-npx @cassiomc1/forgeloop init
-npx @cassiomc1/forgeloop doctor
-```
-
 ### 60-second demonstration
 
 In a disposable directory, initialize the kit and create an isolated task.
@@ -211,20 +204,18 @@ forgeloop protocol-info --json
 | Validate completion | Yes | Provides real work and evidence |
 | Schedule agents or LLM inference | No | External to the protocol |
 
-For a concrete exchange between tools, see
-[cross-harness continuity](./docs/CROSS_HARNESS_CONTINUITY.md).
-
-From a published package, initialize a target project with:
+From the privately delivered package, initialize a target project with:
 
 ```bash
 npx @cassiomc1/forgeloop init
 npx @cassiomc1/forgeloop doctor
 ```
 
-The CLI installs canonical documents under `.forgeloop/kit/`, keeps small
-native discovery shims at the project root, stores project-scoped
-configuration under `.forgeloop/`, and stores task-scoped protocol artifacts
-under `.forgeloop/task-state/<taskKey>/`.
+The CLI installs canonical documents under `.forgeloop/kit/`, keeps native
+discovery shims at the project root, and stores project configuration under
+`.forgeloop/`. Task artifacts use `.forgeloop/task-state/<taskKey>/` as their
+logical portable export path; SQLite mode stores mutable records in
+`.forgeloop/state.sqlite`.
 `update` preserves target-specific profile facts and locally modified files.
 
 ForgeLoop adapts protocol depth to task risk and scope, preserving verifiable
@@ -256,8 +247,7 @@ host-reported or `UNKNOWN`; values are never estimated.
 capability, but advisory recall remains Integration API only. The stock CLI
 does not auto-recall providers and does not expose a `context-recall` command.
 
-Before npm publication, the same source checkout can be exercised without a
-network or package lookup:
+Validate the source checkout offline before any private release:
 
 ```bash
 node src/cli.js init

package/THIRD_PARTY_NOTICES.md

@@ -7,10 +7,9 @@ for reuse.
 
 ## Collection license
 
-The CLI and validator code are licensed under the MIT License in `LICENSE`.
-Original documentation is offered under CC BY 4.0 as described in
-`LICENSE-DOCS.md`. Those notices do not apply to adapted or external material;
-review the applicable source terms before redistributing such material.
+ForgeLoop-owned source and documentation are licensed under the
+[PolyForm Noncommercial License 1.0.0](./LICENSE). The notices below apply only to third-party
+components, adapted sources, vendored tools, and external references.
 
 ## Adapted and editorial sources
 

package/completions/_forgeloop

@@ -1,7 +1,7 @@
 #compdef forgeloop
 # Generated by scripts/generate-shell-completions.mjs. Do not edit.
 _arguments \
-  '1:command:(action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve attestation-create attestation-status attestation-verify attestation-verify-range audit baseline bundle checkpoint-revalidate clear-continuity clear-state complete context-plan continuity contract-create contract-revise decision-show decision-status discover doctor efficiency eval gate-record gate-revalidate handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol model-route next policy policy-diff policy-discover policy-status preflight prepare-completion profile-interview progress protocol-info quality-baseline quality-status quality-verify reconcile-closure reconcile-continuity record-check record-continuity record-decision-criterion record-diagnosis record-hypothesis-disposition record-intervention record-terminal-result reflect report responsibility-set responsibility-status route rule-verify run-action run-check search semantic-plan status task-abandon task-create task-list task-lock-status task-migrate task-migrate-contract-bootstrap-repair task-recover task-repair-contract-bootstrap task-repair-legacy-recovery task-resume task-scope task-show task-unlock test-inventory test-prune-plan test-prune-probe test-utility trace update usage-record validate-protocol validate-receipt validate-state verify-scope workspace-bind workspace-status)' \
+  '1:command:(action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve attestation-create attestation-status attestation-verify attestation-verify-range audit baseline bundle checkpoint-revalidate clear-continuity clear-state complete context-plan continuity contract-create contract-revise decision-show decision-status discover doctor efficiency eval gate-record gate-revalidate handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol model-route next policy policy-diff policy-discover policy-status preflight prepare-completion profile-interview progress protocol-info quality-baseline quality-status quality-verify reconcile-closure reconcile-continuity record-check record-continuity record-decision-criterion record-diagnosis record-hypothesis-disposition record-intervention record-terminal-result reflect report responsibility-set responsibility-status route rule-verify run-action run-check search semantic-plan status storage-backup storage-migrate storage-migration-resume storage-migration-status storage-restore storage-restore-resume storage-rollback storage-rollback-resume task-abandon task-create task-list task-lock-status task-migrate task-migrate-contract-bootstrap-repair task-recover task-repair-contract-bootstrap task-repair-legacy-recovery task-resume task-scope task-show task-unlock test-inventory test-prune-plan test-prune-probe test-utility trace update usage-record validate-protocol validate-receipt validate-state verify-scope workspace-bind workspace-status)' \
   '*::options:->options'
 case $words[2] in
   action-authorize) _arguments '--action[durable action ID]' '--approval[current fingerprint-bound approval]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
@@ -50,7 +50,7 @@ case $words[2] in
   init) _arguments '--dry-run[perform deterministic init planning and conflict detection without writing]' '--help[show this help]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' ;;
   inspect) _arguments '--contract-file[current JSON contract used for freshness comparison]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   metrics) _arguments '--help[show this help]' '--json[emit trajectory metrics as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
-  migrate-protocol) _arguments '--dry-run[show migration actions without writing or deleting artifacts]' '--help[show this help]' '--json[emit structured migration result as JSON]' '--path[target project directory (default: current directory)]' '--to[target supported protocol version]' '--version[show the installed package version]' ;;
+  migrate-protocol) _arguments '--destination[retained source and publication evidence destination]' '--dry-run[show migration actions without writing or deleting artifacts]' '--help[show this help]' '--json[emit structured migration result as JSON]' '--path[target project directory (default: current directory)]' '--to[target supported protocol version]' '--version[show the installed package version]' '--writers-quiesced[confirm all legacy writers are stopped and excluded]' ;;
   model-route) _arguments '--ambiguous[declare unresolved ambiguity]' '--architecture-change[declare an architectural change]' '--behavior-change[declare behavior change]' '--decision[persisted Jev decision artifact ID]' '--executable-change[declare executable/configuration change]' '--generation-required[declare that generation is required]' '--help[show this help]' '--json[emit model-route projection as JSON]' '--path[target project directory (default: current directory)]' '--platform[affected platform]' '--risk[task risk]' '--surface[affected surface]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' '--work[declared work type]' ;;
   next) _arguments '--compact[emit a bounded next-action projection]' '--explain[include bounded read-only blocker and recovery explanation]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   policy) _arguments '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
@@ -85,11 +85,19 @@ case $words[2] in
   search) _arguments '--after-context[lines of context after matches]' '--before-context[lines of context before matches]' '--context[lines of context before and after matches]' '--files-with-matches[return matching file paths only]' '--fixed-strings[treat the pattern as a literal string]' '--glob[include files matching a glob]' '--help[show this help]' '--ignore-case[search case-insensitively]' '--json[emit normalized provider-neutral search JSON]' '--max-count[maximum matches per file]' '--path[target project directory (default: current directory)]' '--smart-case[use case-insensitive search only for lowercase patterns]' '--stats[include observed native search statistics]' '--type[include files of a tgrep type]' '--version[show the installed package version]' '--word-regexp[match whole words only]' ;;
   semantic-plan) _arguments '--decision[persisted Jev decision artifact ID]' '--help[show this help]' '--input[bounded failure, diagnosis, or review context]' '--json[emit semantic plan projection as JSON]' '--kind[bounded semantic planning projection]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   status) _arguments '--contract-file[current JSON contract used for freshness comparison]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
+  storage-backup) _arguments '--destination[new backup file or attachment-inclusive directory relative to the project; parent directory must exist]' '--help[show this help]' '--include-attachments[create a new backup directory including all canonically referenced attachment bytes]' '--json[emit backup metadata]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' ;;
+  storage-migrate) _arguments '--destination[new retained migration directory relative to the project; missing parent directories are created]' '--help[show this help]' '--json[emit migration publication and verification metadata]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers, including older clients, have been externally stopped]' ;;
+  storage-migration-resume) _arguments '--destination[retained migration directory relative to the project]' '--expected-owner[exact retained maintenance owner reported by storage-migration-status]' '--help[show this help]' '--json[emit recovery verification metadata]' '--path[target project directory (default: current directory)]' '--reconcile-unbound-handoff[preserve an unbound legacy handoff by atomic archival before resuming the exact dead owner]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers, including older clients, have been externally stopped]' ;;
+  storage-migration-status) _arguments '--help[show this help]' '--json[emit bootstrap storage layout and retained maintenance ownership]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' ;;
+  storage-restore) _arguments '--help[show this help]' '--json[emit restore activation metadata]' '--path[target project directory (default: current directory)]' '--replace-active[explicitly select active replacement with retained outgoing authority]' '--source[verified attachment-inclusive backup directory; absolute or relative to the target project]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers have been externally stopped]' ;;
+  storage-restore-resume) _arguments '--expected-owner[exact retained maintenance owner UUID]' '--help[show this help]' '--json[emit restore recovery metadata]' '--operation[exact retained restore journal operation UUID]' '--path[target project directory (default: current directory)]' '--replace-active[explicitly select active replacement with retained outgoing authority]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers have been externally stopped]' ;;
+  storage-rollback) _arguments '--destination[retained published migration directory relative to the project]' '--help[show this help]' '--json[emit restoration and target-validation metadata]' '--legacy-root[clean supported pinned legacy checkout used for actual target validation]' '--native-writes-excluded[assert that native writes have been excluded since migration; snapshot equality alone does not prove this]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers, including older clients, have been externally stopped and excluded]' ;;
+  storage-rollback-resume) _arguments '--destination[retained migration with recorded rollback preparation, staging or publication]' '--expected-owner[exact retained dead local owner reported by storage-migration-status]' '--help[show this help]' '--json[emit restoration and target-validation metadata]' '--legacy-root[clean supported pinned legacy checkout used for actual target validation]' '--native-writes-excluded[assert that native writes have been excluded since migration; snapshot equality alone does not prove this]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers, including older clients, have been externally stopped and excluded]' ;;
   task-abandon) _arguments '--acknowledge-abandonment[explicitly acknowledge abandonment of an active task (required; not completion authority)]' '--help[show this help]' '--json[emit structured abandonment output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   task-create) _arguments '--claim[scoped file path or directory prefix claimed for mutation]' '--contract-file[path to initial contract file]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--preset[bounded contract preset: documentation, bug, feature, or release]' '--preview[preview the contract without creating lifecycle state]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   task-list) _arguments '--active[only return healthy tasks with active ownership and a non-terminal phase]' '--help[show this help]' '--json[emit structured output as JSON]' '--limit[maximum tasks to return]' '--offset[number of sorted tasks to skip]' '--path[target project directory (default: current directory)]' '--phase[only return tasks in this lifecycle phase]' '--version[show the installed package version]' ;;
   task-lock-status) _arguments '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
-  task-migrate) _arguments '--dry-run[show planned migration actions without moving files]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' ;;
+  task-migrate) _arguments '--destination[retained source and publication evidence destination]' '--dry-run[show planned migration actions without moving files]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' '--writers-quiesced[confirm all legacy writers are stopped and excluded]' ;;
   task-migrate-contract-bootstrap-repair) _arguments '--acknowledge-migration[fresh explicit caller acknowledgement of the exact legacy marker migration (required)]' '--help[show this help]' '--json[emit structured migration output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   task-recover) _arguments '--acknowledge-recovery[acknowledge release of claims for a STALE or ABANDONED task (required; not host attestation)]' '--help[show this help]' '--json[emit structured output as JSON]' '--operator-authorized[deprecated alias for --acknowledge-recovery; does not attest operator authority]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
   task-repair-contract-bootstrap) _arguments '--acknowledge-repair[explicit caller acknowledgement of the exact append-only repair (required)]' '--help[show this help]' '--json[emit structured repair output as JSON]' '--path[target project directory (default: current directory)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;

package/completions/forgeloop.bash

@@ -87,6 +87,14 @@ _forgeloop() {
       search) command="search" ;;
       semantic-plan) command="semantic-plan" ;;
       status) command="status" ;;
+      storage-backup) command="storage-backup" ;;
+      storage-migrate) command="storage-migrate" ;;
+      storage-migration-resume) command="storage-migration-resume" ;;
+      storage-migration-status) command="storage-migration-status" ;;
+      storage-restore) command="storage-restore" ;;
+      storage-restore-resume) command="storage-restore-resume" ;;
+      storage-rollback) command="storage-rollback" ;;
+      storage-rollback-resume) command="storage-rollback-resume" ;;
       task-abandon) command="task-abandon" ;;
       task-create) command="task-create" ;;
       task-list) command="task-list" ;;
@@ -116,7 +124,7 @@ _forgeloop() {
     esac
   done
   if [[ -z "\${command}" && "\${cur}" != -* ]]; then
-    COMPREPLY=( $(compgen -W 'action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve attestation-create attestation-status attestation-verify attestation-verify-range audit baseline bundle checkpoint-revalidate clear-continuity clear-state complete context-plan continuity contract-create contract-revise decision-show decision-status discover doctor efficiency eval gate-record gate-revalidate handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol model-route next policy policy-diff policy-discover policy-status preflight prepare-completion profile-interview progress protocol-info quality-baseline quality-status quality-verify reconcile-closure reconcile-continuity record-check record-continuity record-decision-criterion record-diagnosis record-hypothesis-disposition record-intervention record-terminal-result reflect report responsibility-set responsibility-status route rule-verify run-action run-check search semantic-plan status task-abandon task-create task-list task-lock-status task-migrate task-migrate-contract-bootstrap-repair task-recover task-repair-contract-bootstrap task-repair-legacy-recovery task-resume task-scope task-show task-unlock test-inventory test-prune-plan test-prune-probe test-utility trace update usage-record validate-protocol validate-receipt validate-state verify-scope workspace-bind workspace-status' -- "$cur") )
+    COMPREPLY=( $(compgen -W 'action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve attestation-create attestation-status attestation-verify attestation-verify-range audit baseline bundle checkpoint-revalidate clear-continuity clear-state complete context-plan continuity contract-create contract-revise decision-show decision-status discover doctor efficiency eval gate-record gate-revalidate handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol model-route next policy policy-diff policy-discover policy-status preflight prepare-completion profile-interview progress protocol-info quality-baseline quality-status quality-verify reconcile-closure reconcile-continuity record-check record-continuity record-decision-criterion record-diagnosis record-hypothesis-disposition record-intervention record-terminal-result reflect report responsibility-set responsibility-status route rule-verify run-action run-check search semantic-plan status storage-backup storage-migrate storage-migration-resume storage-migration-status storage-restore storage-restore-resume storage-rollback storage-rollback-resume task-abandon task-create task-list task-lock-status task-migrate task-migrate-contract-bootstrap-repair task-recover task-repair-contract-bootstrap task-repair-legacy-recovery task-resume task-scope task-show task-unlock test-inventory test-prune-plan test-prune-probe test-utility trace update usage-record validate-protocol validate-receipt validate-state verify-scope workspace-bind workspace-status' -- "$cur") )
     return
   fi
   case "\${command}" in
@@ -166,7 +174,7 @@ _forgeloop() {
     init) COMPREPLY=( $(compgen -W '--dry-run --help --path --version' -- "$cur") );;
     inspect) COMPREPLY=( $(compgen -W '--contract-file --help --json --path --task --version' -- "$cur") );;
     metrics) COMPREPLY=( $(compgen -W '--help --json --path --task --version' -- "$cur") );;
-    migrate-protocol) COMPREPLY=( $(compgen -W '--dry-run --help --json --path --to --version' -- "$cur") );;
+    migrate-protocol) COMPREPLY=( $(compgen -W '--destination --dry-run --help --json --path --to --version --writers-quiesced' -- "$cur") );;
     model-route) COMPREPLY=( $(compgen -W '--ambiguous --architecture-change --behavior-change --decision --executable-change --generation-required --help --json --path --platform --risk --surface --task --version --work' -- "$cur") );;
     next) COMPREPLY=( $(compgen -W '--compact --explain --help --json --path --task --version' -- "$cur") );;
     policy) COMPREPLY=( $(compgen -W '--help --json --path --task --version' -- "$cur") );;
@@ -201,11 +209,19 @@ _forgeloop() {
     search) COMPREPLY=( $(compgen -W '--after-context --before-context --context --files-with-matches --fixed-strings --glob --help --ignore-case --json --max-count --path --smart-case --stats --type --version --word-regexp' -- "$cur") );;
     semantic-plan) COMPREPLY=( $(compgen -W '--decision --help --input --json --kind --path --task --version' -- "$cur") );;
     status) COMPREPLY=( $(compgen -W '--contract-file --help --json --path --task --version' -- "$cur") );;
+    storage-backup) COMPREPLY=( $(compgen -W '--destination --help --include-attachments --json --path --version' -- "$cur") );;
+    storage-migrate) COMPREPLY=( $(compgen -W '--destination --help --json --path --version --writers-quiesced' -- "$cur") );;
+    storage-migration-resume) COMPREPLY=( $(compgen -W '--destination --expected-owner --help --json --path --reconcile-unbound-handoff --version --writers-quiesced' -- "$cur") );;
+    storage-migration-status) COMPREPLY=( $(compgen -W '--help --json --path --version' -- "$cur") );;
+    storage-restore) COMPREPLY=( $(compgen -W '--help --json --path --replace-active --source --version --writers-quiesced' -- "$cur") );;
+    storage-restore-resume) COMPREPLY=( $(compgen -W '--expected-owner --help --json --operation --path --replace-active --version --writers-quiesced' -- "$cur") );;
+    storage-rollback) COMPREPLY=( $(compgen -W '--destination --help --json --legacy-root --native-writes-excluded --path --version --writers-quiesced' -- "$cur") );;
+    storage-rollback-resume) COMPREPLY=( $(compgen -W '--destination --expected-owner --help --json --legacy-root --native-writes-excluded --path --version --writers-quiesced' -- "$cur") );;
     task-abandon) COMPREPLY=( $(compgen -W '--acknowledge-abandonment --help --json --path --task --version' -- "$cur") );;
     task-create) COMPREPLY=( $(compgen -W '--claim --contract-file --help --json --path --preset --preview --task --version' -- "$cur") );;
     task-list) COMPREPLY=( $(compgen -W '--active --help --json --limit --offset --path --phase --version' -- "$cur") );;
     task-lock-status) COMPREPLY=( $(compgen -W '--help --json --path --task --version' -- "$cur") );;
-    task-migrate) COMPREPLY=( $(compgen -W '--dry-run --help --json --path --version' -- "$cur") );;
+    task-migrate) COMPREPLY=( $(compgen -W '--destination --dry-run --help --json --path --version --writers-quiesced' -- "$cur") );;
     task-migrate-contract-bootstrap-repair) COMPREPLY=( $(compgen -W '--acknowledge-migration --help --json --path --task --version' -- "$cur") );;
     task-recover) COMPREPLY=( $(compgen -W '--acknowledge-recovery --help --json --operator-authorized --path --task --version' -- "$cur") );;
     task-repair-contract-bootstrap) COMPREPLY=( $(compgen -W '--acknowledge-repair --help --json --path --task --version' -- "$cur") );;

package/completions/forgeloop.fish

@@ -1,5 +1,5 @@
 # Generated by scripts/generate-shell-completions.mjs. Do not edit.
-complete -c forgeloop -f -n '__fish_use_subcommand' -a 'action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve attestation-create attestation-status attestation-verify attestation-verify-range audit baseline bundle checkpoint-revalidate clear-continuity clear-state complete context-plan continuity contract-create contract-revise decision-show decision-status discover doctor efficiency eval gate-record gate-revalidate handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol model-route next policy policy-diff policy-discover policy-status preflight prepare-completion profile-interview progress protocol-info quality-baseline quality-status quality-verify reconcile-closure reconcile-continuity record-check record-continuity record-decision-criterion record-diagnosis record-hypothesis-disposition record-intervention record-terminal-result reflect report responsibility-set responsibility-status route rule-verify run-action run-check search semantic-plan status task-abandon task-create task-list task-lock-status task-migrate task-migrate-contract-bootstrap-repair task-recover task-repair-contract-bootstrap task-repair-legacy-recovery task-resume task-scope task-show task-unlock test-inventory test-prune-plan test-prune-probe test-utility trace update usage-record validate-protocol validate-receipt validate-state verify-scope workspace-bind workspace-status'
+complete -c forgeloop -f -n '__fish_use_subcommand' -a 'action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve attestation-create attestation-status attestation-verify attestation-verify-range audit baseline bundle checkpoint-revalidate clear-continuity clear-state complete context-plan continuity contract-create contract-revise decision-show decision-status discover doctor efficiency eval gate-record gate-revalidate handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol model-route next policy policy-diff policy-discover policy-status preflight prepare-completion profile-interview progress protocol-info quality-baseline quality-status quality-verify reconcile-closure reconcile-continuity record-check record-continuity record-decision-criterion record-diagnosis record-hypothesis-disposition record-intervention record-terminal-result reflect report responsibility-set responsibility-status route rule-verify run-action run-check search semantic-plan status storage-backup storage-migrate storage-migration-resume storage-migration-status storage-restore storage-restore-resume storage-rollback storage-rollback-resume task-abandon task-create task-list task-lock-status task-migrate task-migrate-contract-bootstrap-repair task-recover task-repair-contract-bootstrap task-repair-legacy-recovery task-resume task-scope task-show task-unlock test-inventory test-prune-plan test-prune-probe test-utility trace update usage-record validate-protocol validate-receipt validate-state verify-scope workspace-bind workspace-status'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from action-authorize' -l 'action' -d 'durable action ID'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from action-authorize' -l 'approval' -d 'current fingerprint-bound approval'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from action-authorize' -l 'help' -d 'show this help'
@@ -312,12 +312,14 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from metrics' -l 'json' -d '
 complete -c forgeloop -f -n '__fish_seen_subcommand_from metrics' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from metrics' -l 'task' -d 'task ID to operate on (when omitted, resolved from context or single active task)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from metrics' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'destination' -d 'retained source and publication evidence destination'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'dry-run' -d 'show migration actions without writing or deleting artifacts'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'json' -d 'emit structured migration result as JSON'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'to' -d 'target supported protocol version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'writers-quiesced' -d 'confirm all legacy writers are stopped and excluded'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'ambiguous' -d 'declare unresolved ambiguity'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'architecture-change' -d 'declare an architectural change'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'behavior-change' -d 'declare behavior change'
@@ -592,6 +594,62 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'json' -d 'e
 complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'task' -d 'task ID to operate on (when omitted, resolved from context or single active task)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-backup' -l 'destination' -d 'new backup file or attachment-inclusive directory relative to the project; parent directory must exist'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-backup' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-backup' -l 'include-attachments' -d 'create a new backup directory including all canonically referenced attachment bytes'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-backup' -l 'json' -d 'emit backup metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-backup' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-backup' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migrate' -l 'destination' -d 'new retained migration directory relative to the project; missing parent directories are created'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migrate' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migrate' -l 'json' -d 'emit migration publication and verification metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migrate' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migrate' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migrate' -l 'writers-quiesced' -d 'assert that all writers, including older clients, have been externally stopped'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'destination' -d 'retained migration directory relative to the project'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'expected-owner' -d 'exact retained maintenance owner reported by storage-migration-status'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'json' -d 'emit recovery verification metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'reconcile-unbound-handoff' -d 'preserve an unbound legacy handoff by atomic archival before resuming the exact dead owner'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-resume' -l 'writers-quiesced' -d 'assert that all writers, including older clients, have been externally stopped'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-status' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-status' -l 'json' -d 'emit bootstrap storage layout and retained maintenance ownership'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-status' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-migration-status' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'json' -d 'emit restore activation metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'replace-active' -d 'explicitly select active replacement with retained outgoing authority'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'source' -d 'verified attachment-inclusive backup directory; absolute or relative to the target project'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore' -l 'writers-quiesced' -d 'assert that all writers have been externally stopped'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'expected-owner' -d 'exact retained maintenance owner UUID'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'json' -d 'emit restore recovery metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'operation' -d 'exact retained restore journal operation UUID'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'replace-active' -d 'explicitly select active replacement with retained outgoing authority'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-restore-resume' -l 'writers-quiesced' -d 'assert that all writers have been externally stopped'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'destination' -d 'retained published migration directory relative to the project'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'json' -d 'emit restoration and target-validation metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'legacy-root' -d 'clean supported pinned legacy checkout used for actual target validation'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'native-writes-excluded' -d 'assert that native writes have been excluded since migration; snapshot equality alone does not prove this'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback' -l 'writers-quiesced' -d 'assert that all writers, including older clients, have been externally stopped and excluded'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'destination' -d 'retained migration with recorded rollback preparation, staging or publication'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'expected-owner' -d 'exact retained dead local owner reported by storage-migration-status'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'json' -d 'emit restoration and target-validation metadata'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'legacy-root' -d 'clean supported pinned legacy checkout used for actual target validation'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'native-writes-excluded' -d 'assert that native writes have been excluded since migration; snapshot equality alone does not prove this'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'writers-quiesced' -d 'assert that all writers, including older clients, have been externally stopped and excluded'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -l 'acknowledge-abandonment' -d 'explicitly acknowledge abandonment of an active task (required; not completion authority)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -l 'json' -d 'emit structured abandonment output as JSON'
@@ -620,11 +678,13 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from task-lock-status' -l 'j
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-lock-status' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-lock-status' -l 'task' -d 'task ID to operate on (when omitted, resolved from context or single active task)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-lock-status' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'destination' -d 'retained source and publication evidence destination'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'dry-run' -d 'show planned migration actions without moving files'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'json' -d 'emit structured output as JSON'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l 'writers-quiesced' -d 'confirm all legacy writers are stopped and excluded'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate-contract-bootstrap-repair' -l 'acknowledge-migration' -d 'fresh explicit caller acknowledgement of the exact legacy marker migration (required)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate-contract-bootstrap-repair' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate-contract-bootstrap-repair' -l 'json' -d 'emit structured migration output as JSON'