openpencil/apps/desktop/dev.ts
Kayshen Xu 3caaa495bb
V0.5.2 (#82)
* feat(ai): scaffold pen-ai-skills package

* feat(ai): add pen-ai-skills core types

* feat(ai): add Vite plugin for skill file compilation

* feat(ai): add budget module with token estimation and category-priority trimming

* feat(ai): add skill loader with phase filtering and test injection

* feat(ai): add skill resolver with phase filter, intent match, and dynamic injection

* feat(ai): migrate all prompt content to skill files

Extract prompt content from 7 TypeScript source files into 27 Markdown
skill files with proper frontmatter. Each file contains phase, trigger,
priority, budget, and category metadata for the skill resolution engine.

Planning: decomposition, design-type
Generation: jsonl-format, jsonl-format-simplified, schema, layout,
  text-rules, overflow, style-defaults, variables, design-system,
  design-code, design-md
Validation: vision-feedback
Maintenance: local-edit, incremental-add, style-consistency
Domains: landing-page, dashboard, mobile-app, form-ui, cjk-typography
Knowledge: role-definitions, design-principles, icon-catalog,
  copywriting, examples

* feat(ai): add document context memory module

* feat(ai): add generation history memory module

* feat(ai): wire memory loading into skill resolver

Add memory field to ResolveOptions and load documentContext/generationHistory
into AgentContext with per-phase limits (planning:5, maintenance:3, others:0).
Export memory utility functions from package index.

* refactor(ai): use resolveSkills('planning') in orchestrator

Replace ORCHESTRATOR_PROMPT import with resolveSkills() from pen-ai-skills.
The planning phase system prompt is now resolved dynamically from skill
files instead of a static constant.

* refactor(ai): use resolveSkills('generation') in sub-agent

Replace SUB_AGENT_PROMPT + designPrinciples concatenation with
resolveSkills() from pen-ai-skills. The generation phase system prompt
is now resolved dynamically with flag-based skill filtering for
variables and design.md context.

* refactor(ai): use resolveSkills('validation') in design validation

Replace the 70-line inline VALIDATION_SYSTEM_PROMPT constant with a
lazy resolver function that loads the validation prompt from pen-ai-skills
skill files at call time.

* refactor(mcp): use skill registry for design prompt sections

* refactor(ai): remove old prompt files replaced by pen-ai-skills

Delete prompt files whose content has been migrated to the
pen-ai-skills package:
- ai-prompt-sections.ts (section registry, triggers, builders)
- orchestrator-prompts.ts (orchestrator + sub-agent prompts)
- design-system-prompts.ts (design token generation prompt)
- design-code-prompts.ts (HTML/CSS code-gen prompt)
- design-principles/ directory (5 principle files + index)

Consolidate role-definitions/ 8 sub-files into index.ts
(registerRole calls are runtime behavior, must be preserved).

Move buildDesignMdStylePolicy into ai-prompts.ts. Strip migrated
constants (PEN_NODE_SCHEMA, DESIGN_EXAMPLES, ADAPTIVE_STYLE_POLICY,
CHAT_SYSTEM_PROMPT, DESIGN_GENERATOR_PROMPT, etc.) from ai-prompts.ts.

Add pen-ai-skills alias to mcp:compile esbuild script.

* docs: add pen-ai-skills to architecture documentation

* fix(mcp): use h3 v2 createEventStream API for SSE endpoint

event.node.res was removed in h3 v2. Migrate to createEventStream
which handles SSE headers, streaming, and cleanup automatically.

* chore: update package versions and add pen-ai-skills to Dockerfile

- Bump version for multiple packages to 0.5.2, including pen-ai-skills, pen-codegen, pen-core, pen-figma, pen-renderer, pen-sdk, and pen-types.
- Add pen-ai-skills package to Dockerfile for inclusion in the build process.
- Update TypeScript configuration to ensure proper file inclusion.
- Modify GitHub Actions workflow to trigger on version tags.
- Enhance AI-related functionality by integrating resolveAgentModel for dynamic model resolution in chat and generation APIs.

* refactor: clean up unused imports and improve dynamic content handling

- Removed unused imports from various files, including SkillMeta and ResolvedSkill from types.test.ts, and estimateTokens from resolve-skills.ts.
- Updated the dynamic content injection function to use a more concise parameter in the regex replacement callback.

* chore: enhance build and CI workflows with skill generation

- Added a new script to generate the skill registry during post-installation in package.json.
- Updated the GitHub Actions workflows to include steps for compiling the CLI and generating the skill registry, ensuring all necessary components are built and ready for deployment.

---------

Co-authored-by: Fini <fini.yang@gmail.com>
2026-03-24 21:16:28 +08:00

141 lines
3.9 KiB
TypeScript

/**
* Electron development workflow orchestrator.
*
* 1. Start Vite dev server (bun run dev)
* 2. Wait for it to be ready on port 3000
* 3. Compile electron/ with esbuild
* 4. Launch Electron pointing at the dev server
*/
import { spawn, execSync, type ChildProcess } from 'node:child_process'
import { build } from 'esbuild'
import { join } from 'node:path'
import { compileSkills } from '../../packages/pen-ai-skills/vite-plugin-skills'
const DESKTOP_DIR = import.meta.dirname
const ROOT = join(DESKTOP_DIR, '..', '..')
const VITE_DEV_PORT = 3000
// ---------------------------------------------------------------------------
// Helpers
// ---------------------------------------------------------------------------
async function waitForServer(
url: string,
timeoutMs = 30_000,
): Promise<void> {
const start = Date.now()
while (Date.now() - start < timeoutMs) {
try {
const res = await fetch(url)
if (res.ok || res.status < 500) return
} catch {
// server not ready yet
}
await new Promise((r) => setTimeout(r, 500))
}
throw new Error(`Timeout waiting for ${url}`)
}
async function compileElectron(): Promise<void> {
const common: Parameters<typeof build>[0] = {
platform: 'node',
bundle: true,
sourcemap: true,
external: ['electron'],
target: 'node20',
outdir: join(ROOT, 'out', 'desktop'),
outExtension: { '.js': '.cjs' },
format: 'cjs' as const,
}
await Promise.all([
build({
...common,
entryPoints: [join(DESKTOP_DIR, 'main.ts')],
}),
build({
...common,
entryPoints: [join(DESKTOP_DIR, 'preload.ts')],
}),
])
console.log('[electron-dev] Electron files compiled')
}
// ---------------------------------------------------------------------------
// Main
// ---------------------------------------------------------------------------
async function main(): Promise<void> {
// 1. Start Vite dev server
console.log('[electron-dev] Starting Vite dev server...')
const vite = spawn('bun', ['--bun', 'run', 'dev'], {
cwd: ROOT,
stdio: 'inherit',
env: { ...process.env },
})
// Ensure cleanup on exit
const cleanup = () => {
if (process.platform === 'win32' && vite.pid) {
try {
execSync(`taskkill /pid ${vite.pid} /T /F`, { stdio: 'ignore' })
} catch { /* ignore */ }
} else {
vite.kill()
}
process.exit()
}
process.on('SIGINT', cleanup)
process.on('SIGTERM', cleanup)
// 2. Wait for Vite to be ready
console.log(`[electron-dev] Waiting for Vite on port ${VITE_DEV_PORT}...`)
await waitForServer(`http://localhost:${VITE_DEV_PORT}`)
console.log('[electron-dev] Vite is ready')
// 3. Compile MCP server + Electron files
compileSkills(join(ROOT, 'packages', 'pen-ai-skills'))
console.log('[electron-dev] Compiling MCP server...')
await build({
platform: 'node',
bundle: true,
sourcemap: true,
target: 'node20',
format: 'cjs',
entryPoints: [join(ROOT, 'apps', 'web', 'src', 'mcp', 'server.ts')],
outfile: join(ROOT, 'out', 'mcp-server.cjs'),
alias: { '@': join(ROOT, 'apps', 'web', 'src') },
define: { 'import.meta.env': '{}' },
external: ['canvas', 'paper'],
})
console.log('[electron-dev] MCP server compiled')
await compileElectron()
// 4. Launch Electron
console.log('[electron-dev] Starting Electron...')
const electronBin = join(ROOT, 'node_modules', '.bin', 'electron')
const electron = spawn(electronBin, [join(ROOT, 'out', 'desktop', 'main.cjs')], {
cwd: ROOT,
stdio: 'inherit',
env: { ...process.env },
}) as ChildProcess
electron.on('exit', () => {
if (process.platform === 'win32' && vite.pid) {
try {
execSync(`taskkill /pid ${vite.pid} /T /F`, { stdio: 'ignore' })
} catch { /* ignore */ }
} else {
vite.kill()
}
process.exit()
})
}
main().catch((err) => {
console.error(err)
process.exit(1)
})