@danypops/papyrus 0.23.0 → 0.24.0

package/README.md

@@ -145,6 +145,7 @@ Tasks, Docs, Rules, and Skills all support first-class `update` (title/body/labe
 - `/rules` — severity/condition rows, exact injection preview, edit, enable/disable, and task gating
 - `/skills` — trigger/tools rows, edit, invocation into the editor, and artifact templates
 - `/playbooks` — trigger/tools rows, edit, invocation into the editor, and graph links
+- `/playbook <name>` — tab-completes active playbook titles and places that one's invocation directly in the editor, one step instead of browse-then-select; no argument falls back to the full `/playbooks` browser
 
 All frontends use daemon-backed domain operations; none opens SQLite from the Pi process. **Show details** opens a bounded navigable view across Tasks, Notes, Docs, Rules, legacy Skills, templates, and workflow Skills. User-authored bodies render as width-aware Markdown with headings, emphasis, links, quotes, lists, tables, inline/fenced code, syntax highlighting, and every color/decorative style derived dynamically from the active Pi theme. Generated lifecycle, metadata, checklist, gate, history, and relationship sections keep explicit semantic theme colors. `↑/↓` scrolls, `←/→` pans wide relationships, and Esc returns to the browser; non-interactive clients receive stable source text.
 

package/extension/src/index.ts

@@ -462,6 +462,11 @@ export default async function (pi: ExtensionAPI) {
 		description: "Browse, edit, and invoke Papyrus playbooks -- trigger/steps guidance an agent reads and follows (interactive)",
 		handler: async (_args, ctx) => { await playbooksModule.showPlaybooks(ctx); },
 	});
+	pi.registerCommand("playbook", {
+		description: "Open one Papyrus playbook directly by name (tab-completes active playbook titles) and place its invocation in the editor; no argument opens the full /playbooks browser instead",
+		getArgumentCompletions: (argumentPrefix) => playbooksModule.playbookArgumentCompletions(argumentPrefix),
+		handler: async (args, ctx) => { await playbooksModule.openPlaybookByName(args, ctx); },
+	});
 	pi.registerCommand("discuss", {
 		description: "Browse Papyrus Discussions and reply, defer, resume, settle, or block/unblock a task (interactive)",
 		handler: async (_args, ctx) => { await discussModule.showDiscussions(ctx); },

package/extension/src/playbooks.ts

@@ -1,9 +1,44 @@
+import type { AutocompleteItem } from "@earendil-works/pi-tui";
 import type { ExtensionCommandContext, Theme } from "@earendil-works/pi-coding-agent";
 import type { Artifact } from "../../src/domain/artifact.ts";
 import { showArtifactBrowser, showArtifactDetails } from "./artifact-browser.ts";
 import { PLAYBOOK_STATUS_PRESENTATION } from "./artifact-status-presentation.ts";
+import { matchArtifactByName } from "./domain-tools.ts";
 import { callService } from "./service-client.ts";
 
+const PLAYBOOK_COMPLETION_MAX_CANDIDATES = 100;
+
+async function activePlaybooks(): Promise<Artifact[]> {
+	return callService<Record<string, unknown>, Artifact[]>("playbooks.list", { status: "active", limit: PLAYBOOK_COMPLETION_MAX_CANDIDATES });
+}
+
+/** `/playbook <tab>` completions -- title-prefix match, since that's what a human actually types, not a full-text search of body content. */
+export async function playbookArgumentCompletions(argumentPrefix: string): Promise<AutocompleteItem[] | null> {
+	try {
+		const needle = argumentPrefix.trim().toLowerCase();
+		const rows = await activePlaybooks();
+		return rows
+			.filter((row) => row.title.toLowerCase().startsWith(needle))
+			.sort((a, b) => a.title.localeCompare(b.title))
+			.map((row) => ({ value: row.title, label: row.title, description: typeof row.extra["trigger"] === "string" ? row.extra["trigger"] : undefined }));
+	} catch {
+		return null; // a Papyrus daemon hiccup degrades to "no suggestions", never breaks the command line
+	}
+}
+
+/** `/playbook <name>` (no args opens the full browser instead): resolves by exact title, then places its invocation directly in the editor -- one step, not browse-then-select-then-invoke. */
+export async function openPlaybookByName(name: string, ctx: ExtensionCommandContext): Promise<void> {
+	if (!name.trim()) { await showPlaybooks(ctx); return; }
+	try {
+		const id = matchArtifactByName(await activePlaybooks(), name);
+		const invocation = await callService<Record<string, unknown>, string>("playbooks.invoke", { id });
+		ctx.ui.setEditorText(invocation);
+		ctx.ui.notify(`"${name.trim()}" invocation placed in the editor`, "info");
+	} catch (error) {
+		ctx.ui.notify(error instanceof Error ? error.message : String(error), "error");
+	}
+}
+
 const PLAYBOOK_RELATIONS = ["references", "documents", "relates_to", "contains", "part_of"];
 
 function strings(value: unknown): string[] {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/papyrus",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "Daemon-backed graph artifacts, evidence-bearing tasks, rules, skills, and native TUI workflows for Pi",
   "type": "module",
   "keywords": ["pi-package"],