@przeprogramowani/10x-cli 1.7.0 → 1.8.0

package/README.md

@@ -69,6 +69,7 @@ Once installed, just tell your agent to **set up 10x-cli** and it will pick up t
 | `--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`) |
+| `--no-course-rules` | Skip the course rules block in your rules file (`CLAUDE.md`/`AGENTS.md`); strips an existing one. Use `--course-rules` to re-enable. |
 
 #### Examples
 
@@ -88,8 +89,21 @@ Once installed, just tell your agent to **set up 10x-cli** and it will pick up t
 
 # Use with a different AI coding tool
 10x get m1l1 --tool cursor
+
+# Skip the course rules block (use only your rules). Persisted across runs;
+# a previously-applied block is stripped. Re-enable later with --course-rules.
+10x get m1l1 --no-course-rules
+10x get m1l2 --course-rules
+
+# An explicit rules request always applies, even with the opt-out persisted
+10x get m1l1 --type rules
 ```
 
+> The `--no-course-rules` / `--course-rules` choice is saved as `courseRules`
+> in `config.json` and applies to subsequent plain `10x get` runs. An explicit
+> `--type rules` request overrides the opt-out for that run. Skills, prompts,
+> and config-templates are unaffected.
+
 ### Global Flags
 
 - `--json` — Machine-readable JSON output (auto-detected when piped)

package/dist/index.mjs

@@ -2271,7 +2271,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "1.7.0",
+  version: "1.8.0",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -2992,6 +2992,9 @@ function readToolConfig() {
     if (parsed.acknowledgedOrphans !== undefined && (!Array.isArray(parsed.acknowledgedOrphans) || !parsed.acknowledgedOrphans.every((x2) => typeof x2 === "string"))) {
       delete parsed.acknowledgedOrphans;
     }
+    if (parsed.courseRules !== undefined && typeof parsed.courseRules !== "boolean") {
+      delete parsed.courseRules;
+    }
     return parsed;
   } catch {
     return null;
@@ -3004,6 +3007,14 @@ function saveToolConfig(config) {
   }
   writeJsonAtomic(toolConfigPath(), config);
 }
+function updateToolConfig(patch) {
+  const current = readToolConfig();
+  const merged = { ...current, ...patch };
+  if (typeof merged.tool !== "string") {
+    throw new Error("updateToolConfig: refusing to persist a config without a `tool` — " + "no prior config exists and the patch did not seed one.");
+  }
+  saveToolConfig(merged);
+}
 
 // src/lib/api-client.ts
 var DEFAULT_API_BASE = "https://10x-toolkit-api.przeprogramowani.workers.dev";
@@ -4563,6 +4574,7 @@ async function applyBundle(bundle, projectRoot, options = {}) {
   const course = options.course ?? DEFAULT_COURSE;
   const profile = options.profile ?? PROFILES[DEFAULT_TOOL];
   const onConflict = options.onConflict;
+  const applyCourseRules = options.applyCourseRules !== false;
   const manifestDir = join5(projectRoot, profile.manifestDir);
   const prevManifest = readManifest(manifestDir);
   for (const skill of bundle.skills) {
@@ -4672,7 +4684,17 @@ async function applyBundle(bundle, projectRoot, options = {}) {
   const rulesFilePath = join5(projectRoot, profile.rulesFile);
   const existingRules = readFileOrEmpty(rulesFilePath);
   let rulesAction;
-  if (bundle.rules.length === 0) {
+  if (!applyCourseRules) {
+    const { content: stripped, removed: removed2 } = removeRulesBlockWithMarkers(existingRules, profile.sentinelBegin, profile.sentinelEnd);
+    if (removed2 && stripped !== existingRules) {
+      rulesAction = "removed";
+      if (!dryRun) {
+        writeFileAt(rulesFilePath, stripped);
+      }
+    } else {
+      rulesAction = "unchanged";
+    }
+  } else if (bundle.rules.length === 0) {
     rulesAction = "unchanged";
   } else {
     const rulesBody = bundle.rules.map((r2) => r2.content.trim()).join(`
@@ -5346,9 +5368,16 @@ var ARTIFACT_TYPES = ["skills", "prompts", "rules", "configs"];
 function isArtifactType(s) {
   return ARTIFACT_TYPES.includes(s);
 }
