@portel/photon 1.27.0 → 1.28.0

package/README.md

@@ -452,6 +452,39 @@ photon test                       # Run tests
 photon ps                         # Observe & control scheduled jobs, webhooks, sessions
 ```
 
+### `photon ps`: scheduled jobs, webhooks, and sessions
+
+`photon ps` is the operator surface for the daemon. Without arguments
+it prints a four-section snapshot — ACTIVE schedules, DECLARED-but-
+not-enrolled, WEBHOOKS, and ACTIVE SESSIONS.
+
+```bash
+photon ps                          # full snapshot
+photon ps --json                   # structured output for scripts
+photon ps --type active            # one section only
+photon ps --base ~/Projects/kith   # filter to one PHOTON_DIR
+```
+
+**Two-step model.** A `@scheduled` annotation in source is **DECLARED**
+until enrolled. Enrollment is per-machine, persistent, and explicit:
+
+```bash
+photon ps enable  newsletter:sendDigest    # DECLARED → ACTIVE
+photon ps disable newsletter:sendDigest    # ACTIVE → suppressed (survives restart)
+photon ps pause   newsletter:sendDigest    # stop firing without removing enrollment
+photon ps resume  newsletter:sendDigest    # undo pause
+photon ps history newsletter:sendDigest    # last 20 firings: timestamp, status, error
+```
+
+For manual cron schedules without a `@scheduled` tag, use the Beam Pulse
+panel ("Add schedule") or call `this.schedule.create()` from photon code.
+
+`this.schedule.create()` (programmatic schedules) skips DECLARED and
+goes straight to ACTIVE. See
+[`docs/GUIDE.md#scheduling`](docs/GUIDE.md#scheduling-scheduled-thisschedule-photon-ps)
+for the full reference, the daemon state layout, and `.photon-no-host`
+for multi-host setups.
+
 ### Install from GitHub
 
 Use qualified refs to install and run photons directly from any GitHub repository:

package/dist/cli/commands/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsF5D"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqF5D"}

package/dist/cli/commands/update.js

@@ -20,19 +20,18 @@ export function registerUpdateCommand(program) {
         try {
             const { printInfo, printSuccess, printWarning, printHeader, printError } = await import('../../cli-formatter.js');
             const { execSync } = await import('child_process');
-            // 1. Check latest version
+            const { fetchLatestVersion } = await import('../../shared/npm-registry.js');
+            // 1. Check latest version. Hits registry.npmjs.org over HTTPS
+            // directly — shelling out to `npm view` failed under launchd PATH
+            // and reported the failure as "registry unreachable" (Bug 3, v1.27.0).
             let latestVersion = null;
             try {
                 latestVersion = await runTask('Checking for updates', async () => {
-                    return execSync('npm view @portel/photon version', {
-                        encoding: 'utf-8',
-                        timeout: 10000,
-                        stdio: ['pipe', 'pipe', 'pipe'],
-                    }).trim();
+                    return await fetchLatestVersion('@portel/photon');
                 });
             }
-            catch {
-                printError('Could not reach npm registry');
+            catch (err) {
+                printError(`Could not check npm registry: ${getErrorMessage(err)}`);
                 process.exit(1);
             }
             if (!latestVersion) {

package/dist/cli/commands/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"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"}

package/dist/daemon/server.js

@@ -3083,8 +3083,34 @@ async function handleRequest(request, socket) {
             workingDir: j.workingDir ?? defaultBase,
             createdBy: j.createdBy,
         }));
+        // Resolve declared->active equivalence by (photon, method, cron, base).
+        // The exact-key lookup `scheduledJobs.has(declaredKey(...))` only catches
+        // a declaration that was enrolled via `photon ps enable` — it misses
+        // the case where a photon ships BOTH `@scheduled` AND a legacy
+        // `enable_schedule` that calls `this.schedule.create()`. The legacy
+        // path keys jobs as `<photon>:sched:<uuid>`, so the declaration shows
+        // up as DECLARED-not-enrolled even though an equivalent timer is
+        // actively firing (Bug 5 in v1.27.0). Compare on the underlying
+        // identity tuple so the CLI can suppress the cosmetic duplicate.
         const declared = Array.from(declaredSchedules.values()).map((d) => {
             const k = declaredKey(d.photon, d.method, d.workingDir);
+            const declBase = d.workingDir ? path.resolve(d.workingDir) : defaultBase;
+            let isActive = scheduledJobs.has(k);
+            if (!isActive) {
+                for (const job of scheduledJobs.values()) {
+                    if (job.photonName !== d.photon)
+                        continue;
+                    if (job.method !== d.method)
+                        continue;
+                    if (job.cron !== d.cron)
+                        continue;
+                    const jobBase = job.workingDir ? path.resolve(job.workingDir) : defaultBase;
+                    if (jobBase !== declBase)
+                        continue;
+                    isActive = true;
+                    break;
+                }
+            }
             return {
                 key: k,
                 photon: d.photon,
@@ -3092,7 +3118,7 @@ async function handleRequest(request, socket) {
                 cron: d.cron,
                 photonPath: d.photonPath,
                 workingDir: d.workingDir ?? defaultBase,
-                active: scheduledJobs.has(k),
+                active: isActive,
             };
         });
         const webhooks = [];