@wildorder/nightshift 0.12.0 → 0.13.0

package/dist/skill-roots.js

@@ -1,6 +1,6 @@
 import { access } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join, resolve } from "node:path";
+import { isAbsolute, join, resolve } from "node:path";
 const SPECS = [
     {
         target: "claude",
@@ -62,6 +62,38 @@ const SPECS = [
             { kind: "skill", scope: "user", root: join(configHome, "workspace", "skills") },
         ],
     },
+    {
+        target: "zed",
+        label: "Zed",
+        // Zed discovers skills from the same cross-tool .agents directory as
+        // Codex, not from its own config directory.
+        userSkills: (_configHome, home) => join(home, ".agents", "skills"),
+        projectSkills: join(".agents", "skills"),
+        // No extraScan: cursor's extraScan already watches .agents/skills at
+        // both scopes for shadowing definitions.
+        configDir: ({ home, env, platform }) => {
+            if (platform === "win32") {
+                const appData = env.APPDATA?.trim();
+                // No documented fallback path; a guess would silently install into
+                // a directory Zed never reads. Report "not detected" instead.
+                return appData ? join(appData, "Zed") : undefined;
+            }
+            if (platform === "darwin") {
+                // Zed's macOS build does not honor XDG_CONFIG_HOME — unlike its
+                // Linux build, this path is fixed.
+                return join(home, ".config", "zed");
+            }
+            // Linux (and other POSIX platforms): Zed reads $XDG_CONFIG_HOME/zed,
+            // falling back to ~/.config/zed. Honor XDG_CONFIG_HOME only when
+            // absolute — the XDG spec says a relative value is ignored, and
+            // resolving it against cwd would silently pick a directory Zed never
+            // reads.
+            const xdg = env.XDG_CONFIG_HOME?.trim();
+            return xdg && isAbsolute(xdg)
+                ? join(xdg, "zed")
+                : join(home, ".config", "zed");
+        },
+    },
 ];
 export const ALL_TARGETS = SPECS.map((spec) => spec.target);
 export const DEFAULT_TARGETS = ALL_TARGETS.join(",");
@@ -106,9 +138,21 @@ export function parseRootOverrides(entries) {
     }
     return overrides;
 }
-function configHomeFor(spec, home, env) {
+/**
+ * The config home before any `homeEnv` relocation is applied — the one
+ * place the string-vs-function `configDir` branch lives, shared by both
+ * call sites that need it.
+ */
+function baseConfigHome(spec, home, env, platform) {
+    return typeof spec.configDir === "function"
+        ? spec.configDir({ home, env, platform })
+        : join(home, spec.configDir);
+}
+function configHomeFor(spec, home, env, platform) {
     const override = spec.homeEnv ? env[spec.homeEnv]?.trim() : undefined;
-    return override ? resolve(override) : join(home, spec.configDir);
+    return override
+        ? resolve(override)
+        : baseConfigHome(spec, home, env, platform);
 }
 /**
  * Resolve every target's roots and report which tools are actually present.
@@ -118,8 +162,9 @@ function configHomeFor(spec, home, env) {
 export async function detectTargets(context = {}) {
     const env = context.env ?? process.env;
     const home = resolve(context.home ?? homedir());
+    const platform = context.platform ?? process.platform;
     return Promise.all(SPECS.map(async (spec) => {
-        const configHome = configHomeFor(spec, home, env);
+        const configHome = configHomeFor(spec, home, env, platform);
         const flag = context.roots?.[spec.target];
         const envOverride = env[overrideEnvName(spec.target)]?.trim();
         let userRoot;
@@ -133,10 +178,10 @@ export async function detectTargets(context = {}) {
             source = "env";
         }
         else {
-            userRoot = spec.userSkills(configHome, home);
+            userRoot = spec.userSkills(configHome ?? "", home);
             // The tool's own home variable only counts as the source when it
             // actually moved the skills root; for Codex it moves detection only.
-            const fromDefaultHome = spec.userSkills(join(home, spec.configDir), home);
+            const fromDefaultHome = spec.userSkills(baseConfigHome(spec, home, env, platform) ?? "", home);
             source = userRoot === fromDefaultHome ? "default" : "env";
         }
         return {
@@ -145,7 +190,7 @@ export async function detectTargets(context = {}) {
             userRoot,
             projectRoot: spec.projectSkills,
             configHome,
-            detected: await pathExists(configHome),
+            detected: configHome !== undefined && (await pathExists(configHome)),
             source,
         };
     }));
@@ -168,11 +213,13 @@ export function scanRoots(detected, projectRoot, home) {
             scope: "project",
             root: join(projectRoot, entry.projectRoot),
         }, { target: spec.target, kind: "skill", scope: "user", root: entry.userRoot });
-        for (const extra of spec.extraScan?.({
-            home,
-            projectRoot,
-            configHome: entry.configHome,
-        }) ?? []) {
+        for (const extra of entry.configHome !== undefined
+            ? (spec.extraScan?.({
+                home,
+                projectRoot,
+                configHome: entry.configHome,
+            }) ?? [])
+            : []) {
             roots.push({ target: spec.target, ...extra });
         }
     }

package/dist/skill-roots.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wildorder/nightshift",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "The crew that builds while you're gone: walk-away, CI-dispatched engineering programs with a decision ledger instead of gates",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/skills/plan-program/SKILL.md

@@ -26,7 +26,20 @@ Read:
   present.
 - When re-planning after a run, the program's run report and decision ledger
   under `docs/programs/` — a prior run's parked workstreams, risk-accepted
-  findings, and recorded decisions are planning input, not noise. Plan from
+  findings, recorded decisions, and **unmet human prerequisites** are
+  planning input, not noise. A prior run's workstreams left `awaiting_human`,
+  and the `prerequisites` entries still `pending` that they reference, name
+  work a human has not yet done. Preserve every prerequisite record that any
+  incomplete workstream still references — verbatim, with its stored
+  `status` unchanged, including a `satisfied` record a live workstream still
+  points at; do not drop it merely because it is satisfied, or the workstream
+  would reference an id the manifest no longer defines. Only a record whose
+  stored status is already `satisfied` may be treated as settled
+  infrastructure, and only because a prior run's preflight flipped it — never
+  because the planner judged the human's work done. A record still marked
+  `pending` stays `pending` even when the human reports having done the
+  action: the planner never flips a prerequisite's status; only the
+  deterministic preflight satisfies one, on the next run. Plan from
   the repository state that exists now, not from the original pre-program
   design; treat work a prior run verified and committed as current
   architecture rather than scheduling it again, and give replacement work new
@@ -143,6 +156,88 @@ npx --yes @wildorder/nightshift branch "{program-id}"
 This skill composes no git of its own — the command above owns branch
 selection, and the packaged runner owns every commit that follows.
 
+## 2.7. Run the actor audit
+
+Before drafting either artifact, walk the phase's work and ask one question of
+each unit: *what credential or access does this step consume, and does the
+crew hold it?* This audit **discovers** human-only steps; it never blocks the
+plan. A phase with no human-only actions produces an empty audit, and the
+skill proceeds exactly as it does today — no `prerequisites` entries, no Human
+Prerequisites section, no friction. There is no rule that a plan must declare
+a prerequisite; there is only a question worth asking before the work is
+scheduled.
+
+The roster does not exist yet at this point — §3 and §4 haven't drafted it —
+so audit a **provisional decomposition**: the candidate units of work the
+phase breaks into, the same decomposition §3 and §4 will formalize into
+workstreams. If drafting the final roster later **adds, removes, splits, or
+moves a workstream**, re-check the hoist-and-batch assignment below against
+the new roster, so every eventual unit of work has been audited and every
+prerequisite lands on the workstream that actually consumes it.
+
+**The enumerable tells** — the concrete signals a unit of work needs a human:
+
+- cloud or organisation **admin credentials** the crew is not given;
+- **console-only actions** with no API the agent can call;
+- **trust anchors** — OIDC providers, state backends, signing keys — that a
+  human must establish before anything can authenticate against them;
+- **secrets the agent may not set** (a repository or environment secret the
+  crew must never hold);
+- **third-party account creation**;
+- **DNS** records and delegations.
+
+**A prerequisite is an action the crew *cannot* perform — never one that is
+merely hard, slow, or annoying.** The audit's test is "does the crew hold
+this?", never "is this unpleasant?" Work an agent can do, even tediously, is
+not a prerequisite; declaring it as one manufactures an intermission and hands
+the human work the run could have done itself.
+
+**Convert each hit into a prerequisite** with:
+
+- a stable **id**, conventionally `HP-01`, `HP-02`, …;
+- a human-facing **description** of the action only a human can perform;
+- a **remediation** written as the exact commands or console steps the human
+  runs — a runbook, not a hint (for example, a repository-settings change like
+  configuring branch protection in the hosting provider's settings, described
+  as console steps, not as a version-control command);
+- a **verifyCommand**: a shell command that exits zero iff the action is done,
+  which the runner executes itself as a deterministic subprocess — never a
+  model's judgment. The observable must be one the headless runner can
+  actually query: non-interactive, reading no stdin, emitting no prompt, and
+  using only credentials the *runner* holds. This is the trap turned back on
+  itself — the prerequisite exists because the crew lacks a credential, and
+  the obvious way to verify the action often needs that same missing
+  privilege. Distinguish permission to **perform** the action (which the crew
+  lacks — that is why it is a prerequisite) from permission to **observe**
+  its completion (which the runner must have). If the only observable needs
+  the human-only privilege, pick a different observable the runner can reach
+  — a downstream effect, a read-only or verification-scoped credential
+  provisioned for the purpose — rather than shipping a command the runner
+  cannot execute. The `verifyCommand` is executed verbatim by the runner, the
+  same trust class as the verify commands in `nightshift.config.json` — it is
+  reviewed at planning time precisely because it will be run.
+
+**Hoist and batch.** Human actions are expensive handoffs. Hoist each human
+action to a workstream boundary rather than burying it mid-workstream, batch
+independent human actions into the fewest handoffs (ideally one), and
+sequence agent-doable work ahead of the first unmet prerequisite so a run
+gets as far as it can before it must wait. A workstream that consumes a
+prerequisite lists it in that workstream's `prerequisites`.
+
+An empty audit is the normal outcome for a program that touches no
+infrastructure — write no `prerequisites`, add no Human Prerequisites
+section, and move on. But an infrastructure-touching program that emerges
+from the audit with an empty prerequisites list is worth re-checking during
+review: it usually means a human seam was missed, not that none exists. This
+is guidance for a second look, not a rule the plan must pass.
+
+**What this step does not do.** The audit produces manifest entries and
+program-document prose. It never runs a `verifyCommand`, never verifies
+whether a human has acted, and never changes a workstream's or a
+prerequisite's `status` — that is the runner's job, at run time. It never
+makes prerequisite declaration mandatory, never blocks a plan, and never adds
+a step the plan must pass. An empty result is a complete, valid plan.
+
 ## 3. Draft the program document
 
 Inspect `docs/programs/` for an existing `*-program.md`. Match its structure
@@ -165,6 +260,13 @@ when one exists. Otherwise use:
 ## Architecture Changes
 [Changes from the system in as-built.md. For the first program, describe the full architecture.]
 
+## Human Prerequisites
+[Only when the actor audit found human-only actions. One short paragraph or a
+few bullets naming each prerequisite by id (HP-xx) and what it unblocks — which
+workstreams wait on it and why the crew cannot perform it. Reference ids only;
+the remediation, verifyCommand, and status live in the manifest, never here.
+Omit this section entirely when the audit found no prerequisites.]
+
 ## Technology Choices
 [Only new choices. If none: "No new technology — uses existing stack."]
 
@@ -188,10 +290,13 @@ and never restates their text.
 The program document carries only what the manifest cannot: narrative
 architecture, causal reasoning, anticipated decisions, and risks. Success
 criteria, the workstream table, the dependency graph, and scope in/out lists
-are manifest data — do not reproduce them here. Two copies of the same fact
-drift apart; one canonical home per fact is a founding rule of this system.
-When this section's rule and an older program document's structure conflict,
-this rule wins: delete the duplicated sections rather than matching them.
+are manifest data — do not reproduce them here. Human Prerequisites follows
+the same rule: reference HP ids only, never their description, remediation,
+verifyCommand, or status, all of which are manifest data. Two copies of the
+same fact drift apart; one canonical home per fact is a founding rule of this
+system. When this section's rule and an older program document's structure
+conflict, this rule wins: delete the duplicated sections rather than matching
+them.
 
 Write the draft directly to `docs/programs/{program-id}-program.md`. Do not
 paste the document into the conversation or ask for approval before saving —
@@ -217,6 +322,15 @@ exactly. Otherwise use:
   "successCriteria": [
     { "id": "SC-01", "description": "{verifiable outcome}" }
   ],
+  "prerequisites": [
+    {
+      "id": "HP-01",
+      "description": "{the action only a human can perform}",
+      "remediation": "{the exact commands or console steps the human runs}",
+      "verifyCommand": "{a shell command that exits zero iff the action is done}",
+      "status": "pending"
+    }
+  ],
   "packages": [
     {
       "name": "{package-name}",
@@ -237,6 +351,7 @@ exactly. Otherwise use:
         "excludes": ["{specific thing it deliberately does not cover}"]
       },
       "dependencies": [],
+      "prerequisites": [],
       "packages": []
     }
   ],
@@ -244,6 +359,11 @@ exactly. Otherwise use:
 }
 ```
 
+The root `prerequisites` array and each workstream's `prerequisites` id list
+come from the actor audit (§2.7). Omit the root array, or leave it empty, when
+the audit found nothing — the schema defaults it to `[]`, so a
+prerequisite-free manifest is byte-for-byte what the skill emits today.
+
 Save it directly to `docs/programs/{program-id}-manifest.json`.
 Keep the manifest, program document, and every referenced `taskFile`
 trackable by Git — nightshift tags decisions to commits and replays roll back