NEWS

agentr 0.2.8.4 (2026-07-06)

Released: 2026-06-30

Removed the redundant trailing "in R" from the package title for CRAN.
Removed the default backup directory from backup_agent() so write operations require an explicit user-supplied path.
Updated the README inspection example to write rendered review output under tempdir().

agentr 0.2.8.3

Released: 2026-06-24

Removed examples from the internal .safe_read_rds() and .safe_save_rds() help pages instead of documenting unexported functions with runnable examples.
Finalized the CRAN resubmission package after the internal-example cleanup.

agentr 0.2.8.2

Released: 2026-06-19

Fixed CRAN incoming feasibility notes by replacing README relative file links with absolute GitHub links.
Replaced the MIT LICENSE file with the CRAN-required DCF license stub for MIT + file LICENSE.
Simplified DESCRIPTION title and wording to avoid incoming spell-check notes in CRAN pretests.

agentr 0.2.8.1

Released: 2026-06-18

Prepared CRAN-oriented packaging infrastructure without changing package APIs.
Added a GitHub Actions R CMD check --no-manual --as-cran matrix for macOS, Windows, Ubuntu, and Ubuntu R-devel.
Updated source-build ignores so repository-only docs, examples, CI files, build artifacts, and local metadata are excluded from CRAN tarballs.
Removed a tracked .DS_Store artifact and made the function-index documentation test safe for built-package checks.
Shortened one generated Rd usage default to avoid PDF manual line-width notes.

agentr 0.2.8

Released: 2026-06-16

Added coding-assistant guidance for optional affective state inference in companion, tutoring, coaching, persona, and long-running relationship-oriented agents.
Documented local affective-state shapes such as memory/affective_state.yaml and task-local state/affective_state.yaml, including dimensions, bounds, inertia, decay, event triggers, and human-review rules.
Updated task code-construction guidance so affective updates use deterministic validation, bounded update and decay, optional LLM signal estimation, and no direct LLM overwrite of canonical affective state.
Linked affective-state inference from the full-stack task-spec wrapper while keeping it explicitly optional for most task agents.

agentr 0.2.7.13

Released: 2026-06-08

Added node_kind = "status" for workflow-visible status, mode, checkpoint, and error markers that are not executable actions or resource nodes.
Updated design review HTML so status nodes remain visible in workflow graphs with a lightweight dashed marker style.
Improved orthogonal workflow edge routing by assigning separate side ports when multiple edges touch the same side of a node.
Updated coding-assistant WorkflowSpec inference guidance to use status nodes for failure or recovery states without drawing every possible upstream failure edge.

agentr 0.2.7.12

Released: 2026-06-08

Tightened WorkflowSpec inference guidance so branch metadata is reserved for real conditional fan-out edges.
Clarified that guarded sequential steps should record guards on nodes or edge notes, not in edge.condition.
Updated workflow-only inference validation and public WorkflowSpec docs to prevent condition-only sequential edges from being rendered as branches.

agentr 0.2.7.11

Released: 2026-06-06

Reordered the design review side panel so linked knowledge, memory, and resources appear above the detail inspector.
Extended subworkflow modals with their own resource context, detail inspector, and structured feedback controls.
Scoped subworkflow node, edge, and resource clicks to the modal inspector while preserving the shared feedback JSON export.

agentr 0.2.7.10

Released: 2026-06-06

Changed design review HTML so clicking a subworkflow badge opens the child workflow in an in-page modal instead of reserving permanent main-page space for task previews.
Updated render_task_preview() to resolve task-local subworkflow_ref paths and embed child workflow specs into the standalone review bundle when available.
Clarified workflow/task-family guidance so subworkflow_ref is the preferred editable source and nested_workflow is review-bundle data.

agentr 0.2.7.9

Released: 2026-06-06

Updated design review HTML so the main workflow graph shows action nodes only, keeping knowledge, memory, file, API, schema, and other resource nodes out of the action-flow diagram.
Added a contextual "Knowledge, memory, and resource schema" panel that shows only resources linked to the selected action node through resource edges or spec references.
Restored subworkflow badges for workflow nodes that use either embedded nested workflows or subworkflow_ref links.

agentr 0.2.7.8

Released: 2026-06-06

