@iamem/amem 0.1.0

package/dist/db.d.ts

@@ -0,0 +1,192 @@
+import Database from "better-sqlite3";
+import { type RepoIdentity } from "./repo-identity.js";
+export type RepoRow = {
+    id: string;
+    repo_key: string;
+    remote_url: string | null;
+    root_path: string;
+    repo_name: string;
+    default_branch: string;
+    platform: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type ClaimRow = {
+    repo_id: string;
+    id: string;
+    kind: string;
+    text: string;
+    code_anchors: string;
+    source_ref: string | null;
+    created_at: string;
+    updated_at: string;
+    /** active | superseded — superseded claims are excluded from retrieval */
+    status: string;
+    superseded_by: string | null;
+    /** 1 when pinned — boosted in retrieval and sorted first in Memory */
+    pinned: number;
+};
+export type ProposalDraftRow = {
+    id: string;
+    repo_id: string;
+    platform: string;
+    session_id: string | null;
+    title: string;
+    proposal_json: string;
+    status: string;
+    source: string;
+    created_at: string;
+    updated_at: string;
+};
+export type ComponentRow = {
+    repo_id: string;
+    id: string;
+    name: string;
+    code_anchor: string | null;
+};
+export type FlowRow = {
+    repo_id: string;
+    id: string;
+    name: string;
+};
+export type EdgeRow = {
+    repo_id: string;
+    id: string;
+    from_id: string;
+    from_type: string;
+    to_id: string;
+    to_type: string;
+    kind: string;
+};
+export type UsageEventRow = {
+    id: string;
+    repo_id: string;
+    platform: string;
+    session_id: string | null;
+    query: string;
+    claim_ids: string;
+    anchors_count: number;
+    claims_count: number;
+    packet_tokens: number;
+    estimated_tokens_saved: number;
+    reported_tokens_saved: number | null;
+    created_at: string;
+    local_ms: number | null;
+    estimated_ms_saved: number | null;
+    kind: string | null;
+};
+export type SessionRow = {
+    platform: string;
+    session_id: string;
+    repo_id: string;
+    last_seen: string;
+};
+export type ConversationNoteRow = {
+    id: string;
+    repo_id: string;
+    platform: string;
+    session_id: string | null;
+    role: string;
+    text: string;
+    created_at: string;
+};
+export type SetupStateRow = {
+    repo_id: string;
+    platforms: string;
+    setup_completed_at: string | null;
+    updated_at: string;
+};
+export declare function openDb(): Database.Database;
+export declare function closeDb(): void;
+declare function nowIso(): string;
+export declare function upsertRepo(identity?: RepoIdentity, platform?: string): RepoRow;
+export declare function getRepoByCwd(cwd?: string): RepoRow | null;
+export declare function requireRepo(cwd?: string): RepoRow;
+export declare function getMeta(key: string): string | null;
+export declare function setMeta(key: string, value: string): void;
+export declare function listClaims(repoId: string, opts?: {
+    includeSuperseded?: boolean;
+}): ClaimRow[];
+export declare function listClaimsAll(opts?: {
+    includeSuperseded?: boolean;
+}): ClaimRow[];
+export declare function getClaim(repoId: string, claimId: string): ClaimRow | null;
+export declare function updateClaim(repoId: string, claimId: string, patch: {
+    text?: string;
+    kind?: string;
+    code_anchors?: string[];
+    pinned?: boolean;
+}): ClaimRow | null;
+export declare function setClaimPinned(repoId: string, claimId: string, pinned: boolean): ClaimRow | null;
+export declare function setClaimStatus(repoId: string, claimId: string, status: "active" | "decayed" | "superseded"): ClaimRow | null;
+export declare function deleteClaim(repoId: string, claimId: string): boolean;
+/** Reindex FTS + local embeddings for one repo (after propose apply / wipe helpers). */
+export declare function reindexClaimsSearch(repoId: string): void;
+export declare function listComponents(repoId: string): ComponentRow[];
+export declare function listComponentsAll(): ComponentRow[];
+export declare function listFlows(repoId: string): FlowRow[];
+export declare function listFlowsAll(): FlowRow[];
+export declare function listEdges(repoId: string): EdgeRow[];
+export declare function listEdgesAll(): EdgeRow[];
+export declare function wipeRepo(repoId: string): void;
+/** Delete every bound repo (cascade clears claims/flows/usage). Returns count wiped. */
+export declare function wipeAllRepos(): number;
+export declare function touchSession(platform: string, sessionId: string, repoId: string): void;
+export declare function insertUsageEvent(input: {
+    repoId: string;
+    platform: string;
+    sessionId?: string | null;
+    query: string;
+    claimIds: string[];
+    anchorsCount: number;
+    claimsCount: number;
+    packetTokens: number;
+    estimatedTokensSaved: number;
+    localMs?: number | null;
+    estimatedMsSaved?: number | null;
+    kind?: string | null;
+}): UsageEventRow;
+export declare function listSessions(repoId: string): SessionRow[];
+export declare function listSessionsAll(): SessionRow[];
+export declare function setReportedTokensSaved(eventId: string, saved: number): UsageEventRow;
+export declare function setReportedOnLatest(repoId: string, platform: string, saved: number): UsageEventRow;
+export declare function listUsageEvents(opts: {
+    repoId?: string | null;
+    days?: number;
+}): UsageEventRow[];
+export declare function listRepos(): RepoRow[];
+export declare function getSetupState(repoId: string): SetupStateRow | null;
+export declare function upsertSetupState(repoId: string, platforms: string[], completed: boolean): SetupStateRow;
+export declare function getRepoById(id: string): RepoRow | null;
+export declare function getRepoByName(name: string): RepoRow | null;
+/** Change a workspace display name. Keeps id, repo_key, and amem:// slug so memory stays bound. */
+export declare function renameWorkspace(repoId: string, displayName: string): RepoRow;
+export declare function insertConversationNote(input: {
+    repoId: string;
+    platform: string;
+    sessionId?: string | null;
+    role: string;
+    text: string;
+}): ConversationNoteRow;
+export declare function listConversationNotes(repoId: string, limit?: number): ConversationNoteRow[];
+export declare function insertProposalDraft(input: {
+    repoId: string;
+    platform: string;
+    sessionId?: string | null;
+    title: string;
+    proposal: unknown;
+    source?: string;
+}): ProposalDraftRow;
+export declare function getProposalDraft(id: string): ProposalDraftRow | null;
+export declare function listProposalDrafts(repoId: string, opts?: {
+    status?: string;
+    limit?: number;
+}): ProposalDraftRow[];
+export declare function listProposalDraftsAll(opts?: {
+    status?: string;
+    limit?: number;
+}): ProposalDraftRow[];
+export declare function countProposalDrafts(repoId: string, status?: string): number;
+export declare function countProposalDraftsAll(status?: string): number;
+export declare function setProposalDraftStatus(id: string, status: "pending" | "applied" | "dismissed"): ProposalDraftRow | null;
+export { nowIso };