This repository was archived by the owner on Mar 23, 2026. It is now read-only.
Conversation
There was a problem hiding this comment.
Pull request overview
Adds a new Go-based AppLogger CLI (with contract/integration tests and CI workflow), expands ES operational documentation + agent skills for Supabase/SDK/CLI configuration, hardens Supabase RLS docs/migrations, and bumps SDK version references to 0.1.1-alpha.2 across build and docs.
Changes:
- Introduce
cli/implementation (cobra commands, Supabase telemetry querying, TOON agent output) plus integration contract tests. - Add/expand ES docs for CLI installation/usage/Supabase operations and new agent skill packages; add migration
006and an index for log tag filtering. - Bump SDK version strings/references to
0.1.1-alpha.2across Gradle + docs + samples.
Reviewed changes
Copilot reviewed 63 out of 65 changed files in this pull request and generated 12 comments.
Show a summary per file
| File | Description |
|---|---|
| sdk/scripts/publish.gradle.kts | Updates publishing fallback version to 0.1.1-alpha.2. |
| sdk/sample/build.gradle.kts | Updates sample dependency comments to 0.1.1-alpha.2. |
| sdk/logger-transport-supabase/src/jvmTest/kotlin/com/applogger/transport/supabase/SupabaseE2ETest.kt | Updates test device appVersion string. |
| sdk/logger-core/src/commonMain/kotlin/com/applogger/core/AppLoggerVersion.kt | Bumps AppLoggerVersion.NAME to 0.1.1-alpha.2. |
| sdk/gradle/libs.versions.toml | Updates applogger version to 0.1.1-alpha.2. |
| sdk/gradle.properties | Updates VERSION_NAME to 0.1.1-alpha.2. |
| sdk/build.gradle.kts | Updates project/subproject version fallback to 0.1.1-alpha.2. |
| sdk/Package.swift | Updates XCFramework remote URL comment to v0.1.1-alpha.2. |
| sdk/AppLogger.podspec | Updates CocoaPods version to 0.1.1-alpha.2. |
| docs/ES/paquete/testing.md | Updates doc header version to 0.1.1-alpha.2. |
| docs/ES/paquete/publishing.md | Updates publishing guide version/examples to 0.1.1-alpha.2. |
| docs/ES/paquete/architecture.md | Updates doc header + dependency examples to 0.1.1-alpha.2. |
| docs/ES/paquete/README.md | Updates dependency snippet to 0.1.1-alpha.2. |
| docs/ES/paquete/CONTRIBUTING.md | Updates referenced SDK version for issue reports. |
| docs/ES/migraciones/006_harden_authenticated_read_policies.sql | Adds migration to remove global authenticated read policies. |
| docs/ES/migraciones/004_rls_policies.sql | Expands RLS guidance and clarifies anon vs service_role usage model. |
| docs/ES/migraciones/003_create_indexes.sql | Adds tag index for CLI filtering performance. |
| docs/ES/desarrollo/monitoring-app.md | Updates doc header version to 0.1.1-alpha.2. |
| docs/ES/desarrollo/integration-guide.md | Updates integration guide version + dependency examples to 0.1.1-alpha.2. |
| docs/ES/desarrollo/api-compatibility.md | Updates compatibility matrix version to 0.1.1-alpha.2. |
| docs/ES/cli/references/BEST_PRACTICES.md | Adds CLI operational best practices reference. |
| docs/ES/cli/SUPABASE_CONFIGURATION.md | Adds detailed Supabase operational configuration runbook for CLI. |
| docs/ES/cli/README.md | Adds extensive CLI usage/reference documentation. |
| docs/ES/cli/INSTALLATION.md | Adds CLI installation guide (multi-platform, source build, docker). |
| docs/ES/agents/applogger-supabase-mcp-configuration/references/mcp-configuration-flow.md | Adds MCP configuration flow reference. |
| docs/ES/agents/applogger-supabase-mcp-configuration/SKILL.md | Adds skill for Supabase MCP configuration/validation. |
| docs/ES/agents/applogger-sdk-live-configuration/references/local-properties-live-checklist.md | Adds checklist for local.properties live setup. |
| docs/ES/agents/applogger-sdk-live-configuration/SKILL.md | Adds skill for in-environment SDK configuration validation. |
| docs/ES/agents/applogger-guided-setup/references/ios-kmp-setup.md | Updates dependency versions to 0.1.1-alpha.2. |
| docs/ES/agents/applogger-guided-setup/references/android-setup.md | Updates dependency versions to 0.1.1-alpha.2. |
| docs/ES/agents/applogger-cli-live-configuration/references/cli-live-setup-runbook.md | Adds CLI live setup runbook reference. |
| docs/ES/agents/applogger-cli-live-configuration/SKILL.md | Adds skill for live CLI installation/config/validation. |
| docs/ES/agents/applogger-cli-agent-operator/SKILL.md | Adds in-repo operational agent operator skill (longform). |
| docs/ES/agents/README.md | Reframes agents directory and lists new operational skills. |
| cli/tests/integration/contract_test.go | Adds integration/contract tests for CLI output + exit code behavior. |
| cli/plugin-metadata.yaml | Adds Syncbin plugin metadata for the CLI. |
| cli/internal/cli/version.go | Adds version command with text/json/agent output. |
| cli/internal/cli/types.go | Adds exit codes + usageError type. |
| cli/internal/cli/telemetry_client.go | Adds Supabase-backed telemetry query client. |
| cli/internal/cli/telemetry_aggregate.go | Adds aggregation logic (hour/severity/tag/session/name). |
| cli/internal/cli/telemetry_agent_response.go | Adds compact agent-response payload builder. |
| cli/internal/cli/telemetry.go | Adds telemetry query and telemetry agent-response commands/flags. |
| cli/internal/cli/supabase.go | Adds env-based Supabase config loading + validation. |
| cli/internal/cli/root.go | Adds root cobra command, output validation, and error envelope behavior. |
| cli/internal/cli/metadata.go | Adds syncbin metadata emission handler. |
| cli/internal/cli/health.go | Adds health command. |
| cli/internal/cli/capabilities.go | Adds capabilities command and schema. |
| cli/internal/cli/buildinfo.go | Adds build info variables + setter. |
| cli/internal/cli/agent_output.go | Adds TOON agent output writer. |
| cli/internal/cli/agent.go | Adds agent schema command. |
| cli/go.sum | Adds Go dependency checksums. |
| cli/go.mod | Adds Go module definition + dependencies. |
| cli/cmd/applogger-cli/main.go | Adds CLI entrypoint wiring build info + exit codes. |
| cli/README.md | Adds CLI developer README and usage notes. |
| cli/Makefile | Adds build/test/lint/cross-compile targets. |
| cli/.golangci.yaml | Adds CLI lint configuration. |
| cli/.gitkeep | Keeps directory tracking. |
| README.md | Updates monorepo README with CLI section, agents, and updated SDK version refs. |
| .github/workflows/applogger-cli.yml | Adds CLI CI workflow (test/lint/build/security/release). |
| .github/skills/syncbin-child-cli-architect/SKILL.md | Adds delivery cadence guidance when used in this repo. |
| .github/skills/applogger-cli-agent-operator/SKILL.md | Adds invocable GitHub skill wrapper for CLI operator. |
| .github/skills/applogger-change-delivery/references/local-validation.md | Adds validation profiles (code/docs/mixed). |
| .github/skills/applogger-change-delivery/references/completion-checklist.md | Adds guidance to avoid micro-commits. |
| .github/skills/applogger-change-delivery/SKILL.md | Updates procedure to classify changes + avoid micro-pushes. |
| .github/agents/applogger-delivery-engineer.agent.md | Updates agent instructions for batching + docs-only validation. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+189
to
+194
| | `--severity` | ❌ (logs) | `debug`, `info`, `warn`, `error` | `--severity error` | | ||
| | `--tag` | ❌ (logs) | texto libre | `--tag PAYMENT` | | ||
| | `--session-id` | ❌ | UUID | `--session-id 550e8400-e29b-41d4-a716-446655440000` | | ||
| | `--name` | ❌ (metrics) | texto libre | `--name response_time_ms` | | ||
| | `--limit` | ❌ | 1-1000 (default: 25) | `--limit 50` | | ||
| | `--output` | ❌ | `text`, `json`, `agent` | `--output json` | |
| if err != nil { | ||
| return err | ||
| } | ||
| _, err = fmt.Fprintln(cmd.OutOrStdout(), "recommendation: use --output json for agent integrations") |
Comment on lines
+85
to
+105
| ```bash | ||
| $ applogger-cli capabilities --output json | ||
| { | ||
| "ok": true, | ||
| "cli_name": "applogger-cli", | ||
| "version": "v0.1.0-alpha.0", | ||
| "output_modes": ["text", "json", "agent"], | ||
| "capabilities": [ | ||
| "version", | ||
| "capabilities", | ||
| "health", | ||
| "agent-schema", | ||
| "telemetry-query", | ||
| "telemetry-agent-response" | ||
| ], | ||
| "syncbin_contract": { | ||
| "metadata": { "version": "v0.1.0-alpha.0" }, | ||
| "exit_codes": { "success": 0, "error": 1, "usage_error": 2 } | ||
| } | ||
| } | ||
| ``` |
Comment on lines
+127
to
+155
| ### `applogger-cli agent schema` | ||
| Muestra el esquema de datos para consumo de agentes. | ||
|
|
||
| ```bash | ||
| $ applogger-cli agent schema --output json | ||
| { | ||
| "telemetry_log": { | ||
| "fields": { | ||
| "id": "uuid", | ||
| "created_at": "timestamp", | ||
| "level": "enum(debug|info|warn|error)", | ||
| "message": "text", | ||
| "session_id": "uuid", | ||
| "tag": "text", | ||
| "extra": "json" | ||
| } | ||
| }, | ||
| "telemetry_metric": { | ||
| "fields": { | ||
| "id": "uuid", | ||
| "created_at": "timestamp", | ||
| "name": "text", | ||
| "value": "float64", | ||
| "session_id": "uuid", | ||
| "unit": "text" | ||
| } | ||
| } | ||
| } | ||
| ``` |
Comment on lines
+88
to
+93
| build: | ||
| name: Build ${{ matrix.os }}-${{ matrix.arch }} | ||
| runs-on: ${{ matrix.runners }} | ||
| needs: [test, lint] | ||
| if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev') | ||
| strategy: |
Comment on lines
+71
to
+78
| ```bash | ||
| $ applogger-cli version | ||
| applogger-cli v0.1.0-alpha.0 (commit: abc1234, built: 2026-03-19T10:30:00Z) | ||
|
|
||
| # JSON | ||
| $ applogger-cli version --output json | ||
| {"ok": true, "version": "v0.1.0-alpha.0", "commit": "abc1234", "build_time": "2026-03-19T10:30:00Z"} | ||
| ``` |
Comment on lines
+109
to
+123
| ### `applogger-cli health` | ||
| Verifica la salud del CLI y servicios backend. | ||
|
|
||
| ```bash | ||
| $ applogger-cli health --output json | ||
| { | ||
| "ok": true, | ||
| "services": { | ||
| "supabase": "available", | ||
| "database": "online", | ||
| "schema": "valid" | ||
| }, | ||
| "timestamp": "2026-03-19T10:35:00Z" | ||
| } | ||
| ``` |
Comment on lines
+11
to
+13
| LDFLAGS := -s -w -X github.com/devzucca/appLoggers/cli/internal/cli.version=$(VERSION) \ | ||
| -X github.com/devzucca/appLoggers/cli/internal/cli.commit=$(COMMIT) \ | ||
| -X github.com/devzucca/appLoggers/cli/internal/cli.buildTime=$(BUILD_TIME) |
Comment on lines
+3
to
+17
| on: | ||
| push: | ||
| branches: | ||
| - main | ||
| - dev | ||
| paths: | ||
| - 'cli/**' | ||
| - '.github/workflows/applogger-cli.yml' | ||
| pull_request: | ||
| branches: | ||
| - main | ||
| - dev | ||
| paths: | ||
| - 'cli/**' | ||
|
|
| GOARCH: ${{ matrix.arch }} | ||
| run: | | ||
| go build \ | ||
| -ldflags="-s -w -X github.com/devzucca/appLoggers/cli/internal/cli.version=${{ env.VERSION }} -X github.com/devzucca/appLoggers/cli/internal/cli.commit=${{ env.COMMIT }} -X github.com/devzucca/appLoggers/cli/internal/cli.buildTime=${{ env.BUILD_TIME }}" \ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Validation
Notes