@enbox/gitd 0.0.1

package/schemas/registry/attestation.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/attestation",
+  "title": "AttestationData",
+  "description": "A signed attestation claim about a package or artifact",
+  "type": "object",
+  "properties": {
+    "attestorDid": {
+      "type": "string"
+    },
+    "claim": {
+      "type": "string"
+    },
+    "sourceCommit": {
+      "type": "string"
+    },
+    "sourceRepo": {
+      "type": "string"
+    }
+  },
+  "required": ["attestorDid", "claim"],
+  "additionalProperties": false
+}

package/schemas/registry/package-version.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/package-version",
+  "title": "PackageVersionData",
+  "description": "A specific version of a registered package",
+  "type": "object",
+  "properties": {
+    "semver": {
+      "type": "string"
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "description": {
+      "type": "string"
+    }
+  },
+  "required": ["semver"],
+  "additionalProperties": false
+}

package/schemas/registry/package.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/package",
+  "title": "PackageData",
+  "description": "A package registered in the decentralized registry",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "homepage": {
+      "type": "string"
+    },
+    "repository": {
+      "type": "string"
+    },
+    "license": {
+      "type": "string"
+    },
+    "keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/releases/release.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/release",
+  "title": "ReleaseData",
+  "description": "A versioned release of a repository",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    },
+    "body": {
+      "type": "string"
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/repo/collaborator.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/collaborator",
+  "title": "CollaboratorData",
+  "description": "A collaborator entry identifying a DID and optional alias, shared by maintainer, triager, and contributor roles.",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string"
+    },
+    "alias": {
+      "type": "string"
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/repo/repo.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/repo",
+  "title": "RepoData",
+  "description": "Repository metadata including name, description, default branch, and endpoints.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "defaultBranch": {
+      "type": "string"
+    },
+    "homepage": {
+      "type": "string"
+    },
+    "dwnEndpoints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "gitEndpoints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "required": ["name", "defaultBranch", "dwnEndpoints"],
+  "additionalProperties": false
+}

package/schemas/repo/settings.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/settings",
+  "title": "SettingsData",
+  "description": "Repository settings including branch protection rules, merge strategies, and auto-delete behavior.",
+  "type": "object",
+  "properties": {
+    "branchProtection": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "requiredReviews": {
+            "type": "integer"
+          },
+          "requiredChecks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "mergeStrategies": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["merge", "squash", "rebase"]
+      }
+    },
+    "autoDeleteBranch": {
+      "type": "boolean"
+    }
+  },
+  "required": [],
+  "additionalProperties": false
+}

package/schemas/repo/topic.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/topic",
+  "title": "TopicData",
+  "description": "A topic label associated with a repository.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/repo/webhook.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/webhook",
+  "title": "WebhookData",
+  "description": "A webhook configuration specifying a callback URL, shared secret, subscribed events, and active status.",
+  "type": "object",
+  "properties": {
+    "url": {
+      "type": "string"
+    },
+    "secret": {
+      "type": "string"
+    },
+    "events": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "active": {
+      "type": "boolean"
+    }
+  },
+  "required": ["url", "secret", "events", "active"],
+  "additionalProperties": false
+}

package/schemas/social/activity.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/activity",
+  "title": "ActivityData",
+  "description": "A social activity event in the forge",
+  "type": "object",
+  "properties": {
+    "type": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "targetDid": {
+      "type": "string"
+    },
+    "targetRecordId": {
+      "type": "string"
+    }
+  },
+  "required": ["type", "summary"],
+  "additionalProperties": false
+}

package/schemas/social/follow.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/follow",
+  "title": "FollowData",
+  "description": "A follow relationship with another user",
+  "type": "object",
+  "properties": {
+    "targetDid": {
+      "type": "string"
+    },
+    "alias": {
+      "type": "string"
+    }
+  },
+  "required": ["targetDid"],
+  "additionalProperties": false
+}

package/schemas/social/star.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/star",
+  "title": "StarData",
+  "description": "A star marking a repository as a favorite",
+  "type": "object",
+  "properties": {
+    "repoDid": {
+      "type": "string"
+    },
+    "repoRecordId": {
+      "type": "string"
+    },
+    "repoName": {
+      "type": "string"
+    }
+  },
+  "required": ["repoDid", "repoRecordId"],
+  "additionalProperties": false
+}

package/schemas/wiki/wiki-history.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/wiki-history",
+  "title": "PageHistoryData",
+  "description": "A historical edit record for a wiki page",
+  "type": "object",
+  "properties": {
+    "editedBy": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "diff": {
+      "type": "string"
+    }
+  },
+  "required": ["editedBy"],
+  "additionalProperties": false
+}