Added workflow data/resource node metadata with node_kind values for action, knowledge, memory, file, API, schema, and generic data nodes.
Added resource-oriented workflow edge semantics for reads, writes, updates, prompt injection, schema validation, and produced artifacts.
Updated design review HTML so process-layout workflows place resource nodes in a resource lane, color them separately, label resource edges, and expose source/retrieval/persistence/spec-link metadata in the detail inspector.
Moved the standalone review renderer JavaScript and CSS into package assets under inst/review/ while preserving the public design_review_html() and export_design_review_html() R APIs.
Updated coding-assistant inference guidance so KnowledgeSpec and MemorySpec are inferred only when workflow resource nodes, references, retrieval paths, update paths, or validation dependencies make them behavior-shaping.

agentr 0.2.7.7

Released: 2026-06-06

Removed the unused first-class KnowledgeGraphSpec surface and its dedicated proposal/message lifecycle.
Reframed graph structure as a representation shape embedded in KnowledgeSpec or MemorySpec, rather than a standalone top-level spec.
Updated task-local discovery and coding-assistant guidance so projects use workflow_spec.yaml, optional memory_spec.yaml, and optional knowledge_spec.yaml; graph-shaped content now belongs under graph: inside knowledge or memory specs.
Preserved graph rendering helpers for KnowledgeSpec, MemorySpec, and plain list(nodes, edges) graph representations.

agentr 0.2.7.6

Released: 2026-06-05

Improved review HTML layout for memory, narrative-knowledge, and graph-knowledge mini-graphs.
Removed the synthetic narrative knowledge_spec hub from fallback knowledge maps so dense knowledge items no longer crowd behind one root node.
Added edge-lane fanout, larger node spacing, and relation-label backgrounds in review mini-graphs to reduce node, edge, and edge-label overlap.

agentr 0.2.7.5

Released: 2026-06-05

Reorganized package-shipped coding-assistant guides under inst/guides/ into wrapper, spec-inference, and code-construction sections.
Renamed the full project inference wrapper to full_stack_task_spec_inference.md.
Added workflow_only_task_spec_inference.md for simpler tasks that only need workflow_spec.yaml.
Split spec-specific inference guidance into spec_inference/workflow_spec.md, memory_spec.md, knowledge_spec.md, and knowledge_graph_spec.md.
Moved code construction guidance under code_construction/.

agentr 0.2.7.4

Released: 2026-06-05

Condensed the README into a concise package overview with links to subject-specific documentation.
Added docs/r_function_examples.md for R helper snippets used by humans for inspection and by coding assistants for package-conformant scaffolding.
Clarified coding-assistant-first scaffolding while preserving R functions as the standardized spec, validation, rendering, and prompt-helper surface.
Reframed subsystem/capability labels in docs and prompt contracts as optional diagnostic annotations rather than primary runtime specs.

agentr 0.2.7.3

Released: 2026-06-05

Reframed README and package metadata around specification, review, and coding-assistant scaffolding rather than a cognitive/human-interaction core.
Clarified that subsystem labels are optional diagnostic node-labeling metadata, not first-class runtime specs.
Removed the stale docs/manuscript/ asset set and docs/manuscript_assets.md.
Replaced the old conceptual-figure hub with guidance to generate figures from package-native workflow, memory-schema, schema-shape, knowledge-graph, and review-HTML renderers.

agentr 0.2.7.2

Released: 2026-06-05

Moved the workspace CLI wrapper to inst/scripts/agentr-cli.R and kept the same -h/--help parser semantics.
Added task-local preview helpers: render_task_preview() and render_task_previews().
Extended the standalone design review page to render memory-schema and knowledge graphs in addition to the workflow graph.
Preserved the package-shipped coding-assistant guides and updated downstream documentation to the new script location.

agentr 0.2.7.1

Released: 2026-06-05

Added memory-schema graph helpers: memory_schema_graph_data() and render_memory_schema_graphviz().
Added schema-shape graph helpers for workflow-node input_schema and output_schema: schema_shape_graph_data() and render_schema_shape_graphviz().
Documented memory/schema rendering in the README, MemorySpec guide, WorkflowSpec guide, and function index.
Added regression coverage for memory-schema and schema-shape DOT, DiagrammeR, and SVG rendering paths.

agentr 0.2.7

Released: 2026-06-04

