@togglhq/cli 1.5.76 → 1.6.1

package/README.md

@@ -78,7 +78,7 @@ toggl [global flags] <group> … <subcommand> [flags]
 
 Many endpoints use two segments (`toggl tasks list`). Some use nested groups, including:
 
-- **`toggl organization …`** — organization APIs (not `toggl org …`; there is no `org` top-level command). Examples: `toggl organization invitations list`, `toggl organization members get`, `toggl organization workspaces list`, `toggl organization workspaces get-timezone`, `toggl organization workspaces update-timezone`.
+- **`toggl organization …`** — organization APIs (not `toggl org …`; there is no `org` top-level command). Examples: `toggl organization invitations list`, `toggl organization members get`, `toggl organization workspaces list`.
 - **`toggl shared …`** — shared workspace/org data routed through `@toggl/queries` helpers (status, holidays, working hours, time off). Example: `toggl shared status get`.
 
 Core resource groups still include `tasks`, `projects`, `time-blocks`, `time-entries`, `statuses`, `users`, `tags`, `clients`, and others surfaced by the public command catalog. Some low-level endpoints are omitted from the CLI and MCP. Existing public command paths and operation IDs stay stable; use `toggl --help` and `toggl <group> --help` to explore what shipped.

package/build/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as CommanderError, t as createProgram } from "./program-llOjKAp8.js";
+import { n as CommanderError, t as createProgram } from "./program-D1iMB9xT.js";
 //#region src/cli.ts
 try {
 	await createProgram({ enableUpdateNotification: true }).parseAsync(process.argv);

package/build/index.js

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

package/build/{program-llOjKAp8.js → program-D1iMB9xT.js}

@@ -10663,15 +10663,6 @@ async function patchOrganizationUserActive(httpClient, organization_id, organiza
 async function getWorkspaces(httpClient, organization_id, signal) {
 	return (await httpClient.get(`organizations/${organization_id}/workspaces`, { signal })).json();
 }
-async function getWorkspaceTimezone(httpClient, organization_id, workspace_id, signal) {
-	return (await httpClient.get(`organizations/${organization_id}/workspaces/${workspace_id}/settings/timezone`, { signal })).json();
-}
-async function putWorkspaceTimezone(httpClient, organization_id, workspace_id, data, signal) {
-	return (await httpClient.put(`organizations/${organization_id}/workspaces/${workspace_id}/settings/timezone`, {
-		signal,
-		json: data
-	})).json();
-}
 async function getWorkspaceUserMeRoles(httpClient, organization_id, workspace_id, signal) {
 	return (await httpClient.get(`organizations/${organization_id}/workspaces/${workspace_id}/users/me/roles`, { signal })).json();
 }
@@ -11596,20 +11587,6 @@ var FocusClient = class {
 			data: response.data
 		} : response;
 	}
-	async getOrgWorkspaceTimezone(workspaceId) {
-		const response = await this.run("getOrgWorkspaceTimezone", () => getWorkspaceTimezone(this.orgHttp, this.organizationIdNum, workspaceId));
-		return response.ok ? {
-			ok: true,
-			data: response.data
-		} : response;
-	}
-	async updateOrgWorkspaceTimezone(workspaceId, payload) {
-		const response = await this.run("updateOrgWorkspaceTimezone", () => putWorkspaceTimezone(this.orgHttp, this.organizationIdNum, workspaceId, payload));
-		return response.ok ? {
-			ok: true,
-			data: response.data
-		} : response;
-	}
 	async getSharedDataStatus() {
 		const response = await this.run("getSharedDataStatus", () => getStatus(this.sharedDataHttp));
 		return this.softValidateResponse("getSharedDataStatus", StatusOKSchema, response);
@@ -12500,7 +12477,7 @@ async function runSkillSetup(options) {
 	});
 }
 //#endregion
-//#region ../operations/build/safety-PA22Wppt.js
+//#region ../operations/build/safety-nrboW9fu.js
 const optionalNumber = /* @__PURE__ */ optional$1(/* @__PURE__ */ number$2());
 const DATE_FIELD_RE = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2}))?$/;
 const dateField = (description) => /* @__PURE__ */ pipe$2(/* @__PURE__ */ string$1(), /* @__PURE__ */ regex(DATE_FIELD_RE, "must be YYYY-MM-DD or RFC3339 datetime (e.g. '2025-01-01' or '2025-01-01T00:00:00Z')"), /* @__PURE__ */ description$1(description));
