@togglhq/cli 1.6.0 → 1.6.1

package/build/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as CommanderError, t as createProgram } from "./program-BCqI2fZI.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-BCqI2fZI.js";
+import { t as createProgram } from "./program-D1iMB9xT.js";
 export { createProgram };

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

@@ -12477,7 +12477,7 @@ async function runSkillSetup(options) {
 	});
 }
 //#endregion
-//#region ../operations/build/safety-FZlH3SQa.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));
@@ -12712,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",
@@ -13013,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"
 			}
 		}]
 	},
@@ -25059,4 +25064,4 @@ Common commands:
 //#endregion
 export { CommanderError as n, createProgram as t };
 
-//# sourceMappingURL=program-BCqI2fZI.js.map
+//# sourceMappingURL=program-D1iMB9xT.js.map

package/build/program.js

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

package/package.json

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

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