Added a coding-assistant scaffolding guide that explains repository inspection, task-local YAML specs, review HTML, and Git-backed spec evolution as a complementary path to proposal-state scaffolding.
Added task-local spec helpers: task_spec_paths(), discover_task_specs(), load_task_specs(), and validate_task_specs().
Linked the coding-assistant scaffolding path from the README, documentation index, proposal lifecycle guide, and package-shipped coding-assistant guides.
Clarified that proposal objects and Git history are separate versioning mechanisms for different scaffolding contexts.
Added tests for task-local spec discovery, loading, validation, required-spec reporting, and function-index export coverage.

agentr 0.2.6.15

Released: 2026-05-31

Reorganized public documentation around a new docs/index.md landing page, YAML-first editable specs, and current review-layer behavior.
Archived completed implementation plans under docs/archive/plans/ and moved manuscript figures and tables under docs/manuscript/.
Added dedicated workflow-spec, knowledge-graph-spec, spec-format, memory-message, and knowledge-message guides.
Expanded proposal-lifecycle documentation across workflow, agent-spec, memory, narrative-knowledge, and graph-knowledge paths.
Refreshed manuscript figures and tables for the current object model, manual-LLM review loop, and corrected IAC semantics.
Added regression coverage requiring every exported package object to remain represented in the documentation function index.

agentr 0.2.6.14

Released: 2026-05-30

Fixed remaining wide review-diagram truncation by accounting for right-extending edge rails in the workflow SVG width budget.
Preserved the horizontal scroll wrapper so oversize workflow charts can expose both left and right edge routing.

agentr 0.2.6.13

Released: 2026-05-30

Fixed wide review-diagram clipping by wrapping workflow SVG output in an explicit horizontal scroll container.
Kept full chart width available inside the review panel so right-side nodes and edges remain reachable by scrolling.

agentr 0.2.6.12

Released: 2026-05-29

Added a lightweight nested-workflow badge to review-diagram nodes that contain child workflows.
Kept the badge visually minimal so nested nodes remain distinguishable without changing the graph layout.

agentr 0.2.6.11

Released: 2026-05-29

Fixed process-layout branch edge anchoring for orthogonal review diagrams.
Routed conditional branch edges from the left or right midpoint of the decision node into the top midpoint of the branch target.
Preserved dashed branch styling while restoring correct arrow direction and endpoint placement.

agentr 0.2.6.10

Released: 2026-05-29

Hardened the design-review process layout for conditional branch blocks in dense workflow diagrams.
Widened process branch lanes so sibling condition labels have more room and are less likely to overlap.
Routed branch rejoin edges on the side of their originating branch lane and pushed long feedback-loop rails farther left of branch nodes.

agentr 0.2.6.9

Released: 2026-05-29

Refined the design-review process layout so mutually exclusive branch groups render as centered decision blocks.
Placed branch alternatives horizontally around the decision node and centered common join nodes below converging branches.
Kept loop and back-edge routing separate from branch decision-block routing.

agentr 0.2.6.8

Released: 2026-05-29

Made the design-review process layout branch-aware so multiple conditional branch targets from the same source are placed into right-side branch lanes even when they later rejoin the main workflow.
Added orthogonal rejoin routing for branch-lane nodes returning to the process spine.
Added regression coverage for conditional branch placement in the process layout.

agentr 0.2.6.7

Released: 2026-05-29

Added first-class workflow edge branch metadata: condition, branch_group, and mutually_exclusive.
Preserved branch edge metadata through workflow JSON/YAML load/save and design-review payload export.
Rendered conditional branch edges visibly in design-review HTML with branch styling, condition labels, and edge-inspector fields.
Updated workflow extraction prompts and coding-assistant guidance to represent conditional routes through explicit edge fields.

agentr 0.2.6.6

Released: 2026-05-24

Added YAML save/load helpers for workflow, memory, knowledge, and knowledge-graph specs while preserving JSON and RDS compatibility.
Made task-local YAML specs the preferred editable source of truth in coding-assistant task-spec guidance.
Hardened design-review HTML against scalar-or-array knowledge_refs payloads and preserved schema-array fields such as knowledge_refs and JSON-schema required during editable spec serialization.
Added inst/guides/coding_assistant_task_code_construction.md for converting approved agentr specs into task-local executable code without expanding agentr into a runtime executor.

agentr 0.2.6.5

Released: 2026-05-22

