agentlas 0.9.8 → 0.9.10

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 0.9.10 — 2026-07-26
+
+- `agentlas context refresh|refs|slice|impact|verify` now invokes the installed
+  Agentlas Core module directly. Context commands no longer fall through the
+  natural-language Hephaestus command route.
+- Context Slice generation refreshes the project fingerprint before each
+  concrete Terminal task, so a long-running Terminal session sees newly added
+  or changed CommonJS, ESM, TypeScript, and JavaScript files.
+- Release validation pins Agentlas Core v1.1.67 commit
+  `04258b7541f604479dc04279146a506e363ad85e`, including Code Map v2 backlinks,
+  functional Sitemap dependencies, and fail-closed impact verification.
+
+## 0.9.9 — 2026-07-26
+
+- In an explicitly initialized project, ordinary runs, firms, Stormbreaker, and
+  Workforce now receive the same local Context Slice from Agentlas OS v1.1.66
+  after the task is concrete. The slice carries inherited goals and constraints
+  plus exact definitions, backlinks, and structurally related files without
+  sending the project map to Hub or Cloud.
+- Read, write, and full task permission no longer doubles as consent to create
+  `.agentlas/` or edit `.gitignore`. `agentlas project status` is passive, and
+  only the explicit `agentlas project init` boundary creates private project
+  state after announcing the side effects.
+- Workload-routing receipts now conform to the public v1 nested schema, treat a
+  missing model/runtime pair as unresolved, and fail closed on unknown required
+  metadata or ambiguous duplicate model identifiers.
+- The shared architecture seeder is monotonic: it preserves newer or
+  unparseable shared state, upgrades older state atomically, and repairs only
+  missing built-ins at an equal version instead of flipping the Desktop-shared
+  database back to an older Terminal bundle.
+- Interactive output is append-only while a task runs, preserves long streamed
+  output and scrollback through resize/cancellation, wraps command meaning at
+  narrow widths, and keeps saved runtime, permission, lifecycle, and Korean/
+  English status text truthful.
+- Release validation targets the exact Agentlas OS v1.1.66 contract commit
+  `3f6f9ac3929b9238330de18c758ba200fb371017`.
+
 ## 0.9.8 — 2026-07-25
 
 - No more silent keyword fallback. When the connected model can't judge a route

package/README.md

@@ -17,10 +17,9 @@ Claude Code style, standalone: **no desktop app required.**
 Agentlas Terminal is the already-shipped independent terminal product. It is
 not a Desktop `cli/` mirror and does not require the Desktop app to run.
 
-> **Current source release candidate (2026-07-16):** `v0.9.1`. The source commit
-> does not prove a GitHub release or npm publication. After the immutable tag
-> and release gates pass, verify the independently published npm version with
-> `npm view agentlas version` before installation.
+> **Current source release candidate (2026-07-26):** `v0.9.10`. A source commit
+> does not prove npm publication. Verify the independently published package
+> before installation with `npm view agentlas version`.
 
 Release tags are published to npm through the repository's OIDC trusted
 publisher workflow. The workflow accepts only an exact immutable `vX.Y.Z` tag,
@@ -116,6 +115,25 @@ agentlas import <폴더>             # 로컬 에이전트/팀 임포트
 agentlas list                      # 설치된 에이전트/회사 + 활성 런타임
 ```
 
+**프로젝트 의존관계 지도**
+```sh
+agentlas project status
+agentlas project init
+agentlas context refresh
+agentlas context refs resolveHubEntityKind
+agentlas context slice --task "entity kind 라우팅 수정" \
+  --target src/package-kind.ts --render
+agentlas context impact --changed src/package-kind.ts
+agentlas context verify --changed src/package-kind.ts \
+  --reviewed src/register/route.ts
+```
+
+`agentlas project init`으로 명시적으로 초기화한 프로젝트에서만 일반
+실행, 팀, Stormbreaker, Workforce가 작업이 구체화된 뒤 같은 로컬 Context
+Slice를 자동으로 받는다. 읽기·쓰기·전체 권한만으로는 `.agentlas/`나
+`.gitignore`를 만들거나 수정하지 않는다. Hub/Cloud 검색에는 코드맵,
+소스 경로, 프로젝트 파일 내용이 전송되지 않는다.
+
 **Portable Experience Bundle과 Variant**
 ```sh
 agentlas experience list

package/engine/agentlas-workforce.cjs

