`hs project dev` fails for projects with a colon in their name

[noerbot]

I'm having trouble getting the hs project dev command to work for 2025.2. Every time I run it, I get the following output (even after a successful upload/deployment):

Your project contains undeployed local changes.

Full output:

noahjeffrey@MacBookPro hs-dev-demo % hs project upload
✓ Uploaded HubSpot Developer Platform 2025.2: Aptitude 8 Demo project files to noerbot-a-8-app-dev [dev account] (48151768)

View build #18 in HubSpot: https://app.hubspot.com/developer-projects/48151768/project/HubSpot%20Developer%20Platform%202025.2:%20Aptitude%208%20Demo/activity/build/18

✓ Built HubSpot Developer Platform 2025.2: Aptitude 8 Demo #18
  ✓ Building card-HubSpotDeveloperPlatform2025.2Aptitude8Demo  ... DONE

  ✓ Building app-HubSpotDeveloperPlatform2025.2Aptitude8Demo  ... DONE

--------------------------------------------------
Build #18 succeeded. Automatically deploying to noerbot-a-8-app-dev [dev account] (48151768)


View deploy of build #18 in HubSpot: https://app.hubspot.com/developer-projects/48151768/project/HubSpot%20Developer%20Platform%202025.2:%20Aptitude%208%20Demo/activity/deploy/18

✓ Deployed build #18 in HubSpot Developer Platform 2025.2: Aptitude 8 Demo
  ✓ Deploying card-HubSpotDeveloperPlatform2025.2Aptitude8Demo  ... DONE

  ✓ Deploying app-HubSpotDeveloperPlatform2025.2Aptitude8Demo  ... DONE

noahjeffrey@MacBookPro hs-dev-demo % hs project dev   
HubSpot projects local development
Learn more about HubSpot projects local dev: https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server | HubSpot account types: https://developers.hubspot.com/docs/getting-started/account-types

Using default account noerbot-a-8-app-dev [dev account] (48151768) for project upload

✔ [--testing-account] Choose the type of account to test on <! Test on your project account: noerbot-a-8-app-dev [dev account] (48151768) !>

✖ Your project contains undeployed local changes.

Run `hs project upload ` to upload these changes to HubSpot, then re-run `hs project dev ` to continue local development.

I can also see the app successfully built and deployed via the HS UI:

I confirmed there are no local changes in my dev environment following the upload.

I used this backend locally to install the app on that same account: https://github.com/hubspot/oauth-quickstart-nodejs

And I can see that it was installed through the UI:

Furthermore, I can see my most recent changes to the app card deployed:

So something is wonky here. I tried debugging this myself, but I don't have access to the CLI v7.7.0 code (as mentioned in #1556) so I can't. :(

Oh, and here's my app-hsmeta.json:

{
  "uid": "app-HubSpotDeveloperPlatform2025.2Aptitude8Demo",
  "type": "app",
  "config": {
    "description": "An example for Aptitude 8 to demonstrate how to build a HubSpot marketplace app with developer projects.",
    "name": "HubSpot Developer Platform 2025.2: Aptitude 8 Demo-Application",
    "distribution": "marketplace",
    "auth": {
      "type": "oauth",
      "redirectUrls": [
        "http://localhost:3000/oauth-callback"
      ],
      "requiredScopes": [
        "crm.objects.contacts.read",
        "crm.objects.contacts.write",
        "forms",
        "oauth"
      ],
      "optionalScopes": [],
      "conditionallyRequiredScopes": []
    },
    "permittedUrls": {
      "fetch": [
        "https://api.hubapi.com/",
        "https://pokeapi.co/"
      ],
      "iframe": [],
      "img": []
    },
    "support": {
      "supportEmail": "njeffrey@aptitude8.com",
      "documentationUrl": "https://docs.google.com/document/d/16EVdGYieEMR7DPqeAZO4UUW819BciyOEVsGJzMbdipo/edit?usp=sharing",
      "supportUrl": "https://aptitude8.com/contact-us",
      "supportPhone": "+13129123503"
    }
  }
}

Based on my analysis of the v7.5.4 code, there may be a case sensitivity or similar issue with the comparison between local and deployed names. But without having access to the v7.7.0 code, there's not much I can do here. Hoping someone else can jump in to help unblock me here! 🙏

[noerbot]

Figured out the issue here thanks to @brandenrodgers releasing the v7.7.0 code! In short, my project name had a colon (:) in it.

Here's the full summary by Claude Sonnet 4:

The issue was exactly what I suspected - a file path mismatch caused by filename sanitization. Your project name "HubSpot Developer Platform 2025.2: Aptitude 8 Demo" contains a colon : which gets sanitized differently during extraction vs. when the code tries to access the files.

What was happening:
The CLI downloads a zip of your deployed project
Extracts it to a temp directory, but the extraction process sanitizes the project name differently than expected
Tries to access the source files using the "expected" sanitized path
Fails because the actual extracted directory has a different name
Returns false due to the file system error, triggering the "undeployed changes" message
The fix:
Instead of assuming the extracted directory name matches the sanitized filename, the code now:

Checks what actually got extracted
Uses the real directory name that was created
Proceeds with the correct path
Your projects were probably identical all along - it was just a path resolution bug!

Now you should be able to run [hs project dev](vscode-file://vscode-app/Applications/Visual%20Studio%20Code%20-%20Insiders.app/Contents/Resources/app/out/vs/code/electron-browser/workbench/workbench.html) without the false positive about undeployed changes. This was a tricky one to track down, but the debug logging made all the difference in identifying the root cause.

Thanks for being patient with all the debugging steps! 🚀

I'll open a PR with the fix for that in the next couple days! At least now I'm unblocked for local development!

[noerbot]

@brandenrodgers I opened a PR with a fix for this issue here: #1559

[brandenrodgers]

Hi @noerbot - we've somewhat recently updated our repo to be issues-only, but I can get that fix into our internal project and released for you. Thanks for taking the time to spin up a solution for it! That makes my job way easier 😄