taskgraph-ai 0.54.13 → 0.54.22

package/README.md

@@ -265,7 +265,7 @@ In Claude Code, say `Change the main model to opus`, or run `taskgraph models --
 
 Projects created with Task Master, or with a TaskGraph release before 0.47, also need a few manual changes:
 
-- **Rename `.taskmaster/` to `.taskgraph/`** by hand. TaskGraph no longer detects the old folder.
+- **Import `.taskmaster/`** with `taskgraph init --from-taskmaster --yes`. It copies every tag, the docs and reports, and the settings that still apply, and leaves `.taskmaster/` in place. See [Migrating from Task Master](apps/docs/migrating-from-taskmaster.mdx).
 - **Rename environment variables:** `TASK_MASTER_*` and `TASKMASTER_*` are now `TASKGRAPH_*`. The old names are ignored.
 - **Removed:** the `taskgraph migrate` command and `.taskmasterconfig`. Configuration lives in `.taskgraph/config.json`; run `taskgraph models --setup` to recreate it.
 - **Claude Code only:** other providers and their flags are gone, models are `opus`, `sonnet` and `haiku`, and the only API key still read is the optional `CLAUDE_CODE_API_KEY`.

package/dist/{ai-services-unified-CKKHbOMd.js → ai-services-unified-B45jIPar.js}

@@ -1,3 +1,3 @@
-import{n as e}from"./rolldown-runtime-BxhE39jg.js";import{B as t}from"./src-Cs4ilbQ-.js";import{$ as n,D as r,G as i,M as a,S as o,X as s,at as c,b as l,d as u,h as d,i as f,m as p,o as m,p as h,u as g,v as _,x as v,y}from"./config-manager-DIET_FiX.js";import b from"path";import{execSync as x}from"child_process";import S from"fs";import{createClaudeCode as C}from"ai-sdk-provider-claude-code";import*as w from"ai";import{jsonrepair as T}from"jsonrepair";import{EnvHttpProxyAgent as E}from"undici";const D=[`Read`,`Grep`,`Glob`];function O(e){let t=e,n=[];for(;;)try{return b.join(S.realpathSync(t),...n.reverse())}catch{let r=b.dirname(t);if(r===t)return e;n.push(b.basename(t)),t=r}}function k(e,t){if(typeof t!=`string`||t.startsWith(`~`))return!1;let n=O(b.resolve(e,t)),r=b.relative(e,n),i=r===`..`||r.startsWith(`..${b.sep}`);return r===``||!i&&!b.isAbsolute(r)}const A=/^(\.env(\..*)?|\.git|\.npmrc|id_(rsa|dsa|ecdsa|ed25519).*)$|\.pem$/i,ee=/^\.env\.(example|sample|template)$/i;function j(e){return e.split(/[\\/,]/).map(e=>e.replace(/[*?[\]{}]/g,``)).some(e=>A.test(e)&&!ee.test(e))}function M(e,t){let n=b.resolve(e,t);return[n,O(n)].some(t=>j(b.relative(e,t)))}function N(e){return e.split(/[\\/]/).includes(`..`)}function P(e){if(!b.posix.isAbsolute(e)&&!b.win32.isAbsolute(e))return null;if(!/[*?[{]/.test(e)){let t=e.replace(/[\\/]+$/,``)||e;return b.win32.isAbsolute(t)&&!b.posix.isAbsolute(t)?b.win32.dirname(t):b.posix.dirname(t)}let t=e.split(/[*?[{]/)[0],n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`));return t.slice(0,n+1)||t}function te(e,t,n={}){if(!D.includes(t))return null;let r=[n.file_path,n.path].filter(e=>e!=null);for(let n of r){if(!k(e,n))return`${t} is limited to the project directory (${e}); ${n} is outside it.`;if(M(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(N(i)||i.startsWith(`~`))return n;if(j(i))return`${t} patterns may not match secret files such as .env, .git or keys.`;let r=P(i);if(r!==null&&!k(e,r))return n}return null}function ne(e){let t=O(b.resolve(e));return{matcher:D.join(`|`),hooks:[async e=>{let n=te(t,e?.tool_name,e?.tool_input);return n?{hookSpecificOutput:{hookEventName:`PreToolUse`,permissionDecision:`deny`,permissionDecisionReason:n}}:{}}]}}const{JSONParseError:re,NoObjectGeneratedError:ie,generateObject:ae,generateText:oe,streamObject:se,streamText:ce,zodSchema:le}=w,F=w.jsonSchema,I=/* @__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 I)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=le(e);if(!t||typeof t!=`object`||!t.jsonSchema)return t;let n=V(t.jsonSchema);return typeof F==`function`?F(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||=i();let e=this._projectRoot;if(r(null,e))return this._proxyAgent||=new E,(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,t){let r=t.message||`Unknown error occurred`;throw n(`error`,`${this.name} ${e} failed: ${r}`,{error:t}),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(`
+import{n as e}from"./rolldown-runtime-BxhE39jg.js";import{Y as t}from"./src-BQZsjzA5.js";import{$ as n,D as r,G as i,M as a,S as o,X as s,at as c,b as l,d as u,h as d,i as f,m as p,o as m,p as h,u as g,v as _,x as v,y}from"./config-manager-DTkRerDn.js";import b from"path";import{execSync as x}from"child_process";import S from"fs";import{createClaudeCode as C}from"ai-sdk-provider-claude-code";import*as w from"ai";import{jsonrepair as T}from"jsonrepair";import{EnvHttpProxyAgent as E}from"undici";const D=[`Read`,`Grep`,`Glob`];function O(e){let t=e,n=[];for(;;)try{return b.join(S.realpathSync(t),...n.reverse())}catch{let r=b.dirname(t);if(r===t)return e;n.push(b.basename(t)),t=r}}function k(e,t){if(typeof t!=`string`||t.startsWith(`~`))return!1;let n=O(b.resolve(e,t)),r=b.relative(e,n),i=r===`..`||r.startsWith(`..${b.sep}`);return r===``||!i&&!b.isAbsolute(r)}const A=/^(\.env(\..*)?|\.git|\.npmrc|id_(rsa|dsa|ecdsa|ed25519).*)$|\.pem$/i,ee=/^\.env\.(example|sample|template)$/i;function j(e){return e.split(/[\\/,]/).map(e=>e.replace(/[*?[\]{}]/g,``)).some(e=>A.test(e)&&!ee.test(e))}function M(e,t){let n=b.resolve(e,t);return[n,O(n)].some(t=>j(b.relative(e,t)))}function N(e){return e.split(/[\\/]/).includes(`..`)}function P(e){if(!b.posix.isAbsolute(e)&&!b.win32.isAbsolute(e))return null;if(!/[*?[{]/.test(e)){let t=e.replace(/[\\/]+$/,``)||e;return b.win32.isAbsolute(t)&&!b.posix.isAbsolute(t)?b.win32.dirname(t):b.posix.dirname(t)}let t=e.split(/[*?[{]/)[0],n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`));return t.slice(0,n+1)||t}function te(e,t,n={}){if(!D.includes(t))return null;let r=[n.file_path,n.path].filter(e=>e!=null);for(let n of r){if(!k(e,n))return`${t} is limited to the project directory (${e}); ${n} is outside it.`;if(M(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(N(i)||i.startsWith(`~`))return n;if(j(i))return`${t} patterns may not match secret files such as .env, .git or keys.`;let r=P(i);if(r!==null&&!k(e,r))return n}return null}function ne(e){let t=O(b.resolve(e));return{matcher:D.join(`|`),hooks:[async e=>{let n=te(t,e?.tool_name,e?.tool_input);return n?{hookSpecificOutput:{hookEventName:`PreToolUse`,permissionDecision:`deny`,permissionDecisionReason:n}}:{}}]}}const{JSONParseError:re,NoObjectGeneratedError:ie,generateObject:ae,generateText:oe,streamObject:se,streamText:ce,zodSchema:le}=w,F=w.jsonSchema,I=/* @__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 I)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=le(e);if(!t||typeof t!=`object`||!t.jsonSchema)return t;let n=V(t.jsonSchema);return typeof F==`function`?F(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||=i();let e=this._projectRoot;if(r(null,e))return this._proxyAgent||=new E,(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,t){let r=t.message||`Unknown error occurred`;throw n(`error`,`${this.name} ${e} failed: ${r}`,{error:t}),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),n(`debug`,`Generating ${this.name} text with model: ${e.modelId}`);let t=await this.getClient(e),r=await oe({abortSignal:U(),model:t(e.modelId),...this.prepareMessages(e.messages),...this.prepareTokenParam(e.modelId,e.maxTokens),...this.supportsTemperature&&e.temperature!==void 0?{temperature:e.temperature}:{}});n(`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),n(`debug`,`Streaming ${this.name} text with model: ${e.modelId}`);let t=await this.getClient(e),r=await ce({model:t(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 n(`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`);n(`debug`,`Streaming ${this.name} object with model: ${e.modelId}`);let t=await this.getClient(e),r=H(e.schema),i=await se({model:t(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})=>n(`debug`,`${this.name} stream error: ${e?.message??e}`)});return n(`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`);n(`debug`,`Generating ${this.name} object ('${e.objectName}') with model: ${e.modelId}`);let t=await this.getClient(e),r=H(e.schema),i=await ae({abortSignal:U(),model:t(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}:{}});n(`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(ie.isInstance(e)&&e.cause instanceof re&&e.cause.text){n(`warn`,`${this.name} generated malformed JSON, attempting to repair...`);try{let t=T(e.cause.text),r=JSON.parse(t);return n(`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){n(`error`,`Failed to repair ${this.name} JSON: ${e.message}`)}}this.handleError(`object generation`,e)}}};let G=!1;const ue=[`WebSearch`,`WebFetch`],de=[`Read`,`Grep`,`Glob`],fe=/^claude(\.exe|\.cmd)?$/i;function K(e,t){let n=b.relative(e,t);return n===``||n!==`..`&&!n.startsWith(`..${b.sep}`)&&!b.isAbsolute(n)}function pe(e,t){if(typeof e!=`string`||!b.isAbsolute(e)||!fe.test(b.basename(e)))return!1;let n;try{n=S.realpathSync(e)}catch{return!1}if(!t)return!0;let r=b.resolve(t),i=r;try{i=S.realpathSync(r)}catch{}return!K(r,b.resolve(e))&&!K(i,n)}function me(e,t){let r=e.pathToClaudeCodeExecutable;if(r===void 0||pe(r,t))return e;n(`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 he(e,t,n){let r=e===`research`,i=r?ue:n?de:[];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:[ne(n)]}:{}}}}var ge=class extends W{constructor(){super(),this.name=`Claude Code`,this.supportedModels=v(`claude-code`),this.supportedModels.length===0&&n(`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{x(`claude --version`,{stdio:`pipe`,timeout:1e3})}catch{n(`debug`,"No `claude` on PATH; using the Claude Code bundled with the Agent SDK")}finally{G=!0}}getClient(e={}){try{let r=e.projectRoot?b.resolve(e.projectRoot):null,i=me(f(e.commandName)||{},r),a=r?t(r):{...process.env},o=a.CLAUDE_CODE_API_KEY;return o?a.ANTHROPIC_API_KEY=o:delete a.ANTHROPIC_API_KEY,C({defaultSettings:{systemPrompt:{type:`preset`,preset:`claude_code`},env:a,logger:{debug:e=>n(`debug`,e),info:e=>n(`debug`,e),warn:e=>n(`debug`,e),error:e=>n(`error`,e)},...i,...he(e.role,i,r)}})}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:t,model:r})=>{for(let i of e){let e=i.message||i.feature||i.setting||i.type;n(`debug`,`AI SDK warning (${t??`?`}/${r??`?`}): ${e}`)}});const Y={"claude-code":new ge};function X(e){if(Y[e])return Y[e];let t=J.getInstance();return t.hasProvider(e)?(n(`debug`,`Provider "${e}" found in dynamic registry`),t.getProvider(e)):null}function _e(e,t){let r={inputCost:0,outputCost:0,currency:`USD`,isUnknown:!1};if(!a||!a[e])return n(`warn`,`Provider "${e}" not found in MODEL_MAP. Cannot determine cost for model ${t}.`),{...r,isUnknown:!0};let i=a[e].find(e=>e.id===t);if(!i)return n(`debug`,`Model "${t}" not found under provider "${e}". Assuming unknown cost.`),{...r,isUnknown:!0};if(i.cost_per_1m_tokens===null)return n(`debug`,`Cost data is null for model "${t}" under provider "${e}". Pricing unknown.`),{...r,isUnknown:!0};if(i.cost_per_1m_tokens===void 0)return n(`debug`,`Cost data not found for model "${t}" under provider "${e}". Pricing unknown.`),{...r,isUnknown:!0};let o=i.cost_per_1m_tokens;return{inputCost:o.input||0,outputCost:o.output||0,currency:o.currency||`USD`,isUnknown:!1}}function ve(e,t,n,r){let i=(e||0)/1e6*n+(t||0)/1e6*r;return parseFloat(i.toFixed(6))}function ye(e){let t={currentTag:`master`,availableTags:[`master`]};try{return e?{currentTag:s(e)||`master`,availableTags:be(e)}:t}catch(e){return m()&&n(`debug`,`Error getting tag information: ${e.message}`),t}}function be(t){let r=[`master`];try{let n=e(`path`),i=e(`fs`),a=n.join(t,`.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=>xe(o[e]));return s.length>0?s:r}catch(e){return m()&&n(`debug`,`Could not read tasks file for available tags: ${e.message}`),r}}function xe(e){return e&&typeof e==`object`&&Array.isArray(e.tasks)}function Se(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 Z(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 Ce(e,t){return{main:{provider:p(t),modelId:h(t)},research:{provider:y(t),modelId:_(t)},fallback:{provider:u(t),modelId:g(t)}}[e]||null}function we(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=c(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 Te(e,t,r,i,a,o){let s=0,c=t;for(;s<=2;)try{m()&&n(`info`,`Attempt ${s+1}/3 calling ${c} (Provider: ${i}, Model: ${a}, Role: ${o})`);let l=await e[t](r);return m()&&n(`info`,`${c} succeeded for role ${o} (Provider: ${i}) on attempt ${s+1}`),l}catch(e){if(n(`warn`,`Attempt ${s+1} failed for role ${o} (${c} / ${i}): ${e.message}`),Se(e)&&s<2){s++;let e=1e3*2**(s-1);n(`info`,`Something went wrong on the provider side. Retrying in ${e/1e3}s...`),await new Promise(t=>setTimeout(t,e))}else throw n(`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,t){let{role:r,session:a,projectRoot:s,systemPrompt:c,prompt:u,schema:f,objectName:p,commandName:h,outputType:g,experimental_transform:_,...v}=t;m()&&n(`debug`,`${e}Service called`,{role:r,commandName:h,outputType:g,projectRoot:s});let y=s||i(),b=o(y),x;r===`main`?x=[`main`,`fallback`,`research`]:r===`research`?x=[`research`,`fallback`,`main`]:r===`fallback`?x=[`fallback`,`main`,`research`]:(n(`warn`,`Unknown initial role: ${r}. 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 t of x){let r,i,o,s,m,x,T=null;try{n(`debug`,`New AI service call with role: ${t}`);let w=Ce(t,y);if(!w){n(`error`,`Unknown role encountered in _unifiedServiceRunner: ${t}`),C||=/* @__PURE__ */ Error(`Unknown AI role specified: ${t}`);continue}if(r=w.provider,i=w.modelId,!r||!i){n(`warn`,`Skipping role '${t}': Provider or Model ID not configured.`),C||=/* @__PURE__ */ Error(`Configuration missing for role '${t}'. Provider: ${r}, Model: ${i}`);continue}if(S.has(`${r}/${i}`)){n(`debug`,`Skipping role '${t}': ${r}/${i} already failed for this request.`);continue}if(m=X(r?.toLowerCase()),!m){n(`warn`,`Skipping role '${t}': Provider '${r}' not supported.`),C||=/* @__PURE__ */ Error(`Unsupported provider configured: ${r}`);continue}s=d(t,y),o=we(r?.toLowerCase(),a,y);let E=[],D=`${c} \n\n Always respond in ${l(y)}.`;if(E.push({role:`system`,content:D.trim()}),u)E.push({role:`user`,content:u});else throw Error(`User prompt content is missing.`);let O={apiKey:o,modelId:i,maxTokens:s.maxTokens,temperature:s.temperature,messages:E,...(e===`generateObject`||e===`streamObject`)&&{schema:f,objectName:p},role:t,projectRoot:y,...h&&{commandName:h},..._&&{experimental_transform:_},...v};if(x=await Te(m,e,O,r,i,t),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&&n(`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`||n(`error`,`Unknown serviceType in _unifiedServiceRunner: ${e}`),k=x);let A=ye(y);return{mainResult:k,telemetryData:T,tagInfo:A,providerName:r,modelId:i}}catch(a){let o=Z(a);if(n(`error`,`Service call failed for role ${t} (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 '${t}' role, or use generateTextService if structured output is not strictly required.`;throw n(`error`,`[Tool Support Error] ${e}`),Error(e)}}}}throw n(`error`,`All roles in the sequence [${x.join(`, `)}] failed.`),Error(w)}async function Ee(e){return Q(`generateText`,{outputType:`cli`,...e})}async function De(e){let t={outputType:`cli`,...e};if(!t.schema)throw Error(`streamObjectService requires a schema parameter`);return Q(`streamObject`,t)}async function Oe(e){return Q(`generateObject`,{objectName:`generated_object`,maxRetries:3,outputType:`cli`,...e})}async function $({userId:e,commandName:t,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:p}=_e(r,i),h=ve(a,o,u,d),g={timestamp:c,userId:e,commandName:t,modelUsed:i,providerName:r,inputTokens:a||0,outputTokens:o||0,totalTokens:l,...s>0?{cachedInputTokens:s}:{},totalCost:h,currency:f,isUnknownCost:p};return m()&&n(`debug`,`AI Usage Telemetry:`,g),g}catch(e){return n(`error`,`Failed to log AI usage telemetry: ${e.message}`,{error:e}),null}}export{k as a,De as i,Ee as n,$ as r,Oe as t};

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

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

