makea-cli 0.1.1__tar.gz → 0.1.6__tar.gz

makea_cli-0.1.6/.claude/skills/link-supplier-user/SKILL.md

@@ -0,0 +1,219 @@
+---
+
+## name: link-supplier-user
+description: >-
+  Links a newly registered Makea supplier user account to an existing supplier profile,
+  then backfills all corresponding quote requests. Use this skill whenever a supplier
+  has just signed up (or re-registered) and you need to connect their new Cognito user
+  to their pre-existing profile — e.g. "Caroline just registered, link her to CHINAWING",
+  "new supplier signup, backfill quotes", "link [person] to [company] supplier profile",
+  "supplier registered but their profile isn't showing", or any time you're told a supplier
+  user_id and an old supplier_id need to be aligned. Also triggers for follow-up tasks like
+  "delete the old supplier record" or "show me all quotes for [supplier]".
+
+# Link Supplier User → Existing Profile + Quote Backfill
+
+A newly registered supplier gets a Cognito `user_id` (their sub). If a supplier profile
+already exists under a different UUID (`old_supplier_id`), you need to migrate the profile
+so it lives under the user's Cognito sub — and backfill any quote requests that were created
+against the old ID. This skill walks through that end-to-end.
+
+---
+
+## Step 1 — Auth & CLI setup
+
+The makea-cli runs in a Linux sandbox, but credentials are stored on the user's Mac.
+Two things need to happen before any CLI commands will work:
+
+**1a. Refresh the token** (the stored token is often stale — the check script doesn't save
+refreshed tokens, so do it directly):
+
+```python
+import json, time, httpx
+from pathlib import Path
+
+CREDS_PATH = "/sessions/modest-brave-newton/mnt/Application Support--makea-cli/credentials.json"
+COGNITO_DOMAIN = "eu-west-1r9ghlpgky.auth.eu-west-1.amazoncognito.com"
+CLIENT_ID = "3nfj8g3et4o85kd6essas16vh0"
+
+creds = json.loads(Path(CREDS_PATH).read_text())
+r = httpx.post(
+    f"https://{COGNITO_DOMAIN}/oauth2/token",
+    data={"grant_type": "refresh_token", "client_id": CLIENT_ID,
+          "refresh_token": creds["refresh_token"]},
+    headers={"Content-Type": "application/x-www-form-urlencoded"},
+    timeout=15,
+)
+if r.status_code == 200:
+    data = r.json()
+    creds["id_token"] = data["id_token"]
+    creds["saved_at"] = time.time()
+    creds["expires_in"] = data.get("expires_in", 3600)
+    Path(CREDS_PATH).write_text(json.dumps(creds, indent=2))
+    print("Token refreshed")
+else:
+    print(f"Refresh failed ({r.status_code}): {r.text}")
+```
+
+If the refresh fails, the user's session has truly expired — ask them to run
+`makea-cli auth` in their Terminal (see the `makea-cli-setup` skill).
+
+**1b. Copy credentials to the Linux path** so the CLI can find them:
+
+```bash
+mkdir -p ~/.config/makea-cli
+cp "/sessions/modest-brave-newton/mnt/Application Support--makea-cli/credentials.json" \
+   ~/.config/makea-cli/credentials.json
+export PATH="$PATH:/sessions/modest-brave-newton/.local/bin"
+```
+
+Quick smoke-test:
+
+```bash
+makea-cli list-suppliers 2>&1 | head -3
+```
+
+If you see JSON, you're authenticated. If you see "尚未登录", the token is still broken.
+
+---
+
+## Step 2 — Find the supplier user
+
+You need the user's Cognito `user_id` (their `sub`). Search by name or email:
+
+```python
+import json, httpx
+from pathlib import Path
+
+TOKEN = json.loads(Path(CREDS_PATH).read_text())["id_token"]
+r = httpx.get("https://api.makea.co/admin/users",
+              headers={"Authorization": f"Bearer {TOKEN}"},
+              params={"limit": 50, "offset": 0}, timeout=15)
+users = r.json()["result"]
+
+search = "caroline"  # lowercase name or email fragment
+matches = [u for u in users if search in u.get("name","").lower()
+                             or search in u.get("email","").lower()]
+for u in matches:
+    print(u["user_id"], u["name"], u["email"], u["user_type"], u["created_at"])
+```
+
+Confirm with the user if there are multiple matches. The right one is typically
+`user_type: "Supplier"` and recently `created_at`.
+
+> If there are more than 50 users and you don't find a match, increase `limit` or page
+> through with `offset`.
+
+---
+
+## Step 3 — Find the old supplier profile
+
+```bash
+export PATH="$PATH:/sessions/modest-brave-newton/.local/bin"
+makea-cli list-suppliers | python3 -c "
+import json, sys
+data = json.load(sys.stdin)
+suppliers = data.get('result', [])
+search = 'chinawing'  # lowercase fragment of company name
+matches = [s for s in suppliers if search in str(s).lower()]
+for s in matches:
+    print(s['supplier_id'], s['name'], 'user_id:', s.get('supplier_user_id'))
+"
+```
+
+You're looking for the profile with `supplier_user_id: null` (not yet linked) or with
+a mismatched ID. If you see two profiles for the same company — one with `supplier_user_id`
+equal to the newly registered user, and one with `null` — the one with `null` is the
+"old" profile that needs to be migrated to the user's ID.
+
+---
+
+## Step 4 — Dry-run preview
+
+Always preview before writing anything:
+
+```bash
+makea-cli backfill-supplier-id \
+  --user-id "<cognito_sub / new user_id>" \
+  --old-supplier-id "<old profile UUID>" \
+  --dry-run
+```
+
+Read the output carefully. Key things to check:
+
+- **Step 1** found the right company name
+- **Step 3** lists the correct products
+- **Step 4** shows the expected number of links to patch
+- **Step 5** confirms quote request backfill will run for the right products
+- `errors` field is empty
+
+If the dry-run looks wrong (wrong company, unexpected products), stop and confirm IDs
+with the user before proceeding.
+
+---
+
+## Step 5 — Apply
+
+```bash
+makea-cli backfill-supplier-id \
+  --user-id "<cognito_sub>" \
+  --old-supplier-id "<old_supplier_id>" \
+  --apply
+```
+
+Summarise the result for the user:
+
+- How many product links were patched
+- How many products had QRs backfilled
+- Whether S3/document rows were migrated
+- Any errors
+
+---
+
+## Step 6 — Delete the old partition (optional)
+
+Only do this if the user explicitly asks. The old `SUPPLIER#{old_id}` partition is now
+marked `is_migrated` but still present. To remove it permanently:
+
+```bash
+makea-cli backfill-supplier-id \
+  --user-id "<cognito_sub>" \
+  --old-supplier-id "<old_supplier_id>" \
+  --apply \
+  --delete-old-supplier-at-end \
+  --confirm-delete-old-supplier
+```
+
+This is irreversible — make sure the apply in Step 5 succeeded cleanly first.
+
+---
+
+## Verification — list all quotes for the supplier
+
+After linking, verify by pulling all quote requests and supplier links for the new ID:
+
+```bash
+export PATH="$PATH:/sessions/modest-brave-newton/.local/bin"
+makea-cli get-quote-requests-by-supplier-id "<cognito_sub>"
+makea-cli get-supplier-links-by-supplier-id "<cognito_sub>"
+```
+
+Present the results as a clean table per product: link name, sampling price, production
+price tiers (with currency), lead times.
+
+> **Note on `is_archived`**: Backfill sets `is_archived: true` only when the related links
+> are **not** selected by a sampling order. If selected by a sampling order, the quote
+> request stays unarchived.
+
+---
+
+## Quick-reference: IDs across steps
+
+
+| Thing                            | Where to find it                                                                    |
+| -------------------------------- | ----------------------------------------------------------------------------------- |
+| Supplier `user_id` (Cognito sub) | `/admin/users` search by name/email                                                 |
+| Old `supplier_id`                | `makea-cli list-suppliers` — look for `supplier_user_id: null`                      |
+| Credentials path                 | `/sessions/modest-brave-newton/mnt/Application Support--makea-cli/credentials.json` |
+
+

