genesis-compiler 1.2.3 → 1.2.4

package/prompts/work.txt

@@ -10,7 +10,7 @@ and reuse an existing function when it already owns the behavior.
 This is the implementation turn. Do not edit the Blueprint, Program, or
 `.genesis/`; the separate reconciliation turn owns explanatory changes. Keep an
 exact Stack `## Launch` declaration aligned when the implementation establishes
-or intentionally changes how the project is started or how Vibe64 may request
+or intentionally changes how the project is started or how a preview host may request
 an application preview identity. Declare only command paths, protocol, supported
 identity types, environment variable names, runtimes, and timeout policy; never
 put an environment value or secret in Stack. Never invent missing external-resource

package/skills/genesis-project/SKILL.md

@@ -21,6 +21,14 @@ codebase, tests, Git review, or the coding agent.
 6. Load applicable technology skills from `.agents/skills/` or from the
    agent's own installed skill catalog.
 
+For an existing application's first Stack selection, inspect its real setup,
+build, and launch commands before relying on component defaults. A selected
+component describes its current foundation; it does not silently port older
+source. When the existing commands differ, keep the implementation unchanged
+and declare exact project-owned `## Workspace setup` and `## Launch` overrides.
+Do not claim the inherited component recipe is usable until it matches the
+source.
+
 Program is concise, fallible explanation. Its Sources and optional
 Implementation maps aid navigation but never substitute for reading code,
 tests, and runtime behavior.
@@ -36,7 +44,7 @@ Neither is authority or proof; both may be regenerated with `genesis index`.
 - Do not edit the Blueprint, Program, or `.genesis/` during implementation; the
   separate reconciliation turn owns explanatory updates. Keep an exact Stack
   `## Launch` declaration aligned when the implementation establishes or
-  intentionally changes how the project is started or how Vibe64 may request
+  intentionally changes how the project is started or how a preview host may request
   an application preview identity. Record only capability metadata and
   environment variable names there, never environment values or secrets.
 - Follow established project and technology seams instead of creating parallel

package/src/cli.js

