@amityco/social-plus-vise 0.14.25 → 0.14.26

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to `@amityco/social-plus-vise` are documented in this file.
 
 The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.14.26 — 2026-06-06
+
+### Added
+- **Creative selection bridge:** `vise creative accept --variant <id>` / MCP `creative_accept` now persists `sp-vise/creative-selection.json` from a chosen creative brief candidate.
+- **Plan/init/workplan feed-forward:** matching `vise plan`, `vise init`, and `vise workplan next/status` runs now read accepted creative selections, add a `creativeContext` block, prepend a selected-variant implementation step, mirror the selection into `sp-vise/intake.json`, and derive multi-surface workplan order from selected experience objects.
+
+### Verified
+- Expanded `test:creative` to cover creative accept, selection sidecar writes, plan feed-forward, creative-derived workplan ordering, init sidecar mirroring, and MCP `creative_accept` smoke coverage.
+
 ## 0.14.25 — 2026-06-06
 
 ### Added

package/README.md

@@ -83,7 +83,7 @@ Correctness is gated by deterministic rules or attestations. Baseline completene
 
 ### Engagement Intelligence roadmap
 
-Vise's next architecture track is the social.plus **Engagement Intelligence System**: an outcome-to-experience layer that maps customer goals, archetypes, solution patterns, experience objects, UX patterns, and variants before normal implementation planning. The first advisory runtime slice is `vise creative`: it consumes a request plus optional requirements/prototype inputs, or runs in exploratory mode when requirements are absent, then writes a local creative brief for user variant selection. See [docs/ENGAGEMENT_INTELLIGENCE_SYSTEM.md](docs/ENGAGEMENT_INTELLIGENCE_SYSTEM.md), [docs/MONOREPO_ARCHITECTURE.md](docs/MONOREPO_ARCHITECTURE.md), and [packages/intelligence](packages/intelligence).
+Vise's next architecture track is the social.plus **Engagement Intelligence System**: an outcome-to-experience layer that maps customer goals, archetypes, solution patterns, experience objects, UX patterns, and variants before normal implementation planning. The first advisory runtime slice is `vise creative`: it consumes a request plus optional requirements/prototype inputs, or runs in exploratory mode when requirements are absent, writes a local creative brief for user variant selection, and records the accepted variant so `vise plan`, `vise init`, and `vise workplan` can carry that product/UX direction forward. See [docs/ENGAGEMENT_INTELLIGENCE_SYSTEM.md](docs/ENGAGEMENT_INTELLIGENCE_SYSTEM.md), [docs/MONOREPO_ARCHITECTURE.md](docs/MONOREPO_ARCHITECTURE.md), and [packages/intelligence](packages/intelligence).
 
 ### Relationship to social.plus Block Factory
 
@@ -165,11 +165,12 @@ Aggregate: **98/99 expected feed capabilities** and **27/27 selected optional ca
 
 ### Current Release Validation
 
-Version 0.14.25 carries current release proof around the full feed-forward, product-expectation, creative pre-planning, and validation flow:
+Version 0.14.26 carries current release proof around the full feed-forward, product-expectation, creative pre-planning, and validation flow:
 
 | Surface | What was validated |
 |---|---|
 | **Creative pre-planning** | `vise creative` produces requirements-driven or exploratory Engagement Intelligence briefs, writes `sp-vise/creative-brief.json` / `.md`, asks for `preferred_solution`, and survives packed-package installation with the intelligence catalog bundled. |
+| **Creative selection bridge** | `vise creative accept --variant <id>` writes `sp-vise/creative-selection.json`; matching `vise plan`, `vise init`, and `vise workplan next` runs surface the accepted variant, derive workplan surfaces from its experience objects, and mirror the selection into `sp-vise/intake.json`. |
 | **Product flow** | Local end-to-end smoke covers design extraction, plan feed-forward, blocking intake, answered init, capability check, design conformance, and sensor discovery. |
 | **Multi-surface planning** | Broad social requests are decomposed into a `socialWorkplan` sequence for feed, comments, chat, and profile work instead of forcing a single top-level surface choice. `vise workplan next` tells the host agent which surface to implement next, and `vise workplan complete` records green-check progress in `sp-vise/workplan.json` with per-surface snapshots under `sp-vise/workplan-snapshots/<surface>/`. |
 | **Plan questions** | Plans surface blocking questions such as `design_contract_confirmation`, product-scope questions such as `feed_post_type_scope`, `feed_composer_type_scope`, `comment_tray_scope`, `chat_inbox_scope`, and `profile_identity_scope`, plus optional choices such as `feed_optional_capabilities`. Focused plans still accept `feature_surface` answers when the agent is ready to implement one surface. |
@@ -304,6 +305,7 @@ The flow above is what the skill teaches your AI agent. You — the human — dr
 | `vise doctor` | Verify install; print version, install path, docs source |
 | `vise inspect [path]` | Detect platform, monorepo surfaces, design signals, available sensors |
 | `vise creative [path] --request "..." [--requirements <path\|none>] [--prototype <html>]` | Produce an advisory Engagement Intelligence brief with 2-3 solution variants before normal implementation planning; writes `sp-vise/creative-brief.json` and `.md` unless `--no-write` is set |
+| `vise creative accept [path] --variant <id>` | Accept a creative variant and write `sp-vise/creative-selection.json` so subsequent `plan`, `init`, and `workplan` runs include the selected product/UX direction |
 | `vise plan [path] --request "..."` | Produce a grounded implementation plan with intake questions and docs citations |
 | `vise plan-harness [path] --request "..."` | (Pre-planning step) Build the harness around the request |
 | `vise workplan next [path] --request "..."` | For broad social requests, print the next uncompleted surface plus focused `plan` / `init` / verification commands |
@@ -408,7 +410,7 @@ MCP-capable hosts can call Vise as structured tool calls instead of shell comman
 
 ### Tool names (snake_case per MCP convention)
 
-`inspect_project`, `creative_brief`, `plan_harness`, `plan_integration`, `init_compliance`, `check_compliance`, `sync_compliance`, `attest_rule`, `explain_rule`, `init_engagement`, `show_engagement`, `resolve_request`, `search_docs`, `get_doc_page`, `debug_issue`, `validate_setup`, `run_sensors`, `suggest_patch`, `design_extract`, `design_check`, `design_preview`, `design_reference`, `design_init_tokens`.
+`inspect_project`, `creative_brief`, `creative_accept`, `plan_harness`, `plan_integration`, `init_compliance`, `check_compliance`, `sync_compliance`, `attest_rule`, `explain_rule`, `init_engagement`, `show_engagement`, `resolve_request`, `search_docs`, `get_doc_page`, `debug_issue`, `validate_setup`, `run_sensors`, `suggest_patch`, `design_extract`, `design_check`, `design_preview`, `design_reference`, `design_init_tokens`.
 
 These are the same operations as the CLI commands above, exposed as MCP tools.
 
