@togglhq/cli 1.11.224 → 1.11.225

package/build/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as CommanderError, i as shutdownCliTelemetry, n as captureCliException, r as initCliTelemetry, t as createProgram } from "./program-BWLypjki.js";
+import { a as CommanderError, i as shutdownCliTelemetry, n as captureCliException, r as initCliTelemetry, t as createProgram } from "./program-Dd98SRJu.js";
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";

package/build/index.js

@@ -1,2 +1,2 @@
-import { t as createProgram } from "./program-BWLypjki.js";
+import { t as createProgram } from "./program-Dd98SRJu.js";
 export { createProgram };

package/build/{program-BWLypjki.js → program-Dd98SRJu.js}

@@ -13156,7 +13156,7 @@ async function runSkillSetup(options) {
 	});
 }
 //#endregion
-//#region ../operations/build/validation-CLozpAO5.js
+//#region ../operations/build/validation-B7kaDM75.js
 const optionalNumber = /* @__PURE__ */ optional$1(/* @__PURE__ */ number$2());
 const perPageField = (max) => /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ number$2(), /* @__PURE__ */ integer(), /* @__PURE__ */ minValue$1(1), /* @__PURE__ */ maxValue$1(max), /* @__PURE__ */ description$1(`Results per page (1-${max})`)));
 const perPageSchema = perPageField(100);
@@ -13438,6 +13438,107 @@ const rateOverrides = {
 	"focus.rates.labor-upsert-workspace-labor-cost-rate": { agentGuidance: RATE_SCHEDULE_GUIDANCE },
 	"focus.rates.labor-upsert-workspace-user-labor-cost-rate": { agentGuidance: RATE_SCHEDULE_GUIDANCE }
 };
