@ours.network/fleet 0.1.2 → 0.4.0

package/README.md

@@ -49,10 +49,19 @@ roles:
 ```
 
 Each role gets a state dir (`~/.ours-fleet/agents/<Name>/`) holding its briefing,
-WORKLOG, and session markers. On boot the agent reads its briefing: bind identity,
-publish bio/persona, arm a mail monitor (`ours-mcp watch`), announce to its
-coordinator, work. On crash the supervisor relaunches it and the harness resumes
-the same session.
+logs, routines, and session markers. On boot the agent reads its briefing: bind
+identity, publish bio/persona, arm a mail monitor (`ours-mcp watch`), announce to
+its coordinator, work. On crash the supervisor relaunches it and the harness
+resumes the same session.
+
+The state dir contract:
+
+| File | Owner | Lifecycle |
+|---|---|---|
+| `briefing.md` | generated | rewritten on every `up`/`restart`; never hand-edit |
+| `WORKLOG.md` | the agent | seeded empty, agent-appended; survives restarts |
+| `ROUTINES.md` | operator / agent | **optional** recurring-work instructions; re-read at the start of every wake, hot-editable **without a restart**; absence means "no routines" |
+| `.identity`, `.cwd`, `.session-id`, `.booted`, `.exit-status` | supervisor | dot-marker state — session resume and boot bookkeeping |
 
 ## Prerequisites
 
@@ -137,7 +146,7 @@ ours-fleet up|down|restart|force-restart [-c FILE] [Name...]
 ours-fleet config [-c FILE]         validate + print merged plan
 ours-fleet ls | attach | peek | logs [-f] | status <Name>
 ours-fleet send <Name> "text" | --key <K>
-ours-fleet spawn [--temp] <Name> [--mission --bio-file --persona-file ...]
+ours-fleet spawn [--temp] <Name> [--mission --model --bio-file --persona-file ...]
 ours-fleet rm <Name>
 ours-fleet doctor [--harness H]
 ours-fleet init
@@ -149,6 +158,7 @@ ours-fleet init
 vars: { work_root: /home/me/work }      # ${var} substitution anywhere below
 defaults:
   harness: claude-code                  # for roles that don't set one
+  model: claude-fable-5                 # default model for roles that don't set one (per-role model / --model wins)
   max_tokens: 500000                    # session cap (harness-interpreted)
 roles:
   Name:                                 # [A-Za-z0-9_-]+
@@ -156,6 +166,7 @@ roles:
     identity: "Display Name"            # ours identity to bind (default: Name)
     cwd: ${work_root}/repo              # where the harness process runs
     coordinator: FleetCoordinator       # announce target on boot
+    model: claude-fable-5               # launch on a specific model (pass-through id; default: launcher default)
     mission: one line
     persona: |                          # operating contract (published as persona)
     bio: |                              # public card (published as bio)
@@ -165,6 +176,8 @@ roles:
     harness_options:                    # adapter-owned, adapter-validated
       plugins: { "name@marketplace": false }   # claude-code: plugin overrides
       # mem_palace: false                      # claude-code: disable memory plugin
+      # permission_mode: dontAsk               # claude-code: launch permission mode —
+      #   one of default | acceptEdits | plan | dontAsk | bypassPermissions
 ```
 
 Merge order: `fleet.yaml` ← `fleet.d/*.yaml`; a duplicate role name is a hard

package/dist/briefing.d.ts

@@ -3,6 +3,7 @@ import type { BriefingVocab } from './harness/types.js';
 export interface BriefingOpts {
     stateDir: string;
     worklogPath: string;
+    routinesPath: string;
     /** Curated body (from briefing_file) replacing the narrative sections. */
     briefingBody?: string;
 }

package/dist/briefing.js

