@przeprogramowani/10x-cli 1.25.2 → 1.26.0

package/README.md

@@ -42,7 +42,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`, `kiro`, or `generic`
+`--tool claude-code`, `cursor`, `codex`, `devin-desktop`, `factory`, `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
@@ -181,7 +181,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`, `kiro`, `generic` |
+| `--tool <tool>` | AI coding tool: `claude-code`, `cursor`, `copilot`, `codex`, `devin-desktop`, `gemini`, `kiro`, `factory`, `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`) |
@@ -309,7 +309,7 @@ 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`, `kiro`, `generic`) |
+| `--tool <id>` | Agent tool for skill placement (`claude-code`, `cursor`, `copilot`, `codex`, `devin-desktop`, `gemini`, `kiro`, `factory`, `generic`) |
 | `--yes` | Run non-interactively, accepting defaults |
 | `--deep` | Clone the detected base repo with full history (default: shallow, HEAD only) |
 
@@ -363,6 +363,7 @@ On first run, the CLI prompts you to choose your AI coding tool. Artifacts are w
 | Devin Desktop | `.devin/` | `AGENTS.md` |
 | Gemini CLI | `.gemini/` | `GEMINI.md` |
 | Kiro | `.kiro/` | `AGENTS.md` |
+| Factory AI | `.factory/` | `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.
@@ -370,6 +371,20 @@ The former `windsurf` ID remains accepted as an alias and is upgraded to
 `devin-desktop`; existing `.windsurf/` artifacts can be migrated by the normal
 tool-switch prompt.
 
+Factory AI stores skills in `.factory/skills/`, prompts in
+`.factory/commands/<name>.md` as custom slash commands, and config templates in
+`.factory/config-templates/`. Prompt names and bytes are preserved. Config
+templates are only a staging location; the CLI does not activate or merge them.
+Factory requests the generic content variant from the delivery API while its
+manifest records `factory`. It is auto-detected from `.factory/` (including its
+manifest, `skills/`, or `commands/`); `AGENTS.md` alone does not identify
+Factory.
+
+Factory shares root `AGENTS.md` with Codex CLI, Devin Desktop, Kiro, and Generic.
+The managed course-rules block can be shared only when its bytes are identical.
+Factory and Generic use the same generic content, but incompatible Codex or
+Devin rules stay protected even when an overwrite is requested.
+
 ## Development
 
 ```bash

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.2",
+  version: "1.26.0",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -3359,7 +3359,6 @@ function updateToolConfig(patch) {
 import { hostname as osHostname, release as osRelease } from "node:os";
 
 // src/lib/api-client.ts
-var import_proper_lockfile = __toESM(require_proper_lockfile(), 1);
 var DEFAULT_API_BASE = "https://10x-toolkit-api.przeprogramowani.workers.dev";
 var PROD_HOSTNAME = "10x-toolkit-api.przeprogramowani.workers.dev";
 var DEV_HOSTNAMES = new Set(["localhost", "127.0.0.1"]);
@@ -3402,7 +3401,6 @@ var ERROR_CODE_MESSAGES = {
   module_locked: "This module is not available yet.",
   signing_failed: "Could not sign the download URL. Try again in a moment.",
   invalid_json: "The server received a malformed request.",
-  email_changed: "Your email changed. Run `10x auth` to sign in again.",
   unauthorized: "You are not signed in. Run `10x auth` first.",
   no_membership: "No active course membership was found for this email.",
   invalid_refresh_token: "Your session has expired. Run `10x auth` again.",
@@ -3474,21 +3472,6 @@ async function request(method, path, body, options = {}) {
   }
   if (!response.ok) {
     const payload = parsed && typeof parsed === "object" ? parsed : undefined;
-    if ((payload?.code ?? payload?.error) === "email_changed" && options.token && readAuth()?.access_token === options.token) {
-      try {
-        const release = await import_proper_lockfile.default.lock(authFilePath(), {
-          realpath: false,
-          stale: 1e4,
-          retries: { retries: 5, factor: 2, minTimeout: 100, maxTimeout: 1000 }
-        });
-        try {
-          if (readAuth()?.access_token === options.token)
-            deleteAuth();
-        } finally {
-          await release();
-        }
-      } catch {}
-    }
     const mapped = messageForApiError(payload);
     let errorMessage;
     if (mapped) {
@@ -3508,13 +3491,7 @@ async function request(method, path, body, options = {}) {
       payload
     };
   }
-  return {
-    ok: true,
-    status: response.status,
-    data: parsed,
-    responseHeaders: response.headers,
-    rawBody: text
-  };
+  return { ok: true, status: response.status, data: parsed, responseHeaders: response.headers, rawBody: text };
 }
 function apiGet(path, options = {}) {
   return request("GET", path, undefined, options);
@@ -3676,7 +3653,7 @@ async function pollCircleLogin(deviceCode, options = {}) {
 }
 
 // src/lib/auth-guard.ts
-var import_proper_lockfile2 = __toESM(require_proper_lockfile(), 1);
+var import_proper_lockfile = __toESM(require_proper_lockfile(), 1);
 import { mkdirSync as mkdirSync2 } from "node:fs";
 import { dirname } from "node:path";
 
@@ -3751,7 +3728,7 @@ function isNearExpiry(auth, windowMs = DEFAULT_REFRESH_WINDOW_MS, now = new Date
 async function acquireRefreshLock(ctx, lockTarget) {
   try {
     mkdirSync2(dirname(lockTarget), { recursive: true });
-    return await import_proper_lockfile2.default.lock(lockTarget, {
+    return await import_proper_lockfile.default.lock(lockTarget, {
       realpath: false,
       stale: LOCK_STALE_MS,
       retries: {
@@ -3809,12 +3786,6 @@ async function requireAuth(ctx, options = {}) {
       persist(next);
       return next;
     }
-    if (refreshed.code === "email_changed") {
-      try {
-        (options.remove ?? deleteAuth)();
-      } catch {}
-      outputError(ctx, "email_changed", "Your email changed. Sign in again.", ExitCodes.AUTH_REQUIRED, "Run '10x auth' to log in.");
-    }
     if (forced) {
       outputError(ctx, refreshed.code, refreshed.error, refreshed.status === 403 ? ExitCodes.FORBIDDEN : refreshed.status === 401 ? ExitCodes.AUTH_REQUIRED : ExitCodes.ERROR);
     }
@@ -4754,6 +4725,19 @@ var PROFILES = {
     sentinelBegin: SENTINEL_BEGIN,
     sentinelEnd: SENTINEL_END
   },
+  factory: {
+    toolId: "factory",
+    contentToolId: "generic",
+    displayName: "Factory AI",
+    skillPath: (n) => `.factory/skills/${n}/SKILL.md`,
+    skillDir: (n) => `.factory/skills/${n}`,
+    promptPath: (n) => `.factory/commands/${n}.md`,
+    configPath: (n) => `.factory/config-templates/${n}`,
+    rulesFile: "AGENTS.md",
+    manifestDir: ".factory",
+    sentinelBegin: SENTINEL_BEGIN,
+    sentinelEnd: SENTINEL_END
+  },
   gemini: {
     toolId: "gemini",
     displayName: "Gemini CLI",
@@ -5213,6 +5197,21 @@ function detectTools(projectRoot) {
       reason: ".windsurf/ directory (legacy)"
     });
   }
+  if (hit(".factory/" + MANIFEST_FILENAME)) {
+    signals.push({
+      profileId: "factory",
+      confidence: "strong",
+      reason: ".factory/.10x-cli-manifest.json"
+    });
+  } else if (hit(".factory/commands")) {
+    signals.push({ profileId: "factory", confidence: "strong", reason: ".factory/commands/" });
+  } else if (hit(".factory/droids")) {
+    signals.push({ profileId: "factory", confidence: "strong", reason: ".factory/droids/" });
+  } else if (hit(".factory/skills")) {
+    signals.push({ profileId: "factory", confidence: "strong", reason: ".factory/skills/" });
+  } else if (hit(".factory")) {
+    signals.push({ profileId: "factory", confidence: "strong", reason: ".factory/ directory" });
+  }
   if (hit(".gemini/" + MANIFEST_FILENAME)) {
     signals.push({
       profileId: "gemini",
@@ -5265,6 +5264,7 @@ var PROFILE_ORDER = [
   "copilot",
   "codex",
   "devin-desktop",
+  "factory",
   "gemini",
   "kiro",
   "generic"
@@ -7216,7 +7216,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, 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) => {
+  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, factory, 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);
   });
@@ -8886,7 +8886,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, 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) => {
+  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, factory, 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.25.2",
+  "version": "1.26.0",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",