@przeprogramowani/10x-cli 1.25.0 → 1.25.1

package/README.md

@@ -101,10 +101,10 @@ separate project from public copies, after setup/auth:
 10x_cli() { npx --yes "@przeprogramowani/10x-cli@$CLI_VERSION" "$@"; }
 10x_cli --version
 10x_cli get --help
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl
 ```
 
 Source membership does not prove publication. Confirm skill-filter support and direct
@@ -123,27 +123,29 @@ per-skill unregister is promised. See the compatibility reference for details.
 ## Quick Start
 
 Use an existing verified global/standalone `10x`, or the pinned `10x_cli` runner
-above. Retain your v3 project and use a separate v4 exercise directory. After
-checking skill-filter capability and content availability. Sync later refreshes
+above. Retain your v3 project and use a separate v4 exercise directory. Leave
+`--course` out: an unbound directory takes the highest edition your account can
+reach, a bound one keeps its own, and `10x doctor` reports which edition this
+project is on. After checking skill-filter capability and content availability. Sync later refreshes
 whole downloaded lessons, so inspect its preview and accept any additional
 artifacts/rules before applying; repeat a skill filter for a narrow update:
 
 ```bash
 10x_cli auth --status
 # If login is needed: 10x_cli auth (email or Circle); see auth commands below.
