@przeprogramowani/10x-cli 1.22.1 → 1.23.0

package/README.md

@@ -38,7 +38,7 @@ Once your release includes it, run from the intended project directory:
 
 This installs **both** `10x-cli-setup` and `10x-cli-guide`, each with its complete
 `SKILL.md` and `references/compatibility.md`, into `.github/skills/`. Use
-`--tool claude-code`, `cursor`, `codex`, `devin-desktop`, `gemini`, or `generic`
+`--tool claude-code`, `cursor`, `codex`, `devin-desktop`, `gemini`, `kiro`, or `generic`
 when that is your intended tool. The target must be explicit; installation is
 project-only. There is no `--global`, automatic agent detection, `skills`/npx
 subprocess, authentication, or network access. The helper bytes come from the
@@ -175,7 +175,7 @@ remain visible. Full lesson downloads and other commands remain available below.
 
 | Flag | Description |
 |------|-------------|
-| `--tool <tool>` | AI coding tool: `claude-code`, `cursor`, `copilot`, `codex`, `devin-desktop`, `gemini`, `generic` |
+| `--tool <tool>` | AI coding tool: `claude-code`, `cursor`, `copilot`, `codex`, `devin-desktop`, `gemini`, `kiro`, `generic` |
 | `--print` | Output artifact content to stdout instead of writing files |
 | `--type <type>` | Filter by artifact type: `skills`, `prompts`, `rules`, `configs` |
 | `--name <name>` | Filter by artifact name (requires `--type`) |
@@ -302,8 +302,9 @@ scoring live in the template and the instance.
 | Flag | Description |
 |------|-------------|
 | `--template-version <tag>` | Template tag to install (default: latest) |
-| `--tool <id>` | Agent tool for skill placement (`claude-code`, `cursor`, `copilot`, `codex`, `devin-desktop`, `gemini`, `generic`) |
+| `--tool <id>` | Agent tool for skill placement (`claude-code`, `cursor`, `copilot`, `codex`, `devin-desktop`, `gemini`, `kiro`, `generic`) |
 | `--yes` | Run non-interactively, accepting defaults |
+| `--deep` | Clone the detected base repo with full history (default: shallow, HEAD only) |
 
 ```bash
 # Create an instance next to your product repo (run inside it to auto-register)
@@ -312,10 +313,18 @@ scoring live in the template and the instance.
 # Pin the template version
 10x bench-kit init my-benchmark --template-version v0.8.0
 
+# Keep the full history in the base repo clone under .repos/
+10x bench-kit init my-benchmark --deep
+
 # Upgrade an existing instance to the latest template
 10x bench-kit update
 ```
 
+A detected base repo is cloned into the instance's `.repos/<name>/` (gitignored)
+as a working copy for the authoring skills. That clone is **shallow** — HEAD only
+— because the skills read the file tree, not the history; `--deep` keeps the full
+history, and `git fetch --unshallow` inside the clone adds it later.
+
 Re-running `init` on an existing instance is a **repair**: missing template
 files are restored, company content is never touched. After `update`, run the
 instance's `bench validate` to confirm the content still matches the new kit.
@@ -346,6 +355,7 @@ On first run, the CLI prompts you to choose your AI coding tool. Artifacts are w
 | Codex CLI | `.agents/` | `AGENTS.md` |
 | Devin Desktop | `.devin/` | `AGENTS.md` |
 | Gemini CLI | `.gemini/` | `GEMINI.md` |
+| Kiro | `.kiro/` | `AGENTS.md` |
 | Generic | `.ai/` | `AGENTS.md` |
 
 Override with `--tool <name>`. Validated writing commands save your choice in `~/.config/10x-cli/config.json`. Previews leave it unchanged.

package/dist/index.mjs

