# imayankss/reliability-aware-on-device-summarization architecture

> Architecture diagram of the GitHub repository imayankss/reliability-aware-on-device-summarization, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imayankss/reliability-aware-on-device-summarization
- Repository: https://github.com/imayankss/reliability-aware-on-device-summarization

## Overview

This is an evidence-only research repository for studying whether a locally profiled summarization configuration can be selected—or whether the system should abstain—before summarizing a complete scientific paper. Its implemented workflow builds declared inputs, audits corpus eligibility and partitions, freezes policy and catalogue evidence, and runs controlled profiling; the README says held-out selector evaluation remains future work. The graph preserves the major documented stages and distinguishes runtime controls from policy, catalogue, and profiling work. Some subsystem links are documented only at README level because their source was not sampled.

Main entry points: [`m6_complete_policy/m6_4/dryrun.py`](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_4/dryrun.py) (Policy dry run), [`m4_execution_control/run_idle.py`](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/run_idle.py) (Idle controls), [`m6_complete_policy/m6_2_2/envelope.py`](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2_2/envelope.py) (Context envelope), [`m5_data_audit/m5_3/text_audit.py`](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_3/text_audit.py) (Text audit)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime feasibility"]
  node_local_runtime["Local runtime smoke<br/>[run_local.py]"]
end

subgraph group_controls["Execution and corpus controls"]
  node_idle_control["Idle controls<br/>[run_idle.py]"]
  node_readiness["Readiness gate<br/>[readiness.py]"]
  node_contention["Contention controls<br/>[native_process.py]"]
  node_run_records["Run records<br/>[records.py]"]
  node_metadata_acquisition["Metadata acquisition<br/>[acquire.py]"]
  node_paper_inventory["Paper inventory<br/>[metadata.py]"]
  node_text_audit["Text audit<br/>[text_audit.py]"]
  node_partitioning["Grouped partitioning<br/>[partition.py]"]
end

subgraph group_policy["Complete-paper policy"]
  node_declared_inputs["Declared inputs<br/>[build_inputs.py]"]
  node_token_accounting["Token accounting<br/>[account.py]"]
  node_context_envelope["Context envelope<br/>[envelope.py]"]
  node_route_decisions["Route decisions<br/>[route.py]"]
  node_execution_plan["Execution plan<br/>[plan.py]"]
  node_policy_dryrun["Policy dry run<br/>[dryrun.py]"]
  node_retry_diagnostics["Retry diagnostics<br/>[diagnose.py]"]
  node_policy_rederive["Policy re-derivation<br/>[rederive.py]"]
  node_policy_orchestrator["Policy orchestration<br/>[orchestrator.py]"]
end

subgraph group_catalogue["Annotation and catalogue"]
  node_annotation_protocol["Annotation protocol<br/>[prepare.py]"]
  node_compatibility_gate["Compatibility gate<br/>[gate.py]"]
  node_catalogue_conversion["Catalogue conversion<br/>[convert.py]"]
  node_catalogue_runtime["Catalogue runtime<br/>[drive.py]"]
  node_frozen_catalogue["Frozen catalogue<br/>[catalogue.py]"]
end

subgraph group_profiling["Profiling evidence"]
  node_profiling_protocol["Profiling protocol<br/>[protocol.py]"]
  node_profiling_inventory["Profile inventory<br/>[inventory.py]"]
  node_profiling_batches["Batch profiling<br/>[run_batch.py]"]
  node_profiling_policy["Profiling policy<br/>[policy.py]"]
  node_profiling_records["Profiling records<br/>[records.py]"]
  node_measured_evidence["Measured evidence<br/>[records.py]"]
end

node_researcher(("Researcher"))

node_researcher -->|"checks route"| node_local_runtime
node_researcher -->|"audits corpus"| node_metadata_acquisition
node_metadata_acquisition -->|"builds inventory"| node_paper_inventory
node_paper_inventory -->|"audits text"| node_text_audit
node_text_audit -->|"supports partitions"| node_partitioning
node_text_audit -->|"builds from text"| node_declared_inputs
node_partitioning -.->|"constrains inputs"| node_declared_inputs
node_declared_inputs -->|"accounts tokens"| node_token_accounting
node_token_accounting -->|"sets envelope"| node_context_envelope
node_context_envelope -->|"renders for routes"| node_route_decisions
node_context_envelope -->|"informs planning"| node_execution_plan
node_route_decisions -.->|"uses catalogue"| node_frozen_catalogue
node_execution_plan -->|"executes plan"| node_policy_dryrun
node_context_envelope -->|"renders prompts"| node_policy_dryrun
node_readiness -->|"gates runs"| node_policy_dryrun
node_idle_control -->|"provides snapshot"| node_policy_dryrun
node_policy_dryrun -->|"feeds diagnosis"| node_retry_diagnostics
node_policy_rederive -->|"supports orchestration"| node_policy_orchestrator
node_readiness -->|"gates attempts"| node_policy_orchestrator
node_idle_control -->|"runs in process"| node_local_runtime
node_idle_control -->|"classifies snapshot"| node_readiness
node_idle_control -.->|"publishes records"| node_run_records
node_contention -.->|"controls execution"| node_profiling_protocol
node_annotation_protocol -->|"supports catalogue"| node_compatibility_gate
node_compatibility_gate -->|"qualifies artifacts"| node_catalogue_conversion
node_catalogue_conversion -->|"precedes runtime checks"| node_catalogue_runtime
node_catalogue_runtime -->|"supports freeze"| node_frozen_catalogue
node_frozen_catalogue -->|"profiles configurations"| node_profiling_protocol
node_profiling_protocol -->|"defines inventory"| node_profiling_inventory
node_profiling_inventory -.->|"organizes batches"| node_profiling_batches
node_profiling_policy -->|"binds records"| node_profiling_records
node_profiling_batches -->|"retains results"| node_measured_evidence
node_profiling_records -->|"records evidence"| node_measured_evidence

