@morshoto/framekit 0.1.6 → 0.1.11

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.
Files changed (43) hide show
  1. package/bin/framekit.mjs +2 -1
  2. package/dist-package/adapters/final-cut/typescript/src/assets.js +157 -35
  3. package/dist-package/adapters/final-cut/typescript/src/background-export.js +384 -0
  4. package/dist-package/adapters/final-cut/typescript/src/background-materialization.js +175 -0
  5. package/dist-package/adapters/final-cut/typescript/src/canonical.js +189 -32
  6. package/dist-package/adapters/final-cut/typescript/src/connection.js +55 -17
  7. package/dist-package/adapters/final-cut/typescript/src/disposable-native.js +33 -7
  8. package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.js +74 -0
  9. package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +615 -49
  10. package/dist-package/adapters/final-cut/typescript/src/index.js +10 -0
  11. package/dist-package/adapters/final-cut/typescript/src/library-inspection.js +390 -0
  12. package/dist-package/adapters/final-cut/typescript/src/live.js +16 -6
  13. package/dist-package/adapters/final-cut/typescript/src/media.js +151 -0
  14. package/dist-package/adapters/final-cut/typescript/src/native-session.js +412 -0
  15. package/dist-package/adapters/final-cut/typescript/src/native.js +1192 -364
  16. package/dist-package/adapters/final-cut/typescript/src/publisher.js +225 -32
  17. package/dist-package/adapters/final-cut/typescript/src/session.js +163 -17
  18. package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.js +120 -0
  19. package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.js +433 -0
  20. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +372 -0
  21. package/dist-package/adapters/final-cut/typescript/src/unattended-editing.js +66 -0
  22. package/dist-package/apps/mcp-server/src/headless-sessions.js +112 -0
  23. package/dist-package/apps/mcp-server/src/main.js +41 -8
  24. package/dist-package/apps/mcp-server/src/materialization-jobs.js +326 -0
  25. package/dist-package/apps/mcp-server/src/routing.js +227 -39
  26. package/dist-package/apps/mcp-server/src/server.js +642 -97
  27. package/dist-package/apps/mcp-server/src/version.js +109 -1
  28. package/dist-package/packages/runtime/src/application/media-analysis-service.js +1 -3
  29. package/dist-package/packages/runtime/src/application/project-service.js +46 -7
  30. package/dist-package/packages/runtime/src/capabilities.js +55 -7
  31. package/dist-package/packages/runtime/src/context/project-catalog.js +159 -0
  32. package/dist-package/packages/runtime/src/domain/capabilities.js +33 -0
  33. package/dist-package/packages/runtime/src/domain/context.js +14 -1
  34. package/dist-package/packages/runtime/src/domain/index.js +1 -0
  35. package/dist-package/packages/runtime/src/domain/timeline-target.js +217 -0
  36. package/dist-package/packages/runtime/src/editing/edit-service.js +15 -1
  37. package/dist-package/packages/runtime/src/editing/intent.js +178 -2
  38. package/dist-package/packages/runtime/src/index.js +3 -0
  39. package/dist-package/packages/runtime/src/runtime.js +2 -2
  40. package/dist-package/packages/runtime/src/timeline/drift-reconciliation.js +295 -0
  41. package/dist-package/packages/runtime/src/timeline/editing-session.js +490 -0
  42. package/dist-package/packages/testkit/src/in-memory-editor.js +5 -4
  43. package/package.json +12 -6
@@ -40,12 +40,37 @@ export class DisposableNativeEditWorkflow {
40
40
  return {
41
41
  previewToken,
42
42
  operation: { type: "rename-selected-clip", name: request.name },
43
- target: { clipId: target.id, name: target.name },
43
+ target: { clipId: target.id, name: target.name, ...(nativeTarget.identity ? { identity: nativeTarget.identity } : {}) },
44
+ projectId: before.projectId,
45
+ sequenceId: before.timeline.id,
46
+ targetIdentity: nativeTarget.identity ?? target.id,
44
47
  baseRevision: structuredClone(before.revision),
45
48
  expiresAt: new Date(expiresAt).toISOString(),
46
49
  };
47
50
  }
