erdos-problems 0.2.9 → 0.3.0

package/src/commands/paper.js

@@ -0,0 +1,147 @@
+import { getProblem } from '../atlas/catalog.js';
+import { getPaperBundleOverview, initPaperBundle } from '../runtime/paper.js';
+import { getWorkspaceRoot } from '../runtime/paths.js';
+import { readCurrentProblem } from '../runtime/workspace.js';
+
+function parsePaperArgs(args) {
+  const parsed = {
+    problemId: null,
+    destination: null,
+    asJson: false,
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const token = args[index];
+    if (token === '--dest') {
+      parsed.destination = args[index + 1];
+      if (!parsed.destination) {
+        return { error: 'Missing destination path after --dest.' };
+      }
+      index += 1;
+      continue;
+    }
+    if (token === '--json') {
+      parsed.asJson = true;
+      continue;
+    }
+    if (!parsed.problemId) {
+      parsed.problemId = token;
+      continue;
+    }
+    return { error: `Unknown paper option: ${token}` };
+  }
+
+  return parsed;
+}
+
+function printPaperOverview(overview) {
+  console.log(`Paper bundle for Erdos Problem #${overview.problemId}`);
+  console.log(`Title: ${overview.title}`);
+  console.log(`Paper mode: ${overview.paperMode}`);
+  console.log(`Bundle dir: ${overview.bundleDir}`);
+  if (overview.bundlePublicPath) {
+    console.log(`Repo bundle path: ${overview.bundlePublicPath}`);
+  }
+  console.log(`Created at: ${overview.createdAt}`);
+  console.log(`Last initialized: ${overview.lastInitializedAt}`);
+  console.log(`Public evidence: canonical=${overview.publicEvidenceSummary.canonicalArtifacts}, pack=${overview.publicEvidenceSummary.packProblemArtifacts}, compute=${overview.publicEvidenceSummary.computePackets}`);
+  console.log('Core files:');
+  console.log(`- manifest: ${overview.paths.manifest}`);
+  console.log(`- writer brief: ${overview.paths.writerBrief}`);
+  console.log(`- evidence index: ${overview.paths.evidenceIndex}`);
+  console.log(`- section status: ${overview.paths.sectionStatus}`);
+  console.log(`- privacy review: ${overview.paths.privacyReview}`);
+  console.log(`- citation ledger: ${overview.paths.citationLedger}`);
+  console.log('Sections:');
+  for (const section of overview.sections) {
+    console.log(`- ${section.fileName}: ${section.exists ? 'present' : 'missing'} (${section.title})`);
+  }
+}
+
+export function runPaperCommand(args) {
+  const [subcommand, ...rest] = args;
+
+  if (!subcommand || subcommand === 'help' || subcommand === '--help') {
+    console.log('Usage:');
+    console.log('  erdos paper init [<id>] [--dest <path>] [--json]');
+    console.log('  erdos paper show [<id>] [--dest <path>] [--json]');
+    return 0;
+  }
+
+  const workspaceRoot = getWorkspaceRoot();
+
+  if (subcommand === 'init') {
+    const parsed = parsePaperArgs(rest);
+    if (parsed.error) {
+      console.error(parsed.error);
+      return 1;
+    }
+
+    const problemId = parsed.problemId ?? readCurrentProblem();
+    if (!problemId) {
+      console.error('Missing problem id and no active problem is selected.');
+      return 1;
+    }
+
+    const problem = getProblem(problemId, workspaceRoot);
+    if (!problem) {
+      console.error(`Unknown problem: ${problemId}`);
+      return 1;
+    }
+
+    const result = initPaperBundle(problem.problemId, {
+      destination: parsed.destination,
+      workspaceRoot,
+    });
+
+    if (parsed.asJson) {
+      console.log(JSON.stringify(result, null, 2));
+      return 0;
+    }
+
+    console.log(`Paper bundle ${result.mode}: ${result.bundleDir}`);
+    console.log(`Problem: ${problem.displayName} (${problem.title})`);
+    console.log(`Paper mode: ${result.manifest.paperMode}`);
+    console.log(`Created files: ${result.createdFiles.length}`);
+    console.log(`Preserved files: ${result.preservedFiles.length}`);
+    console.log(`Updated indexes: ${result.updatedFiles.join(', ')}`);
+    console.log('Start here: WRITER_BRIEF.md, PUBLIC_EVIDENCE_INDEX.json, SECTION_STATUS.md');
+    return 0;
+  }
+
+  if (subcommand === 'show') {
+    const parsed = parsePaperArgs(rest);
+    if (parsed.error) {
+      console.error(parsed.error);
+      return 1;
+    }
+
+    const problemId = parsed.problemId ?? readCurrentProblem();
+    if (!problemId) {
+      console.error('Missing problem id and no active problem is selected.');
+      return 1;
+    }
+
+    let overview;
+    try {
+      overview = getPaperBundleOverview(problemId, {
+        destination: parsed.destination,
+        workspaceRoot,
+      });
+    } catch (error) {
+      console.error(error.message);
+      return 1;
+    }
+
+    if (parsed.asJson) {
+      console.log(JSON.stringify(overview, null, 2));
+      return 0;
+    }
+
+    printPaperOverview(overview);
+    return 0;
+  }
+
+  console.error(`Unknown paper subcommand: ${subcommand}`);
+  return 1;
+}

