feat: support zero-config standalone repositories by corwinm · Pull Request #93 · corwinm/arashi

corwinm · 2026-07-15T05:05:07Z

Implements the CLI portion of corwinm/arashi-arashi#212 under the OpenSpec proposal in corwinm/arashi-arashi#217.

Summary

derive implicit standalone workspace context from Git without writing config
support root .worktrees/<branch> lifecycle commands with configured-workspace precedence
add transactional zero-config bootstrap, exact ignore safety, hooks, rollback, and stable human/JSON metadata
enforce configured-only command boundaries and cross-repository command contracts

Validation

full test suites passed on Ubuntu and Windows
build and validation jobs passed on macOS, Ubuntu, and Windows
focused final compliance suites passed
quality, lint, typecheck, format, schema/contract freshness, changed-file checks, and package smoke passed

Related implementation

Docs: docs: document zero-config standalone workflow arashi-docs#47
Skills: docs: teach zero-config standalone workflows arashi-skills#39
Meta/OpenSpec: docs: propose zero-config standalone workspaces arashi-arashi#217

This child PR intentionally does not close the meta issue.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6d062782d5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-07-15T05:09:38Z

+      else if (options.short) output = formatShortOutput(statuses);
+      console.log(output);
+    }
+    process.exit(ZERO);


Return nonzero for standalone status errors

When a standalone worktree has stale metadata or its directory was removed, checkRepoStatus returns a status with error, but this standalone branch always emits a success result and exits 0. The configured path computes hasErrors and exits ERROR_EXIT_CODE, so CI/scripts using arashi status will miss broken standalone worktrees unless this branch applies the same error-exit check.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-07-15T05:09:38Z

+
+  const worktreesPath = join(mainRoot, ".worktrees");
+  const excludePath = await localExcludePath(mainRoot);
+  const directoryExists = await exists(worktreesPath);


Reject non-directory .worktrees during bootstrap

If a regular file or symlink already exists at .worktrees, this exists check treats the required directory as present, so init --zero-config can report success without creating anything. Later resolveWorkspaceContext requires .worktrees to be a directory, leaving standalone mode unavailable after a supposedly successful bootstrap; validate lstat(...).isDirectory() or fail/rollback instead.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-07-15T05:09:38Z

+  if (await configExists(mainRoot)) {
+    throw new ZeroConfigBootstrapError(
+      "A configured Arashi workspace already exists; zero-config standalone mode cannot replace it.",
+    );


Refuse zero-config inside configured ancestors

This only checks for a config at the repository root, so running arashi init --zero-config from a repo nested under an existing Arashi workspace can return success and write .worktrees, even though resolveWorkspaceContext loads ancestor configuration before considering standalone mode. In that context the new standalone convention will never activate, so bootstrap should detect ancestor configs from the invocation/main root and refuse with the same configured-workspace error.

Useful? React with 👍 / 👎.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b210b82d20

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-07-15T05:25:04Z


+  const workspaceContext = await resolveWorkspaceContext();
+  if (workspaceContext.mode === "standalone") {
+    if (options.only || options.group || options.interactive) {


Reject standalone --move-changes or implement it

When arashi create --move-changes <branch> is run in standalone mode, this branch accepts the option but never runs the dirty-change move logic that the configured path uses after creation, so the command reports success while leaving the user's uncommitted changes in the source worktree. Either include --move-changes in the standalone unsupported-option check or perform the same move plan for the single standalone repository.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-07-15T05:25:04Z

+    await applyStandaloneCreateOverrides({
+      branchName,
+      commandOptions: options,
+      context: workspaceContext,
+      deps,
+      worktreePath: standaloneResult.worktreePath,
+    });


Skip post-create switching for JSON output

For standalone arashi create --json --switch or --launch, the JSON envelope is written and then this call still runs applyStandaloneCreateOverrides, which writes additional messages to stdout and can launch an external context. That leaves JSON consumers with non-JSON trailing output, while the configured JSON path returns immediately after writing its envelope.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-07-15T05:25:04Z

+      const canonicalStatusPaths = await Promise.all(
+        statuses.map(async (status) => await realpath(status.path)),
+      );


Tolerate stale standalone worktrees in handoff

If a standalone worktree directory was deleted before arashi prune, checkRepoStatus records the missing path as a per-worktree error, but this realpath(status.path) rejects with ENOENT and the whole handoff command fails before emitting the report. Stale worktree metadata is a supported diagnostic path elsewhere in this change, so handoff should avoid realpathing missing status paths or fall back to the unresolved path.

Useful? React with 👍 / 👎.

## [1.20.0](v1.19.2...v1.20.0) (2026-07-15) ### Features * add cmux workspace launching ([#91](#91)) ([1dcfeb9](1dcfeb9)) * reconcile managed Git ignore rules ([#92](#92)) ([8da9064](8da9064)) * support zero-config standalone repositories ([#93](#93)) ([91acd82](91acd82))

github-actions · 2026-07-15T07:02:14Z

🎉 This PR is included in version 1.20.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

corwinm added 7 commits July 14, 2026 19:08

feat(cli): support zero-config standalone workspaces

ec2858c

fix(doctor): preserve structured config findings

b3beb63

fix(doctor): retain config error context

62a7728

fix(cli): preserve standalone command contracts

5981572

fix(cli): complete standalone lifecycle parity

9b30e54

fix(cli): honor negated ignore evidence

8e002d2

fix(remove): complete standalone finalization plans

6d06278

This was referenced Jul 15, 2026

docs: document zero-config standalone workflow corwinm/arashi-docs#47

Merged

docs: teach zero-config standalone workflows corwinm/arashi-skills#39

Merged

docs: propose zero-config standalone workspaces corwinm/arashi-arashi#217

Merged

test(cli): pin standalone default branch

2c52871

chatgpt-codex-connector Bot reviewed Jul 15, 2026

View reviewed changes

test(cli): make workspace fixtures cross-platform

b210b82

chatgpt-codex-connector Bot reviewed Jul 15, 2026

View reviewed changes

corwinm merged commit 91acd82 into main Jul 15, 2026
9 checks passed

corwinm mentioned this pull request Jul 15, 2026

Support zero-config standalone repositories with .worktrees corwinm/arashi-arashi#212

Closed

15 tasks

corwinm deleted the feat/zero-config-standalone branch July 15, 2026 06:57

github-actions Bot added the released label Jul 15, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: support zero-config standalone repositories#93

feat: support zero-config standalone repositories#93
corwinm merged 9 commits into
mainfrom
feat/zero-config-standalone

corwinm commented Jul 15, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Uh oh!

Uh oh!

github-actions Bot commented Jul 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

corwinm commented Jul 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Related implementation

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jul 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

github-actions Bot commented Jul 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

corwinm commented Jul 15, 2026 •

edited

Loading