feat(logs): add --env flag to fetch preview, prod, or all logs

[ImriKochWix]

Note

Description

Enhances the base44 logs command with environment targeting, a JSON output format, and ergonomic relative-time shortcuts. Logs now default to the preview environment, support --env preview|prod selection (with a helpful empty-state hint for unpublished production apps), and can emit machine-readable JSON via --format json for scripting and piping. The per-function fetch logic is also refactored into a dedicated helper for clarity.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe):

Changes Made

• Added --env <preview|prod> option to fetch logs from a specific environment, defaulting to preview; the env filter is plumbed through FunctionLogFilters and the logs query string.
• Added --format <text|json> option (default text); --format json prints pretty-printed JSON, suppresses the outro message, and runs the command in quiet/raw output mode via Base44Command.isRawOutputMode().
• Added relative-time shortcuts for --since/--until (e.g. 1h, 30m, 7d), resolved to ISO timestamps in normalizeDatetime().
• Added a tailored empty-state hint when no production logs are found, suggesting the app may be unpublished and pointing to --env preview.
• Extracted per-function log fetching (including the 404 "function not found" handling) into a fetchLogsForFunction() helper.
• Added tests covering JSON output, invalid --format rejection, and relative --since shortcuts.

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (npm test)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated docs/ (AGENTS.md) if I made architectural changes

Additional Notes

The --env all option from an earlier iteration was dropped; logs now default to preview. JSON output is designed to be pipe-friendly (banner and outro suppressed) for downstream tooling.

---

_{🤖 Generated by Claude | 2026-06-24 07:53 UTC | 6632e1b}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.56-pr.551.6632e1b

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/cli@0.0.56-pr.551.6632e1b"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.56-pr.551.6632e1b"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.0.56-pr.551.6632e1b
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}