Undocumented Modules v1.1.0

This document covers the 6 modules not yet individually documented. All are production-ready in MoLOS v1.1.0 with full MCP integration.

---

Quick Navigation

Use the Table of Contents in the right sidebar to jump to any module documentation.

1. MoLOS-AI-Knowledge v1.1.0

A knowledge base and prompt management system that lets you organize information and reusable prompt templates for AI agents.

Overview

Location: /ui/MoLOS-AI-Knowledge Version: 1.1.0

The MoLOS-AI-Knowledge module provides a centralized repository for structured knowledge entries and reusable prompt templates. It serves as the memory layer for AI agents, enabling them to access your domain-specific knowledge, predefined instructions, and refined prompt patterns.

Features:

• Hierarchical knowledge organization with folders and tags
• Prompt template management with variable substitution
• Full-text search across all knowledge entries
• Version control for knowledge entries
• Cross-references between knowledge items
• AI integration via MCP tools

Navigation

Section	Path	Description
Knowledge Base	/ui/MoLOS-AI-Knowledge	Browse and manage knowledge entries
Prompts	/ui/MoLOS-AI-Knowledge/prompts	Create and manage prompt templates
Search	/ui/MoLOS-AI-Knowledge/search	Full-text search across entries
Import/Export	/ui/MoLOS-AI-Knowledge/settings	Data portability and backup

Core Features

Hierarchical Knowledge Organization

Knowledge entries are organized in a folder-based hierarchy:

/Knowledge
├── Development/
│   ├── Architecture/
│   │   ├── system-design.md
│   │   └── api-patterns.md
│   └── Coding Standards/
│       ├── typescript-guide.md
│       └── code-review-checklist.md
├── Domain Expertise/
│   ├── project-context.md
│   └── business-rules.md
└── Reference/
    ├── glossary.md
    └── faq.md

Prompt Template Management

Create reusable prompt templates with variable substitution:

// Example prompt template
const template = {
  name: "Code Review Template",
  content: "Review the following {{language}} code for:\n1. Security vulnerabilities\n2. Performance issues\n3. Code style\n\nCode:\n{{code}}",
  variables: [
    { name: "language", description: "Programming language", required: true },
    { name: "code", description: "Code snippet to review", required: true }
  ]
};

Full-Text Search

Search across all knowledge entries with ranking and highlighting.

Version Control

Every knowledge entry tracks changes with full version history.

Cross-References

Link knowledge entries to each other for contextual navigation.

AI Integration (MCP Tools)

The AI-Knowledge module exposes the following tools for the Architect Agent:

Tool	Description
get_knowledge	Retrieve a specific knowledge entry by ID
create_knowledge	Create a new knowledge entry
update_knowledge	Update an existing knowledge entry
delete_knowledge	Remove a knowledge entry
search_knowledge	Full-text search across knowledge entries
get_prompts	Retrieve all prompt templates
get_prompt	Get a specific prompt template by ID
create_prompt	Create a new prompt template
update_prompt	Update an existing prompt template
delete_prompt	Remove a prompt template
apply_prompt	Apply a prompt template with variable values

API Endpoints

Knowledge API

Method	Endpoint	Description
GET	/api/AI-Knowledge/knowledge	List all knowledge entries
GET	/api/AI-Knowledge/knowledge/:id	Get specific entry
POST	/api/AI-Knowledge/knowledge	Create knowledge entry
PUT	/api/AI-Knowledge/knowledge/:id	Update entry
DELETE	/api/AI-Knowledge/knowledge/:id	Delete entry
GET	/api/AI-Knowledge/knowledge/search	Search entries

Prompts API

Method	Endpoint	Description
GET	/api/AI-Knowledge/prompts	List all prompt templates
GET	/api/AI-Knowledge/prompts/:id	Get specific template
POST	/api/AI-Knowledge/prompts	Create prompt template
PUT	/api/AI-Knowledge/prompts/:id	Update template
DELETE	/api/AI-Knowledge/prompts/:id	Delete template
POST	/api/AI-Knowledge/prompts/:id/apply	Apply template with variables

Database Schema

MoLOS-AI-Knowledge_knowledge_entries

Column	Type	Description
id	TEXT	Primary key
title	TEXT	Entry title
content	TEXT	Knowledge content (markdown)
path	TEXT	Hierarchical path
tags	JSON	Array of tags
references	JSON	Array of related entry IDs
createdAt	INTEGER	Creation timestamp
updatedAt	INTEGER	Last update timestamp

MoLOS-AI-Knowledge_prompt_templates

Column	Type	Description
id	TEXT	Primary key
name	TEXT	Template name
content	TEXT	Prompt content with {{variable}} placeholders
variables	JSON	Array of variable definitions
tags	JSON	Array of tags
createdAt	INTEGER	Creation timestamp
updatedAt	INTEGER	Last update timestamp

MoLOS-AI-Knowledge_versions

Column	Type	Description
id	TEXT	Primary key
entryId	TEXT	Foreign key to knowledge entry
content	TEXT	Content snapshot
version	INTEGER	Version number
createdAt	INTEGER	Version timestamp

Use Cases

AI Research Assistant

Store domain-specific research, glossaries, and context documents that AI agents can reference when answering questions. For example, keep your project's architecture decisions and business rules in the knowledge base so the AI always has up-to-date context.

Prompt Engineering

Create and iterate on prompt templates for recurring tasks. Refine prompts over time using version history, then share templates with other modules via the apply_prompt MCP tool.

Integration

Module	Integration
LLM Council	Council personas access knowledge entries for domain context
Markdown	Cross-link knowledge entries with documentation pages
Tasks	AI agents use knowledge when creating or analyzing tasks
Goals	Reference knowledge entries for goal context

Best Practices

Tagging Strategy

Use consistent, lowercase tags with hyphens. Create a tag taxonomy at the top level (e.g., domain:backend, type:architecture, project:molos) and apply 2-5 tags per entry.

Prompt Templates

Start with broad templates and refine them. Use version history to compare prompt iterations. Always include a description field so AI agents understand when to use each template.

Knowledge Organization

Mirror your project structure in the knowledge hierarchy. Keep entries focused on a single topic. Use cross-references instead of duplicating content.

Troubleshooting

Search Not Returning Results

Problem: Search queries return no results for known content.

Solution:

1. Check that the knowledge entry is published (not draft)
2. Try broader search terms
3. Verify the search index is up to date (try refreshing the page)
4. Check that the entry's path is correct

Template Variable Errors

Problem: Applying a prompt template fails with variable errors.

Solution:

1. Ensure all required variables are provided
2. Check variable names match exactly (case-sensitive)
3. Verify variable values don't contain template syntax ({{ or }})
4. Review the template content for malformed placeholders

Import Failures

Problem: Knowledge import from JSON fails silently.

Solution:

1. Validate the JSON structure matches the expected schema
2. Check for duplicate entry IDs in the import file
3. Ensure file size is within limits
4. Review the import logs in the browser console

---

2. MoLOS-Goals v1.1.0

A goal setting and tracking system with visual progress charts, milestones, and recurrence support.

Overview

Location: /ui/MoLOS-Goals Version: 1.1.0

The MoLOS-Goals module provides a structured approach to setting, tracking, and achieving personal and professional goals. With support for categories, milestones, progress visualization, and recurrence, it transforms vague aspirations into actionable, measurable outcomes.

Features:

• Goal creation with SMART criteria support
• Categorized goals with custom categories
• Milestone tracking for incremental progress
• Recurring goals for habits and routines
• Visual progress charts and dashboards
• AI integration via MCP tools

Navigation

Section	Path	Description
Dashboard	/ui/MoLOS-Goals	Overview with progress summaries
All Goals	/ui/MoLOS-Goals/goals	Browse and manage all goals
Categories	/ui/MoLOS-Goals/categories	Manage goal categories
Calendar	/ui/MoLOS-Goals/calendar	Calendar view of deadlines
Settings	/ui/MoLOS-Goals/settings	Configure goal preferences

Core Features

Goal Creation

Create goals with detailed configuration:

Property	Type	Description
title	string	Goal name (required)
description	string	Detailed description
category	string	Category assignment
status	enum	not_started, in_progress, completed, paused, abandoned
progress	number	Percentage (0-100)
targetDate	number	Target completion timestamp
milestones	JSON	Array of milestone objects
recurrence	string	none, daily, weekly, monthly, yearly

Categories

Organize goals into meaningful categories:

// Example categories
const categories = [
  { name: "Career", color: "#3B82F6", icon: "briefcase" },
  { name: "Health", color: "#10B981", icon: "heart" },
  { name: "Finance", color: "#F59E0B", icon: "wallet" },
  { name: "Learning", color: "#8B5CF6", icon: "book" },
  { name: "Personal", color: "#EC4899", icon: "user" }
];

Milestones

Break goals into measurable milestones:

const milestones = [
  { title: "Complete research phase", completed: true, dueDate: 1774112409 },
  { title: "Build prototype", completed: false, dueDate: 1774717209 },
  { title: "Launch MVP", completed: false, dueDate: 1775926809 }
];

Visual Progress Charts

Track progress with:

• Circular progress indicators per goal
• Category breakdown bar charts
• Timeline view for milestone completion
• Trend charts showing progress over time

AI Integration (MCP Tools)

Tool	Description
get_goals	Retrieve goals with filtering by status, category
create_goal	Create a new goal with milestones
update_goal	Update goal properties and progress
update_progress	Update goal progress percentage
delete_goal	Remove a goal
get_milestones	Get milestones for a goal
complete_milestone	Mark a milestone as completed
get_goal_stats	Get goal analytics and summaries

API Endpoints

Method	Endpoint	Description
GET	/api/Goals/goals	List all goals
GET	/api/Goals/goals/:id	Get specific goal
POST	/api/Goals/goals	Create goal
PUT	/api/Goals/goals/:id	Update goal
DELETE	/api/Goals/goals/:id	Delete goal
PUT	/api/Goals/goals/:id/progress	Update progress
GET	/api/Goals/categories	List categories
POST	/api/Goals/categories	Create category
GET	/api/Goals/stats	Get goal analytics

Database Schema

MoLOS-Goals_goals

Column	Type	Description
id	TEXT	Primary key
title	TEXT	Goal title
description	TEXT	Detailed description
category	TEXT	Category name
status	TEXT	Current status
progress	INTEGER	Progress percentage (0-100)
targetDate	INTEGER	Target completion timestamp
milestones	JSON	Array of milestone objects
recurrence	TEXT	Recurrence pattern
createdAt	INTEGER	Creation timestamp
updatedAt	INTEGER	Last update timestamp

MoLOS-Goals_categories

Column	Type	Description
id	TEXT	Primary key
name	TEXT	Category name
color	TEXT	Hex color code
icon	TEXT	Icon identifier
createdAt	INTEGER	Creation timestamp

Use Cases

Annual Planning

Set yearly goals across multiple categories (career, health, finance, learning). Break each goal into quarterly milestones. Review progress monthly using the dashboard charts. AI agents can suggest adjustments based on progress trends.

