Phase 0.3: @_linked/cli rename + setup-publish + build-workspace refactor

.changeset/README.md

@@ -0,0 +1,20 @@
+# Changesets
+
+This package uses [changesets](https://github.com/changesets/changesets) for version management and publishing.
+
+## Adding a changeset
+
+When making a change that should trigger a new release, run:
+
+```bash
+npx changeset
+```
+
+This generates a markdown file in `.changeset/` describing the change. Commit it with your PR.
+
+On merge to `main`, the publish workflow either:
+
+1. Creates (or updates) a **Release PR** that bumps the version + updates `CHANGELOG.md`, or
+2. If the Release PR is already merged, publishes the new version to npm.
+
+Changes that don't need a release (docs, CI config, tooling) can skip the changeset — the check is a warning, not a block.

.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "linked-cm/cli" }
+  ],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.changeset/phase-0-3-rename-and-publish-workflow.md

@@ -0,0 +1,17 @@
+---
+'@_linked/cli': minor
+---
+
+Phase 0.3 accumulated changes:
+
+- **New `linked setup-publish` command**: scaffolds a changesets-based publish workflow in any package repo. Supports single-branch (default) and `--dual-branch` (main + dev with `@next` prereleases). Patches package.json (publishConfig + changesets devDeps), generates package-lock.json in an isolated tmpdir, writes `.github/workflows/{ci,publish,changeset-check}.yml`, and optionally configures GitHub branch protection via `--configure-github` (uses `gh` CLI).
+- **`linked build-workspace` now invokes each package's own `yarn build` script** instead of the internal buildPackage pipeline. Lets @_linked/core use pure tsc, pure-CSS packages use no-ops, and lincd-style packages use `yarn linked build`.
+- **`linked yarn` (safeYarn) gains `LINKED_YARN_DRY_RUN` env** for testing arg forwarding without executing.
+- **Import checker is warn-only** (was fatal): emits yellow warnings listing missing `.js` extensions but doesn't abort the build.
+- **compilePackageESM/CJS** skip gracefully when tsconfig-{esm,cjs}.json is absent (pure-CSS packages).
+- **Dual-package step** uses `npx tsconfig-to-dual-package` so the binary resolves from nearest node_modules.
+- **runOnPackagesGroupedByDependencies**: tolerate packages without `dependencies` field.
+- **Package template modernized**: uses `yarn linked build` pattern (matches foundational packages), Gruntfile removed.
+- **App template**: adds `mrgit-template.json`, `yarn setup` script, `linkedApp: true` flag, `mrgit` devDep.
+- **`linkedPackage: true` / `linkedApp: true`** flags added to cli-methods readers (alongside legacy `lincd` / `lincdApp` for transition period).
+- **Bug fix**: lingering `lincd-server/*` imports in LincdServer.tsx migrated to `@_linked/server/*`.

.github/workflows/changeset-check.yml

