chipfoundry-cli 1.0.4__tar.gz → 1.1.0__tar.gz

{chipfoundry_cli-1.0.4 → chipfoundry_cli-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: chipfoundry-cli
-Version: 1.0.4
+Version: 1.1.0
 Summary: CLI tool to automate ChipFoundry project submission to SFTP server
 Home-page: https://chipfoundry.io
 License: Apache-2.0
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: click (>=8.0.0,<9)
+Requires-Dist: httpx (>=0.24.0,<1.0)
 Requires-Dist: paramiko (>=3.0.0,<4)
 Requires-Dist: rich (>=13,<14)
 Requires-Dist: toml (>=0.10,<1.0)
@@ -82,6 +83,11 @@ cf --help
    cf view-tapeout-report
    ```
 
+8. **Confirm final tapeout** (when ready to send GDS to foundry):
+   ```bash
+   cf confirm
+   ```
+
 ---
 
 ## Project Structure Requirements
@@ -95,6 +101,7 @@ Your project directory **must** contain:
   - **Note**: Both compressed (`.gz`) and uncompressed (`.gds`) files are supported
 - `verilog/rtl/user_defines.v` (required for digital/analog)
 - `.cf/project.json` (optional; will be created/updated automatically)
+  - Contains project metadata including `submission_state` ("Draft" or "Final")
 
 **Example:**
 ```
@@ -217,6 +224,23 @@ cf pull [--project-name NAME]
           └── consolidated_report.html
   ```
 
+### Confirm Final Tapeout
+
+```bash
+cf confirm [OPTIONS]
+```
+
+- **Confirms your final tapeout** by setting `submission_state` to "Final"
+- **Uploads only the project.json** to the SFTP server (not the entire project)
+- **Use this when you're ready to send your current GDS file to the foundry** for tapeout processing
+- **Options:**
+  - `--project-root`: Specify project directory
+  - `--project-name`: Override project name
+  - `--sftp-username`: Override configured username
+  - `--sftp-key`: Override configured key path
+
+**Important:** This command confirms that your current GDS file is ready to be sent to the foundry for tapeout. Only run this when you are completely satisfied with your design and ready for final tapeout processing. This action cannot be easily undone.
+
 ### View Tapeout Report
 
 ```bash
@@ -240,6 +264,102 @@ cf status
 - Shows which projects have input files and/or results
 - Displays project status in a clean table format
 
+### Repository Management
+
+#### Update Repository Files
+
+```bash
+cf repo update [OPTIONS]
+```
+
+- **Updates local project files** from the upstream GitHub repository
+- **Fetches configuration** from `.cf/repo.json` in the specified repository and branch
+- **Downloads and overwrites** local files based on the changes list in the configuration
+- **Saves configuration** locally to `.cf/repo.json` for reference
+
+**Options:**
+- `--project-root`: Specify project directory (defaults to current directory)
+- `--repo-owner`: GitHub repository owner (default: chipfoundry)
+- `--repo-name`: GitHub repository name (default: caravel_user_project)
+- `--branch`: Branch name containing the repo.json file (default: cli-update)
+- `--dry-run`: Preview changes without updating files
+
+**What happens:**
+1. Fetches `.cf/repo.json` from the specified GitHub repository and branch
+2. Downloads and saves the configuration file locally to `.cf/repo.json`
+3. Downloads and overwrites each file listed in the `changes` array
+4. Provides detailed feedback on success/failure of each file update
+
+**Example:**
+```bash
+# Preview what would be updated
+cf repo update --dry-run
+# Output:
+# Files that would be updated:
+#   • .cf/repo.json (configuration file)
+#   • README.md
+#   • Makefile
+#   • openlane/Makefile
+
+# Update files from upstream
+cf repo update
+# Output:
+# Update results:
+# ✓ Updated: .cf/repo.json
+# ✓ Updated: README.md
+# ✓ Updated: Makefile
+# ✓ Updated: openlane/Makefile
+# Successfully updated 4 file(s)
+# All files updated successfully!
+```
+
+**Use cases:**
+- Keep your project up-to-date with upstream changes
+- Apply bug fixes and improvements from the template repository
+- Sync configuration changes from the upstream project
+- Maintain consistency with the latest project structure
+
+---
+
+## Submission Workflow and States
+
+The CLI tracks your project submission state through the `submission_state` field in `project.json`:
+
+### Project States
+
+- **"Draft"** - Initial state when you run `cf init`
+  - Project is ready for development and testing
+  - You can push updates multiple times
+  - Project is not yet ready for tapeout processing
+
+- **"Final"** - Confirmed state when you run `cf confirm`
+  - GDS file is ready to be sent to the foundry for tapeout
+  - No further changes should be made to the design
+  - Only the project.json is uploaded (not the full project)
+
+### Recommended Workflow
+
+1. **Development Phase:**
+   ```bash
+   cf init          # Creates project with submission_state: "Draft"
+   cf push          # Upload project files (state remains "Draft")
+   # ... make changes to your project ...
+   cf push          # Upload updated files (state remains "Draft")
+   ```
+
+2. **Review Phase (Optional):**
+   ```bash
+   cf pull          # Download results for review (if available)
+   cf view-tapeout-report  # Review the tapeout report (if available)
+   ```
+
+3. **Final Tapeout Confirmation:**
+   ```bash
+   cf confirm       # Confirm current GDS file is ready for foundry tapeout
+   ```
+
+**Important:** Only run `cf confirm` when you are completely satisfied with your GDS file and ready to send it to the foundry for tapeout processing. This action cannot be easily undone.
+
 ---
 
 ## How the GDS Hash Works
@@ -327,9 +447,15 @@ cf pull
 # ✓ All files downloaded to sftp-output/my_awesome_project
 # ✓ Project config automatically updated
 
-# View the tapeout report
+# Review the tapeout report (if available)
 cf view-tapeout-report
 # ✓ Opened tapeout report in browser: sftp-output/my_awesome_project/consolidated_reports/consolidated_report.html
+
+# When ready, confirm final tapeout (sends GDS to foundry)
+cf confirm
+# ✓ Updated project.json with submission_state = Final
+# ✓ Confirmed project submission: my_awesome_project
+# ✓ Uploaded project.json to incoming/projects/my_awesome_project/.cf/project.json
 ```
 
 ### Advanced Usage
@@ -350,6 +476,9 @@ cf pull --project-name other_project
 # View report for specific project
 cf view-tapeout-report --project-name other_project
 
+# Confirm final tapeout for specific project
+cf confirm --project-name other_project
+
 # View custom report file
 cf view-tapeout-report --report-path /path/to/custom_report.html
 
@@ -397,6 +526,12 @@ gds/user_project_wrapper.gds.gz   # ← Remove this one
   - Check that the report exists at the expected location
   - Use `--report-path` to specify a custom report location
 
+- **Repository update errors:**
+  - Check your internet connection
+  - Verify the repository and branch exist
+  - Use `--dry-run` to preview changes before applying them
+  - Check that the `.cf/repo.json` file exists in the upstream repository
+
 - **ModuleNotFoundError:**
   - Upgrade the CLI: `pip install --upgrade chipfoundry-cli`
 

{chipfoundry_cli-1.0.4 → chipfoundry_cli-1.1.0}/README.md

@@ -58,6 +58,11 @@ cf --help
    cf view-tapeout-report
    ```
 
+8. **Confirm final tapeout** (when ready to send GDS to foundry):
+   ```bash
+   cf confirm
+   ```
+
 ---
 
 ## Project Structure Requirements
@@ -71,6 +76,7 @@ Your project directory **must** contain:
   - **Note**: Both compressed (`.gz`) and uncompressed (`.gds`) files are supported
 - `verilog/rtl/user_defines.v` (required for digital/analog)
 - `.cf/project.json` (optional; will be created/updated automatically)
+  - Contains project metadata including `submission_state` ("Draft" or "Final")
 
 **Example:**
 ```
@@ -193,6 +199,23 @@ cf pull [--project-name NAME]
           └── consolidated_report.html
   ```
 
+### Confirm Final Tapeout
+
+```bash
+cf confirm [OPTIONS]
+```
+
+- **Confirms your final tapeout** by setting `submission_state` to "Final"
+- **Uploads only the project.json** to the SFTP server (not the entire project)
+- **Use this when you're ready to send your current GDS file to the foundry** for tapeout processing
+- **Options:**
+  - `--project-root`: Specify project directory
+  - `--project-name`: Override project name
+  - `--sftp-username`: Override configured username
+  - `--sftp-key`: Override configured key path
+
+**Important:** This command confirms that your current GDS file is ready to be sent to the foundry for tapeout. Only run this when you are completely satisfied with your design and ready for final tapeout processing. This action cannot be easily undone.
+
 ### View Tapeout Report
 
 ```bash
@@ -216,6 +239,102 @@ cf status
 - Shows which projects have input files and/or results
 - Displays project status in a clean table format
 
+### Repository Management
+
+#### Update Repository Files
+
+```bash
+cf repo update [OPTIONS]
+```
+
+- **Updates local project files** from the upstream GitHub repository
+- **Fetches configuration** from `.cf/repo.json` in the specified repository and branch
+- **Downloads and overwrites** local files based on the changes list in the configuration
+- **Saves configuration** locally to `.cf/repo.json` for reference
+
+**Options:**
+- `--project-root`: Specify project directory (defaults to current directory)
+- `--repo-owner`: GitHub repository owner (default: chipfoundry)
+- `--repo-name`: GitHub repository name (default: caravel_user_project)
+- `--branch`: Branch name containing the repo.json file (default: cli-update)
+- `--dry-run`: Preview changes without updating files
+
+**What happens:**
+1. Fetches `.cf/repo.json` from the specified GitHub repository and branch
+2. Downloads and saves the configuration file locally to `.cf/repo.json`
+3. Downloads and overwrites each file listed in the `changes` array
+4. Provides detailed feedback on success/failure of each file update
+
+**Example:**
+```bash
+# Preview what would be updated
+cf repo update --dry-run
+# Output:
+# Files that would be updated:
+#   • .cf/repo.json (configuration file)
+#   • README.md
+#   • Makefile
+#   • openlane/Makefile
+
+# Update files from upstream
+cf repo update
+# Output:
+# Update results:
+# ✓ Updated: .cf/repo.json
+# ✓ Updated: README.md
+# ✓ Updated: Makefile
+# ✓ Updated: openlane/Makefile
+# Successfully updated 4 file(s)
+# All files updated successfully!
+```
+
+**Use cases:**
+- Keep your project up-to-date with upstream changes
+- Apply bug fixes and improvements from the template repository
+- Sync configuration changes from the upstream project
+- Maintain consistency with the latest project structure
+
+---
+
+## Submission Workflow and States
+
+The CLI tracks your project submission state through the `submission_state` field in `project.json`:
+
+### Project States
+
+- **"Draft"** - Initial state when you run `cf init`
+  - Project is ready for development and testing
+  - You can push updates multiple times
+  - Project is not yet ready for tapeout processing
+
+- **"Final"** - Confirmed state when you run `cf confirm`
+  - GDS file is ready to be sent to the foundry for tapeout
+  - No further changes should be made to the design
+  - Only the project.json is uploaded (not the full project)
+
+### Recommended Workflow
+
+1. **Development Phase:**
+   ```bash
+   cf init          # Creates project with submission_state: "Draft"
+   cf push          # Upload project files (state remains "Draft")
+   # ... make changes to your project ...
+   cf push          # Upload updated files (state remains "Draft")
+   ```
+
+2. **Review Phase (Optional):**
+   ```bash
+   cf pull          # Download results for review (if available)
+   cf view-tapeout-report  # Review the tapeout report (if available)
+   ```
+
+3. **Final Tapeout Confirmation:**
+   ```bash
+   cf confirm       # Confirm current GDS file is ready for foundry tapeout
+   ```
+
+**Important:** Only run `cf confirm` when you are completely satisfied with your GDS file and ready to send it to the foundry for tapeout processing. This action cannot be easily undone.
+
 ---
 
 ## How the GDS Hash Works
@@ -303,9 +422,15 @@ cf pull
 # ✓ All files downloaded to sftp-output/my_awesome_project
 # ✓ Project config automatically updated
 
-# View the tapeout report
+# Review the tapeout report (if available)
 cf view-tapeout-report
 # ✓ Opened tapeout report in browser: sftp-output/my_awesome_project/consolidated_reports/consolidated_report.html
+
+# When ready, confirm final tapeout (sends GDS to foundry)
+cf confirm
+# ✓ Updated project.json with submission_state = Final
+# ✓ Confirmed project submission: my_awesome_project
+# ✓ Uploaded project.json to incoming/projects/my_awesome_project/.cf/project.json
 ```
 
 ### Advanced Usage
@@ -326,6 +451,9 @@ cf pull --project-name other_project
 # View report for specific project
 cf view-tapeout-report --project-name other_project
 
+# Confirm final tapeout for specific project
+cf confirm --project-name other_project
+
 # View custom report file
 cf view-tapeout-report --report-path /path/to/custom_report.html
 
@@ -373,6 +501,12 @@ gds/user_project_wrapper.gds.gz   # ← Remove this one
   - Check that the report exists at the expected location
   - Use `--report-path` to specify a custom report location
 
+- **Repository update errors:**
+  - Check your internet connection
+  - Verify the repository and branch exist
+  - Use `--dry-run` to preview changes before applying them
+  - Check that the `.cf/repo.json` file exists in the upstream repository
+
 - **ModuleNotFoundError:**
   - Upgrade the CLI: `pip install --upgrade chipfoundry-cli`
 

{chipfoundry_cli-1.0.4 → chipfoundry_cli-1.1.0}/chipfoundry_cli/main.py

@@ -4,7 +4,7 @@ from chipfoundry_cli.utils import (
     collect_project_files, ensure_cf_directory, update_or_create_project_json,
     sftp_connect, upload_with_progress, sftp_ensure_dirs, sftp_download_recursive,
     get_config_path, load_user_config, save_user_config, GDS_TYPE_MAP,
-    open_html_in_browser, download_with_progress
+    open_html_in_browser, download_with_progress, update_repo_files
 )
 import os
 from pathlib import Path
@@ -196,7 +196,7 @@ def init(project_root):
         project_type = console.input(f"Project type (digital/analog/openframe) (detected: [cyan]{gds_type}[/cyan]): ").strip() or gds_type
     else:
         project_type = console.input("Project type (digital/analog/openframe): ").strip()
-    version = console.input("Version (default 1.0.0): ").strip() or "1.0.0"
+    version = "1"  # Start with version 1, will be auto-incremented on push
     # No hash yet, will be filled by push
     data = {
         "project": {
@@ -204,7 +204,8 @@ def init(project_root):
             "type": project_type,
             "user": username,
             "version": version,
-            "user_project_wrapper_hash": ""
+            "user_project_wrapper_hash": "",
+            "submission_state": "Draft"
         }
     }
     with open(project_json_path, 'w') as f:
@@ -770,5 +771,184 @@ def view_tapeout_report(project_name, report_path):
         console.print(f"[red]Failed to open tapeout report in browser: {e}[/red]")
         raise click.Abort()
 
+@main.command('confirm')
+@click.option('--project-root', required=False, type=click.Path(exists=True, file_okay=False), help='Path to the local ChipFoundry project directory (defaults to current directory if .cf/project.json exists).')
+@click.option('--sftp-host', default=DEFAULT_SFTP_HOST, show_default=True, help='SFTP server hostname.')
+@click.option('--sftp-username', required=False, help='SFTP username (defaults to config).')
+@click.option('--sftp-key', type=click.Path(exists=True, dir_okay=False), help='Path to SFTP private key file (defaults to config).', default=None, show_default=False)
+@click.option('--project-name', help='Project name (e.g., "my_project"). Overrides project.json if exists.')
+def confirm(project_root, sftp_host, sftp_username, sftp_key, project_name):
+    """Confirm project submission by setting submission_state to Final and pushing project.json to SFTP."""
+    # If .cf/project.json exists in cwd, use it as default project_root and project_name
+    cwd_root, cwd_project_name = get_project_json_from_cwd()
+    if not project_root and cwd_root:
+        project_root = cwd_root
+    if not project_name and cwd_project_name:
+        project_name = cwd_project_name
+    if not project_root:
+        console.print("[bold red]No project root specified and no .cf/project.json found in current directory. Please provide --project-root.[/bold red]")
+        raise click.Abort()
+    
+    # Load user config for defaults
+    config = load_user_config()
+    if not sftp_username:
+        sftp_username = config.get("sftp_username")
+        if not sftp_username:
+            console.print("[bold red]No SFTP username provided and not found in config. Please run 'cf config' or provide --sftp-username.[/bold red]")
+            raise click.Abort()
+    if not sftp_key:
+        sftp_key = config.get("sftp_key")
+    
+    # Always resolve key_path to absolute path if set
+    if sftp_key:
+        key_path = os.path.abspath(os.path.expanduser(sftp_key))
+    else:
+        key_path = DEFAULT_SSH_KEY
+    
+    if not os.path.exists(key_path):
+        console.print(f"[red]SFTP key file not found: {key_path}[/red]")
+        console.print("[yellow]Please run 'cf keygen' to generate a key or 'cf config' to set a custom key path.[/yellow]")
+        raise click.Abort()
+
+    # Load and update project.json
+    project_json_path = Path(project_root) / '.cf' / 'project.json'
+    if not project_json_path.exists():
+        console.print(f"[red]Project configuration not found at {project_json_path}[/red]")
+        console.print("[yellow]Please run 'cf init' first to initialize your project.[/yellow]")
+        raise click.Abort()
+    
+    # Load existing project.json
+    try:
+        with open(project_json_path, 'r') as f:
+            project_data = json.load(f)
+    except Exception as e:
+        console.print(f"[red]Failed to read project.json: {e}[/red]")
+        raise click.Abort()
+    
+    # Set submission_state to Final
+    if "project" not in project_data:
+        project_data["project"] = {}
+    
+    project_data["project"]["submission_state"] = "Final"
+    
+    # Save updated project.json
+    try:
+        with open(project_json_path, 'w') as f:
+            json.dump(project_data, f, indent=2)
+        console.print("[green]✓ Updated project.json with submission_state = Final[/green]")
+    except Exception as e:
+        console.print(f"[red]Failed to update project.json: {e}[/red]")
+        raise click.Abort()
+    
+    # Get final project name for SFTP upload
+    final_project_name = project_name or project_data.get("project", {}).get("name")
+    if not final_project_name:
+        console.print("[red]No project name found in project.json. Please provide --project-name.[/red]")
+        raise click.Abort()
+    
+    # Connect to SFTP and upload project.json
+    console.print(f"Connecting to {sftp_host}...")
+    transport = None
+    try:
+        sftp, transport = sftp_connect(
+            host=sftp_host,
+            username=sftp_username,
+            key_path=key_path
+        )
+        # Ensure the project directory exists before uploading
+        sftp_project_dir = f"incoming/projects/{final_project_name}"
+        sftp_ensure_dirs(sftp, sftp_project_dir)
+    except Exception as e:
+        console.print(f"[red]Failed to connect to SFTP: {e}[/red]")
+        raise click.Abort()
+    
+    try:
+        # Upload only the project.json file
+        remote_path = os.path.join(sftp_project_dir, ".cf", "project.json")
+        upload_with_progress(
+            sftp,
+            local_path=str(project_json_path),
+            remote_path=remote_path,
+            force_overwrite=True  # Always overwrite for confirmation
+        )
+        console.print(f"[green]✓ Confirmed project submission: {final_project_name}[/green]")
+        console.print(f"[green]✓ Uploaded project.json to {remote_path}[/green]")
+        
+    except Exception as e:
+        console.print(f"[red]Upload failed: {e}[/red]")
+        raise click.Abort()
+    finally:
+        if transport:
+            sftp.close()
+            transport.close()
+
+@main.group('repo')
+def repo_group():
+    """Repository management commands."""
+    pass
+
+@repo_group.command('update')
+@click.option('--project-root', required=False, type=click.Path(exists=True, file_okay=False), help='Path to the local ChipFoundry project directory (defaults to current directory if .cf/project.json exists).')
+@click.option('--repo-owner', default='chipfoundry', help='GitHub repository owner (default: chipfoundry)')
+@click.option('--repo-name', default='caravel_user_project', help='GitHub repository name (default: caravel_user_project)')
+@click.option('--branch', default='cli-update', help='Branch name containing the repo.json file (default: cli-update)')
+@click.option('--dry-run', is_flag=True, help='Preview changes without updating files')
+def repo_update(project_root, repo_owner, repo_name, branch, dry_run):
+    """Update local repository files from upstream GitHub repository based on .cf/repo.json changes list."""
+    # If .cf/project.json exists in cwd, use it as default project_root
+    cwd_root, _ = get_project_json_from_cwd()
+    if not project_root and cwd_root:
+        project_root = cwd_root
+    if not project_root:
+        project_root = os.getcwd()
+    
+    console.print(f"[bold cyan]Updating repository files from {repo_owner}/{repo_name}@{branch}[/bold cyan]")
+    
+    try:
+        if dry_run:
+            console.print("[yellow]Dry run mode - no files will be modified[/yellow]")
+            # Fetch repo.json to show what would be updated
+            from chipfoundry_cli.utils import fetch_github_file
+            repo_json_content = fetch_github_file(repo_owner, repo_name, ".cf/repo.json", branch)
+            repo_data = json.loads(repo_json_content)
+            changes = repo_data.get("changes", [])
+            
+            console.print(f"[cyan]Files that would be updated:[/cyan]")
+            console.print(f"  • .cf/repo.json (configuration file)")
+            for file_path in changes:
+                console.print(f"  • {file_path}")
+        else:
+            # Perform the actual update
+            results = update_repo_files(project_root, repo_owner, repo_name, branch)
+            
+            if "error" in results:
+                console.print(f"[red]Failed to fetch repository information: {results['error']}[/red]")
+                raise click.Abort()
+            
+            # Display results
+            success_count = 0
+            failure_count = 0
+            
+            console.print(f"[cyan]Update results:[/cyan]")
+            for file_path, success in results.items():
+                if success:
+                    console.print(f"[green]✓ Updated: {file_path}[/green]")
+                    success_count += 1
+                else:
+                    console.print(f"[red]✗ Failed: {file_path}[/red]")
+                    failure_count += 1
+            
+            if success_count > 0:
+                console.print(f"[green]Successfully updated {success_count} file(s)[/green]")
+            if failure_count > 0:
+                console.print(f"[red]Failed to update {failure_count} file(s)[/red]")
+                raise click.Abort()
+            else:
+                console.print("[green]All files updated successfully![/green]")
+                
+    except Exception as e:
+        console.print(f"[red]Repository update failed: {e}[/red]")
+        raise click.Abort()
+
 if __name__ == "__main__":
     main() 

{chipfoundry_cli-1.0.4 → chipfoundry_cli-1.1.0}/chipfoundry_cli/utils.py

@@ -7,6 +7,7 @@ import hashlib
 import paramiko
 from rich.progress import Progress, BarColumn, TextColumn, TimeElapsedColumn, TaskProgressColumn
 import toml
+import httpx
 
 REQUIRED_FILES = {
     ".cf/project.json": False,  # Optional, may not exist
@@ -158,7 +159,7 @@ def update_or_create_project_json(
 ) -> str:
     """
     Update or create project.json in cf_dir. If existing_json_path is given, load and update it.
-    Otherwise, create a new one. Always update the user_project_wrapper_hash.
+    Otherwise, create a new one. Always update the user_project_wrapper_hash and auto-increment version.
     Returns the path to the updated/created project.json.
     """
     project_json_path = str(Path(cf_dir) / "project.json")
@@ -169,14 +170,37 @@ def update_or_create_project_json(
             data["project"] = {}
     else:
         data = {"project": {}}
+    
+    # Handle version auto-increment only if GDS hash changed
+    current_version = data["project"].get("version")
+    current_hash = data["project"].get("user_project_wrapper_hash", "")
+    
+    if current_version is None:
+        # No existing version, start with 1
+        new_version = "1"
+    elif current_hash != hash_val:
+        # GDS hash changed, increment version
+        try:
+            # Convert to int, increment, and convert back to string
+            version_num = int(current_version)
+            new_version = str(version_num + 1)
+        except (ValueError, TypeError):
+            # If version is not a valid integer, start from 1
+            new_version = "1"
+    else:
+        # GDS hash unchanged, keep same version
+        new_version = current_version
+    
     # Required fields with defaults
-    data["project"].setdefault("version", "1.0.0")
+    data["project"]["version"] = new_version
     data["project"]["user_project_wrapper_hash"] = hash_val
-    # Apply CLI overrides
-    for key in ["id", "name", "type", "user", "version"]:
+    
+    # Apply CLI overrides (but don't override auto-incremented version)
+    for key in ["id", "name", "type", "user"]:  # Removed "version" from CLI overrides
         cli_key = f"project_{key}" if key != "user" else "sftp_username"
         if cli_key in cli_overrides and cli_overrides[cli_key] is not None:
             data["project"][key] = cli_overrides[cli_key]
+    
     save_project_json(project_json_path, data)
     return project_json_path 
 
@@ -396,4 +420,97 @@ def open_html_in_browser(html_path: str):
     file_url = f"file://{urllib.parse.quote(abs_path)}"
     
     # Open in default browser
-    webbrowser.open(file_url) 
+    webbrowser.open(file_url)
+
+def fetch_github_file(repo_owner: str, repo_name: str, file_path: str, branch: str = "main") -> str:
+    """
+    Fetch a file from a GitHub repository using the GitHub API.
+    
+    Args:
+        repo_owner: GitHub repository owner (e.g., "chipfoundry")
+        repo_name: GitHub repository name (e.g., "caravel_user_project")
+        file_path: Path to the file in the repository (e.g., ".cf/repo.json")
+        branch: Branch name (default: "main")
+    
+    Returns:
+        File content as string
+    
+    Raises:
+        httpx.HTTPError: If the request fails
+    """
+    url = f"https://raw.githubusercontent.com/{repo_owner}/{repo_name}/{branch}/{file_path}"
+    
+    with httpx.Client() as client:
+        response = client.get(url)
+        response.raise_for_status()
+        return response.text
+
+def download_github_file(repo_owner: str, repo_name: str, file_path: str, local_path: str, branch: str = "main") -> bool:
+    """
+    Download a file from a GitHub repository and save it locally.
+    
+    Args:
+        repo_owner: GitHub repository owner
+        repo_name: GitHub repository name
+        file_path: Path to the file in the repository
+        local_path: Local path to save the file
+        branch: Branch name (default: "main")
+    
+    Returns:
+        True if successful, False otherwise
+    """
+    try:
+        content = fetch_github_file(repo_owner, repo_name, file_path, branch)
+        
+        # Ensure the local directory exists
+        os.makedirs(os.path.dirname(local_path), exist_ok=True)
+        
+        # Write the content to the local file
+        with open(local_path, 'w', encoding='utf-8') as f:
+            f.write(content)
+        
+        return True
+    except Exception:
+        return False
+
+def update_repo_files(project_root: str, repo_owner: str = "chipfoundry", repo_name: str = "caravel_user_project", branch: str = "cli-update") -> Dict[str, bool]:
+    """
+    Update local repository files based on the repo.json changes list.
+    
+    Args:
+        project_root: Local project root directory
+        repo_owner: GitHub repository owner
+        repo_name: GitHub repository name
+        branch: Branch name containing the repo.json file
+    
+    Returns:
+        Dictionary mapping file paths to success status
+    """
+    results = {}
+    
+    try:
+        # Fetch the repo.json file
+        repo_json_content = fetch_github_file(repo_owner, repo_name, ".cf/repo.json", branch)
+        repo_data = json.loads(repo_json_content)
+        
+        # Save the repo.json file to local .cf directory
+        cf_dir = os.path.join(project_root, ".cf")
+        os.makedirs(cf_dir, exist_ok=True)
+        local_repo_json_path = os.path.join(cf_dir, "repo.json")
+        
+        with open(local_repo_json_path, 'w', encoding='utf-8') as f:
+            f.write(repo_json_content)
+        results[".cf/repo.json"] = True
+        
+        changes = repo_data.get("changes", [])
+        
+        for file_path in changes:
+            local_file_path = os.path.join(project_root, file_path)
+            success = download_github_file(repo_owner, repo_name, file_path, local_file_path, branch)
+            results[file_path] = success
+            
+    except Exception as e:
+        # If we can't fetch the repo.json, return empty results
+        results["error"] = str(e)
+    
+    return results 

{chipfoundry_cli-1.0.4 → chipfoundry_cli-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "chipfoundry-cli"
-version = "1.0.4"
+version = "1.1.0"
 description = "CLI tool to automate ChipFoundry project submission to SFTP server"
 authors = ["ChipFoundry <marwan.abbas@chipfoundry.io>"]
 readme = "README.md"
@@ -15,6 +15,7 @@ click = ">=8.0.0,<9"
 rich = ">=13,<14"
 paramiko = ">=3.0.0,<4"
 toml = ">=0.10,<1.0"
+httpx = ">=0.24.0,<1.0"
 
 [tool.poetry.dev-dependencies]
 wheel = "*"
@@ -27,4 +28,4 @@ cf = "chipfoundry_cli.main:main"
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]
-build-backend = "poetry.core.masonry.api" 
+build-backend = "poetry.core.masonry.api"