@_linked/cli 1.7.0 → 1.8.1

package/.github/workflows/publish.yml

@@ -15,8 +15,20 @@ jobs:
       contents: write
       pull-requests: write
     steps:
+      # Author the changesets "Version Packages" PR as the org release App (not the default
+      # GITHUB_TOKEN) so its CI runs without a manual "Approve and run" gate. Requires the org
+      # App installed on this repo + org secrets RELEASE_APP_ID / RELEASE_APP_PRIVATE_KEY.
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -37,6 +49,6 @@ jobs:
           title: 'chore: release'
           commit: 'chore: release'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 1.8.1
+
+### Patch Changes
+
+- [#54](https://github.com/linked-cm/cli/pull/54) [`5d475c7`](https://github.com/linked-cm/cli/commit/5d475c718a5435ebf8d9ce0db358ebcb84a91642) Thanks [@flyon](https://github.com/flyon)! - `setup-publish` now generates publish workflows that author the changesets "Version Packages"
+  PR (and, for dual-branch, the post-release sync) via an org **GitHub App token**
+  (`actions/create-github-app-token`, org secrets `RELEASE_APP_ID` / `RELEASE_APP_PRIVATE_KEY`)
+  instead of the default `GITHUB_TOKEN` — so those PRs' checks run without a manual "Approve and
+  run" gate. The dual-branch template's version-only `sync-version-to-dev` job is replaced by a full
+  **back-merge `main -> dev`** (carrying the version bump, CHANGELOG, and changeset deletions, so dev
+  never re-releases consumed changesets). `--configure-github` also enables "Allow auto-merge" so the
+  back-merge PR self-merges once checks pass.
+
+## 1.8.0
+
+### Minor Changes
+
+- [#52](https://github.com/linked-cm/cli/pull/52) [`3b5d645`](https://github.com/linked-cm/cli/commit/3b5d645ac6f10851bc3aee055a9f312186fbf606) Thanks [@flyon](https://github.com/flyon)! - Four scaffolding/runtime fixes from first external-user feedback:
+  - **Template `src/package.ts` now imports from `@_linked/react/package`** instead of `@_linked/core/utils/Package`. Core's `LinkedPackageObject` doesn't expose `linkedComponent` / `linkedSetComponent` (they're React-only) — the old import caused `tsc` to error on a fresh scaffold the moment a user added their first shape. Requires `@_linked/react@>=1.3.1` (which fixed the recursion in `linkedPackage`).
+  - **`linked` CLI swapped `tsx` for a custom esbuild-based ESM loader** for TS/TSX user code. tsx hardcodes esbuild's default decorator emit (TC39 standard) and ignores `experimentalDecorators` in the user's tsconfig — silently breaking `@literalProperty` / `@objectProperty` / `@linkedShape` everywhere, since `@_linked/core` ships legacy-signature `(target, propertyKey, descriptor)` decorators. The new loader at `lib/esm/loaders/ts-loader.mjs` reads the user's `tsconfig.json`, force-enables `experimentalDecorators: true` in the esbuild `tsconfigRaw`, preserves import-attribute (`with { type: 'json' }`) syntax, and backfills extension-less relative imports. Net effect: legacy decorator emit just works, no esbuild-bundle workaround needed for scripts.
+  - **`create-app` now writes an empty `yarn.lock` in the new app**. Without it, Yarn climbs ancestor dirs looking for a project root and may decide an ancestor's stray `yarn.lock` is "the project" — aborting install with "the nearest package directory doesn't seem to be part of the project declared in <ancestor>".
+  - **Template `linked.backend.storage.ts` and `src/linked.frontend.storage.ts` use `with { type: 'json' }`** for the JSON dataset config imports, replacing the deprecated `assert { type: 'json' }` syntax (which Node 22+ rejects).
+
 ## 1.7.0
 
 ### Minor Changes

package/defaults/app-with-backend/linked.backend.storage.ts

@@ -3,7 +3,7 @@
 // Reads linked.backend.datasets.json, dynamically imports each alias's
 // store class via its npm path, and instantiates with the entry's `config`
 // verbatim. See the mirror at src/linked.frontend.storage.ts.
-import datasetsConfig from './linked.backend.datasets.json' assert { type: 'json' };
+import datasetsConfig from './linked.backend.datasets.json' with { type: 'json' };
 import { parseDatasetsConfig } from '@_linked/core/utils/parseDatasetsConfig';
 import { loadStores } from '@_linked/core/utils/loadStores';
 import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';

package/defaults/app-with-backend/src/linked.frontend.storage.ts

@@ -7,7 +7,7 @@
 //
 // Aliases on this side are independent from backend aliases — the
 // framework re-routes by shape on each side.
-import datasetsConfig from './linked.frontend.datasets.json' assert { type: 'json' };
+import datasetsConfig from './linked.frontend.datasets.json' with { type: 'json' };
 import { parseDatasetsConfig } from '@_linked/core/utils/parseDatasetsConfig';
 import { LinkedFileStorage } from '@_linked/core/utils/LinkedFileStorage';
 import { LinkedStorage } from '@_linked/core/utils/LinkedStorage';

package/defaults/app-with-backend/src/package.ts

@@ -1,4 +1,8 @@
-import { linkedPackage } from '@_linked/core/utils/Package';
+// Imports from `@_linked/react/package` (not `@_linked/core/utils/Package`)
+// because `linkedComponent` / `linkedSetComponent` are React-only — they
+// don't exist on core's LinkedPackageObject. The react helper composes
+// React-only fns on top of everything core's linkedPackage provides.
+import { linkedPackage } from '@_linked/react/package';
 
 export const {
   linkedComponent,

package/defaults/setup-publish/dual-branch/github/workflows/publish.yml

@@ -17,8 +17,20 @@ jobs:
       contents: write
       pull-requests: write
     steps:
+      # Author the changesets "Version Packages" PR as the org release App (not the default
+      # GITHUB_TOKEN) so its CI runs without a manual "Approve and run" gate. Requires the org
+      # App installed on this repo + org secrets RELEASE_APP_ID / RELEASE_APP_PRIVATE_KEY.
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -40,12 +52,16 @@ jobs:
           title: "chore: release"
           commit: "chore: release"
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}
           NPM_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}
 
-  sync-version-to-dev:
-    name: Sync Version to Dev
+  backmerge-to-dev:
+    # Full back-merge of main into dev after a release. Unlike a version-only sync, this also
+    # carries the CHANGELOG and — critically — the changeset *deletions* the release made, so dev
+    # never keeps already-released changesets that would otherwise re-release on the next dev->main.
+    # Requires "Allow auto-merge" enabled on the repo for the PR to self-merge once checks pass.
+    name: Back-merge main into dev
     needs: release
     if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
@@ -53,33 +69,43 @@ jobs:
       contents: write
       pull-requests: write
     steps:
-      - name: Checkout dev
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
+      - name: Checkout
         uses: actions/checkout@v4
         with:
-          ref: dev
           fetch-depth: 0
+          token: ${{ steps.app-token.outputs.token }}
 
-      - name: Sync package.json version from main via PR
+      - name: Open & auto-merge back-merge PR (main -> dev)
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
         run: |
-          MAIN_VERSION=$(git show origin/main:package.json | node -p "JSON.parse(require('fs').readFileSync(0,'utf8')).version")
-          DEV_VERSION=$(node -p "require('./package.json').version")
-          if [ "$MAIN_VERSION" != "$DEV_VERSION" ]; then
-            BRANCH="chore/sync-version-${MAIN_VERSION}"
-            git config user.name "github-actions[bot]"
-            git config user.email "github-actions[bot]@users.noreply.github.com"
-            git checkout -b "$BRANCH"
-            npm version "$MAIN_VERSION" --no-git-tag-version --allow-same-version
-            git add package.json package-lock.json
-            git commit -m "chore: sync package.json version to $MAIN_VERSION from main"
-            git push origin "$BRANCH"
-            gh pr create \
-              --base dev \
-              --head "$BRANCH" \
-              --title "chore: sync package.json version to $MAIN_VERSION from main" \
-              --body "Automated version sync from main after release."
+          git fetch origin main dev
+          # Nothing to do when dev already contains main.
+          if git merge-base --is-ancestor origin/main origin/dev; then
+            echo "dev already contains main — nothing to back-merge."
+            exit 0
+          fi
+          # Reuse an existing open back-merge PR if present, else open one.
+          pr=$(gh pr list --base dev --head main --state open --json number --jq '.[0].number // empty')
+          if [ -z "$pr" ]; then
+            url=$(gh pr create --base dev --head main \
+              --title "chore: back-merge main into dev (post-release sync)" \
+              --body "Automated post-release back-merge: brings the version bump, CHANGELOG, and changeset deletions from main into dev so dev stays clean and a future dev->main never re-releases consumed changesets.")
+            pr="${url##*/}"
+            echo "Opened back-merge PR #$pr"
+          else
+            echo "Reusing existing back-merge PR #$pr"
           fi
+          # Auto-merge once required checks pass (needs "Allow auto-merge" enabled on the repo).
+          gh pr merge "$pr" --auto --merge \
+            || echo "Auto-merge unavailable (disabled or conflicts) — PR #$pr left open for manual merge."
 
   dev-release:
     name: Publish Dev Release

package/defaults/setup-publish/github/workflows/publish.yml

@@ -15,8 +15,20 @@ jobs:
       contents: write
       pull-requests: write
     steps:
+      # Author the changesets "Version Packages" PR as the org release App (not the default
+      # GITHUB_TOKEN) so its CI runs without a manual "Approve and run" gate. Requires the org
+      # App installed on this repo + org secrets RELEASE_APP_ID / RELEASE_APP_PRIVATE_KEY.
+      - name: Generate GitHub App token
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_APP_ID }}
+          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
+
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          token: ${{ steps.app-token.outputs.token }}
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
@@ -37,6 +49,6 @@ jobs:
           title: 'chore: release'
           commit: 'chore: release'
         env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}
           NPM_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}

