@software-dlc/cli 0.157.2

package/dist/local/local-org-store.js

@@ -0,0 +1,132 @@
+export class LocalOrgStore {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    /** The root hash of the org's governance graph, or null when it has none. */
+    root(org_id) {
+        const row = this.database
+            .prepare('select root_hash from local_governance_graph where org_id = ?')
+            .get(org_id);
+        return row?.root_hash ?? null;
+    }
+    holders(org_id) {
+        return this.database
+            .prepare(`select post_id, member_kind, member_id, held_since
+             from local_org_post_holder where org_id = ?
+            order by post_id, held_since, member_kind, member_id`)
+            .all(org_id).map((row) => ({
+            post_id: row.post_id,
+            member: { id: row.member_id, kind: row.member_kind },
+            held_since: row.held_since
+        }));
+    }
+    /**
+     * Runs `run` in one write transaction, so a check of the graph's root and
+     * its holders and the change it allows cannot interleave with another
+     * writer's.
+     */
+    write(run) {
+        this.database.exec('begin immediate');
+        try {
+            const result = run();
+            this.database.exec('commit');
+            return result;
+        }
+        catch (error) {
+            this.database.exec('rollback');
+            throw error;
+        }
+    }
+    /**
+     * Points the org at a new graph root if its root is still `expected` (null:
+     * the org has no graph yet). Call it inside `write`.
+     */
+    setRoot(org_id, expected, root_hash) {
+        const current = this.root(org_id);
+        if (current !== expected) {
+            throw new Error('The local org changed while this command ran; run it again.');
+        }
+        this.database
+            .prepare(`insert into local_governance_graph (org_id, root_hash, updated_at)
+         values (?, ?, ?)
+         on conflict(org_id) do update set
+           root_hash = excluded.root_hash, updated_at = excluded.updated_at`)
+            .run(org_id, root_hash, new Date().toISOString());
+    }
+    /** Adds a holder; false when the member already holds the post. */
+    addHolder(org_id, holder) {
+        const result = this.database
+            .prepare(`insert into local_org_post_holder
+           (org_id, post_id, member_kind, member_id, held_since)
+         values (?, ?, ?, ?, ?)
+         on conflict do nothing`)
+            .run(org_id, holder.post_id, holder.member.kind, holder.member.id, holder.held_since);
+        return Number(result.changes) > 0;
+    }
+    /** The team id the org's one project names as its owner, or null when none is set. */
+    projectTeam(org_id) {
+        const row = this.database
+            .prepare('select team_id from local_org_project where org_id = ?')
+            .get(org_id);
+        return row?.team_id ?? null;
+    }
+    setProjectTeam(org_id, team_id) {
+        this.database
+            .prepare(`insert into local_org_project (org_id, team_id, set_at)
+         values (?, ?, ?)
+         on conflict(org_id) do update set
+           team_id = excluded.team_id, set_at = excluded.set_at`)
+            .run(org_id, team_id, new Date().toISOString());
+    }
+    /** The project's slot overrides, one per slot, posts in id order. */
+    overrides(org_id) {
+        const rows = this.database
+            .prepare(`select slot_id, post_id, reason, set_by_kind, set_by_id, set_at
+           from local_org_slot_binding where org_id = ?
+          order by slot_id, post_id`)
+            .all(org_id);
+        const by_slot = new Map();
+        for (const row of rows) {
+            const entry = by_slot.get(row.slot_id);
+            if (entry) {
+                entry.post_ids.push(row.post_id);
+                continue;
+            }
+            by_slot.set(row.slot_id, {
+                slot_id: row.slot_id,
+                post_ids: [row.post_id],
+                reason: row.reason,
+                set_by: { id: row.set_by_id, kind: row.set_by_kind },
+                set_at: row.set_at
+            });
+        }
+        return [...by_slot.values()];
+    }
+    /** Replaces a slot's override with `override`. Call it inside `write`. */
+    setOverride(org_id, override) {
+        this.clearOverride(org_id, override.slot_id);
+        const insert = this.database.prepare(`insert into local_org_slot_binding
+         (org_id, slot_id, post_id, reason, set_by_kind, set_by_id, set_at)
+       values (?, ?, ?, ?, ?, ?, ?)`);
+        for (const post_id of new Set(override.post_ids)) {
+            insert.run(org_id, override.slot_id, post_id, override.reason, override.set_by.kind, override.set_by.id, override.set_at);
+        }
+    }
+    /** Drops a slot's override; false when it had none. */
+    clearOverride(org_id, slot_id) {
+        const result = this.database
+            .prepare('delete from local_org_slot_binding where org_id = ? and slot_id = ?')
+            .run(org_id, slot_id);
+        return Number(result.changes) > 0;
+    }
+    /** Removes a holder; false when the member did not hold the post. */
+    removeHolder(org_id, post_id, member) {
+        const result = this.database
+            .prepare(`delete from local_org_post_holder
+          where org_id = ? and post_id = ? and member_kind = ? and member_id = ?`)
+            .run(org_id, post_id, member.kind, member.id);
+        return Number(result.changes) > 0;
+    }
+}
+//# sourceMappingURL=local-org-store.js.map

