@coralai/sps-cli 0.56.2 → 0.56.3

package/dist/core/wiki/types.d.ts

@@ -1,441 +0,0 @@
-/**
- * @module        core/wiki/types
- * @description   Wiki page 数据模型 + zod schemas
- *
- * @layer         core
- *
- * doc-28 §6 Page Schema 的运行时表示。Frontmatter 用 zod 严格校验——
- * 因为 wiki page 来自 LLM 写入，松散 schema 会让格式漂移失控。
- *
- * 类型分流：5 类 page（module/concept/decision/lesson/source）共享 Base 字段，
- * 每类有 type-specific 加字段。Frontmatter 类型用 discriminated union。
- */
-import { z } from 'zod';
-export declare const PageTypeSchema: z.ZodEnum<{
-    decision: "decision";
-    lesson: "lesson";
-    module: "module";
-    concept: "concept";
-    source: "source";
-}>;
-export type PageType = z.infer<typeof PageTypeSchema>;
-export declare const StatusSchema: z.ZodEnum<{
-    seed: "seed";
-    developing: "developing";
-    mature: "mature";
-    evergreen: "evergreen";
-    stale: "stale";
-}>;
-export type PageStatus = z.infer<typeof StatusSchema>;
-export declare const GeneratedSchema: z.ZodEnum<{
-    auto: "auto";
-    manual: "manual";
-    semi: "semi";
-}>;
-export type Generated = z.infer<typeof GeneratedSchema>;
-export declare const SourceRefSchema: z.ZodUnion<readonly [z.ZodObject<{
-    path: z.ZodString;
-    hash: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    card: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    commit: z.ZodString;
-}, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-    path: string;
-}, string>>]>;
-export type SourceRef = z.infer<typeof SourceRefSchema>;
-export declare const WikilinkSchema: z.ZodString;
-export type Wikilink = z.infer<typeof WikilinkSchema>;
-export declare const ModuleFrontmatterSchema: z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"module">;
-    module_path: z.ZodString;
-}, z.core.$strip>;
-export declare const ConceptFrontmatterSchema: z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"concept">;
-    complexity: z.ZodOptional<z.ZodEnum<{
-        basic: "basic";
-        intermediate: "intermediate";
-        advanced: "advanced";
-    }>>;
-    domain: z.ZodOptional<z.ZodString>;
-    aliases: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>;
-export declare const DecisionFrontmatterSchema: z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"decision">;
-    version: z.ZodOptional<z.ZodString>;
-    superseded_by: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const LessonFrontmatterSchema: z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"lesson">;
-    severity: z.ZodDefault<z.ZodEnum<{
-        critical: "critical";
-        major: "major";
-        minor: "minor";
-    }>>;
-    seen_in_cards: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>;
-export declare const SourceFrontmatterSchema: z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"source">;
-    source_type: z.ZodDefault<z.ZodEnum<{
-        unknown: "unknown";
-        data: "data";
-        pdf: "pdf";
-        article: "article";
-        image: "image";
-        transcript: "transcript";
-        note: "note";
-    }>>;
-    original_path: z.ZodString;
-}, z.core.$strip>;
-export declare const FrontmatterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"module">;
-    module_path: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"concept">;
-    complexity: z.ZodOptional<z.ZodEnum<{
-        basic: "basic";
-        intermediate: "intermediate";
-        advanced: "advanced";
-    }>>;
-    domain: z.ZodOptional<z.ZodString>;
-    aliases: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>, z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"decision">;
-    version: z.ZodOptional<z.ZodString>;
-    superseded_by: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"lesson">;
-    severity: z.ZodDefault<z.ZodEnum<{
-        critical: "critical";
-        major: "major";
-        minor: "minor";
-    }>>;
-    seen_in_cards: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>, z.ZodObject<{
-    title: z.ZodString;
-    created: z.ZodString;
-    updated: z.ZodString;
-    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    status: z.ZodDefault<z.ZodEnum<{
-        seed: "seed";
-        developing: "developing";
-        mature: "mature";
-        evergreen: "evergreen";
-        stale: "stale";
-    }>>;
-    related: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    sources: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        path: z.ZodString;
-        hash: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        card: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        commit: z.ZodString;
-    }, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
-        path: string;
-    }, string>>]>>>;
-    generated: z.ZodDefault<z.ZodEnum<{
-        auto: "auto";
-        manual: "manual";
-        semi: "semi";
-    }>>;
-    type: z.ZodLiteral<"source">;
-    source_type: z.ZodDefault<z.ZodEnum<{
-        unknown: "unknown";
-        data: "data";
-        pdf: "pdf";
-        article: "article";
-        image: "image";
-        transcript: "transcript";
-        note: "note";
-    }>>;
-    original_path: z.ZodString;
-}, z.core.$strip>], "type">;
-export type ModuleFrontmatter = z.infer<typeof ModuleFrontmatterSchema>;
-export type ConceptFrontmatter = z.infer<typeof ConceptFrontmatterSchema>;
-export type DecisionFrontmatter = z.infer<typeof DecisionFrontmatterSchema>;
-export type LessonFrontmatter = z.infer<typeof LessonFrontmatterSchema>;
-export type SourceFrontmatter = z.infer<typeof SourceFrontmatterSchema>;
-export type Frontmatter = z.infer<typeof FrontmatterSchema>;
-export interface Page {
-    /** Stable id: `<type>s/<title>` —— 用作 frontmatter related / 跨页引用 */
-    readonly pageId: string;
-    /** Absolute file path */
-    readonly filePath: string;
-    readonly frontmatter: Frontmatter;
-    /** Body markdown after frontmatter (no leading/trailing whitespace stripping besides YAML block) */
-    readonly body: string;
-}
-export declare const ManifestEntrySchema: z.ZodObject<{
-    type: z.ZodString;
-    sha256: z.ZodString;
-    ingested_at: z.ZodString;
-    pages: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type ManifestEntry = z.infer<typeof ManifestEntrySchema>;
-export declare const ManifestSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    updated_at: z.ZodString;
-    sources: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-        type: z.ZodString;
-        sha256: z.ZodString;
-        ingested_at: z.ZodString;
-        pages: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export type Manifest = z.infer<typeof ManifestSchema>;
-export declare const EMPTY_MANIFEST: Manifest;
-export interface SourceDiff {
-    /** New sources (not in manifest) */
-    readonly added: string[];
-    /** Sources whose hash changed since last ingest */
-    readonly changed: string[];
-    /** Sources still in manifest but no longer in glob results */
-    readonly removed: string[];
-    /** Sources with unchanged hash */
-    readonly unchanged: string[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/core/wiki/types.d.ts.map

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

package/dist/core/wiki/types.js

@@ -1,109 +0,0 @@
-/**
- * @module        core/wiki/types
- * @description   Wiki page 数据模型 + zod schemas
- *
- * @layer         core
- *
- * doc-28 §6 Page Schema 的运行时表示。Frontmatter 用 zod 严格校验——
- * 因为 wiki page 来自 LLM 写入，松散 schema 会让格式漂移失控。
- *
- * 类型分流：5 类 page（module/concept/decision/lesson/source）共享 Base 字段，
- * 每类有 type-specific 加字段。Frontmatter 类型用 discriminated union。
- */
-import { z } from 'zod';
-// ─── Page type enum ───────────────────────────────────────────────
-export const PageTypeSchema = z.enum(['module', 'concept', 'decision', 'lesson', 'source']);
-// ─── Status enum ──────────────────────────────────────────────────
-export const StatusSchema = z.enum(['seed', 'developing', 'mature', 'evergreen', 'stale']);
-// ─── Generated marker ─────────────────────────────────────────────
-export const GeneratedSchema = z.enum(['auto', 'manual', 'semi']);
-// ─── ISO date helpers ─────────────────────────────────────────────
-const IsoDateSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, 'expected YYYY-MM-DD');
-// ─── Source reference (frontmatter sources 字段) ───────────────────
-//
-// 三种形态（discriminated by which field is present）：
-//   { path: 'src/X.ts', hash: '...' }    项目原生文件
-//   { card: '17' }                         SPS 卡片溯源
-//   { commit: 'abcd123' }                  git commit 溯源
-//
-// 注意：YAML 输出可能是字符串（如 ".raw/x.md"）也可能是对象。解析时归一化。
-export const SourceRefSchema = z.union([
-    z.object({ path: z.string(), hash: z.string().optional() }),
-    z.object({ card: z.string() }),
-    z.object({ commit: z.string() }),
-    // 简写：纯字符串路径
-    z.string().transform((s) => ({ path: s })),
-]);
-// ─── Wikilink string format: "[[Page Name]]" or "[[type/Page Name]]" ───
-export const WikilinkSchema = z
-    .string()
-    .regex(/^\[\[[^[\]]+\]\]$/, 'expected [[Page Name]] wikilink format');
-// ─── Base frontmatter (all page types share) ─────────────────────
-const BaseFrontmatterSchema = z.object({
-    title: z.string().min(1),
-    created: IsoDateSchema,
-    updated: IsoDateSchema,
-    tags: z.array(z.string()).default([]),
-    status: StatusSchema.default('developing'),
-    related: z.array(WikilinkSchema).default([]),
-    sources: z.array(SourceRefSchema).default([]),
-    generated: GeneratedSchema.default('manual'),
-});
-// ─── Type-specific frontmatter ────────────────────────────────────
-export const ModuleFrontmatterSchema = BaseFrontmatterSchema.extend({
-    type: z.literal('module'),
-    module_path: z.string().min(1).describe('Source file path relative to repo root'),
-});
-export const ConceptFrontmatterSchema = BaseFrontmatterSchema.extend({
-    type: z.literal('concept'),
-    complexity: z.enum(['basic', 'intermediate', 'advanced']).optional(),
-    domain: z.string().optional(),
-    aliases: z.array(z.string()).default([]).optional(),
-});
-export const DecisionFrontmatterSchema = BaseFrontmatterSchema.extend({
-    type: z.literal('decision'),
-    version: z.string().optional().describe('e.g. v0.51.0'),
-    superseded_by: WikilinkSchema.optional(),
-});
-export const LessonFrontmatterSchema = BaseFrontmatterSchema.extend({
-    type: z.literal('lesson'),
-    severity: z.enum(['critical', 'major', 'minor']).default('major'),
-    seen_in_cards: z.array(z.string()).default([]).optional(),
-});
-export const SourceFrontmatterSchema = BaseFrontmatterSchema.extend({
-    type: z.literal('source'),
-    source_type: z
-        .enum(['pdf', 'article', 'image', 'transcript', 'data', 'note', 'unknown'])
-        .default('unknown'),
-    original_path: z.string().min(1),
-});
-export const FrontmatterSchema = z.discriminatedUnion('type', [
-    ModuleFrontmatterSchema,
-    ConceptFrontmatterSchema,
-    DecisionFrontmatterSchema,
-    LessonFrontmatterSchema,
-    SourceFrontmatterSchema,
-]);
-// ─── Manifest (.manifest.json) ────────────────────────────────────
-export const ManifestEntrySchema = z.object({
-    /** 'code' | 'doc' | 'pdf' | 'article' | 'image' | 'transcript' | 'readme' | 'changelog' | ... */
-    type: z.string().min(1),
-    /** sha256 hex (64 chars) */
-    sha256: z.string().regex(/^[0-9a-f]{64}$/, 'expected sha256 hex'),
-    /** ISO 8601 timestamp */
-    ingested_at: z.string(),
-    /** Page ids this source contributed to */
-    pages: z.array(z.string()).default([]),
-});
-export const ManifestSchema = z.object({
-    version: z.literal(1),
-    updated_at: z.string(),
-    /** Key = source path relative to repo root (e.g. "src/X.ts" or ".raw/pdfs/y.pdf") */
-    sources: z.record(z.string(), ManifestEntrySchema).default({}),
-});
-export const EMPTY_MANIFEST = {
-    version: 1,
-    updated_at: '1970-01-01T00:00:00Z',
-    sources: {},
-};
-//# sourceMappingURL=types.js.map

package/dist/core/wiki/types.js.map

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

package/dist/shared/wikiPaths.d.ts

@@ -1,38 +0,0 @@
-export type WikiPageType = 'module' | 'concept' | 'decision' | 'lesson' | 'source';
-/** `<repo>/wiki/` —— Wiki vault 根目录。Obsidian Open folder 指向这里。 */
-export declare function wikiDir(repoDir: string): string;
-/** `<repo>/wiki/WIKI.md` —— schema + sources 配置 */
-export declare function wikiMetaFile(repoDir: string): string;
-/** `<repo>/wiki/index.md` —— 全部 page 的 catalog */
-export declare function wikiIndexFile(repoDir: string): string;
-/** `<repo>/wiki/overview.md` —— 项目执行摘要 */
-export declare function wikiOverviewFile(repoDir: string): string;
-/** `<repo>/wiki/.hot.md` —— ~500 字最近上下文（gitignored） */
-export declare function wikiHotFile(repoDir: string): string;
-/** `<repo>/wiki/.log.md` —— 操作时间序列（gitignored） */
-export declare function wikiLogFile(repoDir: string): string;
-/** `<repo>/wiki/.manifest.json` —— 源 hash 跟踪表（gitignored） */
-export declare function wikiManifestFile(repoDir: string): string;
-/** `<repo>/wiki/.raw/` —— 用户外部添加的源材料（committed by default） */
-export declare function wikiRawDir(repoDir: string): string;
-/** `<repo>/wiki/_attachments/` —— 嵌入图片（committed） */
-export declare function wikiAttachmentsDir(repoDir: string): string;
-/**
- * `<repo>/wiki/<type>s/` —— 特定类型 page 目录。
- * 名约定：复数后缀（modules/, concepts/, decisions/, lessons/, sources/）。
- */
-export declare function wikiPageDir(repoDir: string, type: WikiPageType): string;
-/** `<repo>/wiki/<type>s/<title>.md` —— 单页文件路径 */
-export declare function wikiPageFile(repoDir: string, type: WikiPageType, title: string): string;
-/** Page id 格式：`<type>s/<title>`（不含 .md）。用作 frontmatter related / sources 字段 */
-export declare function wikiPageId(type: WikiPageType, title: string): string;
-/**
- * 从绝对路径反推 (type, title) —— 用于 listing 时把文件名解析回 page 标识。
- * 只接受 wikiDir 子路径，否则返 null。
- */
-export declare function parseWikiPageId(repoDir: string, filePath: string): {
-    type: WikiPageType;
-    title: string;
-    pageId: string;
-} | null;
-//# sourceMappingURL=wikiPaths.d.ts.map

package/dist/shared/wikiPaths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wikiPaths.d.ts","sourceRoot":"","sources":["../../src/shared/wikiPaths.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnF,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAEvE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAe9D"}