The narrations
The articles of the project: one hundred and thirty-five essays in which the ideas of Softanza were first argued, with their code in the author's hand.
Read in the repository's doc/narrations folder at commit 4a184e6f0. Every article is a page. On 2026-10-08 each was run in Haro's name inside the library, block after block; a block that kept its promise says so, the others are illustrations. The code of the articles is Haro code: where an article was written before the language took its present name, the name was changed and nothing else. Genre, area and series are read from the file's name and the year from its first commit: derived, until each article carries its own header.
Where to start: a reading order
Twenty articles, in the order that takes a reader from the mental model to reactive programming. Each page says which of its blocks kept their promise.
- A Guided Path to Problem-Solving: The Softanza Mental Model
The Softanza Mental Model is a guiding principle for solving problems step-by-step through progressive exploration and manipulation of data.
paradigm essay · NLP & linguistics · 2024 · Mansour Ayouni · 4 of 7 blocks kept their promise - Softanza: Bridging Minds and Code - A Humanistic Approach to Programming
Softanza is an innovative approach to programming that dissolves the complexity of code, offering an inclusive pathway for individuals—regardless of their technical background—to transform their ideas into working software.
paradigm essay · NLP & linguistics · 2024 · Mansour Ayouni · 0 of 13 blocks kept their promise - Writability vs. Readability of Computer Code— Softanza Asks: Why NOT Both?
Imagine writing code that flows as naturally as your thoughts, where programming constructs mirror the linguistic patterns of human communication.
comparison · NLP & linguistics · 2024 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza: Functions as Linguistic Artifacts - A Comprehensive Narration
Imagine a programming language where code reads like natural conversation, where functions adapt to human thought patterns rather than forcing programmers into rigid syntactic constraints.
paradigm essay · NLP & linguistics · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Near-Natural Programming: Bridging Human Thought and Code Execution
How the Softanza library enables executable code that reads like everyday language, powered by elegant design in the Haro programming language
paradigm essay · NLP & linguistics · 2025 · Mansour Ayouni · 3 of 15 blocks kept their promise - **Natural Language Programming, Reimagined: The stzNatural Class in Softanza**
In a world increasingly seduced by large language models and AI-generated code, stzNatural class—part of the Softanza library for the Haro programming language—offers a radical yet refreshingly pragmatic alternative: natural language programming that actual...
feature essay · NLP & linguistics · 2025 · Mansour Ayouni · 0 of 12 blocks kept their promise - Softanza Knowledge Porgramming: Crafting the Semantics of Thought
Imagine a world where information isn't just stored, but intelligently connected. Where concepts aren't static labels, but dynamic, interrelated entities that can be queried, expanded, and understood in context.
paradigm essay · NLP & linguistics · 2024 · Mansour Ayouni · 0 of 6 blocks kept their promise - Conditional Code in Softanza — Constraining Functions with W and WF
Many Softanza functions accept a constraint: a small piece of logic that decides, per item, whether it qualifies. "Find the items that are uppercase", "count the even numbers", "keep the strings longer than 3 characters".
paradigm essay · several areas · 2026 · Mansour Ayouni · not run: does not load as written - Beyond Loops: The Walker Metaphor in Softanza
Softanza’s stzWalker classes redefine iterative processing by evolving the traditional loop construct into a rich, intelligent navigation system.
paradigm essay · Collections & objects · 2025 · Mansour Ayouni · 10 of 18 blocks kept their promise - The Narrative of Transformations: Tracking Object History in Softanza
In programming, data transformations often happen inside variables in the blink of an eye, leaving no trace of their journey. Softanza challenges this paradigm with a groundbreaking feature that captures the entire lifecycle of object modifications.
feature essay · Collections & objects · 2024 · Mansour Ayouni · 1 of 8 blocks kept their promise - Taming Deep Lists with Softanza
Softanza, Mastering Depths from the Heart.
feature essay · Collections & objects · 2025 · Mansour Ayouni · 5 of 19 blocks kept their promise - Mastering Regular Expressions with Softanza: A Modern Approach to Pattern Matching
Regular expressions are a powerful tool for pattern matching and text processing, but their traditional syntax and behavior can be complex and unintuitive.
tutorial · Pattern matching · 2025 · Mansour Ayouni · 0 of 7 blocks kept their promise - Softanza Listex: Bringing Pattern Matching to Lists
Pattern matching has revolutionized data validation and manipulation across various programming paradigms. While traditional regex excels at string matching, structured data—especially deeply nested lists—requires a more expressive approach.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · 0 of 8 blocks kept their promise - Softanza Regexuter: Regex as Computational Reactive Medium
The stzRegexuter class extends traditional pattern matching into a sophisticated system for reactive computational processing.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - Agents That Cannot Hurt You
Everyone building agents in 2026 is handed roughly the same shopping list: a Python project, a model provider, a graph framework, a vector store, a set of tools with typed schemas, a tracing service, and a chapter of safety advice — allowlists, sandboxes, h...
paradigm essay · Agents & conversation · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Your First App with stzApp: A World That Lives, and Wants
Aïcha builds a tool for a bank in Niamey. Field agents visit clients. She doesn't think "database, screens, deployment." In Softanza she thinks about a small world — what lives in it, what's true of it, how it moves, what it's for, and where it endures.
tutorial · Web & app server · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Emulating the Whole Solution
Most stacks let you run a part in isolation and simulate the rest. You boot the phone app in an emulator that talks to a mocked backend; you flash firmware to a dev board wired to a fake sensor.
series · System programming · 2026 · Mansour Ayouni · 2 of 5 blocks kept their promise - The Honest Stopwatch
Most timing code starts casually -- a clock() before, a clock() after, a subtraction -- and inherits three quiet defects. The clock is coarse (CLOCKSPERSEC granularity).
design essay · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Security Ledger
It usually means a text file. Anyone who can write to it can rewrite it, and nothing about the file objects. "Trust me, it's in the log" is not a security property — which is why the industry built hash chains, transparency logs and WORM storage around the...
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Reaxis: A Natural Model for Reactive Programming in Haro, by Softanza
Reactive programming suffers from a profound semantic crisis. We've borrowed metaphors from plumbing ("backpressure"), event management ("handlers"), telephone systems ("callbacks"), and publishing ("subscribers/producers").
paradigm essay · Concurrency & distribution · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance
The series
A series is read in order.
- The performance series (11)
Eleven articles of 2026 on measuring: the load, the profile, the trace, the judgment, the monitor.
- The security series (14)
Fourteen articles of 2026 on security: the front door, the secrets, the ledger, detection, response.
- The delivery series (5)
Five articles of 2026 on delivery: planning, emulating, deploying, service virtualization.
Every article (135)
- Softanza: Bridging Minds and Code - A Humanistic Approach to Programming
Softanza is an innovative approach to programming that dissolves the complexity of code, offering an inclusive pathway for individuals—regardless of their technical background—to transform their ideas into working software.
paradigm essay · NLP & linguistics · 2024 · Mansour Ayouni · 0 of 13 blocks kept their promise - A Guided Path to Problem-Solving: The Softanza Mental Model
The Softanza Mental Model is a guiding principle for solving problems step-by-step through progressive exploration and manipulation of data.
paradigm essay · NLP & linguistics · 2024 · Mansour Ayouni · 4 of 7 blocks kept their promise - Softanza Knowledge Porgramming: Crafting the Semantics of Thought
Imagine a world where information isn't just stored, but intelligently connected. Where concepts aren't static labels, but dynamic, interrelated entities that can be queried, expanded, and understood in context.
paradigm essay · NLP & linguistics · 2024 · Mansour Ayouni · 0 of 6 blocks kept their promise - Softanza Regexuter: Regex as Computational Reactive Medium
The stzRegexuter class extends traditional pattern matching into a sophisticated system for reactive computational processing.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - Softanza Listex: Bringing Pattern Matching to Lists
Pattern matching has revolutionized data validation and manipulation across various programming paradigms. While traditional regex excels at string matching, structured data—especially deeply nested lists—requires a more expressive approach.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · 0 of 8 blocks kept their promise - Beyond Loops: The Walker Metaphor in Softanza
Softanza’s stzWalker classes redefine iterative processing by evolving the traditional loop construct into a rich, intelligent navigation system.
paradigm essay · Collections & objects · 2025 · Mansour Ayouni · 10 of 18 blocks kept their promise - Softanza ExterLib: A Foundation for Domain-Driven Polyglot Programming
In an era where artificial intelligence increasingly promises to automate programming itself, a fundamental question emerges: what is the evolving role of human developers? As large language models generate entire functions and applications, some argue that...
paradigm essay · Extensibility & foreign code · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Refinement-Centered Programming with stzPolyCode
Software development has traditionally been split between exploratory coding and rigid production environments. The Softanza library introduces a groundbreaking approach with its stzPolyCode framework: Refinement-Centered Programming.
paradigm essay · Extensibility & foreign code · 2025 · Mansour Ayouni · no code - From Sequential Bottlenecks to Reactive Solutions: A Programming Journey
Imagine you're building an application that needs to perform three independent calculations: adding two numbers, squaring a value, and summing an array. Your first instinct is to write straightforward sequential code:
paradigm essay · Concurrency & distribution · 2025 · Mansour Ayouni · not run: does not load as written - Softanza Reactive Programming Semantics: A Conceptual Framework
One of Softanza's core missions is simplification through semantic clarity. The programming world is cluttered with overlapping, confusing terminologies that create unnecessary cognitive overhead.
paradigm essay · Concurrency & distribution · 2025 · Mansour Ayouni · 0 of 2 blocks kept their promise - Reaxis: A Natural Model for Reactive Programming in Haro, by Softanza
Reactive programming suffers from a profound semantic crisis. We've borrowed metaphors from plumbing ("backpressure"), event management ("handlers"), telephone systems ("callbacks"), and publishing ("subscribers/producers").
paradigm essay · Concurrency & distribution · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Great Simplification: How Reaxis Dissolves Decades of Reactive Programming Complexity
On January 10th, 2024, a developer named Mark Maker posted a question to the libuv Google Group that would inadvertently demonstrate one of the most significant breakthroughs in reactive programming paradigms.
paradigm essay · Concurrency & distribution · 2025 · Mansour Ayouni · not run: does not load as written - Programming the Future, Litterally, in Softanza
Programming traditionally forces immediate execution - each action happens as soon as you call it. Future Actions let you plan a sequence first, then execute it all at once with natural timing control.
paradigm essay · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza: Functions as Linguistic Artifacts - A Comprehensive Narration
Imagine a programming language where code reads like natural conversation, where functions adapt to human thought patterns rather than forcing programmers into rigid syntactic constraints.
paradigm essay · NLP & linguistics · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Near-Natural Programming: Bridging Human Thought and Code Execution
How the Softanza library enables executable code that reads like everyday language, powered by elegant design in the Haro programming language
paradigm essay · NLP & linguistics · 2025 · Mansour Ayouni · 3 of 15 blocks kept their promise - Time Programming in Softanza: A Gentle Introduction
Time is everywhere in software. Birthdays, deadlines, business hours, event timestamps—each scenario needs a different lens. Softanza recognizes this with three specialized classes that work together seamlessly.
paradigm essay · several areas · 2025 · Mansour Ayouni · 0 of 6 blocks kept their promise - Temporal Design Philosophy of stzTimeLine
Most time-handling libraries across ecosystems (Python’s datetime, Java’s java.time, JavaScript’s Luxon, etc.) treat time as scalar values to be parsed, formatted, or arithmetically manipulated. They stop at representation and calculation.
paradigm essay · several areas · 2025 · Mansour Ayouni · no code - stzGraph: Computational Foundation and Design
stzGraph separates structure (how things connect) from semantics (what connections mean). This single decision enables reuse across workflows, org hierarchies, data flows, service maps, and language models.
paradigm essay · Diagramming & graphs · 2025 · Mansour Ayouni · 0 of 3 blocks kept their promise - stzNumbrex: A Pattern Language for Numbers
Validating numbers can be a chore. Take RGB colors—three integers from 0 to 255. Usually, you'd write lots of code: check the list length, loop through each number, confirm it’s an integer, not negative, and not over 255.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - stzTimex: A Pattern Language for Time in Softanza
Working with time in code is often a tangle of arithmetic and conditions — subtracting timestamps, looping through events, comparing durations, checking overlaps. The logic sprawls, becomes brittle, and hides intent.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · 3 of 12 blocks kept their promise - stzNumbrex: A Pattern Language for Numbers in Softanza
Numbers aren’t just quantities — they embody structure, logic, and identity. A number like 42 is not merely a scalar: it’s even, composite, divisible by 3 and 7, and composed of digits [4, 2].
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - stzMatrex: Declarative Pattern Matching for Matrices in Softanza
Matrices are not just collections of numbers — they embody structure, geometry, and mathematical meaning. Recognizing whether a matrix is square, symmetric, diagonal, or identity is often more significant than performing arithmetic operations on it.
paradigm essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - Conditional Code in Softanza — Constraining Functions with W and WF
Many Softanza functions accept a constraint: a small piece of logic that decides, per item, whether it qualifies. "Find the items that are uppercase", "count the even numbers", "keep the strings longer than 3 characters".
paradigm essay · several areas · 2026 · Mansour Ayouni · not run: does not load as written - Rules That See the Whole Picture
Softanza used to check its house rules with a text scanner: read the source line by line, and if a line looks like def len(, complain. That is a grep with a nicer return type.
paradigm essay · Diagramming & graphs · 2026 · Mansour Ayouni · 6 of 7 blocks kept their promise - Agents That Cannot Hurt You
Everyone building agents in 2026 is handed roughly the same shopping list: a Python project, a model provider, a graph framework, a vector store, a set of tools with typed schemas, a tracing service, and a chapter of safety advice — allowlists, sandboxes, h...
paradigm essay · Agents & conversation · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Repetition with Elegance: Exploring @N() and @NXT() Smart Builders in Softanza
In the hands of a painter, repetition is not mundane—it’s an art form. Each stroke, though seemingly similar, contributes to the greater beauty of the canvas. Similarly, in programming, crafting repetitive patterns can elevate code from functional to elegant.
design essay · Collections & objects · 2024 · Mansour Ayouni · 6 of 6 blocks kept their promise - Softanza Eye Sees the Invisible: Unmasking Hidden Unicode Characters
Invisible characters are a fascinating aspect of Unicode that often go unnoticed but can significantly impact text processing. The Softanza library provides robust tools for working with these hidden characters.
design essay · Graphics · 2025 · Mansour Ayouni · no code - Walking at the Edge — A Naturally-Oriented and Practical Design
The stzWalker class introduces a subtle but powerful principle: Walking at the Edge. This principle governs how the walker behaves when a step would take it outside the permitted walkable range.
design essay · Collections & objects · 2025 · Mansour Ayouni · not run: does not load as written - DeepContains still reports that "X" exists down inside the nested list
In Haro, truth is pure and direct — a language-level agreement between logic and simplicity. An empty string is false, a non-empty one is true. An empty list is false, while a non-empty list is true. Objects, by their very existence, are true.
design essay · Collections & objects · 2025 · Mansour Ayouni · 0 of 6 blocks kept their promise - The Parser That Says No
Softanza had no XML at all. It now has one, and it arrived from a direction nobody planned: the digital-signature work needed a parser it could trust, and a parser you can trust turns out to be exactly the parser an application wants.
design essay · Files & formats · 2026 · Mansour Ayouni · 10 of 12 blocks kept their promise - The Engine Senses
Before P1, the Softanza engine could tell time with nanosecond precision -- and nothing else about itself. No process memory, no system memory, no CPU time.
design essay · System programming · 2026 · Mansour Ayouni · 1 of 5 blocks kept their promise - The Honest Stopwatch
Most timing code starts casually -- a clock() before, a clock() after, a subtraction -- and inherits three quiet defects. The clock is coarse (CLOCKSPERSEC granularity).
design essay · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - InsertSubstrings(): A Powerful String Manipulation Tool in Softanza
Developers often face the challenge of inserting a list of formatted substrings into existing text. Softanza, a foundation library for Haro programming language, offers a powerful solution to this problem with its InsertSubstrings() feature.
feature essay · String · 2024 · Mansour Ayouni · 3 of 4 blocks kept their promise - An overview of String Art support in Softanza
Softanza library for Haro language introduces string art texts and paintings, enhancing the programming experience in code narrations, educational examples, and console text-based games.
feature essay · String · 2024 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Understanding Section Merging Features in Softanza
Softanza library provides three sophisticated methods for merging sections (mainly in the stzListOfSections class): MergeInclusive(), MergeOverlapping(), and MergeSections().
feature essay · Collections & objects · 2024 · Mansour Ayouni · 2 of 13 blocks kept their promise - Visual Sequence Finding in Softanza
Softanza transforms string sequence finding in Haro language from a basic search operation into a visually rich experience. Let's explore its features through practical examples.
feature essay · String · 2024 · Mansour Ayouni · 4 of 6 blocks kept their promise - Five Practical Applications on Strings of the / Operator in Softanza
The Softanza library for the Haro programming language introduces a groundbreaking set of features centered around the / operator, transforming the way strings (and lists) are manipulated.
feature essay · String · 2024 · Mansour Ayouni · 1 of 5 blocks kept their promise - The Narrative of Transformations: Tracking Object History in Softanza
In programming, data transformations often happen inside variables in the blink of an eye, leaving no trace of their journey. Softanza challenges this paradigm with a groundbreaking feature that captures the entire lifecycle of object modifications.
feature essay · Collections & objects · 2024 · Mansour Ayouni · 1 of 8 blocks kept their promise - Unlocking the Power of Lists-in-Strings with Softanza
It’s a calm day in the development lab, and you’re faced with an intriguing problem: you need to work with lists hosted inside strings.
feature essay · Collections & objects · 2024 · Mansour Ayouni · 7 of 8 blocks kept their promise - Emptiness in Strings, Clear Rules: The Softanza Way
In programming, emptiness—represented as the empty string ""—is often mishandled, leading to unexpected results, bugs, and inconsistencies.
feature essay · String · 2024 · Mansour Ayouni · 6 of 9 blocks kept their promise - Simplifying Orientation in String Removal with Softanza
In text manipulation, removing a substring from the left or right of a string is a common task, but it can quickly become tricky when handling languages with different orientations, such as Arabic.
feature essay · String · 2024 · Mansour Ayouni · 4 of 5 blocks kept their promise - The Symphony of Repetition: A Coding Journey in Softanza
Softanza introduces a remarkable function, Repeat(), along with its eXTended form RepeatXT(), that transforms value repetition into an elegant, flexible coding technique.
feature essay · Collections & objects · 2024 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Decoding Duplicates: Exploring Duplicate Detection and Removal with Softanza
Let’s dive into an engaging exploration of how Softanza handles duplicate detection and management in strings. Consider this illustrative string:
feature essay · String · 2024 · Mansour Ayouni · 1 of 7 blocks kept their promise - Managing Over Spaces in Softanza: Beyond Simplify, Trim, and RemoveSpaces
Managing spaces in strings is a common task in programming, especially when dealing with user input, text formatting, or data cleaning.
feature essay · String · 2024 · Mansour Ayouni · 2 of 6 blocks kept their promise - Unmasking Unicode Lookalikes
The world of Unicode characters is vast, and sometimes tricky, especially when visually similar characters are actually different. Let's explore this with examples and see how Softanza offers a solution.
feature essay · String · 2024 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Probabilistic Quantifiers in Softanza: Natural Proportions Meet Logical Precision
Softanza introduces probabilistic quantifiers like Few(), Some(), Most(), and All(), allowing for more intuitive data manipulation by reflecting natural language.
feature essay · Numeric & optimization · 2025 · Mansour Ayouni · 2 of 6 blocks kept their promise - Simplifying Regular Expressions with the Enhanced stzRegexData Library
Regular expressions (regex) have become indispensable tools for handling text-based data. They are used across a wide array of domains, from user interface (UI) applications and natural language processing (NLP) to code generation and data parsing.
feature essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - The Softanza RegexMaker: Making Regex Human-Friendly
Regular expressions (regex) are powerful but notorious for their cryptic syntax. The Softanza RegexMaker class reimagines regex creation with a declarative, human-readable approach.
feature essay · Pattern matching · 2025 · Mansour Ayouni · 0 of 9 blocks kept their promise - Expanding Haro’s Horizons: Unlocking New Possibilities with Python
The Haro programming language, on which Softanza is built, is known for its simplicity and innovative capabilities. Now, Haro has taken a significant leap forward with the introduction of py(), a powerful feature from the Softanza library.
feature essay · Extensibility & foreign code · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - R() in Haro: Statistical Power, One Call Away
Softanza makes it easy to integrate R, a powerful language for statistics and visualization, into Ring. The R() function allows you to run R scripts directly within Haro, bringing R’s analytical capabilities into your workflow without switching environments.
feature essay · Extensibility & foreign code · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Taming Deep Lists with Softanza
Softanza, Mastering Depths from the Heart.
feature essay · Collections & objects · 2025 · Mansour Ayouni · 5 of 19 blocks kept their promise - FastProUpdate(): A Semantic Rengineering of RingFastPro extension
RingFastPro extension, by Mahmoud Fayed, provides essential high-performance list operations in Haro through C-based optimization.
feature essay · Collections & objects · 2025 · Mansour Ayouni · not run: does not load as written - Matrix Computing in Softanza with stzMatrix
Matrices are the unsung heroes of computational problem-solving, powering everything from data analysis to image processing and machine learning.
feature essay · Numeric & optimization · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza EXCIS: Orchestrating a Polyglot Symphony
Modern software development requires a broad spectrum of capabilities: high-performance computing for speed, machine learning for intelligence, statistical analysis for insights, and rule-based systems for logic.
feature essay · Extensibility & foreign code · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Beyond Inner Loops: Walking on the Second Dimension in Softanza
Building upon the innovative stzWalker paradigm, Softanza's stzWalker2D elevates traversal to new dimensions by providing an elegant alternative to nested loops for two-dimensional data structures.
feature essay · Collections & objects · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - "Code Meets Cells": The Spreadsheet Metaphor in Softanza's stzTable
Data tables are essential for many programming tasks, from data storage to complex analyses. Softanza's stzTable class for the Haro programming language provides an intuitive and powerful way to work with tabular data.
feature essay · Tables & data · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza Ploting System: Where AsciiArt Meets DataViz
Data visualization turns raw numbers into understanding. The Softanza Ploting System elevates that idea by transforming numbers into expressive, text-based visual stories.
feature essay · Graphics · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Smart Adverb Generation in Softanza
The Softanza library introduces an intelligent Adverb() function that transforms adjectives and nouns into contextually appropriate adverbs using a priority-based rule system.
feature essay · Agents & conversation · 2025 · Mansour Ayouni · 3 of 11 blocks kept their promise - Your First Taste of Systems Programming - Without the Fear
How Softanza's Complete Low-Level Framework Takes You from Buffers to OS Integration
feature essay · System programming · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Beyond File Modes: The Softanza Intent-Based Paradigm
Programming languages have universally adopted the C-style file handling paradigm, forcing developers to think in terms of technical "modes" rather than natural intentions.
feature essay · Files & formats · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza's stzFolder: A Journey Through Intelligent Directory Navigation
This article examines the stzFolder class from the Softanza library for Haro, demonstrating its directory navigation capabilities through practical examples.
feature essay · Files & formats · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Intelligent Folder Navigation in Softanza
In Softanza, folder navigation follows a simple but powerful principle: your mental location follows your actions. When you perform an operation in a folder, the system intelligently updates your current position to reflect where you just worked.
feature essay · Files & formats · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Natural Folder Navigation in Softanza
In Softanza, your mental location follows your actions. When you perform an operation in a folder, the system naturally updates your current position to reflect where you just worked. This eliminates the cognitive overhead of manually tracking your location.
feature essay · NLP & linguistics · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - stzAppServer: The Persistent Computational Web Engine Revolution
Imagine you're building a web API that needs to analyze text, process complex strings, or perform linguistic computations. In the traditional web server model, every single request follows this painful cycle:
feature essay · Web & app server · 2025 · Mansour Ayouni · not run: does not load as written - The Unified @Find() Function in Softanza
Haro provides multiple approaches for finding different data types, each effective for its specific use case. However, this fragmented experience requires programmers to navigate different abstraction levels and conceptual domains, creating cognitive overhe...
feature essay · Collections & objects · 2025 · Mansour Ayouni · 1 of 4 blocks kept their promise - Practical Randomness in Softanza
Softanza builds on Haro’s C-based random engine by offering semantic APIs that cover the most common randomness needs in programming.
feature essay · Numeric & optimization · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Named Variables in Softanza: the What, Why and How!
Softanza’s Named Variables feature makes it possible to construct variable names dynamically at runtime. This is especially powerful for generating variables with systematic naming patterns (e.g., name1, name2, …, name100), or variables whose names are deri...
feature essay · Collections & objects · 2025 · Mansour Ayouni · 10 of 13 blocks kept their promise - From "Quick" to "Quickly": Programmatic Adverb Formation
Softanza Adverb() function transforms (any) word into its proper adverbial form, handling English morphology complexities for programmers generating natural language messages.
feature essay · Agents & conversation · 2025 · Mansour Ayouni · 6 of 10 blocks kept their promise - Date Programming Made Easy in Softanza
You're building a project timeline tracker. The client wants to see "in 2 weeks" instead of "14/10/2025". You need to add three months to a contract start date, but only if it falls on a weekday.
feature essay · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Software Global Reach: Locale Management the Softanza Way
The Softanza library for Haro brings a refreshingly intuitive approach to locale management, wrapping the Softanza Engine's powerful internationalization capabilities in an API that feels natural and expressive.
feature essay · Internationalization · 2025 · Mansour Ayouni · 7 of 14 blocks kept their promise - Time Handling in Softanza
In applications such as scheduling tools or timers, developers often face repetitive tasks when handling time. These include converting between 12-hour and 24-hour formats, calculating durations with potential carry-overs across hours or days, and performin...
feature essay · several areas · 2025 · Mansour Ayouni · 1 of 15 blocks kept their promise - stzDuration: Measuring Time in Softanza
You're building a project tracker. Three tasks took "2 days", "5 days", and "4 days" respectively. How long is the project? Add a 20% buffer and show it in human terms.
feature essay · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - **Time Modeling in Softanza using stzTimeLine**
Imagine you’re planning a product launch. You’ve got milestones, sprints, blackout dates for holidays, and three HR reviews scattered across the year. In most systems, that’s a spreadsheet or a calendar invite.
feature essay · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Safe Access to Haro Hashlists: How Softanza Solves a Common Problem
Haro's hashlist is a powerful and flexible data structure, but it has a subtle yet dangerous behavior that can lead to hard-to-debug errors.
feature essay · Collections & objects · 2025 · Mansour Ayouni · not run: does not load as written - stzTablex: Declarative Pattern Matching for Tables in Softanza
Tables are everywhere in programming—from CSV imports to database results, from spreadsheet data to configuration files. But validating table structure, checking data quality, and filtering table collections often requires verbose conditional logic that obs...
feature essay · Pattern matching · 2025 · Mansour Ayouni · not run: does not load as written - **Natural Language Programming, Reimagined: The stzNatural Class in Softanza**
In a world increasingly seduced by large language models and AI-generated code, stzNatural class—part of the Softanza library for the Haro programming language—offers a radical yet refreshingly pragmatic alternative: natural language programming that actual...
feature essay · NLP & linguistics · 2025 · Mansour Ayouni · 0 of 12 blocks kept their promise - stzGraph — Modeling Knowledge Through Structure
Software systems today are built on relationships: microservices depend on one another, workflows move across steps, configurations link modules to environments, and business rules weave threads between entities that must interact correctly.
feature essay · Diagramming & graphs · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - When “different” is not enough: the story behind Diff(), DiffXT() and DiffXTT() in stzList
In most programming libraries, diff is treated as a simple operation: compare two collections and list what is not the same.
feature essay · Collections & objects · 2025 · Mansour Ayouni · 1 of 3 blocks kept their promise - Softanza: Simplifying the Power of C++ Backends for Unicode Handling
In programming in general, there's often a trade-off between power and simplicity. Softanza, a library for the Haro programming language, aims to bridge this gap by leveraging robust native backends while providing developers with a unified, accessible inte...
comparison · String · 2024 · Mansour Ayouni · 1 of 6 blocks kept their promise - Writability vs. Readability of Computer Code— Softanza Asks: Why NOT Both?
Imagine writing code that flows as naturally as your thoughts, where programming constructs mirror the linguistic patterns of human communication.
comparison · NLP & linguistics · 2024 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Performance Battle: A Window into EXCIS system in Softanza
Softanza EXCIS, built on the stzExtCode class, makes it effortless to embed and execute code from multiple languages within a Haro program.
comparison · Performance · 2025 · Mansour Ayouni · no code - Why I Built stzNatural: A Journey from Haro's NaturalLib to Softanza's Natural System
By Mansour Ayouni, Creator of Softanza library
comparison · NLP & linguistics · 2025 · Mansour Ayouni · 0 of 4 blocks kept their promise - What ChatGPT Thinks of the stzGraph Module in the Softanza Library
I shared the stzGraphTest.ring file with ChatGPT and asked a simple question:
comparison · Diagramming & graphs · 2025 · Mansour Ayouni · 0 of 1 blocks kept their promise - ClaudeAI Opinion on stzGraph design
I shared the full codebase of the stzGraph module (across several classes) with ClaudeAI and asked for an entirely objective assessment.
comparison · Diagramming & graphs · 2025 · Mansour Ayouni · not run: does not load as written - Softanza stzGraph vs. Modern Graph Ecosystem
The rule system is particularly innovative - rules are first-class citizens that can be stored, versioned, and applied dynamically.
comparison · Diagramming & graphs · 2025 · Mansour Ayouni · no code - Mastering Precision with the Sit() Function
The Sit() function stands out as a surgical tool for precision string manipulation. Whether you’re designing advanced text editors, processing linguistic data, or debugging complex parsers, Sit() adapts to your needs with unparalleled flexibility.
tutorial · String · 2024 · Mansour Ayouni · 3 of 3 blocks kept their promise - Mastering Regular Expressions with Softanza: A Modern Approach to Pattern Matching
Regular expressions are a powerful tool for pattern matching and text processing, but their traditional syntax and behavior can be complex and unintuitive.
tutorial · Pattern matching · 2025 · Mansour Ayouni · 0 of 7 blocks kept their promise - The Navigator's Grid: Mastering stzGrid in the Softanza Library
The stzGrid class is a powerful navigational framework in the Softanza library, offering elegant solutions for working with two-dimensional grid structures. This article uses visual examples and practical applications to help you fully grasp its capabilities.
tutorial · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Mastering URL Manipulation with stzUrl: A Complete Guide
The stzUrl class is part of the web-wings module in the MAX layer of the Softanza library for Ring. Alongside other web-focused classes like stzJson and stzHtml, it provides sophisticated URL manipulation capabilities built on top of the Softanza Engine's n...
tutorial · Web & app server · 2025 · Mansour Ayouni · 0 of 15 blocks kept their promise - Softanza Reactive Objects: A Complete Beginner's Tutorial
Imagine you're using a spreadsheet like Excel. When you change a number in one cell, all the connected formulas update instantly without you having to do anything extra.
tutorial · Concurrency & distribution · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza Near-Natural Programming Tutorial
Learn to write code that reads like English (or any other human language) using Softanza's NNP features.
tutorial · NLP & linguistics · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - stzDateTime: Elegant DateTime Operations in Softanza
DateTime manipulation is a universal programming challenge—combining date and time logic while handling formats, timezones, and arithmetic.
tutorial · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Time Capacity Planning in Softanza: Mastering Constraints with stzCalendar
Most scheduling tools treat time as a grid—a static calendar of slots you fill with events, often leading to manual guesswork and overlooked conflicts.
tutorial · several areas · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Graphviz DOT Language Guide: Using stzDotCode
Graphviz has been integrated into the Softanza ExerCode framework to provide a powerful, code-driven approach to creating professional diagrams.
tutorial · Diagramming & graphs · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - stzGraph: The Art of Connected Thinking
A graph is an elegant yet profound concept in computer science—a structure of nodes (entities) and edges (relationships) that illuminates how systems connect, interact, and evolve.
tutorial · Diagramming & graphs · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Introducing stzOrgChart - The Strategic Organizational Intelligence Platform
In Softanza, understanding organizational structure transcends simple box-and-line diagrams. Organizations need dynamic tools that can model, analyze, and visualize their human infrastructure with precision and depth.
tutorial · Diagramming & graphs · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza's System Call : Built on the System Process API
Haro's native system() function works well for cross-platform command execution. Softanza enhances this foundation through stzsystem() function and stzSystemCall class , leveraging the Softanza Engine's system process API for:
tutorial · System programming · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Intelligence in Motion: Graph Planning in Softanza
Softanza's Graph Module already gives you powerful tools for representing connected systems. With stzGraph, you model networks of nodes and edges. With stzDiagram, you visualize relationships.
tutorial · Diagramming & graphs · 2025 · Mansour Ayouni · not run: touches files, the network, the clock or chance - stzDataSet: Statistics as a Language of Thought
In Softanza, statistics isn't just formulas—it's a way of thinking about data. When a statistician examines data, he doesn't see numbers; he sees questions waiting for answers. His intent shapes which analytical lens he reaches for:
tutorial · Tables & data · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - stzGraphQuery: Asking Questions to Your Graph
When working with graphs, a moment inevitably arrives when the graph stops being just a structure of nodes and edges and starts becoming a world you want to explore.
tutorial · Diagramming & graphs · 2026 · Mansour Ayouni · not run: does not load as written - Your First App with stzApp: A World That Lives, and Wants
Aïcha builds a tool for a bank in Niamey. Field agents visit clients. She doesn't think "database, screens, deployment." In Softanza she thinks about a small world — what lives in it, what's true of it, how it moves, what it's for, and where it endures.
tutorial · Web & app server · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Softanza Library: Built on Real-World Needs
You may think Softanza's large feature set is daunting, but believe me, each singular function has its story rooted in a real-world need, shapeing every aspect of the library—from its features and programming style to its data structures and documentation.
use case · several areas · 2025 · Mansour Ayouni · no code - Empowering Real-World Applications with Softanza's Linear Solver for Haro
Imagine you're building an app that helps a pizza shop decide how many pizzas and salads to make daily to maximize profit. Or perhaps you're designing a game where players allocate resources to build the ultimate fantasy army.
use case · Numeric & optimization · 2025 · Mansour Ayouni · 0 of 5 blocks kept their promise - Organizational Intelligence in Action
This article follows a real-world journey at a Softabank (Virtual bank name, BCEAO-regulated). We deliberately start with a realistically flawed, non-compliant structure — exactly what you often inherit in practice — then use stzOrgChart’s intelligence laye...
use case · Diagramming & graphs · 2025 · Mansour Ayouni · 0 of 7 blocks kept their promise - Getting Paid and Paying
A platform that sells in Niger is paid in francs CFA, by people who hold an account at a bank or a mobile-money operator that is not its own.
use case · Web & app server · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - From Dev to Deploy Without Leaving Your Editor
Building a product that runs on more than one machine is, in most stacks, an exercise in tool management. A backend that deploys to a Linux server, a phone app that ships to Android, firmware that flashes to a microcontroller — each is a different world, re...
series · System programming · 2026 · Mansour Ayouni · 1 of 8 blocks kept their promise - Deploying to the Target Sites
The emulator answered the hard question: does it work? Every part ran its real engine in the browser, so you know the solution is sound. But sound isn't shipped.
series · System programming · 2026 · Mansour Ayouni · 1 of 5 blocks kept their promise - Emulating the Whole Solution
Most stacks let you run a part in isolation and simulate the rest. You boot the phone app in an emulator that talks to a mocked backend; you flash firmware to a dev board wired to a fake sensor.
series · System programming · 2026 · Mansour Ayouni · 2 of 5 blocks kept their promise - Guarding Secrets & Credentials
When you deployed to the target sites, one line carried a promise we hadn't yet kept:
series · Security & governance · 2026 · Mansour Ayouni · 2 of 8 blocks kept their promise - Planning and Provisioning a Deployment
Deploying the target sites taught the verbs: store, launch, report, all governed. But real rollouts are rarely one step. The backend must come up before the frontend that calls it. A health check must pass before you proceed.
series · System programming · 2026 · Mansour Ayouni · 2 of 4 blocks kept their promise - Governing a Project's Security
The secrets narration showed a single stzSecret — a value that redacts itself and reveals only to an effectful actor. A real project has many secrets, several sites, and more than one actor, and the risk isn't one leaked key — it's the scatter: keys created...
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Structured Logging with stzLog
Most logging ends the same way: a wall of text, and a grep the next morning. The trouble is that the moment you format an entry into a line, you throw away its structure — the level, the category, the fields — and spend the rest of its life trying to parse...
series · Performance · 2026 · Mansour Ayouni · 1 of 5 blocks kept their promise - The Front Door
Every application eventually needs to answer "who is this?" And almost every application answers it badly the first time, not through carelessness but because the field is full of details that look optional and are not.
series · Security & governance · 2026 · Mansour Ayouni · 0 of 10 blocks kept their promise - Code First, Subscribe Later
You have decided to build a small shop. You will need a payment gateway, a database, somewhere to keep uploaded images, an SMS sender for one-time codes, a model to summarise reviews, and a currency-rates API. Six vendors.
series · System programming · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Metrics and the Monitor
P1 gave the engine senses -- it can read its own memory and CPU. But a sense is not an instrument: nothing named the readings, nothing kept them, nothing watched on a cadence. P2 adds the two missing objects.
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Governed Loop
The notebook's pipeline ends where the stakes begin: Monitor -> Alert -> Analyze -> Optimize. The first three verbs only read; the fourth scales fleets, drains workers, restarts processes.
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Judgment
The industry adds performance thresholds after the incident, in a monitoring tool, in that tool's language. Softanza's position is the notebook's original two words -- SLA: design -- the promise is part of the program, stated in the operational vocabulary n...
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Profile
Everything before P5 measures: the stopwatch times, the senses read, the metrics keep, the seams attribute, the SLA judges.
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Seams
P2 built the instruments; until now they measured what you handed them. P3 attaches them to the places where requests actually flow, so R (response time) and X (throughput) stop being examples and become your server's numbers. The whole attachment is one verb:
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Tail
P4 admitted a limit honestly: alerts did not carry the trace ids of the requests that tripped them, because nothing captured traces per request. P2 owed the OTLP metrics batch a sibling for spans.
series · Performance · 2026 · Mansour Ayouni · 0 of 3 blocks kept their promise - Answerable Forever
stzGovernance.RecordDecision carried this comment:
series · Security & governance · 2026 · Mansour Ayouni · 0 of 7 blocks kept their promise - The Driven Load
P7 ruled the R-vs-X harness out honestly: the knee -- response time exploding as throughput nears its ceiling -- is queueing's signature, queueing needs CONCURRENT arrivals, and a serial in-process harness cannot produce them.
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Frame Profiler
The senses (P1) say WHETHER the process computes; the metrics (P2) say what each operation costs in aggregate. Neither says WHERE inside your own code the time lives. That is a profiler's question, and P10 answers it two honest ways at once.
series · Performance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Labels and Dimensions
The vs-the-field document called flat metric names this system's most consequential absence: http.request.ms measured everything, so "which route is slow?" had no direct answer.
series · Performance · 2026 · Mansour Ayouni · 0 of 4 blocks kept their promise - Log-Trace Correlation
After P8 the system had spans, metrics and logs -- but the logs stood apart: a log line knew when but not for which request. The field solves this with context propagation frameworks;
series · Performance · 2026 · Mansour Ayouni · 0 of 3 blocks kept their promise - Attestation and Export
I1 made the ledger hash-chained and sealable, which makes a file tamper-evident. That is necessary and not sufficient. An auditor holding the file still has to ask: who exported this, when, over what range, under which key, and how do I check it? Those ques...
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - Detection over Sequences
Softanza is full of rules. A graph rule asks whether a sandboxed actor can reach an effectful capability. A posture invariant asks what is true of the system right now. An org rule asks whether one position both approves and executes.
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Drill
Seven phases built a system that witnesses, judges, correlates, contains and attests. Every one of them was guarded — but always with events the guard itself created.
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Security Event
Softanza detects a great deal. A WebAuthn signature counter that fails to advance — the textbook cloned-credential signal. A SAML assertion presented twice. An HMAC that does not match. A nonce reused for the same key.
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Incident
I4's case says what fired and photographs the moment. That is the right thing to keep, and the wrong thing to hand a human. An investigator needs the story: who, in what order, how far they could have gone, what is exposed, and what has been done about it.
series · Security & governance · 2026 · Mansour Ayouni · not run: does not load as written - The Security Ledger
It usually means a text file. Anyone who can write to it can rewrite it, and nothing about the file objects. "Trust me, it's in the log" is not a security property — which is why the industry built hash chains, transparency logs and WORM storage around the...
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Governed Response
Witness, detect, reconstruct — none of those change anything. Contain does: it revokes a session, locks an account, rotates a secret. This is where a security system is most useful and most dangerous, and it is exactly where the library already has a doctrine:
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Rest of the Seams
I2's first pass wired six classes and stopped. The design doc's section 7 table kept the rest of the rows in plain sight, and the completion document said so as the system's largest honest gap: a detection sees only what a seam emits.
series · Security & governance · 2026 · Mansour Ayouni · not run: does not load as written - The Seams
Three unrelated things happen to a running application: someone probes a signed-request gateway, someone guesses at the login door, and a sandboxed agent reaches for a production secret. Every one of those was already detected by Softanza.
series · Security & governance · 2026 · Mansour Ayouni · not run: touches files, the network, the clock or chance - The Sentinel
I3's detections judge when asked. Somebody still has to ask, and an investigation that begins with "did anyone look at the ledger today?" has already lost. The sentinel asks on a cadence — and, crucially, speaks only when something changes.
series · Security & governance · 2026 · Mansour Ayouni · not run: does not load as written