apexrest 1.2.0 → 1.3.0-beta.1

package/dist/runtime/{chunk-HOKFFGSZ.mjs → chunk-33GE2NWZ.mjs}

@@ -2,7 +2,7 @@ import { createRequire as __createRequire } from 'node:module'; const require =
 import {
   managedHome,
   runtimeState
-} from "./chunk-3MDDJFXN.mjs";
+} from "./chunk-EBBEN4AV.mjs";
 import {
   Fault,
   exists,

package/dist/runtime/chunk-5JI3XEAK.mjs

@@ -0,0 +1,14 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+import {
+  startMcp
+} from "./chunk-BAHECVGO.mjs";
+import "./chunk-HKJVCGQQ.mjs";
+import "./chunk-FTTPESNK.mjs";
+import "./chunk-2BBNJVKW.mjs";
+import "./chunk-YPLIIQ4Y.mjs";
+import "./chunk-G3KR57BY.mjs";
+import "./chunk-EBBEN4AV.mjs";
+import "./chunk-2Z3BZF66.mjs";
+export {
+  startMcp
+};

package/dist/runtime/{chunk-2ZUNLCLK.mjs → chunk-BAHECVGO.mjs}

@@ -3,19 +3,19 @@ import {
   dispatch,
   schemas,
   toolCatalog
-} from "./chunk-TXVQLYTH.mjs";
+} from "./chunk-HKJVCGQQ.mjs";
 import {
   panelDocument
-} from "./chunk-AQZLLQ3D.mjs";
+} from "./chunk-FTTPESNK.mjs";
 import {
   JobService
-} from "./chunk-BD2AVCFU.mjs";
+} from "./chunk-2BBNJVKW.mjs";
 import {
   ArtifactService
-} from "./chunk-4MYHJ2IU.mjs";
+} from "./chunk-YPLIIQ4Y.mjs";
 import {
   VERSION
-} from "./chunk-S24BD6PY.mjs";
+} from "./chunk-G3KR57BY.mjs";
 import {
   AjvJsonSchemaValidator,
   CallToolRequestSchema,
@@ -49,7 +49,7 @@ import {
   parse,
   safeParse,
   serializeMessage
-} from "./chunk-3MDDJFXN.mjs";
+} from "./chunk-EBBEN4AV.mjs";
 import {
   Fault,
   failure,
@@ -747,13 +747,24 @@ function preview(value, depth = 0) {
     "scope",
     "compiler",
     "approval",
-    "backupRequired"
+    "backupRequired",
+    "mode",
+    "backupStrategy",
+    "syncId",
+    "revision",
+    "exportedAt",
+    "dirty",
+    "blocked",
+    "blockedReason",
+    "serverFreshness",
+    "backupId",
+    "importingRunId"
   ]) {
     const entry = data[key];
     if (["string", "number", "boolean"].includes(typeof entry))
       result[key] = typeof entry === "string" ? entry.slice(0, 400) : entry;
   }
