@jinion/core 0.5.0 → 0.5.1

package/dist/state/team.js

@@ -0,0 +1,4 @@
+import { atom } from 'jotai/vanilla';
+/** Whether the project belongs to a team, and what its user may do there; unknown until it was first checked. */
+export const teamAtom = atom(undefined);
+//# sourceMappingURL=team.js.map

package/dist/state/team.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.js","sourceRoot":"","sources":["../../src/state/team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,iHAAiH;AACjH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAwB,SAAS,CAAC,CAAC"}

package/dist/team/anchoring.d.ts

@@ -0,0 +1,9 @@
+import type { Decision } from './decision.js';
+import type { Git } from './history.js';
+/**
+ * The commit on `folder`'s branch that carries `draft`, however it was made: the first after its base that touches one
+ * of its paths, or the first at all for a draft without paths. A branch reset or rebased since the draft was recorded
+ * no longer has its base, so the search starts where the branch and the base part. Undefined while no commit carries it.
+ */
+export declare function anchorOf(folder: string, draft: Pick<Decision, 'baseCommit' | 'paths'>, git: Git): Promise<string | undefined>;
+//# sourceMappingURL=anchoring.d.ts.map

package/dist/team/anchoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchoring.d.ts","sourceRoot":"","sources":["../../src/team/anchoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,+BA2BrG"}

package/dist/team/anchoring.js

@@ -0,0 +1,26 @@
+/**
+ * The commit on `folder`'s branch that carries `draft`, however it was made: the first after its base that touches one
+ * of its paths, or the first at all for a draft without paths. A branch reset or rebased since the draft was recorded
+ * no longer has its base, so the search starts where the branch and the base part. Undefined while no commit carries it.
+ */
+export async function anchorOf(folder, draft, git) {
+    const succeeds = (args) => git(folder, args).then(() => true, () => false);
+    if (!draft.baseCommit || !(await succeeds(['cat-file', '-e', `${draft.baseCommit}^{commit}`])))
+        return undefined;
+    const base = (await succeeds(['merge-base', '--is-ancestor', draft.baseCommit, 'HEAD']))
+        ? draft.baseCommit
+        : (await git(folder, ['merge-base', draft.baseCommit, 'HEAD']).catch(() => '')).trim();
+    if (!base)
+        return undefined;
+    const log = await git(folder, ['log', '--reverse', '--ancestry-path', '--format=%x00%H', '--name-only', `${base}..HEAD`]);
+    const paths = new Set(draft.paths);
+    const commits = log
+        .split('\0')
+        .filter((chunk) => chunk.trim())
+        .map((chunk) => {
+        const [sha, ...files] = chunk.split('\n').filter(Boolean);
+        return { sha: sha, files };
+    });
+    return (paths.size === 0 ? commits[0] : commits.find((commit) => commit.files.some((file) => paths.has(file))))?.sha;
+}
+//# sourceMappingURL=anchoring.js.map

package/dist/team/anchoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchoring.js","sourceRoot":"","sources":["../../src/team/anchoring.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,KAA6C,EAAE,GAAQ;IACpG,MAAM,QAAQ,GAAG,CAAC,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CACzD,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;IAEF,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,WAAW,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAEjH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC,KAAK,CAAC,UAAU;QAClB,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzF,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC;IAC1H,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,GAAG;SAChB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1D,OAAO,EAAE,GAAG,EAAE,GAAI,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEL,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;AACvH,CAAC"}

package/dist/team/config.d.ts

@@ -0,0 +1,16 @@
+import { TeamConfig } from './types.js';
+export type FoundConfig = {
+    path: string;
+    config: TeamConfig;
+    problem?: undefined;
+} | {
+    path: string;
+    config?: undefined;
+    problem: string;
+};
+/** Where jinion.config.json is committed: git's top level, which a conversation's worktree has of its own; the folder itself outside git. */
+export declare function repositoryRoot(folder: string): string;
+/** The config at `root`, or why it can't be used; undefined where there is none. */
+export declare function readConfig(root: string): FoundConfig | undefined;
+export declare function writeConfig(root: string, ids: Pick<TeamConfig, 'workspaceId' | 'projectId'>): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/team/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/team/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkC,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5I,6IAA6I;AAC7I,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,UAS5C;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAehE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,WAAW,CAAC,UAM3F"}

