Skip to content

Repository files navigation

AUDAPACK

AUDAPACK Logo

High-velocity Windows project packaging, audit cockpit & browser automation bridge

Release Python 3.10+ Windows Pytest Widget Golden Vintage

EnglishРусский


2026-08-30_025740


⚡ Highlights

  • 📦 Clean Project Packaging: Timestamped, CRC-verified .zip creation with .part staging, exclude filtering, and optional metadata manifests.
  • 🎛️ 24-Slot Priority Cockpit: Structured grid across four canonical groups (MAIN0, MAIN1, SIDE0, SIDE1) with 6 slots each.
  • ⏱️ Real-Time Freshness Tracking: Color-coded audit temperature indicators (HOT, WARM, COOL, COLD, STALE) showing exact elapsed time.
  • 📋 1-Click Audit Handoff: Copies canonical __00_AUDIT_ALL_3.md instantly, tracks hash state, and switches between ✓ AUDIT and AUDIT.
  • 🌐 Browser Auto3 Automation: Bundled Tampermonkey userscript (AUDAPACK_WIDGET.user.js) automating 3-wave audits in ChatGPT with strict runId boundary isolation.
  • 🔌 Loopback Bridge Daemon: High-throughput HTTP server on 127.0.0.1:17843 (API v3/v2) with token authorization, INAUDIT capture REST API, and atomic wave aggregation.
  • 🪟 Windows Integration: Explorer right-click context menu integration ("Упаковать через AUDAPACK") and silent VBScript background launchers.
  • 🎨 Golden Vintage Aesthetic: Authentic Windows 95 Dark Golden theme with 2px raised/sunken bevels and zero antialiasing for maximum readability.
  • 📥 Durable INAUDIT Inbox: Filesystem-backed capture store for ChatGPT responses, blocks, or clipboard text; deterministic project classification, verified hardlink/copy assignment to audit/N.md, and archive/restore/delete lifecycle.
  • 🧠 Dedicated Chromium Worker: Launches a Chromium-family browser (Chrome, Edge, Vivaldi, Opera, Brave) in an isolated profile with all throttling disabled; the top-level-only Widget guard rejects embedded ChatGPT sentinel frames.

🧭 Cockpit Grid Layout

The 24-slot interface organizes projects into a dense, high-contrast operational grid:

Column Header Description Interaction
0 ✓ ⊘ Enable / Visual Dimming Checkboxes Toggle packing inclusion or visual dimming
1 SLOT Priority Slot Number (#1#6) Drag handle and priority position
2 Project & Path Name, Git Dirty badge, SAIPEN status, Source Path Right-click name to clear copied state
3 WAVE Audit Wave Progress (✓ 3/3, 2/3, 1/3, 0/3) Visual status of current audit stage
4 FRESHNESS Temperature Marker (● 14m, ● 3h, ● 8h, ) Color-coded age of latest audit
5 AUDIT Copy Audit Handoff Button Copies __00_AUDIT_ALL_3.md to clipboard
6 PACK Single-Project Pack Button Creates immediate timestamped .zip archive
7 ARCHIVE Copy Archive File Button (ARCHIVE (14m)) Copies .zip file directly to clipboard
8 ··· Project Context Menu Move, Edit, Mute, Open Folder, Delete

🚀 Quick Start

1. Launch GUI

Double-click AUDAPACK.vbs (silent background start, no black console window) or run:

pythonw AUDAPACK.pyw

2. Silent All-Project Packaging

Double-click PACK_ALL_SILENT.vbs or run:

pythonw AUDAPACK.pyw --silent

3. Explorer Context Menu

Install the context menu from Settings inside the GUI, or via command line:

python AUDAPACK.pyw --install-context-menu

Right-click any folder or file in Windows Explorer and select Упаковать через AUDAPACK.

4. Install Browser Widget

Open Tampermonkey in your browser and install resources/AUDAPACK_WIDGET.user.js. When opening ChatGPT, the AUDAPACK toolbar will attach to the prompt input.

5. Launch a Dedicated Chromium Audit Worker

Use Settings → Components → Launch AUDAPACK Chromium. AUDAPACK picks an installed Chromium-family browser (Google Chrome, Cent, Edge, Vivaldi, or Opera before Brave), launches it with an isolated profile under %LOCALAPPDATA%\AUDAPACK\browser_worker, and disables Chromium's background timer, occlusion, and renderer throttling. Install Tampermonkey and the widget once inside that dedicated profile. The worker keeps running minimized, covered by other apps, or with the displays off; Windows sleep still suspends every process.

Only a clean root ChatGPT tab in a Chromium-family browser can claim a new audit — existing conversations, drafts, attachments, in-flight generation, and non-root URLs fail closed, and embedded ChatGPT sentinel frames are rejected outright.

6. INAUDIT Capture Workflow

On a stable ChatGPT answer, press IA beside the response or a code block. A verified Bridge write shows IA ✓; if the Bridge is unavailable, the bounded IndexedDB spool shows IA QUEUED and retries the same capture identity later. In AUDAPACK, open INAUDIT → Inbox to inspect provenance and classification evidence, choose a registered project, then use Assign, Assign + GG, or Assign + CC. The toolbar's IA+ action captures the current Windows clipboard through the same durable store. Assignment rescans the project's audit directory, writes max(N) + 1 without overwriting, verifies the body hash, and only then offers the canonical GG/CC command.


🌡️ Freshness & Temperature Matrix

Audit temperature is dynamically computed from metadata timestamps (GENERATED_AT / DATE_TIME) in the audit files:

Marker Temperature Age Threshold Color / Visual Tone
HOT 04 hours Coral Red (#D49090 on #451B1B)
WARM >424 hours Golden Amber (#D4B875 on #3E3014)
COOL >13 days Steel Blue (#8BB4D4 on #182E40)
❄️ COLD >37 days Slate Ice (#A0A8B0 on #20242B)
STALE >7 days Muted Dark (#7D7565 on #221E18)
NONE No audit found Muted Dash (#6E674E)

💻 CLI Reference

usage: AUDAPACK.pyw [-h] [--pack PATH] [--pack-project ID] [--silent]
                    [--install-context-menu] [--remove-context-menu]
                    [--status] [--bridge]

options:
  -h, --help              Show this help message and exit
  --pack PATH             Pack specified directory or file into archive
  --pack-project ID       Pack project by ID from registry
  --silent                Pack all enabled projects silently without UI
  --install-context-menu  Install Windows Explorer context menu entry
  --remove-context-menu   Remove Windows Explorer context menu entry
  --status                Print registry and audit freshness status to stdout
  --bridge                Run AUDAPACK bridge server in foreground

📁 Repository Structure

_AUDAPACK/
├── audapack/               # Core Python application package
│   ├── bridge/             # Local HTTP daemon (API v2) & wave storage
│   ├── components/         # Scheduled tasks, autostart & migration
│   ├── services/           # Framework-neutral application services
│   ├── ui/                 # Tkinter Golden Default desktop UI
│   ├── ui_qt/              # PySide6 Qt desktop implementation
│   ├── config.py           # Configuration & JSON serializer
│   ├── packing.py          # Atomic ZIP packager with .part staging
│   └── projects.py         # 24-slot registry & priority groups
├── docs/                   # Documentation & developer wiki
│   └── wiki/               # 5-part comprehensive documentation
├── resources/              # Brand assets, icons & Tampermonkey widget
│   ├── AUDAPACK_WIDGET.user.js # Browser automation userscript
│   ├── app_icon.ico        # Multi-size Windows application icon
│   ├── app_icon.png        # Golden Vintage application icon
│   └── screenshot.png      # High-resolution cockpit screenshot
├── scripts/                # Benchmarking & performance tools
├── tests/                  # Pytest & Node widget test suites
│   ├── services/           # Neutral service unit tests
│   ├── ui/                 # Model & UI component tests
│   └── widget/             # 152 Node.js browser widget unit tests across 23 suites
├── AUDAPACK.pyw            # Main GUI entry point
├── AUDAPACK.vbs            # Silent GUI launcher
├── PACK_ALL_SILENT.vbs     # Silent batch pack launcher
├── CHANGELOG.md            # Monotonic release changelog
├── README.md               # English documentation
├── README.ru.md            # Russian documentation
└── VERSION                 # Canonical semver release version

📚 Documentation Wiki

Detailed guides are available in docs/wiki/:


🔒 Invariants & Safety

  • Atomic Staging: Archives are written to .part temporary files first, validated with zipfile.testzip(), and only then committed to destination.
  • Fail-Closed Security: The HTTP bridge strictly binds to loopback (127.0.0.1), requires a 256-bit authentication token stored outside project source in %LOCALAPPDATA%, and enforces request size boundaries.
  • Strict RunId Isolation: Audit handoffs enforce run-boundary separation to prevent cross-run wave badge bleed.
  • Zero Heavy Frameworks: Core functionality runs on Python standard library without cloud dependencies or telemetry.

2026-08-30_025746 2026-08-30_025749 2026-08-30_025756

AUDAPACK — Built for speed, clarity, and reliability.

About

AUDAPACK

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages