annotask 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kurt Stohrer
+
+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

@@ -1,4 +1,8 @@
-# Annotask
+<p align="center">
+  <img src="annotask-logo.png" alt="Annotask" width="120" />
+</p>
+
+<h1 align="center">Annotask</h1>
 
 Visual markup tool for web apps. Annotate your UI in the browser — pins, arrows, drawn sections, notes — and Annotask generates structured tasks that AI coding agents apply to your source code. Supports Vue, React, Svelte, Astro, and plain HTML/htmx with Vite and Webpack.
 
@@ -100,6 +104,42 @@ import { AnnotaskWebpackPlugin } from 'annotask/webpack'
 plugins: [new AnnotaskWebpackPlugin()]
 ```
 
+### Micro-frontends (single-spa, Module Federation, etc.)
+
+For MFE architectures where multiple apps load into a single root shell:
+
+**MFE child** (Vite) — adds `data-annotask-mfe` attribute to all elements:
+
+```ts
+import { annotask } from 'annotask'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    annotask({
+      mfe: '@myorg/my-mfe',                    // MFE identity tag
+      server: 'http://localhost:24678',         // Root's annotask server URL
+    }),
+  ],
+})
+```
+
+**Root shell** (Webpack) — runs the annotask server, bridge, and shell UI:
+
+```ts
+import { AnnotaskWebpackPlugin } from 'annotask/webpack'
+
+plugins: [new AnnotaskWebpackPlugin({ port: 24678 })]
+```
+
+When `server` is set, the MFE's local annotask server is skipped — the root handles it. When only `mfe` is set (no `server`), annotask runs normally for standalone development.
+
+Tasks created from MFE elements carry the `mfe` field. Filter them with `GET /__annotask/api/tasks?mfe=@myorg/my-mfe` or use the CLI:
+
+```bash
+annotask report --mfe=@myorg/my-mfe
+```
+
 Start your dev server, then open:
 - **App**: `http://localhost:5173/` (Vite) or `http://localhost:8090/` (Webpack)
 - **Annotask**: `http://localhost:5173/__annotask/`
