@av-pi-studio/server 0.0.1

package/dist/projects/workspace-activity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Workspace activity bucket aggregation (features/projects-workspaces.md § Workspace activity bucket;
+ * architecture/agent-lifecycle.md § Lifecycle status semantics).
+ *
+ * Workspace status is an aggregate signal — NOT an agent's literal status:
+ * - Root agents contribute their own bucket to their workspace (by cwd).
+ * - A running subagent escalates `running` to its ROOT PARENT's workspace, not its own cwd.
+ * - Non-running subagent attention/error states stay in the parent's track and do NOT escalate the
+ *   workspace bucket.
+ */
+export type WorkspaceBucket = "running" | "error" | "attention" | "idle" | "closed" | "none";
+export interface AgentActivityInput {
+    id: string;
+    cwd: string;
+    /** Literal agent status. */
+    status: "initializing" | "idle" | "running" | "error" | "closed";
+    /** Root parent has `null`; a subagent points at its (possibly transitive) parent. */
+    parentAgentId: string | null;
+    /** Root agents may flag a non-running attention state (permission/error needing the user). */
+    needsAttention?: boolean;
+}
+/** Resolve an agent's root ancestor by walking parent links (cycle-safe). */
+export declare function resolveRoot(agentId: string, byId: Map<string, AgentActivityInput>): AgentActivityInput | undefined;
+/**
+ * Aggregate per-workspace activity buckets keyed by workspace cwd.
+ */
+export declare function aggregateWorkspaceActivity(agents: AgentActivityInput[]): Map<string, WorkspaceBucket>;
+//# sourceMappingURL=workspace-activity.d.ts.map

package/dist/projects/workspace-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-activity.d.ts","sourceRoot":"","sources":["../../src/projects/workspace-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjE,qFAAqF;IACrF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,8FAA8F;IAC9F,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA2BD,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACpC,kBAAkB,GAAG,SAAS,CAUhC;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAwB9B"}

package/dist/projects/workspace-activity.js

@@ -0,0 +1,74 @@
+/**
+ * Workspace activity bucket aggregation (features/projects-workspaces.md § Workspace activity bucket;
+ * architecture/agent-lifecycle.md § Lifecycle status semantics).
+ *
+ * Workspace status is an aggregate signal — NOT an agent's literal status:
+ * - Root agents contribute their own bucket to their workspace (by cwd).
+ * - A running subagent escalates `running` to its ROOT PARENT's workspace, not its own cwd.
+ * - Non-running subagent attention/error states stay in the parent's track and do NOT escalate the
+ *   workspace bucket.
+ */
+const PRIORITY = {
+    running: 5,
+    error: 4,
+    attention: 3,
+    idle: 2,
+    closed: 1,
+    none: 0,
+};
+function statusBucket(status, needsAttention) {
+    if (status === "running")
+        return "running";
+    if (status === "error")
+        return "error";
+    if (needsAttention)
+        return "attention";
+    if (status === "closed")
+        return "closed";
+    // initializing folds into idle for the workspace signal.
+    return "idle";
+}
+function higher(a, b) {
+    return PRIORITY[a] >= PRIORITY[b] ? a : b;
+}
+/** Resolve an agent's root ancestor by walking parent links (cycle-safe). */
+export function resolveRoot(agentId, byId) {
+    let current = byId.get(agentId);
+    const seen = new Set();
+    while (current && current.parentAgentId && !seen.has(current.id)) {
+        seen.add(current.id);
+        const parent = byId.get(current.parentAgentId);
+        if (!parent)
+            break;
+        current = parent;
+    }
+    return current;
+}
+/**
+ * Aggregate per-workspace activity buckets keyed by workspace cwd.
+ */
+export function aggregateWorkspaceActivity(agents) {
+    const byId = new Map(agents.map((a) => [a.id, a]));
+    const buckets = new Map();
+    const contribute = (cwd, bucket) => {
+        if (bucket === "none")
+            return;
+        buckets.set(cwd, higher(buckets.get(cwd) ?? "none", bucket));
+    };
+    for (const agent of agents) {
+        const isRoot = agent.parentAgentId === null;
+        if (isRoot) {
+            contribute(agent.cwd, statusBucket(agent.status, agent.needsAttention));
+            continue;
+        }
+        // Subagent: ONLY a running state escalates, and it escalates to the root parent's workspace.
+        if (agent.status === "running") {
+            const root = resolveRoot(agent.id, byId);
+            if (root)
+                contribute(root.cwd, "running");
+        }
+        // Non-running subagent attention/error stays in the parent's track — no workspace escalation.
+    }
+    return buckets;
+}
+//# sourceMappingURL=workspace-activity.js.map