Habit Formation

Use recurring goals to track daily, weekly, or monthly habits. Combine with the Tasks module to create actionable checklists. Use progress charts to visualize streaks and consistency over time.

Integration

Module	Integration
Tasks	Break goals into actionable tasks with dependencies
Daily Logs	Track goal progress in daily reviews
Health	Set and track health-related goals
AI Knowledge	Store goal-related context for AI agents
LLM Council	Get AI perspectives on goal planning

Best Practices

SMART Goals

Write goals that are Specific, Measurable, Achievable, Relevant, and Time-bound. Use the description field to define success criteria. Set realistic target dates and meaningful milestones.

Milestone Planning

Break large goals into 3-7 milestones. Each milestone should be independently verifiable. Set due dates for each milestone that sum to the overall target date.

Regular Reviews

Schedule weekly goal reviews in your Daily Log. Use the dashboard to identify stalled goals. Let AI agents analyze patterns and suggest course corrections.

Troubleshooting

Progress Not Updating

Problem: Goal progress percentage doesn't change after completing milestones.

Solution:

1. Check that milestone completion was saved (refresh the page)
2. Verify the update_progress call succeeded
3. Ensure progress is auto-calculated or manually synced
4. Check browser console for error messages

Goal Deletion Not Working

Problem: Cannot delete a goal, or it reappears after deletion.

Solution:

1. Check if the goal has linked tasks (remove them first)
2. Verify you have permission to delete the goal
3. Clear the Docusaurus cache and retry
4. Check for active references from other modules

Milestone Issues

Problem: Milestones appear out of order or duplicates exist.

Solution:

1. Edit the goal and re-order milestones manually
2. Remove duplicate milestones and save
3. Ensure milestone due dates are unique and sequential
4. Refresh the page after saving changes

---

3. MoLOS-Health v1.1.0

A comprehensive health metrics tracking module for personal wellness, including vitals logging, medication management, and appointment scheduling.

Overview

Location: /ui/MoLOS-Health Version: 1.1.0

The MoLOS-Health module provides tools for tracking personal health metrics, managing medications, scheduling appointments, and maintaining a symptom journal. All data stays local on your infrastructure, ensuring complete privacy of sensitive health information.

Features:

• Vitals logging (weight, blood pressure, heart rate, blood sugar, sleep)
• Medication tracking with dosage schedules
• Appointment scheduling and reminders
• Visual charts and trend analysis
• Symptom journal with severity tracking
• AI integration via MCP tools

Navigation

Section	Path	Description
Dashboard	/ui/MoLOS-Health	Health overview with latest metrics
Vitals	/ui/MoLOS-Health/vitals	Log and view vital signs
Medications	/ui/MoLOS-Health/medications	Manage medications and schedules
Appointments	/ui/MoLOS-Health/appointments	Schedule and track appointments
Journal	/ui/MoLOS-Health/journal	Symptom and wellness journal
Settings	/ui/MoLOS-Health/settings	Units, reminders, and preferences

Core Features

Vitals Logging

Track a wide range of health metrics:

Metric	Unit	Typical Range
Weight	kg / lbs	Varies by individual
Blood Pressure	mmHg	90-120 / 60-80
Heart Rate	bpm	60-100
Blood Sugar	mg/dL	70-100 (fasting)
Sleep Duration	hours	7-9
Body Temperature	°C / °F	36.1-37.2°C
Steps	count	Varies by individual

Medication Tracking

Manage your medications with full scheduling support:

const medication = {
  name: "Vitamin D",
  dosage: "2000 IU",
  frequency: "daily",
  timeOfDay: ["08:00"],
  startDate: 1774112409,
  endDate: null, // Ongoing
  notes: "Take with food",
  refillReminder: true,
  refillDate: 1776711609
};

Appointment Scheduling

Schedule and track medical appointments:

Property	Type	Description
title	string	Appointment description
provider	string	Doctor or clinic name
date	number	Appointment timestamp
duration	number	Duration in minutes
location	string	Clinic address or link
notes	string	Pre-appointment notes
status	enum	scheduled, completed, cancelled
reminder	boolean	Enable reminder notification

Symptom Journal

Log symptoms with severity and context:

const journalEntry = {
  date: 1774112409,
  symptoms: [
    { name: "Headache", severity: 3, notes: "Behind eyes" },
    { name: "Fatigue", severity: 2, notes: "After lunch" }
  ],
  mood: "moderate",
  notes: "Didn't sleep well last night",
  triggers: ["poor sleep", "stress"]
};

Charts and Trend Analysis

Visualize health data over time with interactive charts for each metric type.

AI Integration (MCP Tools)

Tool	Description
log_health_data	Log vitals or health metrics
get_health_data	Retrieve health data with date filtering
analyze_trends	Analyze health trends over time
manage_medications	Add, update, or remove medications
schedule_appointment	Create or update appointments
log_symptoms	Log symptoms to the journal
get_health_summary	Get a comprehensive health overview

API Endpoints

Vitals API

Method	Endpoint	Description
GET	/api/Health/vitals	List vitals entries
POST	/api/Health/vitals	Log vitals entry
GET	/api/Health/vitals/:metric	Get entries for specific metric
GET	/api/Health/vitals/trends	Get trend analysis

Medications API

Method	Endpoint	Description
GET	/api/Health/medications	List all medications
POST	/api/Health/medications	Add medication
PUT	/api/Health/medications/:id	Update medication
DELETE	/api/Health/medications/:id	Remove medication

