# Task for Today

Read all session logs in ai/ to get up to speed, then proceed with
**Linux integration testing** against a real SDP environment with a
running p4d instance.

See session_log_2026-06-25-3.md for the full testing checklist.

## Quick Start on Linux

```bash
# Sync workspace (set up a //p4lf/dev client on the Linux machine first)
p4 sync

# Build (requires Go 1.20+; install via https://go.dev/dl/ if needed)
make build
bin/p4lf -version   # expect: p4lf 0.1.0 (CL ..., //p4lf/dev#N, ...)

# Configure
cp p4lf.cfg.example /p4/common/site/log_feeder/p4lf.cfg
vi /p4/common/site/log_feeder/p4lf.cfg   # set P4LogFile at minimum

# Run in foreground for initial testing
bin/p4lf -config /p4/common/site/log_feeder/p4lf.cfg
```

## Current Project State (as of CL 32835)

- All source code in //p4lf/dev, passing `make check` on macOS
- Binary builds: Linux amd64/arm64, macOS arm64/amd64 all build cleanly
- `install.sh` ready for production use (needs binaries in main/release stream first)
- Open job: P4LF-2 — perforce user service management (deferred, not blocking)
- **Not yet done:** Linux integration testing, README update, tailer/logger unit tests

## Key Files for Context

- ai/P4WorkflowNotes.md — P4 workflow, stream structure, how to create jobs
- session_log_2026-06-25-3.md — integration testing checklist
- session_log_2026-06-26.md — deployment/install.sh design decisions

# Version Control Interaction

Consult the file P4WorkflowNotes.md for info about version control worklfows and interactions.

# The 'ai/' folder

The 'ai/' directory under the workspace root is where this AGENTS.md file is, which is symlink'd to from the root of the workspace as copilot-instructions.md.

The ai/ folder is used to store the AGENTS.md file (updated for each AI session), AI session logs -- not part of the software itself. However, the ai/ folder contents are versioned.

For each session, write a session log that captures highlights of what was done, including prompts. Paraphrasing prompts is OK; not all prompts need to be captured, only those useful in helping understand result of the session.  Capture any important decisions that were made (and why).  The primary audience if the session logs is a future agent to continue the work, though they may also have training and audit value.
