refactor: update paths from projects to packages in documentation and scripts

Author: ryanmerolle

.github/workflows/QUICKSTART.md

@@ -103,11 +103,11 @@ Before publishing to production PyPI, test with TestPyPI:
 
 ```bash
 # 1. Update version numbers
-sed -i 's/^version = ".*"/version = "0.3.1"/' projects/agent/pyproject.toml
-sed -i 's/^version = ".*"/version = "0.3.1"/' projects/simunet/pyproject.toml
+sed -i 's/^version = ".*"/version = "0.3.1"/' packages/agent/pyproject.toml
+sed -i 's/^version = ".*"/version = "0.3.1"/' packages/simunet/pyproject.toml
 
 # 2. Commit changes
-git add projects/*/pyproject.toml
+git add packages/*/pyproject.toml
 git commit -m "chore: bump version to 0.3.1"
 git push
 
@@ -157,8 +157,8 @@ The `release.yml` workflow will automatically:
 
 ```bash
 # Manually update version in pyproject.toml files
-sed -i 's/^version = ".*"/version = "0.3.2"/' projects/agent/pyproject.toml
-sed -i 's/^version = ".*"/version = "0.3.2"/' projects/simunet/pyproject.toml
+sed -i 's/^version = ".*"/version = "0.3.2"/' packages/agent/pyproject.toml
+sed -i 's/^version = ".*"/version = "0.3.2"/' packages/simunet/pyproject.toml
 # Then rebuild and publish
 ```
 
@@ -177,7 +177,7 @@ Or check the image name matches: `ghcr.io/opensecflow/netdriver/python-uv:3.12`
 **Solution:** Check build output - Polylith path warnings are normal, verify wheel contents:
 
 ```bash
-unzip -l projects/agent/dist/netdriver_agent-*.whl
+unzip -l packages/agent/dist/netdriver_agent-*.whl
 ```
 
 ## Best Practices
@@ -186,7 +186,7 @@ unzip -l projects/agent/dist/netdriver_agent-*.whl
 
 ✅ **DO:**
 
-- Keep version numbers in sync across `projects/agent/pyproject.toml` and `projects/simunet/pyproject.toml`
+- Keep version numbers in sync across `packages/agent/pyproject.toml` and `packages/simunet/pyproject.toml`
 - Use semantic versioning: `MAJOR.MINOR.PATCH`
 - Test on TestPyPI before production
 
@@ -199,7 +199,7 @@ unzip -l projects/agent/dist/netdriver_agent-*.whl
 ### Release Process
 
 1. Develop features on branches
-2. Test locally: `uv build --directory projects/agent`
+2. Test locally: `uv build --directory packages/agent`
 3. Create PR and verify build test passes
 4. Merge to master
 5. Test on TestPyPI

.github/workflows/README.md

@@ -68,10 +68,10 @@ The project supports independent release workflows for agent and simunet:
 
 ```bash
 # Update agent version in pyproject.toml (optional, will be updated by workflow)
-sed -i 's/^version = ".*"/version = "1.0.0"/' projects/agent/pyproject.toml
+sed -i 's/^version = ".*"/version = "1.0.0"/' packages/agent/pyproject.toml
 
 # Commit version changes (optional)
-git add projects/agent/pyproject.toml
+git add packages/agent/pyproject.toml
 git commit -m "chore: bump agent version to 1.0.0"
 
 # Create and push agent tag
@@ -98,10 +98,10 @@ git push origin agent-1.0.0
 
 ```bash
 # Update simunet version in pyproject.toml (optional, will be updated by workflow)
-sed -i 's/^version = ".*"/version = "2.5.0"/' projects/simunet/pyproject.toml
+sed -i 's/^version = ".*"/version = "2.5.0"/' packages/simunet/pyproject.toml
 
 # Commit version changes (optional)
-git add projects/simunet/pyproject.toml
+git add packages/simunet/pyproject.toml
 git commit -m "chore: bump simunet version to 2.5.0"
 
 # Create and push simunet tag
@@ -165,13 +165,13 @@ Use this when you only need to release the agent:
 1. **Update version number** (optional):
 
    ```bash
