@sitecoreai-labs/sitecoreai-cli 0.1.2 → 0.2.1

package/dist/commands/brand/sync.js

@@ -77,7 +77,7 @@ const createDiffCommand = () => {
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
-        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.brandKitKind.schema);
+        const recipe = await (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.brandKitKind.schema);
         const plan = await (0, sync_1.syncDiff)(recipe_1.brandKitKind, recipe, { kind: recipe_1.brandKitKind.name, id: recipe.name }, ctx);
         printPlan(logger, plan);
         if (hasPaidPipeline(plan)) {
@@ -98,7 +98,7 @@ const createPushCommand = () => {
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
-        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.brandKitKind.schema);
+        const recipe = await (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.brandKitKind.schema);
         const mode = options.allowWrite ? "apply" : "what-if";
         const outcome = await (0, sync_1.syncPush)(recipe_1.brandKitKind, recipe, { kind: recipe_1.brandKitKind.name, id: recipe.name }, ctx, { mode, prune: options.prune });
         printPlan(logger, outcome.plan);

package/dist/commands/brief/create.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const createBriefCreateCommand: () => Command;

package/dist/commands/brief/create.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBriefCreateCommand = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const commander_1 = require("commander");
+const brief_1 = require("../../brief");
+const tasks_1 = require("../../brief/tasks");
+const cli_tasks_1 = require("../../shared/cli-tasks");
+const shared_1 = require("../shared");
+/**
+ * `scai ops brief create` — create a brief instance from a JSON
+ * document matching `CreateBriefInput`. Mirrors `brief types create`:
+ * imperative one-shot, dry-runs by default, --apply to write.
+ *
+ * The JSON body matches the raw API shape:
+ *   {
+ *     "name":        "Q3 Launch Brief",
+ *     "briefTypeId": "<uuid-from `brief types list`>",
+ *     "locale":      "en-us",        // optional
+ *     "fields":      { ... },        // optional, per-field shapes vary by brief type
+ *     "isTemplate":  false           // optional
+ *   }
+ *
+ * For a declarative (codename-based, idempotent) push, use
+ * `scai ops brief sync push --kind brief --file <recipe>` instead.
+ */
+const readJsonFile = (path) => {
+    try {
+        return JSON.parse(node_fs_1.default.readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw (0, cli_tasks_1.inputError)(`Could not read JSON from ${path}: ${error instanceof Error ? error.message : String(error)}`, "Pass --file <path> pointing at a valid CreateBriefInput JSON document.");
+    }
+};
+const createBriefCreateCommand = () => {
+    const command = new commander_1.Command("create")
+        .description("Create a brief instance from a CreateBriefInput JSON document. For declarative + idempotent pushes, use `brief sync push --kind brief`.")
+        .addOption(new commander_1.Option("-f, --file <path>", "Path to a JSON file matching CreateBriefInput (name + briefTypeId, plus optional locale/fields/isTemplate).").makeOptionMandatory(true));
+    (0, shared_1.addOrgScopeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    (0, shared_1.addApplyOption)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    command.action((0, shared_1.withApplyGate)(async (options) => {
+        const input = (0, brief_1.assertCreateBriefInput)(readJsonFile(options.file));
+        await (0, tasks_1.runBriefCreate)({ ...options, input });
+    }));
+    command.addHelpText("after", "\nExamples:\n" +
+        "  $ scai ops brief create -f ./brief.json -n agents --apply\n" +
+        "  $ scai ops brief create -f ./brief.json -n agents             # dry run\n");
+    return command;
+};
+exports.createBriefCreateCommand = createBriefCreateCommand;

package/dist/commands/brief/index.d.ts

@@ -6,10 +6,12 @@ import { Command } from "commander";
  * Surface:
  *   - `scai ops brief list`                            — list briefs in the tenant
  *   - `scai ops brief show <briefId>`                  — read one brief in detail
+ *   - `scai ops brief create -f <file>`                — create a brief from CreateBriefInput JSON
+ *   - `scai ops brief update <briefId>`                — partial-PUT update (file or --status)
  *   - `scai ops brief set-status <briefId> <status>`   — move a brief's workflow status
  *   - `scai ops brief delete <briefId>`                — delete a brief
  *   - `scai ops brief types {list,get,create,update,delete}` — brief type CRUD
- *   - `scai ops brief sync {pull,diff,push}`           — brief type as a recipe
+ *   - `scai ops brief sync {pull,diff,push} [--kind brief|brief-type]` — recipe sync
  *   - `scai ops brief todos [briefId]`                 — list to-dos
  *   - `scai ops brief comments {list,add}`             — list / post comments
  *

package/dist/commands/brief/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBriefCommand = void 0;
 const commander_1 = require("commander");
+const create_1 = require("./create");
 const list_1 = require("./list");
 const show_1 = require("./show");
 const set_status_1 = require("./set-status");
@@ -10,6 +11,7 @@ const todos_1 = require("./todos");
 const comments_1 = require("./comments");
 const delete_1 = require("./delete");
 const sync_1 = require("./sync");
+const update_1 = require("./update");
 /**
  * `scai ops brief …` command family — Sitecore Content Operations Brief
  * API (`co-brief-api-<region>.sitecorecloud.io`).
@@ -17,10 +19,12 @@ const sync_1 = require("./sync");
  * Surface:
  *   - `scai ops brief list`                            — list briefs in the tenant
  *   - `scai ops brief show <briefId>`                  — read one brief in detail
+ *   - `scai ops brief create -f <file>`                — create a brief from CreateBriefInput JSON
+ *   - `scai ops brief update <briefId>`                — partial-PUT update (file or --status)
  *   - `scai ops brief set-status <briefId> <status>`   — move a brief's workflow status
  *   - `scai ops brief delete <briefId>`                — delete a brief
  *   - `scai ops brief types {list,get,create,update,delete}` — brief type CRUD
- *   - `scai ops brief sync {pull,diff,push}`           — brief type as a recipe
+ *   - `scai ops brief sync {pull,diff,push} [--kind brief|brief-type]` — recipe sync
  *   - `scai ops brief todos [briefId]`                 — list to-dos
  *   - `scai ops brief comments {list,add}`             — list / post comments
  *
@@ -31,6 +35,8 @@ const createBriefCommand = () => {
     const command = new commander_1.Command("brief").description("Briefs, brief types, to-dos, and comments on the Sitecore Content Operations Brief API.");
     command.addCommand((0, list_1.createBriefListCommand)());
     command.addCommand((0, show_1.createBriefShowCommand)());
+    command.addCommand((0, create_1.createBriefCreateCommand)());
+    command.addCommand((0, update_1.createBriefUpdateCommand)());
     command.addCommand((0, set_status_1.createBriefSetStatusCommand)());
     command.addCommand((0, delete_1.createBriefDeleteCommand)());
     command.addCommand((0, types_1.createBriefTypesCommand)());
@@ -40,11 +46,15 @@ const createBriefCommand = () => {
     command.addHelpText("after", "\nExamples:\n" +
         "  $ scai ops brief list -n agents                      # list briefs\n" +
         "  $ scai ops brief show <briefId> -n agents            # read one brief\n" +
+        "  $ scai ops brief create -f b.json -n agents --apply  # create a brief (raw API shape)\n" +
+        "  $ scai ops brief update <id> --status Approved --apply  # status-only patch\n" +
         "  $ scai ops brief set-status <briefId> Approved --apply  # move out of Draft\n" +
         "  $ scai ops brief delete <briefId> --apply --force    # delete a brief\n" +
         "  $ scai ops brief types list -n agents                # list brief schemas\n" +
         "  $ scai ops brief types create -f t.json --apply      # create a new schema\n" +
         "  $ scai ops brief sync pull --name CreativeBrief      # capture a type as a recipe\n" +
+        "  $ scai ops brief sync pull --kind brief --name MyBrief  # capture a brief as a recipe\n" +
+        "  $ scai ops brief sync push --kind brief -f b.yaml --allow-write  # converge a brief\n" +
         "  $ scai ops brief todos <briefId> --assignees         # to-dos on a brief, with assignees\n" +
         "  $ scai ops brief comments list <briefId>             # comments on a brief\n" +
         '  $ scai ops brief comments add <briefId> --text "…" --apply  # post a comment\n');

package/dist/commands/brief/sync.d.ts

@@ -1,12 +1,15 @@
 /**
- * `scai ops brief sync` — pull, diff, and push a brief type as a
- * declarative recipe. The recipe / sync model — see
- * docs/recipe-sync-architecture.md.
+ * `scai ops brief sync` — pull, diff, and push a brief type OR a brief
+ * instance as a declarative recipe. See docs/recipe-sync-architecture.md.
  *
- *   pull  capture a live brief type into a recipe file
- *   diff  show the plan to converge a brief type onto a recipe
+ *   pull  capture a live brief type or brief as a recipe file
+ *   diff  show the plan to converge a brief type or brief onto a recipe
  *   push  apply that plan (dry-run unless --allow-write)
+ *
+ * Both verbs default to `--kind brief-type` for back-compat with the
+ * pre-instance surface — the same flag distinguishes `briefTypeKind`
+ * (the schema template) from `briefInstanceKind` (a populated brief).
  */
 import { Command } from "commander";
-/** `scai ops brief sync` — the recipe pull / diff / push verbs for brief types. */
+/** `scai ops brief sync` — the recipe pull / diff / push verbs. */
 export declare const createBriefSyncCommand: () => Command;

package/dist/commands/brief/sync.js

@@ -2,13 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBriefSyncCommand = void 0;
 /**
- * `scai ops brief sync` — pull, diff, and push a brief type as a
- * declarative recipe. The recipe / sync model — see
- * docs/recipe-sync-architecture.md.
+ * `scai ops brief sync` — pull, diff, and push a brief type OR a brief
+ * instance as a declarative recipe. See docs/recipe-sync-architecture.md.
  *
- *   pull  capture a live brief type into a recipe file
- *   diff  show the plan to converge a brief type onto a recipe
+ *   pull  capture a live brief type or brief as a recipe file
+ *   diff  show the plan to converge a brief type or brief onto a recipe
  *   push  apply that plan (dry-run unless --allow-write)
+ *
+ * Both verbs default to `--kind brief-type` for back-compat with the
+ * pre-instance surface — the same flag distinguishes `briefTypeKind`
+ * (the schema template) from `briefInstanceKind` (a populated brief).
  */
 const commander_1 = require("commander");
 const shared_1 = require("../shared");
@@ -16,11 +19,28 @@ const recipe_1 = require("../../brief/recipe");
 const root_config_1 = require("../../config/root-config");
 const cli_tasks_1 = require("../../shared/cli-tasks");
 const sync_1 = require("../../sync");
-/** Slugify a brief-type name for a default recipe filename. */
-const slug = (value) => value
+const BRIEF_SYNC_KINDS = ["brief-type", "brief"];
+/** Slugify a recipe name for a default filename. */
+const slug = (value, fallback) => value
     .toLowerCase()
     .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "") || "brief-type";
+    .replace(/^-+|-+$/g, "") || fallback;
+/** Per-kind metadata — wires the discriminator to the right kind + filename suffix. */
+const kindFor = (kind) => {
+    const resolved = kind ?? "brief-type";
+    if (resolved === "brief") {
+        return {
+            recipeKind: recipe_1.briefInstanceKind,
+            suffix: "brief.yaml",
+            humanName: "brief",
+        };
+    }
+    return {
+        recipeKind: recipe_1.briefTypeKind,
+        suffix: "brieftype.yaml",
+        humanName: "brief type",
+    };
+};
 /** Build the `SyncContext` for a brief sync command invocation. */
 const buildContext = (options, logger) => {
     const configPath = options.config ?? process.cwd();
@@ -44,23 +64,31 @@ const printPlan = (logger, plan) => {
     const tally = (0, sync_1.summarizePlan)(plan);
     logger.info(`Plan: ${tally.create} create, ${tally.update} update, ${tally.delete} delete, ${tally.noop} unchanged.`);
 };
+/** `--kind` is shared across all three verbs. */
+const addKindOption = (command) => command.addOption(new commander_1.Option("--kind <kind>", "Recipe kind to operate on. Defaults to brief-type for back-compat.")
+    .choices(BRIEF_SYNC_KINDS)
+    .default("brief-type"));
 const createPullCommand = () => {
     const command = new commander_1.Command("pull")
-        .description("Capture a live brief type as a recipe file.")
-        .requiredOption("--name <name>", "Brief type codename")
-        .addOption(new commander_1.Option("--file <path>", "Output recipe file (default: <name>.brieftype.yaml)"));
+        .description("Capture a live brief type or brief instance as a recipe file.")
+        .requiredOption("--name <name>", "Identifier of the recipe. Brief-type codename (`CreativeBrief`) or brief display name (`Q3 Launch`).")
+        .addOption(new commander_1.Option("--file <path>", "Output recipe file (default: <name>.<kind>.yaml)"));
+    addKindOption(command);
     (0, shared_1.addEnvironmentOption)(command);
     (0, shared_1.addConfigOption)(command);
     (0, shared_1.addVerbosityOptions)(command);
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
+        const { recipeKind, suffix, humanName } = kindFor(options.kind);
         const name = options.name ?? "";
-        const recipe = await (0, sync_1.syncPull)(recipe_1.briefTypeKind, { kind: recipe_1.briefTypeKind.name, id: name }, ctx);
+        const recipe = await (0, sync_1.syncPull)(recipeKind, { kind: recipeKind.name, id: name }, ctx);
         if (!recipe) {
-            throw (0, cli_tasks_1.inputError)(`Brief type "${name}" not found.`, "List brief types with `scai ops brief types list`.");
+            throw (0, cli_tasks_1.inputError)(`${humanName.charAt(0).toUpperCase()}${humanName.slice(1)} "${name}" not found.`, recipeKind === recipe_1.briefTypeKind
+                ? "List brief types with `scai ops brief types list`."
+                : "List briefs with `scai ops brief list`.");
         }
-        const file = options.file ?? `${slug(name)}.brieftype.yaml`;
+        const file = options.file ?? `${slug(name, humanName.replace(/\s+/g, "-"))}.${suffix}`;
         (0, sync_1.writeRecipe)(file, recipe);
         logger.info(`Pulled "${name}" -> ${file}`, "green");
     });
@@ -68,35 +96,39 @@ const createPullCommand = () => {
 };
 const createDiffCommand = () => {
     const command = new commander_1.Command("diff")
-        .description("Show the plan to converge a brief type onto a recipe file.")
+        .description("Show the plan to converge a brief type or brief onto a recipe file.")
         .requiredOption("--file <path>", "Recipe file (.yaml / .json)");
+    addKindOption(command);
     (0, shared_1.addEnvironmentOption)(command);
     (0, shared_1.addConfigOption)(command);
     (0, shared_1.addVerbosityOptions)(command);
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
-        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.briefTypeKind.schema);
-        const plan = await (0, sync_1.syncDiff)(recipe_1.briefTypeKind, recipe, { kind: recipe_1.briefTypeKind.name, id: recipe.name }, ctx);
+        const { recipeKind } = kindFor(options.kind);
+        const recipe = (await (0, sync_1.loadRecipe)(options.file ?? "", recipeKind.schema));
+        const plan = await (0, sync_1.syncDiff)(recipeKind, recipe, { kind: recipeKind.name, id: recipe.name }, ctx);
         printPlan(logger, plan);
     });
     return command;
 };
 const createPushCommand = () => {
     const command = new commander_1.Command("push")
-        .description("Converge a brief type onto a recipe file. Dry-run unless --allow-write.")
+        .description("Converge a brief type or brief onto a recipe file. Dry-run unless --allow-write.")
         .requiredOption("--file <path>", "Recipe file (.yaml / .json)")
         .addOption(new commander_1.Option("--allow-write", "Apply the plan (default is a dry-run)"))
         .addOption(new commander_1.Option("--prune", "Include delete changes (off by default)"));
+    addKindOption(command);
     (0, shared_1.addEnvironmentOption)(command);
     (0, shared_1.addConfigOption)(command);
     (0, shared_1.addVerbosityOptions)(command);
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
-        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.briefTypeKind.schema);
+        const { recipeKind } = kindFor(options.kind);
+        const recipe = (await (0, sync_1.loadRecipe)(options.file ?? "", recipeKind.schema));
         const mode = options.allowWrite ? "apply" : "what-if";
-        const outcome = await (0, sync_1.syncPush)(recipe_1.briefTypeKind, recipe, { kind: recipe_1.briefTypeKind.name, id: recipe.name }, ctx, { mode, prune: options.prune });
+        const outcome = await (0, sync_1.syncPush)(recipeKind, recipe, { kind: recipeKind.name, id: recipe.name }, ctx, { mode, prune: options.prune });
         printPlan(logger, outcome.plan);
         if (outcome.result) {
             logger.info(`Applied ${outcome.result.applied.length} change(s); ${outcome.result.skipped.length} skipped.`, "green");
@@ -110,9 +142,9 @@ const createPushCommand = () => {
     });
     return command;
 };
-/** `scai ops brief sync` — the recipe pull / diff / push verbs for brief types. */
+/** `scai ops brief sync` — the recipe pull / diff / push verbs. */
 const createBriefSyncCommand = () => {
-    const command = new commander_1.Command("sync").description("Pull, diff, and push a brief type as a declarative recipe.");
+    const command = new commander_1.Command("sync").description("Pull, diff, and push a brief type or brief instance as a declarative recipe.");
     command.addCommand(createPullCommand());
     command.addCommand(createDiffCommand());
     command.addCommand(createPushCommand());

package/dist/commands/brief/update.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const createBriefUpdateCommand: () => Command;

package/dist/commands/brief/update.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBriefUpdateCommand = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const commander_1 = require("commander");
+const tasks_1 = require("../../brief/tasks");
+const cli_tasks_1 = require("../../shared/cli-tasks");
+const errors_1 = require("../../shared/errors");
+const shared_1 = require("../shared");
+/**
+ * `scai ops brief update <briefId>` — partial-PUT update of a brief
+ * instance. The JSON body is `Partial<CreateBriefInput> & { status? }`:
+ * any subset of `name`, `locale`, `fields`, `isTemplate`, plus an
+ * optional `status` workflow move. Read first if you only want to
+ * change one field — the PUT is partial but applies whatever keys it
+ * receives.
+ *
+ * Use `scai ops brief set-status` for status-only moves (already wired)
+ * or this command's `--status <s>` flag as a shortcut that bypasses the
+ * `--file` requirement.
+ */
+const KNOWN_STATUSES = [
+    "Draft",
+    "InReview",
+    "Approved",
+    "Canceled",
+    "Archived",
+];
+const readJsonFile = (path) => {
+    try {
+        return JSON.parse(node_fs_1.default.readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw (0, cli_tasks_1.inputError)(`Could not read JSON from ${path}: ${error instanceof Error ? error.message : String(error)}`, "Pass --file <path> pointing at a valid brief-update JSON document.");
+    }
+};
+const assertUpdateBody = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw (0, errors_1.createScaiError)("Brief update body must be a JSON object.", "INPUT_INVALID");
+    }
+    const obj = value;
+    if (obj.status !== undefined && !KNOWN_STATUSES.includes(obj.status)) {
+        throw (0, errors_1.createScaiError)(`Invalid 'status': ${JSON.stringify(obj.status)}.`, "INPUT_INVALID", {
+            hint: `Must be one of: ${KNOWN_STATUSES.join(", ")}.`,
+        });
+    }
+    if (obj.fields !== undefined && (typeof obj.fields !== "object" || Array.isArray(obj.fields))) {
+        throw (0, errors_1.createScaiError)("'fields' must be an object keyed by field name.", "INPUT_INVALID");
+    }
+    return obj;
+};
+const createBriefUpdateCommand = () => {
+    const command = new commander_1.Command("update")
+        .description("Update a brief instance with a partial-PUT body. Provide --file for arbitrary patches, or --status as a shortcut for a status-only move.")
+        .argument("<briefId>", "Brief UUID")
+        .addOption(new commander_1.Option("-f, --file <path>", "Path to a JSON file with the partial patch."))
+        .addOption(new commander_1.Option("--status <status>", "Shortcut: status-only patch. Equivalent to `scai ops brief set-status`.").choices(KNOWN_STATUSES));
+    (0, shared_1.addOrgScopeOptions)(command);
+    (0, shared_1.addConfigOption)(command);
+    (0, shared_1.addVerbosityOptions)(command);
+    (0, shared_1.addApplyOption)(command);
+    (0, shared_1.addWhatIfOption)(command);
+    command.action(async (briefId, options) => {
+        await (0, shared_1.withApplyGate)(async (opts) => {
+            if (!opts.file && !opts.status) {
+                throw (0, cli_tasks_1.inputError)("Pass --file <path> or --status <status>.", "The PUT requires at least one field; pass a JSON file with the patch or use --status for the common case.");
+            }
+            const fromFile = opts.file ? assertUpdateBody(readJsonFile(opts.file)) : {};
+            const patch = {
+                ...fromFile,
+                ...(opts.status ? { status: opts.status } : {}),
+            };
+            await (0, tasks_1.runBriefUpdate)({ ...opts, briefId, patch });
+        })(options);
+    });
+    command.addHelpText("after", "\nExamples:\n" +
+        "  $ scai ops brief update <id> --status Approved -n agents --apply\n" +
+        "  $ scai ops brief update <id> -f ./patch.json -n agents --apply\n");
+    return command;
+};
+exports.createBriefUpdateCommand = createBriefUpdateCommand;

