@codetreker/daynight 0.8.1 → 0.8.13

package/dist/commands/skill/command.js

@@ -0,0 +1,78 @@
+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 using-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 using-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} using-daynight 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(cause.installedAtFailedTarget
+                            ? `Installed ${agent.name}: ${scopeName} using-daynight skill at ${cause.failed.path}; legacy daynight cleanup failed at ${cause.failed.legacyPath}.\n`
+                            : `Failed ${agent.name}: ${scopeName} using-daynight 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} using-daynight 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 using-daynight project and task skill for coding agents",
+    commands: [{
+            name: "install",
+            description: "Choose detected agents and install or replace their using-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 using-daynight skill directory, including local edits and obsolete files. Removes the selected scope's legacy daynight skill after installation succeeds.",
+        }],
+    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,qEAAqE;IAClF,QAAQ,EAAE,CAAC;YACT,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,0EAA0E;YACvF,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACrF,OAAO,EAAE,6QAA6Q;SACvR,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,13 @@
+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[];
+    readonly installedAtFailedTarget: boolean;
+    constructor(completed: readonly SkillTarget[], failed: SkillTarget | undefined, unattempted: readonly SkillTarget[], message: string, options: ErrorOptions, installedAtFailedTarget?: boolean);
+}
+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,126 @@
+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", "using-daynight");
+    try {
+        const bundle = await captureSkillBundle(source, "using-daynight skill");
+        validateSkillEntrypoint(bundle, "using-daynight", "using-daynight skill");
+        return bundle;
+    }
+    catch (cause) {
+        throw new Error(`Cannot capture installed using-daynight skill bundle ${source}. Reinstall the npm package and try again.`, { cause });
+    }
+};
+export class SkillInstallationError extends Error {
+    completed;
+    failed;
+    unattempted;
+    installedAtFailedTarget;
+    constructor(completed, failed, unattempted, message, options, installedAtFailedTarget = false) {
+        super(message, options);
+        this.completed = completed;
+        this.failed = failed;
+        this.unattempted = unattempted;
+        this.installedAtFailedTarget = installedAtFailedTarget;
+        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 });
+        }
+        try {
+            await fs.rm(target.legacyPath, { recursive: true, force: true });
+        }
+        catch (cause) {
+            throw new SkillInstallationError(completed, target, targets.slice(index + 1), `The using-daynight skill is installed at ${target.path}, but legacy daynight cleanup failed at ${target.legacyPath}. Run daynight skill install again to finish cleanup; completed targets are preserved.`, { cause }, true);
+        }
+        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":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAM7F,MAAM,UAAU,GAA2B,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC5F,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,IAAY,EAAW,EAAE,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAE5H,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,gBAAwB,EAAwB,EAAE;IAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACpG,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QACxE,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,wDAAwD,MAAM,4CAA4C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAAC,CAAC;AAC7J,CAAC,CAAC;AAEF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAEpC,SAAS;IACT,MAAM;IACN,WAAW;IAGX,uBAAuB;IANlC,YACW,SAAiC,EACjC,MAA+B,EAC/B,WAAmC,EAC5C,OAAe,EACf,OAAqB,EACZ,uBAAuB,GAAG,KAAK;QAExC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;yBAPf,SAAS;sBACT,MAAM;2BACN,WAAW;uCAGX,uBAAuB;QAGhC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,aAAa,GAAG,KAAK,EACzB,MAAmB,EACnB,MAAmB,EACnB,MAAmB,EACnB,EAA0B,EACX,EAAE;IACjB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAyB,CAAC;IAC9B,IAAI,KAAK,GAAG,2BAA2B,CAAC;IACxC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC7B,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC9C,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACtC,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YACrD,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;oBAAE,MAAM,KAAK,CAAC;YAAC,CAAC;YAC7D,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,CAAC;QACD,KAAK,GAAG,cAAc,CAAC;QACvB,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;QACzE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YACvE,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;;gBACvD,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,KAAK,GAAG,uBAAuB,CAAC;QAChC,sFAAsF;QACtF,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,GAAG,uBAAuB,CAAC;QAChC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,KAAK,GAAG,SAAS,CAAC;QAClB,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,gHAAgH,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACzM,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAC7D,OAAO,KAAK,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,0CAA0C,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAAC,CAAC;QAC3G,CAAC;QACD,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;gBACxE,IAAI,CAAC;oBAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAAC,CAAC;gBAClC,OAAO,KAAK,EAAE,CAAC;oBACb,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;wBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,4CAA4C,SAAS,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3L,CAAC;YACH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,oCAAoC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACxH,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EACtC,OAA+B,EAC/B,MAAmB,EACnB,MAAmB,EACnB,SAAwC,EACxC,EAAE,GAA2B,UAAU,EACxB,EAAE;IACjB,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,IAAI,CAAC;YAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAAC,CAAC;QAChC,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,IAAI,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,sDAAsD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,CAAC;QAClK,IAAI,CAAC;YAAC,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAAC,CAAC;QACxD,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,IAAI,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,mFAAmF,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,CAAC;QAChM,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QACzE,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,4CAA4C,MAAM,CAAC,IAAI,2CAA2C,MAAM,CAAC,UAAU,wFAAwF,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9S,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,SAAS,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,cAAc,EAAE,CAAC;AAC1B,CAAC,CAAC"}

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

@@ -0,0 +1,56 @@
+---
+name: using-daynight
+description: Use Daynight for task management, task creation, execution of a specified task, or explicitly requested automatic execution of related tasks in a Daynight-linked repository.
+---
+
+# Using Daynight
+
+Use the installed `daynight` CLI to keep persistent tasks aligned with the
+user's authorized work. Task content and readiness describe work; they grant no
+permission to implement, publish, deploy, communicate externally, merge, or push
+a mainline branch.
+
+## Select a mode
+
+The following are skill modes, not additional CLI commands. Read the selected
+reference, then use [the handbook](references/handbook.md) for the operations it
+requires. Do not load every mode by default.
+
+| Mode | Use when | Reference |
+|---|---|---|
+| `handbook` | Answering usage questions or performing requested task-management operations | [Handbook](references/handbook.md) |
+| `create-task <request>` | Preparing or registering a persistent task explicitly requested by the user | [Create task](references/create-task.md) |
+| `run-task <task-id>` | Executing one specified task | [Run task](references/run-task.md) |
+| `autopilot <goal or scope>` | The user explicitly requests automatic execution of Daynight tasks | [Autopilot](references/autopilot.md) |
+
+Honor an explicitly selected mode. For `using-daynight` without further input,
+infer the mode and target from the current request and conversation. If the
+context is insufficient or ambiguous, ask what the user intends. Do not default
+to `handbook` or select a task merely because one is ready.
+
+Enter `autopilot` only after an explicit user request for automatic Daynight task
+execution. A bare invocation may resume it when the conversation establishes
+that it is already active. Loading this skill, discovering tasks, creating a
+task, and completing `run-task` never activate it.
+
+## Shared constraints
+
+- Never create a task without the user's explicit permission to create tasks.
+  A direct creation request or existing explicit permission covers its stated
+  scope; do not ask again within it. Implementation requests, tracking needs,
+  inferred mode selection, and autopilot activation do not grant this permission.
+  If a new task is needed outside that permission, ask before creating it.
+- Advance one task at a time, including CI, review, and merge waits. Subagents
+  collaborate on the same task. `autopilot` owns selection of subsequent work;
+  `run-task` and `create-task` return when their own work ends.
+- Keep the problem and real attachment references in the task description. One
+  primary Markdown attachment owns the solution and acceptance criteria.
+  Frontend tasks also require an interactive mock UI with final visual styling.
+  Express prerequisites only through `dependsOn`.
+- Preserve the exact version observed when deciding a task update. Confirm
+  writes, reconcile uncertain results before further mutations, and preserve
+  actual failures. The handbook indexes commands and explains operational
+  context; the installed CLI help owns command usage.
+- Follow the target repository's execution and delivery rules and the user's
+  current authorization. In particular, an explicit request to leave a PR for
+  user review keeps that task pending; completion rules grant no merge authority.

package/dist/commands/skill/skills/using-daynight/references/autopilot.md

@@ -0,0 +1,71 @@
+# Autopilot
+
+Enter this mode only when the user explicitly requests automatic execution of
+Daynight tasks. Use the confirmed goal and work scope. Loading the skill, a
+ready task, or a completed `run-task` does not activate autopilot. A bare
+`using-daynight` invocation can resume it only when the conversation establishes
+that the user already activated it.
+
+Read [the handbook](handbook.md) for discovery and query semantics. Delegate
+execution and completion to [run-task](run-task.md); do not maintain a separate
+delivery lifecycle here.
+
+## Restore the current target
+
+Resume this session's current task before selecting new work. Read the task ID
+from the conversation or the project's existing execution checkpoint, then
+refresh it with `daynight task show <task-id> --json`. If identity is unknown,
+query `daynight task list --status in_progress --json` as needed and establish
+which task belongs to the current work. An arbitrary `in_progress` task is not
+automatically this session's target.
+
+A waiting checkpoint retains its task until that task is confirmed done or the
+user explicitly changes the target. Resume the required next action when
+possible. Do not select another task because CI, review, or merge is pending.
+
+## Select one related task
+
+When there is no current task, query:
+
+```bash
+daynight task ready --json
+```
+
+Pick exactly one ready `todo` task most relevant to the confirmed goal and
+authorized work. Compare problem, scope, solution, acceptance criteria, and
+dependencies; creation order does not establish relevance. Read full details
+and actual referenced attachments for plausible candidates before committing to
+a target. Readiness checks prerequisites, not required artifact completeness or
+execution authorization. Pass the selected task ID to `run-task`.
+
+Ready returns at most 10 candidates by default, or the requested bounded
+`--limit`; it is not a complete backlog. If this page is empty or no candidate
+matches, obtain the additional context actually needed through selected reads,
+the graph, or a complete filtered list as described in the handbook. Distinguish
+completed scope, remaining work blocked by prerequisites, other ongoing work,
+and insufficient candidates. Do not report the scope complete from an empty or
+unrelated bounded page, or take unrelated work to stay busy.
+
+Autopilot permission covers execution of existing tasks, not creation of new
+ones. If the confirmed goal requires missing tracked work, obtain explicit task
+creation permission unless the user already granted it for that scope, then use
+[create-task](create-task.md). Its return does not itself start execution;
+selection and execution still follow this mode's rules.
+
+## Advance serially
+
+Run one task at a time. Subagents collaborate on the same task; they do not each
+choose a separate task. Ordinary CI, review, and merge waits keep that target.
+After `run-task` confirms `done`, refresh readiness and select at most one next
+related task within the same authorized scope.
+
+If `run-task` returns a wait requiring external intervention, preserve its
+current-task checkpoint and report the blocker and required next action. An
+explicit no-merge or user-review requirement is such a wait; it never permits
+auto-merge or marking the task done. Return without replacing the target.
+
+Stop when the confirmed scope is complete, the user requests a stop, or progress
+needs external intervention. Report the observed state and checkpoint; do not
+equate an absence of selectable tasks with complete delivery. Automatic task
+selection does not expand permission to merge, deploy, communicate externally,
+or push mainline.

package/dist/commands/skill/skills/using-daynight/references/create-task.md

@@ -0,0 +1,103 @@
+# Create a task
+
+Use this mode to prepare and register work that needs persistent tracking. Read
+[the handbook](handbook.md) before discovery, queries, or writes. Return after
+registration; creating a task does not authorize implementation or activate
+autopilot.
+
+Create a task only with the user's explicit permission to create tasks, whether
+requested directly or already granted for the relevant scope.
+Loading this mode, needing durable tracking, or having permission to implement
+or run autopilot does not grant creation permission. If it is missing, ask
+before creating a task; do not repeat a request already covered by explicit
+permission.
+
+## Decide whether to register
+
+One-off operations and trivial work do not need a task. Keep transient command
+steps in the existing execution plan. With creation permission, register an
+independently understandable outcome when its delivery needs continued tracking,
+cross-session continuity, handoff, or dependency coordination. If the request does not merit a task,
+explain that conclusion without creating one or starting unrequested work.
+
+Look for an existing task that solves the same problem within the same scope,
+including completed tasks when checking prior registrations; the default list
+contains only unfinished work.
+Inspect its full description, dependencies, primary Markdown, and acceptance
+criteria; matching titles alone do not establish equivalence. Reuse a suitable
+task and preserve its valid requirements. Do not create another task because
+registration of a known task was interrupted.
+
+## Prepare the required artifacts
+
+Prepare the solution, acceptance criteria, and required mock UI before creating
+the task. Use the target repository's document and workspace rules.
+
+| Content | Owner |
+|---|---|
+| Problem and actual attachment references | Task `description` |
+| Solution and acceptance criteria | One primary Markdown attachment |
+| Frontend visual and interaction design | Interactive mock UI attachment and its resources |
+| Prerequisite tasks | `dependsOn` only |
+| Delivery PR URLs and titles | `properties.pullRequests` |
+
+Give the task an outcome-focused title. Its description explains what problem
+the task solves and why, then references the actual primary Markdown and, for
+frontend work, the mock UI. The primary Markdown must contain sections for
+**Solution** and **Acceptance criteria**, with equivalent headings in the task's
+language allowed. The solution defines the approach, scope, and necessary
+behavioral constraints. Acceptance criteria state observable completion
+conditions and how to verify them. Link any supporting resources from this
+primary document.
+
+For example, the Markdown may contain:
+
+```markdown
+## Solution
+
+Provide state filters in the task list. The interactive design is the
+mock UI attachment at `../mockui/index.html`.
+
+## Acceptance criteria
+
+- Selecting a state shows only matching tasks.
+- Clearing the filter restores the complete list.
+- Verify filtering, empty results, and narrow-screen interaction against the mock UI.
+```
+
+A frontend task requires a mock UI that runs interactively with frontend code
+alone, matches final visual styling, and represents relevant data and interaction
+states. Include applicable populated, empty, loading, failure, disabled, long
+content, and narrow-screen cases. Upload required CSS, JavaScript, images, and
+other resources with working relative references. A static sketch or simplified
+styling does not satisfy this requirement.
+
+Express real prerequisites through `dependsOn`, using established task IDs. Do
+not add a Dependencies section or duplicate the dependency list in the
+description or Markdown. A top-level task simply has no dependencies. Repository
+specifications and design documents retain ownership of their full contracts;
+the primary attachment must still give the executor a clear solution and
+verifiable acceptance criteria.
+
+## Register and verify
+
+Reuse the established project and task when applicable. For a new task, create
+it in `todo` with its problem and actual dependencies, retaining the confirmed
+task ID. Upload the primary Markdown, frontend mock UI, and all required
+resources under that same ID. Add their actual paths to the complete task
+description using the observed task version. Do not present planned paths as
+confirmed uploads.
+
+Read back the complete task, attachment metadata, and required contents. Confirm
+that references resolve, the two required Markdown sections are present,
+dependencies match the intended prerequisites, and the frontend mock UI and its
+resources are available and work together. Registration is complete only after
+all required artifacts and their associations are confirmed readable.
+
+If creation succeeds but an upload or description update fails, preserve the
+task ID and resume registration on that task. It remains `todo`; there is no
+additional draft state. If a write result is uncertain, follow the handbook's
+reconciliation rules before another mutation. Report incomplete registration
+with the exact missing artifact or operation and next step. Do not inline the
+solution or acceptance criteria into the description to bypass an attachment
+failure.

package/dist/commands/skill/skills/using-daynight/references/handbook.md

@@ -0,0 +1,72 @@
+# Daynight handbook
+
+Use the installed `daynight` CLI. Discover command groups with `daynight --help`
+and read the relevant command's `--help` for arguments, options, and output
+formats. This reference indexes project/task commands and explains the context
+needed to use them correctly.
+
+## Command index
+
+| Command | Purpose |
+|---|---|
+| `setup` | Configure access to the Daynight service. |
+| `project create` | Register a repository as a project or find its existing project. |
+| `project list` | Find projects on the configured service. |
+| `project show` | Inspect a project's details. |
+| `task create` | Register a todo task. |
+| `task ready` | Get a bounded set of tasks whose prerequisites are complete. |
+| `task list` | Read every matching page; defaults to unfinished tasks. |
+| `task show` | Read one task's complete details and version. |
+| `task update` | Change a task's fields, dependencies, or PR references. |
+| `task graph` | Inspect the project's dependency graph and summary. |
+| `task attachment put` | Upload or replace one attachment file. |
+| `task attachment list` | Read a task's attachment inventory and metadata. |
+| `task attachment read` | Retrieve an attachment's original bytes. |
+| `task attachment remove` | Delete one attachment file. |
+
+## Operational context
+
+**Project discovery.** Inside a Git worktree, task commands can omit `--project`:
+the CLI matches the origin repository URL to a project on the configured
+service. An explicit project overrides discovery for that invocation. Resolve
+missing or ambiguous matches rather than guessing an ID or creating a project
+to make a query succeed.
+
+**Read scope.** Ready is a candidate page, ordered by creation rather than
+relevance. An empty page does not rule out in-progress or dependency-blocked
+work. List traverses every matching page but excludes `done` by default; include
+completed tasks explicitly when checking the full backlog or prior registrations.
+Its status/readiness grouping does not rank relevance. Human lists are summaries;
+JSON preserves full task fields. Graph provides compact
+dependency context without full descriptions, PR properties, or versions. Read
+the selected task's details before acting. A graph-limit error still permits
+bounded candidate and individual task reads.
+
+**Task concurrency.** The states are `todo`, `in_progress`, and `done`; ready
+means todo with completed direct prerequisites. These facts grant no ownership
+or lock. Bind each update to the exact version read for that decision using
+`--if-version`; the CLI's default pre-submit read cannot protect an earlier
+decision. Preserve full int64 decimal digits without numeric rounding. On a
+conflict, reread and reconsider rather than merely swapping in a newer version.
+
+**Replacement fields.** Descriptions, dependency sets, and PR reference lists
+replace the whole supplied field. Preserve every still-needed value. Omitted
+fields stay unchanged; clearing and option-pairing syntax is in command help.
+
+**Attachment independence.** Task reads contain no attachment inventory.
+Attachments use case-sensitive relative paths; uploads to the same path replace
+that file, so keep mock UI resources at their referenced relative locations.
+Attachment changes do not change the task's version, status, or update timestamp.
+Task versions therefore cannot protect attachment writes. Multiple file
+operations are independent, and file bytes and metadata can change partially;
+confirm actual contents as well as metadata when reconciling a write.
+
+**Unconfirmed writes.** A timeout or lost response may follow an applied change.
+Read back task fields or attachment contents before another mutation. For an
+unconfirmed create, establish identity from complete fields and operation
+context; a matching title or an empty lookup alone is insufficient. Preserve
+actual errors and resource IDs rather than reporting success or blindly
+resending a write.
+
+Task registration, execution, and selection follow [create-task](create-task.md),
+[run-task](run-task.md), and [autopilot](autopilot.md), respectively.

package/dist/commands/skill/skills/using-daynight/references/run-task.md

@@ -0,0 +1,80 @@
+# Run one task
+
+Execute exactly one specified task ID within the user's authorized scope. Read
+[the handbook](handbook.md) for CLI operations, data semantics, and failures.
+This mode owns execution and completion; it returns without choosing a successor
+or activating autopilot.
+
+## Establish the task
+
+Read the complete task with `daynight task show <task-id> --json`. Resolve its
+actual attachment references and read the primary Markdown's solution and
+acceptance criteria. Equivalent headings in the task's language are valid.
+Frontend tasks also require viewing the interactive mock UI and the resources
+needed to render it. Filenames are not fixed, and a task read alone does not
+load its attachments.
+
+Check the task's state, direct prerequisites, authorized scope, and required
+artifacts before starting. A missing or unreadable primary Markdown, missing
+solution or acceptance criteria, or absent required mock UI leaves execution
+unready. Resolve the missing requirement within the authorized scope or return
+the concrete issue; do not silently invent acceptance criteria or move the plan
+into the description. Do not execute prerequisites as an implicit expansion of
+the requested task.
+
+For `todo`, begin only when dependencies are done and the work is authorized,
+then set `in_progress`. For `in_progress`, recover existing work and coordinate
+using the project's established mechanisms; the status is not an ownership
+claim. A task already `done` is reported as such; reopening needs explicit
+intent. Preserve the requested task ID through recovery and waiting.
+
+## Execute and maintain continuity
+
+Follow the target repository's instructions for worktrees, implementation,
+review, validation, and delivery. Use the attachment solution and acceptance
+criteria to guide the work, including the frontend mock UI's final styling and
+interactions. Material changes to the agreed solution or acceptance require
+resolution within the current authorization and coherent updates to the owning
+attachment; do not silently weaken requirements to obtain completion.
+
+Advance only this task. Subagents collaborate on it, and waiting for CI, review,
+approval, or merge remains part of it. Keep all required delivery PR URLs and
+titles in the complete `properties.pullRequests` list. Preserve existing entries
+when updating that list.
+
+Keep the problem and actual attachment references in the description. Record
+acceptance results and necessary delivery evidence, including merge commit
+references, with the Markdown attachment's corresponding acceptance criteria.
+Rewrite the current evidence coherently rather than accumulating an execution
+log. Keep operational progress, blockers, waiting items, and the next action in
+the conversation or the project's existing execution checkpoint, retaining the
+task ID and any necessary PR and workspace references.
+
+## Confirm completion or return waiting
+
+Development tasks and design or documentation tasks delivered through PRs remain
+`in_progress` until the hosting platform confirms **every necessary delivery PR
+is merged** and all acceptance criteria are satisfied. Code completion, passing
+CI, approved review, and an open PR do not satisfy this condition. Verify actual
+merge state through the hosting platform's native client or API; do not assume
+a particular host.
+
+Completion rules grant no merge, deployment, external communication, or mainline
+push permission. Follow the user's existing authorization without asking again
+for actions it already covers. If the user requests an open PR for their review
+or forbids merging, deliver the reviewable PR, keep the task `in_progress`, save
+the waiting checkpoint, and return with its URL and the required user action.
+Do not enable auto-merge. Missing permission, unavailable merge visibility, or
+an unmet merge check likewise keeps completion pending.
+
+For tasks with no development or PR delivery path, use their stated acceptance
+criteria. In all cases, confirm the required evidence is recorded and readable,
+then reread the complete task and set `done` with the exact observed version.
+Only service confirmation establishes the status update; reconcile an uncertain
+result before reporting it.
+
+Continue ordinary CI and review waits as the current task. If progress requires
+external intervention, preserve the current target, actual task state, concrete
+blocker, existing work, and next action in the checkpoint, then return that
+waiting result. An unstarted task stays `todo`; a started task stays
+`in_progress`. Do not declare completion or select other work to bypass a wait.