nnw-theme 0.1.0 → 1.0.1

package/assets/guide/publishing.md

@@ -24,6 +24,11 @@ stable GitHub release; and the valid ZIP asset. A useful repository description
 metadata warns but does not block publication. `npx nnw-theme@1 marketplace enable`
 adds the recommended topic through the author’s authenticated `gh` session.
 
+The screenshot workflow pushes a branch and opens a pull request for review, so the
+repository needs **Settings → Actions → General → Workflow permissions → Allow GitHub
+Actions to create and approve pull requests**. Without it the run pushes the branch and
+then fails with "GitHub Actions is not permitted to create or approve pull requests".
+
 Creating releases, topics, branches, pull requests, or other GitHub state is external
 mutation. Confirm the person’s intent immediately before doing it. Ordinary edits,
 local previews, checks, and packages do not need that additional confirmation.

package/assets/stubs/AGENTS.md

@@ -6,6 +6,13 @@ its `fixtures/`, and `screenshots/`. The tooling is the `nnw-theme` npm package;
 run it as `npx nnw-theme@1 <command>`. Never install it globally and never add
 it to this repository. Read `npx nnw-theme@1 guide` before theme work.
 
+If this repository is `dave-atx/netnewswire-theme-template` itself (check
+`git remote -v`), it is the GitHub template, not a theme: do not initialize,
+fork, or design in it. Help the user create their own repository from it with
+**Use this template** or `gh repo create NAME --template
+dave-atx/netnewswire-theme-template --clone`, confirming before you create it,
+then work in that copy.
+
 If `.nnw-theme-uninitialized` exists, run `npx nnw-theme@1 init` first and let
 the user confirm the permanent theme identifier. Prefer CSS changes; change
 `template.html` only when the requested structure or behavior requires it.

package/dist/commands/init.js

@@ -61,6 +61,23 @@ function updateReadme(root, name, creator, homepage) {
         `A NetNewsWire theme by [${creator}](${homepage}).\n${IDENTITY_END}`;
     writeFileSync(path, text.slice(0, start) + replacement + text.slice(end + IDENTITY_END.length), "utf8");
 }
+const TEMPLATE = "dave-atx/netnewswire-theme-template";
+/** The theme root, or directions to create one: init starts from the template. */
+function templateRoot() {
+    try {
+        return findRoot();
+    }
+    catch (error) {
+        if (!(error instanceof ThemeError))
+            throw error;
+        throw new ThemeError("no theme repository here; init personalizes a copy of the theme template.\n" +
+            `Create one with "Use this template" at https://github.com/${TEMPLATE}, ` +
+            "clone it, and run init inside it. With the GitHub CLI:\n" +
+            `  gh repo create my-theme --template ${TEMPLATE} --public --clone\n` +
+            "  cd my-theme\n" +
+            "  npx nnw-theme@1 init");
+    }
+}
 async function ask(value, flag, label, fallback) {
     if (value)
         return value;
@@ -69,7 +86,7 @@ async function ask(value, flag, label, fallback) {
     return await promptText(label, fallback);
 }
 export default async function init({ values }) {
-    const root = findRoot();
+    const root = templateRoot();
     let theme = findTheme(root);
     if (!existsSync(join(root, PLACEHOLDER_MARKER))) {
         throw new ThemeError("this repository is already initialized; run `npx nnw-theme@1 setup` to install preview tools");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nnw-theme",
-	"version": "0.1.0",
+	"version": "1.0.1",
 	"description": "Create, preview, check, and publish a NetNewsWire theme.",
 	"license": "Apache-2.0",
 	"author": "Dave Marquard",