Appointments API

Method	Endpoint	Description
GET	/api/Health/appointments	List appointments
POST	/api/Health/appointments	Schedule appointment
PUT	/api/Health/appointments/:id	Update appointment
DELETE	/api/Health/appointments/:id	Cancel appointment

Journal API

Method	Endpoint	Description
GET	/api/Health/journal	List journal entries
POST	/api/Health/journal	Create journal entry
PUT	/api/Health/journal/:id	Update journal entry

Database Schema

MoLOS-Health_health_entries

Column	Type	Description
id	TEXT	Primary key
metric	TEXT	Metric type (weight, bp, hr, etc.)
value	REAL	Recorded value
unit	TEXT	Unit of measurement
notes	TEXT	Optional notes
date	INTEGER	Recording timestamp
createdAt	INTEGER	Creation timestamp

MoLOS-Health_medications

Column	Type	Description
id	TEXT	Primary key
name	TEXT	Medication name
dosage	TEXT	Dosage information
frequency	TEXT	How often to take
timeOfDay	JSON	Array of times
startDate	INTEGER	Start timestamp
endDate	INTEGER	End timestamp (nullable)
notes	TEXT	Additional notes
isActive	INTEGER	Active status (0/1)
createdAt	INTEGER	Creation timestamp

MoLOS-Health_appointments

Column	Type	Description
id	TEXT	Primary key
title	TEXT	Appointment title
provider	TEXT	Doctor or clinic
date	INTEGER	Appointment timestamp
duration	INTEGER	Duration in minutes
location	TEXT	Location details
notes	TEXT	Additional notes
status	TEXT	Appointment status
createdAt	INTEGER	Creation timestamp

MoLOS-Health_journal

Column	Type	Description
id	TEXT	Primary key
date	INTEGER	Entry timestamp
symptoms	JSON	Array of symptom objects
mood	TEXT	Mood description
notes	TEXT	General notes
triggers	JSON	Array of trigger tags
createdAt	INTEGER	Creation timestamp

Use Cases

Personal Health Monitoring

Track daily vitals like weight, blood pressure, and sleep. Use trend charts to identify patterns. Share summaries with your doctor. AI agents can flag concerning trends and suggest when to seek medical advice.

Family Health Tracking

Maintain separate health profiles for family members. Track appointments, medications, and symptoms for each person. Use the journal to document medical history and communicate with healthcare providers.

Integration

Module	Integration
Goals	Set health-related goals (weight loss, exercise targets)
Tasks	Create tasks for doctor visits, prescription refills
Google	Sync appointments to Google Calendar
Daily Logs	Reference health data in daily reviews

Best Practices

Regular Logging

Log vitals at the same time each day for consistent data. Set a daily reminder in Tasks. Even a single metric tracked consistently provides valuable trend data.

Medication Management

Keep medication records up to date. Note side effects in the journal. Set refill reminders ahead of time. Include dosage instructions for emergency reference.

Data Backup

Export health data regularly using the import/export feature. Store backups securely. Health data is sensitive—ensure backups are encrypted.

Troubleshooting

Chart Display Issues

Problem: Health charts don't render or show incomplete data.

Solution:

1. Ensure at least 2 data points exist for the selected time range
2. Check that metric values are valid numbers
3. Try selecting a different time range
4. Clear browser cache and reload

Data Sync Issues

Problem: Recently logged data doesn't appear in charts or lists.

Solution:

1. Refresh the page to trigger a data reload
2. Check browser console for network errors
3. Verify the data was saved (check the vitals list)
4. Ensure the date filter includes the entry date

Missing Vitals After Update

Problem: Some vitals entries disappeared after a module update.

Solution:

1. Check the import/export settings for a backup
2. Verify database migration completed successfully
3. Review module logs for migration errors
4. Restore from the most recent backup

---

4. MoLOS-Meals v1.1.0

A meal planning and recipe management system with nutrition tracking, shopping lists, and AI-powered meal suggestions.

Overview

Location: /ui/MoLOS-Meals Version: 1.1.0

The MoLOS-Meals module helps you plan meals, manage recipes, track nutrition, and generate shopping lists. With AI-powered meal suggestions and template-based planning, it simplifies the weekly meal preparation cycle from planning to shopping to cooking.

Features:

• Recipe database with ingredients and instructions
• Weekly and monthly meal calendar planning
• Auto-generated shopping lists from meal plans
• Nutrition tracking with macro and micronutrient breakdown
• Meal plan templates for quick setup
• AI integration via MCP tools

Navigation

Section	Path	Description
Dashboard	/ui/MoLOS-Meals	Meal plan overview and nutrition summary
Recipes	/ui/MoLOS-Meals/recipes	Browse and manage recipes
Meal Plans	/ui/MoLOS-Meals/plans	Create and manage meal plans
Shopping Lists	/ui/MoLOS-Meals/shopping	View and manage shopping lists
Nutrition	/ui/MoLOS-Meals/nutrition	Track nutrition goals and intake
Settings	/ui/MoLOS-Meals/settings	Dietary preferences and units

Core Features

Recipe Database

Store and organize recipes with full details:

const recipe = {
  title: "Greek Salad",
  description: "Fresh Mediterranean salad",
  ingredients: [
    { name: "Cucumber", amount: 1, unit: "whole" },
    { name: "Tomatoes", amount: 200, unit: "g" },
    { name: "Feta cheese", amount: 100, unit: "g" },
    { name: "Olive oil", amount: 2, unit: "tbsp" }
  ],
  instructions: "Chop vegetables. Crumble feta. Drizzle with olive oil.",
  prepTime: 15, // minutes
  cookTime: 0,
  servings: 2,
  tags: ["vegetarian", "quick", "summer"],
  nutrition: {
    calories: 220,
    protein: 8,
    carbs: 12,
    fat: 16
  }
};

