@kody-ade/kody-engine 0.4.204-next.3 → 0.4.204-next.5

package/dist/bin/kody.js

@@ -1483,7 +1483,7 @@ var init_loadCoverageRules = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.204-next.3",
+  version: "0.4.204-next.5",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -4023,6 +4023,7 @@ var VALID_PHASES = /* @__PURE__ */ new Set(["research", "planning", "implementin
 var KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
   "name",
   "staff",
+  "every",
   "describe",
   "role",
   "kind",
@@ -4104,6 +4105,8 @@ function loadProfile(profilePath) {
     describe: typeof r.describe === "string" ? r.describe : "",
     // Optional persona to run as. Empty/blank string → undefined (no persona).
     staff: typeof r.staff === "string" && r.staff.trim() ? r.staff.trim() : void 0,
+    // Optional recurrence cadence (scheduled duty). Blank → undefined (on-demand).
+    every: typeof r.every === "string" && r.every.trim() ? r.every.trim() : void 0,
     role,
     kind,
     schedule: typeof r.schedule === "string" ? r.schedule : void 0,
@@ -8497,6 +8500,55 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
 `);
     const results = [];
     const now = Date.now();
+    const scheduledDuties = listFolderDutySlugs(path29.join(ctx.cwd, jobsDir)).map((slug) => {
+      try {
+        const p = loadProfile(path29.join(ctx.cwd, jobsDir, slug, "profile.json"));
+        return { slug, every: p.every, staff: p.staff };
+      } catch (err) {
+        process.stderr.write(`[jobs] \u23ED  skip folder-duty ${slug}: profile load failed: ${String(err)}
+`);
+        return null;
+      }
+    }).filter((d) => d !== null && Boolean(d.every));
+    process.stdout.write(`[jobs] ${scheduledDuties.length} scheduled folder-dut(y/ies) to consider
+`);
+    for (const { slug, every, staff } of scheduledDuties) {
+      if (!staff || staff.trim().length === 0) {
+        process.stderr.write(`[jobs] \u23ED  skip ${slug}: scheduled duty has no staff
+`);
+        results.push({ slug, exitCode: 0, skipped: true, reason: "no staff assigned" });
+        continue;
+      }
+      const decision = await decideShouldFire(every, slug, backend, now);
+      if (decision.skip) {
+        process.stdout.write(`[jobs] \u23ED  skip ${slug}: ${decision.reason}
+`);
+        results.push({ slug, exitCode: 0, skipped: true, reason: decision.reason });
+        continue;
+      }
+      await stampFired(backend, slug, now);
+      process.stdout.write(`[jobs] \u2192 run scheduled duty ${slug} (one-shot, as ${staff})
+`);
+      try {
+        const out = await runExecutable(slug, {
+          cliArgs: {},
+          cwd: ctx.cwd,
+          config: ctx.config,
+          verbose: ctx.verbose,
+          quiet: ctx.quiet
+        });
+        results.push({ slug, exitCode: out.exitCode, reason: out.reason });
+        if (out.exitCode !== 0) {
+          process.stderr.write(`[jobs] scheduled duty ${slug} failed (exit ${out.exitCode}): ${out.reason ?? ""}
+`);
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[jobs] scheduled duty ${slug} crashed: ${msg}
+`);
+        results.push({ slug, exitCode: 99, reason: msg });
+      }
+    }
     for (const slug of slugs) {
       const frontmatter = readJobFrontmatter(ctx.cwd, jobsDir, slug);
       if (frontmatter.disabled === true) {
@@ -8613,6 +8665,26 @@ function listJobSlugs(absDir) {
   }
   return entries.filter((e) => e.isFile() && e.name.endsWith(".md")).map((e) => e.name.replace(/\.md$/, "")).filter((slug) => slug.length > 0 && !slug.startsWith("_") && !slug.startsWith(".")).sort();
 }
+function listFolderDutySlugs(absDir) {
+  if (!fs32.existsSync(absDir)) return [];
+  let entries;
+  try {
+    entries = fs32.readdirSync(absDir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  return entries.filter((e) => e.isDirectory() && !e.name.startsWith("_") && !e.name.startsWith(".")).filter((e) => fs32.existsSync(path29.join(absDir, e.name, "profile.json"))).map((e) => e.name).sort();
+}
+async function stampFired(backend, slug, now) {
+  try {
+    const loaded = await backend.load(slug);
+    const nextData = { ...loaded.state.data ?? {}, lastFiredAt: new Date(now).toISOString() };
+    await backend.save(loaded, { ...loaded.state, data: nextData });
+  } catch (err) {
+    process.stderr.write(`[jobs] failed to stamp lastFiredAt for ${slug}: ${String(err)}
+`);
+  }
+}
 
 // src/scripts/dispatchJobTicks.ts
 init_issue();

package/dist/executables/types.ts

@@ -49,6 +49,14 @@ export interface Profile {
    * `schedule:`). Scheduled profiles must declare a `schedule` cron string.
    */
   kind: "oneshot" | "scheduled"
+  /**
+   * Recurrence cadence for a duty that runs on a timer (unified successor to a
+   * markdown duty's `every:` frontmatter). One of the ScheduleEvery values
+   * ("15m".."7d" | "manual"). Present → the duty-scheduler fires a one-shot run
+   * when due (no target). Absent → on-demand only (runs against an issue/PR).
+   * This is what makes "scheduled" just a field on the one duty shape.
+   */
+  every?: string
   /** Cron expression for scheduled profiles (e.g. "0 8 * * MON"). */
   schedule?: string
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.204-next.3",
+  "version": "0.4.204-next.5",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",