@pixelbyte-software/pixcode 1.51.2 → 1.51.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.
Files changed (331) hide show
  1. package/CODE_OF_CONDUCT.md +41 -41
  2. package/CONTRIBUTING.md +155 -155
  3. package/LICENSE +718 -718
  4. package/README.de.md +169 -169
  5. package/README.ja.md +167 -167
  6. package/README.ko.md +167 -167
  7. package/README.md +419 -419
  8. package/README.ru.md +169 -169
  9. package/README.tr.md +298 -298
  10. package/README.zh-CN.md +167 -167
  11. package/SECURITY.md +46 -46
  12. package/dist/api-automation.html +110 -110
  13. package/dist/api-docs.html +548 -548
  14. package/dist/assets/index-B9N-gfOQ.css +32 -0
  15. package/dist/assets/{index-EN9ngyxf.js → index-HfGHXhD6.js} +175 -175
  16. package/dist/clear-cache.html +85 -85
  17. package/dist/convert-icons.md +52 -52
  18. package/dist/docs.html +308 -308
  19. package/dist/favicon.svg +8 -8
  20. package/dist/features.html +133 -133
  21. package/dist/generate-icons.js +48 -48
  22. package/dist/humans.txt +15 -15
  23. package/dist/icons/codex-white.svg +3 -3
  24. package/dist/icons/codex.svg +3 -3
  25. package/dist/icons/cursor-white.svg +11 -11
  26. package/dist/icons/icon-128x128.svg +9 -9
  27. package/dist/icons/icon-144x144.svg +9 -9
  28. package/dist/icons/icon-152x152.svg +9 -9
  29. package/dist/icons/icon-192x192.svg +9 -9
  30. package/dist/icons/icon-384x384.svg +9 -9
  31. package/dist/icons/icon-512x512.svg +9 -9
  32. package/dist/icons/icon-72x72.svg +9 -9
  33. package/dist/icons/icon-96x96.svg +9 -9
  34. package/dist/icons/icon-template.svg +9 -9
  35. package/dist/icons/qwen-logo.svg +14 -14
  36. package/dist/index.html +59 -59
  37. package/dist/landing.html +268 -268
  38. package/dist/llms-full.txt +119 -119
  39. package/dist/llms.txt +53 -53
  40. package/dist/logo.svg +12 -12
  41. package/dist/manifest.json +60 -60
  42. package/dist/openapi.yaml +1696 -1696
  43. package/dist/orchestration.html +125 -125
  44. package/dist/robots.txt +4 -4
  45. package/dist/site.css +692 -692
  46. package/dist/sitemap.xml +51 -51
  47. package/dist/sw.js +132 -132
  48. package/dist-server/server/cli.js +96 -96
  49. package/dist-server/server/daemon/manager.js +33 -33
  50. package/dist-server/server/daemon-manager.js +64 -64
  51. package/dist-server/server/database/db.js +14 -2
  52. package/dist-server/server/database/db.js.map +1 -1
  53. package/dist-server/server/index.js +191 -31
  54. package/dist-server/server/index.js.map +1 -1
  55. package/dist-server/server/middleware/auth.js +16 -5
  56. package/dist-server/server/middleware/auth.js.map +1 -1
  57. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.js +84 -0
  58. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.js.map +1 -0
  59. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.test.js +43 -0
  60. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.test.js.map +1 -0
  61. package/dist-server/server/modules/orchestration/hermes/hermes.routes.js +55 -1
  62. package/dist-server/server/modules/orchestration/hermes/hermes.routes.js.map +1 -1
  63. package/dist-server/server/modules/orchestration/index.js +1 -0
  64. package/dist-server/server/modules/orchestration/index.js.map +1 -1
  65. package/dist-server/server/routes/auth.js +12 -5
  66. package/dist-server/server/routes/auth.js.map +1 -1
  67. package/dist-server/server/routes/commands.js +25 -25
  68. package/dist-server/server/routes/git.js +29 -17
  69. package/dist-server/server/routes/git.js.map +1 -1
  70. package/dist-server/server/routes/live-view.js +46 -46
  71. package/dist-server/server/routes/platformization.js +7 -6
  72. package/dist-server/server/routes/platformization.js.map +1 -1
  73. package/dist-server/server/services/hermes-gateway.js +310 -0
  74. package/dist-server/server/services/hermes-gateway.js.map +1 -1
  75. package/dist-server/server/services/platformization.js +58 -2
  76. package/dist-server/server/services/platformization.js.map +1 -1
  77. package/dist-server/server/services/public-api-manifest.js +59 -51
  78. package/dist-server/server/services/public-api-manifest.js.map +1 -1
  79. package/package.json +222 -222
  80. package/scripts/fix-node-pty.js +67 -67
  81. package/scripts/github/create-v1.38-issues.mjs +351 -351
  82. package/scripts/github/create-vscode-workbench-issues.mjs +121 -121
  83. package/scripts/hermes/configure-pixcode-mcp.mjs +165 -163
  84. package/scripts/hermes/pixcode-mcp-server.mjs +1009 -958
  85. package/scripts/smoke/changes-panel-layout.mjs +48 -48
  86. package/scripts/smoke/chat-composer-fixed-layout.mjs +55 -55
  87. package/scripts/smoke/chat-message-timeline-order.mjs +41 -41
  88. package/scripts/smoke/chat-realtime-hydration.mjs +44 -44
  89. package/scripts/smoke/chat-session-provider-pools.mjs +35 -35
  90. package/scripts/smoke/chat-session-state.mjs +19 -19
  91. package/scripts/smoke/code-editor-theme.mjs +55 -55
  92. package/scripts/smoke/code-editor-vscode-engine.mjs +91 -91
  93. package/scripts/smoke/command-center-agent-writes.mjs +79 -79
  94. package/scripts/smoke/command-center-non-git.mjs +46 -46
  95. package/scripts/smoke/context-packet.mjs +43 -43
  96. package/scripts/smoke/control-room-ux-redesign.mjs +91 -91
  97. package/scripts/smoke/daemon-entrypoint.mjs +20 -20
  98. package/scripts/smoke/default-landing-routing.mjs +33 -33
  99. package/scripts/smoke/desktop-native-notifications.mjs +30 -30
  100. package/scripts/smoke/desktop-tray-icon.mjs +33 -33
  101. package/scripts/smoke/discord-release-workflow.mjs +24 -24
  102. package/scripts/smoke/git-install-update.mjs +255 -255
  103. package/scripts/smoke/handoff-artifact-protocol.mjs +50 -50
  104. package/scripts/smoke/hermes-api-install.mjs +56 -56
  105. package/scripts/smoke/hermes-gateway-persistence.mjs +104 -104
  106. package/scripts/smoke/hermes-mcp-pixcode-roundtrip.mjs +426 -367
  107. package/scripts/smoke/hermes-rest-chat-api.mjs +162 -162
  108. package/scripts/smoke/hermes-rest-chat-live.mjs +45 -45
  109. package/scripts/smoke/hermes-rest-codex-launch.mjs +209 -209
  110. package/scripts/smoke/hermes-rest-gateway.mjs +79 -70
  111. package/scripts/smoke/hermes-rest-live.mjs +42 -42
  112. package/scripts/smoke/hermes-roundtrip.mjs +167 -167
  113. package/scripts/smoke/hermes-settings-commands.mjs +349 -346
  114. package/scripts/smoke/hermes-smoke-launcher-guard.mjs +34 -34
  115. package/scripts/smoke/live-view-diagnostics.mjs +53 -53
  116. package/scripts/smoke/live-view-environment.mjs +92 -92
  117. package/scripts/smoke/live-view-integration.mjs +450 -450
  118. package/scripts/smoke/mac-desktop-runtime.mjs +37 -37
  119. package/scripts/smoke/mobile-tunnel-guidance.mjs +29 -29
  120. package/scripts/smoke/model-registry.mjs +36 -36
  121. package/scripts/smoke/multi-project-ui.mjs +45 -45
  122. package/scripts/smoke/multi-worker-slots.mjs +42 -42
  123. package/scripts/smoke/notification-center.mjs +87 -87
  124. package/scripts/smoke/notification-inapp-preference.mjs +23 -23
  125. package/scripts/smoke/notification-taxonomy.mjs +58 -58
  126. package/scripts/smoke/orchestration-api.mjs +172 -172
  127. package/scripts/smoke/orchestration-execution-dashboard.mjs +33 -33
  128. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  129. package/scripts/smoke/orchestration-mobile-scroll.mjs +29 -29
  130. package/scripts/smoke/orchestration-model-sync.mjs +30 -30
  131. package/scripts/smoke/orchestration-permission-fallback.mjs +34 -34
  132. package/scripts/smoke/orchestration-runtime-guards.mjs +48 -48
  133. package/scripts/smoke/orchestration-user-facing-output.mjs +25 -25
  134. package/scripts/smoke/permission-policy.mjs +50 -50
  135. package/scripts/smoke/pixcode-workbench-1-48.mjs +167 -167
  136. package/scripts/smoke/provider-models-opencode-live.mjs +66 -66
  137. package/scripts/smoke/provider-rest-api.mjs +124 -124
  138. package/scripts/smoke/provider-selection-status.mjs +52 -52
  139. package/scripts/smoke/run-state-refresh.mjs +52 -52
  140. package/scripts/smoke/runtime-manager.mjs +99 -99
  141. package/scripts/smoke/shell-manual-disconnect.mjs +30 -30
  142. package/scripts/smoke/side-panel-editor-layout.mjs +34 -34
  143. package/scripts/smoke/static-root-routing.mjs +21 -21
  144. package/scripts/smoke/strict-handoff-compact.mjs +60 -60
  145. package/scripts/smoke/taskmaster-config.mjs +24 -24
  146. package/scripts/smoke/taskmaster-execution-telegram.mjs +3 -3
  147. package/scripts/smoke/taskmaster-onboarding.mjs +3 -3
  148. package/scripts/smoke/taskmaster-run-graph.mjs +3 -3
  149. package/scripts/smoke/telegram-control.mjs +242 -242
  150. package/scripts/smoke/tunnel-persistence.mjs +56 -56
  151. package/scripts/smoke/update-issue-progress.mjs +69 -69
  152. package/scripts/smoke/update-ux.mjs +55 -55
  153. package/scripts/smoke/v138-completion.mjs +132 -132
  154. package/scripts/smoke/v138-desktop-release-hardening.mjs +69 -69
  155. package/scripts/smoke/v138-diagnostics.mjs +63 -63
  156. package/scripts/smoke/v138-issue-planner.mjs +33 -33
  157. package/scripts/smoke/v143-remote-control.mjs +76 -76
  158. package/scripts/smoke/v144-production-loop.mjs +47 -47
  159. package/scripts/smoke/v145-platformization.mjs +46 -46
  160. package/scripts/smoke/v146-control-room-ui.mjs +150 -150
  161. package/scripts/smoke/version-modal-autoshow.mjs +29 -29
  162. package/scripts/smoke/vscode-workbench-layout.mjs +63 -63
  163. package/scripts/smoke/vscode-workbench-polish.mjs +461 -436
  164. package/scripts/smoke/workflow-fallback-replay.mjs +56 -56
  165. package/scripts/smoke/workflow-templates.mjs +43 -43
  166. package/scripts/smoke/workflow-trace-timeline.mjs +46 -46
  167. package/scripts/update-git-install.mjs +293 -293
  168. package/server/claude-sdk.js +920 -920
  169. package/server/cli.js +1039 -1039
  170. package/server/constants/config.js +4 -4
  171. package/server/cursor-cli.js +344 -344
  172. package/server/daemon/manager.js +563 -563
  173. package/server/daemon-manager.js +964 -964
  174. package/server/database/db.js +908 -895
  175. package/server/database/json-store.js +197 -197
  176. package/server/gemini-cli.js +550 -550
  177. package/server/gemini-response-handler.js +79 -79
  178. package/server/index.js +201 -30
  179. package/server/load-env.js +35 -35
  180. package/server/middleware/auth.js +171 -156
  181. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  182. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +63 -63
  183. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +286 -286
  184. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  185. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  186. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  187. package/server/modules/orchestration/a2a/adapters/json-event.adapter.test.ts +60 -0
  188. package/server/modules/orchestration/a2a/adapters/json-event.adapter.ts +101 -0
  189. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  190. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  191. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  192. package/server/modules/orchestration/a2a/routes.ts +590 -590
  193. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  194. package/server/modules/orchestration/a2a/types.ts +126 -126
  195. package/server/modules/orchestration/a2a/validator.ts +113 -113
  196. package/server/modules/orchestration/hermes/hermes.routes.ts +642 -583
  197. package/server/modules/orchestration/index.ts +101 -100
  198. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  199. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  200. package/server/modules/orchestration/preview/types.ts +19 -19
  201. package/server/modules/orchestration/security/permission-policy.ts +401 -401
  202. package/server/modules/orchestration/tasks/orchestration-task-store.ts +41 -41
  203. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +64 -64
  204. package/server/modules/orchestration/tasks/orchestration-task.service.ts +209 -209
  205. package/server/modules/orchestration/tasks/orchestration-task.types.ts +40 -40
  206. package/server/modules/orchestration/tasks/task-run-graph.ts +155 -155
  207. package/server/modules/orchestration/workflows/approval-queue.ts +106 -106
  208. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  209. package/server/modules/orchestration/workflows/context-packet.ts +186 -186
  210. package/server/modules/orchestration/workflows/handoff-artifact.ts +175 -175
  211. package/server/modules/orchestration/workflows/workflow-fallback-policy.ts +161 -161
  212. package/server/modules/orchestration/workflows/workflow-replay.ts +254 -254
  213. package/server/modules/orchestration/workflows/workflow-runner.ts +2070 -2070
  214. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  215. package/server/modules/orchestration/workflows/workflow-templates.ts +272 -272
  216. package/server/modules/orchestration/workflows/workflow-trace.ts +424 -424
  217. package/server/modules/orchestration/workflows/workflow.routes.ts +586 -586
  218. package/server/modules/orchestration/workflows/workflow.types.ts +111 -111
  219. package/server/modules/orchestration/workflows/workspace-target.ts +122 -122
  220. package/server/modules/orchestration/workspace/docker-workspace.ts +136 -136
  221. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  222. package/server/modules/orchestration/workspace/types.ts +52 -52
  223. package/server/modules/orchestration/workspace/workspace-manager.ts +102 -102
  224. package/server/modules/orchestration/workspace/worktree-workspace.ts +126 -126
  225. package/server/modules/providers/index.ts +2 -2
  226. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -146
  227. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  228. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  229. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  230. package/server/modules/providers/list/codex/codex-auth.provider.ts +117 -117
  231. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  232. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  233. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  234. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +147 -147
  235. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  236. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  237. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  238. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +173 -173
  239. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  240. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  241. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  242. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -131
  243. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  244. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +286 -286
  245. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  246. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -146
  247. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  248. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  249. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  250. package/server/modules/providers/provider.registry.ts +40 -40
  251. package/server/modules/providers/provider.routes.ts +944 -944
  252. package/server/modules/providers/services/mcp.service.ts +86 -86
  253. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  254. package/server/modules/providers/services/sessions.service.ts +45 -45
  255. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  256. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  257. package/server/modules/providers/shared/provider-configs.ts +142 -142
  258. package/server/modules/providers/tests/mcp.test.ts +293 -293
  259. package/server/openai-codex.js +462 -462
  260. package/server/opencode-cli.js +491 -491
  261. package/server/opencode-response-handler.js +111 -111
  262. package/server/projects.js +3008 -3008
  263. package/server/qwen-code-cli.js +410 -410
  264. package/server/qwen-response-handler.js +73 -73
  265. package/server/routes/agent.js +1435 -1435
  266. package/server/routes/auth.js +154 -146
  267. package/server/routes/codex.js +20 -20
  268. package/server/routes/commands.js +570 -570
  269. package/server/routes/cursor.js +61 -61
  270. package/server/routes/diagnostics.js +41 -41
  271. package/server/routes/gemini.js +25 -25
  272. package/server/routes/git.js +1650 -1635
  273. package/server/routes/live-view.js +411 -411
  274. package/server/routes/mcp-utils.js +13 -13
  275. package/server/routes/messages.js +62 -62
  276. package/server/routes/network.js +125 -125
  277. package/server/routes/platformization.js +198 -197
  278. package/server/routes/plugins.js +320 -320
  279. package/server/routes/production-agent-loop.js +90 -90
  280. package/server/routes/projects.js +917 -917
  281. package/server/routes/public-api.js +34 -34
  282. package/server/routes/qwen.js +27 -27
  283. package/server/routes/remote.js +55 -55
  284. package/server/routes/settings.js +321 -321
  285. package/server/routes/telegram.js +140 -140
  286. package/server/routes/user.js +125 -125
  287. package/server/routes/webhooks.js +63 -63
  288. package/server/services/control-room.js +102 -102
  289. package/server/services/diagnostics.js +165 -165
  290. package/server/services/external-access.js +375 -375
  291. package/server/services/hermes-gateway.js +1562 -1247
  292. package/server/services/hermes-install-jobs.js +729 -729
  293. package/server/services/install-jobs.js +715 -715
  294. package/server/services/live-view.js +956 -956
  295. package/server/services/managed-runtimes.js +493 -493
  296. package/server/services/model-registry.js +144 -144
  297. package/server/services/notification-orchestrator.js +365 -365
  298. package/server/services/notification-taxonomy.js +204 -204
  299. package/server/services/platformization.js +844 -779
  300. package/server/services/production-agent-loop.js +248 -248
  301. package/server/services/provider-cli-versions.js +149 -149
  302. package/server/services/provider-credentials.js +189 -189
  303. package/server/services/provider-models.js +396 -396
  304. package/server/services/public-api-manifest.js +190 -182
  305. package/server/services/remote-connection.js +127 -127
  306. package/server/services/runtime-manager.js +323 -323
  307. package/server/services/startup-update.js +234 -234
  308. package/server/services/telegram/bot.js +331 -331
  309. package/server/services/telegram/control-center.js +979 -979
  310. package/server/services/telegram/telegram-http-client.js +151 -151
  311. package/server/services/telegram/translations.js +340 -340
  312. package/server/services/vapid-keys.js +36 -36
  313. package/server/services/webhooks.js +216 -216
  314. package/server/sessionManager.js +225 -225
  315. package/server/shared/interfaces.ts +54 -54
  316. package/server/shared/types.ts +172 -172
  317. package/server/shared/utils.ts +193 -193
  318. package/server/tsconfig.json +36 -36
  319. package/server/utils/colors.js +21 -21
  320. package/server/utils/commandParser.js +305 -305
  321. package/server/utils/frontmatter.js +18 -18
  322. package/server/utils/gitConfig.js +34 -34
  323. package/server/utils/plugin-loader.js +457 -457
  324. package/server/utils/plugin-process-manager.js +185 -185
  325. package/server/utils/port-access.js +209 -209
  326. package/server/utils/runtime-paths.js +37 -37
  327. package/server/utils/url-detection.js +71 -71
  328. package/server/vite-daemon.js +79 -79
  329. package/shared/modelConstants.js +161 -161
  330. package/shared/networkHosts.js +22 -22
  331. package/dist/assets/index-DMz0zv6T.css +0 -32
