@przeprogramowani/10x-cli 0.2.0 → 0.3.0

package/README.md

@@ -28,9 +28,40 @@ npm install -g @przeprogramowani/10x-cli
 |---------|-------------|
 | `10x auth` | Magic-link login with your Circle-registered email |
 | `10x list` | Browse modules and lessons in your course |
-| `10x get <ref>` | Fetch a lesson and apply artifacts to `.claude/` |
+| `10x get <ref>` | Fetch a lesson and apply artifacts to your workspace |
 | `10x doctor` | Diagnose auth, API connectivity, and local config |
 
+### `10x get` Flags
+
+| Flag | Description |
+|------|-------------|
+| `--tool <tool>` | AI coding tool: `claude-code`, `cursor`, `copilot`, `codex`, `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`) |
+| `--dry-run` | Show what would be written without touching the filesystem |
+| `--course <slug>` | Override the course slug (default: `10xdevs3`) |
+
+#### Examples
+
+```bash
+# Fetch full lesson — writes skills, prompts, rules, configs
+10x get m1l1
+
+# Write only skills (skip prompts, rules, configs)
+10x get m1l1 --type skills
+
+# Write a single artifact
+10x get m1l1 --type skills --name code-review
+
+# Print to stdout (pipe-friendly)
+10x get m1l1 --print --type skills --name code-review
+10x get m1l1 --print --type skills --name code-review | pbcopy
+
+# Use with a different AI coding tool
+10x get m1l1 --tool cursor
+```
+
 ### Global Flags
 
 - `--json` — Machine-readable JSON output (auto-detected when piped)
@@ -45,6 +76,20 @@ Lessons are referenced by module and lesson number:
 - `m1l1` — Module 1, Lesson 1
 - `m2l3` — Module 2, Lesson 3
 
