@hyphaene/hexa-ts-kit 1.0.0

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import {
+  analyzeCommand,
+  lintCommand,
+  scaffoldCommand
+} from "./chunk-56VIQG3N.js";
+
+// src/cli.ts
+import { program } from "commander";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var { version: VERSION } = require2("../package.json");
+program.name("hexa-ts").description(
+  "TypeScript dev kit: architecture linting, scaffolding, knowledge analysis"
+).version(VERSION);
+program.command("lint [path]").description("Lint files for colocation architecture rules").option("-f, --format <type>", "Output format: console, json", "console").option("--changed", "Only lint files changed in git").option(
+  "--rules <rules>",
+  "Comma-separated list of rule prefixes to run (COL,NAM,DOM,VUE,etc)"
+).option("--quiet", "Only show errors, hide warnings and info").option("--debug", "Show debug information").action(lintCommand);
+program.command("analyze [files...]").description("Map files to their associated knowledges").option("--changed", "Analyze files changed in git").option(
+  "--knowledge-path <path>",
+  "Path to knowledge files",
+  "~/.claude/marketplace/shared/knowledge"
+).action(analyzeCommand);
+program.command("scaffold <type> <path>").description("Generate a colocated feature structure").option("--dry-run", "Show what would be created without writing files").action(scaffoldCommand);
+program.parse();

package/dist/mcp-server.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/mcp-server.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import {
+  analyzeCore,
+  lintCore,
+  scaffoldCore
+} from "./chunk-56VIQG3N.js";
+
+// src/mcp-server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+var { version: VERSION } = require2("../package.json");
+var server = new McpServer({
+  name: "hexa-ts-kit",
+  version: VERSION
+});
+server.tool(
+  "lint",
+  "Lint files for colocation architecture rules. Checks 71 rules across structure (COL, NAM, DOM) and AST (VUE, RUL, TSP) categories. Use --changed for incremental mode on git-modified files only.",
+  {
+    path: z.string().optional().describe("Path to lint (default: current working directory)"),
+    changed: z.boolean().optional().describe("Only lint git-changed files (staged and unstaged)"),
+    rules: z.string().optional().describe(
+      "Filter by rule prefix, comma-separated (COL, NAM, DOM, VUE, RUL, TSP)"
+    ),
+    quiet: z.boolean().optional().describe("Only show errors, hide warnings and info")
+  },
+  async (params) => {
+    const result = await lintCore({
+      path: params.path,
+      changed: params.changed,
+      rules: params.rules,
+      quiet: params.quiet
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
+    };
+  }
+);
+server.tool(
+  "analyze",
+  "Map files to their associated knowledges. CALL THIS BEFORE writing .composable.ts, .rules.ts, .vue, .controller.ts, .service.ts files to know which knowledge files to read for best practices and patterns.",
+  {
+    files: z.array(z.string()).optional().describe("Files to analyze (relative or absolute paths)"),
+    changed: z.boolean().optional().describe("Analyze git-changed files instead of specified files"),
+    knowledgePath: z.string().optional().describe(
+      "Path to knowledge files (default: ~/.claude/marketplace/shared/knowledge)"
+    )
+  },
+  async (params) => {
+    const result = await analyzeCore({
+      files: params.files,
+      changed: params.changed,
+      knowledgePath: params.knowledgePath
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
+    };
+  }
+);
+server.tool(
+  "scaffold",
+  "Generate a complete colocated feature structure with all required files. Creates Vue features (component, composable, rules, types, query, translations, tests), NestJS features (module, controller, service, types, tests), or Playwright features (spec, page object, fixtures).",
+  {
+    type: z.enum(["vue-feature", "nestjs-feature", "playwright-feature"]).describe("Type of feature to scaffold"),
+    path: z.string().describe("Target path for the feature directory"),
+    dryRun: z.boolean().optional().describe("Preview files that would be created without writing them")
+  },
+  async (params) => {
+    const result = await scaffoldCore({
+      type: params.type,
+      path: params.path,
+      dryRun: params.dryRun
+    });
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(result, null, 2)
+        }
+      ]
+    };
+  }
+);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((error) => {
+  console.error("Failed to start MCP server:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@hyphaene/hexa-ts-kit",
+  "version": "1.0.0",
+  "description": "TypeScript dev kit for Claude Code agents: architecture linting, scaffolding, knowledge analysis",
+  "type": "module",
+  "bin": {
+    "hexa-ts": "./bin/hexa-ts.js",
+    "hexa-ts-mcp": "./bin/hexa-ts-mcp.js",
+    "hts": "./bin/hexa-ts.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsup src/cli.ts src/mcp-server.ts --format esm --dts --clean",
+    "dev": "tsup src/cli.ts src/mcp-server.ts --format esm --watch",
+    "lint": "node bin/hexa-ts.js lint",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hyphaene/hexa-ts-kit.git"
+  },
+  "keywords": [
+    "claude",
+    "mcp",
+    "lint",
+    "scaffold",
+    "vue",
+    "nestjs",
+    "playwright",
+    "colocation"
+  ],
+  "author": "hyphaene",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/hyphaene/hexa-ts-kit/issues"
+  },
+  "homepage": "https://github.com/hyphaene/hexa-ts-kit#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "@typescript-eslint/typescript-estree": "^8.50.1",
+    "commander": "^12.1.0",
+    "fast-glob": "^3.3.2",
+    "gray-matter": "^4.0.3",
+    "minimatch": "^10.0.1",
+    "picocolors": "^1.1.1",
+    "vue-eslint-parser": "^10.2.0",
+    "zod": "^4.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^3.1.4",
+    "semantic-release": "^24.2.5",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.1.4"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/npm",
+      "@semantic-release/github"
+    ]
+  }
+}