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 / den-aware-lsp-gen-policy-graph-scoping-design.md
Last active July 20, 2026 18:55
den-aware tooling — scoping design: one query engine, two frontends (LSP + MCP, MCP-first) over den's node.query resolution facet; gated value ladder over vanilla nixd / NixOS

den-aware language server — gen libs + policy + native graphs (scoping)

Repo: den-server (LSP + MCP frontends) · den/gen (projection lib + node.query facet) · nixd (upstream reference) · Date: 2026-07-20 · Status: approved scoping design (gate ladder + consumer analysis; vehicle = one den-server with LSP + MCP frontends over a shared query engine, built MCP-first; Gate-2 spike decides viability + routing, not the vehicle)

Purpose

Scope the work and delivery order for extending Nix language tooling to understand den's gen libraries, policy system, and native (gen-graph) graphs. This is a scoping spec: it fixes the value ladder, the eval-model seam that governs it, the per-gate capability delta over vanilla nixd and over vanilla NixOS, and the vehicle decision

@sini
sini / 2026-07-17-d3-pure-present-registry-design.md
Created July 17, 2026 18:37
nixidy: pure-present presentation-backend registry — design spec (proposed for PR #104)

D3 (revised): Pure-present presentation-backend registry

Status: design, approved for spec review Date: 2026-07-17 Supersedes the synthesis model of 2026-06-11-d3-presentation-backend-design.md (the enum + guarded-modules dispatch). The per-app-options threading, the ArgoCD option relocation + back-compat aliases, and the minimal Flux proof carry over unchanged; only the dispatch and synthesis mechanism is redesigned.

Branch: refactor/presentation-backend (PR arnarg/nixidy#104), now rebased onto the ready-to-merge #102 (build/ layout seam) at 8c3c6b0.

1. Motivation

@sini
sini / gen-module-system-announcement-draft.md
Created July 5, 2026 18:22
Announcing gen's pure-Nix module system — faster, lighter, byte-identical to nixpkgs' lib.evalModules

Announcing gen's pure-Nix module system

Draft — publishes after the current v1-trust roadmap lands. The module system, trust artifacts, and fleet measurements are real and green today; den's next-generation internals are the foundation-laid-for, not done-yet, and are phrased that way below. Numbers grounded in gen/BENCHMARKS.md, gen/VALIDATION.md, and gen/ci/README.md as of 2026-07-05.

The short version

@sini
sini / host-aspect-settings.simple.md
Last active July 20, 2026 21:59
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 (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

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

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 के बारे में थोड़ा-बहुत

@sini
sini / host-aspect-settings.md
Last active June 26, 2026 19:22
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