perseus-ctx 1.0.0__tar.gz

perseus_ctx-1.0.0/CHANGELOG.md

@@ -0,0 +1,98 @@
+# Changelog
+
+All notable changes to Perseus.
+
+This project follows the alpha-then-semver convention:
+during the alpha (pre-`1.0.0`) phase, minor bumps may include breaking changes
+that are documented in the release notes.
+
+Each entry maps a release to the task IDs that shipped in it. The
+single-file `perseus.py` runtime is the only required artifact; everything
+else (installer, docs) is generated by `scripts/release.sh`.
+
+## [Unreleased]
+
+## [1.0.0] — 2026-05-20
+
+All Phase 1–22 tasks complete. Perseus v1.0.0 — the first stable release.
+
+- **task-56** — Phase 20C: added headless watch mode (`perseus watch`) — inotify/polling
+  file watcher with configurable interval, re-render on change, and debounce. Degrades
+  gracefully when watchdog is unavailable.
+- **task-57** — Phase 21A: added golden evaluation corpus under `tests/fixtures/golden/`
+  covering render, synthesis, and Pythia output shapes; deterministic comparison harness
+  in `tests/test_golden.py`.
+- **task-58** — Phase 21B: added performance budget framework (`tests/test_perf_budgets.py`)
+  with per-command cold/warm timing, advisory warnings at 2× budget, and configurable
+  thresholds. Three commands (render, graph, prefetch) emit advisory warnings in the
+  current environment — not failures.
+- **task-59** — Phase 21C: added compatibility and migration suite (`tests/test_compat_migration.py`)
+  covering checkpoint round-trip compatibility, config migration (`oracle:` → `pythia:` rename),
+  pack manifest version handling, and install/upgrade smoke paths.
+- **task-60** — Phase 22A: added `docs/index.md` (documentation hub), `docs/quickstart.md`
+  (install-to-render in 10 steps), and `docs/CONTRIBUTING.md` (contributor guide with
+  single-file constraint, directive authoring 4-touch pattern, test conventions, Agora
+  workflow). Updated README with `## Documentation` section.
+- **task-61** — Phase 22B: added `examples/` with three runnable demo workspaces:
+  `local-cli/` (render, checkpoint, recover, suggest, doctor), `assistant-profile/`
+  (context pack, hermes profile, @memory + @agora), and `container/README.md` (Docker
+  mount and auth guide). Smoke scripts verified end-to-end.
+- **task-62** — Phase 22C: v1 release candidate checklist. 493 tests passing (1 skipped
+  TCP smoke). Release artifacts built and checksums verified. README/CHANGELOG/ROADMAP
+  docs aligned. Version bumped to `1.0.0-rc.1`. Known limitations documented.
+
+## [1.0.0-rc.1] — 2026-05-20
+
+Release candidate — superseded by v1.0.0.
+
+- **task-63** — Completed the Oracle → Pythia internal rename while preserving the
+  public `perseus oracle` CLI compatibility surface. Added legacy `oracle:`
+  config warnings and one-time `oracle_log.jsonl` → `pythia_log.jsonl`
+  migration.
+- **task-49** — Phase 18B: added `tests/test_release.py` (16 tests) covering all
+  release artifact acceptance criteria — version coherence, repeatability,
+  SHA256SUMS integrity, CHANGELOG task mapping, and tarball contents.
+- **task-50** — Phase 18C: aligned scheduler behavior and docs around
+  host-neutral POSIX crontab generation, macOS launchd, Linux systemd, and
+  explicitly deferred native Windows Task Scheduler support. Added scheduler
+  smoke tests and repaired release artifact portability on macOS/BSD tar.
+- **task-51** — Phase 19A: added offline adapter conformance fixtures and a
+  parametrized harness covering generic, Hermes, Codex, Claude Code, Cursor,
+  and Rovo Dev render outputs, pack manifests, and integration docs.
+- **task-52** — Phase 19B: promoted product profiles into a documented gallery
+  with output paths, trust defaults, refresh guidance, non-interactive generation
+  tests, and hardcoded-path guards for all six supported profiles.
+- **task-53** — Phase 19C: polished the VSCode extension for release with
+  reproducible packaging docs, package scripts, LSP render/checkpoint/mutation
+  smoke tests, and static package-manifest checks.
+- **task-54** — Phase 20A: added optional bearer-token authentication for
+  `perseus serve`, a token generator, non-loopback bind safety gates, trust
+  report serve fields, and HTTP auth tests.
+- **task-55** — Phase 20B: added a single-file-runtime container image,
+  compose examples for render and authenticated serve, container trust docs,
+  and static/optional Docker smoke tests.
+- **task-56** — Phase 20C: added `perseus watch`, a dependency-free polling
+  loop for refreshing single source files or context-pack render targets, with
+  deterministic debounce tests and clean shutdown behavior.
+
+## [0.9.0] — 2026-05-19
+
+### Trust, privacy, and local policy (Phase 17)
+
+- **task-45** — Permission profiles (`strict` / `balanced` / `power-user`); `perseus trust` and `--json`; `serve.bind` promoted to config; version bump to 0.9.0.
+- **task-46** — Secrets redaction (`DEFAULT_REDACTION_RULES`, `redact_text()`) at render/synthesize/serve trust boundaries; source files never mutated; counts-only report.
+- **task-47** — Audit log (`audit_event()` JSONL with rotation); emitters at 5 trust boundaries; `perseus trust audit [--tail N] [--json]`; default `perseus trust` shows audit posture; secret values never persisted.
+
+### Distribution (Phase 18)
+
+- **task-48** — Installer bootstrap (`scripts/install.sh` + `INSTALL.md`); preserves the single-file runtime; verifies Python 3.10+ and `pyyaml`; idempotent upgrade and clean uninstall.
+- **task-49** — Release artifacts and versioning: `VERSION` file as source of truth, `scripts/release.sh` produces a deterministic tarball + zip + SHA256SUMS, this changelog, and version-coherence checks (perseus.py / VERSION / CHANGELOG).
+
+### Verification
+
+- Tests: 393 passing, 0 skipped.
+- Single-file runtime: `perseus.py` (`pyyaml` only).
+
+## [0.8.x and earlier]
+
+Pre-Phase 17 history is tracked in `tasks/` (closed task files) and `HANDOFF.md`.

perseus_ctx-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Connally
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

perseus_ctx-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include VERSION
+include CHANGELOG.md