@agentshouse/kit 0.2.1-alpha.22 → 0.2.1-alpha.23

package/README.md

@@ -43,7 +43,7 @@ connects your own agent: `house <tool>` run outside an Agent conversation calls
 House as you, until you revoke that connection on Connections.
 
 `kit resident` keeps the Environment connected, and keeps the Rooms you chose
-for this Environment as Git repositories under `working-copies` in the
+for this Environment as Git repositories under `local-copies` in the
 workspace. Commit in one and run `house git push --owner` there to send the
 commit to House; in the container, run it through the install command from the
 copy's directory. Inside an Agent conversation the Agent runs `house git push`.

package/dist/bootstrap.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
-  "version": "0.2.1-alpha.22",
+  "version": "0.2.1-alpha.23",
   "hosts": {
     "linux": {
-      "command": "bash <(curl -fsSL https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.22/connect-linux.sh)",
+      "command": "bash <(curl -fsSL https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.23/connect-linux.sh)",
       "asset": {
         "name": "connect-linux.sh",
-        "url": "https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.22/connect-linux.sh"
+        "url": "https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.23/connect-linux.sh"
       },
       "workspace": {
         "argument": "--workspace",
@@ -17,10 +17,10 @@
       }
     },
     "windows": {
-      "command": "& ([scriptblock]::Create((irm https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.22/connect-windows.ps1)))",
+      "command": "& ([scriptblock]::Create((irm https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.23/connect-windows.ps1)))",
       "asset": {
         "name": "connect-windows.ps1",
-        "url": "https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.22/connect-windows.ps1"
+        "url": "https://github.com/agentshouse/kit/releases/download/v0.2.1-alpha.23/connect-windows.ps1"
       },
       "workspace": {
         "argument": "--workspace",

package/dist/copies.js

@@ -3,13 +3,12 @@ import { randomUUID } from 'node:crypto';
 import { mkdir, readFile, readdir, realpath, rename, rm, rmdir, stat, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { HouseRefusal } from './api.js';
-import { blobId, blobText, git, HOUSE_REF, importCommits, revision, run, succeeded, tree, workingCopies, } from './git.js';
+import { blobId, blobText, git, HOUSE_REF, importCommits, localCopies, revision, run, succeeded, tree, } from './git.js';
 import { kitHome } from './home.js';
 import { operationId } from './operation.js';
 import { refusalOf } from './refusals.js';
 import { changed } from './translate.js';
 const BRANCH = 'main';
-const ROOM_HOMES = ['capture', 'library', 'collaboration'];
 const PROVENANCE = '_provenance';
 const REPLICA_RETRY_MS = 30_000;
 const IDENTITY = { GIT_COMMITTER_NAME: 'House Kit', GIT_COMMITTER_EMAIL: 'house-kit@localhost' };
@@ -47,9 +46,6 @@ function rootOf(copy) {
 function relative(path) {
     return path.replace(/^\/private\//, '').replace(/^\/rooms\/[^/]+\//, '');
 }
-function prefixesOf(selected) {
-    return selected.private ? ['/private'] : ROOM_HOMES.map((home) => `${rootOf(selected)}/${home}`);
-}
 function declaredWritable(path, copy) {
     const deepest = (scopes) => Math.max(-1, ...scopes.filter((scope) => covers(path, scope)).map((scope) => scope.length));
     return deepest(copy.write) > deepest(copy.protected);
@@ -151,7 +147,7 @@ function movedPaths(moves, before, after) {
         .filter((pair) => pairs.filter((other) => other.from === pair.from || other.to === pair.to).length === 1)
         .map(({ from, to }) => [from, to]));
 }
-export class WorkingCopies {
+export class LocalCopies {
     owner;
     house;
     copies = new Map();
@@ -178,7 +174,7 @@ export class WorkingCopies {
         };
     }
     async load() {
-        const home = join(kitHome(), 'working-copies');
+        const home = join(kitHome(), 'local-copies');
         const names = (await readdir(join(home, 'rooms')).catch(() => [])).filter((name) => name.endsWith('.json'));
         for (const path of [...names.map((name) => join(home, 'rooms', name)), join(home, 'private.json')]) {
             const text = await readFile(path, 'utf8').catch(() => null);
@@ -201,7 +197,7 @@ export class WorkingCopies {
         return selected;
     }
     async reselect() {
-        const { working_copy: chosen } = await this.house.post('/kit/working-copy/selection', {});
+        const { local_copy: chosen } = await this.house.post('/kit/local-copy/selection', {});
         const selected = [
             ...(chosen?.rooms ?? [])
                 .filter((room) => room.room_handle !== null)
@@ -259,11 +255,11 @@ export class WorkingCopies {
     async push(cwd, selector, caller) {
         const located = await run(cwd, ['rev-parse', '--path-format=absolute', '--git-common-dir', '--show-toplevel']);
         if (located.status !== 0)
-            return { refused: true, text: `${cwd} is not a House working copy; run house git push inside one` };
+            return { refused: true, text: `${cwd} is not a House Local copy; run house git push inside one` };
         const [common, worktree] = located.stdout.toString('utf8').split('\n');
         const key = await this.keyAt(dirname(common));
         if (key === undefined)
-            return { refused: true, text: `${worktree} is not a House working copy; run house git push inside one` };
+            return { refused: true, text: `${worktree} is not a House Local copy; run house git push inside one` };
         return this.exclusive(key, () => this.pushed(key, worktree, selector, caller));
     }
     async keyAt(repository) {
@@ -291,7 +287,7 @@ export class WorkingCopies {
         }).catch(logged);
     }
     async save(copy) {
-        const path = join(kitHome(), 'working-copies', copy.private ? 'private.json' : `${copy.key}.json`);
+        const path = join(kitHome(), 'local-copies', copy.private ? 'private.json' : `${copy.key}.json`);
         await mkdir(dirname(path), { recursive: true, mode: 0o700 });
         const temporary = `${path}.${process.pid}`;
         await writeFile(temporary, JSON.stringify(copy), { mode: 0o600 });
@@ -300,7 +296,7 @@ export class WorkingCopies {
         return copy;
     }
     async read(selected) {
-        const prefixes = prefixesOf(selected);
+        const prefixes = [rootOf(selected)];
         const discovery = await this.house.post('/kit/door/discover', { prefixes });
         let bundle = await this.house.post('/kit/door/bootstrap', { prefixes });
         if ('transfer' in bundle)
@@ -347,7 +343,7 @@ export class WorkingCopies {
             return;
         }
         const discovery = await this.house.post('/kit/door/discover', {
-            prefixes: prefixesOf(copy),
+            prefixes: [rootOf(copy)],
         });
         const authority = discovery.authorities.find((entry) => entry.room_ref === copy.room_ref);
         if (authority === undefined)
@@ -369,7 +365,7 @@ export class WorkingCopies {
             logged(`House serves nothing of ${rootOf({ private: scope.private, room_handle: scope.handle })} to copy`);
             return;
         }
-        const repository = scope.private ? join(workingCopies(), 'private') : join(workingCopies(), 'rooms', read.anchor);
+        const repository = scope.private ? join(localCopies(), 'private') : join(localCopies(), 'rooms', read.anchor);
         if (await exists(repository)) {
             logged(`${repository} already exists and House Kit leaves it as it is`);
             return;
@@ -438,7 +434,7 @@ export class WorkingCopies {
             let answer;
             try {
                 answer = await this.house.post('/kit/door/enumerate', {
-                    prefixes: prefixesOf(copy),
+                    prefixes: [rootOf(copy)],
                     positions: [{ authority: copy.room_ref, position: copy.position, log_epoch: copy.log_epoch }],
                 });
             }

package/dist/git-main.js

@@ -4,7 +4,7 @@ import { accessSync, constants, realpathSync, statSync } from 'node:fs';
 import { request } from 'node:http';
 import { constants as system } from 'node:os';
 import { delimiter, dirname, join } from 'node:path';
-import { workingCopies } from './git.js';
+import { localCopies } from './git.js';
 import { kitHome } from './home.js';
 const VALUED = new Set(['-C', '-c', '--git-dir', '--work-tree', '--namespace', '--config-env', '--attr-source', '--super-prefix']);
 const READS = new Set([
@@ -125,7 +125,7 @@ async function observed(git, args) {
         return delegated(git, args);
     const located = captured(git, [...globals, 'rev-parse', '--path-format=absolute', '--git-common-dir', '--show-toplevel']);
     const [common, worktree] = located?.split('\n') ?? [];
-    if (common === undefined || worktree === undefined || !dirname(common).startsWith(`${workingCopies()}/`)) {
+    if (common === undefined || worktree === undefined || !dirname(common).startsWith(`${localCopies()}/`)) {
         return delegated(git, args);
     }
     const listing = [...globals, '-C', worktree, 'ls-files', '--stage', '-z'];

package/dist/git.js

@@ -3,8 +3,8 @@ import { createHash } from 'node:crypto';
 import { join } from 'node:path';
 import { withoutProxy } from './clis.js';
 import { workspaceRoot } from './home.js';
-export function workingCopies() {
-    return join(workspaceRoot(), 'working-copies');
+export function localCopies() {
+    return join(workspaceRoot(), 'local-copies');
 }
 export const HOUSE_REF = 'refs/house/received';
 const COMMITTER = 'House Kit <house-kit@localhost>';

package/dist/instructions.js

@@ -1,8 +1,8 @@
 import { HOW_WE_WORK } from './skills.js';
 const HOUSE_LINE = 'Work with House through the `house` CLI: run `house --help`.';
 const FILE_LINE = 'To give the User a file or a page, upload it with `house upload_attachment` and link it; never start a server.';
-const READ_LINE = 'Before working in a Room, read `/private/rooms/<handle>/AGENTS.md`, and before editing its Wiki, `/rooms/<handle>/library/wiki/RULES.md`.';
-const COPIES_LINE = 'House working copies; commit, then `house git push`:';
+const READ_LINE = 'Before working in a Room, read `/private/rooms/<handle>/AGENTS.md`.';
+const COPIES_LINE = 'House Local copies; commit, then `house git push`:';
 const UNREADABLE = /^(?:\S+: )?(?:path_not_found|room_not_found|operation_denied)\b/;
 const FAILED = /^exit: [1-9]\d*$/;
 const CUT = /^stderr: shell: output_cut (\d+) of \d+ bytes; continue with: (.+)$/;

package/dist/resident.js

@@ -8,7 +8,7 @@ import { Agents } from './agents.js';
 import { house } from './api.js';
 import { received } from './bridge.js';
 import { Conversations } from './conversations.js';
-import { WorkingCopies } from './copies.js';
+import { LocalCopies } from './copies.js';
 import { agentBase, kitHome, readEnrolment } from './home.js';
 import { SignIns } from './sign-in.js';
 import { placeSkillSet } from './skills.js';
@@ -60,7 +60,7 @@ export async function resident() {
     await mkdir(agentBase(), { recursive: true });
     process.env.HOUSE_KIT_RESIDENT = String(process.pid);
     const agents = new Agents(house);
-    const copies = new WorkingCopies(house);
+    const copies = new LocalCopies(house);
     await copies.load();
     await installShim();
     await serveOwner(copies);
@@ -103,7 +103,7 @@ export async function resident() {
         frame: (arrived) => {
             if (arrived.type === 'work_available' && arrived.subject === 'agents')
                 logged(agents.refresh());
-            if (arrived.type === 'work_available' && arrived.subject === 'working_copy')
+            if (arrived.type === 'work_available' && arrived.subject === 'local_copy')
                 logged(copies.select());
             if (arrived.type === 'entries') {
                 copies.entries(arrived);

package/dist/skills.js

@@ -6,7 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { KIT_VERSION } from './clis.js';
 import { kitHome, readConfiguration, readHome, writeHome } from './home.js';
 import { refusalOf } from './refusals.js';
-export const HOW_WE_WORK = '/private/library/how-we-work.md';
+export const HOW_WE_WORK = '/private/how-we-work.md';
 const SKILL_SET = fileURLToPath(new URL('../skills/', import.meta.url));
 const HOW_WE_WORK_TEXT = readFileSync(new URL('../how-we-work.md', import.meta.url), 'utf8');
 const RECORD = 'skill-set.json';

package/how-we-work.md

@@ -8,16 +8,16 @@ The skills are already set up; never run `setup-matt-pocock-skills`.
 
 ## Where skill output goes
 
-- Glossary (`CONTEXT.md`): `library/glossary.md`
-- Decisions (ADRs): `library/decisions/NNNN-<slug>.md`
-- Plan (spec): `library/projects/<name>/plan.md`
-- Tasks (tickets): `library/projects/<name>/tasks/NN-<slug>.md`, with a
+- Glossary (`CONTEXT.md`): `glossary.md`
+- Decisions (ADRs): `decisions/NNNN-<slug>.md`
+- Plan (spec): `projects/<name>/plan.md`
+- Tasks (tickets): `projects/<name>/tasks/NN-<slug>.md`, with a
   `Status:` line (`needs-triage`, `needs-info`, `ready-for-agent`,
   `ready-for-human`, `wontfix`), a `Blocked by:` line and comments under
   `## Comments`
-- Map (Wayfinding): `library/projects/<name>/map.md`, its tasks under
+- Map (Wayfinding): `projects/<name>/map.md`, its tasks under
   `tasks/` with `Type:`, `Status: claimed|resolved` and `Blocked by:` lines
-- Research: `library/research/<slug>.md`
-- Questionnaires: `library/questionnaires/<slug>.md`
-- Learning: `library/learning/<topic>/`
+- Research: `research/<slug>.md`
+- Questionnaires: `questionnaires/<slug>.md`
+- Learning: `learning/<topic>/`
 - Prototype: one HTML file with every variant on one page.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/kit",
-  "version": "0.2.1-alpha.22",
+  "version": "0.2.1-alpha.23",
   "description": "House Kit connects an Environment to agents.house.",
   "license": "MIT",
   "repository": {