@sellable/install 0.1.589 → 0.1.590-wip.phase187.20260811.3

package/lib/sellable-agent/fly-admin-image/admin-runtime.mjs

@@ -67,6 +67,7 @@ import {
   HERMES_SNAPSHOT_HOOKS,
   HERMES_SNAPSHOT_HOOK_ALLOWLIST_BYTES,
   applyHermesHostedBackgroundReviewPolicy,
+  ensureHermesOpportunitySequencesCron,
   ensureHermesSnapshotCron,
   markHermesSnapshotDirty,
   mergeHermesState,
@@ -696,6 +697,10 @@ const ADMIN_LIVE_SKILLS_CONFIG_KEYS = Object.freeze([
   "disabled",
   "platform_disabled",
 ]);
+const ADMIN_SEALED_SKILL_DIRECTORIES = new Set([
+  "sellable",
+  "opportunity-sequences",
+]);
 
 function adminPreservedSkillsIdentity(profileRoot) {
   if (!existsSync(profileRoot)) return null;
@@ -704,7 +709,7 @@ function adminPreservedSkillsIdentity(profileRoot) {
   const walk = (directory, relativePath = "") => {
     for (const name of readdirSync(directory).sort()) {
       const nextRelative = relativePath ? `${relativePath}/${name}` : name;
-      if (nextRelative === "sellable") continue;
+      if (ADMIN_SEALED_SKILL_DIRECTORIES.has(nextRelative)) continue;
       const path = join(directory, name);
       const stat = lstatSync(path);
       if (stat.isSymbolicLink()) {
@@ -961,12 +966,22 @@ async function materializeAdminProfile({
     hermesCli: HERMES,
   });
   if (!memoryCron.ok) throw new Error(memoryCron.code);
+  const opportunitySequencesCron = await ensureHermesOpportunitySequencesCron({
+    profileId: profile,
+    profileRoot: profileHome,
+    hermesRoot: DATA_ROOT,
+    statePath: layout.statePath,
+  });
+  if (!opportunitySequencesCron.ok) {
+    throw new Error(opportunitySequencesCron.code);
+  }
   return {
     stage,
     promotion: promoted.promotion,
     profile,
     profileHome,
     adminHome,
+    opportunitySequencesCron,
     observedSoulRawSha256: promoted.observedSoulRawSha256,
     servers: [serverProofs.sellable, serverProofs["sellable-admin"]].map(
       ({ tools: _tools, ...proof }) => proof

package/lib/sellable-agent/hermes-memory-snapshot.mjs

@@ -55,9 +55,20 @@ export const HERMES_SNAPSHOT_CRON = Object.freeze({
   installedScript: "scripts/hermes-memory-reconcile.sh",
   noAgent: true,
 });
+export const HERMES_OPPORTUNITY_SEQUENCES_CRON = Object.freeze({
+  name: "sellable-opportunity-sequences",
+  schedule: "every 30m",
+  deliver: "slack",
+  skills: Object.freeze(["opportunity-sequences"]),
+  enabledToolsets: Object.freeze(["safe", "sellable", "mcp"]),
+  noAgent: false,
+});
+export const HERMES_OPPORTUNITY_SEQUENCES_JOURNAL_ROOT =
+  "/opt/data/.sellable-agent/admin-runtime/opportunity-sequences";
 const LEGACY_HERMES_SNAPSHOT_SCRIPT = "scripts/hermes-memory-reconcile.sh";
 
 const HERMES = "/opt/hermes/.venv/bin/hermes";
+const HERMES_PYTHON = "/opt/hermes/.venv/bin/python";
 const VERSION = "0.20.0";
 const ID = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;
 const SHA256 = /^[a-f0-9]{64}$/;
@@ -259,6 +270,68 @@ function cronJobs(profileRoot) {
   return jobs;
 }
 
+const sameJson = (left, right) =>
+  JSON.stringify(left) === JSON.stringify(right);
+
+export async function ensureHermesNamedCron({
+  profileRoot,
+  name,
+  isExpected,
+  isUpdatable = () => true,
+  create,
+  update,
+  codePrefix = "hermes_named_cron",
+}) {
+  if (
+    !isAbsolute(profileRoot) ||
+    !ID.test(name ?? "") ||
+    typeof isExpected !== "function" ||
+    typeof create !== "function" ||
+    typeof update !== "function"
+  ) {
+    return failed(`${codePrefix}_identity_rejected`);
+  }
+  try {
+    const before = cronJobs(profileRoot);
+    const named = before.filter((job) => job?.name === name);
+    if (named.length > 1 || (named[0] && !isUpdatable(named[0]))) {
+      return failed(`${codePrefix}_inventory_rejected`);
+    }
+    if (named[0] && isExpected(named[0])) {
+      return {
+        ok: true,
+        status: "REUSED",
+        jobId: named[0].id,
+        job: named[0],
+      };
+    }
+    const siblings = before.filter((job) => job?.name !== name);
+    const mutation = named[0] ? await update(named[0]) : await create();
+    if (childFailed(mutation)) {
+      return failed(`${codePrefix}_${named[0] ? "update" : "create"}_failed`);
+    }
+    const after = cronJobs(profileRoot);
+    const readback = after.filter((job) => job?.name === name);
+    const afterSiblings = after.filter((job) => job?.name !== name);
+    if (!sameJson(afterSiblings, siblings)) {
+      return failed(`${codePrefix}_sibling_readback_rejected`);
+    }
+    if (readback.length !== 1 || !isExpected(readback[0])) {
+      return failed(
+        `${codePrefix}_${named[0] ? "update_readback" : "readback"}_rejected`
+      );
+    }
+    return {
+      ok: true,
+      status: named[0] ? "UPDATED" : "CREATED",
+      jobId: readback[0].id,
+      job: readback[0],
+    };
+  } catch {
+    return failed(`${codePrefix}_install_failed`);
+  }
+}
+
 function isCron(job) {
   return Boolean(
     job?.id &&
@@ -430,25 +503,23 @@ export async function ensureHermesSnapshotCron({
       readFileSync(reconcileTemplatePath),
       0o700
     );
-    const before = cronJobs(profileRoot).filter(
-      (job) => job?.name === HERMES_SNAPSHOT_CRON.name
-    );
-    if (
-      before.length > 1 ||
-      (before[0] && !isCron(before[0]) && !isLegacyCron(before[0]))
-    ) {
-      return failed("hermes_snapshot_cron_inventory_rejected");
-    }
-    if (before[0]) {
-      if (isLegacyCron(before[0])) {
-        const migrated = await childRunner(runChild)(
+    const result = await ensureHermesNamedCron({
+      profileRoot,
+      name: HERMES_SNAPSHOT_CRON.name,
+      isExpected: isCron,
+      isUpdatable: (job) => isCron(job) || isLegacyCron(job),
+      codePrefix: "hermes_snapshot_cron",
+      create: () =>
+        childRunner(runChild)(
           invocation(
             [
               "--profile",
               profileId,
               "cron",
-              "edit",
-              before[0].id,
+              "create",
+              HERMES_SNAPSHOT_CRON.schedule,
+              "--name",
+              HERMES_SNAPSHOT_CRON.name,
               "--script",
               HERMES_SNAPSHOT_CRON.script,
               "--no-agent",
@@ -456,53 +527,211 @@ export async function ensureHermesSnapshotCron({
             hermesRoot,
             hermesCli
           )
-        );
-        if (childFailed(migrated)) {
-          return failed("hermes_snapshot_cron_migrate_failed");
-        }
-        const afterMigration = cronJobs(profileRoot).filter(
-          (job) => job?.name === HERMES_SNAPSHOT_CRON.name
-        );
-        return afterMigration.length === 1 && isCron(afterMigration[0])
-          ? {
-              ok: true,
-              status: "MIGRATED",
-              jobId: afterMigration[0].id,
+        ),
+      update: (job) =>
+        childRunner(runChild)(
+          invocation(
+            [
+              "--profile",
               profileId,
-            }
-          : failed("hermes_snapshot_cron_migrate_readback_rejected");
+              "cron",
+              "edit",
+              job.id,
+              "--script",
+              HERMES_SNAPSHOT_CRON.script,
+              "--no-agent",
+            ],
+            hermesRoot,
+            hermesCli
+          )
+        ),
+    });
+    if (!result.ok) {
+      if (result.code === "hermes_snapshot_cron_update_failed") {
+        return failed("hermes_snapshot_cron_migrate_failed");
+      }
+      if (result.code === "hermes_snapshot_cron_update_readback_rejected") {
+        return failed("hermes_snapshot_cron_migrate_readback_rejected");
       }
-      return { ok: true, status: "REUSED", jobId: before[0].id, profileId };
+      return result;
     }
-    const result = await childRunner(runChild)(
-      invocation(
-        [
-          "--profile",
-          profileId,
-          "cron",
-          "create",
-          HERMES_SNAPSHOT_CRON.schedule,
-          "--name",
-          HERMES_SNAPSHOT_CRON.name,
-          "--script",
-          HERMES_SNAPSHOT_CRON.script,
-          "--no-agent",
+    return {
+      ok: true,
+      status: result.status === "UPDATED" ? "MIGRATED" : result.status,
+      jobId: result.jobId,
+      profileId,
+    };
+  } catch {
+    return failed("hermes_snapshot_cron_install_failed");
+  }
+}
+
+const OPPORTUNITY_SEQUENCE_ASSETS = Object.freeze([
+  "SKILL.md",
+  "references/outbound-multichannel-v1.md",
+  "references/positive-reply-to-agreed-meeting-v1.md",
+]);
+const SLACK_USER_ID = /^U[A-Z0-9]{8,20}$/;
+const OPPORTUNITY_SEQUENCE_CRON_PYTHON = [
+  "import json,sys",
+  "from cron.jobs import create_job, update_job",
+  "value=json.loads(sys.argv[1])",
+  "job_id=value.pop('jobId', None)",
+  "enabled=value.pop('enabled')",
+  "result=update_job(job_id, {**value, 'enabled': enabled}) if job_id else create_job(**value)",
+  "print(json.dumps({'id': result.get('id') if result else None}))",
+].join("\n");
+
+function opportunitySequenceIdentity(profileRoot) {
+  const root = join(profileRoot, "skills", "opportunity-sequences");
+  return Object.fromEntries(
+    OPPORTUNITY_SEQUENCE_ASSETS.map((relative) => {
+      const path = join(root, relative);
+      regularFile(path);
+      return [relative, sha256(readFileSync(path))];
+    })
+  );
+}
+
+function opportunitySequencePrompt({
+  notificationSlackUserId,
+  journalRoot,
+  hashes,
+}) {
+  return [
+    "Run the installed opportunity-sequences skill for one bounded page.",
+    `Use the private journal at ${journalRoot}.`,
+    `Require these installed asset hashes: ${JSON.stringify(hashes)}.`,
+    `End with a compact native Slack summary addressed to <@${notificationSlackUserId}>.`,
+    "Never send prospect outreach; never claim exactly-once delivery; never use a direct Slack or Lightfield transport outside the installed skill and Product MCP.",
+  ].join(" ");
+}
+
+export async function ensureHermesOpportunitySequencesCron({
+  profileId,
+  profileRoot,
+  hermesRoot,
+  statePath,
+  journalRoot = HERMES_OPPORTUNITY_SEQUENCES_JOURNAL_ROOT,
+  hermesPython = HERMES_PYTHON,
+  runChild,
+}) {
+  if (
+    !validProfilePath(profileId, profileRoot, hermesRoot) ||
+    !existsSync(profileRoot) ||
+    !isAbsolute(statePath) ||
+    !isAbsolute(journalRoot)
+  ) {
+    return failed("hermes_opportunity_sequences_cron_identity_rejected");
+  }
+  try {
+    const stateStat = regularFile(statePath);
+    if ((stateStat.mode & 0o077) !== 0) {
+      return failed("hermes_opportunity_sequences_cron_state_mode_rejected");
+    }
+    const state = JSON.parse(readFileSync(statePath, "utf8"));
+    const notificationSlackUserId =
+      state?.opportunitySequences?.notificationSlackUserId;
+    if (!SLACK_USER_ID.test(notificationSlackUserId ?? "")) {
+      return failed("hermes_opportunity_sequences_cron_notification_rejected");
+    }
+    mkdirSync(journalRoot, { recursive: true, mode: 0o700 });
+    chmodSync(journalRoot, 0o700);
+    const journalStat = lstatSync(journalRoot);
+    if (
+      journalStat.isSymbolicLink() ||
+      !journalStat.isDirectory() ||
+      (journalStat.mode & 0o077) !== 0
+    ) {
+      return failed("hermes_opportunity_sequences_cron_journal_rejected");
+    }
+    const hashes = opportunitySequenceIdentity(profileRoot);
+    const prompt = opportunitySequencePrompt({
+      notificationSlackUserId,
+      journalRoot,
+      hashes,
+    });
+    const expected = (job) =>
+      Boolean(
+        job?.id &&
+          job.name === HERMES_OPPORTUNITY_SEQUENCES_CRON.name &&
+          job.prompt === prompt &&
+          job.no_agent === false &&
+          job.enabled === true &&
+          job.deliver === HERMES_OPPORTUNITY_SEQUENCES_CRON.deliver &&
+          sameJson(job.skills, HERMES_OPPORTUNITY_SEQUENCES_CRON.skills) &&
+          sameJson(
+            job.enabled_toolsets,
+            HERMES_OPPORTUNITY_SEQUENCES_CRON.enabledToolsets
+          ) &&
+          job.schedule?.kind === "interval" &&
+          job.schedule?.minutes === 30
+      );
+    const mutate = (jobId = null) => {
+      const spec = {
+        prompt,
+        schedule: HERMES_OPPORTUNITY_SEQUENCES_CRON.schedule,
+        name: HERMES_OPPORTUNITY_SEQUENCES_CRON.name,
+        deliver: HERMES_OPPORTUNITY_SEQUENCES_CRON.deliver,
+        skills: [...HERMES_OPPORTUNITY_SEQUENCES_CRON.skills],
+        enabled_toolsets: [
+          ...HERMES_OPPORTUNITY_SEQUENCES_CRON.enabledToolsets,
         ],
-        hermesRoot,
-        hermesCli
-      )
-    );
-    if (childFailed(result)) {
-      return failed("hermes_snapshot_cron_create_failed");
+        no_agent: false,
+        enabled: true,
+        ...(jobId ? { jobId } : {}),
+      };
+      return childRunner(runChild)({
+        command: hermesPython,
+        args: ["-c", OPPORTUNITY_SEQUENCE_CRON_PYTHON, JSON.stringify(spec)],
+        env: {
+          ...process.env,
+          HOME: hermesRoot,
+          HERMES_HOME: profileRoot,
+          HERMES_PROFILE: profileId,
+          NO_COLOR: "1",
+        },
+        shell: false,
+        timeoutMs: NATIVE_COMMAND_TIMEOUT_MS,
+        maxOutputBytes: 64 * 1024,
+      });
+    };
+    const result = await ensureHermesNamedCron({
+      profileRoot,
+      name: HERMES_OPPORTUNITY_SEQUENCES_CRON.name,
+      isExpected: expected,
+      create: () => mutate(),
+      update: (job) => mutate(job.id),
+      codePrefix: "hermes_opportunity_sequences_cron",
+    });
+    if (!result.ok) return result;
+    const jobsMode =
+      lstatSync(join(profileRoot, "cron", "jobs.json")).mode & 0o777;
+    if ((jobsMode & 0o077) !== 0) {
+      return failed("hermes_opportunity_sequences_cron_jobs_mode_rejected");
     }
-    const after = cronJobs(profileRoot).filter(
-      (job) => job?.name === HERMES_SNAPSHOT_CRON.name
-    );
-    return after.length === 1 && isCron(after[0])
-      ? { ok: true, status: "CREATED", jobId: after[0].id, profileId }
-      : failed("hermes_snapshot_cron_readback_rejected");
+    return {
+      ok: true,
+      status: result.status,
+      jobId: result.jobId,
+      name: result.job.name,
+      prompt: result.job.prompt,
+      schedule: result.job.schedule,
+      profileId,
+      enabledToolsets: result.job.enabled_toolsets,
+      skills: result.job.skills,
+      assetHashes: hashes,
+      notificationSlackUserIdSource:
+        "config-state.json:opportunitySequences.notificationSlackUserId",
+      journalRoot,
+      modes: {
+        state: stateStat.mode & 0o777,
+        journal: journalStat.mode & 0o777,
+        jobs: jobsMode,
+      },
+    };
   } catch {
-    return failed("hermes_snapshot_cron_install_failed");
+    return failed("hermes_opportunity_sequences_cron_install_failed");
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/install",
-  "version": "0.1.589",
+  "version": "0.1.590-wip.phase187.20260811.3",
   "type": "module",
   "description": "One-command installer for Sellable MCP in Claude Code, Codex, and Hermes",
   "bin": {