@codehourra/llm-iwiki 0.1.0 → 0.1.1

package/src/projects.ts

@@ -1,192 +0,0 @@
-import { spawnSync } from 'node:child_process'
-import { existsSync } from 'node:fs'
-import { basename, resolve } from 'node:path'
-
-import type { LlmIwikiDatabase } from './db'
-
-export interface ProjectRecord {
-  id: string
-  canonicalName: string
-  displayName: string | null
-  slug: string
-  canonicalRepoUrl: string | null
-  identitySource: string
-}
-
-export function canonicalizeRemoteUrl(remoteUrl: string): string {
-  return remoteUrl
-    .trim()
-    .replace(/\/+$/, '')
-    .replace(/^ssh:\/\/git@([^/]+)\//, '$1/')
-    .replace(/^git@([^:]+):/, '$1/')
-    .replace(/^https?:\/\//, '')
-    .replace(/\.git$/, '')
-}
-
-export function slugifyProjectName(name: string): string {
-  const ascii = name
-    .normalize('NFKD')
-    .replace(/[^\w\s./-]/g, '')
-    .trim()
-    .toLowerCase()
-    .replace(/[\s._/]+/g, '-')
-    .replace(/-+/g, '-')
-    .replace(/^-|-$/g, '')
-
-  return ascii || 'project'
-}
-
-function git(cwd: string, args: string[]): string | null {
-  const result = spawnSync('git', args, { cwd, encoding: 'utf8' })
-  if (result.status !== 0) return null
-  return result.stdout.trim() || null
-}
-
-interface ProjectIdentity {
-  id: string
-  canonicalName: string
-  slug: string
-  canonicalRepoUrl: string | null
-  identitySource: string
-}
-
-function computeProjectIdentity(localPath: string): ProjectIdentity {
-  const gitRoot = git(localPath, ['rev-parse', '--show-toplevel'])
-  const remote = git(localPath, ['config', '--get', 'remote.origin.url'])
-  const canonicalRepoUrl = remote ? canonicalizeRemoteUrl(remote) : null
-  const canonicalName = canonicalRepoUrl ?? basename(gitRoot ?? localPath)
-  const slug = slugifyProjectName(canonicalName)
-  const id = `proj_${Bun.hash(canonicalRepoUrl ?? gitRoot ?? localPath).toString(16)}`
-
-  return {
-    id,
-    canonicalName,
-    slug,
-    canonicalRepoUrl,
-    identitySource: canonicalRepoUrl ? 'git_remote' : 'path',
-  }
-}
-
-function upsertProjectIdentity(db: LlmIwikiDatabase, identity: ProjectIdentity): ProjectRecord {
-  const now = new Date().toISOString()
-  db.query(`
-    INSERT INTO projects (id, canonical_name, display_name, slug, canonical_repo_url, provider, identity_source, created_at, updated_at)
-    VALUES ($id, $canonicalName, NULL, $slug, $canonicalRepoUrl, NULL, $identitySource, $now, $now)
-    ON CONFLICT(id) DO UPDATE SET
-      canonical_name = excluded.canonical_name,
-      slug = excluded.slug,
-      canonical_repo_url = excluded.canonical_repo_url,
-      identity_source = excluded.identity_source,
-      updated_at = excluded.updated_at
-  `).run({
-    $id: identity.id,
-    $canonicalName: identity.canonicalName,
-    $slug: identity.slug,
-    $canonicalRepoUrl: identity.canonicalRepoUrl,
-    $identitySource: identity.identitySource,
-    $now: now,
-  })
-
-  return getProject(db, identity.id)
-}
-
-export function resolveProject(db: LlmIwikiDatabase, checkoutPath: string): ProjectRecord {
-  const localPath = resolve(checkoutPath)
-  if (!existsSync(localPath)) throw new Error(`Path does not exist: ${localPath}`)
-  return upsertProjectIdentity(db, computeProjectIdentity(localPath))
-}
-
-export function resolveProjectByPath(db: LlmIwikiDatabase, rawPath: string): ProjectRecord {
-  const localPath = resolve(rawPath)
-  return upsertProjectIdentity(db, computeProjectIdentity(localPath))
-}
-
-export function renameProject(db: LlmIwikiDatabase, projectId: string, displayName: string): ProjectRecord {
-  const now = new Date().toISOString()
-  const changes = db
-    .query('UPDATE projects SET display_name = $displayName, updated_at = $now WHERE id = $projectId')
-    .run({
-      $displayName: displayName,
-      $projectId: projectId,
-      $now: now,
-    })
-
-  if (changes.changes === 0) throw new Error(`Project not found: ${projectId}`)
-
-  return getProject(db, projectId)
-}
-
-export interface ProjectSummaryRow extends ProjectRecord {
-  sessionCount: number
-  lastSeenAt: string | null
-}
-
-export function listProjects(db: LlmIwikiDatabase): ProjectSummaryRow[] {
-  const rows = db
-    .query<
-      {
-        id: string
-        canonical_name: string
-        display_name: string | null
-        slug: string
-        canonical_repo_url: string | null
-        identity_source: string
-        session_count: number
-        last_seen_at: string | null
-      },
-      []
-    >(`
-      SELECT
-        p.id,
-        p.canonical_name,
-        p.display_name,
-        p.slug,
-        p.canonical_repo_url,
-        p.identity_source,
-        COUNT(s.id) AS session_count,
-        MAX(s.last_seen_at) AS last_seen_at
-      FROM projects p
-      LEFT JOIN sessions s ON s.project_id = p.id
-      GROUP BY p.id
-      ORDER BY session_count DESC, p.canonical_name ASC
-    `)
-    .all()
-
-  return rows.map((row) => ({
-    id: row.id,
-    canonicalName: row.canonical_name,
-    displayName: row.display_name,
-    slug: row.slug,
-    canonicalRepoUrl: row.canonical_repo_url,
-    identitySource: row.identity_source,
-    sessionCount: row.session_count,
-    lastSeenAt: row.last_seen_at,
-  }))
-}
-
-export function getProject(db: LlmIwikiDatabase, projectId: string): ProjectRecord {
-  const row = db
-    .query<
-      {
-        id: string
-        canonical_name: string
-        display_name: string | null
-        slug: string
-        canonical_repo_url: string | null
-        identity_source: string
-      },
-      [string]
-    >('SELECT * FROM projects WHERE id = ?')
-    .get(projectId)
-
-  if (!row) throw new Error(`Project not found: ${projectId}`)
-
-  return {
-    id: row.id,
-    canonicalName: row.canonical_name,
-    displayName: row.display_name,
-    slug: row.slug,
-    canonicalRepoUrl: row.canonical_repo_url,
-    identitySource: row.identity_source,
-  }
-}

package/src/sessions.ts

@@ -1,119 +0,0 @@
-import type { LlmIwikiDatabase } from './db'
-
-export interface SessionRow {
-  id: string
-  sourceId: string
-  sourceSessionId: string
-  title: string | null
-  messageCount: number
-  status: string
-  rawProjectPath: string | null
-  updatedAt: string | null
-  lastSeenAt: string
-}
-
-export interface SourceBreakdown {
-  source: string
-  sessionCount: number
-}
-
-export interface ProjectInspection {
-  sources: SourceBreakdown[]
-  sessions: SessionRow[]
-}
-
-function mapRow(row: {
-  id: string
-  source_id: string
-  source_session_id: string
-  title: string | null
-  message_count: number
-  status: string
-  raw_project_path: string | null
-  updated_at: string | null
-  last_seen_at: string
-}): SessionRow {
-  return {
-    id: row.id,
-    sourceId: row.source_id,
-    sourceSessionId: row.source_session_id,
-    title: row.title,
-    messageCount: row.message_count,
-    status: row.status,
-    rawProjectPath: row.raw_project_path,
-    updatedAt: row.updated_at,
-    lastSeenAt: row.last_seen_at,
-  }
-}
-
-export function listSessionsByProject(db: LlmIwikiDatabase, projectId: string, limit = 100): SessionRow[] {
-  return db
-    .query<Parameters<typeof mapRow>[0], [string, number]>(`
-      SELECT id, source_id, source_session_id, title, message_count, status, raw_project_path, updated_at, last_seen_at
-      FROM sessions
-      WHERE project_id = ?
-      ORDER BY COALESCE(updated_at, last_seen_at) DESC
-      LIMIT ?
-    `)
-    .all(projectId, limit)
-    .map(mapRow)
-}
-
-export interface StoredMessage {
-  role: string
-  content: string
-}
-
-export function getSessionMessages(db: LlmIwikiDatabase, sessionId: string): StoredMessage[] {
-  return db
-    .query<{ role: string; content: string }, [string]>(
-      'SELECT role, content FROM messages WHERE session_id = ? ORDER BY seq_order ASC',
-    )
-    .all(sessionId)
-}
-
-export function getSession(db: LlmIwikiDatabase, sessionId: string): SessionRow | null {
-  const row = db
-    .query<Parameters<typeof mapRow>[0], [string]>(`
-      SELECT id, source_id, source_session_id, title, message_count, status, raw_project_path, updated_at, last_seen_at
-      FROM sessions
-      WHERE id = ?
-    `)
-    .get(sessionId)
-  return row ? mapRow(row) : null
-}
-
-export function listSessionsToSummarize(
-  db: LlmIwikiDatabase,
-  projectId: string,
-  scope: 'changed' | 'all',
-): SessionRow[] {
-  const statusClause = scope === 'changed' ? "AND status IN ('new', 'changed')" : ''
-  return db
-    .query<Parameters<typeof mapRow>[0], [string]>(`
-      SELECT id, source_id, source_session_id, title, message_count, status, raw_project_path, updated_at, last_seen_at
-      FROM sessions
-      WHERE project_id = ? ${statusClause}
-      ORDER BY COALESCE(updated_at, last_seen_at) DESC
-    `)
-    .all(projectId)
-    .map(mapRow)
-}
-
-export function inspectProject(db: LlmIwikiDatabase, projectId: string): ProjectInspection {
-  const sources = db
-    .query<{ source_id: string; session_count: number }, [string]>(`
-      SELECT source_id, COUNT(*) AS session_count
-      FROM sessions
-      WHERE project_id = ?
-      GROUP BY source_id
-      ORDER BY session_count DESC
-    `)
-    .all(projectId)
-    .map((row) => ({ source: row.source_id, sessionCount: row.session_count }))
-
-  return {
-    sources,
-    sessions: listSessionsByProject(db, projectId),
-  }
-}

package/src/skills.ts

@@ -1,168 +0,0 @@
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-
-export type SkillTarget = 'codex' | 'claude-code' | 'cursor'
-
-export const SKILL_TARGETS = ['codex', 'claude-code', 'cursor'] as const satisfies readonly SkillTarget[]
-
-export interface InitSkillsOptions {
-  cwd: string
-  target: SkillTarget | null
-  force: boolean
-  dryRun: boolean
-}
-
-export interface InitSkillsResult {
-  written: string[]
-  skipped: string[]
-}
-
-interface SkillTemplate {
-  directory: string
-  content: string
-}
-
-const TARGET_NAMES: Record<SkillTarget, string> = {
-  codex: 'Codex',
-  'claude-code': 'Claude Code',
-  cursor: 'Cursor',
-}
-
-const SKILL_TEMPLATES: SkillTemplate[] = [
-  {
-    directory: 'aiwiki-after-session',
-    content: `---
-name: aiwiki-after-session
-description: Capture session knowledge into llm-iwiki summaries, experiences, and Obsidian export after project work.
----
-
-# AIWiki After Session
-
-Use this skill after a meaningful coding or design session in the current project.
-
-## Steps
-
-1. Sync the current project:
-   \`\`\`bash
-   llm-iwiki sync --project .
-   \`\`\`
-2. Prepare changed summaries:
-   \`\`\`bash
-   llm-iwiki summarize prepare changed --project . --out .llm-iwiki/tasks/summaries-task.md
-   \`\`\`
-3. Generate \`.llm-iwiki/tasks/summaries.yaml\` from the prepared task.
-4. Apply the summaries:
-   \`\`\`bash
-   llm-iwiki summarize apply --project . --file .llm-iwiki/tasks/summaries.yaml
-   \`\`\`
-5. Prepare experience proposals from changed summaries:
-   \`\`\`bash
-   llm-iwiki experiences prepare --project . --from changed-summaries --out .llm-iwiki/tasks/experiences-task.md
-   \`\`\`
-6. Generate \`.llm-iwiki/tasks/experiences.yaml\` from the prepared task.
-7. Propose the experiences:
-   \`\`\`bash
-   llm-iwiki experiences propose --project . --file .llm-iwiki/tasks/experiences.yaml
-   \`\`\`
-8. Export project knowledge to Obsidian:
-   \`\`\`bash
-   llm-iwiki obsidian export --project .
-   \`\`\`
-`,
-  },
-  {
-    directory: 'aiwiki-before-debug',
-    content: `---
-name: aiwiki-before-debug
-description: Search project memory before debugging so related history is visible before changing code.
----
-
-# AIWiki Before Debug
-
-Use this skill before investigating a bug, failure, error message, or confusing behavior.
-
-## Steps
-
-1. Search the full project knowledge index:
-   \`\`\`bash
-   llm-iwiki search "<error or topic>" --project . --index all
-   \`\`\`
-2. Read any related summaries, experiences, or prior decisions before editing code.
-3. Report whether related history was found, and name the most relevant item when it was found.
-`,
-  },
-  {
-    directory: 'aiwiki-project-retrospective',
-    content: `---
-name: aiwiki-project-retrospective
-description: Review recent project knowledge and extract retrospective themes from llm-iwiki.
----
-
-# AIWiki Project Retrospective
-
-Use this skill when preparing a project retrospective or looking for recent repeated lessons.
-
-## Steps
-
-1. Prepare a retrospective from recent project history:
-   \`\`\`bash
-   llm-iwiki experiences prepare --project . --from all-recent --since 30d --out .llm-iwiki/tasks/retrospective-task.md
-   \`\`\`
-2. Review the prepared task for repeated themes, unresolved questions, and process improvements.
-3. Capture any accepted learnings through the normal llm-iwiki experience proposal flow.
-`,
-  },
-]
-
-function appendTargetGuidance(content: string, target: SkillTarget | null): string {
-  if (!target) return content
-
-  return `${content}
-## Tool Target
-
-This skill is initialized for ${TARGET_NAMES[target]}.
-`
-}
-
-function isFileExistsError(error: unknown): boolean {
-  return error instanceof Error && 'code' in error && error.code === 'EEXIST'
-}
-
-export function initSkills(options: InitSkillsOptions): InitSkillsResult {
-  const written: string[] = []
-  const skipped: string[] = []
-
-  for (const template of SKILL_TEMPLATES) {
-    const filePath = join(options.cwd, '.agents', 'skills', template.directory, 'SKILL.md')
-
-    if (existsSync(filePath) && !options.force) {
-      skipped.push(filePath)
-      continue
-    }
-
-    written.push(filePath)
-
-    if (options.dryRun) {
-      continue
-    }
-
-    mkdirSync(dirname(filePath), { recursive: true })
-    const content = appendTargetGuidance(template.content, options.target)
-    if (options.force) {
-      writeFileSync(filePath, content)
-      continue
-    }
-
-    try {
-      writeFileSync(filePath, content, { flag: 'wx' })
-    } catch (error) {
-      if (!isFileExistsError(error)) {
-        throw error
-      }
-      written.pop()
-      skipped.push(filePath)
-    }
-  }
-
-  return { written, skipped }
-}

package/src/summarize.ts

@@ -1,122 +0,0 @@
-import type { ParsedSummariesYaml } from './types'
-import type { LlmIwikiDatabase } from './db'
-import { compactTranscript } from './compaction'
-import { getSessionMessages, listSessionsToSummarize } from './sessions'
-
-export interface PrepareSummariesResult {
-  markdown: string
-  sessionCount: number
-}
-
-const SUMMARIES_FORMAT = `## 输出格式
-
-请阅读下面每个会话的压缩记录，为有价值的会话生成一份 \`summaries.yaml\`，写入
-\`.llm-iwiki/tasks/summaries.yaml\`，再运行 \`llm-iwiki summarize apply\`。
-
-\`\`\`yaml
-project_id: <见下方 project_id>
-summaries:
-  - session_id: <会话的 session_id，原样照抄>
-    title: <一句话标题>
-    value: none | low | medium | high
-    summary_markdown: |
-      用 Markdown 概括这次会话解决了什么问题、关键决策、结论。
-\`\`\`
-
-要求：
-- \`value\` 表示这次会话的沉淀价值，\`medium\` / \`high\` 会进入经验提取。
-- \`session_id\` 必须与下面给出的完全一致。
-- 没有价值的会话可以省略，不必每个都写。`
-
-export function prepareSummariesTask(
-  db: LlmIwikiDatabase,
-  projectId: string,
-  scope: 'changed' | 'all',
-): PrepareSummariesResult {
-  const sessions = listSessionsToSummarize(db, projectId, scope)
-
-  const blocks: string[] = []
-  for (const session of sessions) {
-    const messages = getSessionMessages(db, session.id)
-    if (messages.length === 0) continue
-    const transcript = compactTranscript(messages)
-    blocks.push(
-      [
-        `### ${session.id}`,
-        `- source: ${session.sourceId}`,
-        `- title: ${session.title ?? '(无标题)'}`,
-        `- messages: ${session.messageCount}`,
-        '',
-        transcript,
-      ].join('\n'),
-    )
-  }
-
-  const markdown = [
-    `# Summaries Task`,
-    '',
-    `project_id: ${projectId}`,
-    `scope: ${scope}`,
-    `sessions: ${blocks.length}`,
-    '',
-    SUMMARIES_FORMAT,
-    '',
-    '---',
-    '',
-    blocks.join('\n\n---\n\n'),
-    '',
-  ].join('\n')
-
-  return { markdown, sessionCount: blocks.length }
-}
-
-export interface ApplySummariesResult {
-  written: number
-  skipped: string[]
-}
-
-function hash(value: string): string {
-  return Bun.hash(value).toString(16)
-}
-
-export function applySummaries(db: LlmIwikiDatabase, parsed: ParsedSummariesYaml): ApplySummariesResult {
-  const now = new Date().toISOString()
-  let written = 0
-  const skipped: string[] = []
-
-  const apply = db.transaction(() => {
-    for (const summary of parsed.summaries) {
-      const session = db
-        .query<{ project_id: string | null }, [string]>('SELECT project_id FROM sessions WHERE id = ?')
-        .get(summary.sessionId)
-      if (!session) {
-        skipped.push(summary.sessionId)
-        continue
-      }
-
-      db.query(`
-        INSERT INTO session_summaries (id, session_id, project_id, title, value, summary_markdown, metadata_json, created_at, updated_at)
-        VALUES ($id, $sessionId, $projectId, $title, $value, $summaryMarkdown, $metadata, $now, $now)
-        ON CONFLICT(id) DO UPDATE SET
-          title = excluded.title,
-          value = excluded.value,
-          summary_markdown = excluded.summary_markdown,
-          metadata_json = excluded.metadata_json,
-          updated_at = excluded.updated_at
-      `).run({
-        $id: `sum_${hash(summary.sessionId)}`,
-        $sessionId: summary.sessionId,
-        $projectId: session.project_id ?? parsed.projectId,
-        $title: summary.title,
-        $value: summary.value,
-        $summaryMarkdown: summary.summaryMarkdown,
-        $metadata: JSON.stringify(summary.metadata),
-        $now: now,
-      })
-      written += 1
-    }
-  })
-  apply()
-
-  return { written, skipped }
-}