@cassiomc1/forgeloop 2.0.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.
Files changed (49) hide show
  1. package/.cursor/rules/project-loop.mdc +1 -1
  2. package/.github/copilot-instructions.md +1 -1
  3. package/AGENTS.md +1 -1
  4. package/CLAUDE.md +1 -1
  5. package/ENG/design-code-eng.md +7 -5
  6. package/ENG/dotnet-aspnetcore-development-eng.md +8 -4
  7. package/ENG/nodejs-backend-development-eng.md +7 -4
  8. package/ENG/sql-development-eng.md +5 -4
  9. package/ENG/taste-frontend-eng.md +19 -5
  10. package/PROTOCOL_INTEGRATION.md +21 -0
  11. package/README.md +10 -7
  12. package/THIRD_PARTY_NOTICES.md +1 -0
  13. package/completions/_forgeloop +6 -1
  14. package/completions/forgeloop.bash +11 -1
  15. package/completions/forgeloop.fish +40 -1
  16. package/docs/AGENT_PROTOCOL_SUMMARY.md +6 -1
  17. package/docs/CLI_REFERENCE.md +88 -3
  18. package/docs/CODE_ATTESTATION.md +7 -0
  19. package/docs/FORGELOOP_AUDIT.md +1 -1
  20. package/docs/GETTING_STARTED.md +8 -1
  21. package/docs/PACKAGE_CONTENTS.md +4 -5
  22. package/docs/RELEASE_CHECKLIST.md +67 -13
  23. package/docs/STABLE_2_ACCEPTANCE.md +118 -71
  24. package/docs/TROUBLESHOOTING.md +167 -0
  25. package/package.json +1 -5
  26. package/src/cli.js +26 -0
  27. package/src/commands/assess.js +36 -0
  28. package/src/commands/evidence-export.js +17 -0
  29. package/src/commands/evidence-verify.js +36 -0
  30. package/src/commands/sync-pull.js +46 -0
  31. package/src/commands/sync-push.js +49 -0
  32. package/src/core/assessment/facts.js +146 -0
  33. package/src/core/assessment/plan.js +133 -0
  34. package/src/core/cli-command-definitions.js +70 -0
  35. package/src/core/command-executors.js +26 -3
  36. package/src/core/error-codes.js +232 -2
  37. package/src/core/evidence/bundle-format.js +72 -0
  38. package/src/core/evidence/export.js +179 -0
  39. package/src/core/evidence/markdown.js +40 -0
  40. package/src/core/evidence/verify.js +179 -0
  41. package/src/core/integration-invocation-policy.js +4 -2
  42. package/src/core/next-action-review-phase.js +14 -5
  43. package/src/core/parsers/dotnet-project.js +221 -0
  44. package/src/core/parsers/limits.js +9 -0
  45. package/src/core/parsers/pubspec.js +307 -0
  46. package/src/core/parsers/shared.js +4 -0
  47. package/src/core/project-detection.js +6 -527
  48. package/src/core/sync/remote.js +124 -0
  49. package/src/core/sync/snapshot.js +129 -0
@@ -7,7 +7,7 @@ alwaysApply: true
7
7
  This project is ForgeLoop-enabled. If your execution environment loaded this
8
8
  file, ForgeLoop applies regardless of model, provider, IDE, agent, or runtime.
9
9
  Do not treat ForgeLoop as vendor-specific, optional, or to follow only "in spirit".
10
- 1. Read [`LOOP_ENGINEERING.md`](../../LOOP_ENGINEERING.md) and [`PROTOCOL_INTEGRATION.md`](../../PROTOCOL_INTEGRATION.md).
10
+ 1. Read [`LOOP_ENGINEERING.md`](../../LOOP_ENGINEERING.md) from its Navigation section, loading each section before the phase it governs, and [`PROTOCOL_INTEGRATION.md`](../../PROTOCOL_INTEGRATION.md).
11
11
  2. Confirm [`PROJECT_PROFILE.md`](../../PROJECT_PROFILE.md) from real sources; initialize if in `template` mode.
12
12
  3. Use [`GUIDE_ROUTER.md`](../../GUIDE_ROUTER.md) to activate relevant guides and report IDs.
13
13
  3. For repository-wide textual discovery, prefer `forgeloop search` and treat its results as discovery only; do not use them as verification evidence or scope authority.