click node_local_runtime "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m3_runtime_feasibility/run_local.py"
click node_idle_control "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/run_idle.py"
click node_readiness "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/m4_2/readiness.py"
click node_contention "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/m4_3/native_process.py"
click node_run_records "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/records.py"
click node_metadata_acquisition "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_2/acquire.py"
click node_paper_inventory "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_2/metadata.py"
click node_text_audit "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_3/text_audit.py"
click node_partitioning "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_4/partition.py"
click node_declared_inputs "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_1/build_inputs.py"
click node_token_accounting "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2/account.py"
click node_context_envelope "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2_2/envelope.py"
click node_route_decisions "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2_3/route.py"
click node_execution_plan "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_3/plan.py"
click node_policy_dryrun "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_4/dryrun.py"
click node_retry_diagnostics "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_4_2/diagnose.py"
click node_policy_rederive "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_5/rederive.py"
click node_policy_orchestrator "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_6/orchestrator.py"
click node_annotation_protocol "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_annotation_protocol/m7_1/prepare.py"
click node_compatibility_gate "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_compatibility/m7_2a/gate.py"
click node_catalogue_conversion "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_conversion/m7_2c3/convert.py"
click node_catalogue_runtime "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_runtime/m7_2d/drive.py"
click node_frozen_catalogue "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_freeze/m7_3/catalogue.py"
click node_profiling_protocol "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_1/protocol.py"
click node_profiling_inventory "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_2/inventory.py"
click node_profiling_batches "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_3a/run_batch.py"
click node_profiling_policy "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_r1/policy.py"
click node_profiling_records "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_r1/records.py"
click node_measured_evidence "https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_r1/records.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_local_runtime toneBlue
class node_idle_control,node_readiness,node_contention,node_run_records,node_metadata_acquisition,node_paper_inventory,node_text_audit,node_partitioning toneAmber
class node_declared_inputs,node_token_accounting,node_context_envelope,node_route_decisions,node_execution_plan,node_policy_dryrun,node_retry_diagnostics,node_policy_rederive,node_policy_orchestrator toneMint
class node_annotation_protocol,node_compatibility_gate,node_catalogue_conversion,node_catalogue_runtime,node_frozen_catalogue toneRose
class node_profiling_protocol,node_profiling_inventory,node_profiling_batches,node_profiling_policy,node_profiling_records,node_measured_evidence,node_researcher toneIndigo
```

## Components

### Runtime feasibility

- [Local runtime smoke](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m3_runtime_feasibility/run_local.py): `m3_runtime_feasibility/run_local.py`

### Execution and corpus controls

- [Idle controls](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/run_idle.py): `m4_execution_control/run_idle.py`
- [Readiness gate](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/m4_2/readiness.py): `m4_execution_control/m4_2/readiness.py`
- [Contention controls](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/m4_3/native_process.py): `m4_execution_control/m4_3/native_process.py`
- [Run records](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m4_execution_control/records.py): `m4_execution_control/records.py`
- [Metadata acquisition](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_2/acquire.py): `m5_data_audit/m5_2/acquire.py`
- [Paper inventory](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_2/metadata.py): `m5_data_audit/m5_2/metadata.py`
- [Text audit](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_3/text_audit.py): `m5_data_audit/m5_3/text_audit.py`
- [Grouped partitioning](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m5_data_audit/m5_4/partition.py): `m5_data_audit/m5_4/partition.py`

### Complete-paper policy

- [Declared inputs](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_1/build_inputs.py): `m6_complete_policy/m6_1/build_inputs.py`
- [Token accounting](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2/account.py): `m6_complete_policy/m6_2/account.py`
- [Context envelope](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2_2/envelope.py): `m6_complete_policy/m6_2_2/envelope.py`
- [Route decisions](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_2_3/route.py): `m6_complete_policy/m6_2_3/route.py`
- [Execution plan](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_3/plan.py): `m6_complete_policy/m6_3/plan.py`
- [Policy dry run](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_4/dryrun.py): `m6_complete_policy/m6_4/dryrun.py`
- [Retry diagnostics](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_4_2/diagnose.py): `m6_complete_policy/m6_4_2/diagnose.py`
- [Policy re-derivation](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_5/rederive.py): `m6_complete_policy/m6_5/rederive.py`
- [Policy orchestration](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m6_complete_policy/m6_6/orchestrator.py): `m6_complete_policy/m6_6/orchestrator.py`

### Annotation and catalogue

- [Annotation protocol](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_annotation_protocol/m7_1/prepare.py): `m7_annotation_protocol/m7_1/prepare.py`
- [Compatibility gate](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_compatibility/m7_2a/gate.py): `m7_catalogue_compatibility/m7_2a/gate.py`
- [Catalogue conversion](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_conversion/m7_2c3/convert.py): `m7_catalogue_conversion/m7_2c3/convert.py`
- [Catalogue runtime](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_runtime/m7_2d/drive.py): `m7_catalogue_runtime/m7_2d/drive.py`
- [Frozen catalogue](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m7_catalogue_freeze/m7_3/catalogue.py): `m7_catalogue_freeze/m7_3/catalogue.py`

### Profiling evidence

- [Profiling protocol](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_1/protocol.py): `m8_profiling/m8_1/protocol.py`
- [Profile inventory](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_2/inventory.py): `m8_profiling/m8_2/inventory.py`
- [Batch profiling](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_3a/run_batch.py): `m8_profiling/m8_3a/run_batch.py`
- [Profiling policy](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_r1/policy.py): `m8_profiling/m8_r1/policy.py`
- [Profiling records](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_r1/records.py): `m8_profiling/m8_r1/records.py`
- [Measured evidence](https://github.com/imayankss/reliability-aware-on-device-summarization/blob/main/m8_profiling/m8_r1/records.py): `m8_profiling/m8_r1/records.py`

### Other components

- **Researcher**

## Connections

- Researcher → Local runtime smoke: checks route (evidence: `README.md`)
- Researcher → Metadata acquisition: audits corpus (evidence: `README.md`)
- Metadata acquisition → Paper inventory: builds inventory (evidence: `m5_data_audit/m5_2/pipeline.py`)
- Paper inventory → Text audit: audits text (evidence: `README.md`)
- Text audit → Grouped partitioning: supports partitions (evidence: `README.md`)
- Text audit → Declared inputs: builds from text (evidence: `m6_complete_policy/m6_1/build_inputs.py`)
- Grouped partitioning → Declared inputs: constrains inputs
- Declared inputs → Token accounting: accounts tokens (evidence: `README.md`)
- Token accounting → Context envelope: sets envelope (evidence: `README.md`)
- Context envelope → Route decisions: renders for routes (evidence: `m6_complete_policy/m6_2_3/route.py`)
- Context envelope → Execution plan: informs planning (evidence: `m6_complete_policy/m6_3/plan.py`)
- Route decisions → Frozen catalogue: uses catalogue
- Execution plan → Policy dry run: executes plan (evidence: `m6_complete_policy/m6_4/dryrun.py`)
- Context envelope → Policy dry run: renders prompts (evidence: `m6_complete_policy/m6_4/dryrun.py`)
- Readiness gate → Policy dry run: gates runs (evidence: `m6_complete_policy/m6_4/dryrun.py`)
- Idle controls → Policy dry run: provides snapshot (evidence: `m6_complete_policy/m6_4/dryrun.py`)
- Policy dry run → Retry diagnostics: feeds diagnosis (evidence: `m6_complete_policy/m6_4_2/diagnose.py`)
- Policy re-derivation → Policy orchestration: supports orchestration (evidence: `m6_complete_policy/m6_6/orchestrator.py`)
- Readiness gate → Policy orchestration: gates attempts (evidence: `m6_complete_policy/m6_6/orchestrator.py`)
- Idle controls → Local runtime smoke: runs in process (evidence: `m4_execution_control/run_idle.py`)
- Idle controls → Readiness gate: classifies snapshot (evidence: `m6_complete_policy/m6_6/orchestrator.py`)
- Idle controls → Run records: publishes records
- Contention controls → Profiling protocol: controls execution
- Annotation protocol → Compatibility gate: supports catalogue (evidence: `README.md`)
- Compatibility gate → Catalogue conversion: qualifies artifacts (evidence: `README.md`)
- Catalogue conversion → Catalogue runtime: precedes runtime checks (evidence: `README.md`)
- Catalogue runtime → Frozen catalogue: supports freeze (evidence: `README.md`)
- Frozen catalogue → Profiling protocol: profiles configurations (evidence: `README.md`)
- Profiling protocol → Profile inventory: defines inventory (evidence: `README.md`)
- Profile inventory → Batch profiling: organizes batches
- Profiling policy → Profiling records: binds records (evidence: `m8_profiling/m8_r1/records.py`)
- Batch profiling → Measured evidence: retains results (evidence: `README.md`)
- Profiling records → Measured evidence: records evidence (evidence: `README.md`)
