@chiralkit/kits 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xHadal
+
+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,15 @@
+# @chiralkit/kits
+
+Kit aggregator for the chiralkit monorepo. Exports the canonical list of kit names (`ui`, `agents`, `cli`, `workspace`, `generator`, `training`), the `pairs.json` source-of-truth for the three ring-2 enantiomeric pairs (`ui↔agents`, `cli↔workspace`, `generator↔training`), and helpers for discovering per-kit source files (`ROADMAP.md`, `BACKLOG.md`) inside a chiralkit workspace.
+
+Primarily an internal dependency of `@chiralkit/cli`; published so the CLI's `workspace:*` reference resolves against npm at consume-time.
+
+## Install
+
+```sh
+pnpm add @chiralkit/kits
+```
+
+## Status
+
+`0.1.0-alpha.0` — first published version. `resolveKitsRoot()` currently returns the package's install directory; for consumer projects that run PM ceremonies over their own `kits/` folder, the resolution strategy will migrate to config-driven in `0.x`. See the main repo: https://github.com/xHadal/chiralkit

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export declare const KIT_NAMES: readonly ["ui", "agents", "cli", "workspace", "generator", "training"];
+export type KitName = (typeof KIT_NAMES)[number];
+export declare function resolveKitsRoot(): string;
+export interface KitSource {
+    name: KitName;
+    roadmapPath: string | null;
+    backlogPath: string | null;
+}
+export declare function discoverKitSources(kitsRoot: string): Promise<KitSource[]>;

package/dist/index.js

@@ -0,0 +1,32 @@
+import { createRequire } from "node:module";
+import { access } from "node:fs/promises";
+import { constants } from "node:fs";
+import { dirname, join } from "node:path";
+export const KIT_NAMES = ["ui", "agents", "cli", "workspace", "generator", "training"];
+export function resolveKitsRoot() {
+    const req = createRequire(import.meta.url);
+    return dirname(req.resolve("@chiralkit/kits/package.json"));
+}
+async function exists(path) {
+    try {
+        await access(path, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function discoverKitSources(kitsRoot) {
+    const out = [];
+    for (const name of KIT_NAMES) {
+        const roadmap = join(kitsRoot, name, "ROADMAP.md");
+        const backlog = join(kitsRoot, name, "BACKLOG.md");
+        out.push({
+            name,
+            roadmapPath: (await exists(roadmap)) ? roadmap : null,
+            backlogPath: (await exists(backlog)) ? backlog : null,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAGhG,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,WAAW,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YACrD,WAAW,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;SACtD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@chiralkit/kits",
+  "version": "0.1.0-alpha.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pairs.json": "./pairs.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "pairs.json"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "pretest": "pnpm run build",
+    "test": "node --test 'src/**/*.test.ts'"
+  }
+}

package/pairs.json

@@ -0,0 +1,30 @@
+{
+  "$comment": "Fuente de verdad de los pares enantioméricos de kits en la espiral productos (ring 2). Cada par pasa el test de 3 partes: estructura compartida, superficie mirrored en un axis, función opuesta. Ver docs/superpowers/specs/ para el detalle de chirality y products spiral.",
+  "version": 1,
+  "pairs": [
+    {
+      "a": "ui",
+      "b": "agents",
+      "chiral_axis": "consumer",
+      "shared_structure": "Ambos son type del registry con mismo envelope, mismo spec.json shape, mismo distribution flow via `ck add`.",
+      "mirrored_surface": "React/HTML/CSS/Web Components ↔ prompts/skills/rules/tools",
+      "opposed_function": "Renderizar para humano ↔ ejecutar para LLM"
+    },
+    {
+      "a": "cli",
+      "b": "workspace",
+      "chiral_axis": "modality",
+      "shared_structure": "Ambos son operator-surfaces sobre el registry — leen y escriben los mismos módulos.",
+      "mirrored_surface": "Texto imperativo (comandos, flags) ↔ visual declarativo (paneles, clicks)",
+      "opposed_function": "Escribir un comando ↔ clickear un estado"
+    },
+    {
+      "a": "generator",
+      "b": "training",
+      "chiral_axis": "lifecycle_direction",
+      "shared_structure": "Ambos consumen/emiten traces del uso de módulos y comparten el response parser.",
+      "mirrored_surface": "Prompt → módulo nuevo ↔ Traces → módulo mejor",
+      "opposed_function": "Crear módulos desde spec ↔ refinar módulos desde uso"
+    }
+  ]
+}