Appture

Appture is the production DISR/CST validation and materialization pipeline.

Core Concepts (DISR and CST)

• DISR (Diagram Instruction Stream)

  • The model of meaning/intent.
  • Serves as the canonical reference model.
  • Acts as anti-drift source-of-truth for what the system is supposed to express.

• CST (Composable Semantic Template)

  • The execution plan for how DISR truth is revealed.
  • Defines how intent is materialized into concrete renderable outputs.
  • Targets can include HTML, CSS, SVG, JavaScript, ReactJS, Node, XAML, workflows, and other renderable/runtime surfaces.

Core closed loop:

DISR + CST -> HTML

Validation checks:

• grammar-contract
• disr-to-cst
• cst-to-output
• disr-to-output
• intent-expression

Architecture (Current)

Appture is organized as hard-cut stages:

1. Fetch
   • load DISR text
   • load CST JSON
   • load external grammar profile
2. Decode
   • merge grammar/profile + CST decode contract
   • enforce DISR boundary rules
   • parse DISR intent
   • validate grammar contract
3. Execute
   • validate DISR-to-CST topology
   • materialize HTML from CST + intent primitives
   • compute intent-expression scoring
4. Write-back
   • validate CST-to-output and DISR-to-output
   • write HTML artifact
   • write evidence artifact

The pipeline entrypoint is src/pipeline.ts.

Source Layout

• src/types.ts — shared contracts and model types
• src/core/
  • html-inspector.ts
  • interpolator.ts
  • topology-indexer.ts
• src/fetch/
  • disr-sampler.ts
  • cst-sampler.ts
  • grammar-sampler.ts
• src/decode/
  • boundary-guard.ts
  • disr-decoder.ts
  • grammar-resolver.ts
  • grammar-contract-validator.ts
• src/execute/
  • topology-validator.ts
  • materializer.ts
  • iem-scorer.ts
• src/write-back/
  • output-validator.ts
  • output-writer.ts
• src/pipeline.ts — pipeline orchestrator
• src/index.ts — public export surface
• src/cli.ts — CLI runner

Demos and Artifacts

• demos/demo-manifest.json defines demo order and metadata.
• demos/<demo>/ contains source files and generated outputs:
  • *-output.html
  • *-evidence.txt
• demos/.baseline/ stores baseline snapshots and hash manifests for no-regression verification.

CLI Usage

Run from the repository root:

• npm run build
• npm run appture -- all
• npm run appture -- <demo-name>

Example demo names are in demos/demo-manifest.json.

Build Note (Grammar Assets)

Build now includes a grammar asset copy step so runtime profile loading works from dist/:

• npm run build runs TypeScript compilation and copies grammar/ to dist/grammar/.
• Copy script: scripts/copy-grammar-assets.js

Behavior Notes

• Decode behavior is data-driven via renderingContract.decodeContract and optional external grammar profiles.
• DISR boundary guardrails are enforced before parsing.
• Primitive rendering is template-map driven and checked for materialization coverage.
• Demo suite status follows current baseline truth; no-regression is validated using baseline evidence/HTML hashes.