@pcircle/footprint 1.3.0 → 1.6.0

package/dist/src/ingestion/types.d.ts

@@ -0,0 +1,10 @@
+export interface SourceRef {
+    type: "message" | "event" | "artifact";
+    id: string;
+}
+export interface IngestionSummary {
+    artifactsCreated: number;
+    narrativesCreated: number;
+    decisionsCreated: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/ingestion/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ingestion/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACvC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/src/ingestion/types.js

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

package/dist/src/ingestion/types.js.map

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

package/dist/src/lib/context-memory.d.ts

@@ -0,0 +1,140 @@
+import { type HistoryHandoffReport } from "./history-handoff.js";
+import { type HistoryTrendReport } from "./session-trends.js";
+import type { ContextLinkSource, DecisionRecord, EvidenceDatabase, SessionHost, SessionStatus } from "./storage/index.js";
+export type ContextConfidence = "high" | "medium" | "low";
+export interface ContextSessionSummary extends Record<string, unknown> {
+    id: string;
+    label: string;
+    host: SessionHost;
+    status: SessionStatus;
+    startedAt: string;
+    endedAt: string | null;
+}
+export interface ContextListItem extends Record<string, unknown> {
+    id: string;
+    label: string;
+    workspaceKey: string;
+    latestSessionId: string;
+    latestSessionLabel: string;
+    latestStartedAt: string;
+    latestEndedAt: string | null;
+    sessionCount: number;
+    hosts: SessionHost[];
+    statuses: SessionStatus[];
+    confidence: ContextConfidence;
+    confidenceScore: number;
+    signals: string[];
+}
+export interface ContextDecisionItem extends Record<string, unknown> {
+    decisionId: string;
+    topic: string;
+    sessionId: string;
+    sessionLabel: string;
+    title: string;
+    summary: string;
+    rationale: string | null;
+    status: DecisionRecord["status"];
+    createdAt: string;
+}
+export interface SupersededContextDecisionItem extends ContextDecisionItem {
+    supersededByDecisionId: string | null;
+    supersededByTitle: string | null;
+}
+export interface ContextChangeItem extends Record<string, unknown> {
+    kind: "decision-updated" | "context-refreshed";
+    summary: string;
+    sessionId: string | null;
+    sessionLabel: string | null;
+    createdAt: string | null;
+}
+export interface ContextCurrentTruth extends Record<string, unknown> {
+    summary: string;
+    latestSessionId: string;
+    latestSessionLabel: string;
+    latestSummaryNarrative: string | null;
+    latestHandoff: string | null;
+    activeBlockers: string[];
+    openQuestions: string[];
+}
+export interface ContextReport extends Record<string, unknown> {
+    context: ContextListItem;
+    currentTruth: ContextCurrentTruth;
+    activeDecisions: ContextDecisionItem[];
+    supersededDecisions: SupersededContextDecisionItem[];
+    changeLog: ContextChangeItem[];
+    sessions: ContextSessionSummary[];
+    trends: HistoryTrendReport["trends"];
+    handoff: Pick<HistoryHandoffReport, "summary" | "followUps" | "blockers">;
+    markdown: string;
+}
+export interface ContextCandidate extends Record<string, unknown> {
+    kind: "existing-context" | "new-context";
+    contextId: string | null;
+    label: string;
+    workspaceKey: string;
+    confidence: ContextConfidence;
+    confidenceScore: number;
+    reasons: string[];
+    sessionIds: string[];
+    latestSessionId: string | null;
+    latestSessionLabel: string | null;
+    preferred: boolean;
+    confirmationRequired: boolean;
+}
+export interface ContextResolution extends Record<string, unknown> {
+    mode: "linked" | "preferred" | "suggested" | "none";
+    sessionId: string | null;
+    cwd: string | null;
+    confirmationRequired: boolean;
+    recommendedAction: "use-linked" | "use-preferred" | "confirm-existing" | "create-new-context" | "choose-candidate" | "none";
+    linkedContextId: string | null;
+    currentContext: ContextListItem | null;
+    briefing: ContextReport | null;
+    candidates: ContextCandidate[];
+}
+export interface ContextLinkMutationResult extends Record<string, unknown> {
+    action: "confirmed" | "rejected" | "moved" | "merged" | "split" | "preferred";
+    context: ContextListItem | null;
+    affectedSessionIds: string[];
+    contextId: string | null;
+    mergedFromContextId: string | null;
+}
+interface ResolveContextOptions {
+    sessionId?: string;
+    cwd?: string;
+    title?: string;
+    host?: SessionHost;
+}
+interface ConfirmContextOptions {
+    sessionIds: string[];
+    contextId?: string;
+    label?: string;
+    setPreferred?: boolean;
+    linkSource?: ContextLinkSource;
+}
+interface MoveContextOptions {
+    sessionId: string;
+    contextId?: string;
+    label?: string;
+    setPreferred?: boolean;
+}
+interface SplitContextOptions {
+    contextId: string;
+    sessionIds: string[];
+    label?: string;
+    setPreferred?: boolean;
+}
+export declare function listContexts(db: EvidenceDatabase): {
+    contexts: ContextListItem[];
+    total: number;
+};
+export declare function getContextReport(db: EvidenceDatabase, contextId: string): ContextReport;
+export declare function resolveContext(db: EvidenceDatabase, options: ResolveContextOptions): ContextResolution;
+export declare function confirmContextLink(db: EvidenceDatabase, options: ConfirmContextOptions): ContextLinkMutationResult;
+export declare function rejectContextLink(db: EvidenceDatabase, sessionId: string, contextId: string): ContextLinkMutationResult;
+export declare function moveSessionContext(db: EvidenceDatabase, options: MoveContextOptions): ContextLinkMutationResult;
+export declare function mergeContexts(db: EvidenceDatabase, sourceContextId: string, targetContextId: string): ContextLinkMutationResult;
+export declare function splitContext(db: EvidenceDatabase, options: SplitContextOptions): ContextLinkMutationResult;
+export declare function setActiveContext(db: EvidenceDatabase, contextId: string, cwd?: string): ContextLinkMutationResult;
+export {};
+//# sourceMappingURL=context-memory.d.ts.map

package/dist/src/lib/context-memory.d.ts.map

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