@possumtech/rummy 0.2.7 → 0.3.0

package/src/sql/v_model_context.sql

@@ -1,34 +1,31 @@
 -- INIT: create_v_model_context
 CREATE VIEW IF NOT EXISTS v_model_context AS
 WITH
-classified AS (
+visible AS (
 	SELECT
 		ke.run_id
 		, ke.id
 		, ke.path
 		, ke.body
 		, ke.scheme
-		, ke.state
+		, ke.status
+		, ke.fidelity
 		, ke.turn
 		, ke.updated_at
 		, ke.attributes
 		, ke.tokens AS tokens_full
 		, CASE
-			-- Proposed entries hidden until resolved
-			WHEN ke.state = 'proposed' THEN NULL
+			-- Archived entries not in context
+			WHEN ke.fidelity = 'archive' THEN NULL
+			-- 202 Accepted (proposed) hidden until resolved
+			WHEN ke.status = 202 THEN NULL
 			-- Audit schemes (model_visible = 0) hidden
 			WHEN s.model_visible = 0 THEN NULL
-			-- State IS fidelity for visible entries
-			WHEN ke.state IN ('full', 'summary', 'index') THEN ke.state
-			-- Stored entries hidden (retrievable via <read>)
-			WHEN ke.state = 'stored' THEN NULL
-			-- Result/structural states are visible at full fidelity
-			WHEN ke.state IN ('pass', 'error', 'warn', 'pattern', 'read', 'info', 'summary') THEN 'full'
-			ELSE NULL
-		END AS fidelity
+			-- Everything else visible at its fidelity
+			ELSE ke.fidelity
+		END AS visible_fidelity
 	FROM known_entries AS ke
 	JOIN schemes AS s ON s.name = COALESCE(ke.scheme, 'file')
-	WHERE ke.state NOT IN ('proposed')
 ),
 projected AS (
 	SELECT
@@ -36,38 +33,37 @@ projected AS (
 		, id
 		, path
 		, scheme
-		, state
-		, fidelity
+		, status
+		, visible_fidelity AS fidelity
 		, turn
 		, updated_at
 		, attributes
 		, CASE
-			WHEN fidelity IN ('full', 'summary') THEN body
+			WHEN visible_fidelity IN ('full', 'summary') THEN body
 			ELSE ''
 		END AS body
+		-- Four roles: data, logging, unknown, prompt.
+		-- These are structural — see PluginContext.CATEGORIES.
+		-- 'tool' is internal (model_visible=0 in practice).
+		-- Default is 'logging' — plugins opt into 'data' explicitly.
 		, CASE
-			WHEN scheme IS NULL AND state IN ('full', 'summary') THEN 'file'
-			WHEN scheme IS NULL THEN 'file_index'
-			WHEN scheme IN ('http', 'https') AND state IN ('full', 'summary') THEN 'file'
-			WHEN scheme IN ('http', 'https') THEN 'file_index'
-			WHEN scheme IN ('known', 'skill') AND state = 'full' THEN 'known'
-			WHEN scheme IN ('known', 'skill') THEN 'known_index'
+			WHEN scheme IS NULL THEN 'data'
+			WHEN scheme IN ('http', 'https') THEN 'data'
+			WHEN scheme IN ('known', 'skill') THEN 'data'
 			WHEN scheme = 'unknown' THEN 'unknown'
-			WHEN scheme IN ('ask', 'act', 'progress') THEN 'prompt'
-			WHEN scheme = 'summarize' THEN 'structural'
-			WHEN scheme = 'update' THEN 'structural'
+			WHEN scheme = 'prompt' THEN 'prompt'
 			WHEN scheme = 'tool' THEN 'tool'
-			ELSE 'result'
+			ELSE 'logging'
 		END AS category
-	FROM classified
-	WHERE fidelity IS NOT NULL
+	FROM visible
+	WHERE visible_fidelity IS NOT NULL
 )
 SELECT
 	run_id
 	, path
 	, scheme
 	, fidelity
-	, state
+	, status
 	, body
 	, attributes
 	, category
@@ -77,18 +73,14 @@ SELECT
 		ORDER BY
 			CASE category
 				WHEN 'tool' THEN 1
-				WHEN 'known' THEN 2
-				WHEN 'known_index' THEN 2
-				WHEN 'file_index' THEN 2
-				WHEN 'file' THEN 2
-				WHEN 'result' THEN 3
-				WHEN 'structural' THEN 4
-				WHEN 'unknown' THEN 5
-				WHEN 'prompt' THEN 6
-				ELSE 6
+				WHEN 'data' THEN 2
+				WHEN 'logging' THEN 3
+				WHEN 'unknown' THEN 4
+				WHEN 'prompt' THEN 5
+				ELSE 5
 			END
 			, CASE scheme WHEN 'skill' THEN 0 ELSE 1 END
-			, CASE state
+			, CASE fidelity
 				WHEN 'index' THEN 0
 				WHEN 'summary' THEN 1
 				ELSE 2

package/src/sql/v_run_log.sql

@@ -4,8 +4,8 @@ SELECT
 	ke.run_id
 	, ke.path
 	, ke.body
-	, ke.state AS status
-	, COALESCE(ke.scheme, ke.state) AS tool
+	, ke.status
+	, COALESCE(ke.scheme, 'file') AS tool
 	, COALESCE(
 		json_extract(ke.attributes, '$.command')
 		, json_extract(ke.attributes, '$.file')
@@ -17,7 +17,7 @@ FROM known_entries AS ke
 JOIN schemes AS s ON s.name = COALESCE(ke.scheme, 'file')
 WHERE
 	ke.scheme IS NOT NULL
-	AND ke.state != 'proposed'
+	AND ke.status != 202
 	AND s.category NOT IN ('knowledge', 'file')
 	AND ke.scheme NOT IN ('system', 'reasoning', 'model', 'content')
 ORDER BY ke.id;

package/src/agent/prompt_queue.sql

@@ -1,39 +0,0 @@
--- PREP: enqueue_prompt
-INSERT INTO prompt_queue (run_id, mode, model, prompt, config)
-VALUES (:run_id, :mode, :model, :prompt, :config)
-RETURNING id;
-
--- PREP: claim_next_prompt
-UPDATE prompt_queue
-SET status = 'active'
-WHERE
-	id = (
-		SELECT
-			id
-		FROM prompt_queue
-		WHERE run_id = :run_id AND status = 'pending'
-		ORDER BY id
-		LIMIT 1
-	)
-RETURNING id, run_id, mode, model, prompt, config;
-
--- PREP: complete_prompt
-UPDATE prompt_queue
-SET status = 'completed', result = :result
-WHERE id = :id;
-
--- PREP: abort_active_prompt
-UPDATE prompt_queue
-SET status = 'aborted'
-WHERE run_id = :run_id AND status = 'active';
-
--- PREP: get_pending_prompts
-SELECT id, mode, model, prompt, status, created_at
-FROM prompt_queue
-WHERE run_id = :run_id AND status IN ('pending', 'active')
-ORDER BY id;
-
--- PREP: reset_active_prompts
-UPDATE prompt_queue
-SET status = 'pending'
-WHERE status = 'active';

package/src/plugins/ask_user/docs.md

@@ -1,2 +0,0 @@
-## <ask_user question="[Question?]">[option1; option2; ...]</ask_user>
-Example: <ask_user question="Which test framework?">Mocha; Jest; Node Native</ask_user>

package/src/plugins/cp/docs.md

@@ -1,2 +0,0 @@
-## <cp path="[path/to/origin"]>[path/to/destination]</cp> - Copy a file or entry
-Example: <cp path="docs/example.txt">docs/example_copy.txt</cp>

package/src/plugins/env/docs.md

@@ -1,2 +0,0 @@
-## <env>[command]</env> - Run an exploratory shell command
-Example: <env>npm --version</env>

package/src/plugins/get/docs.md

@@ -1,6 +0,0 @@
-## <get>[path/to/file]</get> - Load a file or entry into context
-Example: <get>docs/example.txt</get>
-Example: <get>known://auth_flow</get>
-* Entries at state="index" or state="summary" are promoted to full content.
-* Use "known://" paths to recall stored information.
-* When irrelevant or resolved, use <store/> to remove from context.

package/src/plugins/known/docs.md

@@ -1,3 +0,0 @@
-## <known>[information]</known> - Save knowledge
-Example: <known>Donald Rumsfeld was born in 1932</known>
-Example: <known path="known://auth">OAuth2 PKCE</known>

package/src/plugins/mv/docs.md

@@ -1,2 +0,0 @@
-## <mv path="[path/to/origin"]>[path/to/destination]</mv> - Move a file or entry
-Example: <mv path="known://active_user">known://inactive_user</mv>

package/src/plugins/rm/docs.md

@@ -1,4 +0,0 @@
-## <rm path="[path/to/file]"/> - Remove a file or entry
-Example: <rm path="src/config.js"/>
-Example: <rm path="unknown://42"/>
-* <rm/> removes the file or entry from context and deletes it PERMANENTLY

package/src/plugins/set/docs.md

@@ -1,4 +0,0 @@
-## <set path="[path/to/file]">[edit]</set> - Edit a file or entry
-Example: <set path="src/config.js">s/base_url = http:\/\/localhost/base_url = http:\/\/0.0.0.0/g s/port = 3000/port = 8080/g</set>
-* All editing syntaxes supported: s/old/new/, {"search":"old","replace":"new"}, SEARCH/REPLACE blocks
-* Do not use <sh/> or <env/> to read, create, update, or delete files or entries

package/src/plugins/sh/docs.md

@@ -1,2 +0,0 @@
-## <sh>[command]</sh> - Run a shell command with side effects
-Example: <sh>npm install</sh>

package/src/plugins/skills/README.md

@@ -1,25 +0,0 @@
-# skills
-
-Manages skills and personas via RPC methods. Skills are stackable per-run entries; personas are exclusive per-run configuration.
-
-## Registration
-
-- **No tool handler** — registers RPC methods on `hooks.rpc.registry`.
-
-## RPC Methods
-
-### Skills
-- `skill/add` — Load a skill from `config/skills/{name}.md` into the run as a `skill://` entry at full state.
-- `skill/remove` — Remove a skill entry from a run.
-- `getSkills` — List active skills on a run.
-- `listSkills` — List available skill files from disk.
-
-### Personas
-- `persona/set` — Set persona on a run. Load from `config/personas/{name}.md` by name, pass raw text, or clear by omitting both.
-- `listPersonas` — List available persona files from disk.
-
-## Behavior
-
-- Skills stack: multiple skills can be active on a run simultaneously as separate `skill://` entries.
-- Personas are exclusive: setting a persona replaces the previous one (stored as a run column, not an entry).
-- File paths resolve from `RUMMY_HOME` environment variable.

package/src/plugins/store/README.md

@@ -1,20 +0,0 @@
-# store
-
-Demotes entries from active context to stored (background) state.
-
-## Registration
-
-- **Tool**: `store`
-- **Modes**: ask, act
-- **Category**: ask
-- **Handler**: Matches entries by pattern, demotes them via `demoteByPattern`, and records the result.
-
-## Projection
-
-Shows `store {path}`.
-
-## Behavior
-
-- Pattern queries (globs or body filters) produce a summary of matched paths.
-- Exact path queries report "{path} stored" or "{path} not found".
-- Stored entries remain in the database but are excluded from model context.

package/src/plugins/store/docs.md

@@ -1,5 +0,0 @@
-## <store path="[path/to/file]"/> - Store a file or entry
-Example: <store path="src/config.js"/>
-Example: <store path="unknown://42"/>
-* <store/> removes the file or entry from context, but does not delete it
-* A stored file or entry can be restored with <get/>

package/src/plugins/store/store.js

@@ -1,52 +0,0 @@
-import { readFileSync } from "node:fs";
-import { storePatternResult } from "../helpers.js";
-
-export default class Store {
-	#core;
-
-	constructor(core) {
-		this.#core = core;
-		core.registerScheme({ validStates: ["full", "stored", "pattern"] });
-		core.on("handler", this.handler.bind(this));
-		core.on("full", this.full.bind(this));
-		core.on("summary", this.summary.bind(this));
-		const docs = readFileSync(new URL("./docs.md", import.meta.url), "utf8");
-		core.filter("instructions.toolDocs", async (content) =>
-			content ? `${content}\n\n${docs}` : docs,
-		);
-	}
-
-	async handler(entry, rummy) {
-		const { entries: store, sequence: turn, runId } = rummy;
-		const target = entry.attributes.path;
-		const bodyFilter = entry.attributes.body || null;
-		const isPattern = bodyFilter || target.includes("*");
-		const matches = await store.getEntriesByPattern(runId, target, bodyFilter);
-		await store.demoteByPattern(runId, target, bodyFilter);
-
-		if (isPattern) {
-			await storePatternResult(
-				store,
-				runId,
-				turn,
-				"store",
-				target,
-				bodyFilter,
-				matches,
-			);
-		} else {
-			const paths = matches.map((m) => m.path).join(", ");
-			const body =
-				matches.length > 0 ? `${paths} stored` : `${target} not found`;
-			await store.upsert(runId, turn, entry.resultPath, body, "stored");
-		}
-	}
-
-	full(entry) {
-		return `# store ${entry.attributes.path || entry.path}`;
-	}
-
-	summary(entry) {
-		return this.full(entry);
-	}
-}

package/src/plugins/summarize/docs.md

@@ -1,4 +0,0 @@
-## <summarize>[Answer or summary]</summarize>
-* Describe the final state
-* ONLY use if done
-* Keep brief (<= 80 characters)

package/src/plugins/unknown/docs.md

@@ -1,5 +0,0 @@
-## <unknown>[what you need to learn]</unknown> - Track open questions
-Example: <unknown>contents of answer.txt</unknown>
-Example: <unknown>which database adapter is configured</unknown>
-* Use get, env, or ask_user to investigate unknowns
-* When irrelevant or resolved, use <rm/> to remove from context.

package/src/plugins/update/docs.md

@@ -1,4 +0,0 @@
-## <update>[Brief update]</update>
-* Describe the current state
-* DO NOT use if done
-* Keep brief (<= 80 characters)