@_linked/cli 1.38.0 → 1.40.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.40.0
+
+### Minor Changes
+
+- [#211](https://github.com/linked-fw/cli/pull/211) [`c268b22`](https://github.com/linked-fw/cli/commit/c268b22efc68384470e90dc391729dcf5911d185) Thanks [@flyon](https://github.com/flyon)! - `linked localize` now leaves one copy of each framework package. A checkout's install leaves its own `@_linked/core` (pinned by the checkout's lockfile, often older than the app's) and a registry copy of any localized sibling in its `node_modules`, and plain Node and `tsx` loaded those: measured with three localized linked packages, three cores in one process, and a localized package that never saw its localized sibling. `@_linked/localize` 0.3.0 removes a checkout's copies of what the app provides after every install and on every `--relink`; this CLI requires it and tells it what the app provides: the linked packages it has installed (by their `linkedPackage` flag, not their scope), `react` and `react-dom`. A copy is removed only when the app's version satisfies the checkout's range (a localized sibling always counts); otherwise it is kept, with a warning. Measured afterwards: one core in Node, `tsx` and Vite SSR, and every checkout still builds — `npx linked build` in a checkout runs the app's `linked` — and passes its tests. `--no-prune` turns it off.
+
+### Patch Changes
+
+- [#211](https://github.com/linked-fw/cli/pull/211) [`01d3dc0`](https://github.com/linked-fw/cli/commit/01d3dc02b68245b79e1bb2855e96f969d5942026) Thanks [@flyon](https://github.com/flyon)! - The dev resolver registers every localized package as source, including one that another localized package depends on. The dependency walk used to key "visited" on the package name and go depth-first, so reaching a checkout's own `node_modules` copy of a sibling (a lib-only registry install) first hid the app's localized checkout of that sibling: Vite served it from `lib/`, and the depending checkout's imports went to its nested copy. The walk is now breadth-first and keyed on the installed directory.
+
+- [#211](https://github.com/linked-fw/cli/pull/211) [`c268b22`](https://github.com/linked-fw/cli/commit/c268b22efc68384470e90dc391729dcf5911d185) Thanks [@flyon](https://github.com/flyon)! - `createViteConfig` dedupes what localization can duplicate, in every mode: every localized package (from `local-packages.json`), every runtime dependency a localized checkout declares that the app has at a version satisfying that checkout's range, and `react`/`react-dom`. Before, it deduped only `@_linked/server-utils` and `@_linked/react`, and only in a standalone app, so an app with a localized package had Vite resolve `@_linked/core` from that checkout's own `node_modules`: its dev SSR backend loaded one core per copy (three, measured). A dependency whose range the app does not satisfy is left out and reported in the dev log, and so is a name a registry install nests its own copy of, because a dedupe hands every importer the app's copy without checking versions. A standalone app's `optimizeDeps.exclude` now picks linked packages by their `linkedPackage` flag rather than the `@_linked/` scope, and the legacy `lincd: true` flag is no longer read anywhere.
+
+## 1.39.0
+
+### Minor Changes
+
+- [#199](https://github.com/linked-fw/cli/pull/199) [`dfdb1c5`](https://github.com/linked-fw/cli/commit/dfdb1c50547bab428540db149afb4b106c9f0c5c) Thanks [@flyon](https://github.com/flyon)! - `create-package` chooses where a package lives inside an app: `packages/` (part of the app's repository: a workspace member, added to its dependencies and installed at the app root) or `packages-local/` (its own git repository, under `linked localize`'s name for it, with `git init`, a first commit, an optional `--remote` and `--push`, then installed, built, linked and recorded by `linked localize --adopt`). Choose with `--location`, `--remote` and `--push`; with none of them you are asked, on a terminal only. An existing target folder is refused. Outside an app nothing changes.
+
+  `linked localize --adopt` links a checkout already in `packages-local/` without cloning it, and `build-all` builds packages recorded in `local-packages.json` even when the app does not declare them yet. Needs `@_linked/localize` 0.2.0.
+
 ## 1.38.0
 
 ### Minor Changes

package/README.md

@@ -8,13 +8,16 @@ Command-line tools for the `@_linked/*` packages and apps.
 npm install --save-dev @_linked/cli
 ```
 
-## Binaries
+## Binary
 
-Three executables ship in this package:
+One executable ships in this package: `linked`. (`lnk`, `lincd` and `lincd-cli` were dropped in
+[#40](https://github.com/linked-fw/cli/pull/40).)
 
-- `linked` — primary command
-- `lnk` — short alias for `linked`
-- `lincd` — deprecated alias; prints a warning and forwards to `linked`. Will be removed in a future major release.
+In a project that has `@_linked/cli` installed — any linked app, including Create Now — run it as
+`npx linked <command>`. Everywhere else, name the package: `npx @_linked/cli <command>`.
+A bare `npx linked` outside such a project does **not** reach this CLI: npm resolves it to the
+unrelated `linked` package on the registry, which has no binary, and fails with
+`could not determine executable to run`.
 
 ## Commands
 
@@ -24,11 +27,31 @@ Run `linked --help` for the full list. The commonly used ones:
 
 ```bash
 linked create-app <name>          # scaffold a new app (interactive)
-linked create-package <name>      # scaffold a new linkedPackage
+linked create-package <name>      # scaffold a new linkedPackage (see below for where it goes)
 linked create-shape <name>        # add a shape file to the current package
 linked create-component <name>    # add a React component file
 ```
 
+Inside an app (a `package.json` with `"linkedApp": true` above the current directory),
+`create-package` puts the package in one of two places, and asks which on a terminal:
+
+```bash
+linked create-package @_linked/foo --location packages        # part of the app's repository
+linked create-package @_linked/foo --location packages-local  # a repository of its own
+linked create-package @_linked/foo --remote <git-url> [--push] # the same, with an origin
+```
+
+- `packages/foo` — a workspace member: added to the app's `dependencies` (and `packages/*` to its
+  `workspaces` if missing), installed at the app root.
+- `packages-local/_linked-foo` — the name `linked localize` uses. `git init` and a first commit,
+  `origin` and `repository.url` from `--remote`, pushed with `--push`; then installed, built,
+  linked and recorded by `linked localize --adopt`. It is not added to the app's `dependencies`
+  until it is published. `--remote` or `--push` imply this location.
+
+Any of the three flags skips the question. With none of them and no terminal, it exits 1 and says
+which flag to pass. An existing target folder is refused. Outside an app nothing changes: the
+package goes in `./packages/`, `./modules/` or the current directory, and installs on its own.
+
 ### Building
 
 ```bash
@@ -214,10 +237,18 @@ linked localize @_linked/rdfs     # clone, install, build, symlink into node_mod
 linked localize                   # report what is localized (same as --list)
 linked localize --list --check    # exit 1 when something recorded is not actually linked
 linked localize --relink          # recreate the recorded symlinks — run this from postinstall
+linked localize @_linked/rdfs --adopt  # link a checkout already in packages-local/_linked-rdfs, no clone
 linked delocalize @_linked/rdfs   # unlink and forget, keeping the checkout
 linked delocalize --purge         # undo everything and delete the checkouts
 ```
 
+Checkouts go in `packages-local/` under the npm name with the scope flattened:
+`@_linked/rdfs` → `packages-local/_linked-rdfs`.
+
+`npm install <name>` — with a package name — does not run the app's own `postinstall`, so it
+replaces every localized link with the registry copy and prunes the checkouts' dependencies,
+silently. Run `linked localize --relink` after it (a bare `npm install` runs the hook itself).
+
 Name packages exactly as npm names them (`@_linked/rdfs`, `lodash`): the
 repository is read from the package's published `repository` field, so there is
 no short-name expansion and no org guessing. `--dir` moves the checkout
@@ -226,9 +257,42 @@ published metadata does not point at the right place, and `--build "<cmd>"`
 replaces `linked build` (an empty string builds nothing). A failing build only
 warns — a package whose build is broken is usually why you localized it.
 
+**One copy of each framework package.** A checkout's own install leaves its own
+`@_linked/core` (pinned by the checkout's lockfile, often older than the app's)
+and a registry copy of any localized sibling in its `node_modules`, and Node
+loads those instead of the app's. So after installing, and on every `--relink`,
+`linked localize` removes from every checkout's `node_modules` its own copy of
+a linked package the app has installed, `react` and `react-dom` (plus its
+peerDependencies) when the app has a version that satisfies the checkout's range; a localized sibling always
+counts. A copy the app's version does not satisfy is kept, with a warning naming
+the package, the range and the app's version. The checkout still builds and runs
+its tests, resolving those packages from the app — this CLI included: npm puts
+every ancestor's `node_modules/.bin` on the `PATH`, so `npx linked build` in a
+checkout runs the app's `linked`. `--no-prune` keeps every checkout's
+`node_modules` as npm left it. The
+A linked package is one whose `package.json` says `"linkedPackage": true` — the
+definition `build-all` and `linked build` use — whatever its npm scope;
+`@_linked/localize`, a plain tool, is not one.
+
+The dev server gets the same guarantee from Vite's `resolve.dedupe`, which
+`createViteConfig` derives from what is localized: the localized packages
+themselves, plus every runtime dependency a localized checkout declares that the
+app has at a version satisfying the checkout's range, plus React. A dependency
+whose range the app does not satisfy keeps the checkout's own copy (the dev log
+says which), and so does a name some registry install nests its own copy of —
+a dedupe hands every importer the app's copy without checking versions. With
+nothing localized, only React is deduped. The dedupe covers what Vite loads; the
+removal on disk covers plain Node, `tsx` and test runners, which never read it.
+
 The work is done by [`@_linked/localize`](https://www.npmjs.com/package/@_linked/localize),
-which is dependency-free and framework-agnostic; this CLI only supplies the
-build command.
+which is dependency-free and framework-agnostic; this CLI supplies the
+build command and the list of what an app provides. That package's own binary, `linked-localize`, is the same mechanism with
+three differences: it builds nothing unless given `--build "<cmd>"`, it treats only localized
+siblings and peerDependencies as provided unless given `--provided "<name>,…"`,
+and its verbs are subcommands —
+`linked-localize adopt <pkg>` and `linked-localize remove <pkg>` where this CLI has
+`linked localize --adopt <pkg>` and `linked delocalize <pkg>`. In a linked app, use
+`linked localize`.
 
 ### Registry / dev utilities
 

package/defaults/app-react-native/docker-compose.yml

@@ -2,7 +2,7 @@
 # `npm run fuseki:up` starts it and waits for the healthcheck; `npm run fuseki:down` stops it (data persists).
 services:
   fuseki:
-    image: secoresearch/fuseki:5.5.0
+    image: secoresearch/fuseki:5.6.0
     ports:
       # Override the host port when 3030 is taken (another project's Fuseki); set FUSEKI_BASE_URL to match.
       - "${FUSEKI_PORT:-3030}:3030"

package/lib/esm/cli-methods.d.ts

@@ -1,3 +1,4 @@
+import type { CreatePackageOptions } from './utils/createPackageLocation.js';
 import type { PackageDetails } from './interfaces.js';
 /**
  * Dynamically import the app's backend storage configuration. Tries the
@@ -130,7 +131,7 @@ export declare const startServer: (initOnly?: boolean, ServerClass?: any) => Pro
  */
 export declare const buildBackend: () => Promise<boolean>;
 export declare const upgradePackages: () => Promise<void>;
-export declare const createPackage: (name: any, uriBase?: any, basePath?: string) => Promise<void>;
+export declare const createPackage: (name: any, uriBase?: any, basePath?: string, options?: CreatePackageOptions) => Promise<void>;
 export declare const register: (registryURL: any) => Promise<void>;
 export declare const buildPackage: (target: any, target2: any, packagePath?: string, logResults?: boolean) => Promise<boolean>;
 type BuildStep = {

package/lib/esm/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":"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"}

package/lib/esm/cli-methods.js

@@ -17,12 +17,13 @@ import { createInterface } from 'readline';
 import { debugInfo, execp, execPromise, getFileImports, getFiles, getLastCommitTime, getPackageJSON, isImportOutsideOfPackage, isInternalLinkedImport, needsRebuilding, } from './utils.js';
 import { renameShippedDotfiles } from './utils/shippedDotfiles.js';
 import { planPackageSetup } from './utils/packageSetup.js';
+import { bareName, CreatePackageError, decideCreatePackageTarget, ensureRelinkPostinstall, ensureWorkspaceGlob, findLinkedAppRoot, RELINK_COMMAND, repositoryUrlFor, } from './utils/createPackageLocation.js';
 import { detectPackageManager, execBinCommand, runScriptCommand, } from './utils/packageManager.js';
 import { rewriteExtensionlessImports } from './utils/esmSpecifiers.js';
 import { checkShapeNames } from './utils/shapeNames.js';
 import { checkShapeReferences, inspectShapeReferences, } from './utils/shapeReferences.js';
 import { checkShapesIndex, checkShapesSideEffects } from './utils/shapesIndex.js';
-import { spawn as spawnChild } from 'child_process';
+import { spawn as spawnChild, spawnSync } from 'child_process';
 import { findNearestPackageJson } from 'find-nearest-package-json';
 import { statSync } from 'fs';
 // import pkg from 'lincd/utils/LinkedFileStorage';
@@ -1833,45 +1834,64 @@ export const upgradePackages = () => __awaiter(void 0, void 0, void 0, function*
     // })
     // });
 });
-export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0, [name_1, uriBase_1, ...args_1], void 0, function* (name, uriBase, basePath = process.cwd()) {
+export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0, [name_1, uriBase_1, ...args_1], void 0, function* (name, uriBase, basePath = process.cwd(), options = {}) {
     if (!name) {
         console.warn('Please provide a name as the first argument');
         return;
     }
-    //if ran with npx, basePath will be the root directory of the repository, even if we're executing from a sub folder (the root directory is where node_modules lives and package.json with workspaces)
-    //so we manually find a packages folder, if it exists we go into that.
-    if (fs.existsSync(path.join(basePath, 'packages'))) {
-        basePath = path.join(basePath, 'packages');
+    const appRoot = findLinkedAppRoot(basePath);
+    const decided = decideCreatePackageTarget({
+        appRoot,
+        options,
+        isTTY: !!(process.stdin.isTTY && process.stdout.isTTY),
+    });
+    if (decided.kind === 'refuse')
+        throw new CreatePackageError(decided.message);
+    const decision = decided.kind === 'ask' ? yield askPackageLocation(name) : decided;
+    //let's remove scope for variable names
+    const cleanPackageName = bareName(name);
+    let targetFolder;
+    if (decision.kind === 'outside') {
+        //if ran with npx, basePath will be the root directory of the repository, even if we're executing from a sub folder (the root directory is where node_modules lives and package.json with workspaces)
+        //so we manually find a packages folder, if it exists we go into that.
+        if (fs.existsSync(path.join(basePath, 'packages'))) {
+            basePath = path.join(basePath, 'packages');
+        }
+        //for lincd.org currently packages are stored in the modules folder
+        else if (fs.existsSync(path.join(basePath, 'modules'))) {
+            basePath = path.join(basePath, 'modules');
+        }
+        targetFolder = path.join(basePath, cleanPackageName);
     }
-    //for lincd.org currently packages are stored in the modules folder
-    else if (fs.existsSync(path.join(basePath, 'modules'))) {
-        basePath = path.join(basePath, 'modules');
+    else if (decision.location === 'packages') {
+        targetFolder = path.join(appRoot, 'packages', cleanPackageName);
+    }
+    else {
+        // localize's own naming, so `linked localize` and this command can never
+        // disagree about where a package lives.
+        const { checkoutNameFor, DEFAULT_DIR } = yield import('@_linked/localize');
+        targetFolder = path.join(appRoot, DEFAULT_DIR, checkoutNameFor(name));
+    }
+    if (fs.existsSync(targetFolder)) {
+        throw new CreatePackageError(`${targetFolder} already exists. Refusing to write a new package over it.`);
     }
-    //let's remove scope for variable names
-    let [packageName, scope, cleanPackageName] = name.match(/(@[\w\-]+\/)?([\w\-]+)/);
-    let targetFolder = ensureFolderExists(basePath, cleanPackageName);
     if (!uriBase) {
         uriBase = defaultOntologyNamespace(name);
     }
     setVariable('uri_base', asNamespace(uriBase));
-    //find @scope and the next part between 2 slashes after
-    //so @dacore/some-mod/lib/file.js
-    // --> match[0] = @dacore/some-mod
-    // --> match[1] = @dacore
-    // --> match[2] = some-mod
-    //but save full scoped package name under ${package_name}
+    //save the full scoped package name under ${package_name}
     setVariable('package_name', name);
     //extra variable for clarity (will be same as 'name')
     setVariable('output_file_name', name);
-    let { hyphenName, camelCaseName, underscoreName } = setNameVariables(cleanPackageName);
+    const { hyphenName } = setNameVariables(cleanPackageName);
     log("Creating new linked package '" + name + "'");
+    fs.mkdirSync(targetFolder, { recursive: true });
     fs.copySync(path.join(getScriptDir(), '..', '..', 'defaults', 'package'), targetFolder);
     renameShippedDotfiles(targetFolder);
     //replace variables in some of the copied files
     yield Promise.all([
         'src/index.ts',
         'package.json',
-        'Gruntfile.js',
         'src/package.ts',
         'src/ontologies/example-ontology.ts',
         'src/ontologies/example-ontology.register.ts',
@@ -1898,37 +1918,189 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
         console.log('rename ', path.join(targetFolder, f), path.join(targetFolder, ...newParts, newName));
         fs.renameSync(path.join(targetFolder, f), path.join(targetFolder, ...newParts, newName));
     });
-    // npm is the default for a new package. yarn is only consulted when the new
-    // package lands inside an existing yarn project (a yarn-3 monorepo),
-    // where adding an npm lockfile would break the workspace.
-    const insideYarnProject = detectPackageManager(path.dirname(path.resolve(targetFolder))) === 'yarn';
-    let version = insideYarnProject
-        ? (yield execPromise('yarn --version').catch(() => {
-            console.log('yarn probably not working');
-            return '';
-        }))
-        : '';
-    const setup = planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'), process.execPath, insideYarnProject);
-    if (setup.yarnrc) {
-        fs.writeFileSync(path.join(targetFolder, '.yarnrc.yml'), setup.yarnrc);
-    }
-    const installed = yield execp(setup.installCommand, true, false, {
-        cwd: targetFolder,
-    })
-        .then(() => true)
-        .catch(() => {
-        console.warn(`Could not install dependencies (${setup.installCommand})`);
-        process.exitCode = 1;
-        return false;
+    if (decision.kind === 'outside') {
+        yield installStandalonePackage(targetFolder);
+    }
+    else if (decision.location === 'packages') {
+        yield installWorkspacePackage(name, targetFolder, appRoot);
+    }
+    else {
+        yield installOwnRepoPackage(name, targetFolder, appRoot, decision);
+    }
+});
+/**
+ * Ask where a new package goes — only ever on a terminal, and only when no
+ * flag said so already.
+ */
+function askPackageLocation(name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        console.log(`\nWhere should ${chalk.magenta(name)} live?\n` +
+            `  1) packages/        part of this app's repository\n` +
+            `  2) packages-local/  its own git repository, linked into this app\n`);
+        let answer = '';
+        while (answer !== '1' && answer !== '2') {
+            answer = yield promptUser('Choose 1 or 2: ');
+        }
+        if (answer === '1')
+            return { kind: 'resolved', location: 'packages', push: false };
+        const remote = yield promptUser('Remote git URL for its repository (optional, Enter to skip): ');
+        const push = !!remote &&
+            /^y(es)?$/i.test(yield promptUser(`Push the first commit to ${remote}? (y/N): `));
+        return Object.assign(Object.assign({ kind: 'resolved', location: 'packages-local' }, (remote ? { remote } : {})), { push });
+    });
+}
+/** The install + first build plan for a package, given where it installs from. */
+function packageSetupFor(installRoot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // npm is the default for a new package. yarn is only consulted when the new
+        // package lands inside an existing yarn project (a yarn-3 monorepo),
+        // where adding an npm lockfile would break the workspace.
+        const insideYarnProject = detectPackageManager(installRoot) === 'yarn';
+        let version = insideYarnProject
+            ? (yield execPromise('yarn --version').catch(() => {
+                console.log('yarn probably not working');
+                return '';
+            }))
+            : '';
+        return planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'), process.execPath, insideYarnProject);
     });
-    if (installed) {
-        yield execp(setup.buildCommand, true, false, { cwd: targetFolder }).catch(() => {
-            console.warn('Dependencies installed, but the initial build failed');
+}
+/**
+ * Install `cwd` with `setup`, then build `targetFolder`. Failures set the exit
+ * code; `installFailedHint` says what was already changed when the install fails.
+ */
+function installThenBuild(setup_1, cwd_1, targetFolder_1) {
+    return __awaiter(this, arguments, void 0, function* (setup, cwd, targetFolder, installFailedHint = '') {
+        const installed = yield execp(setup.installCommand, true, false, { cwd })
+            .then(() => true)
+            .catch(() => {
+            console.warn(`Could not install dependencies (${setup.installCommand})` +
+                (installFailedHint ? `. ${installFailedHint}` : ''));
             process.exitCode = 1;
+            return false;
         });
+        if (installed) {
+            yield execp(setup.buildCommand, true, false, { cwd: targetFolder }).catch(() => {
+                console.warn('Dependencies installed, but the initial build failed');
+                process.exitCode = 1;
+            });
+        }
+    });
+}
+/** Outside an app: install inside the package itself, as this command always has. */
+function installStandalonePackage(targetFolder) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const setup = yield packageSetupFor(path.dirname(path.resolve(targetFolder)));
+        if (setup.yarnrc) {
+            fs.writeFileSync(path.join(targetFolder, '.yarnrc.yml'), setup.yarnrc);
+        }
+        yield installThenBuild(setup, targetFolder, targetFolder);
+        log(`Prepared a new linked package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'build'))} from this directory to build once`, `Or ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} to continuously rebuild on file changes`);
+    });
+}
+/**
+ * packages/: a workspace member of the app's own repository. The app's
+ * workspaces must cover it and its dependencies declare it — npm links a
+ * workspace member by name, and `build-all` builds what the app depends on —
+ * and the install runs at the app root, where the workspace is.
+ */
+function installWorkspacePackage(name, targetFolder, appRoot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const appPkgPath = path.join(appRoot, 'package.json');
+        const appPkg = fs.readJsonSync(appPkgPath);
+        const workspaces = ensureWorkspaceGlob(appPkg);
+        if (workspaces.warning)
+            console.warn(chalk.yellow(workspaces.warning));
+        const version = fs.readJsonSync(path.join(targetFolder, 'package.json')).version;
+        appPkg.dependencies = Object.assign(Object.assign({}, appPkg.dependencies), { [name]: `^${version}` });
+        fs.writeJsonSync(appPkgPath, appPkg, { spaces: 2 });
+        log(`Added ${name}@^${version} to ${path.relative(process.cwd(), appPkgPath) || 'package.json'}` +
+            (workspaces.changed ? ' and packages/* to its workspaces' : ''));
+        const setup = yield packageSetupFor(appRoot);
+        yield installThenBuild(setup, appRoot, targetFolder, `The app's package.json already declares ${name}; run the install again at the app root once it is fixed.`);
+        log(`Prepared a new linked package in ${chalk.magenta(targetFolder)}, part of this app's repository`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} in it to continuously rebuild on file changes`);
+    });
+}
+/**
+ * packages-local/: a repository of its own. Its git history starts here, and
+ * localize's `adopt` installs, builds, links and records it. The app's
+ * dependencies are NOT touched: until the package is published a version range
+ * fails `npm install` (E404 once a lockfile exists), and a `file:` path would
+ * install cleanly for a teammate without the checkout and fail at runtime.
+ */
+function installOwnRepoPackage(name, targetFolder, appRoot, decision) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { remote, push } = decision;
+        const rel = path.relative(appRoot, targetFolder);
+        const pkgPath = path.join(targetFolder, 'package.json');
+        const fail = (message) => {
+            console.warn(chalk.yellow(message));
+            process.exitCode = 1;
+        };
+        if (!git(['init', '--quiet'], targetFolder)) {
+            return fail(`git init failed in ${rel}; the package is scaffolded but not linked.`);
+        }
+        if (remote) {
+            if (!git(['remote', 'add', 'origin', remote], targetFolder)) {
+                return fail(`git remote add origin ${remote} failed in ${rel}; nothing was linked.`);
+            }
+            const pkg = fs.readJsonSync(pkgPath);
+            pkg.repository = { type: 'git', url: repositoryUrlFor(remote) };
+            fs.writeJsonSync(pkgPath, pkg, { spaces: 2 });
+        }
+        // Before adopt, never during it: adopt asserts the app's package.json did not
+        // change while it ran.
+        const appPkgPath = path.join(appRoot, 'package.json');
+        const appPkg = fs.readJsonSync(appPkgPath);
+        if (ensureRelinkPostinstall(appPkg)) {
+            fs.writeJsonSync(appPkgPath, appPkg, { spaces: 2 });
+            log(`Added \`${RELINK_COMMAND}\` to the app's postinstall, so npm install keeps the link`);
+        }
+        const { adoptPackage } = yield import('./commands/localize.js');
+        const { EXIT_WARNED } = yield import('@_linked/localize');
+        // Only the build command matters here: adopt always installs with npm, so
+        // the package-manager half of the plan does not apply.
+        const { buildCommand } = planPackageSetup('', path.join(getScriptDir(), 'launch.js'), process.execPath);
+        const code = yield adoptPackage(name, { appRoot, build: buildCommand });
+        if (code === EXIT_WARNED) {
+            fail('The package is linked, but its initial build failed');
+        }
+        else if (code !== 0) {
+            return fail(`Linking ${name} failed (localize exit ${code}). ${rel} is scaffolded with an uncommitted ` +
+                `git init, and the app's postinstall relinks localized packages. Fix the cause and retry ` +
+                `with: linked localize ${name} --adopt`);
+        }
+        const committed = git(['add', '-A'], targetFolder) &&
+            git(['commit', '--quiet', '-m', `feat: scaffold ${name}`], targetFolder);
+        if (!committed) {
+            fail(`Could not make the first commit in ${rel} (is git's user.name/user.email set?). ` +
+                `The package is linked; commit it yourself.`);
+        }
+        let pushed = false;
+        if (push && committed) {
+            pushed = git(['push', '--quiet', '-u', 'origin', 'HEAD'], targetFolder);
+            if (!pushed)
+                fail(`Could not push to ${remote}. Push it yourself: git push -u origin HEAD`);
+        }
+        const version = fs.readJsonSync(pkgPath).version;
+        log(`Prepared ${name} in ${chalk.magenta(rel)}, in its own git repository` +
+            (remote ? ` (origin ${remote}${pushed ? ', pushed' : ''})` : ' (no remote yet)'), `It is linked into node_modules and recorded in local-packages.json.`, `It is not in the app's dependencies: until it is published a version range would fail npm install.`, `  After publishing: ${chalk.blueBright(`npm install ${name}@^${version}`)}`);
+        if (!remote) {
+            log(`To add a remote later: ${chalk.blueBright('git remote add origin <url>')} in ${rel}, ` +
+                `then ${chalk.blueBright(`linked localize ${name} --adopt`)} to record it.`);
+        }
+    });
+}
+/** Run git with arguments (no shell, so a URL is never re-parsed). Echoes failures. */
+function git(args, cwd) {
+    var _a;
+    const r = spawnSync('git', args, { cwd, encoding: 'utf8' });
+    if (r.status !== 0) {
+        console.warn((r.stderr || r.stdout || String((_a = r.error) !== null && _a !== void 0 ? _a : '')).trim());
+        return false;
     }
-    log(`Prepared a new linked package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright(runScriptCommand(setup.packageManager, 'build'))} from this directory to build once`, `Or ${chalk.blueBright(runScriptCommand(setup.packageManager, 'start'))} to continuously rebuild on file changes`);
-});
+    return true;
+}
 var getNextVersion = function (version) {
     let parts = version.split('.');
     return parts[0] + '.' + parts[1] + '.' + (parseInt(parts[2]) + 1).toString();