Skip to content

Add Jobs skill for daemon automation and recovery - #6

Merged
calvin-archastro merged 3 commits into
mainfrom
feat/tasks-workflow-skill
Sep 9, 2026
Merged

calvin-archastro merged 3 commits into
mainfrom
feat/tasks-workflow-skill

Conversation

@calvin-archastro

@calvin-archastro calvin-archastro commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Review on ArchCode

Problem and author intent

ArchDev exposes repository setup, private branch automation, durable jobs, and automatic PR remediation, but external coding agents lack a packaged workflow for operating them. Agents need to distinguish committed snapshots from checkout state, branch publication from PR watching, and failed Jobs from Factory dead-letter work before configuring or retrying automation.

This skill teaches the existing CLI lifecycle, using archdev setup's evidence-backed configuration audit as its exemplar.

What changed

  • Add an independently installable jobs skill covering bootstrap, onboarding, repository registration, private submission, named jobs, result synchronization, and automatic PR watching.
  • Add focused configuration and operations references for audited verification commands, model aliases and precedence, worktree runtime environments, validation, retry semantics, Factory dead-letter work, and destructive cleanup boundaries.
  • Explain before registration that publish.auto: false does not disable authored-PR remediation; registration cannot promise zero upstream mutations.
  • Ship pinned-installer Unix/PowerShell bootstraps that verify actual Jobs and provider command help, including rejection of older CLIs that return success with generic help.
  • Add README installation instructions and a dedicated PR CI packaging/bootstrap job.

Scope: CLI distribution, agent instructions, and CI only; no backend/frontend runtime changes. Users can install the skill independently and have their coding agent configure and operate existing automation.

Risk

Low to medium: bootstrap follows the Rooms/Tasks packaging pattern, but agent instructions govern consequential operations. The skill preserves publication authorization, host-owned PR finalization, retry identity, and explicit deletion boundaries. The 675-line change is primarily instructions split into two focused references; packaging remains alongside the skill so it installs independently.

Testing

  • Passed bash tests/jobs-skill.sh. Canonical packaging/bootstrap proof: tests/jobs-skill.sh, the complete script target. It invokes the real skills manager in global and repository scopes, checks packaged references, then crosses the installed bootstrap process boundary using a fixture installer/CLI. Assertions cover absolute executable identity, cold installation, reuse, upgrading a permissive older CLI, and installer failure without misleading stdout.
  • Automatic PR coverage: .github/workflows/installer-smoke-test.ymljobs-skillbash tests/jobs-skill.sh, on pull requests, main pushes, and manual dispatch. No Aster target exists in this public distribution repository; the script runs directly without test filters/skips.
  • Passed skill frontmatter validation, Bash syntax checks, and git diff --check.
  • Parsed the pipeline, model-alias structure, and worktree examples using the actual ArchDev source parsers. Model IDs are explicitly illustrative; no live availability claim.
  • Independent source walkthrough covered private-only onboarding, edited-config named retries, idle PR watching, Factory dead-letter recovery, and lifecycle configuration authority. Findings were corrected.

Follow-ups and limitations

The bootstrap test substitutes the release/CLI boundary; it is not a live daemon or GitHub end-to-end proof. A disposable repository, isolated native runner, authenticated model account, and controlled GitHub PR are needed to exercise setup → submit → job → publication/remediation automatically. That live journey remains follow-up work. PowerShell bootstrap was source-reviewed but not executed locally and has no dedicated Jobs bootstrap CI coverage. No production daemon or PR automation was enabled during this change.

@calvin-archastro
calvin-archastro merged commit ac76cdd into main Sep 9, 2026
8 checks passed
@calvin-archastro
calvin-archastro deleted the feat/tasks-workflow-skill branch September 9, 2026 18:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant