@danypops/papyrus 0.44.10 → 0.44.11

package/package.json

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

package/src/artifact/artifact.ts

@@ -20,6 +20,29 @@ export interface Artifact {
 	edges?: ArtifactEdge[];
 }
 
+/**
+ * A list operation's default projection: everything needed to identify, browse, and pick
+ * one artifact out of many, without its body/extra -- the same fields show()'s own full
+ * Artifact carries minus the two that make listing dozens of rows as expensive as showing
+ * each one individually (a Playbook's full runbook body, a Rule's condition/action text).
+ */
+export interface ArtifactSummary {
+	id: string;
+	kind: string;
+	title: string;
+	status: string;
+	subtype: string;
+	labels: string[];
+	created_at: string;
+	updated_at: string;
+	alias: string;
+}
+
+export function summarizeArtifact(artifact: Artifact): ArtifactSummary {
+	const { id, kind, title, status, subtype, labels, created_at, updated_at, alias } = artifact;
+	return { id, kind, title, status, subtype, labels, created_at, updated_at, alias };
+}
+
 export interface CreateArtifactInput {
 	kind?: string;
 	title?: string;

package/src/handlers/docs.ts

@@ -9,7 +9,7 @@ import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import type { AuthorityRegistry } from "../authority-registry.ts";
 import { listDocuments } from "../domain-services.ts";
 import { docsOperations } from "../modules/docs.ts";
-import { createOperationDefiner, numberProp, resolveArtifactIdWidened, stringProp, validationError } from "./shared.ts";
+import { booleanProp, createOperationDefiner, numberProp, resolveArtifactIdWidened, stringProp, validationError } from "./shared.ts";
 
 const OWNER = "docs";
 
@@ -66,9 +66,9 @@ export function registerDocsVehicleOperations(
 
 	define(
 		"list",
-		"Lists Docs matching an optional status/text filter, scoped to project_root when given.",
+		"Lists Docs matching an optional status/text filter, scoped to project_root when given. Returns a lean summary (no body) by default -- pass full: true for the complete artifact.",
 		"read",
-		{ status: stringProp, text: stringProp, limit: numberProp, project_root: stringProp },
+		{ status: stringProp, text: stringProp, limit: numberProp, project_root: stringProp, full: booleanProp },
 		[],
 		(input) => input,
 	);

package/src/handlers/playbooks.ts

@@ -29,6 +29,7 @@ import type { TaskEventStore } from "../stores/task-event-store.ts";
 import type { TaskScopeStore } from "../stores/task-scope-store.ts";
 import type { Tasks } from "../task/task-service.ts";
 import {
+	booleanProp,
 	buildWorkflowRunContent,
 	classifyPlaybookComposition,
 	classifySessionAuthorization,
@@ -107,9 +108,9 @@ export function registerPlaybooksVehicleOperations(registry: VehicleRegistry, de
 
 	define(
 		"list",
-		"Lists Playbooks matching an optional status/text filter, scoped to project_root when given.",
+		"Lists Playbooks matching an optional status/text filter, scoped to project_root when given. Returns a lean summary (no body/steps) by default -- pass full: true for the complete artifact.",
 		"read",
-		{ status: stringProp, text: stringProp, limit: numberProp, project_root: stringProp },
+		{ status: stringProp, text: stringProp, limit: numberProp, project_root: stringProp, full: booleanProp },
 		[],
 		(input) => input,
 	);

package/src/handlers/rules.ts

@@ -9,7 +9,7 @@ import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
 import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import { listRules } from "../domain-services.ts";
 import { rulesOperations } from "../modules/rules.ts";
-import { createOperationDefiner, numberProp, resolveArtifactIdWidened, stringProp, validationError } from "./shared.ts";
+import { booleanProp, createOperationDefiner, numberProp, resolveArtifactIdWidened, stringProp, validationError } from "./shared.ts";
 
 const OWNER = "rules";
 
@@ -70,9 +70,9 @@ export function registerRulesVehicleOperations(registry: VehicleRegistry, artifa
 
 	define(
 		"list",
-		"Lists Rules matching an optional status/text filter, scoped to project_root when given.",
+		"Lists Rules matching an optional status/text filter, scoped to project_root when given. Returns a lean summary (no condition/action/body) by default -- pass full: true for the complete artifact.",
 		"read",
-		{ status: stringProp, text: stringProp, limit: numberProp, project_root: stringProp },
+		{ status: stringProp, text: stringProp, limit: numberProp, project_root: stringProp, full: booleanProp },
 		[],
 		(input) => input,
 	);

package/src/handlers/shared.ts

@@ -57,6 +57,7 @@ export const passthroughOutput: VehicleSchemaCodec<unknown> = defineVehicleSchem
 
 export const stringProp = { type: "string" } as const;
 export const numberProp = { type: "number" } as const;
+export const booleanProp = { type: "boolean" } as const;
 
 /**
  * A plain `throw new Error(...)` inside any resolve()/execute() step here is caught by

package/src/modules/docs.ts

@@ -7,6 +7,7 @@
  * ArtifactStore-based with no other module's concrete class dependency.
  */
 
+import { summarizeArtifact } from "../artifact/artifact.ts";
 import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
 import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import type { AuthorityRegistry } from "../authority-registry.ts";
@@ -21,7 +22,7 @@ import {
 	updateDocument,
 } from "../domain-services.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import { type OperationInput, optionalNumber, optionalString, string } from "./operation-input.ts";
+import { type OperationInput, optionalBoolean, optionalNumber, optionalString, string } from "./operation-input.ts";
 
 const MODULE_ID = "docs";
 
@@ -76,7 +77,10 @@ export function docsOperations(artifacts: ArtifactStore, scopes: ArtifactScopeSt
 				eventContext(input),
 			),
 		),
-		define("docs.list", (input: OperationInput) => listDocuments(artifacts, scopes, artifactFilter(input))),
+		define("docs.list", (input: OperationInput) => {
+			const docs = listDocuments(artifacts, scopes, artifactFilter(input));
+			return optionalBoolean(input, "full") === true ? docs : docs.map(summarizeArtifact);
+		}),
 		define("docs.show", (input: OperationInput) => showDocument(artifacts, string(input, "id"))),
 		define("docs.activate", (input: OperationInput) =>
 			transitionDocument(artifacts, string(input, "id"), "activate", authority, eventContext(input)),

package/src/modules/operation-input.ts

@@ -33,3 +33,10 @@ export function optionalNumber(input: OperationInput, key: string): number | und
 	if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`${key} must be a number`);
 	return value;
 }
+
+export function optionalBoolean(input: OperationInput, key: string): boolean | undefined {
+	const value = input[key];
+	if (value === undefined) return undefined;
+	if (typeof value !== "boolean") throw new Error(`${key} must be a boolean`);
+	return value;
+}

package/src/modules/playbooks.ts

@@ -10,6 +10,7 @@
  * playbook/playbook-definition.ts for the full rationale.
  */
 
+import { summarizeArtifact } from "../artifact/artifact.ts";
 import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
 import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import {
@@ -31,7 +32,7 @@ import type { SessionIdentity } from "../session-identity/session-identity-servi
 import type { TaskEventStore } from "../stores/task-event-store.ts";
 import type { TaskScopeStore } from "../stores/task-scope-store.ts";
 import type { Tasks } from "../task/task-service.ts";
-import { type OperationInput, optionalNumber, optionalString, string } from "./operation-input.ts";
+import { type OperationInput, optionalBoolean, optionalNumber, optionalString, string } from "./operation-input.ts";
 
 const MODULE_ID = "playbooks";
 
@@ -114,7 +115,10 @@ export function playbooksOperations({
 				eventContext(input),
 			),
 		),
-		define("playbooks.list", (input: OperationInput) => listPlaybooks(artifacts, artifactScopes, artifactFilter(input))),
+		define("playbooks.list", (input: OperationInput) => {
+			const playbooks = listPlaybooks(artifacts, artifactScopes, artifactFilter(input));
+			return optionalBoolean(input, "full") === true ? playbooks : playbooks.map(summarizeArtifact);
+		}),
 		define("playbooks.show", (input: OperationInput) => showPlaybook(artifacts, string(input, "id"))),
 		define("playbooks.preview", (input: OperationInput) =>
 			playbookInvocation(artifacts, string(input, "id"), input.arguments as Record<string, unknown> | undefined),

package/src/modules/rules.ts

@@ -11,6 +11,7 @@
  * registry" convention.
  */
 
+import { summarizeArtifact } from "../artifact/artifact.ts";
 import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
 import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import {
@@ -24,7 +25,7 @@ import {
 	updateRule,
 } from "../domain-services.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import { type OperationInput, optionalNumber, optionalString, string } from "./operation-input.ts";
+import { type OperationInput, optionalBoolean, optionalNumber, optionalString, string } from "./operation-input.ts";
 
 const MODULE_ID = "rules";
 
@@ -79,7 +80,10 @@ export function rulesOperations(artifacts: ArtifactStore, scopes: ArtifactScopeS
 				eventContext(input),
 			),
 		),
-		define("rules.list", (input: OperationInput) => listRules(artifacts, scopes, artifactFilter(input))),
+		define("rules.list", (input: OperationInput) => {
+			const rules = listRules(artifacts, scopes, artifactFilter(input));
+			return optionalBoolean(input, "full") === true ? rules : rules.map(summarizeArtifact);
+		}),
 		define("rules.show", (input: OperationInput) => showRule(artifacts, string(input, "id"))),
 		define("rules.preview", (input: OperationInput) => previewRule(artifacts, string(input, "id"))),
 		define("rules.enable", (input: OperationInput) => transitionRule(artifacts, string(input, "id"), "enable", eventContext(input))),