@cassiomc1/forgeloop 1.13.0 → 1.14.0

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 clear-continuity clear-state complete continuity doctor efficiency eval handoff-accept handoff-create handoff-list handoff-show history index-rebuild index-setup index-start index-status index-stop init inspect metrics migrate-protocol 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 status task-create task-list task-lock-status task-migrate task-recover task-repair-legacy-recovery task-resume task-scope task-show task-unlock 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 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'
@@ -133,6 +133,11 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from bundle' -l 'json' -d 'e
 complete -c forgeloop -f -n '__fish_seen_subcommand_from bundle' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from bundle' -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 bundle' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from checkpoint-revalidate' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from checkpoint-revalidate' -l 'json' -d 'emit structured revalidation output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from checkpoint-revalidate' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from checkpoint-revalidate' -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 checkpoint-revalidate' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from clear-continuity' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from clear-continuity' -l 'json' -d 'emit structured output as JSON'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from clear-continuity' -l 'path' -d 'target project directory (default: current directory)'
@@ -149,11 +154,48 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from complete' -l 'path' -d
 complete -c forgeloop -f -n '__fish_seen_subcommand_from complete' -l 'strict' -d 'require strict protocol compliance'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from complete' -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 complete' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from context-plan' -l 'decision' -d 'persisted Jev decision artifact ID'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from context-plan' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from context-plan' -l 'json' -d 'emit the bounded context plan as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from context-plan' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from context-plan' -l 'profile' -d 'bounded context budget profile'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from context-plan' -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 context-plan' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from continuity' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from continuity' -l 'json' -d 'emit structured output as JSON'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from continuity' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from continuity' -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 continuity' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-create' -l 'contract-file' -d 'validated JSON contract relative to the target'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-create' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-create' -l 'json' -d 'emit structured contract output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-create' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-create' -l 'preset' -d 'bounded contract preset: documentation, bug, feature, or release'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-create' -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 contract-create' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-revise' -l 'contract-file' -d 'validated replacement JSON contract relative to the target'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-revise' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-revise' -l 'json' -d 'emit structured contract revision output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-revise' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-revise' -l 'preset' -d 'bounded replacement contract preset: documentation, bug, feature, or release'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from contract-revise' -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 contract-revise' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-show' -l 'decision' -d 'decision artifact ID'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-show' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-show' -l 'json' -d 'emit the decision artifact as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-show' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-show' -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 decision-show' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-status' -l 'health' -d 'perform a bounded live Jev health check when credentials are configured'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-status' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-status' -l 'json' -d 'emit decision-plane status as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-status' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from decision-status' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from discover' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from discover' -l 'json' -d 'emit structured discovery output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from discover' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from discover' -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 discover' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from doctor' -l 'adopt' -d 'preserve an existing adapter in the manifest'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from doctor' -l 'fix' -d 'restore missing managed template files'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from doctor' -l 'help' -d 'show this help'
@@ -173,6 +215,25 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'path' -d 'tar
 complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'scenario' -d 'project-local trajectory scenario JSON'
 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)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from eval' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'artifact' -d 'project-relative evidence artifact'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'assumption' -d 'approved local assumption'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'decision' -d 'caller-recorded gate decision'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'evidence-file' -d 'bounded local descriptive evidence JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'gate' -d 'required gate name'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'json' -d 'emit structured gate output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'status' -d 'satisfied, unverified, or blocked'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -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 gate-record' -l 'unknown' -d 'known unresolved item'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-record' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-revalidate' -l 'acknowledge-stale' -d 'explicitly acknowledge refresh of stale gate artifacts inside active task claims'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-revalidate' -l 'gate' -d 'satisfied gate to refresh after safe artifact drift'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-revalidate' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-revalidate' -l 'json' -d 'emit structured gate revalidation output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-revalidate' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from gate-revalidate' -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 gate-revalidate' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from handoff-accept' -l 'consumer-id' -d 'consumer identifier accepting the handoff'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from handoff-accept' -l 'handoff' -d 'handoff identifier'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from handoff-accept' -l 'harness' -d 'optional harness accepting the handoff'
