taskgraph-ai 0.54.7 → 0.54.12

package/dist/taskgraph.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{c as e}from"./src-xo9dUCIC.js";import t from"chalk";import{join as n}from"node:path";import r from"dotenv";function i(e,n=t){e.NO_COLOR&&e.FORCE_COLOR===void 0&&(e.FORCE_COLOR=`0`,n.level=0)}i(process.env);const a=process.cwd(),o=e();r.config({path:n(o,`.env`),quiet:!0}),process.env.TASKGRAPH_ORIGINAL_CWD=a,process.env.DEBUG===`1`&&console.error(`DEBUG - dev.js received args:`,process.argv.slice(2));const{runCLI:s}=await import(`./commands-BQrpRKx2.js`);s(process.argv);export{};
+import{c as e}from"./src-DRpuDe-k.js";import t from"chalk";import{join as n}from"node:path";import r from"dotenv";function i(e,n=t){e.NO_COLOR&&e.FORCE_COLOR===void 0&&(e.FORCE_COLOR=`0`,n.level=0)}i(process.env);const a=process.cwd(),o=e();r.config({path:n(o,`.env`),quiet:!0}),process.env.TASKGRAPH_ORIGINAL_CWD=a,process.env.DEBUG===`1`&&console.error(`DEBUG - dev.js received args:`,process.argv.slice(2));const{runCLI:s}=await import(`./commands-DJc5m0Gi.js`);s(process.argv);export{};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "taskgraph-ai",
-	"version": "0.54.7",
+	"version": "0.54.12",
 	"description": "Task management for AI-driven development, built for Claude Code: plan from a PRD, then work tasks one at a time with slash commands, a CLI or an MCP server.",
 	"type": "module",
 	"bin": {

package/dist/ai-services-unified-443pp39A.js

@@ -1 +0,0 @@
-export{r as logAiUsage}from"./ai-services-unified-C29ea2f8.js";

package/dist/ai-services-unified-C29ea2f8.js

@@ -1,3 +0,0 @@
-import{n as e}from"./rolldown-runtime-BxhE39jg.js";import{$ as t,D as n,G as r,M as i,S as a,X as o,at as s,b as c,d as l,h as u,i as d,m as f,o as p,p as m,u as h,v as g,x as _,y as v}from"./config-manager-CecOyMub.js";import y from"path";import{execSync as b}from"child_process";import x from"fs";import{createClaudeCode as S}from"ai-sdk-provider-claude-code";import*as C from"ai";import{jsonrepair as w}from"jsonrepair";import{EnvHttpProxyAgent as T}from"undici";const E=[`Read`,`Grep`,`Glob`];function D(e){let t=e,n=[];for(;;)try{return y.join(x.realpathSync(t),...n.reverse())}catch{let r=y.dirname(t);if(r===t)return e;n.push(y.basename(t)),t=r}}function O(e,t){if(typeof t!=`string`||t.startsWith(`~`))return!1;let n=D(y.resolve(e,t)),r=y.relative(e,n),i=r===`..`||r.startsWith(`..${y.sep}`);return r===``||!i&&!y.isAbsolute(r)}const k=/^(\.env(\..*)?|\.git|\.npmrc|id_(rsa|dsa|ecdsa|ed25519).*)$|\.pem$/i,A=/^\.env\.(example|sample|template)$/i;function j(e){return e.split(/[\\/,]/).map(e=>e.replace(/[*?[\]{}]/g,``)).some(e=>k.test(e)&&!A.test(e))}function ee(e,t){let n=y.resolve(e,t);return[n,D(n)].some(t=>j(y.relative(e,t)))}function M(e){return e.split(/[\\/]/).includes(`..`)}function N(e){if(!y.posix.isAbsolute(e)&&!y.win32.isAbsolute(e))return null;if(!/[*?[{]/.test(e)){let t=e.replace(/[\\/]+$/,``)||e;return y.win32.isAbsolute(t)&&!y.posix.isAbsolute(t)?y.win32.dirname(t):y.posix.dirname(t)}let t=e.split(/[*?[{]/)[0],n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`));return t.slice(0,n+1)||t}function P(e,t,n={}){if(!E.includes(t))return null;let r=[n.file_path,n.path].filter(e=>e!=null);for(let n of r){if(!O(e,n))return`${t} is limited to the project directory (${e}); ${n} is outside it.`;if(ee(e,n))return`${t} may not open secret files such as .env, .git or keys (${n}).`}if(typeof n.glob==`string`&&j(n.glob))return`${t} globs may not match secret files such as .env, .git or keys.`;let i=t===`Glob`?n.pattern:void 0;if(typeof i==`string`){let n=`${t} patterns may not leave the project directory (${e}).`;if(M(i)||i.startsWith(`~`))return n;if(j(i))return`${t} patterns may not match secret files such as .env, .git or keys.`;let r=N(i);if(r!==null&&!O(e,r))return n}return null}function F(e){let t=D(y.resolve(e));return{matcher:E.join(`|`),hooks:[async e=>{let n=P(t,e?.tool_name,e?.tool_input);return n?{hookSpecificOutput:{hookEventName:`PreToolUse`,permissionDecision:`deny`,permissionDecisionReason:n}}:{}}]}}const{JSONParseError:te,NoObjectGeneratedError:ne,generateObject:re,generateText:ie,streamObject:ae,streamText:oe,zodSchema:se}=C,I=C.jsonSchema,ce=/* @__PURE__ */ new Set([`minimum`,`maximum`,`exclusiveMinimum`,`exclusiveMaximum`]),L=[`additionalProperties`,`contains`,`if`,`then`,`else`,`not`,`propertyNames`],R=[`allOf`,`anyOf`,`oneOf`,`prefixItems`],z=[`definitions`,`$defs`,`dependentSchemas`,`patternProperties`,`properties`],B=e=>e?Array.isArray(e)?e.includes(`integer`):e===`integer`:!1,V=e=>{if(!e||typeof e!=`object`)return e;if(Array.isArray(e))return e.map(V);let t={...e};if(B(t.type))for(let e of ce)e in t&&delete t[e];for(let e of L)t[e]&&(t[e]=V(t[e]));for(let e of R)Array.isArray(t[e])&&(t[e]=t[e].map(V));for(let e of z)if(t[e]&&typeof t[e]==`object`){let n={};for(let[r,i]of Object.entries(t[e]))n[r]=V(i);t[e]=n}return t.items&&=V(t.items),t},H=e=>{let t=se(e);if(!t||typeof t!=`object`||!t.jsonSchema)return t;let n=V(t.jsonSchema);return typeof I==`function`?I(n,{validate:t.validate}):{...t,jsonSchema:n}};function U(){let e=Number(process.env.TASKGRAPH_AI_TIMEOUT_MS);return AbortSignal.timeout(Number.isFinite(e)&&e>0?e:6e5)}var W=class e{constructor(){if(this.constructor===e)throw Error(`BaseAIProvider cannot be instantiated directly`);this.name=this.constructor.name,this._proxyAgent=null,this.needsExplicitJsonSchema=!1,this.supportsTemperature=!0}validateAuth(e){if(!e.apiKey)throw Error(`${this.name} API key is required`)}createProxyFetch(){this._projectRoot||=r();let e=this._projectRoot;if(n(null,e))return this._proxyAgent||=new T,(e,t={})=>fetch(e,{...t,dispatcher:this._proxyAgent})}validateParams(e){if(this.validateAuth(e),!e.modelId)throw Error(`${this.name} Model ID is required`);this.validateOptionalParams(e)}validateOptionalParams(e){if(e.temperature!==void 0&&(e.temperature<0||e.temperature>1))throw Error(`Temperature must be between 0 and 1`);if(e.maxTokens!==void 0){let t=Number(e.maxTokens);if(!Number.isFinite(t)||t<=0)throw Error(`maxTokens must be a finite number greater than 0`)}}validateMessages(e){if(!e||!Array.isArray(e)||e.length===0)throw Error(`Invalid or empty messages array provided`);for(let t of e)if(!t.role||!t.content)throw Error(`Invalid message format. Each message must have role and content`)}handleError(e,n){let r=n.message||`Unknown error occurred`;throw t(`error`,`${this.name} ${e} failed: ${r}`,{error:n}),Error(`${this.name} API error during ${e}: ${r}`)}getClient(e){throw Error(`getClient must be implemented by provider`)}isRequiredApiKey(){return!0}getRequiredApiKeyName(){throw Error(`getRequiredApiKeyName must be implemented by provider`)}prepareTokenParam(e,t){return t===void 0?{}:{maxOutputTokens:Math.floor(Number(t))}}prepareMessages(e){let t=e.filter(e=>e.role===`system`);return t.length===0?{messages:e}:{instructions:t.map(e=>typeof e.content==`string`?e.content:e.content.map(e=>e.text??``).join(``)).join(`
-
-`),messages:e.filter(e=>e.role!==`system`)}}async generateText(e){try{this.validateParams(e),this.validateMessages(e.messages),t(`debug`,`Generating ${this.name} text with model: ${e.modelId}`);let n=await this.getClient(e),r=await ie({abortSignal:U(),model:n(e.modelId),...this.prepareMessages(e.messages),...this.prepareTokenParam(e.modelId,e.maxTokens),...this.supportsTemperature&&e.temperature!==void 0?{temperature:e.temperature}:{}});t(`debug`,`${this.name} generateText completed successfully for model: ${e.modelId}`);let i=r.usage?.inputTokens??r.usage?.promptTokens??0,a=r.usage?.outputTokens??r.usage?.completionTokens??0,o=r.usage?.totalTokens??i+a,s=r.usage?.inputTokenDetails?.cacheReadTokens??r.usage?.cachedInputTokens??0;return{text:r.text,usage:{inputTokens:i,outputTokens:a,totalTokens:o,cachedInputTokens:s}}}catch(e){this.handleError(`text generation`,e)}}async streamText(e){try{this.validateParams(e),this.validateMessages(e.messages),t(`debug`,`Streaming ${this.name} text with model: ${e.modelId}`);let n=await this.getClient(e),r=await oe({model:n(e.modelId),...this.prepareMessages(e.messages),...this.prepareTokenParam(e.modelId,e.maxTokens),...this.supportsTemperature&&e.temperature!==void 0?{temperature:e.temperature}:{},...e.experimental_transform&&{experimental_transform:e.experimental_transform}});return t(`debug`,`${this.name} streamText initiated successfully for model: ${e.modelId}`),r}catch(e){this.handleError(`text streaming`,e)}}async streamObject(e){try{if(this.validateParams(e),this.validateMessages(e.messages),!e.schema)throw Error(`Schema is required for object streaming`);t(`debug`,`Streaming ${this.name} object with model: ${e.modelId}`);let n=await this.getClient(e),r=H(e.schema),i=await ae({model:n(e.modelId),...this.prepareMessages(e.messages),schema:r,mode:this.needsExplicitJsonSchema?`json`:`auto`,...e.objectName&&{schemaName:e.objectName,schemaDescription:`Generate a valid JSON object for ${e.objectName}`},...this.prepareTokenParam(e.modelId,e.maxTokens),...this.supportsTemperature&&e.temperature!==void 0?{temperature:e.temperature}:{},onError:({error:e})=>t(`debug`,`${this.name} stream error: ${e?.message??e}`)});return t(`debug`,`${this.name} streamObject initiated successfully for model: ${e.modelId}`),i}catch(e){this.handleError(`object streaming`,e)}}async generateObject(e){try{if(this.validateParams(e),this.validateMessages(e.messages),!e.schema)throw Error(`Schema is required for object generation`);if(!e.objectName)throw Error(`Object name is required for object generation`);t(`debug`,`Generating ${this.name} object ('${e.objectName}') with model: ${e.modelId}`);let n=await this.getClient(e),r=H(e.schema),i=await re({abortSignal:U(),model:n(e.modelId),...this.prepareMessages(e.messages),schema:r,mode:this.needsExplicitJsonSchema?`json`:`auto`,schemaName:e.objectName,schemaDescription:`Generate a valid JSON object for ${e.objectName}`,...this.prepareTokenParam(e.modelId,e.maxTokens),...this.supportsTemperature&&e.temperature!==void 0?{temperature:e.temperature}:{}});t(`debug`,`${this.name} generateObject completed successfully for model: ${e.modelId}`);let a=i.usage?.inputTokens??i.usage?.promptTokens??0,o=i.usage?.outputTokens??i.usage?.completionTokens??0,s=i.usage?.totalTokens??a+o,c=i.usage?.inputTokenDetails?.cacheReadTokens??i.usage?.cachedInputTokens??0;return{object:i.object,usage:{inputTokens:a,outputTokens:o,totalTokens:s,cachedInputTokens:c}}}catch(e){if(ne.isInstance(e)&&e.cause instanceof te&&e.cause.text){t(`warn`,`${this.name} generated malformed JSON, attempting to repair...`);try{let n=w(e.cause.text),r=JSON.parse(n);return t(`debug`,`Successfully repaired ${this.name} JSON output`),{object:r,usage:{inputTokens:e.usage?.promptTokens||e.usage?.inputTokens||0,outputTokens:e.usage?.completionTokens||e.usage?.outputTokens||0,totalTokens:e.usage?.totalTokens||0}}}catch(e){t(`error`,`Failed to repair ${this.name} JSON: ${e.message}`)}}this.handleError(`object generation`,e)}}};let G=!1;const le=[`WebSearch`,`WebFetch`],ue=[`Read`,`Grep`,`Glob`],de=/^claude(\.exe|\.cmd)?$/i;function K(e,t){let n=y.relative(e,t);return n===``||n!==`..`&&!n.startsWith(`..${y.sep}`)&&!y.isAbsolute(n)}function fe(e,t){if(typeof e!=`string`||!y.isAbsolute(e)||!de.test(y.basename(e)))return!1;let n;try{n=x.realpathSync(e)}catch{return!1}if(!t)return!0;let r=y.resolve(t),i=r;try{i=x.realpathSync(r)}catch{}return!K(r,y.resolve(e))&&!K(i,n)}function pe(e,n){let r=e.pathToClaudeCodeExecutable;if(r===void 0||fe(r,n))return e;t(`warn`,`Ignoring pathToClaudeCodeExecutable "${r}": it must be an absolute path to a file named claude outside the project`);let{pathToClaudeCodeExecutable:i,...a}=e;return a}function me(e,t,n){let r=e===`research`,i=r?le:n?ue:[];return{tools:[...i],allowedTools:[...i],permissionMode:`dontAsk`,permissionPrompts:`none`,strictMcpConfig:!0,mcpServers:{},settingSources:[],...r?{maxTurns:t.maxTurns??8}:{cwd:n??void 0,additionalDirectories:void 0,hooks:n?{PreToolUse:[F(n)]}:{}}}}var he=class extends W{constructor(){super(),this.name=`Claude Code`,this.supportedModels=_(`claude-code`),this.supportedModels.length===0&&t(`warn`,`No supported models found for claude-code provider. Check supported-models.json configuration.`),this.needsExplicitJsonSchema=!0,this.supportsTemperature=!1}getRequiredApiKeyName(){return`CLAUDE_CODE_API_KEY`}isRequiredApiKey(){return!1}validateAuth(e){if(process.env.NODE_ENV!==`test`&&!G&&!process.env.CLAUDE_CODE_OAUTH_TOKEN)try{b(`claude --version`,{stdio:`pipe`,timeout:1e3})}catch{t(`debug`,"No `claude` on PATH; using the Claude Code bundled with the Agent SDK")}finally{G=!0}}getClient(e={}){try{let n=e.projectRoot?y.resolve(e.projectRoot):null,r=pe(d(e.commandName)||{},n),i={...process.env};return process.env.CLAUDE_CODE_API_KEY?i.ANTHROPIC_API_KEY=process.env.CLAUDE_CODE_API_KEY:delete i.ANTHROPIC_API_KEY,S({defaultSettings:{systemPrompt:{type:`preset`,preset:`claude_code`},env:i,logger:{debug:e=>t(`debug`,e),info:e=>t(`debug`,e),warn:e=>t(`debug`,e),error:e=>t(`error`,e)},...r,...me(e.role,r,n)}})}catch(e){let t=String(e?.message||``);if(e?.code===`ENOENT`||/claude/i.test(t)){let t=/* @__PURE__ */ Error(`Claude Code CLI not available. Please install Claude Code CLI first. Original error: ${e.message}`);t.cause=e,this.handleError(`Claude Code CLI initialization`,t)}else this.handleError(`client initialization`,e)}}getSupportedModels(){return this.supportedModels}isModelSupported(e){return e?this.supportedModels.includes(String(e).toLowerCase()):!1}};let q=null;var J=class e{constructor(){this._providers=/* @__PURE__ */ new Map,this._initialized=!1}static getInstance(){return q||=new e,q}initialize(){return this._initialized||=!0,this}registerProvider(e,t,n={}){if(!e||typeof e!=`string`)throw Error(`Provider name must be a non-empty string`);if(!t)throw Error(`Provider instance is required`);if(typeof t.generateText!=`function`||typeof t.streamText!=`function`||typeof t.generateObject!=`function`)throw Error(`Provider must implement BaseAIProvider interface`);return this._providers.set(e,{instance:t,options:n,registeredAt:/* @__PURE__ */ new Date}),this}hasProvider(e){return this._providers.has(e)}getProvider(e){let t=this._providers.get(e);return t?t.instance:null}getAllProviders(){return new Map(this._providers)}unregisterProvider(e){return this._providers.has(e)?(this._providers.delete(e),!0):!1}reset(){this._providers.clear(),this._initialized=!1}};J.getInstance().initialize(),globalThis.AI_SDK_LOG_WARNINGS===void 0&&(globalThis.AI_SDK_LOG_WARNINGS=({warnings:e,provider:n,model:r})=>{for(let i of e){let e=i.message||i.feature||i.setting||i.type;t(`debug`,`AI SDK warning (${n??`?`}/${r??`?`}): ${e}`)}});const Y={"claude-code":new he};function X(e){if(Y[e])return Y[e];let n=J.getInstance();return n.hasProvider(e)?(t(`debug`,`Provider "${e}" found in dynamic registry`),n.getProvider(e)):null}function ge(e,n){let r={inputCost:0,outputCost:0,currency:`USD`,isUnknown:!1};if(!i||!i[e])return t(`warn`,`Provider "${e}" not found in MODEL_MAP. Cannot determine cost for model ${n}.`),{...r,isUnknown:!0};let a=i[e].find(e=>e.id===n);if(!a)return t(`debug`,`Model "${n}" not found under provider "${e}". Assuming unknown cost.`),{...r,isUnknown:!0};if(a.cost_per_1m_tokens===null)return t(`debug`,`Cost data is null for model "${n}" under provider "${e}". Pricing unknown.`),{...r,isUnknown:!0};if(a.cost_per_1m_tokens===void 0)return t(`debug`,`Cost data not found for model "${n}" under provider "${e}". Pricing unknown.`),{...r,isUnknown:!0};let o=a.cost_per_1m_tokens;return{inputCost:o.input||0,outputCost:o.output||0,currency:o.currency||`USD`,isUnknown:!1}}function _e(e,t,n,r){let i=(e||0)/1e6*n+(t||0)/1e6*r;return parseFloat(i.toFixed(6))}function ve(e){let n={currentTag:`master`,availableTags:[`master`]};try{return e?{currentTag:o(e)||`master`,availableTags:ye(e)}:n}catch(e){return p()&&t(`debug`,`Error getting tag information: ${e.message}`),n}}function ye(n){let r=[`master`];try{let t=e(`path`),i=e(`fs`),a=t.join(n,`.taskgraph`,`tasks`,`tasks.json`);if(!i.existsSync(a))return r;let o=JSON.parse(i.readFileSync(a,`utf8`));if(!o||typeof o!=`object`)return r;let s=Object.keys(o).filter(e=>be(o[e]));return s.length>0?s:r}catch(e){return p()&&t(`debug`,`Could not read tasks file for available tags: ${e.message}`),r}}function be(e){return e&&typeof e==`object`&&Array.isArray(e.tasks)}function xe(e){let t=e.message?.toLowerCase()||``;return e.name===`TimeoutError`||t.includes(`aborted`)?!1:t.includes(`rate limit`)||t.includes(`overloaded`)||t.includes(`service temporarily unavailable`)||t.includes(`timeout`)||t.includes(`network error`)||e.status===429||e.status>=500}function Se(e){try{if(e?.data?.error?.message)return e.data.error.message;if(e?.error?.message)return e.error.message;if(typeof e?.responseBody==`string`)try{let t=JSON.parse(e.responseBody);if(t?.error?.message)return t.error.message}catch{}return typeof e?.message==`string`&&e.message?e.message:typeof e==`string`?e:`An unknown AI service error occurred.`}catch{return`Failed to extract error message.`}}function Z(e,t){return{main:{provider:f(t),modelId:m(t)},research:{provider:v(t),modelId:g(t)},fallback:{provider:l(t),modelId:h(t)}}[e]||null}function Ce(e,t,n=null){let r=X(e);if(!r)throw Error(`Unknown provider '${e}' for API key resolution.`);let i=r.getRequiredApiKeyName();if(i===null)return null;let a=s(i,t,n);if(!r.isRequiredApiKey())return a||null;if(!a)throw Error(`Required API key ${i} for provider '${e}' is not set in environment, session, or .env file.`);return a}async function we(e,n,r,i,a,o){let s=0,c=n;for(;s<=2;)try{p()&&t(`info`,`Attempt ${s+1}/3 calling ${c} (Provider: ${i}, Model: ${a}, Role: ${o})`);let l=await e[n](r);return p()&&t(`info`,`${c} succeeded for role ${o} (Provider: ${i}) on attempt ${s+1}`),l}catch(e){if(t(`warn`,`Attempt ${s+1} failed for role ${o} (${c} / ${i}): ${e.message}`),xe(e)&&s<2){s++;let e=1e3*2**(s-1);t(`info`,`Something went wrong on the provider side. Retrying in ${e/1e3}s...`),await new Promise(t=>setTimeout(t,e))}else throw t(`error`,`Something went wrong on the provider side. Max retries reached for role ${o} (${c} / ${i}).`),e}throw Error(`Exhausted all retries for role ${o} (${c} / ${i})`)}async function Q(e,n){let{role:i,session:o,projectRoot:s,systemPrompt:l,prompt:d,schema:f,objectName:m,commandName:h,outputType:g,experimental_transform:_,...v}=n;p()&&t(`debug`,`${e}Service called`,{role:i,commandName:h,outputType:g,projectRoot:s});let y=s||r(),b=a(y),x;i===`main`?x=[`main`,`fallback`,`research`]:i===`research`?x=[`research`,`fallback`,`main`]:i===`fallback`?x=[`fallback`,`main`,`research`]:(t(`warn`,`Unknown initial role: ${i}. Defaulting to main -> fallback -> research sequence.`),x=[`main`,`fallback`,`research`]);let S=/* @__PURE__ */ new Set,C=null,w=`AI service call failed for all configured roles.`;for(let n of x){let r,i,a,s,p,x,T=null;try{t(`debug`,`New AI service call with role: ${n}`);let w=Z(n,y);if(!w){t(`error`,`Unknown role encountered in _unifiedServiceRunner: ${n}`),C||=/* @__PURE__ */ Error(`Unknown AI role specified: ${n}`);continue}if(r=w.provider,i=w.modelId,!r||!i){t(`warn`,`Skipping role '${n}': Provider or Model ID not configured.`),C||=/* @__PURE__ */ Error(`Configuration missing for role '${n}'. Provider: ${r}, Model: ${i}`);continue}if(S.has(`${r}/${i}`)){t(`debug`,`Skipping role '${n}': ${r}/${i} already failed for this request.`);continue}if(p=X(r?.toLowerCase()),!p){t(`warn`,`Skipping role '${n}': Provider '${r}' not supported.`),C||=/* @__PURE__ */ Error(`Unsupported provider configured: ${r}`);continue}s=u(n,y),a=Ce(r?.toLowerCase(),o,y);let E=[],D=`${l} \n\n Always respond in ${c(y)}.`;if(E.push({role:`system`,content:D.trim()}),d)E.push({role:`user`,content:d});else throw Error(`User prompt content is missing.`);let O={apiKey:a,modelId:i,maxTokens:s.maxTokens,temperature:s.temperature,messages:E,...(e===`generateObject`||e===`streamObject`)&&{schema:f,objectName:m},role:n,projectRoot:y,...h&&{commandName:h},..._&&{experimental_transform:_},...v};if(x=await we(p,e,O,r,i,n),b&&x&&x.usage)try{T=await $({userId:b,commandName:h,providerName:r,modelId:i,inputTokens:x.usage.inputTokens,outputTokens:x.usage.outputTokens,cachedInputTokens:x.usage.cachedInputTokens,outputType:g})}catch{}else b&&x&&!x.usage&&t(`warn`,`Cannot log telemetry for ${h} (${r}/${i}): AI result missing 'usage' data. (May be expected for streams)`);let k;e===`generateText`?k=x.text:e===`generateObject`?k=x.object:(e===`streamText`||e===`streamObject`||t(`error`,`Unknown serviceType in _unifiedServiceRunner: ${e}`),k=x);let A=ve(y);return{mainResult:k,telemetryData:T,tagInfo:A,providerName:r,modelId:i}}catch(a){let o=Se(a);if(t(`error`,`Service call failed for role ${n} (Provider: ${r||`unknown`}, Model: ${i||`unknown`}): ${o}`),C=a,w=o,r&&i&&S.add(`${r}/${i}`),e===`generateObject`){let e=o.toLowerCase();if(e.includes(`no endpoints found that support tool use`)||e.includes(`does not support tool_use`)||e.includes(`tool use is not supported`)||e.includes(`tools are not supported`)||e.includes(`function calling is not supported`)||e.includes(`tool use is not supported`)){let e=`Model '${i||`unknown`}' via provider '${r||`unknown`}' does not support the 'tool use' required by generateObjectService. Please configure a model that supports tool/function calling for the '${n}' role, or use generateTextService if structured output is not strictly required.`;throw t(`error`,`[Tool Support Error] ${e}`),Error(e)}}}}throw t(`error`,`All roles in the sequence [${x.join(`, `)}] failed.`),Error(w)}async function Te(e){return Q(`generateText`,{outputType:`cli`,...e})}async function Ee(e){let t={outputType:`cli`,...e};if(!t.schema)throw Error(`streamObjectService requires a schema parameter`);return Q(`streamObject`,t)}async function De(e){return Q(`generateObject`,{objectName:`generated_object`,maxRetries:3,outputType:`cli`,...e})}async function $({userId:e,commandName:n,providerName:r,modelId:i,inputTokens:a,outputTokens:o,cachedInputTokens:s,outputType:c}){try{let c=(/* @__PURE__ */ new Date()).toISOString(),l=(a||0)+(o||0),{inputCost:u,outputCost:d,currency:f,isUnknown:m}=ge(r,i),h=_e(a,o,u,d),g={timestamp:c,userId:e,commandName:n,modelUsed:i,providerName:r,inputTokens:a||0,outputTokens:o||0,totalTokens:l,...s>0?{cachedInputTokens:s}:{},totalCost:h,currency:f,isUnknownCost:m};return p()&&t(`debug`,`AI Usage Telemetry:`,g),g}catch(e){return t(`error`,`Failed to log AI usage telemetry: ${e.message}`,{error:e}),null}}export{O as a,Ee as i,Te as n,$ as r,De as t};

package/dist/assets/scripts_README.md

@@ -1,443 +0,0 @@
-# Meta-Development Script
-
-This folder contains a **meta-development script** (`dev.js`) and related utilities that manage tasks for an AI-driven or traditional software development workflow. The script revolves around a `tasks.json` file, which holds an up-to-date list of development tasks.
-
-## Overview
-
-In an AI-driven development process—particularly with tools like [Cursor](https://www.cursor.so/)—it's beneficial to have a **single source of truth** for tasks. This script allows you to:
-
-1. **Parse** a PRD or requirements document (`.txt`) to initialize a set of tasks (`tasks.json`).
-2. **List** all existing tasks (IDs, statuses, titles).
-3. **Update** tasks to accommodate new prompts or architecture changes (useful if you discover "implementation drift").
-4. **Generate** individual task files (e.g., `task_001.txt`) for easy reference or to feed into an AI coding workflow.
-5. **Set task status**—mark tasks as `done`, `pending`, or `deferred` based on progress.
-6. **Expand** tasks with subtasks—break down complex tasks into smaller, more manageable subtasks.
-7. **Research-backed subtask generation**—use the research model to generate more informed and contextually relevant subtasks.
-8. **Clear subtasks**—remove subtasks from specified tasks to allow regeneration or restructuring.
-9. **Show task details**—display detailed information about a specific task and its subtasks.
-
-## Configuration (Updated)
-
-TaskGraph configuration is now managed through two primary methods:
-
-1.  **`.taskgraph/config.json` File (Project Root - Primary)**
-
-    - Stores AI model selections (`main`, `research`, `fallback`), model parameters (`maxTokens`, `temperature`), `logLevel`, `defaultSubtasks`, `defaultPriority`, `projectName`, etc.
-    - Managed using the `taskgraph models --setup` command or the `models` MCP tool.
-    - This is the main configuration file for most settings.
-
-2.  **Environment Variables (optional)**
-    - TaskGraph needs no provider API keys; AI calls run through your signed-in Claude Code.
-    - `CLAUDE_CODE_API_KEY` optionally bills calls to a specific Anthropic API key.
-    - See the Configuration page in the TaskGraph docs for the `TASKGRAPH_*` variables.
-
-**Important:** Settings like `MODEL`, `MAX_TOKENS`, `TEMPERATURE`, `TASKGRAPH_LOG_LEVEL`, etc., are **no longer set via `.env`**. Use `taskgraph models --setup` instead.
-
-## How It Works
-
-1. **`tasks.json`**:
-
-   - A JSON file at the project root containing an array of tasks (each with `id`, `title`, `description`, `status`, etc.).
-   - The `meta` field can store additional info like the project's name, version, or reference to the PRD.
-   - Tasks can have `subtasks` for more detailed implementation steps.
-   - Dependencies are displayed with status indicators (✅ for completed, ⏱️ for pending) to easily track progress.
-
-2. **CLI Commands**
-   You can run the commands via:
-
-   ```bash
-   # If installed globally
-   taskgraph [command] [options]
-
-   # If using locally within the project
-   node scripts/dev.js [command] [options]
-   ```
-
-   Available commands:
-
-   - `init`: Initialize a new project
-   - `parse-prd`: Generate tasks from a PRD document
-   - `list`: Display all tasks with their status
-   - `update`: Update tasks based on new information
-   - `generate`: Create individual task files
-   - `set-status`: Change a task's status
-   - `expand`: Add subtasks to a task or all tasks
-   - `clear-subtasks`: Remove subtasks from specified tasks
-   - `next`: Determine the next task to work on based on dependencies
-   - `show`: Display detailed information about a specific task
-   - `analyze-complexity`: Analyze task complexity and generate recommendations
-   - `complexity-report`: Display the complexity analysis in a readable format
-   - `add-dependency`: Add a dependency between tasks
-   - `remove-dependency`: Remove a dependency from a task
-   - `validate-dependencies`: Check for invalid dependencies
-   - `fix-dependencies`: Fix invalid dependencies automatically
-   - `add-task`: Add a new task using AI
-
-   Run `taskgraph --help` or `node scripts/dev.js --help` to see detailed usage information.
-
-## Listing Tasks
-
-The `list` command allows you to view all tasks and their status:
-
-```bash
-# List all tasks
-taskgraph list
-
-# List tasks with a specific status
-taskgraph list --status=pending
-
-# List tasks and include their subtasks
-taskgraph list --with-subtasks
-
-# List tasks with a specific status and include their subtasks
-taskgraph list --status=pending --with-subtasks
-```
-
-## Updating Tasks
-
-The `update` command allows you to update tasks based on new information or implementation changes:
-
-```bash
-# Update tasks starting from ID 4 with a new prompt
-taskgraph update --from=4 --prompt="Refactor tasks from ID 4 onward to use Express instead of Fastify"
-
-# Update all tasks (default from=1)
-taskgraph update --prompt="Add authentication to all relevant tasks"
-
-# Specify a different tasks file
-taskgraph update --file=custom-tasks.json --from=5 --prompt="Change database from MongoDB to PostgreSQL"
-```
-
-Notes:
-
-- The `--prompt` parameter is required and should explain the changes or new context
-- Only tasks that aren't marked as 'done' will be updated
-- Tasks with ID >= the specified --from value will be updated
-
-## Setting Task Status
-
-The `set-status` command allows you to change a task's status:
-
-```bash
-# Mark a task as done
-taskgraph set-status --id=3 --status=done
-
-# Mark a task as pending
-taskgraph set-status --id=4 --status=pending
-
-# Mark a specific subtask as done
-taskgraph set-status --id=3.1 --status=done
-
-# Mark multiple tasks at once
-taskgraph set-status --id=1,2,3 --status=done
-```
-
-Notes:
-
-- When marking a parent task as "done", all of its subtasks will automatically be marked as "done" as well
-- Common status values are 'done', 'pending', and 'deferred', but any string is accepted
-- You can specify multiple task IDs by separating them with commas
-- Subtask IDs are specified using the format `parentId.subtaskId` (e.g., `3.1`)
-- Dependencies are updated to show completion status (✅ for completed, ⏱️ for pending) throughout the system
-
-## Expanding Tasks
-
-The `expand` command allows you to break down tasks into subtasks for more detailed implementation:
-
-```bash
-# Expand a specific task with 3 subtasks (default)
-taskgraph expand --id=3
-
-# Expand a specific task with 5 subtasks
-taskgraph expand --id=3 --num=5
-
-# Expand a task with additional context
-taskgraph expand --id=3 --prompt="Focus on security aspects"
-
-# Expand all pending tasks that don't have subtasks
-taskgraph expand --all
-
-# Force regeneration of subtasks for all pending tasks
-taskgraph expand --all --force
-
-# Use the research model for research-backed subtask generation
-taskgraph expand --id=3 --research
-
-# Use the research model for research-backed generation on all pending tasks
-taskgraph expand --all --research
-```
-
-## Clearing Subtasks
-
-The `clear-subtasks` command allows you to remove subtasks from specified tasks:
-
-```bash
-# Clear subtasks from a specific task
-taskgraph clear-subtasks --id=3
-
-# Clear subtasks from multiple tasks
-taskgraph clear-subtasks --id=1,2,3
-
-# Clear subtasks from all tasks
-taskgraph clear-subtasks --all
-```
-
-Notes:
-
-- After clearing subtasks, task files are automatically regenerated
-- This is useful when you want to regenerate subtasks with a different approach
-- Can be combined with the `expand` command to immediately generate new subtasks
-- Works with both parent tasks and individual subtasks
-
-## AI Integration (Updated)
-
-- The script now uses a unified AI service layer (`ai-services-unified.js`).
-- Model selection (for example `opus`, `sonnet` or `haiku`) is determined by the configuration in `.taskgraph/config.json` based on the requested `role` (`main` or `research`).
-- No provider API keys are needed; calls run through your signed-in Claude Code.
-- To use the research capabilities (for example `expand --research`), configure a model for the `research` role with `taskgraph models --setup`.
-
-## Logging
-
-The script supports different logging levels controlled by the `TASKGRAPH_LOG_LEVEL` environment variable:
-
-- `debug`: Detailed information, typically useful for troubleshooting
-- `info`: Confirmation that things are working as expected (default)
-- `warn`: Warning messages that don't prevent execution
-- `error`: Error messages that might prevent execution
-
-When `DEBUG=true` is set, debug logs are also written to a `dev-debug.log` file in the project root.
-
-## Managing Task Dependencies
-
-The `add-dependency` and `remove-dependency` commands allow you to manage task dependencies:
-
-```bash
-# Add a dependency to a task
-taskgraph add-dependency --id=<id> --depends-on=<id>
-
-# Remove a dependency from a task
-taskgraph remove-dependency --id=<id> --depends-on=<id>
-```
-
-These commands:
-
-1. **Allow precise dependency management**:
-
-   - Add dependencies between tasks with automatic validation
-   - Remove dependencies when they're no longer needed
-   - Update task files automatically after changes
-
-2. **Include validation checks**:
-
-   - Prevent circular dependencies (a task depending on itself)
-   - Prevent duplicate dependencies
-   - Verify that both tasks exist before adding/removing dependencies
-   - Check if dependencies exist before attempting to remove them
-
-3. **Provide clear feedback**:
-
-   - Success messages confirm when dependencies are added/removed
-   - Error messages explain why operations failed (if applicable)
-
-4. **Automatically update task files**:
-   - Regenerates task files to reflect dependency changes
-   - Ensures tasks and their files stay synchronized
-
-## Dependency Validation and Fixing
-
-The script provides two specialized commands to ensure task dependencies remain valid and properly maintained:
-
-### Validating Dependencies
-
-The `validate-dependencies` command allows you to check for invalid dependencies without making changes:
-
-```bash
-# Check for invalid dependencies in tasks.json
-taskgraph validate-dependencies
-
-# Specify a different tasks file
-taskgraph validate-dependencies --file=custom-tasks.json
-```
-
-This command:
-
-- Scans all tasks and subtasks for non-existent dependencies
-- Identifies potential self-dependencies (tasks referencing themselves)
-- Reports all found issues without modifying files
-- Provides a comprehensive summary of dependency state
-- Gives detailed statistics on task dependencies
-
-Use this command to audit your task structure before applying fixes.
-
-### Fixing Dependencies
-
-The `fix-dependencies` command proactively finds and fixes all invalid dependencies:
-
-```bash
-# Find and fix all invalid dependencies
-taskgraph fix-dependencies
-
-# Specify a different tasks file
-taskgraph fix-dependencies --file=custom-tasks.json
-```
-
-This command:
-
-1. **Validates all dependencies** across tasks and subtasks
-2. **Automatically removes**:
-   - References to non-existent tasks and subtasks
-   - Self-dependencies (tasks depending on themselves)
-3. **Fixes issues in both**:
-   - The tasks.json data structure
-   - Individual task files during regeneration
-4. **Provides a detailed report**:
-   - Types of issues fixed (non-existent vs. self-dependencies)
-   - Number of tasks affected (tasks vs. subtasks)
-   - Where fixes were applied (tasks.json vs. task files)
-   - List of all individual fixes made
-
-This is especially useful when tasks have been deleted or IDs have changed, potentially breaking dependency chains.
-
-## Analyzing Task Complexity
-
-The `analyze-complexity` command allows you to automatically assess task complexity and generate expansion recommendations:
-
-```bash
-# Analyze all tasks and generate expansion recommendations
-taskgraph analyze-complexity
-
-# Specify a custom output file
-taskgraph analyze-complexity --output=custom-report.json
-
-# Override the model used for analysis
-taskgraph analyze-complexity --model=claude-3-opus-20240229
-
-# Set a custom complexity threshold (1-10)
-taskgraph analyze-complexity --threshold=6
-
-# Use the research model for research-backed complexity analysis
-taskgraph analyze-complexity --research
-```
-
-Notes:
-
-- The command uses Claude to analyze each task's complexity (or the research model with the --research flag)
-- Tasks are scored on a scale of 1-10
-- Each task receives a recommended number of subtasks based on DEFAULT_SUBTASKS configuration
-- The default output path is `scripts/task-complexity-report.json`
-- Each task in the analysis includes a ready-to-use `expansionCommand` that can be copied directly to the terminal or executed programmatically
-- Tasks with complexity scores below the threshold (default: 5) may not need expansion
-- The research flag provides more contextual and informed complexity assessments
-
-### Integration with Expand Command
-
-The `expand` command automatically checks for and uses complexity analysis if available:
-
-```bash
-# Expand a task, using complexity report recommendations if available
-taskgraph expand --id=8
-
-# Expand all tasks, prioritizing by complexity score if a report exists
-taskgraph expand --all
-
-# Override recommendations with explicit values
-taskgraph expand --id=8 --num=5 --prompt="Custom prompt"
-```
-
-When a complexity report exists:
-
-- The `expand` command will use the recommended subtask count from the report (unless overridden)
-- It will use the tailored expansion prompt from the report (unless a custom prompt is provided)
-- When using `--all`, tasks are sorted by complexity score (highest first)
-- The `--research` flag is preserved from the complexity analysis to expansion
-
-The output report structure is:
-
-```json
-{
-  "meta": {
-    "generatedAt": "2023-06-15T12:34:56.789Z",
-    "tasksAnalyzed": 20,
-    "thresholdScore": 5,
-    "projectName": "Your Project Name",
-    "usedResearch": true
-  },
-  "complexityAnalysis": [
-    {
-      "taskId": 8,
-      "taskTitle": "Develop Implementation Drift Handling",
-      "complexityScore": 9.5,
-      "recommendedSubtasks": 6,
-      "expansionPrompt": "Create subtasks that handle detecting...",
-      "reasoning": "This task requires sophisticated logic...",
-      "expansionCommand": "taskgraph expand --id=8 --num=6 --prompt=\"Create subtasks...\" --research"
-    }
-    // More tasks sorted by complexity score (highest first)
-  ]
-}
-```
-
-## Finding the Next Task
-
-The `next` command helps you determine which task to work on next based on dependencies and status:
-
-```bash
-# Show the next task to work on
-taskgraph next
-
-# Specify a different tasks file
-taskgraph next --file=custom-tasks.json
-```
-
-This command:
-
-1. Identifies all **eligible tasks** - pending or in-progress tasks whose dependencies are all satisfied (marked as done)
-2. **Prioritizes** these eligible tasks by:
-   - Priority level (high > medium > low)
-   - Number of dependencies (fewer dependencies first)
-   - Task ID (lower ID first)
-3. **Displays** comprehensive information about the selected task:
-   - Basic task details (ID, title, priority, dependencies)
-   - Detailed description and implementation details
-   - Subtasks if they exist
-4. Provides **contextual suggested actions**:
-   - Command to mark the task as in-progress
-   - Command to mark the task as done when completed
-   - Commands for working with subtasks (update status or expand)
-
-This feature ensures you're always working on the most appropriate task based on your project's current state and dependency structure.
-
-## Showing Task Details
-
-The `show` command allows you to view detailed information about a specific task:
-
-```bash
-# Show details for a specific task
-taskgraph show 1
-
-# Alternative syntax with --id option
-taskgraph show --id=1
-
-# Show details for a subtask
-taskgraph show --id=1.2
-
-# Specify a different tasks file
-taskgraph show 3 --file=custom-tasks.json
-```
-
-This command:
-
-1. **Displays comprehensive information** about the specified task:
-   - Basic task details (ID, title, priority, dependencies, status)
-   - Full description and implementation details
-   - Test strategy information
-   - Subtasks if they exist
-2. **Handles both regular tasks and subtasks**:
-   - For regular tasks, shows all subtasks and their status
-   - For subtasks, shows the parent task relationship
-3. **Provides contextual suggested actions**:
-   - Commands to update the task status
-   - Commands for working with subtasks
-   - For subtasks, provides a link to view the parent task
-
-This command is particularly useful when you need to examine a specific task in detail before implementing it or when you want to check the status and details of a particular task.