@@ -3183,7 +3183,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "1.22.1",
+  version: "1.23.0",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -3208,10 +3208,14 @@ var package_default = {
     build: "bun build src/index.ts --outfile dist/index.mjs --target node",
     "build:binary": "bun build --compile --minify src/index.ts --outfile dist/10x",
     "generate-types": "bun run scripts/generate-types.ts",
-    typecheck: "tsc --noEmit",
+    typecheck: "node node_modules/typescript/bin/tsc --noEmit",
     test: "bun test",
     lint: "bun run --bun node_modules/oxlint/bin/oxlint .",
-    "validate:cli-skills": "node scripts/validate-cli-skills.mjs"
+    "validate:cli-skills": "node scripts/validate-cli-skills.mjs",
+    "quality:fast": "node .quality/run.mjs fast",
+    "quality:affected": "node .quality/run.mjs affected",
+    "quality:gate": "node .quality/run.mjs gate",
+    "quality:risk": "node .quality/run.mjs risk"
   },
   dependencies: {
     "@clack/prompts": "0.9.1",
@@ -4732,6 +4736,19 @@ var PROFILES = {
     sentinelBegin: SENTINEL_BEGIN,
     sentinelEnd: SENTINEL_END
   },
+  kiro: {
+    toolId: "kiro",
+    contentToolId: "generic",
+    displayName: "Kiro",
+    skillPath: (n) => `.kiro/skills/${n}/SKILL.md`,
+    skillDir: (n) => `.kiro/skills/${n}`,
+    promptPath: (n) => `.kiro/prompts/${n}.md`,
+    configPath: (n) => `.kiro/config-templates/${n}`,
+    rulesFile: "AGENTS.md",
+    manifestDir: ".kiro",
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
+  },
   generic: {
     toolId: "generic",
     displayName: "Other / Generic",
@@ -5177,6 +5194,27 @@ function detectTools(projectRoot) {
   } else if (hit(".gemini")) {
     signals.push({ profileId: "gemini", confidence: "medium", reason: ".gemini/ directory" });
   }
+  if (hit(".kiro/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "kiro",
+      confidence: "strong",
+      reason: ".kiro/.10x-cli-manifest.json"
+    });
+  } else if (hit(".kiro/steering") || hit(".kiro/specs")) {
+    signals.push({
+      profileId: "kiro",
+      confidence: "strong",
+      reason: ".kiro/steering/ or .kiro/specs/"
+    });
+  } else if (hit(".kiro/hooks") || hit(".kiro/settings")) {
+    signals.push({
+      profileId: "kiro",
+      confidence: "strong",
+      reason: ".kiro/hooks/ or .kiro/settings/"
+    });
+  } else if (hit(".kiro")) {
+    signals.push({ profileId: "kiro", confidence: "strong", reason: ".kiro/ directory" });
+  }
   if (hit(".ai/" + MANIFEST_FILENAME)) {
     signals.push({
       profileId: "generic",
@@ -5198,6 +5236,7 @@ var PROFILE_ORDER = [
   "codex",
   "devin-desktop",
   "gemini",
+  "kiro",
   "generic"
 ];
 function rankSignals(signals) {
@@ -5220,7 +5259,7 @@ var TEMPLATE_REPO_URL = "https://github.com/przeprogramowani/10x-bench-kit";
 var BOOTSTRAP_ENTRY = join5(".bench-kit", "bootstrap", "index.mjs");
 var CONTRACT_VERSION = 1;
 function registerBenchKitCommand(cli) {
-  cli.command("bench-kit <action> [dir]", "Manage a benchmark instance (actions: init, update)").option("--template-version <tag>", "Template tag to install (default: latest)").option("--tool <id>", `Agent tool for skill placement (${Object.keys(PROFILES).join(", ")})`).option("--yes", "Run non-interactively, accepting defaults").example("10x bench-kit init my-benchmark").example("10x bench-kit init my-benchmark --template-version v0.1.0").example("10x bench-kit update").action(async (action, dir, options) => {
+  cli.command("bench-kit <action> [dir]", "Manage a benchmark instance (actions: init, update)").option("--template-version <tag>", "Template tag to install (default: latest)").option("--tool <id>", `Agent tool for skill placement (${Object.keys(PROFILES).join(", ")})`).option("--yes", "Run non-interactively, accepting defaults").option("--deep", "Clone the detected base repo with full history (default: shallow, HEAD only)").example("10x bench-kit init my-benchmark").example("10x bench-kit init my-benchmark --template-version v0.1.0").example("10x bench-kit init my-benchmark --deep").example("10x bench-kit update").action(async (action, dir, options) => {
     const ctx = resolveContext(options);
     if (action === "init") {
       await runBenchKitInit(ctx, dir, options);
@@ -5270,6 +5309,7 @@ async function runBenchKitInit(ctx, dirArg, options, deps = defaultDeps) {
       templateRef: requestedRef ?? "latest",
       templateSource: TEMPLATE_REPO_URL,
       detectedBaseRepo,
+      ...options.deep === true ? { deepClone: true } : {},
       now: deps.now().toISOString()
     };
     verbose(ctx, `running template bootstrap (${BOOTSTRAP_ENTRY})`);
@@ -5280,7 +5320,8 @@ async function runBenchKitInit(ctx, dirArg, options, deps = defaultDeps) {
     let baseRepoClone = "skipped";
     if (res.baseRepoClone != null) {
       const cloneDest = join5(targetDir, res.baseRepoClone.dest);
-      verbose(ctx, `cloning base repo into ${res.baseRepoClone.dest}`);
+      const depth = res.baseRepoClone.depth ?? null;
+      verbose(ctx, `cloning base repo into ${res.baseRepoClone.dest}${depth === null ? "" : ` (depth ${depth})`}`);
       const cloned = await deps.cloneBaseRepo(res.baseRepoClone, cloneDest);
       if (cloned.ok) {
         baseRepoClone = "cloned";
@@ -5306,9 +5347,9 @@ async function runBenchKitInit(ctx, dirArg, options, deps = defaultDeps) {
         `Pinned the demo task to ${detectedBaseRepo.headCommit.slice(0, 12)} (current HEAD of the base repo).`
       ] : [],
       ...baseRepoClone === "cloned" && res.baseRepoClone != null ? [
-        `Cloned '${res.baseRepoClone.name}' into ${res.baseRepoClone.dest}/ — local working copy for the authoring skills (gitignored).`
+        `Cloned '${res.baseRepoClone.name}' into ${res.baseRepoClone.dest}/ — ${(res.baseRepoClone.depth ?? null) === null ? "local working copy with full history" : "shallow local working copy (HEAD only; 'git fetch --unshallow' there when you need history)"} for the authoring skills (gitignored).`
       ] : baseRepoClone === "failed" && res.baseRepoClone != null ? [
-        `Base repo clone failed — run 'git clone ${res.baseRepoClone.url} ${res.baseRepoClone.dest}' yourself.`
+        `Base repo clone failed — run 'git clone${(res.baseRepoClone.depth ?? null) === null ? "" : " --depth 1"} ${res.baseRepoClone.url} ${res.baseRepoClone.dest}' yourself.`
       ] : [],
       ...res.runnerDeps === "failed" ? ["Runner dependencies did not install — run 'npm ci --prefix .bench-kit/runner' yourself."] : res.runnerDeps === "installed" ? ["Runner dependencies installed (.bench-kit/runner/node_modules)."] : [],
       res.committed === true ? "Initialized a fresh git repository with an initial commit." : "Initialized a fresh git repository (initial commit skipped — commit the files yourself).",
@@ -5552,7 +5593,10 @@ var defaultDeps = {
     return { rootDir, name: basename(rootDir), url, headCommit };
   },
   async cloneBaseRepo(repo, destDir) {
-    const clone = await run("git", ["clone", "--quiet", repo.rootDir, destDir]);
+    const depth = repo.depth ?? null;
+    const source = depth === null ? repo.rootDir : `file://${resolve2(repo.rootDir)}`;
+    const args = depth === null ? ["clone", "--quiet", source, destDir] : ["clone", "--quiet", "--depth", String(depth), "--no-tags", source, destDir];
+    const clone = await run("git", args);
     if (!clone.ok)
       return { ok: false, error: clone.error };
     return run("git", ["-C", destDir, "remote", "set-url", "origin", repo.url]);
@@ -7118,7 +7162,7 @@ function resolveCourseRulesFlag(argv) {
   return;
 }
 function registerGetCommand(cli) {
-  cli.command("get <ref>", "Fetch and apply a lesson pack").option("--dry-run", "Show what would be written without touching the filesystem").option("--course <course>", "Select course ID or slug (default: project edition or API recommendation)").option("--tool <tool>", "AI coding tool (claude-code, cursor, copilot, codex, devin-desktop, gemini, generic)").option("--print", "Print artifact content to stdout instead of writing to files").option("--type <type>", "Artifact type filter: skills, prompts, rules, configs").option("--name <name>", "Artifact name filter (requires --type)").option("--lang <lang>", "Content language: en (default) or pl").option("--no-course-rules", "Skip applying the course rules block to your rules file (CLAUDE.md/AGENTS.md)").action(async (ref, options) => {
+  cli.command("get <ref>", "Fetch and apply a lesson pack").option("--dry-run", "Show what would be written without touching the filesystem").option("--course <course>", "Select course ID or slug (default: project edition or API recommendation)").option("--tool <tool>", "AI coding tool (claude-code, cursor, copilot, codex, devin-desktop, gemini, kiro, generic)").option("--print", "Print artifact content to stdout instead of writing to files").option("--type <type>", "Artifact type filter: skills, prompts, rules, configs").option("--name <name>", "Artifact name filter (requires --type)").option("--lang <lang>", "Content language: en (default) or pl").option("--no-course-rules", "Skip applying the course rules block to your rules file (CLAUDE.md/AGENTS.md)").action(async (ref, options) => {
     const ctx = resolveContext(options);
     await runGet(ctx, ref, options);
   });
@@ -8759,7 +8803,7 @@ function isLessonFresh(root, manifest, id, profile, lang, courseRules) {
 // src/commands/sync.ts
 var SUPPORTED_LANGS = ["en", "pl"];
 function registerSyncCommand(cli) {
-  cli.command("sync", "Bulk-download and update lessons, reporting what changed upstream").option("--all", "Sync every unlocked lesson (default: only lessons you've already downloaded)").option("--dry-run", "Show what would change without writing").option("--force", "Ignore the cheap-skip digest and overwrite local edits with upstream").option("--module <module>", "Limit to one module (e.g. 'm2' or '2')").option("--course <course>", "Select course ID or slug (default: project edition or API recommendation)").option("--tool <tool>", "AI coding tool (claude-code, cursor, copilot, codex, devin-desktop, gemini, generic)").option("--lang <lang>", "Content language: en (default) or pl").option("--no-course-rules", "Skip applying the course rules block to your rules file (CLAUDE.md/AGENTS.md)").action(async (options) => {
+  cli.command("sync", "Bulk-download and update lessons, reporting what changed upstream").option("--all", "Sync every unlocked lesson (default: only lessons you've already downloaded)").option("--dry-run", "Show what would change without writing").option("--force", "Ignore the cheap-skip digest and overwrite local edits with upstream").option("--module <module>", "Limit to one module (e.g. 'm2' or '2')").option("--course <course>", "Select course ID or slug (default: project edition or API recommendation)").option("--tool <tool>", "AI coding tool (claude-code, cursor, copilot, codex, devin-desktop, gemini, kiro, generic)").option("--lang <lang>", "Content language: en (default) or pl").option("--no-course-rules", "Skip applying the course rules block to your rules file (CLAUDE.md/AGENTS.md)").action(async (options) => {
     const ctx = resolveContext(options);
     await runSync(ctx, options);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",
@@ -25,10 +25,14 @@
     "build": "bun build src/index.ts --outfile dist/index.mjs --target node",
     "build:binary": "bun build --compile --minify src/index.ts --outfile dist/10x",
     "generate-types": "bun run scripts/generate-types.ts",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "node node_modules/typescript/bin/tsc --noEmit",
     "test": "bun test",
     "lint": "bun run --bun node_modules/oxlint/bin/oxlint .",
-    "validate:cli-skills": "node scripts/validate-cli-skills.mjs"
+    "validate:cli-skills": "node scripts/validate-cli-skills.mjs",
+    "quality:fast": "node .quality/run.mjs fast",
+    "quality:affected": "node .quality/run.mjs affected",
+    "quality:gate": "node .quality/run.mjs gate",
+    "quality:risk": "node .quality/run.mjs risk"
   },
   "dependencies": {
     "@clack/prompts": "0.9.1",