agentlas 1.0.14 → 1.0.15

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 1.0.15 — 2026-07-29
+
+- **Agent Cloud saves work from a new machine or fresh clone.** Before writing,
+  the terminal resolves the signed-in owner's exact asset revision by
+  `slug` and scope, then keeps the conditional-write guard on that revision.
+  A missing local receipt no longer turns an owned asset into a false create
+  conflict.
+- **A real stale-copy conflict stays fail-closed.** The terminal stops before
+  replacing a newer server revision, reports its identity, and offers an
+  explicit `--overwrite` only when the owner deliberately chooses the current
+  folder over the newer copy.
+- Conflict messages now describe ownership and the next command instead of
+  exposing storage precondition terminology.
+
 ## 1.0.14 — 2026-07-29
 
 - **Write-capable commands now prepare every project automatically.** The first

package/engine/agentlas-cloud-runtime.cjs

@@ -74,7 +74,7 @@ function buildManifest(root, options = {}) {
     memoryPolicy: { writeBack: "ask", publicCopy: "reset" },
     memory: files.filter((file) => [".agentlas/memory-map.json", ".agentlas/agent-card.json"].includes(file.path)).map((file) => file.path),
     allowRead: ["README.md", "AGENTS.md", "agent.md", "skills/**", ".agentlas/*.json"],
-    denyRead: [".env", ".env.*", "**/secrets/**", "**/credentials/**", "**/cookies/**", "**/*token*", "**/*secret*"],
+    denyRead: [".env", ".env.*", "secrets/**", "**/secrets/**", "credentials/**", "**/credentials/**", "cookies/**", "**/cookies/**"],
     publicExportPolicy: "clean-copy",
     requiredRuntime: ["mcp-client"],
     license: "call-only-default",
@@ -92,7 +92,13 @@ function scanFiles(files) {
     findings.push({ verdict, type, path: file.path, ...(line ? { line } : {}), message, redacted: true });
   }
   for (const file of files) {
-    if ([".env", ".env.local"].includes(file.path) || /(?:^|\/)(secrets|credentials|cookies)\//i.test(file.path) || /token|secret/i.test(file.path)) {
+    // A credential store is a path SEGMENT, never a filename substring. The old
+    // `/token|secret/i` test blocked ordinary vocabulary — measured 2026-07-29,
+    // it gave the live `web-master` package a BLOCK verdict for its own design
+    // system (`token-architecture.md`, `reference-token-db.json`). Dropping it
+    // costs no coverage: the per-line SECRET_PATTERNS scan below reads every
+    // packaged file and is the check that actually looks at values.
+    if (/^\.env(\.|$)/.test(file.path.split("/").pop() || "") || /(?:^|\/)(secrets|credentials|cookies)\//i.test(file.path)) {
       add("BLOCK", "credential-path", file, null, "Credential-like file path is excluded from Cloud package and public publish.");
     }
     file.content.split(/\r?\n/).forEach((line, index) => {

package/engine/cloud-assets/cas.cjs

@@ -42,9 +42,14 @@ function cloudCasResponseError(response, label) {
   let message = `${label} failed with HTTP ${response.status}`;
   if (response.status === 412 && code === "cloud_agent_revision_conflict") {
     const current = body && body.current ? body.current : body && body.conflict && body.conflict.current;
+    // 서버가 알려준 사실만 사람 말로 전달한다. 내부 개념(precondition, base, 연결)은
+    // 사용자에게 아무 의미가 없다 — 기준은 "이 이름이 내 계정 것인가" 하나다.
     message = current
-      ? `다른 PC에서 이 Agent Cloud 자산이 변경되었습니다. 자동 덮어쓰기는 중단했습니다. \`agentlas cloud list\`로 최신 revision을 확인하고 \`agentlas cloud restore ${current.slug || "<slug>"}\`로 복원한 뒤 변경 사항을 병합하세요.`
-      : "이 Agent Cloud 자산은 다른 PC에서 삭제되었거나 다른 식별자로 다시 생성되었습니다. 자동 재생성은 중단했습니다. `agentlas cloud list`로 현재 상태를 확인하세요.";
+      ? `업로드하지 않았습니다. "${current.slug || "이 이름"}"의 서버 버전이 지금 보낸 것과 맞지 않습니다` +
+        `${current.updatedAt ? ` (서버 쪽 마지막 저장: ${current.updatedAt})` : ""}.\n` +
+        `  내 계정 자산이면: agentlas cloud restore ${current.slug || "<slug>"} 로 받아서 확인한 뒤 다시 저장하세요.\n` +
+        `  (서버 cloudId ${current.cloudId || "?"} · revision ${current.revision || "?"})`
+      : "업로드하지 않았습니다. 이 이름의 자산이 삭제됐거나 다른 계정 소유입니다. `agentlas cloud list`로 내 자산을 확인하세요.";
   } else if (response.status === 428 && code === "client_upgrade_required") {
     message = "No base revision is available to safely update the existing Cloud asset. The server revision will not be copied automatically. Check `agentlas cloud list`, restore with `agentlas cloud restore <slug>`, then save again.";
   } else if (response.status === 503 && code === "cloud_mutations_maintenance") {

package/engine/cloud-assets/commands.cjs

@@ -103,6 +103,7 @@ const CLOUD_HELP = [
   "  publish <path> [--dry-run] [--slug name]",
   "                                      explicitly publish to the public Agentlas Hub",
   "  package <path> [--json] [--visibility private-link|marketplace]",
+  "  --overwrite                         서버에 더 새 버전이 있어도 지금 폴더 내용으로 덮어쓰기",
   "                                      package only; defaults to private-save checks",
   "  list [--json]                       list packages in your private Agent Cloud",
   "  restore <slug> [--json]             restore an owned Cloud package on this machine",
@@ -241,6 +242,7 @@ async function runCloud(ctx, args) {
     slug: typeof flags.slug === "string" ? flags.slug : undefined,
     visibility,
     llmReview: Boolean(flags["llm-review"]),
+    overwriteRemote: Boolean(flags.overwrite),
     dryRun,
   });
   if (flags.json) {

package/engine/cloud-assets/package.cjs

@@ -33,10 +33,12 @@ const {
   cloudPortablePathConflict,
   cloudPackageHashVersion,
   cloudHashPackage,
+  normalizeCloudAssetDescriptor,
 } = require("../hub/install.cjs");
 const { SECRET_PATTERNS } = require("../agentlas-secret-patterns.cjs");
 const { userDataDir } = require("../core/paths.cjs");
 const state = require("./state.cjs");
+const { cargoSearchAgents } = require("./cargo.cjs");
 const cas = require("./cas.cjs");
 
 const CLOUD_TEXT_EXTS = new Set([".cfg", ".cjs", ".conf", ".config", ".css", ".csv", ".env", ".html", ".ini", ".js", ".json", ".jsonl", ".md", ".mjs", ".properties", ".ps1", ".psd1", ".psm1", ".py", ".sh", ".toml", ".ts", ".tsx", ".txt", ".xml", ".yaml", ".yml"]);
@@ -748,6 +750,28 @@ function cloudSecuritySummary(findings) {
 
 // ── 메인: 패키지(+등록) ──
 
+/**
+ * 이 계정이 소유한 자산의 현재 리비전을 서버에서 조회한다.
+ * 로컬 관측 기록이 전혀 없는 새 PC/새 클론에서 갱신을 가능하게 하는 유일한 경로다.
+ * 소유자 세션이 없거나 자산이 없으면 null — 조용한 폴백은 만들지 않는다.
+ */
+async function lookupOwnedCloudDescriptor(slug, scope) {
+  let response;
+  try {
+    response = await cargoSearchAgents({ q: slug, limit: 20 });
+  } catch {
+    return null;
+  }
+  const rows = Array.isArray(response && response.results) ? response.results : [];
+  const row = rows.find((item) => item && item.slug === slug && item.scope === scope);
+  if (!row) return null;
+  try {
+    return normalizeCloudAssetDescriptor(row, "owner cloud search result");
+  } catch {
+    return null;
+  }
+}
+
 async function packageCloudAgent(db, root, opts = {}) {
   const requestedRoot = path.resolve(root);
   let st;
@@ -796,7 +820,7 @@ async function packageCloudAgent(db, root, opts = {}) {
   const name = cloudReadName(snapshot, path.basename(rootPath));
   const slug = cloudSlug(opts.slug || cloudReadStableSlug(snapshot) || name || path.basename(rootPath));
   const scope = cas.cloudScopeForVisibility(visibility);
-  const baseDescriptor = state.cloudBaseDescriptorForSource(scan.localPackageMarker, rootPath, slug, scope);
+  let baseDescriptor = state.cloudBaseDescriptorForSource(scan.localPackageMarker, rootPath, slug, scope);
   const packageHashVersion = CLOUD_PACKAGE_HASH_V2;
   const packageHash = cloudHashPackage(scan.included, packageHashVersion);
   const manifest = {
@@ -844,6 +868,30 @@ async function packageCloudAgent(db, root, opts = {}) {
   let registration = null;
   let status = blocked ? "blocked" : opts.dryRun ? "dry-run" : "ready";
   if (!blocked && !opts.dryRun) {
+    // 자산의 정체성은 (로그인 계정, slug)다 — 어느 폴더에서 올리는지는 중요하지 않다.
+    // 쓰기 전에 서버가 들고 있는 내 자산의 현재 버전을 조회해서:
+    //   · 이 폴더에 기록이 없으면(새 PC, 새 클론) 그 버전을 기준으로 업데이트한다.
+    //   · 이 폴더 기록이 서버보다 오래됐으면(다른 곳에서 먼저 올림) 덮어쓰기 전에 멈춘다.
+    // 이것은 412 뒤의 자동 재시도가 아니라 쓰기 전 refresh다. 등록 자체는 여전히
+    // 조회한 정확한 리비전에 대한 조건부 쓰기(If-Match)라 경합은 서버가 막는다.
+    const remote = await lookupOwnedCloudDescriptor(slug, scope);
+    if (!baseDescriptor && remote) {
+      baseDescriptor = state.rememberCloudAssetDescriptor(remote, { sourceRoot: rootPath });
+    } else if (baseDescriptor && remote && baseDescriptor.revision !== remote.revision) {
+      if (opts.overwriteRemote) {
+        baseDescriptor = state.rememberCloudAssetDescriptor(remote, { sourceRoot: rootPath });
+      } else {
+        const error = new Error(
+          `업로드하지 않았습니다. "${slug}"에 더 새 버전이 있습니다 (${remote.updatedAt || "시각 미상"}에 다른 곳에서 저장됨).\n` +
+          `  지금 폴더 내용으로 그 버전을 덮어쓰려면: --overwrite\n` +
+          `  먼저 그 버전을 받아서 비교하려면:      agentlas cloud restore ${slug}\n` +
+          `  (서버 cloudId ${remote.cloudId} · revision ${remote.revision})`,
+        );
+        error.code = "cloud_agent_revision_conflict";
+        error.current = remote;
+        throw error;
+      }
+    }
     registration = await cas.registerCloudAgent(manifest, bundlePath, review, visibility, { baseDescriptor });
     let descriptor;
     try {

package/engine/cloud-assets/state.cjs

@@ -174,6 +174,39 @@ function cloudBaseDescriptorFromMarker(marker, slug, scope) {
  * 톰스톤에 걸린 마커 디스크립터는 무시(삭제 후 재저장은 새 생성이어야 한다).
  * 둘 다 있으면 같은 cloudId에서 더 최신 관측을 채택한다.
  */
+/**
+ * 이 slug/scope의 관측된 리비전은 있는데, 이 소스 루트에는 아직 연결되지 않은
+ * 경우를 돌려준다.
+ *
+ * 이 구분이 없으면 base 조회가 null을 돌려주고, 호출부는 그것을 "새 자산"으로
+ * 읽어 create precondition을 보낸다. 서버에는 자산이 멀쩡히 존재하므로 412로
+ * 거절되고, 사용자는 "다른 PC에서 변경됨 / restore 하세요"라는 엉뚱한 안내를
+ * 받는다. restore는 디스크립터를 설치 경로에 묶으므로 소스 루트에서 발행하는
+ * 한 영원히 해소되지 않는다. 모름을 그럴듯한 값으로 메꾸지 않기 위한 분기다.
+ */
+function cloudUnboundDescriptorForSource(rootPath, slug, scope) {
+  const state = readCloudAssetState();
+  const entry = state.assets[`${scope}:${slug}`];
+  if (!entry) return null;
+  return entry.sourceRoots.includes(path.resolve(rootPath)) ? null : entry.descriptor;
+}
+
+/** 이 소스 루트를 이미 관측된 클라우드 자산에 명시적으로 연결한다. */
+function bindCloudAssetSourceRoot(rootPath, slug, scope) {
+  const state = readCloudAssetState();
+  const key = `${scope}:${slug}`;
+  const entry = state.assets[key];
+  if (!entry) throw new Error(`No observed Cloud revision for ${key} to bind.`);
+  const normalizedRoot = path.resolve(rootPath);
+  const roots = [...new Set([...entry.sourceRoots, normalizedRoot])].slice(0, 32);
+  state.assets[key] = { descriptor: entry.descriptor, sourceRoots: roots };
+  state.deletedBases = state.deletedBases.filter(
+    (item) => !(item.rootPath === normalizedRoot && item.slug === slug && item.scope === scope),
+  );
+  writeCloudAssetState(state);
+  return entry.descriptor;
+}
+
 function cloudBaseDescriptorForSource(marker, rootPath, slug, scope) {
   const state = readCloudAssetState();
   const normalizedRoot = path.resolve(rootPath);
@@ -263,6 +296,8 @@ module.exports = {
   cloudMarkerDescriptors,
   cloudBaseDescriptorFromMarker,
   cloudBaseDescriptorForSource,
+  cloudUnboundDescriptorForSource,
+  bindCloudAssetSourceRoot,
   writeCloudSourceMarker,
   readCloudSourceMarker,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Agentlas agent terminal — chat with your installed AI agents and teams from the terminal, Claude Code style. Standalone: no desktop app required.",
   "bin": {
     "agentlas": "bin/agentlas.cjs"