@starascendin/lifeos-mcp 0.7.73 → 0.7.75

package/README.md

@@ -95,9 +95,10 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 - **get_tasks** - Get tasks with filters (project, status, priority)
 - **get_todays_tasks** - Get today's tasks and top priorities
 - **get_overdue_tasks** - Get open tasks that are already overdue
-- **create_issue** - Create a new task/issue, optionally with a calendar start/end time
-- **update_issue** - Update an existing task, including estimate/story points and scheduled calendar time
+- **create_issue** - Create a new task/issue, optionally with an initial issue calendar block
+- **update_issue** - Update an existing task, including estimate/story points and due date
 - **mark_issue_complete** - Mark a task as done
+- **create_calendar_block** - Create protected calendar-only time without creating a PM issue or Google event
 
 ### Phases
 - **get_phases** - Get all phases for a project
@@ -112,10 +113,10 @@ Add to your `.mcp.json` (project root or `~/.claude/mcp.json`):
 - **assign_issue_to_cycle** - Add task to a cycle
 
 ### Agenda
-- **get_daily_agenda** - Today's tasks, events, priorities
-- **get_weekly_agenda** - Week's tasks and events
+- **get_daily_agenda** - Today's tasks, events, protected blocks, priorities
+- **get_weekly_agenda** - Week's tasks, events, and protected blocks
 - **get_planning_context** - Full day/week/current-cycle planning context for agents
-- **apply_planning_patch** - Mutating planning patch for due dates, priorities, current cycle, and notes
+- **apply_planning_patch** - Mutating planning patch for due dates, priorities, protected calendar-only blocks, current cycle, and notes
 
 ### Habits
 - **get_habits** - List active habits with streaks and completion stats

package/dist/build-info.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.7.73";
-export declare const BUILD_TIME = "2026-05-18T15:43:15.303Z";
+export declare const VERSION = "0.7.75";
+export declare const BUILD_TIME = "2026-05-19T19:39:48.444Z";

package/dist/build-info.js

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Regenerated on every build.
-export const VERSION = "0.7.73";
-export const BUILD_TIME = "2026-05-18T15:43:15.303Z";
+export const VERSION = "0.7.75";
+export const BUILD_TIME = "2026-05-19T19:39:48.444Z";

package/dist/index.js

