oh-my-space 1.1.1 → 2.0.0

package/README.md

@@ -2,25 +2,30 @@
 
 [![npm version](https://img.shields.io/npm/v/oh-my-space.svg)](https://www.npmjs.com/package/oh-my-space)
 
-`oh-my-space` (OMS) is a small CLI for managing multi-repository workspaces with Git submodules. Declare source repositories once, work in normal branches, and let the main project record the exact commit used from each repository.
+`oh-my-space` (OMS) manages multi-repository workspaces with Git submodules. Source repositories use normal branches. The main project records each source repository's exact commit.
 
 ## Who it helps
 
 Use OMS when you:
 
-- develop one product across several repositories and want them checked out side by side;
-- need reproducible workspaces where the main project records each source repository's exact commit;
-- want everyday branch, commit, pull, and push workflows without accidentally working in a detached checkout;
-- want source-commit changes to remain visible until you deliberately record them in the main project;
+- develop one product across several repositories and need adjacent checkouts.
+- need reproducible workspaces with exact source commits recorded in the main project.
+- need branch, commit, pull, and push workflows that avoid accidental detached checkouts.
+- need source-commit changes to remain visible until you record them in the main project.
 - use AI coding tools that need a clear boundary between the main project and source repositories.
 
-OMS keeps Git's reproducibility while automating routine submodule setup and bounded recovery. When a choice depends on your intent, it asks instead of changing repository state silently.
+OMS preserves Git's reproducibility and automates routine submodule setup and bounded recovery. OMS asks when a choice depends on your intent.
 
 ## Requirements
 
-- [Node.js](https://nodejs.org) `>=20.19.0`
+- [Node.js](https://nodejs.org) `^24 || >=26`
 - Git `>=2.40`
-- A Git repository whose top-level directory contains `oms.yaml` before repositories are synchronized
+- A Git repository with `oms.yaml` at its top level before you synchronize repositories
+
+Node 24 is the minimum supported line and the development, release, and required CI baseline.
+Node 26 and later are permitted, but not every future version is verified.
+Node 20, 22, and 25 are no longer supported; upgrade Node before installing the next major OMS release.
+CI also runs a separate, non-gating latest-runtime diagnostic.
 
 ## Install
 
@@ -52,25 +57,30 @@ repos:
     branch: main # optional; defaults to the remote's default branch
 ```
 
-Synchronize the workspace and inspect its state:
+Synchronize the workspace:
 
 ```bash
 oms sync --all
+```
+
+Inspect its state:
+
+```bash
 oms status
 ```
 
-The source repository is now available at `oms/api/`. Continue with [Getting started](https://github.com/divlook/oh-my-space/blob/main/docs/getting-started.md) to complete the first branch, commit, push, and recorded-commit workflow.
+The source repository is now available at `oms/api/`. Follow [Getting started](https://github.com/divlook/oh-my-space/blob/main/docs/getting-started.md) for your first branch, commit, push, and recorded-commit workflow.
 
 ## Documentation
 
-- [Getting started](https://github.com/divlook/oh-my-space/blob/main/docs/getting-started.md) — set up a workspace and complete the first source change from branch creation through recording the commit in the main project.
-- [How OMS works](https://github.com/divlook/oh-my-space/blob/main/docs/how-oms-works.md) — understand workspace layout, repository boundaries, recorded commits, synchronization, status, safety behavior, and recovery.
-- [Commands](https://github.com/divlook/oh-my-space/blob/main/docs/commands.md) — choose the right command and Git scope; use `oms <command> --help` for exact arguments, options, and exit behavior.
-- [Configure your workspace](https://github.com/divlook/oh-my-space/blob/main/docs/configure-your-workspace.md) — define repositories, remotes, and starting branches in `oms.yaml`.
-- [AI coding tools](https://github.com/divlook/oh-my-space/blob/main/docs/ai-coding-tools.md) — install agent instructions and workspace skills that preserve repository boundaries.
-- [Migration guides](https://github.com/divlook/oh-my-space/blob/main/docs/migrations/README.md) — follow version-specific upgrade instructions.
-- [Development](https://github.com/divlook/oh-my-space/blob/main/docs/development.md) — build, test, and contribute to OMS.
-- [Release channels](https://github.com/divlook/oh-my-space/blob/main/docs/release-channels.md) — install stable or beta releases and maintain npm release channels.
+- [Getting started](https://github.com/divlook/oh-my-space/blob/main/docs/getting-started.md): Read for workspace setup and your first source change.
+- [How OMS works](https://github.com/divlook/oh-my-space/blob/main/docs/how-oms-works.md): Read for layout, repository boundaries, recorded commits, managed trees, synchronization, status, safety, and recovery.
+- [Commands](https://github.com/divlook/oh-my-space/blob/main/docs/commands.md): Read to choose a command and Git scope. Use `oms <command> --help` for exact arguments, options, and exit behavior.
+- [Configure your workspace](https://github.com/divlook/oh-my-space/blob/main/docs/configure-your-workspace.md): Read to define repositories, remotes, and starting branches in `oms.yaml`.
+- [AI coding tools](https://github.com/divlook/oh-my-space/blob/main/docs/ai-coding-tools.md): Read to install agent instructions and workspace skills that preserve repository boundaries.
+- [Migration guides](https://github.com/divlook/oh-my-space/blob/main/docs/migrations/README.md): Read for version-specific upgrade instructions.
+- [Development](https://github.com/divlook/oh-my-space/blob/main/docs/development.md): Read to build, test, or contribute to OMS.
+- [Release channels](https://github.com/divlook/oh-my-space/blob/main/docs/release-channels.md): Read to install stable or beta releases or maintain npm release channels.
 
 ## License
 

package/dist/THIRD-PARTY-NOTICES.txt

@@ -2,12 +2,12 @@ oh-my-space bundles the following third-party packages into dist/oms.js.
 Their licenses and copyright notices are reproduced below.
 
 ================================================================================
-@clack/core@1.3.1 (MIT)
+@clack/core@1.5.1 (MIT)
 ================================================================================
 
 MIT License
 
-Copyright (c) Nate Moore
+MIT License Copyright (c) 2025-Present [Bombshell contributors](https://bomb.sh/team)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 
@@ -15,12 +15,12 @@ The above copyright notice and this permission notice shall be included in all c
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ================================================================================
-@clack/prompts@1.4.0 (MIT)
+@clack/prompts@1.8.1 (MIT)
 ================================================================================
 
 MIT License
 
-Copyright (c) Nate Moore
+MIT License Copyright (c) 2025-Present [Bombshell contributors](https://bomb.sh/team)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

package/dist/build-info.json

@@ -1 +1 @@
-{"commit":"f6a44637490456ded09f83b3eeaed3e4049a950e","skills":{"oms-branch":{"version":"1.1.0","omsVersion":">=1.0.0-0"},"oms-pointer":{"version":"1.1.0","omsVersion":">=1.0.0-0"},"oms-workspace":{"version":"1.2.0","omsVersion":">=1.0.0-0"}}}
+{"commit":"b2a86e8876ac76ffc8e4daed8146f82fe93613d1","skills":{"oms-branch":{"version":"1.2.0","omsVersion":">=1.0.0-0"},"oms-pointer":{"version":"1.2.0","omsVersion":">=1.0.0-0"},"oms-workspace":{"version":"1.4.0","omsVersion":">=1.2.0-0"}}}