sini’s gists · GitHub
Skip to content

Instantly share code, notes, and snippets.

View sini's full-sized avatar

Jason Bowman sini

  • San Francisco, CA, USA
View GitHub Profile
@sini
sini / host-aspect-settings.simple.md
Last active June 25, 2026 18:46
Per-Aspect Settings in Den — a beginner-friendly (simplified English) guide to the host/aspect settings pattern

Per-Aspect Settings in Den — A Beginner-Friendly Guide

Hi! 👋 This guide teaches you a really useful pattern used in a Nix framework called Den. Don't worry if you're new to Nix — we'll explain everything slowly, in plain language, with examples.

Who is this for? Anyone learning about Nix/NixOS who knows a little but isn't an expert yet. If a word looks unfamiliar, don't panic — there's a glossary at the very bottom where every technical term is explained.

@sini
sini / host-aspect-settings.hi.md
Created June 25, 2026 18:42
Den में Per-Aspect Settings — शुरुआती लोगों के लिए आसान हिंदी गाइड (Hindi beginner's guide to the host/aspect settings pattern in Den)

Den में Per-Aspect Settings — शुरुआती लोगों के लिए आसान गाइड

नमस्ते! 👋 यह गाइड आपको एक बहुत उपयोगी pattern सिखाएगी जो Den नाम के एक Nix framework में इस्तेमाल होती है। चिंता मत कीजिए अगर आप Nix में नए हैं — हम हर चीज़ को धीरे-धीरे, आसान भाषा में, उदाहरणों के साथ समझाएँगे।

किसके लिए है यह गाइड? उन लोगों के लिए जो Computer Science पढ़ रहे हैं और Nix/NixOS के बारे में थोड़ा-बहुत जानते हैं, पर अभी expert नहीं हैं। अगर कुछ शब्द नए लगें, तो घबराइए मत — सबसे नीचे एक शब्दावली (glossary) दी गई है जहाँ हर technical शब्द का मतलब समझाया गया है।

@sini
sini / host-aspect-settings.md
Last active June 25, 2026 17:00
Typed per-aspect settings in Den — a how-to for giving shared aspects per-host knobs (module-system pattern + the gen-aspects first-class cascade)

Typed per-aspect settings in Den

A how-to for giving shared aspects per-host knobs. If you build configurations with Den (or any dendritic / aspect-oriented Nix setup), this guide shows how to let an aspect expose a few typed values — a disk device id, a kernel optimization target, a BGP AS number — that each host fills in, without forking the aspect.

It is written to be replicated in your own configuration, not just read as a description of one repo. It has two parts:

@sini
sini / delivery-edge-behavior-changes.md
Created June 13, 2026 05:40
den delivery-edge unification — net behavior changes (1 latent-bug fix + 1 additive API; reference host byte-identical)

den delivery-edge unification — net behavior changes

Branch feat/entity-gen-schema-port, commits e71860b7..d3c74242 (the delivery-half rewrite: nine ad-hoc delivery mechanisms collapsed into one (S, T, P, M) edge algebra). This document enumerates every net runtime behavior change versus the pre-rewrite baseline, with justification. Spec + plan + deviation ledger live in den-architecture/{specs,plans}/2026-06-12-delivery-edge-unification-*.

TL;DR

@sini
sini / 2026-06-12-delivery-edge-unification-design.md
Created June 12, 2026 22:09
den v1 delivery-edge unification — delivery-half debt elimination design (edge algebra, Π(root), trace-gated ports)

Delivery-edge unification — v1 delivery-half debt elimination

  • Date: 2026-06-12
  • Status: Design approved (sectioned review with maintainer); pending spec review + implementation plan.
  • Scope: den v1 fx-pipeline, delivery/collection half. Full sweep, audit-driven. Public API free to improve, with route/provides retained as shims (see §4).
  • Strategic premise: v2/HOAG timing is uncertain — v1 is the product and must be as correct as possible. This completes the stabilization the binding-half decoupling (2026-06-12 core-resolver spec) started: that effort purified who binds what, where emission lands; this one purifies how content reaches instantiation roots.
  • Baseline: branch feat/entity-gen-schema-port @ b1619a47 (rebased on vic/den main fe63b4bf), CI 947/947, nix-config parity green.

1. Problem — the delivery half is legacy debt

@sini
sini / 2026-06-12-core-resolver-host-user-decoupling-design.md
Created June 12, 2026 17:58
den v1 fx-pipeline: core-resolver host/user decoupling — class-local relationship resolution (fixes denful/den#609)

Core-resolver host/user decoupling — class-local relationship resolution

  • Date: 2026-06-12
  • Status: Design approved; not implementable until Phase 0 (carrier census) closes.
  • Scope: den v1 (soon-legacy) fx-pipeline. Stabilize and shrink before HOAG so v1↔v2 parity is assertable.
  • Triggers: denful/den#609 (host-included homeManager silently delivered only when the aspect is user-parametric) + an audit finding that the core resolver hardcodes host/user/homeManager.

1. Problem

1.1 The bug (denful/den#609)

@sini
sini / 2026-06-11-entity-isolation-aware-extraction-design.md
Created June 11, 2026 15:27
den: entity-isolation-aware subtree extraction — fixing delivered child-host content leak (design spec)

Entity-isolation-aware subtree extraction (den core)

Date: 2026-06-11 Status: Design — approved for planning Target: den core (feat/delivered-child-host-lazy, off 4f317c5a which nix-config pins) Unblocks: Task 4 of 2026-06-10-delivered-child-host-foundation-plan.md (cortex-cuda rewire)

Problem

extractSubtreeModules (den nix/lib/aspects/fx/resolve.nix ~215-254) builds a

@sini
sini / 2026-06-09-nixidy-transforms-design.md
Last active June 9, 2026 17:31
Nixidy generic transforms — design

Nixidy generic transforms — design

Date: 2026-06-09 Status: Approved design, pre-implementation Repos: github:sini/nixidy (fork, branch feat/crd-native-module or successor), sini/nix-config

Problem

nix-config renders Kubernetes manifests with nixidy, then post-processes the

@sini
sini / 2026-06-09-projected-hasaspect-v1.md
Last active June 9, 2026 16:10
Den: projected hasAspect (v1 patch, HOAG-aligned)

Projected hasAspect (v1 patch, HOAG-aligned)

Status: approved (conversational, 2026-06-09). Scope: minimal v1 patch whose semantics match den-v2 HOAG, so it is not throwaway design — only its carrier is.

Problem

user.hasAspect aspectX returns false when aspectX is delivered into the user's scope via provides/policy (e.g. igloo.provides.tux.includes = [ aspectX ]), even though the config genuinely applies. Cause: entity hasAspect

@sini
sini / pipe-shared-aspect-scope-leak.nix
Created June 5, 2026 19:46
den: quirk scope-leak reproduction — quirks emitted/consumed via a shared aspect must stay host-local without pipe.collect (denTest suite)