{makea_cli-0.1.1 → makea_cli-0.1.6}/.claude/skills/supplier-user-id-migration/SKILL.md

@@ -103,7 +103,7 @@ Or verify first, then delete only:
 | Cognito `custom:supplierReferenceId` → `user_id` | Yes |
 | S3 + `DOCUMENT#` (unless skipped) | Yes |
 | Product `supplier_links` | Yes |
-| Quote requests from links | Yes (migration sets `is_archived=true` on touched QRs; step 5b archives stragglers under `old_supplier_id`) |
+| Quote requests from links | Yes (`is_archived=true` only when related links are not selected by a sampling order; step 5b applies same rule for stragglers under `old_supplier_id`) |
 | Sampling / production orders | Yes |
 
 ### Quote request `current_stage` / `status`

makea_cli-0.1.6/.claude/worktrees/vigilant-bartik-a79dc8/.claude/settings.local.json

@@ -0,0 +1,30 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(lark-cli im *)",
+      "Bash(lark-cli auth *)",
+      "Read(//tmp/**)",
+      "Bash(jobs)",
+      "Bash(wait)",
+      "Bash(python3 -c ' *)",
+      "mcp__Claude_in_Chrome__tabs_context_mcp",
+      "WebFetch(domain:www.pietra.co)",
+      "WebFetch(domain:www.zyod.com)",
+      "WebFetch(domain:techpacker.com)",
+      "WebSearch",
+      "WebFetch(domain:help.pietrastudio.com)",
+      "WebFetch(domain:backboneplm.com)",
+      "WebFetch(domain:www.onbrandplm.com)",
+      "WebFetch(domain:www.kobolabs.io)",
+      "WebFetch(domain:bamboorose.com)",
+      "WebFetch(domain:www.limitless.builders)",
+      "WebFetch(domain:yourstory.com)",
+      "WebFetch(domain:www.pietrastudio.com)",
+      "WebFetch(domain:www.getapp.com)",
+      "WebFetch(domain:helpcenter.techpacker.com)",
+      "WebFetch(domain:fashionvaluechain.com)",
+      "WebFetch(domain:inc42.com)",
+      "WebFetch(domain:www.g2.com)"
+    ]
+  }
+}

