create-snipara 2.0.11 → 2.0.12

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "2.0.11",
+  version: "2.0.12",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -107,6 +107,8 @@ var DEVICE_CLIENT_ID = "create-snipara";
 var DAY_ZERO_CORPUS_MAX_FILES = 8;
 var DAY_ZERO_CORPUS_MAX_FILE_CHARS = 12e3;
 var DAY_ZERO_CORPUS_MAX_TOTAL_CHARS = 5e4;
+var ACTIVATION_MANIFEST_SCHEMA_VERSION = "snipara.activation.manifest.v1";
+var ACTIVATION_CONSUMER_CONTRACT_VERSION = "snipara.editor.activation.v1";
 var EXPERIENCE_GOAL_SECTION = `## Experience Goal
 
 The target experience is outcome-first agent work across supported clients:
@@ -140,15 +142,23 @@ function getActivationDir() {
 function getActivationManifestPath() {
   return path.join(getActivationDir(), "manifest.json");
 }
+function getStableActivationManifestPath() {
+  return path.join(getActivationDir(), "activation-manifest.json");
+}
 function getActivationHandoffPath() {
   return path.join(getActivationDir(), "handoff.md");
 }
+function getFirstWorkBriefPath() {
+  return path.join(getActivationDir(), "first-brief.md");
+}
 function getMemoryCandidatesPath() {
   return path.join(getActivationDir(), "memory-candidates.json");
 }
 function writeActivationManifest(manifest) {
   fs.mkdirSync(getActivationDir(), { recursive: true });
-  fs.writeFileSync(getActivationManifestPath(), JSON.stringify(manifest, null, 2) + "\n", "utf8");
+  const payload = JSON.stringify(manifest, null, 2) + "\n";
+  fs.writeFileSync(getActivationManifestPath(), payload, "utf8");
+  fs.writeFileSync(getStableActivationManifestPath(), payload, "utf8");
 }
 function updateActivationManifest(manifest) {
   manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -451,6 +461,24 @@ function writeInitialHandoff(answers, manifest) {
   ];
   fs.writeFileSync(getActivationHandoffPath(), lines.join("\n"), "utf8");
 }
+function writeFirstWorkBrief(manifest) {
+  fs.mkdirSync(getActivationDir(), { recursive: true });
+  const lines = [
+    `# ${manifest.firstBrief.title}`,
+    "",
+    `Status: ${manifest.firstBrief.status}`,
+    `Activation: ${manifest.activationId}`,
+    `Client: ${getClientDisplayName(manifest.aiClient)}`,
+    "",
+    ...manifest.firstBrief.sections.flatMap((section) => [
+      `## ${section.title}`,
+      "",
+      ...section.lines.map((line) => `- ${line}`),
+      ""
+    ])
+  ];
+  fs.writeFileSync(getFirstWorkBriefPath(), lines.join("\n"), "utf8");
+}
 function detectLocalActivationScan(detection) {
   const cwd = process.cwd();
   const exists = (relativePath) => fs.existsSync(path.join(cwd, relativePath));
@@ -624,9 +652,11 @@ function createActivationManifest(answers, detection, mode = "default", scan) {
   const surfaceContract = buildActivationSurfaceContract(answers.aiClient);
   return {
     version: "create-snipara-activation-v1",
+    schemaVersion: ACTIVATION_MANIFEST_SCHEMA_VERSION,
     activationId: buildActivationId(),
     mode,
     surfaceContract,
+    consumerContract: buildEditorActivationConsumerContract(answers.aiClient),
     activationMetric: {
       name: "time_to_how_did_it_know_that",
       targetMinutes: 5,
@@ -694,9 +724,13 @@ function createActivationManifest(answers, detection, mode = "default", scan) {
       )
     },
     artifacts: {
+      activationManifestPath: path.relative(process.cwd(), getStableActivationManifestPath()),
+      legacyManifestPath: path.relative(process.cwd(), getActivationManifestPath()),
+      firstBriefPath: null,
       handoffPath: null,
       memoryCandidatesPath: null
     },
+    nextActions: buildActivationNextActions(surfaceContract, answers),
     firstBrief: createInitialFirstWorkBrief(answers, detection, localScan),
     createdAt: now,
     updatedAt: now
@@ -899,10 +933,12 @@ function createActivationArtifacts(answers, manifest) {
     "Initial local handoff created.",
     manifest.artifacts.handoffPath
   );
+  writeFirstWorkBrief(manifest);
+  manifest.artifacts.firstBriefPath = path.relative(process.cwd(), getFirstWorkBriefPath());
   manifest.lanes.firstBrief = createActivationLane(
     "ready",
     "First Work Brief generated from local setup and scan signals.",
-    path.relative(process.cwd(), getActivationManifestPath())
+    manifest.artifacts.firstBriefPath
   );
   updateActivationManifest(manifest);
 }
@@ -995,7 +1031,7 @@ function buildProgram() {
   ).option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
     "--profile <profile>",
     "Install profile: hosted-only, hosted-companion, full-stack, runtime-only"
-  ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--starter", "Mark this run as a starter activation and print dashboard-first guidance").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
+  ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--starter", "Mark this run as a starter activation and print dashboard-first guidance").option("--json", "Print a machine-readable activation summary after setup").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting").action(async (options) => {
     printBanner();
     await runInit(options);
   });
@@ -1036,7 +1072,7 @@ function addSharedRootOptions(program) {
   ).option("--advanced", "Show advanced profile, project id, hooks, GitHub, and sandbox prompts").option(
     "--profile <profile>",
     "Install profile: hosted-only, hosted-companion, full-stack, runtime-only"
-  ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--starter", "Mark this run as a starter activation and print dashboard-first guidance").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting");
+  ).option("--skip-companion", "Skip local companion CLI installation").option("--skip-mcp", "Skip local snipara-mcp package installation").option("--skip-runtime", "Skip snipara-sandbox installation").option("--skip-hooks", "Skip hook generation").option("--skip-test", "Skip hosted connection test").option("--with-orchestrator", "Install optional snipara-orchestrator package").option("--github", "Open GitHub repository automation setup when a git remote is detected").option("--skip-github", "Skip the GitHub automation prompt").option("--github-path <path>", "Optional GitHub path filter for the initial repository sync").option("--starter", "Mark this run as a starter activation and print dashboard-first guidance").option("--json", "Print a machine-readable activation summary after setup").option("--runtime-only", "Install only Snipara Sandbox").addOption(new Option("--full", "Legacy alias for --profile full-stack").hideHelp()).option("-y, --yes", "Accept defaults without prompting");
 }
 async function main() {
   const program = buildProgram();
@@ -1136,6 +1172,7 @@ function parseInitOptionsFromArgv(args) {
     "--github": "github",
     "--skip-github": "skipGithub",
     "--starter": "starter",
+    "--json": "json",
     "--yes": "yes",
     "-y": "yes"
   };
@@ -1200,6 +1237,11 @@ async function runInit(options) {
   runLocalSourceActivation(answers, activationManifest);
   createActivationArtifacts(answers, activationManifest);
   printSuccess(answers, validationReport, activationManifest);
+  if (normalizedOptions.json) {
+    console.log(
+      JSON.stringify(buildActivationJsonSummary(activationManifest, validationReport), null, 2)
+    );
+  }
   if (answers.configureGitHub && answers.githubRepo) {
     await openGitHubAutomation(answers);
   }
@@ -1207,6 +1249,35 @@ async function runInit(options) {
     await runSandboxInit();
   }
 }
+function buildActivationJsonSummary(manifest, validation) {
+  const laneEntries = Object.entries(manifest.lanes);
+  const failedLanes = laneEntries.filter(([, lane]) => lane.status === "failed").map(([name]) => name);
+  const pendingLanes = laneEntries.filter(([, lane]) => lane.status === "queued" || lane.status === "indexing").map(([name]) => name);
+  const activationStatus = failedLanes.length > 0 ? "partial" : pendingLanes.length > 0 ? "partial" : "complete";
+  return {
+    ok: true,
+    activationStatus,
+    activationId: manifest.activationId,
+    schemaVersion: manifest.schemaVersion,
+    consumerContractVersion: manifest.consumerContract.version,
+    projectSlug: manifest.projectSlug,
+    aiClient: manifest.aiClient,
+    profile: validation.profile,
+    artifacts: manifest.artifacts,
+    lanes: Object.fromEntries(
+      laneEntries.map(([name, lane]) => [
+        name,
+        {
+          status: lane.status,
+          detail: lane.detail,
+          command: lane.command
+        }
+      ])
+    ),
+    nextActions: manifest.nextActions,
+    exitCode: activationStatus === "complete" ? 0 : manifest.consumerContract.exitCodes.activation_partial
+  };
+}
 async function runDoctor(options) {
   const normalizedOptions = normalizeMaintenanceOptions(options);
   const requestedClient = normalizeClientOption(normalizedOptions.client);
@@ -1290,11 +1361,12 @@ async function runUpgrade(options) {
   printDoctorReport(detectEnvironment(), report);
 }
 async function runPrintConfig(options) {
+  const normalizedOptions = normalizeMaintenanceOptions(options);
   const detection = detectEnvironment();
-  const answers = loadExistingAnswers(options);
+  const answers = loadExistingAnswers(normalizedOptions);
   const githubRepo = detectGitRepository();
   const githubAnswerPacks = githubRepo ? `${githubRepo.fullName} can be connected with npx create-snipara --github` : "requires a GitHub-backed git remote";
-  if (options.json) {
+  if (normalizedOptions.json) {
     console.log(
       JSON.stringify(
         {
@@ -3384,6 +3456,81 @@ function buildActivationSurfaceContract(client) {
     nextSurfaceAction: "Restart or reload the client, verify Snipara tools, then ask the first grounded project question from the generated First Work Brief."
   };
 }
+function buildEditorActivationConsumerContract(client) {
+  const secretRule = client === "vscode" ? "Use VS Code SecretStorage for SNIPARA_API_KEY and pass it to create-snipara through the child-process environment; never write raw secrets into extension settings or logs." : "Pass SNIPARA_API_KEY through the process environment or client secret store; never parse, log, or persist raw secrets from terminal output.";
+  return {
+    version: ACTIVATION_CONSUMER_CONTRACT_VERSION,
+    audience: "editor_extension",
+    stableFiles: {
+      activationManifest: ".snipara/activation/activation-manifest.json",
+      firstBrief: ".snipara/activation/first-brief.md",
+      handoff: ".snipara/activation/handoff.md",
+      memoryCandidates: ".snipara/activation/memory-candidates.json"
+    },
+    requiredManifestFields: [
+      "schemaVersion",
+      "consumerContract.version",
+      "surfaceContract",
+      "artifacts.activationManifestPath",
+      "artifacts.firstBriefPath",
+      "artifacts.handoffPath",
+      "lanes.connection.status",
+      "lanes.firstBrief.status",
+      "nextActions"
+    ],
+    laneStatuses: ["ready", "indexing", "queued", "needs_review", "skipped", "failed"],
+    exitCodes: {
+      success: 0,
+      activation_partial: 10,
+      auth_required: 20,
+      missing_api_key: 21,
+      missing_node_or_npm: 30,
+      activation_failed: 40
+    },
+    parseRule: "Read .snipara/activation/activation-manifest.json as the source of truth. If --json is used, parse the last JSON object from stdout as a summary pointer, not as the full durable state.",
+    secretRule
+  };
+}
+function buildActivationNextActions(surfaceContract, answers) {
+  const actions = [
+    {
+      id: "open_first_work_brief",
+      label: "Open First Work Brief",
+      target: "editor",
+      when: "artifacts.firstBriefPath is present and lanes.firstBrief.status is ready"
+    },
+    {
+      id: "handoff_to_agent",
+      label: "Hand off to the coding agent",
+      target: "agent",
+      when: "lanes.connection.status is ready and First Work Brief has been shown"
+    },
+    {
+      id: "review_memory_candidates",
+      label: "Review memory candidates",
+      target: "editor",
+      when: "lanes.memoryCandidates.status is needs_review"
+    }
+  ];
+  if (answers.aiClient === "vscode") {
+    actions.unshift({
+      id: "vscode_activate_workspace",
+      label: "Snipara: Activate Workspace",
+      command: "Snipara: Activate Workspace",
+      target: "editor",
+      when: "VS Code extension command is available"
+    });
+  } else {
+    actions.unshift({
+      id: "verify_surface_activation",
+      label: "Verify activation surface",
+      command: surfaceContract.nextSurfaceAction,
+      target: "agent",
+      when: "editor-specific command is unavailable"
+    });
+  }
+  return actions;
+}
 function getClientGuidance(client) {
   if (client === "claude-code") {
     return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-snipara",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   "main": "dist/index.js",
   "type": "module",