@@ -12735,6 +12712,7 @@ const clientOverrides = { "focus.clients.list": {
 const compositeOverrides = {
 	"focus.composite.create-project": {
 		description: "Create a project with related data such as members, milestones, rates, and billable rates.",
+		agentGuidance: "Follow the create action's privacy and billable guidance. Project fields go under payload.project.",
 		cli: {
 			group: ["projects"],
 			command: "create-advanced",
@@ -13036,16 +13014,20 @@ const projectOverrides = {
 	},
 	"focus.projects.get": { agentGuidance: "Fetch a single project with aggregated task counts and time estimates." },
 	"focus.projects.create": {
-		agentGuidance: "Required: name. Recommended: color (hex), billable (boolean). Associate with a client via client_id.",
+		agentGuidance: "Required: name. Recommended: color (hex). The API defaults private and billable to false when omitted. Match the Toggl UI on privacy. If the user explicitly asks for a shared or public project, pass private=false; no permissions check is needed, because only private projects require an entitlement. Otherwise call workspace-settings get-user-permissions and pass private=true when permissions includes access_private_projects_tasks_feature. If that permission is absent, pass private=false and tell the user; if the user explicitly required a private project, do not create a shared one. Leave billable unset unless the user explicitly says the work is billable or provides a rate. Associate with a client via client_id.",
 		examples: [{
-			description: "Create a project",
-			data: { name: "New feature" }
+			description: "Create a private internal project",
+			data: {
+				name: "Internal research",
+				private: true
+			}
 		}, {
-			description: "Create a billable project with color",
+			description: "Create a private billable project when billing was requested",
 			data: {
 				name: "Client work",
+				private: true,
 				billable: true,
-				color: "#e44332"
+				color: "#DD3919"
 			}
 		}]
 	},
@@ -13684,71 +13666,6 @@ const orgSharedOperations = [
 			return client.getMyWorkspaceRoles(body.workspace_id ?? Number.parseInt(client.workspaceId, 10));
 		}
 	},
-	{
-		id: "org.workspaces.get-timezone",
-		family: "org",
-		resource: "workspaces",
-		action: "get-timezone",
-		title: "Get workspace timezone",
-		description: "Get the workspace-level default timezone (null when unset). Requires organization admin.",
-		agentGuidance: "Use when you need the org-wide default timezone for a workspace. When timezone is null, members use their personal timezones.",
-		safety: "read",
-		destructive: false,
-		cli: {
-			group: ["organization", "workspaces"],
-			command: "get-timezone",
-			examples: [{
-				description: "Get timezone for the active workspace",
-				data: {}
-			}, {
-				description: "Get timezone for a specific workspace",
-				data: { workspace_id: 40770900 }
-			}]
-		},
-		mcp: { entityTool: "org-workspaces" },
-		inputSchema: /* @__PURE__ */ object$2({ workspace_id: /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ number$2(), /* @__PURE__ */ description$1("Workspace ID (defaults to profile)"))) }),
-		execute: (input, { client }) => {
-			const body = input;
-			return client.getOrgWorkspaceTimezone(body.workspace_id ?? client.workspaceIdNumber);
-		}
-	},
-	{
-		id: "org.workspaces.update-timezone",
-		family: "org",
-		resource: "workspaces",
-		action: "update-timezone",
-		title: "Update workspace timezone",
-		description: "Set or clear the workspace-level default timezone. Requires organization admin.",
-		agentGuidance: "Set timezone to an IANA name (e.g. Europe/London) or clear with clear: true / timezone: null so members fall back to personal timezones.",
-		safety: "update",
-		destructive: false,
-		cli: {
-			group: ["organization", "workspaces"],
-			command: "update-timezone",
-			examples: [{
-				description: "Set default timezone for the active workspace",
-				data: { timezone: "Europe/London" }
-			}, {
-				description: "Clear workspace default timezone",
-				data: { clear: true }
-			}]
-		},
-		mcp: { entityTool: "org-workspaces" },
-		inputSchema: /* @__PURE__ */ object$2({
-			workspace_id: /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ number$2(), /* @__PURE__ */ description$1("Workspace ID (defaults to profile)"))),
-			timezone: /* @__PURE__ */ optional$1(/* @__PURE__ */ nullable$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ string$1(), /* @__PURE__ */ description$1("IANA timezone (e.g. \"Europe/London\"), or null to clear")))),
-			clear: /* @__PURE__ */ optional$1(/* @__PURE__ */ pipe$2(/* @__PURE__ */ boolean$1(), /* @__PURE__ */ description$1("Clear workspace default timezone")))
-		}),
-		execute: (input, { client }) => {
-			const body = input;
-			const workspaceId = body.workspace_id ?? client.workspaceIdNumber;
-			const clearsTimezone = body.clear === true || body.timezone === null;
-			if (clearsTimezone && typeof body.timezone === "string") throw new Error("Pass either a timezone string or clear/null, not both");
-			if (clearsTimezone) return client.updateOrgWorkspaceTimezone(workspaceId, { timezone: null });
-			if (body.timezone === void 0) throw new Error("Pass --timezone <IANA>, --clear true, or timezone: null to remove the default");
-			return client.updateOrgWorkspaceTimezone(workspaceId, { timezone: body.timezone });
-		}
-	},
 	{
 		id: "shared.status.get",
 		family: "shared",
@@ -25147,4 +25064,4 @@ Common commands:
 //#endregion
 export { CommanderError as n, createProgram as t };
 
-//# sourceMappingURL=program-llOjKAp8.js.map
+//# sourceMappingURL=program-D1iMB9xT.js.map

package/build/program.js

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

package/package.json

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

package/skills/toggl-cli/reference/command-contract.md

@@ -21,9 +21,6 @@ toggl --workspace-id 789012 tasks list --project-id 123456
 ```bash
 toggl organization invitations list
 toggl organization workspaces list
-toggl organization workspaces get-timezone
-toggl organization workspaces update-timezone --timezone Europe/London
-toggl organization workspaces update-timezone --clear true
 toggl shared status get
 toggl shared holidays list
 ```

package/skills/toggl-cli/reference/projects.md

@@ -19,9 +19,16 @@ toggl --json projects get --project-id <project-id>
 Create a project:
 
 ```bash
-toggl --json projects create --data '{"name":"Q3 Planning","workspace_id":789012}'
+toggl --json projects create --data '{"name":"Q3 Planning","private":true}'
 ```
 
+When targeting a specific workspace, run `toggl --json workspace switch <workspace-id>` before the permissions check and create command; the project payload does not select the workspace.
+When the user explicitly asks for a shared or public project, use `private: false` and skip the permissions check — only private projects require an entitlement.
+Otherwise, before defaulting to a private project, run `toggl --json workspace-settings get-user-permissions`.
+Use `private: true` when `permissions` includes `access_private_projects_tasks_feature`;
+otherwise use `private: false` and tell the user. If the user explicitly requires privacy, do not create a shared project.
+Omit `billable` unless billing was requested.
+
 Rename a project:
 
 ```bash