@ours.network/fleet 0.2.0 → 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
 
@@ -167,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/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,9 @@ export function makeClaudeCodeAdapter(exec = realExec) {
         },
         buildLaunch(role, mode, s, prep) {
             const stateDir = roleStateDir(role);
+            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.`]

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ours.network/fleet",
-  "version": "0.2.0",
+  "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",