@mediamonks/canopy-cli 0.7.46 → 0.7.47

package/dist/audience-B68YZBGy.mjs

@@ -0,0 +1,121 @@
+import { c as projectDirArgs, d as resolveProject, l as projectFlagArgs } from "./site-BL5Ik-yj.mjs";
+import { a as apiRequest, m as withContext } from "./api-DmJrIsE7.mjs";
+import { r as reportErrors } from "./ui-26ETk1n8.mjs";
+import { defineCommand } from "citty";
+import * as p from "@clack/prompts";
+//#region src/audience.ts
+/**
+* Project audience (OpenSpec change project-audience): `canopy audience
+* show|set|draft|ready`. Who a project is for and whether it's still a draft
+* are labels on the dashboard's project list, stored on the platform (never
+* in canopy.json) and set through the project update route.
+*/
+const KINDS = [
+	"everyone",
+	"personal",
+	"client",
+	"department"
+];
+const NAME_MAX = 40;
+/** `set <kind> [name]` → the update body, or a sentence saying what's wrong. */
+function parseAudience(kind, name) {
+	const k = kind.trim().toLowerCase();
+	if (!KINDS.includes(k)) return `"${kind}" is not an audience. Use everyone, personal, client <name> or department <name>.`;
+	if (k === "client" || k === "department") {
+		const n = name?.trim() ?? "";
+		if (!n) return `Name the ${k}: canopy audience set ${k} "<name>"`;
+		if (n.length > NAME_MAX) return `Keep the ${k} name to ${NAME_MAX} characters.`;
+		return {
+			kind: k,
+			name: n
+		};
+	}
+	if (name?.trim()) return `${k === "everyone" ? "Everyone" : "Personal"} takes no name.`;
+	return { kind: k };
+}
+/** One line for people: who it's for, and whether it's a draft. */
+function describeAudience(project) {
+	const a = project.audience ?? null;
+	const who = a === null ? "is for everyone" : a.kind === "personal" ? "is a personal project" : `is for the ${a.name} ${a.kind === "client" ? "client team" : "department"}`;
+	return `${project.slug} ${who}${project.draft ? ", and is still a draft" : ""}.`;
+}
+const FIXES = { invalid_audience: "Use everyone, personal, client <name> or department <name> (names up to 40 characters)." };
+function update(slug, body) {
+	return withContext(apiRequest("PATCH", `/projects/${slug}`, body).then((r) => r.project), {
+		action: `update ${slug}`,
+		fixes: FIXES
+	});
+}
+const audienceCommand = defineCommand({
+	meta: {
+		name: "audience",
+		description: "Who the project is for, and whether it's a draft (show, set, draft, ready)"
+	},
+	subCommands: {
+		show: defineCommand({
+			meta: {
+				name: "show",
+				description: "Show who the project is for and whether it's a draft"
+			},
+			args: { ...projectDirArgs },
+			run: reportErrors("audience show", async ({ args }) => {
+				const { slug } = resolveProject(args);
+				const { project } = await withContext(apiRequest("GET", `/projects/${slug}`), { action: `read ${slug}` });
+				console.log(describeAudience(project));
+			})
+		}),
+		set: defineCommand({
+			meta: {
+				name: "set",
+				description: "Say who it's for: everyone, personal, client <name> or department <name>"
+			},
+			args: {
+				kind: {
+					type: "positional",
+					description: "everyone | personal | client | department",
+					required: true
+				},
+				name: {
+					type: "positional",
+					description: "The client team or department (client and department only)",
+					required: false
+				},
+				...projectFlagArgs
+			},
+			run: reportErrors("audience set", async ({ args }) => {
+				const audience = parseAudience(args.kind, args.name);
+				if (typeof audience === "string") {
+					console.error(audience);
+					process.exit(1);
+				}
+				const { slug } = resolveProject({ project: args.project });
+				p.log.success(describeAudience(await update(slug, { audience })));
+				p.log.info("It's a label on the project list; who can open the project is unchanged.");
+			})
+		}),
+		draft: defineCommand({
+			meta: {
+				name: "draft",
+				description: "Mark it as not ready yet (greyed out on the list)"
+			},
+			args: { ...projectDirArgs },
+			run: reportErrors("audience draft", async ({ args }) => {
+				const { slug } = resolveProject(args);
+				p.log.success(describeAudience(await update(slug, { draft: true })));
+			})
+		}),
+		ready: defineCommand({
+			meta: {
+				name: "ready",
+				description: "Mark it as ready (no longer a draft)"
+			},
+			args: { ...projectDirArgs },
+			run: reportErrors("audience ready", async ({ args }) => {
+				const { slug } = resolveProject(args);
+				p.log.success(describeAudience(await update(slug, { draft: false })));
+			})
+		})
+	}
+});
+//#endregion
+export { audienceCommand };

package/dist/docs/cli-audience.md

@@ -0,0 +1,47 @@
+---
+title: canopy audience
+description: Say who a project is for and whether it's still a draft.
+---
+
+`canopy audience` sets the labels people see on the dashboard's project list:
+who the project was made for, and whether it's still a draft. They never
+change who can open the project. Read
+[Saying who it's for](https://docs.canopy.website/platform/members-and-access#saying-who-its-for).
+
+## Usage
+
+```bash
+canopy audience show
+canopy audience set <everyone|personal>
+canopy audience set <client|department> <name>
+canopy audience draft
+canopy audience ready
+```
+
+## Arguments & flags
+
+Each subcommand works on the project in the current folder (`canopy.json`),
+or the one you name with `--project <slug>`. All of them honour the global
+`--profile <site>` / `CANOPY_PROFILE`. Owners, managers and editors can change
+them.
+
+- `show` — who the project is for, and whether it's a draft.
+- `set <kind> [name]` — `everyone` (the default), `personal`, or `client` /
+  `department` with a name of up to 40 characters. Quote names with spaces.
+- `draft` — mark it as not ready yet. It shows greyed out on the project list
+  but stays listed and usable.
+- `ready` — it's no longer a draft.
+
+## Examples
+
+```bash
+canopy audience set client "Uniqlo"
+```
+
+Marks the project as made for the Uniqlo client team.
+
+```bash
+canopy audience draft --project retro-board
+```
+
+Marks `retro-board` as a draft without being in its folder.

package/dist/docs/index.json

@@ -246,6 +246,11 @@
           "title": "canopy rename",
           "summary": "Change a project's slug — its address — and update canopy.json."
         },