package/dist/projects/workspace-activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-activity.js","sourceRoot":"","sources":["../../src/projects/workspace-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,QAAQ,GAAoC;IAChD,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,SAAS,YAAY,CACnB,MAAoC,EACpC,cAAwB;IAExB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,cAAc;QAAE,OAAO,WAAW,CAAC;IACvC,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACzC,yDAAyD;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,CAAkB,EAAE,CAAkB;IACpD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,IAAqC;IAErC,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,OAAO,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM;YAAE,MAAM;QACnB,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA4B;IAE5B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEnD,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,MAAuB,EAAQ,EAAE;QAChE,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO;QAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;QAC5C,IAAI,MAAM,EAAE,CAAC;YACX,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QACD,6FAA6F;QAC7F,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,IAAI;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QACD,8FAA8F;IAChG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/projects/workspace-git-service.d.ts

@@ -0,0 +1,27 @@
+import { type GitRunner } from "./git-detect.js";
+import { type CheckoutStatusProjection } from "./status-projection.js";
+/**
+ * Workspace git service: live status projections streamed as `checkout_status_update`
+ * (features/git-checkout.md § Status & diff). Recomputation is change-driven (a filesystem watcher
+ * calls `refresh()`), never polled. `CheckoutRefreshRequest` is gated by `features.checkoutRefresh`.
+ */
+export type StatusListener = (projection: CheckoutStatusProjection) => void;
+export declare class WorkspaceGitService {
+    private readonly gitRunner;
+    private readonly watched;
+    constructor(gitRunner?: GitRunner);
+    /** One-shot status read for a cwd. */
+    getStatus(cwd: string): Promise<CheckoutStatusProjection>;
+    /**
+     * Subscribe to live status for `cwd`. Emits the current projection immediately, then again on each
+     * `refresh(cwd)` that yields a *changed* projection. Returns an unsubscribe fn.
+     */
+    subscribe(cwd: string, listener: StatusListener): () => void;
+    /**
+     * Recompute status for `cwd` and notify listeners only when the projection changed since the last
+     * emit (dedupe — no spurious updates). Returns true when an update was broadcast.
+     */
+    refresh(cwd: string): Promise<boolean>;
+    private emit;
+}
+//# sourceMappingURL=workspace-git-service.d.ts.map

package/dist/projects/workspace-git-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-git-service.d.ts","sourceRoot":"","sources":["../../src/projects/workspace-git-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,wBAAwB,EAAiB,MAAM,wBAAwB,CAAC;AAEtF;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,wBAAwB,KAAK,IAAI,CAAC;AAO5E,qBAAa,mBAAmB;IAGlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAEzB,SAAS,GAAE,SAA4B;IAEpE,sCAAsC;IACtC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIzD;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI;IAiB5D;;;OAGG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAW9B,IAAI;CAMnB"}

package/dist/projects/workspace-git-service.js