+function resolveCourseRulesFlag(argv) {
+  if (argv.includes("--no-course-rules"))
+    return false;
+  if (argv.includes("--course-rules"))
+    return true;
+  return;
+}
 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, windsurf, 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").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, windsurf, 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) => {
     const ctx = resolveContext(options);
     await runGet(ctx, ref, options);
   });
@@ -5371,10 +5400,18 @@ async function runGet(ctx, ref, options) {
   const auth = await requireAuth(ctx);
   const course = options.course ?? DEFAULT_COURSE2;
   const profile = await resolveToolProfile(options.tool, process.cwd());
+  const dryRun = options.dryRun === true;
   const lang = options.lang ?? readToolConfig()?.lang ?? "en";
-  if (options.lang) {
-    const existing = readToolConfig();
-    saveToolConfig({ tool: existing?.tool ?? profile.toolId, lang: options.lang });
+  const explicitCourseRules = resolveCourseRulesFlag(process.argv);
+  const resolvedCourseRules = explicitCourseRules ?? readToolConfig()?.courseRules ?? true;
+  if (!dryRun && (options.lang || explicitCourseRules !== undefined)) {
+    const tool = readToolConfig()?.tool ?? profile.toolId;
+    const patch = { tool };
+    if (options.lang)
+      patch.lang = options.lang;
+    if (explicitCourseRules !== undefined)
+      patch.courseRules = explicitCourseRules;
+    updateToolConfig(patch);
   }
   if (options.print) {
     await runPrintMode(ctx, parsed.lessonId, course, profile, auth.access_token, lang, options);
@@ -5405,15 +5442,18 @@ async function runGet(ctx, ref, options) {
   if (prevManifest && prevManifest.manifestVersion === 2) {
     showUpgradeNotice(isTTY);
   }
+  const applyCourseRules = isFiltered ? true : resolvedCourseRules;
   const writeResult = await applyBundle(bundle, process.cwd(), {
-    dryRun: options.dryRun === true,
+    dryRun,
     profile,
     partial: isFiltered,
-    onConflict: createConflictResolver(isTTY)
+    onConflict: createConflictResolver(isTTY),
+    applyCourseRules
   });
-  renderGetResult(ctx, bundle, writeResult, options.dryRun === true, profile, {
+  renderGetResult(ctx, bundle, writeResult, dryRun, profile, {
     language: contentLang ?? lang,
-    languageFallback: isFallback
+    languageFallback: isFallback,
+    applyCourseRules
   });
 }
 function filterBundle(ctx, bundle, options) {
@@ -5553,7 +5593,12 @@ function formatAction(action) {
       return action;
   }
 }
-function renderGetResult(ctx, bundle, writeResult, dryRun, profile, langMeta = { language: "en", languageFallback: false }) {
+function renderGetResult(ctx, bundle, writeResult, dryRun, profile, langMeta = {
+  language: "en",
+  languageFallback: false,
+  applyCourseRules: true
+}) {
+  const applyCourseRules = langMeta.applyCourseRules;
   const totalRemovals = writeResult.removals.skills.length + writeResult.removals.prompts.length + writeResult.removals.configs.length;
   if (ctx.json) {
     output(ctx, "", {
@@ -5574,7 +5619,7 @@ function renderGetResult(ctx, bundle, writeResult, dryRun, profile, langMeta = {
       counts: {
         skills: writeResult.skills.length,
         prompts: writeResult.prompts.length,
-        rules: bundle.rules.length,
+        rules: applyCourseRules ? bundle.rules.length : 0,
         configs: writeResult.configs.length,
         removals: totalRemovals
       }
@@ -5602,7 +5647,13 @@ function renderGetResult(ctx, bundle, writeResult, dryRun, profile, langMeta = {
   for (const prompt of writeResult.prompts) {
     lines.push(`  [${formatAction(prompt.action)}] prompt ${prompt.path}`);
   }
-  if (bundle.rules.length > 0) {
+  if (!applyCourseRules) {
+    if (writeResult.rules.action === "removed") {
+      lines.push(`  [removed] rules  ${profile.rulesFile}`);
+    } else {
+      verbose(ctx, `course rules disabled — ${profile.rulesFile} left untouched`);
+    }
+  } else if (bundle.rules.length > 0) {
     lines.push(`  [${writeResult.rules.action}] rules  ${profile.rulesFile} (${bundle.rules.length} block${bundle.rules.length === 1 ? "" : "s"})`);
   }
   for (const config of writeResult.configs) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",