Agentic AI Atlasby a5c.ai
OverviewWikiGraphFor AgentsEdgesSearchWorkspace
/
GitHubDocsDiscord
iiRecord
Agentic AI Atlas · cycle-aware-verification
lib-process:shared--cycle-aware-verificationa5c.ai
Search record views/
Record · tabs

Available views

II.Record viewspp. 1 - 1
overviewjsongraph
II.
LibraryProcess overview

lib-process:shared--cycle-aware-verification

Reference · live

cycle-aware-verification overview

Composable cycle-aware verification component that validates fixes survive system execution cycles (cron jobs, scheduled tasks, server restarts, watch-mode rebuilds). Many bugs only manifest after a system completes its next cycle — a server that passes an immediate health check may crash on its next hot-reload, a cron fix may break on the next scheduled invocation, or a build-watch process may fail on the next file-change trigger. Traditional verification checks the system once, immediately after a change. Cycle-aware verification adds a temporal dimension: it performs a baseline check, waits for the system to complete its next execution cycle, then re-checks. A fix is only considered valid if the system survives both the immediate check and the post-cycle check. The module also provides pre-flight analysis to scan files for dangerous patterns before changes are applied, catching destructive commands (rm -rf, kill -9, etc.) before they can do damage. The module exposes four surfaces: - `createPreflightAnalysis(config)` — factory that builds a shell task to grep for dangerous patterns in a target file. - `cycleAwareVerificationTask` — standalone `defineTask` descriptor (kind: 'shell') that performs baseline check, waits for a cycle, then re-checks in a single shell invocation. - `createCycleAwareVerification(config)` — factory that returns separate baseline and post-cycle task definitions for fine-grained manual control. - `createPostCycleSurvivalCheck(config)` — factory that builds a single post-cycle survival check task with baked-in URL, cycle interval, and expected status.

LibraryProcessOutgoing · 11Incoming · 0

Attributes

displayName
cycle-aware-verification
description
Composable cycle-aware verification component that validates fixes survive system execution cycles (cron jobs, scheduled tasks, server restarts, watch-mode rebuilds). Many bugs only manifest after a system completes its next cycle — a server that passes an immediate health check may crash on its next hot-reload, a cron fix may break on the next scheduled invocation, or a build-watch process may fail on the next file-change trigger. Traditional verification checks the system once, immediately after a change. Cycle-aware verification adds a temporal dimension: it performs a baseline check, waits for the system to complete its next execution cycle, then re-checks. A fix is only considered valid if the system survives both the immediate check and the post-cycle check. The module also provides pre-flight analysis to scan files for dangerous patterns before changes are applied, catching destructive commands (rm -rf, kill -9, etc.) before they can do damage. The module exposes four surfaces: - `createPreflightAnalysis(config)` — factory that builds a shell task to grep for dangerous patterns in a target file. - `cycleAwareVerificationTask` — standalone `defineTask` descriptor (kind: 'shell') that performs baseline check, waits for a cycle, then re-checks in a single shell invocation. - `createCycleAwareVerification(config)` — factory that returns separate baseline and post-cycle task definitions for fine-grained manual control. - `createPostCycleSurvivalCheck(config)` — factory that builds a single post-cycle survival check task with baked-in URL, cycle interval, and expected status.
libraryPath
library/processes/shared/cycle-aware-verification.js
example
```js import { cycleAwareVerificationTask, createCycleAwareVerification, createPreflightAnalysis, createPostCycleSurvivalCheck, } from './cycle-aware-verification.js'; // Standalone task usage (single shell invocation): const result = await ctx.task(cycleAwareVerificationTask, { url: 'http://localhost:3000/api/health', cycleIntervalMs: 60000, expectedStatus: 200, }); // Factory usage (separate baseline + post-cycle tasks): const { baselineTask, postCycleTask } = createCycleAwareVerification({ healthCheck: { url: 'http://localhost:3000/api/health', timeout: 5000 }, cycleIntervalMs: 300000, }); const baseline = await ctx.task(baselineTask, {}); const postCycle = await ctx.task(postCycleTask, {}); // Pre-flight analysis: const preflight = createPreflightAnalysis({ timeout: 5000 }); const scan = await ctx.task(preflight, { filePath: 'scripts/deploy.sh' }); // Post-cycle survival check: const survivalTask = createPostCycleSurvivalCheck({ url: 'http://localhost:8080/health', cycleIntervalMs: 120000, }); const survived = await ctx.task(survivalTask, {}); ```

Outgoing edges

lib_applies_to_domain1
  • domain:software-engineering·DomainSoftware Engineering
lib_covers_topic2
  • topic:test-driven-development·TopicTest-Driven Development
  • topic:code-review-best-practices·TopicCode Review Best Practices
lib_implements_workflow3
  • workflow:code-review·Workflow
  • workflow:feature-development·Workflow
  • workflow:release-management·Workflow
lib_involves_role3
  • role:backend-engineer·RoleBackend Engineer
  • role:tech-lead·RoleTech Lead
  • role:qa-engineer·RoleQA Engineer
lib_requires_skill_area2
  • skill-area:code-review-practice·SkillAreaCode Review Practice
  • skill-area:e2e-testing·SkillAreaEnd-to-End Testing

Incoming edges

None.

Related pages

No related wiki pages for this record.

Shortcuts

Open in graph
Browse node kind