package/dist/commands/campaign/sync.js

@@ -76,7 +76,7 @@ const createDiffCommand = () => {
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
-        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.campaignKind.schema);
+        const recipe = await (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.campaignKind.schema);
         const plan = await (0, sync_1.syncDiff)(recipe_1.campaignKind, recipe, { kind: recipe_1.campaignKind.name, id: recipe.name }, ctx);
         printPlan(logger, plan);
     });
@@ -94,7 +94,7 @@ const createPushCommand = () => {
     command.action(async (options) => {
         const logger = (0, cli_tasks_1.toLogger)(options);
         const ctx = buildContext(options, logger);
-        const recipe = (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.campaignKind.schema);
+        const recipe = await (0, sync_1.loadRecipe)(options.file ?? "", recipe_1.campaignKind.schema);
         const mode = options.allowWrite ? "apply" : "what-if";
         const outcome = await (0, sync_1.syncPush)(recipe_1.campaignKind, recipe, { kind: recipe_1.campaignKind.name, id: recipe.name }, ctx, { mode, prune: options.prune });
         printPlan(logger, outcome.plan);

package/dist/mcp/descriptions.js

@@ -72,7 +72,7 @@ exports.TOOL_DESCRIPTIONS = {
     publish_lifecycle: "Mutating publishing operations. v1 exposes only `cancel` — the safety-improving op that stops a running publish. Submission verbs (`submit_item` / `submit_all` / `unpublish`) are intentionally CLI-only because publishing pushes content to Experience Edge and the consent model requires a token minted from a human-driven dry-run. Use `publish_inspect verb='list-running'` to find a jobId to cancel; cancellation is recoverable via resubmission.",
     // Brief (Content Operations)
     brief_inspect: "[unstable] Read-side Content Operations Brief surface over a discriminated { verb } input — `list` (briefs in tenant), `show` (one brief by id, with nested to-dos/comments/references), `types` (brief schema templates with field definitions and aiIntent hints), `todos` (across briefs or filtered by briefId), or `comments` (across briefs or filtered by briefId). 'Todo' is the Content Operations UI label for the Brief API's wire `tasks` resource. No writes; safe to call as part of plan assembly before any future brief_manage operation.",
-    brief_manage: "[unstable] Mutating Content Operations Brief surface over a discriminated { resource, verb } input. `resource: 'brief-type'` supports `create` (POST a new type from a full body), `update` (PUT-replace by id; no PATCH — read first if preserving fields), and `delete` (irreversible). `resource: 'brief'` supports `set-status` — move a brief to Draft | InReview | Approved | Canceled | Archived (a brief must leave Draft before it can be linked to a campaign) — and `delete` (irreversible; SDK `deleteBrief`). `resource: 'comment'` supports `create` — post a comment to a brief via `commentText` (UNVERIFIED: the write body is a best guess; smoke-test before relying on it). Requires allowWrite: true. Brief-type `name` must match /^[A-Za-z][A-Za-z0-9_]*$/. Brief `create` remains SDK/CLI-only.",
+    brief_manage: "[unstable] Mutating Content Operations Brief surface over a discriminated { resource, verb } input. `resource: 'brief-type'` supports `create` (POST a new type from a full body), `update` (PUT-replace by id; no PATCH — read first if preserving fields), and `delete` (irreversible). `resource: 'brief'` supports `create` (POST a new brief — needs `briefTypeId` plus a `brief` body of name/locale/fields/isTemplate), `update` (partial PUT by id — any subset of name/locale/fields/isTemplate plus an optional `status`), `set-status` — move a brief to Draft | InReview | Approved | Canceled | Archived (a brief must leave Draft before it can be linked to a campaign) — and `delete` (irreversible; SDK `deleteBrief`). `resource: 'comment'` supports `create` — post a comment to a brief via `commentText` (UNVERIFIED: the write body is a best guess; smoke-test before relying on it). Requires allowWrite: true. Brief-type `name` must match /^[A-Za-z][A-Za-z0-9_]*$/. For declarative, idempotent brief writes prefer brief_recipe_push.",
     // Campaign (Orchestrate)
     campaign_inspect: "[unstable] Read-side Orchestrate campaign surface over a discriminated { verb } input — `list` (campaigns in tenant), `show` (one campaign by id, with deliverables and tasks inline), `tasks` (tasks under a deliverable), `task` (one task by id), or `users` (the member directory that resolves the Auth0 subjects on members and assignees). A campaign is an Orchestrate `project`; projects own deliverables, deliverables own tasks. No writes.",
     campaign_manage: "[unstable] Mutating Orchestrate campaign surface over a discriminated { resource, verb } input — `resource: 'campaign'|'deliverable'` support verbs `create` and `delete`; `resource: 'task'` supports `create`, `update` (PUT full-replacement, no PATCH), and `delete`. Requires allowWrite: true. Deliverable/task writes need `campaignId` (and `deliverableId` for tasks); update/task-delete need `taskId`. The `delete` verb is irreversible and hits Orchestrate DELETE endpoints that were never captured during reverse-engineering — they are wired optimistically per REST conventions and remain UNVERIFIED; smoke-test before relying on them. Pass whatIf: true for a plan-only dry run.",
@@ -90,8 +90,8 @@ exports.TOOL_DESCRIPTIONS = {
     brand_review: "[unstable] Score content against a brand kit using AI. Returns an overall 1–5 score plus per-section + per-field breakdowns with explanations and improvement suggestions. The kit must already have populated sections — call brand_manage with action=seed (or pre-existing brand_inspect verb=list-sections on a populated kit) first. Headline agent-loop op for evaluating marketing copy, page content, or PR drafts; pair with the file path in `label` so SARIF / CI aggregators can attribute findings to source files.",
     brand_recipe_inspect: "[unstable] Read-side of the brand-kit recipe surface over a discriminated { verb } input. verb=pull captures a live brand kit as a declarative recipe (a clean, schema'd description — kit metadata plus section/field values, no server UUIDs). verb=diff compares a recipe against the live kit and returns the plan (create / update / noop changes). Both are read-only; neither writes. Use pull to snapshot a kit, diff to preview what a push would do.",
     brand_recipe_push: "[unstable] Converge a brand kit onto a declarative recipe. Computes the plan, then — unless whatIf — applies it: full orchestration via seedBrandKit (create → upload → publish → ingest → enrich) when the kit is absent, then per-field value convergence. Requires allowWrite: true to mutate; pass whatIf: true for a dry-run that returns the plan without writing. When the recipe carries documents for a not-yet-created kit, push triggers paid AI pipeline runs (~5–15 min).",
-    brief_recipe_inspect: "[unstable] Pull or diff a Sitecore Content Operations brief type as a declarative recipe. verb='pull' captures the live brief type named `name` as a clean recipe; verb='diff' compares a given recipe against the live type and returns the convergence plan. Read-only — neither verb writes.",
-    brief_recipe_push: "[unstable] Push a brief-type recipe — converge a Sitecore Content Operations brief type onto the given declarative recipe. Creates the brief type when absent or PUT-replaces it when present. Write tool: gated by `allowWrite`; pass `whatIf: true` for a dry-run that returns the plan without writing.",
+    brief_recipe_inspect: "[unstable] Pull or diff a Sitecore Content Operations brief type OR brief instance as a declarative recipe. `kind` discriminates: 'brief-type' (default — the schema template, identified by codename) or 'brief' (a populated brief instance, identified by display name; references its type by codename via `briefTypeName`). verb='pull' captures the live resource named `name` as a clean recipe; verb='diff' compares a given recipe against the live resource and returns the convergence plan. Read-only — neither verb writes.",
+    brief_recipe_push: "[unstable] Push a brief-type OR brief-instance recipe — converge the named Sitecore Content Operations resource onto the recipe. `kind: 'brief-type'` (default) creates the brief type when absent or PUT-replaces it when present. `kind: 'brief'` creates the brief when absent (resolving `briefTypeName` to its server id), or partial-PUT-updates it when present (refuses to repoint at a different brief type — the API has no verified path for that). Write tool: gated by `allowWrite`; pass `whatIf: true` for a dry-run that returns the plan without writing.",
     campaign_recipe_inspect: "[unstable] Pull or diff a Sitecore Orchestrate campaign as a declarative recipe. verb='pull' captures the live campaign named `campaignName` (its project, deliverables, and tasks) as a clean recipe with server ids dropped. verb='diff' compares a given recipe against the live campaign and returns the convergence plan. Neither verb writes.",
     campaign_recipe_push: "[unstable] Push a campaign recipe — converge a Sitecore Orchestrate campaign onto the recipe. Creates the campaign when absent, creates missing deliverables and tasks, and updates existing tasks. Additive: a recipe omitting a deliverable or task never removes it. Gated by `allowWrite`; `whatIf` returns the plan without writing.",
 };

package/dist/mcp/tools/brief-recipe.js

@@ -2,19 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerBriefRecipeTools = void 0;
 /**
- * Brief-type recipe surface — the MCP projection of the `brief-type`
- * recipe kind. Two workflow-shaped tools:
+ * Brief recipe surface — the MCP projection of both brief recipe kinds.
+ * Two workflow-shaped tools, each discriminating on `kind`:
  *
  *   - `brief_recipe_inspect` — read. `verb=pull` captures a live brief
- *     type as a declarative recipe; `verb=diff` plans the convergence of
- *     a brief type onto a given recipe. Neither writes.
+ *     type OR brief instance as a declarative recipe; `verb=diff` plans
+ *     the convergence of the named resource onto a given recipe.
  *
- *   - `brief_recipe_push` — write. Converges a brief type onto a recipe,
- *     gated by `allowWrite`; `whatIf` returns the plan without writing.
+ *   - `brief_recipe_push` — write. Converges a brief type or brief
+ *     instance onto a recipe, gated by `allowWrite`; `whatIf` returns
+ *     the plan without writing.
  *
- * The `recipe` input field IS `BriefTypeRecipeSchema` — the single
- * source of truth feeds the agent-facing tool surface for free. See
- * docs/recipe-sync-architecture.md.
+ * `kind: 'brief-type'` is the legacy default (kept for back-compat with
+ * the pre-instance surface). `kind: 'brief'` operates on populated
+ * brief instances. The matching recipe schema becomes the input shape
+ * for `recipe` automatically — the schema is the single source of truth.
+ *
+ * See docs/recipe-sync-architecture.md.
  */
 const zod_1 = require("zod");
 const recipe_1 = require("../../brief/recipe");
@@ -31,53 +35,81 @@ const planSummaryText = (plan) => {
     const tally = (0, sync_1.summarizePlan)(plan);
     return `Plan: ${tally.create} create, ${tally.update} update, ${tally.delete} delete, ${tally.noop} unchanged.`;
 };
+/** Map the MCP `kind` discriminator to the underlying `RecipeKind`. */
+const recipeKindFor = (kind) => {
+    const resolved = kind ?? "brief-type";
+    return resolved === "brief"
+        ? recipe_1.briefInstanceKind
+        : recipe_1.briefTypeKind;
+};
 const registerBriefRecipeTools = (registry) => {
     registry.registerTool({
         name: "brief_recipe_inspect",
         description: descriptions_1.TOOL_DESCRIPTIONS.brief_recipe_inspect,
         auth: "read",
         annotations: {
-            title: "Pull or diff a brief type as a declarative recipe",
+            title: "Pull or diff a brief type or brief instance as a declarative recipe",
             readOnlyHint: true,
             destructiveHint: false,
             openWorldHint: true,
         },
         inputSchema: {
+            kind: zod_1.z
+                .enum(["brief-type", "brief"])
+                .default("brief-type")
+                .describe("Which recipe kind to operate on. 'brief-type' (default — the schema template) or 'brief' (a populated brief instance)."),
             verb: zod_1.z
                 .enum(["pull", "diff"])
-                .describe("pull: capture the live brief type named `name` as a recipe. diff: compare `recipe` against the live brief type and return the plan."),
-            name: zod_1.z.string().optional().describe("Brief type codename. Required for verb='pull'."),
-            recipe: recipe_1.briefTypeKind.schema
+                .describe("pull: capture the live resource named `name` as a recipe. diff: compare `recipe` against the live resource and return the plan."),
+            name: zod_1.z
+                .string()
+                .optional()
+                .describe("Brief-type codename or brief display name. Required for verb='pull'."),
+            recipe: zod_1.z
+                .union([recipe_1.briefTypeKind.schema, recipe_1.briefInstanceKind.schema])
                 .optional()
-                .describe("A brief-type recipe. Required for verb='diff'."),
+                .describe("A brief-type recipe or brief-instance recipe (matching `kind`). Required for verb='diff'."),
             ...common_1.environmentBindingShape,
         },
         handler: async (input, context) => {
             const ctx = syncContextFrom(context, input.environmentName);
+            const kind = recipeKindFor(input.kind);
+            const humanKind = input.kind === "brief" ? "brief" : "brief type";
             if (input.verb === "pull") {
                 if (!input.name) {
                     throw (0, errors_1.createScaiError)("verb='pull' requires `name`.", "INPUT_INVALID");
                 }
-                const recipe = await (0, sync_1.syncPull)(recipe_1.briefTypeKind, { kind: recipe_1.briefTypeKind.name, id: input.name }, ctx);
+                const recipe = await (0, sync_1.syncPull)(kind, { kind: kind.name, id: input.name }, ctx);
                 return {
                     content: [
                         {
                             type: "text",
                             text: recipe
-                                ? `Captured "${input.name}" as a recipe.`
-                                : `No brief type named "${input.name}".`,
+                                ? `Captured ${humanKind} "${input.name}" as a recipe.`
+                                : `No ${humanKind} named "${input.name}".`,
                         },
                     ],
-                    structuredContent: { verb: input.verb, found: recipe !== null, recipe },
+                    structuredContent: {
+                        kind: input.kind ?? "brief-type",
+                        verb: input.verb,
+                        found: recipe !== null,
+                        recipe,
+                    },
                 };
             }
             if (!input.recipe) {
                 throw (0, errors_1.createScaiError)("verb='diff' requires `recipe`.", "INPUT_INVALID");
             }
-            const plan = await (0, sync_1.syncDiff)(recipe_1.briefTypeKind, input.recipe, { kind: recipe_1.briefTypeKind.name, id: input.recipe.name }, ctx);
+            const recipe = input.recipe;
+            const plan = await (0, sync_1.syncDiff)(kind, recipe, { kind: kind.name, id: recipe.name }, ctx);
             return {
                 content: [{ type: "text", text: planSummaryText(plan) }],
-                structuredContent: { verb: input.verb, plan, summary: (0, sync_1.summarizePlan)(plan) },
+                structuredContent: {
+                    kind: input.kind ?? "brief-type",
+                    verb: input.verb,
+                    plan,
+                    summary: (0, sync_1.summarizePlan)(plan),
+                },
             };
         },
     });
@@ -86,13 +118,19 @@ const registerBriefRecipeTools = (registry) => {
         description: descriptions_1.TOOL_DESCRIPTIONS.brief_recipe_push,
         auth: "write",
         annotations: {
-            title: "Push a brief-type recipe — converge the type onto the recipe",
+            title: "Push a brief-type or brief recipe — converge the resource onto the recipe",
             readOnlyHint: false,
             destructiveHint: true,
             openWorldHint: true,
         },
         inputSchema: {
-            recipe: recipe_1.briefTypeKind.schema.describe("The brief-type recipe to converge onto. The brief type is identified by `recipe.name`."),
+            kind: zod_1.z
+                .enum(["brief-type", "brief"])
+                .default("brief-type")
+                .describe("Which recipe kind to push. 'brief-type' (default — the schema template) or 'brief' (a populated brief instance)."),
+            recipe: zod_1.z
+                .union([recipe_1.briefTypeKind.schema, recipe_1.briefInstanceKind.schema])
+                .describe("The recipe to converge onto. Schema must match `kind`. The resource is identified by `recipe.name`."),
             prune: zod_1.z
                 .boolean()
                 .default(false)
@@ -103,14 +141,20 @@ const registerBriefRecipeTools = (registry) => {
         },
         handler: async (input, context, extra) => {
             const ctx = syncContextFrom(context, input.environmentName, extra.signal);
+            const kind = recipeKindFor(input.kind);
+            const recipe = input.recipe;
             const mode = input.whatIf ? "what-if" : "apply";
-            const outcome = await (0, sync_1.syncPush)(recipe_1.briefTypeKind, input.recipe, { kind: recipe_1.briefTypeKind.name, id: input.recipe.name }, ctx, { mode, prune: input.prune });
+            const outcome = await (0, sync_1.syncPush)(kind, recipe, { kind: kind.name, id: recipe.name }, ctx, {
+                mode,
+                prune: input.prune,
+            });
             const text = outcome.result
                 ? `Applied ${outcome.result.applied.length} change(s); ${outcome.result.skipped.length} skipped.`
                 : planSummaryText(outcome.plan);
             return {
                 content: [{ type: "text", text }],
                 structuredContent: {
+                    kind: input.kind ?? "brief-type",
                     mode,
                     plan: outcome.plan,
                     summary: (0, sync_1.summarizePlan)(outcome.plan),