Meal Calendar

Plan meals on a weekly or monthly calendar:

Property	Type	Description
date	number	Meal date timestamp
mealType	enum	breakfast, lunch, dinner, snack
recipeId	string	Linked recipe
servings	number	Number of servings
notes	string	Additional notes

Shopping Lists

Auto-generate shopping lists from meal plans:

• Smart Aggregation: Combines duplicate ingredients across recipes
• Categorized: Groups items by store section (produce, dairy, etc.)
• Checkable: Mark items as purchased
• Manual Items: Add non-recipe items to any list

Nutrition Tracking

Track daily and weekly nutrition intake:

Nutrient	Unit	Description
Calories	kcal	Total energy
Protein	g	Protein intake
Carbs	g	Carbohydrate intake
Fat	g	Fat intake
Fiber	g	Dietary fiber
Sodium	mg	Sodium intake

Meal Plan Templates

Create reusable templates for common meal patterns:

const template = {
  name: "High Protein Week",
  meals: {
    breakfast: ["oatmeal-protein", "greek-yogurt-bowl"],
    lunch: ["chicken-salad", "tuna-wrap"],
    dinner: ["salmon-veggies", "lean-steak"],
    snacks: ["protein-shake", "nuts"]
  }
};

AI Integration (MCP Tools)

Tool	Description
generate_meal_plan	Generate a meal plan based on preferences and constraints
suggest_recipes	Suggest recipes matching criteria
create_shopping_list	Generate shopping list from meal plan
get_recipes	Retrieve recipes with filtering
create_recipe	Create a new recipe
get_nutrition_summary	Get nutrition summary for a date range
get_meal_plan	Retrieve current meal plan

API Endpoints

Recipes API

Method	Endpoint	Description
GET	/api/Meals/recipes	List all recipes
GET	/api/Meals/recipes/:id	Get specific recipe
POST	/api/Meals/recipes	Create recipe
PUT	/api/Meals/recipes/:id	Update recipe
DELETE	/api/Meals/recipes/:id	Delete recipe
GET	/api/Meals/recipes/search	Search recipes

Meal Plans API

Method	Endpoint	Description
GET	/api/Meals/meal-plans	List meal plans
POST	/api/Meals/meal-plans	Create meal plan
PUT	/api/Meals/meal-plans/:id	Update meal plan
DELETE	/api/Meals/meal-plans/:id	Delete meal plan

Shopping Lists API

Method	Endpoint	Description
GET	/api/Meals/shopping-lists	List shopping lists
POST	/api/Meals/shopping-lists	Create shopping list
PUT	/api/Meals/shopping-lists/:id	Update list
POST	/api/Meals/shopping-lists/:id/items	Add item to list

Nutrition API

Method	Endpoint	Description
GET	/api/Meals/nutrition	Get nutrition log
GET	/api/Meals/nutrition/summary	Get nutrition summary
POST	/api/Meals/nutrition	Log nutrition entry

Database Schema

MoLOS-Meals_recipes

Column	Type	Description
id	TEXT	Primary key
title	TEXT	Recipe title
description	TEXT	Recipe description
ingredients	JSON	Array of ingredient objects
instructions	TEXT	Step-by-step instructions
prepTime	INTEGER	Prep time in minutes
cookTime	INTEGER	Cook time in minutes
servings	INTEGER	Number of servings
tags	JSON	Array of tags
createdAt	INTEGER	Creation timestamp
updatedAt	INTEGER	Last update timestamp

MoLOS-Meals_meal_plans

Column	Type	Description
id	TEXT	Primary key
name	TEXT	Plan name
startDate	INTEGER	Plan start timestamp
endDate	INTEGER	Plan end timestamp
meals	JSON	Array of meal assignments
createdAt	INTEGER	Creation timestamp

MoLOS-Meals_shopping_list_items

Column	Type	Description
id	TEXT	Primary key
listId	TEXT	Parent shopping list
name	TEXT	Item name
amount	REAL	Quantity
unit	TEXT	Unit of measurement
category	TEXT	Store section category
isChecked	INTEGER	Purchased status (0/1)
recipeId	TEXT	Source recipe (nullable)

MoLOS-Meals_nutrition

Column	Type	Description
id	TEXT	Primary key
date	INTEGER	Entry timestamp
mealType	TEXT	Meal type
recipeId	TEXT	Source recipe
calories	REAL	Calorie count
protein	REAL	Protein in grams
carbs	REAL	Carbs in grams
fat	REAL	Fat in grams

Use Cases

Weekly Meal Prep

Plan a full week of meals every Sunday. Generate a shopping list from the plan. Cook batch meals for lunch and dinner. Track nutrition to ensure balanced intake. Use templates to rotate through favorite meal patterns.

Dietary Tracking

Set nutrition goals (e.g., 2000 kcal/day, 150g protein). Log meals and snacks. Review weekly nutrition summaries. Use AI suggestions to fill nutritional gaps. Adjust meal plans based on tracking data.

Integration

Module	Integration
Tasks	Create shopping tasks from meal plans
Health	Cross-reference nutrition with health metrics
Goals	Set dietary goals and track progress
Google	Share shopping lists via Google Drive

Best Practices

Recipe Organization