-10x_cli list --course 10xdevs4
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli list
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 # Follow the guide: read each installed SKILL.md and references, then
 # init → shape with the learner’s 10xCards inputs → PRD from approved notes.
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 10x_cli doctor
 ```
 

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.25.0",
+  version: "1.25.1",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -6299,11 +6299,10 @@ import {
 } from "node:fs";
 import { dirname as dirname4, join as join8 } from "node:path";
 var CLI_VERSION = package_default.version;
-var DEFAULT_COURSE = "10xdevs3";
-async function applyBundle(bundle, projectRoot, options = {}) {
+async function applyBundle(bundle, projectRoot, options) {
   const dryRun = options.dryRun === true;
   const partial = options.partial === true;
-  const course = options.course ?? DEFAULT_COURSE;
+  const course = options.course;
   const profile = options.profile ?? PROFILES[DEFAULT_TOOL];
   const applyCourseRules = options.applyCourseRules !== false;
   const plan = planBundle(bundle, projectRoot, { course, profile, applyCourseRules });
@@ -6501,11 +6500,11 @@ async function applyBundle(bundle, projectRoot, options = {}) {
   persist();
   return result;
 }
-function planBundle(bundle, projectRoot, options = {}) {
+function planBundle(bundle, projectRoot, options) {
   const profile = options.profile ?? PROFILES[DEFAULT_TOOL];
   const applyCourseRules = options.applyCourseRules !== false;
   validateBundlePayload(bundle);
-  if (options.course && bundle.course !== undefined && bundle.course !== options.course)
+  if (bundle.course !== undefined && bundle.course !== options.course)
     throw new Error("Bundle course differs from selected project course");
   for (const skill of bundle.skills) {
     assertSafeName(skill.name, "skill");
@@ -7422,13 +7421,7 @@ function formatAction(action) {
       return action;
   }
 }
-function renderGetResult(ctx, bundle, writeResult, dryRun, profile, langMeta = {
-  course: "10xdevs3",
-  selectionReason: "backend_recommendation",
-  language: "en",
-  languageFallback: false,
-  applyCourseRules: true
-}) {
+function renderGetResult(ctx, bundle, writeResult, dryRun, profile, langMeta) {
   const applyCourseRules = langMeta.applyCourseRules;
   const totalRemovals = [...writeResult.removals.skills, ...writeResult.removals.prompts, ...writeResult.removals.configs].filter((entry) => entry.action === "removed").length;
   if (ctx.json) {
@@ -7598,10 +7591,14 @@ a magic link sent by email or a Circle message (\`--method email\` /
 on the user's behalf without their authorization. Never read out \`auth.json\`,
 tokens, magic-link URLs or email contents. Summarize only session/access state.
 
-Then use the selected runner's \`list --course 10xdevs4\` (or the user's explicit
-course). Distinguish no membership, unpublished course, locked module and network
+Then use the selected runner's bare \`list\`: with no \`--course\` the CLI takes the
+edition from the project's \`.10x-cli.json\` binding, or, in a directory that is not
+bound yet, from the live API recommendation (the highest edition the account can
+reach). Add \`--course <slug>\` only to inspect another entitled edition on purpose.
+Distinguish no membership, unpublished course, locked module and network
 failure. Reinstalling the CLI or selecting a different tool does not grant access.
-Keep \`--course\`, \`--tool\` and \`--lang\` explicit in subsequent download/sync commands.
+Keep \`--tool\` and \`--lang\` explicit in subsequent download/sync commands and leave
+\`--course\` out, so every download stays on the project's edition.
 
 ## 4. Diagnose readiness without manufacturing a tool directory
 
@@ -7609,7 +7606,11 @@ Run the selected runner's \`doctor --json\`; read all of \`data.checks\` and
 \`data.overall\`, plus the exit status. The outer \`status: "ok"\` is an output envelope,
 not a promise that every check passed. Doctor uses the configured profile (or its
 default), so compare the reported tool with the intended one; it has no \`--tool\`
-flag in the inspected baseline.
+flag in the inspected baseline. Its auth check also reports the resolved edition
+and selection reason (\`details.course\`, \`details.selectionReason\`) — use that as
+the self-check before the first download. A project is bound to one edition on its
+first write; a later edition needs a new empty directory, because writing it into a
+bound project fails with \`course_mismatch\`.
 
 In a new project before the first download, a missing \`.claude/\` (or the reported
 profile directory) can be expected. If that is the only failure and this is the
@@ -7723,19 +7724,27 @@ substitute its exact executable for \`10x_cli\`; no reinstall is required.
 10x_cli sync --help
 10x_cli auth --help
 10x_cli auth --status
-10x_cli list --course 10xdevs4
+10x_cli list
 \`\`\`
 
 Run commands from the intended project root. The target guided context is
-\`--course 10xdevs4 --tool claude-code --lang pl\`; preserve it in downloads,
-previews, updates and recovery. \`list\` takes \`--course\`, not tool/lang flags.
+\`--tool claude-code --lang pl\` with no \`--course\`; preserve those two flags in
+downloads, previews, updates and recovery and let the edition come from the
+project. Pass \`--course <slug>\` only for a deliberate look at another entitled
+edition (\`list\`, \`get --print\`); \`list\` takes \`--course\`, not tool/lang flags.
 Use another context only when the user chose it. Record any language fallback
 reported by the CLI rather than calling English output Polish.
 
 The project edition is stored in \`.10x-cli.json\` after a validated write and shared
 across profiles; existing supported manifests also carry edition information.
-Course selection is explicit flag → project edition → live API recommendation.
-An explicit course does not authorize changing a bound project's edition. Retain
+Course selection is explicit flag → project edition → live API recommendation, so
+a bare command stays on the project's edition and a fresh directory gets the
+highest edition the account can reach. \`get\` prints the resolved pair
+(\`Course: 10xdevs4 (backend_recommendation)\`); \`doctor\`'s auth check reports the
+same one (\`details.course\` and \`details.selectionReason\` under \`--json\`). Read that
+instead of forcing a flag. An explicit course does not authorize changing a bound
+project's edition — writing another edition into a bound directory fails with
+\`course_mismatch\`, so a new edition belongs in a new empty directory. Retain
 the v3 project and start a separate v4 directory for this journey. Preserve unknown,
 corrupt or conflicting manifests; never delete a binding to force migration.
 
@@ -7827,10 +7836,10 @@ In a separate project from the public copies, or after the explicit takeover
 below, use the same verified \`10x_cli\` runner:
 
 \`\`\`bash
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl
 \`\`\`
 
 Each successful filtered skill download should materialize
@@ -7867,14 +7876,14 @@ explicitly requested only a specific skill.
 content checks for each name, inspect each preview before its corresponding write:
 
 \`\`\`bash
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 \`\`\`
 
 Require the complete four trees and inspect each installed entrypoint/reference.
@@ -7928,8 +7937,8 @@ when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.
 
 \`\`\`bash
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 \`\`\`
 
 Normal sync refreshes downloaded owners, including the full lessons that own previously downloaded skills. Avoid \`--all\` for this small journey. Inspect updated,
@@ -8024,9 +8033,17 @@ verified global/standalone executable:
 10x_cli get --help
 10x_cli sync --help
 10x_cli auth --status
-10x_cli list --course 10xdevs4
+10x_cli list
 \`\`\`
 
+Leave \`--course\` out of these commands: the CLI reads the edition from
+\`.10x-cli.json\` when the directory is already bound, otherwise from the live API
+recommendation (the highest edition the account can reach). \`get\` prints
+\`Course: <slug> (<reason>)\`; check it once before the first write. Use
+\`--course <slug>\` only to inspect another entitled edition on purpose — a bound
+project cannot be rewritten to a different edition (\`course_mismatch\`), so v4
+starts in a new empty directory.
+
 Check source/release evidence for lesson reference, skill filter and lesson-scoped sync, then use the
 filtered preview below to check the endpoint. Do not treat a successful help exit as
 capability proof. Keep unsupported CLI syntax, unpublished/missing content, locked
@@ -8069,14 +8086,14 @@ narrower scope. After checking each name's capability and availability, download
 four separate complete selected skill trees. Inspect each dry-run before its corresponding write:
 
 \`\`\`bash
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 \`\`\`
 
 Inspect each report and the complete supporting tree, not just SKILL.md. In the
@@ -8121,8 +8138,8 @@ missing prerequisite and obtain the supported route from the lesson/release owne
 before that step. Do not invent a rule command or download a full lesson to bypass
 it. Do not overwrite an existing project rule.
 
-For browsing use \`10x_cli list m1 --course 10xdevs4\`. The commands above filter
-one lesson by skill name; \`get 10x-init\` is not supported. \`--print\` is inspection:
+For browsing use \`10x_cli list m1\`. The commands above filter one lesson by skill
+name; \`get 10x-init\` is not supported. \`--print\` is inspection:
 TTY Markdown can contain only SKILL.md; non-TTY output is a JSON envelope. Never
 redirect print output into SKILL.md as a package installation.
 
@@ -8163,16 +8180,17 @@ two canonical output filenames instead of forcing an overwrite.
 
 ## Update
 
-Use the same runner, directory, course, tool and language. Sync updates entire
-downloaded lessons, including m1l1 after these filtered gets. Its preview may
+Use the same runner, directory, tool and language; the edition stays the project's
+own, so \`sync\` needs no \`--course\` either. Sync updates entire downloaded lessons,
+including m1l1 after these filtered gets. Its preview may
 include other skills, prompts, configs and course rules. Inspect that expanded
 scope and apply only when the user accepts it; to update only one skill, repeat
 its filtered preview/get instead. Do not use sync as a hidden rule prerequisite
 workaround:
 
 \`\`\`bash
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 \`\`\`
 
 Normal sync refreshes the full lessons recorded in the manifest, not just the
@@ -8183,9 +8201,9 @@ resource counts even if exit is 0: skipped conflicts alone are not process error
 Do not equate an unchanged remote digest with intact local files.
 
 For one conflicting skill, inspect the diff and back up local work before retrying
-its filtered get in an interactive terminal with the same course/tool/lang. Preserve
-the user's resolution choice. If a CLI hint omits context, restore these flags in
-your proposed command. Never run automatic \`--force\`; it can overwrite local
+its filtered get in an interactive terminal, from the same directory and with the
+same tool/lang. Preserve the user's resolution choice. If a CLI hint omits context,
+restore these flags in your proposed command. Never run automatic \`--force\`; it can overwrite local
 skill/prompt edits and does not bypass protected rules or safe removal. Config
 templates remain create-only. Cleanup preserves modified/untracked files and
 files owned elsewhere; do not manually sweep a skill directory after sync.
@@ -8234,8 +8252,10 @@ other-agent walkthrough. Translate shell syntax to the user's actual shell.
 
 Run \`10x_cli doctor --json\` when diagnosis is useful; inspect its complete
 \`data.overall\` and \`data.checks\` as well as exit status. It checks the configured
-profile, not a \`--tool\` or \`--course\` argument. Before first get, a missing tool
-directory can be expected; explain only that failure and keep other failures
+profile, not a \`--tool\` or \`--course\` argument. Its auth check reports the resolved
+edition and selection reason (\`details.course\`, \`details.selectionReason\`) — that is
+the self-check for which edition this directory is on. Before first get, a missing
+tool directory can be expected; explain only that failure and keep other failures
 visible. Doctor exit 78 can coexist with outer JSON \`status: "ok"\`.
 
 | Symptom | Next step |
@@ -8329,19 +8349,27 @@ substitute its exact executable for \`10x_cli\`; no reinstall is required.
 10x_cli sync --help
 10x_cli auth --help
 10x_cli auth --status
-10x_cli list --course 10xdevs4
+10x_cli list
 \`\`\`
 
 Run commands from the intended project root. The target guided context is
-\`--course 10xdevs4 --tool claude-code --lang pl\`; preserve it in downloads,
-previews, updates and recovery. \`list\` takes \`--course\`, not tool/lang flags.
+\`--tool claude-code --lang pl\` with no \`--course\`; preserve those two flags in
+downloads, previews, updates and recovery and let the edition come from the
+project. Pass \`--course <slug>\` only for a deliberate look at another entitled
+edition (\`list\`, \`get --print\`); \`list\` takes \`--course\`, not tool/lang flags.
 Use another context only when the user chose it. Record any language fallback
 reported by the CLI rather than calling English output Polish.
 
 The project edition is stored in \`.10x-cli.json\` after a validated write and shared
 across profiles; existing supported manifests also carry edition information.
-Course selection is explicit flag → project edition → live API recommendation.
-An explicit course does not authorize changing a bound project's edition. Retain
+Course selection is explicit flag → project edition → live API recommendation, so
+a bare command stays on the project's edition and a fresh directory gets the
+highest edition the account can reach. \`get\` prints the resolved pair
+(\`Course: 10xdevs4 (backend_recommendation)\`); \`doctor\`'s auth check reports the
+same one (\`details.course\` and \`details.selectionReason\` under \`--json\`). Read that
+instead of forcing a flag. An explicit course does not authorize changing a bound
+project's edition — writing another edition into a bound directory fails with
+\`course_mismatch\`, so a new edition belongs in a new empty directory. Retain
 the v3 project and start a separate v4 directory for this journey. Preserve unknown,
 corrupt or conflicting manifests; never delete a binding to force migration.
 
@@ -8433,10 +8461,10 @@ In a separate project from the public copies, or after the explicit takeover
 below, use the same verified \`10x_cli\` runner:
 
 \`\`\`bash
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl
 \`\`\`
 
 Each successful filtered skill download should materialize
@@ -8473,14 +8501,14 @@ explicitly requested only a specific skill.
 content checks for each name, inspect each preview before its corresponding write:
 
 \`\`\`bash
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 \`\`\`
 
 Require the complete four trees and inspect each installed entrypoint/reference.
@@ -8534,8 +8562,8 @@ when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.
 
 \`\`\`bash
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 \`\`\`
 
 Normal sync refreshes downloaded owners, including the full lessons that own previously downloaded skills. Avoid \`--all\` for this small journey. Inspect updated,
@@ -8965,6 +8993,7 @@ async function syncLesson(ctx, lesson, opts) {
   const bundle = result.data;
   if (opts.dryRun) {
     const plan = planBundle(bundle, process.cwd(), {
+      course: opts.course,
       profile: opts.profile,
       applyCourseRules: opts.applyCourseRules
     });

package/package.json

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

package/skills/10x-cli-guide/SKILL.md

@@ -41,9 +41,17 @@ verified global/standalone executable:
 10x_cli get --help
 10x_cli sync --help
 10x_cli auth --status
-10x_cli list --course 10xdevs4
+10x_cli list
 ```
 