Added inst/guides/coding_assistant_task_spec_inference.md as a coding-assistant inference contract for task codebases.
Aligned the guide with node-folder subworkflow conventions under tasks/<task_id>/nodes/<subworkflow_node_id>/.
Added guidance for task-local docs/ artifacts, knowledge/agent_paths.json workspace-path loading, side-effect-safe validation practices, and supported KnowledgeSpec item types.
Clarified that generated specs are descriptive/reviewable artifacts and should not introduce runtime behavior beyond observed task code.

agentr 0.2.6.4

Released: 2026-05-21

Added task-family helpers so one workspace can group multiple related tasks under a shared root workflow while keeping each child task reviewable through its own subworkflow reference.
Added task-family design documentation and review-page task tabs so the main browser preview can switch between child tasks instead of forcing all nested workflows into one narrow detail panel.
Improved design-review rendering so nested workflow clicks preserve the selected preview context and the right-side detail panel continues to show the clicked node.

agentr 0.2.6.3

Released: 2026-05-20

Added workflow-node subworkflow_ref, input_schema, output_schema, and nested_workflow fields for hierarchical workflow review and schema inspection.
Added a right-side node-detail panel in design-review HTML, with clickable workflow nodes/cards and local nested-workflow rendering when available.
Added constrained scaffolder actions set_node_schema and set_node_nested_workflow.
Added build_node_detail_prompt() and workspace/CLI support for node-scoped workflow revisions through apply_node_detail_message() and --node-id.
Updated workflow field docs, CLI lifecycle docs, scaffolder message schema, and tests for node-detail proposal flows.

agentr 0.2.6.2

Released: 2026-05-20

Hardened workspace CLI argument handling around explicit -- options and made initial workflow imports create pending workflow proposals instead of silently mutating approved state.
Made review export work for workflow-only proposal states when no approved AgentSpec is available.
Added design-review workflow graph layout controls for grid, layered, swimlane, and loop-aware process layouts, with curved, straight, and orthogonal edge styles.
Improved review graph rendering with wrapped SVG labels, scrollable graph panels, swimlane stacking, cycle-aware layout warnings, and process-spine rendering for loop-heavy workflows.
Relaxed scaffolder-message handling for common LLM JSON drift while still rejecting unsupported actions and preserving constrained dispatch semantics.

agentr 0.2.6.1

Released: 2026-05-20

Added generic workspace lifecycle helpers and a thin CLI wrapper for manual prompt/response scaffolding loops across workflow, agent, memory, and knowledge design.
Added workspace-scoped proposal listing, approval, rejection, review HTML export, and implementation handoff prompt helpers.
Updated design-review workflow graph rendering so long labels wrap in SVG instead of being hard-truncated.

agentr 0.2.6

Released: 2026-05-17

Added standalone, offline HTML review export with design_review_html() and export_design_review_html().
Extended design-review data support with new_design_review_spec(), workflow-only, workflow-proposal, and knowledge-only inputs.
Added design-feedback issue types, target ids, RDS persistence helpers, target-id validation warnings, non-mutating preview, and scaffolder-routed application.
Added tests covering review HTML generation, feedback save/load, feedback validation, review-data adapters, and feedback application.
Added review-layer documentation clarifying that browser output is for inspection and structured feedback, not execution.

agentr 0.2.5.6

Released: 2026-05-17

Added DesignReviewSpec as a data contract for a future JS/HTML design review layer.
Added build_design_review_data() to package workflow graphs, memory schemas, narrative knowledge, graph knowledge, proposal states, and feedback schema into one review bundle.
Added structured design-feedback helpers: design_feedback_item(), validate_design_feedback(), and parse_design_feedback_json().
Added tests for review bundle construction, proposal-state snapshots, and structured feedback validation.

agentr 0.2.5.5

Released: 2026-05-17

Added MemoryProposal and MemoryProposalState so memory schemas can move through proposal, discussion, approval, rejection, and supersession.
Added KnowledgeGraphProposal and KnowledgeGraphProposalState so graph knowledge can use the same review lifecycle as workflow and narrative knowledge.
Added memory prompt builders and constrained message handlers for proposing, revising, discussing, approving, rejecting, and human-querying memory schemas.
Added knowledge-graph prompt builders and constrained message handlers for extracting, revising, discussing, approving, rejecting, and human-querying graph knowledge.
Added tests covering lifecycle transitions, preview non-mutation, constrained JSON application, and unsafe action rejection for memory and graph knowledge loops.

agentr 0.2.5.4

Released: 2026-05-17