@@ -0,0 +1,44 @@
+name: Changeset Check
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  changeset-check:
+    name: Check for changeset
+    # Skip the check on the automated Release PR.
+    if: ${{ github.head_ref != 'changeset-release/main' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check for changeset files
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: files } = await github.rest.pulls.listFiles({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.issue.number,
+            });
+
+            const hasChangeset = files.some(f =>
+              f.filename.startsWith('.changeset/') &&
+              f.filename.endsWith('.md') &&
+              f.filename !== '.changeset/README.md'
+            );
+
+            if (!hasChangeset) {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body: "No changeset found. If this PR should trigger a release, run `npx changeset` and commit the generated file.\n\nIf this change doesn't need a release (docs, CI config, etc.), you can ignore this message."
+              });
+              core.warning('No changeset file found in this PR.');
+            }

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build-and-test:
+    name: Build & Test
+    # Skip CI on the automated Release PR created by changesets/action.
+    if: ${{ !(github.event.pull_request.base.ref == 'main' && github.head_ref == 'changeset-release/main') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.16.0
+
+      - name: Install dependencies
+        run: npm ci --legacy-peer-deps
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test --if-present

.github/workflows/publish.yml

@@ -0,0 +1,42 @@
+name: Publish
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Publish Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.16.0
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci --legacy-peer-deps
+
+      - name: Build
+        run: npm run build
+
+      - name: Create release Pull Request or Publish
+        uses: changesets/action@v1
+        with:
+          publish: npx changeset publish
+          title: 'chore: release'
+          commit: 'chore: release'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

.gitignore

@@ -1,4 +1,12 @@
-node_modules
+node_modules/
+lib/
+yarn.lock
+.yarnrc.yml
 .idea
-lib
-.yarnrc.yml
+*.log
+.DS_Store
+
+# tsc sourcemap output — always in lib/, never src/.
+# (.d.ts not gitignored — hand-written type declarations like
+# src/plugins/colors.d.ts are legit sources.)
+src/**/*.js.map

CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to `@_linked/cli` (formerly `lincd-cli`) are documented here.
+
+This project follows [Keep a Changelog](https://keepachangelog.com/) and [Semantic Versioning](https://semver.org/).
+
+## [1.2.11] - 2026-04-22
+
+### Changed
+- **Renamed package**: `lincd-cli` → `@_linked/cli`. Repo moved from `semantu/lincd-cli` → `linked-cm/cli`.
+- **Primary binary** is now `linked` (with `lnk` as a short alias).
+- **Flag in package.json** is now `linkedPackage: true` (packages) / `linkedApp: true` (apps). The legacy flags `lincd: true` / `lincdApp: true` are still read for a transition period.
+- **Package template** (`defaults/package/`) no longer ships a `Gruntfile.js`. New packages use `rimraf + tsc + tsconfig-to-dual-package` for dual ESM/CJS output.
+- **App template** (`defaults/app-with-backend/`) now includes `mrgit-template.json`, a `yarn setup` script, and `mrgit` as a devDep. Run `yarn setup` after `linked create-app` to optionally clone sibling `@_linked/*` repos for local development.
+
+### Added
+- `linked build-workspace` — builds all linked packages in the current workspace in dependency order. Supports `-u` (updated only) and `--use-git` (git-based change detection). Migrated from `@semantu/cli`.
+- `linked build-package <filepath>` — given a file path, walks up to the nearest `package.json` and rebuilds that package. Designed for editor save hooks. Migrated from `@semantu/cli`.
+- `linked yarn <args>` — safe-yarn wrapper that preserves nested repo yarn.lock files during root-level yarn commands (for mrgit workflows). Migrated from `@semantu/cli`.
+
+### Deprecated
+- The `lincd` binary is retained as a deprecated alias that prints a warning to stderr on invocation. It will be removed in a future major release; migrate scripts to `linked`.
+- `generateGruntConfig` export has been removed; it had no active callers. If you still reference it, migrate your package build to `tsc + tsconfig-to-dual-package` (see the package template).
+
+### Removed
+- Grunt bin entry (`grunt`) removed from package.json bins.
+- Internal `config-grunt.cts` and `getGruntConfig` helper removed.
+- Grunt-related devDependencies (`grunt`, `grunt-cli`, `grunt-*`, `@lodder/grunt-postcss`, `load-grunt-tasks`) removed.
+
+### Migration notes
+- Update `package.json` deps: `lincd-cli` → `@_linked/cli`.
+- Update `package.json` flag: `lincd: true` → `linkedPackage: true` (and `lincdApp: true` → `linkedApp: true` for apps). Legacy flags still read for now.
+- Update scripts: `yarn lincd <cmd>` → `yarn linked <cmd>`. The legacy alias still works but emits a deprecation warning.
+- Update import paths: `lincd-cli/<module>` → `@_linked/cli/<module>`.

defaults/app-static/.env-cmdrc.json

@@ -0,0 +1,17 @@
+{
+  "app-main": {
+    "APP_ID": "com.yourdomain.www",
+    "APP_ENV": true,
+    "OUTPUT_PATH": "./web/assets",
+    "ASSET_PATH": "./assets/",
+    "ENTRY_PATH": "./src/index-static.tsx"
+  },
+  "app-local-android": {
+    "NODE_ENV": "app",
+    "SITE_ROOT": "http://10.0.2.2:4000"
+  },
+  "app-local-ios": {
+    "NODE_ENV": "app",
+    "SITE_ROOT": "http://localhost:4000"
+  }
+}

defaults/app-static/package.json

@@ -0,0 +1,8 @@
+{
+  "scripts": {
+    "app": "env-cmd -e _main,production,app-main node scripts/build.js && npx cap sync",
+    "app-local-ios": "env-cmd -e _main,development,app-main,app-local-ios node scripts/build.js && npx cap sync",
+    "app-local-android": "env-cmd -e _main,development,app-main,app-local-android node scripts/build.js && npx cap sync",
+    "app-staging": "env-cmd -e _main,staging,app-main,app-staging node scripts/build.js && npx cap sync"
+  }
+}

defaults/app-static/src/index-static.tsx

@@ -8,7 +8,7 @@ import {AppContextProvider} from 'lincd-server-utils/lib/components/AppContext';
 import './config-frontend';
 
 const root = ReactDOM.createRoot(
-  document.getElementById('root') as HTMLElement
+  document.getElementById('root') as HTMLElement,
 );
 
 root.render(
@@ -18,5 +18,5 @@ root.render(
         <App />
       </AppContextProvider>
     </BrowserRouter>
-  </React.StrictMode>
-);
+  </React.StrictMode>,
+);

defaults/app-with-backend/.env-cmdrc.json

@@ -1,20 +1,17 @@
 {
   "_main": {
-    "DATA_ROOT": "https://app.${hyphen_name}.com/data",
-    "APP_PREFIX": "${underscore_name}",
-    "APP_NAME": "${name}",
+    "DATA_ROOT": "https://${app_domain}/data",
+    "APP_PREFIX": "${app_prefix}",
+    "APP_NAME": "${app_name}",
     "SOURCE_PATH": "./src"
   },
   "development": {
     "NODE_ENV": "development",
     "SITE_ROOT": "http://localhost:4000"
   },
-  "staging": {
-    "NODE_ENV": "staging",
-    "SITE_ROOT": "https://next.${hyphen_name}.com"
-  },
   "production": {
+    "PORT": "4000",
     "NODE_ENV": "production",
-    "SITE_ROOT": "https://app.${hyphen_name}.com"
+    "SITE_ROOT": "https://${app_domain}"
   }
 }

defaults/app-with-backend/.eslintignore

@@ -1,3 +1,5 @@
 node_modules
 public
-build
+build
+data
+web

defaults/app-with-backend/gitignore.template

@@ -1,5 +1,6 @@
 node_modules
 build
+mrgit.json
 public/bundles
 data/uploads
 data/metadata

defaults/app-with-backend/lincd.config.js

@@ -1,7 +1,5 @@
-module.exports = {
-  cssMode: 'scss-modules',
-  cacheWebpack:true,
-  cssGlobalModulePaths:[/global-overwrites.scss/],
-  analyse:false,
-
+export default {
+  cssMode: 'tailwind',
+  cacheWebpack: true,
+  analyse: false,
 };

defaults/app-with-backend/mrgit-template.json

@@ -0,0 +1,3 @@
+{
+  "dependencies": {}
+}