@enbox/gitd 0.0.1

package/dist/esm/cli/commands/shim.js

@@ -0,0 +1,75 @@
+/**
+ * `gitd shim` — start a package manager / registry compatibility shim.
+ *
+ * Usage:
+ *   gitd shim npm [--port 4873]   Start npm registry shim
+ *   gitd shim go  [--port 4874]   Start Go module proxy shim
+ *   gitd shim oci [--port 5555]   Start OCI/Docker registry shim
+ *
+ * Each shim starts a local HTTP proxy that speaks the native protocol of
+ * the ecosystem tool, resolving DID-scoped packages from DWN records.
+ *
+ * @module
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { startGoShim } from '../../shims/go/server.js';
+import { startNpmShim } from '../../shims/npm/server.js';
+import { startOciShim } from '../../shims/oci/server.js';
+import { flagValue, parsePort } from '../flags.js';
+// ---------------------------------------------------------------------------
+// Default ports
+// ---------------------------------------------------------------------------
+const DEFAULT_NPM_PORT = '4873';
+const DEFAULT_GO_PORT = '4874';
+const DEFAULT_OCI_PORT = '5555';
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+export function shimCommand(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const sub = args[0];
+        const rest = args.slice(1);
+        switch (sub) {
+            case 'npm': {
+                const port = parsePort((_b = (_a = flagValue(rest, '--port')) !== null && _a !== void 0 ? _a : process.env.GITD_NPM_SHIM_PORT) !== null && _b !== void 0 ? _b : DEFAULT_NPM_PORT);
+                console.log('Starting npm registry shim...');
+                startNpmShim({ ctx, port });
+                yield new Promise(() => { });
+                break;
+            }
+            case 'go': {
+                const port = parsePort((_d = (_c = flagValue(rest, '--port')) !== null && _c !== void 0 ? _c : process.env.GITD_GO_SHIM_PORT) !== null && _d !== void 0 ? _d : DEFAULT_GO_PORT);
+                console.log('Starting Go module proxy shim...');
+                startGoShim({ ctx, port });
+                yield new Promise(() => { });
+                break;
+            }
+            case 'oci':
+            case 'docker': {
+                const port = parsePort((_f = (_e = flagValue(rest, '--port')) !== null && _e !== void 0 ? _e : process.env.GITD_OCI_SHIM_PORT) !== null && _f !== void 0 ? _f : DEFAULT_OCI_PORT);
+                console.log('Starting OCI/Docker registry shim...');
+                startOciShim({ ctx, port });
+                yield new Promise(() => { });
+                break;
+            }
+            default:
+                console.error('Usage: gitd shim <npm|go|oci> [--port <port>]');
+                console.error('');
+                console.error('Shims:');
+                console.error(`  npm     npm registry proxy (default port: ${DEFAULT_NPM_PORT})`);
+                console.error(`  go      Go module proxy (default port: ${DEFAULT_GO_PORT})`);
+                console.error(`  oci     OCI/Docker registry proxy (default port: ${DEFAULT_OCI_PORT})`);
+                process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=shim.js.map

package/dist/esm/cli/commands/shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shim.js","sourceRoot":"","sources":["../../../../src/cli/commands/shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAgB,WAAW,CAAC,GAAiB,EAAE,IAAc;;;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE3B,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,MAAM,IAAI,GAAG,SAAS,CACpB,MAAA,MAAA,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,mCAAI,gBAAgB,CAChF,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;gBAC7C,YAAY,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC5B,MAAM;YACR,CAAC;YAED,KAAK,IAAI,CAAC,CAAC,CAAC;gBACV,MAAM,IAAI,GAAG,SAAS,CACpB,MAAA,MAAA,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,mCAAI,eAAe,CAC9E,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;gBAChD,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC5B,MAAM;YACR,CAAC;YAED,KAAK,KAAK,CAAC;YACX,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,IAAI,GAAG,SAAS,CACpB,MAAA,MAAA,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,mCAAI,gBAAgB,CAChF,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;gBACpD,YAAY,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5B,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC5B,MAAM;YACR,CAAC;YAED;gBACE,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;gBAC/D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,+CAA+C,gBAAgB,GAAG,CAAC,CAAC;gBAClF,OAAO,CAAC,KAAK,CAAC,4CAA4C,eAAe,GAAG,CAAC,CAAC;gBAC9E,OAAO,CAAC,KAAK,CAAC,sDAAsD,gBAAgB,GAAG,CAAC,CAAC;gBACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;CAAA"}

package/dist/esm/cli/commands/social.js

@@ -0,0 +1,206 @@
+/**
+ * `gitd social` — stars, follows, and activity feeds.
+ *
+ * Stars and follows live on the actor's DWN (data sovereignty).
+ * Aggregate counts require an indexer.
+ *
+ * Usage:
+ *   gitd star <did>                         Star a repo (by owner DID)
+ *   gitd unstar <did>                       Remove a star
+ *   gitd stars                              List starred repos
+ *   gitd follow <did>                       Follow a user
+ *   gitd unfollow <did>                     Unfollow a user
+ *   gitd following                          List followed users
+ *
+ * @module
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+// ---------------------------------------------------------------------------
+// Sub-command dispatch
+// ---------------------------------------------------------------------------
+export function socialCommand(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const sub = args[0];
+        const rest = args.slice(1);
+        switch (sub) {
+            case 'star': return starRepo(ctx, rest);
+            case 'unstar': return unstarRepo(ctx, rest);
+            case 'stars': return listStars(ctx);
+            case 'follow': return followUser(ctx, rest);
+            case 'unfollow': return unfollowUser(ctx, rest);
+            case 'following': return listFollowing(ctx);
+            default:
+                console.error('Usage: gitd social <star|unstar|stars|follow|unfollow|following>');
+                process.exit(1);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// star
+// ---------------------------------------------------------------------------
+function starRepo(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const repoDid = args[0];
+        if (!repoDid) {
+            console.error('Usage: gitd social star <repo-owner-did>');
+            process.exit(1);
+        }
+        // Query the target DID's DWN for their repo record.
+        // Use `from` to route the query to the remote DWN when the target
+        // differs from the local agent.
+        const from = repoDid === ctx.did ? undefined : repoDid;
+        const { records: repoRecords } = yield ctx.repo.records.query('repo', { from });
+        if (repoRecords.length === 0) {
+            console.error(`No repository found for ${repoDid}.`);
+            process.exit(1);
+        }
+        const repoRecord = repoRecords[0];
+        const repoRecordId = repoRecord.id;
+        const repoData = yield repoRecord.data.json();
+        const repoName = (_a = repoData.name) !== null && _a !== void 0 ? _a : undefined;
+        // Check if already starred.
+        const { records: existing } = yield ctx.social.records.query('star', {
+            filter: { tags: { repoDid } },
+        });
+        if (existing.length > 0) {
+            console.log(`Already starred ${repoDid}.`);
+            return;
+        }
+        const { status } = yield ctx.social.records.create('star', {
+            data: { repoDid, repoRecordId, repoName },
+            tags: { repoDid, repoRecordId },
+        });
+        if (status.code >= 300) {
+            console.error(`Failed to star repo: ${status.code} ${status.detail}`);
+            process.exit(1);
+        }
+        console.log(`Starred ${repoDid}${repoName ? ` (${repoName})` : ''}.`);
+    });
+}
+// ---------------------------------------------------------------------------
+// unstar
+// ---------------------------------------------------------------------------
+function unstarRepo(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const repoDid = args[0];
+        if (!repoDid) {
+            console.error('Usage: gitd social unstar <repo-owner-did>');
+            process.exit(1);
+        }
+        const { records } = yield ctx.social.records.query('star', {
+            filter: { tags: { repoDid } },
+        });
+        if (records.length === 0) {
+            console.error(`No star found for ${repoDid}.`);
+            process.exit(1);
+        }
+        const { status } = yield records[0].delete();
+        if (status.code >= 300) {
+            console.error(`Failed to unstar: ${status.code} ${status.detail}`);
+            process.exit(1);
+        }
+        console.log(`Unstarred ${repoDid}.`);
+    });
+}
+// ---------------------------------------------------------------------------
+// stars
+// ---------------------------------------------------------------------------
+function listStars(ctx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const { records } = yield ctx.social.records.query('star');
+        if (records.length === 0) {
+            console.log('No starred repos.');
+            return;
+        }
+        console.log(`Starred repos (${records.length}):\n`);
+        for (const rec of records) {
+            const data = yield rec.data.json();
+            const date = (_b = (_a = rec.dateCreated) === null || _a === void 0 ? void 0 : _a.slice(0, 10)) !== null && _b !== void 0 ? _b : '';
+            console.log(`  ${data.repoDid}${data.repoName ? ` (${data.repoName})` : ''}  ${date}`);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// follow
+// ---------------------------------------------------------------------------
+function followUser(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const targetDid = args[0];
+        if (!targetDid) {
+            console.error('Usage: gitd social follow <did>');
+            process.exit(1);
+        }
+        // Check if already following.
+        const { records: existing } = yield ctx.social.records.query('follow', {
+            filter: { tags: { targetDid } },
+        });
+        if (existing.length > 0) {
+            console.log(`Already following ${targetDid}.`);
+            return;
+        }
+        const { status } = yield ctx.social.records.create('follow', {
+            data: { targetDid },
+            tags: { targetDid },
+        });
+        if (status.code >= 300) {
+            console.error(`Failed to follow: ${status.code} ${status.detail}`);
+            process.exit(1);
+        }
+        console.log(`Following ${targetDid}.`);
+    });
+}
+// ---------------------------------------------------------------------------
+// unfollow
+// ---------------------------------------------------------------------------
+function unfollowUser(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const targetDid = args[0];
+        if (!targetDid) {
+            console.error('Usage: gitd social unfollow <did>');
+            process.exit(1);
+        }
+        const { records } = yield ctx.social.records.query('follow', {
+            filter: { tags: { targetDid } },
+        });
+        if (records.length === 0) {
+            console.error(`Not following ${targetDid}.`);
+            process.exit(1);
+        }
+        const { status } = yield records[0].delete();
+        if (status.code >= 300) {
+            console.error(`Failed to unfollow: ${status.code} ${status.detail}`);
+            process.exit(1);
+        }
+        console.log(`Unfollowed ${targetDid}.`);
+    });
+}
+// ---------------------------------------------------------------------------
+// following
+// ---------------------------------------------------------------------------
+function listFollowing(ctx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const { records } = yield ctx.social.records.query('follow');
+        if (records.length === 0) {
+            console.log('Not following anyone.');
+            return;
+        }
+        console.log(`Following (${records.length}):\n`);
+        for (const rec of records) {
+            const data = yield rec.data.json();
+            const date = (_b = (_a = rec.dateCreated) === null || _a === void 0 ? void 0 : _a.slice(0, 10)) !== null && _b !== void 0 ? _b : '';
+            console.log(`  ${data.targetDid}${data.alias ? ` (${data.alias})` : ''}  ${date}`);
+        }
+    });
+}
+//# sourceMappingURL=social.js.map

package/dist/esm/cli/commands/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../../../../src/cli/commands/social.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/commands/web.js

@@ -0,0 +1,36 @@
+/**
+ * `gitd web` — start the read-only web UI server.
+ *
+ * Usage:
+ *   gitd web [--port <port>]
+ *
+ * Serves a read-only HTML interface for browsing repo metadata, issues,
+ * patches, releases, and wiki pages.  Default port: 8080.
+ *
+ * @module
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { flagValue } from '../flags.js';
+import { startWebServer } from '../../web/server.js';
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+export function webCommand(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const port = parseInt((_b = (_a = flagValue(args, '--port')) !== null && _a !== void 0 ? _a : process.env.GITD_WEB_PORT) !== null && _b !== void 0 ? _b : '8080', 10);
+        console.log('Starting gitd web UI...');
+        startWebServer({ ctx, port });
+        // Keep the process alive — the server runs until Ctrl+C.
+        yield new Promise(() => { });
+    });
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/cli/commands/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../../src/cli/commands/web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;;;;;;;;;;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAgB,UAAU,CAAC,GAAiB,EAAE,IAAc;;;QAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAA,MAAA,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,aAAa,mCAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QAE5F,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9B,yDAAyD;QACzD,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;CAAA"}

package/dist/esm/cli/commands/wiki.js

@@ -0,0 +1,185 @@
+/**
+ * `gitd wiki` — collaborative documentation pages.
+ *
+ * Usage:
+ *   gitd wiki create <slug> <title> [--body <markdown>]
+ *   gitd wiki show <slug>
+ *   gitd wiki edit <slug> --body <markdown> [--summary <text>]
+ *   gitd wiki list
+ *
+ * @module
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { flagValue } from '../flags.js';
+import { getRepoContextId } from '../repo-context.js';
+// ---------------------------------------------------------------------------
+// Sub-command dispatch
+// ---------------------------------------------------------------------------
+export function wikiCommand(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const sub = args[0];
+        const rest = args.slice(1);
+        switch (sub) {
+            case 'create': return wikiCreate(ctx, rest);
+            case 'show': return wikiShow(ctx, rest);
+            case 'edit': return wikiEdit(ctx, rest);
+            case 'list':
+            case 'ls': return wikiList(ctx, rest);
+            default:
+                console.error('Usage: gitd wiki <create|show|edit|list>');
+                process.exit(1);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// wiki create
+// ---------------------------------------------------------------------------
+function wikiCreate(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const slug = args[0];
+        const title = args[1];
+        const body = (_a = flagValue(args, '--body')) !== null && _a !== void 0 ? _a : '';
+        if (!slug || !title) {
+            console.error('Usage: gitd wiki create <slug> <title> [--body <markdown>]');
+            process.exit(1);
+        }
+        const repoContextId = yield getRepoContextId(ctx);
+        // Check for duplicate slug.
+        const existing = yield findPageBySlug(ctx, repoContextId, slug);
+        if (existing) {
+            console.error(`Wiki page "${slug}" already exists. Use \`gitd wiki edit ${slug}\` to update it.`);
+            process.exit(1);
+        }
+        const { status, record } = yield ctx.wiki.records.create('repo/page', {
+            data: body,
+            dataFormat: 'text/markdown',
+            tags: { slug, title },
+            parentContextId: repoContextId,
+        });
+        if (status.code >= 300) {
+            console.error(`Failed to create wiki page: ${status.code} ${status.detail}`);
+            process.exit(1);
+        }
+        console.log(`Created wiki page: ${title} (/${slug})`);
+        console.log(`  Record ID: ${record.id}`);
+    });
+}
+// ---------------------------------------------------------------------------
+// wiki show
+// ---------------------------------------------------------------------------
+function wikiShow(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const slug = args[0];
+        if (!slug) {
+            console.error('Usage: gitd wiki show <slug>');
+            process.exit(1);
+        }
+        const repoContextId = yield getRepoContextId(ctx);
+        const page = yield findPageBySlug(ctx, repoContextId, slug);
+        if (!page) {
+            console.error(`Wiki page "${slug}" not found.`);
+            process.exit(1);
+        }
+        const tags = page.tags;
+        const title = (_a = tags === null || tags === void 0 ? void 0 : tags.title) !== null && _a !== void 0 ? _a : slug;
+        const date = (_c = (_b = page.dateCreated) === null || _b === void 0 ? void 0 : _b.slice(0, 10)) !== null && _c !== void 0 ? _c : '';
+        const modified = (_e = (_d = page.dateModified) === null || _d === void 0 ? void 0 : _d.slice(0, 10)) !== null && _e !== void 0 ? _e : date;
+        // Wiki pages use text/markdown as the data format.
+        const blob = yield page.data.blob();
+        const content = yield blob.text();
+        console.log(`Wiki: ${title} (/${slug})`);
+        console.log(`  Created:  ${date}`);
+        if (modified !== date) {
+            console.log(`  Modified: ${modified}`);
+        }
+        console.log(`  ID:       ${page.id}`);
+        console.log('');
+        console.log(content);
+    });
+}
+// ---------------------------------------------------------------------------
+// wiki edit
+// ---------------------------------------------------------------------------
+function wikiEdit(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const slug = args[0];
+        const body = flagValue(args, '--body');
+        const summary = flagValue(args, '--summary');
+        if (!slug || !body) {
+            console.error('Usage: gitd wiki edit <slug> --body <markdown> [--summary <text>]');
+            process.exit(1);
+        }
+        const repoContextId = yield getRepoContextId(ctx);
+        const page = yield findPageBySlug(ctx, repoContextId, slug);
+        if (!page) {
+            console.error(`Wiki page "${slug}" not found. Use \`gitd wiki create\` first.`);
+            process.exit(1);
+        }
+        const tags = page.tags;
+        const { status } = yield page.update({
+            data: body,
+            dataFormat: 'text/markdown',
+            tags: Object.assign({}, tags),
+        });
+        if (status.code >= 300) {
+            console.error(`Failed to update wiki page: ${status.code} ${status.detail}`);
+            process.exit(1);
+        }
+        // Create a history entry (immutable audit trail).
+        yield ctx.wiki.records.create('repo/page/pageHistory', {
+            data: { editedBy: ctx.did, summary: summary !== null && summary !== void 0 ? summary : 'Page updated' },
+            parentContextId: page.contextId,
+        });
+        console.log(`Updated wiki page: ${(_a = tags === null || tags === void 0 ? void 0 : tags.title) !== null && _a !== void 0 ? _a : slug} (/${slug})`);
+    });
+}
+// ---------------------------------------------------------------------------
+// wiki list
+// ---------------------------------------------------------------------------
+function wikiList(ctx, _args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const repoContextId = yield getRepoContextId(ctx);
+        const { records } = yield ctx.wiki.records.query('repo/page', {
+            filter: { contextId: repoContextId },
+        });
+        if (records.length === 0) {
+            console.log('No wiki pages found.');
+            return;
+        }
+        console.log(`Wiki pages (${records.length}):\n`);
+        for (const rec of records) {
+            const tags = rec.tags;
+            const slug = (_a = tags === null || tags === void 0 ? void 0 : tags.slug) !== null && _a !== void 0 ? _a : '?';
+            const title = (_b = tags === null || tags === void 0 ? void 0 : tags.title) !== null && _b !== void 0 ? _b : slug;
+            const date = (_f = (_d = (_c = rec.dateModified) === null || _c === void 0 ? void 0 : _c.slice(0, 10)) !== null && _d !== void 0 ? _d : (_e = rec.dateCreated) === null || _e === void 0 ? void 0 : _e.slice(0, 10)) !== null && _f !== void 0 ? _f : '';
+            console.log(`  /${slug.padEnd(20)} ${title}  ${date}`);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function findPageBySlug(ctx, repoContextId, slug) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { records } = yield ctx.wiki.records.query('repo/page', {
+            filter: {
+                contextId: repoContextId,
+                tags: { slug },
+            },
+        });
+        return records[0];
+    });
+}
+//# sourceMappingURL=wiki.js.map

package/dist/esm/cli/commands/wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../../../src/cli/commands/wiki.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli/flags.js

@@ -0,0 +1,29 @@
+/**
+ * Shared CLI argument helpers.
+ *
+ * @module
+ */
+/** Extract the value following a flag in argv (e.g. `--port 8080`). */
+export function flagValue(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length) {
+        return undefined;
+    }
+    return args[idx + 1];
+}
+/**
+ * Parse a port number string, validating that it's a valid TCP port.
+ * Exits the process with an error if the value is not a valid port.
+ *
+ * @param value - The port string to parse
+ * @returns A valid port number (1–65535)
+ */
+export function parsePort(value) {
+    const port = parseInt(value, 10);
+    if (Number.isNaN(port) || port < 1 || port > 65535) {
+        console.error(`Invalid port number: '${value}'. Must be an integer between 1 and 65535.`);
+        process.exit(1);
+    }
+    return port;
+}
+//# sourceMappingURL=flags.js.map

package/dist/esm/cli/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/cli/flags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,IAAY;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,yBAAyB,KAAK,4CAA4C,CAAC,CAAC;QAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}