@affectively/aeon-pages 1.3.0

package/packages/cli/src/index.ts

@@ -0,0 +1,105 @@
+#!/usr/bin/env bun
+/**
+ * Aeon Pages CLI
+ *
+ * Commands:
+ * - aeon init [dir]  - Initialize a new Aeon Pages project
+ * - aeon dev         - Start development server with hot reload
+ * - aeon build       - Build for production
+ * - aeon start       - Start production server
+ */
+
+import { parseArgs } from 'util';
+
+const { values, positionals } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    port: { type: 'string', short: 'p', default: '3000' },
+    config: { type: 'string', short: 'c' },
+  },
+  allowPositionals: true,
+});
+
+const VERSION = '0.1.0';
+
+async function main() {
+  if (values.version) {
+    console.log(`aeon v${VERSION}`);
+    process.exit(0);
+  }
+
+  const command = positionals[0];
+
+  if (!command || values.help) {
+    printHelp();
+    process.exit(command ? 0 : 1);
+  }
+
+  switch (command) {
+    case 'init':
+      await import('./commands/init').then((m) => m.init(positionals[1]));
+      break;
+
+    case 'dev':
+      await import('./commands/dev').then((m) =>
+        m.dev({ port: parseInt(values.port || '3000'), config: values.config }),
+      );
+      break;
+
+    case 'build':
+      await import('./commands/build').then((m) =>
+        m.build({ config: values.config }),
+      );
+      break;
+
+    case 'start':
+      await import('./commands/start').then((m) =>
+        m.start({
+          port: parseInt(values.port || '3000'),
+          config: values.config,
+        }),
+      );
+      break;
+
+    default:
+      console.error(`Unknown command: ${command}`);
+      printHelp();
+      process.exit(1);
+  }
+}
+
+function printHelp() {
+  console.log(`
+aeon v${VERSION} - The CMS IS the website
+
+Usage: aeon <command> [options]
+
+Commands:
+  init [dir]     Initialize a new Aeon Pages project
+  dev            Start development server with hot reload
+  build          Build for production (Cloudflare Workers)
+  start          Start production server
+
+Options:
+  -p, --port     Server port (default: 3000)
+  -c, --config   Path to aeon.config.ts
+  -h, --help     Show this help message
+  -v, --version  Show version
+
+Examples:
+  aeon init my-app       Create new project in ./my-app
+  aeon dev               Start dev server on port 3000
+  aeon dev -p 8080       Start dev server on port 8080
+  aeon build             Build for Cloudflare Workers
+  aeon start             Start production server
+
+Documentation: https://github.com/affectively/aeon-pages
+`);
+}
+
+main().catch((err) => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/packages/directives/src/use-aeon.ts

@@ -0,0 +1,272 @@
+/**
+ * 'use aeon' Directive Processor
+ *
+ * Transforms pages with the 'use aeon' directive to enable:
+ * - Collaborative editing
+ * - Real-time presence
+ * - Schema versioning
+ * - Offline support
+ *
+ * @example
+ * Input:
+ * ```tsx
+ * 'use aeon';
+ *
+ * export default function Page() {
+ *   return <div>Hello</div>;
+ * }
+ * ```
+ *
+ * Output:
+ * ```tsx
+ * import { AeonPageProvider, useAeonPage } from '@affectively/aeon-pages/react';
+ *
+ * function Page() {
+ *   return <div>Hello</div>;
+ * }
+ *
+ * export default function AeonWrappedPage(props) {
+ *   return (
+ *     <AeonPageProvider route="/path/to/page">
+ *       <Page {...props} />
+ *     </AeonPageProvider>
+ *   );
+ * }
+ * ```
+ */
+
+export interface TransformOptions {
+  /** File path for route derivation */
+  filePath: string;
+  /** Base pages directory */
+  pagesDir?: string;
+}
+
+export interface TransformResult {
+  /** Transformed code */
+  code: string;
+  /** Whether the file was transformed */
+  transformed: boolean;
+  /** Derived route from file path */
+  route: string;
+}
+
+/**
+ * Check if a file contains the 'use aeon' directive
+ */
+export function hasAeonDirective(code: string): boolean {
+  // Match 'use aeon' or "use aeon" at the start of the file
+  const directivePattern = /^['"]use aeon['"];?\s*\n/m;
+  return directivePattern.test(code.trimStart());
+}
+
+/**
+ * Process the 'use aeon' directive and transform the code
+ */
+export function processAeonDirective(
+  code: string,
+  options: TransformOptions,
+): TransformResult {
+  const { filePath, pagesDir = './pages' } = options;
+
+  // Check for directive
+  if (!hasAeonDirective(code)) {
+    return {
+      code,
+      transformed: false,
+      route: deriveRoute(filePath, pagesDir),
+    };
+  }
+
+  const route = deriveRoute(filePath, pagesDir);
+
+  // Remove the directive
+  const codeWithoutDirective = code.replace(/^['"]use aeon['"];?\s*\n/m, '');
+
+  // Find the default export
+  const defaultExportMatch = codeWithoutDirective.match(
+    /export\s+default\s+function\s+(\w+)/,
+  );
+
+  if (!defaultExportMatch) {
+    // Handle arrow function exports or other patterns
+    return transformArrowExport(codeWithoutDirective, route);
+  }
+
+  const componentName = defaultExportMatch[1];
+
+  // Transform the code
+  const transformedCode = `
+// Aeon Pages - Transformed from 'use aeon' directive
+import { AeonPageProvider, useAeonPage } from '@affectively/aeon-pages/react';
+
+${codeWithoutDirective.replace(
+  /export\s+default\s+function\s+(\w+)/,
+  'function $1',
+)}
+
+// Re-export useAeonPage for convenience
+export { useAeonPage };
+
+// Wrapped component with Aeon providers
+export default function AeonWrappedPage(props: any) {
+  return (
+    <AeonPageProvider route="${route}">
+      <${componentName} {...props} />
+    </AeonPageProvider>
+  );
+}
+`.trim();
+
+  return {
+    code: transformedCode,
+    transformed: true,
+    route,
+  };
+}
+
+/**
+ * Transform arrow function or other export patterns
+ */
+function transformArrowExport(code: string, route: string): TransformResult {
+  // Match: export default () => ... or export default function() ...
+  const arrowExportMatch = code.match(
+    /export\s+default\s+((?:\([^)]*\)|[^=])\s*=>|function\s*\()/,
+  );
+
+  if (!arrowExportMatch) {
+    // No recognizable default export, wrap the whole thing
+    return {
+      code: `
+// Aeon Pages - Transformed from 'use aeon' directive
+import { AeonPageProvider, useAeonPage } from '@affectively/aeon-pages/react';
+
+const OriginalPage = (() => {
+  ${code}
+  return undefined; // Placeholder
+})();
+
+export { useAeonPage };
+
+export default function AeonWrappedPage(props: any) {
+  return (
+    <AeonPageProvider route="${route}">
+      {OriginalPage}
+    </AeonPageProvider>
+  );
+}
+`.trim(),
+      transformed: true,
+      route,
+    };
+  }
+
+  // Extract the arrow function/anonymous function
+  const transformedCode = `
+// Aeon Pages - Transformed from 'use aeon' directive
+import { AeonPageProvider, useAeonPage } from '@affectively/aeon-pages/react';
+
+${code.replace(/export\s+default\s+/, 'const OriginalPage = ')}
+
+export { useAeonPage };
+
+export default function AeonWrappedPage(props: any) {
+  return (
+    <AeonPageProvider route="${route}">
+      <OriginalPage {...props} />
+    </AeonPageProvider>
+  );
+}
+`.trim();
+
+  return {
+    code: transformedCode,
+    transformed: true,
+    route,
+  };
+}
+
+/**
+ * Derive route from file path
+ *
+ * @example
+ * - pages/index.tsx -> /
+ * - pages/about.tsx -> /about
+ * - pages/blog/[slug].tsx -> /blog/[slug]
+ * - pages/blog/[slug]/page.tsx -> /blog/[slug]
+ */
+export function deriveRoute(filePath: string, pagesDir: string): string {
+  // Normalize paths
+  const normalizedPath = filePath.replace(/\\/g, '/');
+  const normalizedPagesDir = pagesDir.replace(/\\/g, '/').replace(/\/$/, '');
+
+  // Remove pages directory prefix
+  let route = normalizedPath;
+  if (route.startsWith(normalizedPagesDir)) {
+    route = route.slice(normalizedPagesDir.length);
+  }
+
+  // Remove file extension
+  route = route.replace(/\.(tsx?|jsx?)$/, '');
+
+  // Remove /page suffix (Next.js app router style)
+  route = route.replace(/\/page$/, '');
+
+  // Remove /index suffix
+  route = route.replace(/\/index$/, '');
+
+  // Handle route groups (parentheses)
+  route = route.replace(/\/\([^)]+\)/g, '');
+
+  // Ensure leading slash
+  if (!route.startsWith('/')) {
+    route = '/' + route;
+  }
+
+  // Handle root
+  if (route === '' || route === '/') {
+    return '/';
+  }
+
+  return route;
+}
+
+/**
+ * Bun plugin for processing 'use aeon' directives
+ */
+export function aeonBunPlugin(options: { pagesDir?: string } = {}) {
+  return {
+    name: 'aeon-directive',
+    setup(build: { onLoad: (opts: unknown, callback: unknown) => void }) {
+      build.onLoad(
+        { filter: /\.(tsx?|jsx?)$/ },
+        async (args: { path: string }) => {
+          const file = Bun.file(args.path);
+          const code = await file.text();
+
+          if (!hasAeonDirective(code)) {
+            return undefined; // Let Bun handle it normally
+          }
+
+          const result = processAeonDirective(code, {
+            filePath: args.path,
+            pagesDir: options.pagesDir,
+          });
+
+          return {
+            contents: result.code,
+            loader: args.path.endsWith('.tsx') ? 'tsx' : 'ts',
+          };
+        },
+      );
+    },
+  };
+}
+
+// Export for use in build tools
+export default {
+  hasAeonDirective,
+  processAeonDirective,
+  deriveRoute,
+  aeonBunPlugin,
+};

package/packages/mcp-server/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@aeon/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for aeon-flux site navigation - enables Cyrano to suggest and invoke navigation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "aeon-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/navigation.d.ts",
+      "import": "./dist/tools/navigation.js"
+    },
+    "./resources": {
+      "types": "./dist/resources.d.ts",
+      "import": "./dist/resources.js"
+    }
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "aeon-flux",
+    "cyrano",
+    "navigation",
+    "ai"
+  ],
+  "author": "AFFECTIVELY",
+  "license": "MIT"
+}

