arnes/docs/scripts-reference.md

Scripts reference

./scripts/install_into_repo.sh /path/to/project-repo

Copies ARNES core into a different project repo.

What it does:

• refuses to install into the ARNES source repo itself
• initializes git repo at target if missing
• copies ARNES core files into target repo

./scripts/start.sh

Interactive bootstrap wizard.

What it does:

• asks project metadata
• chooses default app directory (project/ by default)
• defaults Python/Flask projects to python3 -m unittest discover -s project/tests -v
• seeds a minimal bootstrap smoke test under project/tests/ for Python/Flask
• writes harness/project.config.json
• creates scripts/verify.local.sh
• can seed one bootstrap ticket
• resets runtime status

./scripts/verify.sh

Core harness verification.

What it checks:

• required core files exist
• project is inside a git repo
• warns if no git remote exists
• backlog JSON is valid
• only one feature is in_progress
• done features have all required artifacts, including publish evidence
• runtime status JSON is valid
• source-repo self-tests run automatically if tests/ exists
• optional local overlay runs if present

python3 scripts/new_ticket.py

Interactive ticket creator.

Writes one new backlog entry with:

• type
• title
• problem
• goal
• scope_in
• scope_out
• priority
• risk
• acceptance

python3 scripts/publish_ticket.py --feature-id F-001

Final publish step for one ticket.

What it does:

• validates git repo, remote, and git identity
• writes work/artifacts/<feature_id>/publish.json
• creates one commit for the ticket
• pushes the branch to remote

python3 scripts/agent_status.py

Runtime status helper.

Commands:

• show
• set
• reset

The set command validates stage and agent names against harness files.