Skip to content

Reset implementation for v4 architecture - #398

Merged
DefinetlyNotAI merged 317 commits into
mainfrom
v4
Sep 26, 2026
Merged

DefinetlyNotAI merged 317 commits into
mainfrom
v4

Conversation

@DefinetlyNotAI

Copy link
Copy Markdown
Owner

Pull Request Template

Prerequisites

  • I have searched for duplicate or closed issues.
  • I have read the contributing guidelines.
  • I have followed the instructions in the wiki about contributions.
  • I have updated the documentation accordingly.
  • I have tested my code with the --dev flag, if required. (Not applicable: v4 has no --dev flag.)

PR Type

  • Bug fix
  • Deprecation Change
  • New feature
  • Refactoring
  • Documentation update
  • ⚠️ Breaking change ⚠️

Description

Merge Logicytics v4.0.0 into main. This release replaces the legacy script-based workflow with a typed pipeline for collector validation and planning, isolated collection, registered artifacts, run manifests, and verified packages. It adds profiles, capability and authorization controls, opt-in plugins, USB workflows, and a new CLI and documentation set.

The configuration, output layout, and extension contracts have changed. The migration guide documents supported legacy inputs and aliases; legacy MOD support has been removed.

Motivation and Context

The legacy shared-script workflow lacked a consistent boundary for validation, authorization, failure isolation, and evidence tracking. V4 establishes those contracts so collection results are easier to inspect and failures remain visible without invalidating independent collectors.

Credit

No additional contributors to credit for this release merge. Existing attribution is retained in .github/CREDITS.md.

Issues Fixed

N/A

…pty (currently working on v4); updated security for supported versions
Signed-off-by: DefinetlyNotAI <Shahm_Najeeb@outlook.com>
Retire script-sidecar discovery, execution, packaging, and compatibility paths. Document the plugin-only extension contract, command flags, and error remediation.

Signed-off-by: DefinetlyNotAI <Shahm_Najeeb@outlook.com>
Move contract and platform boundaries into the engine module package.

Keep compatibility aliases for established collector imports while documenting canonical locations.

Signed-off-by: DefinetlyNotAI <Shahm_Najeeb@outlook.com>
@DefinetlyNotAI DefinetlyNotAI self-assigned this Sep 25, 2026
@DefinetlyNotAI DefinetlyNotAI added the type/Documentation Improvements or additions to commentations label Sep 25, 2026
@DefinetlyNotAI DefinetlyNotAI added request/Important New feature or request, top priority, for next update type/Dependencies Pull requests that update a dependency file type/Code Related to the Code part type/System Related to System Code for Logicytics type/Development Related to Development issues labels Sep 25, 2026
@coderabbitai

coderabbitai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

Important

Review skipped

Too many files!

This PR contains 221 files, which is 121 over the limit of 100.

To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Advanced

Run ID: e1e74910-d781-41d2-90ca-08ce43d59d86

📥 Commits

Reviewing files that changed from the base of the PR and between e671ac3 and 51b06ed.

⛔ Files ignored due to path filters (3)
  • CODE/SysInternal_Suite/SysInternal_Suite.zip is excluded by !**/*.zip
  • tests/golden/connection_graph.dot is excluded by !**/*.dot
  • tests/golden/running_processes.csv is excluded by !**/*.csv
📒 Files selected for processing (221)
  • .bandit
  • .github/CODEOWNERS
  • .github/CREDITS.md
  • .github/DCO.md
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • .github/PULL_REQUEST_TEMPLATE.md
  • .github/dependabot.yml
  • .github/script/validate-commit-msg.sh
  • .github/workflows/greetings.yml
  • .github/workflows/publish-wiki.yml
  • .gitignore
  • .mailmap
  • .pre-commit-config.yaml
  • CODE/Logicytics.py
  • CODE/_debug.py
  • CODE/_dev.py
  • CODE/bluetooth_details.py
  • CODE/bluetooth_logger.py
  • CODE/browser_miner.ps1
  • CODE/cmd_commands.py
  • CODE/config.ini
  • CODE/dir_list.py
  • CODE/dump_memory.py
  • CODE/encrypted_drive_audit.py
  • CODE/event_log.py
  • CODE/log_miner.py
  • CODE/logicytics/Checks.py
  • CODE/logicytics/Config.py
  • CODE/logicytics/Execute.py
  • CODE/logicytics/FileManagement.py
  • CODE/logicytics/Flag.py
  • CODE/logicytics/Get.py
  • CODE/logicytics/Logger.py
  • CODE/logicytics/__init__.py
  • CODE/media_backup.py
  • CODE/netadapter.ps1
  • CODE/network_psutil.py
  • CODE/packet_sniffer.py
  • CODE/property_scraper.ps1
  • CODE/registry.py
  • CODE/sensitive_data_miner.py
  • CODE/ssh_miner.py
  • CODE/sys_internal.py
  • CODE/tasklist.py
  • CODE/tree.ps1
  • CODE/usb_history.py
  • CODE/vulnscan.py
  • CODE/vulnscan/Model_SenseMacro.4n1.pth
  • CODE/wifi_stealer.py
  • CODE/window_feature_miner.ps1
  • CODE/wmic.py
  • CONTRIBUTING.md
  • MODS/_MOD_SKELETON.py
  • PLANS.md
  • README.md
  • SECURITY.md
  • core/bluetooth/bluetooth_addresses.py
  • core/bluetooth/bluetooth_history.py
  • core/bluetooth/paired_devices.py
  • core/browser/browser_data_backup.py
  • core/diagnostics/sysinternals_report.py
  • core/encryption/bitlocker_status.py
  • core/encryption/bitlocker_volumes.py
  • core/event_log/application_events.py
  • core/event_log/security_events.py
  • core/event_log/system_events.py
  • core/filesystem/sensitive_file_inventory.py
  • core/filesystem/startup_folder_entries.py
  • core/filesystem/system_drive_listing.py
  • core/filesystem/system_drive_tree.py
  • core/hardware/battery_status.py
  • core/hardware/display_adapters.py
  • core/hardware/windows_features.py
  • core/integration/legacy_code_outputs.py
  • core/media/media_backup.py
  • core/memory/memory_snapshot.py
  • core/network/active_connections.py
  • core/network/adapter_statistics.py
  • core/network/arp_cache.py
  • core/network/bandwidth_sample.py
  • core/network/connection_processes.py
  • core/network/dns_cache.py
  • core/network/firewall_profiles.py
  • core/network/network_adapters.py
  • core/network/network_identity.py
  • core/network/network_interfaces.py
  • core/network/routing_table.py
  • core/packet/connection_graph.py
  • core/packet/packet_capture.py
  • core/process/detailed_processes.py
  • core/process/memory_map.py
  • core/process/process_memory.py
  • core/process/running_processes.py
  • core/registry/hklm_backup.py
  • core/registry/installed_applications.py
  • core/registry/startup_applications.py
  • core/ssh/ssh_backup.py
  • core/storage/logical_drives.py
  • core/storage/mounted_volumes.py
  • core/storage/physical_disks.py
  • core/storage/volume_details.py
  • core/system/bios_info.py
  • core/system/computer_system.py
  • core/system/defender_status.py
  • core/system/environment_posture.py
  • core/system/group_policy.py
  • core/system/installed_drivers.py
  • core/system/installed_updates.py
  • core/system/local_accounts.py
  • core/system/operating_system.py
  • core/system/scheduled_tasks.py
  • core/system/session_snapshot.py
  • core/system/system_details.py
  • core/system/system_diagnostics.py
  • core/system/system_info.py
  • core/system/windows_services.py
  • core/system/windows_system_data_backup.py
  • core/system/wmic_inventory.py
  • core/usb/usb_storage_inventory.py
  • core/wireless/wifi_interfaces.py
  • core/wireless/wifi_profile_keys.py
  • core/wireless/wifi_profiles.py
  • docs/ARCHITECTURE.md
  • docs/COMMANDS.md
  • docs/CONFIGURATION.md
  • docs/CONTRACTS.md
  • docs/CORE_COLLECTORS.md
  • docs/DEVELOPMENT.md
  • docs/ENGINE.md
  • docs/ERRORS.md
  • docs/EVIDENCE_REVIEW.md
  • docs/FLOW_MATRIX.md
  • docs/FORMATS.md
  • docs/GETTING_STARTED.md
  • docs/INSTALLATION.md
  • docs/MIGRATION.md
  • docs/OPERATIONS.md
  • docs/OUTPUTS.md
  • docs/PLUGINS.md
  • docs/PLUGIN_AUTHORING.md
  • docs/README.md
  • docs/SAFETY.md
  • docs/TROUBLESHOOTING.md
  • docs/VERIFICATION.md
  • logicytics.yaml
  • logicytics/.gitkeep
  • logicytics/__init__.py
  • logicytics/__main__.py
  • logicytics/cli/__init__.py
  • logicytics/cli/__main__.py
  • logicytics/cli/commands.py
  • logicytics/cli/installer.py
  • logicytics/cli/tests.py
  • logicytics/global/__init__.py
  • logicytics/global/ctypes_collector.py
  • logicytics/module/__init__.py
  • logicytics/module/api.py
  • logicytics/module/artifacts.py
  • logicytics/module/command_runner.py
  • logicytics/module/configuration.py
  • logicytics/module/contracts.py
  • logicytics/module/discovery.py
  • logicytics/module/environment.py
  • logicytics/module/errors.py
  • logicytics/module/interaction.py
  • logicytics/module/logging.py
  • logicytics/module/maintenance.py
  • logicytics/module/manifest.py
  • logicytics/module/modes.py
  • logicytics/module/output_contracts.py
  • logicytics/module/output_layout.py
  • logicytics/module/packaging.py
  • logicytics/module/planner.py
  • logicytics/module/platform_adapters.py
  • logicytics/module/presentation.py
  • logicytics/module/redaction.py
  • logicytics/module/runtime.py
  • logicytics/module/sysinternals.py
  • logicytics/module/terminal.py
  • logicytics/module/usb.py
  • logicytics/module/validation_worker.py
  • logicytics/module/virtual_environment.py
  • plugins/.gitkeep
  • pyproject.toml
  • requirements.txt
  • tests/__init__.py
  • tests/fixtures/__init__.py
  • tests/fixtures/collectors.py
  • tests/fixtures/file_listing.py
  • tests/golden/bios_info.html
  • tests/golden/manifest.json
  • tests/golden/system_details.txt
  • tests/test_artifact_writer.py
  • tests/test_cli.py
  • tests/test_collector_cancellation.py
  • tests/test_configuration.py
  • tests/test_configuration_documentation.py
  • tests/test_contracts.py
  • tests/test_deep_collector_resilience.py
  • tests/test_flow_matrix.py
  • tests/test_golden_outputs.py
  • tests/test_interaction.py
  • tests/test_legacy_code_outputs_collector.py
  • tests/test_logging.py
  • tests/test_maintenance.py
  • tests/test_packaging.py
  • tests/test_planning.py
  • tests/test_platform_adapters.py
  • tests/test_preflight.py
  • tests/test_public_api.py
  • tests/test_running_processes_collector.py
  • tests/test_runtime.py
  • tests/test_scheduler.py
  • tests/test_shipped_collectors.py
  • tests/test_terminal.py
  • tests/test_test_runner_cli.py
  • tests/test_usb.py
  • tests/test_windows_features_collector.py
  • tests/test_windows_integration.py
  • tests/test_wmic_inventory_collector.py
  • tests/test_worker_security.py

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@pull-request-size pull-request-size Bot added the size/XXL Super Huge size pr label Sep 25, 2026
@qltysh

qltysh Bot commented Sep 25, 2026 •

Copy link
Copy Markdown
Contributor

❌ 1 blocking issue (100 total)

Tool Category Rule Count
zizmor Vulnerability credential persistence through GitHub Actions artifacts 1 ❌
qlty Duplication Found 18 lines of similar code in 10 locations (mass = 96) 42
qlty Structure Function with many returns (count = 6): collect 25
qlty Structure Function with high complexity (count = 69): collect 12
radarlint-python Lint Refactor this function to reduce its Cognitive Complexity from 68 to the 15 allowed. 12
qlty Structure Complex binary expression 3
qlty Structure High total complexity (count = 74) 2
qlty Structure Deeply nested control flow (level = 5) 2
radarlint-python Lint Define a constant instead of duplicating this literal "cancelled during browser data backup" 4 times. 1

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 5dcc48cd10

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread logicytics/module/platform_adapters.py Outdated
Comment thread tests/test_terminal.py Outdated
Comment thread logicytics/module/sysinternals.py Outdated
Comment thread core/system/bios_info.py
Comment thread tests/test_deep_collector_resilience.py
@DefinetlyNotAI
DefinetlyNotAI merged commit 790e9b0 into main Sep 26, 2026
8 of 9 checks passed
@DefinetlyNotAI DefinetlyNotAI changed the title chore: reset implementation for v4 architecture Reset implementation for v4 architecture Sep 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

request/Important New feature or request, top priority, for next update size/XXL Super Huge size pr type/Code Related to the Code part type/Dependencies Pull requests that update a dependency file type/Development Related to Development issues type/Documentation Improvements or additions to commentations type/System Related to System Code for Logicytics

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants