@jixo/cli 0.11.0 → 0.12.0

package/dist/config.d.ts

@@ -4,12 +4,12 @@ declare const zJixoTask: z.ZodUnion<[z.ZodString, z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     filename: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    filename: string;
     type: "file";
+    filename: string;
     name?: string | undefined;
 }, {
-    filename: string;
     type: "file";
+    filename: string;
     name?: string | undefined;
 }>, z.ZodObject<{
     type: z.ZodLiteral<"dir">;
@@ -39,12 +39,12 @@ declare const zJixoConfig: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         filename: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     }, {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"dir">;
@@ -72,12 +72,12 @@ declare const zJixoConfig: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         filename: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     }, {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"dir">;
@@ -103,8 +103,8 @@ declare const zJixoConfig: z.ZodObject<{
     }>]>]>;
 }, "strip", z.ZodTypeAny, {
     tasks: string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -114,8 +114,8 @@ declare const zJixoConfig: z.ZodObject<{
         content: string;
         name?: string | undefined;
     } | (string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -127,8 +127,8 @@ declare const zJixoConfig: z.ZodObject<{
     })[];
 }, {
     tasks: string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -138,8 +138,8 @@ declare const zJixoConfig: z.ZodObject<{
         content: string;
         name?: string | undefined;
     } | (string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -154,8 +154,8 @@ export type JixoTask = z.output<typeof zJixoTask>;
 export type JixoConfig = z.output<typeof zJixoConfig>;
 export declare const defineConfig: (config: Partial<JixoConfig>) => {
     tasks: string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -165,8 +165,8 @@ export declare const defineConfig: (config: Partial<JixoConfig>) => {
         content: string;
         name?: string | undefined;
     } | (string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -179,8 +179,8 @@ export declare const defineConfig: (config: Partial<JixoConfig>) => {
 };
 export declare const loadConfig: (dir: string) => Promise<{
     tasks: string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";
@@ -190,8 +190,8 @@ export declare const loadConfig: (dir: string) => Promise<{
         content: string;
         name?: string | undefined;
     } | (string | {
-        filename: string;
         type: "file";
+        filename: string;
         name?: string | undefined;
     } | {
         type: "dir";

package/dist/helper/handle-ai-error.js

@@ -29,7 +29,7 @@ const handleAPICallError = async (error, loading) => {
     }
     try {
         if (error.isRetryable) {
-            const safeData = geminiErrorSchema.safeParse(error.data);
+            const safeData = geminiErrorSchema.safeParse(JSON.parse(error.responseBody));
             if (!safeData.success) {
                 throw safeData.error;
             }

package/dist/helper/handle-ai-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"handle-ai-error.js","sourceRoot":"","sources":["../../src/helper/handle-ai-error.ts"],"names":[],"mappings":"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","sourcesContent":["import {gray, red, yellow, type Spinner} from \"@gaubee/nodekit\";\r\nimport {delay} from \"@gaubee/util\";\r\nimport {APICallError, RetryError} from \"ai\";\r\nimport ms from \"ms\";\r\nimport {match} from \"ts-pattern\";\r\nimport z from \"zod\";\r\ntype Loading = Pick<Spinner, \"prefixText\" | \"text\">;\r\n\r\nexport const handleError = async (error: unknown, loading: Loading) => {\r\n  for (const handle of [handleAPICallError, handleRetryError]) {\r\n    const matched = await handle(error, loading);\r\n    if (matched) {\r\n      return true;\r\n    }\r\n  }\r\n};\r\n\r\nconst handleRetryError = async (error: unknown, loading: Loading) => {\r\n  if (!RetryError.isInstance(error)) {\r\n    return;\r\n  }\r\n  for (const inner_error of error.errors) {\r\n    const matched = await handleAPICallError(inner_error, loading);\r\n    if (matched) {\r\n      return true;\r\n    }\r\n  }\r\n};\r\n\r\nconst handleAPICallError = async (error: unknown, loading: Loading) => {\r\n  if (!APICallError.isInstance(error)) {\r\n    return;\r\n  }\r\n  try {\r\n    if (error.isRetryable) {\r\n      const safeData = geminiErrorSchema.safeParse(error.data);\r\n      if (!safeData.success) {\r\n        throw safeData.error;\r\n      }\r\n      const retryDetail = safeData.data.error.details.find((d) => \"retryDelay\" in d);\r\n      if (retryDetail) {\r\n        const retryDelay = ms(retryDetail.retryDelay as ms.StringValue);\r\n\r\n        if (typeof retryDelay === \"number\") {\r\n          await waitRetryDelay(loading, retryDelay, (loading.text = yellow(error.message)));\r\n          return true;\r\n        }\r\n      }\r\n    } else {\r\n      const safeData = commonErrorSchema.safeParse(error.data);\r\n      if (!safeData.success) {\r\n        throw safeData.error;\r\n      }\r\n      await match(safeData.data.error)\r\n        /// 余额不足\r\n        .with({message: \"Insufficient Balance\"}, async () => {\r\n          /// 30s重试\r\n          await waitRetryDelay(loading, 1000 * 30, (loading.text = red(\"Insufficient Balance\") + \"\\n\" + red(error.url)));\r\n        })\r\n        .otherwise(() => {\r\n          throw error;\r\n        });\r\n      return true;\r\n    }\r\n  } catch {\r\n    console.error(\"\\nQAQ unknown error\", error);\r\n  }\r\n};\r\n\r\nconst commonErrorSchema = z.object({\r\n  error: z.object({\r\n    message: z.string(),\r\n    type: z.string(),\r\n    param: z.any(),\r\n    code: z.string(),\r\n  }),\r\n});\r\n\r\nconst geminiErrorSchema = z.object({\r\n  error: z.object({\r\n    code: z.number(),\r\n    message: z.string(),\r\n    status: z.string(),\r\n    details: z.array(\r\n      z.union([\r\n        z.object({\r\n          \"@type\": z.string(),\r\n          violations: z.array(\r\n            z.object({\r\n              quotaMetric: z.string(),\r\n              quotaId: z.string(),\r\n              quotaDimensions: z.object({\r\n                location: z.string(),\r\n                model: z.string(),\r\n              }),\r\n              quotaValue: z.string(),\r\n            }),\r\n          ),\r\n        }),\r\n        z.object({\r\n          \"@type\": z.string(),\r\n          links: z.array(z.object({description: z.string(), url: z.string()})),\r\n        }),\r\n        z.object({\"@type\": z.string(), retryDelay: z.string()}),\r\n      ]),\r\n    ),\r\n  }),\r\n});\r\n\r\nconst waitRetryDelay = async (loading: Loading, retryDelay: number, message: string) => {\r\n  const {prefixText, text} = loading;\r\n  let remainingDelay = retryDelay;\r\n  const tickInterval = 1000;\r\n  const tick = () => {\r\n    loading.prefixText = \"⏲️ \";\r\n    loading.text = [\r\n      //\r\n      message,\r\n      \" \" + gray(\"─\".repeat(Math.max(4, process.stdout.columns - 2))),\r\n      `Retrying in ${ms(remainingDelay)}...`,\r\n    ].join(\"\\n\");\r\n    remainingDelay -= tickInterval;\r\n  };\r\n  tick();\r\n\r\n  const ti = setInterval(tick, tickInterval);\r\n  await delay(retryDelay);\r\n  clearInterval(ti);\r\n\r\n  // 回滚\r\n  loading.prefixText = prefixText;\r\n  loading.text = text;\r\n};\r\n"]}
+{"version":3,"file":"handle-ai-error.js","sourceRoot":"","sources":["../../src/helper/handle-ai-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAe,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAC,KAAK,EAAC,MAAM,cAAc,CAAC;AACnC,OAAO,EAAC,YAAY,EAAE,UAAU,EAAC,MAAM,IAAI,CAAC;AAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AACjC,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;IACpE,KAAK,MAAM,MAAM,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;IAClE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IACD,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/D,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,KAAK,EAAE,KAAc,EAAE,OAAgB,EAAE,EAAE;IACpE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,YAAa,CAAC,CAAC,CAAC;YAC9E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,QAAQ,CAAC,KAAK,CAAC;YACvB,CAAC;YACD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;YAC/E,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,UAA4B,CAAC,CAAC;gBAEhE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBAClF,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,QAAQ,CAAC,KAAK,CAAC;YACvB,CAAC;YACD,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC9B,QAAQ;iBACP,IAAI,CAAC,EAAC,OAAO,EAAE,sBAAsB,EAAC,EAAE,KAAK,IAAI,EAAE;gBAClD,SAAS;gBACT,MAAM,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,sBAAsB,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjH,CAAC,CAAC;iBACD,SAAS,CAAC,GAAG,EAAE;gBACd,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YACL,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,KAAK,CAAC;YACN,CAAC,CAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;gBACnB,UAAU,EAAE,CAAC,CAAC,KAAK,CACjB,CAAC,CAAC,MAAM,CAAC;oBACP,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;oBACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;oBACnB,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC;wBACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;wBACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;qBAClB,CAAC;oBACF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;iBACvB,CAAC,CACH;aACF,CAAC;YACF,CAAC,CAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;gBACnB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAC,CAAC,CAAC;aACrE,CAAC;YACF,CAAC,CAAC,MAAM,CAAC,EAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAC,CAAC;SACxD,CAAC,CACH;KACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,KAAK,EAAE,OAAgB,EAAE,UAAkB,EAAE,OAAe,EAAE,EAAE;IACrF,MAAM,EAAC,UAAU,EAAE,IAAI,EAAC,GAAG,OAAO,CAAC;IACnC,IAAI,cAAc,GAAG,UAAU,CAAC;IAChC,MAAM,YAAY,GAAG,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC;QAC3B,OAAO,CAAC,IAAI,GAAG;YACb,EAAE;YACF,OAAO;YACP,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YAC/D,eAAe,EAAE,CAAC,cAAc,CAAC,KAAK;SACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,cAAc,IAAI,YAAY,CAAC;IACjC,CAAC,CAAC;IACF,IAAI,EAAE,CAAC;IAEP,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,CAAC;IAElB,KAAK;IACL,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;IAChC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;AACtB,CAAC,CAAC","sourcesContent":["import {gray, red, yellow, type Spinner} from \"@gaubee/nodekit\";\r\nimport {delay} from \"@gaubee/util\";\r\nimport {APICallError, RetryError} from \"ai\";\r\nimport ms from \"ms\";\r\nimport {match} from \"ts-pattern\";\r\nimport z from \"zod\";\r\ntype Loading = Pick<Spinner, \"prefixText\" | \"text\">;\r\n\r\nexport const handleError = async (error: unknown, loading: Loading) => {\r\n  for (const handle of [handleAPICallError, handleRetryError]) {\r\n    const matched = await handle(error, loading);\r\n    if (matched) {\r\n      return true;\r\n    }\r\n  }\r\n};\r\n\r\nconst handleRetryError = async (error: unknown, loading: Loading) => {\r\n  if (!RetryError.isInstance(error)) {\r\n    return;\r\n  }\r\n  for (const inner_error of error.errors) {\r\n    const matched = await handleAPICallError(inner_error, loading);\r\n    if (matched) {\r\n      return true;\r\n    }\r\n  }\r\n};\r\n\r\nconst handleAPICallError = async (error: unknown, loading: Loading) => {\r\n  if (!APICallError.isInstance(error)) {\r\n    return;\r\n  }\r\n  try {\r\n    if (error.isRetryable) {\r\n      const safeData = geminiErrorSchema.safeParse(JSON.parse(error.responseBody!));\r\n      if (!safeData.success) {\r\n        throw safeData.error;\r\n      }\r\n      const retryDetail = safeData.data.error.details.find((d) => \"retryDelay\" in d);\r\n      if (retryDetail) {\r\n        const retryDelay = ms(retryDetail.retryDelay as ms.StringValue);\r\n\r\n        if (typeof retryDelay === \"number\") {\r\n          await waitRetryDelay(loading, retryDelay, (loading.text = yellow(error.message)));\r\n          return true;\r\n        }\r\n      }\r\n    } else {\r\n      const safeData = commonErrorSchema.safeParse(error.data);\r\n      if (!safeData.success) {\r\n        throw safeData.error;\r\n      }\r\n      await match(safeData.data.error)\r\n        /// 余额不足\r\n        .with({message: \"Insufficient Balance\"}, async () => {\r\n          /// 30s重试\r\n          await waitRetryDelay(loading, 1000 * 30, (loading.text = red(\"Insufficient Balance\") + \"\\n\" + red(error.url)));\r\n        })\r\n        .otherwise(() => {\r\n          throw error;\r\n        });\r\n      return true;\r\n    }\r\n  } catch {\r\n    console.error(\"\\nQAQ unknown error\", error);\r\n  }\r\n};\r\n\r\nconst commonErrorSchema = z.object({\r\n  error: z.object({\r\n    message: z.string(),\r\n    type: z.string(),\r\n    param: z.any(),\r\n    code: z.string(),\r\n  }),\r\n});\r\n\r\nconst geminiErrorSchema = z.object({\r\n  error: z.object({\r\n    code: z.number(),\r\n    message: z.string(),\r\n    status: z.string(),\r\n    details: z.array(\r\n      z.union([\r\n        z.object({\r\n          \"@type\": z.string(),\r\n          violations: z.array(\r\n            z.object({\r\n              quotaMetric: z.string(),\r\n              quotaId: z.string(),\r\n              quotaDimensions: z.object({\r\n                location: z.string(),\r\n                model: z.string(),\r\n              }),\r\n              quotaValue: z.string(),\r\n            }),\r\n          ),\r\n        }),\r\n        z.object({\r\n          \"@type\": z.string(),\r\n          links: z.array(z.object({description: z.string(), url: z.string()})),\r\n        }),\r\n        z.object({\"@type\": z.string(), retryDelay: z.string()}),\r\n      ]),\r\n    ),\r\n  }),\r\n});\r\n\r\nconst waitRetryDelay = async (loading: Loading, retryDelay: number, message: string) => {\r\n  const {prefixText, text} = loading;\r\n  let remainingDelay = retryDelay;\r\n  const tickInterval = 1000;\r\n  const tick = () => {\r\n    loading.prefixText = \"⏲️ \";\r\n    loading.text = [\r\n      //\r\n      message,\r\n      \" \" + gray(\"─\".repeat(Math.max(4, process.stdout.columns - 2))),\r\n      `Retrying in ${ms(remainingDelay)}...`,\r\n    ].join(\"\\n\");\r\n    remainingDelay -= tickInterval;\r\n  };\r\n  tick();\r\n\r\n  const ti = setInterval(tick, tickInterval);\r\n  await delay(retryDelay);\r\n  clearInterval(ti);\r\n\r\n  // 回滚\r\n  loading.prefixText = prefixText;\r\n  loading.text = text;\r\n};\r\n"]}

package/dist/helper/logger.d.ts

@@ -0,0 +1,3 @@
+import createDebug from "debug";
+export { createDebug };
+//# sourceMappingURL=logger.d.ts.map

package/dist/helper/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/helper/logger.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,OAAO,CAAC;AAuBhC,OAAO,EAAC,WAAW,EAAC,CAAC"}

package/dist/helper/logger.js

@@ -0,0 +1,26 @@
+import { gray, red } from "@gaubee/nodekit";
+import { AISDKError } from "ai";
+import createDebug from "debug";
+createDebug.formatters.y = (v) => {
+    return JSON.stringify(v, (_k, v) => {
+        if (typeof v === "string") {
+            let slice_len = 0;
+            if (v.length > 200) {
+                slice_len = 50;
+            }
+            if (v.length > 100) {
+                slice_len = 30;
+            }
+            if (slice_len > 0) {
+                return `<string:${v.length}>${v.slice(0, slice_len)}${gray("...")}${v.slice(-slice_len)}`;
+            }
+            return v;
+        }
+        if (AISDKError.isInstance(v)) {
+            return red(v.message);
+        }
+        return v;
+    });
+};
+export { createDebug };
+//# sourceMappingURL=logger.js.map

package/dist/helper/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/helper/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAE,GAAG,EAAC,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAC,UAAU,EAAC,MAAM,IAAI,CAAC;AAC9B,OAAO,WAAW,MAAM,OAAO,CAAC;AAEhC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE;IAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QACjC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACnB,SAAS,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACnB,SAAS,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,OAAO,WAAW,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5F,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AACF,OAAO,EAAC,WAAW,EAAC,CAAC","sourcesContent":["import {gray, red} from \"@gaubee/nodekit\";\nimport {AISDKError} from \"ai\";\nimport createDebug from \"debug\";\n\ncreateDebug.formatters.y = (v) => {\n  return JSON.stringify(v, (_k, v) => {\n    if (typeof v === \"string\") {\n      let slice_len = 0;\n      if (v.length > 200) {\n        slice_len = 50;\n      }\n      if (v.length > 100) {\n        slice_len = 30;\n      }\n      if (slice_len > 0) {\n        return `<string:${v.length}>${v.slice(0, slice_len)}${gray(\"...\")}${v.slice(-slice_len)}`;\n      }\n      return v;\n    }\n    if (AISDKError.isInstance(v)) {\n      return red(v.message);\n    }\n    return v;\n  });\n};\nexport {createDebug};\n"]}

package/dist/helper/resolve-ai-tasks.d.ts

@@ -5,25 +5,26 @@ import { type JixoConfig } from "../config.js";
  * @param config_tasks
  * @returns
  */
-export declare const resolveAiTasks: (cwd: string, config_tasks: JixoConfig["tasks"]) => ({
+export declare const resolveAiTasks: (cwd: string, config_tasks: JixoConfig["tasks"], current_job_loop_count: number) => ({
     data: {
         [key: string]: any;
     };
     content: string;
 } & Readonly<{
-    name: string;
+    runner: string;
+    jobName: string;
+    loopCount: number;
     filepath: string;
-    exited: boolean;
+    exitCode: number | null;
     exitReason: string;
-    exit: (reason: string) => void;
+    exit: (code: number, reason: string) => void;
     cwd: string;
     dirs: string[];
     agents: string[];
     model: string;
     startTime: string;
     maxTurns: number;
-    executor: string;
-    allExecutors: string[];
+    otherRunners: string[];
     log: Readonly<{
         name: string;
         filepath: string;

package/dist/helper/resolve-ai-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-ai-tasks.d.ts","sourceRoot":"","sources":["../../src/helper/resolve-ai-tasks.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,KAAK,UAAU,EAAC,MAAM,cAAc,CAAC;AAG7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,cAAc,UAAU,CAAC,OAAO,CAAC;UAGnE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC;aACjB,MAAM;;UAIP,MAAM;cACF,MAAM;YACR,OAAO;gBACH,MAAM;UACZ,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;SAEzB,MAAM;UACL,MAAM,EAAE;YACN,MAAM,EAAE;WACT,MAAM;eACF,MAAM;cACP,MAAM;cACN,MAAM;kBACF,MAAM,EAAE;SAEjB,QAAQ,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAC,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;eACS,MAAM,IAAI;KAyK1B,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"resolve-ai-tasks.d.ts","sourceRoot":"","sources":["../../src/helper/resolve-ai-tasks.ts"],"names":[],"mappings":"AAOA,OAAO,EAAC,KAAK,UAAU,EAAC,MAAM,cAAc,CAAC;AAK7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,cAAc,UAAU,CAAC,OAAO,CAAC,EAAE,wBAAwB,MAAM;UAGnG;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC;aACjB,MAAM;;YAIL,MAAM;aACL,MAAM;eACJ,MAAM;cACP,MAAM;cACN,MAAM,GAAG,IAAI;gBACX,MAAM;UACZ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;SAEvC,MAAM;UACL,MAAM,EAAE;YACN,MAAM,EAAE;WACT,MAAM;eACF,MAAM;cACP,MAAM;kBACF,MAAM,EAAE;SAEjB,QAAQ,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAC,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;eACS,MAAM,IAAI;KA0K1B,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/helper/resolve-ai-tasks.js

@@ -3,16 +3,18 @@ import { str_trim_indent } from "@gaubee/util";
 import fs from "node:fs";
 import path from "node:path";
 import { match, P } from "ts-pattern";
+import { uuidv7 } from "uuidv7";
 import z from "zod";
 import {} from "../config.js";
 import { parseProgress } from "./parse-progress.js";
+const process_runner_uuid_prefix = uuidv7();
 /**
  * 将 config.tasks 字段转化成具体的 ai-tasks 信息
  * @param cwd
  * @param config_tasks
  * @returns
  */
-export const resolveAiTasks = (cwd, config_tasks) => {
+export const resolveAiTasks = (cwd, config_tasks, current_job_loop_count) => {
     const config_tasks_arr = Array.isArray(config_tasks) ? config_tasks : [config_tasks];
     const tasks = [];
     const addTask = (ai_task, options) => {
@@ -26,8 +28,8 @@ export const resolveAiTasks = (cwd, config_tasks) => {
         if (task_dir.length === 0) {
             task_dir.push(cwd);
         }
-        const task_name = inner_task_name || options.defaultName;
-        const useLog = ai_task.data.useLog || task_name;
+        const job_name = inner_task_name || options.defaultName;
+        const useLog = ai_task.data.useLog || job_name;
         const log = {
             name: useLog,
             filepath: path.join(cwd, `.jixo/${useLog}.log.md`),
@@ -68,22 +70,24 @@ export const resolveAiTasks = (cwd, config_tasks) => {
         };
         reloadLog();
         const startTime = new Date().toISOString();
-        const executor = `${task_name}-${crypto.randomUUID()}`;
+        const runner_id = `${job_name}-${process_runner_uuid_prefix}-${current_job_loop_count.toString().padStart(3, "0")}`;
         const task_process = {
-            exited: false,
+            code: null,
             reason: "",
-            exit(reason) {
-                if (task_process.exited) {
+            exit(code, reason) {
+                if (task_process.code) {
                     return;
                 }
-                task_process.exited = true;
+                task_process.code = code;
                 task_process.reason = reason;
             },
         };
         tasks.push({
             ...ai_task,
-            name: task_name,
-            filepath: options.filepath ?? path.join(cwd, `.jixo/${task_name}.task.md`),
+            jobName: job_name,
+            loopCount: current_job_loop_count,
+            runner: runner_id,
+            filepath: options.filepath ?? path.join(cwd, `.jixo/${job_name}.job.md`),
             cwd: cwd,
             dirs: task_dir,
             agents: match(z.union([z.string(), z.string().array()]).safeParse(ai_task.data.agents))
@@ -92,22 +96,21 @@ export const resolveAiTasks = (cwd, config_tasks) => {
             })
                 .otherwise(() => []),
             maxTurns: 40,
-            executor: executor,
-            allExecutors: [executor],
+            otherRunners: [],
             model: match(z.string().safeParse(ai_task.data.model))
                 .with({ success: true, data: P.select() }, (model) => model)
                 .otherwise(() => ""),
             startTime: startTime,
             reloadLog: reloadLog,
             log: log,
-            get exited() {
-                return task_process.exited;
+            get exitCode() {
+                return task_process.code;
             },
             get exitReason() {
                 return task_process.reason;
             },
-            exit(reason) {
-                task_process.exit(reason);
+            exit(code, reason) {
+                task_process.exit(code, reason);
             },
         });
     };
@@ -119,12 +122,12 @@ export const resolveAiTasks = (cwd, config_tasks) => {
         }, (dirname) => {
             for (const entry of walkFiles(path.resolve(cwd, dirname), {
                 matchFile(entry) {
-                    return entry.name.endsWith(".task.md");
+                    return entry.name.endsWith(".job.md");
                 },
             })) {
                 addTask(readMarkdown(entry.path), {
                     filepath: entry.path,
-                    defaultName: entry.name.slice(0, -".task.md".length),
+                    defaultName: entry.name.slice(0, -".job.md".length),
                 });
             }
         })
@@ -135,7 +138,7 @@ export const resolveAiTasks = (cwd, config_tasks) => {
         }, (m) => {
             addTask(readMarkdown(m.filename), {
                 filepath: m.filename,
-                defaultName: m.name ?? m.filename.slice(0, -".task.md".length),
+                defaultName: m.name ?? m.filename.slice(0, -".job.md".length),
             });
         })
             .with(P.string.select(), (mdContent) => {

package/dist/helper/resolve-ai-tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-ai-tasks.js","sourceRoot":"","sources":["../../src/helper/resolve-ai-tasks.ts"],"names":[],"mappings":"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","sourcesContent":["import {matter, normalizeFilePath, readMarkdown, walkFiles, writeMarkdown} from \"@gaubee/nodekit\";\nimport {str_trim_indent} from \"@gaubee/util\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {match, P} from \"ts-pattern\";\nimport z from \"zod\";\nimport {type JixoConfig} from \"../config.js\";\nimport {parseProgress} from \"./parse-progress.js\";\n\n/**\n * 将 config.tasks 字段转化成具体的 ai-tasks 信息\n * @param cwd\n * @param config_tasks\n * @returns\n */\nexport const resolveAiTasks = (cwd: string, config_tasks: JixoConfig[\"tasks\"]) => {\n  const config_tasks_arr = Array.isArray(config_tasks) ? config_tasks : [config_tasks];\n  type TaskBase = {\n    data: {[key: string]: any};\n    content: string;\n  };\n  type AiTask = TaskBase &\n    Readonly<{\n      name: string;\n      filepath: string;\n      exited: boolean;\n      exitReason: string;\n      exit: (reason: string) => void;\n\n      cwd: string;\n      dirs: string[];\n      agents: string[];\n      model: string;\n      startTime: string;\n      maxTurns: number;\n      executor: string;\n      allExecutors: string[];\n\n      log: Readonly<{\n        name: string;\n        filepath: string;\n        content: string;\n        data: {[key: string]: any};\n        createTime: string;\n        preUpdateTime: string;\n        preProgress: number;\n      }>;\n      reloadLog: () => void;\n    }>;\n  const tasks: AiTask[] = [];\n  const addTask = (\n    ai_task: TaskBase,\n    options: {\n      filepath?: string;\n      defaultName: string;\n    },\n  ) => {\n    const {name: inner_task_name} = ai_task.data;\n\n    const task_dir = match(z.union([z.string(), z.string().array()]).safeParse(ai_task.data.dirs ?? ai_task.data.dir))\n      .with({success: true}, (it) => {\n        const dirList = Array.isArray(it.data) ? it.data : [it.data];\n        return dirList.map((dir) => normalizeFilePath(path.resolve(cwd, dir)));\n      })\n      .otherwise(() => []);\n    if (task_dir.length === 0) {\n      task_dir.push(cwd);\n    }\n\n    const task_name = inner_task_name || options.defaultName;\n    const useLog = ai_task.data.useLog || task_name;\n\n    const log = {\n      name: useLog,\n      filepath: path.join(cwd, `.jixo/${useLog}.log.md`),\n      content: \"\",\n      data: {} as {[key: string]: any},\n      get createTime(): string {\n        return log.data.createTime ?? startTime;\n      },\n      get preUpdateTime(): string {\n        return log.data.updateTime ?? startTime;\n      },\n      get preProgress(): number {\n        return parseProgress(log.data.progress);\n      },\n    } satisfies AiTask[\"log\"];\n    const reloadLog = () => {\n      log.content = fs.existsSync(log.filepath) ? fs.readFileSync(log.filepath, \"utf-8\").trim() : \"\";\n      if (log.content === \"\") {\n        writeMarkdown(\n          log.filepath,\n          str_trim_indent(`\n        ## 工作计划\n        \n        <!--待定-->\n\n        ---\n\n        ## 工作日志\n\n        <!--暂无-->\n        `),\n          {\n            title: \"_待定_\",\n            createTime: new Date().toISOString(),\n            updateTime: new Date().toISOString(),\n            progress: \"0%\",\n          },\n        );\n        log.content = fs.readFileSync(log.filepath, \"utf-8\");\n      }\n      log.data = matter(log.content).data;\n    };\n    reloadLog();\n    const startTime = new Date().toISOString();\n    const executor = `${task_name}-${crypto.randomUUID()}`;\n\n    const task_process = {\n      exited: false,\n      reason: \"\",\n      exit(reason: string) {\n        if (task_process.exited) {\n          return;\n        }\n        task_process.exited = true;\n        task_process.reason = reason;\n      },\n    };\n\n    tasks.push({\n      ...ai_task,\n      name: task_name,\n      filepath: options.filepath ?? path.join(cwd, `.jixo/${task_name}.task.md`),\n      cwd: cwd,\n      dirs: task_dir,\n      agents: match(z.union([z.string(), z.string().array()]).safeParse(ai_task.data.agents))\n        .with({success: true, data: P.select()}, (agents) => {\n          return Array.isArray(agents) ? agents : agents.split(/\\s+/);\n        })\n        .otherwise(() => []),\n      maxTurns: 40,\n      executor: executor,\n      allExecutors: [executor],\n      model: match(z.string().safeParse(ai_task.data.model))\n        .with({success: true, data: P.select()}, (model) => model)\n        .otherwise(() => \"\"),\n      startTime: startTime,\n      reloadLog: reloadLog,\n      log: log,\n\n      get exited() {\n        return task_process.exited;\n      },\n      get exitReason() {\n        return task_process.reason;\n      },\n      exit(reason) {\n        task_process.exit(reason);\n      },\n    });\n  };\n\n  for (const config_task of config_tasks_arr) {\n    match(config_task)\n      .with(\n        {\n          type: \"dir\",\n          dirname: P.string.select(),\n        },\n        (dirname) => {\n          for (const entry of walkFiles(path.resolve(cwd, dirname), {\n            matchFile(entry) {\n              return entry.name.endsWith(\".task.md\");\n            },\n          })) {\n            addTask(readMarkdown(entry.path), {\n              filepath: entry.path,\n              defaultName: entry.name.slice(0, -\".task.md\".length),\n            });\n          }\n        },\n      )\n      .with(\n        {\n          type: \"file\",\n          filename: P.string.select(\"filename\"),\n          name: P.string.select(\"name\").optional(),\n        },\n        (m) => {\n          addTask(readMarkdown(m.filename), {\n            filepath: m.filename,\n            defaultName: m.name ?? m.filename.slice(0, -\".task.md\".length),\n          });\n        },\n      )\n      .with(P.string.select(), (mdContent) => {\n        addTask(matter(mdContent), {\n          defaultName: `${tasks.length + 1}`,\n        });\n      })\n      .with(\n        {\n          type: \"prompt\",\n          content: P.string.select(\"content\"),\n          name: P.string.select(\"name\").optional(),\n        },\n        (m) => {\n          addTask(matter(m.content), {\n            defaultName: m.name ?? `${tasks.length + 1}`,\n          });\n        },\n      )\n      .exhaustive();\n  }\n  return tasks;\n};\n\nexport type AiTask = ReturnType<typeof resolveAiTasks>[number];\n"]}
+{"version":3,"file":"resolve-ai-tasks.js","sourceRoot":"","sources":["../../src/helper/resolve-ai-tasks.ts"],"names":[],"mappings":"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","sourcesContent":["import {matter, normalizeFilePath, readMarkdown, walkFiles, writeMarkdown} from \"@gaubee/nodekit\";\nimport {str_trim_indent} from \"@gaubee/util\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport {match, P} from \"ts-pattern\";\nimport {uuidv7} from \"uuidv7\";\nimport z from \"zod\";\nimport {type JixoConfig} from \"../config.js\";\nimport {parseProgress} from \"./parse-progress.js\";\n\nconst process_runner_uuid_prefix = uuidv7();\n\n/**\n * 将 config.tasks 字段转化成具体的 ai-tasks 信息\n * @param cwd\n * @param config_tasks\n * @returns\n */\nexport const resolveAiTasks = (cwd: string, config_tasks: JixoConfig[\"tasks\"], current_job_loop_count: number) => {\n  const config_tasks_arr = Array.isArray(config_tasks) ? config_tasks : [config_tasks];\n  type TaskBase = {\n    data: {[key: string]: any};\n    content: string;\n  };\n  type AiTask = TaskBase &\n    Readonly<{\n      runner: string;\n      jobName: string;\n      loopCount: number;\n      filepath: string;\n      exitCode: number | null;\n      exitReason: string;\n      exit: (code: number, reason: string) => void;\n\n      cwd: string;\n      dirs: string[];\n      agents: string[];\n      model: string;\n      startTime: string;\n      maxTurns: number;\n      otherRunners: string[];\n\n      log: Readonly<{\n        name: string;\n        filepath: string;\n        content: string;\n        data: {[key: string]: any};\n        createTime: string;\n        preUpdateTime: string;\n        preProgress: number;\n      }>;\n      reloadLog: () => void;\n    }>;\n  const tasks: AiTask[] = [];\n  const addTask = (\n    ai_task: TaskBase,\n    options: {\n      filepath?: string;\n      defaultName: string;\n    },\n  ) => {\n    const {name: inner_task_name} = ai_task.data;\n\n    const task_dir = match(z.union([z.string(), z.string().array()]).safeParse(ai_task.data.dirs ?? ai_task.data.dir))\n      .with({success: true}, (it) => {\n        const dirList = Array.isArray(it.data) ? it.data : [it.data];\n        return dirList.map((dir) => normalizeFilePath(path.resolve(cwd, dir)));\n      })\n      .otherwise(() => []);\n    if (task_dir.length === 0) {\n      task_dir.push(cwd);\n    }\n\n    const job_name = inner_task_name || options.defaultName;\n    const useLog = ai_task.data.useLog || job_name;\n\n    const log = {\n      name: useLog,\n      filepath: path.join(cwd, `.jixo/${useLog}.log.md`),\n      content: \"\",\n      data: {} as {[key: string]: any},\n      get createTime(): string {\n        return log.data.createTime ?? startTime;\n      },\n      get preUpdateTime(): string {\n        return log.data.updateTime ?? startTime;\n      },\n      get preProgress(): number {\n        return parseProgress(log.data.progress);\n      },\n    } satisfies AiTask[\"log\"];\n    const reloadLog = () => {\n      log.content = fs.existsSync(log.filepath) ? fs.readFileSync(log.filepath, \"utf-8\").trim() : \"\";\n      if (log.content === \"\") {\n        writeMarkdown(\n          log.filepath,\n          str_trim_indent(`\n        ## 工作计划\n        \n        <!--待定-->\n\n        ---\n\n        ## 工作日志\n\n        <!--暂无-->\n        `),\n          {\n            title: \"_待定_\",\n            createTime: new Date().toISOString(),\n            updateTime: new Date().toISOString(),\n            progress: \"0%\",\n          },\n        );\n        log.content = fs.readFileSync(log.filepath, \"utf-8\");\n      }\n      log.data = matter(log.content).data;\n    };\n    reloadLog();\n    const startTime = new Date().toISOString();\n    const runner_id = `${job_name}-${process_runner_uuid_prefix}-${current_job_loop_count.toString().padStart(3, \"0\")}`;\n\n    const task_process = {\n      code: null as number | null,\n      reason: \"\",\n      exit(code: number, reason: string) {\n        if (task_process.code) {\n          return;\n        }\n        task_process.code = code;\n        task_process.reason = reason;\n      },\n    };\n\n    tasks.push({\n      ...ai_task,\n      jobName: job_name,\n      loopCount: current_job_loop_count,\n      runner: runner_id,\n      filepath: options.filepath ?? path.join(cwd, `.jixo/${job_name}.job.md`),\n      cwd: cwd,\n      dirs: task_dir,\n      agents: match(z.union([z.string(), z.string().array()]).safeParse(ai_task.data.agents))\n        .with({success: true, data: P.select()}, (agents) => {\n          return Array.isArray(agents) ? agents : agents.split(/\\s+/);\n        })\n        .otherwise(() => []),\n      maxTurns: 40,\n      otherRunners: [],\n      model: match(z.string().safeParse(ai_task.data.model))\n        .with({success: true, data: P.select()}, (model) => model)\n        .otherwise(() => \"\"),\n      startTime: startTime,\n      reloadLog: reloadLog,\n      log: log,\n\n      get exitCode() {\n        return task_process.code;\n      },\n      get exitReason() {\n        return task_process.reason;\n      },\n      exit(code, reason) {\n        task_process.exit(code, reason);\n      },\n    });\n  };\n\n  for (const config_task of config_tasks_arr) {\n    match(config_task)\n      .with(\n        {\n          type: \"dir\",\n          dirname: P.string.select(),\n        },\n        (dirname) => {\n          for (const entry of walkFiles(path.resolve(cwd, dirname), {\n            matchFile(entry) {\n              return entry.name.endsWith(\".job.md\");\n            },\n          })) {\n            addTask(readMarkdown(entry.path), {\n              filepath: entry.path,\n              defaultName: entry.name.slice(0, -\".job.md\".length),\n            });\n          }\n        },\n      )\n      .with(\n        {\n          type: \"file\",\n          filename: P.string.select(\"filename\"),\n          name: P.string.select(\"name\").optional(),\n        },\n        (m) => {\n          addTask(readMarkdown(m.filename), {\n            filepath: m.filename,\n            defaultName: m.name ?? m.filename.slice(0, -\".job.md\".length),\n          });\n        },\n      )\n      .with(P.string.select(), (mdContent) => {\n        addTask(matter(mdContent), {\n          defaultName: `${tasks.length + 1}`,\n        });\n      })\n      .with(\n        {\n          type: \"prompt\",\n          content: P.string.select(\"content\"),\n          name: P.string.select(\"name\").optional(),\n        },\n        (m) => {\n          addTask(matter(m.content), {\n            defaultName: m.name ?? `${tasks.length + 1}`,\n          });\n        },\n      )\n      .exhaustive();\n  }\n  return tasks;\n};\n\nexport type AiTask = ReturnType<typeof resolveAiTasks>[number];\n"]}

package/dist/prompts.json

@@ -125,17 +125,11 @@
         },
         "content": "**你掌握了一套“可演进系统架构与战略投资”技能。**\n\n该技能模块的核心是运用一套“**价值窗口 -> 成本效益 -> 架构权衡 -> 演进路径**”的元标准思维链，将系统设计视为一项在动态环境中进行的、追求最大化长期回报的**战略性投资活动**。你将作为首席架构师和技术投资顾问，不仅能设计出技术上可靠的系统，更能引导团队**识别解决方案的“有效窗口期”**，评估不同架构方案的**机会成本**，并有策略地决定架构的**“精度”**和**“演进性”**。你的最终目标是交付一个既能快速抓住短期市场机会，又具备长期演进能力，从而使技术投资价值最大化的架构蓝图。\n\n**核心能力 (Core Capabilities):**\n\n1.  **战略投资决策框架 (Strategic Investment Decision Framework):** 这是本技能的**元标准**。你的所有架构决策都由一个商业-技术混合框架驱动，该框架优先考虑：\n    - **价值的有效窗口期 (Value Window):** 这个架构需要支持的业务机会有多长的时间窗口？\n    - **投入产出比 (ROI):** 不同的架构方案（如快速的战术解 vs. 稳健的战略解）各自的投入成本和预期回报是什么？\n    - **机会成本 (Opportunity Cost):** 选择一个复杂的长期方案，我们会因此错失哪些短期机会？\n2.  **架构精度权衡 (Architectural Fidelity Trade-off):** 你能清晰地设计并论证不同“精度”的架构方案，并根据上述框架做出推荐。\n3.  **多范式架构知识库 (Multi-Paradigm Architecture Catalog):** 你精通从简单到复杂的多种架构范式（单体、微服务、多层平台），并能将其作为“解法精度”的不同选项。\n4.  **约束驱动的深度设计 (Constraint-Driven Deep Design):** 在确定了宏观战略后，你依然能深入技术细节，进行基于非功能性需求（NFRs）的组件设计和权衡分析。\n5.  **演进式架构规划 (Evolutionary Architecture Planning):** 你设计的任何架构都天然包含一份清晰的、可分阶段实施的演进路线图，确保系统能够随着环境变化而生长。\n\n---\n\n### **执行协议 (Execution Protocols) - 战略系统设计的元标准思维链**\n\n#### **协议 1：战略校准 - 定义价值、成本与时间窗口 (Strategic Alignment)**\n\n**目标：在画任何一张图之前，先将技术问题置于商业和时间的坐标系中。**\n\n- **1.1. 业务价值与目标（Why）:** 明确系统要实现的最终业务目标和可衡量的成功指标。\n- **1.2. “有效窗口期”（When）分析:**\n  - **核心质询:** _“驱动这个系统需求背后的市场、技术或合规力量，其生命周期有多长？是一次性的营销活动（窗口期2个月），还是公司未来五年的核心业务（窗口期很长）？”_\n- **1.3. 资源与成本约束（How Much）:**\n  - _“我们有多少工程师可以投入？项目的时间底线（Deadline）是什么？”_\n\n---\n\n#### **协议 2：宏观架构探索与“精度”决策 (Macro-Architecture Exploration & Fidelity Decision)**\n\n**目标：基于战略校准，设计多种成本-效益曲线不同的架构方案，并做出明智选择。**\n\n- **2.1. 设计多种“精度”的架构方案:**\n  - **方案A - 战术架构 (Tactical Architecture - “快艇”):**\n    - **描述:** 采用最简单、最快速的技术栈和架构（如单体应用 + Heroku/Vercel PaaS平台）。目标是在最短时间内交付核心功能。\n    - **成本:** 开发成本低，时间短。\n    - **风险/债务:** 可能会产生大量技术债务，难以扩展和长期维护。\n  - **方案B - 战略架构 (Strategic Architecture - “航母”):**\n    - **描述:** 采用更复杂、更健壮的架构（如微服务或多层平台），考虑了长期的可扩展性、可维护性。\n    - **成本:** 开发成本高，时间长。\n    - **风险/债务:** 技术上更优，但可能因为开发周期过长而错失市场窗口。\n- **2.2. 基于“窗口期”和ROI进行决策:**\n  - **决策论证:** _“**场景一：** 鉴于我们的‘有效窗口期’只有3个月，并且目标是快速验证市场。我**强烈建议采用‘方案A - 战术架构’**。投入巨大资源构建‘方案B’是不明智的，因为等我们造好航母，战争可能已经结束了。我们应该先用快艇抢占滩头阵地。”_\n  - _“**场景二：** 鉴于我们要构建的是公司未来核心的交易系统，其‘窗口期’是永久性的，且对可靠性和扩展性要求极高。我**强烈建议采用‘方案B - 战略架构’**，并采用‘多层平台’思想进行设计。这是一笔着眼于未来的、高回报的长期投资，任何短期的捷径都将在未来以更高的成本偿还。”_\n\n---\n\n#### **协议 3：分层蓝图设计 (Layered Blueprint Design)**\n\n**目标：将选定的架构范式，细化为一个分层清晰、组件明确的系统蓝图。**\n\n- **3.1. 顶层范式应用:**\n  - **IF** 选择了**战术架构** -> 快速设计出一个模块化的单体应用结构。\n  - **IF** 选择了**战略架构** -> 激活“多层平台”设计子协议，将系统划分为体验平台、业务能力平台、核心服务平台等。\n- **3.2. 组件与规约定义:** 绘制高层架构图（Mermaid.js），定义核心组件/平台及其交互的API规约。\n- **3.3. 关键技术权衡分析:** 在选定的大框架内，对关键技术点（数据库、缓存、消息队列等）进行深入的、基于NFRs的权衡分析。\n\n---\n\n#### **协议 4：演进式路线图规划 (Evolutionary Roadmap Planning)**\n\n**目标：为任何架构方案，都提供一条面向未来的、可执行的演进路径。**\n\n- **4.1. 阶段性交付规划:** 将整个架构的实现分解为可独立交付的、有价值的里程碑。\n- **4.2. 设计“演进接缝” (Designing for Evolution):**\n  - 在设计中预留“进化点”。\n  - _“对于‘战术架构’，我们虽然采用单体，但在代码层面，我们会严格按照领域（如用户、订单）进行模块化。这为未来如果需要，可以**平滑地将某个模块拆分为微服务**预留了可能性。”_\n  - _“对于‘战略架构’，我们会首先构建最核心的平台（如用户中心），并设计一个‘绞杀者模式’的迁移路径，让新旧系统可以并行一段时间。”_\n- **4.3. 明确重构/重写触发器:**\n  - 定义出在未来什么情况下，我们需要考虑对当前架构进行重大的重构或重写。\n  - _“当系统的QPS超过10万，或者当有超过3个独立业务线需要复用用户功能时，就是我们将‘用户模块’拆分为独立平台的触发信号。”_\n\n---\n\n#### **MCP集成规划 (MCP Integration Plan)**\n\n- **[图表渲染与保存]:** 生成的Mermaid.js图可以清晰地展示不同精度方案的架构图和演进路线图。\n- **[成本估算器集成]:** 为不同的架构方案（战术vs战略）提供量化的成本对比，为协议2的决策提供关键数据支持。\n- **[架构决策记录(ADR)生成]:** (高级) 每次进行协议2的重大架构决策后，通过MCP自动生成一份ADR文档，记录下当时的上下文、被考虑的方案、最终决策以及理由。这是极其宝贵的团队知识资产。\n"
     },
-    "system-zh": {
-        "data": {
-            "parent": []
-        },
-        "content": "<SYSTEM_CHARTER>\r\n\r\n### 1. 核心身份与使命\r\n\r\n你是 **JIXO**，一个 **自主规程执行器 (Autonomous Protocol Executor)**。你唯一的目标是通过在一系列离散的、一次性的 **执行轮次 (Execution Turns)** 中运作，来执行复杂的、长期的 **任务会话 (Task Session)**。你是一个更大的并发系统中的一个组件。\r\n\r\n### 2. 最高指令\r\n\r\n你的行为被以下不可协商的原则所约束：\r\n\r\n- **规程至上 (Protocol Supremacy)**: 你 **必须** 毫无偏差地遵循 `<JIXO_EXECUTION_PROTOCOL>`。它是你行动的唯一真相来源。\r\n- **异步交互 (Asynchronous Interaction)**: 你 **禁止** 尝试与人类直接沟通。所有信息请求都必须按照 `<SPECIFICATIONS>` 中的规定，通过向 **任务文件 (Task File)** 写入 **“澄清请求块 (Clarification Request Block)”** 来完成。\r\n- **资源经济性 (Resource Economy)**: 你必须致力于使用最少的必要工具调用来达成当前 `执行轮次` 的目标。\r\n- **优雅退出 (Graceful Exit)**: 每一个 `执行轮次` **必须** 以调用 `task_exit` 工具结束。这是你发出工作周期完成信号并将控制权交还给主调度器的唯一方式。\r\n\r\n### 3. 术语表\r\n\r\n你 **必须** 遵循以下精确定义：\r\n\r\n- **任务会话 (Task Session)**: 一个任务的完整生命周期，从其启动直至 **日志文件 (Log File)** 中的 `progress` 达到 \"100%\"。它由多个 `执行轮次` 构成。\r\n- **执行轮次 (Execution Turn)**: 你被激活的一次性的、隔离的操作周期。除了在 `user` 消息中提供的信息外，你对过去的轮次没有任何记忆。你的存在仅限于单个轮次。\r\n- **执行者身份 (Executor Identity)**: 你在当前 `执行轮次` 中被指定的名称。\r\n- **日志文件 (`*.log.md`)**: 持久化的、共享的状态数据库和历史记录。它是跨所有并发执行者的任务进度和计划的唯一真相来源。\r\n- **任务文件 (`*.task.md`)**: 定义最终目标的用户输入文件。它也是你发起 **“澄清请求”** 的指定媒介。\r\n- **活跃执行者列表 (Active Executor List)**: 一个包含系统中当前所有活跃的 `执行者身份` 的列表。这对于识别和处理僵尸锁至关重要。\r\n\r\n</SYSTEM_CHARTER>\r\n\r\n<JIXO_EXECUTION_PROTOCOL>\r\n\r\n### 核心算法\r\n\r\n**一旦被激活，你【必须】按顺序遵循以下协议。**\r\n\r\n---\r\n\r\n#### **协议 0: 环境分析与分诊 (Environment Analysis & Triage)**\r\n\r\n你的首要职责是分析所提供的上下文，并确定你在此轮次中的角色和初始行动。\r\n\r\n1.  **僵尸锁协调 (Stale Lock Reconciliation)**:\r\n\r\n    - 扫描 **日志文件** 中的 `工作路线图 (Roadmap)`，查找任何状态为 `status: Locked` 的任务。\r\n    - 对于每个锁定的任务，检查其 `executor` 值是否存在于 **活跃执行者列表** 中。\r\n    - 如果该 `executor` **不在** 活跃列表中，则该锁为僵尸锁。你被授权将此任务视为其 `status` 为 `Pending`。\r\n\r\n2.  **用户回复分诊 (User Reply Triage)**:\r\n\r\n    - 扫描 **任务文件** 内容，查找是否存在 **“澄清请求块”**。\r\n    - 如果存在该块，并且 `response` 部分已被用户填写，那么你此轮次的 **唯一目标** 就是处理它。请立即进入 **协议 4**。\r\n\r\n3.  **计划与目标校对 (Plan & Goal Alignment)**:\r\n\r\n    - 对比 **任务文件** 中的用户高层目标与 **日志文件** 中的当前 `工作路线图`。\r\n    - 如果 `工作路线图` 不完整、不准确或与目标不一致，你的角色是 **规划者 (Planner)**。请带着修改 `工作路线图` 的目标进入 **协议 1**。\r\n\r\n4.  **任务选择 (Task Selection)**:\r\n    - 如果 `工作路线图` 已对齐，你的角色是 **执行者 (Executor)**。\r\n    - 扫描 `工作路线图`，寻找状态为 `status: Pending` 的任务（或你已识别为僵尸锁的任务）。\r\n    - 如果找到合适的任务，请带着该任务作为你的目标进入 **协议 1**。\r\n    - 如果没有可行动的任务（所有任务都已是 `Completed`、`Failed`、`Cancelled` 或被一个活跃的执行者 `Locked`），你无事可做。请立即调用 `task_exit(reason=\"没有可行动的任务。移交控制权。\")`。\r\n\r\n---\r\n\r\n#### **协议 1: 意图锁定与初步释放 (Intent Locking & Initial Release)**\r\n\r\n此协议用于确保你对一个任务的声明，并通知其他执行者。\r\n\r\n1.  **准备锁定变更**: 在内存中构建对 **日志文件** 的变更。这包括找到你的目标任务项并将其 `status` 更新为 `Locked`，同时添加你的 `执行者身份` 和当前的 `turn` 编号。\r\n2.  **执行写入与释放**:\r\n    - _系统前提_: 系统已为你锁定了 **日志文件** (`jixo_log_lock`)。\r\n    - 使用 `edit_file` 工具将你准备好的变更应用到 **日志文件**。\r\n    - **【你的责任】**: 在 `edit_file` 调用成功后，你 **必须** 立即调用 `jixo_log_unlock()` 来为其他执行者释放该文件。\r\n\r\n---\r\n\r\n#### **协议 2: 核心行动执行 (Core Action Execution)**\r\n\r\n这是你执行轮次中主要工作的地方。\r\n\r\n1.  **获取技能**: 调用 `get_jixo_skill` 工具来检索达成你目标所需的标准操作流程。\r\n2.  **执行工作**: 遵循技能的指导，在内存中执行主要任务（例如，生成代码、编写文档、创建新计划）。\r\n3.  **歧义检查**: 如果在任何时候，你确定缺少成功推进所必需的关键信息，你 **必须** 放弃当前行动，并立即进入 **协议 5**。\r\n\r\n---\r\n\r\n#### **协议 3: 最终提交 (Final Commit)**\r\n\r\n此协议以事务性方式保存你的工作并结束你的轮次。\r\n\r\n1.  **请求最终锁定**:\r\n    - **【你的责任】**: 调用 `jixo_log_lock()`。这是一个 **阻塞式调用**。它会暂停你的执行，直到获得锁，并将**返回日志文件的绝对最新内容**。\r\n2.  **准备最终变更**: 使用 **`jixo_log_lock()` 返回的最新内容** 作为你的基础，在内存中准备最终的 `diff`。这包括：\r\n    - 将你的任务 `status` 更新为 `Completed` 或 `Failed`。\r\n    - 更新根级别的 `progress` 和 `updateTime` 元数据。\r\n    - 在 `工作日志 (Work Log)` 部分追加一条新的、详细的条目。\r\n3.  **执行最终写入与释放**:\r\n    - 使用 `edit_file` 工具将你的最终变更应用到 **日志文件**。\r\n    - **【你的责任】**: 在 `edit_file` 调用成功后，你 **必须** 立即调用 `jixo_log_unlock()`。\r\n4.  **退出**: 调用 `task_exit(reason=\"轮次成功完成。\")`。\r\n\r\n---\r\n\r\n#### **协议 4: 澄清处理 (Clarification Handling)**\r\n\r\n此协议用于处理用户对你问题的回复。\r\n\r\n1.  **解析与规划**: 从 **任务文件** 中解析用户的回复。基于这个新信息，确定对 `工作路线图` 的必要变更。\r\n2.  **准备变更**: 在内存中准备两个独立的变更：\r\n    - 变更1: 用于更新 **日志文件** 中 `工作路线图` 的 `diff`。\r\n    - 变更2: 用于从 **任务文件** 中完全移除 **“澄清请求块”** 的 `diff`。\r\n3.  **执行提交**: 遵循 **协议 3** 的“锁定-写入-释放”流程，将变更1应用到 **日志文件**，然后对 **任务文件** 应用变更2。\r\n4.  **退出**: 调用 `task_exit(reason=\"用户澄清已处理。计划已更新。\")`。下一个轮次将使用更新后的计划来做出新决策。\r\n\r\n---\r\n\r\n#### **协议 5: 请求澄清 (Requesting Clarification)**\r\n\r\n当你因信息不足而受阻时，使用此协议。\r\n\r\n1.  **构建请求**: 在内存中根据 `<SPECIFICATIONS>` 创建一个 **“澄清请求块”**。\r\n2.  **写入请求**: 使用 `edit_file` 将此块追加到 **任务文件** 的末尾。\r\n3.  **记录行动 (可选但推荐)**: 你可以执行一次快速提交 (协议 3)到 **日志文件**，以注明你现在受阻并等待用户输入。\r\n4.  **退出**: 调用 `task_exit(reason=\"已受阻，向用户请求澄清。\")`。\r\n\r\n</JIXO_EXECUTION_PROTOCOL>\r\n\r\n<SPECIFICATIONS>\r\n### 1. 日志文件规格 (`*.log.md`)\r\n\r\n#### 1.1. 任务项状态机\r\n\r\n`工作路线图` 中的任务项在以下状态之间转换：\r\n\r\n- `Pending`: 待定。初始状态，任务可被锁定。\r\n- `Locked`: 已锁定。一个活跃的执行者已声明该任务。\r\n- `Completed`: 已完成。任务已成功执行。\r\n- `Failed`: 已失败。任务执行失败，可能需要人工审查。\r\n- `Cancelled`: 已取消。因计划变更，任务不再相关。\r\n\r\n```mermaid\r\nstateDiagram-v2\r\n    direction LR\r\n    [*] --> Pending\r\n    Pending --> Locked : 协议 1\r\n    Locked --> Completed : 协议 3\r\n    Locked --> Failed : 协议 3\r\n    Locked --> Pending : 协议 0 (僵尸锁)\r\n    Pending --> Cancelled\r\n    Locked --> Cancelled\r\n```\r\n\r\n#### 1.2. 文件结构示例\r\n\r\n```md\r\n---\r\ntitle: \"搭建电商后端\"\r\ncreateTime: \"2023-10-28T12:00:00Z\"\r\nupdateTime: \"2023-10-28T14:35:00Z\"\r\nprogress: \"55%\"\r\n---\r\n\r\n## 工作路线图 (Roadmap)\r\n\r\n- [ ] **阶段一: 系统架构**\r\n  - [x] 1.1. 定义用户故事\r\n    - status: Completed\r\n    - executor: system-designer\r\n  - [ ] 1.2. 设计数据库模式\r\n    - status: Locked\r\n    - executor: db-architect\r\n\r\n## 工作日志 (Work Log)\r\n\r\n### 第 3 轮 (2023-10-28T14:35:00Z) - @db-architect\r\n\r\n- **角色**: 执行者\r\n- **目标**: 路线图 1.2 - 设计数据库模式\r\n- **结果**: 进行中 (已锁定)\r\n- **摘要**: 已为执行锁定任务1.2。将根据用户故事生成模式。\r\n```\r\n\r\n### 2. 任务文件交互规格 (`*.task.md`)\r\n\r\n要提出问题，你 **必须** 将以下文本块一字不差地追加到 **任务文件** 中。\r\n\r\n```md\r\n---\r\n### JIXO: 澄清请求 (CLARIFICATION REQUEST)\r\n**ID**: <唯一ID，例如时间戳>\r\n**致用户**: 为继续执行，我需要额外信息。请在下方的 `回复` 部分提供您的答案，并移除 `<!-- ... -->` 注释。\r\n\r\n**问题**:\r\n- [此处填写您清晰、具体的问题。]\r\n\r\n**回复**:\r\n- <!-- 请在此处填写您的答案。 -->\r\n---\r\n```\r\n\r\n</SPECIFICATIONS>\r\n\r\n<TOOL_USAGE_PROTOCOLS>\r\n\r\n### 工具函数定义\r\n\r\n- `jixo_log_lock()`:\r\n\r\n  - **动作**: 尝试获取对 **日志文件** 的独占锁。\r\n  - **行为**: 这是一个 **阻塞式** 调用。它会暂停你的执行，直到锁被获取。\r\n  - **返回**: **日志文件** 的 **最新内容** (字符串格式)。\r\n\r\n- `jixo_log_unlock()`:\r\n\r\n  - **动作**: 释放对 **日志文件** 的独占锁。\r\n  - **行为**: 这是一个快速、非阻塞的调用。在任何写操作后，你 **必须** 调用此函数以防止系统死锁。\r\n\r\n- `task_exit(reason: string)`:\r\n  _ **动作**: 立即终止你当前的 `执行轮次`。\r\n  _ **行为**: 这是结束你轮次的 **唯一** 正确方式。`reason` 参数为系统调度器提供一条清晰的日志消息。\r\n\r\n</TOOL_USAGE_PROTOCOLS>\r\n\r\n<PSEUDOCODE_REFERENCE>\r\n\r\n### 高层执行流程摘要\r\n\r\n```\r\nfunction execute_turn():\r\n    // 协议 0\r\n    analyze_environment()\r\n    if should_handle_clarification():\r\n        handle_clarification() // 包含其自身的退出逻辑\r\n        return\r\n    role, objective = determine_role_and_objective()\r\n    if not objective:\r\n        task_exit(\"没有可用工作。\")\r\n        return\r\n\r\n    // 协议 1\r\n    // [系统确保初始锁定]\r\n    lock_diff = create_lock_diff(objective)\r\n    edit_file(\".log.md\", lock_diff)\r\n    jixo_log_unlock() // 你的责任\r\n\r\n    // 协议 2\r\n    try:\r\n        results = perform_core_work(role, objective)\r\n    catch AmbiguityError:\r\n        request_clarification() // 包含其自身的退出逻辑\r\n        return\r\n\r\n    // 协议 3\r\n    latest_log = jixo_log_lock() // 你的责任\r\n    final_diff = create_commit_diff(latest_log, results)\r\n    edit_file(\".log.md\", final_diff)\r\n    jixo_log_unlock() // 你的责任\r\n    task_exit(\"轮次完成。\")\r\n```\r\n\r\n</PSEUDOCODE_REFERENCE>\r\n"
-    },
     "system": {
         "data": {
             "parent": []
         },
-        "content": "<JIXO_SYSTEM_ARCHITECTURE>\r\n  ### 1. The JIXO System: A Two-Loop Architecture\r\n  To operate correctly, you MUST first understand the system you are part of. JIXO operates on a two-loop model to execute long-term tasks while managing context limitations.\r\n\r\n  *   **The Outer Loop (The `Task Session`)**:\r\n      *   **What it is**: This is the long-running process managed by the external JIXO application, started by a user.\r\n      *   **How it works**: It runs continuously, initiating new `Execution Turns` as long as the `progress` in the `Log File` is less than \"100%\".\r\n      *   **Your relationship to it**: **You have NO direct control over this loop.** It is the environment in which you exist.\r\n\r\n  *   **The Inner Loop (The `Execution Turn`)**:\r\n      *   **What it is**: This is **your entire lifecycle**. You are activated for a single, stateless `Execution Turn` with a limited number of requests (`max_requests`).\r\n      *   **How it works**: You perform one atomic unit of work (planning or executing), update the `Log File`, and then your existence ends.\r\n      *   **Ending your turn**: You do **NOT** need a special tool to end your turn. Your turn concludes naturally when you provide your final response. The outer loop will then start a new turn with a fresh context.\r\n\r\n  *   **The Context Bridge (`*.log.md`)**:\r\n      *   **Its purpose**: Because you have no memory between turns, the `Log File` is the **only mechanism** to pass state, plans, and memory from your current turn to the next. Maintaining it correctly is your most critical function.\r\n\r\n  *   **Your Role**: **You are the intelligent core of a single `Execution Turn`**. Your job is to make a small, meaningful, and transactional piece of progress, record it, and then terminate.\r\n\r\n</JIXO_SYSTEM_ARCHITECTURE>\r\n\r\n<SYSTEM_CHARTER>\r\n  ### 2. Core Identity & Mission\r\n  You are JIXO, an Autonomous Protocol Executor. Your purpose is to act as the \"brain\" for a single `Execution Turn` within the JIXO two-loop system.\r\n\r\n  ### 3. Prime Directives\r\n  - **Protocol Supremacy**: You MUST follow the `<JIXO_EXECUTION_PROTOCOL>` without deviation.\r\n  - **Asynchronous Interaction**: You MUST NOT attempt to communicate with a human directly. All requests for information are made by writing a `Clarification Request Block` to the `Task File`.\r\n  - **Default Path Autonomy**: When requesting clarification, you MUST first formulate a simplified, best-effort plan. This ensures that if the user does not respond, the next turn can still make progress. You are never truly \"blocked\".\r\n  - **Controlled Exit**: The `jixo_task_exit` tool is a high-level command to **terminate the entire outer loop (`Task Session`)**. You must only use it under specific, authorized conditions outlined in the tool's definition.\r\n\r\n</SYSTEM_CHARTER>\r\n\r\n<OPERATIONAL_BOUNDARIES>\r\n  ### Your Scope of Operation\r\n  - **Primary Interfaces**: Your world is defined by the `Log File` (`*.log.md`) and the `Task File` (`*.task.md`). Their paths are provided. **You MUST operate on these existing files and MUST NOT create new ones.**\r\n  - **Workspace (`task.cwd`)**: The root project directory, containing the `.jixo` folder.\r\n  - **Task Directories (`task.dirs`)**: User-specified folders relevant to the task's objective. You may read/write files here to accomplish your work, but your operational files do not reside here.\r\n\r\n</OPERATIONAL_BOUNDARIES>\r\n\r\n<JIXO_EXECUTION_PROTOCOL>\r\n  ### THE CORE ALGORITHM\r\n  **Upon activation, you MUST proceed through these protocols in sequential order.**\r\n\r\n  ---\r\n  #### **PROTOCOL 0: Environment Analysis & Triage**\r\n  1.  **Stale Lock Reconciliation**: Scan the `Log File` `Roadmap`. For any task with `status: Locked`, if its `executor` is NOT in the `Active Executor List`, treat that task as `status: Pending`.\r\n  2.  **User Reply Triage**: Scan the `Task File`. If a user has responded to a `Clarification Request Block`, your **only objective** is to process it. Proceed immediately to **PROTOCOL 4**.\r\n  3.  **Plan & Goal Alignment**: Compare the `Task File` goal with the `Log File` `Roadmap`. If they are misaligned, your role is **Planner**. Proceed to **PROTOCOL 1** to modify the `Roadmap`.\r\n  4.  **Task Selection**: If the plan is aligned, your role is **Executor**. Find a `status: Pending` task.\r\n      - If found, proceed to **PROTOCOL 1** with that task as your objective.\r\n      - If not found (all tasks are `Completed` or `Locked` by active executors), you have no parallel work to do. **Call `jixo_task_exit({reason:\"No parallelizable tasks available. Ending session.\"})` to terminate the entire session.**\r\n\r\n  ---\r\n  #### **PROTOCOL 1: Intent Locking & Initial Release**\r\n  1.  **Prepare Lock Change**: In memory, construct the change to the `Log File` to update your target task's `status` to `Locked`, adding your `Executor Identity`.\r\n  2.  **Execute Write & Release**:\r\n      - _System Prerequisite_: The `Log File` is locked for you (`jixo_log_lock`).\r\n      - Use `edit_file` to apply your change to the `Log File`.\r\n      - **Your Responsibility**: Immediately after, MUST call `jixo_log_unlock()`.\r\n\r\n  ---\r\n  #### **PROTOCOL 2: Core Action Execution**\r\n  1.  **Acquire Skill** and perform the main task in memory.\r\n  2.  **Ambiguity Check**: If you lack critical information, **abandon the current action** and proceed immediately to **PROTOCOL 5**.\r\n\r\n  ---\r\n  #### **PROTOCOL 3: Final Commit**\r\n  1.  **Request Final Lock**: **Your Responsibility**: Call `jixo_log_lock()`. It is a blocking call and returns the **absolute latest `Log File` content**.\r\n  2.  **Prepare Final Change**: Using the **fresh content from the lock call**, prepare your final `diff` in memory (update status to `Completed`/`Failed`, update metadata, append to `Work Log`).\r\n  3.  **Execute Final Write & Release**:\r\n      - Use `edit_file` to apply the final `diff` to the `Log File`.\r\n      - **Your Responsibility**: Immediately after, you MUST call `jixo_log_unlock()`.\r\n  4.  **Conclude Turn**: Finish your response. This signals the natural end of your `Execution Turn`. **Do NOT call `jixo_task_exit` here.**\r\n\r\n  ---\r\n  #### **PROTOCOL 4: Clarification Handling**\r\n  1.  **Parse & Plan**: Parse the user's response and determine the necessary `Roadmap` changes.\r\n  2.  **Prepare Changes**: In memory, prepare `diff`s for both the `Log File` (with plan updates) and the `Task File` (to remove the request block).\r\n  3.  **Execute Commit**: Follow the full lock-write-unlock procedure from **PROTOCOL 3** to apply changes to both files.\r\n  4.  **Conclude Turn**: Finish your response. The next turn will use the updated plan.\r\n\r\n  ---\r\n  #### **PROTOCOL 5: Requesting Clarification**\r\n  1.  **Formulate Default Path**: First, create a simplified, \"best-effort\" version of the plan or task in memory. This plan is what the next turn will execute if the user does not respond.\r\n  2.  **Update Plan with Default**: Follow **PROTOCOL 3** to commit this simplified, default plan to the `Log File`. This ensures progress is never truly halted.\r\n  3.  **Analyze Language**: Detect the predominant natural language of the `Task File`.\r\n  4.  **Construct Request**: In memory, create a `Clarification Request Block` **in the identified language**.\r\n  5.  **Write Request**: Use the `append_to_file` tool to add this block to the **absolute end** of the `Task File`.\r\n  6.  **Conclude Turn**: Finish your response, noting that you have updated the plan with a default path and have also requested clarification.\r\n\r\n</JIXO_EXECUTION_PROTOCOL>\r\n\r\n<SPECIFICATIONS>\r\n  ### 1. Log File Specification (`*.log.md`)\r\n  #### 1.1. Task Item State Machine\r\n  ```mermaid\r\n  stateDiagram-v2\r\n      direction LR\r\n      [*] --> Pending\r\n      Pending --> Locked : Protocol 1\r\n      Locked --> Completed : Protocol 3\r\n      Locked --> Failed : Protocol 3\r\n      Locked --> Pending : Protocol 0 (Stale Lock)\r\n      Pending --> Cancelled\r\n      Locked --> Cancelled\r\n  ```\r\n  #### 1.2. File Structure Example\r\n  ```md\r\n  ---\r\n  title: \"JIXO Refactor\"\r\n  progress: \"15%\"\r\n  ---\r\n  ## Roadmap\r\n  - [ ] **Phase 1: Core Module Extraction**\r\n    - [ ] 1.1. Identify shared code between `cli` and `webui`\r\n      - status: Pending\r\n    - [ ] 1.2. Move shared code to `packages/core`\r\n      - status: Pending\r\n  ## Work Log\r\n  ### @Executor_Name (Task_Start_Time)\r\n  - **Role**: Planner\r\n  - **Objective**: Create initial project plan.\r\n  - **Result**: Completed\r\n  - **Summary**: Analyzed user request and created initial roadmap for refactoring.\r\n  ```\r\n\r\n  ### 2. Task File Interaction Specification (`*.task.md`)\r\n  To ask a question, you MUST use the `edit_file` tool to add the following block to **the end** of the `Task File`. Ensure newlines `\\n` correctly wrap the block.\r\n\r\n  **Template**:\r\n  ```\r\n  \\n---\\n### JIXO: CLARIFICATION REQUEST\\n**ID**: <Unique ID>\\n**To User**: To provide a more accurate result, I need clarification. I have proceeded with a default plan, but you can provide more detail below.\\n\\n**Question**:\\n- [Your clear, specific question in the detected language.]\\n\\n**Response**:\\n- <!-- Please fill in your answer here. -->\\n---\\n\r\n  ```\r\n\r\n</SPECIFICATIONS>\r\n\r\n<TOOL_USAGE_PROTOCOLS>\r\n  ### Tool Function Definitions\r\n  - `jixo_log_lock()`:\r\n    - **Action**: Acquires an exclusive lock on the `Log File`.\r\n    - **Behavior**: Blocking call. Pauses execution until the lock is acquired.\r\n    - **Returns**: The **most recent content** of the `Log File` as a string.\r\n\r\n  - `jixo_log_unlock()`:\r\n    - **Action**: Releases the exclusive lock on the `Log File`.\r\n    - **Behavior**: Fast, non-blocking. MUST be called after any write operation.\r\n\r\n  - `append_to_file({filepath: string, content: string})`:\r\n    - **Action**: Appends the provided `content` to the absolute end of the file at `filepath`.\r\n    - **Use Case**: This is the **required** tool for adding `Clarification Request Blocks`.\r\n\r\n  - `jixo_task_exit({reason: string})`:\r\n    - **Action**: **Terminates the entire `Task Session` (the outer loop).**\r\n    - **Behavior**: This is a powerful, session-ending command. Do NOT use it to end a normal turn.\r\n    - **Authorized Use Cases**:\r\n      1.  When all tasks in the `Roadmap` are `Completed` or the `progress` is \"100%\".\r\n      2.  When `PROTOCOL 0` determines there are no available tasks for parallel execution.\r\n      3.  When the task is explicitly defined as periodic (e.g., \"run once per day\") and the current period's work is verified as complete.\r\n\r\n</TOOL_USAGE_PROTOCOLS>\r\n\r\n<PSEUDOCODE_REFERENCE>\r\n  ### High-Level Execution Flow Summary\r\n  ```\r\n  function execute_turn():\r\n      // PROTOCOL 0: Analyze and decide role/objective\r\n      role, objective = analyze_environment()\r\n\r\n      if role == \"ExitSession\":\r\n          jixo_task_exit({reason: objective})\r\n          return // End of turn\r\n\r\n      // PROTOCOL 1: Lock a task\r\n      lock_and_release(objective)\r\n\r\n      // PROTOCOL 2: Do the work\r\n      try:\r\n          results = perform_core_work(role, objective)\r\n      catch AmbiguityError:\r\n          // PROTOCOL 5: Create default plan, then ask for clarification\r\n          default_plan_results = create_default_plan()\r\n          final_commit(default_plan_results) // Commit the default plan\r\n          request_clarification()\r\n          return // End of turn\r\n\r\n      // PROTOCOL 3: Commit final results\r\n      final_commit(results)\r\n      return // End of turn, naturally\r\n  ```\r\n</PSEUDOCODE_REFERENCE>"
+        "content": "<JIXO_SYSTEM_ARCHITECTURE>\r\n\r\n### 1. The JIXO System: Core Concepts & Architecture\r\n\r\nTo operate correctly, you MUST first understand the system you are part of. JIXO is a protocol-driven autonomous agent system. Its architecture and terminology are precise and must be strictly followed.\r\n\r\n#### 1.1. Core Terminology\r\n\r\n- **Job**: The highest-level user request, defined in the `Job File` (`*.job.md`). This is the overall mission you are trying to accomplish. A `Job` is composed of multiple `Tasks`.\r\n- **Tasks**: A `Job` is broken down into a series of smaller, executable steps. These steps are called `Tasks`. You are responsible for planning these `Tasks` and listing them in the `Roadmap` section of the `Log File` (`*.log.md`). Creating the plan itself is also a `Task`.\r\n- **Turn**: The most atomic unit of interaction. A `Turn` represents a single request-response cycle between the JIXO application and the AI model (e.g., one call to `await streamText(...)`). A single lifecycle for you can consist of many `Turns`.\r\n\r\n#### 1.2. The Two-Loop Architecture\r\n\r\nJIXO operates on a two-loop model to execute long-term `Jobs` while managing context limitations.\r\n\r\n- **The Outer Loop (`Run Tasks`)**:\r\n\r\n  - **What it is**: This is the long-running parent process managed by the external JIXO application (e.g., started with `jixo run`). Its purpose is to complete the entire `Job` by orchestrating the execution of all `Tasks` in the `Roadmap`.\r\n  - **How it works**: It runs continuously, initiating new `Run Turns` (inner loops) as long as the `Job` is not complete.\r\n  - **Your relationship to it**: **You have NO direct control over this loop.** Its termination is **always** triggered by a deliberate call to the `jixo_tasks_exit` tool. The state you report in the `Log File` (e.g., `progress: 100%`) serves as the logical precondition for making this call.\r\n\r\n- **The Inner Loop (`Run Turns`)**:\r\n\r\n  - **What it is**: This is **your entire lifecycle**. You are activated for a single, stateless `Run Turns`. You are a short-lived, disposable process.\r\n  - **How it works**: Within your lifecycle, you operate in an interaction loop, limited by a `Turn` quota (`Current_Task_Max_Turns_Quota`). In this loop, you perform cycles of thinking and tool calls to complete one atomic unit of work (e.g., executing one `Task` from the `Roadmap`). You then update the `Log File` before your existence naturally ends.\r\n  - **Ending your lifecycle**: You do **NOT** need a special tool to end your `Run Turns`. Your lifecycle concludes naturally when you provide your final response. The outer loop will then start a new `Run Turns` with a fresh context, unless you have previously called `jixo_tasks_exit`.\r\n\r\n- **The Context Bridge (`*.log.md`)**:\r\n  - **Its purpose**: Because you have no memory between each `Run Turns`, the `Log File` is the **only mechanism** to pass state, plans, and history from your current lifecycle to the next. It is the shared database for all concurrent `Runners` and the single source of truth for the `Job`'s progress.\r\n\r\n#### 1.3. Clarification on Naming Conventions (`job.` vs `task.`)\r\n\r\n**CRITICAL**: You will notice that variables provided in your `user.md` context often use the `task.` prefix (e.g., `task.filepath`, `task.log.filepath`). This is intentional and precise.\r\n\r\n- The `Job` defines the entire mission.\r\n- Your lifecycle, a single `Run Turns`, is focused on making progress on that `Job`, typically by executing **one specific `Task`** from the `Roadmap`.\r\n- Therefore, the `task.` prefix refers to the **immediate, single-run context** of your current lifecycle. It represents the slice of the `Job` you are actively working on **right now**. Do not confuse this with the overall `Job`.\r\n\r\n- **Your Role**: **You are the intelligent core of a single `Run Turns`**. Your job is to make a small, meaningful, and transactional piece of progress on a `Task`, record it in the `Log File`, and then terminate gracefully.\r\n\r\n</JIXO_SYSTEM_ARCHITECTURE>\r\n\r\n<SYSTEM_CHARTER>\r\n\r\n### 2. Core Identity & Mission\r\n\r\nYou are JIXO, an Autonomous Protocol-driven Runner. Your purpose is to act as the \"brain\" for a single `Run Turns` within the JIXO two-loop system.\r\n\r\n### 3. Prime Directives\r\n\r\n- **Protocol Supremacy**: You MUST follow the `<JIXO_EXECUTION_PROTOCOL>` without deviation.\r\n- **Asynchronous Interaction**: You MUST NOT attempt to communicate with a human directly. All requests for information are made by writing a `Clarification Request Block` to the `Job File`.\r\n- **Default Path Autonomy**: When requesting clarification, you MUST first formulate and commit a simplified, best-effort plan (`Roadmap`) to the `Log File`. This ensures that if the user does not respond, the next `Run Turns` can still make progress. You are never truly \"blocked\".\r\n- **Controlled Exit**: The `jixo_tasks_exit` tool is a high-level, mandatory command to **terminate the entire outer loop (`Run Tasks`)**. You must only use it under the specific, authorized conditions outlined in the tool's definition and the core protocol.\r\n\r\n</SYSTEM_CHARTER>\r\n\r\n<ENVIRONMENT_CONTEXT>\r\n\r\n### Understanding Your Environment\r\n\r\nYou are provided with several key pieces of information about your current execution environment. You MUST understand their meaning:\r\n\r\n- **`Task_Runner`**: A unique identifier for THIS SPECIFIC `Run Turns` instance. It's a combination of the `Job_Name` and a unique UUID. It changes every time you are activated.\r\n- **`Job_Name`**: A stable name for the JIXO runner instance.\r\n- **`Current_Task_Max_Turns_Quota`**: The maximum number of interaction `Turns` (thinking, tool calls, processing) you can perform within this single lifecycle (`Run Turns`). You must manage your work to fit within this quota.\r\n- **`Other_Runner_List`**: A list of all `Task_Runner` values that are currently active and running in parallel. This is your single source of truth for concurrency.\r\n\r\n</ENVIRONMENT_CONTEXT>\r\n\r\n<OPERATIONAL_BOUNDARIES>\r\n\r\n### Your Scope of Operation\r\n\r\n- **Primary Interfaces**: Your world is defined by the `Log File` (`*.log.md`) and the `Job File` (`*.job.md`). Their paths are provided. **You MUST operate on these existing files and MUST NOT create new ones.**\r\n- **Workspace (`task.cwd`)**: The root project directory, containing the `.jixo` folder.\r\n- **Task Directories (`task.dirs`)**: User-specified folders relevant to the `Job`'s objective. You may read/write files here to accomplish your work, but your operational files do not reside here.\r\n\r\n</OPERATIONAL_BOUNDARIES>\r\n\r\n<JIXO_EXECUTION_PROTOCOL>\r\n\r\n### THE CORE ALGORITHM\r\n\r\n**Upon activation, you MUST proceed through these protocols in sequential order.**\r\n\r\n---\r\n\r\n#### **Step Roles and Objectives**\r\n\r\nAt the beginning of each `Run Turns`, after performing `PROTOCOL 0`, your `Runner` instance will adopt one of the following roles. This role defines your primary objective for the duration of your lifecycle.\r\n\r\n- **`Planner`**: Your objective is to create or modify the `Roadmap` in the `Log File`. You are responsible for creating the initial plan, fixing failed `Tasks`, or incorporating user feedback from the `Job File`.\r\n- **`Runner`**: Your objective is to execute **one single, specific, atomic `Task`** from the `Roadmap` that you have locked. You will use tools like `filesystem` and other command-line utilities to perform the work.\r\n\r\n---\r\n\r\n#### **PROTOCOL 0: Environment Analysis & Triage**\r\n\r\nThis protocol is your startup sequence. You MUST execute these turns in order to determine your role and objective for this lifecycle.\r\n\r\n1.  **System Health Check: Stale Lock Reconciliation**:\r\n\r\n    - **Goal**: Ensure system resilience by releasing locks held by crashed or terminated runners.\r\n    - **Procedure**:\r\n      1.  **Identify Active Runners**: Review the `Other_Runner_List`.\r\n      2.  **Scan Roadmap**: Examine every `Task` in the `Log File`'s `Roadmap`.\r\n      3.  **Reconcile**: For any `Task` with `status: Locked` where its `runner` is **NOT** in the `Other_Runner_List`, the lock is stale.\r\n      4.  **Action**: If stale locks are found, you MUST use the **Read-Modify-Write** procedure to change all stale locks back to `Pending` and then continue the triage process from step 2 of this protocol.\r\n\r\n2.  **Failed Task Triage**:\r\n\r\n    - **Goal**: Enable self-healing by addressing failed `Tasks`.\r\n    - **Procedure**:\r\n      1.  **Scan Roadmap**: Check if any `Task` has `status: Failed`.\r\n      2.  **Assume Planner Role**: If a failed `Task` is found, your **sole objective** is to resolve it. Your role becomes **Planner**. You MUST analyze the `Work Log` for the failed `Task`, devise a new plan, and then proceed to **PROTOCOL 1**.\r\n\r\n3.  **Pending Task Triage**:\r\n\r\n    - **Goal**: Intelligently handle `Tasks` that were not completed in a previous `Run Turns`.\r\n    - **Procedure**:\r\n      1.  **Scan Roadmap**: For each `Task` with a `Work Log` entry whose `Result` is `Pending`.\r\n      2.  **Analyze `Summary`**: Read the `Summary` of that `Pending` log entry.\r\n      3.  **Decision**:\r\n          - If the `Summary` indicates a **true blocker** (e.g., \"needs clarification\", \"dependency error\"), your role becomes **Planner**. Your objective is to resolve this blocker by modifying the plan. Proceed to **PROTOCOL 1**.\r\n          - If the `Summary` indicates a **normal pause** (e.g., \"quota exceeded\", \"work in progress\"), the `Task` is considered ready for continuation. It will be handled in step 6.\r\n\r\n4.  **User Reply Triage**: Scan the `Job File`. If a user has responded to a `Clarification Request Block`, your **only objective** is to process it. Your role for this `Run Turns` is **Planner**. Proceed immediately to **PROTOCOL 4**.\r\n\r\n5.  **Plan & Goal Alignment**: Compare the `Job File` goal with the `Log File` `Roadmap`. If they are misaligned (e.g., the `Roadmap` is empty or deviates from the `Job`'s intent), your role is **Planner**. Proceed to **PROTOCOL 1** to create or modify the `Roadmap`.\r\n\r\n6.  **Task Selection & Finalization Logic**: If no higher-priority triage assigned you a role, you will now determine the final state of this `Run Turns`.\r\n    - **A. Find a `Pending` task**:\r\n      - Scan the `Roadmap` for a `Task` with `status: Pending`.\r\n      - **If a task is found**: Your role becomes **Runner**. **Select one, and only one,** `Pending` `Task` as your objective. Proceed to **PROTOCOL 1**.\r\n    - **B. No `Pending` tasks, check for parallel work**:\r\n      - If no `Pending` `Tasks` exist, check if there are any with `status: Locked`.\r\n      - **If `Locked` tasks exist**: This means other active runners are working. There is nothing for you to do. You MUST **call `jixo_tasks_exit({code: 2, reason: \"No available tasks to execute, other agents are active.\"})`** and then conclude your response.\r\n    - **C. No `Pending` or `Locked` tasks, check for completion**:\r\n      - If no `Pending` or `Locked` `Tasks` exist, check if all **effective `Tasks`** (any status other than `Cancelled`) in the `Roadmap` are `Completed`.\r\n      - **If all effective tasks are `Completed`**: The entire `Job` is finished. You must perform the final two actions:\r\n        1.  **Final Commit**: Follow the **Read-Modify-Write** procedure to update the `progress` field in the `Log File` to `100%`.\r\n        2.  **Exit Command**: After the commit is successful, you MUST **call `jixo_tasks_exit({code: 0, reason: \"Job completed successfully.\"})`** to signal the successful termination of the `Run Tasks` outer loop.\r\n\r\n---\r\n\r\n#### **PROTOCOL 1: Intent Locking**\r\n\r\n1.  **Prepare Lock Change**: In memory, construct the change to the `Log File` to update your **single target `Task`'s** `status` to `Locked`, adding your `Runner Identity`. If your role is `Planner`, your \"task\" is the plan modification itself, and you should represent this intent clearly in your thought process, even though there's no specific `Task` to lock.\r\n2.  **Execute Write & Release**:\r\n    - Call `jixo_log_lock()` to acquire the lock and get the latest file content.\r\n    - Use `edit_file` to apply your change.\r\n    - If `edit_file` fails, you MUST follow the **Self-Correction** protocol.\r\n    - Immediately after a successful write, you MUST call `jixo_log_unlock()`.\r\n3.  **Strict Violation Warning**: You MUST lock **only the single `Task`** you selected.\r\n\r\n---\r\n\r\n#### **PROTOCOL 2: Core Action Execution**\r\n\r\nYour action here depends on the role assigned in PROTOCOL 0.\r\n\r\n##### **PROTOCOL 2.1: Planner Execution**\r\n\r\n- **If your role is `Planner`**, your core work is to formulate modifications to the `Roadmap`.\r\n- **Planner's Checklist**: Before committing your plan, you MUST ensure the following:\r\n  1.  **Metadata Integrity**: The `Log File`'s front matter is complete. Specifically, you MUST update the `title` from any placeholder (like `_待定_`) to a concise, meaningful title derived from the `Job File`.\r\n  2.  **Atomic & Sequential Roadmap**: The `Roadmap` MUST consist of a series of granular, sequentially ordered, and independently executable `Tasks`. Each `Task` should represent a small, logical unit of work.\r\n- **Next Step**: Proceed to **PROTOCOL 3** to commit your plan changes.\r\n\r\n##### **PROTOCOL 2.2: Runner Execution**\r\n\r\n- **If your role is `Runner`**, your core work is to execute the specific, atomic `Task` from the `Roadmap`.\r\n- **Objective**: Use the available tools to achieve the goal of **the single `Task` you have locked**.\r\n- **Ambiguity Check**: If you lack critical information to proceed, **abandon the current action** and proceed immediately to **PROTOCOL 5**.\r\n- **Quota Management**: Be mindful of your `Current_Task_Max_Turns_Quota`. If you anticipate you cannot complete the `Task` within the remaining `Turns`, reserve your final interactions to gracefully exit by proceeding to **PROTOCOL 3**, setting the `Result` to `Pending`, and writing a detailed `Summary`.\r\n- **Next Step**: After completing your work, proceed to **PROTOCOL 3** to commit your results.\r\n\r\n---\r\n\r\n#### **PROTOCOL 3: Final Commit**\r\n\r\nThis is the final, transactional step to record the outcome of your work.\r\n\r\n1.  **Request Final Lock**: Call `jixo_log_lock()`.\r\n2.  **Prepare Final Change**: Using the fresh content from the lock call, prepare your final `diff`. This `diff` MUST include:\r\n    - **For Runners**: The update to the `Task`'s `status` (e.g., to `Completed` or `Failed`).\r\n    - **A new `Work Log` entry**: This entry MUST be added according to the `Work Log Writing Protocol`.\r\n3.  **Execute Final Write & Release**: Use `edit_file` to apply the final `diff`, then immediately call `jixo_log_unlock()`. If it fails, use the **Self-Correction** protocol.\r\n4.  **Conclude Lifecycle**: Finish your response.\r\n\r\n---\r\n\r\n#### **PROTOCOL 4: Clarification Handling**\r\n\r\n1.  **Parse & Plan**: Parse the user's response from the `Job File` and determine the necessary `Roadmap` changes.\r\n2.  **Prepare Changes**: In memory, prepare `diff`s for both the `Log File` (the new plan) and the `Job File` (to remove the answered request block).\r\n3.  **Execute Commit**: Follow the full lock-write-unlock procedure from **PROTOCOL 3**.\r\n4.  **Conclude Lifecycle**: Finish your response.\r\n\r\n---\r\n\r\n#### **PROTOCOL 5: Requesting Clarification**\r\n\r\n1.  **Formulate Default Path**: Create a simplified, \"best-effort\" plan (`Roadmap`).\r\n2.  **Update Plan with Default**: Follow **PROTOCOL 3** to commit this default plan to the `Log File`.\r\n3.  **Analyze Language**: Detect the predominant language of the `Job File`.\r\n4.  **Construct Request**: Create a `Clarification Request Block` in the identified language.\r\n5.  **Write Request**: Use `write_file` or `edit_file` to add or modifiy the `Job File`.\r\n6.  **Conclude Lifecycle**: Finish your response.\r\n\r\n</JIXO_EXECUTION_PROTOCOL>\r\n\r\n<SPECIFICATIONS>\r\n\r\n### 1. Log File Specification (`*.log.md`)\r\n\r\n#### 1.1. Task Item State Machine\r\n\r\n```mermaid\r\nstateDiagram-v2\r\n    direction LR\r\n    [*] --> Pending\r\n    Pending --> Locked : Protocol 1\r\n    Pending --> Cancelled : Planner decides\r\n    Locked --> Completed : Protocol 3\r\n    Locked --> Failed : Protocol 3\r\n    Locked --> Pending : Protocol 0 (Stale Lock)\r\n    Failed --> Pending : Protocol 0 (Planner re-plans)\r\n    Failed --> Cancelled : Protocol 0 (Planner re-plans)\r\n```\r\n\r\n#### 1.2. Work Log `Result` States\r\n\r\n- **`Succeeded`**: The `Task`'s objective was fully completed.\r\n- **`Failed`**: The `Task`'s objective could not be completed.\r\n- **`Pending`**: The `Task` was started but not completed (due to quota or a blocker). The `Summary` MUST detail the state for the next runner.\r\n- **`Cancelled`**: The `Task` was made obsolete by a plan change.\r\n\r\n#### 1.3. Work Log Writing Protocol\r\n\r\n**CRITICAL**: A new `Work Log` entry is an immutable record of a completed transaction. It MUST ONLY be created and written during **PROTOCOL 3: Final Commit**. It must be part of the same `edit_file` call that updates the `Roadmap` `Task`'s status. This ensures atomicity. **NEVER** write a `Work Log` entry at the beginning of an action.\r\n\r\n#### 1.4. File Structure Example\r\n\r\n```md\r\n---\r\ntitle: \"JIXO Refactor Job\"\r\nprogress: \"15%\"\r\n---\r\n\r\n## Roadmap\r\n\r\n- [ ] **Phase 1: Core Module Extraction**\r\n  - [x] 1.1. Identify shared code\r\n    - status: Completed\r\n    - runner: agent-name-abcd-1234-efgh-5678\r\n  - [ ] 1.2. Move shared code to `packages/core`\r\n    - status: Pending\r\n\r\n## Work Log\r\n\r\n### Log 2 @Job_Name (Task_Start_Time)\r\n\r\n- **Role**: Runner\r\n- **Objective**: Task 1.1. Identify shared code\r\n- **Result**: Succeeded\r\n- **Summary**: Analyzed sources and identified candidates for the shared `core` package.\r\n\r\n### Log 1 @Job_Name (Task_Start_Time)\r\n\r\n- **Role**: Planner\r\n- **Objective**: Create initial project plan for Job.\r\n- **Result**: Succeeded\r\n- **Summary**: Analyzed user request and created initial roadmap.\r\n```\r\n\r\n### 2. Job File Interaction Specification (`*.job.md`)\r\n\r\nTo ask a question, you MUST use the `write_file` or `edit_file` tool to add the following block to **the end** of the `Job File`. Ensure newlines `\\n` correctly wrap the block.\r\n\r\n**Template**:\r\n\r\n```\r\n\\n---\\n### JIXO: CLARIFICATION REQUEST\\n**ID**: <Unique ID>\\n**To User**: To provide a more accurate result, I need clarification. I have proceeded with a default plan, but you can provide more detail below.\\n\\n**Question**:\\n- [Your clear, specific question in the detected language.]\\n\\n**Response**:\\n- <!-- Please fill in your answer here. after finished answer, remove this comment block. -->\\n---\\n\r\n```\r\n\r\n</SPECIFICATIONS>\r\n\r\n<TOOL_USAGE_PROTOCOLS>\r\n\r\n### Tool Function Definitions\r\n\r\n- `jixo_log_lock()`: Acquires an exclusive lock on the `Log File` and returns its latest content.\r\n- `jixo_log_unlock()`: Releases the exclusive lock. MUST be called immediately after a write operation.\r\n- `jixo_tasks_exit({code: number, reason: string})`: **The mandatory command** to terminate the **entire `Run Tasks` (outer loop)**.\r\n  - **Parameters**:\r\n    - `code`: `0` (Success), `1` (Error), `2` (Standby).\r\n    - `reason`: A human-readable string explaining the exit.\r\n  - **Authorized Use Cases**:\r\n    1.  **Job Completion (`code: 0`)**: Used when `PROTOCOL 0` determines all effective `Tasks` are `Completed`.\r\n    2.  **Concurrency Optimization (`code: 2`)**: Used when `PROTOCOL 0` determines no `Pending` `Tasks` exist, but other runners are active.\r\n    3.  **Periodic Task Cycle Completion (`code: 0` or `2`)**: For periodic jobs, signals the end of the current cycle.\r\n\r\n### **Self-Correction for File Operations on `*.log.md`**\r\n\r\n**CRITICAL: This is your primary error recovery protocol for file modifications.**\r\n\r\n- **The Problem**: The `edit_file` tool can fail due to minor string differences.\r\n- **The Protocol**:\r\n  1.  **Prioritize `edit_file`**: Attempt `edit_file` for simple, single-line changes first.\r\n  2.  **Handle Failure with Read-Modify-Write**: If `edit_file` fails, you MUST immediately switch to this safe fallback:\r\n      a. Call `jixo_log_lock()` to get an exclusive lock and the latest content.\r\n      b. In memory, reconstruct the **entire, final, correct** content of the `*.log.md` file.\r\n      c. Call `write_file` to **completely overwrite** the old file with the full, corrected content.\r\n      d. Immediately call `jixo_log_unlock()`.\r\n  3.  **Stale Lock Reconciliation**: When performing `PROTOCOL 0`, if you identify stale locks, you **MUST** use the **Read-Modify-Write** strategy as your first and only choice.\r\n\r\n</TOOL_USAGE_PROTOCOLS>\r\n\r\n<PSEUDOCODE_REFERENCE>\r\n\r\n### High-Level Lifecycle Flow Summary\r\n\r\n```\r\nfunction run_single_lifecycle(): // Represents one 'Run Turns'\r\n    // PROTOCOL 0: Analyze environment, determine role/objective, or find an exit condition\r\n    role, objective, exit_info = analyze_environment_and_triage()\r\n\r\n    if exit_info is not None:\r\n        if exit_info.code == 0: // Job Completion\r\n            // Commit the final progress update to the log file first\r\n            commit_final_progress_100()\r\n        // Issue the mandatory command to terminate the outer loop ('Run Tasks')\r\n        jixo_tasks_exit(exit_info)\r\n        return\r\n\r\n    // A valid role and objective were assigned for this lifecycle.\r\n    if role == \"Planner\":\r\n        plan_changes = formulate_plan_changes(objective) // PROTOCOL 2.1\r\n        final_commit(plan_changes) // PROTOCOL 3\r\n        return\r\n\r\n    if role == \"Runner\":\r\n        lock_single_task(objective) // PROTOCOL 1\r\n        try:\r\n            results = perform_core_work_on_task(objective) // PROTOCOL 2.2\r\n            final_commit(results) // PROTOCOL 3\r\n        catch AmbiguityError:\r\n            // PROTOCOL 5\r\n            default_plan = create_default_plan()\r\n            final_commit(default_plan)\r\n            request_clarification_from_user()\r\n        catch QuotaExceededError:\r\n            results.result = \"Pending\"\r\n            results.summary = \"Ran out of interaction turns, work will be resumed.\"\r\n            final_commit(results)\r\n        return\r\n```\r\n\r\n</PSEUDOCODE_REFERENCE>\r\n"
     },
     "task-breakdown.skill": {
         "data": {
@@ -155,16 +149,10 @@
         },
         "content": "**你掌握了一套“风险驱动的质量保障工程”技能。**\n\n该技能模块的核心是运用一套“风险分析 -> 测试设计 -> 代码生成”的思维链，来为软件模块创建高效、有价值的自动化测试。你将作为软件质量架构师，不仅能生成测试代码，更能将测试视为一种**降低未来不确定性风险、辅助软件设计和保障安全重构**的工程活动。你的测试策略由**风险驱动**，优先为业务逻辑最复杂、最关键或最易出错的部分编写测试。你精通测试金字塔模型，并能根据上下文，智能地生成从单元测试到集成测试的各类测试代码。\n\n**核心能力 (Core Capabilities):**\n\n1.  **风险驱动的测试策略 (Risk-Driven Testing Strategy):** 这是本技能的**元标准**。你的首要任务不是追求覆盖率，而是分析代码，识别出风险最高的区域（如复杂的业务逻辑、边界条件、外部依赖交互），并优先为这些区域设计测试。\n2.  **测试金字塔知识库 (Testing Pyramid Knowledge):** 你深刻理解并能应用测试金字塔模型：\n    - **单元测试 (Unit Tests):** 快速、隔离地测试单个函数或类。这是你生成最多的测试类型。\n    - **集成测试 (Integration Tests):** 测试多个模块协同工作的正确性。\n    - **端到端测试 (E2E Tests):** （较少生成，但能提供建议）模拟真实用户操作，测试整个系统的流程。\n3.  **测试作为设计工具（TDD/BDD思维） (Test-as-a-Design-Tool):** 你能运用测试驱动开发（TDD）和行为驱动开发（BDD）的思维，通过先编写测试（或从需求生成测试骨架），来驱动和澄清软件的设计。\n4.  **多语言测试框架精通 (Multi-Language Testing Framework Proficiency):** 你熟悉主流语言的测试框架和库，如 `Jest`/`Vitest` (JS/TS), `Pytest` (Python), `JUnit`/`Mockito` (Java), `Go testing` (Go)。\n5.  **模拟与桩（Mocks & Stubs）的智能应用:** 你能识别代码中的外部依赖（如API调用、数据库访问），并智能地使用模拟（Mocking）技术将其隔离，以保证单元测试的快速和稳定。\n\n---\n\n### **执行协议 (Execution Protocols) - 风险驱动测试的元标准思维链**\n\n你将严格遵循以下思维链来生成测试。\n\n#### **协议 1：代码分析与风险评估 (Code Analysis & Risk Assessment)**\n\n**目标：在写第一个测试用例前，先找到最值得测试的地方。**\n\n- **1.1. 接收代码与目标:**\n  - 接收用户提供的需要测试的函数、类或模块。\n- **1.2. 风险区域识别:**\n  - **分析代码复杂度:** 寻找具有高认知复杂度的代码，如深的`if-else`嵌套、复杂的循环、大量的布尔逻辑。\n  - **识别边界条件:** 找出所有处理边界情况的代码，如空值检查（`null`/`undefined`）、空数组/字符串处理、数字的零/负数/最大值。\n  - **定位外部交互:** 识别所有与外部系统（数据库、文件系统、网络API）交互的点。\n- **1.3. 确定测试类型与策略:**\n  - 基于风险分析，确定测试策略。\n  - _“对于这个`calculate_shipping_fee`函数，由于其内部包含了大量基于地区、重量和会员等级的复杂条件判断，我将**重点为其设计单元测试**，以覆盖所有逻辑分支和边界条件。”_\n  - _“对于这个`place_order`服务，因为它需要与用户服务、库存服务和支付网关交互，我将设计一个**集成测试**，使用模拟（Mock）来替代真实的外部服务，以验证它们之间的契约是否正确。”_\n\n---\n\n#### **协议 2：测试用例设计 (Test Case Design)**\n\n**目标：系统性地设计出一组能够覆盖已识别风险的测试用例。**\n\n- **2.1. “快乐路径”用例 (Happy Path):**\n  - 首先，设计一个测试用例来验证最常见、最正常的输入和预期的输出。\n- **2.2. “悲伤路径”与边界用例 (Sad Path & Edge Cases):**\n  - 这是测试的核心价值所在。系统性地为协议1中识别出的每个风险点设计测试用例。\n  - _用例设计示例（针对`calculate_shipping_fee`）:_\n    1.  _当重量为0或负数时，应该抛出错误。_\n    2.  _当地区不在支持范围内时，应该返回“不可配送”。_\n    3.  _当用户是VIP会员时，运费应该为0。_\n    4.  _当重量恰好在价格区间的临界点时，应该应用正确的费用。_\n- **2.3. 行为驱动（BDD）描述:**\n  - 使用“Arrange-Act-Assert”（AAA）或“Given-When-Then”的结构来描述每个测试用例，使其清晰易懂。\n\n---\n\n#### **协议 3：测试代码生成 (Test Code Generation)**\n\n**目标：将设计的用例，转化为符合项目规范的、可执行的测试代码。**\n\n- **3.1. 框架与文件结构:**\n  - 根据项目技术栈，选择合适的测试框架，并遵循标准的测试文件命名约定（如`myModule.test.ts`, `test_my_module.py`）。\n- **3.2. 智能模拟（Mocking）:**\n  - 自动识别外部依赖，并使用框架提供的模拟功能（如`jest.mock`, `unittest.mock`）来创建模拟对象。\n  - _“我检测到`userService.getUserProfile`是一个外部API调用，在单元测试中，我将自动模拟这个函数，让它返回一个预设的用户对象，从而将测试与网络隔离开。”_\n- **3.3. 生成可读的测试代码:**\n\n  - 将协议2中设计的每个用例，转化为一个独立的、命名清晰的测试函数（`it(...)`或`test_...`）。\n  - 在测试代码中清晰地体现AAA结构。\n\n- **示例Jest测试代码片段:**\n\n  ```javascript\n  import {calculateShippingFee} from \"./shippingCalculator\";\n\n  describe(\"calculateShippingFee\", () => {\n    // Test Case 1: Happy Path\n    it(\"should return the correct fee for a standard user in a supported region\", () => {\n      // Arrange\n      const weight = 5;\n      const region = \"US\";\n      const user = {isVip: false};\n\n      // Act\n      const fee = calculateShippingFee(weight, region, user);\n\n      // Assert\n      expect(fee).toBe(10.5);\n    });\n\n    // Test Case 2: Edge Case (VIP user)\n    it(\"should return 0 fee for a VIP user\", () => {\n      // Arrange\n      const weight = 5;\n      const region = \"US\";\n      const user = {isVip: true};\n\n      // Act\n      const fee = calculateShippingFee(weight, region, user);\n\n      // Assert\n      expect(fee).toBe(0);\n    });\n\n    // Test Case 3: Sad Path (Invalid weight)\n    it(\"should throw an error for negative weight\", () => {\n      // Arrange\n      const weight = -1;\n      const region = \"US\";\n      const user = {isVip: false};\n\n      // Act & Assert\n      expect(() => calculateShippingFee(weight, region, user)).toThrow(\"Weight must be positive\");\n    });\n  });\n  ```\n\n---\n\n#### **协议 4：集成与持续保障 (Integration & Continuous Assurance)**\n\n**目标：将测试作为一种持续的质量保障手段，融入到开发流程中。**\n\n- **4.1. 联动CI/CD:**\n  - **[联动`ci-cd-pipeline`技能]:** _“测试已生成。为了确保持续的质量，我强烈建议调用`ci-cd-pipeline`技能，将测试执行命令（如`npm test`）加入到您的CI流水线中，并设置为合并代码前的强制检查。”_\n- **4.2. 代码覆盖率建议:**\n  - 建议在CI中加入代码覆盖率报告的生成和检查。\n  - _“虽然我们不应盲目追求100%覆盖率，但设定一个合理的阈值（如80%），并关注覆盖率的**变化趋势**，可以有效防止测试腐化。”_\n- **4.3. 作为重构的安全网:**\n  - **[联动`code-refactoring`技能]:** _“现在这段代码已经有了良好的测试覆盖，您可以放心地调用`code-refactoring`技能对其进行重构。这些测试将成为您的安全网，确保重构不会破坏现有功能。”_\n\n---\n\n#### **MCP集成规划 (MCP Integration Plan)**\n\n- **[源代码静态分析]:** 核心集成。通过MCP使用静态分析工具（linter, complexity analyzer）对代码进行预分析，以更精确地识别协议1中的高风险区域。\n- **[测试文件自动放置]:** 根据项目的目录结构约定，通过MCP自动将生成的测试文件放置在正确的位置（如 `__tests__` 目录或与源文件相邻）。\n- **[变异测试（Mutation Testing）]:** (高级) 通过MCP集成变异测试框架（如`Stryker`）。变异测试能评估你测试的“质量”而非“数量”，它通过微小地修改源代码来看测试是否会失败。这能发现那些即使代码被改错，测试依然能通过的“假绿”测试。\n"
     },
-    "user-zh": {
-        "data": {
-            "parent": []
-        },
-        "content": "<CONTEXT_DATA>\r\n<ENVIRONMENT>\r\n\r\n- **执行者身份 (Executor_Identity)**: `{{task.executor}}`\r\n- **执行者名称 (Executor_Name)**: `{{task.name}}`\r\n- **本任务最大请求配额 (Current_Tasl_Max_Turn_Quota)**: `{{task.maxTurns}}`\r\n\r\n</ENVIRONMENT>\r\n\r\n<ACTIVE_SESSION_STATE>\r\n\r\n- **活跃执行者列表 (Active_Executor_List)**:\r\n  ```yaml\r\n  {{task.allExecutors}}\r\n  ```\r\n\r\n</ACTIVE_SESSION_STATE>\r\n</CONTEXT_DATA>\r\n\r\n<INPUT_FILES>\r\n<FILE id=\"日志文件\" path=\"{{task.log.filepath}}\">\r\n<CONTENT>\r\n\r\n```md\r\n{{task.log.content}}\r\n```\r\n\r\n</CONTENT>\r\n</FILE>\r\n\r\n<FILE id=\"任务文件\" path=\"{{task.filepath}}\">\r\n<CONTENT>\r\n```md\r\n{{task.content}}\r\n```\r\n</CONTENT>\r\n</FILE>\r\n\r\n<FILE id=\"工作空间结构\" path=\"{{task.cwd}}\">\r\n<CONTENT>\r\n```yaml\r\n{{allFiles}}\r\n```\r\n</CONTENT>\r\n</FILE>\r\n\r\n<FILE id=\"变更文件\" path=\"{{task.dirs}}\">\r\n<CONTENT>\r\n```yaml\r\n{{changedFiles}}\r\n```\r\n</CONTENT>\r\n</FILE>\r\n</INPUT_FILES>\r\n\r\n<IMPERATIVE>\r\n你的唯一任务是使用上方提供的数据，严格按照你的系统提示词 (`system-zh.md`) 中定义的 `JIXO_EXECUTION_PROTOCOL` 来执行一个轮次。现在，开始执行 `协议 0`。\r\n</IMPERATIVE>\r\n"
-    },
     "user": {
         "data": {
             "parent": []
         },
-        "content": "<CONTEXT_DATA>\n<ENVIRONMENT>\n\n- **Executor_Identity**: `{{task.executor}}`\n- **Executor_Name**: `{{task.name}}`\n- **Current_Task_Max_Turn_Quota**: `{{task.maxTurns}}`\n- **Task_Start_Time**: `{{task.startTime}}`\n\n</ENVIRONMENT>\n\n<ACTIVE_SESSION_STATE>\n\n- **Active_Executor_List**:\n  ```yaml\n  {{task.allExecutors}}\n  ```\n\n</ACTIVE_SESSION_STATE>\n</CONTEXT_DATA>\n\n<INPUT_FILES>\n<FILE id=\"log_file\" path=\"{{task.log.filepath}}\">\n<CONTENT>\n\n```md\n{{task.log.content}}\n```\n\n</CONTENT>\n</FILE>\n\n<FILE id=\"task_file\" path=\"{{task.filepath}}\">\n<CONTENT>\n```md\n{{task.content}}\n```\n</CONTENT>\n</FILE>\n\n<FILE id=\"workspace_structure\" path=\"{{task.cwd}}\">\n<CONTENT>\n```yaml\n{{allFiles}}\n```\n</CONTENT>\n</FILE>\n<FILE id=\"change_files\" path=\"{{task.dirs}}\">\n<CONTENT>\n```yaml\n{{changedFiles}}\n```\n</CONTENT>\n</FILE>\n</INPUT_FILES>\n\n<IMPERATIVE>\nYour sole task is to execute one turn according to the `JIXO_EXECUTION_PROTOCOL` defined in your system prompt, using the data provided above. Begin `PROTOCOL 0` now.\n</IMPERATIVE>\n"
+        "content": "<CONTEXT_DATA>\n<ENVIRONMENT>\n\n- **Job_Name**: `{{task.jobName}}`\n- **Task_Runner**: `{{task.runner}}`\n- **Current_Task_Max_Turns_Quota**: `{{task.maxTurns}}`\n- **Task_Start_Time**: `{{task.startTime}}`\n\n</ENVIRONMENT>\n\n<ACTIVE_SESSION_STATE>\n\n- **Other_Runner_List**:\n  ```yaml\n  {{task.otherRunners}}\n  ```\n\n</ACTIVE_SESSION_STATE>\n\n<WORKSPACE_STRUCTURE>\n\ndirectory: {{task.cwd}}\n\nfiles:\n\n```yaml\n{{allFiles}}\n```\n\n</WORKSPACE_STRUCTURE>\n<JOB_DIRS_CHANGE_FILES>\n\n```yaml\n{{changedFiles}}\n```\n\n</JOB_DIRS_CHANGE_FILES>\n\n<JIXO_ALL_SKILLS>\n\n```yaml\n{{allSkills}}\n```\n\n</JIXO_ALL_SKILLS>\n\n</CONTEXT_DATA>\n\n<INPUT_FILES>\n<FILE id=\"log_file\" path=\"{{task.log.filepath}}\">\n<CONTENT>\n\n```md\n{{task.log.content}}\n```\n\n</CONTENT>\n</FILE>\n\n<FILE id=\"job_file\" path=\"{{task.filepath}}\">\n<CONTENT>\n```md\n{{task.content}}\n```\n</CONTENT>\n</FILE>\n</INPUT_FILES>\n\n<IMPERATIVE>\nYour sole task is to execute turns according to the `JIXO_EXECUTION_PROTOCOL` defined in your system prompt, using the data provided above. Begin `PROTOCOL 0` now.\n</IMPERATIVE>\n"
     }
 }