@coralai/sps-cli 0.56.2 → 0.56.3

package/dist/shared/wikiPaths.js

@@ -1,89 +0,0 @@
-/**
- * @module        shared/wikiPaths
- * @description   Wiki vault 文件系统路径单一来源
- *
- * @layer         shared
- *
- * Wiki 实际位置：`<repo>/wiki/`（per-project，进 git 团队共享）。
- * 这里所有 helper 都是相对 repo 根目录的纯函数——不依赖 SPS instance state，
- * 不依赖 ProjectContext，方便测试。
- *
- * 命名规范：见 doc-28 §4 目录结构。
- *   - dot-prefix 文件（.hot.md / .log.md / .manifest.json）→ gitignored 的 per-instance 飘移
- *   - dot-prefix 目录（.raw/）→ Obsidian 视图隐藏，但进 git 共享
- *   - underscore-prefix（_attachments）→ Obsidian 约定的"非 wiki 内容"
- */
-import { resolve } from 'node:path';
-/** `<repo>/wiki/` —— Wiki vault 根目录。Obsidian Open folder 指向这里。 */
-export function wikiDir(repoDir) {
-    return resolve(repoDir, 'wiki');
-}
-/** `<repo>/wiki/WIKI.md` —— schema + sources 配置 */
-export function wikiMetaFile(repoDir) {
-    return resolve(wikiDir(repoDir), 'WIKI.md');
-}
-/** `<repo>/wiki/index.md` —— 全部 page 的 catalog */
-export function wikiIndexFile(repoDir) {
-    return resolve(wikiDir(repoDir), 'index.md');
-}
-/** `<repo>/wiki/overview.md` —— 项目执行摘要 */
-export function wikiOverviewFile(repoDir) {
-    return resolve(wikiDir(repoDir), 'overview.md');
-}
-/** `<repo>/wiki/.hot.md` —— ~500 字最近上下文（gitignored） */
-export function wikiHotFile(repoDir) {
-    return resolve(wikiDir(repoDir), '.hot.md');
-}
-/** `<repo>/wiki/.log.md` —— 操作时间序列（gitignored） */
-export function wikiLogFile(repoDir) {
-    return resolve(wikiDir(repoDir), '.log.md');
-}
-/** `<repo>/wiki/.manifest.json` —— 源 hash 跟踪表（gitignored） */
-export function wikiManifestFile(repoDir) {
-    return resolve(wikiDir(repoDir), '.manifest.json');
-}
-/** `<repo>/wiki/.raw/` —— 用户外部添加的源材料（committed by default） */
-export function wikiRawDir(repoDir) {
-    return resolve(wikiDir(repoDir), '.raw');
-}
-/** `<repo>/wiki/_attachments/` —— 嵌入图片（committed） */
-export function wikiAttachmentsDir(repoDir) {
-    return resolve(wikiDir(repoDir), '_attachments');
-}
-/**
- * `<repo>/wiki/<type>s/` —— 特定类型 page 目录。
- * 名约定：复数后缀（modules/, concepts/, decisions/, lessons/, sources/）。
- */
-export function wikiPageDir(repoDir, type) {
-    return resolve(wikiDir(repoDir), `${type}s`);
-}
-/** `<repo>/wiki/<type>s/<title>.md` —— 单页文件路径 */
-export function wikiPageFile(repoDir, type, title) {
-    return resolve(wikiPageDir(repoDir, type), `${title}.md`);
-}
-/** Page id 格式：`<type>s/<title>`（不含 .md）。用作 frontmatter related / sources 字段 */
-export function wikiPageId(type, title) {
-    return `${type}s/${title}`;
-}
-/**
- * 从绝对路径反推 (type, title) —— 用于 listing 时把文件名解析回 page 标识。
- * 只接受 wikiDir 子路径，否则返 null。
- */
-export function parseWikiPageId(repoDir, filePath) {
-    const root = wikiDir(repoDir);
-    const PAGE_TYPES = ['module', 'concept', 'decision', 'lesson', 'source'];
-    for (const t of PAGE_TYPES) {
-        const dir = wikiPageDir(repoDir, t);
-        if (filePath.startsWith(dir + '/') && filePath.endsWith('.md')) {
-            const rel = filePath.slice(dir.length + 1, -3);
-            // 不允许子目录嵌套——title 不含路径分隔符
-            if (rel.includes('/'))
-                return null;
-            return { type: t, title: rel, pageId: wikiPageId(t, rel) };
-        }
-    }
-    // 不在已知 type dir 下；可能是 index/overview/hot/log 等顶层文件
-    void root;
-    return null;
-}
-//# sourceMappingURL=wikiPaths.js.map

