@distributionos/cli 0.1.4 → 0.1.7

package/package.json

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

package/src/initialization.js

@@ -1,11 +1,34 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 
-export async function buildInitializationPayload(plan, options = {}) {
-  const appName = titleFromPackageName(plan.repo.packageJson?.name ?? plan.appId);
-  const docs = await readProjectDocs(plan.cwd);
-  const publicBlogRoute = plan.repo.routes.find(route => route === '/blog' || route.startsWith('/blog/'));
-  const claims = [
+export async function buildInitializationPayload(plan, options = {}) {
+  const appName = titleFromPackageName(plan.repo.packageJson?.name ?? plan.appId);
+  const docs = await readProjectDocs(plan.cwd);
+  const publicBlogRoute = plan.repo.routes.find(route => route === '/blog' || route.startsWith('/blog/'));
+  const appIdentity = {
+    name: appName,
+  };
+  if (options.domain) {
+    appIdentity.domain = options.domain;
+  }
+  if (docs.overview?.claim) {
+    appIdentity.description = docs.overview.claim;
+  }
+  const repo = {
+    root: path.basename(plan.cwd),
+    frameworks: [plan.repo.framework].filter(value => value && value !== 'unknown'),
+    languages: ['TypeScript', 'JavaScript'],
+    packageManagers: [plan.repo.packageManager].filter(value => value && value !== 'unknown'),
+    notableFiles: [
+      'package.json',
+      ...plan.repo.layoutCandidates,
+      ...plan.repo.contentFiles.slice(0, 12),
+    ],
+  };
+  if (plan.repo.git.branch) {
+    repo.defaultBranch = plan.repo.git.branch;
+  }
+  const claims = [
     {
       category: 'repo',
       claim: `The repo package name is ${plan.repo.packageJson?.name ?? appName}.`,
@@ -47,23 +70,8 @@ export async function buildInitializationPayload(plan, options = {}) {
     client: 'distributionos-cli',
     instructionPackVersion: plan.instructionPackVersion,
     sourceSummary: 'DistributionOS CLI inspected package metadata, routes, content files, deploy hints, and agent instruction files. It did not read .env files or secrets.',
-    appIdentity: {
-      name: appName,
-      domain: options.domain,
-      description: docs.overview?.claim,
-    },
-    repo: {
-      root: path.basename(plan.cwd),
-      defaultBranch: plan.repo.git.branch ?? null,
-      frameworks: [plan.repo.framework].filter(value => value && value !== 'unknown'),
-      languages: ['TypeScript', 'JavaScript'],
-      packageManagers: [plan.repo.packageManager].filter(value => value && value !== 'unknown'),
-      notableFiles: [
-        'package.json',
-        ...plan.repo.layoutCandidates,
-        ...plan.repo.contentFiles.slice(0, 12),
-      ],
-    },
+    appIdentity,
+    repo,
     distribution: {
       blogRoute: publicBlogRoute ?? undefined,
       analytics: plan.analytics.status === 'enabled'
@@ -121,16 +129,31 @@ async function readProjectDocs(cwd) {
   return {};
 }
 
-function extractOverviewExcerpt(text) {
-  const normalized = text.replace(/\r\n/g, '\n');
-  const overviewIndex = normalized.search(/(^|\n)#{1,3}\s+(Project Overview|Overview|Solution|What it does)\s*\n/i);
-  const source = overviewIndex >= 0 ? normalized.slice(overviewIndex) : normalized;
-  return source
-    .split(/\n{2,}/)
-    .map(block => block.replace(/^#{1,6}\s+[^\n]+\n?/, '').trim())
-    .find(block => block.length >= 80 && !/secret|api key|environment variables/i.test(block))
-    ?.slice(0, 700) ?? null;
-}
+function extractOverviewExcerpt(text) {
+  const normalized = text.replace(/\r\n/g, '\n');
+  if (isScaffoldReadme(normalized)) {
+    return null;
+  }
+  const overviewIndex = normalized.search(/(^|\n)#{1,3}\s+(Project Overview|Overview|Solution|What it does)\s*\n/i);
+  const source = overviewIndex >= 0 ? normalized.slice(overviewIndex) : normalized;
+  return source
+    .split(/\n{2,}/)
+    .map(block => block.replace(/^#{1,6}\s+[^\n]+\n?/, '').trim())
+    .find(block => block.length >= 80 && !/secret|api key|environment variables/i.test(block) && !isScaffoldReadme(block))
+    ?.slice(0, 700) ?? null;
+}
+
+function isScaffoldReadme(value) {
+  const text = value.toLowerCase();
+  return [
+    'this is a [next.js]',
+    'bootstrapped with [`create-next-app`]',
+    'next.js documentation',
+    'learn next.js',
+    'deploy on vercel',
+    'you can start editing the page by modifying',
+  ].filter(needle => text.includes(needle)).length >= 2;
+}
 
 function routeReference(route, files) {
   if (route === '/blog' && files.includes('src/app/blog/page.tsx')) return 'src/app/blog/page.tsx';

package/src/mutate.js

@@ -91,9 +91,9 @@ async function applyNextAppRouterAnalytics(cwd, analytics, scriptSrc) {
     contractVersion: analytics.contractVersion,
     configScript: analytics.configScript,
   });
-  const next = ANALYTICS_BLOCK_RE.test(existing)
-    ? existing.replace(ANALYTICS_BLOCK_RE, `\n${block}\n`)
-    : insertBeforeHeadClose(existing, block);
+  const next = ANALYTICS_BLOCK_RE.test(existing)
+    ? existing.replace(ANALYTICS_BLOCK_RE, `\n${block}\n`)
+    : insertIntoNextAppRouterLayout(existing, block);
 
   if (next === existing) {
     return { type: 'analytics', changed: false, file: analytics.layoutTarget, reason: 'No analytics change needed.' };
@@ -156,13 +156,33 @@ function buildHtmlAnalyticsBlock({ scriptSrc, contractVersion, configScript }) {
   ].join('\n');
 }
 
-function insertBeforeHeadClose(content, block) {
-  const headClose = content.match(/^(\s*)<\/head>/im);
-  if (headClose?.index === undefined) {
-    throw new Error('Could not find </head> in shared layout.');
-  }
-  return `${content.slice(0, headClose.index)}${block}\n${content.slice(headClose.index)}`;
-}
+function insertBeforeHeadClose(content, block) {
+  const headClose = content.match(/^(\s*)<\/head>/im);
+  if (headClose?.index === undefined) {
+    throw new Error('Could not find </head> in shared layout.');
+  }
+  return `${content.slice(0, headClose.index)}${block}\n${content.slice(headClose.index)}`;
+}
+
+function insertIntoNextAppRouterLayout(content, block) {
+  const headClose = content.match(/^(\s*)<\/head>/im);
+  if (headClose?.index !== undefined) {
+    return `${content.slice(0, headClose.index)}${block}\n${content.slice(headClose.index)}`;
+  }
+
+  const bodyOpen = content.match(/^(\s*)<body(\s|>)/im);
+  if (bodyOpen?.index === undefined) {
+    throw new Error('Could not find <body> in shared layout.');
+  }
+
+  const indent = bodyOpen[1] || '      ';
+  const headBlock = [
+    `${indent}<head>`,
+    block,
+    `${indent}</head>`,
+  ].join('\n');
+  return `${content.slice(0, bodyOpen.index)}${headBlock}\n${content.slice(bodyOpen.index)}`;
+}
 
 function indentLines(value, prefix) {
   return String(value).split(/\r?\n/).map(line => `${prefix}${line}`).join('\n');