Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 17 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,23 @@ contract corrections before stable `v1.0.0`.

## [Unreleased]

No user-visible changes yet.
### Changed

- Replace the capture/displays PowerShell process with a bundled command-scoped
native C++ executable. Retain the capture protocol, desktop admission, before/after
environment checks, independent PNG validation and transactional archive publication.
Input execution continues to use Windows PowerShell 5.1.
- Build the native helper with MinGW-w64 or CMake/Visual Studio; installed packages
include the executable and JSON library license and need no compiler.
- Add a controlled-window CLI benchmark with alternating baseline/candidate runs
and independent pixel verification.

- Make the cu automation skill explicitly prefer Pi codemode for observation and
optional image delivery in one call, including reuse of action checkpoint images.
- Document collection-only delivery, batched action-file writing, background-task
handling, and recovery when image delivery fails after a completed command.
- Correct the skill's checkpoint key list and explain why move-then-click plans
discard the second coordinate action.

## [1.0.0-preview.1] - 2026-08-14

Expand Down
6 changes: 5 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,9 @@ Required tooling:
- Node.js 22.19.0 or newer
- Windows PowerShell 5.1
- npm as supplied with the selected Node.js installation
- A matching Windows C++ compiler: MinGW-w64 GCC, or CMake with Visual Studio C++
build tools. `CU_CXX` may select an explicit MinGW compiler for source builds.
Installed packages contain the compiled helper and require no compiler.

Set up a checkout:

Expand Down Expand Up @@ -55,7 +58,8 @@ new parallel implementations.
## Testing

The repository test aggregator is an active Windows integration suite, not a
side-effect-free metadata check. It loads PowerShell helper paths and must run only in a
side-effect-free metadata check. It executes the native capture helper and PowerShell
input/reference helpers and must run only in a
suitable Windows test environment:

```powershell
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,8 +64,8 @@ Keep observation authority, input delivery, and application outcomes separate.
- **Transactional capture archive**: validated PNG/sidecar bundles, create-once
publication, rollback-before/forward-after recovery, quotas, history, and explicit
cleanup.
- **Command-scoped Windows helpers**: stock Windows PowerShell 5.1 helpers exist only
for the command that needs desktop topology, observation, or input.
- **Command-scoped Windows helpers**: a bundled native EXE handles desktop topology
and capture; Windows PowerShell 5.1 handles input. Each helper exits with its command.
- **Stable machine output**: versioned JSON receipts, sanitized error envelopes, and
fixed exit-code meanings for shell automation.

Expand All @@ -75,7 +75,7 @@ Keep observation authority, input delivery, and application outcomes separate.

- Windows with an interactive default desktop
- Node.js `22.19.0` or newer
- Windows PowerShell 5.1
- Windows PowerShell 5.1 for input execution (capture/displays run directly as native code)
- Permission to observe and control the selected desktop content

Locked, secure, unavailable, or elevation-bypass desktops fail closed. `cu` does not
Expand Down
11 changes: 11 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,17 @@ for exact schemas, state transitions, and design decisions.
- [Transactional Observation Archive and Effect Recovery](specification/v1/decisions/005-transactional-observation-archive.md)
- [Witness-Validated Control-Record Replacement](specification/v1/decisions/006-witness-validated-control-record-replacement.md)

## Research and Product Analysis

These documents record dated findings and proposals, not normative contracts.

- [Efficiency and Pi Image Delivery](research/efficiency-and-pi-image-delivery.md)
- [Observe Latency Hill Climb](research/observe-latency-hillclimb.md)
- [PowerShell 7 and DLL Observe Experiments](research/observe-powershell7-and-dll.md)
- [Observe without PowerShell: Startup Comparison](research/observe-without-powershell.md)
- [Native Capture Helper: Implementation and Measurements](research/observe-native-helper.md)
- [Product Boundaries: agent-desktop and Codex](research/product-boundaries-agent-desktop-codex.md)

## Project Operations

- [Contributing](../CONTRIBUTING.md)
Expand Down
4 changes: 3 additions & 1 deletion docs/releasing.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ node dist/src/cli.js help --json

Before making automated tests a required hosted check, add or identify a dedicated
CI-safe test command whose environment and effects are explicit. The current `npm test`
is an active Windows integration suite that loads PowerShell helper paths; it is not a
is an active Windows integration suite that executes native and PowerShell helpers; it is not a
side-effect-free metadata preflight and may require an interactive desktop. Run it on an
authorized Windows integration host, not blindly on a generic hosted runner.

Expand Down Expand Up @@ -147,6 +147,8 @@ unscoped package name `cu` is already owned by another project. Before npm publi
`dist/helper/`, `README.md`, `LICENSE`, and required package metadata.
- [ ] Exclude tests, source TypeScript, local reviews, fixtures, `.cu/`, and `NUL`.
- [ ] Remove `private: true` only in the reviewed npm-publishing change.
- [ ] Build the native capture executable for each advertised architecture using a
matching MinGW-w64 or Visual Studio C++ toolchain; include its JSON library license.
- [ ] Run `npm pack --dry-run --json` and inspect every proposed path.
- [ ] Run `npm pack --json --pack-destination <temporary-directory>` to create the exact
candidate `.tgz` outside the checkout, then inspect its file list and SHA-256.
Expand Down
Loading
Loading