@shawnstack/quickforge 1.0.0

package/dist/assets/prompt-dialog-B4BD09Oc.js

@@ -0,0 +1 @@
+import{i as e}from"./chunk-62oNxeRG.js";import{f as t,m as n,n as r,p as i,r as a,t as o}from"./index-CK_34smc.js";var s=i(),c=t(),l=e(n(),1),u=r(),d=l.forwardRef(({className:e,type:t,...n},r)=>(0,u.jsx)(`input`,{type:t,className:a(`flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50`,e),ref:r,...n}));d.displayName=`Input`;function f({options:e,onResolve:t}){let n=(0,l.useRef)(null),[r,i]=(0,l.useState)(e.defaultValue??``),c=(0,l.useRef)(r);return(0,l.useEffect)(()=>{c.current=r},[r]),(0,l.useEffect)(()=>{n.current?.focus(),n.current?.select()},[]),(0,l.useEffect)(()=>{let e=e=>{e.key===`Escape`&&t(null),e.key===`Enter`&&c.current.trim()&&t(c.current.trim())};return document.addEventListener(`keydown`,e),()=>document.removeEventListener(`keydown`,e)},[t]),(0,s.createPortal)((0,u.jsx)(`div`,{className:`fixed inset-0 z-50 flex items-center justify-center bg-black/50`,onClick:e=>{e.target===e.currentTarget&&t(null)},children:(0,u.jsxs)(`div`,{className:a(`w-full max-w-sm rounded-lg border border-border bg-background p-6 shadow-lg`,`mx-4`),children:[(0,u.jsx)(`h2`,{className:`text-base font-semibold text-foreground`,children:e.title}),e.description?(0,u.jsx)(`p`,{className:`mt-2 text-sm text-muted-foreground`,children:e.description}):null,(0,u.jsx)(`div`,{className:`mt-4`,children:(0,u.jsx)(d,{ref:n,value:r,onChange:e=>i(e.target.value),placeholder:e.placeholder,className:`w-full`})}),(0,u.jsxs)(`div`,{className:`mt-5 flex justify-end gap-2`,children:[(0,u.jsx)(o,{variant:`outline`,size:`sm`,onClick:()=>t(null),children:e.cancelLabel??`Cancel`}),(0,u.jsx)(o,{size:`sm`,onClick:()=>r.trim()?t(r.trim()):void 0,disabled:!r.trim(),children:e.confirmLabel??`Save`})]})]})}),document.body)}function p(e){return new Promise(t=>{let n=document.createElement(`div`);document.body.appendChild(n);let r=(0,c.createRoot)(n);function i(){r.unmount(),setTimeout(()=>n.remove(),0)}function a(e){i(),t(e)}r.render((0,u.jsx)(f,{options:e,onResolve:a}))})}export{p as showPrompt};

package/dist/assets/transform-messages-BFwlToJ0.js