+const TASK_DATES_RULE = "Send start_date and end_date together, with end_date on or after start_date";
+const TASK_DATES_CREATE_GUIDANCE = `${TASK_DATES_RULE}; for a single due date, send both as that day.`;
+const taskOverrides = {
+	"focus.tasks.list": {
+		aliases: ["ls"],
+		agentGuidance: "Filter by start_date/end_date (ISO 8601, e.g. '2025-04-27') for date ranges, project_id, status_id, or assignee_user_id. Returns paginated results — use page/per_page for more. Use parent_task_id to list subtasks. Priority values: none, low, medium, high.",
+		examples: [
+			{
+				description: "List tasks due today",
+				data: {
+					start_date: "2025-04-27",
+					end_date: "2025-04-27"
+				}
+			},
+			{
+				description: "List tasks for a project",
+				data: { project_id: 123456 }
+			},
+			{
+				description: "List high-priority open tasks",
+				data: { priority: "high" }
+			}
+		]
+	},
+	"focus.tasks.get": { agentGuidance: "Fetch a single task with full detail including subtasks and time estimates." },
+	"focus.tasks.create": {
+		agentGuidance: `Required: name. Strongly recommended: project_id, status_id, assignee_user_ids. Use start_date/end_date for scheduling as date-only YYYY-MM-DD values; never pass RFC 3339 datetimes. ${TASK_DATES_CREATE_GUIDANCE} Set estimated_mins for time estimates.`,
+		examples: [{
+			description: "Create a minimal task",
+			data: { name: "Dogfood the CLI" }
+		}, {
+			description: "Create a task with full metadata",
+			data: {
+				name: "Review PR",
+				project_id: 123456,
+				assignee_user_ids: [789],
+				estimated_mins: 30
+			}
+		}]
+	},
+	"focus.tasks.update": {
+		agentGuidance: `Partial update — only include fields to change in payload. Provide task_id at top level and the fields to update under payload. custom_fields writes values as a map keyed by custom field ID; reads return the same data as custom_field_values[], so the write shape is not the read shape. ${TASK_DATES_RULE}; to move one date, resend the task's current other date; if the task has none, or that breaks the order, send the new date as both.`,
+		examples: [
+			{
+				description: "Change task status",
+				data: {
+					task_id: 12345,
+					payload: { status_id: 456789 }
+				}
+			},
+			{
+				description: "Assign to a user and update estimate",
+				data: {
+					task_id: 12345,
+					payload: {
+						assignee_user_ids: [789],
+						estimated_mins: 60
+					}
+				}
+			},
+			{
+				description: "Set a select custom field value",
+				data: {
+					task_id: 12345,
+					payload: { custom_fields: { "406": [1639] } }
+				}
+			}
+		]
+	},
+	"focus.tasks.full-update": { agentGuidance: "Follow the update action's date guidance." },
+	"focus.tasks.delete": { agentGuidance: "Permanently deletes the task and all its subtasks. Cannot be undone." },
+	"focus.tasks.bulk-patch": {
+		agentGuidance: "Prefer over many single updates: pass a JSON array of { id: taskId, ...partial fields }. Same field names and date guidance as single task update.",
+		examples: [{
+			description: "Set status on two tasks",
+			data: [{
+				id: 111,
+				status_id: 456789
+			}, {
+				id: 222,
+				status_id: 456789
+			}]
+		}, {
+			description: "Set a select custom field value on two tasks",
+			data: [{
+				id: 111,
+				custom_fields: { "406": [1639] }
+			}, {
+				id: 222,
+				custom_fields: { "406": [1640] }
+			}]
+		}]
+	},
+	"focus.tasks.bulk-delete": {
+		agentGuidance: "Deletes all listed task IDs in one HTTP call. Requires confirm flow like single delete.",
+		examples: [{
+			description: "Delete two tasks",
+			data: { ids: [111, 222] }
+		}]
+	}
+};
 const compositeOverrides = {
 	"focus.composite.create-project": {
 		description: "Create a project with related data such as members, milestones, rates, and billable rates.",
@@ -13451,6 +13552,7 @@ const compositeOverrides = {
 	},
 	"focus.composite.create-task": {
 		description: "Create a task with related data such as subtasks and an initial time entry.",
+		agentGuidance: `For payload.task and each payload.subtasks[] item: ${TASK_DATES_CREATE_GUIDANCE}`,
 		cli: {
 			group: ["tasks"],
 			command: "create-with-children",
@@ -13941,104 +14043,6 @@ const tagOverrides = {
 		}]
 	}
 };
-const taskOverrides = {
-	"focus.tasks.list": {
-		aliases: ["ls"],
-		agentGuidance: "Filter by start_date/end_date (ISO 8601, e.g. '2025-04-27') for date ranges, project_id, status_id, or assignee_user_id. Returns paginated results — use page/per_page for more. Use parent_task_id to list subtasks. Priority values: none, low, medium, high.",
-		examples: [
-			{
-				description: "List tasks due today",
-				data: {
-					start_date: "2025-04-27",
-					end_date: "2025-04-27"
-				}
-			},
-			{
-				description: "List tasks for a project",
-				data: { project_id: 123456 }
-			},
-			{
-				description: "List high-priority open tasks",
-				data: { priority: "high" }
-			}
-		]
-	},
-	"focus.tasks.get": { agentGuidance: "Fetch a single task with full detail including subtasks and time estimates." },
-	"focus.tasks.create": {
-		agentGuidance: "Required: name. Strongly recommended: project_id, status_id, assignee_user_ids. Use start_date/end_date for scheduling as date-only YYYY-MM-DD values; never pass RFC 3339 datetimes. Set estimated_mins for time estimates.",
-		examples: [{
-			description: "Create a minimal task",
-			data: { name: "Dogfood the CLI" }
-		}, {
-			description: "Create a task with full metadata",
-			data: {
-				name: "Review PR",
-				project_id: 123456,
-				assignee_user_ids: [789],
-				estimated_mins: 30
-			}
-		}]
-	},
-	"focus.tasks.update": {
-		agentGuidance: "Partial update — only include fields to change in payload. Provide task_id at top level and the fields to update under payload. custom_fields writes values as a map keyed by custom field ID; reads return the same data as custom_field_values[], so the write shape is not the read shape.",
-		examples: [
-			{
-				description: "Change task status",
-				data: {
-					task_id: 12345,
-					payload: { status_id: 456789 }
-				}
-			},
-			{
-				description: "Assign to a user and update estimate",
-				data: {
-					task_id: 12345,
-					payload: {
-						assignee_user_ids: [789],
-						estimated_mins: 60
-					}
-				}
-			},
-			{
-				description: "Set a select custom field value",
-				data: {
-					task_id: 12345,
-					payload: { custom_fields: { "406": [1639] } }
-				}
-			}
-		]
-	},
-	"focus.tasks.delete": { agentGuidance: "Permanently deletes the task and all its subtasks. Cannot be undone." },
-	"focus.tasks.bulk-patch": {
-		agentGuidance: "Prefer over many single updates: pass a JSON array of { id: taskId, ...partial fields }. Same field names as single task update.",
-		examples: [{
-			description: "Set status on two tasks",
-			data: [{
-				id: 111,
-				status_id: 456789
-			}, {
-				id: 222,
-				status_id: 456789
-			}]
-		}, {
-			description: "Set a select custom field value on two tasks",
-			data: [{
-				id: 111,
-				custom_fields: { "406": [1639] }
-			}, {
-				id: 222,
-				custom_fields: { "406": [1640] }
-			}]
-		}]
-	},
-	"focus.tasks.bulk-delete": {
-		agentGuidance: "Deletes all listed task IDs in one HTTP call. Requires confirm flow like single delete.",
-		examples: [{
-			description: "Delete two tasks",
-			data: { ids: [111, 222] }
-		}]
-	}
-};
 const timeEntryOverrides = {
 	"focus.time-entries.list": {
 		agentGuidance: "Returns tracked time entries in a date range, including taskless entries (tracked on a project with no task). Requires date_from and date_to. Accepts date-only strings (YYYY-MM-DD) or RFC3339 datetimes — date-only is automatically expanded: date_from to T00:00:00Z, date_to to T23:59:59Z. Optional project_id keeps only entries on that project (sent to the API; client also scans up to 50 list pages of 100, then slices page/per_page; not a full workspace scan). If truncated is true, more unfiltered rows exist than were scanned — narrow date_from/date_to. Pass include_taskless:false to hide taskless rows. Includes task and project context.",
@@ -29288,4 +29292,4 @@ Common commands:
 //#endregion
 export { CommanderError as a, shutdownCliTelemetry as i, captureCliException as n, initCliTelemetry as r, createProgram as t };
 
-//# sourceMappingURL=program-BWLypjki.js.map
+//# sourceMappingURL=program-Dd98SRJu.js.map

package/build/program.js

@@ -1,2 +1,2 @@
-import { t as createProgram } from "./program-BWLypjki.js";
+import { t as createProgram } from "./program-Dd98SRJu.js";
 export { createProgram };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@togglhq/cli",
-  "version": "1.11.224",
+  "version": "1.11.225",
   "description": "Toggl CLI for Toggl 2.0 API operations.",
   "license": "UNLICENSED",
   "type": "module",