@@ -1,41 +1,41 @@
1
- # Code of Conduct
2
-
3
- ## Our Pledge
4
-
5
- Pixcode is an open-source project for developers who want a practical,
6
- self-hosted workspace for AI coding agents. We want discussion, issues, reviews,
7
- and contributions to stay useful, respectful, and focused on improving the
8
- project.
9
-
10
- ## Expected Behavior
11
-
12
- - Be respectful when discussing bugs, design choices, and tradeoffs.
13
- - Assume good intent, but be concrete when something is wrong.
14
- - Keep issues actionable: include reproduction steps, logs, screenshots, or
15
- environment details when possible.
16
- - Respect maintainers' time by keeping pull requests scoped.
17
- - Avoid sharing private tokens, project paths, customer data, or provider
18
- credentials in public threads.
19
-
20
- ## Unacceptable Behavior
21
-
22
- - Harassment, personal attacks, slurs, threats, or targeted abuse.
23
- - Publishing another person's private information without permission.
24
- - Repeated off-topic comments that derail issue or pull request discussion.
25
- - Posting secrets, malware, exploit payloads, or harmful instructions unrelated
26
- to a responsible security report.
27
- - Any behavior that makes the project unsafe for contributors or users.
28
-
29
- ## Reporting
30
-
31
- If you see conduct problems, report them through GitHub by contacting the
32
- repository maintainers or opening a private security/advisory channel when the
33
- problem includes sensitive information.
34
-
35
- Maintainers may remove comments, close issues, block users, or take other
36
- reasonable actions to keep the project healthy.
37
-
38
- ## Scope
39
-
40
- This code of conduct applies to the Pixcode repository, issue tracker, pull
41
- requests, discussions, release threads, and other project-managed spaces.
1
+ # Code of Conduct
2
+
3
+ ## Our Pledge
4
+
5
+ Pixcode is an open-source project for developers who want a practical,
6
+ self-hosted workspace for AI coding agents. We want discussion, issues, reviews,
7
+ and contributions to stay useful, respectful, and focused on improving the
8
+ project.
9
+
10
+ ## Expected Behavior
11
+
12
+ - Be respectful when discussing bugs, design choices, and tradeoffs.
13
+ - Assume good intent, but be concrete when something is wrong.
14
+ - Keep issues actionable: include reproduction steps, logs, screenshots, or
15
+ environment details when possible.
16
+ - Respect maintainers' time by keeping pull requests scoped.
17
+ - Avoid sharing private tokens, project paths, customer data, or provider
18
+ credentials in public threads.
19
+
20
+ ## Unacceptable Behavior
21
+
22
+ - Harassment, personal attacks, slurs, threats, or targeted abuse.
23
+ - Publishing another person's private information without permission.
24
+ - Repeated off-topic comments that derail issue or pull request discussion.
25
+ - Posting secrets, malware, exploit payloads, or harmful instructions unrelated
26
+ to a responsible security report.
27
+ - Any behavior that makes the project unsafe for contributors or users.
28
+
29
+ ## Reporting
30
+
31
+ If you see conduct problems, report them through GitHub by contacting the
32
+ repository maintainers or opening a private security/advisory channel when the
33
+ problem includes sensitive information.
34
+
35
+ Maintainers may remove comments, close issues, block users, or take other
36
+ reasonable actions to keep the project healthy.
37
+
38
+ ## Scope
39
+
40
+ This code of conduct applies to the Pixcode repository, issue tracker, pull
41
+ requests, discussions, release threads, and other project-managed spaces.
package/CONTRIBUTING.md CHANGED
@@ -1,156 +1,156 @@
1
- # Contributing to Pixcode
2
-
3
- Thanks for your interest in contributing to Pixcode! Before you start, please take a moment to read through this guide.
4
-
5
- ## Before You Start
6
-
7
- - **Search first.** Check [existing issues](https://github.com/alicomert/pixcode/issues) and [pull requests](https://github.com/alicomert/pixcode/pulls) to avoid duplicating work.
8
- - **Discuss first** for new features. Open an [issue](https://github.com/alicomert/pixcode/issues/new) to discuss your idea before investing time in implementation. We may already have plans or opinions on how it should work.
9
- - **Bug fixes are always welcome.** If you spot a bug, feel free to open a PR directly.
10
-
11
- ## Prerequisites
12
-
13
- - [Node.js](https://nodejs.org/) 22 or later
14
- - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and configured
15
-
16
- ## Getting Started
17
-
18
- 1. Fork the repository
19
- 2. Clone your fork:
20
- ```bash
21
- git clone https://github.com/<your-username>/pixcode.git
22
- cd pixcode
23
- ```
24
- 3. Install dependencies:
25
- ```bash
26
- npm install
27
- ```
28
- 4. Start the development server:
29
- ```bash
30
- npm run dev
31
- ```
32
- 5. Create a branch for your changes:
33
- ```bash
34
- git checkout -b feat/your-feature-name
35
- ```
36
-
37
- ## Project Structure
38
-
39
- ```
40
- pixcode/
41
- ├── src/ # React frontend (Vite + Tailwind)
42
- │ ├── components/ # UI components
43
- │ ├── contexts/ # React context providers
44
- │ ├── hooks/ # Custom React hooks
45
- │ ├── i18n/ # Internationalization and translations
46
- │ ├── lib/ # Shared frontend libraries
47
- │ ├── types/ # TypeScript type definitions
48
- │ └── utils/ # Frontend utilities
49
- ├── server/ # Express backend
50
- │ ├── routes/ # API route handlers
51
- │ ├── middleware/ # Express middleware
52
- │ ├── database/ # SQLite database layer
53
- │ └── tools/ # CLI tool integrations
54
- ├── shared/ # Code shared between client and server
55
- └── public/ # Static assets, icons, PWA manifest
56
- ```
57
-
58
- ## Development Workflow
59
-
60
- - `npm run dev` — Start both the frontend and backend in development mode
61
- - `npm run build` — Create a production build
62
- - `npm run server` — Start only the backend server
63
- - `npm run client` — Start only the Vite dev server
64
-
65
- ## Making Changes
66
-
67
- ### Bug Fixes
68
-
69
- - Reference the issue number in your PR if one exists
70
- - Describe how to reproduce the bug in your PR description
71
- - Add a screenshot or recording for visual bugs
72
-
73
- ### New Features
74
-
75
- - Keep the scope focused — one feature per PR
76
- - Include screenshots or recordings for UI changes
77
-
78
- ### Documentation
79
-
80
- - Documentation improvements are always welcome
81
- - Keep language clear and concise
82
-
83
- ## Commit Convention
84
-
85
- We follow [Conventional Commits](https://conventionalcommits.org/) to generate release notes automatically. Every commit message should follow this format:
86
-
87
- ```
88
- <type>(optional scope): <description>
89
- ```
90
-
91
- Use imperative, present tense: "add feature" not "added feature" or "adds feature".
92
-
93
- ### Types
94
-
95
- | Type | Description |
96
- |------|-------------|
97
- | `feat` | A new feature |
98
- | `fix` | A bug fix |
99
- | `perf` | A performance improvement |
100
- | `refactor` | Code change that neither fixes a bug nor adds a feature |
101
- | `docs` | Documentation only |
102
- | `style` | CSS, formatting, visual changes |
103
- | `chore` | Maintenance, dependencies, config |
104
- | `ci` | CI/CD pipeline changes |
105
- | `test` | Adding or updating tests |
106
- | `build` | Build system changes |
107
-
108
- ### Examples
109
-
110
- ```bash
111
- feat: add conversation search
112
- feat(i18n): add Japanese language support
113
- fix: redirect unauthenticated users to login
114
- fix(editor): syntax highlighting for .env files
115
- perf: lazy load code editor component
116
- refactor(chat): extract message list component
117
- docs: update API configuration guide
118
- ```
119
-
120
- ### Breaking Changes
121
-
122
- Add `!` after the type or include `BREAKING CHANGE:` in the commit footer:
123
-
124
- ```bash
125
- feat!: redesign settings page layout
126
- ```
127
-
128
- ## Pull Requests
129
-
130
- - Give your PR a clear, descriptive title following the commit convention above
131
- - Fill in the PR description with what changed and why
132
- - Link any related issues
133
- - Include screenshots for UI changes
134
- - Make sure the build passes (`npm run build`)
135
- - Keep PRs focused — avoid unrelated changes
136
-
137
- ## Releases
138
-
139
- Releases are managed by maintainers using [release-it](https://github.com/release-it/release-it) with the [conventional changelog plugin](https://github.com/release-it/conventional-changelog).
140
-
141
- ```bash
142
- npm run release # interactive (prompts for version bump)
143
- npm run release -- patch # patch release
144
- npm run release -- minor # minor release
145
- ```
146
-
147
- This automatically:
148
- - Bumps the version based on commit types (`feat` = minor, `fix` = patch)
149
- - Generates categorized release notes
150
- - Updates `CHANGELOG.md`
151
- - Creates a git tag and GitHub Release
152
- - Publishes to npm
153
-
154
- ## License
155
-
1
+ # Contributing to Pixcode
2
+
3
+ Thanks for your interest in contributing to Pixcode! Before you start, please take a moment to read through this guide.
4
+
5
+ ## Before You Start
6
+
7
+ - **Search first.** Check [existing issues](https://github.com/alicomert/pixcode/issues) and [pull requests](https://github.com/alicomert/pixcode/pulls) to avoid duplicating work.
8
+ - **Discuss first** for new features. Open an [issue](https://github.com/alicomert/pixcode/issues/new) to discuss your idea before investing time in implementation. We may already have plans or opinions on how it should work.
9
+ - **Bug fixes are always welcome.** If you spot a bug, feel free to open a PR directly.
10
+
11
+ ## Prerequisites
12
+
13
+ - [Node.js](https://nodejs.org/) 22 or later
14
+ - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed and configured
15
+
16
+ ## Getting Started
17
+
18
+ 1. Fork the repository
19
+ 2. Clone your fork:
20
+ ```bash
21
+ git clone https://github.com/<your-username>/pixcode.git
22
+ cd pixcode
23
+ ```
24
+ 3. Install dependencies:
25
+ ```bash
26
+ npm install
27
+ ```
28
+ 4. Start the development server:
29
+ ```bash
30
+ npm run dev
31
+ ```
32
+ 5. Create a branch for your changes:
33
+ ```bash
34
+ git checkout -b feat/your-feature-name
35
+ ```
36
+
37
+ ## Project Structure
38
+
39
+ ```
40
+ pixcode/
41
+ ├── src/ # React frontend (Vite + Tailwind)
42
+ │ ├── components/ # UI components
43
+ │ ├── contexts/ # React context providers
44
+ │ ├── hooks/ # Custom React hooks
45
+ │ ├── i18n/ # Internationalization and translations
46
+ │ ├── lib/ # Shared frontend libraries
47
+ │ ├── types/ # TypeScript type definitions
48
+ │ └── utils/ # Frontend utilities
49
+ ├── server/ # Express backend
50
+ │ ├── routes/ # API route handlers
51
+ │ ├── middleware/ # Express middleware
52
+ │ ├── database/ # SQLite database layer
53
+ │ └── tools/ # CLI tool integrations
54
+ ├── shared/ # Code shared between client and server
55
+ └── public/ # Static assets, icons, PWA manifest
56
+ ```
57
+
58
+ ## Development Workflow
59
+
60
+ - `npm run dev` — Start both the frontend and backend in development mode
61
+ - `npm run build` — Create a production build
62
+ - `npm run server` — Start only the backend server
63
+ - `npm run client` — Start only the Vite dev server
64
+
65
+ ## Making Changes
66
+
67
+ ### Bug Fixes
68
+
69
+ - Reference the issue number in your PR if one exists
70
+ - Describe how to reproduce the bug in your PR description
71
+ - Add a screenshot or recording for visual bugs
72
+
73
+ ### New Features
74
+
75
+ - Keep the scope focused — one feature per PR
76
+ - Include screenshots or recordings for UI changes
77
+
78
+ ### Documentation
79
+
80
+ - Documentation improvements are always welcome
81
+ - Keep language clear and concise
82
+
83
+ ## Commit Convention
84
+
85
+ We follow [Conventional Commits](https://conventionalcommits.org/) to generate release notes automatically. Every commit message should follow this format:
86
+
87
+ ```
88
+ <type>(optional scope): <description>
89
+ ```
90
+
91
+ Use imperative, present tense: "add feature" not "added feature" or "adds feature".
92
+
93
+ ### Types
94
+
95
+ | Type | Description |
96
+ |------|-------------|
97
+ | `feat` | A new feature |
98
+ | `fix` | A bug fix |
99
+ | `perf` | A performance improvement |
100
+ | `refactor` | Code change that neither fixes a bug nor adds a feature |
101
+ | `docs` | Documentation only |
102
+ | `style` | CSS, formatting, visual changes |
103
+ | `chore` | Maintenance, dependencies, config |
104
+ | `ci` | CI/CD pipeline changes |
105
+ | `test` | Adding or updating tests |
106
+ | `build` | Build system changes |
107
+
108
+ ### Examples
109
+
110
+ ```bash
111
+ feat: add conversation search
112
+ feat(i18n): add Japanese language support
113
+ fix: redirect unauthenticated users to login
114
+ fix(editor): syntax highlighting for .env files
115
+ perf: lazy load code editor component
116
+ refactor(chat): extract message list component
117
+ docs: update API configuration guide
118
+ ```
119
+
120
+ ### Breaking Changes
121
+
122
+ Add `!` after the type or include `BREAKING CHANGE:` in the commit footer:
123
+
124
+ ```bash
125
+ feat!: redesign settings page layout
126
+ ```
127
+
128
+ ## Pull Requests
129
+
130
+ - Give your PR a clear, descriptive title following the commit convention above
131
+ - Fill in the PR description with what changed and why
132
+ - Link any related issues
133
+ - Include screenshots for UI changes
134
+ - Make sure the build passes (`npm run build`)
135
+ - Keep PRs focused — avoid unrelated changes
136
+
137
+ ## Releases
138
+
139
+ Releases are managed by maintainers using [release-it](https://github.com/release-it/release-it) with the [conventional changelog plugin](https://github.com/release-it/conventional-changelog).
140
+
141
+ ```bash
142
+ npm run release # interactive (prompts for version bump)
143
+ npm run release -- patch # patch release
144
+ npm run release -- minor # minor release
145
+ ```
146
+
147
+ This automatically:
148
+ - Bumps the version based on commit types (`feat` = minor, `fix` = patch)
149
+ - Generates categorized release notes
150
+ - Updates `CHANGELOG.md`
151
+ - Creates a git tag and GitHub Release
152
+ - Publishes to npm
153
+
154
+ ## License
155
+
156
156
  By contributing, you agree that your contributions will be licensed under the [AGPL-3.0-or-later License](LICENSE), including the additional terms specified in Section 7 of the LICENSE file.