Merged
Conversation
- Error classification: convert Python tracebacks into human-readable messages with suggested fixes (ModuleNotFoundError, AuthenticationError, ValidationError, ConnectionError, etc.) - Retry logic: exponential backoff with jitter for Fabric API calls, retries on 429/502/503/504 and network errors - Progress tracking: real-time node execution updates in workflow run spinner (parses Python verbose stderr) - Improved init: managed venv at ~/.ace/venv, Python version detection, 5-step setup flow with summary checklist - Workflow templates: 4 bundled templates (hello-llm, text-transform, llm-chain, api-to-llm) with list-templates and create commands - Tests: 65 tests across 7 files covering errors, retry, templates, init lifecycle, and workflow lifecycle - CI: GitHub Actions workflow with Node 18/20/22 matrix Closes #2 Co-Authored-By: Claude Opus 4.6 <[email protected]>
Document list-templates, create, init flow, error messages, fabric commands, and all test/dev scripts. Co-Authored-By: Claude Opus 4.6 <[email protected]>
- Install section: npm, npx, and build-from-source with npm link - New "Using Local LLMs" section with Ollama, vLLM, and cloud API examples - Model name → provider mapping reference table - ace init now mentions Ollama alongside cloud API keys Co-Authored-By: Claude Opus 4.6 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Hardens the ace CLI from v0.1.0 prototype to production-ready v1.0. Closes #2.
src/utils/errors.ts): Converts raw Python tracebacks into human-readable messages with actionable suggestions (ModuleNotFoundError, AuthenticationError, ValidationError, ConnectionError, etc.)src/utils/retry.ts): Exponential backoff with jitter for Fabric API calls — retries on 429/502/503/504 and network errors (configurable max retries, delay)workflow runspinner, parsing Python verbose stderr for node start/complete/error eventsace init: Managed venv at~/.ace/venv/, Python version detection with specific error messages, 5-step setup flow with summary checklistlist-templatesandcreatecommandsTest plan
pnpm lint— clean (0 errors)pnpm test— 65 tests pass across 7 filespnpm build— successful (36 KB bundle)ace workflow list-templates— displays 4 templates in formatted tableace workflow list-templates --category chains— filters correctlyace workflow create hello-llm -o /tmp/test.json— creates valid workflow JSON with parameter customizationace workflow validate /tmp/test.json— validates structure (Python validation requires aceteam-nodes)🤖 Generated with Claude Code