refactor: remove meta.size from population spec

Size is now exclusively set via 'sample -n' flag (required).
Removes redundant size field from SpecMeta and all usages:
- spec builder no longer extracts size from description
- sampler requires count parameter (no fallback)
- prompts/context strings no longer mention size
- updated docs and tests

Author: DeveshParagiri

AGENTS.md

@@ -51,13 +51,13 @@ extropy spec → extropy scenario → extropy persona → extropy sample → ext
 For `spec` command, use `--answers` to skip clarification prompts:
 
 ```bash
-extropy spec "500 German surgeons" -o surgeons --answers '{"location": "Bavaria"}'
+extropy spec "German surgeons" -o surgeons --answers '{"location": "Bavaria"}'
 ```
 
 Or use `--use-defaults` to accept default values:
 
 ```bash
-extropy spec "500 German surgeons" -o surgeons --use-defaults
+extropy spec "German surgeons" -o surgeons --use-defaults
 ```
 
 ### Skip confirmations

docs/commands.md

@@ -48,7 +48,7 @@ Generate a population spec from a natural language description.
 
 ```bash
 # Create new study folder with population.v1.yaml
-extropy spec "500 German surgeons" -o surgeons
+extropy spec "German surgeons" -o surgeons
 
 # Create with custom name (surgeons/hospital-staff.v1.yaml)
 extropy spec "German surgeons" -o surgeons/hospital-staff

extropy/cli/commands/scenario.py

@@ -127,7 +127,6 @@ def do_selection():
         try:
             new_attributes = select_attributes(
                 description=description,
-                size=pop_spec.meta.size,
                 geography=pop_spec.meta.geography,
                 context=pop_spec.attributes,
             )

extropy/cli/commands/spec.py

@@ -203,7 +203,6 @@ def spec_command(
             out.needs_clarification(
                 questions=questions,
                 resume_command=resume_cmd,
-                partial_data={"size": sufficiency_result.size},
             )
             raise typer.Exit(out.finish())
         else:
@@ -272,15 +271,14 @@ def spec_command(
                     console.print(f"  • {q}")
                 raise typer.Exit(1)
 
-    size = sufficiency_result.size
     geography = sufficiency_result.geography
     agent_focus = sufficiency_result.agent_focus
     geo_str = f", {geography}" if geography else ""
     focus_str = f", focus: {agent_focus}" if agent_focus else ""
 
     if not agent_mode:
         console.print(
-            f"[green]✓[/green] Context sufficient ({size} agents{geo_str}{focus_str})"
+            f"[green]✓[/green] Context sufficient{geo_str}{focus_str}"
         )
 
     # Step 1: Attribute Selection
@@ -293,7 +291,7 @@ def spec_command(
     def do_selection():
         nonlocal attributes, selection_error
         try:
-            attributes = select_attributes(description, size, geography)
+            attributes = select_attributes(description, geography)
         except Exception as e:
             selection_error = e
         finally:
@@ -430,7 +428,6 @@ def do_hydration():
     with console.status("[cyan]Building spec...[/cyan]"):
         population_spec = build_spec(
             description=description,
-            size=size,
             geography=geography,
             attributes=bound_attrs,
             sampling_order=sampling_order,
@@ -484,7 +481,6 @@ def do_hydration():
         out.success(
             "Spec saved",
             output=str(resolved_output),
-            size=size,
             geography=geography,
             agent_focus=agent_focus,
             attribute_count=len(population_spec.attributes),

extropy/cli/display.py

@@ -58,7 +58,7 @@ def display_spec_summary(spec: PopulationSpec) -> None:
     console.print("└" + "─" * 58 + "┘")
     console.print()
 
-    console.print(f"[bold]{spec.meta.description}[/bold] ({spec.meta.size} agents)")
+    console.print(f"[bold]{spec.meta.description}[/bold]")
     console.print(
         f"Grounding: {grounding_indicator(spec.grounding.overall)} ({spec.grounding.sources_count} sources)"
     )

extropy/core/models/population.py

@@ -422,10 +422,6 @@ class SpecMeta(BaseModel):
     """Metadata about the population spec."""
 
     description: str = Field(description="Original population description")
-    size: int = Field(
-        default=1000,
-        description="Suggested number of agents (actual count determined by sample -n)",
-    )
     geography: str | None = Field(default=None, description="Geographic scope")
     agent_focus: str | None = Field(
         default=None,
@@ -510,7 +506,6 @@ def summary(self) -> str:
         """Get a text summary of the spec."""
         lines = [
             f"Population: {self.meta.description}",
-            f"Size: {self.meta.size}",
             f"Grounding: {self.grounding.overall} ({self.grounding.sources_count} sources)",
             f"Attributes: {len(self.attributes)}",
             "",
@@ -596,7 +591,6 @@ def merge(self, extension: "PopulationSpec") -> "PopulationSpec":
 
         merged_meta = SpecMeta(
             description=f"{self.meta.description} + {extension.meta.description}",
-            size=self.meta.size,
             geography=self.meta.geography,
             agent_focus=self.meta.agent_focus,
             created_at=datetime.now(),
@@ -732,7 +726,6 @@ class SufficiencyResult(BaseModel):
     """Result from context sufficiency check (Step 0)."""
 
     sufficient: bool
-    size: int = Field(default=1000, description="Extracted or default population size")
     geography: str | None = None
     agent_focus: str | None = Field(
         default=None,

extropy/population/network/config_generator.py

@@ -256,7 +256,6 @@ def _build_prompt(
 
 ## Population
 - Description: {population_spec.meta.description}
-- Size: {population_spec.meta.size} people
 - Location/context: {population_spec.meta.geography or "unspecified"}
 
 ## Available Attributes

extropy/population/sampler/core.py

@@ -79,7 +79,7 @@ def _has_household_attributes(spec: PopulationSpec) -> bool:
 
 def sample_population(
     spec: PopulationSpec,
-    count: int | None = None,
+    count: int,
     seed: int | None = None,
     on_progress: ItemProgressCallback | None = None,
 ) -> SamplingResult:
@@ -92,7 +92,7 @@ def sample_population(
 
     Args:
         spec: The population specification to sample from
-        count: Number of agents to generate (defaults to spec.meta.size)
+        count: Number of agents to generate (required)
         seed: Random seed for reproducibility (None = random)
         on_progress: Optional callback(current, total) for progress updates
 
@@ -103,7 +103,7 @@ def sample_population(
         SamplingError: If sampling fails for any agent (e.g., formula error)
     """
     # Resolve count
-    n = count if count is not None else spec.meta.size
+    n = count
 
     # Initialize RNG
     if seed is None:

extropy/population/spec_builder/binder.py

@@ -188,7 +188,6 @@ def _compute_grounding_summary(
 
 def build_spec(
     description: str,
-    size: int,
     geography: str | None,
     attributes: list[AttributeSpec],
     sampling_order: list[str],
@@ -202,7 +201,6 @@ def build_spec(
 
     Args:
         description: Original population description
-        size: Number of agents
         geography: Geographic scope
         attributes: List of AttributeSpec
         sampling_order: Order for sampling
@@ -216,7 +214,6 @@ def build_spec(
     """
     meta = SpecMeta(
         description=description,
-        size=size,
         geography=geography,
         agent_focus=agent_focus,
         created_at=datetime.now(),

extropy/population/spec_builder/selector.py

@@ -152,7 +152,6 @@ def _is_multi_country_geography(geography: str | None, description: str) -> bool
 
 def select_attributes(
     description: str,
-    size: int,
     geography: str | None = None,
     context: list[AttributeSpec] | None = None,
     model: str | None = None,
@@ -173,7 +172,6 @@ def select_attributes(
 
     Args:
         description: Natural language population description
-        size: Number of agents (for context)
         geography: Geographic scope if known
         context: Existing attributes from base population (for extend mode)
         model: Model to use
@@ -240,7 +238,7 @@ def select_attributes(
 
     ## Population
 
-    "{description}" ({size} agents{geo_context})
+    "{description}"{geo_context}
 
     {constraint_note}