@@ -257,6 +318,21 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from migrate-protocol' -l 'j
 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 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'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'decision' -d 'persisted Jev decision artifact ID'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'executable-change' -d 'declare executable/configuration change'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'generation-required' -d 'declare that generation is required'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'json' -d 'emit model-route projection as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'platform' -d 'affected platform'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'risk' -d 'task risk'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'surface' -d 'affected surface'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -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 model-route' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from model-route' -l 'work' -d 'declared work type'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from next' -l 'compact' -d 'emit a bounded next-action projection'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from next' -l 'explain' -d 'include bounded read-only blocker and recovery explanation'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from next' -l 'help' -d 'show this help'
@@ -502,12 +578,26 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from search' -l 'stats' -d '
 complete -c forgeloop -f -n '__fish_seen_subcommand_from search' -l 'type' -d 'include files of a tgrep type'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from search' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from search' -l 'word-regexp' -d 'match whole words only'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -l 'decision' -d 'persisted Jev decision artifact ID'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -l 'input' -d 'bounded failure, diagnosis, or review context'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -l 'json' -d 'emit semantic plan projection as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -l 'kind' -d 'bounded semantic planning projection'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from semantic-plan' -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 semantic-plan' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'contract-file' -d 'current JSON contract used for freshness comparison'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from status' -l 'json' -d 'emit structured output as JSON'
 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 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'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-abandon' -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-abandon' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-create' -l 'claim' -d 'scoped file path or directory prefix claimed for mutation'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-create' -l 'contract-file' -d 'path to initial contract file'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-create' -l 'help' -d 'show this help'
@@ -535,6 +625,12 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate' -l '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-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'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate-contract-bootstrap-repair' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-migrate-contract-bootstrap-repair' -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-migrate-contract-bootstrap-repair' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-recover' -l 'acknowledge-recovery' -d 'acknowledge release of claims for a STALE or ABANDONED task (required; not host attestation)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-recover' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-recover' -l 'json' -d 'emit structured output as JSON'
@@ -542,6 +638,12 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from task-recover' -l 'opera
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-recover' -l 'path' -d 'target project directory (default: current directory)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-recover' -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-recover' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-contract-bootstrap' -l 'acknowledge-repair' -d 'explicit caller acknowledgement of the exact append-only repair (required)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-contract-bootstrap' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-contract-bootstrap' -l 'json' -d 'emit structured repair output as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-contract-bootstrap' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-contract-bootstrap' -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-repair-contract-bootstrap' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-legacy-recovery' -l 'acknowledge-recovery' -d 'fresh explicit acknowledgement of the legacy boundary migration (required)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-legacy-recovery' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-repair-legacy-recovery' -l 'json' -d 'emit structured output as JSON'
@@ -573,6 +675,26 @@ complete -c forgeloop -f -n '__fish_seen_subcommand_from task-unlock' -l 'path'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-unlock' -l 'stale-only' -d 'release only a lock whose lease is expired'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from task-unlock' -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-unlock' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-inventory' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-inventory' -l 'json' -d 'emit deterministic test inventory as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-inventory' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-inventory' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-plan' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-plan' -l 'json' -d 'emit test prune plan as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-plan' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-plan' -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 test-prune-plan' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-probe' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-probe' -l 'json' -d 'emit test prune probe as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-probe' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-probe' -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 test-prune-probe' -l 'test' -d 'stable test ID to probe in isolation'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-prune-probe' -l 'version' -d 'show the installed package version'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-utility' -l 'help' -d 'show this help'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-utility' -l 'json' -d 'emit test utility analysis as JSON'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-utility' -l 'path' -d 'target project directory (default: current directory)'
+complete -c forgeloop -f -n '__fish_seen_subcommand_from test-utility' -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 test-utility' -l 'version' -d 'show the installed package version'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from trace' -l 'help' -d 'show this help'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from trace' -l 'json' -d 'emit structured trace output as JSON (default rendering is a summary)'
 complete -c forgeloop -f -n '__fish_seen_subcommand_from trace' -l 'path' -d 'target project directory (default: current directory)'

