Skip to content

docs: add logs, docs, functions delete, and schedules commands #16#22

Merged
jwfing merged 4 commits intoInsForge:mainfrom
evergreenx:feat/readme-updates-16
Mar 17, 2026
Merged

docs: add logs, docs, functions delete, and schedules commands #16#22
jwfing merged 4 commits intoInsForge:mainfrom
evergreenx:feat/readme-updates-16

Conversation

@evergreenx
Copy link
Contributor

@evergreenx evergreenx commented Mar 14, 2026

Summary by CodeRabbit

  • Documentation
    • Added README sections for four CLI commands with expanded usage, options, and multiple examples:
      • insforge logs — usage, sources, options, and examples for fetching logs.
      • insforge docs — features, languages, and example usages for SDK docs.
      • insforge functions delete — deletion command with confirmation-toggle example.
      • insforge schedules — full CRUD and logs workflows with multiple examples.
    • No existing commands or public interfaces were removed or changed.

@coderabbitai
Copy link

coderabbitai bot commented Mar 14, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 0d53dc52-dbe7-4925-b26c-e4761c06770a

📥 Commits

Reviewing files that changed from the base of the PR and between 6099192 and 9f12145.

📒 Files selected for processing (1)
  • README.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

Walkthrough

Adds four README CLI command sections—insforge logs, insforge docs, insforge functions delete, and insforge schedules—as documentation-only additions; no code or public API changes.

Changes

Cohort / File(s) Summary
CLI Command Documentation
README.md
Adds detailed usage, options, and examples for insforge logs, insforge docs, insforge functions delete, and insforge schedules. Documentation-only edits; no behavioral or API changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related issues

Poem

🐇 I hopped through README rows tonight,
I tucked four commands in tidy light.
Logs to peek and docs to share,
Functions gone with one small dare,
Schedules dancing into sight. 🥕

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title accurately describes the main changes: it lists the specific CLI commands being documented (logs, docs, functions delete, schedules) and clearly indicates this is a documentation addition.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@evergreenx
Copy link
Contributor Author

Closes #16

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 148-154: Update the README section for the insforge docs command
to document its optional positional arguments and examples: state that the
command accepts optional [feature] and [language] arguments, list supported
features (db, storage, functions, auth, ai, realtime) and supported languages
(typescript, swift, kotlin, rest-api), and add several usage examples
demonstrating both listing all docs (insforge docs) and filtered invocations
(e.g., insforge docs db typescript, insforge docs auth swift, insforge docs
storage rest-api) so users understand the command's flexibility.
- Around line 140-146: Update the README entry for the insforge logs command to
document the allowed <source> values and the --limit option and add usage
examples: state that <source> must be one of insforge.logs, postgREST.logs,
postgres.logs, or function.logs, document that --limit controls how many entries
are returned (default 20), and include at least two concrete examples such as
"insforge logs insforge.logs" and "insforge logs postgres.logs --limit 50" so
users can run the command without invoking --help.
- Around line 436-442: The README's schedules section only documents `insforge
schedules list`; add full documentation entries for the remaining subcommands:
`insforge schedules get`, `insforge schedules create`, `insforge schedules
update`, `insforge schedules delete`, and `insforge schedules logs`. For each
subcommand follow the same format as other command groups: a short description,
required flags/arguments (e.g., schedule ID or name), and a usage example (bash
block) showing typical options (for create/update include spec/cron/target
flags, for logs include --follow/--tail or --since as applicable). Ensure the
headings match the existing style (e.g., "Schedules — `insforge schedules`"
subsections) and mirror phrasing and examples used in `db`, `functions`,
`storage` sections for consistency.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: d7635bf0-64f0-4205-95c2-95b6dcec38fb

📥 Commits

Reviewing files that changed from the base of the PR and between 9c3bebc and 8c4161d.

📒 Files selected for processing (1)
  • README.md

Copy link
Member

@jwfing jwfing left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the comments of coderabbit are reasonable.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 303-309: Replace the placeholder usage for the insforge functions
delete command with concrete examples: show "insforge functions delete
my-function" and include the non-interactive variant "insforge functions delete
my-function -y  # skip confirmation" so the README's style matches other
commands; update the section containing the "insforge functions delete" heading
and usage block accordingly.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a1cb6ae1-f9e9-48b1-83d4-a99d136c2921

📥 Commits

Reviewing files that changed from the base of the PR and between 8c4161d and 932eb64.

📒 Files selected for processing (1)
  • README.md

@evergreenx evergreenx requested a review from jwfing March 15, 2026 08:26
README.md Outdated
insforge docs

# Specific feature/language docs
insforge docs db typescript
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

insforge docs instructions Show setup instructions
please add it into README, setup instructions is very important for being aware the entire backend.

Copy link
Member

@jwfing jwfing left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR has been significantly updated since my last review, thanks for your effort.
I think I can merge it If you add insforge docs instructions.

@evergreenx evergreenx requested a review from jwfing March 15, 2026 22:03
@jwfing jwfing merged commit 832ec9c into InsForge:main Mar 17, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants