create-snipara 2.0.9 → 2.0.10

package/README.md

@@ -26,7 +26,7 @@ Use it for:
 - free account signup with reviewed Context + Memory
 - local project wiring, `doctor`, `repair`, and `upgrade`
 - local source activation without GitHub, plus optional GitHub repository sync and PR Answer Packs approval when the current folder is a GitHub repo
-- day-zero Project Intelligence proof: a First Work Brief, a ready-to-run `snipara_context_query`, review-only decision archaeology candidates, possible doc-staleness findings, and an estimated context economy report from the user's own repository
+- day-zero Project Intelligence proof: a First Work Brief, a ready-to-run `snipara_context_query`, a small hosted README/docs seed sync for virgin projects, review-only decision archaeology candidates, possible doc-staleness findings, and an estimated context economy report from the user's own repository
 
 ## Why It Exists
 

package/dist/index.js

@@ -13,7 +13,7 @@ import { homedir } from "os";
 // package.json
 var package_default = {
   name: "create-snipara",
-  version: "2.0.9",
+  version: "2.0.10",
   description: "Onboard Snipara Hosted MCP Context + Memory with auth, companion workflows, and optional Snipara Sandbox",
   main: "dist/index.js",
   type: "module",
@@ -104,6 +104,9 @@ var SANDBOX_COMMAND_NAME = "snipara-sandbox";
 var LEGACY_SANDBOX_COMMAND_NAME = "rlm";
 var ORCHESTRATOR_COMMAND_NAME = "snipara-orchestrator";
 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 EXPERIENCE_GOAL_SECTION = `## Experience Goal
 
 The target experience is outcome-first agent work across supported clients:
@@ -288,6 +291,63 @@ function readTextFileSnippet(relativePath, maxChars = 24e3) {
     return "";
   }
 }
+function collectDayZeroCorpusDocuments(scan) {
+  const documents = [];
+  let totalChars = 0;
+  const cwd = process.cwd();
+  const rootReadmes = fs.existsSync(cwd) ? fs.readdirSync(cwd).filter((entry) => /^readme(?:\.[a-z0-9_-]+)?\.mdx?$/i.test(entry)).sort() : [];
+  const sources = [
+    ...rootReadmes,
+    ...listFilesUnder("docs", DAY_ZERO_CORPUS_MAX_FILES * 8),
+    ...scan.files.candidateDocs
+  ];
+  const seen = /* @__PURE__ */ new Set();
+  for (const source of sources) {
+    const normalized = source.replace(/\\/g, "/");
+    if (seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    const lower = normalized.toLowerCase();
+    const isReadme = /^readme(?:\.[a-z0-9_-]+)?\.mdx?$/.test(lower);
+    const isDocsMarkdown = lower.startsWith("docs/") && /\.(?:md|mdx|markdown|txt|rst|adoc)$/.test(lower);
+    if (!isReadme && !isDocsMarkdown) {
+      continue;
+    }
+    if (documents.length >= DAY_ZERO_CORPUS_MAX_FILES) {
+      break;
+    }
+    if (totalChars >= DAY_ZERO_CORPUS_MAX_TOTAL_CHARS) {
+      break;
+    }
+    const remainingChars = DAY_ZERO_CORPUS_MAX_TOTAL_CHARS - totalChars;
+    const content = readTextFileSnippet(
+      source,
+      Math.min(DAY_ZERO_CORPUS_MAX_FILE_CHARS, remainingChars)
+    ).trim();
+    if (!content) {
+      continue;
+    }
+    documents.push({
+      path: normalized,
+      content
+    });
+    totalChars += content.length;
+  }
+  return documents;
+}
+function createDayZeroCorpusReport(status, documents, detail, options = {}) {
+  return {
+    status,
+    documents: documents.map((document) => ({
+      path: document.path,
+      chars: document.content.length
+    })),
+    detail,
+    ...options.tool ? { tool: options.tool } : {},
+    ...options.error ? { error: options.error.slice(0, 500) } : {}
+  };
+}
 function buildStalenessFindings(scan) {
   const findings = [];
   const scriptSet = new Set(scan.scripts);
@@ -566,6 +626,11 @@ function createActivationManifest(answers, detection, mode = "default", scan) {
       query: dayZeroQuery,
       expectedOutcome: "First own-repo answer pack before the user reads product docs."
     },
+    dayZeroCorpus: createDayZeroCorpusReport(
+      "queued",
+      collectDayZeroCorpusDocuments(localScan),
+      "README and docs Markdown will be submitted to hosted context before the first day-zero query when live hosted checks are enabled."
+    ),
     agentReadiness: buildAgentReadinessReport(localScan),
     contextEconomy: buildContextEconomyReport(localScan, dayZeroQuery),
     projectSlug: answers.projectSlug,
@@ -593,8 +658,8 @@ function createActivationManifest(answers, detection, mode = "default", scan) {
         hasCompanion ? "Local source activation will create a repository snapshot." : "Install companion later to activate local source context."
       ),
       contextIndex: createActivationLane(
-        hasCompanion ? "queued" : "skipped",
-        hasCompanion ? "Context indexing starts from local docs and instruction files." : "Context indexing requires companion or hosted provider sync."
+        hasHostedConfig || hasCompanion ? "queued" : "skipped",
+        hasCompanion ? "Context indexing starts from local docs and instruction files." : hasHostedConfig ? "Day-zero README/docs sync will seed hosted context when live hosted checks run." : "Context indexing requires companion or hosted provider sync."
       ),
       codeGraph: createActivationLane(
         hasCompanion ? "queued" : "skipped",
@@ -698,6 +763,115 @@ function runLocalSourceActivation(answers, manifest) {
   }
   updateActivationManifest(manifest);
 }
+async function runHostedDayZeroCorpusSync(answers, manifest, enabled) {
+  if (answers.profile === "runtime-only") {
+    manifest.dayZeroCorpus = createDayZeroCorpusReport(
+      "skipped",
+      [],
+      "Runtime-only profile skipped Hosted MCP config and hosted document sync."
+    );
+    updateActivationManifest(manifest);
+    return;
+  }
+  if (!enabled) {
+    const documents2 = collectDayZeroCorpusDocuments(manifest.localScan);
+    manifest.dayZeroCorpus = createDayZeroCorpusReport(
+      "skipped",
+      documents2,
+      "Skipped because hosted validation was disabled with --skip-test."
+    );
+    updateActivationManifest(manifest);
+    return;
+  }
+  if (answers.apiKeyType === "none" || answers.apiKey.includes("YOUR_")) {
+    manifest.dayZeroCorpus = createDayZeroCorpusReport(
+      "skipped",
+      [],
+      "Skipped because no live hosted API key was available."
+    );
+    updateActivationManifest(manifest);
+    return;
+  }
+  const documents = collectDayZeroCorpusDocuments(manifest.localScan);
+  if (documents.length === 0) {
+    manifest.dayZeroCorpus = createDayZeroCorpusReport(
+      "skipped",
+      [],
+      "No README or docs Markdown files were found to seed hosted context."
+    );
+    if (manifest.lanes.contextIndex.status === "queued") {
+      manifest.lanes.contextIndex = createActivationLane(
+        "skipped",
+        "No README or docs Markdown files were found to seed hosted context."
+      );
+    }
+    updateActivationManifest(manifest);
+    return;
+  }
+  const syncTool = "snipara_sync_documents";
+  const syncResponse = await callHostedMcp(answers, "tools/call", {
+    name: syncTool,
+    arguments: {
+      documents,
+      delete_missing: false
+    }
+  });
+  if (syncResponse.ok && !syncResponse.data.error) {
+    manifest.dayZeroCorpus = createDayZeroCorpusReport(
+      "submitted",
+      documents,
+      `Submitted ${documents.length} README/docs files to hosted context for the first day-zero answer pack.`,
+      { tool: syncTool }
+    );
+    manifest.lanes.contextIndex = createActivationLane(
+      "indexing",
+      "Day-zero README/docs corpus submitted to hosted context indexing.",
+      syncTool
+    );
+    updateActivationManifest(manifest);
+    return;
+  }
+  const uploadTool = "snipara_upload_document";
+  const uploadErrors = [];
+  for (const document of documents) {
+    const uploadResponse = await callHostedMcp(answers, "tools/call", {
+      name: uploadTool,
+      arguments: document
+    });
+    if (!uploadResponse.ok || uploadResponse.data.error) {
+      uploadErrors.push(
+        uploadResponse.ok ? describeJsonRpcError(uploadResponse.data) : describeHostedHttpFailure(uploadResponse.status, uploadResponse.bodyText)
+      );
+      break;
+    }
+  }
+  if (uploadErrors.length === 0) {
+    manifest.dayZeroCorpus = createDayZeroCorpusReport(
+      "submitted",
+      documents,
+      `Submitted ${documents.length} README/docs files to hosted context for the first day-zero answer pack.`,
+      { tool: uploadTool }
+    );
+    manifest.lanes.contextIndex = createActivationLane(
+      "indexing",
+      "Day-zero README/docs corpus submitted to hosted context indexing.",
+      uploadTool
+    );
+  } else {
+    const syncError = syncResponse.ok ? describeJsonRpcError(syncResponse.data) : describeHostedHttpFailure(syncResponse.status, syncResponse.bodyText);
+    const detail = `Could not submit the day-zero README/docs corpus. sync_documents: ${syncError}; upload_document: ${uploadErrors[0]}`;
+    manifest.dayZeroCorpus = createDayZeroCorpusReport("failed", documents, detail, {
+      tool: syncTool,
+      error: detail
+    });
+    manifest.lanes.contextIndex = failActivationLane(
+      "Hosted day-zero README/docs sync failed; the first answer may need GitHub, companion, or a later sync.",
+      syncTool,
+      new Error(detail)
+    );
+  }
+  updateActivationManifest(manifest);
+}
 function createActivationArtifacts(answers, manifest) {
   const candidates = buildMemoryCandidatePreviews(manifest.localScan);
   writeMemoryCandidates(candidates);
@@ -1011,6 +1185,7 @@ async function runInit(options) {
     normalizedOptions.starter ? "starter" : "default",
     activationScan
   );
+  await runHostedDayZeroCorpusSync(answers, activationManifest, !normalizedOptions.skipTest);
   runLocalSourceActivation(answers, activationManifest);
   createActivationArtifacts(answers, activationManifest);
   printSuccess(answers, validationReport, activationManifest);
@@ -4331,6 +4506,11 @@ function printActivationSummary(manifest) {
       `   Target: ${manifest.activationMetric.targetMinutes} minutes to a true, non-obvious own-repo answer.`
     )
   );
+  console.log(
+    chalk.dim(
+      `   Day-zero corpus: ${manifest.dayZeroCorpus.status} - ${manifest.dayZeroCorpus.detail}`
+    )
+  );
   console.log(chalk.bold("\nAgent readiness:\n"));
   console.log(`   ${manifest.agentReadiness.summary}`);
   for (const finding of manifest.agentReadiness.stalenessFindings.slice(0, 3)) {

package/package.json

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