QFlush

QFlush is the NOSSEN command-line orchestrator for local automation, runtime modules, compose files, NPZ routing, Cortex packets, and supervised service processes.

It is designed for operators who need one small CLI that can inspect, prepare, start, stop, and clean an A11/Funesterie workspace without wiring every module by hand.

Install

Distribution Funesterie actuelle :

@funesterie/[email protected]
tags: latest, stable, internal

Le package source historique reste @nossen/qflush dans ce dossier, mais le miroir recommande pour les nouveaux consommateurs est @funesterie/qflush.

npm install -g @funesterie/qflush@stable
qflush --help

For project-local use:

npm install @funesterie/qflush@stable
npx qflush --help

What It Does

• Detects runtime modules and starts selected services.
• Generates missing environment and config files.
• Supervises background processes and stores logs under .qflush/logs.
• Reads funesterie.yml or funesterie.fcl compose definitions.
• Routes NPZ lanes with fallback scoring and circuit-breaker state.
• Applies Cortex packets from JSON or PNG carriers.
• Exposes small automation helpers used by A11, Rome, Spyder, Nezlephant, and Freeland flows.

CLI

| Command | Purpose | | --- | --- | | qflush start | Launch detected or selected modules. | | qflush kill | Stop supervised processes. | | qflush purge | Clear caches, logs, sessions, and supervisor state. | | qflush inspect | Show active services and ports. | | qflush config | Generate missing configuration files. | | qflush compose up | Start modules from funesterie.yml or funesterie.fcl. | | qflush compose down | Stop composed services and clear supervisor state. | | qflush compose logs <name> | Tail a supervised module log. | | qflush doctor | Run local health checks. | | qflush tool-run | Execute a guarded tool command through QFlush. |

Examples

qflush start
qflush start --service rome --path D:/rome
qflush start --service nezlephant --service freeland --fresh
qflush compose up --background
qflush compose logs rome
qflush purge --fresh
qflush doctor

Programmatic Use

import { buildPipeline, executePipeline } from "@funesterie/qflush";

const { pipeline, options } = buildPipeline(["start", "--service", "rome"]);
await executePipeline(pipeline, options);

Runtime Dependencies

QFlush uses the public NOSSEN package set:

• @nossen/bat
• @nossen/envaptex
• @nossen/freeland
• @nossen/nezlephant
• @nossen/rome

Installations should resolve from Google Artifact Registry first, with GitHub Packages/GHCR as the GitHub-side mirror.

Quality Gates

Run these checks before publishing or tagging a release:

npm install
npm run build
npm test
npm pack --dry-run

The published package exposes the qflush binary from dist/cli.js; keep the compiled dist output current before release.

Support NOSSEN

NOSSEN packages stay public and usable under their license. If this package helps your workflow, support is voluntary and can be any amount:

• PayPal: https://paypal.me/funeste38
• QR Wero: https://funesterie.me/assets/wero-jeffrey-cellauro-qr.png
• Contact, invoice, sponsorship or custom support: https://funesterie.me/contact/

Publishing

npm version patch
npm run build
npm test
npm publish --access public

For JFrog, generate .npmrc.jfrog with scripts/jfrog/Write-JFrogNpmrc.ps1 only when testing the old sandbox. The active path is Google Artifact Registry:

npm run google:packages:dry
npm run google:packages:publish

License

See the repository license files for commercial and non-commercial terms.