gooseworks 0.3.15 → 0.4.0

package/dist/skills/master-skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"master-skill.js","sourceRoot":"","sources":["../../src/skills/master-skill.ts"],"names":[],"mappings":";;AA4BA,wCAMC;AAWD,sDA8NC;AAiBD,0DA0UC;AAcD,8DA2bC;AAphCD,oDAAoD;AACpD,SAAgB,cAAc;IAC5B,OAAO;QACL,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAE;QACxD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,uBAAuB,EAAE,EAAE;QACzD,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4NR,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,uBAAuB;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwUR,CAAC;AACF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,yBAAyB;IACvC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAybR,CAAC;AACF,CAAC"}
+{"version":3,"file":"master-skill.js","sourceRoot":"","sources":["../../src/skills/master-skill.ts"],"names":[],"mappings":"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"}

package/dist/skills/names.d.ts

@@ -1,2 +1,54 @@
-export declare function isManagedGooseworksSkill(name: string): boolean;
+/**
+ * Which directories under ~/.agents/skills/ the CLI is allowed to DELETE.
+ *
+ * GOOSE-3191 (data loss): this predicate used to match ANY directory whose name
+ * started with `goose-` or `gooseworks-`. `gooseworks install` calls
+ * `removeAllSkills()` on every install / update / login-refresh, so a user's own
+ * unrelated third-party skill — `goose-notes`, `goose-jira`, anything they wrote
+ * themselves — was silently destroyed. A name prefix is NOT ownership.
+ *
+ * The rule now, in order of authority:
+ *
+ *   1. **Known entry-skill slugs** (`gooseworks`, `goose-ads`, `goose-video`,
+ *      `goose-product-photos`, plus the legacy `ads-remix` name) are ours by
+ *      definition — they are the dirs the CLI itself writes on every install, so
+ *      we delete them regardless of whether they carry a stamp. This is what
+ *      keeps upgrades from an old CLI working.
+ *   2. **A `.gooseworks-version` stamp** marks a directory the installer wrote.
+ *      It is a SECONDARY signal, used to recognise standalone skills installed
+ *      with `--with <slug>` (whose slugs we can't enumerate ahead of time).
+ *   3. **Anything else is the user's.** An unstamped directory that is not a
+ *      known entry slug is NEVER deleted, no matter what it's called.
+ *
+ * Deliberate, documented trade-off: a standalone skill installed by an OLDER CLI
+ * (before `installStandaloneSkill` wrote a stamp) is unstamped and therefore no
+ * longer removed by `removeAllSkills()`. That is the safe direction to be wrong —
+ * it leaves a stale-but-working copy on disk instead of deleting a stranger's
+ * work — and it self-heals: re-running `gooseworks install --with <slug>`
+ * replaces the directory in place and stamps it.
+ */
+/** The stamp file `installEntrySkill` / `installStandaloneSkill` write. */
+export declare const STAMP_FILE = ".gooseworks-version";
+/**
+ * Entry-skill dir names the CLI no longer writes but must still clean up.
+ * `ads-remix` was renamed to `goose-ads`.
+ */
+export declare const LEGACY_ENTRY_SKILL_NAMES: readonly ["ads-remix"];
+/**
+ * Every skill directory name the CLI itself owns and writes. Derived from
+ * `getEntrySkills()` so the registry stays the single source (GOOSE-3190).
+ */
+export declare function getManagedEntrySkillNames(): string[];
+/** True when `name` is a skill directory the CLI itself installs. */
+export declare function isManagedEntrySkillName(name: string): boolean;
+/** True when `<skillsBase>/<name>/.gooseworks-version` exists. */
+export declare function hasGooseworksStamp(skillsBase: string, name: string): boolean;
+/**
+ * True when the CLI may manage (link, list, and DELETE) `<skillsBase>/<name>/`.
+ *
+ * `skillsBase` is required: ownership is a property of what's ON DISK, not of
+ * the name. Callers that only have a name (e.g. pruning symlinks in
+ * ~/.claude/skills) pass the skills base the links point into.
+ */
+export declare function isManagedGooseworksSkill(name: string, skillsBase: string): boolean;
 //# sourceMappingURL=names.d.ts.map