Promoted agentr_knowledge_graph_spec from a visualization-only projection into a first-class graph-knowledge representation.
Added graph node metadata for memory type, knowledge form, provenance, review, and scope.
Added graph edge metadata for relation type, memory type, provenance, review, and scope.
Added add_knowledge_graph_node(), add_knowledge_graph_edge(), save_knowledge_graph_spec(), and load_knowledge_graph_spec().
Extended KnowledgeSpec so it can hold narrative items, first-class graph knowledge, and future vector-reference metadata.
Clarified that knowledge_graph_from_spec() creates a projection graph from narrative knowledge items.

agentr 0.2.5.3

Released: 2026-05-17

Added first-class MemorySpec support for context, semantic, episodic, and procedural memory schemas.
Added memory-field records with persistence policies for session memory, cold-start RDS state, JSONL traces, external stores, and non-persistent fields.
Extended AgentSpec with optional memory_spec while preserving existing state_spec and state_requirements compatibility.
Added save_memory_spec(), load_memory_spec(), validate_memory_spec(), memory_types(), and memory_persistence_policies().
Added MemorySpec tests and updated the complete AgentSpec fixture to cover memory schema round trips.

agentr 0.2.5.2

Released: 2026-05-17

Tightened README wording so patch releases do not overstate the historical shift to agent-spec-first scaffolding.
Added explicit state_spec, interface_spec, and autonomy_spec examples for AgentSpec to prepare the package surface for design-review artifacts.
Added a reusable complete AgentSpec test fixture and round-trip tests covering knowledge_spec, state_spec, interface_spec, autonomy_spec, workflow knowledge references, and implementation-prompt knowledge selection.
Clarified generated knowledge-graph documentation and examples so the graph surface is framed as review and visualization support for curated KnowledgeSpec content.
Added the v0.2.6 implementation plan for the standalone JS/HTML design-review and structured-feedback layer.

agentr 0.2.5.1

Released: 2026-05-13

Added agentr_knowledge_graph_spec helpers for structuring graph-ready knowledge nodes and edges from curated KnowledgeSpec items.
Added knowledge_graph_from_spec(), knowledge_graph_data(), render_knowledge_graphviz(), and plot_knowledge_graph() for DiagrammeR/Graphviz-based knowledge visualization.
Updated the README, function index, generated manual pages, and tests to cover the new knowledge-graph surface.

agentr 0.2.5

Released: 2026-04-29

Refactored subsystem semantics to the corrected five-module schema: RWM = Reasoning & World Model, PG = Perception & Grounding, AE = Action Execution, LA = Learning & Adaptation, and IAC = Inter-Agent Communication.
Added KnowledgeSpec, KnowledgeProposal, and KnowledgeProposalState plus persistence, validation, and constrained knowledge-prompt/message helpers.
Extended AgentSpec and workflow nodes with knowledge references, autonomy metadata, ownership fields, and transitional trace requirements.
Added decision-trace and reflection-trace helpers for progressive codification of human-owned reasoning.
Added concept docs for KnowledgeSpec, cold-vs-hot runtime, and the capability-autonomy landscape.

agentr 0.2.4.3

Released: 2026-04-23

Hardened Graphviz string escaping in workflow rendering so backslashes and apostrophes no longer break render_workflow_graphviz(..., as = "svg") on article-derived workflows.
Restored correct Graphviz label line-break rendering after the escaping hardening by preserving intended \n label breaks while still escaping unsafe string content.
Added regression tests covering backslash-heavy labels, apostrophes in wrapped labels, and multiline label rendering through the SVG export path.

agentr 0.2.4.2

Released: 2026-04-20

Added article_workflow_specs_from_json() to import multi-workflow article extraction JSON into validated workflow specifications.
Refactored workflow JSON import internals so single-workflow and article-level extraction paths share stricter node and edge normalization.
Made Graphviz tooltips opt-in in render_workflow_graphviz() and plot_workflow_graph() to avoid DiagrammeR/Viz.js parse failures from long article-derived prose.
Updated README examples, function index docs, generated manual pages, and tests for article workflow import and robust DiagrammeR rendering.

agentr 0.2.4.1

Released: 2026-04-19

Switched workflow graph rendering guidance from base igraph plotting to a DiagrammeR/Graphviz-first path for clearer workflow DAG visualization.
Enhanced render_workflow_graphviz() with wrapped labels, human-gate node styling, tooltips, optional same-rank grouping, and SVG export through DiagrammeRsvg.
Kept plot_workflow_graph() as the public plotting helper while making it return a DiagrammeR graph.
Added build_article_workflow_extraction_prompt() for inferring agentr-compatible workflow specifications from article-described cases.
Updated README, function index, lifecycle docs, generated manual pages, and tests for the new visualization and article-extraction paths.