-   sed -i 's/^version = ".*"/version = "1.0.0"/' projects/agent/pyproject.toml
+   sed -i 's/^version = ".*"/version = "1.0.0"/' packages/agent/pyproject.toml
    ```
 
 2. **Commit changes** (optional):
 
    ```bash
-   git add projects/agent/pyproject.toml
+   git add packages/agent/pyproject.toml
    git commit -m "chore: bump agent version to 1.0.0"
    git push origin master
    ```
@@ -197,13 +197,13 @@ Use this when you need to release simunet:
 1. **Update version number** (optional):
 
    ```bash
-   sed -i 's/^version = ".*"/version = "2.5.0"/' projects/simunet/pyproject.toml
+   sed -i 's/^version = ".*"/version = "2.5.0"/' packages/simunet/pyproject.toml
    ```
 
 2. **Commit changes** (optional):
 
    ```bash
-   git add projects/simunet/pyproject.toml
+   git add packages/simunet/pyproject.toml
    git commit -m "chore: bump simunet version to 2.5.0"
    git push origin master
    ```
@@ -235,8 +235,8 @@ To test publishing before official release:
 2. **Or use CLI**:
 
    ```bash
-   uv publish --directory projects/agent --publish-url https://test.pypi.org/legacy/ --token $TESTPYPI_TOKEN
-   uv publish --directory projects/simunet --publish-url https://test.pypi.org/legacy/ --token $TESTPYPI_TOKEN
+   uv publish --directory packages/agent --publish-url https://test.pypi.org/legacy/ --token $TESTPYPI_TOKEN
+   uv publish --directory packages/simunet --publish-url https://test.pypi.org/legacy/ --token $TESTPYPI_TOKEN
    ```
 
 3. **Verify on TestPyPI**:
@@ -413,7 +413,7 @@ jobs:
       - uses: astral-sh/setup-uv@v4
       - run: uv python install
       - run: uv sync
-      - run: uv build --directory projects/agent
+      - run: uv build --directory packages/agent
 ```
 
 **Benefits of using Docker image**:
@@ -452,7 +452,7 @@ netdriver/
 │       ├── agent/                  # REST API service
 │       └── simunet/                # Simulation network
 ├── components/                     # Shared components
-└── projects/
+└── packages/
     ├── agent/
     │   └── pyproject.toml
     └── simunet/
@@ -498,5 +498,5 @@ uv is pre-installed, so you can use it directly:
 ## References
 
 - [uv Documentation](https://docs.astral.sh/uv/)
-- [PyPI Publishing Guide](https://packaging.python.org/tutorials/packaging-projects/)
+- [PyPI Publishing Guide](https://packaging.python.org/tutorials/packaging-packages/)
 - [GitHub Actions - Python](https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python)

scripts/README.md

@@ -37,7 +37,7 @@ A convenient script to create and push release tags.
 2. Checks prerequisites (git repository, uv installation)
 3. Verifies working directory is clean
 4. Verifies the tag doesn't already exist
-5. Updates version in `projects/<project>/pyproject.toml`
+5. Updates version in `packages/<project>/pyproject.toml`
 6. Commits the version change
 7. Creates an annotated git tag (e.g., `agent-0.3.5`)
 8. Pushes the commit and tag to remote

scripts/release.sh

@@ -127,13 +127,13 @@ fi
 
 # Update version in pyproject.toml
 echo
-print_info "Updating version in projects/${PROJECT}/pyproject.toml to ${VERSION}..."
-sed -i '' "s/^version = \".*\"/version = \"${VERSION}\"/" "projects/${PROJECT}/pyproject.toml"
+print_info "Updating version in packages/${PROJECT}/pyproject.toml to ${VERSION}..."
+sed -i '' "s/^version = \".*\"/version = \"${VERSION}\"/" "packages/${PROJECT}/pyproject.toml"
 print_success "Version updated"
 
 # Commit version changes
 print_info "Committing version changes..."
-git add "projects/${PROJECT}/pyproject.toml"
+git add "packages/${PROJECT}/pyproject.toml"
 git commit -m "chore: bump ${PROJECT} version to ${VERSION}"
 print_success "Version changes committed"