+Leave `--course` out of these commands: the CLI reads the edition from
+`.10x-cli.json` when the directory is already bound, otherwise from the live API
+recommendation (the highest edition the account can reach). `get` prints
+`Course: <slug> (<reason>)`; check it once before the first write. Use
+`--course <slug>` only to inspect another entitled edition on purpose — a bound
+project cannot be rewritten to a different edition (`course_mismatch`), so v4
+starts in a new empty directory.
+
 Check source/release evidence for lesson reference, skill filter and lesson-scoped sync, then use the
 filtered preview below to check the endpoint. Do not treat a successful help exit as
 capability proof. Keep unsupported CLI syntax, unpublished/missing content, locked
@@ -86,14 +94,14 @@ narrower scope. After checking each name's capability and availability, download
 four separate complete selected skill trees. Inspect each dry-run before its corresponding write:
 
 ```bash
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 ```
 
 Inspect each report and the complete supporting tree, not just SKILL.md. In the
@@ -138,8 +146,8 @@ missing prerequisite and obtain the supported route from the lesson/release owne
 before that step. Do not invent a rule command or download a full lesson to bypass
 it. Do not overwrite an existing project rule.
 
-For browsing use `10x_cli list m1 --course 10xdevs4`. The commands above filter
-one lesson by skill name; `get 10x-init` is not supported. `--print` is inspection:
+For browsing use `10x_cli list m1`. The commands above filter one lesson by skill
+name; `get 10x-init` is not supported. `--print` is inspection:
 TTY Markdown can contain only SKILL.md; non-TTY output is a JSON envelope. Never
 redirect print output into SKILL.md as a package installation.
 