-  for (const key of ["jobs", "deployments", "diagnostics", "artifacts", "verification"])
+  for (const key of ["sync", "jobs", "deployments", "diagnostics", "artifacts", "verification"])
     if (Array.isArray(data[key])) result[key + "Count"] = data[key].length;
   if (Array.isArray(data.diagnostics))
     result.diagnostics = data.diagnostics.slice(0, 2).map(
@@ -766,6 +777,9 @@ function preview(value, depth = 0) {
       result[key] = data[key].slice(0, 4).map((entry) => String(entry).slice(0, 200));
       result[key + "Omitted"] = Math.max(0, data[key].length - 4);
     }
+  if (data.lastSuccessfulImport && typeof data.lastSuccessfulImport === "object")
+    result.lastSuccessfulImport = data.lastSuccessfulImport;
+  if (data.workingCopy && typeof data.workingCopy === "object") result.workingCopy = data.workingCopy;
   if (depth < 2 && data.result && typeof data.result === "object")
     result.result = preview(data.result, depth + 1);
   if (data.operation === "deploy.plan" && data.data && depth < 2) result.data = preview(data.data, depth + 1);
@@ -953,7 +967,9 @@ var absoluteProject = external_exports.string().min(1).max(4096).refine(
 var mcpSchemas = /* @__PURE__ */ new Map();
 for (const { operation, long } of toolCatalog) {
   const schema = schemas[operation];
-  const transportSchema = "project" in schema.shape ? schema.extend({ project: operation === "doctor" ? absoluteProject.optional() : absoluteProject }) : schema;
+  const transportSchema = "project" in schema.shape ? schema.extend({
+    project: operation === "doctor" || operation.startsWith("docs.") ? absoluteProject.optional() : absoluteProject
+  }) : schema;
   mcpSchemas.set(operation, long ? transportSchema.extend({ waitSeconds: jobWaitSeconds }) : transportSchema);
 }
 async function startMcp() {
@@ -998,6 +1014,8 @@ async function startMcp() {
           destructiveHint: t.destructive ?? !t.readOnly,
           idempotentHint: t.readOnly,
           openWorldHint: ![
+            "compose.plan",
+            "compose.materialize",
             "doctor",
             "docs.search",
             "docs.read",
@@ -1018,7 +1036,9 @@ async function startMcp() {
       if (!tool) throw new Fault("UNKNOWN_TOOL", "Tool is not in the catalog.", 2);
       const input = parse(mcpSchemas.get(tool.operation), request.params.arguments ?? {});
       project = typeof input.project === "string" ? input.project : void 0;
-      result = tool.long ? jobToolResult(
+      const localSync = tool.operation === "apex.sync" && input.action === "status";
+      if (localSync) delete input.waitSeconds;
+      result = tool.long && !localSync ? jobToolResult(
         tool.operation,
         await runJobTool(
           new JobService(await loadProject(String(input.project))),

package/dist/{codex-compat/plugins/apexrest-apex/runtime/chunk-SPZVXAM5.mjs → runtime/chunk-CYPFCUNE.mjs}

@@ -6,10 +6,10 @@ import {
 } from "./chunk-TLYYCRQA.mjs";
 import {
   PanelService
-} from "./chunk-BD2AVCFU.mjs";
-import "./chunk-4MYHJ2IU.mjs";
-import "./chunk-S24BD6PY.mjs";
-import "./chunk-3MDDJFXN.mjs";
+} from "./chunk-2BBNJVKW.mjs";
+import "./chunk-YPLIIQ4Y.mjs";
+import "./chunk-G3KR57BY.mjs";
+import "./chunk-EBBEN4AV.mjs";
 import {
   Fault
 } from "./chunk-2Z3BZF66.mjs";
@@ -40,6 +40,9 @@ function panelLines(data, tab) {
       ...data.jobs.flatMap((job) => [`${job.operation} \xB7 ${job.status}`, job.summary]),
       ...data.jobs.length ? [] : ["No operation jobs recorded."],
       "",
+      "WORKING-COPY SYNC (local only)",
+      ...data.sync.flatMap((row) => [row.environment + " \xB7 " + row.status, JSON.stringify(row)]),
+      "",
       "DEPLOYMENT & IMPORT JOURNAL",
       ...data.deployments.flatMap((run) => [run.status + " \xB7 " + run.at, run.details]),
       "",

package/dist/{codex-compat/plugins/apexrest-apex/runtime/chunk-3MDDJFXN.mjs → runtime/chunk-EBBEN4AV.mjs}

@@ -28745,6 +28745,7 @@ var projectSchema = external_exports.strictObject({
     defaultBrowser: external_exports.literal("chromium"),
     mutationAllowedEnvironments: external_exports.array(refName)
   }),
+  composer: external_exports.strictObject({ allowSourceOnly: external_exports.boolean().default(false) }).optional(),
   artifacts: external_exports.strictObject({ directory: relativePath, retentionDays: external_exports.number().int().min(1).max(365) })
 });
 var managedHome = () => path.resolve(process.env.APEXREST_HOME ?? path.join(homedir(), ".apexrest"));
@@ -33195,7 +33196,7 @@ connect -orest -user "${selected.ords.username}" -password "${selected.ords.pass
     };
   }
   async exportApplication(env, connection, format = "APEXLANG") {
-    await this.requireCapability("export");
+    const compiler = await this.requireCapability("export");
     const stage = await this.stage();
     const ords = (await this.settings()).databaseTransport === "ords";
     const exportRoot = ords ? path5.join(stage, "export") : stage;
@@ -33225,7 +33226,7 @@ connect -orest -user "${selected.ords.username}" -password "${selected.ords.pass
     const files = await inventory(directory);
     if (!Object.keys(files).length || format === "SQL" && !Object.keys(files).some((f2) => f2.endsWith(".sql")))
       throw new Fault("EMPTY_BACKUP", "Oracle export produced no usable files.", 1);
-    return { directory, files, digest: hash(canonical(files)), format, output: result.output };
+    return { directory, files, digest: hash(canonical(files)), format, compiler, output: result.output };
   }
   async savedConnections(signal) {
     const marker = `APEXREST_CONNECTIONS_${randomUUID().replaceAll("-", "")}`;
@@ -33356,6 +33357,28 @@ ${sql};`,
       );
     return { identity, workspace: workspaces[0], application: applications[0] ?? null };
   }
+  async applicationMetadata(env, connection) {
+    const rows = await this.jsonQuery(
+      `select to_char(last_updated_on, 'YYYY-MM-DD"T"HH24:MI:SS', 'NLS_DATE_LANGUAGE=American') last_updated_on,
+        last_updated_by from apex_applications
+        where application_id = :p_app_id and workspace = :p_workspace and owner = :p_owner`,
+      connection,
+      { p_app_id: env.applicationId, p_workspace: env.workspace, p_owner: env.parsingSchema }
+    );
+    if (rows.length !== 1 || !Object.hasOwn(rows[0], "last_updated_on") || !Object.hasOwn(rows[0], "last_updated_by"))
+      throw new Fault(
+        "SYNC_METADATA_UNCONFIRMED",
+        "Application update metadata is absent or inaccessible.",
+        5
+      );
+    const row = rows[0];
+    if ([row.last_updated_on, row.last_updated_by].some((v2) => v2 !== null && typeof v2 !== "string"))
+      throw new Fault("SYNC_METADATA_UNCONFIRMED", "Unexpected application update metadata.", 5);
+    return {
+      lastUpdatedOn: row.last_updated_on,
+      lastUpdatedBy: row.last_updated_by
+    };
+  }
   async nativeDeployment(ctx, env, source) {
     const output2 = path5.join(await this.stage(), "deployment.json");
     const defaults = path5.join(source, "deployments/default.json");
@@ -37025,7 +37048,6 @@ var ToolchainService = class {
 };
 
 export {
-  runProcess,
   external_exports,
   identifier,
   refName,
@@ -37043,6 +37065,7 @@ export {
   resolveConnection,
   editConnection,
   configureConnection,
+  runProcess,
   sqlclMode,
   sqlclRestriction,
   databaseTransport,
@@ -37096,13 +37119,13 @@ export {
   ReadBuffer,
   serializeMessage,
   StdioClientTransport,
+  resourceRoot,
+  projectInit,
+  projectInspect,
   sqlclToken,
   sqlLiteral,
   OracleAdapter,
   installSources,
-  resourceRoot,
-  projectInit,
-  projectInspect,
   lockSchema,
   runtimeState,
   platformProfile,

package/dist/{codex-compat/plugins/apexrest-apex/runtime/chunk-NDZ2RWQU.mjs → runtime/chunk-ESDVN7DS.mjs}

@@ -3,8 +3,9 @@ import {
   browserInstructions,
   externalBrowserCommand,
   openVerificationBrowser
-} from "./chunk-4MYHJ2IU.mjs";
-import "./chunk-3MDDJFXN.mjs";
+} from "./chunk-YPLIIQ4Y.mjs";
+import "./chunk-G3KR57BY.mjs";
+import "./chunk-EBBEN4AV.mjs";
 import "./chunk-2Z3BZF66.mjs";
 export {
   browserInstructions,

package/dist/runtime/{chunk-AQZLLQ3D.mjs → chunk-FTTPESNK.mjs}

@@ -2,11 +2,11 @@ import { createRequire as __createRequire } from 'node:module'; const require =
 import {
   PanelService,
   panelActionSchema
-} from "./chunk-BD2AVCFU.mjs";
+} from "./chunk-2BBNJVKW.mjs";
 import {
   parse,
   resourceRoot
-} from "./chunk-3MDDJFXN.mjs";
+} from "./chunk-EBBEN4AV.mjs";
 import {
   Fault,
   contained,

package/dist/runtime/{chunk-S24BD6PY.mjs → chunk-G3KR57BY.mjs}

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from 'node:module'; const require =
 // plugins/metadata.json
 var metadata_default = {
   name: "apexrest-apex",
-  version: "1.2.0",
+  version: "1.3.0-beta.1",
   description: "Develop, deploy and test Oracle APEX applications with Codex.",
   author: {
     name: "APEXREST",

package/dist/runtime/{chunk-TXVQLYTH.mjs → chunk-HKJVCGQQ.mjs}

@@ -2,18 +2,28 @@ import { createRequire as __createRequire } from 'node:module'; const require =
 import {
   JobService,
   PanelService,
+  composeMaterialize,
+  composeMaterializeInput,
+  composePlan,
+  composePlanInput,
+  metadataInputSchema,
+  metadataRead,
   panelActionSchema,
   panelReadSchema,
   publicPanelActionSchema
-} from "./chunk-BD2AVCFU.mjs";
+} from "./chunk-2BBNJVKW.mjs";
 import {
   ArtifactService,
   DeploymentService,
-  TestService
-} from "./chunk-4MYHJ2IU.mjs";
+  SyncStore,
+  TestService,
+  catalogRead,
+  catalogSearch,
+  checkpoint
+} from "./chunk-YPLIIQ4Y.mjs";
 import {
   VERSION
-} from "./chunk-S24BD6PY.mjs";
+} from "./chunk-G3KR57BY.mjs";
 import {
   OracleAdapter,
   configureConnection,
@@ -23,7 +33,6 @@ import {
   editConnection,
   environment,
   external_exports,
-  identifier,
   installSources,
   loadProject,
   managedHome,
@@ -43,7 +52,7 @@ import {
   sqlclConfig,
   sqlclMode,
   sqlclRestriction
-} from "./chunk-3MDDJFXN.mjs";
+} from "./chunk-EBBEN4AV.mjs";
 import {
   Fault,
   artifactPage,
@@ -59,72 +68,6 @@ import {
   writeJson
 } from "./chunk-2Z3BZF66.mjs";
 
-// packages/core/src/metadata.ts
-var metadataOffset = external_exports.number().int().min(0).max(1e5);
-var metadataLimit = external_exports.number().int().min(1).max(100);
-var metadataRequest = external_exports.strictObject({
-  kind: external_exports.enum(["objects", "columns", "constraints", "signatures", "applications", "pages"]),
-  schema: identifier,
-  name: identifier.optional(),
-  offset: metadataOffset.default(0),
-  limit: metadataLimit.default(30)
-});
-var metadataRequests = external_exports.array(metadataRequest).min(1).max(8);
-var metadataBatchRequest = external_exports.strictObject({ requests: metadataRequests });
-var metadataInputSchema = external_exports.strictObject({
-  kind: metadataRequest.shape.kind.optional(),
-  schema: metadataRequest.shape.schema.optional(),
-  name: metadataRequest.shape.name,
-  offset: metadataOffset.optional(),
-  limit: metadataLimit.optional(),
-  requests: metadataRequests.optional()
-});
-var queries = {
-  objects: "select object_name, object_type from all_objects where owner=:p_owner and object_type in ('TABLE','VIEW','PACKAGE') and (:p_name is null or object_name=:p_name) order by object_name, object_type",
-  columns: "select table_name,column_name,data_type,nullable,column_id from all_tab_columns where owner=:p_owner and table_name=:p_name order by column_id",
-  constraints: "select table_name,constraint_name,constraint_type,r_owner,r_constraint_name,status from all_constraints where owner=:p_owner and table_name=:p_name order by constraint_name",
-  signatures: "select package_name,object_name,argument_name,position,in_out,data_type,overload from all_arguments where owner=:p_owner and package_name=:p_name order by object_name,overload,sequence",
-  applications: "select application_id,application_name,alias from apex_applications where owner=:p_owner and application_id=:p_app_id order by application_id",
-  pages: "select application_id,page_id,page_name,page_alias from apex_application_pages where application_id=:p_app_id and workspace=:p_workspace order by page_id"
-};
-async function metadataRead(adapter, env2, connection, value) {
-  const input = parse(external_exports.union([metadataRequest, metadataBatchRequest]), value);
-  const batch = "requests" in input;
-  const requests = batch ? input.requests : [input];
-  for (const r of requests) {
-    if (r.schema !== env2.parsingSchema)
-      throw new Fault("SCHEMA_DENIED", "Metadata is restricted to the configured parsing schema.", 4);
-    if (["columns", "constraints", "signatures"].includes(r.kind) && !r.name)
-      throw new Fault("OBJECT_REQUIRED", "Select a specific object first.", 2);
-  }
-  await adapter.verifyTarget(env2, connection);
-  const read = async (r) => {
-    const rows = await adapter.jsonQuery(
-      queries[r.kind] + " offset :p_offset rows fetch next :p_limit rows only",
-      connection,
-      {
-        p_owner: r.schema,
-        p_name: r.name ?? "",
-        p_app_id: env2.applicationId,
-        p_workspace: env2.workspace,
-        p_offset: r.offset,
-        p_limit: r.limit
-      }
-    );
-    return {
-      dataClassification: "untrusted_database_content",
-      rows,
-      offset: r.offset,
-      nextOffset: rows.length === r.limit ? r.offset + r.limit : null
-    };
-  };
-  if (!batch) return read(input);
-  const results = [];
-  for (const [index, r] of requests.entries())
-    results.push({ index, kind: r.kind, ...r.name ? { name: r.name } : {}, ...await read(r) });
-  return { results, targetVerifiedOnce: true };
-}
-
 // packages/core/src/operations.ts
 var project = external_exports.string().min(1).max(4096).optional();
 var env = refName;
@@ -182,7 +125,12 @@ var schemas = {
     template: external_exports.enum(["blank-app", "customer-crm", "existing-app"]).default("blank-app"),
     alias: refName.optional()
   }),
-  "project.adopt": external_exports.strictObject({ ...base, env, appId: external_exports.number().int().positive() }),
+  "project.adopt": external_exports.strictObject({
+    ...base,
+    env,
+    appId: external_exports.number().int().positive(),
+    workingCopy: external_exports.boolean().default(false)
+  }),
   "project.inspect": external_exports.strictObject({ ...base, detail: external_exports.enum(["full", "summary"]).default("full") }),
   "connection.add": external_exports.strictObject({
     ...base,
@@ -202,16 +150,24 @@ var schemas = {
     saved: external_exports.boolean().default(false)
   }),
   "connection.remove": external_exports.strictObject({ ...base, name: refName }),
+  "compose.plan": composePlanInput,
+  "compose.materialize": composeMaterializeInput,
   "docs.search": external_exports.strictObject({
+    ...base,
     query: external_exports.string().min(1).max(256),
-    corpus: external_exports.enum(["apexlang", "components", "patterns"]).default("apexlang"),
+    corpus: external_exports.enum(["apexlang", "components", "patterns", "blocks", "blueprints"]).default("apexlang"),
     version: external_exports.string().optional(),
     kind: external_exports.enum(["grammar", "template", "contract", "guide"]).optional(),
     family: external_exports.string().min(1).max(200).optional(),
+    profile: external_exports.string().max(200).optional(),
+    status: external_exports.enum(["draft", "experimental", "verified", "deprecated", "revoked"]).optional(),
+    locale: external_exports.enum(["en", "uk"]).optional(),
+    cursor: external_exports.string().regex(/^[a-f0-9]{64}$/).optional(),
     offset: external_exports.number().int().min(0).max(1e4).default(0),
     limit: external_exports.number().int().min(1).max(8).default(3)
   }),
   "docs.read": external_exports.strictObject({
+    ...base,
     id: external_exports.string().max(200),
     offset: external_exports.number().int().min(0).default(0),
     limit: external_exports.number().int().min(1).max(8192).default(4096)
@@ -224,9 +180,10 @@ var schemas = {
     output: relativePath,
     alias: refName.optional()
   }),
+  "apex.sync": external_exports.strictObject({ ...base, env, action: external_exports.enum(["init", "status", "refresh", "invalidate"]) }),
   "apex.export": external_exports.strictObject({ ...base, env, output: relativePath }),
   "apex.validate": external_exports.strictObject({ ...base, env: env.optional() }),
-  "apex.diff": external_exports.strictObject({ ...base, env }),
+  "apex.diff": external_exports.strictObject({ ...base, env, comparison: external_exports.enum(["auto", "live"]).default("auto") }),
   "db.plan": external_exports.strictObject({ ...base, env }),
   "deploy.plan": external_exports.strictObject({ ...base, env, out: relativePath }),
   "deploy.apply": external_exports.strictObject({ ...base, plan: relativePath }),
@@ -258,6 +215,22 @@ var schemas = {
   "sandbox.down": external_exports.strictObject(base)
 };
 var toolCatalog = [
+  {
+    name: "apexrest_compose_plan",
+    operation: "compose.plan",
+    description: "Create an immutable Composer plan. Offline by default; connected requires an explicit environment. No import or database writes. Full plans are artifacts.",
+    readOnly: false,
+    destructive: false,
+    long: true
+  },
+  {
+    name: "apexrest_compose_materialize",
+    operation: "compose.materialize",
+    description: "Apply a reviewed Composer plan using its expected digest. Journaled local source writes only; never deploys. Recovery is explicit.",
+    readOnly: false,
+    destructive: false,
+    long: true
+  },
   {
     name: "apexrest_browser_open",
     operation: "browser.open",
@@ -321,6 +294,14 @@ var toolCatalog = [
     readOnly: false,
     long: true
   },
+  {
+    name: "apexrest_apex_sync",
+    operation: "apex.sync",
+    description: "Manage a single-editor working copy for an existing dev/test app: init, local status, explicit refresh or invalidate. Initial APEXlang and SQL exports only; blocked outcomes require reconciliation.",
+    readOnly: false,
+    destructive: false,
+    long: true
+  },
   {
     name: "apexrest_apex_export",
     operation: "apex.export",
@@ -828,6 +809,24 @@ function snippet(text, query, terms) {
   };
 }
 async function referenceSearch(query, version, options = {}) {
+  if (options.corpus === "blocks" || options.corpus === "blueprints") {
+    const found = await catalogSearch(query, { ...options, ...version ? { version } : {} });
+    return found.results.map((hit) => ({
+      ...hit,
+      source: "bundled-composer-catalog",
+      version: "version" in hit ? hit.version : "1",
+      kind: "template",
+      family: "composer",
+      text: hit.title,
+      offset: 0,
+      matchOffset: 0,
+      length: hit.title.length,
+      nextOffset: null,
+      requires: [],
+      totalMatches: found.totalMatches,
+      nextResultOffset: found.nextResultOffset
+    }));
+  }
   if (options.corpus === "components") return componentSearch(query, version, options);
   if (options.corpus === "patterns") return patternSearch(query, version, options);
   const terms = termsFor(query);
@@ -883,7 +882,8 @@ async function referenceSearch(query, version, options = {}) {
     };
   });
 }
-async function referenceRead(id, offset, limit) {
+async function referenceRead(id, offset, limit, project2) {
+  if (id.startsWith("block:") || id.startsWith("blueprint:")) return catalogRead(id, offset, limit, project2);
   if (id.startsWith("component:")) return componentRead(id, offset, limit);
   if (id.startsWith("pattern:")) return patternRead(id, offset, limit);
   const index = await referenceIndex();
@@ -987,7 +987,7 @@ async function dispatch(operation, input = {}, signal) {
     let data;
     switch (operation) {
       case "panel.open": {
-        const { openPanel } = await import("./chunk-IX6V6ZGW.mjs");
+        const { openPanel } = await import("./chunk-WXP75UUP.mjs");
         data = await openPanel(await realpath2(root));
         break;
       }
@@ -1024,29 +1024,29 @@ async function dispatch(operation, input = {}, signal) {
         );
         break;
       case "dependencies.install": {
-        const { ToolchainService } = await import("./chunk-QIVPMPU3.mjs");
+        const { ToolchainService } = await import("./chunk-YQHHPRJH.mjs");
         data = await new ToolchainService().apply(parsed);
         break;
       }
       case "dependencies.uninstall": {
-        const { uninstallTools } = await import("./chunk-HOKFFGSZ.mjs");
+        const { uninstallTools } = await import("./chunk-33GE2NWZ.mjs");
         data = await uninstallTools(parsed);
         break;
       }
       case "setup":
       case "plugin.install":
       case "plugin.update": {
-        const { setup: setup2 } = await import("./chunk-WK5GP4ES.mjs");
+        const { setup: setup2 } = await import("./chunk-KQ5IDT7Z.mjs");
         data = await setup2(parsed);
         break;
       }
       case "plugin.validate": {
-        const { validateNative } = await import("./chunk-WK5GP4ES.mjs");
+        const { validateNative } = await import("./chunk-KQ5IDT7Z.mjs");
         data = await validateNative(text("from"));
         break;
       }
       case "plugin.uninstall": {
-        const { uninstallNative } = await import("./chunk-WK5GP4ES.mjs");
+        const { uninstallNative } = await import("./chunk-KQ5IDT7Z.mjs");
         data = await uninstallNative(text("home") ?? managedHome(), Boolean(parsed.keepRuntime));
         break;
       }
@@ -1089,7 +1089,7 @@ async function dispatch(operation, input = {}, signal) {
         data = await referenceSearch(text("query"), text("version"), schemas["docs.search"].parse(parsed));
         break;
       case "docs.read":
-        data = await referenceRead(text("id"), Number(parsed.offset), Number(parsed.limit));
+        data = await referenceRead(text("id"), Number(parsed.offset), Number(parsed.limit), text("project"));
         break;
       case "docs.sync":
         data = await referenceSync(text("version"), Boolean(parsed.dryRun));
@@ -1102,6 +1102,12 @@ async function dispatch(operation, input = {}, signal) {
       default: {
         const ctx = await loadProject(root);
         switch (operation) {
+          case "compose.plan":
+            data = await composePlan(ctx, schemas["compose.plan"].parse(parsed), oracle, signal);
+            break;
+          case "compose.materialize":
+            data = await composeMaterialize(ctx, schemas["compose.materialize"].parse(parsed), signal);
+            break;
           case "project.inspect":
             data = await projectInspect(ctx, parsed.detail);
             break;
@@ -1123,6 +1129,14 @@ async function dispatch(operation, input = {}, signal) {
             };
             break;
           }
+          case "apex.sync":
+            data = await deployment.sync(
+              ctx,
+              text("env"),
+              parsed.action,
+              signal
+            );
+            break;
           case "project.adopt":
           case "apex.export": {
             await requireTrust(ctx.root);
@@ -1133,6 +1147,10 @@ async function dispatch(operation, input = {}, signal) {
                 "Requested app ID differs from the environment mapping.",
                 5
               );
+            if (operation === "project.adopt" && parsed.workingCopy) {
+              data = await deployment.sync(ctx, text("env"), "init", signal);
+              break;
+            }
             const connection = await resolveConnection(env2.readConnectionRef);
             await oracle.verifyTarget(env2, connection);
             const exported = await oracle.exportApplication(env2, connection);
@@ -1149,12 +1167,25 @@ async function dispatch(operation, input = {}, signal) {
             break;
           case "apex.diff": {
             await requireTrust(ctx.root);
-            const env2 = environment(ctx, text("env")), connection = await resolveConnection(env2.readConnectionRef);
-            await oracle.verifyTarget(env2, connection);
-            const exported = await oracle.exportApplication(env2, connection), local = (await projectInspect(ctx)).sources.apex;
+            const env2 = environment(ctx, text("env"));
+            const store = new SyncStore(ctx, env2, text("env"));
+            const state = parsed.comparison === "live" ? null : await store.read();
+            let exported, provenance;
+            if (state && state.status !== "invalidated" && parsed.comparison !== "live") {
+              await store.validate(state);
+              exported = checkpoint(state);
+              provenance = state.lastSuccessfulImport ? "last-successful-import" : "initial-baseline";
+            } else {
+              const connection = await resolveConnection(env2.readConnectionRef);
+              await oracle.verifyTarget(env2, connection);
+              exported = await oracle.exportApplication(env2, connection);
+              provenance = "live-export";
+            }
+            const local = (await projectInspect(ctx)).sources.apex;
             data = {
               scope: "full-application-import",
               completeness: "textual-file-hashes-only",
+              provenance,
               changes: [.../* @__PURE__ */ new Set([...Object.keys(exported.files), ...Object.keys(local ?? {})])].filter((f) => exported.files[f] !== local?.[f]).map((file) => ({
                 file,
                 before: exported.files[file] ?? null,
@@ -1231,7 +1262,7 @@ async function dispatch(operation, input = {}, signal) {
             data = await tests.auth(ctx, text("env"));
             break;
           case "browser.open": {
-            const { openVerificationBrowser } = await import("./chunk-NDZ2RWQU.mjs");
+            const { openVerificationBrowser } = await import("./chunk-ESDVN7DS.mjs");
             data = await openVerificationBrowser(
               ctx,
               text("env"),

package/dist/runtime/{chunk-WK5GP4ES.mjs → chunk-KQ5IDT7Z.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-S24BD6PY.mjs";
+} from "./chunk-G3KR57BY.mjs";
 import {
   Client,
   StdioClientTransport,
@@ -27,7 +27,7 @@ import {
   resourceRoot,
   runProcess,
   runtimeState
-} from "./chunk-3MDDJFXN.mjs";
+} from "./chunk-EBBEN4AV.mjs";
 import {
   Fault,
   __commonJS,