@@ -326,15 +326,15 @@ const TOOLS = [
                 },
                 scheduledStartAt: {
                     type: "string",
-                    description: "Calendar start datetime in ISO format like '2026-05-18T09:00:00-07:00' (optional)",
+                    description: "First issue calendar block start datetime in ISO format like '2026-05-18T09:00:00-07:00' (optional, separate from dueDate)",
                 },
                 scheduledEndAt: {
                     type: "string",
-                    description: "Calendar end datetime in ISO format like '2026-05-18T10:30:00-07:00' (optional, required when scheduledStartAt is provided)",
+                    description: "First issue calendar block end datetime in ISO format like '2026-05-18T10:30:00-07:00' (optional, required when scheduledStartAt is provided)",
                 },
                 scheduledTimezone: {
                     type: "string",
-                    description: "IANA timezone for the scheduled block, e.g. 'America/Los_Angeles' (optional)",
+                    description: "IANA timezone for the issue calendar block, e.g. 'America/Los_Angeles' (optional)",
                 },
                 cycleId: {
                     type: "string",
@@ -437,11 +437,11 @@ const TOOLS = [
                 },
                 scheduledStartAt: {
                     type: "string",
-                    description: "Calendar start datetime in ISO format like '2026-05-18T09:00:00-07:00' (optional)",
+                    description: "Legacy calendar start datetime. Prefer apply_planning_patch schedule_issue to add issue calendar blocks.",
                 },
                 scheduledEndAt: {
                     type: "string",
-                    description: "Calendar end datetime in ISO format like '2026-05-18T10:30:00-07:00' (optional)",
+                    description: "Legacy calendar end datetime. Prefer apply_planning_patch schedule_issue to add issue calendar blocks.",
                 },
                 scheduledTimezone: {
                     type: "string",
@@ -973,7 +973,7 @@ const TOOLS = [
     },
     {
         name: "get_planning_context",
-        description: "Get full planning context for day/week/current cycle. Mirrors the LifeOS Agenda daily tab plus current cycle, backlog, habits, daily fields, calendar, and notes.",
+        description: "Get full planning context for day/week/current cycle. Mirrors the LifeOS Agenda daily tab plus current cycle, backlog, habits, daily fields, calendar, protected non-ticket calendar blocks, and notes.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1008,7 +1008,7 @@ const TOOLS = [
     },
     {
         name: "apply_planning_patch",
-        description: "Apply an agent-generated day/week/cycle planning patch. Mutates tasks, due dates, scheduled start/end times, top priorities, current cycle goals/assignments, daily fields, issue comments, Daily AI Comments, Weekly AI Comments, and daily/weekly notes.",
+        description: "Apply an agent-generated day/week/cycle planning patch. Mutates tasks, due dates, issue calendar blocks, protected non-ticket calendar blocks, top priorities, current cycle goals/assignments, daily fields, issue comments, Daily AI Comments, Weekly AI Comments, and daily/weekly notes.",
         inputSchema: {
             type: "object",
             properties: {
@@ -1035,7 +1035,7 @@ const TOOLS = [
                 },
                 operations: {
                     type: "array",
-                    description: "Operations to apply. Supported types: create_issue, update_issue, schedule_issue, assign_issue_to_current_cycle, set_top_priority, mark_issue_status, save_daily_note, save_weekly_note, set_daily_field, update_cycle_goals, add_issue_comment, add_daily_ai_comment, add_weekly_ai_comment.",
+                    description: "Operations to apply. Supported types: create_issue, create_calendar_block, update_issue, schedule_issue, assign_issue_to_current_cycle, set_top_priority, mark_issue_status, save_daily_note, save_weekly_note, set_daily_field, update_cycle_goals, add_issue_comment, add_daily_ai_comment, add_weekly_ai_comment. dueDate is the issue deadline/day assignment. schedule_issue adds one issue calendar block and can be repeated for multiple blocks.",
                     items: {
                         type: "object",
                         properties: {
@@ -1043,6 +1043,7 @@ const TOOLS = [
                                 type: "string",
                                 enum: [
                                     "create_issue",
+                                    "create_calendar_block",
                                     "update_issue",
                                     "schedule_issue",
                                     "assign_issue_to_current_cycle",
@@ -1059,7 +1060,7 @@ const TOOLS = [
                             },
                             payload: {
                                 type: "object",
-                                description: "Operation-specific payload. Use issueIdOrIdentifier for existing tasks, dueDate for day assignment/deadlines, scheduledStartAt/scheduledEndAt ISO datetimes or startTime/endTime with scheduledDate for calendar time blocks, userNote for notes, body/source for comments, goals for cycle goals.",
+                                description: "Operation-specific payload. Use issueIdOrIdentifier for existing tasks, dueDate for day assignment/deadlines, and schedule_issue with scheduledStartAt/scheduledEndAt or date plus startTime/endTime to add an issue calendar block. Use create_calendar_block with title, timezone, and either startAt/endAt ISO datetimes or date plus startTime/endTime for protected calendar-only blocks that must not create an issue.",
                             },
                         },
                         required: ["type", "payload"],
@@ -1069,6 +1070,82 @@ const TOOLS = [
             required: ["mode", "operations"],
         },
     },
+    {
+        name: "create_calendar_block",
+        description: "Create a protected LifeOS calendar-only block without creating a PM issue or Google-synced event. Use this for non-ticket time like dog walking, meals, errands, personal appointments, or holds.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                userId: {
+                    type: "string",
+                    description: "Override the default user ID (optional)",
+                },
+                title: {
+                    type: "string",
+                    description: "Block title, e.g. Dog walking",
+                },
+                description: {
+                    type: "string",
+                    description: "Optional description",
+                },
+                location: {
+                    type: "string",
+                    description: "Optional location",
+                },
+                startAt: {
+                    type: "string",
+                    description: "ISO datetime start, e.g. 2026-05-18T16:00:00-06:00. Alternative to date/startTime.",
+                },
+                endAt: {
+                    type: "string",
+                    description: "ISO datetime end, e.g. 2026-05-18T18:00:00-06:00. Alternative to date/endTime.",
+                },
+                date: {
+                    type: "string",
+                    description: "YYYY-MM-DD date when using local clock startTime/endTime",
+                },
+                startTime: {
+                    type: "string",
+                    description: "Local HH:mm start time, e.g. 16:00",
+                },
+                endTime: {
+                    type: "string",
+                    description: "Local HH:mm end time, e.g. 18:00",
+                },
+                timezone: {
+                    type: "string",
+                    description: "IANA timezone, e.g. America/Denver",
+                },
+                blockType: {
+                    type: "string",
+                    enum: [
+                        "protected_time",
+                        "personal",
+                        "focus",
+                        "appointment",
+                        "travel",
+                        "hold",
+                        "other",
+                    ],
+                    description: "Block type metadata (optional, default protected_time)",
+                },
+                source: {
+                    type: "string",
+                    enum: ["agent", "manual", "system", "import"],
+                    description: "Source metadata (optional, default agent)",
+                },
+                sourceDetail: {
+                    type: "string",
+                    description: "Optional agent/workflow name or source note",
+                },
+                isProtected: {
+                    type: "boolean",
+                    description: "Whether agents should protect this time (default true)",
+                },
+            },
+            required: ["title", "timezone"],
+        },
+    },
     {
         name: "regenerate_daily_summary",
         description: "Regenerate the AI summary for a specific day.",
@@ -5379,7 +5456,7 @@ const PROMPT_MESSAGES = {
                     type: "text",
                     text: `Get my daily standup briefing. Use the LifeOS MCP tools to gather:
 
-1. Call get_daily_agenda for today's agenda (tasks due today, calendar events, top priorities)
+1. Call get_daily_agenda for today's agenda (tasks due today, calendar events, protected calendar blocks, top priorities)
 2. Call get_todays_tasks for today's task list
 3. Call get_overdue_tasks to surface anything already slipping
 4. Call get_current_cycle for current sprint progress and stats
@@ -5391,7 +5468,7 @@ Summarize in a concise standup format:
 - **Tasks Due**: List tasks due today with priority
 - **Overdue**: Anything already late that needs immediate triage
 - **Sprint Progress**: Cycle completion % and key stats
-- **Calendar**: Any meetings or events today
+- **Calendar**: Any meetings, events, or protected blocks today
 
 Keep it short and actionable.`,
                 },
@@ -5415,10 +5492,12 @@ ${notesClause}
 
 Workflow:
 1. Call get_planning_context with daily=true, weekly=true, currentCycle=true, backlog=true, habits=true, dailyFields=true, calendar=true, voiceMemos=true.
-2. Decide today's top 3, tasks to assign to the day via dueDate, tasks to time-block via scheduledStartAt/scheduledEndAt, backlog items to pull into the current cycle, and any cycle goal updates.
+2. Decide today's top 3, tasks to assign to the day or deadline via dueDate, issue calendar blocks to add with schedule_issue, protected non-ticket calendar blocks to create with create_calendar_block, backlog items to pull into the current cycle, and any cycle goal updates.
 3. Call apply_planning_patch with mode "day" and dryRun=false. Use operations as needed:
    - create_issue for new tasks
-   - schedule_issue/update_issue for dueDate, scheduledStartAt/scheduledEndAt, status, priority, and estimate changes
+   - create_calendar_block for protected non-ticket time like errands, meals, dog walking, appointments, or holds; this must not create a PM issue
+   - update_issue for dueDate, status, priority, and estimate changes
+   - schedule_issue for each issue calendar block using issueIdOrIdentifier plus scheduledStartAt/scheduledEndAt, or date plus startTime/endTime; repeat for multiple blocks
    - assign_issue_to_current_cycle for current cycle work
    - set_top_priority for today's top 3
    - update_cycle_goals when the current cycle goal should change
@@ -5543,10 +5622,12 @@ ${notesClause}
 
 Workflow:
 1. Call get_planning_context with daily=true, weekly=true, currentCycle=true, backlog=true, habits=true, dailyFields=true, calendar=true, voiceMemos=true.
-2. Shape the week around the current cycle: update cycle goals, pull/assign tasks, assign tasks to days with dueDate, time-block tasks with scheduledStartAt/scheduledEndAt, and set near-term priorities.
+2. Shape the week around the current cycle: update cycle goals, pull/assign tasks, assign tasks to days or deadlines with dueDate, add issue calendar blocks with schedule_issue, create protected non-ticket calendar blocks with create_calendar_block, and set near-term priorities.
 3. Call apply_planning_patch with mode "week" and dryRun=false. Use operations as needed:
    - create_issue for new tasks
-   - schedule_issue/update_issue for dueDate, scheduledStartAt/scheduledEndAt, status, priority, and estimate changes
+   - create_calendar_block for protected non-ticket time like errands, meals, dog walking, appointments, or holds
+   - update_issue for dueDate, status, priority, and estimate changes
+   - schedule_issue for each issue calendar block using issueIdOrIdentifier plus scheduledStartAt/scheduledEndAt, or date plus startTime/endTime; repeat for multiple blocks
    - assign_issue_to_current_cycle for current cycle work
    - set_top_priority for immediate focus
    - update_cycle_goals for the active cycle
@@ -5570,11 +5651,13 @@ Do not ask for confirmation; the user intends this planning workflow to mutate L
                     text: `Help me plan my current cycle/sprint in LifeOS and apply the resulting mutations.
 
 1. Call get_planning_context with currentCycle=true, backlog=true, weekly=true, daily=true.
-2. Shape the current cycle: update cycle goals, pull/assign tasks, assign near-term tasks with dueDate, time-block tasks with scheduledStartAt/scheduledEndAt, and set near-term priorities.
+2. Shape the current cycle: update cycle goals, pull/assign tasks, assign near-term tasks to days or deadlines with dueDate, add issue calendar blocks with schedule_issue, create protected non-ticket calendar blocks with create_calendar_block, and set near-term priorities.
 3. Call apply_planning_patch with mode "cycle" and dryRun=false. Use operations as needed:
    - create_issue for new tasks
+   - create_calendar_block for protected non-ticket time that should appear on the calendar without creating a PM issue
    - assign_issue_to_current_cycle for current cycle work
-   - schedule_issue/update_issue for dueDate, scheduledStartAt/scheduledEndAt, status, priority, and estimate changes
+   - update_issue for dueDate, status, priority, and estimate changes
+   - schedule_issue for each issue calendar block using issueIdOrIdentifier plus scheduledStartAt/scheduledEndAt, or date plus startTime/endTime; repeat for multiple blocks
    - update_cycle_goals for active cycle goals
    - save_daily_note or save_weekly_note when useful as the readable plan artifact
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starascendin/lifeos-mcp",
-  "version": "0.7.73",
+  "version": "0.7.75",
   "description": "MCP server for LifeOS Project Management - manage projects, tasks, notes, and contacts via AI assistants",
   "type": "module",
   "main": "dist/index.js",