@@ -180,16 +188,17 @@ two canonical output filenames instead of forcing an overwrite.
 
 ## Update
 
-Use the same runner, directory, course, tool and language. Sync updates entire
-downloaded lessons, including m1l1 after these filtered gets. Its preview may
+Use the same runner, directory, tool and language; the edition stays the project's
+own, so `sync` needs no `--course` either. Sync updates entire downloaded lessons,
+including m1l1 after these filtered gets. Its preview may
 include other skills, prompts, configs and course rules. Inspect that expanded
 scope and apply only when the user accepts it; to update only one skill, repeat
 its filtered preview/get instead. Do not use sync as a hidden rule prerequisite
 workaround:
 
 ```bash
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 ```
 
 Normal sync refreshes the full lessons recorded in the manifest, not just the
@@ -200,9 +209,9 @@ resource counts even if exit is 0: skipped conflicts alone are not process error
 Do not equate an unchanged remote digest with intact local files.
 
 For one conflicting skill, inspect the diff and back up local work before retrying
-its filtered get in an interactive terminal with the same course/tool/lang. Preserve
-the user's resolution choice. If a CLI hint omits context, restore these flags in
-your proposed command. Never run automatic `--force`; it can overwrite local
+its filtered get in an interactive terminal, from the same directory and with the
+same tool/lang. Preserve the user's resolution choice. If a CLI hint omits context,
+restore these flags in your proposed command. Never run automatic `--force`; it can overwrite local
 skill/prompt edits and does not bypass protected rules or safe removal. Config
 templates remain create-only. Cleanup preserves modified/untracked files and
 files owned elsewhere; do not manually sweep a skill directory after sync.
