@danypops/papyrus 0.57.0 → 0.58.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/papyrus",
-  "version": "0.57.0",
+  "version": "0.58.0",
   "description": "Daemon-backed graph artifacts, evidence-bearing tasks, rules, skills, and native TUI workflows for Pi",
   "type": "module",
   "main": "./src/index.ts",

package/src/artifact/artifact-scope-store.ts

@@ -1,5 +1,5 @@
+import type { ScopeAssignmentSource } from "../project-registry/scope-source.ts";
 import type { ScopeMemberRef } from "../scope-group/scope-group.ts";
-import type { TaskScopeSource } from "../task-scope/task-scope.ts";
 
 /**
  * Project scoping for Docs/Rules/Playbooks: an artifact is explicitly "none" (hidden -- never
@@ -19,13 +19,13 @@ export interface ArtifactScope {
 	mode: ArtifactScopeMode;
 	/** Direct membership only (not expanded through nested groups) -- always empty when mode is "none"/"all", always non-empty when mode is "explicit". */
 	members: ScopeMemberRef[];
-	source: TaskScopeSource;
+	source: ScopeAssignmentSource;
 }
 
 export interface LegacyArtifactScope {
 	artifactId: string;
 	projectRoot?: string;
-	source: TaskScopeSource;
+	source: ScopeAssignmentSource;
 }
 
 export interface ArtifactScopeStore {
@@ -34,15 +34,15 @@ export interface ArtifactScopeStore {
 	/** Single-root compatibility view over scope(): an "all"/"none" or unscoped artifact omits projectRoot; an "explicit" mode artifact with exactly one project-type membership (and no group members) resolves it back to that project's current root; anything else (zero, more than one, or any group membership) omits projectRoot, since this shape cannot represent it. */
 	get(artifactId: string): LegacyArtifactScope | undefined;
 	/** Single-root compatibility shim: registers/resolves projectRoot and replaces the artifact's scope with exactly that one project membership, or setAll() when projectRoot is undefined. Every existing caller (rules/docs/playbooks assign_project) keeps working unchanged. */
-	assign(artifactId: string, projectRoot: string | undefined, source: TaskScopeSource): LegacyArtifactScope;
+	assign(artifactId: string, projectRoot: string | undefined, source: ScopeAssignmentSource): LegacyArtifactScope;
 	/** Sets an artifact to explicitly "all" (applies everywhere), clearing any membership. */
-	setAll(artifactId: string, source: TaskScopeSource): ArtifactScope;
+	setAll(artifactId: string, source: ScopeAssignmentSource): ArtifactScope;
 	/** Sets an artifact to explicitly "none" (fully hidden -- never applicable, never context-injected, regardless of project), clearing any membership. */
-	setNone(artifactId: string, source: TaskScopeSource): ArtifactScope;
+	setNone(artifactId: string, source: ScopeAssignmentSource): ArtifactScope;
 	/** Replaces an artifact's entire explicit membership set with exactly these (project and/or group) members -- must be non-empty; use setAll/setNone to clear scoping entirely. */
-	replaceMembers(artifactId: string, members: readonly ScopeMemberRef[], source: TaskScopeSource): ArtifactScope;
+	replaceMembers(artifactId: string, members: readonly ScopeMemberRef[], source: ScopeAssignmentSource): ArtifactScope;
 	/** Adds one member to an artifact's explicit membership (idempotent), switching mode to "explicit" if it was "all"/"none". Enforces the bounded maximum membership count. */
-	addMember(artifactId: string, member: ScopeMemberRef, source: TaskScopeSource): ArtifactScope;
+	addMember(artifactId: string, member: ScopeMemberRef, source: ScopeAssignmentSource): ArtifactScope;
 	/** Removes one member from an artifact's explicit membership (idempotent). Rejects removing the last membership while mode is "explicit": a caller must explicitly call setAll/setNone instead of accidentally broadening/narrowing scope by emptying the set. */
 	removeMember(artifactId: string, member: ScopeMemberRef): ArtifactScope;
 	/** Bounded id listing for one project root's EXACT direct membership (or the "all" bucket when projectRoot is undefined) -- an unregistered root always yields an empty list. Deliberately does not expand nested groups (audit semantics, matching this method's own pre-existing "exact membership" contract) -- use appliesToProjectRoot for the applicable/injection query instead. */

package/src/artifact/in-memory-artifact-scope-store.ts

@@ -1,16 +1,16 @@
 import { ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT } from "../constants.ts";
 import { InMemoryProjectRegistryStore } from "../project-registry/in-memory-project-registry-store.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
+import type { ScopeAssignmentSource } from "../project-registry/scope-source.ts";
 import { InMemoryScopeGroupStore } from "../scope-group/in-memory-scope-group-store.ts";
 import { type ScopeMemberRef, sameScopeMember } from "../scope-group/scope-group.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
-import type { TaskScopeSource } from "../task-scope/task-scope.ts";
 import type { ArtifactScope, ArtifactScopeMode, ArtifactScopeStore, LegacyArtifactScope } from "./artifact-scope-store.ts";
 
 interface Row {
 	mode: ArtifactScopeMode;
 	members: ScopeMemberRef[];
-	source: TaskScopeSource;
+	source: ScopeAssignmentSource;
 }
 
 export class InMemoryArtifactScopeStore implements ArtifactScopeStore {
@@ -45,7 +45,7 @@ export class InMemoryArtifactScopeStore implements ArtifactScopeStore {
 		return { artifactId, ...(projectRoot === undefined ? {} : { projectRoot }), source: row.source };
 	}
 
-	assign(artifactId: string, projectRoot: string | undefined, source: TaskScopeSource): LegacyArtifactScope {
+	assign(artifactId: string, projectRoot: string | undefined, source: ScopeAssignmentSource): LegacyArtifactScope {
 		if (projectRoot === undefined) {
 			this.setAll(artifactId, source);
 			return { artifactId, source };
@@ -55,19 +55,19 @@ export class InMemoryArtifactScopeStore implements ArtifactScopeStore {
 		return { artifactId, projectRoot: project.projectRoot, source };
 	}
 
-	setAll(artifactId: string, source: TaskScopeSource): ArtifactScope {
+	setAll(artifactId: string, source: ScopeAssignmentSource): ArtifactScope {
 		const row: Row = { mode: "all", members: [], source };
 		this.rows.set(artifactId, row);
 		return this.toScope(artifactId, row);
 	}
 
-	setNone(artifactId: string, source: TaskScopeSource): ArtifactScope {
+	setNone(artifactId: string, source: ScopeAssignmentSource): ArtifactScope {
 		const row: Row = { mode: "none", members: [], source };
 		this.rows.set(artifactId, row);
 		return this.toScope(artifactId, row);
 	}
 
-	replaceMembers(artifactId: string, members: readonly ScopeMemberRef[], source: TaskScopeSource): ArtifactScope {
+	replaceMembers(artifactId: string, members: readonly ScopeMemberRef[], source: ScopeAssignmentSource): ArtifactScope {
 		if (members.length === 0) throw new Error("replaceMembers requires at least one member; use setAll/setNone to clear scoping");
 		if (members.length > ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT) {
 			throw new Error(`an artifact cannot have more than ${ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT} scope members`);
@@ -78,7 +78,7 @@ export class InMemoryArtifactScopeStore implements ArtifactScopeStore {
 		return this.toScope(artifactId, row);
 	}
 
-	addMember(artifactId: string, member: ScopeMemberRef, source: TaskScopeSource): ArtifactScope {
+	addMember(artifactId: string, member: ScopeMemberRef, source: ScopeAssignmentSource): ArtifactScope {
 		const existing = this.rows.get(artifactId);
 		const members = dedupeMembers(existing?.mode === "explicit" ? existing.members : []);
 		if (!members.some((candidate) => sameScopeMember(candidate, member)) && members.length >= ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT) {

package/src/artifact/sqlite-artifact-scope-store.ts

@@ -1,16 +1,16 @@
 import { ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT } from "../constants.ts";
 import type { Db } from "../db.ts";
 import { inTransaction } from "../db.ts";
+import type { ScopeAssignmentSource } from "../project-registry/scope-source.ts";
 import { SQLiteProjectRegistryStore } from "../project-registry/sqlite-project-registry-store.ts";
 import type { ScopeMemberRef } from "../scope-group/scope-group.ts";
 import { SQLiteScopeGroupStore } from "../scope-group/sqlite-scope-group-store.ts";
-import type { TaskScopeSource } from "../task-scope/task-scope.ts";
 import type { ArtifactScope, ArtifactScopeMode, ArtifactScopeStore, LegacyArtifactScope } from "./artifact-scope-store.ts";
 
 interface ScopeRow {
 	artifact_id: string;
 	mode: ArtifactScopeMode;
-	source: TaskScopeSource;
+	source: ScopeAssignmentSource;
 }
 
 interface MemberRow {
@@ -65,7 +65,7 @@ export class SQLiteArtifactScopeStore implements ArtifactScopeStore {
 		return { artifactId, ...(project ? { projectRoot: project.projectRoot } : {}), source: row.source };
 	}
 
-	assign(artifactId: string, projectRoot: string | undefined, source: TaskScopeSource): LegacyArtifactScope {
+	assign(artifactId: string, projectRoot: string | undefined, source: ScopeAssignmentSource): LegacyArtifactScope {
 		if (projectRoot === undefined) {
 			this.setAll(artifactId, source);
 			return { artifactId, source };
@@ -77,7 +77,7 @@ export class SQLiteArtifactScopeStore implements ArtifactScopeStore {
 		});
 	}
 
-	private upsertScopeRow(artifactId: string, mode: ArtifactScopeMode, source: TaskScopeSource): void {
+	private upsertScopeRow(artifactId: string, mode: ArtifactScopeMode, source: ScopeAssignmentSource): void {
 		this.db
 			.prepare(`
 				INSERT INTO artifact_scopes (artifact_id, project_root, mode, source, assigned_at)
@@ -91,7 +91,7 @@ export class SQLiteArtifactScopeStore implements ArtifactScopeStore {
 			.run(artifactId, mode, source, new Date().toISOString());
 	}
 
-	setAll(artifactId: string, source: TaskScopeSource): ArtifactScope {
+	setAll(artifactId: string, source: ScopeAssignmentSource): ArtifactScope {
 		return inTransaction(this.db, () => {
 			this.upsertScopeRow(artifactId, "all", source);
 			this.db.prepare("DELETE FROM artifact_scope_members WHERE artifact_id = ?").run(artifactId);
@@ -99,7 +99,7 @@ export class SQLiteArtifactScopeStore implements ArtifactScopeStore {
 		});
 	}
 
-	setNone(artifactId: string, source: TaskScopeSource): ArtifactScope {
+	setNone(artifactId: string, source: ScopeAssignmentSource): ArtifactScope {
 		return inTransaction(this.db, () => {
 			this.upsertScopeRow(artifactId, "none", source);
 			this.db.prepare("DELETE FROM artifact_scope_members WHERE artifact_id = ?").run(artifactId);
@@ -107,7 +107,7 @@ export class SQLiteArtifactScopeStore implements ArtifactScopeStore {
 		});
 	}
 
-	replaceMembers(artifactId: string, members: readonly ScopeMemberRef[], source: TaskScopeSource): ArtifactScope {
+	replaceMembers(artifactId: string, members: readonly ScopeMemberRef[], source: ScopeAssignmentSource): ArtifactScope {
 		if (members.length === 0) throw new Error("replaceMembers requires at least one member; use setAll/setNone to clear scoping");
 		if (members.length > ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT) {
 			throw new Error(`an artifact cannot have more than ${ARTIFACT_SCOPE_MAX_MEMBERS_PER_ARTIFACT} scope members`);
@@ -127,7 +127,7 @@ export class SQLiteArtifactScopeStore implements ArtifactScopeStore {
 		});
 	}
 
-	addMember(artifactId: string, member: ScopeMemberRef, source: TaskScopeSource): ArtifactScope {
+	addMember(artifactId: string, member: ScopeMemberRef, source: ScopeAssignmentSource): ArtifactScope {
 		return inTransaction(this.db, () => {
 			const current = this.members(artifactId);
 			const already = current.some((candidate) => candidate.type === member.type && candidate.id === member.id);

package/src/docs/docs-service.ts

@@ -30,8 +30,8 @@ import {
 } from "../domain-service-shared.ts";
 import { NOTE_SUBTYPE } from "../note/note-service.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
+import { normalizeProjectRoot } from "../project-registry/scope-source.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
-import { normalizeProjectRoot } from "../task-scope/task-scope.ts";
 
 function rejectsNoteTemplate(artifacts: ArtifactStore, templateId: string | undefined, subtype: string | undefined): boolean {
 	if (subtype === NOTE_SUBTYPE) return true;

package/src/domain-service-shared.ts

@@ -19,9 +19,9 @@ import {
 } from "./constants.ts";
 import { resolveProjectReference } from "./project-registry/project-registry.ts";
 import type { ProjectRegistryStore } from "./project-registry/project-registry-store.ts";
+import { normalizeProjectRoot } from "./project-registry/scope-source.ts";
 import { resolveScopeGroupReference } from "./scope-group/scope-group.ts";
 import type { ScopeGroupStore } from "./scope-group/scope-group-store.ts";
-import { normalizeProjectRoot } from "./task-scope/task-scope.ts";
 
 export interface UpdateContentInput {
 	title?: string;

package/src/handlers/playbooks.ts

@@ -27,9 +27,9 @@ import { listPlaybooks } from "../playbook/playbook-service.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
 import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
+import type { TaskEventSink } from "../task/event/task-event-store.ts";
+import type { TaskScopeAssigner } from "../task/scope/task-scope-store.ts";
 import type { Tasks } from "../task/task-service.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
-import type { TaskScopeStore } from "../task-scope/task-scope-store.ts";
 import {
 	booleanProp,
 	buildWorkflowRunContent,
@@ -53,8 +53,8 @@ const jsonObjectProp = {
 
 export interface PlaybooksVehicleDeps {
 	artifacts: ArtifactStore;
-	events: TaskEventStore;
-	scopes: TaskScopeStore;
+	events: TaskEventSink;
+	scopes: TaskScopeAssigner;
 	artifactScopes: ArtifactScopeStore;
 	tasks: Tasks;
 	sessionIdentity: SessionIdentity;

package/src/handlers/registry.ts

@@ -16,9 +16,9 @@ import type { Notes } from "../note/note-service.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
 import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
+import type { TaskEventStore } from "../task/event/task-event-store.ts";
+import type { TaskScopeStore } from "../task/scope/task-scope-store.ts";
 import type { Tasks } from "../task/task-service.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
-import type { TaskScopeStore } from "../task-scope/task-scope-store.ts";
 import { registerArtifactTrashOperations } from "./artifact-trash.ts";
 import { registerDiscussVehicleOperations } from "./discuss.ts";
 import { registerDocsVehicleOperations } from "./docs.ts";

package/src/handlers/task-classifiers.ts

@@ -10,8 +10,8 @@
 import { VehicleError } from "@danypops/vehicle-core";
 import { PlaybookCompositionError } from "../playbook/playbook-definition.ts";
 import { InvalidSessionSecretError } from "../session-identity/session-identity-service.ts";
+import { TaskCreateIdempotencyConflictError } from "../task/create-request/task-create-request-store.ts";
 import { TaskDependencyCycleError, TaskExecutionBoundExceededError } from "../task/task-execution.ts";
-import { TaskCreateIdempotencyConflictError } from "../task-create-request/task-create-request-store.ts";
 
 /**
  * tasks.focus/pause/unpause/clear_focus and playbooks.invoke all re-run

package/src/handlers/tasks.ts

@@ -27,6 +27,8 @@ import { GATE_TYPES } from "../gate/gate.ts";
 import { tasksOperations } from "../modules/tasks.ts";
 import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
 import { PROOF_TYPES } from "../task/checklist.ts";
+import { TaskMutationIdempotencyConflictError, TaskMutationPendingError } from "../task/mutation-request/task-mutation-request-store.ts";
+import type { TaskViewMode } from "../task/scope/task-scope.ts";
 import type { TaskExecutionPlan } from "../task/task-execution.ts";
 import {
 	type TaskCompletion,
@@ -36,8 +38,6 @@ import {
 	TaskProjectNotFoundError,
 	type Tasks,
 } from "../task/task-service.ts";
-import { TaskMutationIdempotencyConflictError, TaskMutationPendingError } from "../task-mutation-request/task-mutation-request-store.ts";
-import type { TaskViewMode } from "../task-scope/task-scope.ts";
 import {
 	booleanProp,
 	classifySessionAuthorization,

package/src/index.ts

@@ -28,6 +28,9 @@ export type { PlaybookInvocationResult, PlaybookMissingArguments } from "./playb
 export type { WorkflowRunResult } from "./playbook/workflow-execution.ts";
 export type { OperationName, SchemaState } from "./service.ts";
 export { checklistEntries, PROOF_TYPES, type ProofReference } from "./task/checklist.ts";
+export type { TaskEvent, TaskHistoryPage } from "./task/event/task-event.ts";
+export type { TaskLease, TaskLeaseView } from "./task/lease/task-lease.ts";
+export type { TaskViewSelection } from "./task/scope/task-scope.ts";
 export { taskContext } from "./task/task-context.ts";
 export { projectTaskExecution, type TaskExecutionPlan, type TaskExecutionState } from "./task/task-execution.ts";
 export { projectTaskGraph, type TaskGraphView } from "./task/task-graph-view.ts";
@@ -41,6 +44,3 @@ export type {
 	TaskStatus,
 } from "./task/task-service.ts";
 export { TaskInvalidTransitionError, TaskMutationReceiptNotFoundError } from "./task/task-service.ts";
-export type { TaskEvent, TaskHistoryPage } from "./task-event/task-event.ts";
-export type { TaskLease, TaskLeaseView } from "./task-lease/task-lease.ts";
-export type { TaskViewSelection } from "./task-scope/task-scope.ts";

package/src/modules/playbooks.ts

@@ -40,9 +40,9 @@ import {
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
 import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
+import type { TaskEventSink } from "../task/event/task-event-store.ts";
+import type { TaskScopeAssigner } from "../task/scope/task-scope-store.ts";
 import type { Tasks } from "../task/task-service.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
-import type { TaskScopeStore } from "../task-scope/task-scope-store.ts";
 import { type OperationInput, optionalBoolean, optionalNumber, optionalString, string } from "./operation-input.ts";
 
 const MODULE_ID = "playbooks";
@@ -105,8 +105,8 @@ export const PLAYBOOKS_OPERATION_NAMES = [
 
 export interface PlaybooksModuleDeps {
 	artifacts: ArtifactStore;
-	events: TaskEventStore;
-	scopes: TaskScopeStore;
+	events: TaskEventSink;
+	scopes: TaskScopeAssigner;
 	/** Docs/Rules/Skills/Playbooks project scoping (distinct from `scopes`, which is Task-run project scoping for playbooks.invoke's materialized tasks). */
 	artifactScopes: ArtifactScopeStore;
 	/** Used for exactly one thing: focusing the entry task after a successful invoke -- the one safety-checked Tasks operation this module needs, not bulk graph construction (that goes straight through artifacts/events/scopes in playbook/playbook-execution.ts, mirroring playbook/workflow-execution.ts). */

package/src/modules/projects.ts

@@ -11,7 +11,7 @@ import { TASK_PROJECT_LIST_MAX_RESULTS } from "../constants.ts";
 import type { OperationDefinition } from "../module-registry.ts";
 import { assertRegisterProjectInputBounds, resolveProjectReference } from "../project-registry/project-registry.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
-import { normalizeProjectRoot } from "../task-scope/task-scope.ts";
+import { normalizeProjectRoot } from "../project-registry/scope-source.ts";
 import { type OperationInput, optionalNumber, optionalString, optionalStringArray, string } from "./operation-input.ts";
 
 const MODULE_ID = "projects";

package/src/modules/tasks.ts

@@ -24,11 +24,11 @@ import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import type { OperationDefinition } from "../module-registry.ts";
 import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
 import type { Checklist } from "../task/checklist.ts";
+import type { TaskEventContext, TaskEventDirection, TaskEventFeedQuery } from "../task/event/task-event.ts";
+import type { TaskViewMode } from "../task/scope/task-scope.ts";
 import { taskContext } from "../task/task-context.ts";
 import { projectTaskExecution } from "../task/task-execution.ts";
 import type { TaskMutationRequestContext, TaskStatus, Tasks } from "../task/task-service.ts";
-import type { TaskEventContext, TaskEventDirection, TaskEventFeedQuery } from "../task-event/task-event.ts";
-import type { TaskViewMode } from "../task-scope/task-scope.ts";
 import { type OperationInput, optionalBoolean, optionalNumber, optionalString, optionalStringArray, string } from "./operation-input.ts";
 
 const MODULE_ID = "tasks";

package/src/playbook/playbook-service.ts

@@ -57,8 +57,8 @@ import {
 	type UpdateContentInput,
 } from "../domain-service-shared.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
+import { normalizeProjectRoot } from "../project-registry/scope-source.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
-import { normalizeProjectRoot } from "../task-scope/task-scope.ts";
 import {
 	BLUEPRINT_INPUT_TYPES,
 	type BlueprintArgumentValue,

package/src/playbook/workflow-execution.ts

@@ -9,13 +9,13 @@ import {
 	SKILL_WORKFLOW_MAX_NESTING_DEPTH,
 	TASK_EXECUTION_MAX_EDGES,
 } from "../constants.ts";
+import { normalizeProjectRoot } from "../project-registry/scope-source.ts";
 import { validateChecklist } from "../task/checklist.ts";
+import type { TaskEventContext } from "../task/event/task-event.ts";
+import type { TaskEventSink } from "../task/event/task-event-store.ts";
+import type { TaskScopeAssigner } from "../task/scope/task-scope-store.ts";
 import { projectTaskExecution, TaskExecutionBoundExceededError, type TaskExecutionPlan } from "../task/task-execution.ts";
 import type { TaskGraph, TaskNode, TaskStatus } from "../task/task-service.ts";
-import type { TaskEventContext } from "../task-event/task-event.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
-import { normalizeProjectRoot } from "../task-scope/task-scope.ts";
-import type { TaskScopeStore } from "../task-scope/task-scope-store.ts";
 import {
 	type BlueprintArgumentValue,
 	type BlueprintDefinition,
@@ -167,8 +167,8 @@ function executionGraph(tasks: Artifact[], definition: BlueprintDefinition, ids:
  * other project's context.
  */
 export type WorkflowRunHistory = {
-	events: TaskEventStore;
-	scopes: TaskScopeStore;
+	events: TaskEventSink;
+	scopes: TaskScopeAssigner;
 	artifactScopes?: ArtifactScopeStore;
 	projectRoot?: string;
 	context?: TaskEventContext;

package/src/project-registry/scope-source.ts

@@ -0,0 +1,29 @@
+import { basename, isAbsolute, normalize } from "node:path";
+import { TASK_PROJECT_ROOT_MAX_LENGTH } from "../constants.ts";
+
+/**
+ * How a project root ended up attached to a scoped artifact -- shared across every artifact kind
+ * (Tasks, Docs, Rules, Playbooks) rather than owned by Tasks alone, same category as Project
+ * itself in project-registry.ts. This lived inside task-scope.ts under the name
+ * `TaskScopeSource` until a SOLID audit (see Doc "SOLID pattern analysis: task-event/task-scope
+ * shared-kernel extraction") found it consumed identically by artifact/, docs-service.ts,
+ * rules-service.ts, playbook-service.ts, and modules/projects.ts -- a Role Interface split
+ * couldn't fix this half of the problem because there's no single supplier to narrow a contract
+ * for; every one of those five call sites is a peer owner of the same vocabulary. task-scope.ts
+ * keeps `TaskScopeSource` as a backward-compatible alias of this type for Task's own call sites.
+ */
+export type ScopeAssignmentSource = "cwd" | "explicit" | "unscoped";
+
+/**
+ * Same relocation as ScopeAssignmentSource above, for the same reason: a pure, artifact-kind-
+ * agnostic validation/normalization function that every non-Task scope-assigning service already
+ * called directly rather than through any Task-owned abstraction.
+ */
+export function normalizeProjectRoot(value: string): string {
+	if (!isAbsolute(value)) throw new Error("project_root must be an absolute path");
+	const normalized = normalize(value);
+	if (normalized.length > TASK_PROJECT_ROOT_MAX_LENGTH) {
+		throw new Error(`project_root cannot exceed ${TASK_PROJECT_ROOT_MAX_LENGTH} characters`);
+	}
+	return normalized;
+}

package/src/rules/rules-service.ts

@@ -31,8 +31,8 @@ import {
 	type UpdateContentInput,
 } from "../domain-service-shared.ts";
 import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
+import { normalizeProjectRoot } from "../project-registry/scope-source.ts";
 import type { ScopeGroupStore } from "../scope-group/scope-group-store.ts";
-import { normalizeProjectRoot } from "../task-scope/task-scope.ts";
 
 export interface CreateRuleInput {
 	title: string;

package/src/service.ts

@@ -43,17 +43,17 @@ import { listInjectableRules } from "./rules/rules-service.ts";
 import { SQLiteScopeGroupStore } from "./scope-group/sqlite-scope-group-store.ts";
 import { InvalidSessionSecretError, SessionIdentity } from "./session-identity/session-identity-service.ts";
 import { SQLiteSessionIdentityStore } from "./session-identity/sqlite-session-identity-store.ts";
+import { SQLiteTaskCreateRequestStore } from "./task/create-request/sqlite-task-create-request-store.ts";
+import { SQLiteTaskEventStore } from "./task/event/sqlite-task-event-store.ts";
+import type { TaskEventContext } from "./task/event/task-event.ts";
+import type { TaskEventStore } from "./task/event/task-event-store.ts";
+import { SQLiteTaskFocusStore } from "./task/focus/sqlite-task-focus-store.ts";
+import { SQLiteTaskLeaseStore } from "./task/lease/sqlite-task-lease-store.ts";
+import { SQLiteTaskMutationRequestStore } from "./task/mutation-request/sqlite-task-mutation-request-store.ts";
+import { SQLiteTaskScopeStore } from "./task/scope/sqlite-task-scope-store.ts";
+import type { TaskViewMode } from "./task/scope/task-scope.ts";
+import type { TaskScopeStore } from "./task/scope/task-scope-store.ts";
 import { type TaskStatus, Tasks } from "./task/task-service.ts";
-import { SQLiteTaskCreateRequestStore } from "./task-create-request/sqlite-task-create-request-store.ts";
-import { SQLiteTaskEventStore } from "./task-event/sqlite-task-event-store.ts";
-import type { TaskEventContext } from "./task-event/task-event.ts";
-import type { TaskEventStore } from "./task-event/task-event-store.ts";
-import { SQLiteTaskFocusStore } from "./task-focus/sqlite-task-focus-store.ts";
-import { SQLiteTaskLeaseStore } from "./task-lease/sqlite-task-lease-store.ts";
-import { SQLiteTaskMutationRequestStore } from "./task-mutation-request/sqlite-task-mutation-request-store.ts";
-import { SQLiteTaskScopeStore } from "./task-scope/sqlite-task-scope-store.ts";
-import type { TaskViewMode } from "./task-scope/task-scope.ts";
-import type { TaskScopeStore } from "./task-scope/task-scope-store.ts";
 import { VERSION } from "./version.ts";
 
 /**

package/src/{task-create-request → task/create-request}/sqlite-task-create-request-store.ts

@@ -1,5 +1,5 @@
-import type { Db } from "../db.ts";
-import type { TaskCreateRequestRecord, TaskCreateRequestStore } from "../task-create-request/task-create-request-store.ts";
+import type { Db } from "../../db.ts";
+import type { TaskCreateRequestRecord, TaskCreateRequestStore } from "./task-create-request-store.ts";
 
 export class SQLiteTaskCreateRequestStore implements TaskCreateRequestStore {
 	constructor(private readonly db: Db) {}

package/src/{task-event → task/event}/sqlite-task-event-store.ts

@@ -1,5 +1,5 @@
-import type { Db } from "../db.ts";
-import { inTransaction } from "../db.ts";
+import type { Db } from "../../db.ts";
+import { inTransaction } from "../../db.ts";
 import {
 	type AppendTaskEvent,
 	normalizeTaskEventFeedQuery,
@@ -13,8 +13,8 @@ import {
 	type TaskHistoryQuery,
 	type TaskLifecycleStatus,
 	validateTaskEvent,
-} from "../task-event/task-event.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
+} from "./task-event.ts";
+import type { TaskEventStore } from "./task-event-store.ts";
 
 interface TaskEventRow {
 	id: number;

package/src/{task-event → task/event}/task-event-store.ts

@@ -8,11 +8,24 @@ import {
 	type TaskHistoryPage,
 	type TaskHistoryQuery,
 	validateTaskEvent,
-} from "../task-event/task-event.ts";
+} from "./task-event.ts";
 
-export interface TaskEventStore {
+/**
+ * Role Interface (Fowler: https://martinfowler.com/bliki/RoleInterface.html) for the one
+ * collaboration playbook workflow execution actually has with Task's event log: append one event
+ * inside a single atomic transaction. Extracted after a SOLID audit found TaskEventStore's full
+ * Header Interface (all 4 methods, including history/feed -- pagination concerns that exist
+ * purely for Task's own history/feed reader endpoints) threaded unchanged through
+ * handlers/playbooks.ts, modules/playbooks.ts, and playbook/workflow-execution.ts, which never
+ * calls history()/feed() at all. TaskEventStore still implements this structurally with zero
+ * changes to either concrete store; only the playbook-facing field type narrows to this.
+ */
+export interface TaskEventSink {
 	atomic<T>(operation: () => T): T;
 	append(event: AppendTaskEvent): TaskEvent;
+}
+
+export interface TaskEventStore extends TaskEventSink {
 	history(taskId: string, query?: TaskHistoryQuery): TaskHistoryPage;
 	/** Bounded, sequenced, cross-task replay feed -- see TaskEventFeedQuery. */
 	feed(query?: TaskEventFeedQuery): TaskEventFeedPage;

package/src/{task-event → task/event}/task-event.ts

@@ -6,7 +6,7 @@ import {
 	TASK_EVENT_REASON_MAX_LENGTH,
 	TASK_HISTORY_DEFAULT_LIMIT,
 	TASK_HISTORY_MAX_LIMIT,
-} from "../constants.ts";
+} from "../../constants.ts";
 export type TaskLifecycleStatus = "todo" | "in-progress" | "review" | "rejected" | "done" | "canceled";
 
 export const TASK_EVENT_TYPES = [

package/src/{task-focus → task/focus}/sqlite-task-focus-store.ts

@@ -1,7 +1,7 @@
-import { TASK_FOCUS_MAX_SCOPES } from "../constants.ts";
-import type { Db } from "../db.ts";
-import { inTransaction } from "../db.ts";
-import { normalizeFocusScope, type TaskFocusState, type TaskFocusStatus, type TaskFocusStore } from "../task-focus/task-focus-store.ts";
+import { TASK_FOCUS_MAX_SCOPES } from "../../constants.ts";
+import type { Db } from "../../db.ts";
+import { inTransaction } from "../../db.ts";
+import { normalizeFocusScope, type TaskFocusState, type TaskFocusStatus, type TaskFocusStore } from "./task-focus-store.ts";
 
 export class SQLiteTaskFocusStore implements TaskFocusStore {
 	constructor(private readonly db: Db) {}

package/src/{task-focus → task/focus}/task-focus-store.ts

@@ -1,4 +1,4 @@
-import { TASK_FOCUS_DEFAULT_SCOPE, TASK_FOCUS_MAX_SCOPES, TASK_FOCUS_SCOPE_MAX_LENGTH } from "../constants.ts";
+import { TASK_FOCUS_DEFAULT_SCOPE, TASK_FOCUS_MAX_SCOPES, TASK_FOCUS_SCOPE_MAX_LENGTH } from "../../constants.ts";
 
 export type TaskFocusStatus = "active" | "paused";
 

package/src/{task-lease → task/lease}/sqlite-task-lease-store.ts

@@ -1,8 +1,8 @@
-import { TASK_LEASE_DEFAULT_TTL_MS } from "../constants.ts";
-import type { Db } from "../db.ts";
-import { inTransaction } from "../db.ts";
-import { isLeaseExpired, type TaskLease, validateLeaseNote, validateLeaseOwner, validateLeaseTtlMs } from "../task-lease/task-lease.ts";
-import type { TaskLeaseStore } from "../task-lease/task-lease-store.ts";
+import { TASK_LEASE_DEFAULT_TTL_MS } from "../../constants.ts";
+import type { Db } from "../../db.ts";
+import { inTransaction } from "../../db.ts";
+import { isLeaseExpired, type TaskLease, validateLeaseNote, validateLeaseOwner, validateLeaseTtlMs } from "./task-lease.ts";
+import type { TaskLeaseStore } from "./task-lease-store.ts";
 
 interface TaskLeaseRow {
 	task_id: string;

package/src/{task-lease → task/lease}/task-lease-store.ts

@@ -1,5 +1,5 @@
-import { TASK_LEASE_DEFAULT_TTL_MS } from "../constants.ts";
-import { isLeaseExpired, type TaskLease, validateLeaseNote, validateLeaseOwner, validateLeaseTtlMs } from "../task-lease/task-lease.ts";
+import { TASK_LEASE_DEFAULT_TTL_MS } from "../../constants.ts";
+import { isLeaseExpired, type TaskLease, validateLeaseNote, validateLeaseOwner, validateLeaseTtlMs } from "./task-lease.ts";
 
 export interface TaskLeaseStore {
 	/**

package/src/{task-lease → task/lease}/task-lease.ts

@@ -1,4 +1,4 @@
-import { TASK_LEASE_MAX_TTL_MS, TASK_LEASE_MIN_TTL_MS, TASK_LEASE_NOTE_MAX_LENGTH, TASK_LEASE_OWNER_MAX_LENGTH } from "../constants.ts";
+import { TASK_LEASE_MAX_TTL_MS, TASK_LEASE_MIN_TTL_MS, TASK_LEASE_NOTE_MAX_LENGTH, TASK_LEASE_OWNER_MAX_LENGTH } from "../../constants.ts";
 
 /**
  * A bounded work reservation on a Task, independent of both the Task's own lifecycle status

package/src/{task-mutation-request → task/mutation-request}/sqlite-task-mutation-request-store.ts

@@ -1,9 +1,5 @@
-import type { Db } from "../db.ts";
-import {
-	TaskMutationPendingError,
-	type TaskMutationRequestRecord,
-	type TaskMutationRequestStore,
-} from "../task-mutation-request/task-mutation-request-store.ts";
+import type { Db } from "../../db.ts";
+import { TaskMutationPendingError, type TaskMutationRequestRecord, type TaskMutationRequestStore } from "./task-mutation-request-store.ts";
 
 interface TaskMutationRequestRow {
 	request_scope: string;

package/src/{task-scope → task/scope}/sqlite-task-scope-store.ts

@@ -1,6 +1,6 @@
-import type { Db } from "../db.ts";
-import { inTransaction } from "../db.ts";
-import { SQLiteProjectRegistryStore } from "../project-registry/sqlite-project-registry-store.ts";
+import type { Db } from "../../db.ts";
+import { inTransaction } from "../../db.ts";
+import { SQLiteProjectRegistryStore } from "../../project-registry/sqlite-project-registry-store.ts";
 import type {
 	RegisterTaskProjectInput,
 	TaskProject,
@@ -8,8 +8,8 @@ import type {
 	TaskScopeSource,
 	TaskViewMode,
 	TaskViewPreference,
-} from "../task-scope/task-scope.ts";
-import type { TaskScopeStore } from "../task-scope/task-scope-store.ts";
+} from "./task-scope.ts";
+import type { TaskScopeStore } from "./task-scope-store.ts";
 
 /** Rewrites every task_scopes/task_views row pinned to a project root that just moved -- called inside the same registerProject() transaction, so a rename/move is atomic with the rewrite. */
 function rewriteTaskRowsForMovedRoot(db: Db, previousRoot: string, nextRoot: string): void {

package/src/{task-scope → task/scope}/task-scope-store.ts

@@ -1,5 +1,5 @@
-import { InMemoryProjectRegistryStore } from "../project-registry/in-memory-project-registry-store.ts";
-import type { ProjectRegistryStore } from "../project-registry/project-registry-store.ts";
+import { InMemoryProjectRegistryStore } from "../../project-registry/in-memory-project-registry-store.ts";
+import type { ProjectRegistryStore } from "../../project-registry/project-registry-store.ts";
 import type {
 	RegisterTaskProjectInput,
 	TaskProject,
@@ -7,10 +7,24 @@ import type {
 	TaskScopeSource,
 	TaskViewMode,
 	TaskViewPreference,
-} from "../task-scope/task-scope.ts";
+} from "./task-scope.ts";
 
-export interface TaskScopeStore {
+/**
+ * Role Interface (Fowler: https://martinfowler.com/bliki/RoleInterface.html) for the one
+ * collaboration playbook workflow execution actually has with Task's own scope bookkeeping:
+ * assigning a task's project scope when a playbook step creates/advances one. Extracted after a
+ * SOLID audit found TaskScopeStore's full Header Interface (all 8 methods -- project-catalog
+ * registration, view-preference bookkeeping, task-id listing, none of which playbook ever
+ * touches) threaded unchanged through handlers/playbooks.ts, modules/playbooks.ts, and
+ * playbook/workflow-execution.ts, which only ever calls .assign(). TaskScopeStore still
+ * implements this structurally with zero changes to either concrete store; only the
+ * playbook-facing field type narrows to this.
+ */
+export interface TaskScopeAssigner {
 	assign(taskId: string, projectRoot: string | undefined, source: TaskScopeSource): TaskProjectScope;
+}
+
+export interface TaskScopeStore extends TaskScopeAssigner {
 	get(taskId: string): TaskProjectScope | undefined;
 	taskIds(projectRoot: string | undefined, limit: number): string[];
 	view(projectRoot: string): TaskViewPreference;

package/src/{task-scope → task/scope}/task-scope.ts

@@ -1,9 +1,13 @@
-import { basename, isAbsolute, normalize } from "node:path";
-import { TASK_PROJECT_ROOT_MAX_LENGTH } from "../constants.ts";
-import type { Project, RegisterProjectInput } from "../project-registry/project-registry.ts";
+import { basename } from "node:path";
+import type { Project, RegisterProjectInput } from "../../project-registry/project-registry.ts";
+import type { ScopeAssignmentSource } from "../../project-registry/scope-source.ts";
+
+export { normalizeProjectRoot } from "../../project-registry/scope-source.ts";
 
 export type TaskViewMode = "project" | "graph" | "all";
-export type TaskScopeSource = "cwd" | "explicit" | "unscoped";
+
+/** Task's own name for the shared, kind-neutral scope-assignment provenance -- see scope-source.ts. Kept as a type alias so every existing Task-scope call site keeps working unchanged. */
+export type TaskScopeSource = ScopeAssignmentSource;
 
 export interface TaskProjectScope {
 	taskId: string;
@@ -29,15 +33,6 @@ export interface TaskViewSelection {
 	rootTaskId?: string;
 }
 
-export function normalizeProjectRoot(value: string): string {
-	if (!isAbsolute(value)) throw new Error("project_root must be an absolute path");
-	const normalized = normalize(value);
-	if (normalized.length > TASK_PROJECT_ROOT_MAX_LENGTH) {
-		throw new Error(`project_root cannot exceed ${TASK_PROJECT_ROOT_MAX_LENGTH} characters`);
-	}
-	return normalized;
-}
-
 export function taskScopeLabel(mode: TaskViewMode, projectRoot?: string, rootTitle?: string): string {
 	if (mode === "all") return "All projects";
 	const project = projectRoot ? basename(projectRoot) || projectRoot : "Unscoped";

package/src/task/task-edges.ts

@@ -1,8 +1,8 @@
 import type { Artifact, ArtifactEdge } from "../artifact/artifact.ts";
 import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import { TASK_EXECUTION_MAX_DEGREE } from "../constants.ts";
-import type { AppendTaskEvent, TaskEventContext } from "../task-event/task-event.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
+import type { AppendTaskEvent, TaskEventContext } from "./event/task-event.ts";
+import type { TaskEventStore } from "./event/task-event-store.ts";
 import { assertDependencyEdgeAllowed, TaskExecutionBoundExceededError } from "./task-execution.ts";
 // Type-only import: erased entirely at compile time, so this does not create a real runtime
 // circular dependency even though task-service.ts also imports TaskEdges (a real value) from

package/src/task/task-focus-coordinator.ts

@@ -1,9 +1,9 @@
 import type { Artifact } from "../artifact/artifact.ts";
 import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import { TASK_FOCUS_STALE_AFTER_MS } from "../constants.ts";
-import { type AppendTaskEvent, type TaskEventContext, validateEventContext } from "../task-event/task-event.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
-import type { TaskFocusStatus, TaskFocusStore } from "../task-focus/task-focus-store.ts";
+import { type AppendTaskEvent, type TaskEventContext, validateEventContext } from "./event/task-event.ts";
+import type { TaskEventStore } from "./event/task-event-store.ts";
+import type { TaskFocusStatus, TaskFocusStore } from "./focus/task-focus-store.ts";
 import { TaskInvalidTransitionError } from "./task-lifecycle-errors.ts";
 import type { TaskMutationCoordinator, TaskMutationRequestContext } from "./task-mutation-coordinator.ts";
 // Type-only import: erased entirely at compile time, so this does not create a real runtime

package/src/task/task-lease-coordinator.ts

@@ -1,6 +1,6 @@
 import type { Artifact } from "../artifact/artifact.ts";
-import type { TaskLease, TaskLeaseView } from "../task-lease/task-lease.ts";
-import type { TaskLeaseStore } from "../task-lease/task-lease-store.ts";
+import type { TaskLease, TaskLeaseView } from "./lease/task-lease.ts";
+import type { TaskLeaseStore } from "./lease/task-lease-store.ts";
 
 /**
  * Task lease management (claim/heartbeat/release/get/reap), split out of the Tasks god class as

package/src/task/task-mutation-coordinator.ts

@@ -6,7 +6,7 @@ import {
 	TaskMutationPendingError,
 	type TaskMutationRequestRecord,
 	type TaskMutationRequestStore,
-} from "../task-mutation-request/task-mutation-request-store.ts";
+} from "./mutation-request/task-mutation-request-store.ts";
 
 export class TaskMutationReceiptNotFoundError extends Error {}
 

package/src/task/task-project-scope.ts

@@ -1,8 +1,8 @@
 import type { Artifact } from "../artifact/artifact.ts";
 import { TASK_PROJECT_LIST_MAX_RESULTS } from "../constants.ts";
 import { assertRegisterProjectInputBounds } from "../project-registry/project-registry.ts";
-import type { AppendTaskEvent, TaskEventContext } from "../task-event/task-event.ts";
-import type { TaskEventStore } from "../task-event/task-event-store.ts";
+import type { AppendTaskEvent, TaskEventContext } from "./event/task-event.ts";
+import type { TaskEventStore } from "./event/task-event-store.ts";
 import {
 	normalizeProjectRoot,
 	type RegisterTaskProjectInput,
@@ -10,8 +10,8 @@ import {
 	type TaskViewMode,
 	type TaskViewSelection,
 	taskScopeLabel,
-} from "../task-scope/task-scope.ts";
-import type { TaskScopeStore } from "../task-scope/task-scope-store.ts";
+} from "./scope/task-scope.ts";
+import type { TaskScopeStore } from "./scope/task-scope-store.ts";
 
 export class TaskProjectNotFoundError extends Error {}
 export class TaskProjectAmbiguousError extends Error {}

package/src/task/task-service.ts

@@ -18,11 +18,12 @@ import { DISCUSSION_SUBTYPE, isDiscussionArtifact, readDiscussionExtra } from ".
 import type { TransitionTable } from "../domain-service-shared.ts";
 import { type Gate, type GateResult, validateGates } from "../gate/gate.ts";
 import type { GateRunner } from "../gate/gate-runner.ts";
+import { type Checklist, checklistEntries, type ProofReference, validateChecklist } from "./checklist.ts";
 import {
 	InMemoryTaskCreateRequestStore,
 	TaskCreateIdempotencyConflictError,
 	type TaskCreateRequestStore,
-} from "../task-create-request/task-create-request-store.ts";
+} from "./create-request/task-create-request-store.ts";
 import type {
 	AppendTaskEvent,
 	TaskEventContext,
@@ -31,18 +32,18 @@ import type {
 	TaskHistoryPage,
 	TaskHistoryQuery,
 	TaskLifecycleStatus,
-} from "../task-event/task-event.ts";
-import { validateEventContext } from "../task-event/task-event.ts";
-import { InMemoryTaskEventStore, type TaskEventStore } from "../task-event/task-event-store.ts";
-import { InMemoryTaskFocusStore, type TaskFocusStatus, type TaskFocusStore } from "../task-focus/task-focus-store.ts";
-import type { TaskLeaseView } from "../task-lease/task-lease.ts";
-import { InMemoryTaskLeaseStore, type TaskLeaseStore } from "../task-lease/task-lease-store.ts";
+} from "./event/task-event.ts";
+import { validateEventContext } from "./event/task-event.ts";
+import { InMemoryTaskEventStore, type TaskEventStore } from "./event/task-event-store.ts";
+import { InMemoryTaskFocusStore, type TaskFocusStatus, type TaskFocusStore } from "./focus/task-focus-store.ts";
+import type { TaskLeaseView } from "./lease/task-lease.ts";
+import { InMemoryTaskLeaseStore, type TaskLeaseStore } from "./lease/task-lease-store.ts";
 import {
 	InMemoryTaskMutationRequestStore,
 	TaskMutationPendingError,
 	type TaskMutationRequestRecord,
 	type TaskMutationRequestStore,
-} from "../task-mutation-request/task-mutation-request-store.ts";
+} from "./mutation-request/task-mutation-request-store.ts";
 import {
 	normalizeProjectRoot,
 	type RegisterTaskProjectInput,
@@ -51,9 +52,8 @@ import {
 	type TaskViewMode,
 	type TaskViewSelection,
 	taskScopeLabel,
-} from "../task-scope/task-scope.ts";
-import { InMemoryTaskScopeStore, type TaskScopeStore } from "../task-scope/task-scope-store.ts";
-import { type Checklist, checklistEntries, type ProofReference, validateChecklist } from "./checklist.ts";
+} from "./scope/task-scope.ts";
+import { InMemoryTaskScopeStore, type TaskScopeStore } from "./scope/task-scope-store.ts";
 import { TaskEdges } from "./task-edges.ts";
 import { TaskExecutionBoundExceededError } from "./task-execution.ts";
 import { type TaskFocus, TaskFocusCoordinator, type TaskFocusMutationResult } from "./task-focus-coordinator.ts";