@@ -7,7 +7,7 @@ Do not treat ForgeLoop as vendor-specific, optional, or to follow only "in spiri
7
7
 
8
8
  Use these instructions across the repository while preserving local rules.
9
9
 
10
- - Read [`LOOP_ENGINEERING.md`](../LOOP_ENGINEERING.md) and [`PROTOCOL_INTEGRATION.md`](../PROTOCOL_INTEGRATION.md).
10
+ - Read [`LOOP_ENGINEERING.md`](../LOOP_ENGINEERING.md) from its Navigation section, loading each section before the phase it governs, and [`PROTOCOL_INTEGRATION.md`](../PROTOCOL_INTEGRATION.md).
11
11
  - If an official ForgeLoop structured integration is available in your host, prefer it for protocol operations; otherwise use the project-local ForgeLoop CLI. Never simulate ForgeLoop-managed lifecycle, claim, recovery, ledger, or completion state directly.
12
12
  - Confirm [`PROJECT_PROFILE.md`](../PROJECT_PROFILE.md) from evidence; initialize if in `template` mode.
13
13
  - Select context with [`GUIDE_ROUTER.md`](../GUIDE_ROUTER.md) and report activated guide IDs.
package/AGENTS.md CHANGED
@@ -6,7 +6,7 @@ file, ForgeLoop applies regardless of model, provider, IDE, agent, or runtime.
6
6
  Do not treat ForgeLoop as vendor-specific, optional, or to follow only "in spirit".
7
7
 
8
8
  1. Follow platform rules, the user's latest request, and local instructions first.
9
- 1. Read [`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md) and [`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md).
9
+ 1. Read [`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md) from its Navigation section, loading each section before the phase it governs, and [`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md).
10
10
  1. If an official ForgeLoop structured integration is available in your host, prefer it for protocol operations; otherwise use the project-local ForgeLoop CLI. Never simulate ForgeLoop-managed lifecycle, claim, recovery, ledger, or completion state directly.
11
11
  1. Inspect [`PROJECT_PROFILE.md`](./PROJECT_PROFILE.md). Confirm facts from sources; initialize if in `template` mode.
12
12
  1. Use [`GUIDE_ROUTER.md`](./GUIDE_ROUTER.md) to select relevant guides and report activated guide IDs.
package/CLAUDE.md CHANGED
@@ -8,7 +8,7 @@ Do not treat ForgeLoop as vendor-specific, optional, or to follow only "in spiri
8
8
  When working in this repository:
9
9
 
10
10
  1. Follow higher-level instructions, the user's latest request, and local rules first.