@@ -251,8 +260,10 @@ other-agent walkthrough. Translate shell syntax to the user's actual shell.
 
 Run `10x_cli doctor --json` when diagnosis is useful; inspect its complete
 `data.overall` and `data.checks` as well as exit status. It checks the configured
-profile, not a `--tool` or `--course` argument. Before first get, a missing tool
-directory can be expected; explain only that failure and keep other failures
+profile, not a `--tool` or `--course` argument. Its auth check reports the resolved
+edition and selection reason (`details.course`, `details.selectionReason`) — that is
+the self-check for which edition this directory is on. Before first get, a missing
+tool directory can be expected; explain only that failure and keep other failures
 visible. Doctor exit 78 can coexist with outer JSON `status: "ok"`.
 
 | Symptom | Next step |

package/skills/10x-cli-guide/references/compatibility.md

@@ -66,19 +66,27 @@ substitute its exact executable for `10x_cli`; no reinstall is required.
 10x_cli sync --help
 10x_cli auth --help
 10x_cli auth --status
-10x_cli list --course 10xdevs4
+10x_cli list
 ```
 
 Run commands from the intended project root. The target guided context is
-`--course 10xdevs4 --tool claude-code --lang pl`; preserve it in downloads,
-previews, updates and recovery. `list` takes `--course`, not tool/lang flags.
+`--tool claude-code --lang pl` with no `--course`; preserve those two flags in
+downloads, previews, updates and recovery and let the edition come from the
+project. Pass `--course <slug>` only for a deliberate look at another entitled
+edition (`list`, `get --print`); `list` takes `--course`, not tool/lang flags.
 Use another context only when the user chose it. Record any language fallback
 reported by the CLI rather than calling English output Polish.
 
 The project edition is stored in `.10x-cli.json` after a validated write and shared
 across profiles; existing supported manifests also carry edition information.
-Course selection is explicit flag → project edition → live API recommendation.
-An explicit course does not authorize changing a bound project's edition. Retain
+Course selection is explicit flag → project edition → live API recommendation, so
+a bare command stays on the project's edition and a fresh directory gets the
+highest edition the account can reach. `get` prints the resolved pair
+(`Course: 10xdevs4 (backend_recommendation)`); `doctor`'s auth check reports the
+same one (`details.course` and `details.selectionReason` under `--json`). Read that
+instead of forcing a flag. An explicit course does not authorize changing a bound
+project's edition — writing another edition into a bound directory fails with
+`course_mismatch`, so a new edition belongs in a new empty directory. Retain
 the v3 project and start a separate v4 directory for this journey. Preserve unknown,
 corrupt or conflicting manifests; never delete a binding to force migration.
 
@@ -170,10 +178,10 @@ In a separate project from the public copies, or after the explicit takeover
 below, use the same verified `10x_cli` runner:
 
 ```bash
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl
 ```
 
 Each successful filtered skill download should materialize
@@ -210,14 +218,14 @@ explicitly requested only a specific skill.
 content checks for each name, inspect each preview before its corresponding write:
 
 ```bash
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 ```
 
 Require the complete four trees and inspect each installed entrypoint/reference.
@@ -271,8 +279,8 @@ when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.
 
 ```bash
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 ```
 
 Normal sync refreshes downloaded owners, including the full lessons that own previously downloaded skills. Avoid `--all` for this small journey. Inspect updated,

package/skills/10x-cli-setup/SKILL.md

@@ -83,10 +83,14 @@ a magic link sent by email or a Circle message (`--method email` /
 on the user's behalf without their authorization. Never read out `auth.json`,
 tokens, magic-link URLs or email contents. Summarize only session/access state.
 
-Then use the selected runner's `list --course 10xdevs4` (or the user's explicit
-course). Distinguish no membership, unpublished course, locked module and network
+Then use the selected runner's bare `list`: with no `--course` the CLI takes the
+edition from the project's `.10x-cli.json` binding, or, in a directory that is not
+bound yet, from the live API recommendation (the highest edition the account can
+reach). Add `--course <slug>` only to inspect another entitled edition on purpose.
+Distinguish no membership, unpublished course, locked module and network
 failure. Reinstalling the CLI or selecting a different tool does not grant access.
-Keep `--course`, `--tool` and `--lang` explicit in subsequent download/sync commands.
+Keep `--tool` and `--lang` explicit in subsequent download/sync commands and leave
+`--course` out, so every download stays on the project's edition.
 
 ## 4. Diagnose readiness without manufacturing a tool directory
 
@@ -94,7 +98,11 @@ Run the selected runner's `doctor --json`; read all of `data.checks` and
 `data.overall`, plus the exit status. The outer `status: "ok"` is an output envelope,
 not a promise that every check passed. Doctor uses the configured profile (or its
 default), so compare the reported tool with the intended one; it has no `--tool`
-flag in the inspected baseline.
+flag in the inspected baseline. Its auth check also reports the resolved edition
+and selection reason (`details.course`, `details.selectionReason`) — use that as
+the self-check before the first download. A project is bound to one edition on its
+first write; a later edition needs a new empty directory, because writing it into a
+bound project fails with `course_mismatch`.
 
 In a new project before the first download, a missing `.claude/` (or the reported
 profile directory) can be expected. If that is the only failure and this is the

package/skills/10x-cli-setup/references/compatibility.md

@@ -66,19 +66,27 @@ substitute its exact executable for `10x_cli`; no reinstall is required.
 10x_cli sync --help
 10x_cli auth --help
 10x_cli auth --status
-10x_cli list --course 10xdevs4
+10x_cli list
 ```
 
 Run commands from the intended project root. The target guided context is
