gh-postplan 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cyrus Venn Casada
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -45,6 +45,15 @@ npx gh-postplan publish ./draft.html --no-wait
 
 Only the HTML file is uploaded. Use self-contained HTML or absolute URLs for assets.
 
+## List and delete
+
+```sh
+npx gh-postplan list
+npx gh-postplan delete
+```
+
+`delete` shows the published drafts and accepts multiple comma-separated choices. Deleting a draft removes its stable URL and every permanent version.
+
 Configuration lives in `~/.config/gh-postplan`. Set `GH_POSTPLAN_REPO=owner/repo` to override the configured repository.
 
 The npm package also includes an agent skill at `skills/gh-postplan/SKILL.md`.

package/dist/cli.js

@@ -16,8 +16,9 @@ import {
 } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, extname, join, resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
-var packageVersion = "0.1.0";
+var packageVersion = "0.2.0";
 var configDirectory = join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "gh-postplan");
 var cacheDirectory = join(process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache"), "gh-postplan");
 var configPath = join(configDirectory, "config.json");
@@ -28,10 +29,14 @@ class PushError extends Error {
 var help = `Usage:
   gh-postplan setup OWNER/REPO [--create]
   gh-postplan publish FILE [--new | --draft ID] [--no-wait]
+  gh-postplan list
+  gh-postplan delete
 
 Commands:
   setup     Configure an existing repo, or create a public one with --create
-  publish   Publish one HTML file and keep its older versions available`;
+  publish   Publish one HTML file and keep its older versions available
+  list      List published drafts
+  delete    Interactively delete one or more drafts and all their versions`;
 function parseCommand(args) {
   if (args.length === 0 || args.includes("--help") || args.includes("-h"))
     return { kind: "help" };
@@ -70,6 +75,8 @@ ${help}`);
       throw new Error("Invalid draft ID");
     return { kind: "publish", file: subject, draft, fresh, wait };
   }
+  if ((name === "list" || name === "delete") && !subject && flags.length === 0)
+    return { kind: name };
   throw new Error(`Unknown command: ${name ?? ""}
 
 ${help}`);
@@ -81,6 +88,15 @@ function pageUrls(base, id, version) {
   const root = `${base.replace(/\/+$/, "")}/drafts/${id}/`;
   return { current: root, version: `${root}v${version}/` };
 }
+function parseSelection(answer, count) {
+  if (!answer.trim())
+    return [];
+  const choices = answer.split(",").map((choice) => Number(choice.trim()));
+  if (choices.some((choice) => !Number.isInteger(choice) || choice < 1 || choice > count)) {
+    throw new Error(`Choose numbers from 1 to ${count}, separated by commas`);
+  }
+  return [...new Set(choices)];
+}
 function validateRepo(repo) {
   if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repo)) {
     throw new Error("Repository must look like OWNER/REPO");
@@ -254,6 +270,68 @@ async function getRepo() {
   validateRepo(repo);
   return repo;
 }
+async function readPublishedDrafts(repo) {
+  const path = await syncClone(repo);
+  const pages = await readPages(repo);
+  const localDrafts = await readJson(draftsPath, {});
+  const sources = new Map(Object.entries(localDrafts).map(([source, draft]) => [draft.id, source]));
+  const directory = join(path, "drafts");
+  if (!await exists(directory))
+    return [];
+  const drafts = [];
+  for (const id of await readdir(directory)) {
+    const draftDirectory = join(directory, id);
+    if (!(await stat(draftDirectory)).isDirectory() || !await exists(join(draftDirectory, "index.html")))
+      continue;
+    const versions = (await readdir(draftDirectory)).filter((entry) => /^v\d+$/.test(entry)).length;
+    drafts.push({ id, versions, source: sources.get(id), url: pageUrls(pages.html_url, id, 1).current });
+  }
+  return drafts.sort((a, b) => a.id.localeCompare(b.id));
+}
+async function list() {
+  const repo = await getRepo();
+  await checkTools();
+  const drafts = await readPublishedDrafts(repo);
+  if (drafts.length === 0)
+    return void process.stdout.write(`No drafts published.
+`);
+  for (const draft of drafts) {
+    process.stdout.write(`${draft.id}	${draft.versions} version${draft.versions === 1 ? "" : "s"}	${draft.source ?? "-"}	${draft.url}
+`);
+  }
+}
+async function deleteDrafts() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY)
+    throw new Error("delete requires an interactive terminal");
+  const repo = await getRepo();
+  await checkTools();
+  const drafts = await readPublishedDrafts(repo);
+  if (drafts.length === 0)
+    return void process.stdout.write(`No drafts published.
+`);
+  drafts.forEach((draft, index) => {
+    process.stdout.write(`${index + 1}. ${draft.id} (${draft.versions} version${draft.versions === 1 ? "" : "s"}) ${draft.source ?? ""}
+`);
+  });
+  const prompt = createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await prompt.question("Delete which drafts? Enter numbers separated by commas, or press Enter to cancel: ");
+  prompt.close();
+  const selected = parseSelection(answer, drafts.length).map((choice) => drafts[choice - 1]);
+  if (selected.length === 0)
+    return void process.stdout.write(`Cancelled.
+`);
+  const path = clonePath(repo);
+  for (const draft of selected)
+    await rm(join(path, "drafts", draft.id), { recursive: true });
+  await run("git", ["add", "-A", ...selected.map((draft) => join("drafts", draft.id))], path);
+  await run("git", ["commit", "-m", `chore: delete ${selected.map((draft) => draft.id).join(", ")}`], path);
+  await run("git", ["push", "origin", "gh-pages"], path);
+  const localDrafts = await readJson(draftsPath, {});
+  const deleted = new Set(selected.map((draft) => draft.id));
+  await writeJson(draftsPath, Object.fromEntries(Object.entries(localDrafts).filter(([, draft]) => !deleted.has(draft.id))));
+  process.stdout.write(`Deleted ${selected.length} draft${selected.length === 1 ? "" : "s"}.
+`);
+}
 async function makeDraftId(path) {
   let id;
   do
@@ -356,8 +434,12 @@ async function main(args = process.argv.slice(2)) {
 `);
   else if (command.kind === "setup")
     await setup(command);
-  else
+  else if (command.kind === "publish")
     await publish(command);
+  else if (command.kind === "list")
+    await list();
+  else
+    await deleteDrafts();
 }
 var executablePath = process.argv[1] ? await realpath(process.argv[1]).catch(() => resolve(process.argv[1])) : undefined;
 if (executablePath === fileURLToPath(import.meta.url)) {
@@ -371,5 +453,6 @@ export {
   main,
   nextVersion,
   pageUrls,
-  parseCommand
+  parseCommand,
+  parseSelection
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gh-postplan",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Publish versioned HTML drafts to GitHub Pages",
   "type": "module",
   "bin": {

package/skills/gh-postplan/SKILL.md

@@ -67,3 +67,12 @@ npx gh-postplan setup OWNER/REPO --create
 ```
 
 All published drafts are public. Configuration and local draft mappings live in `~/.config/gh-postplan`.
+
+List or interactively delete published drafts with:
+
+```sh
+npx gh-postplan list
+npx gh-postplan delete
+```
+
+Deleting a draft also deletes all of its permanent versions.