package/docs/ADVISORY_CONTEXT.md

@@ -196,3 +196,28 @@ opt-in real-binary smoke test, and the retrieval benchmark. A real binary and
 its exact version must be qualified by the host; ForgeLoop does not install or
 discover Ripwire and does not treat an unavailable smoke test as proof of
 interoperability.
+
+## OpenSrc adapter
+
+ForgeLoop includes an optional host-injected adapter for
+[OpenSrc](https://github.com/vercel-labs/opensrc) external package and
+repository source context. The adapter is deliberately outside the default
+runtime: the host must provide an absolute executable path, an exact expected
+version, a dedicated absolute cache root outside the project, and an explicit
+source allowlist, then register the returned provider under the `opensrc` key
+and invoke `recallAdvisoryContext` explicitly. Creating the provider performs
+no discovery, network access, process start, cache write, or lifecycle write.
+
+The adapter qualifies `<absolute-opensrc> --version` before every recall,
+resolves each configured source once through `opensrc path <source> --cwd
+<projectRoot>` with `shell: false` and `OPENSRC_HOME` set to the dedicated
+cache root, canonicalizes every returned path inside that cache, and searches
+resolved sources locally with bounded deterministic Node.js traversal (no
+`rg`, embeddings, or network search). It never exposes absolute cache paths,
+raw stderr, environment, or credentials, and source text stays inert bounded
+context under the standard advisory trust projection.
+
+See [OPENSRC_ADAPTER.md](OPENSRC_ADAPTER.md) for registration, limits, cache
+and network behavior, tests, and troubleshooting. `opensrc path` may contact
+registries or remotes and populate its own cache on miss; ForgeLoop persists
+nothing and never auto-recalls.

package/docs/AGENT_BROWSER_ADAPTER.md

@@ -0,0 +1,81 @@
+# Agent Browser Adapter
+
+ForgeLoop ships an optional, host-injected adapter for Vercel Labs
+`agent-browser`. It implements the existing provider-neutral Browser
+Verification contract; it is not canonical browser infrastructure and it does
+not create lifecycle evidence.
+
+## Installation ownership
+
+The host must provide an already-installed `agent-browser` executable and pass
+its absolute path to `createAgentBrowserVerificationProvider`. ForgeLoop never
+discovers a binary through `PATH`, installs or upgrades Agent Browser, installs
+Chrome, or runs `doctor --fix`.
+
+```js
+import {
+  createAgentBrowserVerificationProvider,
+  createForgeLoopContext,
+  runBrowserVerification,
+} from "@cassiomc1/forgeloop/integration";
+
+const provider = createAgentBrowserVerificationProvider({
+  executablePath: "/opt/agent-browser/bin/agent-browser",
+  expectedVersion: "0.38.1",
+});
+const runtimeContext = createForgeLoopContext({
+  browserVerificationProviders: { "agent-browser": provider },
+});
+```
+
+## Supported mapping
+
+The adapter maps `NAVIGATE`, `CLICK`, `FILL`, `PRESS`, and bounded polling for
+`WAIT_FOR` to Agent Browser commands. CSS locators are passed directly;
+TEXT, LABEL, and ROLE locators are resolved from one accessibility snapshot and
+ambiguity is `BLOCKED`. Assertions cover visibility, hidden state, text,
+value, attribute, URL, URL prefix, and title. Requested assertion order is
+preserved.
+
+## Security and lifecycle
+
+Each invocation probes the explicitly supplied executable version lazily, uses
+a fresh random session, runs in an adapter-owned temporary cwd, and closes the
+session in `finally`. Profiles, restore/state replay, CDP, auto-connect,
+plugins, init scripts, and ambient cloud/authentication variables are filtered.
+The target repository is never used as the Agent Browser cwd.
+
+ForgeLoop validates exact `http`/`https` origins. Agent Browser receives the
+corresponding hostname allowlist as defense in depth, while ForgeLoop remains
+authoritative for scheme, host, and port. Redirects outside the allowlist are
+rejected. Subprocess argv uses `shell: false`; stdout, stderr, time, and
+diagnostics are bounded, and abort/timeout sends bounded termination signals.
+
+## Screenshots and trust model
+
+`NEVER`, `ON_FAILURE`, and `ALWAYS` screenshot policies are supported. Screenshot
+bytes remain temporary; results expose only bounded PNG metadata, a SHA-256
+digest, and a portable `agent-browser/<verification>/<digest>.png` reference.
+
+The result is observation-only: `persisted: false`, `evidenceAuthority: NONE`,
+and no lifecycle, claim, completion, evidence, or next-action fields. Calling
+`runBrowserVerification` does not mutate ForgeLoop artifacts and a PASS is never
+auto-promoted to a check or completion.
+
+Command responses must use the complete `{success: true, data}` envelope and
+scalar observations are type-checked before assertions run. Missing or extra
+envelope fields, malformed observations, non-zero exits, unsupported versions,
+cancellation, timeout, and output overflow fail closed; process success alone
+never produces a PASS. Any internal test-only temporary-root override must stay
+outside the verification target; the public TypeScript API exposes only the
+host-selected executables.
+
+## Troubleshooting and limitations
+
+Use an absolute regular executable path and, when desired, set
+`expectedVersion` to the host-qualified version. A missing executable, version
+mismatch, timeout, malformed response, output overflow, locator ambiguity, or
+origin escape fails closed. The default test suite does not require Agent
+Browser, Chrome, network access, or a Node 24 runtime. An optional localhost
+smoke test is available only when explicitly enabled with
+`FORGELOOP_AGENT_BROWSER_E2E=1` and `FORGELOOP_AGENT_BROWSER_EXECUTABLE`.

package/docs/AGENT_BROWSER_VERIFICATION.md

@@ -0,0 +1,6 @@
+# Agent Browser Verification
+
+This page is a short navigation entry for the concrete optional adapter. See
+[`AGENT_BROWSER_ADAPTER.md`](./AGENT_BROWSER_ADAPTER.md) for host installation
+ownership, the public factory, command mapping, isolation, exact-origin policy,
+screenshots, troubleshooting, and the non-authoritative trust boundary.

package/docs/AGENT_PROTOCOL_SUMMARY.md

@@ -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.
 
 Protocol version: 1
-Package version: 1.13.0
+Package version: 1.14.0
 
 ## Canonical loop
 
@@ -89,7 +89,7 @@ or `NOT_COMPARABLE` when evidence is absent or incompatible. See
 - Responsibility contracts constrain paths, checks, and frozen inputs; they do not prove identity or authorship.
 - Verification scope describes planned verification breadth. Attestation coverage proves content for a concrete revision. These are separate claims.
 - Attestation manifests exclude ForgeLoop protocol metadata and bind to the completion receipt and append-only ledger without circular references.
-- Verification commands are read-only. Signing is external; private keys and credentials are never persisted by ForgeLoop.
+- Verification command execution is external and provenance-bearing; ForgeLoop records the exact argv and result, while the authorized command may perform its declared effects. Signing is external; private keys and credentials are never persisted by ForgeLoop.
 
 ## Lifecycle
 
@@ -101,6 +101,7 @@ Phases: RECEIVED, DISCOVERING, CONTRACT_READY, ROUTED, DESIGNING, PLANNED, EXECU
 | --- | --- | --- |
 | adaptiveExecutionProfiles | 1 | yes |
 | advisoryContextProviders | 1 | yes |
+| auditUx | 1 | yes |
 | canonicalHandoffs | 2 | yes |
 | capabilityPolicy | 1 | yes |
 | codeAttestation | 1 | yes |
@@ -115,9 +116,11 @@ Phases: RECEIVED, DISCOVERING, CONTRACT_READY, ROUTED, DESIGNING, PLANNED, EXECU
 | executionProfileContext | 1 | yes |
 | integrationApi | 1 | yes |
 | observabilityStability | n/a | yes |
+| providerExtensions | 1 | yes |
 | reflection | 1 | yes |
 | repositoryIndex | 1 | yes |
 | responsibilityConstraints | 1 | yes |
+| semanticDecisionPlane | 1 | yes |
 | structuralQuality | 1 | yes |
 | structuredTrace | 1 | yes |
 | taskClaimRecovery | 1 | yes |
@@ -139,6 +142,8 @@ Phases: RECEIVED, DISCOVERING, CONTRACT_READY, ROUTED, DESIGNING, PLANNED, EXECU
   Integration-API-only, lazy, and opt-in. Provider results are not persisted by
   ForgeLoop and are never lifecycle state, evidence, authority, or executable
   instructions.
+- `providerExtensions` v1 is provider-neutral and
+  experimental. The generic provider registry remains internal and unexported.
 
 Protocol v1, schema v1, and Integration API v1 remain independent of these
 capability-family versions.
@@ -199,10 +204,12 @@ capability-family versions.
 | recovery | TASK | .forgeloop/task-state/<task-key>/recovery.json | task-recovery | TASK_RECOVERY_STATE |
 | responsibility | TASK | .forgeloop/task-state/<task-key>/responsibility.json | responsibility | RESPONSIBILITY_CONSTRAINT |
 | route | TASK | .forgeloop/task-state/<task-key>/routing-result.json | routing-result | GUIDE_ROUTING_SPECIFICATION |
+| semanticDecisions | TASK | .forgeloop/task-state/<task-key>/decisions/<decision-id>.json | semantic-decision | SEMANTIC_DECISION |
 | session | SESSION | .forgeloop/sessions/<session-id>.json | activation | SESSION_MARKER |
 | sources | PROJECT | .forgeloop/sources.json | source-registry | SOURCE_ATTESTATION |
 | state | TASK | .forgeloop/task-state/<task-key>/work-state.json | work-state | CANONICAL_LIFECYCLE_STATE |
 | structuralQuality | TASK | .forgeloop/task-state/<task-key>/structural-quality/baseline.json | structural-quality | STRUCTURAL_QUALITY_EVIDENCE |
+| testUtility | TASK | .forgeloop/task-state/<task-key>/test-utility.json | test-utility | NON_EVIDENCE_TEST_ANALYSIS |
 | usage | TASK | .forgeloop/task-state/<task-key>/usage.json | usage | INFORMATIONAL_USAGE_TELEMETRY |
 | verificationScope | TASK | .forgeloop/task-state/<task-key>/verification-scope.json | verification-scope | VERIFICATION_SCOPE_PLAN |
 | workspaceBinding | TASK | .forgeloop/task-state/<task-key>/workspace-binding.json | workspace-binding | WORKSPACE_IDENTITY_BINDING |
@@ -248,6 +255,9 @@ capability-family versions.
 
 | Command | Mutation | Purpose |
 | --- | --- | --- |
+| context-plan | READ_ONLY | Compiles a bounded non-authoritative context plan from deterministic candidates. |
+| decision-show | READ_ONLY | Shows one persisted semantic decision artifact without performing a live request. |
+| decision-status | READ_ONLY | Reports the pinned semantic decision-plane configuration without exposing credentials. |
 | doctor | MUTATING | Diagnoses project health, discovers adapters, and optionally repairs missing template files. |
 | efficiency | READ_ONLY | Projects usage and timing efficiency, comparing only against a metadata-compatible local baseline. |
 | eval | MUTATING | Evaluates the current trajectory against a validated project-local reference scenario. |
@@ -255,12 +265,17 @@ capability-family versions.
 | index-status | READ_ONLY | Reports provider-neutral repository-index health, metadata, and owned-server status. |
 | inspect | READ_ONLY | Inspects target repository health, dirty files, active branch, and artifact freshness. |
 | metrics | READ_ONLY | Projects trajectory, action, execution, timing, and known usage metrics without mutating state. |
+| model-route | READ_ONLY | Projects a deterministic model-routing floor with advisory Jev escalation only. |
 | profile-interview | READ_ONLY | Optional interactive or dry-run interview to refine project profile facts. |
 | progress | READ_ONLY | Evaluates task progress across verification cycles and detects stalls deterministically. |
 | protocol-info | READ_ONLY | Reports versioning, lifecycle, command, guide, and public error compatibility metadata for external harnesses. |
 | reflect | READ_ONLY | Analyzes diagnostic and correction history deterministically for information gain, repeated failures, ineffective interventions, and oscillation. |
 | search | READ_ONLY | Searches the ForgeLoop repository index through the provider-neutral search contract. |
+| semantic-plan | READ_ONLY | Projects fail-closed failure triage, diagnosis priority, or review planning without authority. |
 | status | READ_ONLY | Displays current lifecycle phase, active checks, blockers, and artifact freshness bindings. |
+| test-inventory | READ_ONLY | Discovers tests deterministically and assigns stable semantic test IDs without pruning authority. |
+| test-prune-plan | READ_ONLY | Projects KEEP, PROBE_REMOVAL, or BLOCKED without deleting tests. |
+| test-utility | MUTATING | Persists non-evidence test utility analysis; never deletes tests or authorizes pruning. |
 | trace | READ_ONLY | Emits detailed structured task trace with provenance and artifact relationships. |
 | usage-record | MUTATING | Records actor-reported usage telemetry without treating it as verification evidence. |
 | validate-protocol | READ_ONLY | Validates end-to-end cryptographic freshness, fingerprint bindings, and ledger integrity. |
@@ -274,6 +289,10 @@ capability-family versions.
 | advance | MUTATING | Transitions the canonical lifecycle work state to an allowed target phase. |
 | clear-state | MUTATING | Removes work-state.json for the active task only, preserving sibling contract, routing, and ledger files. |
 | complete | MUTATING | Evaluates verification receipt coverage, gates, and ledger integrity to authorize task completion. |
+| contract-create | MUTATING | Persists a validated contract and materializes the first real lifecycle checkpoint. |
+| discover | MUTATING | Records the canonical initial discovery milestone for a newly created task. |
+| gate-record | MUTATING | Records a required pre-execution gate with ForgeLoop-owned artifact hashes. |
+| gate-revalidate | MUTATING | Refreshes a stale satisfied gate after execution only when current identity and active claims prove the change is safe. |
 | next | READ_ONLY | Returns deterministic next-action guidance and command recommendations based on active state. |
 | preflight | MUTATING | Evaluates pre-implementation contract, routing, and gates; synchronizes work state when READY. |
 | reconcile-closure | MUTATING | Refreshes the work-state checkpoint of an EXECUTING, VERIFYING, or REVIEWING task whose objective is already satisfied in the current repository, after contract-bound executed evidence, so canonical completion can proceed. |
@@ -304,14 +323,19 @@ capability-family versions.
 
 | Command | Mutation | Purpose |
 | --- | --- | --- |
+| checkpoint-revalidate | MUTATING | Revalidates a safe ROUTED checkpoint after repository-only drift without changing contract or route identity. |
+| contract-revise | MUTATING | Replaces an existing contract canonically before execution while preserving task identity and invalidating derived evidence. |
 | index-rebuild | MUTATING | Atomically rebuilds the repository index and restarts its owned watcher. |
 | index-setup | MUTATING | Provisions the pinned tgrep engine, builds the repository index, and starts its owned watcher. |
 | index-start | MUTATING | Starts the owned tgrep repository-index watcher after an index has been built. |
 | index-stop | MUTATING | Stops only a tgrep server whose process identity is provably owned by ForgeLoop. |
 | init | MUTATING | Initializes a target project directory with ForgeLoop discovery adapters, schemas, and templates. |
 | migrate-protocol | MUTATING | Safely migrates explicitly supported protocol state; unknown target versions fail without rewriting artifacts. |
+| task-abandon | MUTATING | Explicitly abandons an active non-terminal task; records append-only evidence and releases claims without completion authority. |
 | task-migrate | MUTATING | Migrates a legacy 1.0 singleton task state layout into a task-namespaced layout. |
+| 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. |
 | task-recover | MUTATING | Caller-acknowledged recovery of a STALE or ABANDONED task; records durable state and releases effective write claims. |
+| task-repair-contract-bootstrap | MUTATING | Repairs the exact duplicate contract bootstrap defect without rewriting history; idempotent and append-only. |
 | task-repair-legacy-recovery | MUTATING | Migrates one recognized legacy OPERATOR_RECOVERY_RECORDED boundary event into the modern durable recovery representation (append-only; original event unchanged). |
 | task-resume | MUTATING | Reacquires a recovered task's write claims under project serialization and restores ordinary mutation authority. |
 | task-unlock | MUTATING | Removes an orphaned task lock file to recover an interrupted task. |
@@ -343,6 +367,7 @@ capability-family versions.
 | record-terminal-result | MUTATING | Records external terminal result evidence (PUBLICATION or PRODUCTION_READINESS) into receipt. |
 | report | READ_ONLY | Emits a human-readable or structured JSON summary report of protocol state. |
 | run-check | EXTERNAL_EXECUTION | Runs an exact command, records the execution provenance artifact, and binds observed check evidence. |
+| test-prune-probe | EXTERNAL_EXECUTION | Runs only an isolated, fail-closed removal probe; never modifies the live worktree. |
 | validate-receipt | READ_ONLY | Validates schema conformance and cryptographic bounds of an execution receipt file. |
 | verify-scope | MUTATING | Resolves a provable changed, claimed, full, or unresolved verification boundary without launching checks. |
 

package/docs/AGENT_SKILL.md

@@ -0,0 +1,66 @@
+# ForgeLoop Agent Skill
+
+## Status
+
+ForgeLoop ships a generated, portable Agent Skill at
+[`skills/forgeloop/SKILL.md`](../skills/forgeloop/SKILL.md). It is operational
+guidance, not protocol authority, and it does not certify any particular agent
+harness.
+
+## Purpose and Architecture
+
+The documented precedence direction is:
+
+```text
+runtime protocol registries and validators
+        -> canonical protocol documentation
+        -> docs/AGENT_PROTOCOL_SUMMARY.md
+        -> generated Skill
+```
+
+The Skill generator itself reads the generated summary and runtime protocol
+metadata. It does not parse the canonical Markdown protocol documents.
+
+The Skill never becomes lifecycle, completion, evidence, claim, scheduler,
+provider, or installation authority.
+
+## Generation and Freshness
+
+Generation is deterministic, offline, and has no external Agent Skills
+dependency:
+
+```bash
+npm run summary:generate
+npm run skill:generate
+npm run summary:check
+npm run skill:check
+```
+
+The writer is bounded to the five known files under `skills/forgeloop/` and
+does not delete unknown files. Documentation checks run Skill freshness after
+Agent Protocol Summary freshness.
+
+## Compatibility
+
+The Skill follows the portable `skills/forgeloop/SKILL.md` convention with only
+`name` and `description` frontmatter. This is format compatibility, not
+behavioral certification for every external harness. Existing native
+`AGENTS.md`, `CLAUDE.md`, Cursor, and Copilot integration surfaces remain
+intact.
+
+## Safety Boundaries
+
+Agents must discover tasks first, follow `next`, respect claims, require
+preflight `READY`, preserve command provenance, distinguish `run-check` from
+`record-check`, use supported recovery, require `complete -> VALID`, and query
+`next` again for a terminal result. Tokens, credentials, private keys, and
+authorization headers must never be persisted in ForgeLoop artifacts.
+
+External Agent Skills tooling is not a ForgeLoop dependency and is not used in
+CI. ForgeLoop adds no runtime Skill installation or synchronization command.
+
+## Packaging
+
+The generated Skill, this document, and the bounded generator ship in the npm
+package as instruction/documentation content. They add no runtime dependency.
+Harness-specific installed copies and caches are not shipped.