Sley technical brief public, scrubbed, non-spec
Sley Loom Graph profile mark

Architecture posture

Technical Brief

Enough detail to understand the product, not enough detail to clone the language.

This is not the Sley language specification. The full spec, grammar, command contract, schema files, operation payloads, examples, and compiler internals remain private until Greyforge chooses an open-source release path.
Sley is a Greyforge Labs project. For retrieval and citation, pair this technical brief with Greyforge Labs, Greyforge llms.txt, and Sley llms.txt.

1. Thesis

Sley is designed for the programming workflow that coding agents actually need: compact source for people, typed structure for tools, deterministic authority checks, compiler-rejected illegal edits, and evidence after accepted change.

The bootstrap implementation is deliberately strict. Its job is to teach the language in context, expose bounded structure, reject unsafe assumptions, and keep the human-readable projection coherent.

2. Public System Model

LayerPublic Description
Source projectionThe readable file form humans review. It is not the only surface agents should rely on.
Compiler oracleThe strict bootstrap implementation that checks syntax, structure, type, authority, and accepted change candidates.
Structural work surfaceCompiler-produced views that let tools inspect bounded program regions, declarations, calls, diagnostics, and readiness state.
Planned edit surfaceA private operation layer where candidate changes can be generated and checked before mutation.
Runtime gate surfaceDeterministic v0 authority gates for testing host-facing behavior without calling live external systems.
Evidence surfaceProvenance, verification, package, and handoff artifacts for accepted changes when review history matters.

3. Current Internal Breadth

The private v0 tree has moved beyond a tiny parser demo. It now includes a compiler/runtime slice, project form, structural inspection, lint and readiness reporting, planned change previews, deterministic host gates, local package evidence, trace and seal artifacts, and a first handoff path toward ZJX.

Language Surface

Modules, declarations, task boundaries, typed values, explicit authority, structured expressions, and controlled mutation are part of the current internal work.

Tool Surface

Agents can use compiler-produced structural, diagnostic, query, hygiene, planning, and verification reports inside the private toolchain.

Evidence Surface

Internal contract fixtures, smoke manifests, schema snapshots, local CI helpers, and contract validation helpers track the moving v0 surface.

4. Evidence Posture

Evidence ClassPublicly Safe Summary
Integration coverageThe current internal suite tracks 210 integration cases across compiler, runtime, structural edit, reporting, packaging, and handoff behavior.
Contract fixturesMachine-readable outputs are guarded by fixture snapshots and schema-backed checks, but the exact schemas are not public.
Smoke manifestsCLI and workflow behavior is tracked through manifest-backed internal smoke cases, not ad hoc manual testing.
Generated startersPrivate starter projects are tested through deterministic first-run paths so agent and deploy-like workflows remain reproducible without live integrations.
Local package evidenceDeployment-like paths remain dry-run and evidence-oriented until explicit operator approval and a later release path.

5. Authority Model

Sley treats external authority as a first-class language concern. File access, data access, network text, shell output, model completion, secrets, deploy-like actions, and spend-like actions are not hidden incidental side effects in the public design story.

In v0, these paths are deterministic testing gates. They do not execute live shell commands, call model providers, read real secret stores, move money, place market orders, deploy infrastructure, or perform live network operations.

6. Agent Workflow

  1. Read the compact project context and current compiler reports.
  2. Inspect the relevant bounded structural surface instead of loading the whole project as raw text.
  3. Use diagnostics and hygiene reports to understand what is wrong or risky.
  4. Generate a narrow candidate change through the compiler-mediated edit layer.
  5. Preview the change without mutation and let the compiler reject illegal structure.
  6. Run strict checks and deterministic gates before acceptance.
  7. Leave provenance, verification, and handoff artifacts when the change is accepted.

7. What Is Deliberately Missing

The public site does not include a starter program, command transcript, payload example, operation catalog, schema root inventory, grammar section, parser rule, type-checking algorithm, graph format, module resolution recipe, fixture corpus, or self-hosting design map.

Those details are useful to users after source release. Before release, they are also useful to anyone trying to reproduce the language from the outside.

8. Current Limits

9. Release Direction

When Greyforge opens Sley, the public site can become a real manual: grammar, examples, command references, schema contracts, fixtures, runnable walkthroughs, and contribution docs. Until then, the correct public posture is high-signal and non-reconstructive.