+        {
+          "slug": "cli-audience",
+          "title": "canopy audience",
+          "summary": "Say who a project is for and whether it's still a draft."
+        },
         {
           "slug": "cli-dev",
           "title": "canopy dev",

package/dist/docs/platform-members-and-access.md

@@ -113,6 +113,26 @@ Turning it off again is the same toggle.
 > **Note:** Members-only gates the **live app**. Management pages (settings, data, deploys) are always for the
 > owner, managers and editors only, whatever this toggle says.
 
+## Saying who it's for
+
+Not every project is meant for everyone who scrolls past it. In **Settings →
+Audience** you can say who it was made for:
+
+- **Everyone**, the default. Nothing extra shows on the project list.
+- **Just me**, for a personal tool or experiment.
+- **A client team** or **a department**, with its name (up to 40 characters).
+
+Other people see the audience as a small badge next to **Visit** on the
+project list, and personal projects sort below the ones meant for everyone.
+Every Monk can read the name, the same as the project's name and description.
+
+Turn on **Still a draft** while it isn't ready. The project shows greyed out
+and sorts lower, but it stays listed and anyone who could open it still can.
+
+Both are labels only. They never change who can open the project; that's
+what members-only and the client password are for. From the CLI, use
+[`canopy audience`](https://docs.canopy.website/cli/audience).
+
 ## Platform admins and the Admin page
 
 Platform admins get an extra **Admin** page in the dashboard. Its **Users**

package/dist/{docs-CtMrMpt1.mjs → docs-D5gmZRJk.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-BdNHq8QV.mjs";
+import { t as version } from "./package-BksVeJZB.mjs";
 import { r as siteConfig } from "./site-BL5Ik-yj.mjs";
 import { i as latestKnownVersion, r as compareSemver } from "./version-check-CcsA1QjI.mjs";
 import { n as agentHeaders } from "./api-DmJrIsE7.mjs";

package/dist/{feedback-BXhbxyXI.mjs → feedback-C6kiYRro.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-BdNHq8QV.mjs";
+import { t as version } from "./package-BksVeJZB.mjs";
 import { c as projectDirArgs, d as resolveProject, h as tryResolveProject, m as tryReadCanopyJson, r as siteConfig } from "./site-BL5Ik-yj.mjs";
 import { a as apiRequest, c as credentials, i as apiDownload, o as apiUpload, s as commonHeaders } from "./api-DmJrIsE7.mjs";
 import { r as reportErrors, t as formatDateTime } from "./ui-26ETk1n8.mjs";

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as version } from "./package-BdNHq8QV.mjs";
+import { t as version } from "./package-BksVeJZB.mjs";
 import { i as siteHeaderLine, n as setInvocationProfile } from "./site-BL5Ik-yj.mjs";
 import { a as notifyOfUpdate, o as runRefresh } from "./version-check-CcsA1QjI.mjs";
 import { defineCommand, runMain } from "citty";
@@ -83,19 +83,20 @@ const main = defineCommand({
 		roles: () => import("./roles-CrYf_8wk.mjs").then((m) => m.rolesCommand),
 		members: () => import("./roles-CrYf_8wk.mjs").then((m) => m.membersCommand),
 		schedule: () => import("./schedule-DvHSSzfR.mjs").then((m) => m.scheduleCommand),
-		feedback: () => import("./feedback-BXhbxyXI.mjs").then((m) => m.feedbackCommand),
+		feedback: () => import("./feedback-C6kiYRro.mjs").then((m) => m.feedbackCommand),
 		db: () => import("./db-DpCMc0uz.mjs").then((m) => m.dbCommand),
 		usage: () => import("./usage-Bpz5B1N1.mjs").then((m) => m.usageCommand),
 		ai: () => import("./ai-CWPQiUft.mjs").then((m) => m.aiCommand),
 		open: () => import("./open-DcQSdfx5.mjs").then((m) => m.openCommand),
 		browse: () => import("./browse-BPLWhoFI.mjs").then((m) => m.browseCommand),
-		docs: () => import("./docs-CtMrMpt1.mjs").then((m) => m.docsCommand),
-		skill: () => import("./skill-vzcCD1b4.mjs").then((m) => m.skillCommand),
-		upgrade: () => import("./upgrade-8_pFNTo5.mjs").then((m) => m.upgradeCommand),
+		docs: () => import("./docs-D5gmZRJk.mjs").then((m) => m.docsCommand),
+		skill: () => import("./skill-Bz39NhTN.mjs").then((m) => m.skillCommand),
+		upgrade: () => import("./upgrade-BjDaghNf.mjs").then((m) => m.upgradeCommand),
 		logs: () => import("./logs-dZMPTJLu.mjs").then((m) => m.logsCommand),
-		mcp: () => import("./mcp-CGmWkGN8.mjs").then((m) => m.mcpCommand),
+		mcp: () => import("./mcp-DuCxfb85.mjs").then((m) => m.mcpCommand),
 		repo: () => import("./repo-C7AXDtFZ.mjs").then((m) => m.repoCommand),
-		template: () => import("./project-template-Dw11151p.mjs").then((m) => m.templateCommand)
+		template: () => import("./project-template-Dw11151p.mjs").then((m) => m.templateCommand),
+		audience: () => import("./audience-B68YZBGy.mjs").then((m) => m.audienceCommand)
 	}
 });
 const quiet = process.argv[2] === "mcp" && process.argv[3] === "serve" || process.argv[2] === "repo" && process.argv[3] === "credential";

package/dist/{mcp-CGmWkGN8.mjs → mcp-DuCxfb85.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-BdNHq8QV.mjs";
+import { t as version } from "./package-BksVeJZB.mjs";
 import { h as tryResolveProject, p as stagingUrl, r as siteConfig, u as projectUrl } from "./site-BL5Ik-yj.mjs";
 import { a as apiRequest, f as noticeRenamesOnly, l as currentSlug, t as ApiError } from "./api-DmJrIsE7.mjs";
 import { t as liveDevServer } from "./dev-server-file-Dk9pk4AR.mjs";

package/dist/{package-BdNHq8QV.mjs → package-BksVeJZB.mjs}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.7.46";
+var version = "0.7.47";
 //#endregion
 export { version as t };

package/dist/{skill-vzcCD1b4.mjs → skill-Bz39NhTN.mjs}

@@ -1,4 +1,4 @@
-import { t as version } from "./package-BdNHq8QV.mjs";
+import { t as version } from "./package-BksVeJZB.mjs";
 import { r as reportErrors } from "./ui-26ETk1n8.mjs";
 import { defineCommand } from "citty";
 import { cpSync, existsSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";

package/dist/{upgrade-8_pFNTo5.mjs → upgrade-BjDaghNf.mjs}

@@ -112,7 +112,7 @@ const upgradeCommand = defineCommand({
 		const spec = `${PACKAGE_NAME}@${args.version ?? "latest"}`;
 		const command = pmCommand(pm);
 		const cmd = installArgs(pm, spec);
-		const { skillInstalled } = await import("./skill-vzcCD1b4.mjs");
+		const { skillInstalled } = await import("./skill-Bz39NhTN.mjs");
 		const { homedir } = await import("node:os");
 		const refreshGlobal = skillInstalled(homedir());
 		const refreshRepo = process.cwd() !== homedir() && skillInstalled(process.cwd());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mediamonks/canopy-cli",
-  "version": "0.7.46",
+  "version": "0.7.47",
   "description": "Canopy CLI — create, develop and deploy Canopy projects.",
   "bin": {
     "canopy": "./dist/index.mjs"