@hyphaene/hexa-ts-kit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hyphaene
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# hexa-ts-kit
+
+TypeScript dev kit for Claude Code agents: architecture linting, scaffolding, and knowledge analysis.
+
+Built for colocated feature architectures in Vue.js, NestJS, and Playwright projects.
+
+## Installation
+
+```bash
+npm install -g @hyphaene/hexa-ts-kit
+```
+
+Or use directly with npx:
+
+```bash
+npx @hyphaene/hexa-ts-kit lint
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Lint current directory
+hexa-ts lint
+
+# Lint only git-changed files (incremental mode)
+hexa-ts lint --changed
+
+# Filter by rule categories
+hexa-ts lint --rules COL,NAM,VUE
+
+# Analyze files to find matching knowledges
+hexa-ts analyze src/domains/contracts/upload.composable.ts
+
+# Analyze git-changed files
+hexa-ts analyze --changed
+
+# Scaffold a Vue feature
+hexa-ts scaffold vue-feature src/domains/contracts/upload
+
+# Scaffold a NestJS feature
+hexa-ts scaffold nestjs-feature src/domains/orders/create
+
+# Scaffold Playwright tests
+hexa-ts scaffold playwright-feature e2e/checkout
+```
+
+### MCP Server
+
+Add to your Claude Code MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "hexa-ts": {
+      "command": "hexa-ts-mcp"
+    }
+  }
+}
+```
+
+Available MCP tools:
+
+| Tool       | Description                           |
+| ---------- | ------------------------------------- |
+| `lint`     | Lint files for architecture rules     |
+| `analyze`  | Map files to associated knowledges    |
+| `scaffold` | Generate colocated feature structures |
+
+## Lint Rules
+
+71 rules across 9 categories:
+
+| Category     | Prefix | Count | Focus                              |
+| ------------ | ------ | ----- | ---------------------------------- |
+| Colocation   | COL    | 12    | File placement and structure       |
+| Naming       | NAM    | 12    | File and export naming conventions |
+| Vue          | VUE    | 13    | Vue component patterns             |
+| Composable   | CMP    | 11    | Composable patterns                |
+| Rules        | RUL    | 12    | Business rules file patterns       |
+| Query        | QRY    | 8     | Query/API file patterns            |
+| Translations | TRN    | 5     | i18n file patterns                 |
+| TypeScript   | TSP    | 12    | TypeScript patterns                |
+| Domain       | DOM    | 4     | Domain boundary rules              |
+
+### Output Formats
+
+```bash
+# Console output (default)
+hexa-ts lint
+
+# JSON output (for agents)
+hexa-ts lint --format json
+```
+
+## Scaffold Templates
+
+### Vue Feature
+
+```
+src/domains/{domain}/{feature}/
+├── Feature.vue
+├── feature.composable.ts
+├── feature.rules.ts
+├── feature.types.ts
+├── feature.query.ts
+├── feature.translations.ts
+└── __tests__/
+    └── feature.rules.test.ts
+```
+
+### NestJS Feature
+
+```
+src/domains/{domain}/{feature}/
+├── feature.module.ts
+├── feature.controller.ts
+├── feature.service.ts
+├── feature.types.ts
+└── __tests__/
+    └── feature.controller.e2e.spec.ts
+```
+
+### Playwright Feature
+
+```
+e2e/{feature}/
+├── feature.spec.ts
+├── feature.page.ts
+└── feature.fixtures.ts
+```
+
+## Knowledge Analysis
+
+The `analyze` command maps files to knowledge documents based on file patterns:
+
+```bash
+$ hexa-ts analyze upload.composable.ts
+
+{
+  "success": true,
+  "files": ["upload.composable.ts"],
+  "mappings": [
+    {
+      "file": "upload.composable.ts",
+      "knowledges": ["vue-composable.knowledge.md"]
+    }
+  ]
+}
+```
+
+Knowledge files use frontmatter to declare their matching patterns:
+
+```yaml
+---
+name: vue-composable
+match: "*.composable.ts"
+---
+```
+
+## Requirements
+
+- Node.js 20+
+- Git (for `--changed` mode)
+
+## License
+
+MIT

package/bin/hexa-ts-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/mcp-server.js";

package/bin/hexa-ts.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli.js";