@llblab/pi-kit 0.18.2 → 0.19.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +3 -1
- package/node_modules/@llblab/pi-state-flow/AGENTS.md +35 -37
- package/node_modules/@llblab/pi-state-flow/BACKLOG.md +5 -3
- package/node_modules/@llblab/pi-state-flow/CHANGELOG.md +19 -1
- package/node_modules/@llblab/pi-state-flow/README.md +102 -48
- package/node_modules/@llblab/pi-state-flow/dist/index.d.ts +6 -9
- package/node_modules/@llblab/pi-state-flow/dist/index.js +6 -9
- package/node_modules/@llblab/pi-state-flow/dist/lib/acquisition.d.ts +2 -2
- package/node_modules/@llblab/pi-state-flow/dist/lib/acquisition.js +21 -8
- package/node_modules/@llblab/pi-state-flow/dist/lib/artifact.d.ts +40 -24
- package/node_modules/@llblab/pi-state-flow/dist/lib/artifact.js +93 -63
- package/node_modules/@llblab/pi-state-flow/dist/lib/compaction.d.ts +4 -3
- package/node_modules/@llblab/pi-state-flow/dist/lib/compaction.js +9 -9
- package/node_modules/@llblab/pi-state-flow/dist/lib/config.d.ts +1 -1
- package/node_modules/@llblab/pi-state-flow/dist/lib/config.js +6 -5
- package/node_modules/@llblab/pi-state-flow/dist/lib/context.d.ts +8 -7
- package/node_modules/@llblab/pi-state-flow/dist/lib/context.js +56 -58
- package/node_modules/@llblab/pi-state-flow/dist/lib/continuation.js +12 -24
- package/node_modules/@llblab/pi-state-flow/dist/lib/durable.d.ts +7 -18
- package/node_modules/@llblab/pi-state-flow/dist/lib/durable.js +47 -78
- package/node_modules/@llblab/pi-state-flow/dist/lib/extension.d.ts +4 -6
- package/node_modules/@llblab/pi-state-flow/dist/lib/extension.js +241 -437
- package/node_modules/@llblab/pi-state-flow/dist/lib/git.d.ts +2 -72
- package/node_modules/@llblab/pi-state-flow/dist/lib/git.js +120 -499
- package/node_modules/@llblab/pi-state-flow/dist/lib/history.d.ts +2 -1
- package/node_modules/@llblab/pi-state-flow/dist/lib/history.js +4 -3
- package/node_modules/@llblab/pi-state-flow/dist/lib/json.d.ts +3 -0
- package/node_modules/@llblab/pi-state-flow/dist/lib/json.js +43 -22
- package/node_modules/@llblab/pi-state-flow/dist/lib/logging.d.ts +1 -5
- package/node_modules/@llblab/pi-state-flow/dist/lib/logging.js +0 -2
- package/node_modules/@llblab/pi-state-flow/dist/lib/memory.d.ts +1 -14
- package/node_modules/@llblab/pi-state-flow/dist/lib/memory.js +5 -37
- package/node_modules/@llblab/pi-state-flow/dist/lib/protocol.d.ts +1 -2
- package/node_modules/@llblab/pi-state-flow/dist/lib/protocol.js +13 -32
- package/node_modules/@llblab/pi-state-flow/dist/lib/query.d.ts +6 -6
- package/node_modules/@llblab/pi-state-flow/dist/lib/query.js +25 -21
- package/node_modules/@llblab/pi-state-flow/dist/lib/recovery.d.ts +3 -3
- package/node_modules/@llblab/pi-state-flow/dist/lib/recovery.js +15 -12
- package/node_modules/@llblab/pi-state-flow/dist/lib/rehydration.d.ts +2 -4
- package/node_modules/@llblab/pi-state-flow/dist/lib/rehydration.js +5 -1
- package/node_modules/@llblab/pi-state-flow/dist/lib/runtime.d.ts +26 -88
- package/node_modules/@llblab/pi-state-flow/dist/lib/runtime.js +159 -255
- package/node_modules/@llblab/pi-state-flow/dist/lib/skills.d.ts +0 -3
- package/node_modules/@llblab/pi-state-flow/dist/lib/skills.js +1 -47
- package/node_modules/@llblab/pi-state-flow/dist/lib/snapshot.d.ts +16 -33
- package/node_modules/@llblab/pi-state-flow/dist/lib/snapshot.js +48 -137
- package/node_modules/@llblab/pi-state-flow/dist/lib/state.d.ts +16 -11
- package/node_modules/@llblab/pi-state-flow/dist/lib/state.js +13 -14
- package/node_modules/@llblab/pi-state-flow/dist/lib/status.d.ts +1 -9
- package/node_modules/@llblab/pi-state-flow/dist/lib/status.js +15 -43
- package/node_modules/@llblab/pi-state-flow/dist/lib/storage.d.ts +5 -9
- package/node_modules/@llblab/pi-state-flow/dist/lib/storage.js +13 -45
- package/node_modules/@llblab/pi-state-flow/dist/lib/telegram.js +1 -1
- package/node_modules/@llblab/pi-state-flow/dist/lib/temporal.d.ts +15 -7
- package/node_modules/@llblab/pi-state-flow/dist/lib/temporal.js +104 -24
- package/node_modules/@llblab/pi-state-flow/dist/lib/transition.d.ts +0 -2
- package/node_modules/@llblab/pi-state-flow/dist/lib/transition.js +11 -14
- package/node_modules/@llblab/pi-state-flow/dist/package.json +9 -6
- package/node_modules/@llblab/pi-state-flow/dist/skills/state-flow-guide/SKILL.md +11 -17
- package/node_modules/@llblab/pi-state-flow/dist/skills/state-flow-memory/SKILL.md +8 -8
- package/node_modules/@llblab/pi-state-flow/docs/README.md +2 -2
- package/node_modules/@llblab/pi-state-flow/docs/architecture.md +64 -67
- package/node_modules/@llblab/pi-state-flow/docs/compatibility.md +24 -6
- package/node_modules/@llblab/pi-state-flow/docs/filesystem-recovery.md +12 -15
- package/node_modules/@llblab/pi-state-flow/docs/fork-contract.md +22 -27
- package/node_modules/@llblab/pi-state-flow/docs/lazy-state.md +25 -41
- package/node_modules/@llblab/pi-state-flow/docs/performance.md +38 -421
- package/node_modules/@llblab/pi-state-flow/docs/temporal-acceptance.md +33 -46
- package/node_modules/@llblab/pi-state-flow/docs/usage.md +37 -61
- package/node_modules/@llblab/pi-state-flow/index.ts +7 -71
- package/node_modules/@llblab/pi-state-flow/lib/acquisition.ts +26 -11
- package/node_modules/@llblab/pi-state-flow/lib/artifact.ts +116 -88
- package/node_modules/@llblab/pi-state-flow/lib/compaction.ts +12 -10
- package/node_modules/@llblab/pi-state-flow/lib/config.ts +6 -6
- package/node_modules/@llblab/pi-state-flow/lib/context.ts +52 -59
- package/node_modules/@llblab/pi-state-flow/lib/continuation.ts +11 -20
- package/node_modules/@llblab/pi-state-flow/lib/durable.ts +44 -86
- package/node_modules/@llblab/pi-state-flow/lib/extension.ts +237 -460
- package/node_modules/@llblab/pi-state-flow/lib/git.ts +110 -552
- package/node_modules/@llblab/pi-state-flow/lib/history.ts +4 -3
- package/node_modules/@llblab/pi-state-flow/lib/json.ts +39 -23
- package/node_modules/@llblab/pi-state-flow/lib/logging.ts +1 -7
- package/node_modules/@llblab/pi-state-flow/lib/memory.ts +5 -44
- package/node_modules/@llblab/pi-state-flow/lib/protocol.ts +14 -25
- package/node_modules/@llblab/pi-state-flow/lib/query.ts +26 -22
- package/node_modules/@llblab/pi-state-flow/lib/recovery.ts +17 -11
- package/node_modules/@llblab/pi-state-flow/lib/rehydration.ts +7 -5
- package/node_modules/@llblab/pi-state-flow/lib/runtime.ts +154 -254
- package/node_modules/@llblab/pi-state-flow/lib/skills.ts +1 -49
- package/node_modules/@llblab/pi-state-flow/lib/snapshot.ts +58 -142
- package/node_modules/@llblab/pi-state-flow/lib/state.ts +27 -19
- package/node_modules/@llblab/pi-state-flow/lib/status.ts +16 -54
- package/node_modules/@llblab/pi-state-flow/lib/storage.ts +12 -40
- package/node_modules/@llblab/pi-state-flow/lib/telegram.ts +1 -1
- package/node_modules/@llblab/pi-state-flow/lib/temporal.ts +104 -22
- package/node_modules/@llblab/pi-state-flow/lib/transition.ts +16 -26
- package/node_modules/@llblab/pi-state-flow/package.json +9 -6
- package/node_modules/@llblab/pi-state-flow/skills/state-flow-guide/SKILL.md +11 -17
- package/node_modules/@llblab/pi-state-flow/skills/state-flow-memory/SKILL.md +8 -8
- package/package.json +2 -2
- package/node_modules/@llblab/pi-state-flow/dist/lib/discovery.d.ts +0 -21
- package/node_modules/@llblab/pi-state-flow/dist/lib/discovery.js +0 -125
- package/node_modules/@llblab/pi-state-flow/dist/lib/maintenance.d.ts +0 -36
- package/node_modules/@llblab/pi-state-flow/dist/lib/maintenance.js +0 -98
- package/node_modules/@llblab/pi-state-flow/dist/lib/migration.d.ts +0 -13
- package/node_modules/@llblab/pi-state-flow/dist/lib/migration.js +0 -167
- package/node_modules/@llblab/pi-state-flow/dist/lib/publication.d.ts +0 -86
- package/node_modules/@llblab/pi-state-flow/dist/lib/publication.js +0 -437
- package/node_modules/@llblab/pi-state-flow/lib/discovery.ts +0 -133
- package/node_modules/@llblab/pi-state-flow/lib/maintenance.ts +0 -147
- package/node_modules/@llblab/pi-state-flow/lib/migration.ts +0 -171
- package/node_modules/@llblab/pi-state-flow/lib/publication.ts +0 -458
|
@@ -1,72 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
import { type ScopeStream, type TemporalState } from "./temporal.ts";
|
|
4
|
-
import { type SessionRuntime, type Snapshot } from "./snapshot.ts";
|
|
5
|
-
import type { StateScope } from "./state.ts";
|
|
6
|
-
export interface GitPushResult {
|
|
7
|
-
status: "pushed" | "local" | "pending";
|
|
8
|
-
commit: string;
|
|
9
|
-
error?: string;
|
|
10
|
-
}
|
|
11
|
-
/** Explicit start only: initialize this exact root, preserving existing files and ancestor Git. */
|
|
12
|
-
export declare function initializeGitRepository(repositoryRoot: string): void;
|
|
13
|
-
export interface TemporalGitBase {
|
|
14
|
-
head?: string;
|
|
15
|
-
files: DurableFileBase[];
|
|
16
|
-
}
|
|
17
|
-
export interface TemporalRevisionLoad {
|
|
18
|
-
base: TemporalGitBase;
|
|
19
|
-
scopes: Record<StateScope, ScopeStream | undefined>;
|
|
20
|
-
runtime?: {
|
|
21
|
-
document: SessionRuntime;
|
|
22
|
-
revision: string;
|
|
23
|
-
};
|
|
24
|
-
/** Runtime-owned artifact provenance retained at this revision. */
|
|
25
|
-
provenance: Record<StateScope, ArtifactProvenanceRegistry>;
|
|
26
|
-
}
|
|
27
|
-
export declare function captureTemporalGitBase(cwd: string, sessionId: string, repositoryRoot: string, sessionKey?: string): TemporalGitBase;
|
|
28
|
-
/** Cold scope-stream reconstruction from canonical revision paths only. */
|
|
29
|
-
export declare function loadTemporalRevision(cwd: string, sessionId: string, repositoryRoot: string, revision: string, sessionKey?: string): TemporalRevisionLoad;
|
|
30
|
-
export interface StorageMigrationPublication {
|
|
31
|
-
commit?: string;
|
|
32
|
-
push?: GitPushResult;
|
|
33
|
-
scopes: StateScope[];
|
|
34
|
-
}
|
|
35
|
-
/** Explicit migration entrypoint; initialization adopts it only with the temporal writer cutover. */
|
|
36
|
-
export declare function migrateLegacyStorageToGit(cwd: string, sessionId: string, repositoryRoot: string, sessionKey?: string): StorageMigrationPublication;
|
|
37
|
-
/** Explicit current-file adoption, not reconstruction or invention of pre-Git history. */
|
|
38
|
-
export declare function adoptFileStateToGit(cwd: string, sessionId: string, repositoryRoot: string, revision: string, snapshot: Snapshot, sessionKey?: string, push?: boolean): {
|
|
39
|
-
commit?: string;
|
|
40
|
-
push?: GitPushResult;
|
|
41
|
-
revision: string;
|
|
42
|
-
view: {
|
|
43
|
-
scopes: Record<StateScope, ScopeStream>;
|
|
44
|
-
lineage: import("./temporal.ts").TransitionBoundary[];
|
|
45
|
-
};
|
|
46
|
-
provenance: Record<StateScope, ArtifactProvenanceRegistry>;
|
|
47
|
-
base: {
|
|
48
|
-
head: string | undefined;
|
|
49
|
-
files: DurableFileBase[];
|
|
50
|
-
};
|
|
51
|
-
};
|
|
52
|
-
/** Persist selected streams from one validated view, never derive checkpoints from current state. */
|
|
53
|
-
export declare function publishTemporalStateToGit(cwd: string, sessionId: string, view: TemporalState, scopes: readonly StateScope[], base: TemporalGitBase, repositoryRoot: string, runtime?: SessionRuntime, sessionKey?: string, push?: boolean, provenance?: Readonly<Record<StateScope, ArtifactProvenanceRegistry>>): {
|
|
54
|
-
base: TemporalGitBase;
|
|
55
|
-
commit?: string;
|
|
56
|
-
push?: GitPushResult;
|
|
57
|
-
};
|
|
58
|
-
export declare function resolveGitPushDestination(repositoryRoot: string): {
|
|
59
|
-
gitCommonDir: string;
|
|
60
|
-
remote: string;
|
|
61
|
-
ref: string;
|
|
62
|
-
} | undefined;
|
|
63
|
-
/** Read-only publication policy; configuration errors are not local-only success. */
|
|
64
|
-
export declare function isLocalGitRepository(repositoryRoot: string): boolean;
|
|
65
|
-
/** Push an already-created commit exactly; failures are publication state, not transition rejection. */
|
|
66
|
-
export declare function isGitCommitAncestor(repositoryRoot: string, ancestor: string, descendant: string): boolean;
|
|
67
|
-
/** Own one non-interactive exact-target push; cancellation is not confirmation of child exit. */
|
|
68
|
-
export declare function pushGitTarget(repositoryRoot: string, destination: {
|
|
69
|
-
remote: string;
|
|
70
|
-
ref: string;
|
|
71
|
-
}, commit: string, signal?: AbortSignal): Promise<void>;
|
|
72
|
-
export declare function pushGitCommit(repositoryRoot: string, commit: string): GitPushResult;
|
|
1
|
+
/** Commit only current State Flow-owned files; never changes canonical acceptance. */
|
|
2
|
+
export declare function backupCurrentStateFlowFiles(repositoryRoot: string): string | undefined;
|