@@ -62,6 +62,10 @@ export function generateBriefing(role, v, opts) {
     L.push('', '## Durable log');
     L.push(`Append important commands / decisions / results to \`${opts.worklogPath}\` as you go —`);
     L.push('it survives restarts.');
+    L.push('', '## Routines');
+    L.push(`If \`${opts.routinesPath}\` exists, re-read it at the START of every wake — before acting`);
+    L.push('on messages, timers, or prompts — and follow it for recurring or scheduled work. It may');
+    L.push('change between wakes without a restart; treat the file, not your memory of it, as current.');
     L.push('', '## On restart (you run under a supervised launcher)');
     L.push(`On restart, WITHOUT asking: re-bind (**${v.bindTool}** name "${id}" force=true),`);
     L.push(`re-arm the \`${v.watchCommand(id)}\` monitor, then continue from your WORKLOG.`);

package/dist/cli.js

@@ -48,6 +48,8 @@ cOpt(program.command('config').description('validate + print the merged plan (no
             console.log(`    source:      ${r.sourceFile}`);
             if (r.cwd)
                 console.log(`    cwd:         ${r.cwd}`);
+            if (r.model)
+                console.log(`    model:       ${r.model}`);
             if (r.coordinator)
                 console.log(`    coordinator: ${r.coordinator}`);
             if (r.mission)
@@ -148,12 +150,14 @@ cOpt(program.command('spawn <name>').description('spawn a new agent (permanent b
     .option('--identity <name>', 'ours identity to bind (default: role name)')
     .option('--cwd <dir>', 'working directory')
     .option('--coordinator <name>', 'announce target')
+    .option('--model <id>', 'model id to launch on (e.g. claude-fable-5); default: launcher default')
     .option('--bio-file <file>', 'public bio (file)')
     .option('--persona-file <file>', 'persona / operating contract (file)')
     .action(async (name, opts) => {
     const o = {
         name, temp: opts.temp, harness: opts.harness, mission: opts.mission,
         identity: opts.identity, cwd: opts.cwd, coordinator: opts.coordinator,
+        model: opts.model,
         bioFile: opts.bioFile, personaFile: opts.personaFile, configPath: opts.configuration,
     };
     try {

package/dist/config.d.ts

@@ -11,6 +11,7 @@ export interface RoleConfig {
     persona?: string;
     bio?: string;
     briefing_file?: string;
+    model?: string;
     max_tokens?: number;
     autocompact_pct?: number;
     env?: Record<string, string>;

package/dist/config.js

@@ -7,7 +7,7 @@ export class ConfigError extends Error {
 const NAME_RE = /^[A-Za-z0-9_-]+$/;
 const ROLE_KEYS = [
     'harness', 'identity', 'cwd', 'coordinator', 'mission', 'persona', 'bio',
-    'briefing_file', 'max_tokens', 'autocompact_pct', 'env', 'oversee', 'harness_options',
+    'briefing_file', 'model', 'max_tokens', 'autocompact_pct', 'env', 'oversee', 'harness_options',
 ];
 function deepSub(v, vars) {
     if (typeof v === 'string')
@@ -65,6 +65,7 @@ export function loadConfig(configPath) {
                 sourceFile: file,
                 harness: r.harness ?? defaults.harness ?? 'claude-code',
                 identity: r.identity ?? name,
+                model: r.model ?? defaults.model,
                 max_tokens: r.max_tokens ?? defaults.max_tokens,
             });
         }

package/dist/harness/claude-code.js

@@ -3,7 +3,18 @@ import { join } from 'node:path';
 import { home } from '../paths.js';
 import { realExec } from '../exec.js';
 import { registerAdapter } from './registry.js';
-const OPTION_KEYS = ['plugins', 'mem_palace', 'mem_palace_midsession_autosave'];
+const OPTION_KEYS = ['plugins', 'mem_palace', 'mem_palace_midsession_autosave', 'permission_mode'];
+/** Claude Code's accepted --permission-mode values. */
+const PERMISSION_MODES = ['default', 'acceptEdits', 'plan', 'dontAsk', 'bypassPermissions'];
+/** Resolve & validate the per-role permission mode, throwing on an unknown value. */
+function permissionMode(role) {
+    const pm = role.harness_options?.permission_mode;
+    if (pm == null)
+        return undefined;
+    if (!PERMISSION_MODES.includes(pm))
+        throw new Error(`invalid harness_options.permission_mode "${pm}"; allowed: ${PERMISSION_MODES.join(', ')}`);
+    return pm;
+}
 /** Context window of the fleet model (1M); max_tokens → % of this. */
 const WINDOW = 1_000_000;
 export function autocompactPct(role) {
@@ -78,7 +89,10 @@ export function makeClaudeCodeAdapter(exec = realExec) {
         },
         buildLaunch(role, mode, s, prep) {
             const stateDir = roleStateDir(role);
-            const base = ['claude', ...prep.argv, '--remote-control', role.name];
+            const pm = permissionMode(role);
+            const base = ['claude', ...(role.model ? ['--model', role.model] : []),
+                ...(pm ? ['--permission-mode', pm] : []),
+                ...prep.argv, '--remote-control', role.name];
             const argv = mode === 'fresh'
                 ? [...base, '--session-id', s.sessionId, `Read and follow ${join(stateDir, 'briefing.md')} now.`]
                 : [...base, '--resume', s.sessionId,

package/dist/ops.js

@@ -23,7 +23,8 @@ export function applyRole(role, opts = {}) {
         writeFileSync(join(dir, 'WORKLOG.md'), '');
     const briefingBody = role.briefing_file ? readFileSync(role.briefing_file, 'utf8') : undefined;
     writeFileSync(join(dir, 'briefing.md'), generateBriefing(role, adapter.vocabulary, {
-        stateDir: dir, worklogPath: join(dir, 'WORKLOG.md'), briefingBody,
+        stateDir: dir, worklogPath: join(dir, 'WORKLOG.md'),
+        routinesPath: join(dir, 'ROUTINES.md'), briefingBody,
     }));
     if (opts.fresh)
         for (const f of ['.booted', '.session-id', '.exit-status'])

package/dist/spawn.d.ts

@@ -7,6 +7,7 @@ export interface SpawnOpts {
     identity?: string;
     cwd?: string;
     coordinator?: string;
+    model?: string;
     bioFile?: string;
     personaFile?: string;
     overseeInterval?: string;

package/dist/spawn.js

@@ -17,6 +17,8 @@ function roleFromOpts(o) {
         r.coordinator = o.coordinator;
     if (o.mission)
         r.mission = o.mission;
+    if (o.model?.trim())
+        r.model = o.model.trim();
     if (o.bioFile)
         r.bio = readFileSync(o.bioFile, 'utf8').trim();
     if (o.personaFile)
@@ -57,6 +59,7 @@ export async function spawnTemp(o, binPath, launch = detachedSupervisor) {
         name: o.name,
         harness: o.harness ?? cfg.defaults.harness ?? 'claude-code',
         identity: o.identity ?? o.name,
+        model: o.model?.trim() || cfg.defaults.model,
         sourceFile: '(temp)',
     };
     const dir = applyRole(role, { temp: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ours.network/fleet",
-  "version": "0.1.2",
+  "version": "0.4.0",
   "description": "Harness-agnostic fleet of persistent, identity-bound AI agents. Declarative fleet.yaml, tmux consoles, systemd/launchd supervision, ours.network messaging.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",