@przeprogramowani/10x-cli 1.25.3 → 1.26.1

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.3",
+  version: "1.26.1",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -4725,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",
@@ -5184,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",
@@ -5236,6 +5264,7 @@ var PROFILE_ORDER = [
   "copilot",
   "codex",
   "devin-desktop",
+  "factory",
   "gemini",
   "kiro",
   "generic"
@@ -7187,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);
   });
@@ -8857,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);
   });
@@ -9161,6 +9190,7 @@ function renderReport(ctx, profile, input) {
   const buckets = countBuckets(outcomes);
   const lessonsErrored = outcomes.filter((o) => o.status === "errored").length;
   const lessonsConflicts = outcomes.filter((o) => o.status === "conflicts").length;
+  const lessonsWithConflicts = outcomes.filter((o) => o.resources.some((r2) => r2.bucket === "skipped-conflict")).length;
   if (ctx.json) {
     output(ctx, "", {
       course: input.course,
@@ -9177,6 +9207,7 @@ function renderReport(ctx, profile, input) {
         updated: outcomes.filter((o) => o.status === "updated").length,
         unchanged: outcomes.filter((o) => o.status === "unchanged").length,
         conflicts: lessonsConflicts,
+        lessonsWithConflicts,
         errored: lessonsErrored,
         excluded: exclusions.length,
         resources: {
@@ -9227,7 +9258,7 @@ function renderReport(ctx, profile, input) {
   }
   lines.push("");
   lines.push(`Totals: ${buckets["upstream-updated"]} updated, ${buckets.created} new, ` + `${buckets.unchanged} unchanged, ${buckets["skipped-conflict"]} skipped (conflicts), ` + `${buckets.removed} removed, ${buckets["preserved-local"]} preserved locally.`);
-  if (lessonsConflicts > 0 && !input.force) {
+  if (lessonsWithConflicts > 0 && !input.force) {
     lines.push("To replace edited skills and prompts: 10x sync --force. Resolve rule conflicts with 10x get <lesson> --type rules.");
   }
   output(ctx, lines.join(`

package/package.json

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