-`--course 10xdevs4 --tool claude-code --lang pl`; preserve it in downloads,
-previews, updates and recovery. `list` takes `--course`, not tool/lang flags.
+`--tool claude-code --lang pl` with no `--course`; preserve those two flags in
+downloads, previews, updates and recovery and let the edition come from the
+project. Pass `--course <slug>` only for a deliberate look at another entitled
+edition (`list`, `get --print`); `list` takes `--course`, not tool/lang flags.
 Use another context only when the user chose it. Record any language fallback
 reported by the CLI rather than calling English output Polish.
 
 The project edition is stored in `.10x-cli.json` after a validated write and shared
 across profiles; existing supported manifests also carry edition information.
-Course selection is explicit flag → project edition → live API recommendation.
-An explicit course does not authorize changing a bound project's edition. Retain
+Course selection is explicit flag → project edition → live API recommendation, so
+a bare command stays on the project's edition and a fresh directory gets the
+highest edition the account can reach. `get` prints the resolved pair
+(`Course: 10xdevs4 (backend_recommendation)`); `doctor`'s auth check reports the
+same one (`details.course` and `details.selectionReason` under `--json`). Read that
+instead of forcing a flag. An explicit course does not authorize changing a bound
+project's edition — writing another edition into a bound directory fails with
+`course_mismatch`, so a new edition belongs in a new empty directory. Retain
 the v3 project and start a separate v4 directory for this journey. Preserve unknown,
 corrupt or conflicting manifests; never delete a binding to force migration.
 
