Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Monitoring and App readiness

Monitoring is read-only collection, distinct from dependency-update admission. The current audit identifies direct known PR creators in default-branch workflow YAML. It is not a complete call-graph or workflow-security analysis.

DA-MON-001 — Auditable workflow reads

Requirement. Maintenance audit MUST inspect exact default-branch workflow revisions using read authority and retain explicit coverage outcomes.

Acceptance details

  • Reports MUST include schema version, collection time, repository source SHA and workflow paths.
  • Read, parse or truncated-tree failures MUST produce an unavailable coverage entry and a failing exit status.
  • Partial reports MUST still be written and retained by the hosted workflow.
  • Unexpected errors, API bodies, tokens and unallowlisted environment values MUST NOT enter reports.

DA-MON-002 — Bounded authentication findings

Requirement. Authentication findings MUST distinguish workflow-token writers, recognized App-token references and unverified references without claiming more coverage than the detector provides.

Acceptance details

  • Direct gh pr create/edit, Changesets and known PR-creation actions MUST be inspected.
  • Environment token resolution MUST respect workflow, job and step precedence.
  • An arbitrary token output MUST NOT prove App authentication.
  • Findings MUST remain recommendations; inaccessible coverage MUST remain distinct from a clean audit.

DA-MON-003 — Read-only readiness probe

Requirement. The manual main-only App probe MUST verify exactly one explicit pilot repository with read-only contents/PR authority.

Acceptance details

  • Pilot choices MUST resolve through the exact reviewed repository-to-owner mapping before App minting.
  • The token’s installation scope MUST contain exactly that repository.
  • Repository and PR reads MUST succeed without changing branches, PRs, reviews, settings or secrets.
  • Successful reads MUST NOT be reported as proof of write readiness.

Coverage limits

The audit does not inspect script internals or remote reusable workflow bodies. DA-OPS-001 adds recursive local composite resolution, reviewed pin/Node source comparisons, update ownership, exclusions and activation observations. Required check settings are compared conservatively with static PR job candidates; missing APIs, filters, matrices and dynamic names retain unknown coverage. Matching names do not prove functional coverage or green current-head checks. No persistent issue collector or unattended operator UI is implemented here. Maintenance’s separate browser adapter consumes monitoring defaults while retaining its own credential and command boundaries.

Changesets creators may reference with.github-token as well as the legacy GITHUB_TOKEN environment variable. The detector retains the legacy explicit environment precedence and recognizes the source’s pinned v2 input-only App reference; unknown outputs remain unverified. It reports references, not actual token values or proof that a particular action version can execute successfully.

The audit may observe its five allowlisted activation settings from GitHub’s resolved vars context when the Variables API is unavailable. This fallback requires the exact coordinator repository, main ref, audit workflow ref, supported event and source SHA; local or incomplete contexts remain unavailable. Reports retain sanitized values and their provenance under DA-OPS-001.

The next Docs/Tasks source preparations may invoke the same reviewed App readiness workflow for their two explicitly named repositories. Tokens remain restricted to one selected repository with contents/PR reads only; no source checkout, credential retrieval/rotation or writer activation is added.

The next small-repository slice registers Spec Validator’s existing Check workflow and Visual Delta’s existing CI, PR-specification, Pages and version workflows by exact IDs, paths and supported events. The read-only App probe adds only those two exact targets. Tag publishers, native capture, image publishers and callback self-triggers are not completion sources; verified npm notifications remain separate. Both repositories retain phase full until their merged source acceptance and a separate per-entry activation/replay. Spec Validator currently consumes no Lapis npm dependency; no synthetic Core pin or version recipe is introduced to create an update. Visual Delta consumes only the Deno-free specification tool in development and retains its existing audit and compare-only browser gates. The operator requests a final merge pass and gives standing approval for per-repository activation after passing source acceptance; advisory exceptions and global full rollout are not implied.

The parallel adoption probe adds the remaining eligible exact targets, including Mira, Core, Notebook, Desktop, Agent UI, Terminal, Plugin Registry and jj-store. Only the fixed jj-store mapping selects the personal owner. It retains no checkout, writer, secret retrieval or installation-setting mutation. A missing App installation remains a concrete read-readiness failure, not permission to copy credentials or activate that repository.