shiply-cli 0.14.4 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shiply-cli",
-  "version": "0.14.4",
+  "version": "0.15.0",
   "description": "Publish static sites to shiply.now from the command line — instant web hosting for agents.",
   "license": "MIT",
   "type": "module",

package/skill/SKILL.md

@@ -18,7 +18,7 @@ description: Publish static sites to the web instantly with shiply.now and manag
 > fresh — your cached copy may be missing features like databases, projects,
 > marketplace, or sending domains.
 >
-> **Last updated: 2026-06-20**
+> **Last updated: 2026-06-21**
 
 ---
 
@@ -493,6 +493,56 @@ CLI: `shiply project ls · shiply project create <label> [--customer-email <e>]
 
 Docs: https://shiply.now/docs/projects
 
+## Contracts — draft, sign, amend (extends Projects)
+
+Once a project reaches `brief_ready`, the dev drafts a signed contract from
+the brief, the customer e-signs in the portal (typed-name + checkbox), and
+the dev amends it later as scope evolves. A signed contract is immutable
+— any change is a new amendment row chained off the parent. The portal
+sends the customer; the dev can resend / remind / retract. A 7-day
+reminder cron nudges unsigned contracts automatically.
+
+MCP tools:
+```
+contract_draft   — draft a contract from a brief_ready project (returns the new contract id)
+contract_send    — flip status='sent', fire customer email (parent OR amendment)
+contract_amend   — create an amendment draft on a SIGNED parent (scopeDelta required, fee + date optional)
+contract_status  — read state + amendments (poll this to see status='signed')
+contract_pdf     — base64-encoded signed PDF (parent + cert + signed amendments)
+```
+
+Edit-before-send today is REST-only: `PATCH /api/v1/contracts/{id}` lets
+the dev tweak the 8 fields (scopeSummary, feeCents, currency, dates,
+revisionCount, revisionOverageCents, jurisdiction). After PATCH, call
+`contract_send` to fire it. Amendments are sent the same way (call
+`contract_send` with the amendment id returned by `contract_amend`).
+
+Example agent flow (draft → tweak fee → send → poll → amend):
+1. `contract_draft({projectId})` → returns `{id, scopeSummary, feeCents:null, ...}`
+2. `PATCH /api/v1/contracts/{id}` `{feeCents: 450000}` (Bearer key)
+3. `contract_send({contractId: id})` → project flips to `contract_sent`
+4. Poll `contract_status({contractId: id})` until `contract.status === 'signed'`
+5. `contract_amend({parentContractId: id, scopeDelta: "Add login flow", feeDeltaCents: 50000})` → returns the amendment row
+6. `contract_send({contractId: amendment.id})` (no PATCH needed if the amend fields are right)
+
+REST (Bearer for dev, portal cookie for customer):
+`POST /api/v1/projects/{id}/contracts` (draft) ·
+`GET/PATCH /api/v1/contracts/{id}` (read either-party / dev edit) ·
+`POST /api/v1/contracts/{id}/send` (dev) ·
+`POST /api/v1/contracts/{id}/view` (customer ping) ·
+`POST /api/v1/contracts/{id}/sign` (customer e-sign) ·
+`POST /api/v1/contracts/{id}/retract` (dev; `?recoverAsDraft=true` to
+recover the draft instead of voiding) ·
+`POST /api/v1/contracts/{id}/amend` (dev; signed parents only) ·
+`POST /api/v1/contracts/{id}/remind` ·
+`POST /api/v1/contracts/{id}/resend` (manual nudges, rate-limited 3/24h) ·
+`GET /api/v1/contracts/{id}/pdf` (binary, signed only).
+
+`contract_pdf` returns `{filename, contentType:"application/pdf", base64,
+byteLength}` so the MCP client can decode and save the bytes.
+
+Docs: https://shiply.now/docs/contracts
+
 ## Marketplace — sell built sites
 
 Devs can list any owned site for sale: set a price + short pitch, choose