guideline-manage 0.15.0 → 0.16.0

package/cli/src/commands/list.js

@@ -107,10 +107,6 @@ export async function listFromServer({
     err(t('list.noServer'));
     return 2;
   }
-  if (!token) {
-    err(t('common.loginNeeded', { url }));
-    return 1;
-  }
   let src;
   try {
     src = await loadSource(remoteClient({ server: url, token, fetchImpl }));

package/cli/src/commands/project-pick.js

@@ -110,11 +110,8 @@ export async function projectPick({
   let finalAgents = agents;
   for (const name of targets) {
     const { server: url } = sources[name];
+    // 토큰이 없어도 공개 서버(PUBLIC_READ)에서는 받을 수 있다. 비공개면 서버의 401 이 로그인 안내가 된다.
     const token = tokenFor(url, { env, home, single });
-    if (!token) {
-      failures.push(t('common.sourceLoginNeeded', { name, url }));
-      continue;
-    }
     const client = remoteClient({ server: url, token, fetchImpl });
     let src;
     try {
@@ -149,7 +146,7 @@ export async function projectPick({
       err(targets.length > 1 ? t('pick.sourceForm', { name, url: form.url }) : t('pick.form', { url: form.url }));
       if (browser) open(form.url);
       do {
-        result = await client.formResult(form.id, pollWait);
+        result = await client.formResult(form.id, pollWait, new URL(form.url).searchParams.get('k'));
       } while (result.status === 'pending');
     } catch (e) {
       failures.push(`${name}: ${e.status === 404 ? t('pick.formGone') : explain(e, url)}`);

package/cli/src/commands/source.js

@@ -67,10 +67,6 @@ export async function source({
     err(t('common.noServer'));
     return 2;
   }
-  if (!token) {
-    err(t('common.loginNeeded', { url }));
-    return 1;
-  }
   let src;
   try {
     src = await loadSource(remoteClient({ server: url, token, fetchImpl }));

package/cli/src/remote.js

@@ -30,8 +30,8 @@ export function serverOf({ flag, manifest, env = process.env }) {
  */
 export function remoteClient({ server, token = null, fetchImpl = fetch, version = packageVersion() }) {
   const base = `${server.replace(/\/+$/, '')}/`;
-  async function call(method, apiPath, { body, raw = false, auth = true } = {}) {
-    const headers = { 'X-Guideline-Client': version };
+  async function call(method, apiPath, { body, raw = false, auth = true, extra = {} } = {}) {
+    const headers = { 'X-Guideline-Client': version, ...extra };
     if (auth && token) headers.Authorization = `Bearer ${token}`;
     if (body !== undefined) headers['Content-Type'] = 'application/json';
     let res;
@@ -59,7 +59,8 @@ export function remoteClient({ server, token = null, fetchImpl = fetch, version
     tree: rev => call('GET', rev ? `tree?rev=${rev}` : 'tree'),
     archive: rev => call('GET', `archive?rev=${rev}`, { raw: true }),
     createForm: body => call('POST', 'forms', { body }),
-    formResult: (id, wait) => call('GET', `forms/${encodeURIComponent(id)}/result?wait=${wait}`),
+    // 토큰 없이 만든 폼은 링크 토큰(폼 주소의 k)이 결과를 볼 권한이다.
+    formResult: (id, wait, link = null) => call('GET', `forms/${encodeURIComponent(id)}/result?wait=${wait}`, { extra: link ? { 'X-Form-Link': link } : {} }),
     exchange: (code, verifier) => call('POST', 'cli/token', { body: { code, verifier }, auth: false }),
     revokeSelf: () => call('DELETE', 'tokens/self'),
     createProposal: body => call('POST', 'proposals', { body }),

package/cli/src/workspace.js

@@ -55,11 +55,8 @@ export async function fetchSources({
   const failures = [];
   for (const name of names) {
     const server = trim(manifest.sources[name].server);
+    // 토큰이 없으면 없이 부른다. 공개 서버(PUBLIC_READ)는 받아 주고, 비공개면 401 이 로그인 안내가 된다.
     const token = tokenFor(server, { env, home, single });
-    if (!token) {
-      failures.push({ source: name, message: t('common.loginNeeded', { url: server }) });
-      continue;
-    }
     const client = remoteClient({ server, token, fetchImpl });
     const rev = lock?.revisions?.[name];
     try {

package/locales/en/messages.json

@@ -40,7 +40,6 @@
   "common.noServer": "No server address: pass --server <URL> or set GUIDELINE_SERVER",
   "common.notDir": "Not a directory: {dir}",
   "common.serverWithManySources": "With several sources, use --source instead of --server",
-  "common.sourceLoginNeeded": "{name}: login required: guideline login --server {url}",
   "common.tooManyTries": "Too many failed attempts. Try again in {minutes} min",
   "diff.differs": "{path} differs",
   "diff.eolOnly": "(only the final newline differs)",

package/locales/en/templates/llms.txt

@@ -6,7 +6,7 @@ This document is the guide agents and people read when they first use this serve
 
 ## Setup (once per machine)
 
-1. You need Node 24 or later and the `guideline` CLI (the `guideline-manage` npm package, 0.15 or later):
+1. You need Node 24 or later and the `guideline` CLI (the `guideline-manage` npm package, 0.16 or later):
 
    ```bash
    npm install -g guideline-manage
@@ -14,7 +14,7 @@ This document is the guide agents and people read when they first use this serve
 
    To use it straight from a clone of its repository, call `node <repo>/cli/bin/guideline.js <command>`.
 
-2. Log in. When the browser opens, log in with the admin token and click "Issue". A read token is stored in `~/.config/guideline/credentials.json` (mode 600).
+2. Log in. If the server is public (`PUBLIC_READ=1`, the default), fetching guidelines (pick/update/list) works without a login, so you only need one to send proposals. When the browser opens, log in with the admin token and click "Issue". A read token is stored in `~/.config/guideline/credentials.json` (mode 600).
 
    ```bash
    guideline login --server {{SERVER}}
@@ -127,5 +127,5 @@ guideline propose --from <that folder> --title "<title>"   # send what was added
 
 ## More
 
-- [Admin web]({{SERVER}}/): view, edit and browse the history of guidelines, review proposals, issue tokens (log in with the admin token)
+- [Web]({{SERVER}}/): anyone can view guidelines and their history (log in if the server is private); editing, reverting, reviewing proposals and issuing tokens need a login with the admin token
 - `docs/guide.md` in the repository: the user guide for people

package/locales/ko/messages.json

@@ -40,7 +40,6 @@
   "common.noServer": "서버 주소가 없다: --server <URL> 이나 GUIDELINE_SERVER 를 준다",
   "common.notDir": "디렉터리가 아닙니다: {dir}",
   "common.serverWithManySources": "출처가 여럿이면 --server 대신 --source 를 쓴다",
-  "common.sourceLoginNeeded": "{name}: 로그인이 필요하다: guideline login --server {url}",
   "common.tooManyTries": "너무 많이 틀렸다. {minutes}분 뒤에 다시 한다",
   "diff.differs": "{path} 다름",
   "diff.eolOnly": "(파일 끝 줄바꿈만 다름)",

package/locales/ko/templates/llms.txt

@@ -6,7 +6,7 @@
 
 ## 준비 (머신마다 한 번)
 
-1. Node 24 이상과 `guideline` CLI(npm 패키지 `guideline-manage` 0.15 이상)가 있어야 한다.
+1. Node 24 이상과 `guideline` CLI(npm 패키지 `guideline-manage` 0.16 이상)가 있어야 한다.
 
    ```bash
    npm install -g guideline-manage
@@ -14,7 +14,7 @@
 
    저장소 클론에서 바로 쓸 때는 `node <저장소>/cli/bin/guideline.js <명령>` 으로 부른다.
 
-2. 로그인한다. 브라우저가 열리면 관리자 토큰으로 로그인해 「발급」 을 누른다. 읽기 토큰이 `~/.config/guideline/credentials.json`(권한 600)에 저장된다.
+2. 로그인한다. 서버가 공개(`PUBLIC_READ=1`, 기본)면 지침 받기(pick·update·list)는 로그인 없이 되니 제안을 올릴 때만 하면 된다. 브라우저가 열리면 관리자 토큰으로 로그인해 「발급」 을 누른다. 읽기 토큰이 `~/.config/guideline/credentials.json`(권한 600)에 저장된다.
 
    ```bash
    guideline login --server {{SERVER}}
@@ -127,5 +127,5 @@ guideline propose --from <그 폴더> --title "<제목>"   # 그 폴더에서
 
 ## 더 보기
 
-- [관리자 웹]({{SERVER}}/): 지침 보기·편집·이력·제안 검토·토큰 발급(관리자 토큰으로 로그인)
+- [웹]({{SERVER}}/): 지침·이력 보기는 누구나(서버가 비공개면 로그인), 편집·되돌리기·제안 검토·토큰 발급은 관리자 토큰으로 로그인한 뒤
 - 저장소의 `docs/guide.md`: 사람을 위한 이용 가이드

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guideline-manage",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Keep shared coding-agent guidelines on a guideline server and pick them into ruler projects",
   "keywords": [
     "ai",