package/schemas/wiki/wiki-page.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/wiki-page",
+  "title": "PageData",
+  "description": "Metadata for a wiki page whose content is stored as text/markdown",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "slug": {
+      "type": "string"
+    }
+  },
+  "required": ["title", "slug"],
+  "additionalProperties": false
+}

package/src/ci.ts

@@ -0,0 +1,118 @@
+/**
+ * Forge CI/CD Protocol — check suites, check runs, and build artifacts.
+ *
+ * CI bots are DID-bearing agents added as maintainers to the repository.
+ * Check runs are mutable (status transitions: queued -> in_progress -> completed).
+ *
+ * @module
+ */
+
+import type { ProtocolDefinition } from '@enbox/dwn-sdk-js';
+
+import { defineProtocol } from '@enbox/api';
+
+// ---------------------------------------------------------------------------
+// Data types
+// ---------------------------------------------------------------------------
+
+/** Data shape for a CI check suite. */
+export type CheckSuiteData = {
+  app : string;
+  headBranch? : string;
+};
+
+/** Data shape for an individual check run within a suite. */
+export type CheckRunData = {
+  output?: {
+    title : string;
+    summary : string;
+    text? : string;
+  };
+};
+
+// ---------------------------------------------------------------------------
+// Schema map
+// ---------------------------------------------------------------------------
+
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ForgeCiSchemaMap = {
+  checkSuite : CheckSuiteData;
+  checkRun : CheckRunData;
+  artifact : Uint8Array;
+};
+
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+
+export const ForgeCiDefinition = {
+  protocol  : 'https://enbox.org/protocols/forge/ci',
+  published : true,
+  uses      : {
+    repo: 'https://enbox.org/protocols/forge/repo',
+  },
+  types: {
+    checkSuite: {
+      schema      : 'https://enbox.org/schemas/forge/check-suite',
+      dataFormats : ['application/json'],
+    },
+    checkRun: {
+      schema      : 'https://enbox.org/schemas/forge/check-run',
+      dataFormats : ['application/json'],
+    },
+    artifact: {
+      dataFormats: ['application/octet-stream', 'application/gzip'],
+    },
+  },
+  structure: {
+    repo: {
+      $ref: 'repo:repo',
+
+      checkSuite: {
+        $actions: [
+          { role: 'repo:repo/contributor', can: ['read'] },
+          { role: 'repo:repo/maintainer', can: ['create', 'update'] },
+        ],
+        $tags: {
+          $requiredTags       : ['commitSha', 'status'],
+          $allowUndefinedTags : false,
+          commitSha           : { type: 'string' },
+          status              : { type: 'string', enum: ['queued', 'in_progress', 'completed'] },
+          conclusion          : { type: 'string', enum: ['success', 'failure', 'cancelled', 'skipped'] },
+          branch              : { type: 'string' },
+        },
+
+        checkRun: {
+          $actions: [
+            { role: 'repo:repo/contributor', can: ['read'] },
+            { who: 'author', of: 'repo/checkSuite', can: ['create', 'update'] },
+          ],
+          $tags: {
+            $requiredTags       : ['name', 'status'],
+            $allowUndefinedTags : false,
+            name                : { type: 'string' },
+            status              : { type: 'string', enum: ['queued', 'in_progress', 'completed'] },
+            conclusion          : { type: 'string', enum: ['success', 'failure', 'cancelled', 'skipped'] },
+          },
+
+          artifact: {
+            $actions: [
+              { role: 'repo:repo/contributor', can: ['read'] },
+              { who: 'author', of: 'repo/checkSuite', can: ['create'] },
+            ],
+          },
+        },
+      },
+    },
+  },
+} as const satisfies ProtocolDefinition;
+
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+
+/** Typed Forge CI protocol for use with `dwn.using()`. */
+export const ForgeCiProtocol = defineProtocol(
+  ForgeCiDefinition,
+  {} as ForgeCiSchemaMap,
+);

package/src/cli/agent.ts

