liquidware-ninjaSecond brain & toolkit
Personal project. Research and learning only. Not for production. No warranty.Not for production
  • Built on my own time for research and learning. Not affiliated with, endorsed by or supported by my employer, Liquidware or Microsoft.
  • Bring your own Liquidware licenses. Don't run any of it in production or against tenants and subscriptions that matter. Test in a dedicated lab first.
  • Provided "as is", without warranty of any kind, under each repository's license. You use it at your own risk and own the Azure charges it incurs.
  • Contributions and forks are welcome and encouraged on public repos. See Contribute.

How the Liquidware & AVD Repos Fit Together

Four Liquidware repositories divide the work cleanly between open-source knowledge and Azure deployment on one side, and private assessment and packaging automation on the other—plugging directly into the avd-ops Azure Virtual Desktop foundation.

The Layers

Read from the bottom up: the AVD landing zone provides the cloud-native foundation, avd-liquidware deploys the optional Liquidware tier into Azure, ux-assess and flexapp-factory automate data analysis and application packaging, and liquidware-ninja holds the shared second brain, schemas, and guardrails for all of them.

Second Brain, Templates & Guardrails (Public · MIT / Apache-2.0)

Shared knowledge & toolkit: liquidware-ninja

Owns the 2ndbrain knowledge base (docs/knowledge/), reference guardrails (templates/), technical field notes (blog/), and pure PowerShell validation functions (LiquidwareNinja.psm1) consumed across every repo below.

Private Companion Engines (High-Level Architecture Overview)

Assess & report: ux-assess Private

Pulls Stratusphere UX /lwl/api telemetry, checks collection health, normalizes and HMAC-pseudonymizes five canonical tables, scores SpotCheck findings, and generates .xlsx, .pdf, .pptx, and Git-backed Power BI .pbip deliverables.

Evaluate & package: flexapp-factory Private

Evaluates existing application servers, joins ux-assess usage data, builds dependency DAGs, converts legacy packages (.appv, .msix, .intunewin, PSADT), and drives unattended FlexApp captures and smoke tests.

Azure & AVD Execution Tier (Public · MIT)

Liquidware in Azure: avd-liquidware

Subscription-scoped Bicep and PowerShell for Stratusphere UX appliances, CID Key rollout, ProfileUnity console/shares, and FlexApp App Attach registration.

AVD Foundation: avd-landing-zone

Entra ID-joined, Intune-managed, private-by-default Azure Virtual Desktop landing zone with FSLogix on Premium Azure Files.

AVD Verification & Design: avd-current-state & avd-assess

Read-only collector for deployed AVD estates and the target-state sizing/design methodology.

Desktop Estate (AVD, Windows 365, Citrix CVAD/DaaS, Omnissa Horizon, Windows Server RDS, Physical PCs)monitored by Stratusphere CID Keys · managed by ProfileUnity & FSLogix · layered with FlexApp · supported by CommandCTRL

Contract & Data Flows

The repositories do not take runtime code dependencies on each other. Instead, they exchange versioned JSON manifests and canonical dataset tables:

SECOND BRAIN & GUARDRAILS (PUBLIC) liquidware-ninja 2ndbrain KB (docs/knowledge/) · inspector-catalog.json · fslogix-portability-guardrails.json · flexapp-package/v1 schema · LiquidwareNinja.psm1 ASSESSMENT & PACKAGING PIPELINES (PRIVATE COMPANION REPOS) ux-assess (Private) /lwl/api exporter · HMAC pseudonymizer · SpotCheck analyzer Outputs: findings.json, baseline.json, .xlsx/.pdf/.pptx, Power BI .pbip flexapp-factory (Private · F24) Server app evaluator · Dependency DAG · 4-step media cascade Outputs: build-queue.json, smoke-tested VHDX/CimFS + v1 manifest AZURE / AVD DEPLOYMENT & TARGET DESIGN (PUBLIC) avd-assess & avd-current-state AVD target-state design (C14) & live estate verification (C11) avd-liquidware Stratusphere appliances & CID rollout ProfileUnity tier & App Attach publish avd-landing-zone Entra-only session hosts, Intune, Private Link & FSLogix Azure Files Azure Subscription, Entra Tenant & Source/Target Desktops SpotCheck catalog manifest schema app_usage telemetry sizing & baseline.json flexapp-package/v1 guardrails
Data flows between the repositories via explicit schemas: ux-assess normalizes Stratusphere UX telemetry for sizing and app rationalization, flexapp-factory emits validated FlexApp VHDX/CimFS manifests, and avd-liquidware deploys and registers them against an avd-landing-zone estate.

Shared Schemas & Contracts

Schema / ArtifactProducerConsumerPurpose
liquidware-ninja-portability-ruleset/v1liquidware-ninja (Export-LwPortabilityRuleset)avd-liquidware promotion pipelineGuarantees ProfileUnity Portability rulesets exclude all FSLogix-owned profile directories (OneDrive, Teams, Outlook, browser caches).
liquidware-ninja-flexapp-package/v1liquidware-ninja / flexapp-factoryavd-liquidware (Publish-FlexAppPackage.ps1)Records package SHA-256, VHDX/CimFS path, OS build captured on, fallback install method, and enforces the Single Assignment System Rule.
templates/stratusphere/inspector-catalog.jsonliquidware-ninjaux-assess & LiquidwareNinja.psm1Canonical Inspector IDs (0, 1, 2, 3, 4, 10), default basis dimensions, and SpotCheck thresholds with provenance.
templates/commandctrl/multisession-baseline.jsonliquidware-ninjaTest-LwCommandCtrlBaseline / avd-liquidwareEnforces multi-session user consent, privacy exclusions (no command lines, window titles, or URLs), and Stratusphere history coexistence.
output/<engagement>/dataset/*.csv & findings.jsonux-assessflexapp-factory, Power BI .pbip, & avd-assessPseudonymized canonical machine inventory, hourly utilization, login breakdown, and application usage footprint.