package/dist/shared/wikiPaths.js.map

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

package/project-template/.claude/CLAUDE.md

@@ -1,66 +0,0 @@
-# Project Rules (Claude Code Worker)
-
-<!--
-  This file is auto-generated by `sps project init` / `sps doctor --fix`.
-  Edit it to add project-specific rules. SPS will not overwrite it once it exists.
--->
-
-## Scope
-
-- Work only in the current project directory.
-- Do NOT read or modify files outside this directory.
-- Do NOT explore `~/.coral/projects/...` or other system paths.
-
-## SPS Pipeline Context
-
-This project is driven by SPS (Smart Pipeline System). Each card is a task.
-When you are launched as a worker, two env vars identify your stable context:
-
-- `$SPS_PROJECT` — project name (stable across card reuse)
-- `$SPS_WORKER_SLOT` — worker slot name (stable across card reuse)
-
-Per-card information (card id, stage name, title) is **not** in env. POSIX
-freezes env at spawn, so any per-card value would go stale once the claude
-process is reused for the next card. If you need the current card info,
-read the marker file or use the `sps` CLI:
-
-- Marker file: `~/.coral/projects/$SPS_PROJECT/runtime/worker-$SPS_WORKER_SLOT-current.json`
-- CLI: `sps card dashboard $SPS_PROJECT` (or the command your task prompt already passed to you)
-
-## Card lifecycle labels (for reference — all managed automatically)
-
-Each card moves through these labels during its pipeline run:
-
-- `AI-PIPELINE` — added at `sps card add`; the pipeline admission mark
-- `CLAIMED` — added when SPS claims a worker slot for this card
-- `STARTED-<stage>` — added automatically on each prompt submit via the
-  **UserPromptSubmit** hook. This is the "ACK signal" that proves Claude
-  received the prompt. If this label doesn't appear within
-  `WORKER_ACK_TIMEOUT_S` seconds after dispatch, SPS's MonitorEngine flags
-  `ACK-TIMEOUT` and StageEngine kills the worker + retries.
-- `COMPLETED-<stage>` — added on turn end via the **Stop hook**. Tells SPS
-  to advance the card to the next stage (or Done).
-
-You do NOT need to manually update card state, move the card between
-columns, or commit on behalf of the pipeline. The hooks do it all.
-
-**Honesty note**: If you declare "done" without actually implementing the
-work, the pipeline will still advance (the Stop hook fires regardless). The
-user relies on your honesty here.
-
-## Memory
-
-- Claude's **auto memory** is enabled and stored under
-  `~/.coral/projects/$SPS_PROJECT/memory/`. You write to `MEMORY.md` there
-  to persist knowledge across sessions.
-- Use `sps memory add $SPS_PROJECT --type ...` to write structured SPS memories
-  (conventions, decisions, lessons) for the human to curate.
-
-## Git (if the project uses git)
-
-- Claude handles all git operations itself (commit, push, etc.).
-- SPS does NOT intervene in git workflows or conflict resolution.
-
-## Project-specific rules
-
-<!-- Add your own conventions, architecture notes, and constraints below. -->

package/project-template/.claude/hooks/start.sh

@@ -1,44 +0,0 @@
-#!/bin/bash
-# SPS Pipeline Worker — UserPromptSubmit hook (v0.42.0+)
-#
-# Triggered synchronously before Claude processes each prompt. Used by SPS
-# to label the card with STARTED-<stage> — this is the "ACK signal" that
-# proves Claude received the prompt. Also injects skill hints based on the
-# card's `skills` field (or legacy skill:* labels).
-#
-# Phase 2 is user-customizable: add audit logging, request rate limiting,
-# prompt enrichment, etc. without touching Phase 1.
-#
-# Env vars (stable across claude process reuse):
-#   SPS_PROJECT       Project name
-#   SPS_WORKER_SLOT   Worker slot name
-#
-# Per-card info (card id, stage, title) is NOT in env — POSIX env freezes at
-# spawn. Hook scripts must read the marker file instead. Phase 1 does this
-# automatically via `sps hook user-prompt-submit`.
-
-set -e
-
-# ─── Phase 1: SPS official action (do NOT remove) ────────────────────
-# Reads marker file → addLabel STARTED-<stage> + emit skill hints.
-sps hook user-prompt-submit
-
-# ─── Phase 2: User-customizable actions (edit as needed) ────────────
-
-# Example: audit log of every prompt submission.
-# if [ -n "$SPS_PROJECT" ] && [ -n "$SPS_WORKER_SLOT" ]; then
-#   echo "$(date): prompt submitted to $SPS_PROJECT/$SPS_WORKER_SLOT" \
-#     >> "$CLAUDE_PROJECT_DIR/.sps/user-prompts.log"
-# fi
-
-# Example: rate limiting (block if too many prompts in a window).
-# count=$(find "$CLAUDE_PROJECT_DIR/.sps" -name 'last-prompt-*' -mmin -1 | wc -l)
-# if [ "$count" -gt 30 ]; then
-#   echo '{"decision":"block","reason":"rate limit exceeded (>30 prompts/min)"}'
-#   exit 0
-# fi
-
-# Example: prompt-to-Slack mirror for team visibility.
-# curl -sfX POST "$SLACK_WEBHOOK" -d "{\"text\":\"[$SPS_PROJECT] new prompt\"}"
-
-exit 0