makea_cli-0.1.6/.claude/worktrees/vigilant-bartik-a79dc8/.claude/skills/link-supplier-user/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: link-supplier-user
+description: >-
+  Links a newly registered Makea supplier user account to an existing supplier profile,
+  then backfills all corresponding quote requests. Use this skill whenever a supplier
+  has just signed up (or re-registered) and you need to connect their new Cognito user
+  to their pre-existing profile — e.g. "Caroline just registered, link her to CHINAWING",
+  "new supplier signup, backfill quotes", "link [person] to [company] supplier profile",
+  "supplier registered but their profile isn't showing", or any time you're told a supplier
+  user_id and an old supplier_id need to be aligned. Also triggers for follow-up tasks like
+  "delete the old supplier record" or "show me all quotes for [supplier]".
+---
+
+# Link Supplier User → Existing Profile + Quote Backfill
+
+A newly registered supplier gets a Cognito `user_id` (their sub). If a supplier profile
+already exists under a different UUID (`old_supplier_id`), you need to migrate the profile
+so it lives under the user's Cognito sub — and backfill any quote requests that were created
+against the old ID. This skill walks through that end-to-end.
+
+---
+
+## Step 1 — Auth & CLI setup
+
+The makea-cli runs in a Linux sandbox, but credentials are stored on the user's Mac.
+Two things need to happen before any CLI commands will work:
+
+**1a. Refresh the token** (the stored token is often stale — the check script doesn't save
+refreshed tokens, so do it directly):
+
+```python
+import json, time, httpx
+from pathlib import Path
+
+CREDS_PATH = "/sessions/modest-brave-newton/mnt/Application Support--makea-cli/credentials.json"
+COGNITO_DOMAIN = "eu-west-1r9ghlpgky.auth.eu-west-1.amazoncognito.com"
+CLIENT_ID = "3nfj8g3et4o85kd6essas16vh0"
+
+creds = json.loads(Path(CREDS_PATH).read_text())
+r = httpx.post(
+    f"https://{COGNITO_DOMAIN}/oauth2/token",
+    data={"grant_type": "refresh_token", "client_id": CLIENT_ID,
+          "refresh_token": creds["refresh_token"]},
+    headers={"Content-Type": "application/x-www-form-urlencoded"},
+    timeout=15,
+)
+if r.status_code == 200:
+    data = r.json()
+    creds["id_token"] = data["id_token"]
+    creds["saved_at"] = time.time()
+    creds["expires_in"] = data.get("expires_in", 3600)
+    Path(CREDS_PATH).write_text(json.dumps(creds, indent=2))
+    print("Token refreshed")
+else:
+    print(f"Refresh failed ({r.status_code}): {r.text}")
+```
+
+If the refresh fails, the user's session has truly expired — ask them to run
+`makea-cli auth` in their Terminal (see the `makea-cli-setup` skill).
+
+**1b. Copy credentials to the Linux path** so the CLI can find them:
+
+```bash
+mkdir -p ~/.config/makea-cli
+cp "/sessions/modest-brave-newton/mnt/Application Support--makea-cli/credentials.json" \
+   ~/.config/makea-cli/credentials.json
+export PATH="$PATH:/sessions/modest-brave-newton/.local/bin"
+```
+
+Quick smoke-test:
+```bash
+makea-cli list-suppliers 2>&1 | head -3
+```
+If you see JSON, you're authenticated. If you see "尚未登录", the token is still broken.
+
+---
+
+## Step 2 — Find the supplier user
+
+You need the user's Cognito `user_id` (their `sub`). Search by name or email:
+
+```python
+import json, httpx
+from pathlib import Path
+
+TOKEN = json.loads(Path(CREDS_PATH).read_text())["id_token"]
+r = httpx.get("https://api.makea.co/admin/users",
+              headers={"Authorization": f"Bearer {TOKEN}"},
+              params={"limit": 50, "offset": 0}, timeout=15)
+users = r.json()["result"]
+
+search = "caroline"  # lowercase name or email fragment
+matches = [u for u in users if search in u.get("name","").lower()
+                             or search in u.get("email","").lower()]
+for u in matches:
+    print(u["user_id"], u["name"], u["email"], u["user_type"], u["created_at"])
+```
+
+Confirm with the user if there are multiple matches. The right one is typically
+`user_type: "Supplier"` and recently `created_at`.
+
+> If there are more than 50 users and you don't find a match, increase `limit` or page
+> through with `offset`.
+
+---
+
+## Step 3 — Find the old supplier profile
+
+```bash
+export PATH="$PATH:/sessions/modest-brave-newton/.local/bin"
+makea-cli list-suppliers | python3 -c "
+import json, sys
+data = json.load(sys.stdin)
+suppliers = data.get('result', [])
+search = 'chinawing'  # lowercase fragment of company name
+matches = [s for s in suppliers if search in str(s).lower()]
+for s in matches:
+    print(s['supplier_id'], s['name'], 'user_id:', s.get('supplier_user_id'))
+"
+```
+
+You're looking for the profile with `supplier_user_id: null` (not yet linked) or with
+a mismatched ID. If you see two profiles for the same company — one with `supplier_user_id`
+equal to the newly registered user, and one with `null` — the one with `null` is the
+"old" profile that needs to be migrated to the user's ID.
+
+---
+
+## Step 4 — Dry-run preview
+
+Always preview before writing anything:
+
+```bash
+makea-cli backfill-supplier-id \
+  --user-id "<cognito_sub / new user_id>" \
+  --old-supplier-id "<old profile UUID>" \
+  --dry-run
+```
+
+Read the output carefully. Key things to check:
+- **Step 1** found the right company name
+- **Step 3** lists the correct products
+- **Step 4** shows the expected number of links to patch
+- **Step 5** confirms quote request backfill will run for the right products
+- `errors` field is empty
+
+If the dry-run looks wrong (wrong company, unexpected products), stop and confirm IDs
+with the user before proceeding.
+
+---
+
+## Step 5 — Apply
+
+```bash
+makea-cli backfill-supplier-id \
+  --user-id "<cognito_sub>" \
+  --old-supplier-id "<old_supplier_id>" \
+  --apply
+```
+
+Summarise the result for the user:
+- How many product links were patched
+- How many products had QRs backfilled
+- Whether S3/document rows were migrated
+- Any errors
+
+---
+
+## Step 6 — Delete the old partition (optional)
+
+Only do this if the user explicitly asks. The old `SUPPLIER#{old_id}` partition is now
+marked `is_migrated` but still present. To remove it permanently:
+
+```bash
+makea-cli backfill-supplier-id \
+  --user-id "<cognito_sub>" \
+  --old-supplier-id "<old_supplier_id>" \
+  --apply \
+  --delete-old-supplier-at-end \
+  --confirm-delete-old-supplier
+```
+
+This is irreversible — make sure the apply in Step 5 succeeded cleanly first.
+
+---
+
+## Verification — list all quotes for the supplier
+
+After linking, verify by pulling all quote requests and supplier links for the new ID:
+
+```bash
+export PATH="$PATH:/sessions/modest-brave-newton/.local/bin"
+makea-cli get-quote-requests-by-supplier-id "<cognito_sub>"
+makea-cli get-supplier-links-by-supplier-id "<cognito_sub>"
+```
+
+Present the results as a clean table per product: link name, sampling price, production
+price tiers (with currency), lead times.
+
+> **Note on `is_archived`**: Backfill sets `is_archived: true` only when the related links
+> are **not** selected by a sampling order. If selected by a sampling order, the quote
+> request stays unarchived.
+
+---
+
+## Quick-reference: IDs across steps
+
+| Thing | Where to find it |
+|---|---|
+| Supplier `user_id` (Cognito sub) | `/admin/users` search by name/email |
+| Old `supplier_id` | `makea-cli list-suppliers` — look for `supplier_user_id: null` |
+| Credentials path | `/sessions/modest-brave-newton/mnt/Application Support--makea-cli/credentials.json` |