@@ -0,0 +1 @@
+function e(e){return e.replace(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g,``)}function t(e,t,n){return{temperature:t?.temperature,maxTokens:t?.maxTokens??(e.maxTokens>0?Math.min(e.maxTokens,32e3):void 0),signal:t?.signal,apiKey:n||t?.apiKey,cacheRetention:t?.cacheRetention,sessionId:t?.sessionId,headers:t?.headers,onPayload:t?.onPayload,onResponse:t?.onResponse,timeoutMs:t?.timeoutMs,maxRetries:t?.maxRetries,maxRetryDelayMs:t?.maxRetryDelayMs,metadata:t?.metadata}}function n(e){return e===`xhigh`?`high`:e}function r(e,t,r,i){let a={minimal:1024,low:2048,medium:8192,high:16384,...i}[n(r)],o=Math.min(e+a,t);return o<=a&&(a=Math.max(0,o-1024)),{maxTokens:o,thinkingBudget:a}}var i=`(image omitted: model does not support images)`,a=`(tool image omitted: model does not support images)`;function o(e,t){let n=[],r=!1;for(let i of e){if(i.type===`image`){r||n.push({type:`text`,text:t}),r=!0;continue}n.push(i),r=i.text===t}return n}function s(e,t){return t.input.includes(`image`)?e:e.map(e=>e.role===`user`&&Array.isArray(e.content)?{...e,content:o(e.content,i)}:e.role===`toolResult`?{...e,content:o(e.content,a)}:e)}function c(e,t,n){let r=new Map,i=s(e,t).map(e=>{if(e.role===`user`)return e;if(e.role===`toolResult`){let t=r.get(e.toolCallId);return t&&t!==e.toolCallId?{...e,toolCallId:t}:e}if(e.role===`assistant`){let i=e,a=i.provider===t.provider&&i.api===t.api&&i.model===t.id,o=i.content.flatMap(e=>{if(e.type===`thinking`)return e.redacted?a?e:[]:a&&e.thinkingSignature?e:!e.thinking||e.thinking.trim()===``?[]:a?e:{type:`text`,text:e.thinking};if(e.type===`text`)return a?e:{type:`text`,text:e.text};if(e.type===`toolCall`){let o=e,s=o;if(!a&&o.thoughtSignature&&(s={...o},delete s.thoughtSignature),!a&&n){let e=n(o.id,t,i);e!==o.id&&(r.set(o.id,e),s={...s,id:e})}return s}return e});return{...i,content:o}}return e}),a=[],o=[],c=new Set,l=()=>{if(o.length>0){for(let e of o)c.has(e.id)||a.push({role:`toolResult`,toolCallId:e.id,toolName:e.name,content:[{type:`text`,text:`No result provided`}],isError:!0,timestamp:Date.now()});o=[],c=new Set}};for(let e=0;e<i.length;e++){let t=i[e];if(t.role===`assistant`){l();let e=t;if(e.stopReason===`error`||e.stopReason===`aborted`)continue;let n=e.content.filter(e=>e.type===`toolCall`);n.length>0&&(o=n,c=new Set),a.push(t)}else t.role===`toolResult`?(c.add(t.toolCallId),a.push(t)):(t.role===`user`&&l(),a.push(t))}return l(),a}export{e as a,n as i,r as n,t as r,c as t};

package/dist/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="46" fill="none" viewBox="0 0 48 46"><path fill="#863bff" d="M25.946 44.938c-.664.845-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.287c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.497 0-3.578-1.842-3.578H1.237c-.92 0-1.456-1.04-.92-1.788L10.013.474c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.579 1.842 3.579h11.377c.943 0 1.473 1.088.89 1.83L25.947 44.94z" style="fill:#863bff;fill:color(display-p3 .5252 .23 1);fill-opacity:1"/><mask id="a" width="48" height="46" x="0" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M25.842 44.938c-.664.844-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.183c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.498 0-3.579-1.842-3.579H1.133c-.92 0-1.456-1.04-.92-1.787L9.91.473c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.578 1.842 3.578h11.377c.943 0 1.473 1.088.89 1.832L25.843 44.94z" style="fill:#000;fill-opacity:1"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#ede6ff" rx="5.508" ry="14.704" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -4.47 31.516)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#ede6ff" rx="10.399" ry="29.851" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -39.328 7.883)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#7e14ff" rx="5.508" ry="30.487" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -25.913 -14.639)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -32.644 -3.334)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -34.34 30.47)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#ede6ff" rx="14.072" ry="22.078" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="rotate(93.35 24.506 48.493)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx=".387" cy="8.972" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(39.51 .387 8.972)"/></g><g filter="url(#k)"><ellipse cx="47.523" cy="-6.092" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 47.523 -6.092)"/></g><g filter="url(#l)"><ellipse cx="41.412" cy="6.333" fill="#47bfff" rx="5.971" ry="9.665" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 41.412 6.333)"/></g><g filter="url(#m)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#n)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#o)"><ellipse cx="35.651" cy="29.907" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 35.651 29.907)"/></g><g filter="url(#p)"><ellipse cx="38.418" cy="32.4" fill="#47bfff" rx="5.971" ry="15.297" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 38.418 32.4)"/></g></g><defs><filter id="b" width="60.045" height="41.654" x="-19.77" y="16.149" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-54.613" y="-7.533" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-49.64" y="2.03" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-45.045" y="20.029" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-43.513" y="21.178" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="15.756" y="-17.901" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-27.636" y="-22.853" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="20.116" y="-38.415" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="24.641" y="-11.323" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="8.244" y="-2.416" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="18.713" y="10.588" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter></defs></svg>

package/dist/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>速构 QuickForge</title>
+    <script type="module" crossorigin src="/assets/index-CK_34smc.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/chunk-62oNxeRG.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-BQJ8qi1U.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@shawnstack/quickforge",
+  "version": "1.0.0",
+  "description": "AI chat application with YOLO-mode local workspace tools. React + Vite + Tailwind CSS frontend, local Node.js storage server.",
+  "keywords": [
+    "ai",
+    "chat",
+    "llm",
+    "claude",
+    "openai",
+    "anthropic",
+    "litellm",
+    "react",
+    "vite",
+    "tailwindcss",
+    "yolo",
+    "workspace",
+    "tools"
+  ],
+  "author": "shawn <1524587436@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shawnstack/quickforge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shawnstack/quickforge/issues"
+  },
+  "homepage": "https://github.com/shawnstack/quickforge#readme",
+  "type": "module",
+  "bin": {
+    "quickforge": "bin/quickforge.mjs",
+    "qf": "bin/quickforge.mjs"
+  },
+  "files": [
+    "bin",
+    "server",
+    "dist",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "dev": "node server/index.mjs --dev",
+    "dev:web": "vite --host 127.0.0.1 --port 5176 --strictPort",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "start": "node server/index.mjs",
+    "preview": "node server/index.mjs"
+  },
+  "dependencies": {
+    "@mariozechner/mini-lit": "^0.2.1",
+    "@mariozechner/pi-agent-core": "^0.70.5",
+    "@mariozechner/pi-ai": "^0.70.5",
+    "@mariozechner/pi-web-ui": "^0.70.5",
+    "@tailwindcss/vite": "^4.2.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lit": "^3.3.2",
+    "lucide-react": "^1.11.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "tailwind-merge": "^3.5.0",
+    "tailwindcss": "^4.2.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.12.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^10.2.1",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.5.0",
+    "typescript": "~6.0.2",
+    "typescript-eslint": "^8.58.2",
+    "vite": "^8.0.10"
+  }
+}

