refactor: apply repository naming contract

Apply the accepted pre-release package, service, type, directory, and role renames as one repository-wide change.

packages/examples/agent-spine-demo/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * Default executor-less, UI-less agent spine. It bundles the common services,
- * background-task registry and controls, optional persisted goals, concrete loop, local skill and
- * workspace-context providers, and model-facing bash/skill consumers;
+ * background-job registry and controls, optional persisted goals, concrete loop, local skill and
+ * agent-instructions providers, and model-facing shell/skill consumers;
  * deployments still choose the LLM adapter, bash executor, and presentation.
  * The plugin intentionally exposes named exports only because Loader default
  * unwrapping would discard its `Config` schema (see docs/postmortem/0001).
@@ -11,31 +11,31 @@
 import type { Context } from '@deepseek-ai/cordis'
 import Timer from '@deepseek-ai/cordis-plugin-timer'
 import z from '@deepseek-ai/schemastery'
-import LlmService from '@deepseek-ai/dsh-llm'
+import LlmRuntime from '@deepseek-ai/dsh-llm'
 import SessionStore from '@deepseek-ai/dsh-session'
 import SessionTitleService, { type Config as SessionTitleConfig } from '@deepseek-ai/dsh-session-title'
 import SystemPrompt, { type Config as SystemPromptConfig } from '@deepseek-ai/dsh-system-prompt'
-import ToolRegistry, { type Config as ToolsConfig } from '@deepseek-ai/dsh-tools'
-import SkillService, { type Config as SkillRegistryConfig } from '@deepseek-ai/dsh-skill'
-import * as SkillLocal from '@deepseek-ai/dsh-skill-local'
+import ToolRuntime, { type Config as ToolsConfig } from '@deepseek-ai/dsh-tools'
+import SkillRegistry, { type Config as SkillRegistryConfig } from '@deepseek-ai/dsh-skill'
+import * as SkillFileSystem from '@deepseek-ai/dsh-skill-filesystem'
 import AgentRegistry from '@deepseek-ai/dsh-agent'
 import GoalService, { type Config as GoalDomainConfig } from '@deepseek-ai/dsh-goal'
-import * as goalSession from '@deepseek-ai/dsh-goal-session'
+import * as goalSession from '@deepseek-ai/dsh-goal-round-driver'
 import * as toolGoal from '@deepseek-ai/dsh-tool-goal'
-import LocalTaskService, { type Config as TasksConfig } from '@deepseek-ai/dsh-tasks-local'
-import InvariantService, { type Config as InvariantConfig } from '@deepseek-ai/dsh-invariants'
+import LocalJobRegistry, { type Config as JobsConfig } from '@deepseek-ai/dsh-jobs-local'
+import InvariantRegistry, { type Config as InvariantConfig } from '@deepseek-ai/dsh-invariants'
 import * as sessionInvariant from '@deepseek-ai/dsh-session/invariant'
 import * as agentInvariant from '@deepseek-ai/dsh-agent/invariant'
 import * as scopeInvariant from '@deepseek-ai/dsh-scope/invariant'
 import * as agentLoopInvariant from '@deepseek-ai/dsh-agent-loop/invariant'
 import * as toolBash from '@deepseek-ai/dsh-tool-bash'
-import * as bashEnv from '@deepseek-ai/dsh-bash-env'
-import * as workspaceContext from '@deepseek-ai/dsh-workspace-context'
+import * as bashEnv from '@deepseek-ai/dsh-shell-env'
+import * as workspaceContext from '@deepseek-ai/dsh-agent-instructions'
 import * as toolSkill from '@deepseek-ai/dsh-tool-skill'
-import * as toolTasks from '@deepseek-ai/dsh-tool-tasks'
+import * as toolJobs from '@deepseek-ai/dsh-tool-jobs'
 import AgentLoop, { type Config as AgentLoopConfig } from '@deepseek-ai/dsh-agent-loop'
 import * as llmRetry from '@deepseek-ai/dsh-llm-retry'
-import { resolveDshHome } from '@deepseek-ai/dsh-paths'
+import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
 
 export const name = 'agent-spine-demo'
 
@@ -53,7 +53,7 @@ export interface SkillConfig {
   /** Registry-level discovery cache settings. */
   registry?: SkillRegistryConfig
   /** Local filesystem skill provider settings. */
-  local?: SkillLocal.Config
+  filesystem?: SkillFileSystem.Config
   /** Model-facing skill catalog and tool settings. */
   tool?: toolSkill.Config
 }