@@ -170,10 +178,10 @@ In a separate project from the public copies, or after the explicit takeover
 below, use the same verified `10x_cli` runner:
 
 ```bash
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-setup --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-cli-guide --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-setup --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-cli-guide --tool claude-code --lang pl
 ```
 
 Each successful filtered skill download should materialize
@@ -210,14 +218,14 @@ explicitly requested only a specific skill.
 content checks for each name, inspect each preview before its corresponding write:
 
 ```bash
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-idea-check --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-init --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-shape --course 10xdevs4 --tool claude-code --lang pl
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli get m1l1 --type skills --name 10x-prd --course 10xdevs4 --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-idea-check --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-init --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-shape --tool claude-code --lang pl
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl --dry-run
+10x_cli get m1l1 --type skills --name 10x-prd --tool claude-code --lang pl
 ```
 
 Require the complete four trees and inspect each installed entrypoint/reference.
@@ -271,8 +279,8 @@ when the user accepts that scope. For a narrow update, repeat the selected skill
 filter instead. Never use sync to silently bypass a missing lesson-rule prerequisite.
 
 ```bash
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl --dry-run
-10x_cli sync --course 10xdevs4 --tool claude-code --lang pl
+10x_cli sync --tool claude-code --lang pl --dry-run
+10x_cli sync --tool claude-code --lang pl
 ```
 
 Normal sync refreshes downloaded owners, including the full lessons that own previously downloaded skills. Avoid `--all` for this small journey. Inspect updated,