@almadar/workspace 0.7.0 → 0.9.0

package/dist/service.d.ts

@@ -27,13 +27,19 @@ export declare class WorkspaceServiceImpl implements WorkspaceService {
     private readonly backend;
     private readonly sinks;
     private readonly git;
-    private readonly github;
+    private github;
     /** Per-absolute-path serial queue. */
     private readonly writeQueue;
     readonly index: WorkspaceIndex;
     constructor(args: ServiceCtorArgs);
     get appId(): string | undefined;
     setAppId(id: string): void;
+    /**
+     * Set (or clear) the GitHub config after open. Lets a consumer resolve the
+     * link/token lazily — e.g. from a workspace file read post-open — and wire
+     * `commitAndPush`/`pullIfLinked` without knowing it at construction time.
+     */
+    setGitHub(config: GitHubConfig | undefined): void;
     /** Run `op` under a per-path serial lock. */
     private withLock;
     /** Make sure the parent directory of `absPath` exists. */
@@ -74,6 +80,7 @@ export declare class WorkspaceServiceImpl implements WorkspaceService {
     clearCompiled(): Promise<void>;
     readFile(relPath: string): Promise<string | null>;
     writeFile(relPath: string, content: string): Promise<void>;
+    removeFile(relPath: string): Promise<void>;
     listTree(relPath?: string): Promise<FileTreeNode[]>;
     exists(relPath: string): Promise<boolean>;
     commitAndPush(opts: {

package/dist/types.d.ts

@@ -90,6 +90,9 @@ export type WorkspaceWriteEvent = {
     kind: 'file';
     relPath: string;
     content: string;
+} | {
+    kind: 'file-removed';
+    relPath: string;
 } | {
     kind: 'workspace-index';
     orbital: string;
@@ -233,6 +236,8 @@ export interface WorkspaceService {
     readonly appId: string | undefined;
     readonly workDir: string;
     setAppId(id: string): void;
+    /** Set/clear the GitHub config post-open (resolve link/token lazily, then wire push/pull). */
+    setGitHub(config: GitHubConfig | undefined): void;
     readOrbital(name: string): string | null;
     writeOrbital(name: string, content: string): Promise<void>;
     listOrbitals(): string[];
@@ -274,6 +279,8 @@ export interface WorkspaceService {
     clearCompiled(): Promise<void>;
     readFile(relPath: string): Promise<string | null>;
     writeFile(relPath: string, content: string): Promise<void>;
+    /** Delete a sandboxed file and emit a `file-removed` event (unmirrors downstream). No-op if absent. */
+    removeFile(relPath: string): Promise<void>;
     listTree(relPath?: string): Promise<FileTreeNode[]>;
     exists(relPath: string): Promise<boolean>;
     commitAndPush(opts: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/workspace",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Storage-agnostic workspace primitives shared by Almadar consumers. One service, six exports, hidden paths, single observer. See docs/Almadar_Workspace.md.",
   "type": "module",
   "main": "./dist/index.js",