package/dist/team/config.js

@@ -0,0 +1,37 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { z } from 'zod';
+import { CONFIG_FILE, CONFIG_SCHEMA_URL, TeamConfig } from './types.js';
+/** Where jinion.config.json is committed: git's top level, which a conversation's worktree has of its own; the folder itself outside git. */
+export function repositoryRoot(folder) {
+    try {
+        // Relative, so the root is spelled like `folder` even through a symlink.
+        const up = execFileSync('git', ['rev-parse', '--show-cdup'], { cwd: folder, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        return resolve(folder, up);
+    }
+    catch {
+        return folder;
+    }
+}
+/** The config at `root`, or why it can't be used; undefined where there is none. */
+export function readConfig(root) {
+    const path = join(root, CONFIG_FILE);
+    if (!existsSync(path))
+        return undefined;
+    let json;
+    try {
+        json = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return { path, problem: `${CONFIG_FILE} isn’t valid JSON.` };
+    }
+    const parsed = TeamConfig.safeParse(json);
+    return parsed.success ? { path, config: parsed.data } : { path, problem: `${CONFIG_FILE} doesn’t fit its schema:\n${z.prettifyError(parsed.error)}` };
+}
+export function writeConfig(root, ids) {
+    const path = join(root, CONFIG_FILE);
+    writeFileSync(path, `${JSON.stringify({ $schema: CONFIG_SCHEMA_URL, workspaceId: ids.workspaceId, projectId: ids.projectId }, null, 2)}\n`);
+    return path;
+}
+//# sourceMappingURL=config.js.map

package/dist/team/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/team/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxE,6IAA6I;AAC7I,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC;QACH,yEAAyE;QACzE,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5I,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAExC,IAAI,IAAa,CAAC;IAElB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,oBAAoB,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAE1C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,6BAA6B,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AACxJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAkD;IAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAErC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAE5I,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/team/decision.d.ts

@@ -0,0 +1,255 @@
+import { z } from 'zod';
+/** `asked`: the user answered a question or approved a plan; `requested`: the user asked for it; `agent`: the agent's own call. */
+export declare const DecisionOrigin: z.ZodEnum<{
+    agent: "agent";
+    asked: "asked";
+    requested: "requested";
+}>;
+export type DecisionOrigin = z.infer<typeof DecisionOrigin>;
+/** How a decision came about, in the words its user reads in the apps. */
+export declare const ORIGIN_WORDS: Record<DecisionOrigin, string>;
+/** A `draft` is its author's alone until a commit carries it; `superseded` and `archived` bind no one. */
+export declare const DecisionStatus: z.ZodEnum<{
+    active: "active";
+    archived: "archived";
+    draft: "draft";
+    superseded: "superseded";
+}>;
+export type DecisionStatus = z.infer<typeof DecisionStatus>;
+/** A commit a decision is in; the pull request fields come from the GitHub App, when a project has it. */
+export declare const DecisionAnchor: z.ZodObject<{
+    sha: z.ZodString;
+    kind: z.ZodEnum<{
+        commit: "commit";
+        merge: "merge";
+    }>;
+    pullRequest: z.ZodNullable<z.ZodNumber>;
+    pullRequestState: z.ZodNullable<z.ZodEnum<{
+        closed: "closed";
+        merged: "merged";
+        open: "open";
+    }>>;
+    baseBranch: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type DecisionAnchor = z.infer<typeof DecisionAnchor>;
+/** Why a project's code is the way it is, as an agent recorded it, at api.jinion.co. */
+export declare const Decision: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    decision: z.ZodString;
+    reason: z.ZodString;
+    turnedDown: z.ZodNullable<z.ZodString>;
+    origin: z.ZodEnum<{
+        agent: "agent";
+        asked: "asked";
+        requested: "requested";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+        draft: "draft";
+        superseded: "superseded";
+    }>;
+    author: z.ZodNullable<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodNullable<z.ZodString>;
+        email: z.ZodString;
+    }, z.core.$strip>>;
+    backend: z.ZodString;
+    model: z.ZodString;
+    branch: z.ZodNullable<z.ZodString>;
+    baseCommit: z.ZodNullable<z.ZodString>;
+    paths: z.ZodArray<z.ZodString>;
+    symbols: z.ZodArray<z.ZodString>;
+    supersedes: z.ZodNullable<z.ZodString>;
+    supersededBy: z.ZodNullable<z.ZodString>;
+    anchors: z.ZodArray<z.ZodObject<{
+        sha: z.ZodString;
+        kind: z.ZodEnum<{
+            commit: "commit";
+            merge: "merge";
+        }>;
+        pullRequest: z.ZodNullable<z.ZodNumber>;
+        pullRequestState: z.ZodNullable<z.ZodEnum<{
+            closed: "closed";
+            merged: "merged";
+            open: "open";
+        }>>;
+        baseBranch: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    version: z.ZodString;
+}, z.core.$strip>;
+export type Decision = z.infer<typeof Decision>;
+/** What a client sends to record one; `anchors` when a commit already carries it, which makes it active at once. */
+export declare const DecisionDraft: z.ZodObject<{
+    title: z.ZodString;
+    decision: z.ZodString;
+    reason: z.ZodString;
+    turnedDown: z.ZodOptional<z.ZodString>;
+    origin: z.ZodEnum<{
+        agent: "agent";
+        asked: "asked";
+        requested: "requested";
+    }>;
+    backend: z.ZodString;
+    model: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    baseCommit: z.ZodOptional<z.ZodString>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    anchors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supersedes: z.ZodOptional<z.ZodString>;
+    repository: z.ZodObject<{
+        remoteUrl: z.ZodString;
+        rootCommit: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DecisionDraft = z.infer<typeof DecisionDraft>;
+/** A decision deleted since a client synced it, which it drops from its copy. */
+export declare const DecisionTombstone: z.ZodObject<{
+    id: z.ZodString;
+    deleted: z.ZodLiteral<true>;
+    version: z.ZodString;
+}, z.core.$strip>;
+export type DecisionTombstone = z.infer<typeof DecisionTombstone>;
+/**
+ * Where a decision stands for the HEAD a session works on, from git alone. `binding`: a commit HEAD has carries it, so
+ * the agent keeps to it. `not-pulled`: the branch's upstream has it, as of the last fetch. `other-branch`: it waits on
+ * another branch or in a pull request. `dropped`: archived, superseded, or its pull request closed unmerged; not shown.
+ * `draft`: the user's own, not in a commit yet.
+ */
+export declare const DecisionState: z.ZodEnum<{
+    binding: "binding";
+    draft: "draft";
+    dropped: "dropped";
+    "not-pulled": "not-pulled";
+    "other-branch": "other-branch";
+}>;
+export type DecisionState = z.infer<typeof DecisionState>;
+/** A session's view of the project's decisions: those shown, in the order of their states, and how many are in each. */
+export declare const SortedDecisions: z.ZodObject<{
+    decisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        decision: z.ZodString;
+        reason: z.ZodString;
+        turnedDown: z.ZodNullable<z.ZodString>;
+        origin: z.ZodEnum<{
+            agent: "agent";
+            asked: "asked";
+            requested: "requested";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+            draft: "draft";
+            superseded: "superseded";
+        }>;
+        author: z.ZodNullable<z.ZodObject<{
+            id: z.ZodNumber;
+            name: z.ZodNullable<z.ZodString>;
+            email: z.ZodString;
+        }, z.core.$strip>>;
+        backend: z.ZodString;
+        model: z.ZodString;
+        branch: z.ZodNullable<z.ZodString>;
+        baseCommit: z.ZodNullable<z.ZodString>;
+        paths: z.ZodArray<z.ZodString>;
+        symbols: z.ZodArray<z.ZodString>;
+        supersedes: z.ZodNullable<z.ZodString>;
+        supersededBy: z.ZodNullable<z.ZodString>;
+        anchors: z.ZodArray<z.ZodObject<{
+            sha: z.ZodString;
+            kind: z.ZodEnum<{
+                commit: "commit";
+                merge: "merge";
+            }>;
+            pullRequest: z.ZodNullable<z.ZodNumber>;
+            pullRequestState: z.ZodNullable<z.ZodEnum<{
+                closed: "closed";
+                merged: "merged";
+                open: "open";
+            }>>;
+            baseBranch: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        version: z.ZodString;
+        state: z.ZodEnum<{
+            binding: "binding";
+            draft: "draft";
+            dropped: "dropped";
+            "not-pulled": "not-pulled";
+            "other-branch": "other-branch";
+        }>;
+    }, z.core.$strip>>;
+    counts: z.ZodRecord<z.ZodEnum<{
+        binding: "binding";
+        draft: "draft";
+        dropped: "dropped";
+        "not-pulled": "not-pulled";
+        "other-branch": "other-branch";
+    }>, z.ZodNumber>;
+}, z.core.$strip>;
+export type SortedDecisions = z.infer<typeof SortedDecisions>;
+/** What changed since a cursor, oldest first; `more` asks for the next page from `cursor`. */
+export declare const DecisionChanges: z.ZodObject<{
+    changes: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        decision: z.ZodString;
+        reason: z.ZodString;
+        turnedDown: z.ZodNullable<z.ZodString>;
+        origin: z.ZodEnum<{
+            agent: "agent";
+            asked: "asked";
+            requested: "requested";
+        }>;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+            draft: "draft";
+            superseded: "superseded";
+        }>;
+        author: z.ZodNullable<z.ZodObject<{
+            id: z.ZodNumber;
+            name: z.ZodNullable<z.ZodString>;
+            email: z.ZodString;
+        }, z.core.$strip>>;
+        backend: z.ZodString;
+        model: z.ZodString;
+        branch: z.ZodNullable<z.ZodString>;
+        baseCommit: z.ZodNullable<z.ZodString>;
+        paths: z.ZodArray<z.ZodString>;
+        symbols: z.ZodArray<z.ZodString>;
+        supersedes: z.ZodNullable<z.ZodString>;
+        supersededBy: z.ZodNullable<z.ZodString>;
+        anchors: z.ZodArray<z.ZodObject<{
+            sha: z.ZodString;
+            kind: z.ZodEnum<{
+                commit: "commit";
+                merge: "merge";
+            }>;
+            pullRequest: z.ZodNullable<z.ZodNumber>;
+            pullRequestState: z.ZodNullable<z.ZodEnum<{
+                closed: "closed";
+                merged: "merged";
+                open: "open";
+            }>>;
+            baseBranch: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        deleted: z.ZodLiteral<true>;
+        version: z.ZodString;
+    }, z.core.$strip>]>>;
+    cursor: z.ZodString;
+    more: z.ZodBoolean;
+}, z.core.$strip>;
+export type DecisionChanges = z.infer<typeof DecisionChanges>;
+//# sourceMappingURL=decision.d.ts.map

package/dist/team/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../src/team/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mIAAmI;AACnI,eAAO,MAAM,cAAc;;;;EAA0C,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAmF,CAAC;AAE5I,0GAA0G;AAC1G,eAAO,MAAM,cAAc;;;;;EAAwD,CAAC;AAEpF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,0GAA0G;AAC1G,eAAO,MAAM,cAAc;;;;;;;;;;;;;iBAOzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,wFAAwF;AACxF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyBnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,oHAAoH;AACpH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;iBAgBxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,iFAAiF;AACjF,eAAO,MAAM,iBAAiB;;;;iBAA8E,CAAC;AAE7G,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;EAAwE,CAAC;AAEnG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,wHAAwH;AACxH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,8FAA8F;AAC9F,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/team/decision.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+/** `asked`: the user answered a question or approved a plan; `requested`: the user asked for it; `agent`: the agent's own call. */
+export const DecisionOrigin = z.enum(['asked', 'requested', 'agent']);
+/** How a decision came about, in the words its user reads in the apps. */
+export const ORIGIN_WORDS = { requested: 'you asked for it', asked: 'from your answer', agent: 'its call' };
+/** A `draft` is its author's alone until a commit carries it; `superseded` and `archived` bind no one. */
+export const DecisionStatus = z.enum(['draft', 'active', 'superseded', 'archived']);
+/** A commit a decision is in; the pull request fields come from the GitHub App, when a project has it. */
+export const DecisionAnchor = z.object({
+    sha: z.string(),
+    /** `commit` from its author's client, `merge` from the GitHub App after a squash or rebase merge. */
+    kind: z.enum(['commit', 'merge']),
+    pullRequest: z.number().int().nullable(),
+    pullRequestState: z.enum(['open', 'merged', 'closed']).nullable(),
+    baseBranch: z.string().nullable(),
+});
+/** Why a project's code is the way it is, as an agent recorded it, at api.jinion.co. */
+export const Decision = z.object({
+    id: z.string(),
+    title: z.string(),
+    decision: z.string(),
+    reason: z.string(),
+    /** The alternatives and why they lost. */
+    turnedDown: z.string().nullable(),
+    origin: DecisionOrigin,
+    status: DecisionStatus,
+    /** Null once its author's account is gone. */
+    author: z.object({ id: z.number(), name: z.string().nullable(), email: z.string() }).nullable(),
+    backend: z.string(),
+    model: z.string(),
+    /** Where it was made, and HEAD then. */
+    branch: z.string().nullable(),
+    baseCommit: z.string().nullable(),
+    paths: z.array(z.string()),
+    symbols: z.array(z.string()),
+    supersedes: z.string().nullable(),
+    supersededBy: z.string().nullable(),
+    anchors: z.array(DecisionAnchor),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    /** The sync cursor this change has; a later change has a larger one. */
+    version: z.string(),
+});
+/** What a client sends to record one; `anchors` when a commit already carries it, which makes it active at once. */
+export const DecisionDraft = z.object({
+    title: z.string(),
+    decision: z.string(),
+    reason: z.string(),
+    turnedDown: z.string().optional(),
+    origin: DecisionOrigin,
+    backend: z.string(),
+    model: z.string(),
+    branch: z.string().optional(),
+    baseCommit: z.string().optional(),
+    paths: z.array(z.string()).optional(),
+    symbols: z.array(z.string()).optional(),
+    anchors: z.array(z.string()).optional(),
+    supersedes: z.string().optional(),
+    /** The clone it is written from, which has to be the project's repository. */
+    repository: z.object({ remoteUrl: z.string(), rootCommit: z.string() }),
+});
+/** A decision deleted since a client synced it, which it drops from its copy. */
+export const DecisionTombstone = z.object({ id: z.string(), deleted: z.literal(true), version: z.string() });
+/**
+ * Where a decision stands for the HEAD a session works on, from git alone. `binding`: a commit HEAD has carries it, so
+ * the agent keeps to it. `not-pulled`: the branch's upstream has it, as of the last fetch. `other-branch`: it waits on
+ * another branch or in a pull request. `dropped`: archived, superseded, or its pull request closed unmerged; not shown.
+ * `draft`: the user's own, not in a commit yet.
+ */
+export const DecisionState = z.enum(['binding', 'not-pulled', 'other-branch', 'dropped', 'draft']);
+/** A session's view of the project's decisions: those shown, in the order of their states, and how many are in each. */
+export const SortedDecisions = z.object({
+    decisions: z.array(Decision.extend({ state: DecisionState })),
+    counts: z.record(DecisionState, z.number().int()),
+});
+/** What changed since a cursor, oldest first; `more` asks for the next page from `cursor`. */
+export const DecisionChanges = z.object({
+    changes: z.array(z.union([Decision, DecisionTombstone])),
+    cursor: z.string(),
+    more: z.boolean(),
+});
+//# sourceMappingURL=decision.js.map

package/dist/team/decision.js.map

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

package/dist/team/decisions.d.ts

@@ -0,0 +1,98 @@
+import type { JinionAccount } from '../jinion-account/account.js';
+import type { Decision, DecisionDraft } from './decision.js';
+import type { RepositoryIdentity } from './repository.js';
+/**
+ * The project's decisions, as a copy under ~/.jinion that its sessions read without a network: never in the repository,
+ * kept up to date from api.jinion.co, and gone once the user loses access.
+ */
+export declare class DecisionStore {
+    readonly projectId: string;
+    private readonly account;
+    /** After every change to the copy, such as one a sync took in. */
+    private readonly changed;
+    private readonly file;
+    constructor(projectId: string, account: JinionAccount, 
+    /** After every change to the copy, such as one a sync took in. */
+    changed?: () => void);
+    all(): {
+        id: string;
+        title: string;
+        decision: string;
+        reason: string;
+        turnedDown: string | null;
+        origin: "agent" | "asked" | "requested";
+        status: "active" | "archived" | "draft" | "superseded";
+        author: {
+            id: number;
+            name: string | null;
+            email: string;
+        } | null;
+        backend: string;
+        model: string;
+        branch: string | null;
+        baseCommit: string | null;
+        paths: string[];
+        symbols: string[];
+        supersedes: string | null;
+        supersededBy: string | null;
+        anchors: {
+            sha: string;
+            kind: "commit" | "merge";
+            pullRequest: number | null;
+            pullRequestState: "closed" | "merged" | "open" | null;
+            baseBranch: string | null;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+        version: string;
+    }[];
+    get(id: string): {
+        id: string;
+        title: string;
+        decision: string;
+        reason: string;
+        turnedDown: string | null;
+        origin: "agent" | "asked" | "requested";
+        status: "active" | "archived" | "draft" | "superseded";
+        author: {
+            id: number;
+            name: string | null;
+            email: string;
+        } | null;
+        backend: string;
+        model: string;
+        branch: string | null;
+        baseCommit: string | null;
+        paths: string[];
+        symbols: string[];
+        supersedes: string | null;
+        supersededBy: string | null;
+        anchors: {
+            sha: string;
+            kind: "commit" | "merge";
+            pullRequest: number | null;
+            pullRequestState: "closed" | "merged" | "open" | null;
+            baseBranch: string | null;
+        }[];
+        createdAt: string;
+        updatedAt: string;
+        version: string;
+    } | undefined;
+    /** Sends what waits, then takes in every change since the last sync. */
+    sync(): Promise<void>;
+    /** Sent at once; while the API can't be reached, kept here under a local id and sent with the next sync. */
+    record(draft: DecisionDraft): Promise<Decision>;
+    delete(id: string): Promise<void>;
+    /** Its author's client telling which commit carries it; offline, it is anchored again at the next check. */
+    anchor(id: string, shas: string[], repository: RepositoryIdentity): Promise<void>;
+    /** As the user lost access to the project, or signed out. */
+    purge(): void;
+    /** The waiting writes in order, until the API can't be reached again; one it refuses for good is dropped. */
+    private flush;
+    private send;
+    /** How a decision recorded offline shows until the API has it: its author's draft. */
+    private waiting;
+    private saved;
+    private update;
+}
+//# sourceMappingURL=decisions.d.ts.map

package/dist/team/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/team/decisions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAgB1D;;;GAGG;AACH,qBAAa,aAAa;IAItB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,YACW,SAAS,EAAE,MAAM,EACT,OAAO,EAAE,aAAa;IACvC,kEAAkE;IACjD,OAAO,GAAE,MAAM,IAAe,EAGhD;IAED,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEF;IAED,GAAG,CAAC,EAAE,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAIb;IAED,wEAAwE;IAClE,IAAI,kBAmBT;IAED,4GAA4G;IACtG,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgBpD;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,iBAkBtB;IAED,4GAA4G;IACtG,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,kBAAkB,iBAQtE;IAED,6DAA6D;IAC7D,KAAK,SAEJ;IAED,6GAA6G;YAC/F,KAAK;YAgBL,IAAI;IAYlB,sFAAsF;IACtF,OAAO,CAAC,OAAO;IA4Bf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,MAAM;CAIf"}