@@ -9,6 +9,10 @@ import {
   getContext,
   indexCodebase,
   initialize,
+  inspectDeployment,
+  inspectEnvironment,
+  inspectLaunch,
+  inspectWorkspaceSetup,
   installCodex,
   listStackPieces,
   prepareWorkspace,
@@ -31,9 +35,10 @@ const USAGE = `Usage:
   genesis stack add <piece...>
   genesis context <path...>
   genesis index [function-or-path...]
+  genesis inspect <workspace|environment|launch|deployment>
   genesis prepare
   genesis prompt [request...]
-  genesis prompt --task <start|work|deslop|program|blueprint|describe|review> [request...]
+  genesis prompt --task <start|adopt|work|deslop|program|blueprint|describe|review> [request...]
   genesis verify
   genesis check
 
@@ -48,7 +53,7 @@ prompt to the agent you already use. Review all edits through the ordinary Git
 diff, then run genesis verify for the Stack's concrete checks.
 `;
 
-const COMMANDS = new Set(['adopt', 'check', 'codex', 'context', 'hook', 'index', 'init', 'prepare', 'prompt', 'stack', 'verify']);
+const COMMANDS = new Set(['adopt', 'check', 'codex', 'context', 'hook', 'index', 'init', 'inspect', 'prepare', 'prompt', 'stack', 'verify']);
 
 function parseCommand(argv) {
   if (argv.length === 0 || argv.includes('--help') || argv.includes('-h') || argv[0] === 'help') {
@@ -96,9 +101,16 @@ function parseCommand(argv) {
     }
   } else if (command === 'context' && operands.length === 0) {
     fail('CONTEXT_PATH_REQUIRED', 'Command context requires at least one project path.');
+  } else if (command === 'inspect') {
+    if (operands.length !== 1 || !['workspace', 'environment', 'launch', 'deployment'].includes(operands[0])) {
+      fail(
+        'CLI_INSPECT_TARGET_REQUIRED',
+        'Command inspect requires exactly one of: workspace, environment, launch, deployment.',
+      );
+    }
   } else if (command === 'hook' && (operands.length !== 1 || !['begin', 'discover', 'end', 'session', 'stop'].includes(operands[0]))) {
     fail('CLI_HOOK_ACTION_REQUIRED', 'Command hook requires exactly one of: discover, session, begin, stop, end.');
-  } else if (!['adopt', 'context', 'hook', 'index', 'prompt'].includes(command) && operands.length > 0) {
+  } else if (!['adopt', 'context', 'hook', 'index', 'inspect', 'prompt'].includes(command) && operands.length > 0) {
     fail('CLI_EXTRA_ARGUMENT', `Command ${command} accepts no arguments.`);
   }
   return { command, operands, options };
@@ -128,6 +140,31 @@ function writeCheck(result) {
   line(process.stdout, `Check: ${result.status}`);
 }
 
+function writeInspection(result) {
+  const title = result.inspection[0].toUpperCase() + result.inspection.slice(1);
+  line(process.stdout, `${title}: ${result.status}`);
+  namedItems('Components', result.components);
+  namedItems('Runtimes', result.runtimeRequirements);
+  if (result.inspection === 'workspace') {
+    namedItems('Preparation steps', result.steps.map(({ label, argv, workdir }) => (
+      `${label} in ${workdir}: ${argv.join(' ')}`
+    )));
+  } else if (result.inspection === 'environment') {
+    namedItems('Public defaults', result.environmentDefaults.map(({ name, value }) => `${name}=${value}`));
+    namedItems('Environment files', result.files.map(({ format, path: filePath }) => `${format}: ${filePath}`));
+  } else if (result.inspection === 'launch') {
+    namedItems('Targets', result.targets.map(({ id, label, urlPath, steps }) => (
+      `${id} (${label}) ${urlPath}: ${steps.map(({ argv }) => argv.join(' ')).join(' -> ')}`
+    )));
+  } else {
+    namedItems('Deployment steps', result.steps.map(({ label, argv }) => `${label}: ${argv.join(' ')}`));
+  }
+  namedItems('Resources', result.resources.map(({ component, resource }) => (
+    `${resource.id} (${resource.kind}, ${component})`
+  )));
+  for (const item of result.diagnostics || []) line(process.stdout, `${item.code}: ${item.message}`);
+}
+
 function writeResult(command, result) {
   if (command === 'prompt') {
     process.stdout.write(result.prompt.endsWith('\n') ? result.prompt : `${result.prompt}\n`);
@@ -167,6 +204,10 @@ function writeResult(command, result) {
     line(process.stdout, `index: ${result.status}`);
     return;
   }
+  if (command === 'inspect') {
+    writeInspection(result);
+    return;
+  }
   if (command === 'prepare') {
     if (result.summary) line(process.stdout, result.summary);
     namedItems('Commands', result.commands?.map(({ label, argv }) => `${label}: ${argv.join(' ')}`));
@@ -241,6 +282,15 @@ async function execute({ command, operands, options }) {
   }
   if (command === 'context') return getContext({ paths: operands, projectRoot });
   if (command === 'index') return indexCodebase({ projectRoot, queries: operands });
+  if (command === 'inspect') {
+    const inspections = {
+      workspace: inspectWorkspaceSetup,
+      environment: inspectEnvironment,
+      launch: inspectLaunch,
+      deployment: inspectDeployment,
+    };
+    return { inspection: operands[0], ...await inspections[operands[0]]({ projectRoot }) };
+  }
   if (command === 'prepare') {
     return prepareWorkspace({
       projectRoot,

package/src/index/assets.js

@@ -3,6 +3,7 @@ import { readFile } from 'node:fs/promises';
 const root = new URL('../../', import.meta.url);
 const assets = {
   start: new URL('prompts/start.txt', root),
+  adopt: new URL('prompts/adopt.txt', root),
   work: new URL('prompts/work.txt', root),
   describe: new URL('prompts/describe.txt', root),
   reconcile: new URL('prompts/reconcile.txt', root),

package/src/index/codex-hooks.js

@@ -156,8 +156,9 @@ export async function codexAdoptionRecommendation({ projectRoot = process.cwd()
     output: [
       'IMPORTANT GENESIS RECOMMENDATION:',
       'This existing project has no Genesis explanatory layer.',
-      'In your first response, strongly recommend that the user run `genesis adopt` before substantial work.',
-      '`genesis adopt` preserves the implementation and returns the prompt for creating its initial Blueprint and Program.',
+      'In your first response, strongly recommend preparing this existing project for guided editing before substantial work.',
+      'Explain in product language that preparation preserves the implementation while importing its current operational and product context. Do not require the user to know Genesis terminology or type a command.',
+      'If the user approves, run `genesis adopt` yourself and follow the returned adoption prompt.',
       'Do not run it without the user\'s approval. If they agree, run it and follow the returned prompt in this conversation.',
       'If the user declines, continue normally and do not repeat the recommendation in this session.',
     ].join('\n'),

package/src/index/prompt.js

@@ -14,9 +14,10 @@ import { stableJson } from './utils.js';
 import { gitVisibleFileStates } from './project-files.js';
 import { isProjectContentPath } from './paths.js';
 
-const TASKS = new Set(['start', 'work', 'deslop', 'program', 'blueprint', 'describe', 'review']);
+const TASKS = new Set(['start', 'adopt', 'work', 'deslop', 'program', 'blueprint', 'describe', 'review']);
 const DEFAULT_REQUEST = {
   start: 'Start a conversation about this project.',
+  adopt: 'Import the existing project into a truthful Genesis project contract.',
   work: 'Implement the product intent expressed by the current Blueprint.',
   deslop: 'Simplify the current Git-visible work without making unrelated changes.',
   program: 'Refresh the complete useful Program for the code that exists now.',
@@ -97,6 +98,7 @@ function renderPrompt({
   skills = '',
   guidance = '',
   cleanup = '',
+  adoption = '',
 }) {
   return [
     instructions.trim(),
@@ -111,12 +113,58 @@ function renderPrompt({
     stableJson(context).trimEnd(),
     '```',
     ...(guidance ? ['', 'SELECTED STACK GUIDANCE', '', guidance] : []),
+    ...(adoption ? ['', 'SELECTED STACK ADOPTION GUIDANCE', '', adoption] : []),
     ...(skills ? ['', 'AVAILABLE AGENT SKILLS', '', skills] : []),
     ...(cleanup ? ['', 'SELECTED STACK CLEANUP GUIDANCE', '', cleanup] : []),
     '',
   ].join('\n');
 }
 
+async function generateAdoptionPrompt({ environment, instructions, program, request, root }) {
+  const blueprint = await readBlueprint(root, { required: true });
+  const [stack, index, catalog] = await Promise.all([
+    readStack(root),
+    buildProjectIndex({ projectRoot: root, write: false }),
+    listBuiltinStackPieces(),
+  ]);
+  const projectSkills = await inspectProjectSkills({ projectRoot: root, stack });
+  const missing = missingStackResources({
+    environment: withStackEnvironmentDefaults(environment, stack.environmentDefaults),
+    resources: stack.resources,
+  });
+  return {
+    status: 'ready',
+    task: 'adopt',
+    prompt: renderPrompt({
+      instructions,
+      request,
+      context: {
+        task: 'adopt',
+        projectRoot: root,
+        projectKind: 'existing',
+        blueprint: { path: blueprint.path, source: blueprint.source },
+        stack: stackPromptContext(stack),
+        availableStackPieces: stackCatalogContext(catalog),
+        program: programContext(program),
+        resourceInputs: missing.length > 0
+          ? { status: 'missing', diagnostics: missing }
+          : { status: 'present' },
+        codeIndex: codeIndexContext(index),
+      },
+      guidance: stack.guidance,
+      adoption: stack.adoption,
+      skills: renderAgentSkillCatalog(projectSkills.skills),
+    }),
+    warnings: [
+      ...(program.diagnostic ? [program.diagnostic] : []),
+      ...missing,
+      ...projectSkills.diagnostics,
+      ...index.diagnostics,
+    ],
+    verificationCommands: [],
+  };
+}
+
 async function generateExplanationPrompt({ instructions, program, request, root, task }) {
   const blueprint = await readBlueprint(root, {
     required: true,
@@ -268,6 +316,15 @@ export async function generateProjectPrompt({
       root,
     });
   }
+  if (task === 'adopt') {
+    return generateAdoptionPrompt({
+      environment,
+      instructions,
+      program,
+      request: userRequest,
+      root,
+    });
+  }
   let stack;
   if (task === 'work') {
     try {

package/src/index/stack-catalog.js

@@ -61,6 +61,7 @@ export async function listBuiltinStackPieces() {
       id: piece.id,
       description: piece.description,
       guidance: piece.guidance,
+      adoption: piece.adoption,
       requires: piece.requires,
       conflicts: piece.conflicts,
       cityExclusions: piece.cityExclusions,

package/src/index/stack-environment-defaults.js

@@ -14,6 +14,8 @@ export function parseStackEnvironmentDefaultLines(lines, {
   path: defaultsPath = 'stack environment defaults',
 } = {}) {
   if (lines === undefined) return [];
+  const present = lines.map((line) => line.trim()).filter(Boolean);
+  if (present.length === 1 && present[0] === '- Nothing.') return [];
   const defaults = [];
   for (let index = 0; index < lines.length; index += 1) {
     const source = lines[index].trim();

package/src/index/stack-launch.js

@@ -7,9 +7,8 @@ import {
 
 const ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 const PLACEHOLDER = /\{([a-z][a-z0-9-]*)\}/gu;
-const PREVIEW_IDENTITY_COMMAND_PATH = /^\.vibe64\/bin\/[A-Za-z0-9][A-Za-z0-9._-]*$/u;
 const PREVIEW_IDENTITY_ENVIRONMENT_NAME = /^[A-Z_][A-Z0-9_]*$/u;
-const PREVIEW_IDENTITY_PROTOCOL = 'vibe64.preview-identity.command.v1';
+const PREVIEW_IDENTITY_PROTOCOL = 'genesis.preview-identity.command.v1';
 const PREVIEW_IDENTITY_RESERVED_ENVIRONMENT_NAMES = new Set([
   'HOME',
   'LOGNAME',
@@ -17,8 +16,6 @@ const PREVIEW_IDENTITY_RESERVED_ENVIRONMENT_NAMES = new Set([
   'PATH',
   'TMPDIR',
   'USER',
-  'VIBE64_PREVIEW_IDENTITY_ENABLED',
-  'VIBE64_PREVIEW_IDENTITY_SECRET',
 ]);
 const PREVIEW_IDENTITY_TYPES = new Set(['email', 'login', 'user-id']);
 const PREVIEW_FIELDS = [
@@ -291,12 +288,14 @@ function normalizePreviewIdentity(draft, launchPath, targetId) {
   if (
     command.length > 64
     || command.some((entry) => !entry.trim() || entry.length > 4096 || /[\r\n]/u.test(entry))
-    || !PREVIEW_IDENTITY_COMMAND_PATH.test(command[0])
+    || !command[0].includes('/')
+    || command[0].includes('\\')
+    || command[0].split('/').some((part) => !part || ['.', '..'].includes(part))
     || command.some((entry) => /\{(?:host|port)\}/u.test(entry))
   ) {
     invalid(
       launchPath,
-      'Preview identity command must use an app-owned executable under .vibe64/bin and contain at most 64 literal arguments.',
+      'Preview identity command must use a committed app-owned project-relative executable and contain at most 64 literal arguments.',
       draft.line,
     );
   }

package/src/index/stack-piece.js

@@ -10,7 +10,7 @@ import { normalizeSource } from './utils.js';
 
 const STACK_PIECE_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 const STACK_CUSTOMIZATION_TITLE = /^# Stack customization: ([a-z0-9]+(?:-[a-z0-9]+)*)\s*$/u;
-const STACK_CUSTOMIZATION_FIELDS = new Set(['Description', 'Guidance', 'Deslop']);
+const STACK_CUSTOMIZATION_FIELDS = new Set(['Description', 'Guidance', 'Adoption', 'Deslop']);
 
 export function normalizeStackPieceId(value, {
   code = 'STACK_PIECE_INVALID',
@@ -93,12 +93,12 @@ function customizationSections(source, piecePath) {
     if (/^#{1,3}\s+/u.test(line)) invalid(piecePath, `Unknown customization heading: ${line.trim()}.`);
     if (field) content.push(line);
     else if (line.trim()) {
-      invalid(piecePath, 'Customization content must be below Description, Guidance, or Deslop.');
+      invalid(piecePath, 'Customization content must be below Description, Guidance, Adoption, or Deslop.');
     }
   }
   finishField();
   if (Object.values(result).every((values) => Object.keys(values).length === 0)) {
-    invalid(piecePath, 'Stack customization must add or override Description, Guidance, or Deslop.');
+    invalid(piecePath, 'Stack customization must add or override Description, Guidance, Adoption, or Deslop.');
   }
   return result;
 }
@@ -151,18 +151,22 @@ function skill(all, piecePath) {
   };
 }
 
-function resources(all, piecePath) {
-  const source = textSection(all, 'Resources');
+export function parseStackResourceLines(lines, {
+  path: resourcePath = 'stack resources',
+} = {}) {
+  if (lines === undefined) return [];
+  const source = lines.join('\n').trim();
   if (!source) return [];
+  if (source === '- Nothing.') return [];
   const blocks = [...source.matchAll(/```json genesis-resource\s*\n([\s\S]*?)\n```/gu)];
   const outside = source.replace(/```json genesis-resource\s*\n[\s\S]*?\n```/gu, '').trim();
   if (outside || blocks.length === 0) {
-    invalid(piecePath, '## Resources may contain only `json genesis-resource` fenced objects.');
+    invalid(resourcePath, '## Resources may contain only `json genesis-resource` fenced objects.');
   }
   const parsed = blocks.map((match) => {
     let resource;
     try { resource = JSON.parse(match[1]); } catch (error) {
-      invalid(piecePath, `A Stack resource is invalid JSON: ${error.message}`);
+      invalid(resourcePath, `A Stack resource is invalid JSON: ${error.message}`);
     }
     if (
       !resource
@@ -173,7 +177,7 @@ function resources(all, piecePath) {
       || !Array.isArray(resource.environmentAlternatives)
       || resource.environmentAlternatives.length === 0
     ) {
-      invalid(piecePath, 'A Stack resource needs an id, kind, and at least one environment alternative.');
+      invalid(resourcePath, 'A Stack resource needs an id, kind, and at least one environment alternative.');
     }
     const environmentAlternatives = resource.environmentAlternatives.map((alternative) => {
       const required = alternative?.required;
@@ -182,7 +186,7 @@ function resources(all, piecePath) {
         !Array.isArray(required)
         || !Array.isArray(allowEmpty)
       ) {
-        invalid(piecePath, `Stack resource ${resource.id} has an invalid environment alternative.`);
+        invalid(resourcePath, `Stack resource ${resource.id} has an invalid environment alternative.`);
       }
       const names = [...required, ...allowEmpty];
       if (
@@ -191,17 +195,23 @@ function resources(all, piecePath) {
         || allowEmpty.some((name) => !required.includes(name))
         || new Set(required).size !== required.length
         || new Set(allowEmpty).size !== allowEmpty.length
-      ) invalid(piecePath, `Stack resource ${resource.id} has an invalid environment alternative.`);
+      ) invalid(resourcePath, `Stack resource ${resource.id} has an invalid environment alternative.`);
       return { required: [...required], allowEmpty: [...allowEmpty] };
     });
     return { id: resource.id, kind: resource.kind, environmentAlternatives };
   });
   if (new Set(parsed.map(({ id }) => id)).size !== parsed.length) {
-    invalid(piecePath, '## Resources contains a duplicate resource id.');
+    invalid(resourcePath, '## Resources contains a duplicate resource id.');
   }
   return parsed;
 }
 
+function resources(all, piecePath) {
+  return parseStackResourceLines(all.has('Resources') ? all.get('Resources') : undefined, {
+    path: piecePath,
+  });
+}
+
 /**
  * Stack pieces are guidance, not a second programming language. Genesis reads
  * only the few sections it uses and deliberately ignores explanatory sections.
@@ -218,6 +228,7 @@ export function parseStackPieceSource(value, {
   const all = sections(source);
   const description = textSection(all, 'Description');
   const guidance = textSection(all, 'Guidance');
+  const adoption = textSection(all, 'Adoption');
   const deslop = textSection(all, 'Deslop');
   if (!description) invalid(piecePath, 'Stack piece needs Description.');
   const commands = parseStackCommandLines(all.get('Commands') || [], { path: piecePath });
@@ -248,6 +259,7 @@ export function parseStackPieceSource(value, {
     id,
     description,
     guidance,
+    adoption,
     requires: idList(all, 'Requires', piecePath, { required: true }),
     conflicts: idList(all, 'Conflicts', piecePath),
     indexers: idList(all, 'Indexers', piecePath),
@@ -299,6 +311,11 @@ export function applyStackPieceCustomization(piece, customization) {
       customization.override.guidance,
       customization.add.guidance,
     ),
+    adoption: customizedText(
+      piece.adoption,
+      customization.override.adoption,
+      customization.add.adoption,
+    ),
     deslop: customizedText(piece.deslop, customization.override.deslop, customization.add.deslop),
   };
 }

package/src/index/stack.js

@@ -10,6 +10,7 @@ import { composeStackDeployment, parseStackDeploymentLines } from './stack-deplo
 import { resolveStackPieces } from './stack-composition.js';
 import {
   composeStackEnvironmentDefaults,
+  parseStackEnvironmentDefaultLines,
 } from './stack-environment-defaults.js';
 import {
   composeStackEnvironmentFiles,
@@ -24,6 +25,7 @@ import {
   applyStackPieceCustomization,
   normalizeStackPieceId,
   parseStackPieceCustomizationSource,
+  parseStackResourceLines,
 } from './stack-piece.js';
 import { STACK_PATH } from './paths.js';
 import { sha256, stableJson, writeFileAtomic } from './utils.js';
@@ -32,6 +34,8 @@ const COMPONENT_LINE = /^- `([a-z0-9]+(?:-[a-z0-9]+)*)`$/u;
 export const EMPTY_STACK_SOURCE = '# Stack\n\n## Components\n';
 const STACK_SECTIONS = new Set([
   'Components',
+  'Resources',
+  'Environment defaults',
   'Environment files',
   'Workspace setup',
   'Commands',
@@ -104,8 +108,10 @@ function renderStack({
   commandLines = [],
   componentIds: componentIdsValue,
   deploymentLines = null,
+  environmentDefaultLines = null,
   environmentFileLines = null,
   launchLines = null,
+  resourceLines = null,
   workspaceSetupLines = null,
 }) {
   return [
@@ -113,6 +119,12 @@ function renderStack({
     '',
     '## Components',
     ...componentIdsValue.map((id) => `- \`${id}\``),
+    ...(resourceLines === null
+      ? []
+      : ['', '## Resources', '', ...withoutOuterBlankLines(resourceLines)]),
+    ...(environmentDefaultLines === null
+      ? []
+      : ['', '## Environment defaults', '', ...withoutOuterBlankLines(environmentDefaultLines)]),
     ...(environmentFileLines === null
       ? []
       : ['', '## Environment files', '', ...withoutOuterBlankLines(environmentFileLines)]),
@@ -153,6 +165,15 @@ export async function addStackPieces({ pieces, projectRoot }) {
   )).map(({ id }) => id);
   const commandLines = parseStackCommandLines(sections.get('Commands') || [], { path: STACK_PATH })
     .map(({ label, argv }) => `- Verify \`${label}\`: ${argv.map((value) => `\`${value}\``).join(' ')}`);
+  const resourceLines = sections.has('Resources') ? sections.get('Resources') : null;
+  parseStackResourceLines(resourceLines === null ? undefined : resourceLines, { path: STACK_PATH });
+  const environmentDefaultLines = sections.has('Environment defaults')
+    ? sections.get('Environment defaults')
+    : null;
+  parseStackEnvironmentDefaultLines(
+    environmentDefaultLines === null ? undefined : environmentDefaultLines,
+    { path: STACK_PATH },
+  );
   const environmentFileLines = sections.has('Environment files')
     ? sections.get('Environment files')
     : null;
@@ -178,8 +199,10 @@ export async function addStackPieces({ pieces, projectRoot }) {
     commandLines,
     componentIds: selected,
     deploymentLines,
+    environmentDefaultLines,
     environmentFileLines,
     launchLines,
+    resourceLines,
     workspaceSetupLines,
   });
   const stackChanged = rendered !== source;
@@ -266,8 +289,19 @@ export async function readStack(projectRoot) {
   const componentCommands = components.flatMap((piece) => piece.commands);
   const commands = distinctCommands(projectCommands.length > 0 ? projectCommands : componentCommands);
   const cityPresentation = composeStackCityPresentation(components);
-  const resources = resourceDeclarations(components);
-  const environmentDefaults = composeStackEnvironmentDefaults(components);
+  const projectResources = sections.has('Resources')
+    ? parseStackResourceLines(sections.get('Resources'), { path: STACK_PATH })
+    : null;
+  const resources = projectResources === null
+    ? resourceDeclarations(components)
+    : projectResources.map((resource) => ({ component: 'project', resource }));
+  const projectEnvironmentDefaults = parseStackEnvironmentDefaultLines(
+    sections.has('Environment defaults') ? sections.get('Environment defaults') : undefined,
+    { path: STACK_PATH },
+  );
+  const environmentDefaults = sections.has('Environment defaults')
+    ? projectEnvironmentDefaults.map((entry) => ({ ...entry, sources: ['project'] }))
+    : composeStackEnvironmentDefaults(components);
   const projectEnvironmentFiles = parseStackEnvironmentFileLines(
     sections.has('Environment files') ? sections.get('Environment files') : undefined,
     { path: STACK_PATH },
@@ -313,6 +347,7 @@ export async function readStack(projectRoot) {
     workspaceSetup,
     resources,
     guidance: composedProse(components, 'guidance'),
+    adoption: composedProse(components, 'adoption'),
     deslop: composedProse(components, 'deslop'),
   };
 }
@@ -323,12 +358,14 @@ export function stackPromptContext(stack) {
       id: piece.id,
       description: piece.description,
       ...(piece.guidance ? { guidance: piece.guidance } : {}),
+      ...(piece.adoption ? { adoption: piece.adoption } : {}),
       requires: piece.requires,
     })),
     cityExclusions: stack.cityExclusions,
     cityRegions: stack.cityRegions,
     verifyCommands: stack.commands.map(({ label, argv }) => ({ label, argv })),
     environmentDefaults: stack.environmentDefaults,
+    resources: stack.resources,
     environmentFiles: stack.environmentFiles,
     launchTargets: stack.launchTargets,
     deployment: stack.deployment,

package/src/index.js

@@ -44,7 +44,7 @@ export async function adoptProject({ projectRoot = process.cwd(), request = '' }
   const description = await generateProjectPrompt({
     projectRoot,
     request,
-    task: 'describe',
+    task: 'adopt',
   });
   return {
     status: 'ready',
@@ -54,7 +54,7 @@ export async function adoptProject({ projectRoot = process.cwd(), request = '' }
     changedFiles: initialized.changedFiles,
     prompt: description.prompt,
     warnings: description.warnings,
-    guidance: 'Follow the generated description prompt now. Genesis does not start another agent.',
+    guidance: 'Follow the generated adoption prompt now. Genesis does not start another agent.',
   };
 }
 

package/stacks/pieces/cpp.md

@@ -12,6 +12,18 @@ C and C++ translation-unit, header, callable, ownership, build, and test convent
 
 - `cpp`
 
+## Adoption
+
+- Identify the actual build system and presets, compiler and language level,
+  package/runtime dependencies, generated-source steps, and supported build
+  configurations without substituting a preferred CMake or Meson layout.
+- Record exact configure/build/test commands and the executable argv, workdir,
+  host/port handling, HTTP readiness predicate, and signal/shutdown contract for
+  every web-service target.
+- Preserve public headers, ABI and platform assumptions. Treat databases,
+  queues, TLS material, and external service credentials as explicit Resources,
+  not implicit properties of the native binary.
+
 ## Deslop
 
 - Preserve public header boundaries, ABI expectations, build configuration,

package/stacks/pieces/jskit-mysql.md

@@ -35,6 +35,16 @@ JSKIT MySQL runtime, live-schema CRUD generation, and persistence conventions.
 }
 ```
 
+## Adoption
+
+- Confirm that the application's effective MySQL environment alternatives and
+  driver match this Resource declaration; add a project Resource contract when
+  the existing application legitimately differs.
+- Verify from source that the database preparation path discovers every
+  package-owned migration, preserves the existing ledger, orders cross-package
+  constraints safely, and invokes an app-owned idempotent seed. Do not execute
+  it during adoption.
+
 ## Deslop
 
 - Use the installed JSKIT database runtime and generated resource/repository

package/stacks/pieces/jskit-postgresql.md

@@ -35,6 +35,16 @@ JSKIT PostgreSQL runtime, live-schema CRUD generation, and persistence conventio
 }
 ```
 
+## Adoption
+
+- Confirm that the application's effective PostgreSQL environment alternatives
+  and driver match this Resource declaration; add a project Resource contract
+  when the existing application legitimately differs.
+- Verify from source that the database preparation path discovers every
+  package-owned migration, preserves the existing ledger, orders cross-package
+  constraints safely, and invokes an app-owned idempotent seed. Do not execute
+  it during adoption.
+
 ## Deslop
 
 - Use the installed JSKIT database runtime and generated resource/repository

package/stacks/pieces/jskit.md

@@ -27,6 +27,29 @@ application-owned composition.
   user-command failures through JSKIT's shared non-layout-shifting action
   feedback/snackbar path.
 
+## Adoption
+
+- Read the installed JSKIT skill's existing-application migration guidance
+  completely before editing Stack or assessing readiness.
+- Inventory the coordinated `@jskit-ai/*` package graph, application-owned
+  composition, package-owned migrations, explicit repositories/features/named
+  actions, and current client resources without running a broad package update.
+- Compare the real package scripts with JSKIT's current Workspace setup,
+  Launch, verification, and Deployment declarations. Older source needs complete
+  project-owned overrides until a separately approved port supplies the current
+  commands.
+- Inspect existing setup and database preparation for both migration discovery
+  and an app-owned idempotent seed. Never infer `db:prepare` from the selected
+  component when the script or preparation file does not exist.
+- When authenticated Preview exists, preserve the app-owned Preview identity
+  command, selectors, protocol, environment names, runtime, and timeout in the
+  project's Launch declaration. A host-saved identity name/value is not a
+  substitute for this application contract.
+- Treat generator descriptors, receipts, sync commands, legacy service
+  locators, and retired tool manifests as migration evidence only. Translate
+  live facts into current source/Stack and report remaining port work; do not
+  add compatibility readers or claim adoption performed the port.
+
 ## Workspace setup
 
 - Prepare `Install dependencies` with `nodejs` when `package.json` exists: `npm` `install`