@veleads/gtm 0.2.1 → 0.4.0

package/dist/cli.js

@@ -40,28 +40,32 @@ var Approval = z.object({
 );
 var FieldSources = z.record(z.string(), z.string().min(1));
 
-// ../schemas/src/client.ts
+// ../schemas/src/project.ts
 import { z as z2 } from "zod";
 
 // ../schemas/src/versions.ts
 var FILE_VERSIONS = {
-  client: 1,
-  icp: 1,
-  signals: 1,
-  "campaign-config": 1
+  project: 2,
+  icp: 2,
+  signals: 2,
+  "campaign-config": 2
 };
+var FILE_RENAMES = [
+  { from: "client.yaml", to: "project.yaml", since: "0.3.0" },
+  { from: "CLIENT.md", to: "PROJECT.md", since: "0.3.0" }
+];
 
-// ../schemas/src/client.ts
-var ClientFile = z2.object({
-  version: z2.literal(FILE_VERSIONS.client),
-  client_id: Slug,
+// ../schemas/src/project.ts
+var ProjectFile = z2.object({
+  version: z2.literal(FILE_VERSIONS.project),
+  project_id: Slug,
   name: z2.string().min(1),
-  status: z2.enum(["onboarding", "active", "paused", "churned"]),
+  status: z2.enum(["onboarding", "active", "paused", "closed"]),
   started_at: IsoDate,
   owners: z2.object({
     gtm_engineer: z2.string().min(1),
     sdrs: z2.array(z2.string().min(1)),
-    client_approver: z2.string().min(1).describe("Client-side person who signs off ICP and copy")
+    approver: z2.string().min(1).describe("Person who signs off ICP and copy for this project")
   }),
   regions: z2.array(z2.string().min(2)).min(1).describe("Target regions, e.g. EU, UK, US"),
   features: z2.record(z2.string(), z2.boolean()).default({}).describe("Opt-in core features, see FEATURES")
@@ -94,7 +98,7 @@ var IcpPersona = z3.object({
 });
 var IcpFile = z3.object({
   version: z3.literal(FILE_VERSIONS.icp),
-  client_id: Slug,
+  project_id: Slug,
   approval: Approval,
   segments: z3.array(IcpSegment).min(1),
   personas: z3.array(IcpPersona).min(1),
@@ -124,7 +128,7 @@ var SignalDefinition = z4.object({
 });
 var SignalsFile = z4.object({
   version: z4.literal(FILE_VERSIONS.signals),
-  client_id: Slug,
+  project_id: Slug,
   signals: z4.array(SignalDefinition).min(1)
 }).superRefine((f, ctx) => {
   const keys = f.signals.map((s) => s.key);
@@ -185,7 +189,7 @@ var Compliance = z5.object({
 });
 var CampaignConfig = z5.object({
   version: z5.literal(FILE_VERSIONS["campaign-config"]),
-  client_id: Slug,
+  project_id: Slug,
   campaign_id: Slug,
   owner: z5.string().min(1),
   stage: Stage.describe("The stage currently being worked on"),
@@ -208,7 +212,7 @@ var CampaignConfig = z5.object({
 // ../schemas/src/account.ts
 import { z as z6 } from "zod";
 var Account = z6.object({
-  client_id: Slug,
+  project_id: Slug,
   tam_id: Slug,
   domain: Domain,
   name: z6.string().min(1),
@@ -225,7 +229,7 @@ var Account = z6.object({
 import { z as z7 } from "zod";
 var EmailStatus = z7.enum(["valid", "catch_all", "invalid", "unknown", "not_found"]);
 var Contact = z7.object({
-  client_id: Slug,
+  project_id: Slug,
   account_domain: Domain,
   first_name: z7.string().min(1),
   last_name: z7.string().min(1),
@@ -242,7 +246,7 @@ var Contact = z7.object({
 // ../schemas/src/signal.ts
 import { z as z8 } from "zod";
 var SignalEvent = z8.object({
-  client_id: Slug,
+  project_id: Slug,
   signal_key: Slug,
   account_domain: Domain,
   contact_linkedin_url: z8.string().url().nullable(),
@@ -255,7 +259,7 @@ var SignalEvent = z8.object({
 // ../schemas/src/lead.ts
 import { z as z9 } from "zod";
 var Lead = z9.object({
-  client_id: Slug,
+  project_id: Slug,
   campaign_id: Slug,
   run_id: z9.uuid(),
   email: z9.email(),
@@ -282,7 +286,27 @@ var FEATURES = {
 };
 
 // ../schemas/src/migrations.ts
-var MIGRATIONS = [];
+import { isMap, isScalar } from "yaml";
+function renameKey(doc, path, from, to) {
+  const node = path.length ? doc.getIn(path, true) : doc.contents;
+  if (!isMap(node)) return;
+  const pair = node.items.find((p) => (isScalar(p.key) ? p.key.value : p.key) === from);
+  if (!pair) return;
+  if (isScalar(pair.key)) pair.key.value = to;
+  else pair.key = to;
+}
+var renameClientId = (doc) => renameKey(doc, [], "client_id", "project_id");
+var MIGRATIONS = [
+  // 0.3.0: "clients" became "projects" (one private repo per project).
+  { kind: "project", from: 1, description: "client_id \u2192 project_id, owners.client_approver \u2192 owners.approver, status churned \u2192 closed", up(doc) {
+    renameClientId(doc);
+    renameKey(doc, ["owners"], "client_approver", "approver");
+    if (doc.get("status") === "churned") doc.set("status", "closed");
+  } },
+  { kind: "icp", from: 1, description: "client_id \u2192 project_id", up: renameClientId },
+  { kind: "signals", from: 1, description: "client_id \u2192 project_id", up: renameClientId },
+  { kind: "campaign-config", from: 1, description: "client_id \u2192 project_id", up: renameClientId }
+];
 function migrateDocument(kind, doc, migrations = MIGRATIONS, target = FILE_VERSIONS[kind]) {
   const raw = doc.get("version");
   const from = typeof raw === "number" ? raw : Number(raw);
@@ -321,11 +345,11 @@ function copyContentHash(markdown) {
 
 // src/commands/approve.ts
 var USAGE = `Usage:
-  gtm approve icp --by "<Name (side)>" [--notes "<what was approved>"] [--date YYYY-MM-DD]
-  gtm approve copy <campaign> --by "<Name (side)>" [--notes "<what was approved>"] [--date YYYY-MM-DD]`;
+  gtm approve icp --by "<Name (role)>" [--notes "<what was approved>"] [--date YYYY-MM-DD]
+  gtm approve copy <campaign> --by "<Name (role)>" [--notes "<what was approved>"] [--date YYYY-MM-DD]`;
 function load(file) {
   if (!existsSync(file)) {
-    console.error(`${file} not found: run this from the root of a client repo`);
+    console.error(`${file} not found: run this from the root of a project repo`);
     return null;
   }
   const doc = parseDocument(readFileSync(file, "utf8"));
@@ -361,7 +385,7 @@ function runApprove(root2, args2, opts) {
   }
   const by = opts.by?.trim();
   if (!by) {
-    console.error('--by is required: the human who approved, e.g. --by "Maria Chen (client)"');
+    console.error('--by is required: the human who approved, e.g. --by "Maria Chen (VP Marketing)"');
     return false;
   }
   const date = opts.date ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -406,8 +430,8 @@ function runApprove(root2, args2, opts) {
 
 // src/commands/init.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "fs";
-import { join as join6, resolve } from "path";
+import { appendFileSync, existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
+import { basename, join as join6, relative as relative2, resolve } from "path";
 
 // src/paths.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
@@ -425,7 +449,7 @@ var KIT_DIR = kit;
 var CHANGELOG_FILE = firstExisting([join2(pkgRoot, "CHANGELOG.md"), join2(pkgRoot, "..", "..", "CHANGELOG.md")]);
 
 // src/template.ts
-import { cpSync, mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2, join as join4 } from "path";
 
 // src/fsutil.ts
@@ -481,19 +505,22 @@ function destName(rel) {
   const [first, ...rest] = rel.split("/");
   return [DOTFILES.has(first) ? `.${first}` : first, ...rest].join("/");
 }
+function planTemplate(src, vars, rename = destName) {
+  return walk(src).map((rel) => {
+    const raw = readFileSync3(join4(src, rel));
+    if (!/\.(md|ya?ml|json|txt|example)$|gitignore$/.test(rel)) return { rel: rename(rel), content: raw };
+    let text = raw.toString("utf8");
+    for (const [k, v] of Object.entries(vars)) text = text.replaceAll(`__${k}__`, v);
+    return { rel: rename(rel), content: text };
+  });
+}
+function writePlanned(root2, file) {
+  const out = join4(root2, file.rel);
+  mkdirSync(dirname2(out), { recursive: true });
+  writeFileSync2(out, file.content);
+}
 function copyTemplate(src, dest, vars, opts = {}) {
-  for (const rel of walk(src)) {
-    if (opts.only && !opts.only.includes(rel)) continue;
-    const out = join4(dest, (opts.rename ?? destName)(rel));
-    mkdirSync(dirname2(out), { recursive: true });
-    if (/\.(md|ya?ml|json|txt|example)$|gitignore$/.test(rel)) {
-      let text = readFileSync3(join4(src, rel), "utf8");
-      for (const [k, v] of Object.entries(vars)) text = text.replaceAll(`__${k}__`, v);
-      writeFileSync2(out, text);
-    } else {
-      cpSync(join4(src, rel), out);
-    }
-  }
+  for (const file of planTemplate(src, vars, opts.rename)) writePlanned(dest, file);
 }
 
 // src/commands/sync.ts
@@ -502,7 +529,7 @@ import { dirname as dirname3, join as join5 } from "path";
 var SHIPPED_DIRS = ["skills", "templates", "providers", "schemas"];
 function agentsMd() {
   const header = `<!-- GENERATED by \`gtm sync\` from ${PACKAGE_NAME} v${GTM_VERSION}. Do not edit: it is overwritten on upgrade.
-     Client-specific rules go in CLIENT.md. Process changes go to the Veleads/gtm-core repo. -->
+     Project-specific rules go in PROJECT.md. Process changes go to the Veleads/gtm-core repo. -->
 
 `;
   return header + readFileSync4(join5(KIT_DIR, "AGENTS.md"), "utf8").replaceAll("{{GTM_VERSION}}", GTM_VERSION);
@@ -545,7 +572,7 @@ function runSync(root2, opts = {}) {
       console.log(`in sync with ${PACKAGE_NAME} v${GTM_VERSION}`);
       return true;
     }
-    console.log(`out of sync with ${PACKAGE_NAME} v${GTM_VERSION} (run \`pnpm gtm sync\`; never edit .gtm/ or AGENTS.md by hand):`);
+    console.log(`out of sync with ${PACKAGE_NAME} v${GTM_VERSION} (run \`npx gtm sync\`; never edit .gtm/ or AGENTS.md by hand):`);
     for (const d of diffs) console.log(`  ${d}`);
     return false;
   }
@@ -560,33 +587,86 @@ function runSync(root2, opts = {}) {
 }
 
 // src/commands/init.ts
-function runInit(slug, opts) {
-  if (!slug || !Slug.safeParse(slug).success || !opts.name) {
-    console.error('Usage: gtm init <client-slug> --name "<Client Name>" [--dir <path>]   (slug: lowercase, digits, hyphens)');
+var USAGE2 = `Usage:
+  gtm init <project-slug> --name "<Project Name>" [--dir <path>]   create ./gtm-project-<slug> (or <path>)
+  gtm init . --name "<Project Name>" [--slug <project-slug>]        set up the current folder
+Slugs: lowercase letters, digits and hyphens.`;
+var MERGEABLE = /* @__PURE__ */ new Set([".gitignore", "README.md", "CLAUDE.md", "campaigns/.gitkeep", "tam/.gitkeep"]);
+function slugFromFolder(path) {
+  return basename(path).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/^gtm-project-/, "");
+}
+function missingIgnoreLines(existing, ours) {
+  const have = new Set(existing.split("\n").map((l) => l.trim()));
+  return ours.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#") && !have.has(l.trim()));
+}
+function runInit(target, opts) {
+  const here = target === "." || opts.dir === ".";
+  const root2 = resolve(opts.cwd, here ? opts.dir ?? "." : opts.dir ?? `gtm-project-${target ?? ""}`);
+  const slug = target && target !== "." ? target : opts.slug ?? slugFromFolder(root2);
+  if (!opts.name || !slug || !Slug.safeParse(slug).success) {
+    console.error(USAGE2);
+    if (!slug && here) console.error(`Couldn't derive a slug from the folder name "${basename(root2)}": pass one with --slug`);
+    else if (slug && !Slug.safeParse(slug).success) console.error(`"${slug}" is not a valid slug: pass one with --slug`);
     return false;
   }
-  const root2 = resolve(opts.cwd, opts.dir ?? `gtm-client-${slug}`);
-  if (existsSync4(root2) && readdirSync2(root2).length > 0) {
-    console.error(`${root2} exists and is not empty`);
+  if (existsSync4(join6(root2, "project.yaml")) || existsSync4(join6(root2, "client.yaml"))) {
+    console.error(`${root2} is already a gtm project. Use \`npx gtm sync\` or \`npx gtm upgrade\` instead.`);
     return false;
   }
-  const vars = { CLIENT_ID: slug, CLIENT_NAME: opts.name, TODAY: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10), GTM_VERSION };
+  const vars = { PROJECT_ID: slug, PROJECT_NAME: opts.name, TODAY: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10), GTM_VERSION };
   const tpl = join6(KIT_DIR, "templates");
-  copyTemplate(join6(tpl, "repo"), root2, vars);
-  copyTemplate(join6(tpl, "client"), root2, vars, { rename: (rel) => rel === "client.yaml" ? rel : join6("context", rel) });
-  for (const d of ["campaigns", "tam"]) {
-    mkdirSync3(join6(root2, d), { recursive: true });
-    writeFileSync4(join6(root2, d, ".gitkeep"), "");
+  const planned = [
+    ...planTemplate(join6(tpl, "repo"), vars),
+    ...planTemplate(join6(tpl, "project"), vars, (rel) => rel === "project.yaml" ? rel : join6("context", rel)),
+    { rel: "campaigns/.gitkeep", content: "" },
+    { rel: "tam/.gitkeep", content: "" }
+  ];
+  const coreOwned = [...expectedFiles().keys()];
+  const conflicts = [...planned.map((f) => f.rel), ...coreOwned].filter((rel) => existsSync4(join6(root2, rel)) && !MERGEABLE.has(rel));
+  if (existsSync4(join6(root2, ".gtm"))) conflicts.unshift(".gtm/");
+  if (conflicts.length) {
+    console.error(`Cannot set up ${root2}: these files already exist and belong to gtm. Nothing was written.`);
+    for (const c of [...new Set(conflicts)].slice(0, 15)) console.error(`  \u2717 ${c}`);
+    console.error("Move them away (or use an empty folder) and run init again.");
+    return false;
   }
+  const notes = [];
+  for (const file of planned) {
+    const path = join6(root2, file.rel);
+    if (!existsSync4(path)) {
+      writePlanned(root2, file);
+      continue;
+    }
+    if (file.rel === ".gitignore") {
+      const add = missingIgnoreLines(readFileSync5(path, "utf8"), file.content.toString());
+      if (add.length) {
+        appendFileSync(path, `
+# gtm-brain
+${add.join("\n")}
+`);
+        notes.push(`.gitignore: added ${add.length} gtm rule(s)`);
+      }
+    } else if (file.rel === "README.md") {
+      notes.push("README.md: kept yours (see .gtm/templates/repo/README.md for the gtm version)");
+    }
+  }
+  const claude = join6(root2, "CLAUDE.md");
+  const hadClaude = existsSync4(claude);
   runSync(root2);
-  const git = spawnSync("git", ["init", "-q", "-b", "main"], { cwd: root2 });
+  if (hadClaude && !readFileSync5(claude, "utf8").includes("@AGENTS.md")) {
+    appendFileSync(claude, "\n@AGENTS.md\n");
+    notes.push("CLAUDE.md: added @AGENTS.md so Claude Code loads the operating manual");
+  }
+  const inRepo = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd: root2, encoding: "utf8" }).stdout?.trim() === "true";
+  const gitNote = inRepo ? "existing git repository kept" : spawnSync("git", ["init", "-q", "-b", "main"], { cwd: root2 }).status === 0 ? "git initialised" : "git not initialised";
+  const where = relative2(opts.cwd, root2) || ".";
+  console.log(`
+Set up project "${opts.name}" (${slug}) in ${root2} (core v${GTM_VERSION}; ${gitNote}).`);
+  for (const n of notes) console.log(`  \xB7 ${n}`);
   console.log(`
-Created ${root2} (core v${GTM_VERSION})${git.status === 0 ? " with git initialised" : ""}.
-
 Next:
-  1. Create a PRIVATE GitHub repo for it (e.g. <your-org>/gtm-client-${slug}) and push this folder.
-     Client repos hold client context: never make them public.
-  2. pnpm install && pnpm gtm validate     (TODO warnings remain until intake is done)
+  1. ${where === "." ? "" : `cd ${where} && `}npm install && npx gtm validate     (or pnpm/yarn; TODO warnings remain until intake is done)
+  2. ${inRepo ? "Commit and push to your PRIVATE repo." : `Create a PRIVATE GitHub repo (e.g. <your-org>/gtm-project-${slug}) and push.`} Project repos hold project context: never make them public.
   3. Open the repo in Claude Code or Codex and start with stage 00-intake.`);
   return true;
 }
@@ -602,24 +682,41 @@ Per AGENTS.md this is a mandatory stop: do not improvise the job with ad-hoc scr
 }
 
 // src/commands/migrate.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "fs";
-import { join as join7, relative as relative2 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync6, renameSync, writeFileSync as writeFileSync4 } from "fs";
+import { join as join7, relative as relative3 } from "path";
 import { parseDocument as parseDocument2 } from "yaml";
-function clientYamlFiles(root2) {
+function projectYamlFiles(root2) {
   const files = [
-    { kind: "client", file: join7(root2, "client.yaml") },
+    { kind: "project", file: join7(root2, "project.yaml") },
     { kind: "icp", file: join7(root2, "context", "icp.yaml") },
     { kind: "signals", file: join7(root2, "context", "signals.yaml") },
     ...subdirs(join7(root2, "campaigns")).map((c) => ({ kind: "campaign-config", file: join7(root2, "campaigns", c, "config.yaml") }))
   ];
   return files.filter((f) => existsSync5(f.file));
 }
+function pendingRenames(root2) {
+  return FILE_RENAMES.filter((r) => existsSync5(join7(root2, r.from)) && !existsSync5(join7(root2, r.to)));
+}
 function runMigrate(root2, opts = {}) {
   let ok = true;
   let changed = 0;
-  for (const { kind, file } of clientYamlFiles(root2)) {
-    const rel = relative2(root2, file);
-    const doc = parseDocument2(readFileSync5(file, "utf8"));
+  for (const { from, to } of pendingRenames(root2)) {
+    changed++;
+    console.log(`  ${opts.dryRun ? "would rename" : "renamed"} ${from} \u2192 ${to}`);
+    if (opts.dryRun) continue;
+    renameSync(join7(root2, from), join7(root2, to));
+    if (to.endsWith(".md")) {
+      const p = join7(root2, to);
+      writeFileSync4(p, readFileSync6(p, "utf8").replace(new RegExp(`^# ${from.replace(".", "\\.")}`, "m"), `# ${to}`));
+    }
+  }
+  if (opts.dryRun && changed) {
+    console.log("(dry run: YAML migrations are listed after the renames are applied)");
+    return ok;
+  }
+  for (const { kind, file } of projectYamlFiles(root2)) {
+    const rel = relative3(root2, file);
+    const doc = parseDocument2(readFileSync6(file, "utf8"));
     if (doc.errors.length) {
       console.log(`  \u2717 ${rel}: invalid YAML: ${doc.errors[0].message}`);
       ok = false;
@@ -634,9 +731,9 @@ function runMigrate(root2, opts = {}) {
       for (const a of res.applied) console.log(`  ${opts.dryRun ? "would apply" : "applied"} ${rel}: ${a}`);
       if (pinned) {
         doc.setIn(["approval", "content_hash"], icpContentHash(doc.toJS()));
-        console.log(`  re-pinned ICP approval hash in ${rel} (core migration, content approved by the client)`);
+        console.log(`  re-pinned ICP approval hash in ${rel} (core migration, content approved by the project approver)`);
       }
-      if (!opts.dryRun) writeFileSync5(file, doc.toString({ flowCollectionPadding: false, lineWidth: 0 }));
+      if (!opts.dryRun) writeFileSync4(file, doc.toString({ flowCollectionPadding: false, lineWidth: 0 }));
     } catch (e) {
       console.log(`  \u2717 ${rel}: ${e.message}`);
       ok = false;
@@ -647,7 +744,7 @@ function runMigrate(root2, opts = {}) {
 }
 
 // src/commands/new-campaign.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { join as join8 } from "path";
 import { parse } from "yaml";
 function runNewCampaign(root2, campaign) {
@@ -655,9 +752,9 @@ function runNewCampaign(root2, campaign) {
     console.error("Usage: gtm new-campaign <campaign-slug>");
     return false;
   }
-  const clientFile = join8(root2, "client.yaml");
-  if (!existsSync6(clientFile)) {
-    console.error("client.yaml not found: run this from the root of a client repo");
+  const projectFile = join8(root2, "project.yaml");
+  if (!existsSync6(projectFile)) {
+    console.error("project.yaml not found: run this from the root of a project repo");
     return false;
   }
   const dest = join8(root2, "campaigns", campaign);
@@ -665,21 +762,21 @@ function runNewCampaign(root2, campaign) {
     console.error(`campaigns/${campaign} already exists`);
     return false;
   }
-  const clientId = parse(readFileSync6(clientFile, "utf8"))?.client_id ?? "TODO";
-  copyTemplate(join8(KIT_DIR, "templates", "campaign"), dest, { CLIENT_ID: clientId, CAMPAIGN_ID: campaign, OWNER: process.env.GTM_USER ?? "TODO" });
-  mkdirSync4(join8(dest, "runs"), { recursive: true });
-  writeFileSync6(join8(dest, "runs", ".gitkeep"), "");
+  const projectId = parse(readFileSync7(projectFile, "utf8"))?.project_id ?? "TODO";
+  copyTemplate(join8(KIT_DIR, "templates", "campaign"), dest, { PROJECT_ID: projectId, CAMPAIGN_ID: campaign, OWNER: process.env.GTM_USER ?? "TODO" });
+  mkdirSync3(join8(dest, "runs"), { recursive: true });
+  writeFileSync5(join8(dest, "runs", ".gitkeep"), "");
   console.log(`Created campaigns/${campaign}. Branch: git switch -c campaign/${campaign}`);
   return true;
 }
 
 // src/commands/status.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync8 } from "fs";
 import { join as join9 } from "path";
 import { parse as parse2 } from "yaml";
 function readYaml(file) {
   try {
-    return parse2(readFileSync7(file, "utf8"));
+    return parse2(readFileSync8(file, "utf8"));
   } catch {
     return null;
   }
@@ -688,19 +785,19 @@ function campaignStages(root2) {
   return subdirs(join9(root2, "campaigns")).map((id) => ({ id, stage: readYaml(join9(root2, "campaigns", id, "config.yaml"))?.stage ?? "?" }));
 }
 function runStatus(root2) {
-  const client = readYaml(join9(root2, "client.yaml"));
+  const project = readYaml(join9(root2, "project.yaml"));
   const icp = readYaml(join9(root2, "context", "icp.yaml"));
-  console.log(`${client?.name ?? "?"} (${client?.client_id ?? "?"}) \xB7 status ${client?.status ?? "?"} \xB7 core v${GTM_VERSION}`);
+  console.log(`${project?.name ?? "?"} (${project?.project_id ?? "?"}) \xB7 status ${project?.status ?? "?"} \xB7 core v${GTM_VERSION}`);
   console.log(`ICP gate: ${icp?.approval?.status ?? "?"}${icp?.approval?.approved_by ? ` by ${icp.approval.approved_by} on ${icp.approval.approved_at}` : ""}
 `);
   const rows = subdirs(join9(root2, "campaigns")).map((id) => {
     const cfg = readYaml(join9(root2, "campaigns", id, "config.yaml")) ?? {};
     const runsDir = join9(root2, "campaigns", id, "runs");
-    const last = existsSync7(runsDir) ? readdirSync3(runsDir).filter((f) => f.endsWith(".md")).sort().at(-1) ?? "-" : "-";
+    const last = existsSync7(runsDir) ? readdirSync2(runsDir).filter((f) => f.endsWith(".md")).sort().at(-1) ?? "-" : "-";
     return [id, cfg.stage ?? "?", cfg.gates?.copy?.status ?? "?", cfg.gates?.launch?.status ?? "?", cfg.owner ?? "?", last];
   });
   if (!rows.length) {
-    console.log("no campaigns yet: pnpm gtm new-campaign <campaign-slug>");
+    console.log("no campaigns yet: npx gtm new-campaign <campaign-slug>");
     return true;
   }
   const header = ["campaign", "stage", "copy gate", "launch gate", "owner", "latest run log"];
@@ -714,7 +811,7 @@ function runStatus(root2) {
 
 // src/commands/upgrade.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync9, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync10 } from "fs";
 import { join as join11 } from "path";
 
 // src/changelog.ts
@@ -733,7 +830,7 @@ function changelogBetween(text, from, to) {
 }
 
 // src/commands/validate.ts
-import { existsSync as existsSync8, readdirSync as readdirSync4, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync9 } from "fs";
 import { join as join10 } from "path";
 import { parse as parse3 } from "yaml";
 var REQUIRED_CONTEXT = ["intake.md", "icp.md", "icp.yaml", "signals.yaml", "personas.md", "offer.md", "proof.md", "voice.md"];
@@ -746,7 +843,7 @@ var SKIP_DIRS = ["node_modules", ".git", ".gtm"];
 var stageIndex = (s) => Stage.options.indexOf(s);
 function readPackageJson(root2) {
   const p = join10(root2, "package.json");
-  return existsSync8(p) ? JSON.parse(readFileSync8(p, "utf8")) : null;
+  return existsSync8(p) ? JSON.parse(readFileSync9(p, "utf8")) : null;
 }
 function pinnedVersion(root2) {
   const pkg = readPackageJson(root2);
@@ -759,15 +856,15 @@ function loadVersioned(r, file, kind, schema) {
   }
   let raw;
   try {
-    raw = parse3(readFileSync8(file, "utf8"));
+    raw = parse3(readFileSync9(file, "utf8"));
   } catch (e) {
     r.err(file, `invalid YAML: ${e.message}`);
     return null;
   }
   const expected = FILE_VERSIONS[kind];
   if (raw?.version !== expected) {
-    if (typeof raw?.version === "number" && raw.version < expected) r.err(file, `is version ${raw.version}, core v${GTM_VERSION} expects ${expected}: run \`pnpm gtm migrate\``);
-    else if (typeof raw?.version === "number") r.err(file, `is version ${raw.version}, newer than core v${GTM_VERSION} (${expected}): run \`pnpm gtm upgrade\``);
+    if (typeof raw?.version === "number" && raw.version < expected) r.err(file, `is version ${raw.version}, core v${GTM_VERSION} expects ${expected}: run \`npx gtm migrate\``);
+    else if (typeof raw?.version === "number") r.err(file, `is version ${raw.version}, newer than core v${GTM_VERSION} (${expected}): run \`npx gtm upgrade\``);
     else r.err(file, `missing "version: ${expected}"`);
     return null;
   }
@@ -783,20 +880,20 @@ function checkCoreSync(r, root2) {
   if (!pinned) return;
   if (!/^\d+\.\d+\.\d+/.test(pinned)) r.err(join10(root2, "package.json"), `${PACKAGE_NAME} must be pinned exactly (got "${pinned}")`);
   const versionFile = join10(root2, ".gtm", "VERSION");
-  const synced = existsSync8(versionFile) ? readFileSync8(versionFile, "utf8").trim() : null;
-  if (synced !== GTM_VERSION) r.err(versionFile, `is ${synced ?? "missing"}, installed core is ${GTM_VERSION}: run \`pnpm gtm sync\``);
-  if (!existsSync8(join10(root2, "AGENTS.md"))) r.err(join10(root2, "AGENTS.md"), "missing: run `pnpm gtm sync`");
+  const synced = existsSync8(versionFile) ? readFileSync9(versionFile, "utf8").trim() : null;
+  if (synced !== GTM_VERSION) r.err(versionFile, `is ${synced ?? "missing"}, installed core is ${GTM_VERSION}: run \`npx gtm sync\``);
+  if (!existsSync8(join10(root2, "AGENTS.md"))) r.err(join10(root2, "AGENTS.md"), "missing: run `npx gtm sync`");
 }
 function checkNoLeadData(r, root2) {
   for (const rel of walk(root2, SKIP_DIRS)) {
     const file = join10(root2, rel);
     if (DATA_FILES.test(rel)) {
-      r.err(file, "data files are not allowed in a client repo (lead data belongs in Postgres)");
+      r.err(file, "data files are not allowed in a project repo (lead data belongs in Postgres)");
       continue;
     }
     if (!/\.(md|ya?ml|txt)$/i.test(rel) || rel === "pnpm-lock.yaml") continue;
-    if (/\.ya?ml$/i.test(rel) && /\bTODO\b/.test(readFileSync8(file, "utf8"))) r.warn(file, "still contains TODO placeholders");
-    const found = (readFileSync8(file, "utf8").match(EMAIL) ?? []).filter((e) => !ALLOWED_EMAIL.test(e));
+    if (/\.ya?ml$/i.test(rel) && /\bTODO\b/.test(readFileSync9(file, "utf8"))) r.warn(file, "still contains TODO placeholders");
+    const found = (readFileSync9(file, "utf8").match(EMAIL) ?? []).filter((e) => !ALLOWED_EMAIL.test(e));
     if (found.length) r.warn(file, `contains email address(es) ${[...new Set(found)].slice(0, 3).join(", ")}: confirm none are prospects`);
   }
 }
@@ -811,14 +908,14 @@ function checkPinnedApproval(r, contentFile, approval, current, what, approveCmd
   r.err(contentFile, `${what} changed after approval (approved ${pinned}, now ${current}). Re-present it to the approver and record it with \`${approveCmd} --by "<name>"\`, or revert the change`);
   return false;
 }
-function validateCampaign(r, root2, clientId, campaign, icp, signals, icpApproved) {
+function validateCampaign(r, root2, projectId, campaign, icp, signals, icpApproved) {
   const dir = join10(root2, "campaigns", campaign);
   console.log(`campaign ${campaign}`);
   for (const f of REQUIRED_CAMPAIGN) if (!existsSync8(join10(dir, f))) r.err(join10(dir, f), "missing");
   const cfgFile = join10(dir, "config.yaml");
   const cfg = loadVersioned(r, cfgFile, "campaign-config", CampaignConfig);
   if (cfg) {
-    if (cfg.client_id !== clientId) r.err(cfgFile, `client_id "${cfg.client_id}" does not match client.yaml "${clientId}"`);
+    if (cfg.project_id !== projectId) r.err(cfgFile, `project_id "${cfg.project_id}" does not match project.yaml "${projectId}"`);
     if (cfg.campaign_id !== campaign) r.err(cfgFile, `campaign_id "${cfg.campaign_id}" does not match folder "${campaign}"`);
     if (icp) {
       const segs = new Set(icp.segments.map((s) => s.id));
@@ -841,7 +938,7 @@ function validateCampaign(r, root2, clientId, campaign, icp, signals, icpApprove
       r.err(cfgFile, `stage is "${cfg.stage}" but the ICP gate (context/icp.yaml approval) is not approved, or the ICP changed since approval`);
     }
     const copyFile = join10(dir, "copy.md");
-    const copyApproved = existsSync8(copyFile) ? checkPinnedApproval(r, copyFile, cfg.gates.copy, copyContentHash(readFileSync8(copyFile, "utf8")), "copy", `pnpm gtm approve copy ${campaign}`) : false;
+    const copyApproved = existsSync8(copyFile) ? checkPinnedApproval(r, copyFile, cfg.gates.copy, copyContentHash(readFileSync9(copyFile, "utf8")), "copy", `npx gtm approve copy ${campaign}`) : false;
     if (stageIndex(cfg.stage) > stageIndex("copy") && !copyApproved) {
       r.err(cfgFile, `stage is "${cfg.stage}" but gates.copy is not approved, or copy.md changed since approval`);
     }
@@ -857,7 +954,7 @@ function validateCampaign(r, root2, clientId, campaign, icp, signals, icpApprove
   }
   const runs = join10(dir, "runs");
   if (existsSync8(runs)) {
-    for (const f of readdirSync4(runs).filter((f2) => !f2.startsWith("."))) {
+    for (const f of readdirSync3(runs).filter((f2) => !f2.startsWith("."))) {
       if (!RUN_LOG_NAME.test(f)) r.err(join10(runs, f), "run logs must be named YYYY-MM-DD-<user>[-n].md");
     }
   }
@@ -866,22 +963,23 @@ function runValidate(root2, onlyCampaign) {
   const r = new Report(root2);
   console.log(`validating ${root2} against core v${GTM_VERSION}`);
   checkCoreSync(r, root2);
-  const meta = loadVersioned(r, join10(root2, "client.yaml"), "client", ClientFile);
-  const clientId = meta?.client_id ?? "";
+  for (const { from, to } of pendingRenames(root2)) r.err(join10(root2, from), `renamed to ${to} in core 0.3.0: run \`npx gtm migrate\``);
+  const meta = loadVersioned(r, join10(root2, "project.yaml"), "project", ProjectFile);
+  const projectId = meta?.project_id ?? "";
   if (meta) {
     for (const key of Object.keys(meta.features)) {
-      if (!FEATURES[key]) r.err(join10(root2, "client.yaml"), `unknown feature "${key}" (known: ${Object.keys(FEATURES).join(", ") || "none"})`);
+      if (!FEATURES[key]) r.err(join10(root2, "project.yaml"), `unknown feature "${key}" (known: ${Object.keys(FEATURES).join(", ") || "none"})`);
     }
   }
-  if (!existsSync8(join10(root2, "CLIENT.md"))) r.warn(join10(root2, "CLIENT.md"), "missing (client-specific rules for agents)");
+  if (!existsSync8(join10(root2, "PROJECT.md"))) r.warn(join10(root2, "PROJECT.md"), "missing (project-specific rules for agents)");
   for (const f of REQUIRED_CONTEXT) if (!existsSync8(join10(root2, "context", f))) r.err(join10(root2, "context", f), "missing");
   const icpFile = join10(root2, "context", "icp.yaml");
   const sigFile = join10(root2, "context", "signals.yaml");
   const icp = existsSync8(icpFile) ? loadVersioned(r, icpFile, "icp", IcpFile) : null;
   const signals = existsSync8(sigFile) ? loadVersioned(r, sigFile, "signals", SignalsFile) : null;
-  if (meta && icp && icp.client_id !== clientId) r.err(icpFile, `client_id "${icp.client_id}" does not match client.yaml "${clientId}"`);
-  if (meta && signals && signals.client_id !== clientId) r.err(sigFile, `client_id "${signals.client_id}" does not match client.yaml "${clientId}"`);
-  const icpApproved = icp ? checkPinnedApproval(r, icpFile, icp.approval, icpContentHash(parse3(readFileSync8(icpFile, "utf8"))), "ICP", "pnpm gtm approve icp") : false;
+  if (meta && icp && icp.project_id !== projectId) r.err(icpFile, `project_id "${icp.project_id}" does not match project.yaml "${projectId}"`);
+  if (meta && signals && signals.project_id !== projectId) r.err(sigFile, `project_id "${signals.project_id}" does not match project.yaml "${projectId}"`);
+  const icpApproved = icp ? checkPinnedApproval(r, icpFile, icp.approval, icpContentHash(parse3(readFileSync9(icpFile, "utf8"))), "ICP", "npx gtm approve icp") : false;
   checkNoLeadData(r, root2);
   const campaigns = onlyCampaign ? [onlyCampaign] : subdirs(join10(root2, "campaigns"));
   for (const c of campaigns) {
@@ -889,24 +987,31 @@ function runValidate(root2, onlyCampaign) {
       r.err(join10(root2, "campaigns", c), "campaign folder not found");
       continue;
     }
-    validateCampaign(r, root2, clientId, c, icp, signals, icpApproved);
+    validateCampaign(r, root2, projectId, c, icp, signals, icpApproved);
   }
   r.summary();
   return r.errors === 0;
 }
 
 // src/commands/upgrade.ts
-function pm(root2, args2) {
-  const onPath = spawnSync2("pnpm", ["--version"], { stdio: "ignore" }).status === 0;
-  const pinned = JSON.parse(readFileSync9(join11(root2, "package.json"), "utf8")).packageManager ?? "pnpm@10";
-  const [cmd, pre] = onPath ? ["pnpm", []] : ["npx", ["-y", pinned]];
-  return spawnSync2(cmd, [...pre, ...args2], { cwd: root2, stdio: "inherit" }).status ?? 1;
+function detectPackageManager(root2) {
+  if (existsSync9(join11(root2, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync9(join11(root2, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function installExact(root2, pm, spec) {
+  const onPath = (bin) => spawnSync2(bin, ["--version"], { stdio: "ignore" }).status === 0;
+  const [cmd, args2] = pm === "npm" ? ["npm", ["install", "--save-dev", "--save-exact", spec]] : pm === "pnpm" ? onPath("pnpm") ? ["pnpm", ["add", "-D", "--save-exact", spec]] : ["npx", ["-y", "pnpm@10", "add", "-D", "--save-exact", spec]] : onPath("yarn") ? ["yarn", ["add", "-D", "--exact", spec]] : ["npx", ["-y", "yarn@1", "add", "-D", "--exact", spec]];
+  return spawnSync2(cmd, args2, { cwd: root2, stdio: "inherit" }).status ?? 1;
+}
+function gtm(root2, args2) {
+  return spawnSync2("npx", ["gtm", ...args2], { cwd: root2, stdio: "inherit" }).status ?? 1;
 }
 var FROZEN_STAGES = ["qa", "launch"];
 function runUpgrade(root2, opts) {
   const before = pinnedVersion(root2);
   if (!before) {
-    console.error(`package.json does not depend on ${PACKAGE_NAME}: is this a client repo?`);
+    console.error(`package.json does not depend on ${PACKAGE_NAME}: is this a project repo?`);
     return false;
   }
   const frozen = campaignStages(root2).filter((c) => FROZEN_STAGES.includes(c.stage));
@@ -921,15 +1026,16 @@ function runUpgrade(root2, opts) {
     return false;
   }
   const target = opts.version ?? "latest";
-  console.log(`Upgrading ${PACKAGE_NAME} ${before} \u2192 ${target}`);
-  if (pm(root2, ["add", "-D", "--save-exact", `${PACKAGE_NAME}@${target}`]) !== 0) return false;
-  if (pm(root2, ["exec", "gtm", "sync"]) !== 0) return false;
-  if (pm(root2, ["exec", "gtm", "migrate"]) !== 0) return false;
-  const valid = pm(root2, ["exec", "gtm", "validate"]) === 0;
+  const pm = detectPackageManager(root2);
+  console.log(`Upgrading ${PACKAGE_NAME} ${before} \u2192 ${target} (with ${pm})`);
+  if (installExact(root2, pm, `${PACKAGE_NAME}@${target}`) !== 0) return false;
+  if (gtm(root2, ["sync"]) !== 0) return false;
+  if (gtm(root2, ["migrate"]) !== 0) return false;
+  const valid = gtm(root2, ["validate"]) === 0;
   const after = pinnedVersion(root2) ?? target;
   const changelog = join11(root2, "node_modules", ...PACKAGE_NAME.split("/"), "CHANGELOG.md");
   if (existsSync9(changelog)) {
-    const notes = changelogBetween(readFileSync9(changelog, "utf8"), before, after);
+    const notes = changelogBetween(readFileSync10(changelog, "utf8"), before, after);
     console.log(`
 === Changes ${before} \u2192 ${after} ===
 ${notes || "(no changelog entries)"}
@@ -942,44 +1048,48 @@ ${notes || "(no changelog entries)"}
 // src/help.ts
 var COMMANDS = {
   init: {
-    usage: 'gtm init <client-slug> --name "<Client Name>" [--dir <path>]',
-    summary: "scaffold a new client repo",
+    usage: 'gtm init <project-slug> --name "<Project Name>" [--dir <path>]\ngtm init . --name "<Project Name>" [--slug <project-slug>]',
+    summary: 'scaffold a project repo (new folder, or the current one with ".")',
     details: [
-      "Creates a complete client repo: client.yaml, context/ templates, campaigns/, tam/, CLIENT.md,",
-      "CI workflows, .gtm/ (core kit) and AGENTS.md, pinned to this CLI's version, then runs git init.",
-      "Push the result to a PRIVATE repo: it will hold client context."
+      "Creates a complete project repo: project.yaml, context/ templates, campaigns/, tam/, PROJECT.md,",
+      "CI workflows, .gtm/ (core kit) and AGENTS.md, pinned to this CLI's version.",
+      '"." sets up the current folder; the slug comes from the folder name (gtm-project-acme \u2192 acme) or --slug.',
+      "Works in a fresh clone: .git is kept (no git init inside an existing repo), README.md is kept,",
+      ".gitignore gets gtm rules appended, CLAUDE.md gets @AGENTS.md. Any other existing gtm file",
+      "(e.g. AGENTS.md, .gtm/, package.json) stops init before anything is written.",
+      "Push the result to a PRIVATE repo: it will hold project context."
     ],
-    writes: "A new folder (default ./gtm-client-<slug>). Refuses if it exists and is not empty.",
-    examples: ['npx @veleads/gtm init acme --name "Acme Corp"', 'npx @veleads/gtm init acme --name "Acme Corp" --dir ./clients/acme']
+    writes: 'The target folder (new ./gtm-project-<slug>, --dir, or the current folder with "."). Never overwrites existing files.',
+    examples: ['npx @veleads/gtm init . --name "Acme Corp"', 'npx @veleads/gtm init acme --name "Acme Corp"', 'npx @veleads/gtm init . --name "Acme Corp" --slug acme']
   },
   "new-campaign": {
     usage: "gtm new-campaign <campaign-slug>",
     summary: "scaffold campaigns/<slug>/",
     details: ["Copies the campaign template (brief.md, config.yaml, copy.md, runs/). Owner comes from GTM_USER."],
     writes: "campaigns/<slug>/ (refuses if it exists).",
-    examples: ["git switch -c campaign/q1-uk-cfo && pnpm gtm new-campaign q1-uk-cfo"]
+    examples: ["git switch -c campaign/q1-uk-cfo && npx gtm new-campaign q1-uk-cfo"]
   },
   validate: {
     usage: "gtm validate [campaign]",
     summary: "check repo against schemas, gates, data rules",
     details: [
-      "Checks client.yaml, context/ and campaigns against the schemas; segment/persona/signal references;",
+      "Checks project.yaml, context/ and campaigns against the schemas; segment/persona/signal references;",
       "gate order (no stage past an unapproved or changed ICP/copy approval); required files; run-log names;",
       "no lead data (blocks data files, warns on email addresses); .gtm/ matches the installed core.",
       "Exit code 1 if there is any error; warnings never fail."
     ],
     writes: "Nothing (read-only).",
-    examples: ["pnpm gtm validate", "pnpm gtm validate q1-uk-cfo"]
+    examples: ["npx gtm validate", "npx gtm validate q1-uk-cfo"]
   },
   status: {
     usage: "gtm status",
     summary: "campaigns, stages, gates",
-    details: ["One screen: client, core version, ICP gate, and per campaign the stage, copy/launch gates, owner and latest run log."],
+    details: ["One screen: project, core version, ICP gate, and per campaign the stage, copy/launch gates, owner and latest run log."],
     writes: "Nothing (read-only).",
-    examples: ["pnpm gtm status"]
+    examples: ["npx gtm status"]
   },
   approve: {
-    usage: 'gtm approve icp --by "<Name (side)>" [--notes ".."] [--date YYYY-MM-DD]\ngtm approve copy <campaign> --by "<Name (side)>" [--notes ".."] [--date YYYY-MM-DD]',
+    usage: 'gtm approve icp --by "<Name (role)>" [--notes ".."] [--date YYYY-MM-DD]\ngtm approve copy <campaign> --by "<Name (role)>" [--notes ".."] [--date YYYY-MM-DD]',
     summary: "record a sign-off and pin a hash of the approved content",
     details: [
       "Run ONLY after the named human explicitly approved in this session (AGENTS.md section 4).",
@@ -988,7 +1098,7 @@ var COMMANDS = {
       "The launch gate is recorded by hand in config.yaml (its content is the lead set)."
     ],
     writes: "context/icp.yaml \u2192 approval (icp), or campaigns/<campaign>/config.yaml \u2192 gates.copy (copy).",
-    examples: ['pnpm gtm approve icp --by "Maria Chen (client)" --notes "Segments A+B, personas CFO+AP"', 'pnpm gtm approve copy q1-uk-cfo --by "Maria Chen (client)"']
+    examples: ['npx gtm approve icp --by "Maria Chen (VP Marketing)" --notes "Segments A+B, personas CFO+AP"', 'npx gtm approve copy q1-uk-cfo --by "Maria Chen (VP Marketing)"']
   },
   sync: {
     usage: "gtm sync [--check]",
@@ -998,14 +1108,14 @@ var COMMANDS = {
       "--check only compares and exits 1 if they differ (CI uses this; never edit .gtm/ by hand)."
     ],
     writes: ".gtm/ (replaced entirely) and AGENTS.md; creates CLAUDE.md if missing. With --check: nothing.",
-    examples: ["pnpm gtm sync", "pnpm gtm sync --check"]
+    examples: ["npx gtm sync", "npx gtm sync --check"]
   },
   migrate: {
     usage: "gtm migrate [--dry-run]",
     summary: "upgrade YAML files to current schema versions",
-    details: ["Applies core schema migrations to client.yaml, context/*.yaml and campaigns/*/config.yaml, keeping comments."],
+    details: ["Applies core schema migrations to project.yaml, context/*.yaml and campaigns/*/config.yaml, keeping comments."],
     writes: "Those YAML files, only if a migration applies. With --dry-run: nothing.",
-    examples: ["pnpm gtm migrate --dry-run", "pnpm gtm migrate"]
+    examples: ["npx gtm migrate --dry-run", "npx gtm migrate"]
   },
   upgrade: {
     usage: "gtm upgrade [version] [--force]",
@@ -1015,7 +1125,7 @@ var COMMANDS = {
       "Refuses while a campaign is in qa or launch, or with uncommitted changes (--force overrides; ask a GTM engineer)."
     ],
     writes: "package.json, lockfile, node_modules, .gtm/, AGENTS.md and migrated YAML files.",
-    examples: ["pnpm gtm upgrade", "pnpm gtm upgrade 0.3.0"]
+    examples: ["npx gtm upgrade", "npx gtm upgrade 0.3.0"]
   },
   job: {
     usage: "gtm job <name> <campaign>",
@@ -1025,15 +1135,15 @@ var COMMANDS = {
       "Not available yet: it exits 1. Per AGENTS.md this is a stop; do not improvise jobs with ad-hoc scripts."
     ],
     writes: "Nothing yet.",
-    examples: ["pnpm gtm job tam q1-uk-cfo"]
+    examples: ["npx gtm job tam q1-uk-cfo"]
   }
 };
 function generalHelp(version) {
   const width = Math.max(...Object.keys(COMMANDS).map((c) => c.length));
   const lines = Object.entries(COMMANDS).map(([name, c]) => `  ${name.padEnd(width)}  ${c.summary}`);
-  return `gtm v${version}: CLI for gtm-brain client repos (@veleads/gtm)
+  return `gtm v${version}: CLI for gtm-brain project repos (@veleads/gtm)
 
-Usage: gtm <command> [options]      (inside a client repo: pnpm gtm <command>)
+Usage: gtm <command> [options]      (inside a project repo: npx gtm <command>)
 
 Commands:
 ${lines.join("\n")}
@@ -1047,7 +1157,7 @@ Global options:
 
 Exit codes: 0 success, 1 failure or validation errors.
 
-For coding agents: inside a client repo, read AGENTS.md first and follow it. Read-only commands
+For coding agents: inside a project repo, read AGENTS.md first and follow it. Read-only commands
 (validate, status, sync --check, migrate --dry-run) are always safe to run.`;
 }
 function commandHelp(name) {
@@ -1073,6 +1183,7 @@ var { values, positionals } = parseArgs({
     root: { type: "string" },
     name: { type: "string" },
     dir: { type: "string" },
+    slug: { type: "string" },
     by: { type: "string" },
     notes: { type: "string" },
     date: { type: "string" },
@@ -1109,7 +1220,7 @@ function run() {
   if (values.help) return help(command === "help" ? args[0] : command);
   switch (command) {
     case "init":
-      return runInit(args[0], { name: values.name, dir: values.dir, cwd });
+      return runInit(args[0], { name: values.name, dir: values.dir, slug: values.slug, cwd });
     case "new-campaign":
       return runNewCampaign(root, args[0]);
     case "validate":