@osfactory/har 1.17.0 → 1.19.0

package/dist/index.js

@@ -36568,6 +36568,29 @@ var init_control_config = __esm({
   }
 });
 
+// src/core/portal-hosts.ts
+function kernoApiUrlFor(portalUrl) {
+  const override = process.env.HAR_API_URL?.trim().replace(/\/+$/, "");
+  if (override) return override;
+  try {
+    return KERNO_API_BY_PORTAL_HOST[new URL(portalUrl).hostname];
+  } catch {
+    return void 0;
+  }
+}
+var KERNO_API_BY_PORTAL_HOST;
+var init_portal_hosts = __esm({
+  "src/core/portal-hosts.ts"() {
+    "use strict";
+    KERNO_API_BY_PORTAL_HOST = {
+      "portal.kerno.io": "https://api.kerno.io",
+      "app.harhq.com": "https://api.kerno.io",
+      "portal.dev.kerno.io": "https://api.dev.kerno.io",
+      "app.dev.harhq.com": "https://api.dev.kerno.io"
+    };
+  }
+});
+
 // src/core/commit-bindings.ts
 function bindingsDir(harnessRoot) {
   return path11.join(harnessRoot, ".har", COMMIT_BINDINGS_DIR);
@@ -44307,7 +44330,8 @@ function rewindSince(since) {
   return new Date(new Date(since).getTime() - overlap).toISOString();
 }
 function watermarkKeyForTarget(target) {
-  return target.identityKey;
+  const apiUrl = kernoApiUrlFor(target.url);
+  return apiUrl ? `${apiUrl}|${target.identityKey}` : target.identityKey;
 }
 function legacyWatermarkKeysForTarget(target) {
   return target.url === target.identityKey ? [] : [target.url];
@@ -44397,9 +44421,14 @@ async function postJson(url, body, dryRun) {
   }
   return await response.json();
 }
+function portalEndpointUrl(target, endpoint) {
+  const apiUrl = kernoApiUrlFor(target.url);
+  if (!apiUrl) return `${target.url}${endpoint}`;
+  return `${apiUrl}${KERNO_INGEST_PREFIX}${endpoint.slice(PORTAL_API_PREFIX.length)}`;
+}
 function postPortalOnce(target, endpoint, body) {
   return postForResponse(
-    `${target.url}${endpoint}`,
+    portalEndpointUrl(target, endpoint),
     {
       "Content-Type": "application/json",
       Authorization: `Bearer ${target.token}`
@@ -44411,7 +44440,7 @@ async function refreshPortalToken(target) {
   if (!target.refreshToken) return false;
   let response;
   try {
-    response = await fetch(`${target.url}/api/cli/refresh`, {
+    response = await fetch(portalEndpointUrl(target, "/api/cli/refresh"), {
       method: "POST",
       headers: { Authorization: `Bearer ${target.refreshToken}` }
     });
@@ -45167,7 +45196,7 @@ async function syncRunWithControlAsync(repoPath, run2) {
   if (!isRepoPortalSyncEnabled(canonical)) return;
   for (const portal of resolved.targets) {
     try {
-      if (!await isControlApiReachable(portal.url)) continue;
+      if (!kernoApiUrlFor(portal.url) && !await isControlApiReachable(portal.url)) continue;
       await postPortal(portal, "/api/sync", { path: canonical, runs: [run2] });
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -45176,7 +45205,7 @@ async function syncRunWithControlAsync(repoPath, run2) {
     }
   }
 }
-var path48, DEFAULT_MAX_BATCH_BYTES, DEFAULT_SYNC_OVERLAP_MS, MAX_FETCH_ATTEMPTS, SYNC_TIMEOUT_MS, EXPLICIT_SYNC_TIMEOUT_MS;
+var path48, DEFAULT_MAX_BATCH_BYTES, DEFAULT_SYNC_OVERLAP_MS, MAX_FETCH_ATTEMPTS, PORTAL_API_PREFIX, KERNO_INGEST_PREFIX, SYNC_TIMEOUT_MS, EXPLICIT_SYNC_TIMEOUT_MS;
 var init_control_sync = __esm({
   "src/core/control-sync.ts"() {
     "use strict";
@@ -45185,6 +45214,7 @@ var init_control_sync = __esm({
     init_stages();
     init_schema2();
     init_control_config();
+    init_portal_hosts();
     init_control_registry();
     init_portal_credentials();
     init_portal_targets();
@@ -45207,6 +45237,8 @@ var init_control_sync = __esm({
     DEFAULT_MAX_BATCH_BYTES = 4 * 1024 * 1024;
     DEFAULT_SYNC_OVERLAP_MS = 6e4;
     MAX_FETCH_ATTEMPTS = 3;
+    PORTAL_API_PREFIX = "/api";
+    KERNO_INGEST_PREFIX = "/api/har/ingest";
     SYNC_TIMEOUT_MS = 15e3;
     EXPLICIT_SYNC_TIMEOUT_MS = 12e4;
   }
@@ -81973,7 +82005,9 @@ function buildInstallPlan(detection, targets, options = {}) {
     agentsMd: writeAgentsMd,
     migrateLegacyAgentMd: writeAgentsMd && detection.agentMd,
     providers: targets,
-    claudeMd: targets.includes("claude"),
+    // Deprecated: Claude Code reads AGENTS.md directly, so HAR no longer
+    // creates a CLAUDE.md. An existing one is still kept pointing at AGENTS.md.
+    claudeMd: targets.includes("claude") && detection.claudeMd,
     cursorRule: wantsCursor,
     skills: options.skills ?? []
   };
@@ -81987,7 +82021,7 @@ function formatInstallPlan(plan, detection) {
     lines.push(`  ${mark(true)} Migrate ${LEGACY_AGENT_MD} \u2192 ${AGENTS_MD}, then remove legacy file`);
   }
   lines.push(
-    `  ${mark(plan.claudeMd)} Claude \u2014 ensure ${CLAUDE_MD} points at ${AGENTS_MD}`
+    plan.claudeMd ? `  ${mark(true)} Claude \u2014 keep the existing ${CLAUDE_MD} pointing at ${AGENTS_MD}` : `  ${mark(false)} Claude \u2014 reads ${AGENTS_MD} directly (no ${CLAUDE_MD} created)`
   );
   lines.push(
     `  ${mark(plan.cursorRule)} Cursor \u2014 install/refresh .cursor/rules/har-workflow.mdc`
@@ -82121,13 +82155,6 @@ ${legacyTrimmed}
   return true;
 }
 var CLAUDE_MD_IMPORT = "@AGENTS.md";
-function loadClaudeMdTemplate() {
-  const templatePath = resolveTemplateFile("CLAUDE.md.template");
-  if (!templatePath) {
-    throw new Error("CLAUDE.md.template not found. Run npm run build.");
-  }
-  return fs51.readFileSync(templatePath, "utf8");
-}
 function isHarOwnedClaudeMd(content) {
   const trimmed = content.trim();
   if (trimmed === CLAUDE_MD_IMPORT) return true;
@@ -82139,11 +82166,9 @@ function hasAgentsImport(content) {
 }
 function ensureClaudeMdPointer(repoPath, options = {}) {
   const dest = path59.join(repoPath, CLAUDE_MD);
-  const thin = loadClaudeMdTemplate();
-  if (!fs51.existsSync(dest)) {
-    writeFileSafe(dest, thin);
-    return "created";
-  }
+  if (!fs51.existsSync(dest)) return "skipped";
+  const thin = `${CLAUDE_MD_IMPORT}
+`;
   const existing = fs51.readFileSync(dest, "utf8");
   if (isHarOwnedClaudeMd(existing) || options.force) {
     if (existing.trim() === CLAUDE_MD_IMPORT) return "skipped";
@@ -82251,9 +82276,7 @@ async function handleInstructionFiles(options) {
   }
   if (plan.claudeMd) {
     claudeMdAction = ensureClaudeMdPointer(repoPath);
-    if (claudeMdAction === "created") {
-      success(`Wrote ${CLAUDE_MD} (pointer \u2192 ${AGENTS_MD})`);
-    } else if (claudeMdAction === "updated" || claudeMdAction === "appended") {
+    if (claudeMdAction === "updated" || claudeMdAction === "appended") {
       info(
         `${claudeMdAction === "updated" ? "Updated" : "Appended"} ${CLAUDE_MD} pointer \u2192 ${AGENTS_MD}`
       );
@@ -83681,13 +83704,7 @@ function buildInstructionFileNotes(repoPath) {
     notes.push({
       kind: "claude_md_pointer",
       path: "CLAUDE.md",
-      message: "Keep CLAUDE.md as the `@AGENTS.md` import \u2014 no workflow content of its own. Existing project-specific notes stay; the import goes on top."
-    });
-  } else {
-    notes.push({
-      kind: "claude_md_pointer",
-      path: "CLAUDE.md",
-      message: "Optional: add a CLAUDE.md containing `@AGENTS.md` when Claude Code is used on this repo."
+      message: "Keep CLAUDE.md as the `@AGENTS.md` import \u2014 no workflow content of its own. Existing project-specific notes stay; the import goes on top. It is optional now that Claude Code reads AGENTS.md directly."
     });
   }
   return notes;

package/dist/templates/adaptation-prompt-init.md

@@ -202,7 +202,7 @@ Launch creates an isolated session worktree at `~/worktrees/<base>-<sha4>-har-ag
 
 Coding agents discover the harness through two files:
 
-1. **`AGENTS.md`** (repo root) — shared agent instructions (Codex auto-loads this; Claude via `CLAUDE.md` pointer)
+1. **`AGENTS.md`** (repo root) — shared agent instructions (Codex and Claude Code both auto-load this)
 2. **`.har/README.md`** — full index of what's in the harness
 
 Do **not** create `AGENT.md` (singular) — that legacy name is obsolete. If `AGENT.md` exists, merge any unique notes into `AGENTS.md` and delete `AGENT.md`.
@@ -219,14 +219,14 @@ If **no `AGENTS.md` exists**, create one at the repo root using this structure:
 
 If **`AGENTS.md` already exists** (project-owned), add or update a concise **HAR / agent environment** section — do not replace unrelated content.
 
-Keep **`CLAUDE.md`** as the line `@AGENTS.md` (Claude Code auto-loads `CLAUDE.md` and follows the import). Never paste the harness workflow into it — `AGENTS.md` is the single instruction file.
+Do **not** create a `CLAUDE.md` — Claude Code reads `AGENTS.md` directly. If one already exists, keep it as the line `@AGENTS.md` and never paste the harness workflow into it — `AGENTS.md` is the single instruction file.
 
 ### Monorepos / multiple harnesses
 
 If this repository contains **more than one project or `.har` harness** (check for `.har/` directories above or below this one):
 
 - Maintain a **"Harnesses in this repo"** table in the ROOT `AGENTS.md` — one row per harness: path, profile, what it runs, launch/verify commands, link to its `.har/README.md`. Lead with "pick the harness that owns the files you are changing."
-- Keep a small `AGENTS.md` (and `CLAUDE.md` pointer) **inside each project directory** for local discovery, with a back-link to the root index.
+- Keep a small `AGENTS.md` **inside each project directory** for local discovery, with a back-link to the root index.
 - Keep ONE Cursor rule at the repo root (`.cursor/rules/har-workflow.mdc`) listing all harnesses — not one rule per project.
 
 Include a **Run history** subsection:

package/dist/templates/adaptation-prompt-maintain.md

@@ -90,7 +90,7 @@ come back here afterwards. Two standing rules:
 
 - Verification customization lives in `stages.json` / `.har/stages/` — the
   top-level `*.sh` files are generated shims, safe to regenerate.
-- Repo-root agent docs (`AGENTS.md`, `CLAUDE.md`) follow Step 3 below.
+- Repo-root agent docs (`AGENTS.md`) follow Step 3 below.
 
 ## Step 3 — Refresh repo-root `AGENTS.md`
 
@@ -105,7 +105,7 @@ If harness commands, rules, or workflow changed, update the **HAR / agent enviro
 
 If `AGENTS.md` does not mention HAR yet, add a concise section. If it already has a HAR section, update it minimally — do not replace unrelated content.
 
-Do **not** create `AGENT.md` (singular). If legacy `AGENT.md` exists, merge unique notes into `AGENTS.md` and delete `AGENT.md`. Keep `CLAUDE.md` as the line `@AGENTS.md`.
+Do **not** create `AGENT.md` (singular). If legacy `AGENT.md` exists, merge unique notes into `AGENTS.md` and delete `AGENT.md`. Do not create a `CLAUDE.md`; if one exists, keep it as the line `@AGENTS.md`.
 
 ## Rules
 

package/dist/templates/agent-skills/setup-har.md

@@ -79,7 +79,7 @@ Fix the harness scripts until both pass. Then tear down or keep the slot as the
 After the user confirms, commit the harness:
 
 ```bash
-git add .har/ AGENTS.md CLAUDE.md .claude/ .cursor/ 2>/dev/null || git add .har/ AGENTS.md
+git add .har/ AGENTS.md .claude/ .cursor/ 2>/dev/null || git add .har/ AGENTS.md
 git commit -m "chore: add har agent harness"
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "1.17.0",
+  "version": "1.19.0",
   "description": "HAR: open agent harness CLI and MCP server for coding agents, isolated worktrees, and software-factory workflows",
   "keywords": [
     "har",

package/dist/templates/CLAUDE.md.template

@@ -1 +0,0 @@
-@AGENTS.md