package/dist/assets/AGENTS.md

@@ -1,433 +1,13 @@
-# TaskGraph - Agent Integration Guide
+# TaskGraph
 
-## Essential Commands
+This project tracks work in TaskGraph. Run `taskgraph prime` for the task in progress, what's ready next, and the workflow rules; follow those rules. A Claude Code session with the TaskGraph plugin gets this at startup.
 
-### Core Workflow Commands
+## Daily commands
 
-```bash
-# Project Setup
-taskgraph init                                    # Initialize TaskGraph in current project
-taskgraph parse-prd .taskgraph/docs/prd.md       # Generate tasks from PRD document
-taskgraph models --setup                        # Configure AI models interactively
+- `taskgraph next`: the next task to work on
+- `taskgraph show <id>`: one task in detail (`3`, or a subtask like `3.2`)
+- `taskgraph list`: all tasks, filtered by `--status` or `--tag`
+- `taskgraph set-status --id=<id> --status=in-progress`: claim a task (`--status=done` when finished)
+- `taskgraph add-task --prompt="<what>"`: add a task
 
-# Daily Development Workflow
-taskgraph list                                   # Show all tasks with status
-taskgraph next                                   # Get next available task to work on
-taskgraph show <id>                             # View detailed task information (e.g., taskgraph show 1.2)
-taskgraph set-status --id=<id> --status=done    # Mark task complete
-
-# Task Management
-taskgraph add-task --prompt="description" --research        # Add new task with AI assistance
-taskgraph expand --id=<id> --research --force              # Break task into subtasks
-taskgraph update-task --id=<id> --prompt="changes"         # Update specific task
-taskgraph update --from=<id> --prompt="changes"            # Update multiple tasks from ID onwards
-taskgraph update-subtask --id=<id> --prompt="notes"        # Add implementation notes to subtask
-
-# Analysis & Planning
-taskgraph analyze-complexity --research          # Analyze task complexity
-taskgraph complexity-report                      # View complexity analysis
-taskgraph expand --all --research               # Expand all eligible tasks
-
-# Dependencies & Organization
-taskgraph add-dependency --id=<id> --depends-on=<id>       # Add task dependency
-taskgraph move --from=<id> --to=<id>                       # Reorganize task hierarchy
-taskgraph validate-dependencies                            # Check for dependency issues
-taskgraph generate                                         # Update task markdown files (usually auto-called)
-```
-
-## Key Files & Project Structure
-
-### Core Files
-
-- `.taskgraph/tasks/tasks.json` - Main task data file (auto-managed)
-- `.taskgraph/config.json` - AI model configuration (use `taskgraph models` to modify)
-- `.taskgraph/docs/prd.md` - Product Requirements Document for parsing (`.md` extension recommended for better editor support)
-- `.taskgraph/tasks/*.txt` - Individual task files (auto-generated from tasks.json)
-- `.env` - Optional environment variables (for example `CLAUDE_CODE_API_KEY`)
-
-**PRD File Format:** While both `.txt` and `.md` extensions work, **`.md` is recommended** because:
-- Markdown syntax highlighting in editors improves readability
-- Proper rendering when previewing in VS Code, GitHub, or other tools
-- Better collaboration through formatted documentation
-
-### Claude Code Integration Files
-
-- `CLAUDE.md` - Auto-loaded context for Claude Code (this file)
-- `.claude/settings.json` - Claude Code tool allowlist and preferences
-- `.claude/commands/` - Custom slash commands for repeated workflows
-- `.mcp.json` - MCP server configuration (project-specific)
-
-### Directory Structure
-
-```
-project/
-├── .taskgraph/
-│   ├── tasks/              # Task files directory
-│   │   ├── tasks.json      # Main task database
-│   │   ├── task-1.md      # Individual task files
-│   │   └── task-2.md
-│   ├── docs/              # Documentation directory
-│   │   ├── prd.md         # Product requirements (.md recommended)
-│   ├── reports/           # Analysis reports directory
-│   │   └── task-complexity-report.json
-│   ├── templates/         # Template files
-│   │   └── example_prd.md  # Example PRD template (.md recommended)
-│   └── config.json        # AI models & settings
-├── .claude/
-│   ├── settings.json      # Claude Code configuration
-│   └── commands/         # Custom slash commands
-├── .env                  # Optional env vars
-├── .mcp.json            # MCP configuration
-└── CLAUDE.md            # This file - auto-loaded by Claude Code
-```
-
-## Slash Commands & CLI (Preferred)
-
-Use slash commands or the `taskgraph` CLI first. They need no MCP server and load no extra tool definitions into context. Only fall back to the MCP tools below when a command you need has no slash command or CLI equivalent.
-
-With the TaskGraph plugin installed (`/plugin marketplace add stephennmiller/taskgraph-ai`, then `/plugin install taskgraph@taskgraph`), the slash commands live under `/taskgraph:` (type `/taskgraph` to list them). `taskgraph init` does not write slash commands:
-
-| Task | Slash command | CLI |
-|------|---------------|-----|
-| Find next task | `/taskgraph:next-task` | `taskgraph next` |
-| View a task | `/taskgraph:show-task <id>` | `taskgraph show <id>` |
-| List tasks | `/taskgraph:list-tasks` | `taskgraph list` |
-| Parse a PRD | `/taskgraph:parse-prd` | `taskgraph parse-prd <file>` |
-| Add a task | `/taskgraph:add-task` | `taskgraph add-task --prompt="..."` |
-| Break into subtasks | `/taskgraph:expand-task <id>` | `taskgraph expand --id=<id>` |
-| Change status | `/taskgraph:set-status <id> <status>`, or the shortcuts `/taskgraph:to-in-progress <id>` and `/taskgraph:to-done <id>` | `taskgraph set-status --id=<id> --status=<status>` |
-| Update a task | `/taskgraph:update-task <id>` | `taskgraph update-task --id=<id> --prompt="..."` |
-| Check complexity | `/taskgraph:analyze-complexity` | `taskgraph analyze-complexity` |
-
-## MCP Integration (Optional)
-
-TaskGraph also provides an MCP server that Claude Code can connect to. It is optional; the slash commands and CLI above cover the same workflow. To use it, configure `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "taskgraph-ai": {
-      "command": "npx",
-      "args": ["-y", "taskgraph-ai"],
-      "env": {
-        "TASKGRAPH_TOOLS": "core"
-      }
-    }
-  }
-}
-```
-
-### MCP Tool Tiers
-
-Default: `core` (7 tools). Set via `TASKGRAPH_TOOLS` env var.
-
-| Tier | Count | Tools |
-|------|-------|-------|
-| `core` | 7 | `get_tasks`, `next_task`, `get_task`, `set_task_status`, `update_subtask`, `parse_prd`, `expand_task` |
-| `standard` | 15 | core + `initialize_project`, `analyze_project_complexity`, `expand_all`, `add_subtask`, `remove_task`, `add_task`, `complexity_report`, `dependency_analysis` |
-| `all` | 46 | standard + dependencies, tags, research, autopilot, scoping, models |
-
-**Upgrade when tool unavailable:** Edit MCP config, change `TASKGRAPH_TOOLS` from `"core"` to `"standard"` or `"all"`, restart MCP.
-
-### Essential MCP Tools
-
-```javascript
-// Project setup
-initialize_project; // = taskgraph init
-parse_prd; // = taskgraph parse-prd
-
-// Daily workflow
-get_tasks; // = taskgraph list
-next_task; // = taskgraph next
-get_task; // = taskgraph show <id>
-set_task_status; // = taskgraph set-status
-
-// Task management
-add_task; // = taskgraph add-task
-expand_task; // = taskgraph expand
-update_task; // = taskgraph update-task
-update_subtask; // = taskgraph update-subtask
-update; // = taskgraph update
-
-// Analysis
-analyze_project_complexity; // = taskgraph analyze-complexity
-complexity_report; // = taskgraph complexity-report
-```
-
-## Claude Code Workflow Integration
-
-### Standard Development Workflow
-
-#### 1. Project Initialization
-
-```bash
-# Initialize TaskGraph
-taskgraph init
-
-# Create or obtain PRD, then parse it (use .md extension for better editor support)
-taskgraph parse-prd .taskgraph/docs/prd.md
-
-# Analyze complexity and expand tasks
-taskgraph analyze-complexity --research
-taskgraph expand --all --research
-```
-
-If tasks already exist, another PRD can be parsed (with new information only!) using parse-prd with --append flag. This will add the generated tasks to the existing list of tasks..
-
-#### 2. Daily Development Loop
-
-```bash
-# Start each session
-taskgraph next                           # Find next available task
-taskgraph show <id>                     # Review task details
-
-# During implementation, check in code context into the tasks and subtasks
-taskgraph update-subtask --id=<id> --prompt="implementation notes..."
-
-# Complete tasks
-taskgraph set-status --id=<id> --status=done
-```
-
-#### 3. Multi-Claude Workflows
-
-For complex projects, use multiple Claude Code sessions:
-
-```bash
-# Terminal 1: Main implementation
-cd project && claude
-
-# Terminal 2: Testing and validation
-cd project-test-worktree && claude
-
-# Terminal 3: Documentation updates
-cd project-docs-worktree && claude
-```
-
-### Custom Slash Commands
-
-Create `.claude/commands/taskgraph-next.md`:
-
-```markdown
-Find the next available TaskGraph task and show its details.
-
-Steps:
-
-1. Run `taskgraph next` to get the next task
-2. If a task is available, run `taskgraph show <id>` for full details
-3. Provide a summary of what needs to be implemented
-4. Suggest the first implementation step
-```
-
-Create `.claude/commands/taskgraph-complete.md`:
-
-```markdown
-Complete a TaskGraph task: $ARGUMENTS
-
-Steps:
-
-1. Review the current task with `taskgraph show $ARGUMENTS`
-2. Verify all implementation is complete
-3. Run any tests related to this task
-4. Mark as complete: `taskgraph set-status --id=$ARGUMENTS --status=done`
-5. Show the next available task with `taskgraph next`
-```
-
-## Tool Allowlist Recommendations
-
-Add to `.claude/settings.json`:
-
-```json
-{
-  "allowedTools": [
-    "Edit",
-    "Bash(taskgraph *)",
-    "Bash(git commit:*)",
-    "Bash(git add:*)",
-    "Bash(npm run *)",
-    "mcp__taskgraph_ai__*"
-  ]
-}
-```
-
-## Configuration & Setup
-
-### Authentication
-
-TaskGraph runs every AI call through your signed-in Claude Code, so no provider API keys are needed. Run `claude` once to sign in. Optionally set `CLAUDE_CODE_API_KEY` to bill calls to a specific Anthropic API key.
-
-### Model Configuration
-
-```bash
-# Interactive setup (recommended)
-taskgraph models --setup
-
-# Set specific models
-taskgraph models --set-main sonnet
-taskgraph models --set-research opus
-taskgraph models --set-fallback haiku
-```
-
-## Task Structure & IDs
-
-### Task ID Format
-
-- Main tasks: `1`, `2`, `3`, etc.
-- Subtasks: `1.1`, `1.2`, `2.1`, etc.
-- Sub-subtasks: `1.1.1`, `1.1.2`, etc.
-
-### Task Status Values
-
-- `pending` - Ready to work on
-- `in-progress` - Currently being worked on
-- `done` - Completed and verified
-- `deferred` - Postponed
-- `cancelled` - No longer needed
-- `blocked` - Waiting on external factors
-
-### Task Fields
-
-```json
-{
-  "id": "1.2",
-  "title": "Implement user authentication",
-  "description": "Set up JWT-based auth system",
-  "status": "pending",
-  "priority": "high",
-  "dependencies": ["1.1"],
-  "details": "Use bcrypt for hashing, JWT for tokens...",
-  "testStrategy": "Unit tests for auth functions, integration tests for login flow",
-  "subtasks": []
-}
-```
-
-## Claude Code Best Practices with TaskGraph
-
-### Context Management
-
-- Use `/clear` between different tasks to maintain focus
-- This CLAUDE.md file is automatically loaded for context
-- Use `taskgraph show <id>` to pull specific task context when needed
-
-### Iterative Implementation
-
-1. `taskgraph show <subtask-id>` - Understand requirements
-2. Explore codebase and plan implementation
-3. `taskgraph update-subtask --id=<id> --prompt="detailed plan"` - Log plan
-4. `taskgraph set-status --id=<id> --status=in-progress` - Start work
-5. Implement code following logged plan
-6. `taskgraph update-subtask --id=<id> --prompt="what worked/didn't work"` - Log progress
-7. `taskgraph set-status --id=<id> --status=done` - Complete task
-
-### Complex Workflows with Checklists
-
-For large migrations or multi-step processes:
-
-1. Create a markdown PRD file describing the new changes: `touch task-migration-checklist.md` (prds can be .txt or .md)
-2. Use TaskGraph to parse the new prd with `taskgraph parse-prd --append` (also available in MCP)
-3. Use TaskGraph to expand the newly generated tasks into subtasks. Consdier using `analyze-complexity` with the correct --to and --from IDs (the new ids) to identify the ideal subtask amounts for each task. Then expand them.
-4. Work through items systematically, checking them off as completed
-5. Use `taskgraph update-subtask` to log progress on each task/subtask and/or updating/researching them before/during implementation if getting stuck
-
-### Git Integration
-
-TaskGraph works well with `gh` CLI:
-
-```bash
-# Create PR for completed task
-gh pr create --title "Complete task 1.2: User authentication" --body "Implements JWT auth system as specified in task 1.2"
-
-# Reference task in commits
-git commit -m "feat: implement JWT auth (task 1.2)"
-```
-
-### Parallel Development with Git Worktrees
-
-```bash
-# Create worktrees for parallel task development
-git worktree add ../project-auth feature/auth-system
-git worktree add ../project-api feature/api-refactor
-
-# Run Claude Code in each worktree
-cd ../project-auth && claude    # Terminal 1: Auth work
-cd ../project-api && claude     # Terminal 2: API work
-```
-
-## Troubleshooting
-
-### AI Commands Failing
-
-```bash
-# Make sure Claude Code is installed and signed in
-claude --version
-
-# Verify model configuration
-taskgraph models
-
-# Test with different model
-taskgraph models --set-fallback haiku
-```
-
-### MCP Connection Issues (only if you use MCP)
-
-- Check `.mcp.json` configuration
-- Verify Node.js installation
-- Use `--mcp-debug` flag when starting Claude Code
-- Slash commands and the CLI work without MCP; use them if the server will not connect
-
-### Task File Sync Issues
-
-```bash
-# Regenerate task files from tasks.json
-taskgraph generate
-
-# Fix dependency issues
-taskgraph fix-dependencies
-```
-
-DO NOT RE-INITIALIZE. That will not do anything beyond re-adding the same TaskGraph core files.
-
-## Important Notes
-
-### AI-Powered Operations
-
-These commands make AI calls and may take up to a minute:
-
-- `parse_prd` / `taskgraph parse-prd`
-- `analyze_project_complexity` / `taskgraph analyze-complexity`
-- `expand_task` / `taskgraph expand`
-- `expand_all` / `taskgraph expand --all`
-- `add_task` / `taskgraph add-task`
-- `update` / `taskgraph update`
-- `update_task` / `taskgraph update-task`
-- `update_subtask` / `taskgraph update-subtask`
-
-### File Management
-
-- Never manually edit `tasks.json` - use commands instead
-- Never manually edit `.taskgraph/config.json` - use `taskgraph models`
-- Task markdown files in `tasks/` are auto-generated
-- Run `taskgraph generate` after manual changes to tasks.json
-
-### Claude Code Session Management
-
-- Use `/clear` frequently to maintain focused context
-- Create custom slash commands for repeated TaskGraph workflows
-- Configure tool allowlist to streamline permissions
-- Use headless mode for automation: `claude -p "taskgraph next"`
-
-### Multi-Task Updates
-
-- Use `update --from=<id>` to update multiple future tasks
-- Use `update-task --id=<id>` for single task updates
-- Use `update-subtask --id=<id>` for implementation logging
-
-### Research Mode
-
-- Add `--research` flag for research-based AI enhancement
-- The research role has web search and fetch only; it cannot read or change your files
-- Provides more informed task creation and updates
-- Recommended for complex technical tasks
-
----
-
-_This guide ensures Claude Code has immediate access to TaskGraph's essential functionality for agentic development workflows._
+Statuses: pending, in-progress, review, done, deferred, cancelled, blocked. Subtask IDs have one dot (`3.2`). Change tasks through the commands, not by editing `.taskgraph/tasks/tasks.json`. `taskgraph --help` lists the rest.