incitaciones 0.2.0 → 0.3.0

package/pi-package/skills/whisper/references/status.md

@@ -0,0 +1,49 @@
+# Status
+
+Show the state of the current workspace.
+
+## Steps
+
+1. Get repo URL and branch slug:
+   ```bash
+   repo_url=$(git remote get-url origin 2>/dev/null | sed 's|https://||;s|git@||;s|\.git$||')
+   branch=$(git rev-parse --abbrev-ref HEAD)
+   branch_slug=$(echo "$branch" | sed 's|/|--|g')
+   context_path=~/.whisper/repos/"${repo_url}"/branches/"${branch_slug}"/context.md
+   ```
+
+2. If `context.md` doesn't exist, delegate to **check** mode and stop.
+
+3. Read `context.md` and extract: repo, branch, path, beads-epic.
+
+4. Show `env.md` info:
+   ```bash
+   date -r ~/.whisper/repos/"${repo_url}"/env.md "+%Y-%m-%d %H:%M" 2>/dev/null
+   ```
+
+5. Show the branch epic's tree if beads is available:
+   ```bash
+   bd children <beads-epic> --pretty 2>/dev/null
+   ```
+
+6. Show plan status: is `plan.md` a stub or does it have real content?
+
+7. Show all active branch slots for this repo (most recently modified first):
+   ```bash
+   ls -t ~/.whisper/repos/"${repo_url}"/branches/ 2>/dev/null
+   ```
+
+### Output format
+
+```
+── Whisper: <repo> ──
+Branch:    <branch>  (branches/<slug>/)
+Plan:      [exists | stub]
+Epic:      <id> — <n> issues (<open> open)   [or: none linked yet]
+
+Active branch slots:
+  <ls output>
+
+Epic tree:
+  <bd children --pretty output, or "none">
+```

package/scripts/generate-pi-resources.mjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const repoRoot = path.resolve(__dirname, "..");
+const manifestPath = path.join(repoRoot, "content", "manifest.json");
+const outRoot = path.join(repoRoot, "pi-package");
+const skillsOut = path.join(outRoot, "skills");
+const promptsOut = path.join(outRoot, "prompts");
+
+function escapeYamlDoubleQuoted(value) {
+  return String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function resetDir(dir) {
+  if (fs.existsSync(dir)) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      fs.rmSync(path.join(dir, entry.name), { recursive: true, force: true, maxRetries: 3, retryDelay: 50 });
+    }
+  }
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function readText(filePath) {
+  return fs.readFileSync(filePath, "utf8");
+}
+
+function generateSkill(prompt) {
+  const distilledPath = path.join(repoRoot, prompt.distilled);
+  const skillDir = path.join(skillsOut, prompt.name);
+  ensureDir(skillDir);
+
+  const frontmatter = [
+    "---",
+    `name: ${prompt.name}`,
+    `description: \"${escapeYamlDoubleQuoted(prompt.description || `Incitaciones prompt: ${prompt.name}`)}\"`,
+    "metadata:",
+    '  installed-from: "incitaciones"',
+    "---",
+    "",
+  ].join("\n");
+
+  fs.writeFileSync(path.join(skillDir, "SKILL.md"), frontmatter + readText(distilledPath), "utf8");
+
+  if (distilledPath.endsWith(`${path.sep}SKILL.md`)) {
+    const srcDir = path.dirname(distilledPath);
+    for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+      if (entry.name === "SKILL.md") continue;
+      const src = path.join(srcDir, entry.name);
+      const dst = path.join(skillDir, entry.name);
+      if (entry.isDirectory()) {
+        fs.cpSync(src, dst, { recursive: true });
+      } else {
+        fs.copyFileSync(src, dst);
+      }
+    }
+  }
+}
+
+function generatePromptTemplate(prompt) {
+  const description = prompt.description || `Incitaciones prompt: ${prompt.name}`;
+  const template = [
+    "---",
+    `description: \"${escapeYamlDoubleQuoted(`Shortcut for the ${prompt.name} skill. ${description}`)}\"`,
+    "---",
+    "<!-- installed-from: incitaciones -->",
+    "",
+    `Use the installed \`${prompt.name}\` skill for this task.`,
+    "",
+    `If the skill is not automatically loaded, invoke \`/skill:${prompt.name}\` and follow it.`,
+    "",
+    "User context: $@",
+    "",
+  ].join("\n");
+
+  fs.writeFileSync(path.join(promptsOut, `${prompt.name}.md`), template, "utf8");
+}
+
+function main() {
+  const manifest = JSON.parse(readText(manifestPath));
+  resetDir(outRoot);
+  ensureDir(skillsOut);
+  ensureDir(promptsOut);
+
+  for (const prompt of manifest.prompts) {
+    generateSkill(prompt);
+    generatePromptTemplate(prompt);
+  }
+
+  const readme = [
+    "# Generated pi package resources",
+    "",
+    "This directory is generated by `node scripts/generate-pi-resources.mjs`.",
+    "The generated files are committed so `pi install .` works from a clean checkout.",
+    "Refresh them with `just generate-pi-resources` after changing distilled content or manifest entries.",
+    "Do not edit files here by hand.",
+    "",
+    "- `skills/` contains pi-compatible Agent Skills",
+    "- `prompts/` contains pi prompt templates",
+    "",
+    "## Install from npm",
+    "",
+    "```bash",
+    "pi install npm:incitaciones",
+    "```",
+    "",
+    "This package is published as [`incitaciones` on npm](https://www.npmjs.com/package/incitaciones).",
+    "",
+  ].join("\n");
+  fs.writeFileSync(path.join(outRoot, "README.md"), readme, "utf8");
+
+  console.log(`Generated pi resources for ${manifest.prompts.length} prompts in ${path.relative(repoRoot, outRoot)}/`);
+}
+
+main();