48
- async execute(previewToken) {
51
+ getPreview(previewToken) {
52
+ const preview = this.previews.get(previewToken);
53
+ if (!preview)
54
+ return undefined;
55
+ if (this.now() >= preview.expiresAt) {
56
+ this.previews.delete(previewToken);
57
+ return undefined;
58
+ }
59
+ const target = preview.before.timeline.clips.find((clip) => clip.id === preview.request.clipId);
60
+ if (!target)
61
+ return undefined;
62
+ return {
63
+ previewToken,
64
+ operation: { type: "rename-selected-clip", name: preview.request.name },
65
+ target: { clipId: target.id, name: target.name, ...(preview.nativeTarget.identity ? { identity: preview.nativeTarget.identity } : {}) },
66
+ projectId: preview.before.projectId,
67
+ sequenceId: preview.before.timeline.id,
68
+ targetIdentity: preview.nativeTarget.identity ?? target.id,
69
+ baseRevision: structuredClone(preview.before.revision),
70
+ expiresAt: new Date(preview.expiresAt).toISOString(),
71
+ };
72
+ }
73
+ async execute(previewToken, options = {}) {
49
74
  const preview = this.previews.get(previewToken);
50
75
  if (!preview)
51
76
  throw new Error(`PREVIEW_TOKEN_INVALID: unknown or already used preview ${previewToken}`);
@@ -60,8 +85,9 @@ export class DisposableNativeEditWorkflow {
60
85
  if (!currentTarget || currentTarget.name !== preview.before.timeline.clips.find((clip) => clip.id === preview.request.clipId)?.name) {
61
86
  throw new Error("TARGET_MISMATCH: canonical target changed after disposable native preview");
62
87
  }
63
- await this.assertNativeTarget(current, currentTarget.name, preview.nativeTarget);
64
- const native = await this.options.native.edit({ type: "rename-selected-clip", name: preview.request.name });
88
+ await this.assertNativeTarget(current, currentTarget.name, preview.nativeTarget, options.signal);
89
+ options.onMutationStart?.();
90
+ const native = await this.options.native.edit({ type: "rename-selected-clip", name: preview.request.name }, { signal: options.signal });
65
91
  let after;
66
92
  try {
67
93
  after = await this.readCanonical("read-after-write");
@@ -172,10 +198,10 @@ export class DisposableNativeEditWorkflow {
172
198
  throw new Error(`CAPABILITY_UNAVAILABLE: disposable native canonical snapshot (${String(error)})`);
173
199
  }
174
200
  }
175
- async assertNativeTarget(snapshot, expectedName, previousTarget) {
201
+ async assertNativeTarget(snapshot, expectedName, previousTarget, signal) {
176
202
  const capabilities = this.options.native.capabilities();
177
203
  assertNativeCapabilities(capabilities);
178
- const context = await this.options.native.inspect();
204
+ const context = await this.options.native.inspect({ signal });
179
205
  if (!context.available || !context.frontmost || !context.timelineWindowAvailable || !context.timelineFocused) {
180
206
  throw new Error("CAPABILITY_UNAVAILABLE: disposable native timeline preflight");
181
207
  }
@@ -188,7 +214,7 @@ export class DisposableNativeEditWorkflow {
188
214
  if (context.target.kind !== "selected-clip" || context.target.name !== expectedName) {
189
215
  throw new Error("TARGET_MISMATCH: native selected clip does not match the canonical target");
190
216
  }
191
- if (previousTarget?.identity && context.target.identity && previousTarget.identity !== context.target.identity) {
217
+ if (previousTarget?.identity && previousTarget.identity !== context.target.identity) {
192
218
  throw new Error("TARGET_MISMATCH: native selected clip identity changed after disposable preview");
193
219
  }
194
220
  return context.target;
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Classifies evidence collected around the FCPXML programmatic/artifact path.
3
+ * This function never authorizes a write: a headed result is preflight only,
4
+ * and target-bound import readback remains unavailable until independently
5
+ * proven by a native provider.
6
+ */
7
+ export function classifyFinalCutFcpxmlExperiment(observation) {
8
+ validateArtifact(observation.artifact);
9
+ if (!observation.console.source.trim())
10
+ throw new Error("FCPXML_EXPERIMENT_INVALID: console source is required");
11
+ if (!Number.isInteger(observation.log.lineCount) || observation.log.lineCount < 0) {
12
+ throw new Error("FCPXML_EXPERIMENT_INVALID: log lineCount must be a non-negative integer");
13
+ }
14
+ const base = {
15
+ schemaVersion: 1,
16
+ observation: structuredClone(observation),
17
+ capabilities: {
18
+ artifactRead: "verified",
19
+ targetBoundReadback: "unavailable",
20
+ },
21
+ mutationAttempted: false,
22
+ nativeImportVerified: false,
23
+ safeToOverwrite: false,
24
+ };
25
+ if (observation.console.state === "locked") {
26
+ return {
27
+ ...base,
28
+ status: "blocked",
29
+ capabilities: { ...base.capabilities, headedImport: "blocked" },
30
+ blockers: [{
31
+ code: "FINAL_CUT_NATIVE_CONSOLE_LOCKED",
32
+ retryable: observation.console.retryable,
33
+ message: "The macOS console is locked; no headed FCPXML import was attempted",
34
+ }],
35
+ };
36
+ }
37
+ if (observation.console.state === "unknown") {
38
+ return {
39
+ ...base,
40
+ status: "blocked",
41
+ capabilities: { ...base.capabilities, headedImport: "blocked" },
42
+ blockers: [{
43
+ code: "FINAL_CUT_NATIVE_CONSOLE_LOCK_STATE_UNKNOWN",
44
+ retryable: observation.console.retryable,
45
+ message: "macOS did not expose one consistent supported console lock state",
46
+ }],
47
+ };
48
+ }
49
+ if (observation.process !== "running") {
50
+ return artifactOnly(base, "FINAL_CUT_NOT_RUNNING", true, "Final Cut Pro is not running; only the FCPXML artifact was inspected");
51
+ }
52
+ if (observation.frontmost !== "final-cut") {
53
+ return artifactOnly(base, "FINAL_CUT_NOT_FRONTMOST", true, "Final Cut Pro is not frontmost; only the FCPXML artifact was inspected");
54
+ }
55
+ return {
56
+ ...base,
57
+ status: "headed-preflight-ready",
58
+ capabilities: { ...base.capabilities, headedImport: "preflight-only" },
59
+ blockers: [],
60
+ };
61
+ }
62
+ function artifactOnly(base, code, retryable, message) {
63
+ return {
64
+ ...base,
65
+ status: "artifact-only",
66
+ capabilities: { ...base.capabilities, headedImport: "blocked" },
67
+ blockers: [{ code, retryable, message }],
68
+ };
69
+ }
70
+ function validateArtifact(artifact) {
71
+ if (artifact.format !== "fcpxml" || !artifact.valid || artifact.version !== "1.11" || !/^[a-f0-9]{64}$/i.test(artifact.digest)) {
72
+ throw new Error("FCPXML_ARTIFACT_INVALID: experiment requires a valid FCPXML 1.11 artifact and SHA-256 digest");
73
+ }
74
+ }