package/dist/skills/names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/skills/names.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS9D"}
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/skills/names.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,wBAAyB,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAGlF"}

package/dist/skills/names.js

@@ -1,12 +1,112 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGACY_ENTRY_SKILL_NAMES = exports.STAMP_FILE = void 0;
+exports.getManagedEntrySkillNames = getManagedEntrySkillNames;
+exports.isManagedEntrySkillName = isManagedEntrySkillName;
+exports.hasGooseworksStamp = hasGooseworksStamp;
 exports.isManagedGooseworksSkill = isManagedGooseworksSkill;
-function isManagedGooseworksSkill(name) {
-    return (name === 'gooseworks' ||
-        // `ads-remix` was renamed to `goose-ads`; keep it managed so a stale
-        // ads-remix dir from an older install is cleaned up on the next install.
-        name === 'ads-remix' ||
-        name.startsWith('gooseworks-') ||
-        name.startsWith('goose-'));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const master_skill_1 = require("./master-skill");
+/**
+ * Which directories under ~/.agents/skills/ the CLI is allowed to DELETE.
+ *
+ * GOOSE-3191 (data loss): this predicate used to match ANY directory whose name
+ * started with `goose-` or `gooseworks-`. `gooseworks install` calls
+ * `removeAllSkills()` on every install / update / login-refresh, so a user's own
+ * unrelated third-party skill — `goose-notes`, `goose-jira`, anything they wrote
+ * themselves — was silently destroyed. A name prefix is NOT ownership.
+ *
+ * The rule now, in order of authority:
+ *
+ *   1. **Known entry-skill slugs** (`gooseworks`, `goose-ads`, `goose-video`,
+ *      `goose-product-photos`, plus the legacy `ads-remix` name) are ours by
+ *      definition — they are the dirs the CLI itself writes on every install, so
+ *      we delete them regardless of whether they carry a stamp. This is what
+ *      keeps upgrades from an old CLI working.
+ *   2. **A `.gooseworks-version` stamp** marks a directory the installer wrote.
+ *      It is a SECONDARY signal, used to recognise standalone skills installed
+ *      with `--with <slug>` (whose slugs we can't enumerate ahead of time).
+ *   3. **Anything else is the user's.** An unstamped directory that is not a
+ *      known entry slug is NEVER deleted, no matter what it's called.
+ *
+ * Deliberate, documented trade-off: a standalone skill installed by an OLDER CLI
+ * (before `installStandaloneSkill` wrote a stamp) is unstamped and therefore no
+ * longer removed by `removeAllSkills()`. That is the safe direction to be wrong —
+ * it leaves a stale-but-working copy on disk instead of deleting a stranger's
+ * work — and it self-heals: re-running `gooseworks install --with <slug>`
+ * replaces the directory in place and stamps it.
+ */
+/** The stamp file `installEntrySkill` / `installStandaloneSkill` write. */
+exports.STAMP_FILE = '.gooseworks-version';
+/**
+ * Entry-skill dir names the CLI no longer writes but must still clean up.
+ * `ads-remix` was renamed to `goose-ads`.
+ */
+exports.LEGACY_ENTRY_SKILL_NAMES = ['ads-remix'];
+/**
+ * Every skill directory name the CLI itself owns and writes. Derived from
+ * `getEntrySkills()` so the registry stays the single source (GOOSE-3190).
+ */
+function getManagedEntrySkillNames() {
+    return [...(0, master_skill_1.getEntrySkillNames)(), ...exports.LEGACY_ENTRY_SKILL_NAMES];
+}
+/** True when `name` is a skill directory the CLI itself installs. */
+function isManagedEntrySkillName(name) {
+    return getManagedEntrySkillNames().includes(name);
+}
+/** True when `<skillsBase>/<name>/.gooseworks-version` exists. */
+function hasGooseworksStamp(skillsBase, name) {
+    try {
+        return fs.existsSync(path.join(skillsBase, name, exports.STAMP_FILE));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * True when the CLI may manage (link, list, and DELETE) `<skillsBase>/<name>/`.
+ *
+ * `skillsBase` is required: ownership is a property of what's ON DISK, not of
+ * the name. Callers that only have a name (e.g. pruning symlinks in
+ * ~/.claude/skills) pass the skills base the links point into.
+ */
+function isManagedGooseworksSkill(name, skillsBase) {
+    if (isManagedEntrySkillName(name))
+        return true;
+    return hasGooseworksStamp(skillsBase, name);
 }
 //# sourceMappingURL=names.js.map

package/dist/skills/names.js.map

@@ -1 +1 @@
-{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/skills/names.ts"],"names":[],"mappings":";;AAAA,4DASC;AATD,SAAgB,wBAAwB,CAAC,IAAY;IACnD,OAAO,CACL,IAAI,KAAK,YAAY;QACrB,qEAAqE;QACrE,yEAAyE;QACzE,IAAI,KAAK,WAAW;QACpB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/skills/names.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,8DAEC;AAGD,0DAEC;AAGD,gDAMC;AASD,4DAGC;AA3ED,uCAAyB;AACzB,2CAA6B;AAC7B,iDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,2EAA2E;AAC9D,QAAA,UAAU,GAAG,qBAAqB,CAAC;AAEhD;;;GAGG;AACU,QAAA,wBAAwB,GAAG,CAAC,WAAW,CAAU,CAAC;AAE/D;;;GAGG;AACH,SAAgB,yBAAyB;IACvC,OAAO,CAAC,GAAG,IAAA,iCAAkB,GAAE,EAAE,GAAG,gCAAwB,CAAC,CAAC;AAChE,CAAC;AAED,qEAAqE;AACrE,SAAgB,uBAAuB,CAAC,IAAY;IAClD,OAAO,yBAAyB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,kEAAkE;AAClE,SAAgB,kBAAkB,CAAC,UAAkB,EAAE,IAAY;IACjE,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,kBAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CAAC,IAAY,EAAE,UAAkB;IACvE,IAAI,uBAAuB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/skills/routes.d.ts

@@ -0,0 +1,68 @@
+/**
+ * THE routing table for the GooseWorks skill family (GOOSE-3190).
+ *
+ * Routing used to be written out by hand in THREE places that drifted apart:
+ *   1. this CLI's `gooseworks` router SKILL.md (`master-skill.ts`),
+ *   2. the backend's hosted-connector pointer
+ *      (`gooseworks-app/backend/src/app-mcp-server/lib/ads-skill.ts`),
+ *   3. the public skills repo's `collections/brand-growth`.
+ *
+ * This file is now the SINGLE SOURCE. `master-skill.ts` renders its markdown
+ * tables from here (no hand-written route rows), `npm run generate:skills`
+ * emits the machine-readable copy to `skills/routes.json` for the other two
+ * repos to derive from, and `tests/skills/route-drift.test.ts` fails when any
+ * of the three names a skill the others don't.
+ *
+ * The two consumers we cannot edit from this repo are represented by checked-in
+ * snapshots under `tests/fixtures/`; each snapshot names the file to update when
+ * the drift test fires.
+ */
+/** How a routed skill reaches the agent. */
+export type RouteDelivery = 
+/** Vendored by this CLI and installed to ~/.agents/skills/. */
+'entry'
+/** Lives in goose-skills; fetched on demand with `gooseworks fetch <slug>`. */
+ | 'fetch';
+export interface DomainRoute {
+    /** The skill slug to route to. */
+    skill: string;
+    /** When this route applies — the left column of the router table. */
+    when: string;
+    /** How the agent gets the skill — the right column of the router table. */
+    how: string;
+    delivery: RouteDelivery;
+}
+export interface BrandGrowthRoute {
+    /** The job to be done. */
+    job: string;
+    /** The skill slug(s) that do it, in order. */
+    skills: string[];
+}
+/**
+ * Domain routes — the "Route to the right skill FIRST" table. These are the
+ * specialist skills the `gooseworks` router hands whole tasks to.
+ */
+export declare const DOMAIN_ROUTES: DomainRoute[];
+/**
+ * Brand Growth routes — the outcome skills in the `brand-growth` collection.
+ * Must stay in sync with `goose-skills/collections/brand-growth/routes.json`,
+ * which is derived from this list.
+ */
+export declare const BRAND_GROWTH_ROUTES: BrandGrowthRoute[];
+/** Every skill slug named by any route, deduped and sorted. */
+export declare function getRoutedSkillSlugs(): string[];
+/** Brand Growth slugs only (the ones the goose-skills collection must contain). */
+export declare function getBrandGrowthSkillSlugs(): string[];
+/** The machine-readable route table emitted to `skills/routes.json`. */
+export declare function getRouteManifest(): {
+    $comment: string;
+    version: number;
+    domain_routes: DomainRoute[];
+    brand_growth_routes: BrandGrowthRoute[];
+    skills: string[];
+};
+/** Render the domain route table as the router SKILL.md markdown table body. */
+export declare function renderDomainRouteTable(): string;
+/** Render the Brand Growth job→skill table body. */
+export declare function renderBrandGrowthTable(): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/skills/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/skills/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,aAAa;AACvB,+DAA+D;AAC7D,OAAO;AACT,+EAA+E;GAC7E,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EA+BtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAkBjD,CAAC;AAEF,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAK9C;AAED,mFAAmF;AACnF,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAInD;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CASA;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C"}

package/dist/skills/routes.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * THE routing table for the GooseWorks skill family (GOOSE-3190).
+ *
+ * Routing used to be written out by hand in THREE places that drifted apart:
+ *   1. this CLI's `gooseworks` router SKILL.md (`master-skill.ts`),
+ *   2. the backend's hosted-connector pointer
+ *      (`gooseworks-app/backend/src/app-mcp-server/lib/ads-skill.ts`),
+ *   3. the public skills repo's `collections/brand-growth`.
+ *
+ * This file is now the SINGLE SOURCE. `master-skill.ts` renders its markdown
+ * tables from here (no hand-written route rows), `npm run generate:skills`
+ * emits the machine-readable copy to `skills/routes.json` for the other two
+ * repos to derive from, and `tests/skills/route-drift.test.ts` fails when any
+ * of the three names a skill the others don't.
+ *
+ * The two consumers we cannot edit from this repo are represented by checked-in
+ * snapshots under `tests/fixtures/`; each snapshot names the file to update when
+ * the drift test fires.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRAND_GROWTH_ROUTES = exports.DOMAIN_ROUTES = void 0;
+exports.getRoutedSkillSlugs = getRoutedSkillSlugs;
+exports.getBrandGrowthSkillSlugs = getBrandGrowthSkillSlugs;
+exports.getRouteManifest = getRouteManifest;
+exports.renderDomainRouteTable = renderDomainRouteTable;
+exports.renderBrandGrowthTable = renderBrandGrowthTable;
+/**
+ * Domain routes — the "Route to the right skill FIRST" table. These are the
+ * specialist skills the `gooseworks` router hands whole tasks to.
+ */
+exports.DOMAIN_ROUTES = [
+    {
+        skill: 'goose-ads',
+        when: 'Remix/make an ad, research a brand for ads, OR analyze ad performance — Meta/Google ad campaigns, creative fatigue, CAC/lead quality, competitor ad intel, ad angles & hooks',
+        how: 'Installed locally as an entry skill. Just use it. If unavailable, run `gooseworks install --claude`.',
+        delivery: 'entry',
+    },
+    {
+        skill: 'goose-graphics',
+        when: 'Charts, infographics, slides, social graphics, branded visual designs from a style/format',
+        how: 'If installed locally, use it. Otherwise `gooseworks fetch goose-graphics` (or `gooseworks install --claude --with goose-graphics`).',
+        delivery: 'fetch',
+    },
+    {
+        skill: 'goose-video',
+        when: 'Make a **video** ad — remix a video ad template (e.g. iMessage chat-reveal), or "make the video for project <id>"',
+        how: 'Installed locally as an entry skill. Just use it. If unavailable, run `gooseworks install --claude`.',
+        delivery: 'entry',
+    },
+    {
+        skill: 'goose-product-photos',
+        when: 'Make **product photos** — studio, lifestyle, marketplace, social, or on-model product photography',
+        how: 'Installed locally as an entry skill. Just use it. If unavailable, run `gooseworks install --claude`.',
+        delivery: 'entry',
+    },
+    {
+        skill: 'animate-image',
+        when: 'Animate an approved static ad or product image',
+        how: 'Fetch with `gooseworks fetch animate-image` and follow its GooseWorks MCP workflow.',
+        delivery: 'fetch',
+    },
+];
+/**
+ * Brand Growth routes — the outcome skills in the `brand-growth` collection.
+ * Must stay in sync with `goose-skills/collections/brand-growth/routes.json`,
+ * which is derived from this list.
+ */
+exports.BRAND_GROWTH_ROUTES = [
+    { job: 'Brand foundation', skills: ['brand-research'] },
+    { job: 'Competitor ads', skills: ['competitor-ad-intelligence'] },
+    { job: 'Customer language and angles', skills: ['comment-mining', 'ad-angle-miner'] },
+    { job: 'Competitor social content', skills: ['competitor-social-research'] },
+    { job: 'Audience definition', skills: ['audience-research'] },
+    { job: 'Creator discovery and evaluation', skills: ['influencer-prospecting', 'creator-profile-teardown'] },
+    { job: 'Trends and outlier posts', skills: ['trend-discovery', 'outlier-post-finder'] },
+    { job: 'Social listening and product demand', skills: ['social-listening-brief', 'product-demand-research'] },
+    { job: 'Long-form source material (calls, podcasts, videos)', skills: ['transcript-intelligence'] },
+    {
+        job: 'Meta performance, policy, and landing-page match',
+        skills: ['meta-ads-analyzer', 'meta-ad-policy-checker', 'ad-to-landing-page-auditor'],
+    },
+    { job: 'Static ads', skills: ['goose-ads', 'remix-graphic-ad-from-reference'] },
+    { job: 'Product photos', skills: ['goose-product-photos', 'product-photoshoot'] },
+    { job: 'Written content and repurposing', skills: ['content-repurposing'] },
+    { job: 'Graphics and animation', skills: ['goose-graphics', 'animate-image'] },
+];
+/** Every skill slug named by any route, deduped and sorted. */
+function getRoutedSkillSlugs() {
+    const slugs = new Set();
+    for (const r of exports.DOMAIN_ROUTES)
+        slugs.add(r.skill);
+    for (const r of exports.BRAND_GROWTH_ROUTES)
+        for (const s of r.skills)
+            slugs.add(s);
+    return [...slugs].sort();
+}
+/** Brand Growth slugs only (the ones the goose-skills collection must contain). */
+function getBrandGrowthSkillSlugs() {
+    const slugs = new Set();
+    for (const r of exports.BRAND_GROWTH_ROUTES)
+        for (const s of r.skills)
+            slugs.add(s);
+    return [...slugs].sort();
+}
+/** The machine-readable route table emitted to `skills/routes.json`. */
+function getRouteManifest() {
+    return {
+        $comment: 'Generated by `npm run generate:skills` from gooseworks/src/skills/routes.ts — the single source for GooseWorks skill routing (GOOSE-3190). Do not hand-edit. Consumers: goose-skills/collections/brand-growth/routes.json and gooseworks-app/backend/src/app-mcp-server/lib/ads-skill.ts.',
+        version: 1,
+        domain_routes: exports.DOMAIN_ROUTES,
+        brand_growth_routes: exports.BRAND_GROWTH_ROUTES,
+        skills: getRoutedSkillSlugs(),
+    };
+}
+/** Render the domain route table as the router SKILL.md markdown table body. */
+function renderDomainRouteTable() {
+    return exports.DOMAIN_ROUTES.map((r) => `| ${r.when} | **\`${r.skill}\`** | ${r.how} |`).join('\n');
+}
+/** Render the Brand Growth job→skill table body. */
+function renderBrandGrowthTable() {
+    return exports.BRAND_GROWTH_ROUTES.map((r) => `| ${r.job} | ${r.skills.map((s) => `\`${s}\``).join(', ')} |`).join('\n');
+}
+//# sourceMappingURL=routes.js.map

package/dist/skills/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/skills/routes.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gooseworks",
-  "version": "0.3.15",
+  "version": "0.4.0",
   "description": "GooseWorks CLI — give your coding agent real data tools",
   "bin": {
     "gooseworks": "./dist/index.js"