ultracode 5.4.0 → 5.6.0

package/dist/chunks/autodoc-tool-handlers-N736CB56.js

@@ -0,0 +1,138 @@
+import'./chunk-4W6QYGXZ.js';import {a,b,c,d as d$1,e,f,g,h,i,j as j$1,k}from'./chunk-VDY3Y3CS.js';import {d}from'./chunk-XG3ACLWR.js';import'./chunk-XJ2Z5QQO.js';import'./chunk-PY43JPWL.js';import'./chunk-RK5TLU72.js';import'./chunk-LESND2CW.js';import'./chunk-QUO46LUP.js';import'./chunk-3IFLFBQ4.js';import'./chunk-I6STSSAK.js';import'./chunk-SV3WKUNV.js';import'./chunk-PZF7YC35.js';import {e as e$2}from'./chunk-R7SWWANK.js';import {e as e$1}from'./chunk-SOG7QA72.js';import {a as a$1}from'./chunk-F3VMUQ7O.js';import'./chunk-2KIPXYOB.js';import'./chunk-OG62YNVF.js';import {R,I}from'./chunk-4BI7EBPQ.js';import'./chunk-F45ISXCP.js';import'./chunk-POFMGITV.js';import'./chunk-DXB73IDG.js';import ee,{join}from'path';import {execSync}from'child_process';import {existsSync,mkdirSync,writeFileSync}from'fs';R();var te=["architecture.md","dependencies.md","deployment.md","flow.md","glossary.md","processes.md"],ne={"architecture.md":`# Architecture
+
+## Overview
+
+*Describe the high-level architecture of your project here.*
+
+## Core Components
+
+| Component | Location | Description |
+|-----------|----------|-------------|
+| Example | [\`src/example.ts\`](../src/example.ts) | Description |
+
+## Data Flow
+
+\`\`\`
+[Request] \u2192 [Handler] \u2192 [Service] \u2192 [Storage]
+\`\`\`
+
+## Key Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| Example | Reason |
+
+## Related Documents
+
+- [\u2192 dependencies.md](./dependencies.md)
+- [\u2192 deployment.md](./deployment.md)
+- [\u2192 processes.md](./processes.md)
+`,"dependencies.md":`# Dependencies
+
+## Runtime Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| example | ^1.0.0 | Description |
+
+## Dev Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| typescript | ^5.0.0 | Type checking |
+
+## System Requirements
+
+- Node.js 18+
+- *Add other requirements*
+
+## Optional Dependencies
+
+*List optional dependencies and when they are needed.*
+`,"deployment.md":`# Deployment
+
+## Build
+
+\`\`\`bash
+npm run build
+\`\`\`
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| NODE_ENV | development | Environment |
+
+## Installation
+
+\`\`\`bash
+npm install
+\`\`\`
+
+## Production Setup
+
+*Describe production deployment steps.*
+`,"flow.md":`# Data Flow
+
+## Request Flow
+
+\`\`\`
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510     \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502 Client  \u2502 \u2500\u2500\u25BA \u2502 Handler \u2502 \u2500\u2500\u25BA \u2502 Service \u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518     \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+\`\`\`
+
+## Key Processes
+
+### Process 1
+
+1. Step one
+2. Step two
+3. Step three
+
+## State Management
+
+*Describe how state is managed.*
+`,"glossary.md":`# Glossary
+
+## Terms
+
+| Term | Definition |
+|------|------------|
+| **Entity** | A code element (function, class, variable) tracked in the graph |
+| **Relationship** | A connection between entities (imports, calls, extends) |
+
+## Abbreviations
+
+| Abbr | Full Form |
+|------|-----------|
+| AST | Abstract Syntax Tree |
+| MCP | Model Context Protocol |
+`,"processes.md":`# Processes
+
+## Development Workflow
+
+1. Create feature branch
+2. Implement changes
+3. Run tests
+4. Create PR
+
+## Testing
+
+\`\`\`bash
+npm test
+\`\`\`
+
+## Code Style
+
+*Describe code style guidelines.*
+
+## Release Process
+
+1. Update version
+2. Update changelog
+3. Create release tag
+`};function N(l){existsSync(l)||mkdirSync(l,{recursive:true});for(let e of te){let n=ee.join(l,e);existsSync(n)||writeFileSync(n,ne[e],"utf-8");}}function re(l){try{return execSync("git rev-parse --show-toplevel",{cwd:l,encoding:"utf-8",windowsHide:!0,stdio:["pipe","pipe","pipe"]}).trim()}catch{return l}}async function se(l,e,n){if(l!=="auto")return l;try{let r=(await e())?.getConfig()?.language;if(r&&r!=="auto"&&r!=="en")return r;let{readdir:c,readFile:t}=await import('fs/promises'),{detectLanguageFromText:d,aggregateLanguageDetection:a}=await import('./language-detector-4D6IZXBP.js'),o=n||join(process.cwd(),".autodoc");try{let p=(await c(o)).filter(u=>u.endsWith(".md")).slice(0,5),f=[];for(let u of p)try{let g=await t(join(o,u),"utf-8"),y=d(g);y.confidence>0&&f.push(y);}catch{}if(f.length>0){let u=a(f);if(u.confidence>.3)return I.d("AUTODOCGEN","language_detected",{lang:u.language,conf:u.confidence}),u.language}}catch{}return "en"}catch{return "en"}}async function ie(l,e,n,i){let{detectLLMProviders:r,batchGenerateDocs:c}=await import('./llm-O2QLMW4C.js'),{recommended:t}=await r();if(!t)return I.w("AUTODOCGEN","no_llm_provider",{hint:"Install Ollama or configure TGI/OpenAI"}),{llmStatus:"no_provider_available"};let d=t.selectedModel||t.name;I.i("AUTODOCGEN","using_llm",{provider:t.name,model:d,modules:l.length,lang:n});try{let a=await c(t,l,{concurrency:1,language:n,onProgress:(o,s)=>{I.d("AUTODOCGEN","llm_progress",{completed:o,total:s});}});for(let o of e){let s=a.get(o.path.replace(/AUTODOC\.md$/,"").replace(/[\\/]$/,""));s&&(o.content=s);}return {llmStatus:`using_${t.name}:${d}`}}catch(a){return I.w("AUTODOCGEN","llm_gen_failed",{error:a.message}),{llmStatus:`error_${t.name}`}}}async function ae(l,e,n,i){let{updateModuleDoc:r}=await import('./incremental-updater-S5BAAGHP.js'),c=0,t=[];for(let d of l)try{let a=d.path.replace(/[\\/]AUTODOC\.md$/,""),o=await r(a,d.path,d.content,{useLlm:n});o.updated&&o.newContent&&(e&&await e.saveDocument(d.path,o.newContent,{autoGenerated:!0}),await e$2(d.path,o.newContent),c++,t.push({path:d.path,changes:o.changes.map(s=>s.description)}));}catch(a){I.w("AUTODOCGEN","incr_update_failed",{path:d.path,error:a.message});try{e&&await e.saveDocument(d.path,d.content,{autoGenerated:!0}),await e$2(d.path,d.content),c++;}catch(o){I.w("AUTODOCGEN","write_failed",{path:d.path,error:o.message});}}return {filesWritten:c,incrementalChanges:t}}async function ce(l,e,n){let i=0;for(let r of l)try{e&&await e.saveDocument(r.path,r.content,{autoGenerated:!0}),await e$2(r.path,r.content),i++;}catch(c){I.w("AUTODOCGEN","write_failed",{path:r.path,error:c.message});}return i}async function U(l,e){let n=e.normalizeInputPath(l.rootDir||"")||process.cwd(),i=re(n),r=l.autodocDir?e.normalizeInputPath(l.autodocDir)||l.autodocDir:join(i,".autodoc"),c=await se(l.language||"auto",e.getAutoDocManager,r);N(r);let t=await e$1({rootDir:n,exclude:l.exclude,maxDepth:l.maxDepth});if(l.module){let s=l.module.toLowerCase();t.modules=t.modules.filter(p=>p.name.toLowerCase()===s||p.name.toLowerCase().includes(s)),t.files=t.files.filter(p=>t.modules.some(f=>p.path.includes(f.path)));}let d="not_requested";l.useLlm&&t.modules.length>0&&(d=(await ie(t.modules,t.files,c)).llmStatus);let a=0,o=[];if(!l.preview){let s=await e.getAutoDocManager();if(l.incremental){let p=await ae(t.files,s,l.useLlm||false);a=p.filesWritten,o=p.incrementalChanges;}else a=await ce(t.files,s);}return {success:true,preview:l.preview||false,useLlm:l.useLlm||false,llmStatus:d,incremental:l.incremental||false,language:c,modulesFound:t.modules.length,filesToGenerate:t.files.length,filesWritten:a,incrementalChanges:l.incremental?o:void 0,modules:t.modules.map(s=>({name:s.name,path:s.path,files:s.files.length,exports:s.exports.slice(0,5)})),files:t.files.map(s=>({path:s.path,type:s.type,preview:l.preview?s.content.slice(0,200)+"...":void 0}))}}R();async function x(l){let e=l.getServiceContainer?.();if(!e)return null;let n=await e.getAutoDocManager();if(n&&!n.isInitialized()){let i=await e.getGraphStorage?.();await n.initialize(i);}return n}function D(){return {content:[{type:"text",text:JSON.stringify({success:false,error:"AutoDoc not enabled. Create .autodoc folder in project root to enable."})}]}}var $=class extends d{parseArgs(e){return a.parse(e)}async execute(e){let n=this.context.getServiceContainer?.();if(!n)return D();let i=await n.getAutoDocManager();return i?(i.setConfig({enabled:e.enabled,language:e.language,docsDir:e.docsDir||join(n.directory,".memory_bank")}),{content:[{type:"text",text:JSON.stringify({success:true,message:"AutoDoc initialized",config:i.getConfig()},null,2)}]}):D()}},V=class extends d{parseArgs(e){return b.parse(e)}async execute(e){let n=await x(this.context);if(!n)return D();let i=this.context.normalizeInputPath(e.filePath)||e.filePath,r={type:e.type,autoGenerated:e.autoGenerated},c=await n.saveDocument(i,e.content,r),t=false;try{let{writeDocumentToDisk:o}=await import('./file-sync-X6FXAJ5R.js');await o(i,e.content),t=!0;}catch(o){let s=a$1(o);I.w("AUTODOCTOOL","file_write_failed",{error:s.message,path:i,stack:s.stack});}let d=0,a={savedDocsCount:c.length};if(c.length>0)try{I.i("AUTODOCTOOL","embeddings_start",{docsCount:c.length}),a.step="getSemanticAgent";let o=await this.context.getSemanticAgent();a.hasAgent=!!o,a.agentType=typeof o,I.i("AUTODOCTOOL","embeddings_agent",{hasAgent:!!o,agentType:typeof o}),a.step="getVectorStore";let s=o?.getVectorStore?.();if(a.hasStore=!!s,a.hasGetVectorStoreFn=typeof o?.getVectorStore,I.i("AUTODOCTOOL","embeddings_store",{hasStore:!!s,storeType:typeof s,hasGetVectorStore:typeof o?.getVectorStore}),o&&s){a.step="processing",a.agentAndStoreOk=!0,I.i("AUTODOCTOOL","embeddings_processing",{count:c.length});let p=c.map(u=>u.id),f=await s.getExistingIds(p);I.i("AUTODOCTOOL","embeddings_existing_check",{total:p.length,existing:f.size});for(let u of c){let g=`${u.title}
+
+${u.content}`,y=await o.generateEmbedding(g);if(y){let b=f.has(u.id);I.i("AUTODOCTOOL",b?"updating_embedding":"inserting_embedding",{id:u.id,vectorDim:y.length,contentLen:g.length});let O={type:"autodoc",docType:u.type,filePath:u.filePath,section:u.section,title:u.title};b?await s.update(u.id,y,O):await s.insert({id:u.id,content:g.slice(0,1e3),vector:y,metadata:O,createdAt:Date.now()}),d++,I.d("AUTODOCTOOL","embedding_saved",{id:u.id,operation:b?"update":"insert"});}}I.i("AUTODOCTOOL","embeddings_done",{generated:d}),d>0&&(I.i("AUTODOCTOOL","flushing_embeddings"),await s.flushAndSave(),I.i("AUTODOCTOOL","embeddings_flushed"));}else a.skipped=!0,a.reason=`agent=${!!o}, store=${!!s}`,I.w("AUTODOCTOOL","embeddings_skipped",{hasAgent:!!o,hasStore:!!s});}catch(o){let s=a$1(o);a.error=s.message,a.stack=s.stack,I.e("AUTODOCTOOL","embedding_failed",{error:s.message,stack:s.stack});}return {content:[{type:"text",text:JSON.stringify({success:true,message:`Saved ${c.length} sections`,fileWritten:t,embeddingsGenerated:d,debug:a,docs:c.map(o=>({id:o.id,title:o.title,section:o.section}))},null,2)}]}}},J=class extends d{parseArgs(e){return c.parse(e)}async execute(e){let n=await x(this.context);if(!n)return D();if(e.docId){let i=await n.getDocument(e.docId);return {content:[{type:"text",text:JSON.stringify({success:!!i,doc:i||null},null,2)}]}}if(e.filePath){let i=this.context.normalizeInputPath(e.filePath)||e.filePath,r=await n.getDocumentsByFile(i);return {content:[{type:"text",text:JSON.stringify({success:true,count:r.length,docs:r},null,2)}]}}return {content:[{type:"text",text:JSON.stringify({success:false,error:"Provide docId or filePath"},null,2)}]}}},W=class extends d{parseArgs(e){return d$1.parse(e)}async execute(e){let n=await x(this.context);if(!n)return D();let i=[];if(e.mode==="text"||e.mode==="hybrid"){let r=await n.searchDocsByText(e.query,e.limit);for(let c of r)i.push({id:c.id,title:c.title,filePath:c.filePath,section:c.section,snippet:c.content.slice(0,200),source:"text"});}if(e.mode==="semantic"||e.mode==="hybrid")try{let r=await this.context.getSemanticAgent(),c=r?.getVectorStore?.();if(r&&c){let t=await r.generateEmbedding(e.query);if(I.i("AUTODOCTOOL","search_embedding_generated",{hasEmbedding:!!t,dim:t?.length}),t){let d=await c.searchWithFilters(t,{limit:e.limit,metadataFilter:{type:"autodoc"}});I.i("AUTODOCTOOL","search_results",{count:d.length,ids:d.map(a=>a.id).slice(0,5)});for(let a of d)if(I.d("AUTODOCTOOL","search_result_check",{id:a.id,startsWithDoc:a.id.startsWith("doc::")}),a.id.startsWith("doc::")){let o=await n.getDocument(a.id);o&&!i.some(s=>s.id===o.id)&&i.push({id:o.id,title:o.title,filePath:o.filePath,section:o.section,snippet:o.content.slice(0,200),score:a.similarity,source:"semantic"});}}}}catch(r){let c=a$1(r);I.w("AUTODOCTOOL","semantic_search_err",{error:c.message,stack:c.stack});}return i.sort((r,c)=>(c.score??0)-(r.score??0)),{content:[{type:"text",text:JSON.stringify({success:true,query:e.query,mode:e.mode||"text",resultsCount:i.length,results:i.slice(0,e.limit)},null,2)}]}}},j=class extends d{parseArgs(e$1){return e.parse(e$1)}async execute(e){let n=await x(this.context);if(!n)return D();let i=await n.validateReferences(),r={success:true,total:i.total,valid:i.valid,broken:i.broken.length};if(e.filePath){let c=this.context.normalizeInputPath(e.filePath)||e.filePath;r.brokenInFile=i.broken.filter(t=>t.ref.sourceLocation.filePath===c);}else r.brokenRefs=i.broken.slice(0,20);return {content:[{type:"text",text:JSON.stringify(r,null,2)}]}}},q=class extends d{parseArgs(e){return f.parse(e)}async execute(e){let n=await x(this.context);if(!n)return D();let i=await n.getStatus();return {content:[{type:"text",text:JSON.stringify({success:true,status:i},null,2)}]}}},B=class extends d{parseArgs(e){return g.parse(e)}async execute(e){let n=await x(this.context);if(!n)return D();let{syncBidirectional:i,syncDbToDisk:r,syncDiskToDb:c}=await import('./file-sync-X6FXAJ5R.js'),t={validated:0,brokenRefs:0,outdatedDocs:0,markedOutdated:[]};if(e.docsDir){let s=this.context.normalizeInputPath(e.docsDir)||e.docsDir,p=async u=>n.getDocumentsByFile(u),f=async()=>n.getAllDocuments();if(e.direction==="disk-to-db"){let u=await c(s,p,async(g,y)=>(await n.saveDocument(g,y),[]),8);t.fileSync={diskToDb:{added:u.added,updated:u.updated,errors:u.errors.map(g=>({path:g.file,error:g.error}))},dbToDisk:{written:[],errors:[]}};}else if(e.direction==="db-to-disk"){let u=await r(f,8);t.fileSync={diskToDb:{added:[],updated:[],errors:[]},dbToDisk:{written:u.written,errors:u.errors.map(g=>({path:g.file,error:g.error}))}};}else {let u=await i(s,p,f,async(g,y)=>(await n.saveDocument(g,y),[]),8);t.fileSync={diskToDb:{added:u.diskToDb.added,updated:u.diskToDb.updated,errors:u.diskToDb.errors.map(g=>({path:g.file,error:g.error}))},dbToDisk:{written:u.dbToDisk.written,errors:u.dbToDisk.errors.map(g=>({path:g.file,error:g.error}))}};}}let d=await n.validateReferences();t.validated=d.total,t.brokenRefs=d.broken.length;let a=await n.getOutdatedDocs();if(t.outdatedDocs=a.length,e.scope==="file"&&e.filePath){let s=this.context.normalizeInputPath(e.filePath)||e.filePath,p=await n.getDocumentsByFile(s);for(let f of p)f.confidence&&f.confidence<.7&&t.markedOutdated.push(f.id);}else t.markedOutdated=a.map(s=>s.docId);let o=t.fileSync?` Files: ${t.fileSync.diskToDb.added.length} added, ${t.fileSync.diskToDb.updated.length} updated, ${t.fileSync.dbToDisk.written.length} written.`:"";return {content:[{type:"text",text:JSON.stringify({success:true,message:`Sync completed. ${t.brokenRefs} broken refs, ${t.outdatedDocs} outdated docs.${o}`,...t},null,2)}]}}},H=class extends d{parseArgs(e){return h.parse(e)}async execute(e){let n=this.context.getServiceContainer?.();if(!n)return D();let i=e.useLlm;if(i===void 0)try{let{detectLLMProviders:c}=await import('./llm-provider-ZCW4DWD3.js'),{recommended:t}=await c();i=!!t;}catch{i=false;}let r=await U({rootDir:e.rootDir,autodocDir:e.autodocDir,exclude:e.exclude,maxDepth:e.maxDepth,module:e.module,useLlm:i,preview:e.preview,incremental:e.incremental,language:e.language},{normalizeInputPath:this.context.normalizeInputPath,requestId:this.context.requestId,getAutoDocManager:n.getAutoDocManager.bind(n)});return {content:[{type:"text",text:JSON.stringify(r,null,2)}]}}},K=class extends d{parseArgs(e){return i.parse(e)}async execute(e){let n=await x(this.context);if(!n)return D();let i=await n.getChangelog({since:e.since,limit:e.limit,branch:e.branch});return {content:[{type:"text",text:JSON.stringify({success:true,entriesCount:i.length,entries:i.map(r=>({id:r.id,timestamp:r.timestamp,date:new Date(r.timestamp).toISOString(),branch:r.branch,summary:r.summary,changesCount:r.changes?.length||0,impactedDocsCount:r.impactedDocs?.length||0}))},null,2)}]}}},Q=class extends d{parseArgs(e){return j$1.parse(e)}async execute(e){let n=this.context.getServiceContainer?.();if(!n)return {content:[{type:"text",text:JSON.stringify({error:"ServiceContainer not available"})}]};let{installPreCommitHook:i,uninstallHooks:r,getHookStatus:c}=await import('./hook-installer-RK74YA5D.js'),t=n.directory;if(e.action==="status"){let a=await c(t);return {content:[{type:"text",text:JSON.stringify({success:true,gitRepo:a.gitRepo,hooksDir:a.hooksDir,preCommitInstalled:a.preCommit},null,2)}]}}if(e.action==="uninstall"){let a=await r(t);return {content:[{type:"text",text:JSON.stringify({success:a.success,removed:a.installed,skipped:a.skipped,errors:a.errors},null,2)}]}}let d=await i(t);return {content:[{type:"text",text:JSON.stringify({success:d.success,installed:d.installed,skipped:d.skipped,errors:d.errors},null,2)}]}}},X=class extends d{parseArgs(e){return k.parse(e)}async execute(e){let{detectLanguageFromText:n,aggregateLanguageDetection:i}=await import('./language-detector-4D6IZXBP.js'),r=[];if(e.scope==="comments"||e.scope==="all"){let a=(await(await this.context.getGraphStorage()).getAllEntities()).slice(0,e.sampleSize*2),o=0;for(let s of a){if(o>=e.sampleSize)break;let p=s.metadata?.comments||s.documentation;if(p){let f=Array.isArray(p)?p.join(`
+`):String(p),u=n(f);u.confidence>0&&(r.push(u),o++);}}}if(e.scope==="docs"||e.scope==="all"){let t=await x(this.context);if(t){let d=await t.searchDocsByText("",e.sampleSize);for(let a of d){let o=n(a.content);o.confidence>0&&r.push(o);}}}let c=i(r);return {content:[{type:"text",text:JSON.stringify({success:true,detectedLanguage:c.language,confidence:Math.round(c.confidence*100)/100,samplesAnalyzed:r.length,charCounts:c.charCounts,recommendation:c.confidence>.5?`Use language: ${c.language}`:"Low confidence - defaulting to 'en'"},null,2)}]}}};export{K as AutoDocChangelogToolHandler,X as AutoDocDetectLanguageToolHandler,H as AutoDocGenerateToolHandler,J as AutoDocGetToolHandler,$ as AutoDocInitToolHandler,Q as AutoDocInstallHooksToolHandler,V as AutoDocSaveToolHandler,W as AutoDocSearchToolHandler,q as AutoDocStatusToolHandler,B as AutoDocSyncToolHandler,j as AutoDocValidateToolHandler};