@tomradex/repos 0.19.0 → 0.21.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { Repos, ReposConfig, BranchInUseError, CheckoutUnsetError, HubUnsetError, type CheckoutSelection, type CheckoutView, type FolderRepo, type MissingWorkdir, type WorkdirView } from "./service.js";
+export { Repos, ReposConfig, BranchInUseError, CheckoutUnsetError, HubUnsetError, RepoPathOutsideError, type CheckoutProblem, type CheckoutSelection, type CheckoutView, type FolderRepo, type MissingWorkdir, type WorkdirView } from "./service.js";
 export { isLocalRemote, normalizeRemote, remoteIdentity, sameRepository, serverHost, sshHostName, type RemoteIdentity } from "./remotes.js";
 export { Repos as default } from "./service.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/service.d.ts

@@ -16,7 +16,10 @@ export interface CheckoutView {
     remote: string;
     checkout: string | null;
     runInCheckout: boolean;
+    /** The folder this machine names cannot be worked in: gone from disk, or no longer a git checkout. */
+    problem?: CheckoutProblem;
 }
+export type CheckoutProblem = "missing" | "not-git";
 /** Result of inspecting the folder the user explicitly chose. */
 export type CheckoutSelection = {
     state: "ready";
@@ -36,6 +39,10 @@ export interface FolderRepo {
     local: boolean;
     /** The project already had this repository; the folder became its checkout. */
     existing: boolean;
+    /** The folder was not a repository: Tomrade ran git init in it. */
+    initialised: boolean;
+    /** Files committed because the repository had no commit yet; 0 when it already had one. */
+    committed: number;
 }
 export interface WorkdirView {
     repo: Repo;
@@ -84,6 +91,12 @@ export declare class HubUnsetError extends Error {
     constructor();
 }
 /** git keeps a branch in one worktree at a time, and another worktree already has this one. */
+/** The workstream's folder is a place on this machine outside the checkout: only a folder in the repository can be run in. */
+export declare class RepoPathOutsideError extends Error {
+    readonly repoPath: string;
+    readonly checkout: string;
+    constructor(repoPath: string, checkout: string);
+}
 export declare class BranchInUseError extends Error {
     readonly branch: string;
     readonly at: string;
@@ -117,9 +130,18 @@ export declare class Repos extends Service implements ReposReader {
      * A folder chosen as a repository. Its origin, when it has one, is the
      * identity, and a row already naming it under any spelling is reused. With
      * no origin the folder itself is the repository, local to this machine until
-     * it gains one (see adoptOrigins). The folder is only read.
+     * it gains one (see adoptOrigins). A folder that is not a repository yet
+     * becomes one here, and a repository with nothing committed gets its first
+     * commit: worktrees, scans and merges all need a default branch to stand on.
      */
     addFromFolder(projectId: string, rawDir: string): Promise<FolderRepo>;
+    /**
+     * A repository with no commit has no branch to scan, branch from or merge
+     * into. What its working tree holds becomes the first commit, as the user's
+     * .gitignore says; a folder without one still keeps dependency and cache
+     * folders out, through .git/info/exclude so no file of theirs is written.
+     */
+    private commitUnborn;
     /** Where a folder's branches start: origin's HEAD, else main or master, else whatever is checked out. */
     private trunkOf;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomradex/repos",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "type": "module",
   "author": "Haoyuan Tang",
   "engines": {
@@ -27,15 +27,15 @@
     "dist"
   ],
   "dependencies": {
-    "@tomradex/boards": "0.19.0",
-    "@tomradex/contracts": "0.19.0",
-    "@tomradex/db": "0.19.0",
-    "@tomradex/domain": "0.2.28",
-    "@tomradex/git": "0.19.0",
-    "@tomradex/hub": "0.19.0",
-    "@tomradex/ipc": "0.19.0",
-    "@tomradex/storage": "0.19.0",
-    "@tomradex/tools": "0.19.0",
+    "@tomradex/boards": "0.21.0",
+    "@tomradex/contracts": "0.21.0",
+    "@tomradex/db": "0.21.0",
+    "@tomradex/domain": "0.2.29",
+    "@tomradex/git": "0.21.0",
+    "@tomradex/hub": "0.21.0",
+    "@tomradex/ipc": "0.21.0",
+    "@tomradex/storage": "0.21.0",
+    "@tomradex/tools": "0.21.0",
     "cordis": "4.0.0-rc.8",
     "zod": "^4.4.3"
   }