@@ -0,0 +1,60 @@
+import { defaultGitRunner } from "./git-detect.js";
+import { projectStatus } from "./status-projection.js";
+export class WorkspaceGitService {
+    gitRunner;
+    watched = new Map();
+    constructor(gitRunner = defaultGitRunner) {
+        this.gitRunner = gitRunner;
+    }
+    /** One-shot status read for a cwd. */
+    getStatus(cwd) {
+        return projectStatus(cwd, this.gitRunner);
+    }
+    /**
+     * Subscribe to live status for `cwd`. Emits the current projection immediately, then again on each
+     * `refresh(cwd)` that yields a *changed* projection. Returns an unsubscribe fn.
+     */
+    subscribe(cwd, listener) {
+        let entry = this.watched.get(cwd);
+        if (!entry) {
+            entry = { listeners: new Set(), last: null };
+            this.watched.set(cwd, entry);
+        }
+        entry.listeners.add(listener);
+        // Emit current state immediately (snapshot on subscribe).
+        void this.emit(cwd, listener);
+        return () => {
+            const e = this.watched.get(cwd);
+            if (!e)
+                return;
+            e.listeners.delete(listener);
+            if (e.listeners.size === 0)
+                this.watched.delete(cwd);
+        };
+    }
+    /**
+     * Recompute status for `cwd` and notify listeners only when the projection changed since the last
+     * emit (dedupe — no spurious updates). Returns true when an update was broadcast.
+     */
+    async refresh(cwd) {
+        const entry = this.watched.get(cwd);
+        if (!entry || entry.listeners.size === 0)
+            return false;
+        const projection = await projectStatus(cwd, this.gitRunner);
+        const serialized = JSON.stringify(projection);
+        if (serialized === entry.last)
+            return false;
+        entry.last = serialized;
+        for (const listener of entry.listeners)
+            listener(projection);
+        return true;
+    }
+    async emit(cwd, listener) {
+        const projection = await projectStatus(cwd, this.gitRunner);
+        const entry = this.watched.get(cwd);
+        if (entry)
+            entry.last = JSON.stringify(projection);
+        listener(projection);
+    }
+}
+//# sourceMappingURL=workspace-git-service.js.map

package/dist/projects/workspace-git-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-git-service.js","sourceRoot":"","sources":["../../src/projects/workspace-git-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAiC,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAetF,MAAM,OAAO,mBAAmB;IAGD;IAFZ,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEtD,YAA6B,YAAuB,gBAAgB;QAAvC,cAAS,GAAT,SAAS,CAA8B;IAAG,CAAC;IAExE,sCAAsC;IACtC,SAAS,CAAC,GAAW;QACnB,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,GAAW,EAAE,QAAwB;QAC7C,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,0DAA0D;QAC1D,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,CAAC;gBAAE,OAAO;YACf,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,GAAW;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,UAAU,KAAK,KAAK,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5C,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS;YAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,QAAwB;QACtD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/projects/workspace-registry.d.ts

@@ -0,0 +1,59 @@
+import type { ProjectRecord, ProjectRegistry, WorkspaceRecord, WorkspaceRegistry } from "../persistence/entity-schemas.js";
+/**
+ * Project + workspace registries with `projectKey` derivation (features/projects-workspaces.md
+ * § Registries, § Project key derivation; architecture/persistence.md § Project/Workspace registry).
+ *
+ * A **project** groups workspaces sharing a git remote (or main repo root). A **workspace** is one
+ * concrete cwd on the daemon. Both registries are JSON arrays with `archivedAt` soft-delete.
+ */
+export type WorkspaceKind = "local_checkout" | "worktree" | "directory";
+/** Wire also accepts the legacy `checkout` kind; it maps to `local_checkout` and is never persisted. */
+export declare function normalizeWorkspaceKind(kind: string): WorkspaceKind;
+/**
+ * Normalize a git remote URL to a stable `host/owner/repo` form:
+ *   https://github.com/owner/repo.git  → github.com/owner/repo
+ *   git@github.com:owner/repo.git      → github.com/owner/repo
+ *   ssh://git@host:22/owner/repo       → host/owner/repo
+ */
+export declare function normalizeRemote(remote: string): string;
+/** Strip trailing separators; collapse duplicate separators. Case is preserved. */
+export declare function normalizePath(p: string): string;
+/**
+ * Derive the project key: git remote present → `remote:<normalized remote>`; else
+ * `path:<normalized rootPath>`. The key doubles as the projectId so remote-keyed ids are stable.
+ */
+export declare function deriveProjectKey(info: {
+    remote?: string | null;
+    rootPath: string;
+}): string;
+export declare class WorkspaceRegistryService {
+    private readonly home;
+    constructor(home: string);
+    listProjects(): Promise<ProjectRegistry>;
+    listWorkspaces(): Promise<WorkspaceRegistry>;
+    listActiveProjects(): Promise<ProjectRecord[]>;
+    listActiveWorkspaces(): Promise<WorkspaceRecord[]>;
+    /**
+     * Resolve (or create) the project for a detection result. Active git projects are unique by
+     * normalized `rootPath`; reuse an existing active project sharing the same key.
+     */
+    resolveOrCreateProject(detection: {
+        rootPath: string;
+        remote?: string | null;
+        kind: "git" | "non_git";
+        displayName?: string;
+    }): Promise<ProjectRecord>;
+    /** Resolve (or create) a workspace for a cwd under a project. Reuse an existing active record. */
+    resolveOrCreateWorkspace(args: {
+        projectId: string;
+        cwd: string;
+        kind: WorkspaceKind | string;
+        displayName?: string;
+    }): Promise<{
+        workspace: WorkspaceRecord;
+        created: boolean;
+    }>;
+    /** Soft-delete a workspace by id. Returns the archived record, or null if not found/active. */
+    archiveWorkspace(workspaceId: string): Promise<WorkspaceRecord | null>;
+}
+//# sourceMappingURL=workspace-registry.d.ts.map

