pixelweaver 0.1.0

package/.selfdoc/hashes/hashes.json

@@ -0,0 +1,146 @@
+{
+  "cli-config.md": {
+    "content": "184954f0ee21151227fcbad758e1e01478fa9c1fec123eb3ef664584589aa4b8",
+    "description": "5e3ac11586aad6a54fac3d0ffc7347a2a43b28c62874c71b66ae8800ddd0e47e"
+  },
+  "cli-dev.md": {
+    "content": "ac8e9d0f80f2e6e7052e9d8d8f736eb05553e7d51d9f7a6d2460a453b5a230c3",
+    "description": "37c4c1460971dea3c29a39549f7103c944ef360d002d33c7978a131479423887"
+  },
+  "cli-diagnose.md": {
+    "content": "d4983d1dcb2a0c2d08369ccd667a8cc79e961adbbfac0b51e3cecc469e6dce44",
+    "description": "5a5c5d09a300c7fc2a878d0c53b9c66461d0010f6dd3a3a640e6dfc3b95449ea"
+  },
+  "cli-index.md": {
+    "content": "9f14f34e8a916bdc6d4f133b84906d5cd0f9636013bdc225557a866ee4bab9b6",
+    "description": "0657e4c5d654629945d9aba8b852f3239b910f3aa661a544198c1b8e62415e22"
+  },
+  "cli-list.md": {
+    "content": "960c44ec74e467873f1b5315115fa0c20fd282a34c328eb05ad93c273a234ffd",
+    "description": "2ebf987dfad37e10ccfb35e3472c53cce1b056baebe27544e99ab8c7d4570be2"
+  },
+  "cli-mcp.md": {
+    "content": "9796c1e40e18fecdd09ab776eb072bae13048fa2044e461abe99fff7bd915c6c",
+    "description": "1ae7ae9046c22869216b60151d3054fc12b7397f921f19ff33e403a85dbb2ecd"
+  },
+  "cli-new.md": {
+    "content": "a13b90132e3a863fec98e09b3669eef02d08422943a6def943b147186b795fb6",
+    "description": "ec6253508f56ed7cb2ff03ad014f8c4a9a531d257bdae541c2fa05d9d4a36660"
+  },
+  "cli-open.md": {
+    "content": "4ceafc5e0cdf9eb1fc7f1004139566e3175dac136724b73a831e7d9bb641bceb",
+    "description": "2858890c81f8c62493e54d99c8774fe321c9b7836659b40b7f0bec7661ac6c88"
+  },
+  "cli-serve.md": {
+    "content": "28ffebdc1bd41ca8cff78501d8a2fedd93151101edea976ef60482aa2fb65e74",
+    "description": "11d086f456102ac1dc60ae9c8aacc2170b03b114f044122e16a4868075914c49"
+  },
+  "cli-stop.md": {
+    "content": "2026d934a95ff159bfe0f5040e273dbfe2e29f7fc6645875f7541e88b2b7b2f6",
+    "description": "3c513ec4509411d4832c93a80058fb239901cbf058d19a2685f0d7d1690b3072"
+  },
+  "gen-index.md": {
+    "content": "b966605dfa2850ffb931390546d6011f60e22962d3975d9cdeb7a8b948705bc2",
+    "description": "bb3cd9d34f014c0674a9285c25ee14b5b4abc5cf941f0d83594c301405e8f3b6"
+  },
+  "index.md": {
+    "content": "901cd3a6ea0862c2ab7fc7469d4cf0b60e50a4b994da3ae165abe7cf06360d73",
+    "description": "69cbe9bbc9c2481fbb3f35c034e74389c5440a5a51eb3e04cbf2cd2880c5c2b1"
+  },
+  "server-src-pixelweaver-__main__.md": {
+    "content": "07ad2c6d6880579e8fedf78495e53f963fee5d7449b1eb56dc41f4ba03a0db3e",
+    "description": "4fbba20ee6f7401a051787b4b636c269f4321d4c52adfaef99aa152467e4e00a"
+  },
+  "server-src-pixelweaver-autosave.md": {
+    "content": "a5ff1954c1e1de14f809e8cea8e0e508761582cfdd8c4f4a929a8848f7e06c7d",
+    "description": "86cf08e89b4fae75853cab4556598ab1b621c1c1e6b57e74204ebe5e31487c3b"
+  },
+  "server-src-pixelweaver-bridge.md": {
+    "content": "ec22b6094a62369b5bd2c1dab13e1cf9ffe2e4def7a59f3cd7dd24c13706695e",
+    "description": "f59149fb88c04d693199315d77663ff121e2af71a700eaf0c7867e9373b9b99a"
+  },
+  "server-src-pixelweaver-cli.md": {
+    "content": "0b8bca66ef5ac8650ce6b0e36044bc00a2b241c6f15455e464c3e3449004643b",
+    "description": "d9a5d5f6ff0f3b9c67110a03038b65764f60d902b91409de441cf798c13ba933"
+  },
+  "server-src-pixelweaver-config.md": {
+    "content": "a70d05d45ff90395b77e339a9f1a314e50155e3973adff720bce28aac4bd8442",
+    "description": "5cf2925e02788d64975d2ec3e536dd699ffa5a2fb2a5ccfa415951430aa9134b"
+  },
+  "server-src-pixelweaver-connections.md": {
+    "content": "b42e0eb5fd45c303fd28e77f4b3c28162d096f284deecc76afc194579002e3cc",
+    "description": "542ce4bf0510f8bf8933561d640ce854063146a7456365e0ddead312252c8960"
+  },
+  "server-src-pixelweaver-main.md": {
+    "content": "0b77f4fab2273870937b8315a455d05777405c9efa38e51c3157fbd2433b10bf",
+    "description": "6a7b41e1196b43f9a6fc2cea0ccc46c5f2ec41d293ca510ab1a206c2c53f9d70"
+  },
+  "server-src-pixelweaver-mcp_bridge.md": {
+    "content": "8de99cd0a7c36a119db67cb1477a3f350c813d68b844438c346cea1b6186fa49",
+    "description": "d1cc47f696014e830caba4fe84f3fc4a4d211ff93e282f2351b096b327173a75"
+  },
+  "server-src-pixelweaver-mcp_drawing_tools.md": {
+    "content": "88f6aa24aaac1ee24ec6c87853ccdcc133cf5f18c092fdbcdb24a2caa363c6c8",
+    "description": "4aff70fa933c27cefa5ad633852a344dc15f770ecf68824bf4c6e6ce17d78a55"
+  },
+  "server-src-pixelweaver-mcp_export_tools.md": {
+    "content": "11a9c21c0271e10326af7e96acfa785d4038960f5615e8f6cbb14039d692fde4",
+    "description": "4c86a67fba51559397a13750723841024851061a3e96dd851f9d8709f8b65f33"
+  },
+  "server-src-pixelweaver-mcp_frame_tools.md": {
+    "content": "7a75ab97ca30d4dd62fb06c82999d0dc099ed64b08bef04843850cfa7e13d00e",
+    "description": "7daa1909b5b4302d4047271360201b46e8efb298f322054442bcfc1777312174"
+  },
+  "server-src-pixelweaver-mcp_history_tools.md": {
+    "content": "09086ace9cb0018588918c626f2503136baa7e3f3b62c05f2a9280c319dcf497",
+    "description": "d81b9fb13b588e4a6f169d5b4e3685c3a0646b6632fa7c771f4afbe3e694de94"
+  },
+  "server-src-pixelweaver-mcp_layer_tools.md": {
+    "content": "46c9bdc7cdd37889812dd1eeea351b573e1eeca10a7a7879d55303502fba67b0",
+    "description": "3b48da0bd9be722d0f57b321a017b2ef7e04eb347bdd945f9a411611cd2e1fd4"
+  },
+  "server-src-pixelweaver-mcp_lock.md": {
+    "content": "db2c6b4dc2beac801ee2a64b759ce8c68042e573515c51ab6dbdc3f3b451f38c",
+    "description": "632bc9647051cb6c9b1771ebe0e15b3c1074a1e8b8e0d6ca9d01c524863ae53a"
+  },
+  "server-src-pixelweaver-mcp_project_tools.md": {
+    "content": "5cda203da7a744485c3f66c046954e1092f1124ef1a09243d5eb97a899dbf1c2",
+    "description": "dfc011a4b43661a4e6b4f2fd27bf12bfa5577c94de0af03485c775d363bed992"
+  },
+  "server-src-pixelweaver-mcp_read_tools.md": {
+    "content": "2379a1484b6cbac64f9287cdcf860bafb0e060f9ac4fa88a3fe45fa837a883a2",
+    "description": "0f7fa89081635721805fa37f4103121c3d6bf3fdc732bd91ad4b51269b786238"
+  },
+  "server-src-pixelweaver-mcp_registry.md": {
+    "content": "5047e6a0bd45486135e781af7223a5c508d138298db79c5623ff669fb1f8a42d",
+    "description": "fbfb1e648de1065359b30aef271234666617d5509b479f85168cee248ff0ad57"
+  },
+  "server-src-pixelweaver-mcp_resources.md": {
+    "content": "feb210489920434384e9bb89795174279ebeab162e4135718111448b63351dd3",
+    "description": "9b6f3ee38889382994427f068fabfa84640f73f76cd3170f9f5ad6475a44d513"
+  },
+  "server-src-pixelweaver-mcp_server.md": {
+    "content": "768205ae8712884937f2af681c770d74295eb7516c3dd9c7a54db64a56ce8d41",
+    "description": "c78b20be64bacaaaa5cb13020160f91e26dc30e0b70c0df1fb8cc02e12433f4a"
+  },
+  "server-src-pixelweaver-protocol.md": {
+    "content": "04fdc924b15eb8cbd39d6e20a1ab29e2de7594f244c2a4f6a30cebf6b10dd3fe",
+    "description": "7185fc586ecc35223768aed96bccac159f77ce9a54358f5aabe317e67d96df33"
+  },
+  "server-src-pixelweaver-state.md": {
+    "content": "edfe1d67f76043a4de0c798c1894931c7a88a762e24c689edc57a004966165b0",
+    "description": "0ba44b97965174f658d27777573756d8426724a43f6097224cfec5c82f529523"
+  },
+  "server-src-pixelweaver-storage.md": {
+    "content": "9814dd26bacd306bbbf86a0bcc6b59723ccc8dad5baa8a6a7ea18f85e9889f76",
+    "description": "259e01e845e3186b605eb8b2347217526630897352879927beabf6f115a0d0b1"
+  },
+  "server-src-pixelweaver-websocket.md": {
+    "content": "cbf606e1a462082843ad494c7f0a3acf8f15ed0b93b73aacfa6f4646791c48d0",
+    "description": "ce2742c41dba8f9a1ecee8b1dab95ae395e4be8bf3126c6f12ad89770efdf86c"
+  },
+  "server-src-pixelweaver.md": {
+    "content": "c5a9b6230677e69865eea75b57802a27c7ec3b9063f4c339c92661bb95b3dd77",
+    "description": "01ed8b72d9677d61224caea2a280aa706a8f5ac05625e30fad5a6e1d7072b662"
+  }
+}

