@distributionos/cli 0.1.19 → 0.1.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@distributionos/cli",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "DistributionOS repo setup CLI for agent onboarding and first-party analytics.",
   "homepage": "https://distributionos.dev",
   "repository": {

package/src/bootstrap.js

@@ -22,11 +22,13 @@ export function buildLocalBootstrapBlock(version = CURRENT_BOOTSTRAP_VERSION, ap
     `<!-- DISTRIBUTIONOS:START version=${version}${appIdAttribute} -->`,
     '## DistributionOS Agent Sync',
     '',
-    'This repo is linked to DistributionOS.',
-    '',
-    'Session preflight: when starting a fresh agent chat in this repo, call check_distributionos_connection first, then fetch the current instructions below. If DistributionOS returns setupUpdate or setupUpdateGuidance with a status other than current or not_installed, tell the user the repo has a setup update available, show the review command, and run the apply command only after the user approves.',
+    'This repo is linked to DistributionOS.',
+    '',
+    'Session preflight: when starting a fresh agent chat in this repo, call check_distributionos_connection first, then fetch the current instructions below, then call list_agent_alerts. If DistributionOS returns setupUpdate or setupUpdateGuidance with a status other than current or not_installed, tell the user the repo has a setup update available, show the review command, and run the apply command only after the user approves.',
     '',
-    'Hard preflight: before editing files, creating assets, generating images, creating HyperFrames launch/demo videos, or changing copy for SEO, blog, launch, content, visual asset, competitor, social, email, or growth work, fetch the current instructions from DistributionOS:',
+    'Startup alerts: after get_agent_instructions, call list_agent_alerts for this app. If alerts are returned, summarize them to the user before unrelated work. For SEO incidents, call get_seo_incident for full evidence before editing code, report each fix attempt with report_seo_incident_attempt, and verify with verify_seo_incident_fix.',
+    '',
+    'Hard preflight: before editing files, creating assets, generating images, creating HyperFrames launch/demo videos, or changing copy for SEO, blog, launch, content, visual asset, competitor, social, email, or growth work, fetch the current instructions from DistributionOS:',
     '',
     instructionCall,
     '',

package/src/constants.js

@@ -6,9 +6,9 @@ export const CLI_PACKAGE_NAME = '@distributionos/cli';
 export const CLI_LOCAL_VERSION = typeof cliPackageJson.version === 'string' ? cliPackageJson.version : '0.0.0-local';
 export const DEFAULT_API_BASE = 'https://distributionos.dev';
 export const MCP_SERVER_URL = 'https://distributionos.dev/api/mcp';
-export const CURRENT_BOOTSTRAP_VERSION = '2026.07.04.1';
+export const CURRENT_BOOTSTRAP_VERSION = '2026.07.09';
 export const CURRENT_ANALYTICS_CONTRACT_VERSION = '2026.06.20';
-export const CURRENT_SETUP_CONTRACT_VERSION = '2026.07.04.1';
+export const CURRENT_SETUP_CONTRACT_VERSION = '2026.07.09';
 
 export const TOKEN_ENV_NAMES = [
   'DISTRIBUTIONOS_API_KEY',

package/src/setup-report.js

@@ -24,10 +24,13 @@ export async function buildSetupReport(plan, phase = 'plan', details = {}) {
   let blockedReason = null;
 
   const bootstrapVersion = detectBootstrapVersion(plan);
-  if (bootstrapVersion && plan.bootstrap.action === 'none') {
-    detectedCapabilities.add('agent.bootstrap');
-    detectedCapabilities.add('agent.liveInstructions');
-  }
+  if (bootstrapVersion && plan.bootstrap.action === 'none') {
+    detectedCapabilities.add('agent.bootstrap');
+    detectedCapabilities.add('agent.liveInstructions');
+    if (compareVersion(bootstrapVersion, '2026.07.09') >= 0) {
+      detectedCapabilities.add('agent.startupAlerts');
+    }
+  }
   managedFiles.push({
     path: plan.bootstrap.target,
     type: 'agent.bootstrap',
@@ -144,16 +147,16 @@ export function formatSetupReportSummary(setupReport) {
   if (!localSetup) {
     lines.push('- Server report: pending');
     return lines;
-  }
-
-  lines.push(`- Server status: ${localSetup.status}`);
-  if (localSetup.recommendedCliVersion) {
-    lines.push(`- Recommended CLI: ${localSetup.recommendedCliVersion}`);
-  }
-  if (localSetup.latestContractVersion) {
-    lines.push(`- Current setup contract: ${localSetup.latestContractVersion}`);
-  }
-  lines.push(`- Missing capabilities: ${formatList(localSetup.missingCapabilities)}`);
+  }
+
+  lines.push(`- Server status: ${localSetup.status}`);
+  if (localSetup.recommendedCliVersion) {
+    lines.push(`- Recommended CLI: ${localSetup.recommendedCliVersion}`);
+  }
+  if (localSetup.latestContractVersion) {
+    lines.push(`- Current setup contract: ${localSetup.latestContractVersion}`);
+  }
+  lines.push(`- Missing capabilities: ${formatList(localSetup.missingCapabilities)}`);
   if (localSetup.status !== 'current') {
     lines.push(`- Review command: ${localSetup.updateCommand}`);
     lines.push(`- Apply command: ${localSetup.applyCommand}`);
@@ -164,13 +167,29 @@ export function formatSetupReportSummary(setupReport) {
   return lines;
 }
 
-function detectBootstrapVersion(plan) {
-  const current = (plan.repo.instructionFiles ?? []).find((file) => file.hasManagedDistributionOsBlock);
-  return current?.managedDistributionOsVersion ??
-    (plan.bootstrap.action === 'none' ? CURRENT_BOOTSTRAP_VERSION : null);
-}
-
-async function inspectAnalyticsInstall(plan) {
+function detectBootstrapVersion(plan) {
+  const current = (plan.repo.instructionFiles ?? []).find((file) => file.hasManagedDistributionOsBlock);
+  return current?.managedDistributionOsVersion ??
+    (plan.bootstrap.action === 'none' ? CURRENT_BOOTSTRAP_VERSION : null);
+}
+
+function compareVersion(left, right) {
+  const a = String(left ?? '').split(/[.-]/).map(toComparableNumber);
+  const b = String(right ?? '').split(/[.-]/).map(toComparableNumber);
+  const length = Math.max(a.length, b.length);
+  for (let index = 0; index < length; index += 1) {
+    const diff = (a[index] ?? 0) - (b[index] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+
+function toComparableNumber(value) {
+  const parsed = Number.parseInt(value, 10);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
+
+async function inspectAnalyticsInstall(plan) {
   const target = plan.analytics.layoutTarget;
   if (!target) {
     return {