package/dist/local/local-org-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-org-store.js","sourceRoot":"","sources":["../../src/local/local-org-store.ts"],"names":[],"mappings":"AAgCA,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,QAAqC;QAArC,aAAQ,GAAR,QAAQ,CAA6B;IAAG,CAAC;IAEtE,6EAA6E;IAC7E,IAAI,CAAC,MAAc;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ;aACtB,OAAO,CAAC,+DAA+D,CAAC;aACxE,GAAG,CAAC,MAAM,CAAsC,CAAC;QACpD,OAAO,GAAG,EAAE,SAAS,IAAI,IAAI,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,OACE,IAAI,CAAC,QAAQ;aACV,OAAO,CACN;;iEAEuD,CACxD;aACA,GAAG,CAAC,MAAM,CACd,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE;YACpD,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAI,GAAY;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,MAAc,EAAE,QAAuB,EAAE,SAAiB;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,QAAQ;aACV,OAAO,CACN;;;4EAGoE,CACrE;aACA,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,mEAAmE;IACnE,SAAS,CAAC,MAAc,EAAE,MAAsB;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ;aACzB,OAAO,CACN;;;gCAGwB,CACzB;aACA,GAAG,CACF,MAAM,EACN,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,MAAM,CAAC,IAAI,EAClB,MAAM,CAAC,MAAM,CAAC,EAAE,EAChB,MAAM,CAAC,UAAU,CAClB,CAAC;QACJ,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,sFAAsF;IACtF,WAAW,CAAC,MAAc;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ;aACtB,OAAO,CAAC,wDAAwD,CAAC;aACjE,GAAG,CAAC,MAAM,CAAoC,CAAC;QAClD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,OAAe;QAC5C,IAAI,CAAC,QAAQ;aACV,OAAO,CACN;;;gEAGwD,CACzD;aACA,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,MAAc;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ;aACvB,OAAO,CACN;;oCAE4B,CAC7B;aACA,GAAG,CAAC,MAAM,CAAiB,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;QACnD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACjC,SAAS;YACX,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE;gBACvB,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;gBACvB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE;gBACpD,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,0EAA0E;IAC1E,WAAW,CACT,MAAc,EACd,QAAiE;QAEjE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAClC;;oCAE8B,CAC/B,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,CACR,MAAM,EACN,QAAQ,CAAC,OAAO,EAChB,OAAO,EACP,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,MAAM,CAAC,IAAI,EACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,EAClB,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,aAAa,CAAC,MAAc,EAAE,OAAe;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ;aACzB,OAAO,CACN,qEAAqE,CACtE;aACA,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,qEAAqE;IACrE,YAAY,CAAC,MAAc,EAAE,OAAe,EAAE,MAAiB;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ;aACzB,OAAO,CACN;iFACyE,CAC1E;aACA,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/local/local-org.d.ts