Use consistent tags for recipes (cuisine type, dietary restriction, prep time). Include accurate nutrition data for every recipe. Rate recipes to surface favorites in AI suggestions.

Batch Cooking

Plan meals that share ingredients to reduce waste. Cook proteins and grains in bulk. Use the meal plan template system to create batch-cooking schedules.

Seasonal Planning

Adjust meal plans with seasonal produce. Create seasonal recipe collections. Update shopping lists to reflect what's in season for better nutrition and cost savings.

Troubleshooting

Nutrition Data Missing

Problem: Recipe shows 0 or missing nutrition information.

Solution:

1. Edit the recipe and add nutrition data manually
2. Ensure ingredient amounts include units
3. Use the AI suggest_recipes tool to auto-populate nutrition
4. Check that the nutrition fields are in the correct format (numbers, not strings)

Shopping List Sync Issues

Problem: Changes to the meal plan don't update the shopping list.

Solution:

1. Regenerate the shopping list after updating the meal plan
2. Check that the meal plan was saved successfully
3. Verify the recipe ingredients are complete
4. Clear the shopping list and regenerate from scratch

Recipe Import Problems

Problem: Imported recipe has formatting issues or missing fields.

Solution:

1. Validate the import JSON structure matches the schema
2. Ensure all required fields are present (title, ingredients)
3. Check that ingredient amounts are valid numbers
4. Review the import logs for specific field errors

---

5. MoLOS-Google v1.1.0

A Google services integration module that syncs your Google Calendar, Drive, Gmail, and Tasks with MoLOS for a unified productivity experience.

Overview

Location: /ui/MoLOS-Google Version: 1.1.0

The MoLOS-Google module bridges MoLOS with the Google ecosystem. It synchronizes calendars, manages Drive files, integrates Gmail, and keeps Google Tasks in sync with MoLOS Tasks. All data flows through your own infrastructure—Google API calls are made directly from your server, and credentials are stored locally.

Features:

• Google Calendar bidirectional sync
• Google Drive file management
• Gmail integration for reading and composing
• Google Tasks sync with MoLOS Tasks
• Configurable sync intervals
• AI integration via MCP tools

Navigation

Section	Path	Description
Dashboard	/ui/MoLOS-Google	Connection status and sync overview
Calendar	/ui/MoLOS-Google/calendar	Google Calendar sync
Drive	/ui/MoLOS-Google/drive	Google Drive files
Gmail	/ui/MoLOS-Google/gmail	Gmail integration
Tasks	/ui/MoLOS-Google/tasks	Google Tasks sync
Settings	/ui/MoLOS-Google/settings	OAuth and sync configuration

Core Features

Google Calendar Sync

Synchronize events between Google Calendar and MoLOS:

Property	Type	Description
title	string	Event title
description	string	Event description
startTime	number	Start timestamp
endTime	number	End timestamp
location	string	Event location
attendees	JSON	Array of attendee emails
googleEventId	string	Google Calendar event ID
syncStatus	enum	synced, pending, conflict

Google Drive Management

Browse, upload, and manage Drive files from within MoLOS:

• File Browser: Navigate Drive folders
• Upload: Upload files to Drive
• Search: Search across Drive content
• Sharing: Manage file sharing permissions

Gmail Integration

Read and compose emails without leaving MoLOS:

• Inbox: Read and search emails
• Compose: Write and send emails
• Labels: Manage Gmail labels and filters
• Attachments: Handle email attachments

Google Tasks Sync

Keep MoLOS Tasks and Google Tasks in sync:

• Bidirectional Sync: Changes in either system propagate
• Conflict Resolution: Configurable conflict handling
• Selective Sync: Choose which task lists to sync

AI Integration (MCP Tools)

Tool	Description
schedule_event	Create a Google Calendar event
get_events	Retrieve calendar events for a date range
update_event	Modify an existing event
delete_event	Remove a calendar event
create_document	Create a Google Drive document
search_drive	Search Google Drive files
send_email	Compose and send an email
read_emails	Retrieve emails with filtering
sync_tasks	Trigger manual sync of Google Tasks

API Endpoints

Calendar API

Method	Endpoint	Description
GET	/api/Google/calendar/events	List calendar events
POST	/api/Google/calendar/events	Create event
PUT	/api/Google/calendar/events/:id	Update event
DELETE	/api/Google/calendar/events/:id	Delete event
GET	/api/Google/calendar/sync	Trigger sync

Drive API

Method	Endpoint	Description
GET	/api/Google/drive/files	List Drive files
POST	/api/Google/drive/upload	Upload file
GET	/api/Google/drive/search	Search Drive
DELETE	/api/Google/drive/files/:id	Delete file

Gmail API

Method	Endpoint	Description
GET	/api/Google/gmail/messages	List emails
GET	/api/Google/gmail/messages/:id	Get email
POST	/api/Google/gmail/send	Send email
GET	/api/Google/gmail/search	Search emails

Tasks Sync API

Method	Endpoint	Description
GET	/api/Google/tasks/lists	List Google Task lists
GET	/api/Google/tasks/sync	Trigger task sync
POST	/api/Google/tasks/configure	Configure sync settings

Database Schema

MoLOS-Google_google_events

Column	Type	Description
id	TEXT	Primary key
googleEventId	TEXT	Google Calendar event ID
title	TEXT	Event title
description	TEXT	Event description
startTime	INTEGER	Start timestamp
endTime	INTEGER	End timestamp
location	TEXT	Event location
syncStatus	TEXT	Sync status
lastSyncedAt	INTEGER	Last sync timestamp

MoLOS-Google_drive_files