agentr 0.2.4

Released: 2026-04-06

Reorganized documentation assets by adding dedicated figure and table indexes plus a manuscript-assets overview page.
Expanded the manuscript-oriented figure set with standalone source, render, and caption artifacts for the main conceptual diagrams.
Expanded the manuscript-oriented table set with paired Markdown and LaTeX outputs for core framework, subsystem, workflow, lifecycle, and case-comparison summaries.
Moved historical release planning notes into docs/archive/plans/ so top-level documentation stays focused on current package and manuscript materials.
Updated package-level documentation links and version references to align with the expanded documentation structure.

agentr 0.2.3

Released: 2026-04-03

Added workflow_spec_from_json() so workflow-extraction JSON can be converted directly into a validated agentr_workflow_spec.
Added import_extracted_workflow() to bridge extracted JSON into the normal Scaffolder proposal and approval flow.
Added render_workflow_graphviz() for Graphviz DOT and optional DiagrammeR rendering of inferred workflows.
Added plot_workflow_graph() for improved DAG-oriented visualization using igraph.
Expanded README examples, function-index docs, generated manual pages, and tests for workflow import and rendering helpers.

agentr 0.2.2

Released: 2026-04-01

Added first-class draft agent-design proposal flow inside Scaffolder, including proposal creation, listing, discussion, and approval methods.
Added a clearer bridge from workflow proposals into agent-spec approval so a linked workflow proposal can seed and be approved alongside an agent-spec proposal.
Improved subsystem recommendation usability with explicit rationale accessors and richer prompt payloads that surface recommendation records and draft design proposals.
Added incremental workflow-node ownership editing through edit_workflow_subsystems(), making subsystem ownership changes easier than full replacement.
Expanded tests to cover the draft design workflow, incremental ownership editing, and workflow-proposal-to-agent-spec approval bridging.

agentr 0.2.1

Released: 2026-04-01

Hardened AgentSpec and SubsystemSpec validation with stronger subsystem-to-workflow consistency checks, including validation of node subsystem labels against the selected subsystem set.
Added explicit persistence helpers for the new public design objects: save_agent_spec(), load_agent_spec(), save_subsystem_spec(), and load_subsystem_spec().
Improved interactive ergonomics by adding compact print methods for subsystem configs, SubsystemSpec, AgentSpec, AgentScaffoldState, and IntelligentAgent.
Expanded test coverage for mixed config payloads, explicit design-object persistence, and validation failures around inconsistent subsystem selections.

agentr 0.2.0

Released: 2026-04-01

Shifted the package toward agent-spec-first scaffolding by adding public AgentSpec, SubsystemSpec, AgentScaffoldState, and IntelligentAgent classes.
Added public subsystem configuration classes for sparse subsystem selection: RWMConfig, PGConfig, AEConfig, IACConfig, LAConfig, CognitiveConfig, and AffectiveConfig.
Extended Scaffolder with subsystem recommendation, subsystem selection, workflow node subsystem labeling, and approved agent-spec state while preserving the existing workflow-first APIs.
Added build_agent_design_prompt() and extended implementation-prompt normalization so AgentSpec and IntelligentAgent inputs can drive implementation handoff directly.
Expanded persistence support and tests to cover sparse agent design flows alongside the existing workflow proposal lifecycle.

agentr 0.1.9

Released: 2026-03-31

Added public WorkflowProposal and WorkflowProposalState R6 classes so workflow proposal lifecycle handling is available through dedicated stateful objects.
Integrated Scaffolder with WorkflowProposalState while preserving the existing top-level proposal review methods.
Updated proposal persistence helpers to work with the new public proposal class objects.
Expanded lifecycle docs and examples to show direct use of public proposal and proposal-state classes.

agentr 0.1.8

Released: 2026-03-31

Clarified the workflow lifecycle docs so elicitation, proposal review and approval, and implementation or extraction handoff are documented as separate stages.
Promoted proposal persistence helpers into the documented package surface, including validation, save/load, and graph export support for workflow proposals.
Added a proposal lifecycle document and expanded README examples to show how proposals can be persisted and reviewed outside a live Scaffolder.
Added proposal print behavior and test coverage for exported proposal persistence helpers.

