@gluecharm-lab/easyspecs-cli 0.0.13 → 0.0.14

package/dist/main.cjs

@@ -3000,7 +3000,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve15.call(this, root, ref);
+      let _sch = resolve17.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a = root.localRefs) === null || _a === void 0 ? void 0 : _a[ref];
         const { schemaId } = this.opts;
@@ -3027,7 +3027,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve15(root, ref) {
+    function resolve17(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -3242,8 +3242,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path45) {
-      let input = path45;
+    function removeDotSegments(path47) {
+      let input = path47;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3442,8 +3442,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path45, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path45 && path45 !== "/" ? path45 : void 0;
+        const [path47, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path47 && path47 !== "/" ? path47 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -3602,55 +3602,55 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve15(baseURI, relativeURI, options) {
+    function resolve17(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse(baseURI, schemelessOptions), parse(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative12, options, skipNormalization) {
+    function resolveComponent(base, relative13, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse(serialize(base, options), options);
-        relative12 = parse(serialize(relative12, options), options);
+        relative13 = parse(serialize(relative13, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative12.scheme) {
-        target.scheme = relative12.scheme;
-        target.userinfo = relative12.userinfo;
-        target.host = relative12.host;
-        target.port = relative12.port;
-        target.path = removeDotSegments(relative12.path || "");
-        target.query = relative12.query;
+      if (!options.tolerant && relative13.scheme) {
+        target.scheme = relative13.scheme;
+        target.userinfo = relative13.userinfo;
+        target.host = relative13.host;
+        target.port = relative13.port;
+        target.path = removeDotSegments(relative13.path || "");
+        target.query = relative13.query;
       } else {
-        if (relative12.userinfo !== void 0 || relative12.host !== void 0 || relative12.port !== void 0) {
-          target.userinfo = relative12.userinfo;
-          target.host = relative12.host;
-          target.port = relative12.port;
-          target.path = removeDotSegments(relative12.path || "");
-          target.query = relative12.query;
+        if (relative13.userinfo !== void 0 || relative13.host !== void 0 || relative13.port !== void 0) {
+          target.userinfo = relative13.userinfo;
+          target.host = relative13.host;
+          target.port = relative13.port;
+          target.path = removeDotSegments(relative13.path || "");
+          target.query = relative13.query;
         } else {
-          if (!relative12.path) {
+          if (!relative13.path) {
             target.path = base.path;
-            if (relative12.query !== void 0) {
-              target.query = relative12.query;
+            if (relative13.query !== void 0) {
+              target.query = relative13.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative12.path[0] === "/") {
-              target.path = removeDotSegments(relative12.path);
+            if (relative13.path[0] === "/") {
+              target.path = removeDotSegments(relative13.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative12.path;
+                target.path = "/" + relative13.path;
               } else if (!base.path) {
-                target.path = relative12.path;
+                target.path = relative13.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative12.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative13.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative12.query;
+            target.query = relative13.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -3658,7 +3658,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative12.fragment;
+      target.fragment = relative13.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -3829,7 +3829,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize6,
-      resolve: resolve15,
+      resolve: resolve17,
       resolveComponent,
       equal,
       serialize,
@@ -7629,12 +7629,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats2(ajv2, list, fs45, exportName) {
+    function addFormats2(ajv2, list, fs47, exportName) {
       var _a;
       var _b;
       (_a = (_b = ajv2.opts.code).formats) !== null && _a !== void 0 ? _a : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv2.addFormat(f, fs45[f]);
+        ajv2.addFormat(f, fs47[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -7643,8 +7643,8 @@ var require_dist = __commonJS({
 });
 
 // src/cli/main.ts
-var fs44 = __toESM(require("node:fs"));
-var path44 = __toESM(require("node:path"));
+var fs46 = __toESM(require("node:fs"));
+var path46 = __toESM(require("node:path"));
 
 // src/cli/argv.ts
 function isGlobalFlag(s) {
@@ -8597,6 +8597,22 @@ function ensureEasyspecsConfig(repoRoot, opts) {
   atomicWriteFile(configPath, body);
   return readEasyspecsConfig(repoRoot);
 }
+function syncDefaultGitRemoteUrlIfEmpty(repoRoot, cfg, opts) {
+  const current = (cfg.easyspecs?.defaultGitRemoteUrl ?? "").trim();
+  if (current.length > 0) {
+    return cfg;
+  }
+  const configPath = easyspecsConfigPath(repoRoot);
+  if (!fs6.existsSync(configPath)) {
+    return cfg;
+  }
+  const gitRoot = findGitRepoRoot(repoRoot) ?? repoRoot;
+  const url = runGit(gitRoot, ["remote", "get-url", "origin"])?.trim();
+  if (!url) {
+    return cfg;
+  }
+  return updateEasyspecsConfig(repoRoot, { easyspecs: { defaultGitRemoteUrl: url } }, opts);
+}
 function updateEasyspecsConfig(repoRoot, patch, opts) {
   const configPath = easyspecsConfigPath(repoRoot);
   const base = fs6.existsSync(configPath) ? readEasyspecsConfig(repoRoot) : buildFreshEasyspecsConfigFromLegacy(repoRoot, opts?.warnMigration);
@@ -8964,6 +8980,7 @@ function loadSrsDiscoveryIdMapFromContextDir(contextDir2, log) {
 }
 
 // src/analysis/contextSrsDiscoveryUpload.ts
+var UPLOAD_TARGET_FILENAME = "easyspecs-upload-target.json";
 var ADAPTIVE_B_INITIAL = 100;
 var ADAPTIVE_B_MIN = 1;
 var ADAPTIVE_B_MAX = 500;
@@ -9197,7 +9214,7 @@ function stringifyForSrs13Debug(value) {
     return truncateForSrs13DebugLog(String(value));
   }
 }
-function logSrs13HttpDebug(log, path45, method, requestBody, error) {
+function logSrs13HttpDebug(log, path47, method, requestBody, error) {
   if (!log) {
     return;
   }
@@ -9207,7 +9224,7 @@ function logSrs13HttpDebug(log, path45, method, requestBody, error) {
   } catch {
     bodyBytes = 0;
   }
-  log(`[upload] debug ${method} ${path45} \u2014 request body ~${bodyBytes} bytes (JSON below):`);
+  log(`[upload] debug ${method} ${path47} \u2014 request body ~${bodyBytes} bytes (JSON below):`);
   log(stringifyForSrs13Debug(requestBody));
   const raw = httpApiResponseBody(error);
   const status = error && typeof error === "object" && "status" in error ? Number(error.status) : void 0;
@@ -9311,18 +9328,18 @@ async function runParallelSinglesIntoAccum(requestJson, applicationId, paths, on
   const recentWaveMs = [];
   let idx = 0;
   const runOne = async (absPath) => {
-    const basename12 = path12.basename(absPath);
+    const basename13 = path12.basename(absPath);
     let content;
     try {
       content = fs11.readFileSync(absPath, "utf8");
     } catch (e) {
       const msg = errorMessage(e);
-      logSrs13Failure(log, `read file file=${basename12}`, msg);
+      logSrs13Failure(log, `read file file=${basename13}`, msg);
       accum.failed.push({ path: absPath, message: msg });
       return;
     }
     const existingId = resolveExistingId(absPath);
-    const payload = buildSrsDiscoverySavePayload(applicationId, basename12, content, existingId);
+    const payload = buildSrsDiscoverySavePayload(applicationId, basename13, content, existingId);
     try {
       await postSingleCreate(requestJson, payload, log);
       accum.succeeded.push(absPath);
@@ -9336,7 +9353,7 @@ async function runParallelSinglesIntoAccum(requestJson, applicationId, paths, on
         throw e;
       }
       const msg = errorMessage(e);
-      logSrs13Failure(log, `POST /api/content/srs_discovery file=${basename12}`, msg);
+      logSrs13Failure(log, `POST /api/content/srs_discovery file=${basename13}`, msg);
       accum.failed.push({ path: absPath, message: msg });
     }
   };
@@ -9418,18 +9435,18 @@ async function executeContextSrsDiscoveryUploadPhase(filePaths, phaseOpts, accum
     const items = [];
     const chunkPaths = [];
     for (const absPath of chunk) {
-      const basename12 = path12.basename(absPath);
+      const basename13 = path12.basename(absPath);
       let content;
       try {
         content = fs11.readFileSync(absPath, "utf8");
       } catch (e) {
         const msg = errorMessage(e);
-        logSrs13Failure(log, `read file file=${basename12}`, msg);
+        logSrs13Failure(log, `read file file=${basename13}`, msg);
         accum.failed.push({ path: absPath, message: msg });
         continue;
       }
       const existingId = resolveExistingId(absPath);
-      items.push(buildSrsDiscoverySavePayloadForBatch(applicationId, basename12, content, existingId));
+      items.push(buildSrsDiscoverySavePayloadForBatch(applicationId, basename13, content, existingId));
       chunkPaths.push(absPath);
     }
     if (items.length === 0) {
@@ -9836,9 +9853,9 @@ var ANALYSIS_STATIC_CONTEXT_OUTPUTS = [
   "tech-stack-list.json"
 ];
 function discoverDynamicAnalysisTestSteps(contextDir2) {
-  const staticOutputs = ANALYSIS_STATIC_CONTEXT_OUTPUTS.map((basename12) => ({
-    basename: basename12,
-    exists: nonEmptyContextFile(path14.join(contextDir2, basename12))
+  const staticOutputs = ANALYSIS_STATIC_CONTEXT_OUTPUTS.map((basename13) => ({
+    basename: basename13,
+    exists: nonEmptyContextFile(path14.join(contextDir2, basename13))
   }));
   const featuresPath = path14.join(contextDir2, "features-list.json");
   const featuresData = readJson(featuresPath);
@@ -10009,8 +10026,8 @@ function aceCurationPath(contextDir2, agentStem, runId) {
 function aceConsolidatedSessionsJsonlPath(contextDir2) {
   return path15.join(aceLearningsRoot(contextDir2), ACE_CONSOLIDATED_SESSIONS_JSONL);
 }
-function opencodeAceSchemaPath(worktreeRoot, basename12) {
-  return path15.join(worktreeRoot, ".opencode", "schemas", "ace", basename12);
+function opencodeAceSchemaPath(worktreeRoot, basename13) {
+  return path15.join(worktreeRoot, ".opencode", "schemas", "ace", basename13);
 }
 
 // src/analysis/aceJsonValidate.ts
@@ -10824,9 +10841,9 @@ function runOpenCodeAgent(cwd, args, options) {
   log?.(`[AgentCode] command: ${formatCliCommandForLog(cmd, args)}`);
   log?.(`[AgentCode] cwd: ${JSON.stringify(cwd)}`);
   log?.(`[AgentCode] argv: ${JSON.stringify(args)}`);
-  return new Promise((resolve15) => {
+  return new Promise((resolve17) => {
     if (sig?.aborted) {
-      resolve15({ ok: false, message: "Stopped by user.", cancelled: true });
+      resolve17({ ok: false, message: "Stopped by user.", cancelled: true });
       return;
     }
     const spawnEnv = options?.childEnv && Object.keys(options.childEnv).length > 0 ? { ...process.env, ...options.childEnv } : process.env;
@@ -10896,7 +10913,7 @@ ${truncateForDiag(outBody, DIAG_STDOUT_MAX)}`);
       if (diag) {
         finishDiag(diag.label, diag.code, diag.dumpStreams);
       }
-      resolve15(result);
+      resolve17(result);
     };
     let onAbort;
     const clearAbortHandler = () => {
@@ -12958,16 +12975,16 @@ function outputPaths(step, worktreeRoot, listTarget) {
       if (!fe) {
         throw new Error("listUseCases requires listTarget.featureCode");
       }
-      const basename12 = `${fe}-use-cases-list.json`;
-      return { absolute: path24.join(ctx, basename12), basename: basename12 };
+      const basename13 = `${fe}-use-cases-list.json`;
+      return { absolute: path24.join(ctx, basename13), basename: basename13 };
     }
     case "reviewUseCasesList": {
       const fe = listTarget?.featureCode;
       if (!fe) {
         throw new Error("reviewUseCasesList requires listTarget.featureCode");
       }
-      const basename12 = `${fe}-use-cases-list.json`;
-      return { absolute: path24.join(ctx, basename12), basename: basename12 };
+      const basename13 = `${fe}-use-cases-list.json`;
+      return { absolute: path24.join(ctx, basename13), basename: basename13 };
     }
     case "listScenarios": {
       const fe = listTarget?.featureCode;
@@ -12975,8 +12992,8 @@ function outputPaths(step, worktreeRoot, listTarget) {
       if (!fe || !uc) {
         throw new Error("listScenarios requires listTarget.featureCode and useCaseCode");
       }
-      const basename12 = `${fe}_${uc}-scenarios-list.json`;
-      return { absolute: path24.join(ctx, basename12), basename: basename12 };
+      const basename13 = `${fe}_${uc}-scenarios-list.json`;
+      return { absolute: path24.join(ctx, basename13), basename: basename13 };
     }
     case "reviewScenariosList": {
       const fe = listTarget?.featureCode;
@@ -12984,24 +13001,24 @@ function outputPaths(step, worktreeRoot, listTarget) {
       if (!fe || !uc) {
         throw new Error("reviewScenariosList requires listTarget.featureCode and useCaseCode");
       }
-      const basename12 = `${fe}_${uc}-scenarios-list.json`;
-      return { absolute: path24.join(ctx, basename12), basename: basename12 };
+      const basename13 = `${fe}_${uc}-scenarios-list.json`;
+      return { absolute: path24.join(ctx, basename13), basename: basename13 };
     }
     case "listEntityFields": {
       const dm = listTarget?.entityCode;
       if (!dm) {
         throw new Error("listEntityFields requires listTarget.entityCode");
       }
-      const basename12 = `${dm}-fields-list.json`;
-      return { absolute: path24.join(ctx, basename12), basename: basename12 };
+      const basename13 = `${dm}-fields-list.json`;
+      return { absolute: path24.join(ctx, basename13), basename: basename13 };
     }
     case "reviewEntityFieldsList": {
       const dm = listTarget?.entityCode;
       if (!dm) {
         throw new Error("reviewEntityFieldsList requires listTarget.entityCode");
       }
-      const basename12 = `${dm}-fields-list.json`;
-      return { absolute: path24.join(ctx, basename12), basename: basename12 };
+      const basename13 = `${dm}-fields-list.json`;
+      return { absolute: path24.join(ctx, basename13), basename: basename13 };
     }
     default: {
       const _u = step;
@@ -15136,91 +15153,91 @@ function mdItem(id, parentIds, t) {
   };
 }
 function featureDetailTarget(contextDir2, code, name, slug) {
-  const basename12 = `${code}-${slug}.md`;
+  const basename13 = `${code}-${slug}.md`;
   return {
     openCodeAgentStem: "agent-md-feature-detail",
     agentId: "ctx-md-feature-detail",
     displayName: "Feature detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Document feature **${code}** (**${name}**, slug **${slug}**) per \`.gluecharm/context/features-list.json\`: scope, behaviour, main dependencies, entry points, and links to code under the worktree. Write exactly one markdown file at the output path; cite substantive claims with file and line (or range).`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function viewDetailTarget(row2, contextDir2) {
-  const basename12 = `${row2.code}-${row2.slug}.md`;
+  const basename13 = `${row2.code}-${row2.slug}.md`;
   return {
     openCodeAgentStem: "agent-md-view-detail",
     agentId: "ctx-md-view-detail",
     displayName: "View detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Describe view **${row2.code}** (**${row2.name}**, slug **${row2.slug}**) per \`.gluecharm/context/experiences-list.json\`: purpose, layout, controls, navigation, data shown; ground in components and routes.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function interactionDetailTarget(viewCode, ix, contextDir2) {
-  const basename12 = `${viewCode}_${ix.code}-${ix.slug}.md`;
+  const basename13 = `${viewCode}_${ix.code}-${ix.slug}.md`;
   return {
     openCodeAgentStem: "agent-md-interaction-detail",
     agentId: "ctx-md-interaction-detail",
     displayName: "Interaction detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Document interaction **${ix.code}** (**${ix.name}**) on view **${viewCode}** per \`.gluecharm/context/experiences-list.json\`.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function serviceDetailTarget(row2, contextDir2) {
-  const basename12 = `${row2.code}-${row2.slug}.md`;
+  const basename13 = `${row2.code}-${row2.slug}.md`;
   return {
     openCodeAgentStem: "agent-md-service-detail",
     agentId: "ctx-md-service-detail",
     displayName: "Service detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Describe service **${row2.code}** (**${row2.name}**, slug **${row2.slug}**) per \`.gluecharm/context/services-list.json\`: responsibilities, consumers, errors, integration points.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function methodDetailTarget(svc, m, contextDir2) {
-  const basename12 = `${svc.code}_${m.code}-${m.slug}.md`;
+  const basename13 = `${svc.code}_${m.code}-${m.slug}.md`;
   return {
     openCodeAgentStem: "agent-md-method-detail",
     agentId: "ctx-md-method-detail",
     displayName: "Method detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Document method **${m.code}** (**${m.name}**) on service **${svc.code}** per \`.gluecharm/context/services-list.json\`.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function entityDetailTarget(dmCode, ename, slug, contextDir2) {
-  const basename12 = `${dmCode}-${slug}.md`;
+  const basename13 = `${dmCode}-${slug}.md`;
   return {
     openCodeAgentStem: "agent-md-entity-detail",
     agentId: "ctx-md-entity-detail",
     displayName: "Entity detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Describe entity **${dmCode}** (**${ename}**, slug **${slug}**) per \`.gluecharm/context/data-model-list.json\`: lifecycle, invariants, storage, ORM/schema mapping.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function fieldDetailTarget(dmCode, fdCode, fname, fSlug, contextDir2) {
-  const basename12 = `${dmCode}_${fdCode}-${fSlug}.md`;
+  const basename13 = `${dmCode}_${fdCode}-${fSlug}.md`;
   return {
     openCodeAgentStem: "agent-md-field-detail",
     agentId: "ctx-md-field-detail",
     displayName: "Field detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Document field **${fdCode}** (**${fname}**) on entity **${dmCode}** per \`.gluecharm/context/${dmCode}-fields-list.json\`. Cite types and constraints with file and line.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function toolDetailTarget(row2, contextDir2) {
-  const basename12 = `${row2.code}-${row2.slug}.md`;
+  const basename13 = `${row2.code}-${row2.slug}.md`;
   return {
     openCodeAgentStem: "agent-md-tool-detail",
     agentId: "ctx-md-tool-detail",
     displayName: "Tool detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Describe tool **${row2.code}** (**${row2.name}**, slug **${row2.slug}**) per \`.gluecharm/context/tech-stack-list.json\`: role, version hints, configuration, boundaries.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function useCaseDetailTarget(feCode, ucCode, ucName, ucSlug, contextDir2) {
@@ -15237,14 +15254,14 @@ Follow bundled agent **agent-md-use-case-detail**: include **## Data inputs and
   };
 }
 function scenarioDetailTarget(feCode, ucCode, scCode, scName, contextDir2) {
-  const basename12 = `${feCode}_${ucCode}_${scCode}.md`;
+  const basename13 = `${feCode}_${ucCode}_${scCode}.md`;
   return {
     openCodeAgentStem: "agent-md-scenario-detail",
     agentId: "ctx-md-scenario-detail",
     displayName: "Scenario detail",
-    outputBasename: basename12,
+    outputBasename: basename13,
     taskDescription: `Document scenario **${scCode}** (**${scName}**) for **${feCode}** / **${ucCode}** per \`.gluecharm/context/${feCode}_${ucCode}-scenarios-list.json\`. Cite steps with file and line where possible.`,
-    exists: fs31.existsSync(path29.join(contextDir2, basename12)) && fs31.statSync(path29.join(contextDir2, basename12)).size > 0
+    exists: fs31.existsSync(path29.join(contextDir2, basename13)) && fs31.statSync(path29.join(contextDir2, basename13)).size > 0
   };
 }
 function parentsDone(item, byId) {
@@ -15470,15 +15487,15 @@ function expandAfterSuccess(completed, contextDir2, byId, fifo) {
     return;
   }
   if (completed.kind === "markdown") {
-    const basename12 = completed.payload.outputBasename;
+    const basename13 = completed.payload.outputBasename;
     const mdId = completed.id;
-    const feFromFeatureMd = basename12.match(/^(FE-\d+)-[^/]+\.md$/);
+    const feFromFeatureMd = basename13.match(/^(FE-\d+)-[^/]+\.md$/);
     if (feFromFeatureMd) {
       const fe = feFromFeatureMd[1];
       add(coordItem(`coord:uc:${fe}`, [mdId], "listUseCases", { featureCode: fe }));
       return;
     }
-    const xpFromView = basename12.match(/^(XP-\d+)-[^/]+\.md$/);
+    const xpFromView = basename13.match(/^(XP-\d+)-[^/]+\.md$/);
     if (xpFromView) {
       const xp = xpFromView[1];
       const row2 = discoverExperienceTreeRows(contextDir2).find((r) => r.code === xp);
@@ -15490,7 +15507,7 @@ function expandAfterSuccess(completed, contextDir2, byId, fifo) {
       }
       return;
     }
-    const svFromSvc = basename12.match(/^(SV-\d+)-[^/]+\.md$/);
+    const svFromSvc = basename13.match(/^(SV-\d+)-[^/]+\.md$/);
     if (svFromSvc) {
       const sv = svFromSvc[1];
       const srow = discoverServiceTreeRows(contextDir2).find((r) => r.code === sv);
@@ -15502,7 +15519,7 @@ function expandAfterSuccess(completed, contextDir2, byId, fifo) {
       }
       return;
     }
-    const dmFromEnt = basename12.match(/^(DM-\d+)-[^/]+\.md$/);
+    const dmFromEnt = basename13.match(/^(DM-\d+)-[^/]+\.md$/);
     if (dmFromEnt) {
       const dm = dmFromEnt[1];
       add(coordItem(`coord:ef:${dm}`, [mdId], "listEntityFields", { entityCode: dm }));
@@ -15668,8 +15685,8 @@ async function drainArtefactWorkPool(p) {
   const artefactRunId = readArtefactRunSnapshot(storageContext)?.runId ?? "unknown-run";
   let active = 0;
   let wake;
-  const waitTurn = () => new Promise((resolve15) => {
-    wake = resolve15;
+  const waitTurn = () => new Promise((resolve17) => {
+    wake = resolve17;
   });
   const persist = async () => {
     const items = {};
@@ -15997,7 +16014,7 @@ function macroSleep(ms, signal) {
   if (signal.aborted) {
     return Promise.reject(new DOMException("The operation was aborted.", "AbortError"));
   }
-  return new Promise((resolve15, reject) => {
+  return new Promise((resolve17, reject) => {
     const onAbort = () => {
       clearTimeout(t);
       signal.removeEventListener("abort", onAbort);
@@ -16005,7 +16022,7 @@ function macroSleep(ms, signal) {
     };
     const t = setTimeout(() => {
       signal.removeEventListener("abort", onAbort);
-      resolve15();
+      resolve17();
     }, ms);
     signal.addEventListener("abort", onAbort, { once: true });
   });
@@ -16373,8 +16390,8 @@ async function runMacroAnalysisOrchestration(deps) {
 }
 
 // src/analysis/macroHeadlessHost.ts
-var fs40 = __toESM(require("node:fs"));
-var path39 = __toESM(require("node:path"));
+var fs41 = __toESM(require("node:fs"));
+var path40 = __toESM(require("node:path"));
 
 // src/stores/analysisPipelineStore.ts
 var STORAGE_KEY2 = "easyspecs.analysis.pipelineRun.v1";
@@ -16540,8 +16557,8 @@ function expectedFeatureDetailBasenameFromRow(row2) {
   }
   return `${code}-${slug}.md`;
 }
-function ctxPath(contextDir2, basename12) {
-  return path31.join(contextDir2, basename12);
+function ctxPath(contextDir2, basename13) {
+  return path31.join(contextDir2, basename13);
 }
 function pushTarget(targets, stem, outputBasename, taskDescription, contextDir2) {
   const meta = STEM_TO_AGENT[stem];
@@ -16570,11 +16587,11 @@ function discoverDetailMarkdownGroups(contextDir2) {
       continue;
     }
     const name = safeStr3(row2.name) || code;
-    const basename12 = `${code}-${slug}.md`;
+    const basename13 = `${code}-${slug}.md`;
     pushTarget(
       featureTargets,
       "agent-md-feature-detail",
-      basename12,
+      basename13,
       `Document feature **${code}** (**${name}**, slug **${slug}**) per \`.gluecharm/context/features-list.json\`: scope, behaviour, main dependencies, entry points, and links to code under the worktree. Write exactly one markdown file at the output path; cite substantive claims with file and line (or range).`,
       contextDir2
     );
@@ -17762,8 +17779,8 @@ function formatAjvErrors6(errors) {
   });
 }
 var ajv = new import__6.default({ allErrors: true, strict: false });
-function compileSchema(basename12) {
-  const schemaPath = path36.join(schemasDir(), basename12);
+function compileSchema(basename13) {
+  const schemaPath = path36.join(schemasDir(), basename13);
   const schemaRaw = stripUtf8Bom5(fs37.readFileSync(schemaPath, "utf-8"));
   const schema = JSON.parse(schemaRaw);
   return ajv.compile(schema);
@@ -19024,6 +19041,31 @@ async function runReferenceCoverageExecutionReport(p) {
   return { ok: true, outputAbsolutePath: outAbs };
 }
 
+// src/gluecharm/minimalGluecharmLayout.ts
+var fs40 = __toESM(require("node:fs"));
+var path39 = __toESM(require("node:path"));
+var MINIMAL_GLUECHARM_RELATIVE_DIRS = [
+  [".gluecharm", "docs", "srs"],
+  [".gluecharm", "content"],
+  [".gluecharm", "logs"],
+  [".gluecharm", "context"]
+];
+function ensureMinimalGluecharmLayoutNode(repoRootAbs) {
+  const root = path39.resolve(repoRootAbs);
+  for (const segments of MINIMAL_GLUECHARM_RELATIVE_DIRS) {
+    const dir = path39.join(root, ...segments);
+    try {
+      fs40.mkdirSync(dir, { recursive: true });
+    } catch (e) {
+      const err = e;
+      const msg = e instanceof Error ? e.message : String(e);
+      const code = err.code ? ` (${err.code})` : "";
+      return { ok: false, error: `Could not create directory ${dir}${code}: ${msg}` };
+    }
+  }
+  return { ok: true };
+}
+
 // src/analysis/macroHeadlessHost.ts
 function buildMacroOrchestrationDepsHeadless(input) {
   const { storageContext, repoRoot, agentsDirFs, buildOpenCodeOptions, log, signal, macroConfig } = input;
@@ -19042,13 +19084,13 @@ function buildMacroOrchestrationDepsHeadless(input) {
     },
     runPrepareAnalysisWorktree: async (resume) => {
       if (resume) {
-        if (adHocWorktree && fs40.existsSync(path39.join(adHocWorktree.path, ".git"))) {
+        if (adHocWorktree && fs41.existsSync(path40.join(adHocWorktree.path, ".git"))) {
           return { ok: true };
         }
         const snap = readAnalysisWorkspaceSnapshot(storageContext);
         const wtPath = snap?.adHocWorktreePath?.trim();
         const repo = snap?.adHocRepositoryRoot?.trim() || repoRoot;
-        if (wtPath && fs40.existsSync(path39.join(wtPath, ".git"))) {
+        if (wtPath && fs41.existsSync(path40.join(wtPath, ".git"))) {
           adHocWorktree = attachWorktreeHandle(wtPath, repo);
           macroSourceBranch = snap?.adHocSourceBranchAtCreation;
           macroFinalize = () => {
@@ -19113,10 +19155,11 @@ function buildMacroOrchestrationDepsHeadless(input) {
         return { ok: false, error: "No analysis checkout." };
       }
       if (resume) {
-        const ctxDir = path39.join(ar, ".gluecharm", "context");
-        if (!fs40.existsSync(ctxDir)) {
-          return { ok: false, error: "Missing .gluecharm/context in the analysis worktree." };
+        const layout = ensureMinimalGluecharmLayoutNode(ar);
+        if (!layout.ok) {
+          return { ok: false, error: layout.error };
         }
+        const ctxDir = path40.join(ar, ".gluecharm", "context");
         const snap = readArtefactRunSnapshot(storageContext);
         const rows = listMissingArtefacts(ctxDir, ar, snap);
         if (rows.length === 0) {
@@ -19130,7 +19173,7 @@ function buildMacroOrchestrationDepsHeadless(input) {
           storageContext,
           repositoryRoot: repoRoot,
           worktreeRoot: ar,
-          workspaceLabel: path39.basename(ar),
+          workspaceLabel: path40.basename(ar),
           oc: {
             ...oc,
             aceEnabled: getAceAnalysisEnabledForCheckout(ar),
@@ -19158,7 +19201,7 @@ function buildMacroOrchestrationDepsHeadless(input) {
       }
       try {
         await startPipelineRun(storageContext, repoRoot);
-        const folderName = path39.basename(repoRoot);
+        const folderName = path40.basename(repoRoot);
         const oc = buildOpenCodeOptions(handle.path);
         const result = await runContextArtefactPipelineDrainFromPreparedWorktree(
           storageContext,
@@ -19215,7 +19258,7 @@ function buildMacroOrchestrationDepsHeadless(input) {
       if (!ar) {
         return 0;
       }
-      const ctxDir = path39.join(ar, ".gluecharm", "context");
+      const ctxDir = path40.join(ar, ".gluecharm", "context");
       const snap = readArtefactRunSnapshot(storageContext);
       return listMissingArtefacts(ctxDir, ar, snap).length;
     },
@@ -19224,10 +19267,11 @@ function buildMacroOrchestrationDepsHeadless(input) {
       if (!ar) {
         return { ok: false, message: "No analysis worktree." };
       }
-      const contextDir2 = path39.join(ar, ".gluecharm", "context");
-      if (!fs40.existsSync(contextDir2)) {
-        return { ok: false, message: "Missing .gluecharm/context." };
+      const layout = ensureMinimalGluecharmLayoutNode(ar);
+      if (!layout.ok) {
+        return { ok: false, message: layout.error };
       }
+      const contextDir2 = path40.join(ar, ".gluecharm", "context");
       log(`[setup] macro \u2014 reference coverage (worktree) \u2014 ${ar}`);
       const res = runCoverageReferenceValidation({
         repositoryRootAbs: ar,
@@ -19276,6 +19320,10 @@ function buildMacroOrchestrationDepsHeadless(input) {
       if (!ar) {
         return { ok: false, message: "No analysis worktree." };
       }
+      const execLayout = ensureMinimalGluecharmLayoutNode(ar);
+      if (!execLayout.ok) {
+        return { ok: false, message: execLayout.error };
+      }
       log(`[setup] macro \u2014 reference coverage execution report \u2014 ${(/* @__PURE__ */ new Date()).toISOString()}`);
       const res = await runReferenceCoverageExecutionReport({
         repositoryRootAbs: ar,
@@ -19283,7 +19331,7 @@ function buildMacroOrchestrationDepsHeadless(input) {
         diagnosticLog: log
       });
       if (res.ok) {
-        return { ok: true, message: `Report: ${path39.basename(res.outputAbsolutePath)}` };
+        return { ok: true, message: `Report: ${path40.basename(res.outputAbsolutePath)}` };
       }
       if (res.cancelled) {
         return { ok: false, cancelled: true, message: "Report generation stopped." };
@@ -19295,10 +19343,11 @@ function buildMacroOrchestrationDepsHeadless(input) {
       if (!snap?.adHocWorktreePath) {
         return { ok: false, message: "No analysis worktree for index assembly." };
       }
-      const contextDir2 = path39.join(snap.adHocWorktreePath, ".gluecharm", "context");
-      if (!fs40.existsSync(contextDir2)) {
-        return { ok: false, message: "Missing .gluecharm/context." };
+      const idxLayout = ensureMinimalGluecharmLayoutNode(snap.adHocWorktreePath);
+      if (!idxLayout.ok) {
+        return { ok: false, message: idxLayout.error };
       }
+      const contextDir2 = path40.join(snap.adHocWorktreePath, ".gluecharm", "context");
       try {
         writeIndexApplicationContext(contextDir2, void 0, {
           sourceBranchAtWorktreeCreation: snap.adHocSourceBranchAtCreation
@@ -19317,10 +19366,14 @@ function buildMacroOrchestrationDepsHeadless(input) {
         return input.runBackendSyncImpl();
       }
       const snap = readAnalysisWorkspaceSnapshot(storageContext);
-      const wtContextDir = snap?.adHocWorktreePath && fs40.existsSync(path39.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path39.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
-      if (!wtContextDir) {
+      if (!snap?.adHocWorktreePath) {
         return { ok: false, message: "No worktree context to upload." };
       }
+      const syncLayout = ensureMinimalGluecharmLayoutNode(snap.adHocWorktreePath);
+      if (!syncLayout.ok) {
+        return { ok: false, message: syncLayout.error };
+      }
+      const wtContextDir = path40.join(snap.adHocWorktreePath, ".gluecharm", "context");
       let applicationId;
       try {
         applicationId = getEasyspecsProjectIdFromRepoConfig(readEasyspecsConfig(repoRoot))?.trim();
@@ -19336,8 +19389,8 @@ function buildMacroOrchestrationDepsHeadless(input) {
 }
 
 // src/analysis/coordinationDuplicatesDiagnosis.ts
-var fs41 = __toESM(require("fs"));
-var path40 = __toESM(require("path"));
+var fs42 = __toESM(require("fs"));
+var path41 = __toESM(require("path"));
 var import__7 = __toESM(require__());
 var COORDINATION_DUPLICATES_REPORT_BASENAME = "coordination-duplicates-report.json";
 var COORDINATION_LIST_SCAN_ENTRIES = [
@@ -19362,30 +19415,30 @@ var RE_MD_SV = /^SV-\d+-.+\.md$/i;
 var RE_MD_DM_FD = /^DM-\d+_FD-\d+-.+\.md$/i;
 var RE_MD_DM = /^DM-\d+-.+\.md$/i;
 var RE_MD_TS = /^TS-\d+-.+\.md$/i;
-function looksLikeCoordinationDetailMarkdownBasename(basename12) {
-  if (!basename12 || basename12 !== path40.basename(basename12) || !/\.md$/i.test(basename12)) {
+function looksLikeCoordinationDetailMarkdownBasename(basename13) {
+  if (!basename13 || basename13 !== path41.basename(basename13) || !/\.md$/i.test(basename13)) {
     return false;
   }
-  if (STAPLE_CONTEXT_MARKDOWN_BASENAMES.has(basename12)) {
+  if (STAPLE_CONTEXT_MARKDOWN_BASENAMES.has(basename13)) {
     return false;
   }
-  return RE_MD_FE_UC_SC.test(basename12) || RE_MD_FE_UC_SLUG.test(basename12) || RE_MD_FE_UC_PLAIN.test(basename12) || RE_MD_FE_FEATURE.test(basename12) || RE_MD_XP_BH.test(basename12) || RE_MD_XP_VIEW.test(basename12) || RE_MD_SV_ME.test(basename12) || RE_MD_SV.test(basename12) || RE_MD_DM_FD.test(basename12) || RE_MD_DM.test(basename12) || RE_MD_TS.test(basename12);
+  return RE_MD_FE_UC_SC.test(basename13) || RE_MD_FE_UC_SLUG.test(basename13) || RE_MD_FE_UC_PLAIN.test(basename13) || RE_MD_FE_FEATURE.test(basename13) || RE_MD_XP_BH.test(basename13) || RE_MD_XP_VIEW.test(basename13) || RE_MD_SV_ME.test(basename13) || RE_MD_SV.test(basename13) || RE_MD_DM_FD.test(basename13) || RE_MD_DM.test(basename13) || RE_MD_TS.test(basename13);
 }
 function loadRawFeatureRows(contextDirAbs) {
-  const p = path40.join(contextDirAbs, "features-list.json");
-  if (!fs41.existsSync(p)) {
+  const p = path41.join(contextDirAbs, "features-list.json");
+  if (!fs42.existsSync(p)) {
     return [];
   }
   try {
-    const raw = stripUtf8Bom6(fs41.readFileSync(p, "utf-8"));
+    const raw = stripUtf8Bom6(fs42.readFileSync(p, "utf-8"));
     const doc = JSON.parse(raw);
     return Array.isArray(doc.features) ? doc.features : [];
   } catch {
     return [];
   }
 }
-function hintForOrphanFeatureMarkdown(basename12, featureRows) {
-  const m = /^FE-(\d+)-(.+)\.md$/i.exec(basename12);
+function hintForOrphanFeatureMarkdown(basename13, featureRows) {
+  const m = /^FE-(\d+)-(.+)\.md$/i.exec(basename13);
   if (!m) {
     return void 0;
   }
@@ -19397,8 +19450,8 @@ function hintForOrphanFeatureMarkdown(basename12, featureRows) {
       continue;
     }
     const expected = expectedFeatureDetailBasenameFromRow(row2);
-    if (expected && expected !== basename12) {
-      return `features-list row ${code} currently implies detail file ${expected} (slug/name changed \u2014 ${basename12} may be stale).`;
+    if (expected && expected !== basename13) {
+      return `features-list row ${code} currently implies detail file ${expected} (slug/name changed \u2014 ${basename13} may be stale).`;
     }
     if (!expected) {
       return `features-list row ${code} has no resolvable slug for a detail markdown basename.`;
@@ -19412,7 +19465,7 @@ function findOrphanCoordinationMarkdown(contextDirAbs) {
   const featureRows = loadRawFeatureRows(contextDirAbs);
   let dirents;
   try {
-    dirents = fs41.readdirSync(contextDirAbs, { withFileTypes: true });
+    dirents = fs42.readdirSync(contextDirAbs, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -19665,14 +19718,14 @@ function buildCoordinationDuplicatesReport(input) {
   const lists = [];
   const duplicateGroups = [];
   for (const entry of COORDINATION_LIST_SCAN_ENTRIES) {
-    const filePath = path40.join(input.contextDirAbsolute, entry.basename);
-    if (!fs41.existsSync(filePath)) {
+    const filePath = path41.join(input.contextDirAbsolute, entry.basename);
+    if (!fs42.existsSync(filePath)) {
       lists.push({ basename: entry.basename, status: "missing" });
       continue;
     }
     let raw;
     try {
-      raw = stripUtf8Bom6(fs41.readFileSync(filePath, "utf-8"));
+      raw = stripUtf8Bom6(fs42.readFileSync(filePath, "utf-8"));
     } catch (e) {
       lists.push({
         basename: entry.basename,
@@ -19720,8 +19773,8 @@ var validateReportCompiled;
 function validateReportData(data) {
   if (!validateReportCompiled) {
     const ajv2 = new import__7.default({ allErrors: true, strict: false });
-    const schemaPath = path40.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
-    const schemaRaw = stripUtf8Bom6(fs41.readFileSync(schemaPath, "utf-8"));
+    const schemaPath = path41.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
+    const schemaRaw = stripUtf8Bom6(fs42.readFileSync(schemaPath, "utf-8"));
     validateReportCompiled = ajv2.compile(JSON.parse(schemaRaw));
   }
   if (validateReportCompiled(data)) {
@@ -19739,20 +19792,20 @@ function runCoordinationDuplicatesDiagnosis(input) {
   if (!v.ok) {
     return { ok: false, message: `Report validation failed: ${v.errors.join("; ")}` };
   }
-  const outPath = path40.join(input.contextDirAbsolute, COORDINATION_DUPLICATES_REPORT_BASENAME);
+  const outPath = path41.join(input.contextDirAbsolute, COORDINATION_DUPLICATES_REPORT_BASENAME);
   const payload = `${JSON.stringify(report, null, 2)}
 `;
   const tmp = `${outPath}.tmp.${process.pid}`;
   try {
-    fs41.writeFileSync(tmp, payload, "utf-8");
+    fs42.writeFileSync(tmp, payload, "utf-8");
   } catch (e) {
     return { ok: false, message: e instanceof Error ? e.message : String(e) };
   }
   try {
-    fs41.renameSync(tmp, outPath);
+    fs42.renameSync(tmp, outPath);
   } catch (e) {
     try {
-      fs41.unlinkSync(tmp);
+      fs42.unlinkSync(tmp);
     } catch {
     }
     return { ok: false, message: e instanceof Error ? e.message : String(e) };
@@ -19785,6 +19838,247 @@ function runCoordinationDuplicatesDiagnosis(input) {
   };
 }
 
+// src/analysis/contextSrsDiscoveryDownload.ts
+var fs43 = __toESM(require("node:fs"));
+var path42 = __toESM(require("node:path"));
+var SRS_DISCOVERY_BATCH_GET_CHUNK_SIZE = 200;
+function isRecord6(v) {
+  return Boolean(v) && typeof v === "object" && !Array.isArray(v);
+}
+function extractSrsDiscoveryIdsFromApplicationProperties(properties) {
+  const raw = properties.srs_discovery;
+  if (!Array.isArray(raw)) {
+    return [];
+  }
+  const out = [];
+  for (const item of raw) {
+    if (typeof item === "string") {
+      const t = item.trim();
+      if (t.length > 0) {
+        out.push(t);
+      }
+    } else if (isRecord6(item)) {
+      const id = typeof item.id === "string" ? item.id.trim() : "";
+      if (id.length > 0) {
+        out.push(id);
+      }
+    }
+  }
+  return [...new Set(out)];
+}
+async function fetchApplicationPropertiesForDownload(requestJson, applicationId) {
+  const p = `/api/content/application/${encodeURIComponent(applicationId)}`;
+  const body = await requestJson(p, { method: "GET", timeoutMs: 6e4 });
+  const full = parseApplicationPropertiesFromContentGet(body);
+  if (!full || full.id !== applicationId) {
+    throw new Error("Application not found or unexpected response shape.");
+  }
+  return full.properties;
+}
+function parseBatchGetSrsDiscoveryEntities(res) {
+  assertBasicResponseSuccess(res);
+  const root = isRecord6(res) ? res.data : void 0;
+  if (root === void 0 || root === null) {
+    throw new Error("Batch get response missing data.");
+  }
+  if (isRecord6(root) && Array.isArray(root.entities)) {
+    return root.entities.filter(isRecord6);
+  }
+  if (Array.isArray(root)) {
+    return root.filter(isRecord6);
+  }
+  if (isRecord6(root) && Array.isArray(root.nodes)) {
+    return root.nodes.filter(isRecord6);
+  }
+  throw new Error("Unexpected batch get response shape (expected data.entities).");
+}
+function entityBag(record) {
+  const nested = record.properties;
+  if (isRecord6(nested)) {
+    return nested;
+  }
+  return record;
+}
+function extractSrsDiscoveryEntityId(record) {
+  const direct = typeof record.id === "string" ? record.id.trim() : "";
+  if (direct.length > 0) {
+    return direct;
+  }
+  const bag = entityBag(record);
+  const id = typeof bag.id === "string" ? bag.id.trim() : "";
+  return id.length > 0 ? id : void 0;
+}
+function extractSrsDiscoveryEntityName(record) {
+  const bag = entityBag(record);
+  const n = bag.name;
+  return typeof n === "string" ? n.trim() : "";
+}
+function extractSrsDiscoveryEntityBody(record) {
+  const bag = entityBag(record);
+  const ld = bag.long_description;
+  return typeof ld === "string" ? ld : "";
+}
+function resolveSafeContextOutputPath(contextDirAbs, nameRaw) {
+  const norm = nameRaw.replace(/\\/g, "/").trim();
+  if (!norm || norm.includes("\0")) {
+    return null;
+  }
+  const trimmed = norm.replace(/^\/+/, "");
+  const segments = trimmed.split("/");
+  for (const seg of segments) {
+    if (seg.length === 0 || seg === "." || seg === "..") {
+      return null;
+    }
+  }
+  const resolved = path42.resolve(contextDirAbs, ...segments);
+  const rel = path42.relative(contextDirAbs, resolved);
+  if (rel.startsWith("..") || path42.isAbsolute(rel)) {
+    return null;
+  }
+  return resolved;
+}
+function chunkIds(ids, size) {
+  const out = [];
+  for (let i = 0; i < ids.length; i += size) {
+    out.push(ids.slice(i, i + size));
+  }
+  return out;
+}
+function clearContextDirectoryForCloudReplace(contextDirAbs) {
+  if (!fs43.existsSync(contextDirAbs) || !fs43.statSync(contextDirAbs).isDirectory()) {
+    return { filesRemoved: 0 };
+  }
+  const preserveAbs = path42.resolve(contextDirAbs, UPLOAD_TARGET_FILENAME);
+  const preserveSet = /* @__PURE__ */ new Set();
+  if (fs43.existsSync(preserveAbs) && fs43.statSync(preserveAbs).isFile()) {
+    preserveSet.add(preserveAbs);
+  }
+  let filesRemoved = 0;
+  const walkRm = (dir) => {
+    let entries;
+    try {
+      entries = fs43.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e of entries) {
+      const full = path42.join(dir, e.name);
+      if (e.isDirectory()) {
+        walkRm(full);
+        try {
+          fs43.rmdirSync(full);
+        } catch {
+        }
+      } else if (e.isFile()) {
+        const abs = path42.resolve(full);
+        if (preserveSet.has(abs)) {
+          continue;
+        }
+        try {
+          fs43.unlinkSync(abs);
+          filesRemoved += 1;
+        } catch {
+        }
+      }
+    }
+  };
+  walkRm(contextDirAbs);
+  return { filesRemoved };
+}
+var BATCH_GET_PATH = "/api/batch/content/srs_discovery/get";
+async function runContextSrsDiscoveryDownload(opts) {
+  const chunkSize = opts.batchChunkSize ?? SRS_DISCOVERY_BATCH_GET_CHUNK_SIZE;
+  const timeoutMs = opts.timeoutMs ?? SRS_DISCOVERY_BATCH_SAVE_TIMEOUT_MS;
+  const log = opts.log;
+  const props = await fetchApplicationPropertiesForDownload(opts.requestJson, opts.applicationId);
+  const ids = extractSrsDiscoveryIdsFromApplicationProperties(props);
+  let localFilesRemoved = 0;
+  if (opts.replaceFromCloud) {
+    const clr = clearContextDirectoryForCloudReplace(opts.contextDirAbs);
+    localFilesRemoved = clr.filesRemoved;
+    log?.(`[download] removed ${String(localFilesRemoved)} local file(s) before cloud fetch (--replace-from-cloud).`);
+  }
+  if (ids.length === 0) {
+    return {
+      downloaded: 0,
+      skipped: 0,
+      failed: [],
+      localFilesRemoved,
+      succeededIds: {}
+    };
+  }
+  const entityById = /* @__PURE__ */ new Map();
+  const batches = chunkIds(ids, chunkSize);
+  for (const chunk of batches) {
+    const body = {
+      ids: chunk,
+      content_schema_prefix: SRS_DISCOVERY_CONTENT_SCHEMA_PREFIX
+    };
+    const req = {
+      method: "POST",
+      body,
+      timeoutMs
+    };
+    const res = await opts.requestJson(BATCH_GET_PATH, req);
+    const entities = parseBatchGetSrsDiscoveryEntities(res);
+    for (const ent of entities) {
+      const rowId = extractSrsDiscoveryEntityId(ent);
+      if (rowId) {
+        entityById.set(rowId, ent);
+      }
+    }
+  }
+  const failed = [];
+  let downloaded = 0;
+  let skipped = 0;
+  const succeededIds = {};
+  for (const id of ids) {
+    const ent = entityById.get(id);
+    if (!ent) {
+      failed.push({ id, message: "Not returned by batch get." });
+      continue;
+    }
+    const name = extractSrsDiscoveryEntityName(ent);
+    if (!name) {
+      failed.push({ id, message: "Missing name on srs_discovery node." });
+      continue;
+    }
+    if (name === UPLOAD_TARGET_FILENAME || path42.basename(name) === UPLOAD_TARGET_FILENAME) {
+      skipped += 1;
+      log?.(`[download] skip ${name} (upload target row).`);
+      continue;
+    }
+    const bodyText = extractSrsDiscoveryEntityBody(ent);
+    const outAbs = resolveSafeContextOutputPath(opts.contextDirAbs, name);
+    if (!outAbs) {
+      failed.push({ id, name, message: "Unsafe or invalid name for local path." });
+      continue;
+    }
+    fs43.mkdirSync(path42.dirname(outAbs), { recursive: true });
+    const exists = fs43.existsSync(outAbs);
+    if (exists && !opts.force && !opts.replaceFromCloud) {
+      skipped += 1;
+      log?.(`[download] skip existing ${name} (use --force to overwrite).`);
+      continue;
+    }
+    try {
+      fs43.writeFileSync(outAbs, bodyText, "utf8");
+      downloaded += 1;
+      succeededIds[outAbs] = id;
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      failed.push({ id, name, message: msg });
+    }
+  }
+  if (Object.keys(succeededIds).length > 0) {
+    const mergeRes = mergeUploadIdsIntoIndexOnDisk(opts.contextDirAbs, succeededIds);
+    if (!mergeRes.ok) {
+      log?.(`[download] merge ids into index failed: ${mergeRes.message}`);
+    }
+  }
+  return { downloaded, skipped, failed, localFilesRemoved, succeededIds };
+}
+
 // src/auth/authApi.ts
 var API_TIMEOUT_MS = 1e4;
 async function fetchWithTimeout(url, init, fetchImpl) {
@@ -19843,12 +20137,12 @@ function toFetchErrorMessage(e) {
 
 // src/auth/gluecharmContentNegotiation.ts
 var GLUECHARM_WS_LEGACY_JSON = "application/vnd.gluecharm.v1.ws-legacy+json";
-function pathWithoutQuery(path45) {
-  const q = path45.indexOf("?");
-  return q === -1 ? path45 : path45.slice(0, q);
+function pathWithoutQuery(path47) {
+  const q = path47.indexOf("?");
+  return q === -1 ? path47 : path47.slice(0, q);
 }
-function isGluecharmContentApiPath(path45) {
-  const p = pathWithoutQuery(path45);
+function isGluecharmContentApiPath(path47) {
+  const p = pathWithoutQuery(path47);
   return p.startsWith("/api/content/") || p.startsWith("/api/batch/content/");
 }
 function gluecharmContentHeaders(method) {
@@ -19886,7 +20180,7 @@ async function fetchWithTimeout2(url, init, fetchImpl, timeoutMs, externalSignal
 }
 function createAuthenticatedRequestJson(deps) {
   const fetchImpl = deps.fetchImpl ?? fetch;
-  async function requestJson(path45, options = {}) {
+  async function requestJson(path47, options = {}) {
     const base = deps.getApiBaseUrl();
     if (!base) {
       const err = { status: 0, message: "easyspecs.apiBaseUrl is not configured." };
@@ -19894,7 +20188,7 @@ function createAuthenticatedRequestJson(deps) {
     }
     const method = options.method ?? "GET";
     const headers = { ...options.headers };
-    if (isGluecharmContentApiPath(path45)) {
+    if (isGluecharmContentApiPath(path47)) {
       Object.assign(headers, gluecharmContentHeaders(method));
     } else {
       if (!headers.Accept) {
@@ -19908,7 +20202,7 @@ function createAuthenticatedRequestJson(deps) {
     if (options.withAuth !== false && access) {
       headers.Authorization = `Bearer ${access}`;
     }
-    const url = `${base}${path45}`;
+    const url = `${base}${path47}`;
     const timeoutMs = options.timeoutMs ?? API_TIMEOUT_MS;
     const response = await fetchWithTimeout2(
       url,
@@ -19929,7 +20223,7 @@ function createAuthenticatedRequestJson(deps) {
     if (shouldRetryUnauthorized) {
       const refreshed = await deps.refreshSession();
       if (refreshed) {
-        return requestJson(path45, { ...options, retryOnUnauthorized: false });
+        return requestJson(path47, { ...options, retryOnUnauthorized: false });
       }
     }
     const fallback = payload == null ? `${response.statusText || "HTTP error"} (response body empty or not JSON)` : "Request failed.";
@@ -19939,15 +20233,15 @@ function createAuthenticatedRequestJson(deps) {
 }
 
 // src/cli/cliSession.ts
-var fs42 = __toESM(require("node:fs"));
+var fs44 = __toESM(require("node:fs"));
 var os2 = __toESM(require("node:os"));
-var path41 = __toESM(require("node:path"));
+var path43 = __toESM(require("node:path"));
 function defaultSessionPath() {
-  return path41.join(os2.homedir(), ".easyspecs", "cli-session.json");
+  return path43.join(os2.homedir(), ".easyspecs", "cli-session.json");
 }
 var configSessionPath;
 function setCliSessionPathFromConfig(absPath) {
-  configSessionPath = absPath?.trim() ? path41.resolve(absPath) : void 0;
+  configSessionPath = absPath?.trim() ? path43.resolve(absPath) : void 0;
 }
 function applyCliSessionPathFromRepoConfig(repoRoot, cfg) {
   const raw = cfg.easyspecs?.cliSessionPath?.trim();
@@ -19955,7 +20249,7 @@ function applyCliSessionPathFromRepoConfig(repoRoot, cfg) {
     setCliSessionPathFromConfig(void 0);
     return;
   }
-  const abs = path41.isAbsolute(raw) ? raw : path41.join(repoRoot, raw);
+  const abs = path43.isAbsolute(raw) ? raw : path43.join(repoRoot, raw);
   setCliSessionPathFromConfig(abs);
 }
 function normalizeCliSessionPathForConfig(repoRoot, raw) {
@@ -19963,15 +20257,15 @@ function normalizeCliSessionPathForConfig(repoRoot, raw) {
   if (!t) {
     return "";
   }
-  const resolvedRepo = path41.resolve(repoRoot);
-  const abs = path41.isAbsolute(t) ? path41.normalize(t) : path41.resolve(resolvedRepo, t);
-  const rel = path41.relative(resolvedRepo, abs);
+  const resolvedRepo = path43.resolve(repoRoot);
+  const abs = path43.isAbsolute(t) ? path43.normalize(t) : path43.resolve(resolvedRepo, t);
+  const rel = path43.relative(resolvedRepo, abs);
   if (rel === "") {
     return abs;
   }
-  const underRepo = !rel.startsWith("..") && !path41.isAbsolute(rel);
+  const underRepo = !rel.startsWith("..") && !path43.isAbsolute(rel);
   if (underRepo) {
-    return rel.split(path41.sep).join("/");
+    return rel.split(path43.sep).join("/");
   }
   return abs;
 }
@@ -19984,10 +20278,10 @@ function effectiveCliSessionPath() {
 function readCliSession() {
   const p = effectiveCliSessionPath();
   try {
-    if (!fs42.existsSync(p)) {
+    if (!fs44.existsSync(p)) {
       return void 0;
     }
-    const j = JSON.parse(fs42.readFileSync(p, "utf8"));
+    const j = JSON.parse(fs44.readFileSync(p, "utf8"));
     const apiBaseUrl = typeof j.apiBaseUrl === "string" ? j.apiBaseUrl.trim() : "";
     const accessToken = typeof j.accessToken === "string" ? j.accessToken : "";
     const refreshToken = typeof j.refreshToken === "string" ? j.refreshToken : "";
@@ -20001,33 +20295,33 @@ function readCliSession() {
 }
 function writeCliSession(s) {
   const p = effectiveCliSessionPath();
-  fs42.mkdirSync(path41.dirname(p), { recursive: true });
-  fs42.writeFileSync(p, `${JSON.stringify(s, null, 2)}
+  fs44.mkdirSync(path43.dirname(p), { recursive: true });
+  fs44.writeFileSync(p, `${JSON.stringify(s, null, 2)}
 `, "utf8");
 }
 function clearCliSession() {
   const p = effectiveCliSessionPath();
   try {
-    fs42.unlinkSync(p);
+    fs44.unlinkSync(p);
   } catch {
   }
 }
 
 // src/analysis/acePendingTraces.ts
-var fs43 = __toESM(require("fs"));
-var path42 = __toESM(require("path"));
+var fs45 = __toESM(require("fs"));
+var path44 = __toESM(require("path"));
 function normalizeAceTraceRelativePath(rel) {
   return rel.split(/[/\\]/).join("/");
 }
 function readCompletedTraceRelativePaths(contextDir2) {
   const set = /* @__PURE__ */ new Set();
   const jsonlPath = aceConsolidatedSessionsJsonlPath(contextDir2);
-  if (!fs43.existsSync(jsonlPath)) {
+  if (!fs45.existsSync(jsonlPath)) {
     return set;
   }
   let raw;
   try {
-    raw = fs43.readFileSync(jsonlPath, "utf8");
+    raw = fs45.readFileSync(jsonlPath, "utf8");
   } catch {
     return set;
   }
@@ -20058,14 +20352,14 @@ function readCompletedTraceRelativePaths(contextDir2) {
 }
 function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
   const traceSchema = opencodeAceSchemaPath(worktreeRoot, ACE_SCHEMA_TRACE);
-  if (!fs43.existsSync(traceSchema)) {
+  if (!fs45.existsSync(traceSchema)) {
     return [];
   }
   const completed = readCompletedTraceRelativePaths(contextDir2);
   const allAbs = listAceTraceFiles(contextDir2);
   const pending = [];
   for (const abs of allAbs) {
-    const rel = normalizeAceTraceRelativePath(path42.relative(contextDir2, abs));
+    const rel = normalizeAceTraceRelativePath(path44.relative(contextDir2, abs));
     const v = validateAceJsonFile(abs, traceSchema);
     if (!v.ok) {
       continue;
@@ -20080,7 +20374,7 @@ function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
 }
 
 // src/analysis/aceAutoLearnPool.ts
-var path43 = __toESM(require("path"));
+var path45 = __toESM(require("path"));
 function clampConcurrency2(n) {
   if (!Number.isFinite(n)) {
     return 30;
@@ -20094,8 +20388,8 @@ async function runAceAutoLearnPool(p) {
   const fifo = [...p.traceAbsolutePaths];
   let active = 0;
   let wake;
-  const waitTurn = () => new Promise((resolve15) => {
-    wake = resolve15;
+  const waitTurn = () => new Promise((resolve17) => {
+    wake = resolve17;
   });
   const pump = () => {
     wake?.();
@@ -20115,7 +20409,7 @@ async function runAceAutoLearnPool(p) {
       abortSignal.addEventListener("abort", onPipelineAbort, { once: true });
     }
   }
-  const traceRel = (abs) => path43.relative(contextDir2, abs).split(path43.sep).join("/");
+  const traceRel = (abs) => path45.relative(contextDir2, abs).split(path45.sep).join("/");
   const runOne = async (traceAbs) => {
     if (abortSignal?.aborted) {
       active -= 1;
@@ -20564,7 +20858,7 @@ function formatCliStderrLine(line, useAnsi) {
 }
 
 // src/cli/main.ts
-var PKG_VERSION = "0.0.12";
+var PKG_VERSION = "0.0.14";
 function isEasyspecsConfigReadError(e) {
   return e instanceof EasyspecsConfigInvalidJsonError || e instanceof EasyspecsConfigSchemaError;
 }
@@ -20623,6 +20917,7 @@ Commands:
   diagnose coverage-report --root workspace|worktree [--worktree <path>]
   diagnose missing-artefacts --root workspace|worktree [--worktree <path>]
   diagnose zero-reference [--worktree <path>]
+  download context [--force] [--replace-from-cloud]
   upload context | upload republish
   ace clear | ace learn | ace auto-learn [--worktree <path>]
   config init [--overwrite]
@@ -20643,23 +20938,23 @@ function resolveAnalysisRoot(repoRoot, rootKind, worktreePath) {
     return repoRoot;
   }
   const wt = worktreePath?.trim();
-  if (wt && fs44.existsSync(path44.join(wt, ".git"))) {
-    return path44.resolve(wt);
+  if (wt && fs46.existsSync(path46.join(wt, ".git"))) {
+    return path46.resolve(wt);
   }
   throw new Error("worktree mode requires --worktree <path> to an existing analysis checkout.");
 }
 function resolveAdHocCheckoutRoot(_repoRoot, storage, worktreeFlag) {
   const w = worktreeFlag?.trim();
   if (w) {
-    const abs = path44.resolve(w);
-    if (fs44.existsSync(path44.join(abs, ".git"))) {
+    const abs = path46.resolve(w);
+    if (fs46.existsSync(path46.join(abs, ".git"))) {
       return abs;
     }
     throw new Error(`Invalid --worktree (not a git checkout): ${abs}`);
   }
   const snap = readAnalysisWorkspaceSnapshot(storage);
   const p = snap?.adHocWorktreePath?.trim();
-  if (p && fs44.existsSync(path44.join(p, ".git"))) {
+  if (p && fs46.existsSync(path46.join(p, ".git"))) {
     return p;
   }
   throw new Error("No analysis checkout: run `easyspecs-cli run synthesis` first or pass `--worktree <path>`.");
@@ -20686,7 +20981,7 @@ async function runResumeRemediationPool(storage, repoRoot, analysisRoot, merged,
   requireOpenCode(merged, flags);
   const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
   assertAgentsDirExists(agentsDir);
-  const ctxDir = path44.join(analysisRoot, ".gluecharm", "context");
+  const ctxDir = path46.join(analysisRoot, ".gluecharm", "context");
   const snap = readArtefactRunSnapshot(storage);
   const rows = listMissingArtefacts(ctxDir, analysisRoot, snap);
   if (rows.length === 0) {
@@ -20704,7 +20999,7 @@ async function runResumeRemediationPool(storage, repoRoot, analysisRoot, merged,
     storageContext: storage,
     repositoryRoot: repoRoot,
     worktreeRoot: analysisRoot,
-    workspaceLabel: path44.basename(analysisRoot),
+    workspaceLabel: path46.basename(analysisRoot),
     oc,
     log: (line) => logErr(flags, line),
     abortSignal: void 0,
@@ -20823,17 +21118,17 @@ async function main() {
         { easyspecs: { defaultGitRemoteUrl: url } },
         { warnMigration: (m) => logErr(flags, `[EasySpecs] ${m}`) }
       );
-      const path45 = easyspecsConfigPath(repoRoot);
+      const path47 = easyspecsConfigPath(repoRoot);
       if (flags.json) {
         printJsonLine({
           command: "config set-git-remote",
           durationMs: Date.now() - t0,
           ok: true,
-          path: path45,
+          path: path47,
           defaultGitRemoteUrl: cfg.easyspecs?.defaultGitRemoteUrl ?? ""
         });
       } else {
-        console.log(`Updated ${path45} \u2014 easyspecs.defaultGitRemoteUrl`);
+        console.log(`Updated ${path47} \u2014 easyspecs.defaultGitRemoteUrl`);
       }
       process.exit(ExitCode.ok);
     } catch (e) {
@@ -20851,6 +21146,9 @@ async function main() {
       allowCreate: allowCreateConfig,
       warnMigration: (m) => logErr(flags, `[EasySpecs] ${m}`)
     });
+    repoConfig = syncDefaultGitRemoteUrlIfEmpty(repoRoot, repoConfig, {
+      warnMigration: (m) => logErr(flags, `[EasySpecs] ${m}`)
+    });
   } catch (e) {
     if (isEasyspecsConfigReadError(e)) {
       console.error(e.message);
@@ -20861,7 +21159,7 @@ async function main() {
   applyCliSessionPathFromRepoConfig(repoRoot, repoConfig);
   if (flags.sessionPath?.trim()) {
     const sp = flags.sessionPath.trim();
-    const abs = path44.isAbsolute(sp) ? path44.normalize(sp) : path44.resolve(repoRoot, sp);
+    const abs = path46.isAbsolute(sp) ? path46.normalize(sp) : path46.resolve(repoRoot, sp);
     setCliSessionPathFromConfig(abs);
   }
   const apiResolved = initApiBaseUrlForCli(repoRoot, flags, repoConfig);
@@ -20882,6 +21180,12 @@ async function main() {
     process.exit(code);
     throw new Error("unreachable");
   };
+  const requireMinimalGluecharmLayoutAt = (absRoot) => {
+    const r = ensureMinimalGluecharmLayoutNode(absRoot);
+    if (!r.ok) {
+      finish(ExitCode.misconfiguration, { ok: false, error: r.error });
+    }
+  };
   const pos = positionals;
   try {
     resetCliDiagnosticPhaseState();
@@ -20895,7 +21199,7 @@ async function main() {
         process.exit(ExitCode.usage);
       }
       const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
-      const agentsOk = fs44.existsSync(agentsDir);
+      const agentsOk = fs46.existsSync(agentsDir);
       const oc = getOpenCodeReadiness({
         executable: merged.openCodeExecutable,
         skipCredentialsCheck: merged.openCodeSkipCredentialsCheck,
@@ -21070,7 +21374,7 @@ async function main() {
       const result = await runContextArtefactPipelineAsync(
         storage,
         repoRoot,
-        path44.basename(repoRoot),
+        path46.basename(repoRoot),
         agentsDir,
         {
           ...merged.pipelineOpenCode
@@ -21124,7 +21428,8 @@ async function main() {
       const worktree = wtExplicit ?? wtFromRoot;
       if (sub === "reference-coverage") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
-        const contextDir2 = path44.join(rootAbs, ".gluecharm", "context");
+        requireMinimalGluecharmLayoutAt(rootAbs);
+        const contextDir2 = path46.join(rootAbs, ".gluecharm", "context");
         const res = runCoverageReferenceValidation({
           repositoryRootAbs: rootAbs,
           contextDirAbs: contextDir2,
@@ -21146,7 +21451,8 @@ async function main() {
       }
       if (sub === "coordination-duplicates") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
-        const contextDir2 = path44.join(rootAbs, ".gluecharm", "context");
+        requireMinimalGluecharmLayoutAt(rootAbs);
+        const contextDir2 = path46.join(rootAbs, ".gluecharm", "context");
         const res = runCoordinationDuplicatesDiagnosis({
           contextDirAbsolute: contextDir2,
           sourceRoot: rootKind === "worktree" ? "worktree" : "workspace"
@@ -21168,6 +21474,7 @@ async function main() {
       }
       if (sub === "coverage-report") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
+        requireMinimalGluecharmLayoutAt(rootAbs);
         const rep = await runReferenceCoverageExecutionReport({
           repositoryRootAbs: rootAbs,
           diagnosticLog: (line) => logErr(flags, line)
@@ -21180,7 +21487,8 @@ async function main() {
       }
       if (sub === "missing-artefacts") {
         const rootAbs = resolveAnalysisRoot(repoRoot, rootKind, worktree);
-        const ctxDir = path44.join(rootAbs, ".gluecharm", "context");
+        requireMinimalGluecharmLayoutAt(rootAbs);
+        const ctxDir = path46.join(rootAbs, ".gluecharm", "context");
         const storage = createFileBackedWorkspaceState(repoRoot);
         const snap = readArtefactRunSnapshot(storage);
         const rows = listMissingArtefacts(ctxDir, rootAbs, snap);
@@ -21201,6 +21509,7 @@ async function main() {
         const storage = createFileBackedWorkspaceState(repoRoot);
         const { worktree: wtAce } = parseWorktreeFlag(pos.slice(2));
         const analysisRoot = resolveAdHocCheckoutRoot(repoRoot, storage, wtAce);
+        requireMinimalGluecharmLayoutAt(analysisRoot);
         const cov = readNonReferencedFilesFromRepositoryRoot(analysisRoot);
         if (!cov.ok) {
           finish(ExitCode.validation, { ok: false, error: cov.error });
@@ -21260,6 +21569,7 @@ async function main() {
           cloudContextAnalyzedAt: cloudCachedAt
         });
       }
+      requireMinimalGluecharmLayoutAt(repoRoot);
       requireOpenCode(merged, flags);
       const wantsUpload = positionals.includes("--upload");
       const uploadSession = wantsUpload ? readCliSession() : void 0;
@@ -21276,8 +21586,8 @@ async function main() {
       const runBackendSyncImpl = wantsUpload && uploadSession ? async () => {
         const s = uploadSession;
         const snap = readAnalysisWorkspaceSnapshot(storage);
-        const wsContextDir = path44.join(repoRoot, ".gluecharm", "context");
-        const wtContextDir = snap?.adHocWorktreePath && fs44.existsSync(path44.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path44.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
+        const wsContextDir = path46.join(repoRoot, ".gluecharm", "context");
+        const wtContextDir = snap?.adHocWorktreePath && fs46.existsSync(path46.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path46.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
         if (!wtContextDir) {
           return { ok: false, message: "No worktree context to upload." };
         }
@@ -21343,6 +21653,104 @@ async function main() {
         totalElapsedMs: res.totalElapsedMs
       });
     }
+    if (pos[0] === "download" && pos[1] === "context") {
+      const sessRaw = readCliSession();
+      if (sessRaw === void 0) {
+        finish(ExitCode.auth, {
+          ok: false,
+          error: "auth login first (`easyspecs-cli auth login --email \u2026 --password \u2026`, or `--ci` with easyspecs.auth.ciLogin in .easyspecs/config.json)"
+        });
+      }
+      let force = false;
+      let replaceFromCloud = false;
+      for (const a of pos.slice(2)) {
+        if (a === "--force") {
+          force = true;
+          continue;
+        }
+        if (a === "--replace-from-cloud") {
+          replaceFromCloud = true;
+          continue;
+        }
+        finish(ExitCode.usage, { ok: false, error: `unknown download context flag: ${a}` });
+      }
+      requireMinimalGluecharmLayoutAt(repoRoot);
+      const ctxDir = path46.resolve(path46.join(repoRoot, ".gluecharm", "context"));
+      const gluecharmParent = path46.dirname(ctxDir);
+      if (path46.basename(gluecharmParent) === ".gluecharm" && path46.basename(ctxDir) === "context") {
+        requireMinimalGluecharmLayoutAt(path46.dirname(gluecharmParent));
+      }
+      const appIdRaw = getEasyspecsProjectIdFromRepoConfig(repoConfig)?.trim();
+      if (!appIdRaw) {
+        finish(ExitCode.misconfiguration, {
+          ok: false,
+          error: "Missing easyspecs.easyspecsProjectId in .easyspecs/config.json."
+        });
+      }
+      const applicationId = appIdRaw;
+      const sess = sessRaw;
+      let access = sess.accessToken;
+      const refresh = sess.refreshToken;
+      const requestJson = createAuthenticatedRequestJson({
+        getApiBaseUrl: () => sess.apiBaseUrl,
+        getAccessToken: () => access,
+        getRefreshToken: () => refresh,
+        refreshSession: async () => {
+          try {
+            const r = await refreshTokenWithApi(sess.apiBaseUrl, fetch, refresh);
+            access = r.accessToken;
+            writeCliSession({
+              apiBaseUrl: sess.apiBaseUrl,
+              accessToken: r.accessToken,
+              refreshToken: r.refreshToken
+            });
+            return true;
+          } catch {
+            return false;
+          }
+        }
+      });
+      try {
+        const result = await runContextSrsDiscoveryDownload({
+          requestJson,
+          applicationId,
+          contextDirAbs: ctxDir,
+          force,
+          replaceFromCloud,
+          log: (line) => logErr(flags, line)
+        });
+        const failCount = result.failed.length;
+        const cmdOk = failCount === 0;
+        if (!flags.json) {
+          logErr(
+            flags,
+            `[download] downloaded=${String(result.downloaded)} skipped=${String(result.skipped)} failed=${String(failCount)} localRemoved=${String(result.localFilesRemoved)}`
+          );
+          if (failCount > 0) {
+            for (const f of result.failed.slice(0, 12)) {
+              logErr(
+                flags,
+                `[download] failed ${f.name ?? "?"} (${f.id ?? "?"}): ${f.message}`
+              );
+            }
+            if (result.failed.length > 12) {
+              logErr(flags, `[download] \u2026 and ${String(result.failed.length - 12)} more`);
+            }
+          }
+        }
+        finish(cmdOk ? ExitCode.ok : ExitCode.upload, {
+          ok: cmdOk,
+          downloaded: result.downloaded,
+          skipped: result.skipped,
+          failed: failCount,
+          localRemoved: result.localFilesRemoved,
+          ...flags.verbose && failCount > 0 ? { failures: result.failed } : {}
+        });
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        finish(ExitCode.internal, { ok: false, error: msg });
+      }
+    }
     if (pos[0] === "upload" && (pos[1] === "context" || pos[1] === "republish")) {
       const sessRaw = readCliSession();
       if (sessRaw === void 0) {
@@ -21352,16 +21760,17 @@ async function main() {
         });
       }
       const sess = sessRaw;
-      let ctxDir = path44.join(repoRoot, ".gluecharm", "context");
+      requireMinimalGluecharmLayoutAt(repoRoot);
+      let ctxDir = path46.join(repoRoot, ".gluecharm", "context");
       if (pos[1] === "republish") {
         const fromCfg = repoConfig.easyspecs?.upload?.contextDirectory?.trim();
-        const resolvedOverride = fromCfg && fromCfg.length > 0 ? path44.isAbsolute(fromCfg) ? path44.normalize(fromCfg) : path44.resolve(repoRoot, fromCfg) : "";
-        if (resolvedOverride && fs44.existsSync(path44.join(resolvedOverride, ".."))) {
+        const resolvedOverride = fromCfg && fromCfg.length > 0 ? path46.isAbsolute(fromCfg) ? path46.normalize(fromCfg) : path46.resolve(repoRoot, fromCfg) : "";
+        if (resolvedOverride && fs46.existsSync(path46.join(resolvedOverride, ".."))) {
           ctxDir = resolvedOverride;
         } else {
           const storage = createFileBackedWorkspaceState(repoRoot);
           const snap = readAnalysisWorkspaceSnapshot(storage);
-          const wt = snap?.adHocWorktreePath && fs44.existsSync(path44.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path44.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
+          const wt = snap?.adHocWorktreePath && fs46.existsSync(path46.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path46.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
           if (!wt) {
             finish(ExitCode.misconfiguration, {
               ok: false,
@@ -21371,6 +21780,11 @@ async function main() {
           ctxDir = wt;
         }
       }
+      const ctxResolved = path46.resolve(ctxDir);
+      const gluecharmParent = path46.dirname(ctxResolved);
+      if (path46.basename(gluecharmParent) === ".gluecharm" && path46.basename(ctxResolved) === "context") {
+        requireMinimalGluecharmLayoutAt(path46.dirname(gluecharmParent));
+      }
       const appIdRaw = getEasyspecsProjectIdFromRepoConfig(repoConfig)?.trim();
       if (!appIdRaw) {
         finish(ExitCode.misconfiguration, {
@@ -21473,18 +21887,18 @@ async function main() {
       finish(failed ? ExitCode.upload : ExitCode.ok, primary);
     }
     if (pos[0] === "ace" && pos[1] === "clear") {
-      const learnings = path44.join(repoRoot, ".gluecharm", "context", "learnings");
-      if (!fs44.existsSync(learnings)) {
+      const learnings = path46.join(repoRoot, ".gluecharm", "context", "learnings");
+      if (!fs46.existsSync(learnings)) {
         finish(ExitCode.ok, { ok: true, message: "nothing to clear" });
       }
-      fs44.rmSync(learnings, { recursive: true, force: true });
+      fs46.rmSync(learnings, { recursive: true, force: true });
       finish(ExitCode.ok, { ok: true, message: `cleared ${learnings}` });
     }
     if (pos[0] === "ace" && pos[1] === "learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs44.existsSync(path44.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
-      const contextDir2 = path44.join(root, ".gluecharm", "context");
+      const root = worktree && fs46.existsSync(path46.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
+      const contextDir2 = path46.join(root, ".gluecharm", "context");
       const traces = listAceTraceFiles(contextDir2);
       if (traces.length === 0) {
         finish(ExitCode.ok, { ok: true, message: "no traces", traceCount: 0 });
@@ -21508,8 +21922,8 @@ async function main() {
     if (pos[0] === "ace" && pos[1] === "auto-learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs44.existsSync(path44.join(worktree, ".git")) ? worktree : repoRoot;
-      const contextDir2 = path44.join(root, ".gluecharm", "context");
+      const root = worktree && fs46.existsSync(path46.join(worktree, ".git")) ? worktree : repoRoot;
+      const contextDir2 = path46.join(root, ".gluecharm", "context");
       const pending = listPendingAceTraceFiles(contextDir2, root);
       if (pending.length === 0) {
         finish(ExitCode.ok, { ok: true, pending: 0 });