@bevel-software/platform-shared 0.1.0

package/dist/workspace/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/workspace/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBpF"}

package/dist/workspace/frontmatter.js

@@ -0,0 +1,48 @@
+/**
+ * The ONE `---` frontmatter splitter, shared by backend and frontend so no file
+ * type grows its own regex. Splits a leading `---`-fenced YAML block from the
+ * body; null when the text doesn't open with a fence. Parsing the YAML inside is
+ * the caller's concern (the access-control resolver deliberately keeps its own
+ * hardened line-based reader — see `modules/access/access-splice.ts`).
+ */
+export function extractFrontmatter(text) {
+    const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!m)
+        return null;
+    return { frontmatter: m[1], body: m[2] };
+}
+/**
+ * Set a top-level scalar key in a file's `---` frontmatter, LINE-based: replace an
+ * existing `<key>:` line's value, else insert `<key>: <value>` at the top of the
+ * block (creating a `---` block if the file has none). Deliberately NOT a
+ * parse-and-re-serialize — a KB node's `nodeType:` quoted-markdown-link and access
+ * lines are read by a hand-rolled regex parser that a full YAML re-emit would
+ * corrupt, so every other line is preserved byte-for-byte. `value` is emitted as a
+ * bare scalar; callers pass simple id/name strings (no quoting/escaping needed for
+ * the `[a-z0-9_-]` id grammar).
+ */
+export function setFrontmatterField(text, key, value) {
+    const fm = extractFrontmatter(text);
+    const line = `${key}: ${value}`;
+    // Escape the key before interpolating — callers pass plain `id`/`name`, but a
+    // metacharacter must never silently change what the line-matcher matches.
+    const keyRe = new RegExp(`^(\\s*)${key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}:.*$`);
+    // Preserve the file's own line-ending convention: rebuilding a CRLF file with
+    // bare `\n` would dirty every frontmatter line, breaking the byte-for-byte
+    // guarantee this helper exists for. Judged from the FIRST line ending (the
+    // fence line's own), so a stray CRLF deep in the body can't flip the block.
+    const firstNl = text.indexOf('\n');
+    const eol = firstNl > 0 && text[firstNl - 1] === '\r' ? '\r\n' : '\n';
+    if (!fm) {
+        // No frontmatter — prepend a fresh block, keeping the original body intact.
+        return `---${eol}${line}${eol}---${eol}${text}`;
+    }
+    const fmLines = fm.frontmatter.split(/\r?\n/);
+    const idx = fmLines.findIndex((l) => keyRe.test(l));
+    if (idx >= 0)
+        fmLines[idx] = line;
+    else
+        fmLines.unshift(line);
+    return `---${eol}${fmLines.join(eol)}${eol}---${eol}${fm.body}`;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/workspace/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/workspace/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,GAAW,EAAE,KAAa;IAC1E,MAAM,EAAE,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;IAChC,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrF,8EAA8E;IAC9E,2EAA2E;IAC3E,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,4EAA4E;QAC5E,OAAO,MAAM,GAAG,GAAG,IAAI,GAAG,GAAG,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;IAClD,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;;QAC7B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/workspace/kb-layout.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Top-level layout of the KB repo (inside the `KB_DIR_NAME` clone).
+ *
+ * The repo root holds a small, fixed set of special folders that the app
+ * treats distinctly:
+ *
+ *   <kbDirName>/
+ *   ├── KnowledgeBase/   ← all team ontologies live here (the knowledge graph)
+ *   ├── Data/            ← agent-produced records; parsed like KnowledgeBase/
+ *   ├── Agents/          ← .agent files — agent role configurations (not the graph)
+ *   ├── Pipelines/       ← .pipeline files — execution-layer processes (not the graph)
+ *   ├── Skills/          ← reusable agent skills (NOT part of the graph)
+ *   ├── Tools/           ← user-authored tool manuals (*.tool; not the graph)
+ *   ├── roles.yaml       ← identity → role mapping
+ *   └── access.md        ← repo-root access-control rules
+ *
+ * These names are the single source of truth for both sides of the app:
+ *  - Backend: the graph parser discovers ontologies under the
+ *    {@link ONTOLOGY_ROOTS} (`KnowledgeBase/` and `Data/`); `Skills/`,
+ *    `Tools/`, `Agents/`, `Pipelines/` (and anything else at the root) are
+ *    ignored by parsing, validation, and the diagram.
+ *  - Frontend: the file tree renders these root folders as distinct
+ *    top-level sections.
+ *
+ * Don't hard-code these strings elsewhere — import them from here.
+ */
+/** Folder under the repo root that contains all team ontologies. */
+export declare const KNOWLEDGE_BASE_DIR = "KnowledgeBase";
+/** Folder under the repo root that holds reusable agent skills (not graph nodes). */
+export declare const SKILLS_DIR = "Skills";
+/**
+ * Folder under the repo root that holds user-authored tool manuals (`*.tool`
+ * files). Each `.tool` is a UTCP manual (inline / http / mcp) that the MCP/UTCP
+ * endpoint loads for any user who can read it (access-controlled like Skills).
+ * Not part of the knowledge graph.
+ */
+export declare const TOOLS_DIR = "Tools";
+/**
+ * Folder under the repo root for agent-produced records (pipeline instances,
+ * work items, intermediate outputs). Parsed exactly like `KnowledgeBase/`:
+ * its direct subfolders are self-contained ontologies.
+ */
+export declare const DATA_DIR = "Data";
+/** Folder under the repo root that holds `.agent` files — agent role configurations (not graph nodes). */
+export declare const AGENTS_DIR = "Agents";
+/** Folder under the repo root that holds `.pipeline` files — execution-layer processes (not graph nodes). */
+export declare const PIPELINES_DIR = "Pipelines";
+/**
+ * The roots whose subfolders are discovered as ontologies by the graph parser
+ * (each subfolder with both `NodeTypes/` and `Knowledge/` is an ontology).
+ */
+export declare const ONTOLOGY_ROOTS: readonly string[];
+/** The `Knowledge/` marker subfolder of an ontology (holds the graph nodes). */
+export declare const KNOWLEDGE_DIR = "Knowledge";
+/** The `NodeTypes/` marker subfolder of an ontology (holds the type definitions). */
+export declare const NODETYPE_DIR = "NodeTypes";
+/** The marker subfolders that make a directory an ontology (it needs BOTH). */
+export declare const ONTOLOGY_MARKERS: Set<string>;
+/**
+ * A named ontology id, or `null` for the neutral bucket — content that belongs
+ * to no named ontology (root config, `Skills/`, root-level `Knowledge/`, etc.).
+ * The named id is the repo-root-relative path of the ontology directory,
+ * e.g. `KnowledgeBase/Product` or `KnowledgeBase/IT Architecture`.
+ */
+export type Ontology = string | null;
+//# sourceMappingURL=kb-layout.d.ts.map

package/dist/workspace/kb-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-layout.d.ts","sourceRoot":"","sources":["../../src/workspace/kb-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,qFAAqF;AACrF,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC;;;;GAIG;AACH,eAAO,MAAM,QAAQ,SAAS,CAAC;AAE/B,0GAA0G;AAC1G,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,6GAA6G;AAC7G,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAmC,CAAC;AAEhF,gFAAgF;AAChF,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,qFAAqF;AACrF,eAAO,MAAM,YAAY,cAAc,CAAC;AAExC,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,aAAyC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC"}

package/dist/workspace/kb-layout.js

@@ -0,0 +1,63 @@
+/**
+ * Top-level layout of the KB repo (inside the `KB_DIR_NAME` clone).
+ *
+ * The repo root holds a small, fixed set of special folders that the app
+ * treats distinctly:
+ *
+ *   <kbDirName>/
+ *   ├── KnowledgeBase/   ← all team ontologies live here (the knowledge graph)
+ *   ├── Data/            ← agent-produced records; parsed like KnowledgeBase/
+ *   ├── Agents/          ← .agent files — agent role configurations (not the graph)
+ *   ├── Pipelines/       ← .pipeline files — execution-layer processes (not the graph)
+ *   ├── Skills/          ← reusable agent skills (NOT part of the graph)
+ *   ├── Tools/           ← user-authored tool manuals (*.tool; not the graph)
+ *   ├── roles.yaml       ← identity → role mapping
+ *   └── access.md        ← repo-root access-control rules
+ *
+ * These names are the single source of truth for both sides of the app:
+ *  - Backend: the graph parser discovers ontologies under the
+ *    {@link ONTOLOGY_ROOTS} (`KnowledgeBase/` and `Data/`); `Skills/`,
+ *    `Tools/`, `Agents/`, `Pipelines/` (and anything else at the root) are
+ *    ignored by parsing, validation, and the diagram.
+ *  - Frontend: the file tree renders these root folders as distinct
+ *    top-level sections.
+ *
+ * Don't hard-code these strings elsewhere — import them from here.
+ */
+/** Folder under the repo root that contains all team ontologies. */
+export const KNOWLEDGE_BASE_DIR = 'KnowledgeBase';
+/** Folder under the repo root that holds reusable agent skills (not graph nodes). */
+export const SKILLS_DIR = 'Skills';
+/**
+ * Folder under the repo root that holds user-authored tool manuals (`*.tool`
+ * files). Each `.tool` is a UTCP manual (inline / http / mcp) that the MCP/UTCP
+ * endpoint loads for any user who can read it (access-controlled like Skills).
+ * Not part of the knowledge graph.
+ */
+export const TOOLS_DIR = 'Tools';
+/**
+ * Folder under the repo root for agent-produced records (pipeline instances,
+ * work items, intermediate outputs). Parsed exactly like `KnowledgeBase/`:
+ * its direct subfolders are self-contained ontologies.
+ */
+export const DATA_DIR = 'Data';
+/** Folder under the repo root that holds `.agent` files — agent role configurations (not graph nodes). */
+export const AGENTS_DIR = 'Agents';
+/** Folder under the repo root that holds `.pipeline` files — execution-layer processes (not graph nodes). */
+export const PIPELINES_DIR = 'Pipelines';
+/**
+ * The roots whose subfolders are discovered as ontologies by the graph parser
+ * (each subfolder with both `NodeTypes/` and `Knowledge/` is an ontology).
+ */
+export const ONTOLOGY_ROOTS = [KNOWLEDGE_BASE_DIR, DATA_DIR];
+/** The `Knowledge/` marker subfolder of an ontology (holds the graph nodes). */
+export const KNOWLEDGE_DIR = 'Knowledge';
+/** The `NodeTypes/` marker subfolder of an ontology (holds the type definitions). */
+export const NODETYPE_DIR = 'NodeTypes';
+/** The marker subfolders that make a directory an ontology (it needs BOTH). */
+export const ONTOLOGY_MARKERS = new Set([KNOWLEDGE_DIR, NODETYPE_DIR]);
+// The implementation that resolves a path to its `Ontology` (`ontologyOf`) is
+// backend-only — it lives in `packages/backend/src/shared/kb-layout.ts`, built
+// from the `KNOWLEDGE_BASE_DIR` / `ONTOLOGY_MARKERS` constants above. This
+// package holds only the cross-cutting constants and types, not logic.
+//# sourceMappingURL=kb-layout.js.map

package/dist/workspace/kb-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-layout.js","sourceRoot":"","sources":["../../src/workspace/kb-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,qFAAqF;AACrF,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AAEjC;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE/B,0GAA0G;AAC1G,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,6GAA6G;AAC7G,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAEhF,gFAAgF;AAChF,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AAExC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;AAUvE,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,uEAAuE"}

package/dist/workspace/types.d.ts

@@ -0,0 +1,57 @@
+export interface WorkspaceInfo {
+    /**
+     * Workspace id = `encodeURIComponent(branch)`. Stable across users — a
+     * branch's workspace is shared by everyone editing it (PLAN §3).
+     * Decoding rule: callers can derive the branch via
+     * `decodeURIComponent(id)` without a backend round-trip.
+     */
+    id: string;
+    /** Display name. Currently the branch name verbatim. */
+    name: string;
+    /** Absolute path on the backend's filesystem (debug / log surface only). */
+    absolutePath: string;
+    /** ISO timestamp. Per-branch workspaces have no meaningful creation time; epoch is fine. */
+    createdAt: string;
+    /**
+     * Directory name (relative to `absolutePath`) where the KB clone lives.
+     * Configured via `KB_DIR_NAME` on the backend; surfaced to the frontend
+     * so renderers and chat cards can build correct KB-relative paths
+     * without hardcoding the repo name.
+     */
+    kbDirName: string;
+}
+export interface FileTreeEntry {
+    name: string;
+    relativePath: string;
+    type: 'file' | 'directory';
+    children?: FileTreeEntry[];
+}
+import type { AuthUser } from '../auth/types.js';
+export interface IWorkspaceService {
+    /**
+     * Get-or-create the workspace for a branch. Workspaces are per-branch
+     * (PLAN §3) — every user editing `branch` shares the same on-disk clone,
+     * coordinated by the file-lock service.
+     */
+    getOrCreateForBranch(branch: string): Promise<WorkspaceInfo>;
+    /**
+     * Convenience wrapper that defaults to the configured default branch
+     * (`DEFAULT_BRANCH`) when no branch is provided. Kept on the interface so route handlers that
+     * receive a logged-in user but no explicit branch can still bootstrap a
+     * workspace.
+     */
+    getOrCreateForUser(user: AuthUser, branch?: string): Promise<WorkspaceInfo>;
+    getMetadata(workspaceId: string): Promise<WorkspaceInfo | null>;
+    deleteWorkspace(workspaceId: string): Promise<void>;
+    listFiles(workspaceId: string): Promise<FileTreeEntry>;
+    readFile(workspaceId: string, relativePath: string): Promise<string>;
+    writeFile(workspaceId: string, relativePath: string, content: string): Promise<void>;
+    createDirectory(workspaceId: string, relativePath: string): Promise<void>;
+    writeFileBinary(workspaceId: string, relativePath: string, data: Uint8Array): Promise<void>;
+    deleteFile(workspaceId: string, relativePath: string): Promise<void>;
+    moveEntry(workspaceId: string, oldRelativePath: string, newRelativePath: string): Promise<void>;
+    getWorkspacePath(workspaceId: string): Promise<string>;
+    /** Remove the workspace's transient `tmp/` dir (staged docs, tool-chain spills). */
+    clearTmp(workspaceId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7D;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChE,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C"}

package/dist/workspace/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@bevel-software/platform-shared",
+  "version": "0.1.0",
+  "description": "Shared types and pure domain utilities of the Bevel core platform (auth, workspace, git/workflow contracts, branch registry).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=22 <23"
+  },
+  "dependencies": {
+    "ai": "^6.0.161"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Bevel-Software/skill-and-tool-management.git",
+    "directory": "packages/shared"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/auth/types.ts

@@ -0,0 +1,16 @@
+export interface AuthUser {
+  id: string;
+  email: string;
+  name: string;
+  avatarUrl?: string;
+}
+
+export interface LoginRequest {
+  email: string;
+  password: string;
+}
+
+export interface LoginResponse {
+  token: string;
+  user: AuthUser;
+}

package/src/chat/types.ts

@@ -0,0 +1,53 @@
+import type { UIMessage } from 'ai';
+import type { AuthUser } from '../auth/types.js';
+
+/**
+ * Domain-owned alias for the AI SDK v5 UIMessage shape.
+ *
+ * Backend and frontend both import `ChatUIMessage` rather than `UIMessage`
+ * directly so the seam is renameable if the SDK type shifts.
+ */
+export type ChatUIMessage = UIMessage;
+
+export interface ChatThread {
+  id: string;
+  title: string;
+  createdAt: number;
+  updatedAt: number;
+}
+
+// Calibrated for gpt-5.1 (~400k context) with current agent.instructions.ts size
+// + typical KB file tree. Lower than the raw window because the system prompt
+// and workspace state occupy ~40-80k before the user types. Re-tune if the
+// model changes or the system prompt grows materially.
+//
+// Both thresholds drive the agent's input processors in BaseAgentFactory:
+//   - softLimit  → SummaryCompactor recaps the middle of the transcript
+//   - hardLimit  → TokenLimiterProcessor backstops with truncation
+// The composer's context-usage gauge also reads these via the UsagePartData
+// emitted at end-of-turn.
+export const COMPACTION_SOFT_LIMIT_TOKENS = 200_000;
+export const COMPACTION_HARD_LIMIT_TOKENS = 350_000;
+
+/** Per-turn token usage attached to the assistant message via a `data-usage` part. */
+export interface UsagePartData {
+  used: number;
+  softLimit: number;
+  hardLimit: number;
+}
+
+export interface IChatService {
+  streamResponse(params: {
+    message: string;
+    resourceId: string;
+    threadId: string;
+    workspaceId: string;
+    /**
+     * Required — the agent authors every git commit as the user, and the
+     * author marker it pastes into PR bodies is derived from the user's email.
+     * Backend reads `user.name` and `user.email` unconditionally.
+     */
+    user: AuthUser;
+    abortSignal?: AbortSignal;
+  }): Promise<ReadableStream<unknown>>;
+}

package/src/git/branchAuthor.ts

@@ -0,0 +1,46 @@
+/**
+ * Derive the kebab-cased branch-author localpart from an email.
+ *
+ * The frontend's `slugifyDraftName` lowercases the email's localpart and
+ * replaces non-alphanumeric runs with `-` when building a new branch name
+ * (e.g. `Alice@example.com` → `alice/<slug>`, `john.doe@…` → `john-doe/…`).
+ * Authorship lookup must use the same transformation so a branch the user
+ * could create via the UI is also recognised as theirs on delete.
+ *
+ * Returns `null` when the email is missing or sanitizes to an empty string —
+ * authorship MUST NOT silently fall back to a default identity like `user`.
+ * If the helper returned a fallback, any user without a valid localpart
+ * would be granted ownership of every `user/...` branch on origin, which is
+ * the opposite of the safety property `isBranchAuthoredBy` is meant to
+ * provide. The frontend's `slugifyDraftName` can keep its UI-side `user`
+ * fallback at the call site because draft creation is not access-gated.
+ */
+export function branchAuthorLocalpart(
+  email: string | null | undefined,
+): string | null {
+  if (!email) return null;
+  const before = email.split('@')[0];
+  if (!before) return null;
+  const sanitized = before.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+  // Sanitized can be all dashes (`-`, `--`) when every char was non-alphanumeric;
+  // treat that as no usable identity.
+  if (!sanitized.replace(/-/g, '')) return null;
+  return sanitized;
+}
+
+/**
+ * True when `branchName` starts with `<email-localpart>/` — i.e. when the
+ * branch matches the UI-created draft convention for this user.
+ *
+ * The trailing `/` is REQUIRED: without it, `alice-extra/foo` would look
+ * authored by `alice@…`, and any user could delete branches whose prefix
+ * happens to start with their own localpart. Substring is not authorship.
+ */
+export function isBranchAuthoredBy(
+  branchName: string,
+  email: string | null | undefined,
+): boolean {
+  const localpart = branchAuthorLocalpart(email);
+  if (!localpart) return false;
+  return branchName.startsWith(`${localpart}/`);
+}