package/packages/mcp-server/src/index.ts

@@ -0,0 +1,178 @@
+/**
+ * Aeon Flux MCP Server
+ *
+ * Model Context Protocol server for aeon-flux site navigation.
+ * Enables Cyrano to suggest and invoke navigation with auto-accept mode.
+ *
+ * Tools:
+ * - navigate: Navigate to a route
+ * - suggest_route: Suggest a route to the user
+ * - get_current_route: Get the current route
+ * - get_sitemap: Get the site structure
+ * - speculate: Prefetch likely next routes
+ * - personalize: Apply personalization to current page
+ *
+ * Resources:
+ * - sitemap: Full sitemap as RAG context
+ * - current_session: Current user session data
+ * - consciousness_state: Site consciousness state
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+import {
+  navigateTool,
+  suggestRouteTool,
+  getCurrentRouteTool,
+  getSitemapTool,
+  speculateTool,
+  personalizeTool,
+  invokeToolTool,
+  handleNavigate,
+  handleSuggestRoute,
+  handleGetCurrentRoute,
+  handleGetSitemap,
+  handleSpeculate,
+  handlePersonalize,
+  handleInvokeTool,
+} from './tools/navigation';
+
+import {
+  sitemapResource,
+  sessionResource,
+  consciousnessResource,
+  handleReadSitemap,
+  handleReadSession,
+  handleReadConsciousness,
+} from './resources';
+
+// ============================================================================
+// Server Setup
+// ============================================================================
+
+const server = new Server(
+  {
+    name: 'aeon-flux',
+    version: '1.0.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+      resources: {},
+    },
+  },
+);
+
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      navigateTool,
+      suggestRouteTool,
+      getCurrentRouteTool,
+      getSitemapTool,
+      speculateTool,
+      personalizeTool,
+      invokeToolTool,
+    ],
+  };
+});
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  switch (name) {
+    case 'navigate':
+      return handleNavigate(args as { route: string; autoAccept?: boolean });
+
+    case 'suggest_route':
+      return handleSuggestRoute(
+        args as {
+          route: string;
+          reason: string;
+          autoAccept?: boolean;
+        },
+      );
+
+    case 'get_current_route':
+      return handleGetCurrentRoute();
+
+    case 'get_sitemap':
+      return handleGetSitemap(args as { filter?: string });
+
+    case 'speculate':
+      return handleSpeculate(args as { depth?: number });
+
+    case 'personalize':
+      return handlePersonalize(
+        args as {
+          theme?: 'light' | 'dark';
+          accent?: string;
+          density?: 'compact' | 'normal' | 'comfortable';
+        },
+      );
+
+    case 'invoke_tool':
+      return handleInvokeTool(
+        args as {
+          toolId: string;
+          params?: Record<string, unknown>;
+        },
+      );
+
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+});
+
+// ============================================================================
+// Resource Handlers
+// ============================================================================
+
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  return {
+    resources: [sitemapResource, sessionResource, consciousnessResource],
+  };
+});
+
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  const { uri } = request.params;
+
+  switch (uri) {
+    case 'aeon://sitemap':
+      return handleReadSitemap();
+
+    case 'aeon://session':
+      return handleReadSession();
+
+    case 'aeon://consciousness':
+      return handleReadConsciousness();
+
+    default:
+      throw new Error(`Unknown resource: ${uri}`);
+  }
+});
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('Aeon Flux MCP Server running on stdio');
+}
+
+main().catch(console.error);
+
+export { server };