@@ -1643,7 +1643,13 @@ function create(deps = {}) {
   }
 
   async function runModel(runtime, system, prompt, context) {
-    if (typeof D.runModel === "function") return normalizeModelText(await D.runModel({ runtime, system, prompt, context }));
+    const localContextSlice = typeof D.projectContextSlice === "function"
+      ? D.projectContextSlice(context.cwd, context.task || "")
+      : "";
+    const effectiveSystem = localContextSlice
+      ? `${system}\n\n${localContextSlice}`
+      : system;
+    if (typeof D.runModel === "function") return normalizeModelText(await D.runModel({ runtime, system: effectiveSystem, prompt, context }));
     if (runtime.mode === "cli") {
       const authorityMode = context.authorityMode || "no-authority";
       if (runtime.kind === "codex" && authorityMode === "no-authority") {
@@ -1658,7 +1664,7 @@ function create(deps = {}) {
           "Gemini CLI workforce execution is blocked until this host proves an empty built-in and MCP tool inventory",
         );
       }
-      return normalizeModelText(await D.captureRuntime(runtime.kind, system, prompt, {
+      return normalizeModelText(await D.captureRuntime(runtime.kind, effectiveSystem, prompt, {
         cwd: context.cwd,
         env: context.env,
         permission: context.permission,
@@ -1667,7 +1673,7 @@ function create(deps = {}) {
         authorityMode,
       }));
     }
-    return normalizeModelText(await D.runApi(runtime.backend, context.modelPin || runtime.model, system, prompt));
+    return normalizeModelText(await D.runApi(runtime.backend, context.modelPin || runtime.model, effectiveSystem, prompt));
   }
 
   async function callHubTool(name, args) {
@@ -1888,7 +1894,15 @@ function create(deps = {}) {
     const env = typeof D.buildChildEnv === "function" ? await D.buildChildEnv(db, {
       projectPath: ctx.projectPath || null, permission, cwd, lang: ui.lang,
     }) : process.env;
-    const modelContext = { cwd, permission, env, modelPin: ctx.modelPin || null, effortPin: ctx.effortPin, authorityMode: "no-authority" };
+    const modelContext = {
+      cwd,
+      permission,
+      env,
+      modelPin: ctx.modelPin || null,
+      effortPin: ctx.effortPin,
+      authorityMode: "no-authority",
+      task,
+    };
     const prompts = buildPrompts(task, identity);
     const runId = `workforce-run:${crypto.randomUUID()}`;
     const provider = runtime.mode === "cli" ? runtime.kind : runtime.backend;

package/engine/agentlas.cjs

@@ -35,7 +35,11 @@ const desktopOntologyLoadout = require("./agentlas-desktop-loadout.cjs");
 const workloadRouting = require("./agentlas-workload-routing.cjs");
 const terminalExperienceIntake = require("./agentlas-experience-intake.cjs");
 const terminalMemoryGovernance = require("./agentlas-memory-governance.cjs");
-const { captureCoreJsonSync, resolveCoreRuntimeRoot } = require("./agentlas-core-harness.cjs");
+const {
+  captureCoreJsonSync,
+  resolveCoreRuntimeRoot,
+  spawnCoreModule,
+} = require("./agentlas-core-harness.cjs");
 
 // ── 앱과 동일한 userData 경로 (electron app.getPath('userData')와 일치) ──
 function userDataDir() {
@@ -8334,7 +8338,66 @@ function ensureTerminalProjectForExecutionCli(db, projectPath, permission = PERM
   if (permission === "read") return activeProjectPath(db, { projectPath: root });
   return activeProjectPath(db, { projectPath: root, activate: true, reason });
 }
-function cliMemoryContext(db, projectPath, agentId = null) {
+
+function cliProjectContextSlice(projectPath, task) {
+  if (!projectPath || !String(task || "").trim()) return "";
+  if (!fs.existsSync(path.join(projectPath, ".agentlas"))) return "";
+  try {
+    const coreRoot = resolveCoreRuntimeRoot();
+    if (!coreRoot) return "";
+    const result = captureCoreJsonSync(
+      "agentlas_cloud",
+      [
+        "context", "slice",
+        "--project", projectPath,
+        "--task-stdin",
+        "--render",
+      ],
+      {
+        cwd: projectPath,
+        input: String(task).slice(0, 12_000),
+        timeout: 4_000,
+      },
+      coreRoot,
+    );
+    return result
+      && result.schemaVersion === "agentlas.context-slice.v1"
+      && typeof result.rendered === "string"
+      ? result.rendered.trim()
+      : "";
+  } catch {
+    return "";
+  }
+}
+
+function cliProjectContextCommand(projectPath, args) {
+  const coreRoot = resolveCoreRuntimeRoot();
+  const child = spawnCoreModule(
+    "agentlas_cloud",
+    ["context", ...args],
+    { cwd: projectPath, stdio: "inherit" },
+    coreRoot,
+  );
+  if (!child) {
+    process.stderr.write("Agentlas Context Map requires the installed Agentlas Core runtime and Python 3.9+.\n");
+    process.exitCode = 1;
+    return Promise.resolve(1);
+  }
+  return new Promise((resolve) => {
+    child.on("error", (error) => {
+      process.stderr.write(`Agentlas Context Map failed: ${error.message}\n`);
+      process.exitCode = 1;
+      resolve(1);
+    });
+    child.on("close", (code) => {
+      const status = code == null ? 1 : code;
+      if (status !== 0) process.exitCode = status;
+      resolve(status);
+    });
+  });
+}
+
+function cliMemoryContext(db, projectPath, agentId = null, task = "") {
   const sections = [];
   const arch = loadArch();
   ensureMemoryContextColumn(db);
@@ -8347,6 +8410,8 @@ function cliMemoryContext(db, projectPath, agentId = null) {
         if (s.trim()) sections.push(`### Project memory (${projectPath})\n${s.trim()}`);
       }
     } catch { /* ignore */ }
+    const contextSlice = cliProjectContextSlice(projectPath, task);
+    if (contextSlice) sections.push(contextSlice);
   }
   if (tableExists(db, "memory_entries")) {
     try {
@@ -8514,7 +8579,7 @@ function augmentSystem(db, baseSystem, ctx, withEmitter, request = "") {
   sys = langDirective(lang) + (sys ? "\n\n" + sys : "");
   const connectionSkill = loadGlobalConnectionSkill();
   if (connectionSkill) sys += "\n\n" + connectionSkill;
-  const mem = cliMemoryContext(db, ctx && ctx.projectPath, ctx && ctx.agentId);
+  const mem = cliMemoryContext(db, ctx && ctx.projectPath, ctx && ctx.agentId, request);
   if (mem) sys += "\n\n" + mem;
   if (withEmitter) {
     sys += "\n\n" + memoryEmitterPromptFor(request, arch, ctx && ctx.turnId, ctx && ctx.permission);
@@ -9803,7 +9868,7 @@ function buildHelpers(db) {
     autoRouteNote: (choice, lang) => autoRouteNote(choice, lang),
     autoRoutePreamble: (choice, lang) => autoRoutePreamble(choice, lang),
     directSystemPrompt: (lang) => directSystemPrompt(lang),
-    cliMemoryContext: (db_, pp, agentId) => cliMemoryContext(db_, pp, agentId),
+    cliMemoryContext: (db_, pp, agentId, task) => cliMemoryContext(db_, pp, agentId, task),
     importLocal: (db_, p) => importLocalFolderCli(db_, p),
     // REPL-safe public Hub install: fail()(process.exit) 대신 Error를 throw 해 REPL이 직접 렌더하게 한다.
     cloudInstall: async (db_, slug) => {
@@ -10285,6 +10350,7 @@ function workforce() {
       fetchHub: (url, init) => fetchHubCli(url, init),
       listWorkforceTools: listWorkforceToolsCli,
       supportsWorkforceToolAuthority: async () => false,
+      projectContextSlice: cliProjectContextSlice,
       prefsLang,
       out,
     });
@@ -11949,6 +12015,7 @@ function cmdHelp() {
       "  research <sub>           Research Engine: status|gather|search|read|plan",
       "  career-graph <sub>       source routing index: status|list|add",
       "  ontology <sub>           project knowledge: status|list|add   (REPL: /ontology)",
+      "  context <sub>            project map: refresh|locate|refs|slice|impact|verify",
       "  journal <sub>            Stormbreaker run journal: status|verify|repair|gate",
       "",
       hdr("ACCOUNT & OPS"),
@@ -12063,6 +12130,17 @@ async function main() {
     case "memory":
       // Phase 1b: 기존 마크다운 메모리 → 공유 agentlas.sqlite 이관(dry-run 기본, --apply).
       return require("./agentlas-memory-import.cjs").cmdMemory({ db, args: rest.slice(1), out, fail });
+    case "context": {
+      if (!rest[1]) return fail("usage: agentlas context refresh|locate|refs|slice|impact|verify [options]");
+      const cwd = projectCwd();
+      ensureTerminalProjectForExecutionCli(db, cwd, PERMISSION, "terminal-context");
+      const contextArgs = rest.slice(1);
+      const hasProject = contextArgs.includes("--project");
+      return cliProjectContextCommand(
+        cwd,
+        [...contextArgs, ...(hasProject ? [] : ["--project", cwd])],
+      );
+    }
     case "evolve":
       // Phase 2/2+: 데스크탑 트리거가 만든 성장 제안 검토·적용·되돌리기(공유 DB).
       return require("./agentlas-evolution.cjs").cmdEvolve({ db, args: rest.slice(1), out, fail, agentFolder });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlas",
-  "version": "0.9.8",
+  "version": "0.9.10",
   "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"