fix: allow tsci push without entrypoint when circuit.json exists

AGENTS.md

@@ -80,3 +80,12 @@ Test fixture provides:
 ## Runtime
 
 The CLI entrypoint (`cli/entrypoint.js`) selects between Bun and tsx as the TypeScript runner, preferring Bun when available. This allows hot-reload during development while maintaining Node.js compatibility.
+# bump 1778256007
+# bump 1778299207
+# bump 1778342407
+# bump 1778385607
+# bump 1778515208
+# bump 1778558407
+# bump 1778601608
+# bump 1778644807
+# bump 1778688008

cli/build/register.ts

@@ -732,7 +732,16 @@ export const registerBuild = (program: Command) => {
           const entryFile = fileArgIsDirectFile
             ? resolvedFileArgPath
             : transpileEntrypoint
-          if (!entryFile) {
+          const isRealTsEntrypoint = Boolean(
+            entryFile &&
+              (entryFile.endsWith(".ts") || entryFile.endsWith(".tsx")),
+          )
+          if (
+            !entryFile ||
+            (hasConfiguredIncludeBoardFiles &&
+              !transpileExplicitlyRequested &&
+              !isRealTsEntrypoint)
+          ) {
             if (
               hasConfiguredIncludeBoardFiles &&
               !transpileExplicitlyRequested

cli/main.ts

@@ -17,7 +17,6 @@ import { registerCheckPinSpecification } from "./check/pin-specification/registe
 import { registerCheckPlacement } from "./check/placement/register"
 import { registerCheck } from "./check/register"
 import { registerCheckRoutingDifficulty } from "./check/routing-difficulty/register"
-import { registerCheckRouting } from "./check/routing/register"
 import { registerCheckSchematicPlacement } from "./check/schematic-placement/register"
 import { registerCheckTraceLength } from "./check/trace-length/register"
 import { registerClone } from "./clone/register"
@@ -85,7 +84,6 @@ registerCheckNetlist(program)
 registerCheckPinSpecification(program)
 registerCheckPlacement(program)
 registerCheckRoutingDifficulty(program)
-registerCheckRouting(program)
 registerCheckSchematicPlacement(program)
 registerCheckTraceLength(program)
 

lib/shared/get-entrypoint.ts

@@ -1,5 +1,6 @@
 import * as fs from "node:fs"
 import * as path from "node:path"
+import { globbySync } from "globby"
 import { loadProjectConfig } from "lib/project-config"
 import kleur from "kleur"
 
@@ -202,6 +203,27 @@ export const getEntrypoint = async ({
       }
     }
 
+    // No entrypoint found - check for circuit.json files as implicit entrypoints
+    // This allows `tsci push` to work the same as `tsci dev` which supports circuit.json files
+    const circuitJsonFiles = globbySync(
+      ["**/*.circuit.json", "**/circuit.json"],
+      {
+        cwd: validatedProjectDir,
+        ignore: ["**/node_modules/**", "**/dist/**"],
+      },
+    )
+      .map((f) => path.resolve(validatedProjectDir, f))
+      .filter(
+        (f) => fs.existsSync(f) && isValidDirectory(f, validatedProjectDir),
+      )
+      .sort()
+
+    if (circuitJsonFiles.length > 0) {
+      const chosenFile = path.relative(validatedProjectDir, circuitJsonFiles[0])
+      onSuccess(`Using circuit.json as implicit entrypoint: '${chosenFile}'`)
+      return circuitJsonFiles[0]
+    }
+
     onError(
       kleur.red(
         "No entrypoint found. Run 'tsci init' to bootstrap a basic project or specify a file with 'tsci push <file>'",

lib/shared/push-snippet.ts

@@ -30,6 +30,55 @@ type PushOptions = {
 
 const debug = Debug("tsci:push-snippet")
 
+const findPushProject = async ({
+  filePath,
+  onError,
+}: {
+  filePath?: string
+  onError: (message: string) => void
+}): Promise<{
+  snippetFilePath?: string
+  packageJsonPath?: string
+  projectDir: string
+} | null> => {
+  if (filePath) {
+    const snippetFilePath = await getEntrypoint({
+      filePath,
+      onSuccess: () => {},
+      onError,
+    })
+
+    if (!snippetFilePath) {
+      return null
+    }
+
+    const packageJsonPath = [
+      path.resolve(path.join(path.dirname(snippetFilePath), "package.json")),
+      path.resolve(path.join(process.cwd(), "package.json")),
+    ].find((candidatePath) => fs.existsSync(candidatePath))
+    const projectDir = packageJsonPath
+      ? path.dirname(packageJsonPath)
+      : path.dirname(snippetFilePath)
+
+    return { snippetFilePath, packageJsonPath, projectDir }
+  }
+
+  const projectDir = process.cwd()
+  const packageJsonPath = path.resolve(path.join(projectDir, "package.json"))
+  if (!fs.existsSync(packageJsonPath)) {
+    return { projectDir }
+  }
+
+  const snippetFilePath =
+    (await getEntrypoint({
+      projectDir,
+      onSuccess: () => {},
+      onError: () => {},
+    })) ?? undefined
+
+  return { snippetFilePath, packageJsonPath, projectDir }
+}
+
 const getArchivePayload = async (
   filePaths: string[],
   projectDir: string,
@@ -74,24 +123,16 @@ export const pushSnippet = async ({
     return onExit(1)
   }
 
-  // Detect the entrypoint file
-  const snippetFilePath = await getEntrypoint({
+  const pushProject = await findPushProject({
     filePath,
-    onSuccess: () => {},
     onError,
   })
 
-  if (!snippetFilePath) {
+  if (!pushProject) {
     return onExit(1)
   }
 
-  const packageJsonPath = [
-    path.resolve(path.join(path.dirname(snippetFilePath), "package.json")),
-    path.resolve(path.join(process.cwd(), "package.json")),
-  ].find((path) => fs.existsSync(path))
-  const projectDir = packageJsonPath
-    ? path.dirname(packageJsonPath)
-    : path.dirname(snippetFilePath)
+  const { snippetFilePath, packageJsonPath, projectDir } = pushProject
 
   if (!packageJsonPath) {
     onError(
@@ -110,7 +151,7 @@ export const pushSnippet = async ({
     }
   }
 
-  if (!fs.existsSync(snippetFilePath)) {
+  if (snippetFilePath && !fs.existsSync(snippetFilePath)) {
     onError(`File not found: ${snippetFilePath}`)
     return onExit(1)
   }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tscircuit/cli",
-  "version": "0.1.1296",
+  "version": "0.1.1357",
   "main": "dist/cli/main.js",
   "exports": {
     ".": "./dist/cli/main.js",
@@ -11,13 +11,13 @@
     "@biomejs/biome": "^1.9.4",
     "@tscircuit/circuit-json-placement-analysis": "^0.0.6",
     "@tscircuit/circuit-json-routing-analysis": "^0.0.1",
-    "@tscircuit/circuit-json-schematic-placement-analysis": "github:tscircuit/circuit-json-schematic-placement-analysis#d09c8d74f3085b29744bb0f1c9864c1154c69436",
+    "@tscircuit/circuit-json-schematic-placement-analysis": "github:tscircuit/circuit-json-schematic-placement-analysis#8e3b4dc434d342f6b9833777107fc66515d1480b",
     "@tscircuit/fake-snippets": "^0.0.182",
     "@tscircuit/file-server": "^0.0.32",
     "@tscircuit/image-utils": "^0.0.3",
     "@tscircuit/math-utils": "0.0.36",
     "@tscircuit/props": "^0.0.496",
-    "@tscircuit/runframe": "^0.0.1882",
+    "@tscircuit/runframe": "^0.0.1938",
     "@tscircuit/schematic-match-adapt": "^0.0.22",
     "@types/bun": "^1.2.2",
     "@types/configstore": "^6.0.2",
@@ -31,8 +31,8 @@
     "chokidar": "4.0.1",
     "circuit-json": "^0.0.403",
     "circuit-json-to-bom-csv": "^0.0.7",
-    "circuit-json-to-gerber": "^0.0.49",
-    "circuit-json-to-kicad": "^0.0.114",
+    "circuit-json-to-gerber": "^0.0.51",
+    "circuit-json-to-kicad": "^0.0.125",
     "circuit-json-to-pnp-csv": "^0.0.7",
     "circuit-json-to-readable-netlist": "^0.0.15",
     "circuit-json-to-spice": "^0.0.10",

tests/cli/push/push1-no-entrypoint.test.ts

@@ -1,17 +1,42 @@
 import { test, expect } from "bun:test"
 import { getCliTestFixture } from "../../fixtures/get-cli-test-fixture"
+import * as fs from "node:fs"
+import * as path from "node:path"
 
-test("should fail if no entrypoint file is found", async () => {
-  const { runCommand } = await getCliTestFixture()
-  try {
-    await runCommand("tsci push")
-  } catch (e) {
-    if (e instanceof Error) {
-      expect(e.message).toContain(
-        "No entrypoint found. Run 'tsci init' to bootstrap a basic project.",
-      )
-    } else {
-      throw e
-    }
-  }
+test("should fail if no package.json is found", async () => {
+  const { runCommand } = await getCliTestFixture({ loggedIn: true })
+  const { stderr, exitCode } = await runCommand("tsci push")
+
+  expect(exitCode).toBe(1)
+  expect(stderr).toBe(
+    "No package.json found, try running 'tsci init' to bootstrap the project\n",
+  )
 })
+
+test("should push a package without an entrypoint", async () => {
+  const { tmpDir, runCommand } = await getCliTestFixture({
+    loggedIn: true,
+  })
+
+  fs.writeFileSync(
+    path.resolve(tmpDir, "package.json"),
+    JSON.stringify({ name: "@tsci/test-user.test-package", version: "1.0.0" }),
+  )
+  fs.writeFileSync(
+    path.resolve(tmpDir, "tscircuit.config.json"),
+    JSON.stringify({ includeBoardFiles: ["**/*.circuit.json"] }),
+  )
+  fs.writeFileSync(
+    path.resolve(tmpDir, "prebuilt.circuit.json"),
+    JSON.stringify([{ type: "source_component", name: "U1" }]),
+  )
+
+  const { stdout, stderr, exitCode } = await runCommand("tsci push")
+
+  expect(exitCode).toBe(0)
+  expect(stderr).toBe("")
+  expect(stdout).toContain("⬆︎ package.json")
+  expect(stdout).toContain("⬆︎ prebuilt.circuit.json")
+  expect(stdout).toContain("⬆︎ tscircuit.config.json")
+  expect(stdout).toContain('"@tsci/test-user.test-package@1.0.0" published!')
+}, 30_000)

tests/get-entrypoint.test.ts

@@ -519,3 +519,49 @@ test("getEntrypoint warns when multiple common locations exist", async () => {
   expect(warnings[0]).toContain("Choosing 'index.tsx'")
   expect(warnings[0]).toContain("'src/index.tsx'")
 })
+
+test("getEntrypoint returns circuit.json as implicit entrypoint when no tsx/ts files exist", async () => {
+  const { tmpDir } = await getCliTestFixture()
+
+  // Create only a circuit.json file, no tsx/ts entrypoints
+  await fs.writeFile(
+    path.join(tmpDir, "prebuilt.circuit.json"),
+    JSON.stringify([{ type: "source_component", name: "U1" }]),
+  )
+
+  let onSuccessMessage = ""
+  const entrypoint = await getEntrypoint({
+    projectDir: tmpDir,
+    onSuccess: (msg) => {
+      onSuccessMessage = msg
+    },
+  })
+
+  expect(entrypoint).not.toBeNull()
+  expect(entrypoint).toBe(path.join(tmpDir, "prebuilt.circuit.json"))
+  expect(onSuccessMessage).toContain(
+    "Using circuit.json as implicit entrypoint",
+  )
+})
+
+test("getEntrypoint prefers tsx entrypoint over circuit.json", async () => {
+  const { tmpDir } = await getCliTestFixture()
+
+  // Create both a circuit.json and an index.tsx
+  await fs.writeFile(
+    path.join(tmpDir, "prebuilt.circuit.json"),
+    JSON.stringify([{ type: "source_component", name: "U1" }]),
+  )
+  await fs.writeFile(
+    path.join(tmpDir, "index.tsx"),
+    'export default () => <board width="10mm" height="10mm"></board>',
+  )
+
+  const entrypoint = await getEntrypoint({
+    projectDir: tmpDir,
+  })
+
+  // Should prefer the tsx file since it comes first in ALLOWED_ENTRYPOINT_NAMES
+  expect(entrypoint).not.toBeNull()
+  expect(entrypoint).toBe(path.join(tmpDir, "index.tsx"))
+})