@youtyan/code-viewer 0.6.3 → 0.6.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youtyan/code-viewer",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Local browser-based code and git diff viewer",
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   ],
   "scripts": {
     "build": "bun run build:web && bun run build:server",
-    "build:web": "bun build --target=browser --format=iife --outfile=web/app.js web-src/app.ts && bun build --target=browser --format=esm --outfile=web/mermaid.js web-src/mermaid-entry.ts && bun build --target=browser --format=esm --outfile=web/shiki.js web-src/shiki-entry.ts && node scripts/generate-third-party-notices.mjs",
+    "build:web": "bun build --target=browser --format=iife --outfile=web/app.js web-src/app.ts && bun build --target=browser --format=esm --outfile=web/mermaid.js web-src/mermaid-entry.ts && bun build --target=browser --format=esm --outfile=web/shiki.js web-src/shiki-entry.ts && bun build --target=browser --format=iife --outfile=web/vendor/highlight.js/highlight.min.js web-src/highlight-entry.ts && node scripts/generate-third-party-notices.mjs",
     "build:server": "bun build --target=node --format=esm --outfile=dist/code-viewer.js web-src/server/cli.ts",
     "check": "bun run typecheck",
     "typecheck": "tsc --noEmit",
@@ -49,7 +49,7 @@
     "test:postgres:down": "docker compose -f data/test/postgresql/docker-compose.yml down -v",
     "test": "bun test",
     "lint": "biome lint web-src package.json biome.jsonc",
-    "verify": "bun run check && bun run lint && bun run check:format && bun run build && bun run check:bundle && bun run test && node --check web/app.js && node --check web/mermaid.js && node --check web/shiki.js && node --check dist/code-viewer.js && node dist/code-viewer.js --help && node scripts/node-smoke.mjs",
+    "verify": "bun run check && bun run lint && bun run check:format && bun run build && bun run check:bundle && bun run test && node --check web/app.js && node --check web/mermaid.js && node --check web/shiki.js && node --check web/vendor/highlight.js/highlight.min.js && node --check dist/code-viewer.js && node dist/code-viewer.js --help && node scripts/node-smoke.mjs",
     "pack:dry": "npm pack --dry-run",
     "prepack": "bun run build",
     "prepublishOnly": "bun run verify"
@@ -68,6 +68,7 @@
     "@happy-dom/global-registrator": "^20.10.6",
     "@types/bun": "1.3.13",
     "@types/markdown-it": "14.1.2",
+    "highlight.js": "11.9.0",
     "markdown-it": "14.1.1",
     "markdown-it-anchor": "9.2.0",
     "markdown-it-footnote": "4.0.0",

package/skills/code-viewer-journal/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: code-viewer-journal
+description: Use when reading, creating, updating, claiming, completing, or linking code-viewer Work Log tasks through the `code-viewer journal` CLI. Triggers on "work log", "journal task", "task queue", "AI task", "GitHub Issue", "ワークログ", "タスク管理", "タスク一覧", "Issue紐づけ".
+---
+
+# code-viewer journal
+
+Operate code-viewer Work Log tasks through the CLI. The CLI is the contract;
+do not edit `.code-viewer/daily-journal.json` or `.code-viewer/tasks.json`
+directly.
+
+## Requirements
+
+- A code-viewer server must already be running for the repository
+  (the human starts it with: `code-viewer`). The journal CLI never starts one.
+- Run from inside the repository, or pass `--cwd <repo>`.
+- If `code-viewer` is not on PATH, prefix every command with
+  `npx -y @youtyan/code-viewer`.
+- For GitHub Issue listing or linking, `gh` must be installed. Check with:
+
+  ```sh
+  code-viewer doctor --json
+  ```
+
+  The `github.gh` row reports whether `gh --version` works. Doctor does not
+  inspect GitHub auth metadata.
+
+## Read tasks
+
+Use JSON whenever another agent step will parse the result:
+
+```sh
+code-viewer journal tasks --json
+code-viewer journal tasks --status todo --label ai-ready --json
+code-viewer journal task-next --label ai-ready --limit 5 --json
+```
+
+Guidelines:
+
+- Use `task-next` for execution order; do not invent your own sort unless the
+  human asked for it.
+- Treat labels as filters, priority as importance, and board order as human
+  ordering.
+- Do not process `draft` tasks unless the human explicitly asked for drafts.
+
+## Create tasks
+
+Create local tasks through `task-add`:
+
+```sh
+code-viewer journal task-add \
+  --title "Implement example workflow" \
+  --status todo \
+  --priority p1 \
+  --label ai-ready \
+  --label backend \
+  --body "Acceptance criteria and notes."
+```
+
+Use `--dry-run` before generated or bulk task creation:
+
+```sh
+code-viewer journal task-add --title "Check task shape" --label ai-ready --dry-run
+```
+
+## Update tasks
+
+Use `task-update` for title, status, priority, labels, due/source dates, and
+body changes:
+
+```sh
+code-viewer journal task-update <task-id> --status doing
+code-viewer journal task-update <task-id> --priority p0 --label ai-ready --label ui
+code-viewer journal task-update <task-id> --title "New title" --body "Updated notes."
+```
+
+When replacing labels, pass every label that should remain. Use
+`--clear-labels` only when the task should end with no labels.
+
+## Claim and finish
+
+Claim exactly one task before editing code:
+
+```sh
+code-viewer journal task-claim <task-id> --by agent --wip-limit 1
+```
+
+Mark the task done with a concrete verification note:
+
+```sh
+code-viewer journal task-done <task-id> --by agent --note "Implemented and verified with bun test."
+```
+
+## GitHub Issues
+
+List GitHub Issues read-only:
+
+```sh
+code-viewer journal github-issues --repo owner/repo --json
+```
+
+Link an issue to the local board without updating GitHub:
+
+```sh
+code-viewer journal task-link-issue 123 --repo owner/repo --status draft --label ai-ready
+```
+
+Rules:
+
+- Never copy the GitHub Issue body into a local task.
+- `task-link-issue` reads only metadata needed for the local link.
+- The local task receives `github` and `issue-<number>` labels automatically.
+- Put private planning notes in the local task body or a later
+  `task-update`, not in GitHub.
+
+## Daily entries
+
+Use daily entries for work not already represented by a task:
+
+```sh
+code-viewer journal add --date today --label ai --body "..."
+code-viewer journal list --limit 7 --json
+```
+
+## Full reference
+
+Before composing non-trivial commands, read the complete agent guide:
+
+```sh
+code-viewer journal agent-help
+```