All authors

Claude Skills by reliant-labs
github.com/reliant-labs258 skills0 installs195 views
- Helm Chart PruneAdopt the `forge.HelmChart` changes — a chart re-apply now PRUNES the objects the chart stopped rendering (behavior change), `namespace_labels` / `namespace_annotations` for the Namespace forge creates (Pod Security Admission on flux-system), and `KubeconfigPolicyRule.resource_names`. Use when an env declares a `forge.HelmChart` that ever dropped an object, when a chart's Namespace needs PSA labels, or when a minted KubeconfigSecret is paired with a hand-written ClusterRole only to restrict a...Votes: 0GitHub stars: 10
- Metrics SchemaAdopt the declared metrics registry in a project scaffolded before v0.1.45 — add `<bin> metrics schema`, the owned `internal/metrics/metrics.go`, the `records_created` example in CRUD Create shims, and `forge obs metrics declared --dashboard`. Use when `<bin> metrics schema --json` says "unknown command", `cmd/<bin>/cmd/metrics.go` or `internal/metrics/metrics.go` does not exist, or `GET /debug/metrics/schema` returns 404.Votes: 0GitHub stars: 10
- V0.1.46Upgrade a project to forge v0.1.46. One section per change — (1) host-wide heavy slots: `forge slot run` / `forge slot status` (pkg/hostslot) queue heavy work machine-wide, `forge generate` and `forge lint` take a slot on their own, and the scaffolded Taskfile runs `test` and `test:integration` under a `SLOT` prefix; (2) `forge ci gate` runs checks concurrently (after / mutates_tree / heavy), caches PASS verdicts by tree hash, and unit-tests only the affected packages on a branch — with a wid...Votes: 0GitHub stars: 10
- Api KeysUpgrade v0.1.46 auth wiring to context-aware validation and API keys, including owned middleware, SetupAuth and serve.go edits.Votes: 0GitHub stars: 10
- Dev Api ProxyAdopt the same-origin dev API proxy — under the dev server a web frontend's browser reaches the API at `<basePath>/_api` on its own origin (a `next.config.ts` rewrite / `vite.config.ts` proxy), chosen by a new `src/lib/api-base.ts` that `connect.ts` and `auth/native-login.ts` both ask. Use when a Next.js or Vite frontend's `next.config.ts` / `vite.config.ts` has no `FORGE_DEV_API_PROXY`, or when the app works on localhost but every RPC and sign-in fails through a Reliant workspace preview URL...Votes: 0GitHub stars: 10
- Managed IdentityReplace the dev idp-provision job with forge.ManagedIdentity: `forge env up` converges the identity on the dev IdP with the same library the control plane runs, `deploy/kcl/identity.k` declares the users once for every env, and the `auth idp-provision` command, the `idp-provision` workload and `idp_identity_gen.k` are gone. Use when `deploy/kcl/workloads.k` or `deploy/kcl/dev/main.k` declares `idp-provision`, `deploy/kcl/dev/idp_identity_gen.k` exists, a `config.k` reads `idp.idp_identity[`, ...Votes: 0GitHub stars: 10
- Operatorkit BridgeUpgrade an owned internal/app/lifecycle.go that names lifecyclekit.Run, lifecyclekit.Controller or lifecyclekit.Options to operatorkit, so importing lifecyclekit never links controller-runtime.Votes: 0GitHub stars: 10
- V1.0.0Upgrade a project to forge v1.0.0. One section per change — (1) the interceptor chain's Deadline slot, ahead of Auth: every unary RPC is now bounded by a 30s server deadline by default and watched for slow calls, and `(forge.v1.method).timeout` is enforced through `middleware.ProcedureDeadlines`, which an owned chain builder passes as `Deadline: serverkit.Deadline{Procedures: middleware.ProcedureDeadlines}`. Use when cmd/<bin>/cmd/serve.go or internal/app/providers.go calls serverkit.NewChain...Votes: 0GitHub stars: 10
- Activity CallerUpgrade v1.0.0 chains and activity interceptors to a caller that is never guessed — activity.Deps.Principal (ClaimsPrincipal or the project's own), serverkit.Authenticator.Caller / AuthWithCaller, and NewChain's refusal of a defaulted Audit or Activity it cannot attribute.Votes: 0GitHub stars: 10
- ButtonAdopt the v1.0.0 library Button — reinstall it with forge component install button, rename isLoading to loading, re-pick sizes on the denser xs–xl scale (old sm/md/lg were 32/40/48px; new sm/md/lg/xl are 28/32/36/40px), and replace hand-rolled icon slots, icon-only buttons and link-styled anchors with leftIcon/rightIcon, icon + aria-label, and href.Votes: 0GitHub stars: 10
- Config Proto PackageUpgrade v1.0.0 config protos off the shared package config.v1 — run forge fix config-proto-package, forge generate, then update what it lists. Env var names do not change.Votes: 0GitHub stars: 10
- Connect ErrorsMove hand-built connect.NewError calls onto pkg/svcerr — run forge fix connect-errors (wire-identical), then convert its worklist by hand with svcerr.WrapOr, and flip forgeconv-handler-connect-error to error.Votes: 0GitHub stars: 10
- Harness MocksUpgrade v1.0.0 handler tests from the harness's Stub<Field> doubles to the forge Mock<Role> that replaces them — run forge fix harness-mocks, then update any assertion on the old stub error text.Votes: 0GitHub stars: 10
- Image RegistriesMove a v0.1.46 docker-compose.yml off Docker Hub — postgres from public.ecr.aws/docker/library, the OpenTelemetry collector from ghcr, ClickStack through mirror.gcr.io, Zitadel pinned by digest — so a shared IP's anonymous pull limit cannot stop forge env up.Votes: 0GitHub stars: 10
- Local AlertingUpgrade a v0.1.46 dev env to local alert delivery — the compose `alertmanager`, the `alerts` evaluator workload and the alertmanager_port / alerts_port declaration, so forge.Alerts fire locally and reach forge.AlertReceivers and .forge/logs/<env>/alerts.log.Votes: 0GitHub stars: 10
- Pgtest Embeddedpgtest.StartEmbedded returns *pgtest.Embedded, which owns the embedded-postgres temp log file it created. Use when Go code calls pgtest.StartEmbedded and keeps the result as *embeddedpostgres.EmbeddedPostgres.Votes: 0GitHub stars: 10
- PnpmOptional pnpm adoption for existing frontends. New forge frontends pin pnpm 12.15.0; npm projects remain supported. Import the npm lockfile, move overrides and build-script approvals to pnpm-workspace.yaml, declare phantom dependencies exposed by isolated node_modules, and update owned Dockerfiles, CI and Taskfile commands. Keep pnpm's shared store on the same mount as worktrees for hard links.Votes: 0GitHub stars: 10
- Probe PathsUpgrade a v0.1.46 server to configurable probe paths — hand serverkit.Config.Probes to serverkit.Probes.Paths, and declare liveness_paths / readiness_paths when a platform probes a path other than /healthz and /readyz.Votes: 0GitHub stars: 10
- Service LinksUpgrade to v1.0.0's enableServiceLinks false on every forge-rendered pod — find code that read the Kubernetes-injected <SERVICE>_SERVICE_HOST / _SERVICE_PORT / tcp:// _PORT variables, replace them with DNS names or explicit env, opt a workload back in with enableServiceLinks = True, and delete config shadows that only existed to dodge the collision.Votes: 0GitHub stars: 10
- Shape Boundrelease.MaxShapeBytes, the bound Shape.Encode enforces on a bundle shape's canonical JSON, is 512 KiB (was 256 KiB). Use when Go code compares against release.MaxShapeBytes, or a database column that stores a bundle shape carries a size CHECK.Votes: 0GitHub stars: 10
- Tx IsolationUpgrade v1.0.0 pkg/orm transactions to an explicit isolation level — run forge fix tx-isolation, clear what it lists, then review forgeconv-tx-lock-under-serializable.Votes: 0GitHub stars: 10
- V1.0.1Upgrade a project to forge v1.0.1. (1) The anonymous (claimable) plan's caps come from the control plane's GetClaimableAvailability limits: pkg/deploy's Claimable* constants and ClaimableResources are a ClaimableLimits value (ClaimableLimitsFallback is the offline copy, 125m / 128 MiB), and CheckHostedResources(plan, r) is CheckHostedResourcesWithin(plan, limits, r). Use when Go code names deploy.CheckHostedResources, deploy.ClaimableCPUMillicores, deploy.ClaimableMemoryBytes, deploy.Claimabl...Votes: 0GitHub stars: 10
- Claimable LimitsThe anonymous (claimable) plan's caps come from the control plane's GetClaimableAvailability limits; pkg/deploy's Claimable* constants and ClaimableResources are a ClaimableLimits value (ClaimableLimitsFallback is the offline copy, 125m / 128 MiB), and CheckHostedResources(plan, r) is CheckHostedResourcesWithin(plan, limits, r). Use when Go code names deploy.CheckHostedResources, deploy.ClaimableCPUMillicores, deploy.ClaimableMemoryBytes, deploy.ClaimableMax* or deploy.ClaimableResources.Votes: 0GitHub stars: 10
- V1.0.10Upgrade a project to forge v1.0.10. .forge/hashes.json becomes one certificate file per JSON output under .forge/hashes/, and contract mocks (mock_gen.go) certify each mock separately, so pull requests that change different outputs or interfaces no longer conflict in generated files. Use when the project commits .forge/hashes.json.Votes: 0GitHub stars: 10
- V1.0.11Upgrade a project to forge v1.0.11. More generated files merge with plain git. The read-only and dashboard grants (db/grants/*_gen.sql), the config module (deploy/kcl/config_gen.k) and the scenario handler map (src/mocks/scenario-rpcs_gen.ts) certify each table, config block and service separately, the scaffold ledger .forge/scaffolded.json becomes one entry file per path under .forge/scaffolded/, and the mock-fixture fingerprint leaves the committed fixture-manifest_gen.ts for a gitignored m...Votes: 0GitHub stars: 10
- V1.0.12Upgrade a project to forge v1.0.12. Every sectioned generated file (contract mocks, config_gen.k, scenario-rpcs_gen.ts) names each section and puts its hash on the next line, so a part added beside a changed one merges with plain git, the read-only and dashboard grants become one constant script per role plus one row file per table (db/grants/readonly/, db/grants/dashboard/), each entity's store is its own internal/db/<entity>_store_gen.go with the aggregate Store now a struct, each entity's ...Votes: 0GitHub stars: 10
- V1.0.14Upgrade a project to forge v1.0.14. The dashboard role (forge_dash) is granted by ordinary migrations, not annotations - the forge:dashboard / forge:no-dashboard markers, the generated db/grants/dashboard_gen.sql and db/grants/dashboard/, and the forge-db-grants-stale lint rule are gone, and the migrator now creates forge_dash before any migration runs and fails a run after which it holds more than read privileges. Use when the project's migrations carry forge:dashboard or forge:no-dashboard,...Votes: 0GitHub stars: 10
- Flux OperatorAdopt `forge.flux_chart()` installing Flux through ControlPlane's Flux Operator and a FluxInstance (behavior change) instead of the community flux2 chart — the chart is renamed `flux-operator`, `values` now reaches the operator chart, the `flux_check` egress key became `operator`, `rbac`/`network_policies = "chart"` became `"upstream"`, and an existing install is adopted in place. Use when deploy/kcl declares `forge.flux_chart(`, names the chart `flux`, passes `values.extraObjects` / `values....Votes: 0GitHub stars: 10
- V1.0.16Upgrade a project to forge v1.0.16. A `--kind cron` worker now runs its schedule on forge/pkg/cronkit, which claims each tick in the app's Postgres (table forge_cron_ticks, created on first use) so it fires on ONE replica instead of on every replica; `const PerReplica = true` opts a worker back into running everywhere. Workers scaffolded earlier keep firing on every replica until converted. Use when internal/workers/*/worker.go imports github.com/robfig/cron/v3. Also: forge/pkg/releasehealth....Votes: 0GitHub stars: 10
- V1.0.2Upgrade a project to forge v1.0.2. (1) pkg/servicecatalog.MaxBytes is removed — a service catalog has no size bound of its own; the reader that fetched the bytes owns the bound (release.ManifestsLayerMaxBytes for a bundle layer). Use when Go code names servicecatalog.MaxBytes.Votes: 0GitHub stars: 10
- V1.0.7Upgrade a project to forge v1.0.7. (1) pkg/dbquery.Options and pkg/dbquery.Event are no longer comparable — both gained an Args slice for bound query parameters. Use when Go code compares or map-keys a dbquery.Options or dbquery.Event value. (2) release.BundleFeaturePlacementPrerequisites is now "placement-prerequisites-v2" (graph version 2): no cluster kind is refused for being unknown. Use when code spells placement-prerequisites-v1 or a graph version 1.Votes: 0GitHub stars: 10
- V1.0.8Upgrade a project to forge v1.0.8. pkg/migratekit.Grants is no longer comparable — it gained a SecurityDefiner slice naming the SECURITY DEFINER functions a granted role can execute. Use when Go code compares or map-keys a migratekit.Grants value.Votes: 0GitHub stars: 10
- V1.1.0Upgrade a project to forge v1.1.0. A List request field can declare a range or prefix filter with (forge.v1.filter) = {column, op}, which the generated List op applies, so a List hand-written only to filter by a time window or a key prefix can go back to the generated op; use when a handler file builds its own crud.ListOp. Also: against a hosted identity instance, whose gateway answers 404 for the Settings API, the scaffolded login broker's GET /auth/password-policy answered 502 and logged an...Votes: 0GitHub stars: 10
- Identity V2Teach a login broker scaffolded before v1.1.0 the identity-v2 sign-in methods — passkeys, magic links, Google/GitHub, invitations, address verification and open or domain sign-up — by reading the delivered idp_login_policy and mounting devidp.SignInRoutes. Without it a forge.ManagedIdentity that declares methods, social or a non-invite signup is converged and silently ignored by the sign-in screen. Use when internal/app/login_broker.go does not call devidp.ParseLoginPolicy, or `forge lint` re...Votes: 0GitHub stars: 10
- V1.2.0Upgrade a project to forge v1.2.0. In mock mode every RPC of every service a frontend has generated TypeScript for — custom reads, streams, vendored contracts — now answers a deterministic, schema-valid default instead of Unimplemented; forge generate writes src/mocks/services/<service>_gen.ts per service and mock-transport_gen.ts gathers them. Hand-written scenario handlers that only filled in a response shape can become mockService(Service, { rpc: (req, d) => patch(d.rpc(req), …) }) overrid...Votes: 0GitHub stars: 10
- V1.4.0Upgrade a project to forge v1.4.0. (1) Session replay is a per-frontend, per-environment switch, forge.BrowserTelemetry {replay = True}, which renders the frontend's OTEL_REPLAY and opts the env in to replay ingestion; the env-wide Observability.signals.replay is deprecated (it still opts in) and an explicit runtime_config OTEL_REPLAY outranks the new switch. (2) Browser analytics are cookieless by default: the web runtime stores nothing on the device (no visitor id, no session cookie, no sto...Votes: 0GitHub stars: 10
- ObservabilityObservability — the local ClickStack (HyperDX) that forge env up runs by default, forge env status runtime checks, querying logs/traces/metrics, dashboards.Votes: 0GitHub stars: 10
- AlertsAlert rules declared in KCL per env — `forge.AlertRule` (Prometheus rule shape, the condition inside a native ClickHouse SQL `expr`), `forge.AlertRoute` (labels to a receiver NAME), `forge.AlertDefault` (tune or disable forge's generated defaults, including the customer-metadata and platform ones), the local loop (`forge env up` evaluates rules continuously and delivers them through a local Alertmanager rendered by the control plane's own renderer; `forge.AlertReceiver`; `.forge/logs/<env>/al...Votes: 0GitHub stars: 10
- Audit LogA queryable, DB-persisted audit trail on forge/pkg/audit — the audit_log table you own, the DB-backed audit interceptor in the serverkit chain, and a scoped ListAuditEvents read RPC over the same store. The slog-only audit record every RPC already writes needs none of it.Votes: 0GitHub stars: 10
- Component ChainThe in-process middleware chain — RPC-edge interceptors and whose traceparent the edge adopts (observe.TrustRemoteBy), the generated middleware_gen.go component decorator, the owned observe_chain.go seam, success-log sampling, and opting out.Votes: 0GitHub stars: 10
- DashboardsProcess/role dashboards derived from deployed executable and composition commands, metric-backed overview, the built-in Product overview, Users, Product and Acquisition dashboards and the Overview's Traffic and Users sections (pkg/obsbuiltin), renderer-neutral sections and targeted filters, safe retirement and overrides, and HyperDX delivery.Votes: 0GitHub stars: 10
- PanelsThe dashboard panels beyond the basic queries — postgres panels (a live read-only query of your own database), row links into the data browser, saved data-browser views (browse), text panels (Markdown), display options that draw one query as area, stacked, bars, pie, donut, gauge, funnel (bars or steps), heatmap, bar list or KPI card, which way a figure is good (green/red changes), palette colours per series, sparklines on sql figures (trendSql), drill links to another dashboard, and Needs-at...Votes: 0GitHub stars: 10
- DestinationWhere an environment's telemetry goes — the typed `forge.Observability` declaration on a Bundle (destination endpoint + headers secret, signals, sampling, retention), what forge renders for it on host/compose, on a cluster (the node-agent DaemonSet) and on forge.OnHosted, and how to send telemetry to your own OTLP backend.Votes: 0GitHub stars: 10
- Error LevelsWhere forge's error-level policy applies (rpc failed, component failures, every hand-written logger.Error through observe.NewErrorClassHandler), how a failed call's server span follows the class (OK for user and canceled, observe.WithUserErrorsAsSpanErrors), how to wrap a log forwarder so it sees the classified level, and how to mark an error's class (svcerr.WithClass, observe.WithErrorClassifier).Votes: 0GitHub stars: 10
- Error StacksThe bounded stack svcerr captures for server faults (Internal, Unknown, DataLoss, Unavailable), where it appears (exception.stacktrace, code.* call site, sfp1 grouping), what never carries one, and how to get a useful one.Votes: 0GitHub stars: 10
- Monitoring OnlyMonitoring for an app forge did not build and does not deploy — any language, any CI. forge obs init, ingest tokens, the OTEL_* variables per language, the attribute contract forge's own apps follow, alert receivers, and an estimate to quote.Votes: 0GitHub stars: 10
- Product AnalyticsThe built-in product analytics dashboards every hosted forge app gets with no code — the Overview's Traffic and Users sections, and the Product analytics hub's Overview, Users, Product and Acquisition dashboards (pkg/obsbuiltin) — with every definition they count by (cookieless visitor-day, visit, bounce, channel table, source, same-day stitch, person, active/new/returning, sign-up attribution, activation), how to extend them (forge.Analytics goals, activation, channels; forge.Funnel by visit...Votes: 0GitHub stars: 10
- Product EventsProduct events — the contract (one INFO log record, event.name product.<name>), emitting from Go (observe.Track) and the browser (track, setTelemetryUser), the browser's cookieless analytics tiers (off < aggregate < identified < full, identified by default; grantAnalyticsConsent, optOutOfAnalytics, GPC/DNT), automatic page_viewed with its referrer/utm/click_id props, page_engaged (engaged time and scroll depth per view), flag exposures (trackExposure, forgeExposureHook), the reserved event-na...Votes: 0GitHub stars: 10
- Auth EventsThe standard auth product events the console counts users from — auth_signed_up, auth_signed_in, auth_signed_out — emitted from Go (observe.TrackAuth, the auth middleware's daily resumed heartbeat), the browser (identifyUser, trackAuthEvent), Node, or any other language's OTel logger, and the edge visitor-day hash that links a server-side sign-up to its anonymous visit.Votes: 0GitHub stars: 10
- PurgeDeleting one user's or visitor's product events (account deletion, a data-subject request) with observe.RequestPurge — a purge request sent as a product event through the app's own telemetry pipeline, which the Reliant control plane verifies, executes against the environment's product_events and records once per request id.Votes: 0GitHub stars: 10