package/src/commands/problem.js

@@ -99,8 +99,8 @@ function printProblem(problem) {
   }
   console.log(`Prize: ${problem.prize ?? '(none)'}`);
   console.log(`Formalization: ${problem.formalizationStatus}`);
-  console.log(`Upstream formalized: ${problem.upstreamFormalizedState ?? '(unknown)'}`);
-  console.log(`Upstream last update: ${problem.upstreamLastUpdate ?? '(unknown)'}`);
+  console.log(`Imported formalized: ${problem.importedFormalizedState ?? '(unknown)'}`);
+  console.log(`Imported last update: ${problem.importedLastUpdate ?? '(unknown)'}`);
   console.log(`Related: ${problem.relatedProblems.join(', ') || '(none)'}`);
   console.log(`Tags: ${problem.familyTags.join(', ') || '(none)'}`);
   console.log(`Statement: ${problem.shortStatement}`);
@@ -111,11 +111,11 @@ function printProblem(problem) {
     console.log(`  route breakthrough: ${problem.researchState.route_breakthrough ? 'yes' : 'no'}`);
     console.log(`  problem solved: ${problem.researchState.problem_solved ? 'yes' : 'no'}`);
   }
-  if (problem.upstream) {
-    console.log('Upstream provenance:');
-    console.log(`  repo: ${problem.upstream.repo}`);
-    console.log(`  data file: ${problem.upstream.data_file}`);
-    console.log(`  number: ${problem.upstream.number}`);
+  if (problem.externalSource) {
+    console.log('External import provenance:');
+    console.log(`  repo: ${problem.externalSource.repo}`);
+    console.log(`  data file: ${problem.externalSource.data_file}`);
+    console.log(`  number: ${problem.externalSource.number}`);
   }
 }
 
@@ -154,13 +154,13 @@ function printArtifactInventory(problem, inventory, asJson) {
     }
   }
   if (inventory.upstreamSnapshot) {
-    console.log('Upstream snapshot:');
+    console.log('External import snapshot:');
     console.log(`- kind: ${inventory.upstreamSnapshot.kind}`);
     console.log(`- manifest: ${inventory.upstreamSnapshot.manifestPath}`);
     console.log(`- index: ${inventory.upstreamSnapshot.indexPath}`);
     console.log(`- commit: ${inventory.upstreamSnapshot.upstreamCommit ?? '(unknown)'}`);
   }
