We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
Update all wiki files to use current ARO syntax (no angle brackets around action verbs) Action verbs like Extract, Retrieve, Return, Store are plain words in ARO. Only variables and qualifiers use <angle-bracket> notation. Updated 33 files covering ~2000 action verb instances across the full wiki.
Add terminal actions (Prompt, Select, Clear) and Notify handler guards - Reference-Actions.md: add Prompt/Select/Clear to quick reference table, add TERMINAL category, add detailed TERMINAL Actions section, add Notify section with handler guards, update Action Summary Table - Guide-Actions.md: add Notify section with collection dispatch and handler guards example, add Terminal Actions section (Prompt, Select, Clear)
Update Exec action syntax to new preferred format
Document Store action deduplication and observer behavior - Add "When Observers Fire" section explaining that duplicates don't trigger events - Add "Store OR Emit, Not Both" section explaining the anti-pattern - Update Store action reference with behavior table and new-entry variable
docs: remove Receive action from reference documentation Remove Receive action from action reference tables as it has zero usage in the codebase. All event and socket data extraction uses Extract action instead. Changes: - Remove Receive from quick reference table - Remove Receive from action summary table Actual usage pattern: - Events: <Extract> the <data> from the <event: ...> - Sockets: <Extract> the <data> from the <packet: buffer>
docs: remove Route action (routes defined in OpenAPI contract) Remove RouteAction documentation as routes are defined in OpenAPI contracts, not programmatically. Changes: - Reference-Actions.md: Remove Route from quick reference and summary tables Contract-first routing: - Routes defined in openapi.yaml paths with operationIds - Feature sets named after operationId values - Routing happens automatically via contract matching - No Route action or programmatic route definition needed
docs: remove redundant Fetch action (use Request instead) Remove FetchAction documentation as it's redundant with RequestAction: - Request can do GET: `<Request> the <data> from <url>` - Request supports all HTTP methods with config object - Fetch only did GET and created verb ambiguity Changes: - Reference-Actions.md: Remove Fetch from tables and sections - Guide-Actions.md: Remove Fetch section - Guide-Data-Pipelines.md: Replace Fetch with Retrieve (correct action for repos) - Language-Tour.md: Replace Fetch with Request for HTTP examples - Action-Developer-Guide.md: Update example verbs Migration: Replace `<Fetch> ... from <url>` with `<Request> ... from <url>`
docs: update references to consolidated proposals Update wiki to reference new consolidated specification structure: - ARO-0035 → ARO-0001 (Language Fundamentals) - ARO-0038 → ARO-0003 (Type System) - ARO-0041 → ARO-0010 (Advanced Features) - ARO-0022 → ARO-0008 (I/O Services) - ARO-0031 → (inline description) - ARO-0043 → (removed from title) Updated files: - Guide-Actions.md: Remove proposal reference from List Element Access - Guide-Computations.md: Update See Also link - Guide-Data-Pipelines.md: Update type annotation reference - Guide-Dates.md: Update date/time reference - Guide-HTTP-Client.md: Update HTTP client reference - Guide-System-Commands.md: Remove proposal reference - Reference-Actions.md: Remove proposal reference - Reference-System-Objects.md: Remove proposal reference from title
docs: update all examples to new sink syntax (ARO-0043) Update 130+ instances across 25 wiki files to use the new sink syntax where the value comes directly after the verb: Old: <Log> the <message> for the <console> with "Hello". New: <Log> "Hello" to the <console>. Changes: - All Log action examples use new `<Log> <value> to the <console>` syntax - Multi-part messages use Compute then Log pattern - Reference-Actions.md updated with new syntax and prepositions - Reference-System-Objects.md cleaned up (removed backwards compat refs) - All Guide-*.md files updated consistently No backwards compatibility - this is the only valid syntax going forward.
docs(ARO-0042): clarify union semantics Update union description from "All unique elements" to "A preserved + unique from B" for clarity. This accurately describes the behavior: - All of A (including duplicates) is preserved - Only elements from B not in A's set are added
docs(ARO-0042): add set operations documentation Add comprehensive documentation for polymorphic set operations: Guide-Computations.md: - Add Set Operations section with intersect, difference, union - Document multiset semantics for duplicates - Add type behavior table for Lists, Strings, Objects Guide-Data-Pipelines.md: - Add `not in` operator to comparison operators table - Add section on set membership with `in`/`not in` - Document CSV string and array variable support Reference-Actions.md: - Expand Compute section with set operations table - Add examples for set operations on all types - Add Filter section with full comparison operators - Document `not in` and array support for Filter
docs: add .env format to file system and actions reference
docs: add .log format to file system and actions reference
docs(ARO-0040): add format-aware file I/O documentation Guide-File-System.md: - Add Format-Aware File I/O section with 12 supported formats - Add writing/reading examples for all formats - Add CSV/TSV options documentation - Add multi-format export and round-trip patterns Reference-Actions.md: - Enhance Read action with format detection table and examples - Enhance Write action with format detection table and examples - Add CSV/TSV options documentation for both actions
docs: add ARO-0038 list element access to Extract action Add documentation for list element access feature: - :first/:last keywords for array access - Numeric index (0 = last element, reverse indexing) - Range syntax (3-5) for consecutive elements - Pick syntax (0,3,7) for specific elements Updates Guide-Actions.md and Reference-Actions.md
docs: add 'as Type' syntax for optional type annotations (ARO-0038)
feat(ARO-0062): standardize service startup patterns - Update Start action: single preposition 'with' for all services - Update Stop action: single preposition 'with' - Remove Watch action (merged into Start) - Update examples to use new syntax
Merge 'Make verb' documentation from main Resolved conflict in Reference-Actions.md by keeping the Make verb syntax for CreateDirectory which is the preferred/newer approach.
docs: add Make verb syntax for CreateDirectory - Update Reference-Actions.md with new Make syntax and verbs - Update Guide-File-System.md with Make example - CreateDirectory now supports: make, createdirectory, mkdir verbs - New 'at' preposition for natural syntax
docs(wiki): remove unimplemented actions, add Split and file ops to summary - Remove unimplemented actions: Set, Configure, Stop, Flush, Wait, Parse - Add Split action to summary table - Add file operation actions to summary table (List, Stat, Exists, etc.) - Update categories for file operations
feat(ARO-0037): add Split action documentation
docs: update with ARO-0036 file operations - Reference-Actions.md: add List, Stat, Exists, CreateDirectory, Copy, Move, Append actions - Guide-File-System.md: update with new directory operations
Migrate documentation from main repository - Convert 28 markdown files to flat wiki structure - Add Guide-* prefix for Language Guide files - Add Reference-* prefix for Language Reference files - Update all internal links to wiki format - Add _Sidebar.md for navigation