Column	Type	Description
id	TEXT	Primary key
googleFileId	TEXT	Google Drive file ID
name	TEXT	File name
mimeType	TEXT	File type
parentId	TEXT	Parent folder ID
size	INTEGER	File size in bytes
lastSyncedAt	INTEGER	Last sync timestamp

MoLOS-Google_gmail_messages

Column	Type	Description
id	TEXT	Primary key
googleMessageId	TEXT	Gmail message ID
threadId	TEXT	Gmail thread ID
subject	TEXT	Email subject
from	TEXT	Sender email
to	TEXT	Recipient emails (JSON)
snippet	TEXT	Message preview
labels	JSON	Gmail labels
receivedAt	INTEGER	Receive timestamp

MoLOS-Google_sync_config

Column	Type	Description
id	TEXT	Primary key
service	TEXT	Google service name
syncInterval	INTEGER	Sync interval in minutes
lastSyncAt	INTEGER	Last successful sync
status	TEXT	Sync status
errorCount	INTEGER	Consecutive error count

Use Cases

Cross-Platform Productivity

Use MoLOS as your central hub while keeping Google Calendar, Drive, and Gmail synchronized. AI agents can schedule events, search emails, and manage files—all through a single interface with MCP tools.

Google Ecosystem Users

For teams or individuals deeply invested in Google Workspace, this module provides seamless two-way sync. Keep your existing Google workflows while benefiting from MoLOS's task management, goals, and AI capabilities.

Integration

Module	Integration
Tasks	Bidirectional sync between MoLOS Tasks and Google Tasks
Health	Sync health appointments to Google Calendar
Meals	Share shopping lists via Google Drive
Goals	Add goal milestones to Google Calendar
LLM Council	AI agents access Google data for richer context

Best Practices

API Rate Limiting

Google APIs enforce rate limits. Configure sync intervals to stay within quotas. Use batch operations where possible. Monitor the sync dashboard for rate limit warnings.

Error Handling

Configure retry logic for failed sync operations. Set up alerts for persistent sync failures. Review the error count column in sync_config to detect chronic issues.

Permission Management

Grant only the minimum required OAuth scopes. Review permissions periodically. Revoke access for unused integrations. Never share OAuth credentials.

Troubleshooting

OAuth Token Issues

Problem: Sync fails with authentication errors.

Solution:

1. Re-authorize by going to Settings and clicking "Reconnect"
2. Verify the OAuth client ID and secret are correct
3. Check that the redirect URI matches your MoLOS instance
4. Ensure the Google API services are enabled in your Google Cloud console

Sync Conflicts

Problem: Data differs between MoLOS and Google after sync.

Solution:

1. Check the sync_config table for error count
2. Review conflict resolution settings in the Google module settings
3. Trigger a manual sync to force reconciliation
4. If needed, choose a "source of truth" and reset the other side

Quota Exceeded

Problem: Google API calls return 429 (Too Many Requests) errors.

Solution:

1. Increase the sync interval in Settings
2. Reduce the number of concurrent API calls
3. Check the Google Cloud Console for current quota usage
4. Wait for the quota window to reset (usually 24 hours)

---

6. MoLOS-Sample-Module v1.1.0

An example module demonstrating the MoLOS module development patterns, including UI components, database CRUD operations, API endpoints, and AI tool integration.

Overview

Location: /ui/MoLOS-Sample-Module Version: 1.1.0

The MoLOS-Sample-Module serves as a reference implementation for developers building custom modules. It demonstrates every aspect of the module architecture: Svelte UI components, SQLite database operations, REST API endpoints, and MCP tool definitions. Use this module as a starting point and template for your own modules.

Features:

• Sample UI with Svelte components and layouts
• Complete database CRUD (Create, Read, Update, Delete)
• REST API endpoint demonstrations
• AI tool integration via MCP protocol
• Configuration and settings panel
• Standalone—no cross-module dependencies

Navigation

Section	Path	Description
Dashboard	/ui/MoLOS-Sample-Module	Module overview and sample data
Data	/ui/MoLOS-Sample-Module/data	CRUD operations demo
Actions	/ui/MoLOS-Sample-Module/actions	Custom action demonstrations
API Demo	/ui/MoLOS-Sample-Module/api-demo	API endpoint testing
Settings	/ui/MoLOS-Sample-Module/settings	Module configuration

Core Features

Sample UI

Demonstrates standard MoLOS UI patterns:

<!-- Example: Sample data list component -->
<script lang="ts">
  import type { SampleItem } from './types';

  interface Props {
    items: SampleItem[];
    onSelect: (item: SampleItem) => void;
  }

  let { items, onSelect }: Props = $props();
</script>

