execforge 0.1.1__tar.gz → 0.1.2__tar.gz

{execforge-0.1.1/src/execforge.egg-info → execforge-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execforge
-Version: 0.1.1
+Version: 0.1.2
 Summary: Production-minded local CLI for autonomous repo orchestration
 Author: Open Source Contributors
 License: MIT License
@@ -63,6 +63,9 @@ pipx install execforge
 # or
 pip install execforge
 
+# npm (requires Python 3.11+ installed)
+npm install -g execforge
+
 # local dev
 pip install -e .
 ```
@@ -256,43 +259,87 @@ execforge agent update test-agent --set safety_settings.allow_push=true
 execforge agent delete test-agent --yes
 ```
 
-## Commands by workflow
-
-### Setup
-
-- `execforge init`
-- `execforge doctor`
-
-### Prompt sources (task origin)
-
-- `execforge prompt-source add`
-- `execforge prompt-source list`
-- `execforge prompt-source sync`
-
-### Project repos (code targets)
-
-- `execforge project add`
-- `execforge project list`
-
-### Agents (execution profiles)
-
-- `execforge agent add`
-- `execforge agent list`
-- `execforge agent list --compact`
-- `execforge agent update`
-- `execforge agent delete`
-- `execforge agent run <agent-name-or-id>`
-- `execforge agent loop <agent-name-or-id>`
-
-### Task and run inspection
-
-- `execforge task list`
-- `execforge task inspect <task-id>`
-- `execforge task set-status <task-id> <status>`
-- `execforge task retry <task-id>`
-- `execforge run list`
-- `execforge status`
-- `execforge start`
+## Complete command + config reference (grouped by task)
+
+```text
+Setup and health
+- execforge init [--interactive/--no-interactive]
+  Initialize app home, SQLite DB, and run first-time setup wizard.
+- execforge start
+  Print the guided first-time command sequence.
+- execforge status
+  Show setup counts and last run summary.
+- execforge doctor
+  Check app paths, SQLite access, and git environment.
+
+Prompt sources (task origin repos)
+- execforge prompt-source add <name> <repo-url> [branch] [folder_scope] [sync_strategy] [clone_path]
+  Register a prompt source definition.
+- execforge prompt-source list
+  List configured prompt sources.
+- execforge prompt-source sync <name-or-id> [--bootstrap-missing-branch]
+  Pull/clone source and discover task files.
+
+Project repos (code targets)
+- execforge project add <name> <local-path> [default_branch] [allowed_branch_pattern]
+  Register a local git repo as an execution target.
+- execforge project list
+  List configured project repos.
+
+Agents (execution profiles)
+- execforge agent
+  Alias for execforge agent list.
+- execforge agent add <name> <prompt-source-name-or-id> <project-name-or-id> [options]
+  Create an agent linked to one prompt source and one project.
+- execforge agent list [--compact]
+  List agents (JSON blocks or one-line compact view).
+- execforge agent update <agent-name-or-id> --set key=value [--set key=value ...]
+  Update agent fields and nested JSON config.
+- execforge agent delete <agent-name-or-id> [--yes]
+  Delete an agent and its run history.
+- execforge agent run <agent-name-or-id> [--verbose] [--debug]
+  Execute one run cycle.
+- execforge agent loop <agent-name-or-id> [interval_seconds] [max_iterations] [--verbose] [--debug] [--only-new-prompts/--all-eligible-prompts] [--reset-only-new-baseline]
+  Run continuously on a polling interval.
+
+Tasks and runs
+- execforge task list [status]
+  List discovered tasks, optionally filtered by status.
+- execforge task inspect <task-id>
+  Show parsed task details and steps.
+- execforge task set-status <task-id> <status>
+  Set status to one of: todo, ready, in_progress, done, failed, blocked.
+- execforge task retry <task-id>
+  Shortcut that sets task status back to todo.
+- execforge run list [limit]
+  Show recent run history rows.
+
+App config commands
+- execforge config
+  Alias for execforge config show.
+- execforge config show
+  Show current app config and key paths.
+- execforge config keys
+  List editable app config keys and defaults.
+- execforge config set <key> <value>
+  Set one config key.
+- execforge config set --set key=value [--set key=value ...]
+  Set multiple config keys in one command.
+- execforge config reset <key> [<key> ...]
+  Reset selected keys to defaults.
+- execforge config reset --all
+  Reset all app config keys to defaults.
+
+Editable app config keys (execforge config set)
+- log_level: string, default INFO
+- default_timeout_seconds: integer, default 900
+- default_require_clean_tree: boolean, default true
+- default_allow_push: boolean, default false
+
+Common agent update keys (execforge agent update --set ...)
+- Top-level: name, execution_backend, task_selector_strategy, push_policy, autonomy_level, max_steps, active
+- Nested JSON maps: model_settings.<key>, safety_settings.<key>, commit_policy.<key>
+```
 
 ## When nothing runs
 
@@ -337,25 +384,25 @@ export AGENT_ORCHESTRATOR_HOME=~/.agent-orchestrator
 - `docs/USAGE_WALKTHROUGH.md` - practical end-to-end flow
 - `docs/ARCHITECTURE.md` - implementation layout
 
-## CI/CD and PyPI publish
+## CI/CD and package publish
 
 This repo includes GitHub Actions pipelines:
 
-- `.github/workflows/ci.yml` - lint, tests, package build, and `twine check`
+- `.github/workflows/ci.yml` - lint, tests, Python package build, `twine check`, and npm package dry-run
 - `.github/workflows/publish-testpypi.yml` - manual publish to TestPyPI
-- `.github/workflows/publish-pypi.yml` - publish to PyPI on release (and manual dispatch)
+- `.github/workflows/publish-pypi.yml` - publish to PyPI and npm on release (and manual dispatch)
 
-Required repository secrets:
+Publishing auth:
 
-- `TEST_PYPI_API_TOKEN` for TestPyPI publishing
-- `PYPI_API_TOKEN` for PyPI publishing
+- `.github/workflows/publish-pypi.yml` uses Trusted Publishing (OIDC) for both PyPI and npm; no `PYPI_API_TOKEN` or `NPM_TOKEN` secret is required once trusted publishers are configured on each registry.
+- `.github/workflows/publish-testpypi.yml` currently uses `TEST_PYPI_API_TOKEN`.
 
 Typical release flow:
 
 ```bash
 # 1) bump version in pyproject.toml
 # 2) commit and tag
-git tag v0.1.1
+git tag v0.1.2
 git push origin main --tags
 
 # 3) create/publish a GitHub Release for that tag

{execforge-0.1.1 → execforge-0.1.2}/README.md

@@ -23,6 +23,9 @@ pipx install execforge
 # or
 pip install execforge
 
+# npm (requires Python 3.11+ installed)
+npm install -g execforge
+
 # local dev
 pip install -e .
 ```
@@ -216,43 +219,87 @@ execforge agent update test-agent --set safety_settings.allow_push=true
 execforge agent delete test-agent --yes
 ```
 
-## Commands by workflow
-
-### Setup
-
-- `execforge init`
-- `execforge doctor`
-
-### Prompt sources (task origin)
-
-- `execforge prompt-source add`
-- `execforge prompt-source list`
-- `execforge prompt-source sync`
-
-### Project repos (code targets)
-
-- `execforge project add`
-- `execforge project list`
-
-### Agents (execution profiles)
-
-- `execforge agent add`
-- `execforge agent list`
-- `execforge agent list --compact`
-- `execforge agent update`
-- `execforge agent delete`
-- `execforge agent run <agent-name-or-id>`
-- `execforge agent loop <agent-name-or-id>`
-
-### Task and run inspection
-
-- `execforge task list`
-- `execforge task inspect <task-id>`
-- `execforge task set-status <task-id> <status>`
-- `execforge task retry <task-id>`
-- `execforge run list`
-- `execforge status`
-- `execforge start`
+## Complete command + config reference (grouped by task)
+
+```text
+Setup and health
+- execforge init [--interactive/--no-interactive]
+  Initialize app home, SQLite DB, and run first-time setup wizard.
+- execforge start
+  Print the guided first-time command sequence.
+- execforge status
+  Show setup counts and last run summary.
+- execforge doctor
+  Check app paths, SQLite access, and git environment.
+
+Prompt sources (task origin repos)
+- execforge prompt-source add <name> <repo-url> [branch] [folder_scope] [sync_strategy] [clone_path]
+  Register a prompt source definition.
+- execforge prompt-source list
+  List configured prompt sources.
+- execforge prompt-source sync <name-or-id> [--bootstrap-missing-branch]
+  Pull/clone source and discover task files.
+
+Project repos (code targets)
+- execforge project add <name> <local-path> [default_branch] [allowed_branch_pattern]
+  Register a local git repo as an execution target.
+- execforge project list
+  List configured project repos.
+
+Agents (execution profiles)
+- execforge agent
+  Alias for execforge agent list.
+- execforge agent add <name> <prompt-source-name-or-id> <project-name-or-id> [options]
+  Create an agent linked to one prompt source and one project.
+- execforge agent list [--compact]
+  List agents (JSON blocks or one-line compact view).
+- execforge agent update <agent-name-or-id> --set key=value [--set key=value ...]
+  Update agent fields and nested JSON config.
+- execforge agent delete <agent-name-or-id> [--yes]
+  Delete an agent and its run history.
+- execforge agent run <agent-name-or-id> [--verbose] [--debug]
+  Execute one run cycle.
+- execforge agent loop <agent-name-or-id> [interval_seconds] [max_iterations] [--verbose] [--debug] [--only-new-prompts/--all-eligible-prompts] [--reset-only-new-baseline]
+  Run continuously on a polling interval.
+
+Tasks and runs
+- execforge task list [status]
+  List discovered tasks, optionally filtered by status.
+- execforge task inspect <task-id>
+  Show parsed task details and steps.
+- execforge task set-status <task-id> <status>
+  Set status to one of: todo, ready, in_progress, done, failed, blocked.
+- execforge task retry <task-id>
+  Shortcut that sets task status back to todo.
+- execforge run list [limit]
+  Show recent run history rows.
+
+App config commands
+- execforge config
+  Alias for execforge config show.
+- execforge config show
+  Show current app config and key paths.
+- execforge config keys
+  List editable app config keys and defaults.
+- execforge config set <key> <value>
+  Set one config key.
+- execforge config set --set key=value [--set key=value ...]
+  Set multiple config keys in one command.
+- execforge config reset <key> [<key> ...]
+  Reset selected keys to defaults.
+- execforge config reset --all
+  Reset all app config keys to defaults.
+
+Editable app config keys (execforge config set)
+- log_level: string, default INFO
+- default_timeout_seconds: integer, default 900
+- default_require_clean_tree: boolean, default true
+- default_allow_push: boolean, default false
+
+Common agent update keys (execforge agent update --set ...)
+- Top-level: name, execution_backend, task_selector_strategy, push_policy, autonomy_level, max_steps, active
+- Nested JSON maps: model_settings.<key>, safety_settings.<key>, commit_policy.<key>
+```
 
 ## When nothing runs
 
@@ -297,25 +344,25 @@ export AGENT_ORCHESTRATOR_HOME=~/.agent-orchestrator
 - `docs/USAGE_WALKTHROUGH.md` - practical end-to-end flow
 - `docs/ARCHITECTURE.md` - implementation layout
 
-## CI/CD and PyPI publish
+## CI/CD and package publish
 
 This repo includes GitHub Actions pipelines:
 
-- `.github/workflows/ci.yml` - lint, tests, package build, and `twine check`
+- `.github/workflows/ci.yml` - lint, tests, Python package build, `twine check`, and npm package dry-run
 - `.github/workflows/publish-testpypi.yml` - manual publish to TestPyPI
-- `.github/workflows/publish-pypi.yml` - publish to PyPI on release (and manual dispatch)
+- `.github/workflows/publish-pypi.yml` - publish to PyPI and npm on release (and manual dispatch)
 
-Required repository secrets:
+Publishing auth:
 
-- `TEST_PYPI_API_TOKEN` for TestPyPI publishing
-- `PYPI_API_TOKEN` for PyPI publishing
+- `.github/workflows/publish-pypi.yml` uses Trusted Publishing (OIDC) for both PyPI and npm; no `PYPI_API_TOKEN` or `NPM_TOKEN` secret is required once trusted publishers are configured on each registry.
+- `.github/workflows/publish-testpypi.yml` currently uses `TEST_PYPI_API_TOKEN`.
 
 Typical release flow:
 
 ```bash
 # 1) bump version in pyproject.toml
 # 2) commit and tag
-git tag v0.1.1
+git tag v0.1.2
 git push origin main --tags
 
 # 3) create/publish a GitHub Release for that tag

{execforge-0.1.1 → execforge-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "execforge"
-version = "0.1.1"
+version = "0.1.2"
 description = "Production-minded local CLI for autonomous repo orchestration"
 readme = "README.md"
 requires-python = ">=3.11"

{execforge-0.1.1 → execforge-0.1.2/src/execforge.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execforge
-Version: 0.1.1
+Version: 0.1.2
 Summary: Production-minded local CLI for autonomous repo orchestration
 Author: Open Source Contributors
 License: MIT License
@@ -63,6 +63,9 @@ pipx install execforge
 # or
 pip install execforge
 
+# npm (requires Python 3.11+ installed)
+npm install -g execforge
+
 # local dev
 pip install -e .
 ```
@@ -256,43 +259,87 @@ execforge agent update test-agent --set safety_settings.allow_push=true
 execforge agent delete test-agent --yes
 ```
 
-## Commands by workflow
-
-### Setup
-
-- `execforge init`
-- `execforge doctor`
-
-### Prompt sources (task origin)
-
-- `execforge prompt-source add`
-- `execforge prompt-source list`
-- `execforge prompt-source sync`
-
-### Project repos (code targets)
-
-- `execforge project add`
-- `execforge project list`
-
-### Agents (execution profiles)
-
-- `execforge agent add`
-- `execforge agent list`
-- `execforge agent list --compact`
-- `execforge agent update`
-- `execforge agent delete`
-- `execforge agent run <agent-name-or-id>`
-- `execforge agent loop <agent-name-or-id>`
-
-### Task and run inspection
-
-- `execforge task list`
-- `execforge task inspect <task-id>`
-- `execforge task set-status <task-id> <status>`
-- `execforge task retry <task-id>`
-- `execforge run list`
-- `execforge status`
-- `execforge start`
+## Complete command + config reference (grouped by task)
+
+```text
+Setup and health
+- execforge init [--interactive/--no-interactive]
+  Initialize app home, SQLite DB, and run first-time setup wizard.
+- execforge start
+  Print the guided first-time command sequence.
+- execforge status
+  Show setup counts and last run summary.
+- execforge doctor
+  Check app paths, SQLite access, and git environment.
+
+Prompt sources (task origin repos)
+- execforge prompt-source add <name> <repo-url> [branch] [folder_scope] [sync_strategy] [clone_path]
+  Register a prompt source definition.
+- execforge prompt-source list
+  List configured prompt sources.
+- execforge prompt-source sync <name-or-id> [--bootstrap-missing-branch]
+  Pull/clone source and discover task files.
+
+Project repos (code targets)
+- execforge project add <name> <local-path> [default_branch] [allowed_branch_pattern]
+  Register a local git repo as an execution target.
+- execforge project list
+  List configured project repos.
+
+Agents (execution profiles)
+- execforge agent
+  Alias for execforge agent list.
+- execforge agent add <name> <prompt-source-name-or-id> <project-name-or-id> [options]
+  Create an agent linked to one prompt source and one project.
+- execforge agent list [--compact]
+  List agents (JSON blocks or one-line compact view).
+- execforge agent update <agent-name-or-id> --set key=value [--set key=value ...]
+  Update agent fields and nested JSON config.
+- execforge agent delete <agent-name-or-id> [--yes]
+  Delete an agent and its run history.
+- execforge agent run <agent-name-or-id> [--verbose] [--debug]
+  Execute one run cycle.
+- execforge agent loop <agent-name-or-id> [interval_seconds] [max_iterations] [--verbose] [--debug] [--only-new-prompts/--all-eligible-prompts] [--reset-only-new-baseline]
+  Run continuously on a polling interval.
+
+Tasks and runs
+- execforge task list [status]
+  List discovered tasks, optionally filtered by status.
+- execforge task inspect <task-id>
+  Show parsed task details and steps.
+- execforge task set-status <task-id> <status>
+  Set status to one of: todo, ready, in_progress, done, failed, blocked.
+- execforge task retry <task-id>
+  Shortcut that sets task status back to todo.
+- execforge run list [limit]
+  Show recent run history rows.
+
+App config commands
+- execforge config
+  Alias for execforge config show.
+- execforge config show
+  Show current app config and key paths.
+- execforge config keys
+  List editable app config keys and defaults.
+- execforge config set <key> <value>
+  Set one config key.
+- execforge config set --set key=value [--set key=value ...]
+  Set multiple config keys in one command.
+- execforge config reset <key> [<key> ...]
+  Reset selected keys to defaults.
+- execforge config reset --all
+  Reset all app config keys to defaults.
+
+Editable app config keys (execforge config set)
+- log_level: string, default INFO
+- default_timeout_seconds: integer, default 900
+- default_require_clean_tree: boolean, default true
+- default_allow_push: boolean, default false
+
+Common agent update keys (execforge agent update --set ...)
+- Top-level: name, execution_backend, task_selector_strategy, push_policy, autonomy_level, max_steps, active
+- Nested JSON maps: model_settings.<key>, safety_settings.<key>, commit_policy.<key>
+```
 
 ## When nothing runs
 
@@ -337,25 +384,25 @@ export AGENT_ORCHESTRATOR_HOME=~/.agent-orchestrator
 - `docs/USAGE_WALKTHROUGH.md` - practical end-to-end flow
 - `docs/ARCHITECTURE.md` - implementation layout
 
-## CI/CD and PyPI publish
+## CI/CD and package publish
 
 This repo includes GitHub Actions pipelines:
 
-- `.github/workflows/ci.yml` - lint, tests, package build, and `twine check`
+- `.github/workflows/ci.yml` - lint, tests, Python package build, `twine check`, and npm package dry-run
 - `.github/workflows/publish-testpypi.yml` - manual publish to TestPyPI
-- `.github/workflows/publish-pypi.yml` - publish to PyPI on release (and manual dispatch)
+- `.github/workflows/publish-pypi.yml` - publish to PyPI and npm on release (and manual dispatch)
 
-Required repository secrets:
+Publishing auth:
 
-- `TEST_PYPI_API_TOKEN` for TestPyPI publishing
-- `PYPI_API_TOKEN` for PyPI publishing
+- `.github/workflows/publish-pypi.yml` uses Trusted Publishing (OIDC) for both PyPI and npm; no `PYPI_API_TOKEN` or `NPM_TOKEN` secret is required once trusted publishers are configured on each registry.
+- `.github/workflows/publish-testpypi.yml` currently uses `TEST_PYPI_API_TOKEN`.
 
 Typical release flow:
 
 ```bash
 # 1) bump version in pyproject.toml
 # 2) commit and tag
-git tag v0.1.1
+git tag v0.1.2
 git push origin main --tags
 
 # 3) create/publish a GitHub Release for that tag

{execforge-0.1.1 → execforge-0.1.2}/src/orchestrator/__init__.py

@@ -1,4 +1,4 @@
 """Repo orchestrator package."""
 
 __all__ = ["__version__"]
-__version__ = "0.1.1"
+__version__ = "0.1.2"