package/server/index.mjs

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { createServer } from 'node:http'
+import { spawn } from 'node:child_process'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { sendJson, sendError } from './utils/response.mjs'
+import { openBrowser } from './utils/platform.mjs'
+import { migrateLegacyDataDirs, ensureStorage, dataDir, storageDir } from './storage.mjs'
+import { setDefaultWorkspaceRoot, initializeActiveProject, readProjectConfig, getActiveProject } from './project-config.mjs'
+import { getWorkspaceRoot } from './utils/workspace.mjs'
+import { handleStorageApi } from './routes/storage.mjs'
+import { handleProjectApi } from './routes/project.mjs'
+import { handleFilesystemApi } from './routes/filesystem.mjs'
+import { handleToolApi } from './routes/tools.mjs'
+import { handleInstructionsApi } from './routes/instructions.mjs'
+import { serveStatic } from './routes/static.mjs'
+import { setActiveWorkspaceRootForFilesystem } from './routes/filesystem.mjs'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const projectRoot = path.resolve(__dirname, '..')
+
+const isDev = process.argv.includes('--dev')
+const host = process.env.QUICKFORGE_HOST || process.env.FASTCODE_HOST || '127.0.0.1'
+const port = Number(process.env.QUICKFORGE_PORT || process.env.FASTCODE_PORT || (isDev ? 32176 : 5176))
+const vitePort = Number(process.env.QUICKFORGE_VITE_PORT || process.env.FASTCODE_VITE_PORT || 5176)
+
+setDefaultWorkspaceRoot(process.env.QUICKFORGE_WORKSPACE_DIR || process.env.FASTCODE_WORKSPACE_DIR || projectRoot)
+
+// --- Route dispatching ---
+async function handleApi(req, res, url) {
+  const pathname = url.pathname
+  const parts = pathname.split('/').filter(Boolean)
+
+  // Health check
+  if (req.method === 'GET' && pathname === '/api/health') {
+    const config = await readProjectConfig()
+    sendJson(res, 200, {
+      ok: true,
+      mode: isDev ? 'development' : 'production',
+      dataDir,
+      storageDir,
+      workspaceRoot: getWorkspaceRoot(),
+      project: getActiveProject(config),
+    })
+    return
+  }
+
+  // Instructions
+  if (req.method === 'GET' && pathname === '/api/instructions') {
+    await handleInstructionsApi(req, res, url)
+    return
+  }
+
+  // Project routes
+  if (pathname === '/api/project' || pathname.startsWith('/api/project/')) {
+    await handleProjectApi(req, res, url)
+    return
+  }
+
+  // Filesystem routes
+  if (pathname === '/api/filesystem' || pathname.startsWith('/api/filesystem/')) {
+    await handleFilesystemApi(req, res, url)
+    return
+  }
+
+  // Tool routes
+  if (pathname.startsWith('/api/tools/') || (parts[0] === 'api' && parts[1] === 'projects' && parts[3] === 'tools')) {
+    await handleToolApi(req, res, url)
+    return
+  }
+
+  // Storage routes (catch-all)
+  if (parts[0] === 'api' && parts[1] === 'storage') {
+    await handleStorageApi(req, res, url)
+    return
+  }
+
+  const error = new Error('Not found')
+  error.statusCode = 404
+  throw error
+}
+
+// --- Vite dev server ---
+function startVite() {
+  const viteCli = path.join(projectRoot, 'node_modules', 'vite', 'bin', 'vite.js')
+  const child = spawn(process.execPath, [viteCli, '--host', '127.0.0.1', '--port', String(vitePort), '--strictPort'], {
+    cwd: projectRoot,
+    stdio: 'inherit',
+    shell: false,
+    env: { ...process.env, QUICKFORGE_SERVER_PORT: String(port) },
+  })
+  child.on('exit', (code) => {
+    if (code && code !== 0) process.exitCode = code
+  })
+  process.on('exit', () => child.kill())
+  process.on('SIGINT', () => {
+    child.kill('SIGINT')
+    process.exit(0)
+  })
+  process.on('SIGTERM', () => {
+    child.kill('SIGTERM')
+    process.exit(0)
+  })
+}
+
+// --- Bootstrap ---
+const server = createServer(async (req, res) => {
+  try {
+    const url = new URL(req.url || '/', `http://${req.headers.host || `${host}:${port}`}`)
+    if (url.pathname.startsWith('/api/')) {
+      await handleApi(req, res, url)
+      return
+    }
+
+    if (isDev) {
+      res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' })
+      res.end('QuickForge local API server is running. Open the Vite app at http://127.0.0.1:5176')
+      return
+    }
+
+    await serveStatic(req, res, url)
+  } catch (error) {
+    console.error(error)
+    sendError(res, error)
+  }
+})
+
+await migrateLegacyDataDirs()
+await ensureStorage()
+await initializeActiveProject()
+setActiveWorkspaceRootForFilesystem(getWorkspaceRoot())
+
+server.listen(port, host, () => {
+  console.log(`QuickForge local API: http://${host}:${port}`)
+  console.log(`QuickForge data dir: ${dataDir}`)
+  console.log(`QuickForge project: ${getWorkspaceRoot()}`)
+
+  if (isDev) {
+    startVite()
+    setTimeout(() => openBrowser(`http://localhost:${vitePort}`), 1000)
+  } else {
+    openBrowser(`http://localhost:${port}`)
+  }
+})

package/server/project-config.mjs

@@ -0,0 +1,125 @@
+import path from 'node:path'
+import { randomUUID } from 'node:crypto'
+import { ensureStorage, projectConfigFile, dataDir } from './storage.mjs'
+import { promises as fs } from 'node:fs'
+import { setWorkspaceRoot, getWorkspaceRoot, assertDirectory } from './utils/workspace.mjs'
+
+let defaultWorkspaceRoot = ''
+
+export function setDefaultWorkspaceRoot(root) {
+  defaultWorkspaceRoot = path.resolve(root)
+}
+
+function projectNameFromPath(dir) {
+  return path.basename(dir) || dir
+}
+
+function defaultProjectConfig() {
+  const now = new Date().toISOString()
+  const id = 'default'
+  return {
+    activeProjectId: id,
+    projects: [
+      {
+        id,
+        name: projectNameFromPath(defaultWorkspaceRoot),
+        path: defaultWorkspaceRoot,
+        lastOpenedAt: now,
+      },
+    ],
+  }
+}
+
+export async function readProjectConfig() {
+  await ensureStorage()
+  const file = projectConfigFile()
+  try {
+    const text = await fs.readFile(file, 'utf8')
+    const parsed = text.trim() ? JSON.parse(text) : defaultProjectConfig()
+    if (!Array.isArray(parsed.projects) || parsed.projects.length === 0) return defaultProjectConfig()
+    return parsed
+  } catch (error) {
+    if (error?.code === 'ENOENT') return defaultProjectConfig()
+    throw error
+  }
+}
+
+export async function writeProjectConfig(config) {
+  await ensureStorage()
+  const file = projectConfigFile()
+  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`
+  await fs.writeFile(tmp, `${JSON.stringify(config, null, 2)}\n`, 'utf8')
+  await fs.rename(tmp, file)
+}
+
+export function getActiveProject(config) {
+  return config.projects.find((project) => project.id === config.activeProjectId) || config.projects[0]
+}
+
+export async function setActiveProjectPath(inputPath) {
+  const resolved = path.resolve(String(inputPath || ''))
+  await assertDirectory(resolved)
+
+  const config = await readProjectConfig()
+  const now = new Date().toISOString()
+  let project = config.projects.find((item) => path.resolve(item.path) === resolved)
+  if (!project) {
+    project = {
+      id: randomUUID(),
+      name: projectNameFromPath(resolved),
+      path: resolved,
+      lastOpenedAt: now,
+    }
+    config.projects.unshift(project)
+  } else {
+    project.name = projectNameFromPath(resolved)
+    project.path = resolved
+    project.lastOpenedAt = now
+  }
+
+  config.activeProjectId = project.id
+  config.projects = [project, ...config.projects.filter((item) => item.id !== project.id)].slice(0, 20)
+  await writeProjectConfig(config)
+  setWorkspaceRoot(resolved)
+  return { project, projects: config.projects }
+}
+
+export async function initializeActiveProject() {
+  const config = await readProjectConfig()
+  const activeProject = getActiveProject(config)
+  if (activeProject?.path) {
+    try {
+      await assertDirectory(activeProject.path)
+      setWorkspaceRoot(path.resolve(activeProject.path))
+      return
+    } catch {
+      // Fall back to the app project if the stored project was removed.
+    }
+  }
+
+  const fallback = await setActiveProjectPath(defaultWorkspaceRoot)
+  setWorkspaceRoot(path.resolve(fallback.project.path))
+}
+
+export async function projectContextFromId(projectId) {
+  const config = await readProjectConfig()
+  const project = config.projects.find((item) => item.id === projectId)
+  if (!project) {
+    const error = new Error('Unknown project')
+    error.statusCode = 404
+    throw error
+  }
+
+  await assertDirectory(project.path)
+  return { project, workspaceRoot: path.resolve(project.path) }
+}
+
+export async function readInstructionsFile(filePath) {
+  try {
+    const content = await fs.readFile(filePath, 'utf8')
+    const trimmed = content.trim()
+    return trimmed || null
+  } catch {
+    return null
+  }
+}

package/server/routes/filesystem.mjs

@@ -0,0 +1,87 @@
+import os from 'node:os'
+import path from 'node:path'
+import { promises as fs } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { sendJson } from '../utils/response.mjs'
+import { pathExists, assertDirectory } from '../utils/workspace.mjs'
+
+const __filename = fileURLToPath(import.meta.url)
+const projectRoot = path.resolve(path.dirname(__filename), '../..')
+let _activeWorkspaceRoot = projectRoot
+
+export function setActiveWorkspaceRootForFilesystem(root) {
+  _activeWorkspaceRoot = path.resolve(root)
+}
+
+async function getFilesystemRoots() {
+  const roots = []
+  const addRoot = async (name, rootPath) => {
+    if (!rootPath) return
+    const resolved = path.resolve(rootPath)
+    if (!(await pathExists(resolved))) return
+    if (roots.some((entry) => path.resolve(entry.path) === resolved)) return
+    roots.push({ name, path: resolved })
+  }
+
+  const home = os.homedir()
+  await addRoot('Home', home)
+  await addRoot('Desktop', path.join(home, 'Desktop'))
+  await addRoot('Documents', path.join(home, 'Documents'))
+  await addRoot('QuickForge', projectRoot)
+  await addRoot('Current project', _activeWorkspaceRoot)
+
+  if (process.platform === 'win32') {
+    for (let code = 65; code <= 90; code += 1) {
+      const drive = `${String.fromCharCode(code)}:\\`
+      await addRoot(drive, drive)
+    }
+  } else {
+    await addRoot('Filesystem', '/')
+    if (process.platform === 'darwin' && (await pathExists('/Volumes'))) {
+      const volumes = await fs.readdir('/Volumes', { withFileTypes: true }).catch(() => [])
+      for (const volume of volumes) {
+        if (volume.isDirectory() || volume.isSymbolicLink()) {
+          await addRoot(volume.name, path.join('/Volumes', volume.name))
+        }
+      }
+    }
+  }
+
+  return roots
+}
+
+async function listFilesystemDirectories(inputPath) {
+  const requestedPath = String(inputPath || os.homedir())
+  const resolved = path.resolve(requestedPath)
+  await assertDirectory(resolved)
+
+  const entries = await fs.readdir(resolved, { withFileTypes: true }).catch((error) => {
+    error.statusCode = error?.code === 'EACCES' || error?.code === 'EPERM' ? 403 : 400
+    throw error
+  })
+
+  const directories = entries
+    .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+    .map((entry) => ({ name: entry.name, path: path.join(resolved, entry.name) }))
+    .sort((left, right) => left.name.localeCompare(right.name, undefined, { sensitivity: 'base' }))
+
+  const parsed = path.parse(resolved)
+  const parent = resolved === parsed.root ? null : path.dirname(resolved)
+  return { path: resolved, parent, directories }
+}
+
+export async function handleFilesystemApi(req, res, url) {
+  if (req.method === 'GET' && url.pathname === '/api/filesystem/roots') {
+    sendJson(res, 200, { roots: await getFilesystemRoots() })
+    return
+  }
+
+  if (req.method === 'GET' && url.pathname === '/api/filesystem/directories') {
+    sendJson(res, 200, await listFilesystemDirectories(url.searchParams.get('path')))
+    return
+  }
+
+  const error = new Error('Not found')
+  error.statusCode = 404
+  throw error
+}

package/server/routes/instructions.mjs

@@ -0,0 +1,31 @@
+import path from 'node:path'
+import { sendJson } from '../utils/response.mjs'
+import { readInstructionsFile, projectContextFromId } from '../project-config.mjs'
+import { dataDir } from '../storage.mjs'
+
+export async function handleInstructionsApi(req, res, url) {
+  if (req.method !== 'GET') {
+    const error = new Error('Method not allowed')
+    error.statusCode = 405
+    throw error
+  }
+
+  const projectId = url.searchParams.get('projectId')
+  let projectInstructions = null
+
+  if (projectId) {
+    try {
+      const { workspaceRoot } = await projectContextFromId(projectId)
+      projectInstructions = await readInstructionsFile(path.join(workspaceRoot, 'AGENTS.md'))
+    } catch {
+      // project not found or inaccessible — leave projectInstructions null
+    }
+  }
+
+  const globalInstructions = await readInstructionsFile(path.join(dataDir, 'AGENTS.md'))
+
+  sendJson(res, 200, {
+    global: globalInstructions,
+    project: projectInstructions,
+  })
+}

package/server/routes/project.mjs

@@ -0,0 +1,76 @@
+import { sendJson, readJsonBody, decodeSegment } from '../utils/response.mjs'
+import { getActiveProject, setActiveProjectPath, readProjectConfig, writeProjectConfig } from '../project-config.mjs'
+import { getWorkspaceRoot, setWorkspaceRoot } from '../utils/workspace.mjs'
+import { selectDirectoryDialog } from '../utils/platform.mjs'
+import path from 'node:path'
+
+export async function handleProjectApi(req, res, url) {
+  const config = await readProjectConfig()
+
+  if (req.method === 'GET' && url.pathname === '/api/project') {
+    sendJson(res, 200, { project: getActiveProject(config), projects: config.projects, workspaceRoot: getWorkspaceRoot() })
+    return
+  }
+
+  if (req.method === 'POST' && url.pathname === '/api/project/select-directory') {
+    console.log('[project] Opening directory picker dialog...')
+    const selectedPath = await selectDirectoryDialog()
+    console.log('[project] Directory picker result:', selectedPath ? `"${selectedPath}"` : '(cancelled/empty)')
+    if (!selectedPath) {
+      sendJson(res, 200, { cancelled: true, project: getActiveProject(config), projects: config.projects })
+      return
+    }
+    const result = await setActiveProjectPath(selectedPath)
+    sendJson(res, 200, { cancelled: false, ...result, workspaceRoot: getWorkspaceRoot() })
+    return
+  }
+
+  if (req.method === 'POST' && url.pathname === '/api/project/path') {
+    const body = await readJsonBody(req)
+    const result = await setActiveProjectPath(body?.path)
+    sendJson(res, 200, { ...result, workspaceRoot: getWorkspaceRoot() })
+    return
+  }
+
+  if (req.method === 'POST' && url.pathname === '/api/project/active') {
+    const body = await readJsonBody(req)
+    const selected = config.projects.find((project) => project.id === body?.id)
+    if (!selected) {
+      const error = new Error('Unknown project')
+      error.statusCode = 404
+      throw error
+    }
+    const result = await setActiveProjectPath(selected.path)
+    sendJson(res, 200, { ...result, workspaceRoot: getWorkspaceRoot() })
+    return
+  }
+
+  if (req.method === 'DELETE' && url.pathname.startsWith('/api/project/')) {
+    const id = decodeSegment(url.pathname.split('/').filter(Boolean)[2])
+    const nextProjects = config.projects.filter((project) => project.id !== id)
+    if (nextProjects.length === config.projects.length) {
+      const error = new Error('Unknown project')
+      error.statusCode = 404
+      throw error
+    }
+    config.projects = nextProjects.length ? nextProjects : defaultProjectConfigFallback().projects
+    if (config.activeProjectId === id) config.activeProjectId = config.projects[0].id
+    await writeProjectConfig(config)
+    const active = getActiveProject(config)
+    setWorkspaceRoot(path.resolve(active.path))
+    sendJson(res, 200, { project: active, projects: config.projects, workspaceRoot: getWorkspaceRoot() })
+    return
+  }
+
+  const error = new Error('Not found')
+  error.statusCode = 404
+  throw error
+}
+
+function defaultProjectConfigFallback() {
+  const fallbackPath = getWorkspaceRoot()
+  return {
+    activeProjectId: 'default',
+    projects: [{ id: 'default', name: path.basename(fallbackPath) || 'QuickForge', path: fallbackPath, lastOpenedAt: new Date().toISOString() }],
+  }
+}

package/server/routes/static.mjs

@@ -0,0 +1,57 @@
+import path from 'node:path'
+import { promises as fs } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const projectRoot = path.resolve(path.dirname(__filename), '../..')
+
+function getContentType(filePath) {
+  const extension = path.extname(filePath).toLowerCase()
+  return {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+  }[extension] || 'application/octet-stream'
+}
+
+export async function serveStatic(req, res, url) {
+  const distDir = path.join(projectRoot, 'dist')
+  const requested = decodeURIComponent(url.pathname === '/' ? '/index.html' : url.pathname)
+  const normalized = path.normalize(requested).replace(/^([.][.][\/])+/, '')
+  let filePath = path.join(distDir, normalized)
+
+  if (!filePath.startsWith(distDir)) {
+    res.writeHead(403)
+    res.end('Forbidden')
+    return
+  }
+
+  try {
+    const stat = await fs.stat(filePath)
+    if (stat.isDirectory()) filePath = path.join(filePath, 'index.html')
+  } catch {
+    filePath = path.join(distDir, 'index.html')
+  }
+
+  try {
+    const data = await fs.readFile(filePath)
+    res.writeHead(200, {
+      'content-type': getContentType(filePath),
+      'cache-control': filePath.endsWith('index.html') ? 'no-cache' : 'public, max-age=31536000, immutable',
+    })
+    res.end(data)
+  } catch {
+    res.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' })
+    res.end('Build output not found. Run npm run build first.')
+  }
+}