@@ -75,8 +75,8 @@ export interface GoalConfig {
  * `dshHome` to bash environment and local skill discovery, `sessionTitle` to
  * the fallback title service, `skills` to the
  * skill registry/local provider/tool consumer, `workspaceContext` to the
- * workspace-context loader, `tasks` to the process-local task provider, and
- * `toolBash`/`toolTasks` to the model-facing tool plugins this bundle owns.
+ * agent-instructions loader, `jobs` to the process-local job provider, and
+ * `toolBash`/`toolJobs` to the model-facing tool plugins this bundle owns.
  * Provider adapters own their `retryPolicy`; this bundle always mounts its
  * executor.
  * `goals` opts into and configures the persisted goal domain plus its model tool
@@ -115,10 +115,10 @@ export interface Config {
   skills?: SkillConfig
   /** Model-facing bash tool config, or false when another plugin owns `bash`. */
   toolBash?: toolBash.Config | false
-  /** Process-local background-task admission config. */
-  tasks?: TasksConfig
-  /** Generic background-task controls; set false to keep the task service without model-facing task tools. */
-  toolTasks?: toolTasks.Config | false
+  /** Process-local background-job admission config. */
+  jobs?: JobsConfig
+  /** Generic background-job controls; set false to keep the job service without model-facing job tools. */
+  toolJobs?: toolJobs.Config | false
   /** Global enablement and package-name filters for invariant companions. */
   invariants?: InvariantConfig
   /** Opt-in persisted same-session goal stack; set false or omit to leave it unmounted. */
@@ -128,8 +128,8 @@ export interface Config {
 /** The skill config schema exported for app packages that forward `skills`. */
 export const SkillConfigSchema: z<SkillConfig> = z.object({
   enabled: z.boolean().default(true),
-  registry: SkillService.Config,
-  local: SkillLocal.Config,
+  registry: SkillRegistry.Config,
+  filesystem: SkillFileSystem.Config,
   tool: toolSkill.Config,
 })
 
@@ -141,11 +141,11 @@ export const SessionTitleConfigSchema: z<SessionTitleConfig> = SessionTitleServi
 export const ToolBashConfigSchema: z<toolBash.Config | false> =
   z.union([z.const(false), toolBash.Config])
 
-/** The process-local task registry schema exported for app packages that forward `tasks`. */
-export const TasksConfigSchema: z<TasksConfig> = LocalTaskService.Config
+/** The process-local job registry schema exported for app packages that forward `jobs`. */
+export const JobsConfigSchema: z<JobsConfig> = LocalJobRegistry.Config
 
-/** The task-control-tool config schema exported for app packages that forward `toolTasks`. */
-export const ToolTasksConfigSchema: z<toolTasks.Config> = toolTasks.Config
+/** The job-control-tool config schema exported for app packages that forward `toolJobs`. */
+export const ToolJobsConfigSchema: z<toolJobs.Config> = toolJobs.Config
 
 /** The persisted-goal config schema exported for app packages that opt in. */
 export const GoalConfigSchema: z<GoalConfig> = z.object({
@@ -158,17 +158,17 @@ export const Config = z.intersect([
   AgentLoop.Config,
   SystemPrompt.Config,
   z.object({
-    tools: ToolRegistry.Config,
+    tools: ToolRuntime.Config,
     dshHome: z.string(),
     sessionTitle: SessionTitleConfigSchema,
     skills: SkillConfigSchema,
     workspaceContext: z.union([z.const(false), workspaceContext.Config]).required(),
     toolBash: ToolBashConfigSchema,
-    tasks: TasksConfigSchema,
-    toolTasks: z.union([z.const(false), ToolTasksConfigSchema]),
-    invariants: InvariantService.Config,
+    jobs: JobsConfigSchema,
+    toolJobs: z.union([z.const(false), ToolJobsConfigSchema]),
+    invariants: InvariantRegistry.Config,
     goals: z.union([z.const(false), GoalConfigSchema]),
-  }) as unknown as z<Pick<Config, 'tools' | 'dshHome' | 'sessionTitle' | 'skills' | 'workspaceContext' | 'toolBash' | 'tasks' | 'toolTasks' | 'invariants' | 'goals'>>,
+  }) as unknown as z<Pick<Config, 'tools' | 'dshHome' | 'sessionTitle' | 'skills' | 'workspaceContext' | 'toolBash' | 'jobs' | 'toolJobs' | 'invariants' | 'goals'>>,
 ]) as unknown as z<Config>
 
 /**
@@ -188,8 +188,8 @@ export function pickSpineConfig(config: Omit<Config, 'agents'>): Omit<Config, 'a
     workspaceContext: config.workspaceContext,
     ...config.skills !== undefined ? { skills: config.skills } : {},
     ...config.toolBash !== undefined ? { toolBash: config.toolBash } : {},
-    ...config.tasks !== undefined ? { tasks: config.tasks } : {},
-    ...config.toolTasks !== undefined ? { toolTasks: config.toolTasks } : {},
+    ...config.jobs !== undefined ? { jobs: config.jobs } : {},
+    ...config.toolJobs !== undefined ? { toolJobs: config.toolJobs } : {},
     ...config.invariants !== undefined ? { invariants: config.invariants } : {},
     ...config.goals !== undefined ? { goals: config.goals } : {},
   }
@@ -206,15 +206,15 @@ export function pickSpineConfig(config: Omit<Config, 'agents'>): Omit<Config, 'a
  * seams, then the loop that drives them.
  */
 export function apply(ctx: Context, config: Config): void {
-  const nestedDshHome = config.skills?.local?.dshHome
+  const nestedDshHome = config.skills?.filesystem?.dshHome
   if (config.dshHome !== undefined && nestedDshHome !== undefined
     && resolveDshHome(config.dshHome) !== resolveDshHome(nestedDshHome)) {
-    throw new Error('agent-spine-demo: dshHome and skills.local.dshHome must resolve to the same directory')
+    throw new Error('agent-spine-demo: dshHome and skills.filesystem.dshHome must resolve to the same directory')
   }
   const dshHome = resolveDshHome(config.dshHome ?? nestedDshHome)
 
   ctx.plugin(Timer)
-  ctx.plugin(LlmService)
+  ctx.plugin(LlmRuntime)
   ctx.plugin(SessionStore)
   ctx.plugin(SessionTitleService, config.sessionTitle ?? EXAMPLE_SESSION_TITLE_CONFIG)
   // Owner schemas resolve defaults; forward toolOrder only when explicitly set.
@@ -223,11 +223,11 @@ export function apply(ctx: Context, config: Config): void {
     persona: config.persona ?? '',
     ...config.toolOrder !== undefined ? { toolOrder: config.toolOrder } : {},
   })
-  ctx.plugin(ToolRegistry, config.tools ?? {})
+  ctx.plugin(ToolRuntime, config.tools ?? {})
   const skillsEnabled = config.skills?.enabled ?? true
   if (skillsEnabled) {
-    ctx.plugin(SkillService, config.skills?.registry ?? {})
-    ctx.plugin(SkillLocal, Object.assign({}, config.skills?.local, { dshHome }))
+    ctx.plugin(SkillRegistry, config.skills?.registry ?? {})
+    ctx.plugin(SkillFileSystem, Object.assign({}, config.skills?.filesystem, { dshHome }))
   }
   ctx.plugin(AgentRegistry)
   ctx.plugin(llmRetry)
@@ -236,8 +236,8 @@ export function apply(ctx: Context, config: Config): void {
     ctx.plugin(toolGoal, config.goals.tool ?? {})
     ctx.plugin(goalSession)
   }
-  ctx.plugin(LocalTaskService, config.tasks ?? {})
-  ctx.plugin(InvariantService, config.invariants ?? {})
+  ctx.plugin(LocalJobRegistry, config.jobs ?? {})
+  ctx.plugin(InvariantRegistry, config.invariants ?? {})
   ctx.plugin(sessionInvariant)
   ctx.plugin(agentInvariant)
   ctx.plugin(scopeInvariant)
@@ -252,7 +252,7 @@ export function apply(ctx: Context, config: Config): void {
   // Both plugins prepend session-prefix messages. Registration order is the
   // rendered order, so workspace instructions must precede the skill catalog.
   if (skillsEnabled) ctx.plugin(toolSkill, config.skills?.tool ?? {})
-  if (config.toolTasks !== false) ctx.plugin(toolTasks, config.toolTasks ?? {})
+  if (config.toolJobs !== false) ctx.plugin(toolJobs, config.toolJobs ?? {})
   ctx.plugin(AgentLoop, {
     agents: config.agents ?? [],
     ...config.maxParallelToolCalls !== undefined ? { maxParallelToolCalls: config.maxParallelToolCalls } : {},