Skip to content

--bundle: single-file distribution (script + eigs_modules appended to the runtime binary; optional attached tape) #413

Description

@InauguralPhysicist

Why. Go's deliverable-as-design-property lesson: "ship one file" sold Go before its type system did. EigenScript can have it at VM speed today without waiting on ouroboros going public or its partial AOT envelope — and the tape-carrying variant creates a deliverable no incumbent has: an executable bug report that replays deterministically.

What.

  • eigenscript --bundle app.eigs out: embed the script plus its resolved eigs_modules tree into a copy of the runtime binary (appended archive + self-exec detection on startup).
  • Optional attached trace tape: the bundle runs as a self-replaying reproducer (out --replay).
  • Document AOT (ouroboros) as the native-speed tier of the same story in the bundle docs.
  • tests/test_bundle.sh; bundle the data-pipeline example as the demo.

Depends on: the tape-format versioning decision before the tape-attaching variant ships (bundles outlive binaries by design).

Acceptance. A bundled example runs on a machine with no EigenScript checkout; bundle-with-tape replays byte-identically; suite covers script+modules+tape variants.

Effort: weeks. Source: 2026-07-04 survey (embedding/deployment dimension).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions