snipara-companion 3.2.18 → 3.2.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -68,24 +68,24 @@ your current checkout in seconds, before an agent edits the wrong thing.
68
68
 
69
69
  These commands are useful without hosted Snipara:
70
70
 
71
- | Command | What it gives you locally |
72
- | ------------------------------------------------------------ | ------------------------------------------------------------ |
73
- | `source init` / `source sync` / `source status` | Local source snapshot, document preview, and code overlay |
74
- | `impact` / `code impact` | File-level blast-radius from the local code overlay |
75
- | `reality-check` | Intent Ledger, Unknown Registry, and verification checks |
76
- | `code callers` / `imports` / `neighbors` / `shortest-path` | Structural repo questions from local files |
77
- | `workflow start` / `phase-start` / `phase-commit` / `resume` | Agent continuity that survives compaction |
78
- | `workflow timeline` / `workflow session` | Append-only local activity log and Session Snapshot V0 |
79
- | `workflow decisions` / `workflow decide` | Local human decision requests and response receipts |
80
- | `workflow policy-ledger` / `workflow apply-decisions` | Project Policy review ledger and explicit apply pipeline |
81
- | `run --emit-policy-decisions` | Project Policy review requests in the agent workflow |
82
- | `workflow producer-triage` | Ask for human review of unreviewed Producer Loop samples |
83
- | `workflow producer-report` | Local Producer Loop adoption and calibration report |
84
- | `workflow producer-review` | Mark local Producer Loop samples reviewed or rejected |
85
- | `context-pack` | Reversible local packs for long logs, diffs, and tool output |
86
- | `judgment-card`, `verify`, `lead-plan`, `agent-readiness` | Local review artifacts and delegation contracts |
87
- | `intelligence ledger-export` | Structured redacted ledger JSON for replay and review |
88
- | `stuck-guard`, `memory-guard`, `pre-tool`, `post-tool` | Fail-soft local guards and hook helpers |
71
+ | Command | What it gives you locally |
72
+ | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
73
+ | `source init` / `source sync` / `source status` | Local source snapshot, document preview, and code overlay |
74
+ | `impact` / `code impact` | File-level blast-radius from the local code overlay |
75
+ | `reality-check` | Intent Ledger, Unknown Registry, and verification checks |
76
+ | `code callers` / `imports` / `neighbors` / `shortest-path` | Structural repo questions from local files |
77
+ | `workflow start` / `phase-start` / `phase-commit` / `resume` | Agent continuity that survives compaction |
78
+ | `workflow timeline` / `workflow session` | Append-only local activity log and Session Snapshot V0 |
79
+ | `workflow decisions` / `workflow decide` | Local human decision requests and response receipts |
80
+ | `workflow policy-ledger` / `workflow apply-decisions` / `workflow sync-policy-ledger` | Project Policy review ledger, explicit apply pipeline, and hosted audit sync |
81
+ | `run --emit-policy-decisions` | Project Policy review requests in the agent workflow |
82
+ | `workflow producer-triage` | Ask for human review of unreviewed Producer Loop samples |
83
+ | `workflow producer-report` | Local Producer Loop adoption and calibration report |
84
+ | `workflow producer-review` | Mark local Producer Loop samples reviewed or rejected |
85
+ | `context-pack` | Reversible local packs for long logs, diffs, and tool output |
86
+ | `judgment-card`, `verify`, `lead-plan`, `agent-readiness` | Local review artifacts and delegation contracts |
87
+ | `intelligence ledger-export` | Structured redacted ledger JSON for replay and review |
88
+ | `stuck-guard`, `memory-guard`, `pre-tool`, `post-tool` | Fail-soft local guards and hook helpers |
89
89
 
90
90
  ### Local Worker Registry
91
91
 
@@ -148,6 +148,7 @@ npx -y snipara-companion workflow decisions
148
148
  npx -y snipara-companion workflow policy-ledger
149
149
  npx -y snipara-companion workflow decide decision-abc123 --choose accept_all --reviewer alice
150
150
  npx -y snipara-companion workflow apply-decisions --dry-run
151
+ npx -y snipara-companion workflow sync-policy-ledger
151
152
  npx -y snipara-companion workflow timeline
152
153
  npx -y snipara-companion workflow timeline --export md
153
154
  npx -y snipara-companion workflow session --json
@@ -205,6 +206,10 @@ local follow-up actions for resolved Project Policy receipts. Running
205
206
  `workflow apply-decisions` writes only idempotent review artifacts such as local
206
207
  policy drafts under `.snipara/policies/drafts/`; it does not activate canonical
207
208
  Project Policy silently.
209
+ Run `workflow sync-policy-ledger` after local review to upload Decision Request,
210
+ resolution, apply receipt, and policy draft artifacts into the hosted Project
211
+ Policy ledger. The sync is audit-only and does not approve, refuse, activate, or
212
+ edit canonical Project Policy.
208
213
  Other producers such as `outcome-capture preview --emit-decisions`,
209
214
  `memory reviews --emit-decisions`, `workflow decision-producer memory`, and
210
215
  `workflow decision-producer context-risk` emit requests with their existing apply