package/dist/projects/workspace-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-registry.d.ts","sourceRoot":"","sources":["../../src/projects/workspace-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAQ1C;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,UAAU,GAAG,WAAW,CAAC;AAExE,wGAAwG;AACxG,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAIlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBtD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK3F;AAED,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEnC,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAGxC,cAAc,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAG5C,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAG9C,oBAAoB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIxD;;;OAGG;IACG,sBAAsB,CAAC,SAAS,EAAE;QACtC,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B1B,kGAAkG;IAC5F,wBAAwB,CAAC,IAAI,EAAE;QACnC,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,eAAe,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAwB7D,+FAA+F;IACzF,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAU7E"}

package/dist/projects/workspace-registry.js

@@ -0,0 +1,149 @@
+import { randomUUID } from "node:crypto";
+import { loadProjects, loadWorkspaces, saveProjects, saveWorkspaces, } from "../persistence/entity-stores.js";
+/** Wire also accepts the legacy `checkout` kind; it maps to `local_checkout` and is never persisted. */
+export function normalizeWorkspaceKind(kind) {
+    if (kind === "checkout")
+        return "local_checkout";
+    if (kind === "local_checkout" || kind === "worktree" || kind === "directory")
+        return kind;
+    return "directory";
+}
+/**
+ * Normalize a git remote URL to a stable `host/owner/repo` form:
+ *   https://github.com/owner/repo.git  → github.com/owner/repo
+ *   git@github.com:owner/repo.git      → github.com/owner/repo
+ *   ssh://git@host:22/owner/repo       → host/owner/repo
+ */
+export function normalizeRemote(remote) {
+    let r = remote.trim();
+    const hasScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(r);
+    // scp-like (no scheme): git@host:owner/repo(.git)
+    const scp = !hasScheme && r.match(/^[^@]+@([^:]+):(.+)$/);
+    if (scp) {
+        r = `${scp[1]}/${scp[2]}`;
+    }
+    else {
+        // strip scheme://[user@]host[:port]/
+        r = r.replace(/^[a-z][a-z0-9+.-]*:\/\//i, "");
+        const at = r.indexOf("@");
+        if (at !== -1)
+            r = r.slice(at + 1);
+        // drop a :port immediately after host
+        r = r.replace(/^([^/]+):\d+\//, "$1/");
+    }
+    r = r.replace(/\.git$/i, "").replace(/\/+$/, "");
+    return r.toLowerCase();
+}
+/** Strip trailing separators; collapse duplicate separators. Case is preserved. */
+export function normalizePath(p) {
+    return p.replace(/[\\/]+/g, "/").replace(/\/+$/, "") || "/";
+}
+/**
+ * Derive the project key: git remote present → `remote:<normalized remote>`; else
+ * `path:<normalized rootPath>`. The key doubles as the projectId so remote-keyed ids are stable.
+ */
+export function deriveProjectKey(info) {
+    if (info.remote && info.remote.trim().length > 0) {
+        return `remote:${normalizeRemote(info.remote)}`;
+    }
+    return `path:${normalizePath(info.rootPath)}`;
+}
+export class WorkspaceRegistryService {
+    home;
+    constructor(home) {
+        this.home = home;
+    }
+    async listProjects() {
+        return loadProjects(this.home);
+    }
+    async listWorkspaces() {
+        return loadWorkspaces(this.home);
+    }
+    async listActiveProjects() {
+        return (await this.listProjects()).filter((p) => !p.archivedAt);
+    }
+    async listActiveWorkspaces() {
+        return (await this.listWorkspaces()).filter((w) => !w.archivedAt);
+    }
+    /**
+     * Resolve (or create) the project for a detection result. Active git projects are unique by
+     * normalized `rootPath`; reuse an existing active project sharing the same key.
+     */
+    async resolveOrCreateProject(detection) {
+        const projectId = deriveProjectKey(detection);
+        const projects = await this.listProjects();
+        const now = new Date().toISOString();
+        // Exact key match (active) — reuse.
+        const byKey = projects.find((p) => p.projectId === projectId && !p.archivedAt);
+        if (byKey)
+            return byKey;
+        // Active git projects unique by normalized rootPath — reuse if an active one already exists.
+        const normRoot = normalizePath(detection.rootPath);
+        const byRoot = projects.find((p) => !p.archivedAt && p.kind === "git" && normalizePath(p.rootPath) === normRoot);
+        if (byRoot && detection.kind === "git")
+            return byRoot;
+        const record = {
+            projectId,
+            rootPath: detection.rootPath,
+            kind: detection.kind,
+            displayName: detection.displayName ?? defaultProjectName(projectId, detection.rootPath),
+            createdAt: now,
+            updatedAt: now,
+            archivedAt: null,
+        };
+        projects.push(record);
+        await saveProjects(this.home, projects);
+        return record;
+    }
+    /** Resolve (or create) a workspace for a cwd under a project. Reuse an existing active record. */
+    async resolveOrCreateWorkspace(args) {
+        const kind = normalizeWorkspaceKind(String(args.kind));
+        const workspaces = await this.listWorkspaces();
+        const now = new Date().toISOString();
+        const normCwd = normalizePath(args.cwd);
+        const existing = workspaces.find((w) => !w.archivedAt && normalizePath(w.cwd) === normCwd);
+        if (existing)
+            return { workspace: existing, created: false };
+        const record = {
+            workspaceId: randomUUID(),
+            projectId: args.projectId,
+            cwd: args.cwd,
+            kind,
+            displayName: args.displayName ?? defaultWorkspaceName(args.cwd),
+            createdAt: now,
+            updatedAt: now,
+            archivedAt: null,
+        };
+        workspaces.push(record);
+        await saveWorkspaces(this.home, workspaces);
+        return { workspace: record, created: true };
+    }
+    /** Soft-delete a workspace by id. Returns the archived record, or null if not found/active. */
+    async archiveWorkspace(workspaceId) {
+        const workspaces = await this.listWorkspaces();
+        const target = workspaces.find((w) => w.workspaceId === workspaceId);
+        if (!target || target.archivedAt)
+            return target ?? null;
+        const now = new Date().toISOString();
+        target.archivedAt = now;
+        target.updatedAt = now;
+        await saveWorkspaces(this.home, workspaces);
+        return target;
+    }
+}
+function defaultProjectName(projectId, rootPath) {
+    if (projectId.startsWith("remote:")) {
+        const parts = projectId.slice("remote:".length).split("/");
+        return parts[parts.length - 1] || projectId;
+    }
+    return basenameOf(rootPath);
+}
+function defaultWorkspaceName(cwd) {
+    return basenameOf(cwd);
+}
+function basenameOf(p) {
+    const norm = normalizePath(p);
+    const parts = norm.split("/");
+    return parts[parts.length - 1] || norm;
+}
+//# sourceMappingURL=workspace-registry.js.map

package/dist/projects/workspace-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-registry.js","sourceRoot":"","sources":["../../src/projects/workspace-registry.ts"],"names":[],"mappings":"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"}

package/dist/projects/worktree-service.d.ts

@@ -0,0 +1,100 @@
+import type { WorkspaceRecord } from "../persistence/entity-schemas.js";
+import type { Session } from "../ws/session.js";
+import type { HandlerRegistry } from "../ws/router.js";
+import { type GitRunner } from "./git-detect.js";
+import { WorkspaceRegistryService } from "./workspace-registry.js";
+/**
+ * Pi-Studio-managed git worktree service (features/worktrees.md § Operations, § Behavior,
+ * § Lifecycle config; architecture/agent-lifecycle.md § Archive). Handles create/setup, archive/
+ * teardown, and the `autoArchive`+`worktree` coupling.
+ */
+/** Agent label naming the worktree workspace it lives in (for auto-archive coupling). */
+export declare const WORKTREE_WORKSPACE_ID_LABEL = "pi-studio.worktree-workspace-id";
+/** Agent label flagging auto-archive after the first terminal turn. */
+export declare const AUTO_ARCHIVE_LABEL = "pi-studio.auto-archive";
+export interface CreateWorktreeIntent {
+    /** Source checkout (main repo root) the worktree branches from. */
+    projectRoot: string;
+    /** Owning project id. */
+    projectId: string;
+    /** Requested worktree/branch name (slugged; may be generated if absent). */
+    name?: string;
+    /** Existing branch to check out (mutually exclusive with new-branch generation). */
+    branch?: string;
+    /** Base ref for a newly created branch. */
+    baseRef?: string;
+    /** Prompt used to generate a branch name when neither `name` nor `branch` is provided. */
+    generatePrompt?: string;
+}
+export interface WorktreeDescriptor {
+    workspace: WorkspaceRecord;
+    name: string;
+    branch: string;
+    path: string;
+    setupOk: boolean;
+}
+export type CommandRunResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type CommandRunner = (command: string, opts: {
+    cwd: string;
+    env: Record<string, string>;
+}) => Promise<CommandRunResult>;
+export interface AgentLike {
+    id: string;
+    cwd: string;
+    labels: Record<string, string>;
+}
+export interface WorktreeServiceDeps {
+    home: string;
+    registry?: WorkspaceRegistryService;
+    broadcast: (sessions: Iterable<Session>, message: unknown) => void;
+    getActiveSessions?: () => Iterable<Session>;
+    gitRunner?: GitRunner;
+    /** Runs a `setup`/`teardown` shell command. Defaults to a no-op success. */
+    runCommand?: CommandRunner;
+    /** Resolve the `pi-studio.json` worktree lifecycle commands for a project root. */
+    readWorktreeLifecycle?: (projectRoot: string) => Promise<{
+        setup: string[];
+        teardown: string[];
+    }>;
+    /** Structured-generation branch-name generator. */
+    generateBranchName?: (prompt: string) => Promise<string>;
+    /** `worktrees.root` daemon-config override; defaults to `$PI_STUDIO_HOME/worktrees`. */
+    worktreeRoot?: string;
+    /** Active agents (for archiving contained agents + auto-archive coupling). */
+    listAgents?: () => AgentLike[];
+    /** Archive an agent by id (cascades per AgentManager). */
+    archiveAgent?: (id: string) => Promise<void>;
+}
+/** Slug a branch/worktree name: lowercase, keep `[a-z0-9-/]`, collapse separators. */
+export declare function slugBranchName(name: string): string;
+/**
+ * Resolve a unique, length-bounded worktree name. Over-long names are truncated and a deterministic
+ * 7-char hash suffix is appended; colliding names get a deterministic suffix that increments a salt
+ * until unique within `existing`.
+ */
+export declare function resolveWorktreeName(rawName: string, existing: ReadonlySet<string>, maxLen?: number): string;
+export declare class WorktreeService {
+    private readonly deps;
+    private readonly registry;
+    private readonly git;
+    private readonly runCommand;
+    constructor(deps: WorktreeServiceDeps);
+    registerHandlers(registry: HandlerRegistry, getActiveSessions: () => Iterable<Session>): void;
+    private worktreeRoot;
+    /** Create a Pi-Studio worktree, register it, and run `setup`. */
+    createWorktree(intent: CreateWorktreeIntent, getActiveSessions?: () => Iterable<Session>): Promise<WorktreeDescriptor>;
+    /** Archive a worktree: teardown → archive contained agents → `git worktree remove`/prune. */
+    archiveWorktree(workspaceId: string, getActiveSessions?: () => Iterable<Session>): Promise<boolean>;
+    /**
+     * Auto-archive coupling: when an agent created with `autoArchive` + a `worktree` target reaches a
+     * terminal turn, archive the agent AND its worktree (which cascades to any agents inside it).
+     * Returns true when an auto-archive was performed.
+     */
+    maybeAutoArchiveOnTerminalTurn(agent: AgentLike, getActiveSessions?: () => Iterable<Session>): Promise<boolean>;
+    private runLifecycle;
+}
+//# sourceMappingURL=worktree-service.d.ts.map

package/dist/projects/worktree-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-service.d.ts","sourceRoot":"","sources":["../../src/projects/worktree-service.ts"],"names":[],"mappings":"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"}