agentr 0.1.7

Released: 2026-03-31

Refactor Scaffolder internals into clearer workflow, proposal, dispatch, and prompt helper modules while preserving the current top-level UX.
Formalize workflow proposals with fixed statuses, transition rules, and a stable internal object shape.
Keep the approved workflow separate from pending proposal history so implementation handoff continues to use approved state only.
Prevent approved proposals from being silently reopened through discussion, and explicitly supersede older active proposals when a newer proposal is approved.
Add shared internal prompt-contract helpers so scaffolder, implementation, and workflow-extraction prompt builders follow the same schema discipline.
Add lifecycle-oriented tests around proposal discussion, approval, supersession, preview, and implementation handoff boundaries.
Add proposal persistence and graph helpers for internal round-trip and visualization support.

agentr 0.1.6.2

Released: 2026-03-31

Added preview_scaffolder_message() plus workflow proposal storage and approval methods so reasoning-model DAGs can be previewed, discussed, and approved before they replace the live workflow.
Added explicit proposal-management methods on Scaffolder, including proposal listing, lookup, discussion, and approval.
Extended Markdown scaffolder prompts to prefer downloadable .json file output in chatbox reasoning UIs, reducing long inline JSON copy-paste issues.
Extended parse_scaffolder_message() and apply_scaffolder_message() to accept downloaded .json file paths in addition to raw JSON strings and parsed lists.
Added build_implementation_prompt() for handing mature workflow specs to coding agents such as Codex as implementation-planning prompts.
Added build_workflow_extraction_prompt() for reverse-engineering existing ad hoc code into an agentr-compatible workflow specification.
Expanded README examples, function index entries, schema docs, tests, and generated manual pages for the new planning, extraction, preview, and review flows.

agentr 0.1.6.1

Released: 2026-03-31

Hardened apply_scaffolder_message() for real reasoning-model output by accepting direct decompose_task.args.nodes and decompose_task.args.edges payloads in addition to nested suggestions.
Added dispatch-side argument normalization so newer message payloads still work when a loaded Scaffolder$decompose_task() method only accepts the older suggestions signature.
Resolved decomposition edge references by node label as well as generated node id, which makes model-produced DAG payloads more robust in practice.
Added regression tests for direct node/edge decomposition payloads and legacy-signature dispatch compatibility.
Updated the README reasoning-loop example to show inferencer::query_openrouter(prompt_json, max_tokens = 4000) as a concrete model-call path.

agentr 0.1.6

Released: 2026-03-30

Expanded Scaffolder into a more realistic human-in-the-loop loop with persistent task evaluation artifacts, free-form discussion rounds, workflow-level review, and node-level review.
Added first-class workflow editing through node add/remove/insert operations and edge add/remove behavior instead of treating all human updates as one coarse patch.
Extended workflow schema with review-oriented fields including review_status, review_notes, review_confidence, plus richer edge metadata and stronger workflow validation.
Integrated terminal scaffolding helpers into actual scaffolder state updates so terminal prompts can feed back into discussion, rule capture, and review state.
Updated the machine-readable scaffolder bridge to expose discuss_task, review_workflow, review_node, and edit_workflow, while keeping apply_human_feedback() as a compatibility path.
Refreshed README examples, architecture notes, schema docs, tests, and generated manual pages for the new discussion-and-review model.

agentr 0.1.5

Released: 2026-03-29

Added dual scaffolder prompt formats: JSON for SDK or tool usage and Markdown for manual copy-paste into chat interfaces.
Hardened scaffolder message validation and dispatch, with richer normalized results from apply_scaffolder_message().
Added workflow graph export helpers for external DAG visualization workflows.
Added workflow specification persistence helpers for saving and loading scaffolding output independently of the full agent object.
Improved README examples and scaffolder schema documentation around the constrained LLM bridge.

agentr 0.1.4

Released: 2026-03-29

Added the initial LLM scaffolding bridge so external reasoning systems can inspect workflow state through prompts and return machine-readable actions.
Introduced prompt generation, JSON parsing, method-level validation, reference validation, and constrained action dispatch for scaffolder operations.
Formalized apply_scaffolder_message() as the translation layer from validated model output into concrete Scaffolder method calls.
Documented the machine-readable scaffolder message schema and added end-to-end examples for human-guided workflow elicitation.