package/project-template/.claude/hooks/stop.sh

@@ -1,54 +0,0 @@
-#!/bin/bash
-# SPS Pipeline Worker — Stop hook
-#
-# Triggered when Claude finishes its current turn. The pipeline depends on
-# Phase 1 to advance card state. Phase 2+ is user-customizable.
-#
-# Env vars (set by SPS worker at spawn time, frozen for the process lifetime):
-#   SPS_PROJECT       Project name (stable across card reuse)
-#   SPS_WORKER_SLOT   Worker slot name (stable across card reuse)
-#
-# These two env vars form the index to locate the per-slot marker file:
-#   ~/.coral/projects/$SPS_PROJECT/runtime/worker-$SPS_WORKER_SLOT-current.json
-#
-# Per-card info (card id, stage name, card title) is intentionally NOT in env.
-# POSIX freezes env at spawn; when the claude process is reused for the next
-# card, any per-card env would go stale. Always read the marker file (or use
-# `sps` CLI) to get current card information.
-#
-# Claude-native env also available:
-#   CLAUDE_PROJECT_DIR, CLAUDE_SESSION_ID
-
-set -e
-
-# ─── Phase 1: SPS official action (do NOT remove) ────────────────────
-# Mark the card complete so pipeline can advance state.
-# We call mark-complete WITHOUT a seq — the command reads the per-slot
-# current-card marker file (written by the worker manager on each dispatch)
-# to get the authoritative current card. This is the only way to be correct
-# when the same claude process handles multiple cards in sequence.
-if [ -n "$SPS_PROJECT" ] && [ -n "$SPS_WORKER_SLOT" ]; then
-  # 绝不让 mark-complete 失败阻塞 stop:Stop hook 非零退出会被 claude 当成"别停、继续",
-  # 导致 worker 被无限重戳("Acknowledged." 死循环)。失败仅记 stderr(MonitorEngine 有超时兜底)。
-  sps card mark-complete "$SPS_PROJECT" || echo "[stop.sh] mark-complete non-fatal failure — allowing stop" >&2
-fi
-
-# ─── Phase 2: User-customizable actions (edit as needed) ────────────
-
-# Example: record the session transcript location for later audit.
-# if [ -n "$CLAUDE_SESSION_ID" ] && [ -n "$SPS_CARD_ID" ]; then
-#   echo "$CLAUDE_SESSION_ID" >> "$CLAUDE_PROJECT_DIR/.sps/session-log.txt"
-# fi
-
-# Example: third-party knowledge base capture.
-# if command -v your-kb-cli &>/dev/null; then
-#   your-kb-cli capture --project "$SPS_PROJECT" --session "$CLAUDE_SESSION_ID"
-# fi
-
-# Example: notify on completion.
-# sps notify matrix "[$SPS_PROJECT] seq $SPS_CARD_ID ($SPS_STAGE) done"
-
-# Example: post-task CI trigger.
-# curl -sfX POST "$CI_WEBHOOK" -d "{\"project\":\"$SPS_PROJECT\",\"card\":\"$SPS_CARD_ID\"}"
-
-exit 0

package/project-template/.claude/settings.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "hooks": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/stop.sh"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/start.sh"
-          }
-        ]
-      }
-    ]
-  },
-  "attribution": {
-    "commit": "",
-    "pr": ""
-  },
-  "companyAnnouncements": [
-    "🔧 SPS Pipeline Worker — completion is declared via Stop hook \u2192 COMPLETED-<stage> label"
-  ]
-}

package/project-template/.claude/settings.local.json.template

@@ -1,3 +0,0 @@
-{
-  "autoMemoryDirectory": "~/.coral/projects/__PROJECT__/memory"
-}

package/project-template/README.md