@@ -134,10 +174,12 @@ annotask status             # Check connection
 annotask init-skills        # Install agent skills into your project
 ```
 
+Options: `--port=N`, `--host=H`, `--server=URL` (override server.json), `--mfe=NAME` (filter by MFE).
+
 ## API
 
 - `GET /__annotask/api/report` — Current change report
-- `GET /__annotask/api/tasks` — Task list
+- `GET /__annotask/api/tasks` — Task list (supports `?mfe=NAME` filter)
 - `POST /__annotask/api/tasks` — Create a task
 - `PATCH /__annotask/api/tasks/:id` — Update task status
 - `GET /__annotask/api/status` — Health check
@@ -180,7 +222,7 @@ pnpm test:e2e                 # Run E2E tests (all frameworks)
 - `src/schema.ts` — TypeScript types for change reports
 - `src/cli/` — CLI tool for terminal interaction
 - `skills/` — Agent skill definitions (shipped with the npm package)
-- `playgrounds/` — Test apps (vue-vite, vue-webpack, react-vite, svelte-vite, html-vite, astro, htmx-vite)
+- `playgrounds/` — Test apps (vue-vite, vue-webpack, react-vite, svelte-vite, html-vite, astro, htmx-vite, mfe-vite)
 
 ## Troubleshooting
 

package/dist/chunk-GHDLRMQG.js

@@ -0,0 +1,61 @@
+import {
+  removeServerInfo,
+  writeServerInfo
+} from "./chunk-XLNGAH3S.js";
+import {
+  createAnnotaskServer
+} from "./chunk-R6P4MMZW.js";
+
+// src/server/standalone.ts
+import http from "http";
+async function startStandaloneServer(options) {
+  const port = options.port || 24678;
+  const uiServer = createAnnotaskServer({ projectRoot: options.projectRoot });
+  const httpServer = http.createServer((req, res) => {
+    uiServer.middleware(req, res, () => {
+      res.statusCode = 404;
+      res.end("Not found");
+    });
+  });
+  httpServer.on("upgrade", (req, socket, head) => {
+    if (req.url === "/__annotask/ws") {
+      uiServer.handleUpgrade(req, socket, head);
+    }
+  });
+  return new Promise((resolve, reject) => {
+    httpServer.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        httpServer.listen(0, () => {
+          const addr = httpServer.address();
+          writeServerInfo(options.projectRoot, addr.port);
+          resolve({
+            port: addr.port,
+            close: () => {
+              removeServerInfo(options.projectRoot);
+              uiServer.dispose();
+              httpServer.close();
+            }
+          });
+        });
+      } else {
+        reject(err);
+      }
+    });
+    httpServer.listen(port, () => {
+      writeServerInfo(options.projectRoot, port);
+      resolve({
+        port,
+        close: () => {
+          removeServerInfo(options.projectRoot);
+          uiServer.dispose();
+          httpServer.close();
+        }
+      });
+    });
+  });
+}
+
+export {
+  startStandaloneServer
+};
+//# sourceMappingURL=chunk-GHDLRMQG.js.map

package/dist/chunk-GHDLRMQG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/standalone.ts"],"sourcesContent":["import http from 'node:http'\nimport { createAnnotaskServer } from './index.js'\nimport { writeServerInfo, removeServerInfo } from './discovery.js'\n\nexport interface StandaloneServerOptions {\n  projectRoot: string\n  port?: number\n}\n\nexport async function startStandaloneServer(options: StandaloneServerOptions): Promise<{\n  port: number\n  close: () => void\n}> {\n  const port = options.port || 24678\n  const uiServer = createAnnotaskServer({ projectRoot: options.projectRoot })\n\n  const httpServer = http.createServer((req, res) => {\n    uiServer.middleware(req, res, () => {\n      res.statusCode = 404\n      res.end('Not found')\n    })\n  })\n\n  httpServer.on('upgrade', (req, socket, head) => {\n    if (req.url === '/__annotask/ws') {\n      uiServer.handleUpgrade(req, socket, head)\n    }\n  })\n\n  return new Promise((resolve, reject) => {\n    httpServer.on('error', (err: NodeJS.ErrnoException) => {\n      if (err.code === 'EADDRINUSE') {\n        httpServer.listen(0, () => {\n          const addr = httpServer.address() as { port: number }\n          writeServerInfo(options.projectRoot, addr.port)\n          resolve({\n            port: addr.port,\n            close: () => { removeServerInfo(options.projectRoot); uiServer.dispose(); httpServer.close() },\n          })\n        })\n      } else {\n        reject(err)\n      }\n    })\n\n    httpServer.listen(port, () => {\n      writeServerInfo(options.projectRoot, port)\n      resolve({\n        port,\n        close: () => { removeServerInfo(options.projectRoot); uiServer.dispose(); httpServer.close() },\n      })\n    })\n  })\n}\n"],"mappings":";;;;;;;;;AAAA,OAAO,UAAU;AASjB,eAAsB,sBAAsB,SAGzC;AACD,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,WAAW,qBAAqB,EAAE,aAAa,QAAQ,YAAY,CAAC;AAE1E,QAAM,aAAa,KAAK,aAAa,CAAC,KAAK,QAAQ;AACjD,aAAS,WAAW,KAAK,KAAK,MAAM;AAClC,UAAI,aAAa;AACjB,UAAI,IAAI,WAAW;AAAA,IACrB,CAAC;AAAA,EACH,CAAC;AAED,aAAW,GAAG,WAAW,CAAC,KAAK,QAAQ,SAAS;AAC9C,QAAI,IAAI,QAAQ,kBAAkB;AAChC,eAAS,cAAc,KAAK,QAAQ,IAAI;AAAA,IAC1C;AAAA,EACF,CAAC;AAED,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,eAAW,GAAG,SAAS,CAAC,QAA+B;AACrD,UAAI,IAAI,SAAS,cAAc;AAC7B,mBAAW,OAAO,GAAG,MAAM;AACzB,gBAAM,OAAO,WAAW,QAAQ;AAChC,0BAAgB,QAAQ,aAAa,KAAK,IAAI;AAC9C,kBAAQ;AAAA,YACN,MAAM,KAAK;AAAA,YACX,OAAO,MAAM;AAAE,+BAAiB,QAAQ,WAAW;AAAG,uBAAS,QAAQ;AAAG,yBAAW,MAAM;AAAA,YAAE;AAAA,UAC/F,CAAC;AAAA,QACH,CAAC;AAAA,MACH,OAAO;AACL,eAAO,GAAG;AAAA,MACZ;AAAA,IACF,CAAC;AAED,eAAW,OAAO,MAAM,MAAM;AAC5B,sBAAgB,QAAQ,aAAa,IAAI;AACzC,cAAQ;AAAA,QACN;AAAA,QACA,OAAO,MAAM;AAAE,2BAAiB,QAAQ,WAAW;AAAG,mBAAS,QAAQ;AAAG,qBAAW,MAAM;AAAA,QAAE;AAAA,MAC/F,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}