-  console.log(`Upstream record available: ${inventory.upstreamRecordIncluded ? 'yes' : 'no'}`);
+  console.log(`Imported record available: ${inventory.upstreamRecordIncluded ? 'yes' : 'no'}`);
 }
 
 export function runProblemCommand(args) {

package/src/commands/pull.js

@@ -142,7 +142,7 @@ function writeUpstreamOnlyBundle(problemId, destination, upstreamRecord, snapsho
           manifestPath: snapshot.manifestPath,
           indexPath: snapshot.indexPath,
           yamlPath: snapshot.yamlPath,
-          upstreamCommit: snapshot.manifest.upstream_commit ?? null,
+          upstreamCommit: snapshot.manifest.imported_commit ?? snapshot.manifest.upstream_commit ?? null,
           fetchedAt: snapshot.manifest.fetched_at,
         }
       : null,
@@ -156,7 +156,7 @@ function writeUpstreamOnlyBundle(problemId, destination, upstreamRecord, snapsho
       'This bundle was generated from upstream public metadata.',
       '',
       `- Source: https://www.erdosproblems.com/${problemId}`,
-      `- Upstream record included: ${upstreamRecord ? 'yes' : 'no'}`,
+      `- Imported record included: ${upstreamRecord ? 'yes' : 'no'}`,
       '',
       'This problem is not yet seeded locally as a canonical dossier in this package.',
       '',
@@ -476,7 +476,7 @@ async function writeLiteratureLane(
       'This literature lane was generated by the erdos CLI.',
       '',
       `- Local dossier included: ${localProblem ? 'yes' : 'no'}`,
-      `- Upstream record included: ${upstreamRecord ? 'yes' : 'no'}`,
+      `- Imported record included: ${upstreamRecord ? 'yes' : 'no'}`,
       `- Live site snapshot included: ${siteStatus.included ? 'yes' : 'no'}`,
       `- Public search review included: ${publicSearch.included ? 'yes' : 'no'}`,
       `- Crossref adapter included: ${crossref.included ? 'yes' : 'no'}`,
@@ -511,7 +511,7 @@ function writeRootProblemBundle(rootDir, problemId, localProblem, upstreamRecord
     artifactsDir,
     literatureDir,
     snapshotKind: snapshot?.kind ?? null,
-    upstreamCommit: snapshot?.manifest.upstream_commit ?? null,
+    upstreamCommit: snapshot?.manifest.imported_commit ?? snapshot?.manifest.upstream_commit ?? null,
   });
   writeText(
     path.join(rootDir, 'README.md'),
@@ -523,7 +523,7 @@ function writeRootProblemBundle(rootDir, problemId, localProblem, upstreamRecord
       `- Artifacts lane: ${artifactsDir}`,
       `- Literature lane: ${literatureDir}`,
       `- Local canonical dossier available: ${localProblem ? 'yes' : 'no'}`,
-      `- Upstream record included: ${upstreamRecord ? 'yes' : 'no'}`,
+      `- Imported record included: ${upstreamRecord ? 'yes' : 'no'}`,
       '',
     ].join('\n'),
   );
@@ -591,7 +591,7 @@ export async function runPullCommand(args, options = {}) {
     if (!silent) {
       console.log(`Artifact bundle created: ${destination}`);
       console.log(`Local canonical dossier included: ${localProblem ? 'yes' : 'no'}`);
-      console.log(`Upstream record included: ${upstreamRecord ? 'yes' : 'no'}`);
+      console.log(`Imported record included: ${upstreamRecord ? 'yes' : 'no'}`);
       console.log(`Artifacts copied: ${result.copiedArtifacts?.length ?? result.artifactsCopied ?? 0}`);
     }
     return 0;
@@ -632,7 +632,7 @@ export async function runPullCommand(args, options = {}) {
     if (!silent) {
       console.log(`Literature bundle created: ${destination}`);
       console.log(`Local dossier context included: ${localProblem ? 'yes' : 'no'}`);
-      console.log(`Upstream record included: ${upstreamRecord ? 'yes' : 'no'}`);
+      console.log(`Imported record included: ${upstreamRecord ? 'yes' : 'no'}`);
       console.log(`Live site snapshot included: ${result.siteStatus.included ? 'yes' : 'no'}`);
       console.log(`Public search review included: ${result.publicSearch.included ? 'yes' : 'no'}`);
       console.log(`Crossref adapter included: ${result.crossref.included ? 'yes' : 'no'}`);
@@ -719,7 +719,7 @@ export async function runPullCommand(args, options = {}) {
     console.log(`Artifact lane: ${artifactDestination}`);
     console.log(`Literature lane: ${literatureDestination}`);
     console.log(`Local canonical dossier included: ${localProblem ? 'yes' : 'no'}`);
-    console.log(`Upstream record included: ${upstreamRecord ? 'yes' : 'no'}`);
+    console.log(`Imported record included: ${upstreamRecord ? 'yes' : 'no'}`);
     console.log(`Live site snapshot included: ${literatureResult.siteStatus.included ? 'yes' : 'no'}`);
     console.log(`Public search review included: ${literatureResult.publicSearch.included ? 'yes' : 'no'}`);
     console.log(`Crossref adapter included: ${literatureResult.crossref.included ? 'yes' : 'no'}`);

package/src/commands/scaffold.js

@@ -55,6 +55,6 @@ export function runScaffoldCommand(args) {
   const result = scaffoldProblem(problem, destination);
   console.log(`Scaffold created: ${result.destination}`);
   console.log(`Artifacts copied: ${result.copiedArtifacts.length}`);
-  console.log(`Upstream record included: ${result.inventory.upstreamRecordIncluded ? 'yes' : 'no'}`);
+  console.log(`Imported record included: ${result.inventory.upstreamRecordIncluded ? 'yes' : 'no'}`);
   return 0;
 }

package/src/commands/seed.js

@@ -271,7 +271,7 @@ export async function runSeedCommand(args) {
   console.log(`Title: ${result.record.title}`);
   console.log(`Cluster: ${result.record.cluster}`);
   console.log(`Harness depth: ${result.record.harness.depth}`);
-  console.log(`Upstream record used: ${result.usedUpstreamRecord ? 'yes' : 'no'}`);
+  console.log(`Imported record used: ${result.usedUpstreamRecord ? 'yes' : 'no'}`);
   console.log(`Site snapshot used: ${result.usedSiteSnapshot ? 'yes' : 'no'}`);
   console.log(`Public status review used: ${result.usedPublicStatusReview ? 'yes' : 'no'}`);
   console.log(`ORP protocol: ${orp.protocolPath}`);

package/src/commands/upstream.js

@@ -1,4 +1,5 @@
 import { getProblem } from '../atlas/catalog.js';
+import { getBundledUpstreamDir, getWorkspaceUpstreamDir } from '../runtime/paths.js';
 import { fetchProblemSiteSnapshot } from '../upstream/site.js';
 import { buildUpstreamDiff, loadActiveUpstreamSnapshot, syncUpstream, writeDiffArtifacts } from '../upstream/sync.js';
 
@@ -23,7 +24,7 @@ function parseDriftArgs(args) {
       parsed.problemId = token;
       continue;
     }
-    return { error: `Unknown upstream drift option: ${token}` };
+    return { error: `Unknown import drift option: ${token}` };
   }
 
   return parsed;
@@ -34,31 +35,42 @@ export async function runUpstreamCommand(args) {
 
   if (!subcommand || subcommand === 'help' || subcommand === '--help') {
     console.log('Usage:');
-    console.log('  erdos upstream show');
-    console.log('  erdos upstream sync [--write-package-snapshot]');
-    console.log('  erdos upstream diff [--write-package-report]');
-    console.log('  erdos upstream drift [<id>] [--include-site] [--json]');
+    console.log('  erdos import show');
+    console.log('  erdos import sync [--write-package-snapshot]');
+    console.log('  erdos import diff [--write-package-report]');
+    console.log('  erdos import drift [<id>] [--include-site] [--json]');
     return 0;
   }
 
   if (subcommand === 'show') {
     const snapshot = loadActiveUpstreamSnapshot();
     if (!snapshot) {
-      console.log('No upstream snapshot available yet. Run `erdos upstream sync`.');
+      console.log('No import snapshot available yet. Run `erdos import sync`.');
       return 0;
     }
+    const manifest = snapshot.manifest;
+    const externalRepo = manifest.external_repo ?? manifest.upstream_repo;
+    const importedCommit = manifest.imported_commit ?? manifest.upstream_commit;
     console.log(`Snapshot kind: ${snapshot.kind}`);
-    console.log(`Upstream repo: ${snapshot.manifest.upstream_repo}`);
-    console.log(`Upstream commit: ${snapshot.manifest.upstream_commit ?? '(unknown)'}`);
-    console.log(`Fetched at: ${snapshot.manifest.fetched_at}`);
-    console.log(`Entries: ${snapshot.manifest.entry_count}`);
+    console.log(`Active source: ${snapshot.kind === 'workspace' ? 'workspace import override' : 'bundled import snapshot'}`);
+    console.log(`External import repo: ${externalRepo}`);
+    console.log(`Imported commit: ${importedCommit ?? '(unknown)'}`);
+    console.log(`Fetched at: ${manifest.fetched_at}`);
+    console.log(`Entries: ${manifest.entry_count}`);
+    console.log(`Active manifest: ${snapshot.manifestPath}`);
+    console.log(`Active index: ${snapshot.indexPath}`);
+    console.log(`Active yaml: ${snapshot.yamlPath}`);
+    console.log(`Bundled snapshot dir: ${getBundledUpstreamDir()}`);
+    console.log(`Workspace snapshot dir: ${getWorkspaceUpstreamDir()}`);
+    console.log('Refresh workspace import snapshot: erdos import sync');
+    console.log('Refresh bundled import snapshot (maintainers): erdos import sync --write-package-snapshot');
     return 0;
   }
 
   if (subcommand === 'sync') {
     const writePackageSnapshot = rest.includes('--write-package-snapshot');
     const result = await syncUpstream({ writePackageSnapshot });
-    console.log(`Fetched upstream commit: ${result.snapshot.manifest.upstream_commit ?? '(unknown)'}`);
+    console.log(`Fetched import commit: ${result.snapshot.manifest.imported_commit ?? '(unknown)'}`);
     console.log(`Workspace snapshot: ${result.workspacePaths.manifestPath}`);
     if (result.bundledPaths) {
       console.log(`Bundled snapshot: ${result.bundledPaths.manifestPath}`);
@@ -76,8 +88,8 @@ export async function runUpstreamCommand(args) {
     const diffArtifacts = writeDiffArtifacts({ writePackageReport });
     const diff = buildUpstreamDiff();
     console.log(`Local seeded problems: ${diff.localProblemCount}`);
-    console.log(`Upstream total problems: ${diff.upstreamProblemCount}`);
-    console.log(`Upstream-only count: ${diff.upstreamOnlyCount}`);
+    console.log(`External atlas total problems: ${diff.upstreamProblemCount}`);
+    console.log(`External-only count: ${diff.upstreamOnlyCount}`);
     console.log(`Workspace diff report: ${diffArtifacts.workspaceDiffPath}`);
     if (diffArtifacts.repoDiffPath) {
       console.log(`Repo diff report: ${diffArtifacts.repoDiffPath}`);
@@ -113,9 +125,9 @@ export async function runUpstreamCommand(args) {
         return 0;
       }
 
-      console.log('Upstream drift dashboard');
+      console.log('External atlas drift dashboard');
       console.log(`Local seeded problems: ${payload.localProblemCount}`);
-      console.log(`Upstream total problems: ${payload.upstreamProblemCount}`);
+      console.log(`External atlas total problems: ${payload.upstreamProblemCount}`);
       console.log(`Site-status drifts: ${payload.statusDriftCount}`);
       console.log(`Formalization drifts: ${payload.formalizationDriftCount}`);
       console.log(`Tag drifts: ${payload.tagDriftCount}`);
@@ -149,7 +161,7 @@ export async function runUpstreamCommand(args) {
             title: problem.title,
           }
         : null,
-      upstream: upstreamRecord
+      external: upstreamRecord
         ? {
             siteStatus: upstreamRecord.status?.state ?? null,
             formalizedState: upstreamRecord.formalized?.state ?? null,
@@ -171,19 +183,19 @@ export async function runUpstreamCommand(args) {
       return 0;
     }
 
-    console.log(`Upstream drift for problem ${parsed.problemId}`);
+    console.log(`External atlas drift for problem ${parsed.problemId}`);
     console.log(`Local site status: ${payload.local?.siteStatus ?? '(none)'}`);
-    console.log(`Upstream site status: ${payload.upstream?.siteStatus ?? '(none)'}`);
+    console.log(`External atlas site status: ${payload.external?.siteStatus ?? '(none)'}`);
     console.log(`Site snapshot status: ${payload.site?.siteStatus ?? '(not fetched)'}`);
     console.log(`Local repo status: ${payload.local?.repoStatus ?? '(none)'}`);
-    console.log(`Upstream formalized state: ${payload.upstream?.formalizedState ?? '(none)'}`);
-    console.log(`Upstream tags: ${payload.upstream?.tags?.join(', ') || '(none)'}`);
+    console.log(`Imported formalized state: ${payload.external?.formalizedState ?? '(none)'}`);
+    console.log(`External tags: ${payload.external?.tags?.join(', ') || '(none)'}`);
     if (siteError) {
       console.log(`Site fetch note: ${siteError}`);
     }
     return 0;
   }
 
-  console.error(`Unknown upstream subcommand: ${subcommand}`);
+  console.error(`Unknown import subcommand: ${subcommand}`);
   return 1;
 }

package/src/runtime/maintainer-seed.js

@@ -221,7 +221,7 @@ function buildProblemRecord(problemId, bundle, options) {
       url: `https://www.erdosproblems.com/${problemId}`,
       external_id: String(problemId),
     },
-    upstream: {
+    external_source: {
       repo: 'https://github.com/teorth/erdosproblems',
       data_file: 'data/problems.yaml',
       number: String(problemId),
@@ -230,7 +230,7 @@ function buildProblemRecord(problemId, bundle, options) {
       seeded_at: new Date().toISOString(),
       seeded_from: {
         kind: 'pull_bundle',
-        upstream_record_included: Boolean(bundle.upstreamRecord),
+        imported_record_included: Boolean(bundle.upstreamRecord),
         site_snapshot_included: Boolean(bundle.siteExtract || bundle.siteSummary),
         public_search_review_included: Boolean(bundle.publicStatusReview || bundle.publicStatusReviewMarkdown),
       },
@@ -239,8 +239,8 @@ function buildProblemRecord(problemId, bundle, options) {
       site_status: siteStatus,
       site_badge: uppercaseBadge(siteStatus),
       repo_status: options.repoStatus,
-      upstream_status: upstreamRecord.status?.state ?? null,
-      upstream_last_update: upstreamRecord.status?.last_update ?? null,
+      imported_status: upstreamRecord.status?.state ?? null,
+      imported_last_update: upstreamRecord.status?.last_update ?? null,
     },
     cluster: options.cluster ?? inferClusterFromTags(upstreamRecord.tags),
     prize: {
@@ -260,8 +260,8 @@ function buildProblemRecord(problemId, bundle, options) {
     formalization_path: 'FORMALIZATION.md',
     formalization: {
       status: options.formalizationStatus,
-      upstream_state: upstreamRecord.formalized?.state ?? 'unknown',
-      upstream_last_update: upstreamRecord.formalized?.last_update ?? null,
+      imported_state: upstreamRecord.formalized?.state ?? 'unknown',
+      imported_last_update: upstreamRecord.formalized?.last_update ?? null,
     },
   };
 
@@ -337,7 +337,7 @@ function renderReferencesMarkdown(record, bundle) {
     '',
     '- Public problem page:',
     `  - <${record.source.url}>`,
-    '- Upstream structured data:',
+    '- External imported atlas data:',
     '  - <https://github.com/teorth/erdosproblems>',
     '  - `data/problems.yaml`',
     bundle.siteSummary ? '- Site summary snapshot was present in the pull bundle at seed time.' : '- No site summary snapshot was bundled at seed time.',
@@ -351,7 +351,7 @@ function renderEvidenceMarkdown(problemId, record, bundle) {
     '# Evidence',
     '',
     `- This dossier was seeded for Erdos Problem #${problemId} from a pull bundle.`,
-    `- Upstream record included: ${bundle.upstreamRecord ? 'yes' : 'no'}`,
+    `- Imported record included: ${bundle.upstreamRecord ? 'yes' : 'no'}`,
     `- Site snapshot included: ${bundle.siteExtract || bundle.siteSummary ? 'yes' : 'no'}`,
     `- Public status review included: ${bundle.publicStatusReview || bundle.publicStatusReviewMarkdown ? 'yes' : 'no'}`,
     `- Repo status at seed time: ${record.status.repo_status}`,
@@ -368,8 +368,8 @@ function renderFormalizationMarkdown(record) {
     '# Formalization',
     '',
     `- Local status: ${record.formalization.status}`,
-    `- Upstream formalized state: ${record.formalization.upstream_state}`,
-    `- Upstream formalized last update: ${record.formalization.upstream_last_update ?? '(unknown)'}`,
+    `- Imported formalized state: ${record.formalization.imported_state}`,
+    `- Imported formalized last update: ${record.formalization.imported_last_update ?? '(unknown)'}`,
     '',
     'Seed note:',
     '- this file was created automatically from a pull bundle and should be upgraded as local formal work begins.',
@@ -406,7 +406,7 @@ function renderAgentStartMarkdown(problemId, record) {
     '- `AGENT_WEBSEARCH_BRIEF.md`',
     '',
     'First honest move:',
-    `- tighten the local dossier for problem ${problemId} against its pull bundle, references, and upstream provenance before widening claims.`,
+    `- tighten the local dossier for problem ${problemId} against its pull bundle, references, and import provenance before widening claims.`,
     '- read `PUBLIC_STATUS_REVIEW.md` and run the suggested queries in `AGENT_WEBSEARCH_BRIEF.md` before trusting a single public status surface.',
     '- write down the smallest route hypothesis that would make the next session cleaner, even if it remains provisional.',
     '',
@@ -532,7 +532,7 @@ function renderReviewChecklist(problemId, bundle, destinationDir) {
     '',
     '## Provenance',
     '',
-    `- Upstream record included: ${bundle.upstreamRecord ? 'yes' : 'no'}`,
+    `- Imported record included: ${bundle.upstreamRecord ? 'yes' : 'no'}`,
     `- Site snapshot included: ${bundle.siteExtract || bundle.siteSummary ? 'yes' : 'no'}`,
     `- Public search review included: ${bundle.publicStatusReview || bundle.publicStatusReviewMarkdown ? 'yes' : 'no'}`,
     '',