guideline-manage 0.15.0 → 0.16.1

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/login.js

@@ -14,6 +14,36 @@ async function readAll(stream) {
   return s;
 }
 
+/**
+ * 터미널에서 토큰 한 줄을 읽는다. 입력한 글자는 화면에 보이지 않는다.
+ * 파이프가 아닌 터미널은 EOF 가 오지 않아서, readAll 로는 아무 안내 없이 멈춘 것처럼 보인다.
+ * @returns {Promise<string | null>} Ctrl-C 면 null
+ */
+function readHiddenLine(stdin, write) {
+  return new Promise(resolve => {
+    let s = '';
+    const done = value => {
+      stdin.removeListener('data', onData);
+      stdin.setRawMode?.(false);
+      stdin.pause();
+      write('\n');
+      resolve(value);
+    };
+    const onData = chunk => {
+      for (const ch of String(chunk)) {
+        if (ch === '\r' || ch === '\n' || ch === '\u0004') return done(s);
+        if (ch === '\u0003') return done(null);
+        if (ch === '\u007f' || ch === '\b') s = s.slice(0, -1);
+        else s += ch;
+      }
+    };
+    stdin.setRawMode?.(true);
+    stdin.setEncoding?.('utf8');
+    stdin.on('data', onData);
+    stdin.resume();
+  });
+}
+
 /** 127.0.0.1 의 임시 포트에서 /cb 한 번을 기다린다. */
 async function callbackServer() {
   let resolve;
@@ -45,6 +75,7 @@ async function callbackServer() {
 export async function login({
   server, tokenStdin = false, env = process.env, out = console.log, err = console.error, open = openBrowser, fetchImpl = fetch,
   home, stdin = process.stdin, hostname = os.hostname(), timeoutMs = LOGIN_TIMEOUT_MS,
+  prompt = s => process.stderr.write(s),
 }) {
   const url = serverOf({ flag: server, env });
   if (!url) {
@@ -52,7 +83,15 @@ export async function login({
     return 2;
   }
   if (tokenStdin) {
-    const token = (await readAll(stdin)).trim();
+    let token;
+    if (stdin.isTTY) {
+      prompt(t('login.pasteToken'));
+      token = await readHiddenLine(stdin, prompt);
+      if (token === null) return 130;
+    } else {
+      token = await readAll(stdin);
+    }
+    token = token.trim();
     if (!token) {
       err(t('login.noStdinToken'));
       return 2;

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)",
@@ -92,6 +91,7 @@
   "login.callbackPage": "Login received. You can close this tab.",
   "login.done": "Logged in: {url} ({name})",
   "login.loggedOut": "Logged out: {url}",
+  "login.pasteToken": "Paste the token and press Enter (it is not shown): ",
   "login.noStdinToken": "No token on standard input",
   "login.notLoggedIn": "Not logged in",
   "login.openUrl": "Log in: {url}",

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": "(파일 끝 줄바꿈만 다름)",
@@ -92,6 +91,7 @@
   "login.callbackPage": "로그인 정보를 받았다. 이 탭은 닫아도 된다.",
   "login.done": "로그인했다: {url} ({name})",
   "login.loggedOut": "로그아웃했다: {url}",
+  "login.pasteToken": "토큰을 붙여 넣고 Enter (화면에 보이지 않는다): ",
   "login.noStdinToken": "표준 입력에 토큰이 없다",
   "login.notLoggedIn": "로그인돼 있지 않다",
   "login.openUrl": "로그인: {url}",

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.1",
   "description": "Keep shared coding-agent guidelines on a guideline server and pick them into ruler projects",
   "keywords": [
     "ai",