@@ -1,10 +0,0 @@
-# Project Template
-
-This folder is copied into `~/.coral/projects/<project-name>/` for each new pipeline-managed project.
-
-Contents:
-- `conf` — project-specific configuration
-- `deploy.sh` — optional project-local deploy entrypoint
-- `batch_scheduler.sh` — project-local Planning → Backlog scheduler
-- `logs/` — runtime logs
-- `pm_meta/` — local PM metadata store (used especially for Plane)

package/project-template/batch_scheduler.sh

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-# batch_scheduler.sh — project-local cron entry point
-# Delegates to the SPS CLI tick command.
-set -euo pipefail
-
-PROJECT_NAME="$(basename "$(cd "$(dirname "$0")" && pwd)")"
-
-exec sps tick "$PROJECT_NAME" "$@"

package/project-template/conf.template

@@ -1,61 +0,0 @@
-# ── 项目基础信息 ─────────────────────────────────────────────────
-export PROJECT_NAME="__PROJECT_NAME__"
-
-# ── 路径配置（可选，不设置则使用默认值）───────────────────────────
-# 业务代码仓库目录（默认: ~/projects/<project>）
-# export PROJECT_DIR="$HOME/projects/__PROJECT_NAME__"
-# Worker worktree 根目录（默认: ~/.coral/worktrees/）
-# export WORKTREE_DIR="$HOME/.coral/worktrees"
-
-# ── GitLab（项目特有）──────────────────────────────────────────
-# GITLAB_URL / GITLAB_TOKEN 从全局 ~/.coral/env 继承，此处不重复
-export GITLAB_PROJECT="__GITLAB_PROJECT__"
-# GITLAB_PROJECT_ID 可选 — 留空则通过 GITLAB_PROJECT 路径自动查询
-# export GITLAB_PROJECT_ID=""
-export GITLAB_MERGE_BRANCH="develop"
-
-# ── PM Backend ───────────────────────────────────────────────────
-export PM_TOOL="plane"
-
-# ── Trello（PM_TOOL=trello 时填写）───────────────────────────────
-# TRELLO_API_KEY / TRELLO_TOKEN 从全局 ~/.coral/env 继承
-# export TRELLO_BOARD_ID=""
-# export TRELLO_LIST_PLANNING=""
-# export TRELLO_LIST_BACKLOG=""
-# export TRELLO_LIST_TODO=""
-# export TRELLO_LIST_INPROGRESS=""
-# export TRELLO_LIST_QA=""
-# export TRELLO_LIST_DONE=""
-# export TRELLO_ACCOUNT=""
-
-# ── Plane（PM_TOOL=plane 时填写）────────────────────────────────
-# PLANE_URL / PLANE_API_KEY / PLANE_WORKSPACE_SLUG 从全局 ~/.coral/env 继承
-export PLANE_PROJECT_ID="__PLANE_PROJECT_ID__"
-export PLANE_STATE_PLANNING="__PLANE_STATE_PLANNING__"
-export PLANE_STATE_BACKLOG="__PLANE_STATE_BACKLOG__"
-export PLANE_STATE_TODO="__PLANE_STATE_TODO__"
-export PLANE_STATE_INPROGRESS="__PLANE_STATE_INPROGRESS__"
-export PLANE_STATE_QA="__PLANE_STATE_QA__"
-export PLANE_STATE_DONE="__PLANE_STATE_DONE__"
-
-# ── Pipeline ─────────────────────────────────────────────────────
-export PIPELINE_LABEL="AI-PIPELINE"
-export MR_MODE="none"
-
-# ── Worker / Agent ───────────────────────────────────────────────
-# claude is the only supported CLI; no selector exposed.
-export MAX_CONCURRENT_WORKERS=3
-# export MAX_ACTIONS_PER_TICK=1
-# export WORKER_RESTART_LIMIT=2
-# export DEFAULT_WORKER_SKILLS="senior"
-
-# ── 超时与策略（可选，以下为默认值）──────────────────────────────
-# export INPROGRESS_TIMEOUT_HOURS=8
-# export MONITOR_AUTO_QA=false
-# export CONFLICT_DEFAULT=serial
-# export TICK_LOCK_TIMEOUT_MINUTES=30
-
-# ── 通知（项目特有 — 不同项目可发不同房间）──────────────────────
-# MATRIX_HOMESERVER / MATRIX_ACCESS_TOKEN 从全局 ~/.coral/env 继承
-# 如果项目需要发到特定房间，设置 MATRIX_ROOM_ID：
-# export MATRIX_ROOM_ID=""

package/project-template/deploy.sh

@@ -1,3 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-echo "Deployment not configured for ${PROJECT_NAME:-unknown-project}"