+### Multi-Tool Support
+
+On first run, the CLI prompts you to choose your AI coding tool. Artifacts are written to the correct directory for your tool:
+
+| Tool | Directory | Rules file |
+|------|-----------|------------|
+| Claude Code | `.claude/` | `CLAUDE.md` |
+| Cursor | `.cursor/` | `.cursor/rules/10x-course.mdc` |
+| GitHub Copilot | `.github/` | `.github/copilot-instructions.md` |
+| Codex CLI | `.agents/` | `AGENTS.md` |
+| Generic | `.ai/` | `AGENTS.md` |
+
+Override anytime with `--tool <name>`. Your choice is saved in `~/.config/10x-cli/config.json`.
+
 ## Development
 
 ```bash

package/dist/index.mjs

@@ -2271,8 +2271,16 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "Open-source CLI for 10xDevs course content",
+  repository: {
+    type: "git",
+    url: "https://github.com/przeprogramowani/10x-cli.git"
+  },
+  homepage: "https://github.com/przeprogramowani/10x-cli",
+  bugs: {
+    url: "https://github.com/przeprogramowani/10x-cli/issues"
+  },
   type: "module",
   bin: {
     "10x": "./dist/index.mjs"
@@ -3518,6 +3526,41 @@ async function fetchLesson(course, lessonId, token, options = {}) {
   }
   return result;
 }
+async function fetchArtifact(course, lessonId, type, name, tool, token, options = {}) {
+  const params = new URLSearchParams({ tool });
+  const path = `/api/artifacts/${encodeURIComponent(course)}/${encodeURIComponent(lessonId)}/${encodeURIComponent(type)}/${encodeURIComponent(name)}?${params}`;
+  const result = await apiGet(path, { token, signal: options.signal });
+  if (!result.ok)
+    return result;
+  const signature = result.responseHeaders.get("X-Bundle-Signature");
+  const keyIdRaw = result.responseHeaders.get("X-Bundle-Key-Id");
+  if (signature && keyIdRaw) {
+    const keyId = Number(keyIdRaw);
+    const responseBody = JSON.stringify(result.data);
+    try {
+      verifyBundleSignature(responseBody, signature, keyId);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return {
+        ok: false,
+        status: 0,
+        code: err instanceof SignatureError ? "signature_error" : "signature_internal_error",
+        error: message
+      };
+    }
+  } else if (REQUIRE_SIGNATURES) {
+    return {
+      ok: false,
+      status: 0,
+      code: "signature_missing",
+      error: "Artifact is missing a signature. The API may be misconfigured or compromised. " + "Do NOT use the content. Report this to the course team."
+    };
+  } else {
+    process.stderr.write(`Warning: artifact is not signed. Signature verification skipped.
+`);
+  }
+  return result;
+}
 async function fetchHealth(options = {}) {
   const timeoutMs = options.timeoutMs ?? 5000;
   const controller = new AbortController;
@@ -4023,6 +4066,7 @@ var CLI_VERSION = package_default.version;
 var DEFAULT_COURSE = "10xdevs3";
 function applyBundle(bundle, projectRoot, options = {}) {
   const dryRun = options.dryRun === true;
+  const partial = options.partial === true;
   const course = options.course ?? DEFAULT_COURSE;
   const profile = options.profile ?? PROFILES[DEFAULT_TOOL];
   const manifestDir = join4(projectRoot, profile.manifestDir);
@@ -4078,7 +4122,7 @@ function applyBundle(bundle, projectRoot, options = {}) {
     }
     return { name: config.name, path: target, action };
   });
-  if (!dryRun) {
+  if (!dryRun && !partial) {
     const removed = computeRemovals(prevManifest, bundle, profile, projectRoot);
     for (const entry of removed.skills)
       rmSync2(entry.path, { recursive: true, force: true });
@@ -4087,7 +4131,7 @@ function applyBundle(bundle, projectRoot, options = {}) {
     for (const entry of removed.configs)
       rmSync2(entry.path, { force: true });
   }
-  if (!dryRun) {
+  if (!dryRun && !partial) {
     const nextManifest = {
       package: CLI_PACKAGE_NAME,
       version: CLI_VERSION,
@@ -4213,9 +4257,13 @@ function isSafeName(name) {
 }
 
 // src/commands/get.ts
+var ARTIFACT_TYPES = ["skills", "prompts", "rules", "configs"];
+function isArtifactType(s) {
+  return ARTIFACT_TYPES.includes(s);
+}
 var DEFAULT_COURSE2 = "10xdevs3";
 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>", "Override the course slug (default: 10xdevs3)").option("--tool <tool>", "AI coding tool (claude-code, cursor, copilot, codex, generic)").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>", "Override the course slug (default: 10xdevs3)").option("--tool <tool>", "AI coding tool (claude-code, cursor, copilot, codex, 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)").action(async (ref, options) => {
     const ctx = resolveContext(options);
     await runGet(ctx, ref, options);
   });
@@ -4225,9 +4273,19 @@ async function runGet(ctx, ref, options) {
   if (!parsed) {
     outputError(ctx, "invalid_lesson_ref", `'${ref}' is not a valid lesson reference.`, ExitCodes.USAGE, "Use the form 'm<module>l<lesson>', for example 'm1l1' or 'm2l3'.");
   }
+  if (options.name && !options.type) {
+    outputError(ctx, "missing_type", "Specify --type when using --name.", ExitCodes.USAGE, "Usage: 10x get m1l1 --type skills --name code-review");
+  }
+  if (options.type && !isArtifactType(options.type)) {
+    outputError(ctx, "invalid_type", `Unknown artifact type '${options.type}'.`, ExitCodes.USAGE, `Supported types: ${ARTIFACT_TYPES.join(", ")}`);
+  }
   const auth = await requireAuth(ctx);
   const course = options.course ?? DEFAULT_COURSE2;
   const profile = await resolveToolProfile(options.tool);
+  if (options.print) {
+    await runPrintMode(ctx, parsed.lessonId, course, profile, auth.access_token, options);
+    return;
+  }
   verbose(ctx, `fetching lesson ${course}/${parsed.lessonId}`);
   const result = await fetchLesson(course, parsed.lessonId, auth.access_token);
   if (!result.ok) {
@@ -4236,13 +4294,77 @@ async function runGet(ctx, ref, options) {
   const orphanWarning = detectOrphanedArtifacts(process.cwd(), profile);
   if (orphanWarning)
     verbose(ctx, orphanWarning);
-  const bundle = result.data;
+  const isFiltered = options.type !== undefined;
+  const bundle = filterBundle(ctx, result.data, options);
   const writeResult = applyBundle(bundle, process.cwd(), {
     dryRun: options.dryRun === true,
-    profile
+    profile,
+    partial: isFiltered
   });
   renderGetResult(ctx, bundle, writeResult, options.dryRun === true, profile);
 }
+function filterBundle(ctx, bundle, options) {
+  if (!options.type) {
+    if (options.name) {
+      outputError(ctx, "missing_type", "Specify --type when using --name.", ExitCodes.USAGE, "Usage: 10x get m1l1 --type skills --name code-review");
+    }
+    return bundle;
+  }
+  if (!isArtifactType(options.type)) {
+    outputError(ctx, "invalid_type", `Unknown artifact type '${options.type}'.`, ExitCodes.USAGE, `Supported types: ${ARTIFACT_TYPES.join(", ")}`);
+  }
+  const type = options.type;
+  const empty = {
+    ...bundle,
+    skills: [],
+    prompts: [],
+    rules: [],
+    configs: []
+  };
+  if (options.name) {
+    const match = bundle[type].find((a2) => a2.name === options.name);
+    if (!match) {
+      outputError(ctx, "artifact_not_found", `No ${type} artifact named '${options.name}' in ${bundle.lessonId}.`, ExitCodes.NOT_FOUND, `Available ${type}: ${bundle[type].map((a2) => a2.name).join(", ") || "(none)"}`);
+    }
+    return { ...empty, [type]: [match] };
+  }
+  return { ...empty, [type]: bundle[type] };
+}
+async function runPrintMode(ctx, lessonId, course, profile, token, options) {
+  if (!options.type) {
+    outputError(ctx, "missing_type", "Specify --type for --print mode.", ExitCodes.USAGE, "Usage: 10x get m1l1 --print --type skills [--name code-review]");
+  }
+  if (!isArtifactType(options.type)) {
+    outputError(ctx, "invalid_type", `Unknown artifact type '${options.type}'.`, ExitCodes.USAGE, `Supported types: ${ARTIFACT_TYPES.join(", ")}`);
+  }
+  if (options.name) {
+    verbose(ctx, `fetching artifact ${course}/${lessonId}/${options.type}/${options.name}`);
+    const result = await fetchArtifact(course, lessonId, options.type, options.name, profile.toolId, token);
+    if (!result.ok) {
+      handleLessonError(ctx, result.status, result.code, result.error, result.payload);
+    }
+    if (ctx.json) {
+      output(ctx, "", result.data);
+    } else {
+      process.stdout.write(result.data.content);
+    }
+  } else {
+    verbose(ctx, `fetching lesson ${course}/${lessonId} (filtering by ${options.type})`);
+    const result = await fetchLesson(course, lessonId, token);
+    if (!result.ok) {
+      handleLessonError(ctx, result.status, result.code, result.error, result.payload);
+    }
+    const artifacts = result.data[options.type];
+    if (ctx.json) {
+      output(ctx, "", artifacts);
+    } else {
+      const contents = artifacts.map((a2) => a2.content);
+      process.stdout.write(contents.join(`
+---
+`));
+    }
+  }
+}
 function handleLessonError(ctx, status, code, error, payload) {
   verbose(ctx, `lesson fetch failed: status=${status} code=${code}`);
   if (status === 403) {

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Open-source CLI for 10xDevs course content",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/przeprogramowani/10x-cli.git"
+  },
+  "homepage": "https://github.com/przeprogramowani/10x-cli",
+  "bugs": {
+    "url": "https://github.com/przeprogramowani/10x-cli/issues"
+  },
   "type": "module",
   "bin": {
     "10x": "./dist/index.mjs"