<div class="sample-list">
  {#each items as item (item.id)}
    <button class="sample-item" onclick={() => onSelect(item)}>
      <span class="item-title">{item.title}</span>
      <span class="item-status">{item.status}</span>
    </button>
  {/each}
</div>

Database CRUD

Full Create, Read, Update, Delete operations:

Operation	Description	Example
Create	Insert new records	Add a sample data item
Read	Query records	List items with filters
Update	Modify existing records	Change item status
Delete	Remove records	Delete by ID or bulk

API Endpoints Demo

REST API endpoints following MoLOS conventions:

Method	Endpoint	Description
GET	/api/Sample-Module/data	List all sample data
GET	/api/Sample-Module/data/:id	Get single item
POST	/api/Sample-Module/data	Create item
PUT	/api/Sample-Module/data/:id	Update item
DELETE	/api/Sample-Module/data/:id	Delete item
POST	/api/Sample-Module/actions	Execute custom action

Settings Panel

Demonstrates module configuration patterns:

interface ModuleSettings {
  theme: 'light' | 'dark' | 'system';
  pageSize: number;
  autoRefresh: boolean;
  refreshInterval: number; // seconds
  debugMode: boolean;
}

AI Integration (MCP Tools)

The Sample-Module exposes example MCP tools that demonstrate the tool definition pattern:

Tool	Description
sample_tool_1	Retrieve sample data with filtering options
sample_tool_2	Create or update sample data items
sample_tool_3	Execute a custom action on sample data
sample_get_settings	Retrieve module configuration
sample_analyze	Perform analysis on sample data

Tool Definition Pattern:

// Example MCP tool definition
const sampleTool = {
  name: "sample_tool_1",
  description: "Retrieve sample data items with optional filtering",
  parameters: {
    filter: { type: "string", required: false, description: "Filter query" },
    limit: { type: "number", required: false, description: "Max results" },
    sortBy: { type: "string", required: false, description: "Sort field" }
  },
  handler: async (params) => {
    // Implementation
  }
};

API Endpoints

Data API

Method	Endpoint	Description
GET	/api/Sample-Module/data	List all items with pagination
GET	/api/Sample-Module/data/:id	Get specific item
POST	/api/Sample-Module/data	Create new item
PUT	/api/Sample-Module/data/:id	Update existing item
DELETE	/api/Sample-Module/data/:id	Delete item
POST	/api/Sample-Module/data/bulk	Bulk create/update/delete

Actions API

Method	Endpoint	Description
POST	/api/Sample-Module/actions	Execute custom action
GET	/api/Sample-Module/actions/history	Get action history

Settings API

Method	Endpoint	Description
GET	/api/Sample-Module/settings	Get module settings
PUT	/api/Sample-Module/settings	Update module settings

Database Schema

MoLOS-Sample-Module_sample_data

Column	Type	Description
id	TEXT	Primary key (auto-generated UUID)
title	TEXT	Item title
description	TEXT	Item description
status	TEXT	Status (active, archived, draft)
priority	INTEGER	Priority level (1-5)
tags	JSON	Array of tag strings
metadata	JSON	Arbitrary key-value metadata
value	REAL	Numeric value field
isActive	INTEGER	Active flag (0/1)
createdAt	INTEGER	Creation timestamp
updatedAt	INTEGER	Last update timestamp

This schema demonstrates all common column types used in MoLOS modules: TEXT, INTEGER, REAL, and JSON.

Use Cases

Learning Module Development

Use this module as a reference when building your first custom module. Study the directory structure, copy the boilerplate, and follow the patterns demonstrated in the code. Each section is annotated with comments explaining the MoLOS conventions.

Testing API Patterns

Use the built-in API demo page to test REST endpoints and understand the request/response format. Verify your own module's API behavior by comparing against the sample module's documented patterns.

Integration

This module is designed as a standalone example with no cross-module integration. However, it demonstrates integration patterns you can apply:

Pattern	Example
Link to Tasks	Reference task IDs in sample data
Link to Markdown	Embed knowledge entry IDs
MCP Tools	Follow the tool definition pattern for AI integration

Best Practices

Code Organization

Follow the standard module directory structure:

modules/MoLOS-Sample-Module/
├── ui/                    # Frontend (Svelte)
│   ├── +layout.svelte
│   ├── +page.svelte
│   └── components/
├── server/                # Backend
│   ├── api/               # API endpoints
│   ├── repositories/      # Database layer
│   └── mcp/               # MCP tool definitions
├── models/                # TypeScript types
├── package.json
└── tsconfig.json

Testing Patterns

Test your module at each layer:

1. Database: Verify CRUD operations with raw SQL
2. API: Use the API demo page or curl to test endpoints
3. UI: Test components in isolation before integrating
4. MCP: Verify tool definitions with the Architect Agent

Deployment

• Keep package.json name as @molos/module-{name}
• Use workspace:* for dependencies on shared packages
• Ensure TypeScript compiles without errors (tsc --noEmit)
• Test the module in the monorepo dev server before release

Troubleshooting

Build Errors

Problem: Module fails to compile or build.

Solution:

1. Verify all TypeScript types are correct
2. Check that imports reference valid module paths
3. Ensure package.json name follows the @molos/module-* convention
4. Run tsc --noEmit from the module directory for detailed errors

Runtime Issues

Problem: Module loads but shows errors at runtime.

Solution:

1. Check browser console for JavaScript errors
2. Verify API endpoints return valid JSON
3. Ensure database tables are created on first run
4. Check that the module is registered in the workspace configuration

Permission Problems

Problem: Module features don't work due to permissions.

Solution:

1. Check that the module has required database permissions
2. Verify API endpoints have correct authentication
3. Ensure MCP tools have appropriate scope
4. Review module logs for permission-related errors

---

Module Index

Module	Status	Documentation
Tasks	✅ Production	Full Guide
Markdown	✅ Production	Full Guide
LLM Council	✅ Production	Full Guide
AI-Knowledge	✅ Production	This Document
Goals	✅ Production	This Document
Health	✅ Production	This Document
Meals	✅ Production	This Document
Google	✅ Production	This Document
Sample-Module	✅ Sample	This Document

---

Getting Started with Additional Modules

Quick Start

All 6 modules are production-ready and can be activated in your MoLOS instance. Navigate to the module location in the UI to explore features.

Development

For building custom modules, see Module Development Guide and reference MoLOS-Sample-Module.

---

Last Updated: March 21, 2026 | Version: 1.1.0