package/lib/cjs/cli-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAoE5C,eAAO,MAAM,SAAS,GAAU,SAAI,EAAE,iBAAwB,EAAE,UAAS;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAM,kBAgL9J,CAAC;AAmBF,wBAAgB,IAAI,CAAC,GAAG,QAAQ,OAAA,QAK/B;AACD,wBAAgB,QAAQ,CAAC,GAAG,MAAM,OAAA,QAIjC;AACD,wBAAgB,cAAc,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA,QAyB1C;AA2CD,wBAAgB,kCAAkC,CAChD,aAAa,KAAA,EACb,YAAY,EAAE,CACZ,YAAY,KAAA,EACZ,YAAY,KAAA,KACT,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,EAC1C,UAAU,KAAA,EACV,IAAI,UAAQ,GACX,OAAO,CAAC,IAAI,CAAC,CAqNf;AA+ID,wBAAgB,QAAQ,CAAC,OAAO,KAAA,QAkU/B;AAkCD,wBAAgB,gBAAgB,CAAC,QAAQ,SAAgB,GAAG,cAAc,EAAE,CAyB3E;AAyCD,eAAO,MAAM,cAAc,GACzB,WAAM,EACN,aAAQ,EACR,iBAAwB,kBA6FzB,CAAC;AAuIF,eAAO,MAAM,gBAAgB,GAAa,SAAI;;;;;CAc7C,CAAC;AAgBF;;GAEG;AACH,eAAO,MAAM,YAAY,cAaxB,CAAC;AACF,eAAO,MAAM,WAAW,GAAU,SAAI,EAAE,iBAAwB,kBA2B/D,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,SAAI,EAAE,iBAAwB,kBAmCtE,CAAC;AACF,eAAO,MAAM,eAAe,GAAU,SAAI,EAAE,iBAAwB,kBAuCnE,CAAC;AAKF,eAAO,MAAM,YAAY,GACvB,eAAc,MAA0B,EACxC,QAAO,MAAU,EAAE,wDAAwD;AAC3E,iBAAgB,GAAG,CAAC,MAAM,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAC,EAAE,CAAa,qBA4F9E,CAAC;AAEF,eAAO,MAAM,cAAc,qBAuB1B,CAAC;AACF,eAAO,MAAM,QAAQ,GAAU,cAAa,MAAsB,qBAwDjE,CAAC;AACF,eAAO,MAAM,uBAAuB,qBAoDnC,CAAC;AACF,eAAO,MAAM,SAAS,GACpB,YAAY,MAAM,EAClB,SAAS;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,mBAoB1B,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,aAAa,MAAM,EACnB,QAAQ,MAAM,EACd,SAAS;IAAC,KAAK,EAAE,OAAO,CAAA;CAAC,kBA2G1B,CAAC;AACF,eAAO,MAAM,WAAW,GACtB,WAAU,OAAe,EACzB,iBAAkB,iBA8DnB,CAAC;AACF,eAAO,MAAM,QAAQ,sBAKpB,CAAC;AACF,eAAO,MAAM,aAAa,qBAiHzB,CAAC;AACF,eAAO,MAAM,YAAY,wBAiExB,CAAC;AAEF,eAAO,MAAM,eAAe,qBAoK3B,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,SAAI,EACJ,aAAQ,EACR,iBAAwB,kBA4GzB,CAAC;AAqBF,eAAO,MAAM,QAAQ,GAAa,gBAAW,kBAuD5C,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,WAAM,EACN,YAAO,EACP,oBAA2B,EAC3B,aAAY,OAAc,iBAoN3B,CAAC;AACF,eAAO,MAAM,cAAc,GAAU,oBAA2B,kBAyB/D,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,oBAA2B,qBAWlE,CAAC;AACF,eAAO,MAAM,iBAAiB,GAAU,oBAA2B;;EAelE,CAAC;AAEF,eAAO,IAAI,cAAc,GAAa,OAAM,OAAe,kBA0K1D,CAAC;AAsBF,eAAO,IAAI,cAAc,GACvB,SAAI,EACJ,UAAK,EACL,UAAK,EACL,oBAAe,oBA6DhB,CAAC;AAEF,eAAO,IAAI,YAAY,GACrB,SAAI,EACJ,WAAM,EACN,YAAO,EACP,wBAAuB,OAAe,EACtC,OAAM,OAAe,kBAqHtB,CAAC;AAeF,eAAO,IAAI,4BAA4B,GACrC,aAAQ,EACR,YAAO,EACP,iBAAY,EACZ,gBAAW,qBA4CZ,CAAC;AAOF,eAAO,IAAI,cAAc,GAAa,aAAQ,EAAE,YAAO,SAMtD,CAAC;AACF,eAAO,IAAI,YAAY,GAAmB,iBAAwB,kBA8FjE,CAAC;AAEF,eAAO,IAAI,wBAAwB,GAAa,gBAAW,EAAE,YAAO,SA6BnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,gBAAW,qBA8B/C,CAAC"}

package/lib/cjs/cli-methods.js

@@ -165,6 +165,15 @@ const createApp = async (name, basePath = process.cwd(), options = {}) => {
     });
     fs_extra_1.default.renameSync(path_1.default.join(targetFolder, 'gitignore.template'), path_1.default.join(targetFolder, '.gitignore'));
     fs_extra_1.default.renameSync(path_1.default.join(targetFolder, 'yarnrc.yml.template'), path_1.default.join(targetFolder, '.yarnrc.yml'));
+    // Mark the new app as a self-contained Yarn project root. Without this,
+    // Yarn climbs ancestor dirs looking for the project root and may decide
+    // a stray yarn.lock further up the tree is "the project" — aborting
+    // install with "the nearest package directory doesn't seem to be part
+    // of the project declared in <ancestor>".
+    const yarnLockPath = path_1.default.join(targetFolder, 'yarn.lock');
+    if (!fs_extra_1.default.existsSync(yarnLockPath)) {
+        fs_extra_1.default.writeFileSync(yarnLockPath, '');
+    }
     // Seed the real (gitignored) Layer 2 config from the committed example so
     // the scaffolded app boots first try. Users can edit either file later.
     const datasetsExample = path_1.default.join(targetFolder, 'linked.backend.datasets.example.json');