@tequila99/githuman 0.11.2 → 0.12.0

package/dist/shared/artifact-transitions/transitions.js

@@ -0,0 +1,61 @@
+import { TRANSITION_TERMINAL_STAGES } from "./constants.js";
+// One source for server validation, preview and the status menu.
+export const ARTIFACT_STATUS_TRANSITIONS = {
+    draft: ['accepted', 'archived', 'deleted'],
+    in_review: ['draft', 'rejected', 'accepted', 'archived', 'deleted'],
+    rejected: ['draft', 'archived', 'deleted'],
+    accepted: ['archived', 'deleted'],
+    archived: ['draft', 'deleted'],
+    deleted: ['draft', 'archived'],
+    superseded: ['archived', 'deleted']
+};
+// Users never assign these: review was removed and replacement sets superseded.
+const SYSTEM_ONLY_STATUSES = [
+    'in_review',
+    'superseded'
+];
+export function isTerminalTransitionStage(stage) {
+    return TRANSITION_TERMINAL_STAGES.some(terminal => terminal === stage);
+}
+export function allowedTransition(from, to) {
+    if (from === to) {
+        return false;
+    }
+    return ARTIFACT_STATUS_TRANSITIONS[from].includes(to);
+}
+/** Lifecycle command that gives `to` to a subject in status `from`. */
+export function transitionCommand(from, to) {
+    if (!allowedTransition(from, to) || SYSTEM_ONLY_STATUSES.includes(to)) {
+        return null;
+    }
+    if (to === 'accepted') {
+        return 'accept';
+    }
+    if (to === 'rejected') {
+        return 'reject';
+    }
+    if (to === 'archived') {
+        return 'archive';
+    }
+    if (to === 'deleted') {
+        return 'delete';
+    }
+    return from === 'archived' || from === 'deleted'
+        ? 'restore'
+        : 'return_to_draft';
+}
+/** Targets a user can choose from `from`, with the reason for unavailable ones. */
+export function userTransitionTargets(from, hasSupersededHistory) {
+    return ARTIFACT_STATUS_TRANSITIONS[from]
+        .filter(status => !SYSTEM_ONLY_STATUSES.includes(status))
+        .map(status => {
+        if (status === 'draft' && hasSupersededHistory) {
+            return {
+                status,
+                available: false,
+                reason: 'A superseded artifact requires a new revision.'
+            };
+        }
+        return { status, available: true, reason: null };
+    });
+}

package/dist/shared/artifact-transitions/types.js

@@ -0,0 +1 @@
+export {};

package/dist/shared/artifacts/constants.js

@@ -0,0 +1,34 @@
+// Share lifecycle values between runtime schemas and frontend filters.
+export const ARTIFACT_STATUSES = [
+    'draft',
+    'in_review',
+    'accepted',
+    'rejected',
+    'superseded',
+    'archived',
+    'deleted'
+];
+// Bound document allocation before serialization and filesystem reads.
+export const MAX_ARTIFACT_BYTES = 2 * 1024 * 1024;
+// Leave room for the immutable frontmatter.
+export const MAX_ARTIFACT_BODY_BYTES = Math.floor(1.9 * 1024 * 1024);
+// Bound metadata and operation records independently of document content.
+export const MAX_ARTIFACT_METADATA_BYTES = 64 * 1024;
+// Keep content responses small enough for later MCP transport.
+export const MAX_ARTIFACT_CHUNK_BYTES = 64 * 1024;
+// Use the same normal query size for document and definition pages.
+export const DEFAULT_ARTIFACT_PAGE_SIZE = 50;
+// Bound catalog and history pages.
+export const MAX_ARTIFACT_PAGE_SIZE = 100;
+// Bound source excerpts independently of immutable document size.
+export const MAX_ARTIFACT_SOURCE_QUOTE_BYTES = 64 * 1024;
+// Keep normal pages small; one complete large item can exceed this soft budget.
+export const MAX_ARTIFACT_PAGE_BYTES = 128 * 1024;
+// Bound the user query before normalization can expand its Unicode representation.
+export const MAX_SEARCH_QUERY_CODEPOINTS = 256;
+// Keep token combinations and cursor validation bounded.
+export const MAX_SEARCH_TOKENS = 8;
+// Include the original token alongside a small set of corrected alternatives.
+export const MAX_SEARCH_VARIANTS = 8;
+// A candidate can add at most two codepoints to a maximum-length query token.
+export const MAX_SEARCH_WORD_CODEPOINTS = MAX_SEARCH_QUERY_CODEPOINTS + 2;

package/dist/shared/artifacts/mcp-constants.js

@@ -0,0 +1,24 @@
+// Stable server identity used by ACP configuration and permission checks.
+export const ARTIFACT_MCP_SERVER_NAME = 'githuman_artifacts';
+// Environment variable names that carry the bridge address and session key to the MCP process.
+export const ARTIFACT_AGENT_URL_ENV = 'GITHUMAN_AGENT_URL';
+export const ARTIFACT_AGENT_KEY_ENV = 'GITHUMAN_AGENT_KEY';
+// Random bytes in one session key. The key is sent as lowercase hex.
+export const ARTIFACT_AGENT_KEY_BYTES = 32;
+// Shape of a valid session key.
+export const ARTIFACT_AGENT_KEY_PATTERN = new RegExp(`^[a-f0-9]{${ARTIFACT_AGENT_KEY_BYTES * 2}}$`);
+// Shape of a valid Authorization header for the bridge.
+export const ARTIFACT_AGENT_BEARER_PATTERN = new RegExp(`^Bearer [a-f0-9]{${ARTIFACT_AGENT_KEY_BYTES * 2}}$`);
+// Bridge path without the operation name.
+export const ARTIFACT_BRIDGE_PATH_PREFIX = '/api/agent/artifacts/';
+// Only this matched route can authenticate an agent session key.
+export const ARTIFACT_BRIDGE_ROUTE = `${ARTIFACT_BRIDGE_PATH_PREFIX}:operation`;
+// Allow worst-case JSON escaping of a body while domain byte limits stay smaller.
+export const ARTIFACT_BRIDGE_BODY_LIMIT = 12 * 1024 * 1024;
+// Extra room in one MCP stdio message for the JSON-RPC envelope and escaped metadata.
+const MCP_ENVELOPE_ALLOWANCE_BYTES = 1024 * 1024;
+// Largest MCP stdio message the CLI accepts. A body of 1.9 MiB of control
+// characters escapes to about 11.95 MB and metadata adds up to 384 KiB.
+// The limit stays above the HTTP body limit, so an oversize message reaches
+// the server and gets a readable 413 instead of a closed stdio connection.
+export const ARTIFACT_MCP_MAX_MESSAGE_BYTES = ARTIFACT_BRIDGE_BODY_LIMIT + MCP_ENVELOPE_ALLOWANCE_BYTES;

package/dist/shared/artifacts/normalize.js

@@ -0,0 +1,9 @@
+// Old snapshots remain immutable; missing graph fields are supplied only when read.
+export function normalizeArtifact(artifact) {
+    return {
+        ...artifact,
+        taskIds: artifact.taskIds ?? [],
+        relations: artifact.relations ?? [],
+        revisionOf: artifact.revisionOf ?? []
+    };
+}