autosnippet 3.2.21 → 3.3.2

package/dist/lib/domain/task/Task.d.ts

@@ -1,140 +0,0 @@
-export interface TaskProps {
-    id?: string | null;
-    parentId?: string | null;
-    childSeq?: number;
-    title?: string;
-    description?: string;
-    design?: string;
-    acceptance?: string;
-    notes?: string;
-    status?: string;
-    priority?: number;
-    taskType?: string;
-    closeReason?: string;
-    failCount?: number;
-    lastFailReason?: string;
-    contentHash?: string | null;
-    assignee?: string;
-    createdBy?: string;
-    createdAt?: number;
-    updatedAt?: number;
-    closedAt?: number | null;
-    knowledgeContext?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-interface TaskRow {
-    id?: unknown;
-    parent_id?: unknown;
-    child_seq?: unknown;
-    title?: unknown;
-    description?: unknown;
-    design?: unknown;
-    acceptance?: unknown;
-    notes?: unknown;
-    status?: unknown;
-    priority?: unknown;
-    task_type?: unknown;
-    close_reason?: unknown;
-    content_hash?: unknown;
-    fail_count?: unknown;
-    last_fail_reason?: unknown;
-    assignee?: unknown;
-    created_by?: unknown;
-    created_at?: unknown;
-    updated_at?: unknown;
-    closed_at?: unknown;
-    metadata?: unknown;
-    parentId?: unknown;
-    childSeq?: unknown;
-    taskType?: unknown;
-    closeReason?: unknown;
-    contentHash?: unknown;
-    failCount?: unknown;
-    lastFailReason?: unknown;
-    createdBy?: unknown;
-    createdAt?: unknown;
-    updatedAt?: unknown;
-    closedAt?: unknown;
-    [key: string]: unknown;
-}
-/**
- * Task — 任务实体
- *
- * 参考 Beads Issue 结构，裁剪为 AutoSnippet 所需的核心字段。
- *
- * 字段分组：
- *   Core Identification → id, parentId, contentHash
- *   Content             → title, description, design, acceptance
- *   Status & Workflow   → status, priority, taskType
- *   Assignment          → assignee, claimedAt
- *   Timestamps          → createdAt, updatedAt, closedAt
- *   Knowledge Bridge    → knowledgeContext (运行时，不持久化)
- */
-export declare class Task {
-    acceptance: string;
-    assignee: string;
-    childSeq: number;
-    closeReason: string;
-    closedAt: number | null;
-    contentHash: string | null;
-    createdAt: number;
-    createdBy: string;
-    description: string;
-    design: string;
-    failCount: number;
-    id: string | null;
-    lastFailReason: string;
-    metadata: Record<string, unknown>;
-    notes: string;
-    parentId: string | null;
-    priority: number;
-    status: string;
-    taskType: string;
-    title: string;
-    updatedAt: number;
-    knowledgeContext: Record<string, unknown> | null;
-    constructor(props?: TaskProps);
-    claim(assignee?: string): void;
-    close(reason?: string): void;
-    reopen(): void;
-    pin(): void;
-    unpin(reason?: string): void;
-    defer(reason?: string): void;
-    fail(reason: string): void;
-    /**
-     * 计算内容哈希（用于去重检测）
-     * 相同标题+描述+类型 = 重复任务
-     */
-    computeContentHash(): string;
-    validate(): boolean;
-    /** 是否有效（快捷校验） */
-    isValid(): boolean;
-    toJSON(): {
-        knowledgeContext?: Record<string, unknown> | undefined;
-        id: string | null;
-        parentId: string | null;
-        title: string;
-        description: string;
-        design: string;
-        acceptance: string;
-        notes: string;
-        status: string;
-        priority: number;
-        taskType: string;
-        closeReason: string;
-        assignee: string;
-        createdBy: string;
-        createdAt: number;
-        updatedAt: number;
-        closedAt: number | null;
-        contentHash: string | null;
-        failCount: number;
-        lastFailReason: string;
-        metadata: Record<string, unknown>;
-    };
-    static fromJSON(data: unknown): Task;
-    /** 从数据库行构造 Task（snake_case → camelCase） */
-    static fromRow(row: TaskRow | null): Task | null;
-}
-export default Task;

package/dist/lib/domain/task/Task.js

@@ -1,254 +0,0 @@
-import { createHash } from 'node:crypto';
-/**
- * Task — 任务实体
- *
- * 参考 Beads Issue 结构，裁剪为 AutoSnippet 所需的核心字段。
- *
- * 字段分组：
- *   Core Identification → id, parentId, contentHash
- *   Content             → title, description, design, acceptance
- *   Status & Workflow   → status, priority, taskType
- *   Assignment          → assignee, claimedAt
- *   Timestamps          → createdAt, updatedAt, closedAt
- *   Knowledge Bridge    → knowledgeContext (运行时，不持久化)
- */
-export class Task {
-    acceptance;
-    assignee;
-    childSeq;
-    closeReason;
-    closedAt;
-    contentHash;
-    createdAt;
-    createdBy;
-    description;
-    design;
-    failCount;
-    id;
-    lastFailReason;
-    metadata;
-    notes;
-    parentId;
-    priority;
-    status;
-    taskType;
-    title;
-    updatedAt;
-    knowledgeContext;
-    constructor(props = {}) {
-        // ── Core Identification ──
-        this.id = props.id || null;
-        this.parentId = props.parentId || null;
-        this.childSeq = props.childSeq || 0;
-        // ── Content ──
-        this.title = props.title || '';
-        this.description = props.description || '';
-        this.design = props.design || '';
-        this.acceptance = props.acceptance || '';
-        this.notes = props.notes || '';
-        // ── Status & Workflow ──
-        this.status = props.status || 'open';
-        this.priority = props.priority ?? 2;
-        this.taskType = props.taskType || 'task';
-        this.closeReason = props.closeReason || '';
-        this.failCount = props.failCount || 0;
-        this.lastFailReason = props.lastFailReason || '';
-        // ── Content Hash (去重) ──
-        this.contentHash = props.contentHash || null;
-        // ── Assignment ──
-        this.assignee = props.assignee || '';
-        this.createdBy = props.createdBy || 'agent';
-        // ── Timestamps ──
-        this.createdAt = props.createdAt || Math.floor(Date.now() / 1000);
-        this.updatedAt = props.updatedAt || Math.floor(Date.now() / 1000);
-        this.closedAt = props.closedAt || null;
-        // ── Knowledge Bridge (运行时填充, 不持久化) ──
-        this.knowledgeContext = props.knowledgeContext || null;
-        // ── Metadata (可扩展 JSON) ──
-        this.metadata = props.metadata || {};
-    }
-    // ── 生命周期方法 ──
-    claim(assignee = 'agent') {
-        if (this.status === 'closed') {
-            throw new Error('Cannot claim a closed task');
-        }
-        if (this.status === 'pinned') {
-            throw new Error('Cannot claim a pinned decision. Use unpin_decision or revise_decision instead.');
-        }
-        this.status = 'in_progress';
-        this.assignee = assignee;
-        this.updatedAt = Math.floor(Date.now() / 1000);
-    }
-    close(reason = 'Completed') {
-        if (this.status === 'pinned') {
-            throw new Error('Cannot close a pinned decision directly. Use unpin_decision or revise_decision instead.');
-        }
-        this.status = 'closed';
-        this.closeReason = reason;
-        this.closedAt = Math.floor(Date.now() / 1000);
-        this.updatedAt = this.closedAt;
-    }
-    reopen() {
-        this.status = 'open';
-        this.closedAt = null;
-        this.closeReason = '';
-        this.updatedAt = Math.floor(Date.now() / 1000);
-    }
-    pin() {
-        if (this.status === 'closed') {
-            throw new Error('Cannot pin a closed task');
-        }
-        this.status = 'pinned';
-        this.updatedAt = Math.floor(Date.now() / 1000);
-    }
-    unpin(reason = '') {
-        if (this.status !== 'pinned') {
-            throw new Error('Can only unpin a pinned task');
-        }
-        this.status = 'closed';
-        this.closeReason = reason || 'Unpinned by user';
-        this.closedAt = Math.floor(Date.now() / 1000);
-        this.updatedAt = this.closedAt;
-    }
-    defer(reason = '') {
-        if (this.status === 'pinned') {
-            throw new Error('Cannot defer a pinned decision. Use unpin_decision or revise_decision instead.');
-        }
-        this.status = 'deferred';
-        if (reason) {
-            this.notes = `[deferred] ${reason}`;
-        }
-        this.updatedAt = Math.floor(Date.now() / 1000);
-    }
-    fail(reason) {
-        if (this.status === 'closed') {
-            throw new Error('Cannot fail a closed task');
-        }
-        if (this.status === 'pinned') {
-            throw new Error('Cannot fail a pinned decision. Use unpin_decision or revise_decision instead.');
-        }
-        this.status = 'open';
-        this.failCount += 1;
-        this.lastFailReason = reason || 'Unknown failure';
-        this.assignee = '';
-        this.updatedAt = Math.floor(Date.now() / 1000);
-    }
-    /**
-     * 计算内容哈希（用于去重检测）
-     * 相同标题+描述+类型 = 重复任务
-     */
-    computeContentHash() {
-        const content = `${this.title}|${this.description}|${this.taskType}`;
-        this.contentHash = createHash('sha256').update(content).digest('hex').substring(0, 12);
-        return this.contentHash;
-    }
-    // ── 校验 ──
-    validate() {
-        if (!this.title || this.title.length === 0) {
-            throw new Error('title is required');
-        }
-        if (this.title.length > 500) {
-            throw new Error(`title must be 500 characters or less (got ${this.title.length})`);
-        }
-        if (typeof this.priority !== 'number' ||
-            !Number.isInteger(this.priority) ||
-            this.priority < 0 ||
-            this.priority > 4) {
-            throw new Error(`priority must be an integer between 0 and 4 (got ${this.priority})`);
-        }
-        const validStatuses = ['open', 'in_progress', 'deferred', 'closed', 'pinned'];
-        if (!validStatuses.includes(this.status)) {
-            throw new Error(`invalid status: ${this.status}`);
-        }
-        const validTypes = ['epic', 'task', 'bug', 'chore', 'decision'];
-        if (!validTypes.includes(this.taskType)) {
-            throw new Error(`invalid task type: ${this.taskType}`);
-        }
-        if (this.status === 'closed' && !this.closedAt) {
-            throw new Error('closed tasks must have closedAt timestamp');
-        }
-        return true;
-    }
-    /** 是否有效（快捷校验） */
-    isValid() {
-        try {
-            this.validate();
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    toJSON() {
-        return {
-            id: this.id,
-            parentId: this.parentId,
-            title: this.title,
-            description: this.description,
-            design: this.design,
-            acceptance: this.acceptance,
-            notes: this.notes,
-            status: this.status,
-            priority: this.priority,
-            taskType: this.taskType,
-            closeReason: this.closeReason,
-            assignee: this.assignee,
-            createdBy: this.createdBy,
-            createdAt: this.createdAt,
-            updatedAt: this.updatedAt,
-            closedAt: this.closedAt,
-            contentHash: this.contentHash,
-            failCount: this.failCount,
-            lastFailReason: this.lastFailReason,
-            metadata: this.metadata,
-            ...(this.knowledgeContext ? { knowledgeContext: this.knowledgeContext } : {}),
-        };
-    }
-    static fromJSON(data) {
-        if (!data) {
-            return new Task();
-        }
-        return new Task(data);
-    }
-    /** 从数据库行构造 Task（snake_case → camelCase） */
-    static fromRow(row) {
-        if (!row) {
-            return null;
-        }
-        // 兼容 raw SQL 返回的 snake_case 和 Drizzle 返回的 camelCase
-        return new Task({
-            id: row.id,
-            parentId: (row.parent_id ?? row.parentId),
-            childSeq: (row.child_seq ?? row.childSeq),
-            title: row.title,
-            description: row.description,
-            design: row.design,
-            acceptance: row.acceptance,
-            notes: row.notes,
-            status: row.status,
-            priority: row.priority,
-            taskType: (row.task_type ?? row.taskType),
-            closeReason: (row.close_reason ?? row.closeReason),
-            contentHash: (row.content_hash ?? row.contentHash),
-            failCount: (row.fail_count ?? row.failCount),
-            lastFailReason: (row.last_fail_reason ?? row.lastFailReason),
-            assignee: row.assignee,
-            createdBy: (row.created_by ?? row.createdBy),
-            createdAt: (row.created_at ?? row.createdAt),
-            updatedAt: (row.updated_at ?? row.updatedAt),
-            closedAt: (row.closed_at ?? row.closedAt),
-            metadata: (() => {
-                if (typeof row.metadata !== 'string') {
-                    return row.metadata || {};
-                }
-                try {
-                    return JSON.parse(row.metadata);
-                }
-                catch {
-                    return {};
-                }
-            })(),
-        });
-    }
-}
-export default Task;

package/dist/lib/domain/task/TaskDependency.d.ts

@@ -1,23 +0,0 @@
-/**
- * 任务依赖类型
- *
- * Phase 1 引入 6 种核心依赖类型，按 "是否影响就绪" 分为两组。
- *
- *   阻塞型: blocks, waits-for        → 影响 ready 计算
- *   结构型: parent-child              → 仅层次关系
- *   关联型: discovered-from, related, knowledge-ref → 不影响 ready
- */
-export declare const DepType: Readonly<{
-    BLOCKS: "blocks";
-    WAITS_FOR: "waits-for";
-    PARENT_CHILD: "parent-child";
-    DISCOVERED_FROM: "discovered-from";
-    RELATED: "related";
-    KNOWLEDGE_REF: "knowledge-ref";
-    SUPERSEDES: "supersedes";
-}>;
-/** 判断依赖类型是否影响就绪计算 */
-export declare function affectsReadyWork(depType: string): boolean;
-/** 判断依赖类型是否合法 */
-export declare function isValidDepType(depType: string): boolean;
-export default DepType;

package/dist/lib/domain/task/TaskDependency.js

@@ -1,34 +0,0 @@
-/**
- * 任务依赖类型
- *
- * Phase 1 引入 6 种核心依赖类型，按 "是否影响就绪" 分为两组。
- *
- *   阻塞型: blocks, waits-for        → 影响 ready 计算
- *   结构型: parent-child              → 仅层次关系
- *   关联型: discovered-from, related, knowledge-ref → 不影响 ready
- */
-export const DepType = Object.freeze({
-    // ── 阻塞型（影响 ready 计算）──
-    BLOCKS: 'blocks',
-    WAITS_FOR: 'waits-for',
-    // ── 结构型（建立层次，不影响 ready）──
-    PARENT_CHILD: 'parent-child',
-    // ── 关联型（不影响 ready，构建知识/因果图谱）──
-    DISCOVERED_FROM: 'discovered-from',
-    RELATED: 'related',
-    KNOWLEDGE_REF: 'knowledge-ref', // AutoSnippet 独有：关联知识条目
-    SUPERSEDES: 'supersedes', // 决策演化链：新决策取代旧决策
-});
-/** 所有合法的依赖类型值列表 */
-const ALL_DEP_TYPES = Object.values(DepType);
-/** 影响就绪计算的依赖类型集合 */
-const BLOCKING_TYPES = new Set([DepType.BLOCKS, DepType.WAITS_FOR]);
-/** 判断依赖类型是否影响就绪计算 */
-export function affectsReadyWork(depType) {
-    return BLOCKING_TYPES.has(depType);
-}
-/** 判断依赖类型是否合法 */
-export function isValidDepType(depType) {
-    return ALL_DEP_TYPES.includes(depType);
-}
-export default DepType;

package/dist/lib/domain/task/TaskIdGenerator.d.ts

@@ -1,40 +0,0 @@
-import type { DrizzleDB } from '../../infrastructure/database/drizzle/index.js';
-/**
- * TaskIdGenerator — 短 Hash ID 生成器
- *
- * 渐进式长度扩展（随任务数增长自动加长）：
- *   0-500 tasks  → 4 字符  (16^4 = 65,536 组合)
- *   500-1500     → 5 字符  (16^5 = 1,048,576)
- *   1500+        → 6 字符  (16^6 = 16,777,216)
- *
- * 前缀 'asd-'，与 Beads 的 'bd-' 区分。
- */
-interface DbHandle {
-    prepare(sql: string): {
-        get(...params: unknown[]): Record<string, unknown> | undefined;
-        run(...params: unknown[]): unknown;
-    };
-}
-export declare class TaskIdGenerator {
-    #private;
-    _db: DbHandle;
-    _prefix: string;
-    /** @param db raw SQLite handle */
-    constructor(db: DbHandle, drizzle?: DrizzleDB);
-    /**
-     * 生成新的短 Hash ID
-     * @returns 如 'asd-a1b2'
-     */
-    generate(): string;
-    /**
-     * 生成子任务 ID
-     * asd-a3f8 → asd-a3f8.1, asd-a3f8.2, ...
-     * ★ Drizzle 类型安全 SELECT + UPDATE
-     */
-    generateChild(parentId: string): string;
-    /** ★ Drizzle 类型安全 COUNT */
-    private _getTaskCount;
-    /** ★ Drizzle 类型安全 EXISTS */
-    private _exists;
-}
-export default TaskIdGenerator;

package/dist/lib/domain/task/TaskIdGenerator.js

@@ -1,75 +0,0 @@
-import { createHash } from 'node:crypto';
-import { eq, sql } from 'drizzle-orm';
-import { v4 as uuidv4 } from 'uuid';
-import { getDrizzle } from '../../infrastructure/database/drizzle/index.js';
-import { tasks } from '../../infrastructure/database/drizzle/schema.js';
-export class TaskIdGenerator {
-    _db;
-    _prefix;
-    #drizzle;
-    /** @param db raw SQLite handle */
-    constructor(db, drizzle) {
-        this._db = db;
-        this._prefix = 'asd';
-        this.#drizzle = drizzle ?? getDrizzle();
-    }
-    /**
-     * 生成新的短 Hash ID
-     * @returns 如 'asd-a1b2'
-     */
-    generate() {
-        const taskCount = this._getTaskCount();
-        const hashLen = taskCount < 500 ? 4 : taskCount < 1500 ? 5 : 6;
-        // 尝试生成无冲突 ID（最多 10 次）
-        for (let attempt = 0; attempt < 10; attempt++) {
-            const uuid = uuidv4();
-            const hash = createHash('sha256').update(uuid).digest('hex');
-            const shortHash = hash.substring(0, hashLen);
-            const id = `${this._prefix}-${shortHash}`;
-            if (!this._exists(id)) {
-                return id;
-            }
-        }
-        // 回退到 6 位 + 冲突检查 + 终极 8 位兜底
-        const uuid = uuidv4();
-        const hash = createHash('sha256').update(uuid).digest('hex');
-        const fallbackId = `${this._prefix}-${hash.substring(0, 6)}`;
-        if (!this._exists(fallbackId)) {
-            return fallbackId;
-        }
-        return `${this._prefix}-${hash.substring(0, 8)}`;
-    }
-    /**
-     * 生成子任务 ID
-     * asd-a3f8 → asd-a3f8.1, asd-a3f8.2, ...
-     * ★ Drizzle 类型安全 SELECT + UPDATE
-     */
-    generateChild(parentId) {
-        const parent = this.#drizzle
-            .select({ childSeq: tasks.childSeq })
-            .from(tasks)
-            .where(eq(tasks.id, parentId))
-            .get();
-        if (!parent) {
-            throw new Error(`Parent task not found: ${parentId}`);
-        }
-        const nextSeq = (parent.childSeq || 0) + 1;
-        this.#drizzle.update(tasks).set({ childSeq: nextSeq }).where(eq(tasks.id, parentId)).run();
-        return `${parentId}.${nextSeq}`;
-    }
-    /** ★ Drizzle 类型安全 COUNT */
-    _getTaskCount() {
-        const row = this.#drizzle.select({ cnt: sql `COUNT(*)` }).from(tasks).get();
-        return row?.cnt || 0;
-    }
-    /** ★ Drizzle 类型安全 EXISTS */
-    _exists(id) {
-        const row = this.#drizzle
-            .select({ x: sql `1` })
-            .from(tasks)
-            .where(eq(tasks.id, id))
-            .get();
-        return !!row;
-    }
-}
-export default TaskIdGenerator;

package/dist/lib/domain/task/index.d.ts

@@ -1,4 +0,0 @@
-/** Task Domain — 统一导出 */
-export { Task } from './Task.js';
-export { affectsReadyWork, DepType, isValidDepType } from './TaskDependency.js';
-export { TaskIdGenerator } from './TaskIdGenerator.js';

package/dist/lib/domain/task/index.js

@@ -1,4 +0,0 @@
-/** Task Domain — 统一导出 */
-export { Task } from './Task.js';
-export { affectsReadyWork, DepType, isValidDepType } from './TaskDependency.js';
-export { TaskIdGenerator } from './TaskIdGenerator.js';

package/dist/lib/http/routes/snippets.js

@@ -1,49 +0,0 @@
-/**
- * Snippets API 路由
- * Snippet = Recipe 的附属产物，从 Recipe 实时生成，不存 DB
- */
-import express from 'express';
-import { getServiceContainer } from '../../injection/ServiceContainer.js';
-import { NotFoundError } from '../../shared/errors/index.js';
-const router = express.Router();
-/**
- * GET /api/v1/snippets
- * 从 Recipe 实时生成 Snippet 列表
- */
-router.get('/', async (req, res) => {
-    const container = getServiceContainer();
-    const snippetFactory = container.get('snippetFactory');
-    const { language, category, keyword } = req.query;
-    const filters = {};
-    if (language) {
-        filters.language = String(language);
-    }
-    if (category) {
-        filters.category = String(category);
-    }
-    if (keyword) {
-        filters.keyword = String(keyword);
-    }
-    const snippets = await snippetFactory.listSnippets(filters);
-    res.json({
-        success: true,
-        data: {
-            snippets,
-            total: snippets.length,
-        },
-    });
-});
-/**
- * GET /api/v1/snippets/:id
- * 从单个 Recipe 实时生成 Snippet
- */
-router.get('/:id', async (req, res) => {
-    const container = getServiceContainer();
-    const snippetFactory = container.get('snippetFactory');
-    const snippet = await snippetFactory.getSnippet(String(req.params.id));
-    if (!snippet) {
-        throw new NotFoundError('Snippet (recipe)', String(req.params.id));
-    }
-    res.json({ success: true, data: snippet });
-});
-export default router;

package/dist/lib/infrastructure/database/migrations/002_add_tasks.d.ts

@@ -1,11 +0,0 @@
-/**
- * Migration 002: TaskGraph 任务表
- *
- * 新增 tasks 表 + task_dependencies 表 + task_events 表。
- *
- * 设计决策 D1: 独立 task_dependencies 表（不复用 knowledge_edges）
- *   - 语义不同（任务依赖 vs 知识关系）
- *   - 需要专门的索引优化就绪检测查询
- *   - 避免与知识图谱互相污染
- */
-export default function migrate(db: import('better-sqlite3').Database): void;