{
  "$schema": "https://www.triadicframeworks.org/schemas/module.schema.json",
 
  "module": {
    "name": "WRSADC",
    "path": "docs/TFT_3Pack_v1.3/WRSADC",
    "canon_tag": "wrsadc",
    "version": "1.3",
    "layer": "Core Frameworks — Structural Spine",
    "status": "Active, Canonical",
    "purpose": "Lightweight resonance-aware dimensional engine providing state tracking, entity observation, structural snapshots, and triadic introspection for TFT_3Pack_v1.3 tools.",
    "parent": "tft-3pack",
    "url": "https://github.com/umaywant2/TriadicFrameworks/tree/main/docs/TFT_3Pack_v1.3/WRSADC"
  },
 
  "session_context": {
    "canon": "active (wrsadc ⊂ tft-3pack)",
    "modules_linked": [
      "wrsadc_core.py ↔ __init__.py ↔ TFT_Primitive_{1,2,3}.py — Python observe/snapshot pipeline",
      "wrsadc_shell.sh ↔ TFT_Primitive_1.sh — shell mark/summary pipeline",
      "Scaffolding.md ↔ TFT_Primitives.md — architectural rationale ↔ operator specification"
    ],
    "drift": "minimal (deterministic state log)",
    "coherence": "stable (event-log + snapshot-pair grammar)",
    "format": "python + shell + markdown",
    "front_door": "exists (WRSADC/README.md)",
    "every_page": "stands alone + student-ready + operator-aware",
    "audience": ["students", "educators", "developers", "researchers", "AIs"]
  },
 
  "structural_grammar": {
    "dimensional_envelope": "D3 (triadic micro-phases)",
    "regime_envelope": "R1 (single-context runtime)",
    "coherence_envelope": "C1–C2 (event-log ↔ snapshot pair)",
    "drift_sensitivity": "low",
    "regime_sensitivity": "low",
    "triadic_operators": {
      "primitive_1": {
        "label": "Perceive → Interpret → Orient",
        "role": "Foundational awareness — raw input becomes patterned position",
        "phases": ["perceive", "interpret", "orient"],
        "triad_type": "Input → Meaning → Position"
      },
      "primitive_2": {
        "label": "Act → Adjust → Align",
        "role": "Behavioral arc — position becomes calibrated action",
        "phases": ["act", "adjust", "align"],
        "triad_type": "Action → Correction → Coherence"
      },
      "primitive_3": {
        "label": "Reflect → Refine → Reinforce",
        "role": "Consolidation loop — action becomes durable learning",
        "phases": ["reflect", "refine", "reinforce"],
        "triad_type": "Mirror → Polish → Lock"
      }
    },
    "core_api": {
      "python": {
        "class": "WRSADC",
        "dataclasses": ["WRSADCEvent", "WRSADCSnapshot"],
        "methods": ["observe(dimension, entity, state, meta?)", "snapshot()", "debug_print()"]
      },
      "shell": {
        "functions": ["wrsadc_init(context?)", "wrsadc_mark(dimension, entity, state)", "wrsadc_summary()"],
        "log_format": "ISO8601|context|dimension|entity|state"
      }
    }
  },
 
  "cross_module_propagation": {
    "imports": [
      "tft-3pack (parent module — dimensional envelope, audience, canon context)",
      "rtt-core (resonance-aware structural grammar, dimensional tracking concepts)"
    ],
    "exports": [
      "WRSADC class (Python dimensional engine)",
      "wrsadc_shell.sh (shell logging adapter)",
      "observe/snapshot API pattern",
      "WRSADCEvent/WRSADCSnapshot data structures",
      "triadic primitive implementations (P1 + P2 + P3)",
      "triadic micro-phase grammar (perceive/interpret/orient, act/adjust/align, reflect/refine/reinforce)"
    ]
  },
 
  "submodules": [],
 
  "files": [
    {
      "filename": "README.md",
      "path": "README.md",
      "purpose": "Module front door — AI-Ready badge, purpose statement, two-implementation overview (Python core + shell logger), integration summary.",
      "role": "index"
    },
    {
      "filename": "Scaffolding.md",
      "path": "Scaffolding.md",
      "purpose": "Architectural rationale document — explains why WRSADC belongs in TFT_3Pack, defines insertion point in repo tree, specifies minimal feature set (dimensional tracking, state transitions, structural snapshots, debug introspection).",
      "role": "reference",
      "analyzer_layer": "dimensional"
    },
    {
      "filename": "TFT_Primitives.md",
      "path": "TFT_Primitives.md",
      "purpose": "Full specification of all three triadic primitives with WRSADC integration — Python and shell examples, micro-phase definitions, structural pairing rationale (perceive↔record, interpret↔map, orient↔summarize).",
      "role": "reference",
      "analyzer_layer": "operator"
    },
    {
      "filename": "__init__.py",
      "path": "__init__.py",
      "purpose": "Python package initializer — imports WRSADC class from wrsadc_core and exports it as the public API surface.",
      "role": "extension",
      "analyzer_layer": "coherence"
    },
    {
      "filename": "wrsadc_core.py",
      "path": "wrsadc_core.py",
      "purpose": "Core dimensional engine — WRSADCEvent and WRSADCSnapshot dataclasses, WRSADC class with observe() for state logging, snapshot() for structural summaries, debug_print() for triadic introspection.",
      "role": "engine",
      "analyzer_layer": "dimensional"
    },
    {
      "filename": "wrsadc_shell.sh",
      "path": "wrsadc_shell.sh",
      "purpose": "Shell adapter — wrsadc_init() sets context, wrsadc_mark() appends timestamped events to log file, wrsadc_summary() aggregates dimensions and states from log.",
      "role": "engine",
      "analyzer_layer": "dimensional"
    },
    {
      "filename": "TFT_Primitive_1.py",
      "path": "TFT_Primitive_1.py",
      "purpose": "Python implementation of Primitive 1 (Perceive → Interpret → Orient) with WRSADC observe() hooks at each micro-phase transition.",
      "role": "engine",
      "analyzer_layer": "operator",
      "depends_on": ["wrsadc_core.py"]
    },
    {
      "filename": "TFT_Primitive_1.sh",
      "path": "TFT_Primitive_1.sh",
      "purpose": "Shell implementation of Primitive 1 (Perceive → Interpret → Orient) sourcing wrsadc_shell.sh and calling wrsadc_mark at each micro-phase.",
      "role": "engine",
      "analyzer_layer": "operator",
      "depends_on": ["wrsadc_shell.sh"]
    },
    {
      "filename": "TFT_Primitive_2.py",
      "path": "TFT_Primitive_2.py",
      "purpose": "Python implementation of Primitive 2 (Act → Adjust → Align) — behavioral arc with WRSADC observe() hooks.",
      "role": "engine",
      "analyzer_layer": "operator",
      "depends_on": ["wrsadc_core.py"]
    },
    {
      "filename": "TFT_Primitive_3.py",
      "path": "TFT_Primitive_3.py",
      "purpose": "Python implementation of Primitive 3 (Reflect → Refine → Reinforce) — consolidation loop with WRSADC observe() hooks.",
      "role": "engine",
      "analyzer_layer": "operator",
      "depends_on": ["wrsadc_core.py"]
    }
  ]
}