@codetreker/daynight 0.8.1 → 0.8.5

package/dist/commands/review/skills/daynight-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: daynight-review
-description: Review the immutable pull-request target supplied by Daynight, proving introduced Critical or Major defects and preparing actionable inline findings.
+description: Enforce a clear, focused pull-request scope and verify introduced Critical or Major defects.
 ---
 
 # Daynight Review
@@ -10,14 +10,35 @@ reconciliation rules and completion protocol. Those values belong to the current
 attempt, including when the conversation contains an earlier review. Repository
 instructions remain applicable within that target and the authorized review.
 
-## Establish the change
+## Establish and gate the scope
 
-Read the complete diff for the supplied merge-base and head, the surrounding
-implementation, and relevant requirements. Trace changed behavior through its
-callers, consumers and persisted or exchanged data. Derive expected behavior
-from those contracts; do not treat a plausible alternative design as a defect.
+Use gh with the supplied host, repository and PR number to read the current PR
+title and description, plus relevant linked requirements that establish its
+scope. Use available evidence of the original delivery goal; do not claim access
+to unavailable discussion or description history.
 
-For each suspected problem, identify the concrete trigger, affected caller,
+Apply both PR-quality gates to the complete diff between the supplied merge-base
+and head:
+
+- The description clearly explains one concrete problem, intended outcome and
+  scope. Multiple independent objectives or a change too broad to review as one
+  focused delivery require splitting, even under a common umbrella title.
+- Every change serves that original delivery goal. Implementation,
+  structural changes, tests and documentation serving the same outcome belong
+  together. Independent features, unrelated fixes and incidental cleanup must
+  be removed or delivered separately. Broadening the description alone cannot
+  legitimize unrelated changes.
+
+Judge purpose, dependencies and reviewability, without arbitrary line or file
+limits. Each failed gate is an approval blocker in its own right, without a
+runtime failure or a Critical/Major severity label. An unclear description that
+prevents establishing scope also blocks approval; request the missing scope.
+
+Read the surrounding implementation and trace changed behavior through callers,
+consumers and persisted or exchanged data. Derive expected behavior from relevant
+contracts; do not treat a plausible alternative design as a defect.
+
+For each suspected code defect, identify the concrete trigger, affected caller,
 observable failure and changed line that introduces it. Compare the original
 behavior when needed to distinguish an introduced defect from an existing one.
 Include adjacent code only when its interaction with this change causes the
@@ -42,22 +63,30 @@ captured target, and obey the task's foreground-process and cleanup rules.
 
 ## Select and publish findings
 
-Report only actionable Critical or Major defects introduced by the change.
+Report PR-quality blockers and actionable Critical or Major defects introduced
+by the change.
 Critical defects have severe, broad consequences such as destructive data loss
 or a fundamental security failure. Major defects break required behavior for a
 concrete supported use case. Judge severity by the demonstrated consequence and
 reach, not by how small the fix appears.
 
-Defer minor improvements, style preferences, pre-existing defects and unrelated
-cleanup. Do not grow the review into a repository-wide audit. If an uncertain
+Defer minor improvement requests, style preferences and pre-existing defects.
+Do not grow the review into a repository-wide audit. If an uncertain code-defect
 candidate cannot be established with the available evidence, leave it out of
 published findings.
 
-Write English inline comments on the relevant changed lines and identify the
-reviewing agent as required by the task. Each comment states the defect, the
-trigger or affected behavior, and the necessary correction concisely. Keep
+Write English comments and identify the reviewing agent as required by the task.
+Put out-of-scope changes and code defects on the relevant changed lines. Put
+description or PR-wide blockers in the review body when no suitable changed line
+exists; a COMMENT review may contain only a body. State the violated scope or
+behavior, its concrete effect, and the necessary correction concisely. Keep
 investigation narration, reproduction transcripts and lists of things checked
-out of the comment. Combine duplicate manifestations of one cause.
+out of comments. Combine duplicate manifestations of one cause.
+
+Approve only when both PR-quality gates pass and no Critical or Major defect
+remains. Before publication or retry confirmation, re-read the current title and
+description and evaluate the gates again. A matching stable identity on an old
+APPROVE does not establish that the current description and scope pass.
 
 Follow the current task's result-publication and retry-reconciliation protocol.
 Only its successful publication or confirmation permits its completion marker.

package/dist/commands/skill/agents.d.ts

