@morshoto/framekit 0.1.18 → 0.2.3
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/README.md +17 -12
- package/dist-package/adapters/final-cut/typescript/src/analyzers.d.ts +58 -0
- package/dist-package/adapters/final-cut/typescript/src/analyzers.js +52 -13
- package/dist-package/adapters/final-cut/typescript/src/assets.d.ts +24 -0
- package/dist-package/adapters/final-cut/typescript/src/background-export.d.ts +98 -0
- package/dist-package/adapters/final-cut/typescript/src/background-materialization.d.ts +47 -0
- package/dist-package/adapters/final-cut/typescript/src/background-materialization.js +8 -2
- package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.d.ts +32 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.js +275 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical-recovery.d.ts +22 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical-verification.d.ts +11 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical.d.ts +184 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical.js +571 -78
- package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
- package/dist-package/adapters/final-cut/typescript/src/connection.js +6 -1
- package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -0
- package/dist-package/adapters/final-cut/typescript/src/disposable-native.js +6 -0
- package/dist-package/adapters/final-cut/typescript/src/documents.d.ts +3 -0
- package/dist-package/adapters/final-cut/typescript/src/documents.js +3 -0
- package/dist-package/adapters/final-cut/typescript/src/experimental.d.ts +8 -0
- package/dist-package/adapters/final-cut/typescript/src/experimental.js +8 -0
- package/dist-package/adapters/final-cut/typescript/src/export.d.ts +125 -0
- package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.d.ts +54 -0
- package/dist-package/adapters/final-cut/typescript/src/fcpxml.d.ts +75 -0
- package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +28 -9
- package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
- package/dist-package/adapters/final-cut/typescript/src/index.js +1 -7
- package/dist-package/adapters/final-cut/typescript/src/library-inspection.d.ts +101 -0
- package/dist-package/adapters/final-cut/typescript/src/live.d.ts +101 -0
- package/dist-package/adapters/final-cut/typescript/src/live.js +35 -2
- package/dist-package/adapters/final-cut/typescript/src/media.d.ts +12 -0
- package/dist-package/adapters/final-cut/typescript/src/native-operation.d.ts +6 -0
- package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.d.ts +77 -0
- package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.js +175 -0
- package/dist-package/adapters/final-cut/typescript/src/native-session.d.ts +130 -0
- package/dist-package/adapters/final-cut/typescript/src/native-session.js +11 -6
- package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
- package/dist-package/adapters/final-cut/typescript/src/native.js +475 -189
- package/dist-package/adapters/final-cut/typescript/src/pasteboard-snapshot.d.ts +114 -0
- package/dist-package/adapters/final-cut/typescript/src/publish-readback.d.ts +26 -0
- package/dist-package/adapters/final-cut/typescript/src/publish-readback.js +19 -2
- package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
- package/dist-package/adapters/final-cut/typescript/src/publisher.js +255 -14
- package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
- package/dist-package/adapters/final-cut/typescript/src/session.js +43 -13
- package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.d.ts +51 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-experiment.d.ts +156 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.d.ts +134 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-materialization.d.ts +110 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-wal-observation.d.ts +132 -0
- package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.d.ts +61 -0
- package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +31 -5
- package/dist-package/adapters/final-cut/typescript/src/unattended-editing.d.ts +54 -0
- package/dist-package/adapters/headless/typescript/src/audio-output.d.ts +3 -0
- package/dist-package/adapters/headless/typescript/src/audio-output.js +3 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.d.ts +11 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.js +26 -2
- package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.d.ts +25 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +37 -14
- package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.js +9 -4
- package/dist-package/adapters/headless/typescript/src/index.d.ts +3 -0
- package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
- package/dist-package/apps/cli/src/dev-doctor.js +198 -0
- package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
- package/dist-package/apps/cli/src/headless-projects.js +5 -0
- package/dist-package/apps/cli/src/main.d.ts +10 -0
- package/dist-package/apps/cli/src/main.js +42 -0
- package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
- package/dist-package/apps/mcp-server/runtime/speech-analyzer-wrapper.mjs +54 -0
- package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +271 -0
- package/dist-package/apps/mcp-server/src/build-alignment.d.ts +10 -0
- package/dist-package/apps/mcp-server/src/build-identity.d.ts +7 -0
- package/dist-package/apps/mcp-server/src/build-identity.json +2 -2
- package/dist-package/apps/mcp-server/src/canonical-native-snapshot.d.ts +8 -0
- package/dist-package/apps/mcp-server/src/canonical-native-snapshot.js +18 -0
- package/dist-package/apps/mcp-server/src/final-cut-runtime-config.d.ts +5 -0
- package/dist-package/apps/mcp-server/src/final-cut-runtime-config.js +3 -0
- package/dist-package/apps/mcp-server/src/headless-project-snapshot.d.ts +3 -0
- package/dist-package/apps/mcp-server/src/headless-sessions.d.ts +89 -0
- package/dist-package/apps/mcp-server/src/main.d.ts +1 -0
- package/dist-package/apps/mcp-server/src/main.js +24 -19
- package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
- package/dist-package/apps/mcp-server/src/materialization-jobs.js +143 -10
- package/dist-package/apps/mcp-server/src/readback-policy.d.ts +18 -0
- package/dist-package/apps/mcp-server/src/routing.d.ts +90 -0
- package/dist-package/apps/mcp-server/src/routing.js +2 -0
- package/dist-package/apps/mcp-server/src/server.d.ts +75 -0
- package/dist-package/apps/mcp-server/src/server.js +813 -158
- package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
- package/dist-package/apps/mcp-server/src/tools/skills/catalog.js +142 -0
- package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
- package/dist-package/apps/mcp-server/src/tools/skills/metadata.js +71 -0
- package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -0
- package/dist-package/apps/mcp-server/src/tools/skills/register.js +101 -0
- package/dist-package/apps/mcp-server/src/version.d.ts +4 -0
- package/dist-package/packages/headless-application/src/external-edit.d.ts +30 -0
- package/dist-package/packages/headless-application/src/external-edit.js +72 -0
- package/dist-package/packages/headless-application/src/headless-projects.d.ts +233 -0
- package/dist-package/{apps/mcp-server → packages/headless-application}/src/headless-projects.js +392 -59
- package/dist-package/packages/headless-application/src/index.d.ts +2 -0
- package/dist-package/packages/headless-application/src/index.js +2 -0
- package/dist-package/packages/runtime/src/application/duration-policy-service.d.ts +4 -0
- package/dist-package/packages/runtime/src/application/local-media.d.ts +46 -0
- package/dist-package/packages/runtime/src/application/media-analysis-service.d.ts +40 -0
- package/dist-package/packages/runtime/src/application/media-analysis-service.js +105 -15
- package/dist-package/packages/runtime/src/application/project-service.d.ts +35 -0
- package/dist-package/packages/runtime/src/application/project-service.js +5 -1
- package/dist-package/packages/runtime/src/application/project-store.d.ts +56 -0
- package/dist-package/packages/runtime/src/application/project-store.js +13 -36
- package/dist-package/packages/runtime/src/application/project-transactions.d.ts +51 -0
- package/dist-package/packages/runtime/src/application/runtime-options.d.ts +15 -0
- package/dist-package/packages/runtime/src/application/semantic-media-index-store.d.ts +28 -0
- package/dist-package/packages/runtime/src/application/transaction-store.d.ts +10 -0
- package/dist-package/packages/runtime/src/application/transaction-store.js +1 -1
- package/dist-package/packages/runtime/src/audio/analysis.d.ts +3 -0
- package/dist-package/packages/runtime/src/audio/analysis.js +95 -0
- package/dist-package/packages/runtime/src/audio/dialogue-normalization.d.ts +47 -0
- package/dist-package/packages/runtime/src/audio/noise-reduction.d.ts +34 -0
- package/dist-package/packages/runtime/src/capabilities.d.ts +45 -0
- package/dist-package/packages/runtime/src/capabilities.js +1 -1
- package/dist-package/packages/runtime/src/color-correction.d.ts +33 -0
- package/dist-package/packages/runtime/src/context/context-engine.d.ts +28 -0
- package/dist-package/packages/runtime/src/context/context-engine.js +22 -16
- package/dist-package/packages/runtime/src/context/context-service.d.ts +20 -0
- package/dist-package/packages/runtime/src/context/context-service.js +2 -2
- package/dist-package/packages/runtime/src/context/project-catalog.d.ts +12 -0
- package/dist-package/packages/runtime/src/context/revision.d.ts +2 -0
- package/dist-package/packages/runtime/src/domain/capabilities.d.ts +170 -0
- package/dist-package/packages/runtime/src/domain/context.d.ts +179 -0
- package/dist-package/packages/runtime/src/domain/diff.d.ts +104 -0
- package/dist-package/packages/runtime/src/domain/duration.d.ts +63 -0
- package/dist-package/packages/runtime/src/domain/editing.d.ts +227 -0
- package/dist-package/packages/runtime/src/domain/incremental-sync.d.ts +67 -0
- package/dist-package/packages/runtime/src/domain/index.d.ts +14 -0
- package/dist-package/packages/runtime/src/domain/media.d.ts +406 -0
- package/dist-package/packages/runtime/src/domain/ports.d.ts +62 -0
- package/dist-package/packages/runtime/src/domain/primitives.d.ts +21 -0
- package/dist-package/packages/runtime/src/domain/project.d.ts +119 -0
- package/dist-package/packages/runtime/src/domain/rough-cut.d.ts +27 -0
- package/dist-package/packages/runtime/src/domain/skills.d.ts +145 -0
- package/dist-package/packages/runtime/src/domain/timeline-target.d.ts +57 -0
- package/dist-package/packages/runtime/src/domain/timeline-target.js +19 -1
- package/dist-package/packages/runtime/src/domain/types.d.ts +5 -0
- package/dist-package/packages/runtime/src/domain/verification.d.ts +92 -0
- package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.d.ts +18 -0
- package/dist-package/packages/runtime/src/editing/duration-policy.d.ts +3 -0
- package/dist-package/packages/runtime/src/editing/edit-service.d.ts +44 -0
- package/dist-package/packages/runtime/src/editing/edit-service.js +76 -10
- package/dist-package/packages/runtime/src/editing/filler-removal-service.d.ts +23 -0
- package/dist-package/packages/runtime/src/editing/intent.d.ts +97 -0
- package/dist-package/packages/runtime/src/editing/music-service.d.ts +9 -0
- package/dist-package/packages/runtime/src/index.d.ts +32 -0
- package/dist-package/packages/runtime/src/index.js +2 -0
- package/dist-package/packages/runtime/src/planning/rough-cut.d.ts +3 -0
- package/dist-package/packages/runtime/src/render/render-and-verify.d.ts +71 -0
- package/dist-package/packages/runtime/src/render/render-contract.d.ts +96 -0
- package/dist-package/packages/runtime/src/runtime.d.ts +85 -0
- package/dist-package/packages/runtime/src/runtime.js +16 -7
- package/dist-package/packages/runtime/src/skills/builtin.d.ts +2 -0
- package/dist-package/packages/runtime/src/skills/index.d.ts +3 -0
- package/dist-package/packages/runtime/src/skills/registry.d.ts +10 -0
- package/dist-package/packages/runtime/src/skills/requirements.d.ts +38 -0
- package/dist-package/packages/runtime/src/skills/runtime.d.ts +38 -0
- package/dist-package/packages/runtime/src/speech/analysis.d.ts +18 -0
- package/dist-package/packages/runtime/src/speech/analysis.js +67 -0
- package/dist-package/packages/runtime/src/speech/filler-detector.d.ts +49 -0
- package/dist-package/packages/runtime/src/speech/filler-removal.d.ts +37 -0
- package/dist-package/packages/runtime/src/speech/mapping.d.ts +56 -0
- package/dist-package/packages/runtime/src/speech/mapping.js +27 -4
- package/dist-package/packages/runtime/src/speech/safe-cut-resolver.d.ts +52 -0
- package/dist-package/packages/runtime/src/timeline/drift-reconciliation.d.ts +42 -0
- package/dist-package/packages/runtime/src/timeline/editing-session.d.ts +271 -0
- package/dist-package/packages/runtime/src/timeline/editing-session.js +48 -2
- package/dist-package/packages/runtime/src/timeline/fast-observation.d.ts +77 -0
- package/dist-package/packages/runtime/src/timeline/rational-time.d.ts +11 -0
- package/dist-package/packages/runtime/src/timeline/reorder-preview.d.ts +32 -0
- package/dist-package/packages/runtime/src/timeline/reorder-preview.js +202 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-diff.d.ts +3 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-diff.js +1 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-digest.d.ts +3 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-digest.js +1 -1
- package/dist-package/packages/runtime/src/verification/verification.d.ts +6 -0
- package/dist-package/packages/testkit/src/fixture-analyzers.d.ts +37 -0
- package/dist-package/packages/testkit/src/in-memory-editor.d.ts +55 -0
- package/dist-package/packages/testkit/src/in-memory-editor.js +3 -3
- package/dist-package/packages/testkit/src/index.d.ts +4 -0
- package/dist-package/packages/testkit/src/index.js +1 -0
- package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
- package/dist-package/packages/testkit/src/sender-lifecycle-fixture.js +192 -0
- package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
- package/package.json +41 -14
|
@@ -0,0 +1,275 @@
|
|
|
1
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import { constants } from "node:fs";
|
|
3
|
+
import { lstat, mkdir, open, readFile, unlink } from "node:fs/promises";
|
|
4
|
+
import { dirname } from "node:path";
|
|
5
|
+
import { inspectNativeRecoveryReadOnly, validRecoveryContext } from "./native-recovery-inspection.js";
|
|
6
|
+
/** A durable, exclusive checkpoint; unresolved checkpoints are never cleared automatically. */
|
|
7
|
+
export class FileCanonicalRecoveryGuard {
|
|
8
|
+
path;
|
|
9
|
+
owner;
|
|
10
|
+
constructor(path) {
|
|
11
|
+
this.path = path;
|
|
12
|
+
}
|
|
13
|
+
async assertClear() {
|
|
14
|
+
try {
|
|
15
|
+
await lstat(this.path);
|
|
16
|
+
}
|
|
17
|
+
catch (error) {
|
|
18
|
+
if (error.code === "ENOENT")
|
|
19
|
+
return;
|
|
20
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot inspect recovery checkpoint", { cause: error });
|
|
21
|
+
}
|
|
22
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: unresolved canonical edit checkpoint exists");
|
|
23
|
+
}
|
|
24
|
+
/** Read native reservation and sender evidence without acquiring or modifying locks. */
|
|
25
|
+
async inspectNativeRecoveryEvidence() {
|
|
26
|
+
return inspectNativeRecoveryReadOnly(this.path);
|
|
27
|
+
}
|
|
28
|
+
/** Return evidence only; inspection never clears or claims recovery. */
|
|
29
|
+
async inspect() {
|
|
30
|
+
return (await this.inspectVersioned())?.checkpoint;
|
|
31
|
+
}
|
|
32
|
+
/** Inspect a direct native reservation without fabricating a canonical target. */
|
|
33
|
+
async inspectNativeReservation() {
|
|
34
|
+
let handle;
|
|
35
|
+
try {
|
|
36
|
+
handle = await open(this.path, constants.O_RDONLY | constants.O_NOFOLLOW);
|
|
37
|
+
const info = await handle.stat();
|
|
38
|
+
if (!info.isFile() || info.size > 16_384)
|
|
39
|
+
throw new Error("invalid reservation file");
|
|
40
|
+
const contents = await handle.readFile("utf8");
|
|
41
|
+
const record = JSON.parse(contents);
|
|
42
|
+
if ((record.version !== 2 && record.version !== 3) || record.kind !== "native-operation"
|
|
43
|
+
|| typeof record.owner !== "string"
|
|
44
|
+
|| !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(record.owner)
|
|
45
|
+
|| typeof record.operation !== "string" || !/^[a-z][a-z0-9.-]{0,127}$/.test(record.operation)
|
|
46
|
+
|| (record.version === 3 && !validRecoveryContext(record.recoveryContext, record.operation))) {
|
|
47
|
+
throw new Error("invalid native reservation");
|
|
48
|
+
}
|
|
49
|
+
return { reservationId: createHash("sha256").update(contents).digest("hex"), operation: record.operation };
|
|
50
|
+
}
|
|
51
|
+
catch (error) {
|
|
52
|
+
if (error.code === "ENOENT")
|
|
53
|
+
return undefined;
|
|
54
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot inspect native reservation", { cause: error });
|
|
55
|
+
}
|
|
56
|
+
finally {
|
|
57
|
+
await handle?.close();
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
/** Atomically reserve the same path used by canonical checkpoints. */
|
|
61
|
+
async beginNative(operation, context) {
|
|
62
|
+
if (!/^[a-z][a-z0-9.-]{0,127}$/.test(operation))
|
|
63
|
+
throw new Error("INVALID_OPERATION: invalid native reservation operation");
|
|
64
|
+
if (context && !validRecoveryContext(context, operation))
|
|
65
|
+
throw new Error("INVALID_OPERATION: invalid native recovery context");
|
|
66
|
+
await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
|
|
67
|
+
const owner = randomUUID();
|
|
68
|
+
let version = context ? 3 : 2;
|
|
69
|
+
let contents = JSON.stringify({ version, kind: "native-operation", owner, operation, ...(context ? { recoveryContext: context } : {}) }) + "\n";
|
|
70
|
+
let handle;
|
|
71
|
+
try {
|
|
72
|
+
handle = await open(this.path, "wx", 0o600);
|
|
73
|
+
await handle.writeFile(contents, "utf8");
|
|
74
|
+
await handle.sync();
|
|
75
|
+
await syncParentDirectory(this.path);
|
|
76
|
+
}
|
|
77
|
+
catch (error) {
|
|
78
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot create exclusive native reservation", { cause: error });
|
|
79
|
+
}
|
|
80
|
+
finally {
|
|
81
|
+
await handle?.close();
|
|
82
|
+
}
|
|
83
|
+
let released = false;
|
|
84
|
+
let dispatchPossible = false;
|
|
85
|
+
let reservationId = createHash("sha256").update(contents).digest("hex");
|
|
86
|
+
let bindingStarted = false;
|
|
87
|
+
return { get reservationId() { return reservationId; }, markDispatchPossible: async () => {
|
|
88
|
+
if (released || dispatchPossible)
|
|
89
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: native dispatch boundary is unavailable");
|
|
90
|
+
// Mark first: even a failed or interrupted write must never authorize release.
|
|
91
|
+
dispatchPossible = true;
|
|
92
|
+
let marker;
|
|
93
|
+
try {
|
|
94
|
+
marker = await open(`${this.path}.dispatch-${reservationId}`, "wx", 0o600);
|
|
95
|
+
await marker.writeFile(JSON.stringify({ version: 1, reservationId, owner }) + "\n", "utf8");
|
|
96
|
+
await marker.sync();
|
|
97
|
+
await syncParentDirectory(this.path);
|
|
98
|
+
}
|
|
99
|
+
catch (error) {
|
|
100
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot persist dispatch boundary", { cause: error });
|
|
101
|
+
}
|
|
102
|
+
finally {
|
|
103
|
+
await marker?.close();
|
|
104
|
+
}
|
|
105
|
+
}, bindRecoveryContext: async (newContext) => {
|
|
106
|
+
if (released || !dispatchPossible || version !== 2 || bindingStarted) {
|
|
107
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: native intent binding is unavailable");
|
|
108
|
+
}
|
|
109
|
+
// Binding is one-shot, including on error. Once provider code has run,
|
|
110
|
+
// no failure here may re-enable release or dispatch.
|
|
111
|
+
bindingStarted = true;
|
|
112
|
+
if (!validRecoveryContext(newContext, operation))
|
|
113
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: invalid native intent");
|
|
114
|
+
let recorded;
|
|
115
|
+
try {
|
|
116
|
+
recorded = structuredClone(newContext);
|
|
117
|
+
}
|
|
118
|
+
catch (error) {
|
|
119
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot serialize native intent", { cause: error });
|
|
120
|
+
}
|
|
121
|
+
if (!validRecoveryContext(recorded, operation))
|
|
122
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: invalid serialized native intent");
|
|
123
|
+
const safeContext = recorded.kind === "publish"
|
|
124
|
+
? { kind: recorded.kind, jobId: recorded.jobId, dispatchId: recorded.dispatchId,
|
|
125
|
+
requestedTarget: { libraryPath: recorded.requestedTarget.libraryPath }, artifactDigest: recorded.artifactDigest,
|
|
126
|
+
executorIdentity: null, nativeQuiescence: "unproven" }
|
|
127
|
+
: { kind: recorded.kind, jobId: recorded.jobId, dispatchId: recorded.dispatchId,
|
|
128
|
+
requestedTarget: { libraryUid: recorded.requestedTarget.libraryUid, eventUid: recorded.requestedTarget.eventUid,
|
|
129
|
+
projectUid: recorded.requestedTarget.projectUid, sequenceUid: recorded.requestedTarget.sequenceUid },
|
|
130
|
+
artifactDigest: recorded.artifactDigest, desiredDigest: recorded.desiredDigest,
|
|
131
|
+
...(recorded.destination ? { destination: { mode: recorded.destination.mode, projectUid: recorded.destination.projectUid,
|
|
132
|
+
sequenceUid: recorded.destination.sequenceUid, projectName: recorded.destination.projectName,
|
|
133
|
+
sequenceName: recorded.destination.sequenceName } } : {}),
|
|
134
|
+
executorIdentity: null, nativeQuiescence: "unproven" };
|
|
135
|
+
const nextContents = JSON.stringify({ version: 3, kind: "native-operation", owner, operation, recoveryContext: safeContext }) + "\n";
|
|
136
|
+
if (Buffer.byteLength(nextContents) > 16_384)
|
|
137
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: native intent is too large");
|
|
138
|
+
const nextId = createHash("sha256").update(nextContents).digest("hex");
|
|
139
|
+
let marker;
|
|
140
|
+
let pending;
|
|
141
|
+
try {
|
|
142
|
+
// Persist the next identity's uncertainty marker before updating the
|
|
143
|
+
// reservation. A crash during the rewrite stays unknown and closed.
|
|
144
|
+
marker = await open(`${this.path}.dispatch-${nextId}`, "wx", 0o600);
|
|
145
|
+
await marker.writeFile(JSON.stringify({ version: 1, reservationId: nextId, owner }) + "\n", "utf8");
|
|
146
|
+
await marker.sync();
|
|
147
|
+
await syncParentDirectory(this.path);
|
|
148
|
+
pending = await open(this.path, constants.O_RDWR | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
149
|
+
const before = await pending.stat();
|
|
150
|
+
const current = await lstat(this.path);
|
|
151
|
+
if (!before.isFile() || !current.isFile() || before.dev !== current.dev || before.ino !== current.ino
|
|
152
|
+
|| before.size > 16_384 || await pending.readFile("utf8") !== contents)
|
|
153
|
+
throw new Error("reservation ownership changed");
|
|
154
|
+
const data = Buffer.from(nextContents, "utf8");
|
|
155
|
+
let offset = 0;
|
|
156
|
+
while (offset < data.length) {
|
|
157
|
+
const { bytesWritten } = await pending.write(data, offset, data.length - offset, offset);
|
|
158
|
+
if (!bytesWritten)
|
|
159
|
+
throw new Error("short reservation write");
|
|
160
|
+
offset += bytesWritten;
|
|
161
|
+
}
|
|
162
|
+
await pending.truncate(data.length);
|
|
163
|
+
await pending.sync();
|
|
164
|
+
const after = await pending.stat();
|
|
165
|
+
const latest = await lstat(this.path);
|
|
166
|
+
if (!latest.isFile() || after.dev !== latest.dev || after.ino !== latest.ino)
|
|
167
|
+
throw new Error("reservation ownership changed");
|
|
168
|
+
contents = nextContents;
|
|
169
|
+
version = 3;
|
|
170
|
+
reservationId = nextId;
|
|
171
|
+
}
|
|
172
|
+
catch (error) {
|
|
173
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot bind native intent", { cause: error });
|
|
174
|
+
}
|
|
175
|
+
finally {
|
|
176
|
+
await pending?.close();
|
|
177
|
+
await marker?.close();
|
|
178
|
+
}
|
|
179
|
+
}, release: async () => {
|
|
180
|
+
if (released)
|
|
181
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: native reservation was already released");
|
|
182
|
+
if (dispatchPossible)
|
|
183
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: native dispatch may have begun");
|
|
184
|
+
// Block dispatch immediately, including while the filesystem release is pending.
|
|
185
|
+
// A failed release remains closed instead of reopening the dispatch boundary.
|
|
186
|
+
released = true;
|
|
187
|
+
await this.completeOwned(owner, version);
|
|
188
|
+
} };
|
|
189
|
+
}
|
|
190
|
+
async inspectVersioned() {
|
|
191
|
+
let handle;
|
|
192
|
+
try {
|
|
193
|
+
handle = await open(this.path, constants.O_RDONLY | constants.O_NOFOLLOW);
|
|
194
|
+
const info = await handle.stat();
|
|
195
|
+
if (!info.isFile() || info.size > 16_384)
|
|
196
|
+
throw new Error("invalid checkpoint file");
|
|
197
|
+
const contents = await handle.readFile("utf8");
|
|
198
|
+
const record = JSON.parse(contents);
|
|
199
|
+
if (record.version !== 1 || typeof record.owner !== "string"
|
|
200
|
+
|| !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(record.owner)
|
|
201
|
+
|| !record.checkpoint || typeof record.checkpoint !== "object" || Array.isArray(record.checkpoint)) {
|
|
202
|
+
throw new Error("invalid checkpoint record");
|
|
203
|
+
}
|
|
204
|
+
const checkpoint = record.checkpoint;
|
|
205
|
+
const { projectId, sequenceId, baseRevision, beforeDigest, operation, expectedRestoreDigest } = checkpoint;
|
|
206
|
+
if (typeof projectId !== "string" || !projectId.trim()
|
|
207
|
+
|| typeof sequenceId !== "string" || !sequenceId.trim()
|
|
208
|
+
|| typeof baseRevision !== "string" || !baseRevision.trim()
|
|
209
|
+
|| typeof beforeDigest !== "string" || !/^[a-f0-9]{64}$/i.test(beforeDigest)
|
|
210
|
+
|| typeof operation !== "string" || !["rename-clip", "trim-clip", "add-marker", "ripple-delete", "set-gain", "undo"].includes(operation)
|
|
211
|
+
|| (expectedRestoreDigest !== undefined && (typeof expectedRestoreDigest !== "string" || !/^[a-f0-9]{64}$/i.test(expectedRestoreDigest)))) {
|
|
212
|
+
throw new Error("incomplete checkpoint evidence");
|
|
213
|
+
}
|
|
214
|
+
return {
|
|
215
|
+
checkpointId: createHash("sha256").update(contents).digest("hex"),
|
|
216
|
+
checkpoint: { projectId, sequenceId, baseRevision, beforeDigest, operation,
|
|
217
|
+
...(typeof expectedRestoreDigest === "string" ? { expectedRestoreDigest } : {}) },
|
|
218
|
+
};
|
|
219
|
+
}
|
|
220
|
+
catch (error) {
|
|
221
|
+
if (error.code === "ENOENT")
|
|
222
|
+
return undefined;
|
|
223
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot inspect recovery evidence", { cause: error });
|
|
224
|
+
}
|
|
225
|
+
finally {
|
|
226
|
+
await handle?.close();
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
async begin(checkpoint) {
|
|
230
|
+
await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
|
|
231
|
+
let handle;
|
|
232
|
+
try {
|
|
233
|
+
handle = await open(this.path, "wx", 0o600);
|
|
234
|
+
const owner = randomUUID();
|
|
235
|
+
await handle.writeFile(JSON.stringify({ version: 1, owner, checkpoint }) + "\n", "utf8");
|
|
236
|
+
await handle.sync();
|
|
237
|
+
this.owner = owner;
|
|
238
|
+
}
|
|
239
|
+
catch (error) {
|
|
240
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot create exclusive recovery checkpoint", { cause: error });
|
|
241
|
+
}
|
|
242
|
+
finally {
|
|
243
|
+
await handle?.close();
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
async complete() {
|
|
247
|
+
if (!this.owner)
|
|
248
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: checkpoint ownership is unavailable");
|
|
249
|
+
await this.completeOwned(this.owner, 1);
|
|
250
|
+
this.owner = undefined;
|
|
251
|
+
}
|
|
252
|
+
async completeOwned(owner, version) {
|
|
253
|
+
try {
|
|
254
|
+
const info = await lstat(this.path);
|
|
255
|
+
if (!info.isFile() || info.isSymbolicLink())
|
|
256
|
+
throw new Error("invalid checkpoint");
|
|
257
|
+
const record = JSON.parse(await readFile(this.path, "utf8"));
|
|
258
|
+
if (record.version !== version || record.owner !== owner)
|
|
259
|
+
throw new Error("checkpoint ownership changed");
|
|
260
|
+
await unlink(this.path);
|
|
261
|
+
}
|
|
262
|
+
catch (error) {
|
|
263
|
+
throw new Error("FINAL_CUT_CANONICAL_RECOVERY_REQUIRED: cannot safely complete recovery checkpoint", { cause: error });
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
async function syncParentDirectory(path) {
|
|
268
|
+
const directory = await open(dirname(path), "r");
|
|
269
|
+
try {
|
|
270
|
+
await directory.sync();
|
|
271
|
+
}
|
|
272
|
+
finally {
|
|
273
|
+
await directory.close();
|
|
274
|
+
}
|
|
275
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { type ProjectSnapshot, type TimelineTarget } from "../../../../packages/runtime/src/index.js";
|
|
2
|
+
export interface CanonicalRecoveryResult {
|
|
3
|
+
attempted: true;
|
|
4
|
+
succeeded: true;
|
|
5
|
+
operationId: string;
|
|
6
|
+
beforeDigest: string;
|
|
7
|
+
restoredDigest: string;
|
|
8
|
+
}
|
|
9
|
+
export interface CanonicalRecoveryRequest {
|
|
10
|
+
operationId: string;
|
|
11
|
+
before: ProjectSnapshot;
|
|
12
|
+
target: TimelineTarget;
|
|
13
|
+
undo: (operationId: string) => Promise<{
|
|
14
|
+
undone: boolean;
|
|
15
|
+
verification?: {
|
|
16
|
+
verified: boolean;
|
|
17
|
+
};
|
|
18
|
+
}>;
|
|
19
|
+
readSnapshot: () => Promise<ProjectSnapshot>;
|
|
20
|
+
}
|
|
21
|
+
/** Recover one verified native mutation and prove the original target digest. */
|
|
22
|
+
export declare function recoverCanonicalNativeMutation(request: CanonicalRecoveryRequest): Promise<CanonicalRecoveryResult>;
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { type ProjectSnapshot, type TimelineDiff, type TimelineTarget } from "../../../../packages/runtime/src/index.js";
|
|
2
|
+
export interface CanonicalReadbackEvidence {
|
|
3
|
+
beforeDigest: string;
|
|
4
|
+
afterDigest: string;
|
|
5
|
+
diff: TimelineDiff;
|
|
6
|
+
}
|
|
7
|
+
export interface CanonicalReadbackOptions {
|
|
8
|
+
validateDiff?: (diff: TimelineDiff) => void;
|
|
9
|
+
}
|
|
10
|
+
/** Validate one canonical before/after pair and return its durable evidence. */
|
|
11
|
+
export declare function verifyCanonicalReadback(before: ProjectSnapshot, after: ProjectSnapshot, target: TimelineTarget, options?: CanonicalReadbackOptions): CanonicalReadbackEvidence;
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
import { canonicalTimelineMode } from "../../../../packages/runtime/src/index.js";
|
|
2
|
+
import { type ContextRevision, type EditorChange, type EditorIdentity, type EditorLiveState, type EditOperation, type EditorPort, type LiveEditorStatePort, type ProjectCatalog, type ProjectSelection, type ProjectSelectionResult, type ProjectSnapshot, type RationalTime, type RuntimeCapabilities, type CapabilityInspectionOptions, type WorkflowOperation } from "../../../../packages/runtime/src/index.js";
|
|
3
|
+
import type { NativeFinalCutEditor } from "./native.js";
|
|
4
|
+
import { type FcpxmlTargetBinding } from "./fcpxml.js";
|
|
5
|
+
export interface CanonicalNativeMutationPort {
|
|
6
|
+
renameSelectedClip(name: string): Promise<{
|
|
7
|
+
operationId: string;
|
|
8
|
+
undoAvailable: boolean;
|
|
9
|
+
}>;
|
|
10
|
+
trimSelectedClipToRange?(range: {
|
|
11
|
+
start: RationalTime;
|
|
12
|
+
end: RationalTime;
|
|
13
|
+
}): Promise<{
|
|
14
|
+
operationId: string;
|
|
15
|
+
undoAvailable: boolean;
|
|
16
|
+
}>;
|
|
17
|
+
addMarkerAtTime?(marker: {
|
|
18
|
+
start: RationalTime;
|
|
19
|
+
duration: RationalTime;
|
|
20
|
+
name: string;
|
|
21
|
+
}): Promise<{
|
|
22
|
+
operationId: string;
|
|
23
|
+
undoAvailable: boolean;
|
|
24
|
+
}>;
|
|
25
|
+
rippleDeleteRange?(range: {
|
|
26
|
+
start: RationalTime;
|
|
27
|
+
end: RationalTime;
|
|
28
|
+
}): Promise<{
|
|
29
|
+
operationId: string;
|
|
30
|
+
undoAvailable: boolean;
|
|
31
|
+
}>;
|
|
32
|
+
setSelectedClipGain?(gainDb: number): Promise<{
|
|
33
|
+
operationId: string;
|
|
34
|
+
undoAvailable: boolean;
|
|
35
|
+
}>;
|
|
36
|
+
undo(operationId: string): Promise<{
|
|
37
|
+
undone: boolean;
|
|
38
|
+
verification?: {
|
|
39
|
+
verified: boolean;
|
|
40
|
+
};
|
|
41
|
+
}>;
|
|
42
|
+
}
|
|
43
|
+
export type CanonicalNativeTargetResolver = ((clip: ProjectSnapshot["timeline"]["clips"][number], snapshot: ProjectSnapshot) => Promise<void>) & {
|
|
44
|
+
trackNativeDispatch?<T>(operation: () => Promise<T>, onDispatch: () => void): Promise<T>;
|
|
45
|
+
sourceBindingAvailable?: boolean;
|
|
46
|
+
};
|
|
47
|
+
export interface FinalCutBackgroundCatalogProvider {
|
|
48
|
+
listProjects(): Promise<ProjectCatalog>;
|
|
49
|
+
backend?: string;
|
|
50
|
+
}
|
|
51
|
+
export interface CanonicalRecoveryCheckpoint {
|
|
52
|
+
projectId: string;
|
|
53
|
+
sequenceId: string;
|
|
54
|
+
baseRevision: string;
|
|
55
|
+
beforeDigest: string;
|
|
56
|
+
operation: string;
|
|
57
|
+
expectedRestoreDigest?: string;
|
|
58
|
+
}
|
|
59
|
+
export interface CanonicalRecoveryGuard {
|
|
60
|
+
assertClear(): Promise<void>;
|
|
61
|
+
begin(checkpoint: CanonicalRecoveryCheckpoint): Promise<void>;
|
|
62
|
+
complete(): Promise<void>;
|
|
63
|
+
}
|
|
64
|
+
export interface FinalCutCanonicalNativeProviderOptions {
|
|
65
|
+
live: LiveEditorStatePort & {
|
|
66
|
+
getIdentity(): Promise<EditorIdentity>;
|
|
67
|
+
getCapabilities?(options?: CapabilityInspectionOptions): Promise<RuntimeCapabilities>;
|
|
68
|
+
listProjects?(): Promise<ProjectCatalog>;
|
|
69
|
+
selectProject?(selection: ProjectSelection): Promise<ProjectSelectionResult>;
|
|
70
|
+
};
|
|
71
|
+
native: CanonicalNativeMutationPort;
|
|
72
|
+
readSnapshot: () => Promise<ProjectSnapshot>;
|
|
73
|
+
resolveTarget: CanonicalNativeTargetResolver;
|
|
74
|
+
backgroundCatalog?: FinalCutBackgroundCatalogProvider;
|
|
75
|
+
recoveryGuard?: CanonicalRecoveryGuard;
|
|
76
|
+
}
|
|
77
|
+
export interface FinalCutCanonicalSnapshotSourceOptions {
|
|
78
|
+
executor?: (script: string) => Promise<string>;
|
|
79
|
+
exportTimeoutMs?: number;
|
|
80
|
+
pollIntervalMs?: number;
|
|
81
|
+
target?: FcpxmlTargetBinding;
|
|
82
|
+
/** Catalog-bound publish readback. Catalog IDs are not FCPXML UIDs. */
|
|
83
|
+
readbackTarget?: {
|
|
84
|
+
projectId: string;
|
|
85
|
+
sequenceId: string;
|
|
86
|
+
projectName: string;
|
|
87
|
+
sequenceName: string;
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
export type FinalCutCanonicalExportCleanup = "complete" | "incomplete";
|
|
91
|
+
export type FinalCutCanonicalExportResult = {
|
|
92
|
+
status: "export-requested";
|
|
93
|
+
} | {
|
|
94
|
+
status: "retryable" | "failed";
|
|
95
|
+
code: string;
|
|
96
|
+
message: string;
|
|
97
|
+
cleanup: FinalCutCanonicalExportCleanup;
|
|
98
|
+
};
|
|
99
|
+
/** Structured failure returned when headed Export XML recovery can be retried. */
|
|
100
|
+
export declare class FinalCutCanonicalExportError extends Error {
|
|
101
|
+
readonly code: string;
|
|
102
|
+
readonly retryable: boolean;
|
|
103
|
+
readonly cleanup: FinalCutCanonicalExportCleanup;
|
|
104
|
+
constructor(result: Extract<FinalCutCanonicalExportResult, {
|
|
105
|
+
status: "retryable" | "failed";
|
|
106
|
+
}>);
|
|
107
|
+
toJSON(): {
|
|
108
|
+
code: string;
|
|
109
|
+
message: string;
|
|
110
|
+
retryable: boolean;
|
|
111
|
+
cleanup: FinalCutCanonicalExportCleanup;
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
/** Parse the JSON envelope returned by the headed canonical export workflow. */
|
|
115
|
+
export declare function parseFinalCutCanonicalExportResult(input: string | unknown): FinalCutCanonicalExportResult;
|
|
116
|
+
export interface CanonicalLiveReadiness {
|
|
117
|
+
ready: boolean;
|
|
118
|
+
mode: ReturnType<typeof canonicalTimelineMode>;
|
|
119
|
+
missing: string[];
|
|
120
|
+
}
|
|
121
|
+
/** Report the complete guarantees required before claiming canonical live support. */
|
|
122
|
+
export declare function assessCanonicalLiveReadiness(capabilities: RuntimeCapabilities): CanonicalLiveReadiness;
|
|
123
|
+
/** Reads the active Final Cut project through its headed Export XML command. */
|
|
124
|
+
export declare class FinalCutCanonicalSnapshotSource {
|
|
125
|
+
private readonly executor;
|
|
126
|
+
private readonly exportTimeoutMs;
|
|
127
|
+
private readonly pollIntervalMs;
|
|
128
|
+
private readonly target?;
|
|
129
|
+
private readonly readbackTarget?;
|
|
130
|
+
private readonly stageOnDesktop;
|
|
131
|
+
constructor(options?: FinalCutCanonicalSnapshotSourceOptions);
|
|
132
|
+
readSnapshot(): Promise<ProjectSnapshot>;
|
|
133
|
+
}
|
|
134
|
+
export declare function buildFinalCutCanonicalExportScript(exportPath: string): string;
|
|
135
|
+
export declare function createFinalCutNativeTargetResolver(native: Pick<NativeFinalCutEditor, "searchMedia" | "locateOccurrence"> & Partial<Pick<NativeFinalCutEditor, "capabilities" | "selectOccurrence" | "locateOccurrenceForCanonicalTarget" | "searchMediaForCanonicalTarget" | "trackNativeDispatch" | "inspectSelectedOccurrenceSource">>): CanonicalNativeTargetResolver;
|
|
136
|
+
/**
|
|
137
|
+
* Canonical provider for the headed Final Cut UI path.
|
|
138
|
+
*
|
|
139
|
+
* `readSnapshot` must export the currently active Final Cut project through
|
|
140
|
+
* Final Cut itself. It is deliberately injected so the provider cannot fall
|
|
141
|
+
* back to an arbitrary FCPXML artifact. Native mutation is separately bound
|
|
142
|
+
* to one exported occurrence before Accessibility is allowed to edit it.
|
|
143
|
+
*/
|
|
144
|
+
export declare class FinalCutCanonicalNativeProvider implements EditorPort, LiveEditorStatePort {
|
|
145
|
+
private readonly live;
|
|
146
|
+
private readonly native;
|
|
147
|
+
private readonly readSnapshotSource;
|
|
148
|
+
private readonly resolveTarget;
|
|
149
|
+
private readonly backgroundCatalog?;
|
|
150
|
+
private lastDigest?;
|
|
151
|
+
private lastLiveRevision?;
|
|
152
|
+
private readonly revisionEpoch;
|
|
153
|
+
private lastSnapshot?;
|
|
154
|
+
private readonly readScope;
|
|
155
|
+
private selectedTarget?;
|
|
156
|
+
private revisionSequence;
|
|
157
|
+
private revision?;
|
|
158
|
+
private pending?;
|
|
159
|
+
private recoveryRequired;
|
|
160
|
+
private readonly recoveryGuard?;
|
|
161
|
+
constructor(options: FinalCutCanonicalNativeProviderOptions);
|
|
162
|
+
getIdentity(): Promise<EditorIdentity>;
|
|
163
|
+
withCanonicalReadScope<T>(operation: () => Promise<T>): Promise<T>;
|
|
164
|
+
getCapabilities(options?: CapabilityInspectionOptions): Promise<RuntimeCapabilities>;
|
|
165
|
+
private cachedCanonicalSnapshotAvailability;
|
|
166
|
+
private probeCanonicalSnapshot;
|
|
167
|
+
read(): Promise<ProjectSnapshot>;
|
|
168
|
+
readProject(): Promise<ProjectSnapshot>;
|
|
169
|
+
previewTransaction(operations: WorkflowOperation[], expectedRevision: ContextRevision): Promise<ProjectSnapshot>;
|
|
170
|
+
applyTransaction(operations: WorkflowOperation[], expectedRevision: ContextRevision): Promise<void>;
|
|
171
|
+
apply(operation: EditOperation, expectedRevision: ContextRevision): Promise<ContextRevision>;
|
|
172
|
+
private assertRecoveryNotRequired;
|
|
173
|
+
restore(snapshot: ProjectSnapshot, expectedRevision: ContextRevision): Promise<void>;
|
|
174
|
+
listProjects(): Promise<ProjectCatalog>;
|
|
175
|
+
selectProject(selection: ProjectSelection): Promise<ProjectSelectionResult>;
|
|
176
|
+
readLiveState(): Promise<EditorLiveState>;
|
|
177
|
+
liveChangesSince(revision: ContextRevision, waitMs?: number): Promise<EditorChange[]>;
|
|
178
|
+
private assertActiveTarget;
|
|
179
|
+
private resolveBackgroundCatalog;
|
|
180
|
+
private projectSelectionCapability;
|
|
181
|
+
private assertSelectedTarget;
|
|
182
|
+
private readBackgroundCatalog;
|
|
183
|
+
private readLiveStateSafely;
|
|
184
|
+
}
|