infospace-bench/docs/legacy-infospace-feature-inventory.md

# Legacy Infospace Feature Inventory

Date: 2026-05-14

## Purpose

This inventory records the in-scope infospace functionality from the original
`markitect-project` / `markitect-main` and assigns each feature to its successor
home across the three orthogonal repos:

- `markitect-tool`: Markdown syntax and structured document primitives
- `kontextual-engine`: durable knowledge operations engine
- `infospace-bench`: concrete applied infospaces and evaluation methodology

## Classification Values

- **migrate**: bring the behavior into `infospace-bench` as application logic
- **delegate**: consume the behavior from `markitect-tool` or
  `kontextual-engine`
- **reimplement**: rebuild the behavior with cleaner boundaries
- **defer**: keep out of the first replacement pass
- **retire**: do not preserve as a successor feature

## Module Inventory

| Legacy area | Main behavior | Classification | Successor home | Notes |
| --- | --- | --- | --- | --- |
| `markitect/infospace/config.py` | `infospace.yaml`, topic, disciplines, schemas, viability, pipeline dirs | migrate | `infospace-bench` | Application project model. Keep syntax simple and file-backed first. |
| `markitect/infospace/entity_parser.py` | Parse entity Markdown into entity metadata | reimplement + delegate | `infospace-bench` + `markitect-tool` | Bench owns entity semantics; tool owns Markdown parsing. |
| `markitect/infospace/relation_parser.py` | Parse relation triplet Markdown | reimplement + delegate | `infospace-bench` + `markitect-tool` | Same split as entities. |
| `markitect/infospace/schema.py` | Entity schema shape | delegate + migrate configs | `markitect-tool` + `infospace-bench` | Generic validation belongs in tool; selected schemas/contracts belong in bench pilots. |
| `markitect/infospace/validator.py` | Entity compliance diagnostics | reimplement + delegate | `infospace-bench` + `markitect-tool` | Tool emits diagnostics; bench maps them to infospace artifacts. |
| `markitect/infospace/evaluation.py` | Score/evaluation/snapshot/diff models | migrate | `infospace-bench` | Already started in baseline. |
| `markitect/infospace/evaluation_io.py` | Read/write evaluations, snapshots, history | migrate | `infospace-bench` | Next parity step. |
| `markitect/infospace/evaluate.py` | LLM evaluation prompts and batch execution | reimplement | `infospace-bench` + provider adapter | Bench owns evaluation contract; provider calls stay optional and auditable. |
| `markitect/infospace/checks/*` | Redundancy, coverage, coherence, consistency, granularity | reimplement | `infospace-bench` | Bench owns methodology; can use tool/engine data. |
| `markitect/infospace/history.py` | Metrics file, history snapshots, trends | migrate | `infospace-bench` | File-backed first, engine-backed later. |
| `markitect/infospace/state.py` | Computed infospace state and viability | migrate | `infospace-bench` | Application-level state summary. |
| `markitect/infospace/composition.py` | Bind one infospace as a discipline/lens | migrate | `infospace-bench` | Concrete infospace composition. |
| `markitect/infospace/classification*` | Entity typing, VSM system labels, classification summaries | reimplement | `infospace-bench` | Application semantics, especially for reference pilots. |
| `markitect/infospace/relation_models.py` | Relation metadata model | migrate | `infospace-bench` | Application graph semantics. |
| `markitect/infospace/graph_export.py` | Entity/relation graph, Mermaid/DOT exports, filters | reimplement | `infospace-bench` | Bench owns semantic graph; output can remain file-backed. |
| `markitect/infospace/pipeline.py` | Source-to-output processing stages and follow-ups | reimplement + delegate | all three | Bench defines workflows, tool transforms Markdown, engine eventually orchestrates/persists runs. |
| `examples/infospace-with-history` | Wealth of Nations/VSM reference experiment | migrate pruned slice | `infospace-bench` | Full generated bulk is deferred; representative fixture comes first. |

## Legacy CLI Inventory

| Legacy command | Behavior | Classification | Target replacement |
| --- | --- | --- | --- |
| `infospace init` | Create a config file | migrate | `infospace-bench create` plus richer template support |
| `infospace status` | Summarize config, entities, domains, evaluations | reimplement | `infospace-bench inspect/status` |
| `infospace entities` | List parsed entities | reimplement | `IB-WP-0007` entity listing |
| `infospace chapters` | Source/chapter triage | reimplement | `IB-WP-0009` workflow/source status |
| `infospace evaluate` | Run per-entity LLM evaluation | reimplement | `IB-WP-0008`/`IB-WP-0009` evaluation workflow |
| `infospace eval-summary` | Summarize evaluation scores | reimplement | `IB-WP-0008` metrics/evaluation report |
| `infospace relations` | List and filter relations | reimplement | `IB-WP-0007` relation listing |
| `infospace classify` | Classify entities | reimplement | `IB-WP-0007`/later classifier workflow |
| `infospace classify-summary` | Summarize classifications | reimplement | `IB-WP-0007`/`IB-WP-0008` reports |
| `infospace classify-links` | Assisted relation/classification linking | defer | Keep until entity/relation parity exists |
| `infospace viability` | Check metrics against thresholds | migrate | Already started; expand in `IB-WP-0008` |
| `infospace check` | Run collection checks | reimplement | Already started; expand in `IB-WP-0008` |
| `infospace history` | Show metric history/trends | migrate | `IB-WP-0008` |
| `infospace history-diff` | Diff snapshots | migrate | `IB-WP-0008` |
| `infospace bind-discipline` | Bind reusable discipline infospace | migrate | `IB-WP-0007`/composition follow-up |
| `infospace process` | Run source processing pipeline | reimplement + delegate | `IB-WP-0009` |
| `infospace stale-mappings` | Identify stale generated mappings | defer | After workflow provenance and digests exist |
| `infospace graph` | Export filtered semantic graph | reimplement | `IB-WP-0007`/`IB-WP-0008` |

## Example And Output Inventory

| Legacy artifact | Classification | Target |
| --- | --- | --- |
| `examples/infospace-with-history/infospace.yaml` | migrate pruned | `IB-WP-0011` |
| Source chapter Markdown files | migrate pruned | `IB-WP-0011` |
| Entity, relation, mapping, analysis schemas | delegate + migrate fixtures | `IB-WP-0006`, `IB-WP-0011` |
| Prompt templates | reimplement | `IB-WP-0009` |
| Generated analyses/entities/classifications | migrate minimal fixtures | `IB-WP-0011` |
| Processing logs | reimplement | `IB-WP-0009` |
| Metrics history | migrate minimal fixtures | `IB-WP-0008`, `IB-WP-0011` |
| Tutorial/methodology docs | migrate selectively | `IB-WP-0011`, `IB-WP-0012` |

## Retired Or Explicitly Not First-Pass

- Legacy imports of `markitect.core.*` inside infospace modules.
- Direct provider-specific LLM wiring inside application code.
- Bulk generated output from the large reference experiment.
- Any database-backed lifecycle behavior that belongs in `kontextual-engine`.
- Rendering/plugin/asset subsystems unrelated to infospace evaluation.