erdos-problems 0.2.8 → 0.2.10

package/README.md

@@ -1,5 +1,7 @@
 # erdos-problems
 
+Maintained by Fractal Research Group (`frg.earth`).
+
 > CLI and workspace for Paul Erdos problems.
 >
 > Browse the atlas, scaffold a dossier, and keep public status, local route state, and verification records separate.
@@ -37,6 +39,16 @@ A short example from the first minute:
 - pack-specific views where this repo already has enough structure to support them
 - an ORP-based workflow for claims, checkpoints, and run artifacts
 
+## Repo, npm, and Upstream
+
+- the npm package is the installable CLI plus the bundled atlas snapshot, packaged dossiers, and pack assets
+- the GitHub repo is the central collaboration space for dossiers, pack packets, docs, issues, discussions, and pull requests
+- `.erdos/` is local workspace state created by the CLI; it is not the canonical public collaboration surface
+- `erdos upstream show` tells you whether you are currently using the bundled package snapshot or a workspace-local refreshed snapshot
+- `erdos upstream sync` refreshes a workspace-local snapshot from `teorth/erdosproblems` without mutating the packaged bundle
+- `erdos upstream sync --write-package-snapshot` is the maintainer path for intentionally updating the bundled snapshot in this repo
+- repo-only collaboration files can live in the public repo without shipping in the npm tarball; see the GitHub contribution guide: https://github.com/SproutSeeds/erdos-problems/blob/main/CONTRIBUTING.md
+
 ## Start In 60 Seconds
 
 Install:

package/docs/ERDOS_PROBLEMS_REPO_SPEC.md

@@ -45,6 +45,21 @@ The package ships a bundled snapshot of `teorth/erdosproblems` and can refresh a
 Selected problem families get deeper pack-specific context.
 The first pack is `sunflower`.
 
+## Collaboration model
+
+The GitHub repo is the central public collaboration space.
+
+- canonical dossiers live under `problems/<id>/`
+- pack-specific packets live under `packs/<family>/`
+- CLI/runtime behavior lives under `src/`
+- local runtime state lives under `.erdos/` and should not be treated as canonical repo truth
+
+The npm package is the installable distribution channel, not the only collaboration surface.
+
+- the package ships the CLI, bundled upstream snapshot, canonical dossiers, and packaged pack assets
+- the public repo may also contain contribution guides, issue templates, maintainer notes, and other repo-only collaboration files that do not need to ship in the npm tarball
+- workspace-local upstream refreshes should be explicit and inspectable
+
 ## Repository shape
 
 ```text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "erdos-problems",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "CLI atlas and workspace tools for Paul Erdos problems.",
   "type": "module",
   "bin": {
@@ -36,6 +36,7 @@
     "agents",
     "sunflower"
   ],
+  "author": "Fractal Research Group <cody@frg.earth>",
   "dependencies": {
     "breakthroughs": "^0.1.1",
     "yaml": "^2.8.3"

package/packs/sunflower/compute/20/u3_uniform_transfer_window_v0.yaml

@@ -8,7 +8,8 @@ price_checked_local_date: 2026-03-25
 recommendation: local_scout_first
 approval_required: false
 summary: Problem 20 now has a frozen local-scout packet for the uniform k=3 transfer window. The job is to verify a small explicit reduction bundle before any paid compute rung is considered.
-source_repo: /Volumes/Code_2TB/code/sunflower-coda/repo
+source_repo:
+  name: sunflower-coda
 public_feature: uniform_k3_frontier
 rungs:
   - label: local_scout

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';
 
@@ -48,10 +49,18 @@ export async function runUpstreamCommand(args) {
       return 0;
     }
     console.log(`Snapshot kind: ${snapshot.kind}`);
+    console.log(`Active source: ${snapshot.kind === 'workspace' ? 'workspace override' : 'bundled package snapshot'}`);
     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 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 snapshot: erdos upstream sync');
+    console.log('Refresh bundled package snapshot (maintainers): erdos upstream sync --write-package-snapshot');
     return 0;
   }