@fullkkk/codiq 0.0.3 → 0.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -9
- package/dist/index.js +9 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
npm i -g @fullkkk/codiq
|
|
5
5
|
```
|
|
6
6
|
|
|
7
|
-
`
|
|
7
|
+
`Codiq`는 현재 디렉터리 안에 있는 프로젝트를 자동으로 파악하고, Ollama Cloud 기반 LLM(언어 모델)에게 질문하면 바로 답변을 받아옵니다.
|
|
8
8
|
|
|
9
9
|
- **핵심 기능**
|
|
10
10
|
1. 현재 프로젝트 구조를 자동 분석
|
|
@@ -32,23 +32,19 @@ npm i -g @fullkkk/codiq
|
|
|
32
32
|
|
|
33
33
|
## 🚀 소개
|
|
34
34
|
|
|
35
|
-
`
|
|
35
|
+
`Codiq`는 명령줄에서 바로 **프로젝트를 이해해주는** AI 도우미입니다.
|
|
36
36
|
|
|
37
37
|
- 현재 디렉터리의 파일을 분석해 3단계 깊이, 60파일 이하, 32KB 이하 파일 8개 정도를 샘플링해 컨텍스트를 구성합니다.
|
|
38
|
-
- Ollama 모델에게 전달하면 교정·설명·수정 제안 등을 받아볼 수 있습니다.
|
|
38
|
+
- Ollama Cloud 모델에게 전달하면 교정·설명·수정 제안 등을 받아볼 수 있습니다.
|
|
39
39
|
- `codiq "질문"` 으로 한 번에 답변을 얻거나, `codiq` 단독 실행으로 AI가 띄우는 TUI에서 대화형으로 질문/답변을 주고받을 수 있습니다.
|
|
40
40
|
|
|
41
|
-
> **주의**
|
|
42
|
-
> `OLLAMA_API_KEY` 환경 변수에 인증 토큰을 설정해야 합니다. Ollama 서버가 아닌 다른 API를 사용하려면 `-u, --base-url` 옵션으로 지정하세요.
|
|
43
|
-
|
|
44
41
|
---
|
|
45
42
|
|
|
46
43
|
## 🔧 필요 요건
|
|
47
44
|
|
|
48
|
-
-
|
|
45
|
+
- Ollama Cloud API Key
|
|
46
|
+
- Node.js 18+ (ESM 모듈 지원)
|
|
49
47
|
- npm / yarn
|
|
50
|
-
- Ollama 등 LLM 서버
|
|
51
|
-
- **(선택)** `curl` 혹은 `httpie` (테스트용)
|
|
52
48
|
|
|
53
49
|
---
|
|
54
50
|
|
package/dist/index.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{Command as
|
|
3
|
-
`);s=
|
|
4
|
-
`)},a=
|
|
5
|
-
`){l(),
|
|
6
|
-
`,
|
|
7
|
-
`;async function
|
|
8
|
-
`)}async function
|
|
9
|
-
`),s=[];for(let r of
|
|
10
|
-
`);return}
|
|
2
|
+
import{Command as Le}from"commander";import{render as ve}from"ink";import je from"react";import"dotenv/config";async function M(t,e,n){let s=[...n,{role:"user",content:t}];return e.stream?await te({apiKey:e.apiKey,baseUrl:e.baseUrl,model:e.model,messages:s,onToken:e.onToken}):await ee({apiKey:e.apiKey,baseUrl:e.baseUrl,model:e.model,messages:s})}async function ee(t){let e=await fetch(t.baseUrl,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t.apiKey}`},body:JSON.stringify({model:t.model,messages:t.messages,stream:!1})});if(!e.ok)throw new Error(`HTTP ${e.status}: ${await e.text()}`);return(await e.json()).message?.content??""}async function te(t){let e=await fetch(t.baseUrl,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${t.apiKey}`},body:JSON.stringify({model:t.model,messages:t.messages,stream:!0})});if(!e.ok)throw new Error(`HTTP ${e.status}: ${await e.text()}`);if(!e.body)throw new Error("\uC751\uB2F5 \uC2A4\uD2B8\uB9BC\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");let n=new TextDecoder,s="",r="";for await(let a of e.body){s+=n.decode(a,{stream:!0});let m=s.split(`
|
|
3
|
+
`);s=m.pop()??"";for(let P of m){let p=P.trim();if(!p)continue;let y;try{y=JSON.parse(p)}catch{throw new Error(`\uC2A4\uD2B8\uB9BC \uD30C\uC2F1 \uC2E4\uD328: ${p}`)}let w=y.message?.content??"";w&&(r+=w,t.onToken?.(w))}}s+=n.decode();let o=s.trim();if(!o)return r;let l=JSON.parse(o).message?.content??"";return l&&(r+=l,t.onToken?.(l)),r}import{mkdir as se,readFile as oe,rm as ne,writeFile as re}from"node:fs/promises";import ie from"node:os";import L from"node:path";var v=L.join(ie.homedir(),".codiq"),F=L.join(v,"config.json");async function j(){try{return await ne(F,{force:!0}),!0}catch{return!1}}async function k(){let t=process.env.OLLAMA_API_KEY?.trim();if(t)return t;let e=await ae();if(e)return e;let n=await le();return await ce(n),console.log("Ollama Cloud API Key \uC124\uC815\uC774 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4."),n}async function ae(){try{let t=await oe(F,"utf8");return JSON.parse(t).ollamaApiKey?.trim()||null}catch{return null}}async function ce(t){await se(v,{recursive:!0}),await re(F,JSON.stringify({ollamaApiKey:t},null,2),"utf8")}async function le(){if(!process.stdin.isTTY||!process.stdout.isTTY)throw new Error("Ollama Cloud API Key\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uACE0 \uC785\uB825\uC744 \uBC1B\uC744 \uC218 \uC788\uB294 \uD130\uBBF8\uB110\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.");console.log("Ollama Cloud API Key\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4."),console.log("\uCD5C\uCD08 1\uD68C\uB9CC \uC785\uB825\uD558\uBA74 \uC0AC\uC6A9\uC790 \uC124\uC815\uC5D0 \uC800\uC7A5\uD574 \uC7AC\uC0AC\uC6A9\uD569\uB2C8\uB2E4.");let t=await me("Ollama Cloud API Key: ");if(!t.trim())throw new Error("Ollama Cloud API Key\uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.");return t.trim()}async function me(t){return await new Promise((e,n)=>{let s=process.stdin,r=process.stdout,o=s.isRaw,c="",l=()=>{s.off("data",a),s.isTTY&&s.setRawMode(o??!1),s.pause(),r.write(`
|
|
4
|
+
`)},a=m=>{if(m===""){l(),n(new Error("\uC785\uB825\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));return}if(m==="\r"||m===`
|
|
5
|
+
`){l(),e(c);return}if(m==="\x7F"){c.length>0&&(c=c.slice(0,-1),r.write("\b \b"));return}c+=m,r.write("*")};r.write(t),s.setEncoding("utf8"),s.isTTY&&s.setRawMode(!0),s.resume(),s.on("data",a)})}import{readdir as X,readFile as pe,stat as ue}from"node:fs/promises";import _ from"node:path";var de=new Set([".git","node_modules","dist","build",".next",".turbo","coverage",".idea",".vscode"]),fe=[".env"],$=new Set(["package.json","package-lock.json","tsconfig.json","README.md","README","pyproject.toml","requirements.txt","Cargo.toml","go.mod","Dockerfile","docker-compose.yml"]),ge=3,U=60,ye=32e3,he=8,we=1200,D=`\uC544\uB798\uB294 \uD604\uC7AC \uC791\uC5C5 \uB514\uB809\uD130\uB9AC\uB97C \uAE30\uC900\uC73C\uB85C \uC218\uC9D1\uD55C \uD504\uB85C\uC81D\uD2B8 \uCEE8\uD14D\uC2A4\uD2B8\uC785\uB2C8\uB2E4.
|
|
6
|
+
`,H=`\uC751\uB2F5 \uD615\uC2DD \uC9C0\uCE68:
|
|
7
|
+
`;async function O(t,e,n){let s=t.filter(o=>o.role!=="system"||!o.content.startsWith(D)&&!o.content.startsWith(H));if(s.push({role:"system",content:H+xe(e)}),!Ce(e))return{history:s,projectContextUsed:!1};let r=await Ee(n);return s.push({role:"system",content:D+r}),{history:s,projectContextUsed:!0}}function T(t,e){return[{role:"system",content:t},{role:"system",content:`\uD604\uC7AC \uC0AC\uC6A9\uC790\uAC00 CLI\uB97C \uC2E4\uD589\uD55C \uC791\uC5C5 \uB514\uB809\uD130\uB9AC\uB294 ${e} \uC785\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uAC00 \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8, \uD30C\uC77C \uAD6C\uC870, \uCF54\uB4DC \uC218\uC815, \uB9AC\uD329\uD1A0\uB9C1, \uD2B9\uC815 \uD30C\uC77C \uB3D9\uC791\uC744 \uBB3B\uB294 \uACBD\uC6B0 \uC774 \uB514\uB809\uD130\uB9AC\uB97C \uAE30\uC900\uC73C\uB85C \uB2F5\uBCC0\uD558\uC138\uC694.`}]}function Ce(t){let e=t.toLowerCase();return[/프로젝트/,/코드베이스/,/저장소/,/리포지토리/,/구조/,/분석/,/설명/,/파악/,/파일/,/수정/,/리팩토링/,/어디/,/엔트리/,/architecture/,/project/,/codebase/,/repository/,/repo/,/file/,/refactor/,/edit/,/fix/].some(s=>s.test(e))}function xe(t){return Pe(t)?"\uC0AC\uC6A9\uC790\uAC00 README.md, \uBB38\uC11C, markdown \uD30C\uC77C, md \uBB38\uC11C \uC791\uC131\uC744 \uC694\uCCAD\uD55C \uC0C1\uD669\uC785\uB2C8\uB2E4. \uC774 \uACBD\uC6B0\uC5D0\uB294 Markdown \uD615\uC2DD\uC744 \uC0AC\uC6A9\uD574\uB3C4 \uB429\uB2C8\uB2E4. \uB300\uC2E0 \uBB38\uC11C \uBCF8\uBB38 \uC790\uCCB4\uB97C \uBC14\uB85C \uC4F8 \uC218 \uC788\uB294 \uD615\uD0DC\uB85C \uCD9C\uB825\uD558\uC138\uC694.":"\uC0AC\uC6A9\uC790\uB294 shell\uC5D0\uC11C \uC751\uB2F5\uC744 \uC77D\uC2B5\uB2C8\uB2E4. Markdown\uC73C\uB85C \uB2F5\uBCC0\uD558\uC9C0 \uB9C8\uC138\uC694. \uCF54\uB4DC \uD39C\uC2A4(```), \uC81C\uBAA9(#), \uAD75\uAC8C(**), \uBAA9\uB85D \uB9C8\uCEE4(-, *, 1.)\uB97C \uC0AC\uC6A9\uD558\uC9C0 \uB9C8\uC138\uC694. \uD56D\uC0C1 plain text\uB85C\uB9CC \uB2F5\uBCC0\uD558\uACE0, \uC9E7\uC740 \uBB38\uB2E8\uC774\uB098 \uC904\uBC14\uAFC8\uB41C \uC77C\uBC18 \uD14D\uC2A4\uD2B8\uB85C \uC124\uBA85\uD558\uC138\uC694."}function Pe(t){let e=t.toLowerCase();return[/readme/,/markdown/,/\bmd\b/,/문서/,/README\.md/i,/사용법/,/guide/,/docs?/].some(s=>s.test(e))}async function Ee(t){let e=await B(t,0,[]),n=await Te(t),s=[];return s.push(`root: ${t}`),s.push(`top-level entries: ${n.slice(0,20).join(", ")||"(empty)"}`),e.keyFiles.length>0&&s.push(`key files: ${e.keyFiles.join(", ")}`),e.sourceFiles.length>0&&s.push(`source files(sample): ${e.sourceFiles.slice(0,20).join(", ")}`),e.fileSnippets.length>0&&(s.push("file snippets:"),s.push(...e.fileSnippets.map(r=>`- ${r}`))),s.join(`
|
|
8
|
+
`)}async function B(t,e,n){let s={keyFiles:[],sourceFiles:[],fileSnippets:[]};if(e>ge||n.length>=U)return s;let r=await X(t,{withFileTypes:!0});for(let o of r){if(n.length>=U)break;if(o.isDirectory()){if(de.has(o.name))continue;let a=await B(_.join(t,o.name),e+1,n);s.keyFiles.push(...a.keyFiles),s.sourceFiles.push(...a.sourceFiles),s.fileSnippets.push(...a.fileSnippets);continue}if(!o.isFile()||fe.some(a=>o.name.startsWith(a)))continue;let c=_.join(t,o.name),l=_.relative(process.cwd(),c)||o.name;if(n.push(l),$.has(o.name)&&s.keyFiles.push(l),N(o.name)&&s.sourceFiles.push(l),s.fileSnippets.length<he&&($.has(o.name)||N(o.name))){let a=await Ae(c,l);a&&s.fileSnippets.push(a)}}return s}async function Ae(t,e){try{if((await ue(t)).size>ye)return`${e}: skipped, too large`;let r=(await pe(t,"utf8")).replace(/\s+/g," ").trim().slice(0,we);return r?`${e}: ${r}`:null}catch{return null}}function N(t){return/\.(ts|tsx|js|jsx|json|md|py|rs|go|java|kt|rb|php|toml|yaml|yml|sh)$/.test(t)}async function Te(t){try{return(await X(t)).sort()}catch{return[]}}import{useEffect as q,useRef as be,useState as C}from"react";import{Box as x,Text as f,useApp as Se,useInput as Me}from"ink";import Oe from"ink-text-input";import{jsx as h,jsxs as g}from"react/jsx-runtime";var Re="Enter \uC804\uC1A1 | Ctrl+C \uC885\uB8CC | Ctrl+L \uCD08\uAE30\uD654",z="v0.0.4";function Y({apiKey:t,options:e}){let{exit:n}=Se(),[s,r]=C([{role:"assistant",content:"\uC9C8\uBB38\uC744 \uC785\uB825\uD558\uC138\uC694."}]),[o,c]=C([...T(e.system,process.cwd())]),l=be(o),[a,m]=C(""),[P,p]=C("Ready"),[y,w]=C(!1),[J,W]=C(process.stdout.columns??80);q(()=>{l.current=o},[o]),q(()=>{let i=()=>{W(process.stdout.columns??80)};return process.stdout.on("resize",i),()=>{process.stdout.off("resize",i)}},[]),Me((i,u)=>{if(u.ctrl&&i==="c"){n();return}if(u.ctrl&&i==="l"&&!y){r([{role:"assistant",content:"\uB300\uD654 \uAE30\uB85D\uC744 \uCD08\uAE30\uD654\uD588\uC2B5\uB2C8\uB2E4."}]),c(T(e.system,process.cwd())),p("Cleared");return}});let G=async()=>{let i=a.trim();if(!i||y)return;m(""),w(!0),p("Streaming...");let u=-1;r(d=>(u=d.length+1,[...d,{role:"user",content:i},{role:"assistant",content:""}]));try{p("Inspecting project...");let{history:d,projectContextUsed:R}=await O(l.current,i,process.cwd()),I=[...d,{role:"user",content:i}];p(R?"Streaming with project context...":"Streaming...");let b=await M(i,{apiKey:t,model:e.model,baseUrl:e.baseUrl,system:e.system,stream:e.stream,onToken:E=>{r(S=>S.map((A,Z)=>Z===u?{...A,content:A.content+E}:A))}},d);r(E=>E.map((S,A)=>A===u?{...S,content:b}:S)),c([...I,{role:"assistant",content:b}]),p("Ready")}catch(d){let R=d instanceof Error?d.message:String(d);r(I=>I.map((b,E)=>E===u?{role:"assistant",content:`\uC694\uCCAD \uC2E4\uD328: ${R}`}:b)),p("Error")}finally{w(!1)}},V=Math.max(J-4,20),Q=Ie(s,V,y);return g(x,{flexDirection:"column",children:[g(x,{borderStyle:"round",borderColor:"cyan",paddingX:1,children:[h(f,{color:"cyan",children:"Codiq"}),g(f,{dimColor:!0,children:[" ",`(${z})`]})]}),h(x,{flexDirection:"column",paddingX:1,children:Q.map((i,u)=>g(f,{children:[h(f,{color:Ke(i.role),children:i.prefix}),i.text]},`${u}-${i.role}-${i.prefix}-${i.text}`))}),g(x,{borderStyle:"round",borderColor:"green",paddingX:1,children:[h(f,{color:"green",children:"> "}),h(Oe,{value:a,onChange:m,onSubmit:()=>{G()},placeholder:y?"\uC751\uB2F5 \uC0DD\uC131 \uC911...":"\uBA54\uC2DC\uC9C0\uB97C \uC785\uB825\uD558\uC138\uC694",showCursor:!0})]}),g(x,{justifyContent:"space-between",children:[g(f,{dimColor:!0,children:["Codiq (",z,") | model=",e.model," | status=",P]}),g(f,{dimColor:!0,children:["messages=",s.length]})]}),h(x,{children:h(f,{dimColor:!0,children:Re})})]})}function Ie(t,e,n){return t.flatMap((s,r)=>{let o=`${_e(s.role)}: `,c=" ".repeat(o.length),l=s.content||(n&&r===t.length-1?"...":"");return Fe(l,Math.max(e-o.length,8)).map((m,P)=>({role:s.role,prefix:P===0?o:c,text:m}))})}function Fe(t,e){let n=t.split(`
|
|
9
|
+
`),s=[];for(let r of n){if(r.length===0){s.push("");continue}let o=r;for(;o.length>e;)s.push(o.slice(0,e)),o=o.slice(e);s.push(o)}return s.length>0?s:[""]}function _e(t){switch(t){case"user":return"You";case"assistant":return"AI";default:return"System"}}function Ke(t){switch(t){case"user":return"yellow";case"assistant":return"green";default:return"cyan"}}var K=new Le,ke="https://ollama.com/api/chat",$e="gpt-oss:20b",Ue="\uB2F9\uC2E0\uC740 shell\uC5D0\uC11C \uB3D9\uC791\uD558\uB294 \uD504\uB85C\uC81D\uD2B8 \uBD84\uC11D\uAC00 \uBC0F \uCF54\uB529 \uB3C4\uC6B0\uBBF8\uC785\uB2C8\uB2E4. \uD604\uC7AC \uC791\uC5C5 \uB514\uB809\uD130\uB9AC\uB97C \uAE30\uC900\uC73C\uB85C \uD504\uB85C\uC81D\uD2B8\uB97C \uC774\uD574\uD558\uACE0, \uC0AC\uC6A9\uC790\uC758 \uC9C8\uBB38\uC5D0 \uB9DE\uAC8C \uC124\uBA85, \uBD84\uC11D, \uC218\uC815 \uC81C\uC548\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.";K.command("clear-key").description("\uC800\uC7A5\uB41C Ollama Cloud API Key\uB97C \uC0AD\uC81C\uD569\uB2C8\uB2E4.").action(async()=>{if(await j()){console.log("\uC800\uC7A5\uB41C Ollama Cloud API Key\uB97C \uC0AD\uC81C\uD588\uC2B5\uB2C8\uB2E4.");return}console.log("\uC0AD\uC81C\uD560 \uC800\uC7A5\uB41C Ollama Cloud API Key\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.")});K.name("codiq").description("A simple Ollama Cloud CLI tool").version("1.0.0").argument("[prompt...]","\uC9C8\uBB38 \uB0B4\uC6A9").option("-m, --model <model>","\uBAA8\uB378\uBA85",$e).option("-u, --base-url <url>","API URL",ke).option("-s, --system <text>","System \uD504\uB86C\uD504\uD2B8",Ue).option("--stream","\uC2A4\uD2B8\uB9AC\uBC0D \uCD9C\uB825",!0).action(async(t,e)=>{let n=t.join(" ").trim(),s=await k();if(n){let r=T(e.system,process.cwd()),{history:o}=await O(r,n,process.cwd());await M(n,{...e,apiKey:s,onToken:c=>{process.stdout.write(c)}},o),process.stdout.write(`
|
|
10
|
+
`);return}De(s,e)});await K.parseAsync();function De(t,e){ve(je.createElement(Y,{apiKey:t,options:e}),{exitOnCtrlC:!0})}
|