@zosmaai/pi-llm-wiki 0.4.0 → 0.5.0

package/AGENTS.md

@@ -1,57 +0,0 @@
-# AGENTS.md
-
-Instructions for AI agents working on this codebase.
-
-## Project
-
-`@zosmaai/pi-llm-wiki` — A pi package that implements Andrej Karpathy's LLM Wiki pattern as a self-maintaining knowledge base.
-
-## Tech Stack
-
-- TypeScript (ES2022, ESM)
-- Vitest for testing
-- Biome for linting/formatting
-- GitHub Actions for CI
-- npm for publishing
-
-## File Layout
-
-```
-├── extensions/llm-wiki/     # TypeScript extension (10 tools + guardrails)
-│   ├── index.ts             # Entry point
-│   └── lib/                 # tools.ts, metadata.ts, guardrails.ts, utils.ts, source-packet.ts
-├── skills/llm-wiki/         # SKILL.md + templates
-├── prompts/                 # 8 slash command templates
-├── test/                    # Vitest tests
-├── docs/                    # Documentation
-└── scripts/                 # release.js
-```
-
-## Conventions
-
-- Use `node:fs/promises` for async file I/O, not sync
-- Prefer small, pure functions in `lib/`
-- Extension tools must have: name, label, description, promptSnippet, promptGuidelines, parameters (TypeBox), execute
-- Guardrails block `raw/**` and `meta/**` edits at the tool_call hook level
-- Metadata auto-rebuilds on `turn_end` after `wiki/**` edits
-- Source IDs: `SRC-YYYY-MM-DD-NNN`
-- Page filenames: `kebab-case.md`
-- Wikilinks: folder-qualified, e.g. `[[concepts/retrieval-augmented-generation]]`
-
-## Testing
-
-```bash
-npm test              # run tests
-npm run test:coverage # run with coverage
-npm run typecheck     # TypeScript check
-npm run lint          # biome check
-```
-
-## Release
-
-```bash
-npm run release:patch  # or minor/major
-npm run release:push   # push tags
-```
-
-Never edit `package.json` version manually — use the release script.

package/CONTRIBUTING.md

@@ -1,43 +0,0 @@
-# Contributing
-
-## Local Setup
-
-```bash
-git clone https://github.com/zosmaai/pi-llm-wiki.git
-cd pi-llm-wiki
-npm install
-pi install ./
-```
-
-## Development
-
-```bash
-npm run test           # run tests
-npm run test:coverage  # run tests with coverage report
-npm run typecheck      # TypeScript type check
-npm run lint           # biome lint check
-npm run lint:fix       # auto-fix lint issues
-```
-
-## Release Process
-
-```bash
-npm run release:patch  # bump patch version
-npm run release:minor  # bump minor version
-npm run release:major  # bump major version
-npm run release:push   # push to origin with tags
-```
-
-The release script:
-
-1. Verifies clean git tree and `main` branch
-2. Runs typecheck, lint, and tests
-3. Bumps version in `package.json`
-4. Updates `CHANGELOG.md`
-5. Commits and tags
-
-CI handles npm publish on tag push.
-
-## License
-
-MIT

package/biome.json

@@ -1,30 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "files": {
-    "ignore": ["coverage", "dist", "node_modules"]
-  },
-  "organizeImports": {
-    "enabled": true
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "style": {
-        "noNonNullAssertion": "off"
-      }
-    }
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "always"
-    }
-  }
-}

package/scripts/release.js

@@ -1,72 +0,0 @@
-#!/usr/bin/env node
-/**
- * Semantic version release script.
- * Usage: node scripts/release.js [patch|minor|major]
- */
-
-const { execSync } = require("node:child_process");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const bump = process.argv[2];
-if (!["patch", "minor", "major"].includes(bump)) {
-  console.error("Usage: node scripts/release.js [patch|minor|major]");
-  process.exit(1);
-}
-
-// Verify clean tree
-const status = execSync("git status --porcelain", { encoding: "utf-8" }).trim();
-if (status) {
-  console.error("Error: working tree is not clean");
-  process.exit(1);
-}
-
-// Verify main branch
-const branch = execSync("git branch --show-current", { encoding: "utf-8" }).trim();
-if (branch !== "main") {
-  console.error("Error: not on main branch");
-  process.exit(1);
-}
-
-// Run checks
-execSync("npm run typecheck", { stdio: "inherit" });
-execSync("npm run lint", { stdio: "inherit" });
-execSync("npm test", { stdio: "inherit" });
-
-// Read current version
-const pkgPath = path.join(__dirname, "..", "package.json");
-const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-const current = pkg.version;
-const [major, minor, patch] = current.split(".").map(Number);
-
-let next;
-if (bump === "major") next = `${major + 1}.0.0`;
-else if (bump === "minor") next = `${major}.${minor + 1}.0`;
-else next = `${major}.${minor}.${patch + 1}`;
-
-// Update package.json
-pkg.version = next;
-fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
-
-// Update CHANGELOG
-const changelogPath = path.join(__dirname, "..", "CHANGELOG.md");
-let changelog = "";
-if (fs.existsSync(changelogPath)) {
-  changelog = fs.readFileSync(changelogPath, "utf-8");
-}
-const today = new Date().toISOString().split("T")[0];
-const newSection = `## [${next}] - ${today}\n\n### Added\n- Release ${next}\n`;
-if (changelog.includes("## [Unreleased]")) {
-  changelog = changelog.replace("## [Unreleased]", `## [Unreleased]\n\n${newSection}`);
-} else {
-  changelog = `# Changelog\n\n## [Unreleased]\n\n${newSection}\n${changelog.replace("# Changelog\n\n", "")}`;
-}
-fs.writeFileSync(changelogPath, changelog, "utf-8");
-
-// Commit and tag
-execSync("git add package.json CHANGELOG.md", { stdio: "inherit" });
-execSync(`git commit -m "chore(release): v${next}"`, { stdio: "inherit" });
-execSync(`git tag v${next}`, { stdio: "inherit" });
-
-console.log(`\n✅ Released v${next}`);
-console.log(`Run "npm run release:push" to publish.`);