@@ -0,0 +1,117 @@
+/**
+ * Agent bootstrapping — connects to (or creates) a local Web5 agent.
+ *
+ * On first run the agent vault is initialized with a password, a DID is
+ * created, and the forge protocols are installed.  Subsequent runs unlock
+ * the existing vault and return a ready-to-use `TypedWeb5` instance for
+ * each protocol.
+ *
+ * @module
+ */
+
+import type { TypedWeb5 } from '@enbox/api';
+
+import { Web5 } from '@enbox/api';
+
+import type { ForgeCiSchemaMap } from '../ci.js';
+import type { ForgeIssuesSchemaMap } from '../issues.js';
+import type { ForgeNotificationsSchemaMap } from '../notifications.js';
+import type { ForgeOrgSchemaMap } from '../org.js';
+import type { ForgePatchesSchemaMap } from '../patches.js';
+import type { ForgeRefsSchemaMap } from '../refs.js';
+import type { ForgeRegistrySchemaMap } from '../registry.js';
+import type { ForgeReleasesSchemaMap } from '../releases.js';
+import type { ForgeRepoSchemaMap } from '../repo.js';
+import type { ForgeSocialSchemaMap } from '../social.js';
+import type { ForgeWikiSchemaMap } from '../wiki.js';
+
+import { ForgeCiProtocol } from '../ci.js';
+import { ForgeIssuesProtocol } from '../issues.js';
+import { ForgeNotificationsProtocol } from '../notifications.js';
+import { ForgeOrgProtocol } from '../org.js';
+import { ForgePatchesProtocol } from '../patches.js';
+import { ForgeRefsProtocol } from '../refs.js';
+import { ForgeRegistryProtocol } from '../registry.js';
+import { ForgeReleasesProtocol } from '../releases.js';
+import { ForgeRepoProtocol } from '../repo.js';
+import { ForgeSocialProtocol } from '../social.js';
+import { ForgeWikiProtocol } from '../wiki.js';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Context returned by `connectAgent()` — provides typed protocol handles. */
+export type AgentContext = {
+  did : string;
+  repo : TypedWeb5<typeof ForgeRepoProtocol.definition, ForgeRepoSchemaMap>;
+  refs : TypedWeb5<typeof ForgeRefsProtocol.definition, ForgeRefsSchemaMap>;
+  issues : TypedWeb5<typeof ForgeIssuesProtocol.definition, ForgeIssuesSchemaMap>;
+  patches : TypedWeb5<typeof ForgePatchesProtocol.definition, ForgePatchesSchemaMap>;
+  ci : TypedWeb5<typeof ForgeCiProtocol.definition, ForgeCiSchemaMap>;
+  releases : TypedWeb5<typeof ForgeReleasesProtocol.definition, ForgeReleasesSchemaMap>;
+  registry : TypedWeb5<typeof ForgeRegistryProtocol.definition, ForgeRegistrySchemaMap>;
+  social : TypedWeb5<typeof ForgeSocialProtocol.definition, ForgeSocialSchemaMap>;
+  notifications : TypedWeb5<typeof ForgeNotificationsProtocol.definition, ForgeNotificationsSchemaMap>;
+  wiki : TypedWeb5<typeof ForgeWikiProtocol.definition, ForgeWikiSchemaMap>;
+  org : TypedWeb5<typeof ForgeOrgProtocol.definition, ForgeOrgSchemaMap>;
+  web5 : Web5;
+};
+
+// ---------------------------------------------------------------------------
+// Agent bootstrap
+// ---------------------------------------------------------------------------
+
+/**
+ * Connect to the local Web5 agent, initializing on first launch.
+ *
+ * The agent's persistent data lives under `dataPath` (default:
+ * `~/.gitd/agent`).  Sync is disabled — the CLI operates against
+ * the local DWN only.
+ */
+export async function connectAgent(password: string): Promise<AgentContext> {
+  const { web5, did, recoveryPhrase } = await Web5.connect({
+    password,
+    sync: 'off',
+  });
+
+  if (recoveryPhrase) {
+    console.log('');
+    console.log('  Recovery phrase (save this — it cannot be shown again):');
+    console.log(`  ${recoveryPhrase}`);
+    console.log('');
+  }
+
+  // Bind typed protocol handles.
+  const repo = web5.using(ForgeRepoProtocol);
+  const refs = web5.using(ForgeRefsProtocol);
+  const issues = web5.using(ForgeIssuesProtocol);
+  const patches = web5.using(ForgePatchesProtocol);
+  const ci = web5.using(ForgeCiProtocol);
+  const releases = web5.using(ForgeReleasesProtocol);
+  const registry = web5.using(ForgeRegistryProtocol);
+  const social = web5.using(ForgeSocialProtocol);
+  const notifications = web5.using(ForgeNotificationsProtocol);
+  const wiki = web5.using(ForgeWikiProtocol);
+  const org = web5.using(ForgeOrgProtocol);
+
+  // Install / verify all protocols (idempotent).
+  // Repo protocol requires encryption: webhook has encryptionRequired: true,
+  // and bundle records are optionally encrypted based on repo visibility.
+  await repo.configure({ encryption: true });
+  await refs.configure();
+  await issues.configure();
+  await patches.configure();
+  await ci.configure();
+  await releases.configure();
+  await registry.configure();
+  await social.configure();
+  await notifications.configure();
+  await wiki.configure();
+  await org.configure();
+
+  return {
+    did, repo, refs, issues, patches, ci, releases,
+    registry, social, notifications, wiki, org, web5,
+  };
+}