auriga-cli 1.29.0 → 1.29.1

package/dist/api-types.d.ts

@@ -95,8 +95,8 @@ export type ApplyScope = "project" | "user";
 /**
  * Workflow AGENTS.md language variant.
  *
- * - "zh-CN": Simplified Chinese AGENTS.md (the default).
- * - "en":    English AGENTS.en.md.
+ * - "zh-CN": Simplified Chinese workflow template (the default).
+ * - "en":    English workflow template.
  *
  * Only meaningful for `category === "workflow"`; rejected for other
  * categories so the API surface stays explicit.

package/dist/catalog.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-16T13:16:49.448Z",
+  "generatedAt": "2026-05-17T06:16:55.450Z",
   "workflowSkills": [
     {
       "name": "planning-with-files",

package/dist/cli.js

@@ -693,8 +693,9 @@ async function runUi(p, version) {
     //   - tarballRoot: where `dist/catalog.json` + the bundled DEV ui/dist live.
     //     Always read from the installed npm package; can't be fetched because
     //     dist/ is built artifact, not git content.
-    //   - contentRoot: where the runtime install recipes live (AGENTS.md,
-    //     marketplace manifests, extra_plugin_configs.json, skills-lock.json).
+    //   - contentRoot: where the runtime install recipes live (workflow
+    //     templates, marketplace manifests, extra_plugin_configs.json,
+    //     skills-lock.json).
     //     These files are
     //     NOT in the npm tarball — the `files` allowlist only ships `dist/*`
     //     + npm defaults. They are fetched from GitHub, pinned to the CLI
@@ -774,8 +775,9 @@ async function runUi(p, version) {
         pluginAgentsByName.set(name, def.agents);
     }
     const applyHandlers = buildDefaultApplyHandlers({
-        // contentRoot: install handlers read AGENTS.md, marketplace manifests,
-        // extra_plugin_configs.json, and skills-lock.json — all CONTENT_FILES.
+        // contentRoot: install handlers read workflow templates, marketplace
+        // manifests, extra_plugin_configs.json, and skills-lock.json — all
+        // CONTENT_FILES.
         // Routing them at tarballRoot fails ENOENT for npm-installed users.
         packageRoot: contentRoot,
         cwd,
@@ -800,8 +802,8 @@ async function runUi(p, version) {
                 cwd,
                 // server reads dist/catalog.json (tarball-shipped) via
                 // buildScanCatalog on each /api/state call; install-time content
-                // (marketplace manifests, extra plugin config, AGENTS.md, …) was already injected
-                // into applyHandlers above with contentRoot.
+                // (workflow templates, marketplace manifests, extra plugin config, …)
+                // was already injected into applyHandlers above with contentRoot.
                 packageRoot: tarballRoot,
                 heartbeatTimeoutMs: UI_HEARTBEAT_TIMEOUT_MS,
                 applyHandlers,

package/dist/skills.js

@@ -3,7 +3,7 @@ import os from "node:os";
 import path from "node:path";
 import { checkbox, select } from "@inquirer/prompts";
 import { atomicWriteFile, exec, execAsync, log, withEsc } from "./utils.js";
-// Curated default-on set: skills that the workflow in the root AGENTS.md
+// Curated default-on set: skills that the shipped workflow template
 // directly references. Anything else in skills-lock.json is surfaced via
 // installRecommendedSkills as an opt-in utility.
 export const WORKFLOW_SKILLS = [

package/dist/utils.d.ts

@@ -93,7 +93,7 @@ export interface LangOption {
     file: string;
 }
 export declare const DEFAULT_WORKFLOW_LANG = "zh-CN";
-export declare const DEFAULT_WORKFLOW_TEMPLATE_FILE = "AGENTS.md";
+export declare const DEFAULT_WORKFLOW_TEMPLATE_FILE = "AGENTS.template.zh-CN.md";
 export declare const LANGUAGES: LangOption[];
 /**
  * Reads `version` from the packaged manifest. Throws when the package

package/dist/utils.js

@@ -101,10 +101,10 @@ export function execAsync(cmd, opts) {
     });
 }
 export const DEFAULT_WORKFLOW_LANG = "zh-CN";
-export const DEFAULT_WORKFLOW_TEMPLATE_FILE = "AGENTS.md";
+export const DEFAULT_WORKFLOW_TEMPLATE_FILE = "AGENTS.template.zh-CN.md";
 export const LANGUAGES = [
-    { value: "zh-CN", label: "中文", file: "AGENTS.md" },
-    { value: "en", label: "English", file: "AGENTS.en.md" },
+    { value: "zh-CN", label: "中文", file: "AGENTS.template.zh-CN.md" },
+    { value: "en", label: "English", file: "AGENTS.template.en.md" },
 ];
 // --- Remote content ---
 const REPO = "Ben2pc/auriga-cli";
@@ -149,12 +149,16 @@ function resolveContentRef() {
 }
 const CONTENT_FILES = [
     DEFAULT_WORKFLOW_TEMPLATE_FILE,
-    "AGENTS.en.md",
+    "AGENTS.template.en.md",
     "skills-lock.json",
     ".claude-plugin/marketplace.json",
     ".agents/plugins/marketplace.json",
     "extra_plugin_configs.json",
 ];
+const LEGACY_CONTENT_FILE_FALLBACKS = {
+    "AGENTS.template.zh-CN.md": "AGENTS.md",
+    "AGENTS.template.en.md": "AGENTS.en.md",
+};
 async function fetchFile(file) {
     const ref = resolveContentRef();
     const url = `https://raw.githubusercontent.com/${REPO}/${ref}/${file}`;
@@ -163,6 +167,18 @@ async function fetchFile(file) {
         throw new Error(`Failed to fetch ${url}: ${res.status}`);
     return res.text();
 }
+async function fetchContentFile(file) {
+    try {
+        return await fetchFile(file);
+    }
+    catch (err) {
+        const legacyFile = LEGACY_CONTENT_FILE_FALLBACKS[file];
+        if (!legacyFile || !(err instanceof Error) || !/: 404$/.test(err.message)) {
+            throw err;
+        }
+        return fetchFile(legacyFile);
+    }
+}
 async function fetchFileBinary(file) {
     const ref = resolveContentRef();
     const url = `https://raw.githubusercontent.com/${REPO}/${ref}/${file}`;
@@ -177,7 +193,7 @@ export async function fetchContentRoot() {
     }
     const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "auriga-cli-"));
     for (const file of CONTENT_FILES) {
-        const content = await fetchFile(file);
+        const content = await fetchContentFile(file);
         const dest = path.join(tmpDir, file);
         fs.mkdirSync(path.dirname(dest), { recursive: true });
         fs.writeFileSync(dest, content);

package/dist/workflow-markers.js

@@ -21,9 +21,9 @@ export const MARKER_SCHEMA = "v1";
  * START marker line, one per template language. Only the prose differs — the
  * structural `AURIGA:WORKFLOW:v1 START` token is language-independent, so the
  * parser (`START_LINE_RE`) keys on the token alone and never needs to know the
- * language. The English `AGENTS.en.md` gets the English marker; `AGENTS.md`
- * gets the Chinese one, so a downstream file never carries a comment in the
- * wrong language for its document.
+ * language. `AGENTS.template.en.md` gets the English marker;
+ * `AGENTS.template.zh-CN.md` gets the Chinese one, so a downstream file never
+ * carries a comment in the wrong language for its document.
  */
 const WORKFLOW_START_MARKERS = {
     en: `<!-- AURIGA:WORKFLOW:${MARKER_SCHEMA} START — Managed block, maintained by auriga-cli. Do not edit by hand; upgrades replace it wholesale. Put project-specific instructions after the END marker below. -->`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auriga-cli",
-  "version": "1.29.0",
+  "version": "1.29.1",
   "description": "Interactive CLI to install Claude Code harness modules (Workflow, Skills, Recommended Skills, Plugins)",
   "license": "MIT",
   "repository": {
@@ -25,8 +25,8 @@
     "dev": "tsc --watch",
     "start": "node dist/cli.js",
     "pretest": "npm run build",
-    "test": "tsc -p tsconfig.test.json && DEV=1 node --test --experimental-test-module-mocks dist-test/tests/skills.test.js dist-test/tests/skills-uninstall.test.js dist-test/tests/catalog.test.js dist-test/tests/cli-parse.test.js dist-test/tests/install-nontty.test.js dist-test/tests/preset.test.js dist-test/tests/legacy-menu.test.js dist-test/tests/plugins.test.js dist-test/tests/plugins-uninstall.test.js dist-test/tests/content-fetch.test.js dist-test/tests/utils.test.js dist-test/tests/guide.test.js dist-test/tests/validators.test.js dist-test/tests/entrypoint.test.js dist-test/tests/state.test.js dist-test/tests/server.test.js dist-test/tests/server-auth.test.js dist-test/tests/server-apply.test.js dist-test/tests/apply-handlers.test.js dist-test/tests/ui-fetch.test.js dist-test/tests/workflow-markers.test.js dist-test/tests/workflow-install.test.js dist-test/tests/workflow-uninstall.test.js dist-test/tests/tarball-shape.test.js dist-test/tests/spec-design.test.js dist-test/tests/goalify.test.js dist-test/tests/plugin-skill-frontmatter.test.js",
-    "test:watch": "tsc -p tsconfig.test.json --watch & node --test --watch --experimental-test-module-mocks dist-test/tests/skills.test.js dist-test/tests/skills-uninstall.test.js dist-test/tests/catalog.test.js dist-test/tests/cli-parse.test.js dist-test/tests/install-nontty.test.js dist-test/tests/preset.test.js dist-test/tests/legacy-menu.test.js dist-test/tests/plugins.test.js dist-test/tests/plugins-uninstall.test.js dist-test/tests/content-fetch.test.js dist-test/tests/utils.test.js dist-test/tests/guide.test.js dist-test/tests/validators.test.js dist-test/tests/entrypoint.test.js dist-test/tests/state.test.js dist-test/tests/server.test.js dist-test/tests/server-auth.test.js dist-test/tests/server-apply.test.js dist-test/tests/apply-handlers.test.js dist-test/tests/ui-fetch.test.js dist-test/tests/workflow-markers.test.js dist-test/tests/workflow-install.test.js dist-test/tests/workflow-uninstall.test.js dist-test/tests/tarball-shape.test.js dist-test/tests/spec-design.test.js dist-test/tests/goalify.test.js dist-test/tests/plugin-skill-frontmatter.test.js",
+    "test": "tsc -p tsconfig.test.json && DEV=1 node --test --experimental-test-module-mocks dist-test/tests/skills.test.js dist-test/tests/skills-uninstall.test.js dist-test/tests/catalog.test.js dist-test/tests/cli-parse.test.js dist-test/tests/install-nontty.test.js dist-test/tests/preset.test.js dist-test/tests/legacy-menu.test.js dist-test/tests/plugins.test.js dist-test/tests/plugins-uninstall.test.js dist-test/tests/content-fetch.test.js dist-test/tests/utils.test.js dist-test/tests/guide.test.js dist-test/tests/validators.test.js dist-test/tests/entrypoint.test.js dist-test/tests/state.test.js dist-test/tests/server.test.js dist-test/tests/server-auth.test.js dist-test/tests/server-apply.test.js dist-test/tests/apply-handlers.test.js dist-test/tests/ui-fetch.test.js dist-test/tests/workflow-markers.test.js dist-test/tests/workflow-install.test.js dist-test/tests/workflow-uninstall.test.js dist-test/tests/tarball-shape.test.js dist-test/tests/spec-design.test.js dist-test/tests/goalify.test.js dist-test/tests/plugin-skill-frontmatter.test.js dist-test/tests/auriga-workflow-skills.test.js",
+    "test:watch": "tsc -p tsconfig.test.json --watch & node --test --watch --experimental-test-module-mocks dist-test/tests/skills.test.js dist-test/tests/skills-uninstall.test.js dist-test/tests/catalog.test.js dist-test/tests/cli-parse.test.js dist-test/tests/install-nontty.test.js dist-test/tests/preset.test.js dist-test/tests/legacy-menu.test.js dist-test/tests/plugins.test.js dist-test/tests/plugins-uninstall.test.js dist-test/tests/content-fetch.test.js dist-test/tests/utils.test.js dist-test/tests/guide.test.js dist-test/tests/validators.test.js dist-test/tests/entrypoint.test.js dist-test/tests/state.test.js dist-test/tests/server.test.js dist-test/tests/server-auth.test.js dist-test/tests/server-apply.test.js dist-test/tests/apply-handlers.test.js dist-test/tests/ui-fetch.test.js dist-test/tests/workflow-markers.test.js dist-test/tests/workflow-install.test.js dist-test/tests/workflow-uninstall.test.js dist-test/tests/tarball-shape.test.js dist-test/tests/spec-design.test.js dist-test/tests/goalify.test.js dist-test/tests/plugin-skill-frontmatter.test.js dist-test/tests/auriga-workflow-skills.test.js",
     "pretest:e2e": "npm run build",
     "test:e2e": "tsc -p tsconfig.test.json && node --test dist-test/tests/e2e-install.test.js",
     "pretest:web-ui-e2e": "npm run build && npm --prefix ui ci && npm --prefix ui run build",