opencode-navigator 0.19.2 → 0.20.0

package/dist/project-profile.js

@@ -0,0 +1,280 @@
+import {randomUUID} from "crypto"
+import {lstat,mkdir,readFile,realpath,rename,unlink,writeFile} from "fs/promises"
+import {join,resolve} from "path"
+var SIDEBAR_SECTIONS=["limits","todo","subagents","skills","quick_actions","lsp","mcp"]
+var QUICK_ACTION_IDS=["session.rename","session.timeline","session.copy","session.export","session.compact","session.list","session.new","session.fork","messages.copy","session.first","session.last","session.messages_last_user","session.message.next","session.message.previous","permission.mode"]
+function parseQuickActionOrder(value){if(!Array.isArray(value))
+return
+const order=[...new Set(value.filter((id)=>QUICK_ACTION_IDS.includes(id)))]
+return [...order,...QUICK_ACTION_IDS.filter((id)=>!order.includes(id))]
+}
+function parseQuickActionVisibility(value){if(!value||typeof value!=="object"||Array.isArray(value))
+return{}
+const input=value
+return Object.fromEntries(QUICK_ACTION_IDS.flatMap((id)=>typeof input[id]==="boolean"?[[id,input[id]]]:[]))
+}
+function parseSectionOrder(value){if(!Array.isArray(value))
+return
+const seen=new Set
+const order=[]
+for(const candidate of value){if(!SIDEBAR_SECTIONS.includes(candidate)||seen.has(candidate))
+continue
+seen.add(candidate)
+order.push(candidate)
+}
+for(const section of SIDEBAR_SECTIONS){if(!seen.has(section)){if(section==="limits")
+order.unshift(section)
+else
+order.push(section)
+}}
+return order
+}
+function parseSectionPreferences(value){if(!value||typeof value!=="object"||Array.isArray(value))
+return{}
+const input=value
+return Object.fromEntries(SIDEBAR_SECTIONS.flatMap((name)=>typeof input[name]==="boolean"?[[name,input[name]]]:[]))
+}
+function parseSectionLayout(value){if(!value||typeof value!=="object"||Array.isArray(value))
+return
+const input=value
+const sections=parseSectionPreferences(input.sections)
+const expanded=parseSectionPreferences(input.expanded)
+const order=parseSectionOrder(input.order)
+if(Object.keys(sections).length===0&&Object.keys(expanded).length===0&&!order)
+return
+return{sections,expanded,...order&&{order}}}
+function parseSectionItemLimits(value){if(!value||typeof value!=="object"||Array.isArray(value))
+return{}
+const input=value
+return Object.fromEntries(SIDEBAR_SECTIONS.flatMap((section)=>{const limit=input[section]
+return typeof limit==="number"&&Number.isSafeInteger(limit)&&limit>=0?[[section,limit]]:[]
+}))
+}
+var PLUGIN_ID="opencode-navigator"
+var TOGGLE_COMMAND=`${PLUGIN_ID}.toggle`
+var FOCUS_COMMAND=`${PLUGIN_ID}.focus`
+var SEARCH_COMMAND=`${PLUGIN_ID}.search`;
+function record(value){if(!value||typeof value!=="object"||Array.isArray(value))
+return
+return value
+}
+function parsePluginSettings(value){const input=record(value)
+if(!input)
+return{}
+return{...typeof input.toggleKey==="string"&&input.toggleKey.trim()&&{toggleKey:input.toggleKey.trim()},...typeof input.focusKey==="string"&&input.focusKey.trim()&&{focusKey:input.focusKey.trim()},...typeof input.searchKey==="string"&&input.searchKey.trim()&&{searchKey:input.searchKey.trim()},...typeof input.persistMcp==="boolean"&&{persistMcp:input.persistMcp},...typeof input.startInChat==="boolean"&&{startInChat:input.startInChat},...typeof input.showSessionTitle==="boolean"&&{showSessionTitle:input.showSessionTitle},...typeof input.showSessionDate==="boolean"&&{showSessionDate:input.showSessionDate},...typeof input.cornerFont==="boolean"&&{cornerFont:input.cornerFont},...(input.lspIconStyle==="nerd"||input.lspIconStyle==="text")&&{lspIconStyle:input.lspIconStyle},...(input.rowDensity==="compact"||input.rowDensity==="comfortable")&&{rowDensity:input.rowDensity
+},...Object.keys(parseSectionItemLimits(input.sectionItemLimits)).length>0&&{sectionItemLimits:parseSectionItemLimits(input.sectionItemLimits)
+},...parseQuickActionOrder(input.quickActionOrder)&&{quickActionOrder:parseQuickActionOrder(input.quickActionOrder)
+},...Object.keys(parseQuickActionVisibility(input.quickActionVisibility)).length>0&&{quickActionVisibility:parseQuickActionVisibility(input.quickActionVisibility)
+}}}
+function parseLayoutPresets(value){const input=record(value)
+if(!input)
+return{}
+const presets={}
+const entries=Object.entries(input).sort(([left],[right])=>left.localeCompare(right))
+for(const [candidate,preset] of entries){const name=candidate.trim().slice(0,64)
+const layout=parseSectionLayout(preset)
+if(name&&layout&&Object.keys(presets).length<50)
+presets[name]=layout
+}
+return presets
+}
+function parseDesiredMcpStates(value){const input=record(value)
+if(!input)
+return{}
+return Object.fromEntries(Object.entries(input).filter((entry)=>Boolean(entry[0])&&(entry[1]==="enabled"||entry[1]==="disabled")).sort(([left],[right])=>left.localeCompare(right)))
+}
+function parseMcpPresets(value){const input=record(value)
+if(!input)
+return{}
+const presets={}
+const names=new Set
+const entries=Object.entries(input).sort(([left],[right])=>left.localeCompare(right))
+for(const [candidate,preset] of entries){const name=candidate.trim().slice(0,64)
+const states=parseDesiredMcpStates(preset)
+const key=name.toLocaleLowerCase()
+if(name&&!names.has(key)&&Object.keys(states).length>0&&Object.keys(presets).length<50){names.add(key)
+presets[name]=states
+}}
+return presets
+}
+function parseMcpServerGroups(value){const input=record(value)
+if(!input)
+return{}
+return Object.fromEntries(Object.entries(input).flatMap(([server,rawGroup])=>{const group=typeof rawGroup==="string"?rawGroup.trim().slice(0,64):""
+return server.trim()&&group?[[server,group]]:[]
+}))
+}
+function parseWorkspaceProfiles(value){return Object.fromEntries(Object.entries(record(value)??{}).flatMap(([layout,rawMcp])=>{const layoutName=layout.trim().slice(0,64)
+const mcpName=typeof rawMcp==="string"?rawMcp.trim().slice(0,64):""
+return layoutName&&mcpName?[[layoutName,mcpName]]:[]
+}).slice(0,50))
+}
+function record2(value){if(!value||typeof value!=="object"||Array.isArray(value))
+return
+return value
+}
+function present(value){return value&&Object.keys(value).length>0
+}
+function parseConfiguredDefaults(value){const input=record2(value)
+if(!input)
+throw new Error("Expected a JSON object")
+const behavior=parsePluginSettings(input.behavior)
+const layout=parseSectionLayout(input.layout)
+const desiredMcpStates=parseDesiredMcpStates(input.mcp??input.desiredMcpStates)
+const layoutPresets=parseLayoutPresets(input.layoutPresets)
+const mcpPresets=parseMcpPresets(input.mcpPresets)
+const workspaceProfiles=parseWorkspaceProfiles(input.workspaceProfiles)
+const mcpServerGroups=parseMcpServerGroups(input.mcpServerGroups)
+return{...present(behavior)&&{behavior},...layout&&{layout},...present(desiredMcpStates)&&{desiredMcpStates},...present(layoutPresets)&&{layoutPresets},...present(mcpPresets)&&{mcpPresets},...present(workspaceProfiles)&&{workspaceProfiles},...present(mcpServerGroups)&&{mcpServerGroups}}}
+var PORTABLE_SETTINGS_FORMAT="opencode-navigator/settings"
+function object(value,path){if(!value||typeof value!=="object"||Array.isArray(value))
+throw new Error(`${path} must be an object`)
+return value
+}
+function pointer(path,key){return `${path}/${key.replaceAll("~", "~0").replaceAll("/", "~1")}`
+}
+function unknownKeys(input,allowed,path,output){for(const key of Object.keys(input))
+if(!allowed.includes(key))
+output.push(pointer(path,key))
+}
+function parseVisibility(value,path,unsupported){const input=object(value,path)
+return Object.fromEntries(Object.entries(input).flatMap(([name,visible])=>{if(!SIDEBAR_SECTIONS.includes(name)){unsupported.push(pointer(path,name))
+return []
+}
+if(typeof visible!=="boolean")
+throw new Error(`${pointer(path, name)} must be a boolean`)
+return [[name,visible]]
+}))
+}
+function parseLayout(value,unsupported){const input=object(value,"/layout")
+unknownKeys(input,["sections","expanded","order"],"/layout",unsupported)
+const sections=input.sections===undefined?{}:parseVisibility(input.sections,"/layout/sections",unsupported)
+const expanded=input.expanded===undefined?{}:parseVisibility(input.expanded,"/layout/expanded",unsupported)
+let order
+if(input.order!==undefined){if(!Array.isArray(input.order))
+throw new Error("/layout/order must be an array")
+const supported=[]
+const seen=new Set
+for(const [index,name] of input.order.entries()){if(typeof name!=="string")
+throw new Error(`/layout/order/${index} must be a section name`)
+if(!SIDEBAR_SECTIONS.includes(name))
+unsupported.push(`/layout/order/${index}`)
+else if(seen.has(name))
+throw new Error(`/layout/order/${index} duplicates ${name}`)
+else{seen.add(name)
+supported.push(name)
+}}
+order=parseSectionOrder(supported)
+}
+return{sections,expanded,...order&&{order}}}
+function parseMcp(value){const input=object(value,"/mcp")
+return Object.fromEntries(Object.entries(input).map(([name,state])=>{if(!name.trim())
+throw new Error("/mcp contains an empty server name")
+if(state!=="enabled"&&state!=="disabled"){throw new Error(`${pointer("/mcp", name)} must be enabled or disabled`)
+}
+return [name,state]
+}).sort(([left],[right])=>left.localeCompare(right)))
+}
+function parsePortableSettings(source){let value
+try{value=JSON.parse(source)
+} catch(error){throw new Error("Malformed settings JSON",{cause:error})
+}
+const input=object(value,"Settings JSON")
+if(input.format!==PORTABLE_SETTINGS_FORMAT)
+throw new Error(`Expected format ${PORTABLE_SETTINGS_FORMAT}`)
+if(input.version!==1)
+throw new Error(`Unsupported settings version ${String(input.version)}`)
+const unsupported=[]
+unknownKeys(input,["format","version","layout","mcp"],"",unsupported)
+const hasLayout=Object.hasOwn(input,"layout")
+const hasMcp=Object.hasOwn(input,"mcp")
+if(!hasLayout&&!hasMcp)
+throw new Error("Settings JSON contains no supported settings")
+const settings={format:PORTABLE_SETTINGS_FORMAT,version:1,...hasLayout&&{layout:parseLayout(input.layout,unsupported)},...hasMcp&&{mcp:parseMcp(input.mcp)}}
+unsupported.sort()
+return{settings,unsupported}}
+var FILENAME=join(".opencode","navigator.json")
+var PRIVATE_KEYS=new Set(["favoriteSkills","favoriteMcpServers","favoriteQuickActions","skillGroups","recentSkills","recentQuickActions","skippedSkillConfirmations","onboardingCompleted","codexAccountBindings","pendingResetAttempt","lastNavigatorVersion","previousNavigatorVersion","worktrees","user"])
+function object2(value){if(!value||typeof value!=="object"||Array.isArray(value))
+throw new Error("Project settings must be an object")
+return value
+}
+async function readProject(file){const info=await lstat(file).catch((error)=>{if(error.code==="ENOENT")
+return
+throw error
+})
+if(info?.isSymbolicLink()||info&&!info.isFile())
+throw new Error("Project settings must be a regular file")
+try{return await readFile(file,"utf8")
+} catch(error){if(error.code==="ENOENT")
+return
+throw error
+}}
+function parseProject(source){if(source===undefined)
+return{}
+const input=object2(JSON.parse(source))
+const keys=Object.keys(input)
+for(const key of keys){if(PRIVATE_KEYS.has(key))
+throw new Error(`Project settings contain private field ${key}`)
+}
+parseConfiguredDefaults(input)
+return input
+}
+async function previewProjectProfile(root,nameInput,source,replace=false){const directory=await realpath(resolve(root))
+const name=nameInput.trim()
+if(!name||name.length>64)
+throw new Error("Profile names must contain 1\u201364 characters")
+if(name.includes("/")||name.includes("\\")||name.startsWith("~")){throw new Error("Profile names must not contain private paths")
+}
+const parsed=parsePortableSettings(source)
+const layout=parsed.settings.layout&&parseSectionLayout(parsed.settings.layout)
+if(!layout)
+throw new Error("A project profile needs a layout")
+const servers=Object.keys(parsed.settings.mcp??{})
+for(const server of servers){if(server.includes("/")||server.includes("\\")||server.startsWith("~")){throw new Error(`MCP server name looks like a private path: ${server}`)
+}}
+const file=join(directory,FILENAME)
+const before=await readProject(file)
+const existing=parseProject(before)
+const layouts=object2(existing.layoutPresets??{})
+const mcpPresets=object2(existing.mcpPresets??{})
+const profiles=object2(existing.workspaceProfiles??{})
+const collision=Object.keys(layouts).find((candidate)=>candidate.toLocaleLowerCase()===name.toLocaleLowerCase())
+if(collision&&(!replace||collision!==name))
+throw new Error(`Project profile already exists: ${collision}`)
+if(!collision&&Object.keys(layouts).length>=50)
+throw new Error("Project profiles are full")
+const hasMcp=Boolean(parsed.settings.mcp&&servers.length>0)
+if(hasMcp&&!replace&&mcpPresets[name]){throw new Error(`Project MCP preset already exists: ${name}`)
+}
+if(hasMcp&&mcpPresets[name]&&Object.entries(profiles).some(([layoutName,mcpName])=>layoutName!==name&&mcpName===name)){throw new Error(`MCP preset ${name} is linked to another project profile`)
+}
+const next={...existing,layoutPresets:{...layouts,[name]:layout},...hasMcp&&{mcpPresets:{...mcpPresets,[name]:parsed.settings.mcp},workspaceProfiles:{...profiles,[name]:name}}}
+if(!hasMcp&&profiles[name]&&replace){next.workspaceProfiles=Object.fromEntries(Object.entries(profiles).filter(([key])=>key!==name))
+}
+parseConfiguredDefaults(next)
+return{root:directory,file,name,before,after:`${JSON.stringify(next, undefined, 2)}
+`,layout,mcp:parsed.settings.mcp,skipped:parsed.unsupported
+}}
+async function saveProjectProfile(preview,root){if(await realpath(resolve(root))!==preview.root)
+throw new Error("Workspace changed; preview again")
+const configDirectory=join(preview.root,".opencode")
+await mkdir(configDirectory,{recursive:true})
+const directoryInfo=await lstat(configDirectory)
+if(!directoryInfo.isDirectory()||directoryInfo.isSymbolicLink()){throw new Error("Project configuration directory must not be a symlink")
+}
+if(await readProject(preview.file)!==preview.before)
+throw new Error("Project settings changed; preview again")
+const temporary=`${preview.file}.${randomUUID()}.tmp`
+try{await writeFile(temporary,preview.after,{flag:"wx",mode:384})
+if(await readProject(preview.file)!==preview.before)
+throw new Error("Project settings changed; preview again")
+await rename(temporary,preview.file)
+} finally{await unlink(temporary).catch((error)=>{if(error.code!=="ENOENT")
+throw error
+})
+}
+return preview.file
+}
+export{previewProjectProfile,saveProjectProfile
+}