bruce48x/Lakona / skills/lakona-implement-http-service
lakona-implement-http-service
VerifiedImplement or update complete Lakona Application HTTP services in Server.Hotfix. Use when adding an operations endpoint, webhook, payment callback, or other request/response route; changing LakonaHttpService or LakonaHttpEndpoint declarations; selecting listener exposure; fixing HTTP manifest-to-Hotfix binding; or validating raw-body, cancellation, idempotency, status, and response behavior.
Implement a Lakona HTTP Service
Implement Application HTTP as its own traffic plane: the initial Hotfix generation freezes one route manifest whose host-assigned endpoint slots select generation-pinned handlers returning materialized responses. Keep framework hosting mechanics separate from product policy.
Workflow
- Read project instructions and any project HTTP architecture guidance. Detect the installed Lakona version, stable App project, Hotfix project, listener configuration, neighboring HTTP services, and tests. Complete this step when the actual project conventions and validation commands are known.
- Define the product boundary from the request and repository evidence: caller, route purpose, listener exposure, authentication assumptions, timeout behavior, idempotency needs, and durable state owner. Ask for a product decision only when a security or business choice cannot be inferred safely. Classify the work as either a behavior-only change that preserves service/method/route identity and is eligible for in-process Hotfix reload, or a manifest change that requires a process restart.
- Search all
[LakonaHttpService]and[LakonaHttpEndpoint]declarations plus listener service names. Update an existing binding in place and preserve its service name, HTTP method, and route by default. Change that identity only when the requested protocol change is intentional and the restart requirement is explicit. Complete this step when service names and listener/method/route keys are collision-free. - Read http-service-shapes.md before editing a contract, handler, listener, signed request, or durable webhook.
- Define or evolve one top-level public sealed
[LakonaHttpService("...")]class in Hotfix. Annotate each public handler with[LakonaHttpEndpoint(method, route)], acceptLakonaHttpCall, and return exactlyValueTask<LakonaHttpResponse>. Application HTTP has no stable App interface or user-authored numeric method id. - Implement product behavior in the same Hotfix class. Use
call.Request,call.CancellationToken, actors, and concrete HotfixComponent Store/Util dependencies. Stable infrastructure interfaces for configuration, secrets, and third-party clients remain valid; do not introduce a stable business Store interface merely to reach Hotfix logic. Uselakona-implement-componentfor resource initialization already required by the task. Treat method and route changes as protocol changes that require a process restart after the new Hotfix build. - Apply edge semantics explicitly. Validate bounded inputs, verify signatures
against
RawBody, authorize from trusted identity or stable dependencies, choose product status and headers, and route durable acceptance through an application-owned inbox or Store. An Actor may serialize the mutation, but its memory alone is not durable. Complete this step when retries and partial failure cannot silently duplicate state changes. - Expose the service only on the intended
Lakona:Http:Listeners[].Servicesentries. Keep bind address, trusted edge, certificates, proxies, and authentication mechanism as explicit deployment or stable-host policy. - Reuse focused handler tests for affected success, rejection, cancellation, and idempotency behavior; add tests where coverage is missing. Use startup or integration coverage when listener isolation, generated publication, dependency activation, or request snapshot behavior cannot be proven by a unit test.
- Validate the discovered stable App and Hotfix build graph, directly or through focused tests that build the same configuration, and run applicable repository guards. Complete the task only when generated validation accepts the service and runtime validation accepts its complete manifest and tested behavior supports every claimed outcome.
Non-Negotiable Boundaries
- Business exceptions deriving from
System.Exception, directly or indirectly, may remain in Hotfix and usenewwith runtime data. Do not mark them with[HotfixComponent]or register their error codes and inner exceptions in DI. Remove a mistaken marker whenLAKONA20060reports it. For older versions reportingLAKONA20037on exceptions, upgrade and verify build plus loading; do not use component registration as a workaround. - Application HTTP carries product request/response work without creating a Game Session, callback channel, resume flow, or reliable-push stream.
- Keep route declarations and product behavior together in Hotfix. Keep
Program.csas an infrastructure composition root. - Use the detached request snapshot and return a materialized
LakonaHttpResponse; framework adapters own ASP.NET request and response objects. - Observe
call.CancellationTokenin asynchronous and nested work so the generation lease can drain at the mandatory request deadline. - Reserve
/_lakona/**for Management HTTP and select listeners through their configured service sets. - Preserve exact raw request bytes until signature verification completes.
- Back durable webhook acceptance with an application-owned inbox or Store. An authoritative Actor may coordinate the operation only when the durable write completes before success; a successful in-memory return is not durability.
- Do not add dynamic
EndpointDataSourcepublication, a catch-all application router, or a manifest-validation bypass to make route changes reloadable. Treat dynamic manifests as future framework architecture work rather than an application workaround. - Follow the repository's
ValueTaskconventions and keep analyzer diagnostics enabled.
Validation Scope
Apply the validation steps to affected contracts, reusing existing coverage and adding tests only where meaningful coverage is missing. For non-behavioral, low-impact edits, use relevant static checks. A test command may also satisfy the build when it covers the same graph and configuration. Once relevant checks and required stage gates pass, stop unless new changes, failures, or a concrete unresolved risk justify more verification. Report any unverified outcomes.
Completion Report
Report the Hotfix manifest change, handler behavior, listener exposure,
security and idempotency decisions, tests, and builds. Distinguish compile-time
shape validation, unit-tested product behavior, and runtime listener/manifest
validation. State Hot reload eligible: yes/no and
Process restart required: yes/no.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |