Files
git.stella-ops.org/src/TaskRunner/StellaOps.TaskRunner/AGENTS.md
StellaOps Bot 17d45a6d30
Some checks failed
Airgap Sealed CI Smoke / sealed-smoke (push) Has been cancelled
Docs CI / lint-and-preview (push) Has been cancelled
Export Center CI / export-ci (push) Has been cancelled
feat: Implement Filesystem and MongoDB provenance writers for PackRun execution context
- Added `FilesystemPackRunProvenanceWriter` to write provenance manifests to the filesystem.
- Introduced `MongoPackRunArtifactReader` to read artifacts from MongoDB.
- Created `MongoPackRunProvenanceWriter` to store provenance manifests in MongoDB.
- Developed unit tests for filesystem and MongoDB provenance writers.
- Established `ITimelineEventStore` and `ITimelineIngestionService` interfaces for timeline event handling.
- Implemented `TimelineIngestionService` to validate and persist timeline events with hashing.
- Created PostgreSQL schema and migration scripts for timeline indexing.
- Added dependency injection support for timeline indexer services.
- Developed tests for timeline ingestion and schema validation.
2025-11-30 15:38:14 +02:00

2.1 KiB
Raw Blame History

Task Runner Service — Agent Charter

Mission

Execute Task Packs safely and deterministically. Provide remote pack execution, approvals, logging, artifact capture, and policy gates in support of Epic12, honoring the imposed rule to propagate similar work where needed.

Responsibilities

  • Validate Task Packs, enforce RBAC/approvals, orchestrate steps, manage artifacts/logs, stream status.
  • Integrate with Orchestrator, Authority, Policy Engine, Export Center, Notifications, and CLI.
  • Guarantee reproducible runs, provenance manifests, and secure handling of secrets and networks.

Module Layout

  • StellaOps.TaskRunner.Core/ — execution engine, step DSL, policy gates.
  • StellaOps.TaskRunner.Infrastructure/ — storage adapters, artifact handling, external clients.
  • StellaOps.TaskRunner.WebService/ — run management APIs and simulation endpoints.
  • StellaOps.TaskRunner.Worker/ — background executors, approvals, and telemetry loops.
  • StellaOps.TaskRunner.Tests/ — unit tests for core/infrastructure code paths.
  • StellaOps.TaskRunner.sln — module solution.

Required Reading

  • docs/modules/platform/architecture.md
  • docs/modules/platform/architecture-overview.md
  • docs/modules/taskrunner/architecture.md
  • docs/product-advisories/29-Nov-2025 - Task Pack Orchestration and Automation.md
  • docs/task-packs/spec.md, docs/task-packs/authoring-guide.md, docs/task-packs/runbook.md

Working Agreement

    1. Update task status to DOING/DONE in both correspoding sprint file /docs/implplan/SPRINT_*.md and the local TASKS.md when you start or finish work.
    1. Review this charter and the Required Reading documents before coding; confirm prerequisites are met.
    1. Keep changes deterministic (stable ordering, timestamps, hashes) and align with offline/air-gap expectations; enforce plan-hash binding for every run.
    1. Coordinate doc updates, tests, and cross-guild communication whenever contracts or workflows change; sync sprint Decisions/Risks when advisory-driven changes land.
    1. Revert to TODO if you pause the task without shipping changes; leave notes in commit/PR descriptions for context.