@codetreker/daynight 0.8.5 → 0.8.13

package/dist/commands/task/rendering.js

@@ -1,21 +1,42 @@
 import { stringifyApiJson } from "../../api/json.js";
 import { terminalText } from "../../platform/terminal.js";
 const identifiers = (values) => values.length === 0 ? "none" : values.map(terminalText).join(", ");
-export const renderTask = (task) => [
+const taskIdentity = (task) => [
     `ID: ${terminalText(task.id)}`,
     `Project: ${terminalText(task.projectId)}`,
     `Title: ${terminalText(task.title)}`,
-    `Description: ${terminalText(task.description)}`,
-    `Status: ${terminalText(task.status)}`,
-    `Version: ${task.version}`,
+];
+const taskPullRequests = (task) => [
+    `Pull requests: ${task.properties.pullRequests.length}`,
+    ...task.properties.pullRequests.flatMap((pullRequest, index) => [
+        `  ${index + 1}. Title: ${terminalText(pullRequest.title)}`,
+        `     URL: ${terminalText(pullRequest.url)}`,
+    ]),
+];
+const taskDependencies = (task) => [
     `Ready: ${task.ready}`,
     `Depends on: ${identifiers(task.dependsOn)}`,
     `Blocked by: ${identifiers(task.blockedBy)}`,
+];
+export const renderTask = (task) => [
+    ...taskIdentity(task),
+    `Description: ${terminalText(task.description)}`,
+    ...taskPullRequests(task),
+    `Status: ${terminalText(task.status)}`,
+    `Version: ${task.version}`,
+    ...taskDependencies(task),
     `Created: ${terminalText(task.createdAt)}`,
     `Updated: ${terminalText(task.updatedAt)}`,
     "",
 ].join("\n");
 export const renderTaskList = (tasks) => tasks.length === 0 ? "No tasks.\n" : tasks.map(renderTask).join("\n");
+export const renderTaskSummaryList = (tasks) => tasks.length === 0 ? "No tasks.\n" : tasks.map((task) => [
+    ...taskIdentity(task),
+    ...taskPullRequests(task),
+    `Status: ${terminalText(task.status)}`,
+    ...taskDependencies(task),
+    "",
+].join("\n")).join("\n");
 const renderGraphTask = (task) => [
     `ID: ${terminalText(task.id)}`,
     `Title preview: ${terminalText(task.titlePreview)}`,

package/dist/commands/task/rendering.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codetreker/daynight",
-  "version": "0.8.5",
+  "version": "0.8.13",
   "description": "A client command toolkit for development workflows",
   "repository": {
     "type": "git",
@@ -28,6 +28,7 @@
     "@inquirer/prompts": "8.7.4",
     "better-sqlite3": "13.0.3",
     "cross-spawn": "7.0.6",
+    "mime": "4.1.1",
     "read-cmd-shim": "6.0.0",
     "semver": "7.8.5",
     "which": "6.0.1",
@@ -44,5 +45,5 @@
     "vite": "8.3.4",
     "vitest": "5.0.5"
   },
-  "gitHead": "8be8ca92fcec7a6b45957665f594130898f166ed"
+  "gitHead": "38b827fe644139f4e20989cd8e7740350566fb56"
 }

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

@@ -1,95 +0,0 @@
----
-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.

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

@@ -1,155 +0,0 @@
-# Daynight commands
-
-Use the installed `daynight` CLI. Run `daynight <group> <command> --help` when the
-installed version's usage is needed. Query results are service facts; do not use
-private API calls or manually edit `.daynight/project.yml`.
-
-## Project discovery and reads
-
-```bash
-daynight task ready --json
-daynight task ready --limit 20 --json
-daynight task show <task-id> --json
-daynight task list --status in_progress --json
-daynight task graph --json
-daynight task list --ready --json
-daynight project list --json
-daynight project show <project-id> --json
-```
-
-Without `--project`, task commands resolve the current worktree's Git origin and
-verify its binding against the configured service. A unique discovery may write
-the ignored binding and update the root `.gitignore`. A missing binding is not a
-reason to skip discovery, including in a fresh linked worktree. No match,
-ambiguous matches, invalid binding, missing configuration, and network failure
-are different outcomes: report the actual diagnostic. Do not automatically
-create a project or change an existing association. The CLI's setup guidance
-owns service configuration.
-
-All task commands accept `--project <project-id>` for an explicitly established
-target; it applies to that invocation and bypasses repository binding discovery.
-Do not silently substitute a remembered project ID after discovery fails. Use
-project list/show to inspect candidates when an explicit selection is needed.
-
-`task ready` returns the first N ready tasks in `createdAt`, then ID ascending
-order. `--limit` defaults to 10 and accepts decimal integers in 1–100. It requests
-one task page without following its cursor and returns a full-task array of at
-most N elements. It accepts `--project` and `--json`, with no status or cursor
-option. A result with N tasks can have more candidates beyond it. An empty array
-means no ready work was found, not that the project has no tasks. `ready` means
-`todo` with every direct dependency done; it provides no ownership or priority.
-
-Use ready for routine work selection and show for the selected task or a known
-task being resumed. When its identity is unknown, query in-progress work as
-needed. `task list`, including `task list --ready`, reads every page and returns
-a complete array; reserve it for a complete inventory. List filters combine
-with AND. Task counts are bounded by ready, but full titles/descriptions and
-project discovery can still produce substantial output or additional requests.
-
-Use the graph when an overall dependency view is needed. It is one complete
-snapshot containing project metadata, summary, task IDs, title previews, status,
-readiness, and dependency/blocking IDs. It omits full descriptions and versions.
-`graph_limit_exceeded` reports the service's 1,000-node / 5,000-edge bound; no
-partial graph is returned. Continue with bounded ready and selected task reads.
-Other graph failures retain their own cause.
-
-## Create and update
-
-In these examples, replace IDs with observed UUIDs and `observed-version` with
-the exact decimal version from the task details used to decide the update.
-
-```bash
-daynight task create --title "Deliver sign-in" --description "Scope, acceptance, and handoff context"
-daynight task create --title "Deliver the sign-in page" --depends-on <task-id>
-daynight task update <task-id> --status in_progress --if-version <observed-version>
-daynight task update <task-id> --description "Complete revised task description" --if-version <observed-version>
-daynight task update <task-id> --depends-on <task-a> --depends-on <task-b> --if-version <observed-version>
-daynight task update <task-id> --clear-dependencies --if-version <observed-version>
-daynight task update <task-id> --description= --if-version <observed-version>
-```
-
-Create starts in `todo`. Create and update do **not** accept `--json`; their
-success output contains the confirmed resource, including its ID and version.
-Read it before planning the next mutation. Only ready, list, show, and graph task
-queries accept `--json`.
-
-An update must change at least one of title, description, status, or dependencies.
-Omitted fields remain unchanged. A provided description replaces the entire
-description; `--description=` or `--description ""` clears it. Repeated
-`--depends-on` supplies the **complete** replacement set, not additions; retain
-each still-required dependency. Values are individual UUIDs, not CSV. Use
-`--clear-dependencies` to empty the set; it conflicts with `--depends-on`.
-Text options accept `--option=value`; use that form when a value starts with a
-dash. Preserve server validation errors rather than silently altering inputs.
-
-## Preserve the version read with the task
-
-Every update based on task content must use that read's `--if-version`. Omitting
-it makes the CLI read a newer version immediately before submission, which does
-not protect a decision based on older content. Read once, decide from those
-details, and submit that version. After another mutation, obtain or use the
-confirmed resulting resource before deciding the next update.
-
-Versions are JSON numbers in `1..9223372036854775807`. Preserve the original
-decimal digits; ordinary JavaScript numeric decoding can round them. Copy the
-raw decimal token or use a lossless JSON decoder. Node.js 24 can retain the raw
-token through the reviver's `context.source`, for example:
-
-```js
-const task = JSON.parse(rawTaskJson, (key, value, context) =>
-  key === "version" && typeof value === "number" ? context.source : value,
-);
-const observedVersion = task.version; // Decimal string for --if-version.
-```
-
-On `version_conflict`, show the task again, understand the concurrent change,
-and reconsider the proposed fields against the new facts. Do not merely replace
-the version and replay the old update. A dependency refusal likewise needs its
-reported prerequisite, cross-project reference, or cycle addressed within the
-authorized scope. Setting `in_progress` never atomically claims the task.
-
-## Unconfirmed writes and failures
-
-The CLI does not retry failed writes automatically. Preserve error codes,
-request IDs, task IDs, and actual service diagnostics. A confirmed service
-refusal is a failed operation. A lost response, timeout, cancellation, or other
-unconfirmed result may have left a write applied: do not report success or
-blindly resend it.
-
-For an unconfirmed update, show the known task and compare its complete current
-fields with the intended change. If the intended state is present, report the
-observed state without claiming proof of which writer produced it. If it is
-absent or has changed, reconcile the facts and decide what remains necessary;
-any later update needs the exact version read for that decision.
-
-For an unconfirmed create, list tasks in the established project and inspect
-plausible matches with show. Match the intended title, full description,
-dependencies, and operation context; title alone is not a unique identity. A
-unique matching candidate must have its identity established before treating it
-as the created task. With zero candidates, multiple candidates, or unresolved
-identity, keep the create unconfirmed and explain the minimum needed
-reconciliation. Do not create again merely because a read returned no match.
-
-## Completion and dependencies
-
-For development and PR-delivered design/documentation tasks, inspect the hosting
-platform for every necessary delivery PR. Each must be confirmed merged and all
-acceptance criteria satisfied before this update is valid:
-
-```bash
-daynight task update <task-id> --status done --description "Complete task description, acceptance evidence, PR URLs, and merge commit references" --if-version <observed-version>
-```
-
-Use a fresh task read for this decision. Keep the complete relevant description
-when adding delivery references. If a PR remains open, even with passing CI and
-approved review, retain `in_progress` and record the PR plus remaining checks or
-waiting items. If merge visibility is unavailable, keep completion unconfirmed
-and retain `in_progress`. Use the repository host's native client or API to
-verify merge facts; do not assume a particular hosting service. Do not merge
-without the applicable authorization. Nondevelopment tasks with no PR delivery
-path use their explicit acceptance criteria.
-
-After the service confirms `done`, query `daynight task ready --json` to inspect
-newly available successors. Query the graph when overall dependency context is
-needed. Pending or unconfirmed completion must not be presented as having
-unblocked a dependent task.