@@ -0,0 +1,389 @@
+import { type OrgHolderRules, type OrgMember, type OrgSlotOverride, type OrgStructure } from '@software-dlc/graph/computation';
+import type { PortableGraph } from '@software-dlc/graph/types';
+import type { LocalOrgHolder } from './local-org-store.js';
+import { LocalWorkspaceGraphStore } from './workspace-graph-store.js';
+import { LocalWorkspaceStore } from './workspace-store.js';
+/**
+ * The local org (org-structure-and-access.md, Local org without an org
+ * connection; osa-local-org): a workspace with no org connection plans a
+ * theoretical org whose posts its local person and local agents hold. Its
+ * definitions are a governance graph in the repository store, never a project
+ * graph, and its holders are rows beside it (local-org-store.ts). Every
+ * answer comes from the shared resolution in @software-dlc/graph/computation,
+ * so local and hosted orgs cannot disagree.
+ */
+/** The local Home's pseudo-org id (app-shell-readers.ts); one local org per repository store. */
+export declare const LOCAL_ORG_ID = "local";
+/** The person running locally, as workflow.json names them. */
+export declare const LOCAL_PERSON: OrgMember;
+export type WorkflowRoles = {
+    roles: {
+        key: string;
+        name: string;
+        description?: string;
+    }[];
+    /** The person and agent holders a local org seeds; a team holder has no local members to seed. */
+    holders: Record<string, OrgMember[]>;
+    /** Every holder kind each role lists, team included, for the person rules. */
+    holder_kinds: Record<string, string[]>;
+    gates: {
+        gate: string;
+        role: string;
+    }[];
+};
+/** The roles, holders and gates of a workflow.json (scripts/agent-coordination/workflow.json). */
+export declare function parseWorkflowRoles(value: unknown): WorkflowRoles;
+/**
+ * The roles whose gates need a person: a role that holds a gate and has a
+ * holder other than an agent (a person or a team), the rule
+ * planning_gate.derive_approvals gives the user a gate by.
+ */
+export declare function personGateRoles(workflow: WorkflowRoles): Set<string>;
+/**
+ * The holder rules a local org checks: the gate slots are the slots keyed by
+ * a person-gate role, and the posts the project's overrides bind to one
+ * decide that gate too (osa_slots_ac_4).
+ */
+export declare function localOrgRules(graph: PortableGraph, workflow: WorkflowRoles | null, overrides?: readonly OrgSlotOverride[]): OrgHolderRules;
+/** A governance key made from a name: lowercase, dashes for other characters, starting with a letter. */
+export declare function keyFromName(name: string): string;
+export type DefinitionInput = {
+    key: string;
+    label?: string;
+    description?: string;
+};
+export declare function addTeam(graph: PortableGraph, input: DefinitionInput & {
+    parent?: string;
+}): PortableGraph;
+export declare function addJobFunction(graph: PortableGraph, input: DefinitionInput & {
+    parent?: string;
+    fills?: string[];
+    requires_person?: boolean;
+    escalable?: boolean;
+}): PortableGraph;
+export declare function addSlot(graph: PortableGraph, input: DefinitionInput): PortableGraph;
+/** A post's name: its team's key and its job function's key, `team/function`. */
+export declare function postName(graph: PortableGraph, structure: OrgStructure, post_id: string): string;
+/** The post a name means; an unknown team, function or post is refused. */
+export declare function postIdOf(graph: PortableGraph, structure: OrgStructure, name: string): string;
+export declare function addPost(graph: PortableGraph, input: {
+    name: string;
+    label?: string;
+}): PortableGraph;
+/**
+ * Throws, naming each reason, unless `member` may take the post: the shared
+ * holder rules, and one id per member across people and agents.
+ */
+export declare function assertMayHold(graph: PortableGraph, holders: readonly LocalOrgHolder[], post_id: string, member: OrgMember, rules: OrgHolderRules): void;
+export declare function assertMayRelease(graph: PortableGraph, holders: readonly LocalOrgHolder[], post_id: string, member: OrgMember, rules: OrgHolderRules): void;
+/**
+ * Throws, naming each post, when a post whose function has child functions
+ * has more than one holder: a graph edit, not only a hold, can make one so.
+ */
+export declare function assertOneHolderWithReports(graph: PortableGraph, holders: readonly LocalOrgHolder[]): void;
+/** The seeded org's top job function, which the local person holds. */
+export declare const ORG_LEAD = "org-lead";
+/**
+ * A local org planned from a workflow's roles (osa_local_ac_1): a root team
+ * named for the org; an org lead function, held by the local person, so each
+ * agent's line reaches a person (OSA-07); for each role a slot and a job
+ * function filling it under the org lead, with a post in the root team; and
+ * the workflow's people and agents holding those posts. A role held only by
+ * people or teams seeds a function that requires a person.
+ */
+export declare function seedLocalOrg(workflow: WorkflowRoles, org: {
+    name: string;
+}, held_since?: string): {
+    graph: PortableGraph;
+    holders: LocalOrgHolder[];
+};
+/** How each slot resolves (osa_local_ac_3), or one slot by key; an unknown slot or team is refused. */
+export declare function resolveLocalSlots(graph: PortableGraph, holders: readonly LocalOrgHolder[], rules: OrgHolderRules, input?: {
+    slot?: string;
+    team?: string;
+}): ({
+    slot: string;
+    status: "uncovered";
+    posts?: undefined;
+} | {
+    slot: string;
+    status: "vacant";
+    posts: string[];
+} | {
+    needs_person?: boolean | undefined;
+    slot: string;
+    status: "covered";
+    posts: {
+        post: string;
+        holders: OrgMember[];
+    }[];
+})[];
+/** The whole local org: definitions, posts with their holders and lines, members' positions, and slots. */
+export declare function describeLocalOrg(graph: PortableGraph, holders: readonly LocalOrgHolder[], rules: OrgHolderRules): {
+    teams: {
+        key: string;
+        label: string;
+        parent: string | null;
+    }[];
+    job_functions: {
+        key: string;
+        label: string;
+        parent: string | null;
+        fills: string[];
+        requires_person: boolean;
+        escalable: boolean;
+    }[];
+    slots: {
+        key: string;
+        label: string;
+        gate: boolean;
+    }[];
+    posts: {
+        post: string;
+        label: string;
+        reports_to: string | {
+            vacant: string;
+        };
+        holders: {
+            held_since: string;
+            id: string;
+            kind: import("@software-dlc/graph/computation").OrgMemberKind;
+        }[];
+    }[];
+    members: {
+        accountable_person?: OrgMember | null | undefined;
+        posts: {
+            post: string;
+            reports_to: string | {
+                vacant: string;
+            };
+            primary: boolean;
+            dotted: boolean;
+        }[];
+        id: string;
+        kind: import("@software-dlc/graph/computation").OrgMemberKind;
+    }[];
+    slot_resolution: ({
+        slot: string;
+        status: "uncovered";
+        posts?: undefined;
+    } | {
+        slot: string;
+        status: "vacant";
+        posts: string[];
+    } | {
+        needs_person?: boolean | undefined;
+        slot: string;
+        status: "covered";
+        posts: {
+            post: string;
+            holders: OrgMember[];
+        }[];
+    })[];
+};
+/** The repository store a local org lives in, for the repository at `cwd`. */
+export type LocalOrgRepository = {
+    store: LocalWorkspaceStore;
+    graphs: LocalWorkspaceGraphStore;
+    /** The org's name, as the local Home shows it. */
+    name: string;
+    /** The checkout the command runs in, where workflow.json is read by default; null with no work tree. */
+    checkout: string | null;
+};
+export declare function openLocalOrgRepository(input: {
+    cwd: string;
+    state_dir?: string;
+}): Promise<LocalOrgRepository>;
+export declare function readWorkflowRoles(path: string): Promise<WorkflowRoles | null>;
+/** Where workflow.json is read by default; null with no work tree, which has no default workflow. */
+export declare function defaultWorkflowPath(repository: LocalOrgRepository): string | null;
+/**
+ * The org's graph, holders, and its project's stored owning team and slot
+ * overrides, or null when it has no graph yet.
+ */
+export declare function readLocalOrg(repository: LocalOrgRepository): Promise<{
+    root: string;
+    graph: PortableGraph;
+    holders: LocalOrgHolder[];
+    project_team: string | null;
+    overrides: OrgSlotOverride[];
+} | null>;
+declare const NO_ORG = "This repository has no local org yet: plan one with sdlc org seed, or start one with sdlc org add team <key>.";
+/**
+ * Changes the org's graph: writes the new graph object, then moves the root
+ * from the one read with a check-and-set, under the object store lock so a
+ * prune cannot remove the object in between. `seed` writes holders too, and
+ * only into an org with no graph.
+ */
+export declare function changeLocalOrg(repository: LocalOrgRepository, change: (graph: PortableGraph | null) => {
+    graph: PortableGraph;
+    holders?: LocalOrgHolder[];
+}): Promise<{
+    root: string;
+    graph: PortableGraph;
+}>;
+/** Adds to an existing org's graph, or starts one with its first team. */
+export declare function onOrg(graph: PortableGraph | null, starts_org: boolean): PortableGraph;
+/**
+ * Changes who holds a post: checks the post and the rules against the graph
+ * and holders as they stand, inside one write transaction, so two holds
+ * cannot both pass a one-holder rule.
+ */
+export declare function changeLocalHolder(repository: LocalOrgRepository, input: {
+    action: 'hold' | 'release';
+    post: string;
+    member: OrgMember;
+    workflow: WorkflowRoles | null;
+}): Promise<{
+    post: string;
+    member: OrgMember;
+    changed: boolean;
+}>;
+/**
+ * The repository's owning team (osa-slots): the repository is its local
+ * org's one project, owned by the team sdlc org own named, or else by the
+ * org's only root team.
+ */
+export declare function projectTeamId(structure: OrgStructure, stored: string | null): string;
+/**
+ * The owning team, or, when none owns the project, the root team keys
+ * sdlc org own chooses from (none when the org has no team).
+ */
+export declare function projectOwner(structure: OrgStructure, stored: string | null): {
+    team_id: string;
+} | {
+    roots: string[];
+};
+/** A member named as `person:<id>` or `agent:<id>`. */
+export declare function parseMember(text: string): OrgMember;
+type LocalOrgState = {
+    graph: PortableGraph;
+    holders: readonly LocalOrgHolder[];
+    project_team: string | null;
+    overrides: readonly OrgSlotOverride[];
+};
+/**
+ * The repository project's owning team and each slot's binding, or one slot
+ * by key (osa_slots_ac_1 to ac_3, ac_9); an unknown slot is refused.
+ */
+export declare function describeLocalProject(org: LocalOrgState, rules: OrgHolderRules, input?: {
+    slot?: string;
+}): {
+    team: string;
+    slots: {
+        stale_posts?: number | undefined;
+        set_at?: string | undefined;
+        set_by?: string | undefined;
+        reason?: string | undefined;
+        needs_person?: boolean | undefined;
+        slot: string;
+        source: "override" | "baseline";
+        status: "vacant" | "covered" | "uncovered";
+        posts: {
+            off_description?: boolean | undefined;
+            post: string;
+            holders: OrgMember[];
+        }[];
+    }[];
+};
+/**
+ * The org chart's project (osa-slots-viewer, osa_slots_ac_10): its owning
+ * team and each slot's binding, or the root teams to choose an owner from.
+ */
+export declare function describeLocalProjectOrOwners(org: LocalOrgState, rules: OrgHolderRules): {
+    team: string;
+    slots: {
+        stale_posts?: number | undefined;
+        set_at?: string | undefined;
+        set_by?: string | undefined;
+        reason?: string | undefined;
+        needs_person?: boolean | undefined;
+        slot: string;
+        source: "override" | "baseline";
+        status: "vacant" | "covered" | "uncovered";
+        posts: {
+            off_description?: boolean | undefined;
+            post: string;
+            holders: OrgMember[];
+        }[];
+    }[];
+} | {
+    team: null;
+    roots: string[];
+};
+/** Who decides a slot's gate when its holders are absent or the author (osa_slots_ac_5). */
+export declare function escalateLocalSlot(org: LocalOrgState, rules: OrgHolderRules, input: {
+    slot: string;
+    absent?: OrgMember[];
+    author?: OrgMember | null;
+}): {
+    slot: string;
+    decides: {
+        post: string;
+        members: OrgMember[];
+        escalated: boolean;
+        path: string[];
+    };
+    waits_for?: undefined;
+    why?: undefined;
+    unresolved?: undefined;
+    path?: undefined;
+} | {
+    slot: string;
+    waits_for: string | undefined;
+    why: string;
+    decides?: undefined;
+    unresolved?: undefined;
+    path?: undefined;
+} | {
+    slot: string;
+    unresolved: boolean;
+    path: string[];
+    why: string;
+    decides?: undefined;
+    waits_for?: undefined;
+};
+/**
+ * Overrides a slot's binding with posts and a reason, or clears it back to
+ * the baseline, as `actor` (osa_slots_ac_2, ac_4, ac_8). Checked against the
+ * graph, holders and overrides as they stand, inside one write transaction.
+ */
+export declare function changeLocalBinding(repository: LocalOrgRepository, input: {
+    slot: string;
+    /** The posts to bind, as `<team>/<function>`; absent clears the override. */
+    posts?: string[];
+    reason?: string;
+    actor: OrgMember;
+    workflow: WorkflowRoles | null;
+}): Promise<{
+    team: string;
+    slots: {
+        stale_posts?: number | undefined;
+        set_at?: string | undefined;
+        set_by?: string | undefined;
+        reason?: string | undefined;
+        needs_person?: boolean | undefined;
+        slot: string;
+        source: "override" | "baseline";
+        status: "vacant" | "covered" | "uncovered";
+        posts: {
+            off_description?: boolean | undefined;
+            post: string;
+            holders: OrgMember[];
+        }[];
+    }[];
+    changed: boolean;
+}>;
+/**
+ * Names the team that owns the repository's project, as `actor`, who must
+ * govern both the team that owns it now and the new one (osa_slots_ac_8).
+ */
+export declare function setLocalProjectTeam(repository: LocalOrgRepository, input: {
+    team: string;
+    actor: OrgMember;
+}): Promise<{
+    team: string;
+    changed: boolean;
+}>;
+export { NO_ORG as LOCAL_ORG_MISSING };
+//# sourceMappingURL=local-org.d.ts.map

package/dist/local/local-org.d.ts.map

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