Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 3, 2026

The AGENTS.md documentation was outdated (v1.0) and missing coverage of major v1.1.0 features including DSL v2, dynamics simulations, uncertainty quantification, temporal networks, and null models.

Changes

New Feature Documentation

  • DSL v2 modern builder API (Q, UQ, L, C, N, P) with 9 examples covering queries, uncertainty, layer algebra, grouping, comparison, and pattern matching
  • Dynamics simulations: SIS, SIR, SEIR, RandomWalk, and custom process definitions (4 examples)
  • Uncertainty quantification: StatSeries, resampling strategies, context managers (4 examples)
  • Temporal networks: time-stamped edges, snapshots, sliding windows, temporal queries (5 examples)
  • Null models: configuration model, statistical testing integration (2 examples)

Organization Improvements

  • 28-section table of contents with anchor links
  • API-specific patterns section (multi_layer_network API, DSL architecture, error handling)
  • 10 common pitfalls with solutions (NetworkX limitations, builder chaining, uncertainty scope, temporal attributes, etc.)
  • Security guidelines, testing strategy, performance considerations, contributing guidelines

Updated Content

  • Version bumped to 1.1.0
  • File structure updated to reflect current repository layout (dynamics/, uncertainty/, temporal_utils.py, nullmodels/)
  • Additional features list expanded (dynamics, uncertainty, temporal, null models)

DSL v2 Example:

from py3plex.dsl import Q, L, UQ

# Query with uncertainty quantification and layer grouping
result = (
    Q.nodes()
     .from_layers(L["social"] + L["work"])
     .where(degree__gt=3)
     .uq(method="perturbation", n_samples=100, ci=0.95)
     .per_layer()
        .compute("betweenness_centrality")
        .top_k(20, "betweenness_centrality__mean")
     .end_grouping()
     .coverage(mode="at_least", k=2)
     .execute(network)
)

All code examples validated against current API.

Statistics: +1,200 lines (78% increase), 10 new sections, 25+ examples

Original prompt

This section details on the original issue you should resolve

<issue_title>agents</issue_title>
<issue_description>update agents.md

current state of repo

make sure clear structure</issue_description>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI and others added 2 commits January 3, 2026 11:09
- Updated version from 1.0 to 1.1.0
- Added comprehensive DSL v2 documentation with Q/UQ builder API
- Added Dynamics simulations section (SIS, SIR, SEIR, custom processes)
- Added Uncertainty quantification section (StatSeries, bootstrap, null models)
- Added Temporal networks section (time-stamped edges, snapshots, windows)
- Added Null models section
- Added comprehensive API-specific patterns section
- Added common pitfalls and solutions (10 detailed examples)
- Added security guidelines
- Added testing strategy and performance considerations
- Reorganized with clear table of contents (28 sections)
- Updated file structure to reflect current repository state
- Improved organization and clarity throughout

Co-authored-by: SkBlaz <[email protected]>
D is imported from py3plex.dynamics, not py3plex.dsl

Co-authored-by: SkBlaz <[email protected]>
Copilot AI changed the title [WIP] Update agents.md for clearer structure Update AGENTS.md to reflect py3plex v1.1.0 feature set and repository state Jan 3, 2026
Copilot AI requested a review from SkBlaz January 3, 2026 11:14
@SkBlaz SkBlaz marked this pull request as ready for review January 3, 2026 17:18
@SkBlaz SkBlaz merged commit 10e05a6 into master Jan 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

agents

2 participants