@@ -461,9 +463,10 @@ Vise writes local planning, compliance, design, and evidence artifacts under `sp
 | File | Created by | What it contains |
 |---|---|---|
 | `sp-vise/compliance.json` | `vise init` | The rules selected for this integration, the Vise version, the ruleset digest, the target app surface, selected optional capabilities, optional engagement link, and an accepted design-contract digest when confirmed. |
-| `sp-vise/intake.json` | `vise init` | The request, outcome, intake answers, remaining blocking count, design-review status (`absent`, `needs-confirmation`, `accepted`, or `rejected`), and any retrospective `--allow-unresolved-intake` acknowledgement. |
+| `sp-vise/intake.json` | `vise init` | The request, outcome, intake answers, remaining blocking count, optional creative-selection mirror, design-review status (`absent`, `needs-confirmation`, `accepted`, or `rejected`), and any retrospective `--allow-unresolved-intake` acknowledgement. |
 | `sp-vise/creative-brief.json` | `vise creative` | Advisory Engagement Intelligence brief: mode, objective, inferred goals/archetypes, candidate solution variants, feasibility summary, preferred-solution question, and next plan/workplan commands. |
 | `sp-vise/creative-brief.md` | `vise creative` | Human-readable version of the creative brief for review with the user before selecting a variant. |
+| `sp-vise/creative-selection.json` | `vise creative accept` | Accepted creative variant: source brief, selected goals/archetypes/patterns/objects/UX patterns, surface hints, feasibility notes, and plan/workplan feed-forward context. |
 | `sp-vise/attestations/*.json` | `vise sync` (deterministic) or `vise attest` (host-agent / human) | Per-rule evidence: signer, confidence, rationale, cited files (with source fingerprints for drift detection). |
 | `sp-vise/inspection.json` | `vise init` | The platform, monorepo surface, and design-token signals detected at init time. |
 | `sp-vise/workplan.json` | `vise workplan complete` | Local progress for broad social workplans: request, completed surface IDs, outcomes, timestamps, green-check evidence, snapshot paths, and optional host-agent notes. |

package/dist/server.js

@@ -17,13 +17,14 @@ import { runSensorsTool } from "./tools/sensors.js";
 import { getSdkFactsTool } from "./tools/sdkFacts.js";
 import { addBlockInstall, listRegistryBlocks, planBlockInstall, validateBlockInstall } from "./tools/blocks.js";
 import { debugIssueTool, debugIssue } from "./tools/debug.js";
-import { creativeBriefTool } from "./tools/creative.js";
+import { creativeAcceptTool, creativeBriefTool } from "./tools/creative.js";
 import { packageName, packageVersion } from "./version.js";
 const tools = new Map([
     searchDocsTool,
     getDocPageTool,
     inspectProjectTool,
     creativeBriefTool,
+    creativeAcceptTool,
     planHarnessTool,
     planIntegrationTool,
     initComplianceTool,
@@ -137,6 +138,16 @@ async function handleCli(args) {
             return "exit";
         }
         if (command === "creative") {
+            if (args[1] === "accept") {
+                const subArgs = args.slice(2);
+                assertOnlyKnownFlags(subArgs, ["variant", "brief", "brief-path"], "creative accept");
+                await printToolResult(creativeAcceptTool, {
+                    repoPath: positionalRepoPath(subArgs),
+                    variantId: requiredFlagValue(subArgs, "variant", "creative accept requires --variant <id>."),
+                    briefPath: flagValue(subArgs, "brief") ?? flagValue(subArgs, "brief-path"),
+                });
+                return "exit";
+            }
             assertOnlyKnownFlags(args, ["request", "requirements", "prototype", "surface", "surface-path", "no-requirements", "no-write"], "creative");
             if (hasFlag(args, "no-requirements") && flagValue(args, "requirements")) {
                 throw new Error("creative accepts either --requirements <path> or --no-requirements, not both.");
@@ -480,10 +491,12 @@ Usage:
   vise creative [repoPath] --request "Add engagement" --no-requirements
   vise creative [repoPath] --request "Add engagement" --prototype ./prototype.html
   vise creative [repoPath] --request "Add engagement" --no-write
+  vise creative accept [repoPath] --variant community-first
 
 Output:
   Writes sp-vise/creative-brief.json and sp-vise/creative-brief.md unless --no-write is set.
-  Requirements are optional; absence or explicit none switches creative mode to exploratory.`;
+  Requirements are optional; absence or explicit none switches creative mode to exploratory.
+  creative accept writes sp-vise/creative-selection.json for plan/init/workplan feed-forward.`;
     }
     if (command === "plan-harness") {
         return `${packageName} plan-harness
@@ -732,6 +745,7 @@ Usage:
   vise print-skill                 Print bundled skill markdown
   vise inspect [repoPath]          Inspect platform and design signals
   vise creative [repoPath] --request "..." Create an Engagement Intelligence brief
+  vise creative accept [repoPath] --variant <id> Accept a creative variant
   vise debug [repoPath] --error ... Debug an SDK-specific runtime error and emit a repair brief
   vise plan [repoPath] --request "..." Create an implementation plan
   vise workplan next [repoPath] --request "..." Get the next broad-social surface to implement
@@ -1006,6 +1020,7 @@ async function workplanStatus(args) {
         status: nextSurface ? "next-surface" : "complete",
         request,
         progressPath: workplanProgressPath(repoRoot),
+        creativeContext: plan.socialWorkplan?.creativeContext ?? plan.creativeContext,
         completed,
         sequence: sequence.map((surface) => ({
             id: surface.id,
@@ -1207,7 +1222,7 @@ function ciCheckResult(result) {
     };
 }
 function positionalRepoPath(args) {
-    const flagsWithValues = new Set(["request", "requirements", "prototype", "surface", "surface-path", "platform", "capability", "surface-dir", "format", "include", "timeout-ms", "query", "path", "limit", "answer", "target", "dest", "destination", "rule", "confidence", "signer", "identity", "evidence-file", "rationale", "repo", "reference", "registry", "block", "package-source", "note"]);
+    const flagsWithValues = new Set(["request", "requirements", "prototype", "variant", "brief", "brief-path", "surface", "surface-path", "platform", "capability", "surface-dir", "format", "include", "timeout-ms", "query", "path", "limit", "answer", "target", "dest", "destination", "rule", "confidence", "signer", "identity", "evidence-file", "rationale", "repo", "reference", "registry", "block", "package-source", "note"]);
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
         if (!arg) {
@@ -1229,7 +1244,7 @@ function positionalRepoPath(args) {
 }
 function requiredPositionalText(args, message) {
     const values = [];
-    const flagsWithValues = new Set(["request", "requirements", "prototype", "surface", "surface-path", "platform", "capability", "surface-dir", "format", "include", "timeout-ms", "query", "path", "limit", "answer", "target", "dest", "destination", "rule", "confidence", "signer", "identity", "evidence-file", "rationale", "repo", "reference", "registry", "block", "package-source", "note"]);
+    const flagsWithValues = new Set(["request", "requirements", "prototype", "variant", "brief", "brief-path", "surface", "surface-path", "platform", "capability", "surface-dir", "format", "include", "timeout-ms", "query", "path", "limit", "answer", "target", "dest", "destination", "rule", "confidence", "signer", "identity", "evidence-file", "rationale", "repo", "reference", "registry", "block", "package-source", "note"]);
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
         if (!arg) {

package/dist/tools/compliance.js

@@ -9,6 +9,7 @@ import { objectInput, optionalBooleanField, optionalStringField, stringField, te
 import { packageVersion } from "../version.js";
 import { DESIGN_CONTRACT_CONFIRMATION_ANSWER_ID, buildDesignBrief, designContractConfirmationFromAnswers, designPreviewPath, readDesignContract, } from "./design.js";
 import { inspectProject, validateSetup } from "./project.js";
+import { readCreativeSelection } from "./creative.js";
 const complianceDirName = "sp-vise";
 const attestationsDirName = "attestations";
 const schemaVersion = 1;
@@ -298,6 +299,10 @@ export async function initCompliance(repoPath, request, surfacePath, answers = {
     const designContract = await readDesignContract(repoRoot);
     const designReview = designReviewFor(repoRoot, designContract, answers);
     const acceptedDesignContract = designReview.status === "accepted" ? designContract : null;
+    const storedCreativeSelection = await readCreativeSelection(repoRoot);
+    const creativeSelection = storedCreativeSelection && creativeSelectionAppliesToRequest(storedCreativeSelection, request)
+        ? storedCreativeSelection
+        : undefined;
     const intake = intakeAuditFor({
         request,
         outcome,
@@ -346,6 +351,7 @@ export async function initCompliance(repoPath, request, surfacePath, answers = {
         generated_at: compliance.generated_at,
         request,
         outcome,
+        ...(creativeSelection ? { creative_selection: creativeSelectionSummary(creativeSelection) } : {}),
         design_review: designReview,
         ...intake,
     });
@@ -373,6 +379,7 @@ export async function initCompliance(repoPath, request, surfacePath, answers = {
         surfacePath: inspection.selectedSurface?.path,
         rules: refs.length,
         engagement_id: engagement?.engagement_id,
+        ...(creativeSelection ? { creative_selection: creativeSelectionSummary(creativeSelection) } : {}),
         ...(compliance.design_contract && { design_contract: compliance.design_contract }),
         ...(selectedOptionalCapabilities.length > 0 && { selected_optional_capabilities: selectedOptionalCapabilities }),
         intake: {
@@ -469,6 +476,41 @@ function intakeAuditFor(args) {
         acknowledged_unresolved_blocking: args.allowUnresolvedIntake && remainingBlocking > 0,
     };
 }
+function creativeSelectionSummary(selection) {
+    return {
+        status: selection.status,
+        selection_path: "sp-vise/creative-selection.json",
+        source_brief: selection.source.brief,
+        mode: selection.source.mode,
+        original_request: selection.source.request,
+        plan_request: selection.implementationContext.planRequest,
+        selected_variant: {
+            id: selection.selectedVariant.id,
+            title: selection.selectedVariant.title,
+            businessGoalIds: selection.selectedVariant.businessGoalIds,
+            archetypeIds: selection.selectedVariant.archetypeIds,
+            solutionPatternIds: selection.selectedVariant.solutionPatternIds,
+            experienceObjectIds: selection.selectedVariant.experienceObjectIds,
+            uxPatternIds: selection.selectedVariant.uxPatternIds,
+            feasibilitySupport: selection.selectedVariant.feasibility.support,
+        },
+    };
+}
+function creativeSelectionAppliesToRequest(selection, request) {
+    const normalizedRequest = normalizeCreativeRequest(request);
+    const original = normalizeCreativeRequest(selection.source.request);
+    const planRequest = normalizeCreativeRequest(selection.implementationContext.planRequest);
+    if (!normalizedRequest || !original) {
+        return false;
+    }
+    return (normalizedRequest === original ||
+        normalizedRequest === planRequest ||
+        normalizedRequest.includes(original) ||
+        original.includes(normalizedRequest));
+}
+function normalizeCreativeRequest(value) {
+    return value.toLowerCase().replace(/[^a-z0-9\s]+/g, " ").replace(/\s+/g, " ").trim();
+}
 function preferredPlatform(platforms) {
     const order = ["flutter", "android", "typescript", "react-native", "ios"];
     return order.find((platform) => platforms.includes(platform)) ?? platforms[0] ?? "unknown";

package/dist/tools/creative.js

@@ -6,8 +6,10 @@ import { objectInput, optionalBooleanField, optionalStringField, stringField, te
 import { packageVersion } from "../version.js";
 import { inspectProject } from "./project.js";
 const CREATIVE_SCHEMA_VERSION = "2026-06-06.vise-creative.v1";
+const CREATIVE_SELECTION_SCHEMA_VERSION = "2026-06-06.vise-creative-selection.v1";
 const BRIEF_JSON = "creative-brief.json";
 const BRIEF_MD = "creative-brief.md";
+const SELECTION_JSON = "creative-selection.json";
 export const creativeBriefTool = {
     name: "creative_brief",
     description: "Create an advisory Engagement Intelligence brief before normal Vise planning. Supports optional requirements and prototype inputs, or exploratory mode when requirements are absent.",
@@ -54,6 +56,42 @@ export const creativeBriefTool = {
         }));
     },
 };
+export const creativeAcceptTool = {
+    name: "creative_accept",
+    description: "Accept a candidate from sp-vise/creative-brief.json and persist sp-vise/creative-selection.json for plan/init/workplan feed-forward.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            repoPath: {
+                type: "string",
+                description: "Absolute or relative path to the customer repository root.",
+            },
+            variantId: {
+                type: "string",
+                description: "Candidate variant id from creative_brief.candidateSolutions.",
+            },
+            briefPath: {
+                type: "string",
+                description: "Optional path to a creative brief JSON file. Defaults to sp-vise/creative-brief.json under repoPath.",
+            },
+            write: {
+                type: "boolean",
+                description: "Whether to write sp-vise/creative-selection.json. Defaults to true.",
+            },
+        },
+        required: ["repoPath", "variantId"],
+        additionalProperties: false,
+    },
+    async call(input) {
+        const args = objectInput(input);
+        return textResult(await acceptCreativeVariant({
+            repoPath: stringField(args, "repoPath"),
+            variantId: stringField(args, "variantId"),
+            briefPath: optionalStringField(args, "briefPath"),
+            write: optionalBooleanField(args, "write", true),
+        }));
+    },
+};
 export async function buildCreativeBrief(options) {
     const repoRoot = path.resolve(options.repoPath);
     const request = options.request.trim();
@@ -108,6 +146,71 @@ export async function buildCreativeBrief(options) {
     }
     return brief;
 }
+export async function acceptCreativeVariant(options) {
+    const repoRoot = path.resolve(options.repoPath);
+    const briefPath = creativeBriefPath(repoRoot, options.briefPath);
+    const brief = await readCreativeBrief(repoRoot, options.briefPath);
+    const variantId = options.variantId.trim();
+    if (!variantId) {
+        throw new Error("creative accept requires a non-empty variant id.");
+    }
+    const selected = brief.candidateSolutions.find((candidate) => candidate.id === variantId);
+    if (!selected) {
+        throw new Error(`Creative variant "${variantId}" was not found in ${repoRelativePath(repoRoot, briefPath)}. Available variants: ${brief.candidateSolutions.map((candidate) => candidate.id).join(", ") || "(none)"}.`);
+    }
+    const selection = {
+        schema_version: CREATIVE_SELECTION_SCHEMA_VERSION,
+        vise_version: packageVersion,
+        status: "accepted",
+        selected_at: new Date().toISOString(),
+        source: {
+            brief: repoRelativePath(repoRoot, briefPath),
+            brief_schema_version: brief.schema_version,
+            brief_generated_at: brief.generated_at,
+            mode: brief.mode,
+            request: brief.request,
+        },
+        objective: brief.objective,
+        selectedVariant: selected,
+        implementationContext: {
+            planRequest: `${selected.title}: ${brief.request}`,
+            surfaceHints: creativeSurfaceHints(selected),
+            designPatternIds: selected.uxPatternIds,
+            capabilityNotes: selected.feasibility.notes,
+        },
+        nextStep: "Run `vise plan . --request <original request>` or `vise workplan next . --request <original request>`; Vise will include this accepted creative selection as advisory implementation context.",
+    };
+    if (options.write !== false) {
+        selection.artifacts = await writeCreativeSelection(repoRoot, selection);
+    }
+    return selection;
+}
+export async function readCreativeSelection(repoRootOrPath) {
+    const repoRoot = path.resolve(repoRootOrPath);
+    try {
+        return JSON.parse(await readFile(path.join(repoRoot, "sp-vise", SELECTION_JSON), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function creativeSurfaceHints(candidateOrSelection) {
+    const candidate = "selectedVariant" in candidateOrSelection ? candidateOrSelection.selectedVariant : candidateOrSelection;
+    const hints = [];
+    const seen = new Set();
+    for (const objectId of candidate.experienceObjectIds) {
+        const hint = CREATIVE_SURFACE_HINTS.find((item) => item.objectIds.includes(objectId));
+        if (!hint || seen.has(hint.id)) {
+            continue;
+        }
+        seen.add(hint.id);
+        hints.push({
+            ...hint,
+            reason: `Selected variant "${candidate.title}" includes experience object "${objectId}".`,
+        });
+    }
+    return hints;
+}
 async function loadCatalog() {
     const root = catalogRoot();
     const [businessGoals, archetypes, experienceObjects, solutionPatterns, uxPatterns, variants] = await Promise.all([
@@ -127,6 +230,32 @@ async function loadCatalog() {
         variants: variants.items,
     };
 }
+async function readCreativeBrief(repoRoot, inputPath) {
+    const filePath = creativeBriefPath(repoRoot, inputPath);
+    try {
+        return JSON.parse(await readFile(filePath, "utf8"));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Unable to read creative brief at ${repoRelativePath(repoRoot, filePath)}. Run \`vise creative . --request "..."\` first. ${detail}`);
+    }
+}
+function creativeBriefPath(repoRoot, inputPath) {
+    if (inputPath) {
+        return path.isAbsolute(inputPath) ? inputPath : path.resolve(repoRoot, inputPath);
+    }
+    return path.join(repoRoot, "sp-vise", BRIEF_JSON);
+}
+async function writeCreativeSelection(repoRoot, selection) {
+    const sidecarDir = path.join(repoRoot, "sp-vise");
+    await mkdir(sidecarDir, { recursive: true });
+    const jsonPath = path.join(sidecarDir, SELECTION_JSON);
+    const withoutArtifacts = { ...selection, artifacts: undefined };
+    await writeFile(jsonPath, `${JSON.stringify(withoutArtifacts, null, 2)}\n`, "utf8");
+    return {
+        json: repoRelativePath(repoRoot, jsonPath),
+    };
+}
 async function loadCatalogFile(root, fileName) {
     const filePath = path.join(root, fileName);
     try {
@@ -505,6 +634,50 @@ function repoRelativePath(repoRoot, filePath) {
     return path.relative(repoRoot, filePath).split(path.sep).join("/");
 }
 const SOCIAL_PLUS_OBJECTS = new Set(["feed", "comment", "forum", "community", "creator", "profile", "chat", "story", "livestream", "event", "rsvp", "notification"]);
+const CREATIVE_SURFACE_HINTS = [
+    {
+        id: "feed",
+        outcome: "add-feed",
+        label: "Feed and content surface",
+        objectIds: ["feed", "story", "livestream"],
+        reason: "",
+    },
+    {
+        id: "comments",
+        outcome: "add-comments",
+        label: "Comments and replies",
+        objectIds: ["comment"],
+        reason: "",
+    },
+    {
+        id: "chat",
+        outcome: "add-chat",
+        label: "Chat inbox and threads",
+        objectIds: ["chat"],
+        reason: "",
+    },
+    {
+        id: "profile",
+        outcome: "add-follow",
+        label: "Profile and relationship graph",
+        objectIds: ["profile", "creator"],
+        reason: "",
+    },
+    {
+        id: "community",
+        outcome: "add-community",
+        label: "Community management and identity",
+        objectIds: ["community", "forum"],
+        reason: "",
+    },
+    {
+        id: "notifications",
+        outcome: "add-notifications",
+        label: "Notifications and activation",
+        objectIds: ["notification", "event", "rsvp"],
+        reason: "",
+    },
+];
 const GOAL_KEYWORDS = {
     retention: ["retention", "retain", "return", "repeat", "habit", "stickiness", "come back", "daily active", "weekly active"],
     participation: ["participation", "participate", "engagement", "social", "comment", "reply", "post", "active", "contribute"],

package/dist/tools/integration.js

@@ -8,6 +8,7 @@ import { DESIGN_CONTRACT_CONFIRMATION_ANSWER_ID, buildDesignBrief, designContrac
 import { sdkVersionGuidance } from "./sdkVersion.js";
 import { detectCommandSensors } from "./harness.js";
 import { inspectProject } from "./project.js";
+import { creativeSurfaceHints, readCreativeSelection } from "./creative.js";
 export const planIntegrationTool = {
     name: "plan_integration",
     description: "Create a grounded, evidence-backed implementation packet before an AI coding agent edits a customer project.",
@@ -58,6 +59,11 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
     const repoRoot = path.resolve(repoPath);
     const inspection = await inspectProject(repoRoot, surfacePath);
     const root = inspection.effectiveRoot;
+    const storedCreativeSelection = await readCreativeSelection(repoRoot);
+    const creativeSelection = storedCreativeSelection && creativeSelectionAppliesToRequest(storedCreativeSelection, request)
+        ? storedCreativeSelection
+        : undefined;
+    const creativeContext = creativeSelection ? creativeContextForPlan(creativeSelection) : undefined;
     const outcome = resolveOutcome(request, answers);
     const platform = preferredPlatform(inspection.platforms);
     const supportLevel = supportFor(outcome, platform);
@@ -89,6 +95,7 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
         platform,
         platforms: inspection.platforms,
         designSignals: inspection.designSignals,
+        creativeSelection,
         designBrief,
         designReview,
         sensors,
@@ -109,9 +116,16 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
     // reviewable choice rather than a silent drop. Mirrors the detailed `intake`
     // block below; placed here because the intake block lands past common `head`
     // cut points.
-    const decisionsRequired = intake.questions.map((q) => q.blocksImplementationWhenMissing
-        ? `[resolve before building] ${q.question}`
-        : `[decide & state in your summary] ${q.question}`);
+    const decisionsRequired = [
+        ...(creativeContext
+            ? [
+                `[selected creative variant] Carry "${creativeContext.selectedVariant.title}" into the implementation plan. If any selected experience object is intentionally deferred, state that scope decision explicitly.`,
+            ]
+            : []),
+        ...intake.questions.map((q) => q.blocksImplementationWhenMissing
+            ? `[resolve before building] ${q.question}`
+            : `[decide & state in your summary] ${q.question}`),
+    ];
     // Steps-first ordering: implementationSteps + validation lead the object so
     // that an agent piping `vise plan` through `head` still captures the
     // actionable guidance. The verbose scaffolding (intake, docs, surfaces, rule
@@ -122,16 +136,20 @@ async function buildIntegrationPlan(repoPath, request, surfacePath, answers = {}
         platform,
         supportLevel,
         intent: intentFor(request, definition.interpretation),
+        creativeContext,
         socialWorkplan,
         capabilityAvailability,
         designReview,
         decisionsRequired,
-        implementationSteps: definition.implementationSteps(ctx),
+        implementationSteps: [...creativeImplementationSteps(creativeSelection), ...definition.implementationSteps(ctx)],
         validation: ["validate_setup", "run_sensors", ...definition.validation(platform)],
         nextStep: "After implementing every step above, run `vise check .` and fix findings until green. You are not done until the check passes or each finding is explicitly attested.",
         requiredInputs: composeRequiredInputs(ctx, definition.requiredInputs(ctx)),
         targetFiles: await targetFilesFor(root, outcome, platform, inspection.designSignals),
-        implementationRules: composeImplementationRules(ctx, definition.implementationRules(ctx)),
+        implementationRules: [
+            ...composeImplementationRules(ctx, definition.implementationRules(ctx)),
+            ...creativeImplementationRules(creativeSelection),
+        ],
         intake,
         docs: definition.docs(platform).filter((doc) => doc.path !== "unknown"),
         surface: inspection.selectedSurface ? { path: inspection.selectedSurface.path, platforms: inspection.selectedSurface.platforms } : undefined,
@@ -177,6 +195,79 @@ function optionalCapabilitiesFor(outcome, answers, request, availability) {
         selected: selectedOptionalCapabilityIds(outcome, answers, request, availableIds),
     };
 }
+function creativeContextForPlan(selection) {
+    const selectedVariant = selection.selectedVariant;
+    const surfaceHints = creativeSurfaceHints(selection);
+    const customObjects = selectedVariant.feasibility.customObjectIds;
+    return {
+        status: "accepted",
+        selectionPath: "sp-vise/creative-selection.json",
+        sourceBrief: selection.source.brief,
+        mode: selection.source.mode,
+        originalRequest: selection.source.request,
+        selectedVariant: {
+            id: selectedVariant.id,
+            title: selectedVariant.title,
+            confidence: selectedVariant.confidence,
+            businessGoalIds: selectedVariant.businessGoalIds,
+            archetypeIds: selectedVariant.archetypeIds,
+            solutionPatternIds: selectedVariant.solutionPatternIds,
+            experienceObjectIds: selectedVariant.experienceObjectIds,
+            uxPatternIds: selectedVariant.uxPatternIds,
+            feasibilitySupport: selectedVariant.feasibility.support,
+        },
+        objective: selection.objective,
+        surfaceHints,
+        implementationGuidance: [
+            `Use "${selectedVariant.title}" as the product and UX direction selected by the user before implementation.`,
+            `Preserve UX pattern(s): ${selectedVariant.uxPatternIds.join(", ") || "(none)"}.`,
+            `Prioritize experience object(s): ${selectedVariant.experienceObjectIds.join(", ") || "(none)"}.`,
+            ...(customObjects.length > 0
+                ? [`These experience object(s) are outside current deterministic Vise SDK outcomes and need explicit app-layer scope decisions: ${customObjects.join(", ")}.`]
+                : []),
+            ...(selectedVariant.feasibility.notes.length > 0 ? selectedVariant.feasibility.notes : []),
+        ],
+        nextStep: surfaceHints.length > 1
+            ? "Use `vise workplan next` to execute the accepted variant one deterministic surface at a time."
+            : "Use `vise plan` / `vise init` for the focused surface while preserving the accepted creative direction.",
+    };
+}
+function creativeImplementationSteps(selection) {
+    if (!selection) {
+        return [];
+    }
+    const selectedVariant = selection.selectedVariant;
+    return [
+        {
+            step: `Carry the accepted creative variant "${selectedVariant.title}" into this build: solution patterns ${selectedVariant.solutionPatternIds.join(", ")}, UX patterns ${selectedVariant.uxPatternIds.join(", ")}, experience objects ${selectedVariant.experienceObjectIds.join(", ")}.`,
+            evidence: ["sp-vise/creative-selection.json", selection.source.brief],
+        },
+    ];
+}
+function creativeImplementationRules(selection) {
+    if (!selection) {
+        return [];
+    }
+    return [
+        `Do not silently discard the accepted creative variant "${selection.selectedVariant.title}". If a selected experience object is not implemented in this pass, record it as an explicit scope decision in the handoff.`,
+        "Treat creative selection as advisory product/UX feed-forward; deterministic compliance still comes from the focused `vise init` outcome and `vise check` result.",
+    ];
+}
+function creativeSelectionAppliesToRequest(selection, request) {
+    const normalizedRequest = normalizeCreativeRequest(request);
+    const original = normalizeCreativeRequest(selection.source.request);
+    const planRequest = normalizeCreativeRequest(selection.implementationContext.planRequest);
+    if (!normalizedRequest || !original) {
+        return false;
+    }
+    return (normalizedRequest === original ||
+        normalizedRequest === planRequest ||
+        normalizedRequest.includes(original) ||
+        original.includes(normalizedRequest));
+}
+function normalizeCreativeRequest(value) {
+    return value.toLowerCase().replace(/[^a-z0-9\s]+/g, " ").replace(/\s+/g, " ").trim();
+}
 const SOCIAL_SURFACE_SEQUENCE = [
     {
         id: "feed",
@@ -220,18 +311,28 @@ const SOCIAL_SURFACE_SEQUENCE = [
     },
 ];
 async function socialWorkplanFor(args) {
-    if (!BROAD_SOCIAL_REGEX.test(args.request) || hasAnswer(args.answers, "feature_surface")) {
+    if (hasAnswer(args.answers, "feature_surface")) {
+        return undefined;
+    }
+    const creativeHints = args.creativeSelection ? creativeSurfaceHints(args.creativeSelection) : [];
+    const useCreativeSequence = creativeHints.length > 1;
+    if (!BROAD_SOCIAL_REGEX.test(args.request) && !useCreativeSequence) {
         return undefined;
     }
     const matched = SOCIAL_SURFACE_SEQUENCE.filter((surface) => surface.aliases.some((pattern) => pattern.test(args.request)));
-    const selected = matched.length > 0
-        ? matched
-        : SOCIAL_SURFACE_SEQUENCE.filter((surface) => surface.defaultForGenericBroad);
+    const selected = useCreativeSequence
+        ? creativeHints.flatMap((hint) => {
+            const surface = SOCIAL_SURFACE_SEQUENCE.find((item) => item.id === hint.id);
+            return surface ? [{ surface, creativeHint: hint }] : [];
+        })
+        : (matched.length > 0
+            ? matched
+            : SOCIAL_SURFACE_SEQUENCE.filter((surface) => surface.defaultForGenericBroad)).map((surface) => ({ surface, creativeHint: undefined }));
     if (selected.length <= 1) {
         return undefined;
     }
     const sequence = [];
-    for (const surface of selected) {
+    for (const { surface, creativeHint } of selected) {
         const definition = getOutcomeDefinition(surface.outcome);
         const capabilityAvailability = await platformCapabilityAvailability(surface.outcome, args.platform);
         const surfaceAnswers = { ...args.answers, feature_surface: surface.id };
@@ -255,9 +356,9 @@ async function socialWorkplanFor(args) {
             outcome: surface.outcome,
             label: surface.label,
             matchedPrompt,
-            reason: matchedPrompt
+            reason: creativeHint?.reason ?? (matchedPrompt
                 ? `The request explicitly mentions ${surface.label.toLowerCase()}.`
-                : "The request is generic broad social work, so Vise includes this core surface in the default sequence.",
+                : "The request is generic broad social work, so Vise includes this core surface in the default sequence."),
             planCommand: `vise plan ${commonArgs}`,
             initCommand: `vise init ${commonArgs}`,
             intake: {
@@ -276,7 +377,15 @@ async function socialWorkplanFor(args) {
     return {
         kind: "social-multi-surface",
         status,
-        note: "This broad social request is decomposed into ordered per-surface plans. Initialize and check one surface at a time so each sidecar has one outcome, while using this sequence as the coordinated product workplan.",
+        note: useCreativeSequence
+            ? "This accepted creative variant is decomposed into ordered per-surface plans from its experience objects. Initialize and check one surface at a time so each sidecar has one deterministic outcome, while using this sequence as the coordinated product workplan."
+            : "This broad social request is decomposed into ordered per-surface plans. Initialize and check one surface at a time so each sidecar has one outcome, while using this sequence as the coordinated product workplan.",
+        creativeContext: args.creativeSelection
+            ? {
+                selectedVariant: creativeContextForPlan(args.creativeSelection).selectedVariant,
+                surfaceHints: creativeHints,
+            }
+            : undefined,
         sequence,
         nextStep: "Resolve each surface's blocking questions, then run the listed plan/init command for that surface before implementation. After each surface build, run `vise check .`, `vise sync .`, `vise validate .`, and `vise run-sensors .`.",
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amityco/social-plus-vise",
-  "version": "0.14.25",
+  "version": "0.14.26",
   "description": "Skill-guided deterministic CLI for social.plus SDK integration assistance.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",