speccore 1.0.0

package/dist/core/context.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadContext = loadContext;
+exports.saveContext = saveContext;
+exports.updateContext = updateContext;
+exports.recordHistory = recordHistory;
+exports.detectActiveIteration = detectActiveIteration;
+exports.detectCurrentAssignee = detectCurrentAssignee;
+exports.getDefaultIteration = getDefaultIteration;
+exports.getDefaultAssignee = getDefaultAssignee;
+const fs_extra_1 = require("fs-extra");
+const CONTEXT_PATH = '.speccore/local/context.json';
+async function loadContext() {
+    if (await (0, fs_extra_1.pathExists)(CONTEXT_PATH)) {
+        return await (0, fs_extra_1.readJson)(CONTEXT_PATH);
+    }
+    return {
+        currentIteration: '',
+        currentTask: '',
+        currentAssignee: '',
+        lastUpdated: '',
+        lastAction: '',
+        lastIntent: '',
+        interruptedAt: '',
+        iterationStatus: '',
+        pendingTasks: 0,
+        inProgressTasks: 0,
+        completedTasks: 0,
+        blockedTasks: 0,
+        customAliases: {},
+        history: []
+    };
+}
+async function saveContext(context) {
+    await (0, fs_extra_1.ensureDir)('.speccore/local');
+    context.lastUpdated = new Date().toISOString();
+    await (0, fs_extra_1.writeJson)(CONTEXT_PATH, context, { spaces: 2 });
+}
+async function updateContext(partial) {
+    const context = await loadContext();
+    Object.assign(context, partial);
+    await saveContext(context);
+}
+async function recordHistory(command, iteration, task) {
+    const context = await loadContext();
+    context.history.push({
+        command,
+        timestamp: new Date().toISOString(),
+        iteration,
+        task
+    });
+    // Keep only last 100 entries
+    if (context.history.length > 100) {
+        context.history = context.history.slice(-100);
+    }
+    await saveContext(context);
+}
+async function detectActiveIteration() {
+    const { pathExists, readFile } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
+    const { join } = await Promise.resolve().then(() => __importStar(require('path')));
+    // First check context
+    const context = await loadContext();
+    if (context.currentIteration) {
+        return context.currentIteration;
+    }
+    // Read ITERATIONS/README.md
+    const iterationsPath = join('.speccore', 'ITERATIONS', 'README.md');
+    if (!(await pathExists(iterationsPath))) {
+        return '';
+    }
+    const content = await readFile(iterationsPath, 'utf-8');
+    // Find iteration with 🔄 进行中 status
+    const activeMatch = content.match(/\|\s*([^|]+)\s*\|[^|]*🔄/);
+    if (activeMatch) {
+        return activeMatch[1].trim();
+    }
+    // Find latest iteration
+    const matches = content.matchAll(/\|\s*([^|]+)\s*\|/g);
+    const iterations = [];
+    for (const match of matches) {
+        const name = match[1].trim();
+        if (name && name !== '期次名称' && !name.startsWith('---')) {
+            iterations.push(name);
+        }
+    }
+    return iterations[iterations.length - 1] || '';
+}
+async function detectCurrentAssignee() {
+    const context = await loadContext();
+    if (context.currentAssignee) {
+        return context.currentAssignee;
+    }
+    // Try git config
+    try {
+        const { execSync } = await Promise.resolve().then(() => __importStar(require('child_process')));
+        return execSync('git config user.name', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+async function getDefaultIteration(iteration) {
+    if (iteration)
+        return iteration;
+    return await detectActiveIteration();
+}
+async function getDefaultAssignee(assignee) {
+    if (assignee)
+        return assignee;
+    return await detectCurrentAssignee();
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

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

package/dist/core/global-layer.d.ts

@@ -0,0 +1,124 @@
+/**
+ * GLOBAL 全量层管理核心模块
+ * 负责管理 GLOBAL/ 目录下的全量需求索引、项目映射、期次关联
+ */
+/** 需求状态 */
+export type ReqStatus = '📦 已有实现' | '✅ 已实现' | '🔄 进行中' | '🔲 待开发' | '🗑️ 已废弃';
+/** 项目类型 */
+export type ProjectType = 'backend' | 'web' | 'h5' | 'miniapp';
+/** 需求索引条目 */
+export interface ReqIndexEntry {
+    id: string;
+    project: string;
+    name: string;
+    status: ReqStatus;
+    version: string;
+    iteration: string;
+    task: string;
+    filePath: string;
+}
+/** 项目条目 */
+export interface ProjectEntry {
+    name: string;
+    type: ProjectType;
+    reqCount: number;
+    implemented: number;
+    inProgress: number;
+    pending: number;
+    lastImport: string;
+}
+/** 期次关联条目 */
+export interface IterationLink {
+    name: string;
+    reqs: string[];
+    status: string;
+    createdAt: string;
+}
+/** INDEX.md 解析后的全局索引 */
+export interface GlobalIndex {
+    reqs: ReqIndexEntry[];
+    projects: ProjectEntry[];
+    iterations: IterationLink[];
+    version: string;
+    lastUpdated: string;
+}
+/** 导入项目参数 */
+export interface ImportProjectParams {
+    project: string;
+    path: string;
+    type: ProjectType;
+}
+/** 需求变更条目 */
+export interface ReqChange {
+    reqId: string;
+    reqName: string;
+    project: string;
+    changeType: '新增' | '修改' | '废弃';
+    changeDesc: string;
+}
+declare function getGlobalDir(): string;
+declare function getIndexPath(): string;
+declare function getProjectReqPath(project: string): string;
+declare function getProjectMetaPath(project: string): string;
+/**
+ * 解析 GLOBAL/INDEX.md
+ */
+export declare function readGlobalIndex(): Promise<GlobalIndex>;
+/**
+ * 获取下一个需求编号
+ */
+export declare function getNextReqId(index: GlobalIndex): string;
+/**
+ * 递增全局版本号
+ */
+export declare function bumpGlobalVersion(currentVersion: string): string;
+/**
+ * 追加需求条目到 INDEX.md 的需求索引表
+ */
+export declare function appendReqToIndex(entry: ReqIndexEntry): Promise<void>;
+/**
+ * 更新 INDEX.md 中需求条目的状态、版本等信息
+ */
+export declare function updateReqInIndex(reqId: string, updates: Partial<ReqIndexEntry>): Promise<void>;
+/**
+ * 追加项目条目到 INDEX.md
+ */
+export declare function upsertProjectInIndex(project: ProjectEntry): Promise<void>;
+/**
+ * 追加期次关联到 INDEX.md
+ */
+export declare function appendIterationLink(link: IterationLink): Promise<void>;
+/**
+ * 更新 INDEX.md 版本信息
+ */
+export declare function updateIndexVersion(version: string): Promise<void>;
+/**
+ * 确保项目目录存在
+ */
+export declare function ensureProjectDir(project: string): Promise<void>;
+/**
+ * 写入项目需求文档
+ */
+export declare function writeProjectRequirements(project: string, projectType: ProjectType, requirements: {
+    name: string;
+    description: string;
+    id: string;
+}[], techStack?: string): Promise<ReqIndexEntry[]>;
+/**
+ * 写入项目元数据
+ */
+export declare function writeProjectMetadata(project: string, projectType: ProjectType, techStack?: string, repoUrl?: string): Promise<void>;
+/**
+ * 从指定项目中读取指定需求 ID 的详细内容
+ */
+export declare function readRequirementDetail(project: string, reqId: string): Promise<string>;
+/**
+ * 对比两个需求描述并返回变更清单
+ */
+export declare function diffRequirements(sourceTitle: string, sourceContent: string, targetContent: string): ReqChange[];
+/**
+ * 获取所有已导入项目的列表
+ */
+export declare function listProjectDirs(): Promise<string[]>;
+export { getGlobalDir, getIndexPath, getProjectReqPath, getProjectMetaPath };
+//# sourceMappingURL=global-layer.d.ts.map

package/dist/core/global-layer.d.ts.map

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