@@ -0,0 +1,23 @@
+export declare const skillAgents: readonly [{
+    readonly id: "codex";
+    readonly name: "Codex";
+    readonly command: "codex";
+    readonly directory: ".agents";
+    readonly reload: "Codex discovers skills automatically; restart the session if it is not listed.";
+}, {
+    readonly id: "copilot";
+    readonly name: "Copilot CLI";
+    readonly command: "copilot";
+    readonly directory: ".agents";
+    readonly reload: "In Copilot CLI, run /skills reload and /skills info daynight.";
+}, {
+    readonly id: "claude";
+    readonly name: "Claude Code";
+    readonly command: "claude";
+    readonly directory: ".claude";
+    readonly reload: "Claude Code discovers existing skill directories automatically; run /reload-skills after creating a new top-level directory.";
+}];
+export type SkillAgent = typeof skillAgents[number];
+export type SkillAgentId = SkillAgent["id"];
+export type AgentLookup = (command: string) => Promise<string | null>;
+export declare const detectSkillAgents: (lookup?: AgentLookup) => Promise<SkillAgent[]>;

package/dist/commands/skill/agents.js

@@ -0,0 +1,14 @@
+import which from "which";
+export const skillAgents = [
+    { id: "codex", name: "Codex", command: "codex", directory: ".agents", reload: "Codex discovers skills automatically; restart the session if it is not listed." },
+    { id: "copilot", name: "Copilot CLI", command: "copilot", directory: ".agents", reload: "In Copilot CLI, run /skills reload and /skills info daynight." },
+    { id: "claude", name: "Claude Code", command: "claude", directory: ".claude", reload: "Claude Code discovers existing skill directories automatically; run /reload-skills after creating a new top-level directory." },
+];
+export const detectSkillAgents = async (lookup = async (command) => which(command, { nothrow: true })) => {
+    const detected = [];
+    for (const agent of skillAgents)
+        if (await lookup(agent.command) !== null)
+            detected.push(agent);
+    return detected;
+};
+//# sourceMappingURL=agents.js.map

package/dist/commands/skill/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/commands/skill/agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,gFAAgF,EAAE;IAChK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,+DAA+D,EAAE;IACzJ,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,8HAA8H,EAAE;CAC9M,CAAC;AAMX,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,MAAM,GAAgB,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EACnD,EAAE;IACzB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,WAAW;QAAE,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChG,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/commands/skill/command.d.ts

@@ -0,0 +1,12 @@
+import type { CliContext } from "../../cli/context.js";
+import type { SkillAgent } from "./agents.js";
+import type { SkillBundle } from "./install.js";
+import type { SkillTarget } from "./targets.js";
+export type SkillCommandDependencies = {
+    detectAgents: () => Promise<SkillAgent[]>;
+    projectRoot: (cwd: string, signal: AbortSignal) => Promise<string>;
+    captureBundle: (packageDirectory: string) => Promise<SkillBundle>;
+    planTargets: (base: string, agents: readonly SkillAgent[]) => Promise<SkillTarget[]>;
+    install: (targets: readonly SkillTarget[], bundle: SkillBundle, signal: AbortSignal, installed: (target: SkillTarget) => void) => Promise<void>;
+};
+export declare const runSkillCommand: (args: readonly string[], context: CliContext, dependencies?: SkillCommandDependencies, suppliedSignal?: AbortSignal) => Promise<void>;

package/dist/commands/skill/command.js