package/.strictcli/schema.json

@@ -0,0 +1,227 @@
+{
+  "defaults": {
+    "app": {
+      "env_prefix": null,
+      "config": false,
+      "global_flags": [],
+      "commands": {},
+      "groups": {},
+      "deprecated": {}
+    },
+    "flag": {
+      "short": null,
+      "default": null,
+      "env": null,
+      "choices": null,
+      "repeatable": false,
+      "negatable": null,
+      "hidden": false
+    },
+    "arg": {
+      "required": true,
+      "variadic": false
+    },
+    "command": {
+      "passthrough": false,
+      "flags": [],
+      "args": []
+    },
+    "group": {
+      "commands": {},
+      "groups": {},
+      "deprecated": {}
+    }
+  },
+  "name": "pixelweaver",
+  "version": "0.1.0",
+  "help": "PixelWeaver collaboration server",
+  "config": true,
+  "commands": {
+    "serve": {
+      "name": "serve",
+      "help": "Start the server",
+      "flags": [
+        {
+          "name": "host",
+          "type": "str",
+          "help": "Bind address",
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "port",
+          "type": "int",
+          "help": "Port",
+          "default": 7779
+        },
+        {
+          "name": "reload",
+          "type": "bool",
+          "help": "Auto-reload on file changes",
+          "default": false,
+          "negatable": true
+        },
+        {
+          "name": "data-dir",
+          "type": "str",
+          "help": "Projects directory",
+          "default": "./projects"
+        }
+      ]
+    },
+    "new": {
+      "name": "new",
+      "help": "Create a new project on disk",
+      "flags": [
+        {
+          "name": "width",
+          "type": "int",
+          "help": "Canvas width in pixels"
+        },
+        {
+          "name": "height",
+          "type": "int",
+          "help": "Canvas height in pixels"
+        },
+        {
+          "name": "data-dir",
+          "type": "str",
+          "help": "Projects directory",
+          "default": "./projects"
+        }
+      ],
+      "args": [
+        {
+          "name": "name",
+          "help": "Project name"
+        }
+      ]
+    },
+    "list": {
+      "name": "list",
+      "help": "List projects on disk",
+      "flags": [
+        {
+          "name": "data-dir",
+          "type": "str",
+          "help": "Projects directory",
+          "default": "./projects"
+        }
+      ]
+    },
+    "mcp": {
+      "name": "mcp",
+      "help": "Start the MCP tool server (stdio)",
+      "flags": [
+        {
+          "name": "data-dir",
+          "type": "str",
+          "help": "Projects directory",
+          "default": "./projects"
+        }
+      ]
+    },
+    "dev": {
+      "name": "dev",
+      "help": "Development mode with Vite HMR",
+      "flags": [
+        {
+          "name": "host",
+          "type": "str",
+          "help": "Bind address",
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "port",
+          "type": "int",
+          "help": "Port",
+          "default": 7779
+        },
+        {
+          "name": "vite-port",
+          "type": "int",
+          "help": "Vite dev server port",
+          "default": 5173
+        },
+        {
+          "name": "data-dir",
+          "type": "str",
+          "help": "Projects directory",
+          "default": "./projects"
+        }
+      ]
+    },
+    "open": {
+      "name": "open",
+      "help": "Launch desktop window",
+      "flags": [
+        {
+          "name": "host",
+          "type": "str",
+          "help": "Bind address",
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "port",
+          "type": "int",
+          "help": "Port",
+          "default": 7779
+        },
+        {
+          "name": "browser",
+          "type": "bool",
+          "help": "Open in browser instead of native window",
+          "default": false,
+          "negatable": true
+        },
+        {
+          "name": "data-dir",
+          "type": "str",
+          "help": "Projects directory",
+          "default": "./projects"
+        }
+      ]
+    },
+    "diagnose": {
+      "name": "diagnose",
+      "help": "Check runtime environment and dependencies"
+    },
+    "stop": {
+      "name": "stop",
+      "help": "Stop the running server"
+    }
+  },
+  "groups": {
+    "config": {
+      "name": "config",
+      "help": "Manage configuration",
+      "commands": {
+        "path": {
+          "name": "path",
+          "help": "Print the config file path"
+        },
+        "show": {
+          "name": "show",
+          "help": "Show all config values with source attribution"
+        },
+        "set": {
+          "name": "set",
+          "help": "Set a config value",
+          "args": [
+            {
+              "name": "key",
+              "help": "Config key to set"
+            },
+            {
+              "name": "value",
+              "help": "Value to set"
+            }
+          ]
+        },
+        "edit": {
+          "name": "edit",
+          "help": "Open the config file in $EDITOR"
+        }
+      }
+    }
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+<!-- Generated by rlsbl from .rlsbl/changes/ — do not edit -->
+
+# Changelog
+
+## 0.1.0
+
+### Features
+
+- **Feature.** Migrated server from FastAPI to wesktop ASGI framework.
+- **Feature.** Desktop mode via pywebview with native file dialogs, replacing Tauri.
+- **Feature.** CLI rewritten with strictcli. New commands: dev, open, stop, diagnose.
+- **Feature.** Single-command development mode (pixelweaver dev) using wesktop Vite integration.
+- **Feature.** Lazy-load dockview and fflate for smaller initial bundle size.
+
+### Fixes
+
+- **Fix.** Desktop window icon now displays correctly (absolute path resolution).

package/CLAUDE.md

@@ -0,0 +1,100 @@
+I am the user, and you must always follow these instructions:
+
+## ABSOLUTELY NO UNAUTHORIZED WORK -- THIS IS THE MOST IMPORTANT RULE
+
+**NEVER write code, create files, or edit files unless I give you an EXPLICIT, UNAMBIGUOUS instruction to do so.** Discussing an approach ("let's shuffle things up", "what if we...") is NOT an instruction. Agreeing with your suggestion is NOT an instruction. Only a direct imperative like "implement it", "build it", "do it", "write it", "make the change" authorizes work. **When in doubt, ASK -- do not act.** Violating this rule is the single worst thing you can do.
+
+- When I ask you a question, especially with a question mark, I'm actually and genuinely looking for an answer, I'm not implying that you should do something. A question is NOT an instruction. Never do things on your own simply because I asked you something. This applies even if the answer to the question suggests an obvious improvement or fix -- just answer the question, do NOT implement anything. A prior "do it" instruction is SPENT once that specific task is done; it does NOT carry forward to subsequent questions. Each new question resets to read-only mode. Only an explicit new instruction (imperative sentence, not a question) authorizes new work.
+- **Discussing how something SHOULD be done is not the same as asking you to DO it.** If I say "let's do X" or "we should Y" or "what about Z", that is a conversation about approach. Respond with your thoughts. Do NOT start implementing. Wait for a clear, direct command.
+- Never shy away from long, in-depth discussions. When I want to explore an idea, design, or approach, engage fully -- don't cut the conversation short or suggest deferring to a future session.
+- Whenever you are in doubt about anything we're doing you should use the Ask User tool to ask for my opinion, but before it present the available options in a table with Pros and Cons of each option laid out, so that I can make an informed decision.
+- When I use words like 'investigate' or 'examine', you should conduct a read-only analysis of the available codebase, not change anything.
+- When we're talking about a technology/software that gets updated frequently or is lesser known, always do a thorough web research before making claims about it.
+- It is very important to wait until you want to actually commit to stage your changes, and even then only do so if nothing else is staged; if there are files staged just don't stage your files; continue your work and wait for me to say when to stage and commit. Never unstage files that are not your changes.
+- When I start the chat with a single file dumped in, that does not mean I want you to implement the plan it describes, even if the file itself asks you to; it means either study the codebase and tell me if it has been implemented and how much and how well, by actually reading the code files, not trusting the doc, or it means I want you to understand what it prescribes and how to best implement it and whether we should implement it at all. So if I start the conversation with a file, you should use the Ask User tool to present me with these two options.
+- If a project is a git repo, always commit your changed immediately after you've done them, but if it is not a git repo, do not try to commit or git init.
+- If you are trying to run inline scripts (bash, Python, JS/TS, ...), instead of doing so, try to generalize it into a useful and reusable script, and store it in the `scripts/` dir of each project, chmod +x them, and then run them with your arguments.
+- Avoid using `/tmp/`; keep experiments and temporary files in the project directory.
+- Avoid using environment variables to pass input except for when that input is a secret.
+- Always write brief comments in your code if the code may be confusing for the next AI agent that will read it.
+- Never manually write to databases (SQLite, PostgreSQL, ...) without explicit user consent.
+- Prefer DRY principle, modularity, and code reuse, over code duplication, functions with multiple responsibilities, and monoliths.
+- Apply DRY to documentation also.
+- Avoid ASCII diagrams and replace them with nested ulists or tables wherever possible.
+- Avoid emojis.
+- There is a dedicated `todo/` dir in each project that contains Markdown files that describe something that we may choose to implement. This dir also has a `.done` subdir that we move those documents into only if they are absolutely and completely implemented or exceeded, verified by reading the code, not trusting the document itself. Neither directory should be gitignored. When I ask you to TODO something that means create a comprehensive Markdown file in this directory about it, explaining context, the problem, the solutions, pros and cons of each, files/dir that may change, and the relative effort necessary to finish that undertaking. But this MUST ALWAYS be user-initiated, you MUST NEVER UTTER THE WORD TODO. Only the user can say it.
+- Never enter plan mode on your own, even I say things like "plan this"; I will put you in plan mode myself if I need to. Never do so on your own.
+- You receive timestamps from system hooks (e.g. `UserPromptSubmit hook success: 2026-03-09 21:15:57 CET`). Use these to measure durations between events, notice passage of time (hours between messages may imply context shifts), detect late-night sessions, and generally maintain temporal awareness without needing to run date commands.
+- When fixing a bug, always investigate for the SAME bug pattern in related/sibling functions, nearby files, and analogous code paths, present evidence, and offer to fix it.
+- When given multiple items to fix or implement, make ONE COMMIT PER FIX/ITEM separately as you go. Never bundle unrelated changes into a single commit.
+- When using AskUserQuestion, NEVER use the `preview` field on options. It renders an ugly monospace layout instead of the clean default UI. Just use `label` and `description`.
+- Always use `uv` for Python projects -- never pip. Use `uv init`, `uv add`, `uv run`, `uv sync`, etc.
+- When I choose "Let me pick" on an AskUserQuestion, it means show me another AskUserQuestion with multiSelect: true listing all the individual items so I can check the ones I want. Do NOT respond with a plain text "What do you want?" -- always use the tool.
+- Last but not least: always use subagents for reading/writing files to avoid clogging your own context window. When there are N similar tasks, launch N subagents with similar and ample contexts, in parallel if possible. Once they all finish, synthesize their findings and present them to me. When implementing phases and subphases, launch managers for each phase that launchers implementors and auditor agent pairs, where one does the investigation and implementation, and the other does checks if the code is actually complete, correct, introduces no bugs or unintended consequences, is consistent with the rest of the patterns in the codebase, etc. NEVER DO THE WORK YOURSELF, ALWAYS USE HIGH EFFORT OPUS SUB-AGENTS. Never use other models like Haiku or Sonnet, only Opus. Even when I tell you to do something that doesn't mean you should do it yourself, that means spawn subagents with clear contexts, tell them what they need to know and do and accomplish in clear terms.
+- Never add backward compatibility shims, wrapper methods, or legacy API surfaces to unreleased projects. If the project has not been released or has no external consumers, the old API is dead -- delete it and update all callers. Backward compatibility in immature codebases is not a virtue, it is clutter that misleads future developers and adds maintenance cost for zero users.
+- Never use worktree isolation (`isolation: "worktree"`) when launching subagents. It creates confusing orphan branches and doesn't work as expected. All subagents must work directly in the main working directory.
+- When auditing or reviewing code, always read the actual files on disk (Read tool, not `git show` or `git diff`). The working tree is the truth -- committed code that has been reverted on disk is not real. `git show` reads from the object store, not the filesystem. Auditors must verify what actually runs, not what was once committed.
+- The only exception for any of these rules is when I explicitly and emphatically ask you to go against them, and even then double check with me.
+
+## PixelWeaver Architecture
+
+### Tech Stack
+- Svelte 5 (runes: $state, $derived, $effect, $props), SvelteKit-free (vanilla Vite)
+- dockview-core for panel docking (framework-agnostic, imperative API)
+- unplugin-icons with Iconify (lucide icon set ONLY -- no pixelarticons)
+- wesktop for server (ASGI micro-router + granian) and desktop (pywebview)
+- strictcli for CLI
+- TypeScript with .js extensions in imports (ESM)
+
+### Development Workflow
+- `pixelweaver dev` -- single-terminal development (starts Vite + wesktop server with ViteDevProxy)
+- `pixelweaver serve` -- headless API server (port 7779)
+- `pixelweaver open` -- desktop mode (pywebview native window, serves built frontend from dist/)
+- `pixelweaver open --browser` -- like open but launches default browser instead of native window
+- `npm run dev` -- Vite dev server only (port 5173, for frontend-only work)
+- `npm run build` -- build frontend to dist/
+- Frontend build must exist in dist/ for `pixelweaver serve` to serve the SPA
+
+### Plugin System
+- Plugins discovered via `import.meta.glob` in `bootstrap.ts`
+- Each plugin exports a `PluginModule` with `register(api)`
+- `PluginAPI` provides: addCommand, addTool, addPanel, addExporter, addImporter, addShortcut, addMenuItem, addToolbarItem, notify, dismissNotification, dispatch, onCommand
+- 8 reactive registries backed by SvelteMap: command, tool, panel, exporter, importer, shortcut, menu, toolbar
+
+### Dockview Gotchas (CRITICAL -- read before touching dock code)
+- `position: fixed` is BROKEN inside dockview panels (transform creates containing block). Portal to document.body instead.
+- Constraints (min/max width/height) are NOT serialized. Must reapply after every fromJSON() via applyPanelConstraints().
+- `initialWidth`/`initialHeight` are suggestions, not enforced. Use maxWidth/maxHeight constraints for hard caps.
+- Panel addition ORDER determines layout tree nesting. Current order: center, top, right, bottom, left (left last = full height).
+- CSS overrides need high specificity to beat dockview's own rules. Match their selector depth.
+- Bump LAYOUT_VERSION in dock-persistence.ts whenever the default layout changes.
+- Detect toolbars by fixed dimensions (min===max), NOT by closeable===false (canvas is also non-closeable).
+- ResizeObserver fires before dockview finishes layout. Debounce initial callbacks by 300ms.
+
+### Toolbar System
+- ToolbarPanel.svelte reads from toolbarRegistry filtered by toolbarId
+- Orientation derived from container aspect ratio (ResizeObserver), not configurable
+- Fixed-dimension panels (min===max) get: hidden header, locked group (no-drop-target), fixed size constraints
+- Drawing tools: position left, fixed 50px width
+- View controls: position top, fixed 48px height
+- Only iconSize is persisted in localStorage (toolbar-config.ts)
+
+### Menu System
+- MenuContribution registered via api.addMenuItem() with menuPath (slash-separated hierarchy)
+- menu-builder.ts transforms flat contributions into nested tree
+- MENU_ORDER controls top-level ordering: file, edit, view, image, layer, animation, select, effects, context, help
+- Commands need icon field for toolbar/palette display
+- Context menus use menuPath starting with 'context/' (e.g., 'context/canvas')
+
+### Design Tokens
+- All colors via CSS custom properties in app.css (--bg-*, --text-*, --border, --accent)
+- Dark theme on :root, light theme on [data-theme="light"]
+- Theme transition: 150ms ease on background-color, color, border-color
+- Canvas workspace background reads --bg-canvas CSS variable at render time
+- Never hardcode colors -- always use design tokens
+
+### Notification System
+- notification-state.svelte.ts: priority queue, auto-dismiss timers
+- NotificationBanner.svelte between MenuBar and workspace
+- Plugins use api.notify() / api.dismissNotification()
+- Missing panel detection on layout restore pushes info notification

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smm-h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+<!-- Auto-generated by selfdoc from docs/_README.md — do not edit -->
+
+# PixelWeaver
+
+A pixel art sprite editor built with Svelte 5 and wesktop.
+
+## Overview
+
+PixelWeaver is a desktop-class pixel art editor that runs in a native window or browser. The frontend is built with Svelte 5 (runes, vanilla Vite) and dockview-core for panel docking. The backend is a Python server using wesktop (ASGI micro-router + granian) with pywebview for native desktop windows. An MCP server exposes drawing and project tools for AI agent integration.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Frontend | Svelte 5, TypeScript, dockview-core, Vite |
+| Server | Python 3.13+, wesktop (ASGI + granian), Pydantic, Pillow |
+| Desktop | pywebview (native OS window) |
+| CLI | strictcli |
+| Icons | unplugin-icons with Iconify (lucide set) |
+| AI integration | MCP server (stdio) |
+
+## Install
+
+```bash
+npm install
+uv sync
+```
+
+## Quick Start
+
+Development mode (Vite HMR + wesktop server):
+
+```bash
+pixelweaver dev
+```
+
+Headless server (port 7779):
+
+```bash
+pixelweaver serve
+```
+
+Desktop window:
+
+```bash
+npm run build
+pixelweaver open
+```
+
+Browser mode:
+
+```bash
+npm run build
+pixelweaver open --browser
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `pixelweaver dev` | Development mode with Vite HMR |
+| `pixelweaver serve` | Start the headless API server |
+| `pixelweaver open` | Launch desktop window (pywebview) |
+| `pixelweaver open --browser` | Launch in default browser |
+| `pixelweaver new <name>` | Create a new project on disk |
+| `pixelweaver list` | List projects on disk |
+| `pixelweaver mcp` | Start the MCP tool server (stdio) |
+| `pixelweaver diagnose` | Check runtime environment and dependencies |
+| `pixelweaver config show` | Display current configuration |
+| `pixelweaver config set <key> <value>` | Set a config value |
+| `pixelweaver config edit` | Open config file in editor |
+| `pixelweaver config path` | Print config file path |
+
+## Architecture
+
+```
+src/                     Svelte 5 frontend (Vite)
+  lib/
+    plugins/             Plugin system (tools, panels, exporters, importers)
+    ...
+server/
+  src/pixelweaver/
+    cli.py               CLI entry point (strictcli)
+    main.py              ASGI app factory and routes
+    state.py             In-memory project state
+    storage.py           Project persistence
+    bridge.py            pywebview desktop bridge
+    websocket.py         WebSocket handlers
+    mcp_server.py        MCP server for AI agents
+    protocol.py          Shared protocol types
+    ...
+docs/                    Documentation (selfdoc)
+```
+
+The frontend communicates with the server over HTTP and WebSocket. In desktop mode, pywebview opens a native window pointing at the local server. In development mode, `pixelweaver dev` starts both Vite (with HMR) and the wesktop server behind a proxy.
+
+## Plugin System
+
+Plugins are discovered via `import.meta.glob` at bootstrap. Each plugin exports a `register(api)` function that receives a `PluginAPI` with methods for registering commands, tools, panels, exporters, importers, shortcuts, menu items, and toolbar items. Eight reactive registries (backed by SvelteMap) power the UI.
+
+## Development
+
+```bash
+npm install              # Install frontend dependencies
+uv sync                  # Install server dependencies
+pixelweaver dev          # Start dev server (Vite + wesktop)
+npm run build            # Build frontend to dist/
+npm run check            # TypeScript checks
+npm run lint             # ESLint
+npm run test             # Vitest (frontend)
+uv run pytest            # Pytest (server)
+```
+
+## License
+
+MIT