Skip to content

Perf: skills and types - #16

Merged
AxiosLeo merged 4 commits into
mainfrom
perf/skills
Aug 11, 2026
Merged

Perf: skills and types#16
AxiosLeo merged 4 commits into
mainfrom
perf/skills

Conversation

@AxiosLeo

@AxiosLeo AxiosLeo commented Aug 11, 2026

Copy link
Copy Markdown
Owner

Note

Medium Risk
Removing commands/gen.js is a breaking CLI change for anyone using koapp gen; the export additions in index.d.ts are additive for TypeScript consumers.

Overview
Adds agent guidance and TypeScript documentation for koapp, and makes framework types importable from @axiosleo/koapp.

New .agents/rules templates cover Conventional Commits + TaskID (git-commit.mdc.tmpl) and apps/services backend layout (router/controller/model, /openapi vs /api, health check). A new koapp-typescript skill (plus examples.md) documents typed contexts, Router generics, multer uploads, module augmentation, and config types; koapp, koapp-apps, koapp-router, and http-server now point readers to that skill, including a TS upload snippet in http-server.md.

index.d.ts exports previously internal symbols (KoaContext, ContextHandler, RouterInfo, config types, StatusCode, SSE types, etc.) so consumers can import type { ... } from '@axiosleo/koapp' as described in the new skill.

commands/gen.js is removed, dropping the CLI koapp gen / generate flow that scaffolded model/controller/router from JSON Schema.

Reviewed by Cursor Bugbot for commit 2a48e2b. Bugbot is set up for automated code reviews on this repo. Configure here.

- export types in index.d.ts for better TypeScript support;

- update documentation for KoaContext and file upload examples;
- Deleted the gen.js file, which was responsible for generating TypeScript files from JSON schema files, as part of a cleanup process.
…controller patterns, middleware patterns, and project structure

- Introduced new markdown files detailing application setup, CLI command usage, controller conventions, middleware patterns, and overall project structure for the koapp framework.
- Enhanced developer experience by providing clear guidelines and examples for each aspect of the framework.
@AxiosLeo
AxiosLeo merged commit ef0a0d6 into main Aug 11, 2026
11 checks passed
@AxiosLeo
AxiosLeo deleted the perf/skills branch August 11, 2026 06:03
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.

1 participant