From 15bda6aa5cf1e87d187fd4842a4d2c40526260f3 Mon Sep 17 00:00:00 2001
From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com>
Date: Sun, 28 Jun 2026 08:26:09 +0000
Subject: [PATCH] chore(base44-cli): sync skill to v0.0.57

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CLI_VERSION                                    |  2 +-
 skills/base44-cli/SKILL.md                     |  2 +-
 skills/base44-troubleshooter/SKILL.md          |  6 +++++-
 .../references/project-logs.md                 | 18 ++++++++++++++----
 4 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/CLI_VERSION b/CLI_VERSION
index 72e83b9..ff472ce 100644
--- a/CLI_VERSION
+++ b/CLI_VERSION
@@ -1 +1 @@
-v0.0.56
+v0.0.57
\ No newline at end of file
diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md
index bed8bd4..60c3a33 100644
--- a/skills/base44-cli/SKILL.md
+++ b/skills/base44-cli/SKILL.md
@@ -4,7 +4,7 @@ description: "The base44 CLI is used for EVERYTHING related to base44 projects:
 metadata:
   sourcePackage:
     name: base44
-    version: 0.0.56
+    version: 0.0.57
 ---
 
 # Base44 CLI
diff --git a/skills/base44-troubleshooter/SKILL.md b/skills/base44-troubleshooter/SKILL.md
index 60a346f..52412a4 100644
--- a/skills/base44-troubleshooter/SKILL.md
+++ b/skills/base44-troubleshooter/SKILL.md
@@ -57,10 +57,14 @@ npx base44 logs --app-id app_123 --function <function_name> --level error
 
 ### 3. Inspect a Time Range
 
-Correlate with user-reported issue timestamps:
+Correlate with user-reported issue timestamps. Both ISO datetimes and relative shorthands are supported:
 
 ```bash
+# Absolute time range
 npx base44 logs --function <function_name> --since <start_time> --until <end_time>
+
+# Relative shorthand (last hour, last 30 minutes, last 2 days)
+npx base44 logs --function <function_name> --since 1h
 ```
 
 ### 4. Analyze the Logs
diff --git a/skills/base44-troubleshooter/references/project-logs.md b/skills/base44-troubleshooter/references/project-logs.md
index 6b14b1d..6532413 100644
--- a/skills/base44-troubleshooter/references/project-logs.md
+++ b/skills/base44-troubleshooter/references/project-logs.md
@@ -15,11 +15,12 @@ This command can run from a linked project, or outside a project when you pass `
 | Option | Description | Required |
 |--------|-------------|----------|
 | `--function <names>` | Filter by function name(s), comma-separated. If omitted, fetches logs for all functions in the current app | No |
-| `--since <datetime>` | Show logs from this time (ISO format) | No |
-| `--until <datetime>` | Show logs until this time (ISO format) | No |
+| `--since <datetime>` | Show logs from this time. ISO datetime or relative shorthand (e.g. `1h`, `30m`, `2d`) | No |
+| `--until <datetime>` | Show logs until this time. ISO datetime or relative shorthand (e.g. `1h`, `30m`, `2d`) | No |
 | `--level <level>` | Filter by log level: `log`, `info`, `warn`, `error`, `debug` | No |
 | `-n, --limit <n>` | Number of results to return (1-1000, default: 50) | No |
 | `--order <order>` | Sort order: `asc` or `desc` (default: `desc`) | No |
+| `--json` | Output as JSON (clean stdout, safe to pipe to `jq`) | No |
 
 ## Examples
 
@@ -39,9 +40,14 @@ npx base44 logs --function my-function
 # Fetch logs for multiple functions
 npx base44 logs --function send-email,process-payment
 
-# Fetch logs since a specific time
+# Fetch logs since a specific time (ISO format)
 npx base44 logs --since 2024-01-15T10:00:00
 
+# Fetch logs since a relative time (last hour, last 30 minutes, last 2 days)
+npx base44 logs --since 1h
+npx base44 logs --since 30m
+npx base44 logs --since 2d
+
 # Fetch logs within a time range
 npx base44 logs --since 2024-01-15T10:00:00 --until 2024-01-15T12:00:00
 
@@ -50,6 +56,9 @@ npx base44 logs -n 100 --order asc
 
 # Last 10 errors for a specific function
 npx base44 logs --function myFunction --level error --limit 10
+
+# Output as JSON and pipe to jq
+npx base44 logs --json | jq '.[] | select(.level == "error")'
 ```
 
 ## Notes
@@ -59,4 +68,5 @@ npx base44 logs --function myFunction --level error --limit 10
 - When multiple functions are specified, logs are merged and sorted by timestamp.
 - If `--function` is omitted, logs are fetched for **all functions** in the current app.
 - The `--limit` applies after merging logs from all specified functions.
-- The `--since` and `--until` values are normalized to UTC if no timezone is provided (appends `Z`).
+- The `--since` and `--until` values accept ISO datetimes or relative shorthands (`1h`, `30m`, `2d`, etc.). Relative values are resolved to absolute UTC timestamps at the time the command runs.
+- Use `--json` to get machine-readable output suitable for piping to `jq`.