@@ -0,0 +1,76 @@
+import { withCliCancellation } from "../../cli/cancellation.js";
+import { parseCommand, renderCommandHelp } from "../../cli/schema.js";
+import { skillDefinition } from "./definition.js";
+const defaultDependencies = {
+    detectAgents: async () => (await import("./agents.js")).detectSkillAgents(),
+    projectRoot: async (cwd, signal) => {
+        const { createOperation } = await import("../../api/operation.js");
+        const operation = createOperation({ signal, limits: { totalMs: 30_000 } });
+        try {
+            return await (await import("../../repository/git.js")).discoverWorktreeRoot(cwd, operation);
+        }
+        finally {
+            operation.dispose();
+        }
+    },
+    captureBundle: async (packageDirectory) => (await import("./install.js")).captureInstalledSkill(packageDirectory),
+    planTargets: async (...args) => (await import("./targets.js")).planSkillTargets(...args),
+    install: async (...args) => (await import("./install.js")).installSkillTargets(...args),
+};
+export const runSkillCommand = async (args, context, dependencies = defaultDependencies, suppliedSignal) => {
+    const command = parseCommand(skillDefinition, args, ["daynight", "skill"], "daynight skill --help");
+    if (command.kind !== "run") {
+        context.stdout(renderCommandHelp(command.command, command.path));
+        return;
+    }
+    await withCliCancellation(context, async (signal) => {
+        const prompt = context.prompt;
+        if (prompt?.isInteractive !== true)
+            throw new Error("Skill installation requires terminal input and stderr. Run daynight skill install from an interactive terminal.");
+        signal.throwIfAborted();
+        const detected = await dependencies.detectAgents();
+        signal.throwIfAborted();
+        if (detected.length === 0)
+            throw new Error("No supported agent launchers were detected on PATH (codex, copilot, claude). Install an agent and run daynight skill install again.");
+        const selection = await prompt.selectMany({
+            message: "Install the Daynight skill for which agents?",
+            choices: detected.map(({ id, name }) => ({ name, value: id })),
+            requiredMessage: "Select at least one agent.",
+        }, signal);
+        signal.throwIfAborted();
+        const agents = detected.filter(({ id }) => selection.includes(id));
+        if (agents.length === 0)
+            throw new Error("Select at least one detected agent to install the Daynight skill.");
+        const scope = await prompt.select({
+            message: "Where should the skill be installed?",
+            choices: [{ name: "User", value: "user" }, { name: "Project", value: "project" }],
+            default: "user",
+        }, signal);
+        signal.throwIfAborted();
+        const scopeName = scope === "user" ? "User" : "Project";
+        const base = scope === "user" ? context.homeDirectory() : await dependencies.projectRoot(context.workingDirectory(), signal);
+        const bundle = await dependencies.captureBundle(context.packageDirectory);
+        const targets = await dependencies.planTargets(base, agents);
+        signal.throwIfAborted();
+        try {
+            await dependencies.install(targets, bundle, signal, (target) => {
+                for (const [index, agent] of target.agents.entries()) {
+                    context.stdout(`Installed ${agent.name}: ${scopeName} skill at ${target.path} (package ${context.version}${index === 0 ? "" : "; shared installation"}).\n${agent.reload}\n`);
+                }
+            });
+        }
+        catch (cause) {
+            const { SkillInstallationError } = await import("./install.js");
+            if (cause instanceof SkillInstallationError) {
+                if (cause.failed !== undefined)
+                    for (const agent of cause.failed.agents)
+                        context.stderr(`Failed ${agent.name}: ${scopeName} skill at ${cause.failed.path}.\n`);
+                for (const target of cause.unattempted)
+                    for (const agent of target.agents)
+                        context.stderr(`Not attempted ${agent.name}: ${scopeName} skill at ${target.path}.\n`);
+            }
+            throw cause;
+        }
+    }, suppliedSignal);
+};
+//# sourceMappingURL=command.js.map

package/dist/commands/skill/command.js.map

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

package/dist/commands/skill/definition.d.ts

@@ -0,0 +1,2 @@
+import type { CommandDefinition } from "../../cli/schema.js";
+export declare const skillDefinition: CommandDefinition;

package/dist/commands/skill/definition.js

@@ -0,0 +1,12 @@
+export const skillDefinition = {
+    name: "skill",
+    description: "Install the Daynight project and task skill for coding agents",
+    commands: [{
+            name: "install",
+            description: "Choose detected agents and install or replace their Daynight skill",
+            options: [{ names: ["-h", "--help"], description: "Show this help", action: "help" }],
+            details: "Requires interactive terminal input and stderr. Choose agents, then User or Project scope.\nReplaces the complete daynight skill directory, including local edits and obsolete files.",
+        }],
+    options: [{ names: ["-h", "--help"], description: "Show this help", action: "help" }],
+};
+//# sourceMappingURL=definition.js.map

package/dist/commands/skill/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/commands/skill/definition.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,+DAA+D;IAC5E,QAAQ,EAAE,CAAC;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oEAAoE;YACjF,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACrF,OAAO,EAAE,uLAAuL;SACjM,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;CACtF,CAAC"}

package/dist/commands/skill/install.d.ts

@@ -0,0 +1,12 @@
+import type { BundleEntry } from "../../platform/skill-bundle.js";
+import type { SkillTarget } from "./targets.js";
+export type SkillBundle = readonly BundleEntry[];
+export type SkillInstallFilesystem = Pick<typeof import("node:fs/promises"), "mkdir" | "mkdtemp" | "rename" | "rm" | "rmdir" | "writeFile">;
+export declare const captureInstalledSkill: (packageDirectory: string) => Promise<SkillBundle>;
+export declare class SkillInstallationError extends Error {
+    readonly completed: readonly SkillTarget[];
+    readonly failed: SkillTarget | undefined;
+    readonly unattempted: readonly SkillTarget[];
+    constructor(completed: readonly SkillTarget[], failed: SkillTarget | undefined, unattempted: readonly SkillTarget[], message: string, options: ErrorOptions);
+}
+export declare const installSkillTargets: (targets: readonly SkillTarget[], bundle: SkillBundle, signal: AbortSignal, installed: (target: SkillTarget) => void, fs?: SkillInstallFilesystem) => Promise<void>;

package/dist/commands/skill/install.js

@@ -0,0 +1,118 @@
+import { mkdir, mkdtemp, rename, rm, rmdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { captureSkillBundle, validateSkillEntrypoint } from "../../platform/skill-bundle.js";
+const filesystem = { mkdir, mkdtemp, rename, rm, rmdir, writeFile };
+const hasCode = (cause, code) => cause instanceof Error && "code" in cause && cause.code === code;
+export const captureInstalledSkill = async (packageDirectory) => {
+    const source = path.join(packageDirectory, "dist", "commands", "skill", "skills", "daynight");
+    try {
+        const bundle = await captureSkillBundle(source, "Daynight skill");
+        validateSkillEntrypoint(bundle, "daynight", "Daynight skill");
+        return bundle;
+    }
+    catch (cause) {
+        throw new Error(`Cannot capture installed Daynight skill bundle ${source}. Reinstall the npm package and try again.`, { cause });
+    }
+};
+export class SkillInstallationError extends Error {
+    completed;
+    failed;
+    unattempted;
+    constructor(completed, failed, unattempted, message, options) {
+        super(message, options);
+        this.completed = completed;
+        this.failed = failed;
+        this.unattempted = unattempted;
+        this.name = "SkillInstallationError";
+    }
+}
+const replaceTarget = async (target, bundle, signal, fs) => {
+    const created = [];
+    let stage;
+    let phase = "create parent directories";
+    let removed = false;
+    let failure;
+    try {
+        signal.throwIfAborted();
+        let cursor = target.ancestor;
+        for (const component of target.missingParents) {
+            cursor = path.join(cursor, component);
+            try {
+                await fs.mkdir(cursor);
+                created.push(cursor);
+            }
+            catch (cause) {
+                if (!hasCode(cause, "EEXIST"))
+                    throw cause;
+            }
+            signal.throwIfAborted();
+        }
+        phase = "stage bundle";
+        stage = await fs.mkdtemp(path.join(target.parent, ".daynight-install-"));
+        for (const entry of bundle) {
+            signal.throwIfAborted();
+            const destination = path.join(stage, ...entry.relativePath.split("/"));
+            if (entry.type === "directory")
+                await fs.mkdir(destination);
+            else
+                await fs.writeFile(destination, entry.contents, { flag: "wx" });
+        }
+        signal.throwIfAborted();
+        phase = "remove existing skill";
+        // Cancellation is observed after publishing, so removal cannot interrupt replacement.
+        await fs.rm(target.path, { recursive: true, force: true });
+        removed = true;
+        phase = "publish staged bundle";
+        await fs.rename(stage, target.path);
+        stage = undefined;
+        return;
+    }
+    catch (cause) {
+        failure = new Error(`Cannot ${phase} at ${target.path}.${removed ? " The previous skill was removed; the target may now be absent. Run daynight skill install again to restore it." : ""}`, { cause });
+    }
+    finally {
+        const cleanup = [];
+        if (stage !== undefined) {
+            try {
+                await fs.rm(stage, { recursive: true, force: true });
+            }
+            catch (cause) {
+                cleanup.push(new Error(`Cannot remove skill installation stage ${stage}.`, { cause }));
+            }
+        }
+        if (failure !== undefined)
+            for (const directory of created.toReversed()) {
+                try {
+                    await fs.rmdir(directory);
+                }
+                catch (cause) {
+                    if (!hasCode(cause, "ENOTEMPTY") && !hasCode(cause, "EEXIST") && !hasCode(cause, "ENOENT"))
+                        cleanup.push(new Error(`Cannot remove newly created skill parent ${directory}.`, { cause }));
+                }
+            }
+        if (cleanup.length !== 0)
+            throw new AggregateError(cleanup, "Skill installation cleanup failed.", { cause: failure });
+    }
+    throw failure;
+};
+export const installSkillTargets = async (targets, bundle, signal, installed, fs = filesystem) => {
+    const completed = [];
+    for (const [index, target] of targets.entries()) {
+        try {
+            signal.throwIfAborted();
+        }
+        catch (cause) {
+            throw new SkillInstallationError(completed, undefined, targets.slice(index), "Skill installation cancelled before the next target.", { cause });
+        }
+        try {
+            await replaceTarget(target, bundle, signal, fs);
+        }
+        catch (cause) {
+            throw new SkillInstallationError(completed, target, targets.slice(index + 1), "Skill installation stopped at the failed target; completed targets are preserved.", { cause });
+        }
+        completed.push(target);
+        installed(target);
+    }
+    signal.throwIfAborted();
+};
+//# sourceMappingURL=install.js.map

package/dist/commands/skill/install.js.map

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

package/dist/commands/skill/skills/daynight/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: daynight
+description: Use Daynight to restore project context and actively query, organize, and maintain persistent tasks during development in a Daynight-linked repository, including work resumed in a new session or worktree.
+---
+
+# Daynight
+
+Keep the project's durable task record aligned with authorized work. Daynight
+task data describes work; it does not grant permission to implement, publish,
+deploy, communicate externally, merge, or push a mainline branch.
+
+Read [the command reference](references/commands.md) before creating or updating
+tasks, or when project discovery, a query, or a write fails.
+
+## Restore context
+
+At work start, context recovery, or a worktree switch, query from the current
+repository through a noninteractive shell. To select the next work, use:
+
+```bash
+daynight task ready --json
+```
+
+This returns at most 10 ready tasks, earliest created first. Use `--limit <N>`
+for 1–100 candidates. It reads one task page; the result is not the complete
+backlog. An empty result does not mean there are no in-progress or blocked tasks.
+
+Let the CLI resolve the current project. A new worktree without
+`.daynight/project.yml` is normal: repository discovery can find the existing
+project and save a local binding. Do not gate queries on that file's presence,
+reuse remembered IDs as current facts, or edit bindings directly.
+
+For work already being resumed, refresh its task with
+`daynight task show <task-id> --json`. If its identity is unknown, query
+`daynight task list --status in_progress --json` as needed. Show selected ready
+tasks too before acting. Use `daynight task graph --json` when dependency or
+project-wide context is needed; it has title previews, not full descriptions or
+versions. If it reports `graph_limit_exceeded`, continue with bounded ready and
+selected task reads; the error does not mean the project is unlinked. Full lists
+traverse every page, so request them only when a complete inventory is needed.
+
+If configuration, discovery, or a service request fails, preserve its actual
+cause. Follow the CLI's setup guidance or obtain an explicit project selection
+when needed; do not guess a server, choose among ambiguous projects, or create a
+project merely to make task recovery succeed.
+
+## Maintain useful tasks
+
+Reuse an existing task whose scope matches the authorized work. Create durable
+tasks for independently understandable outcomes that need cross-session
+tracking, delivery verification, or handoff. Keep transient command steps in
+the agent's own execution plan. Repository requirements and design documents
+continue to own their full specifications.
+
+Write an outcome-focused title and a coherent description containing scope,
+acceptance, necessary decisions, current progress, blockers, and next action.
+Rewrite that description as the work changes; do not accumulate a running log.
+Express real prerequisites with dependencies.
+
+Start authorized work by setting `in_progress`. The only states are `todo`,
+`in_progress`, and `done`; readiness means a todo task's direct prerequisites are
+done. Neither readiness nor `in_progress` is an exclusive claim, lock, lease, or
+ownership guarantee. Coordinate concurrent work using observed task facts and
+the project's existing communication rules.
+
+Before changing any field, read the complete task and pass that exact observed
+version as `--if-version`. Preserve the full int64 decimal value. A conflict
+requires rereading and reconsidering the intended change, not replaying it with
+a newer version. Descriptions and dependency sets are complete replacements;
+the command reference explains clearing and omitted fields.
+
+Only report a write as successful after service confirmation. When a result is
+unconfirmed, reconcile it with service reads before taking another write action;
+do not blindly resend a create or update.
+
+## Verify delivery before completion
+
+Development tasks, and design or documentation tasks delivered through PRs,
+remain `in_progress` until the hosting platform confirms that **all necessary
+delivery PRs are merged** and the task's acceptance criteria are satisfied.
+Code completion, an open PR, approved review, or passing CI does not meet this
+condition. Record PR URLs, outstanding checks, and waiting items while delivery
+is pending.
+
+Before setting `done`, query the platform's actual merge state for every required
+PR and retain its PR URL and merge commit reference in the task description.
+Then reread the task and update with its observed version. Missing merge
+visibility, a missing permission, or an unmet merge check keeps the task
+`in_progress`; the completion rule grants no merge authority. Tasks with no
+development or PR delivery path use their stated acceptance criteria.
+
+After confirmed completion, query `daynight task ready --json` to see which
+dependent tasks became available. A ready successor still needs authorization within the
+current scope before work starts. Refresh task facts at these semantic
+checkpoints; do not reload the full project on every conversational turn.