11
- 1. Read [`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md) and [`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md).
11
+ 1. Read [`LOOP_ENGINEERING.md`](./LOOP_ENGINEERING.md) from its Navigation section, loading each section before the phase it governs, and [`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md).
12
12
  1. If an official ForgeLoop structured integration is available in your host, prefer it for protocol operations; otherwise use the project-local ForgeLoop CLI. Never simulate ForgeLoop-managed lifecycle, claim, recovery, ledger, or completion state directly.
13
13
  1. Verify [`PROJECT_PROFILE.md`](./PROJECT_PROFILE.md) against real sources; initialize if in `template` mode.
14
14
  1. Consult [`GUIDE_ROUTER.md`](./GUIDE_ROUTER.md), select relevant guides, and announce their IDs.
@@ -3,7 +3,7 @@ name: design-code-eng
3
3
  language: en
4
4
  description: "Visual direction, UX, motion, and perceived performance for premium digital experiences."
5
5
  version: "2026.09"
6
- last-reviewed: "2026-10-17"
6
+ last-reviewed: "2026-11-14"
7
7
  guide-id: design
8
8
  requires-gates:
9
9
  - design
@@ -29,7 +29,7 @@ Adopt this order as the default when creating a page from scratch; document an e
29
29
  5. **Reuse components and their interaction states**; adapt sample specifications to the product.
30
30
  6. **Add purposeful motion** only when it helps the experience, with reduced-motion and static fallbacks.
31
31
  7. **Run the Anti-Slop Checklist** before considering it ready.
32
- 8. **Audit and polish the affected experience** with the available project tools and direct browser/device inspection. Impeccable is an optional aid when installed and relevant; its availability is not a completion gate. Preserve the design system and recheck the changed states.
32
+ 8. **Audit and polish the affected experience** with the available project tools and direct browser/device inspection. When [Impeccable](https://impeccable.style/) is already available, its `audit` and `critique` commands can surface quality issues and `polish`/`harden` can address them in the changed scope; record the Impeccable version and the commands actually run. It is an optional aid: its availability or findings are not a completion gate, and it must not override the project's design system. Preserve the design system and recheck the changed states.
33
33
 
34
34
  Keep color and type decisions intentional. A familiar font, framework default, or repeated component is not a defect by itself; assess its fit, readability, hierarchy, and consistency in the actual interface.
35
35
 
@@ -324,6 +324,7 @@ appearance but cannot prove the state behavior or accessibility.
324
324
 
325
325
  **UI libraries and data visualization**
326
326
 
327
+ - Before adding JavaScript or a dependency for a UI behavior the platform may already provide (dialogs, popovers, tooltips via anchor positioning, view/entry-exit transitions, container queries, `field-sizing`, `:user-invalid` validation, scroll-driven effects), consult [Modern Web Guidance](https://developer.chrome.com/docs/modern-web-guidance) for the current native pattern and its fallback. Confirm each feature's Baseline status against the project's supported browser matrix, keep a lightweight fallback or progressive enhancement where support is incomplete, and preserve the design system and accessibility semantics. It is optional reference material: do not auto-install its CLI or skill, and treat its guidance as advice, not ForgeLoop evidence.
327
328
  - For accessible, composable, and customizable web components, consult [shadcn/ui](https://ui.shadcn.com/); adapt tokens, states, and composition to the project's visual system instead of copying defaults without intent.
328
329
  - For charts and data visualization, consult [TanStack Charts](https://github.com/TanStack/charts); preserve responsiveness, contrast, keyboard readability, and never rely on color alone to communicate series or states.
329
330
  - For subtle interaction sounds, consult [Cuelume](https://cuelume-site.pages.dev/); provide volume/mute controls and never rely on audio to communicate essential information.
@@ -594,7 +595,7 @@ For React-specific supplemental diagnostics after implementation, including desi
594
595
  - [ ] Where the platform exposes contrast/transparency preferences, including `prefers-contrast` or `forced-colors` when applicable, the opaque/less-transparent variant works; without a reliable media query, there is an equivalent in-product control.
595
596
  - [ ] No item from the "Blacklist" is present.
596
597
  - [ ] Tested at 320 CSS px reflow and desktop (1440px).
597
- - [ ] Reviewed the affected interface and states with available tools and browser/device evidence; optional Impeccable findings were addressed when that tool was used.
598
+ - [ ] Reviewed the affected interface and states with available tools and browser/device evidence; optional Impeccable findings (with the version and commands run) were addressed when that tool was used.
598
599
 
599
600
  ---
600
601
 
@@ -696,7 +697,7 @@ For React-specific supplemental diagnostics after implementation, including desi
696
697
 
697
698
  ## Sources and References (Base Skills)
698
699
 
699
- - TasteSkill / Anti-Slop: https://github.com/Leonxlnx/taste-skill | https://www.tasteskill.dev/
700
+ - Taste Skill (art direction and anti-slop review; MIT; adapted and version-pinned in the [Taste frontend guide](./taste-frontend-eng.md)): https://www.tasteskill.dev/ | https://github.com/Leonxlnx/taste-skill
700
701
  - Emil Kowalski (Design Engineering / Motion): https://github.com/emilkowalski/skills
701
702
  - GSAP: https://github.com/greensock/gsap-skills
702
703
  - ScrollWorld: https://github.com/oso95/scroll-world
@@ -706,6 +707,7 @@ For React-specific supplemental diagnostics after implementation, including desi
706
707
  - Apple Human Interface Guidelines (iOS/macOS): https://developer.apple.com/design/human-interface-guidelines/
707
708
  - Material Design 3 (Android): https://m3.material.io/
708
709
  - Microsoft Fluent Design / WinUI 3 (Windows): https://learn.microsoft.com/windows/apps/design/
710
+ - Modern Web Guidance (native web-platform patterns, fallbacks, and Baseline browser-compatibility guidance for coding agents; stewarded by the Chrome, Edge, Firefox, and MDN teams; Apache-2.0; referenced, not adapted; v1.0.0 current as of 2026-11-14): https://developer.chrome.com/docs/modern-web-guidance | https://github.com/GoogleChrome/modern-web-guidance
709
711
  - shadcn/ui (accessible, composable web components): https://ui.shadcn.com/
710
712
  - TanStack Charts (data visualization): https://github.com/TanStack/charts
711
713
  - Cuelume (web interaction sounds): https://cuelume-site.pages.dev/
@@ -716,7 +718,7 @@ For React-specific supplemental diagnostics after implementation, including desi
716
718
  - Pointer enhancement (only when `(hover: hover) and (pointer: fine)`; retain native controls/default cursor and equivalent tap interaction for touch/coarse pointers): https://cursify.ui-layouts.com/
717
719
  - Typography discovery (verify each font's author, license, weights, and hosting rights): https://uncut.wtf/
718
720
  - Creative coding and WebGL (semantic fallback, pause/offscreen behavior, performance budget, and asset/operator provenance): https://cables.gl/
719
- - Impeccable (interface auditing and polish): https://impeccable.style/
721
+ - Impeccable (design vocabulary and commands for building, auditing, refining, hardening, and documenting interfaces; Apache-2.0; referenced, not adapted; v4.9.1 current as of 2026-11-14): https://impeccable.style/ | https://github.com/pbakaus/impeccable | [command reference](https://impeccable.style/docs)
720
722
  - Gradient Studio (external procedural gradient exploration with CSS, Tailwind, and SCSS export by Amit Gajare; validate current provenance, reuse terms, output contrast, and performance budgets before adoption): https://gradientsaas.blogspot.com/
721
723
  - Liquid Glass Design (an independent inspiration gallery, not affiliated with Apple; not a specification or asset library): https://liquidglassdesign.com/
722
724
  - Guide to the material, glassmorphism, and web implementation: https://liquidglassdesign.com/what-is-liquid-glass
@@ -3,7 +3,7 @@ name: dotnet-aspnetcore-development-eng
3
3
  language: en
4
4
  description: "Specialist guide for architecture, implementation, testing, performance, security, data access, hosting, observability, and release of production .NET and ASP.NET Core applications."
5
5
  version: "2026.09"
6
- last-reviewed: "2026-10-13"
6
+ last-reviewed: "2026-11-14"
7
7
  guide-id: dotnet
8
8
  ---
9
9
 
@@ -75,9 +75,13 @@ Use structural project evidence for routing, but use source and configuration in
75
75
 
76
76
  ## 4. Version-sensitive decisions
77
77
 
78
- As of 2026-10-13, .NET 10 is the current LTS line; its latest patch is 10.0.12.
79
- .NET 9 is in maintenance and reaches end of support on 2026-11-10. These are
80
- dated references only: use the repository's pinned SDK and target framework.
78
+ .NET 10 is the current LTS line (supported until 2028-11-14; latest patch 10.0.15). .NET 8 and .NET 9
79
+ both reached end of support on 2026-11-10 and no longer receive security
80
+ updates; treat a repository still targeting them as carrying a supported-runtime
81
+ risk, and plan migration explicitly rather than as incidental cleanup. These are
82
+ dated references (reviewed 2026-11-14): use the repository's pinned SDK and
83
+ target framework, and check the official .NET support policy for the current
84
+ patch.
81
85
 
82
86
  Treat these as version-sensitive:
83
87
 
@@ -3,7 +3,7 @@ name: nodejs-backend-development-eng
3
3
  language: en
4
4
  description: "Specialist guidance for architecture, implementation, testing, security, performance, observability, and release of production Node.js backend services and workers."
5
5
  version: "2026.09"
6
- last-reviewed: "2026-10-13"
6
+ last-reviewed: "2026-11-14"
7
7
  guide-id: nodejs
8
8
  requires-gates:
9
9
  - threat-boundary
@@ -148,9 +148,12 @@ descendants; unrelated frontend packages remain isolated.
148
148
 
149
149
  ## 3. Runtime and module-system decisions
150
150
 
151
- As of 2026-10-13, Node.js 26 is Current and Node.js 24 is the latest LTS
152
- release. Production deployments should use an Active or Maintenance LTS line;
153
- check the official release schedule again when selecting a runtime.
151
+ As of 2026-11-14, Node.js 26 is Active LTS (promoted 2026-10-28) and Node.js 24
152
+ is Maintenance LTS. Node.js 26 is the last release on the twice-yearly
153
+ schedule; from Node.js 27 the project ships one major per year (April) and
154
+ promotes it to LTS each October. Production deployments should use an Active or
155
+ Maintenance LTS line; check the official release schedule again when selecting
156
+ a runtime.
154
157
 
155
158
  Record the actual runtime range before changing APIs:
156
159
 
@@ -3,7 +3,7 @@ name: sql-development-eng
3
3
  language: en
4
4
  description: "Specialist overlay guidance for SQL schemas, queries, migrations, and database-boundary changes."
5
5
  version: "2026.09"
6
- last-reviewed: "2026-10-13"
6
+ last-reviewed: "2026-11-14"
7
7
  guide-id: sql
8
8
  requires-gates:
9
9
  - threat-boundary
@@ -37,8 +37,9 @@ migration, reads credentials, or introspects a schema.
37
37
  The repository's database engine, version, migration policy, transaction model,
38
38
  compatibility window, and deployment process win over generic SQL advice. Use
39
39
  the matching engine's official reference first, then ISO/IEC 9075:2023 for
40
- portable semantics. The 2026-10-13 reference check covers PostgreSQL 18.6, MySQL 9.7 Innovation
41
- and 8.4 LTS, SQL Server 17 T-SQL, Oracle AI Database 26, and SQLite 3.54.0.
40
+ portable semantics. The 2026-11-14 reference check covers PostgreSQL 18.6, MySQL 9.7 LTS and
41
+ 8.4 LTS (Innovation releases now use calendar versions such as 26.7), SQL
42
+ Server 2025 (17.x) T-SQL, Oracle AI Database 26, and SQLite 3.54.0.
42
43
  These are reference points, not automatic upgrade targets.
43
44
 
44
45
  Never infer a dialect, isolation guarantee, identifier rule, timestamp
@@ -103,6 +104,6 @@ execution.
103
104
 
104
105
  - [SQLite SQL language](https://www.sqlite.org/lang.html)
105
106
  - [PostgreSQL documentation](https://www.postgresql.org/docs/)
106
- - [MySQL reference manuals](https://docs.oracle.com/cd/E17952_01/mysql-8.0-en/)
107
+ - [MySQL 9.7 reference manual](https://docs.oracle.com/cd/E17952_01/mysql-9.7-en/)
107
108
  - [Microsoft T-SQL reference](https://learn.microsoft.com/sql/t-sql/)
108
109
  - [Oracle Database SQL Language Reference](https://docs.oracle.com/en/database/oracle/oracle-database/)
@@ -3,7 +3,7 @@ name: taste-frontend-eng
3
3
  language: en
4
4
  description: "Contextual visual-taste review for premium frontend and brand-heavy work."
5
5
  version: "2026.09"
6
- last-reviewed: "2026-10-16"
6
+ last-reviewed: "2026-11-14"
7
7
  guide-id: taste
8
8
  ---
9
9
 
@@ -15,8 +15,9 @@ ForgeLoop router only when the work has that visual context. It is advisory: it
15
15
  does not create an approval gate, block an autonomous task, or require a
16
16
  specific framework, font, layout, animation library, or visual tool.
17
17
 
18
- The upstream inspiration is Taste Skill's design-read and anti-default
19
- approach. ForgeLoop keeps the useful review vocabulary while applying its own
18
+ The upstream inspiration is [Taste Skill](https://www.tasteskill.dev/)
19
+ ([source](https://github.com/Leonxlnx/taste-skill), MIT) and its design-read and
20
+ anti-default approach. ForgeLoop keeps the useful review vocabulary while applying its own
20
21
  protocol boundaries: user evidence, accessibility, performance, security, and
21
22
  the active product constraints have priority over aesthetic preference.
22
23
 
@@ -30,6 +31,15 @@ This identifies the upstream reference, not full feature parity or automatic
30
31
  synchronization. The guide's frontmatter version follows ForgeLoop's guide
31
32
  versioning separately.
32
33
 
34
+ As of 2026-11-14 the upstream repository is at
35
+ [v2.5.1](https://github.com/Leonxlnx/taste-skill/releases/tag/v2.5.1); that
36
+ release is not yet reviewed for this adaptation, so the guidance above still
37
+ reflects v2.0.0. When the optional upstream tools are used, use a copy whose
38
+ `design-taste-frontend` skill is 2.1.5 or later (see the
39
+ [upstream changelog](https://www.tasteskill.dev/changelog)): 2.1.5 escapes text
40
+ that `charts.js` and the split-heading fallback insert from user data, and
41
+ 2.1.4 stops one inspector run from deleting another run's browser profile.
42
+
33
43
  ForgeLoop adapts the content inventory, subject-specific concept, and screenshot
34
44
  correction practices. It deliberately keeps direction selection contextual
35
45
  rather than requiring a scripted draw. It does not adopt universal bans on
@@ -229,7 +239,9 @@ selected copy's requirements and output paths before use. Upstream tools may
229
239
  write project artifacts and user-level history outside ForgeLoop's evidence
230
240
  store; those files do not become attested evidence merely by existing.
231
241
 
232
- Prefer an available equivalent when it supports the same task checks. Treat
242
+ Prefer an available equivalent when it supports the same task checks; for
243
+ example, [Impeccable](https://impeccable.style/)'s `audit` and `critique`
244
+ commands cover a comparable interface review (see the Design guide). Treat
233
245
  upstream style findings as contextual recommendations, not new ForgeLoop gates.
234
246
  For external media, confirm the exact asset's license, attribution, and
235
247
  relevance; search results alone do not establish reuse rights. Identify found
@@ -242,7 +254,9 @@ evidence `NOT_VERIFIED` without claiming upstream tool coverage.
242
254
  For an existing interface, scan first and classify each issue as hierarchy,
243
255
  typography, color/contrast, composition, content, interaction, responsive
244
256
  behavior, accessibility, performance, or evidence. Fix the highest-leverage
245
- issues in small coherent batches. Re-read the whole system after each batch so
257
+ issues in small coherent batches. An optional interface auditor such as
258
+ Impeccable's `audit`/`critique` can seed this scan when it is already
259
+ available; its findings are recommendations, not ForgeLoop evidence. Re-read the whole system after each batch so
246
260
  local polish does not create a new inconsistency elsewhere.
247
261
 
248
262
  The final decision remains protocol-owned: this guide can recommend a visual
@@ -8,6 +8,27 @@ an execution environment appears in a compatibility list.
8
8
 
9
9
  <!-- FORGELOOP_PROJECT_PROTOCOL=REQUIRED -->
10
10
 
11
+ ## Navigation
12
+
13
+ - [Universal applicability](#universal-applicability)
14
+ - [Integration levels](#integration-levels)
15
+ - [Discovery surfaces](#discovery-surfaces)
16
+ - [Adaptive execution profiles and context presentation](#adaptive-execution-profiles-and-context-presentation)
17
+ - [Capability negotiation](#capability-negotiation)
18
+ - [CLI resolution policy](#cli-resolution-policy)
19
+ - [Protocol-owned state and no-simulation policy](#protocol-owned-state-and-no-simulation-policy)
20
+ - [Trusted command provenance](#trusted-command-provenance)
21
+ - [Missing tool capability](#missing-tool-capability)
22
+ - [Optional capability extensions](#optional-capability-extensions)
23
+ - [Delegation scope](#delegation-scope)
24
+ - [Instruction precedence](#instruction-precedence)
25
+ - [External workflow interaction](#external-workflow-interaction)
26
+ - [Harness and session continuity](#harness-and-session-continuity)
27
+ - [Structural quality integration](#structural-quality-integration)
28
+ - [Executable Policy Protocol Integration](#executable-policy-protocol-integration)
29
+ - [Structured integration surfaces](#structured-integration-surfaces)
30
+ - [Durable actions and authority boundary](#durable-actions-and-authority-boundary)
31
+
11
32
  ## Universal applicability
12
33
 
13
34
  If the active execution environment discovers a ForgeLoop project adapter,
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` targets
83
- `latest`; publication requires verified release 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
@@ -225,6 +225,7 @@ The contextual frontend taste guide is informed by Taste Skill:
225
225
 
226
226
  - Taste Skill, Copyright (c) 2026 Leonxlnx, MIT License.
227
227
  - Source: <https://github.com/leonxlnx/taste-skill>
228
+ - Project site: <https://www.tasteskill.dev/>
228
229
  - Reviewed baseline: [v2.0.0](https://github.com/Leonxlnx/taste-skill/tree/v2.0.0/skills/taste-skill),
229
230
  released 2026-10-13; adaptation reviewed 2026-10-16.
230
231
 
@@ -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.0.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. |