@cassiomc1/forgeloop 2.1.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -13,11 +13,12 @@
13
13
 
14
14
  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.
15
15
 
16
- 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).
16
+ Sources: [`DOCS_INDEX.md`](./DOCS_INDEX.md); project facts [`PROJECT_PROFILE.md`](./PROJECT_PROFILE.md); guides [`GUIDE_ROUTER.md`](./GUIDE_ROUTER.md).
17
17
 
18
18
  ## Where should I start?
19
19
 
20
20
  - **New to ForgeLoop** → [`docs/GETTING_STARTED.md`](./docs/GETTING_STARTED.md)
21
+ - **Improve an existing repository** → [`docs/ASSESSMENT.md`](./docs/ASSESSMENT.md)
21
22
  - **Inspect a real ForgeLoop execution** → [repository PoC](https://github.com/cassiomc1/forgeloop/blob/main/poc/README.md)
22
23
  - **Full protocol specification** → [`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md)
23
24
  - **Integrating an AI harness** → [`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md)
@@ -36,7 +37,7 @@ Sources: [`DOCS_INDEX.md`](./DOCS_INDEX.md); canonical [`LOOP_ENGINEERING.md`](.
36
37
 
37
38
  ## Real execution proof
38
39
 
39
- 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`.
40
+ The repository-only [execution PoC](https://github.com/cassiomc1/forgeloop/blob/main/poc/README.md) reaches validator-backed `COMPLETE / VALID` with provenance, receipts, and audit.
40
41
 
41
42
  - [Canonical technical audit](https://github.com/cassiomc1/forgeloop/blob/main/poc/reports/poc-20260826-real-execution-technical-audit-v2.md)
42
43
  - [Evidence package](https://github.com/cassiomc1/forgeloop/tree/main/poc/evidence/poc-20260826-real-execution/)
@@ -78,12 +79,14 @@ See the [23-guide maintenance map](./docs/GUIDE_MAINTENANCE.md) for review scope
78
79
 
79
80
  ## Distribution and license
80
81
 
81
- GitHub hosts source and issues. The core npm package is publicly available;
82
- the MCP companion retains restricted distribution. Stable `2.0.0` is published
83
- on npm `latest`, with verified identity and native user audits.
82
+ GitHub hosts source and issues. The core npm package is public; the MCP
83
+ companion has restricted distribution. Stable `2.1.0` is on npm `latest` with
84
+ provenance and verified release identity.
84
85
  ForgeLoop-owned source and documentation are licensed under the
85
- [PolyForm Noncommercial License 1.0.0](./LICENSE). Commercial use is not granted
86
- by this license. Third-party notices are documented in
86
+ [PolyForm Noncommercial License 1.0.0](./LICENSE): free for noncommercial use.
87
+ Commercial use requires a [commercial license](https://forgeloop.monster/#pricing)
88
+ at USD 199 per developer per year ([buy](https://buy.stripe.com/dRm14n8AQ3ra2OodkT43S00)).
89
+ Third-party notices:
87
90
  [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md).
88
91
 
89
92
  ## Quickstart
@@ -1,7 +1,7 @@
1
1
  #compdef forgeloop
2
2
  # Generated by scripts/generate-shell-completions.mjs. Do not edit.
3
3
  _arguments \
4
- '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)' \
4
+ '1:command:(action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve assess 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 evidence-export evidence-verify 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 sync-pull sync-push 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)' \
5
5
  '*::options:->options'
6
6
  case $words[2] in
7
7
  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]' ;;
@@ -14,6 +14,7 @@ case $words[2] in
14
14
  advance) _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)]' '--to[destination workflow phase]' '--version[show the installed package version]' ;;
15
15
  approval-request) _arguments '--action[bound action ID]' '--approval[approval artifact ID]' '--help[show this help]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--reason[bounded approval reason]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
16
16
  approval-resolve) _arguments '--approval[approval artifact ID]' '--authority[CALLER_ACKNOWLEDGED or HOST_ATTESTED]' '--decision[approval decision]' '--help[show this help]' '--host-grant-ref[host boundary grant reference]' '--json[emit structured output as JSON]' '--path[target project directory (default: current directory)]' '--reason[bounded resolution reason]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
17
+ assess) _arguments '--help[show this help]' '--json[emit the repository assessment plan as JSON]' '--path[target project directory (default: current directory)]' '--version[show the installed package version]' ;;
17
18
  attestation-create) _arguments '--help[show this help]' '--json[emit attestation statement result 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]' ;;
18
19
  attestation-status) _arguments '--help[show this help]' '--json[emit attestation status 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]' ;;
19
20
  attestation-verify) _arguments '--bundle[optional external signature bundle]' '--help[show this help]' '--identity[optional exact signer identity policy]' '--issuer[optional exact signer issuer policy]' '--json[emit verification result as JSON]' '--path[target project directory (default: current directory)]' '--ref[target revision to compare with the manifest]' '--require-signature[require a valid external signature]' '--revision-provider[revision provider (default: git)]' '--signing-provider[signing provider (default: none)]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--trusted-root[trusted signing root path]' '--version[show the installed package version]' ;;
@@ -35,6 +36,8 @@ case $words[2] in
35
36
  doctor) _arguments '--adopt[preserve an existing adapter in the manifest]' '--fix[restore missing managed template files]' '--help[show this help]' '--json[emit doctor findings as JSON]' '--path[target project directory (default: current directory)]' '--strict[treat warnings as unhealthy]' '--version[show the installed package version]' ;;
36
37
  efficiency) _arguments '--baseline[optional comparable efficiency baseline JSON]' '--help[show this help]' '--json[emit efficiency 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]' ;;
37
38
  eval) _arguments '--help[show this help]' '--json[emit evaluation as JSON]' '--path[target project directory (default: current directory)]' '--scenario[project-local trajectory scenario JSON]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--version[show the installed package version]' ;;
39
+ evidence-export) _arguments '--dir[tracked evidence directory (default: .forgeloop-evidence)]' '--help[show this help]' '--json[emit the export result 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]' ;;
40
+ evidence-verify) _arguments '--allow-partial-coverage[report uncovered changed paths without failing]' '--base[base revision of the verified range]' '--dir[tracked evidence directory (default: .forgeloop-evidence)]' '--exclude[changed path or dir/** excluded from coverage (verifier policy)]' '--format[human output format (default: text)]' '--head[head revision of the verified range]' '--help[show this help]' '--identity[exact signer identity policy]' '--issuer[exact signer issuer policy]' '--json[emit the verification result as JSON]' '--path[target project directory (default: current directory)]' '--require-signature[require a valid Sigstore signature for every bundle used]' '--revision-provider[revision provider (default: git)]' '--trusted-root[trusted signing root path]' '--version[show the installed package version]' ;;
38
41
  gate-record) _arguments '--artifact[project-relative evidence artifact]' '--assumption[approved local assumption]' '--decision[caller-recorded gate decision]' '--evidence-file[bounded local descriptive evidence JSON]' '--gate[required gate name]' '--help[show this help]' '--json[emit structured gate output as JSON]' '--path[target project directory (default: current directory)]' '--status[satisfied, unverified, or blocked]' '--task[task ID to operate on (when omitted, resolved from context or single active task)]' '--unknown[known unresolved item]' '--version[show the installed package version]' ;;
39
42
  gate-revalidate) _arguments '--acknowledge-stale[explicitly acknowledge refresh of stale gate artifacts inside active task claims]' '--gate[satisfied gate to refresh after safe artifact drift]' '--help[show this help]' '--json[emit structured gate revalidation 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]' ;;
40
43
  handoff-accept) _arguments '--consumer-id[consumer identifier accepting the handoff]' '--handoff[handoff identifier]' '--harness[optional harness accepting the handoff]' '--help[show this help]' '--json[emit acceptance result 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]' ;;
@@ -93,6 +96,8 @@ case $words[2] in
93
96
  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]' ;;
94
97
  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]' ;;
95
98
  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]' ;;
99
+ sync-pull) _arguments '--help[show this help]' '--json[emit the pull and restore result as JSON]' '--path[target project directory (default: current directory)]' '--remote[sync endpoint (default: https://forgeloop.monster/api/sync)]' '--replace-active[replace existing local state; the outgoing state is retained and archived]' '--repo[repository the snapshot belongs to (default: from the git origin)]' '--version[show the installed package version]' '--writers-quiesced[assert that all writers have been externally stopped]' ;;
100
+ sync-push) _arguments '--help[show this help]' '--json[emit the push result as JSON]' '--path[target project directory (default: current directory)]' '--remote[sync endpoint (default: https://forgeloop.monster/api/sync)]' '--repo[repository the snapshot belongs to (default: from the git origin)]' '--version[show the installed package version]' ;;
96
101
  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]' ;;
97
102
  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]' ;;
98
103
  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]' ;;
@@ -16,6 +16,7 @@ _forgeloop() {
16
16
  advance) command="advance" ;;
17
17
  approval-request) command="approval-request" ;;
18
18
  approval-resolve) command="approval-resolve" ;;
19
+ assess) command="assess" ;;
19
20
  attestation-create) command="attestation-create" ;;
20
21
  attestation-status) command="attestation-status" ;;
21
22
  attestation-verify) command="attestation-verify" ;;
@@ -37,6 +38,8 @@ _forgeloop() {
37
38
  doctor) command="doctor" ;;
38
39
  efficiency) command="efficiency" ;;
39
40
  eval) command="eval" ;;
41
+ evidence-export) command="evidence-export" ;;
42
+ evidence-verify) command="evidence-verify" ;;
40
43
  gate-record) command="gate-record" ;;
41
44
  gate-revalidate) command="gate-revalidate" ;;
42
45
  handoff-accept) command="handoff-accept" ;;
@@ -95,6 +98,8 @@ _forgeloop() {
95
98
  storage-restore-resume) command="storage-restore-resume" ;;
96
99
  storage-rollback) command="storage-rollback" ;;
97
100
  storage-rollback-resume) command="storage-rollback-resume" ;;
101
+ sync-pull) command="sync-pull" ;;
102
+ sync-push) command="sync-push" ;;
98
103
  task-abandon) command="task-abandon" ;;
99
104
  task-create) command="task-create" ;;
100
105
  task-list) command="task-list" ;;
@@ -124,7 +129,7 @@ _forgeloop() {
124
129
  esac
125
130
  done
126
131
  if [[ -z "\${command}" && "\${cur}" != -* ]]; then
127
- 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") )
132
+ COMPREPLY=( $(compgen -W 'action-authorize action-propose action-reconcile action-record action-show action-verify activate advance approval-request approval-resolve assess 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 evidence-export evidence-verify 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 sync-pull sync-push 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") )
128
133
  return
129
134
  fi
130
135
  case "\${command}" in
@@ -138,6 +143,7 @@ _forgeloop() {
138
143
  advance) COMPREPLY=( $(compgen -W '--help --json --path --task --to --version' -- "$cur") );;
139
144
  approval-request) COMPREPLY=( $(compgen -W '--action --approval --help --json --path --reason --task --version' -- "$cur") );;
140
145
  approval-resolve) COMPREPLY=( $(compgen -W '--approval --authority --decision --help --host-grant-ref --json --path --reason --task --version' -- "$cur") );;
146
+ assess) COMPREPLY=( $(compgen -W '--help --json --path --version' -- "$cur") );;
141
147
  attestation-create) COMPREPLY=( $(compgen -W '--help --json --path --task --version' -- "$cur") );;
142
148
  attestation-status) COMPREPLY=( $(compgen -W '--help --json --path --task --version' -- "$cur") );;
143
149
  attestation-verify) COMPREPLY=( $(compgen -W '--bundle --help --identity --issuer --json --path --ref --require-signature --revision-provider --signing-provider --task --trusted-root --version' -- "$cur") );;
@@ -159,6 +165,8 @@ _forgeloop() {
159
165
  doctor) COMPREPLY=( $(compgen -W '--adopt --fix --help --json --path --strict --version' -- "$cur") );;
160
166
  efficiency) COMPREPLY=( $(compgen -W '--baseline --help --json --path --task --version' -- "$cur") );;
161
167
  eval) COMPREPLY=( $(compgen -W '--help --json --path --scenario --task --version' -- "$cur") );;
168
+ evidence-export) COMPREPLY=( $(compgen -W '--dir --help --json --path --task --version' -- "$cur") );;
169
+ evidence-verify) COMPREPLY=( $(compgen -W '--allow-partial-coverage --base --dir --exclude --format --head --help --identity --issuer --json --path --require-signature --revision-provider --trusted-root --version' -- "$cur") );;
162
170
  gate-record) COMPREPLY=( $(compgen -W '--artifact --assumption --decision --evidence-file --gate --help --json --path --status --task --unknown --version' -- "$cur") );;
163
171
  gate-revalidate) COMPREPLY=( $(compgen -W '--acknowledge-stale --gate --help --json --path --task --version' -- "$cur") );;
164
172
  handoff-accept) COMPREPLY=( $(compgen -W '--consumer-id --handoff --harness --help --json --path --task --version' -- "$cur") );;
@@ -217,6 +225,8 @@ _forgeloop() {
217
225
  storage-restore-resume) COMPREPLY=( $(compgen -W '--expected-owner --help --json --operation --path --replace-active --version --writers-quiesced' -- "$cur") );;
218
226
  storage-rollback) COMPREPLY=( $(compgen -W '--destination --help --json --legacy-root --native-writes-excluded --path --version --writers-quiesced' -- "$cur") );;
219
227
  storage-rollback-resume) COMPREPLY=( $(compgen -W '--destination --expected-owner --help --json --legacy-root --native-writes-excluded --path --version --writers-quiesced' -- "$cur") );;
228
+ sync-pull) COMPREPLY=( $(compgen -W '--help --json --path --remote --replace-active --repo --version --writers-quiesced' -- "$cur") );;
229
+ sync-push) COMPREPLY=( $(compgen -W '--help --json --path --remote --repo --version' -- "$cur") );;
220
230
  task-abandon) COMPREPLY=( $(compgen -W '--acknowledge-abandonment --help --json --path --task --version' -- "$cur") );;
221
231
  task-create) COMPREPLY=( $(compgen -W '--claim --contract-file --help --json --path --preset --preview --task --version' -- "$cur") );;
222
232
  task-list) COMPREPLY=( $(compgen -W '--active --help --json --limit --offset --path --phase --version' -- "$cur") );;
@@ -1,5 +1,5 @@
1
1
  # Generated by scripts/generate-shell-completions.mjs. Do not edit.
2
- 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'
2
+ 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 assess 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 evidence-export evidence-verify 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 sync-pull sync-push 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'
3
3
  complete -c forgeloop -f -n '__fish_seen_subcommand_from action-authorize' -l 'action' -d 'durable action ID'
4
4
  complete -c forgeloop -f -n '__fish_seen_subcommand_from action-authorize' -l 'approval' -d 'current fingerprint-bound approval'
5
5
  complete -c forgeloop -f -n '__fish_seen_subcommand_from action-authorize' -l 'help' -d 'show this help'
@@ -79,6 +79,10 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from approval-resolve' -l 'p
79
79
  complete -c forgeloop -f -n '__fish_seen_subcommand_from approval-resolve' -l 'reason' -d 'bounded resolution reason'
80
80
  complete -c forgeloop -f -n '__fish_seen_subcommand_from approval-resolve' -l 'task' -d 'task ID to operate on (when omitted, resolved from context or single active task)'
81
81
  complete -c forgeloop -f -n '__fish_seen_subcommand_from approval-resolve' -l 'version' -d 'show the installed package version'
82
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from assess' -l 'help' -d 'show this help'
83
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from assess' -l 'json' -d 'emit the repository assessment plan as JSON'
84
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from assess' -l 'path' -d 'target project directory (default: current directory)'
85
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from assess' -l 'version' -d 'show the installed package version'
82
86
  complete -c forgeloop -f -n '__fish_seen_subcommand_from attestation-create' -l 'help' -d 'show this help'
83
87
  complete -c forgeloop -f -n '__fish_seen_subcommand_from attestation-create' -l 'json' -d 'emit attestation statement result as JSON'
84
88
  complete -c forgeloop -f -n '__fish_seen_subcommand_from attestation-create' -l 'path' -d 'target project directory (default: current directory)'
@@ -215,6 +219,27 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'path' -d 'tar
215
219
  complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'scenario' -d 'project-local trajectory scenario JSON'
216
220
  complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'task' -d 'task ID to operate on (when omitted, resolved from context or single active task)'
217
221
  complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'version' -d 'show the installed package version'
222
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-export' -l 'dir' -d 'tracked evidence directory (default: .forgeloop-evidence)'
223
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-export' -l 'help' -d 'show this help'
224
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-export' -l 'json' -d 'emit the export result as JSON'
225
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-export' -l 'path' -d 'target project directory (default: current directory)'
226
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-export' -l 'task' -d 'task ID to operate on (when omitted, resolved from context or single active task)'
227
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-export' -l 'version' -d 'show the installed package version'
228
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'allow-partial-coverage' -d 'report uncovered changed paths without failing'
229
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'base' -d 'base revision of the verified range'
230
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'dir' -d 'tracked evidence directory (default: .forgeloop-evidence)'
231
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'exclude' -d 'changed path or dir/** excluded from coverage (verifier policy)'
232
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'format' -d 'human output format (default: text)'
233
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'head' -d 'head revision of the verified range'
234
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'help' -d 'show this help'
235
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'identity' -d 'exact signer identity policy'
236
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'issuer' -d 'exact signer issuer policy'
237
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'json' -d 'emit the verification result as JSON'
238
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'path' -d 'target project directory (default: current directory)'
239
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'require-signature' -d 'require a valid Sigstore signature for every bundle used'
240
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'revision-provider' -d 'revision provider (default: git)'
241
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'trusted-root' -d 'trusted signing root path'
242
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from evidence-verify' -l 'version' -d 'show the installed package version'
218
243
  complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'artifact' -d 'project-relative evidence artifact'
219
244
  complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'assumption' -d 'approved local assumption'
220
245
  complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'decision' -d 'caller-recorded gate decision'
@@ -650,6 +675,20 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume
650
675
  complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'path' -d 'target project directory (default: current directory)'
651
676
  complete -c forgeloop -f -n '__fish_seen_subcommand_from storage-rollback-resume' -l 'version' -d 'show the installed package version'
652
677
  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'
678
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'help' -d 'show this help'
679
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'json' -d 'emit the pull and restore result as JSON'
680
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'path' -d 'target project directory (default: current directory)'
681
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'remote' -d 'sync endpoint (default: https://forgeloop.monster/api/sync)'
682
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'replace-active' -d 'replace existing local state; the outgoing state is retained and archived'
683
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'repo' -d 'repository the snapshot belongs to (default: from the git origin)'
684
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'version' -d 'show the installed package version'
685
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-pull' -l 'writers-quiesced' -d 'assert that all writers have been externally stopped'
686
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-push' -l 'help' -d 'show this help'
687
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-push' -l 'json' -d 'emit the push result as JSON'
688
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-push' -l 'path' -d 'target project directory (default: current directory)'
689
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-push' -l 'remote' -d 'sync endpoint (default: https://forgeloop.monster/api/sync)'
690
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-push' -l 'repo' -d 'repository the snapshot belongs to (default: from the git origin)'
691
+ complete -c forgeloop -f -n '__fish_seen_subcommand_from sync-push' -l 'version' -d 'show the installed package version'
653
692
  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)'
654
693
  complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -l 'help' -d 'show this help'
655
694
  complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -l 'json' -d 'emit structured abandonment output as JSON'
@@ -7,7 +7,7 @@
7
7
  ForgeLoop is a portable protocol and support CLI for verifiable engineering workflows. It records and validates task state, contracts, routing, checks, evidence, continuity, and optional code attestations. It does not become an agent scheduler, delegation service, source-control authority, or secret manager.
8
8
 
9
9
  Protocol version: 1
10
- Package version: 2.1.0
10
+ Package version: 2.2.0
11
11
 
12
12
  ## Canonical loop
13
13
 
@@ -240,6 +240,8 @@ capability-family versions.
240
240
  | attestation-status | READ_ONLY | Reports local ForgeLoop attestation status and trust level without network access. |
241
241
  | attestation-verify | READ_ONLY | Verifies a task attestation and current revision without mutating task state. |
242
242
  | attestation-verify-range | READ_ONLY | Verifies complete attestation coverage for an opaque revision range through a provider-neutral contract. |
243
+ | evidence-export | MUTATING | Exports a completed task's attestation as a portable, redacted evidence bundle to commit with the change. |
244
+ | evidence-verify | READ_ONLY | Verifies committed evidence bundles for a revision range without local ForgeLoop state; signatures raise the level from INTEGRITY_ONLY to ATTESTED. |
243
245
 
244
246
  ### continuity
245
247
 
@@ -257,6 +259,7 @@ capability-family versions.
257
259
 
258
260
  | Command | Mutation | Purpose |
259
261
  | --- | --- | --- |
262
+ | assess | READ_ONLY | Assesses an existing repository read-only: stack, areas, tests, candidate checks, observed gaps, and a guide-routed review plan without executing target code. |
260
263
  | context-plan | READ_ONLY | Compiles a bounded non-authoritative context plan from deterministic candidates. |
261
264
  | decision-show | READ_ONLY | Shows one persisted semantic decision artifact without performing a live request. |
262
265
  | decision-status | READ_ONLY | Reports the pinned semantic decision-plane configuration without exposing credentials. |
@@ -341,6 +344,8 @@ capability-family versions.
341
344
  | storage-restore-resume | MUTATING | Adopts an exact dead local maintenance owner and resumes restore. Incomplete snapshots and prior rebuild intents are retained before rebuilding from bound source; completed preparation requires source parity/domain validation. Use --replace-active for preparation or publication replacement recovery. Conflicting intents and retained handoff locks remain refused. |
342
345
  | storage-rollback | MUTATING | Conditionally restores preserved source before native writes, retaining original native bytes and validating every task with the supported pinned legacy target before release. Failures retain exclusion; post-write restoration is refused. |
343
346
  | storage-rollback-resume | MUTATING | Resumes recorded rollback preparation, staging or publication under exact dead-owner adoption, revalidates native/source locations, and validates every task with the pinned target before release. Unbound attempts remain refused. |
347
+ | sync-pull | MUTATING | Downloads, decrypts and verifies the repository's sync snapshot, then activates it through storage-restore: into a fresh project, or replacing local state only with --replace-active. |
348
+ | sync-push | MUTATING | Uploads a client-side encrypted (FORGELOOP_SYNC_KEY) backup of this project's ForgeLoop state to the sync remote, authenticated by FORGELOOP_SYNC_TOKEN. A push based on a stale remote version is refused with E_SYNC_CONFLICT. |
344
349
  | task-abandon | MUTATING | Explicitly abandons an active non-terminal task; records append-only evidence and releases claims without completion authority. |
345
350
  | task-migrate | MUTATING | Migrates legacy singleton task state into SQLite with retained source and verified publication evidence. |
346
351
  | task-migrate-contract-bootstrap-repair | MUTATING | Migrates the exact legacy contract bootstrap repair marker by appending a bound migration event; the original marker and artifacts remain unchanged. |
@@ -158,6 +158,40 @@ destination is never replaced. External attachments are not included.
158
158
 
159
159
  <!-- END FORGELOOP GENERATED: cli:storage-backup:options -->
160
160
 
161
+ ### `sync-push`
162
+
163
+ Uploads an encrypted backup of this project's ForgeLoop state to the cloud-sync
164
+ remote so another machine can continue the work. The snapshot is encrypted on
165
+ this machine with `FORGELOOP_SYNC_KEY`; `FORGELOOP_SYNC_TOKEN` authenticates the
166
+ request. A push based on a remote version this machine has not pushed or pulled
167
+ is refused with `E_SYNC_CONFLICT`. See [`CLOUD_SYNC.md`](./CLOUD_SYNC.md).
168
+
169
+ <!-- BEGIN FORGELOOP GENERATED: cli:sync-push:options -->
170
+
171
+ - `--path <directory>`: target project directory (default: current directory)
172
+ - `--remote <url>`: sync endpoint (default: https://forgeloop.monster/api/sync)
173
+ - `--repo <owner/name>`: repository the snapshot belongs to (default: from the git origin)
174
+ - `--json`: emit the push result as JSON
175
+
176
+ <!-- END FORGELOOP GENERATED: cli:sync-push:options -->
177
+
178
+ ### `sync-pull`
179
+
180
+ Downloads, decrypts and verifies the repository's snapshot, then activates it
181
+ through `storage-restore`: into a fresh project, or over existing local state
182
+ only with `--replace-active`. Requires `--writers-quiesced`.
183
+
184
+ <!-- BEGIN FORGELOOP GENERATED: cli:sync-pull:options -->
185
+
186
+ - `--path <directory>`: target project directory (default: current directory)
187
+ - `--remote <url>`: sync endpoint (default: https://forgeloop.monster/api/sync)
188
+ - `--repo <owner/name>`: repository the snapshot belongs to (default: from the git origin)
189
+ - `--replace-active`: replace existing local state; the outgoing state is retained and archived
190
+ - `--writers-quiesced`: assert that all writers have been externally stopped
191
+ - `--json`: emit the pull and restore result as JSON
192
+
193
+ <!-- END FORGELOOP GENERATED: cli:sync-pull:options -->
194
+
161
195
  ## Semantic decision projections
162
196
 
163
197
  ### `decision-status`
@@ -239,6 +273,19 @@ question-set categories.
239
273
 
240
274
  <!-- END FORGELOOP GENERATED: cli:semantic-plan:options -->
241
275
 
276
+ ### `assess`
277
+
278
+ Assesses an existing repository read-only and emits a guide-routed review plan
279
+ for frontend and backend code. It never executes target code; see
280
+ [`ASSESSMENT.md`](./ASSESSMENT.md).
281
+
282
+ <!-- BEGIN FORGELOOP GENERATED: cli:assess:options -->
283
+
284
+ - `--path <directory>`: target project directory (default: current directory)
285
+ - `--json`: emit the repository assessment plan as JSON
286
+
287
+ <!-- END FORGELOOP GENERATED: cli:assess:options -->
288
+
242
289
  ### `test-inventory`
243
290
 
244
291
  Discovers deterministic test units and stable test IDs.
@@ -327,8 +374,8 @@ error codes. Default output and default JSON remain unchanged.
327
374
 
328
375
  | Category | Commands |
329
376
  | --- | --- |
330
- | **Setup & Maintenance** | [`storage-restore-resume`](#storage-restore-resume), [`storage-restore`](#storage-restore), [`storage-migration-status`](#storage-migration-status), [`storage-migration-resume`](#storage-migration-resume), [`storage-rollback`](#storage-rollback), [`storage-rollback-resume`](#storage-rollback-resume), [`storage-migrate`](#storage-migrate), [`storage-backup`](#storage-backup), [`contract-revise`](#contract-revise), [`init`](#init), [`index-setup`](#index-setup), [`index-start`](#index-start), [`index-stop`](#index-stop), [`index-rebuild`](#index-rebuild), [`update`](#update), [`checkpoint-revalidate`](#checkpoint-revalidate), [`task-migrate`](#task-migrate), [`migrate-protocol`](#migrate-protocol), [`task-unlock`](#task-unlock), [`task-recover`](#task-recover), [`task-abandon`](#task-abandon), [`task-repair-contract-bootstrap`](#task-repair-contract-bootstrap), [`task-migrate-contract-bootstrap-repair`](#task-migrate-contract-bootstrap-repair), [`task-repair-legacy-recovery`](#task-repair-legacy-recovery), [`task-resume`](#task-resume) |
331
- | **Inspection & Diagnostics** | [`protocol-info`](#protocol-info), [`decision-status`](#decision-status), [`decision-show`](#decision-show), [`context-plan`](#context-plan), [`model-route`](#model-route), [`semantic-plan`](#semantic-plan), [`test-inventory`](#test-inventory), [`test-utility`](#test-utility), [`test-prune-plan`](#test-prune-plan), [`doctor`](#doctor), [`index-status`](#index-status), [`search`](#search), [`metrics`](#metrics), [`usage-record`](#usage-record), [`efficiency`](#efficiency), [`eval`](#eval), [`history`](#history), [`trace`](#trace), [`reflect`](#reflect), [`progress`](#progress), [`profile-interview`](#profile-interview), [`inspect`](#inspect), [`status`](#status), [`validate-state`](#validate-state), [`validate-protocol`](#validate-protocol) |
377
+ | **Setup & Maintenance** | [`storage-restore-resume`](#storage-restore-resume), [`storage-restore`](#storage-restore), [`storage-migration-status`](#storage-migration-status), [`storage-migration-resume`](#storage-migration-resume), [`storage-rollback`](#storage-rollback), [`storage-rollback-resume`](#storage-rollback-resume), [`storage-migrate`](#storage-migrate), [`storage-backup`](#storage-backup), [`sync-push`](#sync-push), [`sync-pull`](#sync-pull), [`contract-revise`](#contract-revise), [`init`](#init), [`index-setup`](#index-setup), [`index-start`](#index-start), [`index-stop`](#index-stop), [`index-rebuild`](#index-rebuild), [`update`](#update), [`checkpoint-revalidate`](#checkpoint-revalidate), [`task-migrate`](#task-migrate), [`migrate-protocol`](#migrate-protocol), [`task-unlock`](#task-unlock), [`task-recover`](#task-recover), [`task-abandon`](#task-abandon), [`task-repair-contract-bootstrap`](#task-repair-contract-bootstrap), [`task-migrate-contract-bootstrap-repair`](#task-migrate-contract-bootstrap-repair), [`task-repair-legacy-recovery`](#task-repair-legacy-recovery), [`task-resume`](#task-resume) |
378
+ | **Inspection & Diagnostics** | [`protocol-info`](#protocol-info), [`decision-status`](#decision-status), [`decision-show`](#decision-show), [`context-plan`](#context-plan), [`model-route`](#model-route), [`semantic-plan`](#semantic-plan), [`test-inventory`](#test-inventory), [`assess`](#assess), [`test-utility`](#test-utility), [`test-prune-plan`](#test-prune-plan), [`doctor`](#doctor), [`index-status`](#index-status), [`search`](#search), [`metrics`](#metrics), [`usage-record`](#usage-record), [`efficiency`](#efficiency), [`eval`](#eval), [`history`](#history), [`trace`](#trace), [`reflect`](#reflect), [`progress`](#progress), [`profile-interview`](#profile-interview), [`inspect`](#inspect), [`status`](#status), [`validate-state`](#validate-state), [`validate-protocol`](#validate-protocol) |
332
379
  | **Verification & Completion** | [`test-prune-probe`](#test-prune-probe), [`quality-baseline`](#quality-baseline), [`quality-verify`](#quality-verify), [`quality-status`](#quality-status), [`prepare-completion`](#prepare-completion), [`run-check`](#run-check), [`record-check`](#record-check), [`record-terminal-result`](#record-terminal-result), [`audit`](#audit), [`report`](#report), [`validate-receipt`](#validate-receipt), [`verify-scope`](#verify-scope) |
333
380
  | **Lifecycle & State** | [`discover`](#discover), [`contract-create`](#contract-create), [`gate-record`](#gate-record), [`gate-revalidate`](#gate-revalidate), [`activate`](#activate), [`route`](#route), [`preflight`](#preflight), [`advance`](#advance), [`next`](#next), [`record-diagnosis`](#record-diagnosis), [`record-intervention`](#record-intervention), [`record-hypothesis-disposition`](#record-hypothesis-disposition), [`record-decision-criterion`](#record-decision-criterion), [`complete`](#complete), [`clear-state`](#clear-state), [`reconcile-closure`](#reconcile-closure), [`task-create`](#task-create), [`task-list`](#task-list), [`task-show`](#task-show), [`task-lock-status`](#task-lock-status), [`task-scope`](#task-scope) |
334
381
  | **Cross-Harness Continuity** | [`continuity`](#continuity), [`record-continuity`](#record-continuity), [`reconcile-continuity`](#reconcile-continuity), [`clear-continuity`](#clear-continuity), [`handoff-create`](#handoff-create), [`handoff-list`](#handoff-list), [`handoff-show`](#handoff-show) |
@@ -337,7 +384,7 @@ error codes. Default output and default JSON remain unchanged.
337
384
  | **workspace** | [`workspace-bind`](#workspace-bind), [`workspace-status`](#workspace-status) |
338
385
  | **task** | [`handoff-accept`](#handoff-accept) |
339
386
  | **scope** | [`responsibility-set`](#responsibility-set), [`responsibility-status`](#responsibility-status) |
340
- | **attestation** | [`attestation-create`](#attestation-create), [`attestation-verify`](#attestation-verify), [`attestation-status`](#attestation-status), [`attestation-verify-range`](#attestation-verify-range) |
387
+ | **attestation** | [`attestation-create`](#attestation-create), [`attestation-verify`](#attestation-verify), [`attestation-status`](#attestation-status), [`evidence-export`](#evidence-export), [`evidence-verify`](#evidence-verify), [`attestation-verify-range`](#attestation-verify-range) |
341
388
 
342
389
  <!-- END FORGELOOP GENERATED: cli-command-index -->
343
390
 
@@ -764,6 +811,44 @@ Reports local attestation status and trust level without network access.
764
811
  forgeloop attestation-status --task task-001 --json
765
812
  ```
766
813
 
814
+ ### `evidence-export`
815
+
816
+ Exports a completed task's attestation as a portable, redacted evidence bundle
817
+ to commit with the change. See [`EVIDENCE_BUNDLES.md`](./EVIDENCE_BUNDLES.md).
818
+
819
+ <!-- BEGIN FORGELOOP GENERATED: cli:evidence-export:options -->
820
+
821
+ - `--path <directory>`: target project directory (default: current directory)
822
+ - `--task <id>`: task ID to operate on (when omitted, resolved from context or single active task)
823
+ - `--dir <path>`: tracked evidence directory (default: .forgeloop-evidence)
824
+ - `--json`: emit the export result as JSON
825
+
826
+ <!-- END FORGELOOP GENERATED: cli:evidence-export:options -->
827
+
828
+ ### `evidence-verify`
829
+
830
+ Verifies committed evidence bundles for a revision range without local
831
+ ForgeLoop state. Unsigned bundles yield `INTEGRITY_ONLY`; signatures under the
832
+ verifier's policy yield `ATTESTED`.
833
+
834
+ <!-- BEGIN FORGELOOP GENERATED: cli:evidence-verify:options -->
835
+
836
+ - `--path <directory>`: target project directory (default: current directory)
837
+ - `--revision-provider <provider>`: revision provider (default: git)
838
+ - `--base <revision>`: base revision of the verified range
839
+ - `--head <revision>`: head revision of the verified range
840
+ - `--dir <path>`: tracked evidence directory (default: .forgeloop-evidence)
841
+ - `--exclude <path>`: changed path or dir/** excluded from coverage (verifier policy) (repeatable)
842
+ - `--allow-partial-coverage`: report uncovered changed paths without failing
843
+ - `--require-signature`: require a valid Sigstore signature for every bundle used
844
+ - `--identity <identity>`: exact signer identity policy
845
+ - `--issuer <issuer>`: exact signer issuer policy
846
+ - `--trusted-root <path>`: trusted signing root path
847
+ - `--format <text|markdown>`: human output format (default: text)
848
+ - `--json`: emit the verification result as JSON
849
+
850
+ <!-- END FORGELOOP GENERATED: cli:evidence-verify:options -->
851
+
767
852
  ### `attestation-verify-range`
768
853
 
769
854
  Verifies attestation coverage for an opaque revision range through the
@@ -140,6 +140,13 @@ distinguished from invalid attestations by the stable exit-code contract:
140
140
  See [`REVISION_PROVIDERS.md`](./REVISION_PROVIDERS.md) and
141
141
  [`SIGNING_PROVIDERS.md`](./SIGNING_PROVIDERS.md) for extension boundaries.
142
142
 
143
+ ## Verifying in pull-request CI
144
+
145
+ Attestations live in the local `.forgeloop/` state. To verify them in CI,
146
+ export each completed task with `forgeloop evidence-export` and commit the
147
+ bundle; `forgeloop evidence-verify` then checks the range without local state.
148
+ See [`EVIDENCE_BUNDLES.md`](./EVIDENCE_BUNDLES.md).
149
+
143
150
  ## Receipt availability in repository CI
144
151
 
145
152
  The repository audit workflow checks supplied task receipts individually with
@@ -4,7 +4,36 @@ This is the current release checklist for the PolyForm Noncommercial-licensed
4
4
  `@cassiomc1/forgeloop` package. It is a preparation and verification checklist;
5
5
  it does not authorize publication.
6
6
 
7
- ## Stable 2.1.0 candidate — 2026-11-14
7
+ ## Stable 2.2.0 candidate — 2026-11-16
8
+
9
+ `2.2.0` is a minor release of the core package. It adds `forgeloop assess`,
10
+ `evidence-export` and `evidence-verify` with ledger metrics, and the cloud-sync
11
+ `sync-push` and `sync-pull` commands, with their error codes. Its runtime
12
+ changes are bound by
13
+ [`stable-2.2.0-writer-review.json.gz`](../benchmarks/storage-sqlite/stable-2.2.0-writer-review.json.gz),
14
+ a delta review against 2.1.0:
15
+
16
+ - Every changed module keeps identical filesystem bindings.
17
+ - 23 added bindings, all in new modules, each have an explicit role.
18
+ - `sync-pull` is a tenth explicit maintenance-admission command; a test proves
19
+ that it leaves a project under retained maintenance unchanged.
20
+
21
+ Before dispatching `npm-publish.yml`:
22
+
23
+ 1. Merge the release commit to `main`.
24
+ 2. Tag it `v2.2.0`.
25
+ 3. Dispatch from that tag with channel `latest` and confirmation
26
+ `PUBLISH PUBLIC PACKAGE`.
27
+
28
+ Windows, rollback drills, hosted parity and registry-user audits are recorded
29
+ as not repeated or post-publication. After publication run:
30
+
31
+ ```bash
32
+ npm view @cassiomc1/forgeloop version dist-tags --json
33
+ npm run release:identity -- --version 2.2.0 --release-commit <release-tag-commit>
34
+ ```
35
+
36
+ ## Stable 2.1.0 publication — 2026-11-14
8
37
 
9
38
  `2.1.0` is a minor release of the core package (the published error registry
10
39
  gains every emitted code, 159 of them as `PUBLIC_UNCLASSIFIED`). Its runtime
@@ -15,12 +44,16 @@ disposition for every changed, added and removed module.
15
44
  `scripts/check-release-channel.mjs` selects the review by exact package version
16
45
  and never falls back to an earlier report.
17
46
 
18
- Before dispatching `npm-publish.yml`: merge the release commit to `main`, tag it
19
- `v2.1.0`, and dispatch from that tag with channel `latest` and confirmation
20
- `PUBLISH PUBLIC PACKAGE`. Hosted parity, native Windows, rollback drills and
47
+ Published from tag `v2.1.0` (commit `bbf0f2a30d356812834c85098179250f07d78842`)
48
+ through `npm-publish.yml` with trusted OIDC publishing: npm `latest` is `2.1.0`,
49
+ `dist.integrity` is
50
+ `sha512-Kcv3h+k8SUVfohiHOHsvgaXwf8OitwDn6f62Mgm5hu3TKR7WKTOHhuLAf5q+oKPmzZ33pJDP3iXBhOJyCyrRKg==`,
51
+ the provenance statement is in the Sigstore transparency log (index
52
+ 3890066512), and `release:identity` returns `RELEASE_IDENTITY_VALID`.
53
+ ForgeLoopAudit vendors this exact archive. Hosted parity, native Windows, rollback drills and
21
54
  registry-user audits from 2.0.0 are not carried forward as evidence for these
22
- bytes; the review records them as not repeated or post-publication. After
23
- publication run:
55
+ bytes; the review records them as not repeated or post-publication. Re-check
56
+ the published identity with:
24
57
 
25
58
  ```bash
26
59
  npm view @cassiomc1/forgeloop version dist-tags --json
@@ -1583,8 +1583,10 @@ canonical task state.
1583
1583
  | `E_EMULATED_SERVICES_VERSION_UNSUPPORTED` | Emitted by ForgeLoop but not yet curated; the code name is the contract and it carries no stable compatibility promise. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1584
1584
  | `E_EVENT_INVALID` | Emitted by ForgeLoop but not yet curated; the code name is the contract and it carries no stable compatibility promise. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1585
1585
  | `E_EVIDENCE_BLOCKED` | Emitted by ForgeLoop but not yet curated; the code name is the contract and it carries no stable compatibility promise. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1586
+ | `E_EVIDENCE_BUNDLE_INVALID` | A ForgeLoop boundary, artifact, provider, or attestation validation condition was not satisfied. | Inspect the structured command result, correct the named boundary or artifact, then retry the canonical command. |
1586
1587
  | `E_EVIDENCE_COVERAGE_INVALID` | A ForgeLoop protocol validation or lifecycle condition was not satisfied. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1587
1588
  | `E_EVIDENCE_COVERAGE_PARTIAL` | A ForgeLoop protocol validation or lifecycle condition was not satisfied. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1589
+ | `E_EVIDENCE_EXPORT_UNAVAILABLE` | A ForgeLoop boundary, artifact, provider, or attestation validation condition was not satisfied. | Inspect the structured command result, correct the named boundary or artifact, then retry the canonical command. |
1588
1590
  | `E_EVIDENCE_INVALID` | A ForgeLoop protocol validation or lifecycle condition was not satisfied. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1589
1591
  | `E_EVIDENCE_KIND_INVALID` | A ForgeLoop protocol validation or lifecycle condition was not satisfied. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1590
1592
  | `E_EVIDENCE_MISSING` | Emitted by ForgeLoop but not yet curated; the code name is the contract and it carries no stable compatibility promise. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
@@ -1861,6 +1863,12 @@ canonical task state.
1861
1863
  | `E_STRUCTURAL_QUALITY_SOURCE_DRIFT` | Structural-quality evidence did not satisfy its provider, artifact, comparison, or lifecycle boundary. | Ensure the worktree is not mutated during provider observation and rerun quality-baseline or quality-verify. |
1862
1864
  | `E_STRUCTURAL_QUALITY_SOURCE_FINGERPRINT_UNAVAILABLE` | Structural-quality evidence did not satisfy its provider, artifact, comparison, or lifecycle boundary. | Repair unreadable or unsafe source material before structural-quality evidence can be trusted. |
1863
1865
  | `E_STRUCTURAL_QUALITY_TIMEOUT` | Structural-quality evidence did not satisfy its provider, artifact, comparison, or lifecycle boundary. | Use a responsive provider or a bounded timeout within the supported limit; never promote a timed-out scan. |
1866
+ | `E_SYNC_CONFIG` | Cloud sync is missing FORGELOOP_SYNC_TOKEN or a FORGELOOP_SYNC_KEY of at least 16 characters, or --remote or --repo is invalid. | Set both environment variables and pass an https --remote and an owner/name --repo, or a GitHub git origin. |
1867
+ | `E_SYNC_CONFLICT` | The remote snapshot changed since this machine last pushed or pulled, so the push was refused instead of overwriting it. | Run forgeloop sync-pull --writers-quiesced --replace-active to adopt the remote state, then continue and push again. |
1868
+ | `E_SYNC_REMOTE` | The sync remote is unreachable, has no snapshot for this repository, or refused the request. | Check --remote and network access, push a first snapshot, or retry later. |
1869
+ | `E_SYNC_SNAPSHOT_INVALID` | The remote snapshot could not be decrypted with FORGELOOP_SYNC_KEY, belongs to another repository, or its contents failed integrity checks. | Use the same FORGELOOP_SYNC_KEY as the pushing machine; never restore a snapshot that fails these checks. |
1870
+ | `E_SYNC_TOO_LARGE` | The encrypted snapshot exceeds the 4 MiB sync limit. | Sync a project with less retained state; cloud sync does not split snapshots. |
1871
+ | `E_SYNC_UNAUTHORIZED` | The sync remote rejected FORGELOOP_SYNC_TOKEN, or the token is not allowed for this repository. | Use a token whose SHA-256 hash the remote owner configured for this repository. |
1864
1872
  | `E_TARGET_REQUIRED` | Emitted by ForgeLoop but not yet curated; the code name is the contract and it carries no stable compatibility promise. | Inspect the structured command result, correct the named artifact or prerequisite, then run forgeloop next --json. |
1865
1873
  | `E_TASK_ABANDON_AUTHORIZATION_REQUIRED` | task-abandon requires explicit caller acknowledgement and never grants completion or publication authority. | Re-run task-abandon with --acknowledge-abandonment after confirming the explicit task identity and intended claim release. |
1866
1874
  | `E_TASK_ABANDON_INCONSISTENT` | Explicit abandonment was refused because canonical ownership or append-only ledger evidence is inconsistent. | Repair and validate the task descriptor, recovery artifact, and ledger through their dedicated protocol paths before retrying. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cassiomc1/forgeloop",
3
- "version": "2.1.0",
3
+ "version": "2.2.0",
4
4
  "description": "Evidence-first engineering protocol for AI coding environments and developer workflows",
5
5
  "repository": {
6
6
  "type": "git",
package/src/cli.js CHANGED
@@ -318,6 +318,11 @@ export const COMMAND_HANDLERS = Object.freeze({
318
318
  renderJsonOr(options, result, (await import("./commands/semantic-plan.js")).formatSemanticPlanResult);
319
319
  return 0;
320
320
  },
321
+ assess: async ({ target, options }) => {
322
+ const { result } = await COMMAND_EXECUTORS.assess({ target, options });
323
+ renderJsonOr(options, result, (await import("./commands/assess.js")).formatAssessResult);
324
+ return 0;
325
+ },
321
326
  "test-inventory": async ({ target, options }) => {
322
327
  const { result } = await COMMAND_EXECUTORS["test-inventory"]({ target, options });
323
328
  renderJsonOr(options, result, (await import("./commands/test-inventory.js")).formatTestInventoryResult);
@@ -368,6 +373,16 @@ export const COMMAND_HANDLERS = Object.freeze({
368
373
  renderJsonOr(options, result, value => `storage backup: ${value.path}\nattachments included: ${value.attachmentsIncluded}`);
369
374
  return exitCode;
370
375
  },
376
+ "sync-push": async ({ target, packageRoot, options }) => {
377
+ const { result, exitCode } = await COMMAND_EXECUTORS["sync-push"]({ target, packageRoot, options });
378
+ renderJsonOr(options, result, (await import("./commands/sync-push.js")).formatSyncPushResult);
379
+ return exitCode;
380
+ },
381
+ "sync-pull": async ({ target, packageRoot, options }) => {
382
+ const { result, exitCode } = await COMMAND_EXECUTORS["sync-pull"]({ target, packageRoot, options });
383
+ renderJsonOr(options, result, (await import("./commands/sync-pull.js")).formatSyncPullResult);
384
+ return exitCode;
385
+ },
371
386
  "storage-restore": async ({ target, packageRoot, options }) => {
372
387
  const { result, exitCode } = await COMMAND_EXECUTORS["storage-restore"]({ target, packageRoot, options });
373
388
  renderJsonOr(options, result, value => `storage restore: ${value.path}\nactive: ${value.active}\nretained snapshot: ${value.retainedSnapshot}`);
@@ -558,6 +573,17 @@ export const COMMAND_HANDLERS = Object.freeze({
558
573
  renderJsonOr(options, result, (await import("./commands/attestation-status.js")).formatAttestationStatusResult);
559
574
  return exitCode;
560
575
  },
576
+ "evidence-export": async ({ target, packageRoot, options }) => {
577
+ const { result } = await COMMAND_EXECUTORS["evidence-export"]({ target, packageRoot, options });
578
+ renderJsonOr(options, result, (await import("./commands/evidence-export.js")).formatEvidenceExportResult);
579
+ return 0;
580
+ },
581
+ "evidence-verify": async ({ target, packageRoot, options }) => {
582
+ const { result, exitCode } = await COMMAND_EXECUTORS["evidence-verify"]({ target, packageRoot, options });
583
+ const { formatEvidenceVerifyResult } = await import("./commands/evidence-verify.js");
584
+ renderJsonOr(options, result, (value) => formatEvidenceVerifyResult(value, options));
585
+ return exitCode;
586
+ },
561
587
  "attestation-verify-range": async ({ target, packageRoot, options }) => {
562
588
  const { result, exitCode } = await COMMAND_EXECUTORS["attestation-verify-range"]({ target, packageRoot, options });
563
589
  renderJsonOr(options, result, (await import("./commands/attestation-verify-range.js")).formatAttestationVerifyRangeResult);