{"_id":"@01.works/reference-cli","_rev":"8-4380a5f07a0e919cec6f11c1ddfc39cb","name":"@01.works/reference-cli","dist-tags":{"latest":"0.4.1"},"versions":{"0.3.1":{"name":"@01.works/reference-cli","version":"0.3.1","keywords":["visual-review","layout","design","agent","cli"],"license":"UNLICENSED","_id":"@01.works/reference-cli@0.3.1","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"d2477264b4f21daec1903e303bed196bda5c35af","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.3.1.tgz","fileCount":3,"integrity":"sha512-oeGVo54DZcp1om14gkdRs/bGWX7nWrR4PdLuQc8obnpc5cqwI9PmV/n8JJQcArO5UG+KrtVgbXNQV/eBoa+MDw==","signatures":[{"sig":"MEQCIGJzNGqZMpqmFQgbJE0ayLN58S4oejsv3Ufx6RHWzXZHAiAESOrmEMq67N2Q0kHKzwn5svZtDrH1YR1DH8GPD/Aaog==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34100},"type":"module","_from":"file:01.works-reference-cli-0.3.1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"kdnhyk","email":"kdnhyk@gmail.com"},"_resolved":"/private/var/folders/mr/1yy73dlx7rg_sb0x6j2hvfs80000gn/T/b79f55450055a43bd20423cd588ad043/01.works-reference-cli-0.3.1.tgz","_integrity":"sha512-oeGVo54DZcp1om14gkdRs/bGWX7nWrR4PdLuQc8obnpc5cqwI9PmV/n8JJQcArO5UG+KrtVgbXNQV/eBoa+MDw==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.16.0","description":"Pull verified UI references and visual artifacts from Design Context","directories":{},"_nodeVersion":"24.18.0","dependencies":{"@01.works/reference-client":"0.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.3.1_1787908480353_0.7549155750930152","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@01.works/reference-cli","version":"0.3.2","keywords":["visual-review","layout","design","agent","cli"],"license":"SEE LICENSE IN LICENSE","_id":"@01.works/reference-cli@0.3.2","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"2c9bd0bd62e1218b739a51b53ac5192413794ace","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.3.2.tgz","fileCount":4,"integrity":"sha512-TQ30CyJSLvGspnpEART6ZsyTCRWqqmd2eancmUAeyk1JKL9NIa7E4yLGs8G9ZI2vBOuGmizNjDD8lCwpFKZH6A==","signatures":[{"sig":"MEQCIC98l/MvdULg390U+uhPJ7YqqVJPRMCUtegc7JF/iTobAiBDRhc1UDv2KN1aD+bcaJwBseFQH84Mez5GkBg1Bx5RBg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35638},"type":"module","_from":"file:/home/runner/work/_temp/npm-release-33479580754-1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"_resolved":"/home/runner/work/_temp/npm-release-33479580754-1.tgz","_integrity":"sha512-TQ30CyJSLvGspnpEART6ZsyTCRWqqmd2eancmUAeyk1JKL9NIa7E4yLGs8G9ZI2vBOuGmizNjDD8lCwpFKZH6A==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.17.0","description":"Pull verified UI references and visual artifacts from Design Context","directories":{},"_nodeVersion":"24.19.0","dependencies":{"@01.works/reference-client":"0.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.3.2_1788245965502_0.1515538022053995","host":"s3://npm-registry-packages-npm-production"}},"0.3.3":{"name":"@01.works/reference-cli","version":"0.3.3","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"license":"SEE LICENSE IN LICENSE","_id":"@01.works/reference-cli@0.3.3","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"15426370e819bbd7452444adf05f15c65df3e3a2","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.3.3.tgz","fileCount":4,"integrity":"sha512-QgG/hlTrM/lemjYa/3qvvThYJgrgNVWm7BwEIbE+0zowFbmvsH/f5tS8jYElpnUqCrzFmvPcfVxc4g1x/gxy9w==","signatures":[{"sig":"MEYCIQCw8NzAtwySKMYJcv9dSWjd7Nu+xpmxpoPGl7mIV3EBFgIhANsl3WDG+LWhIY82pL6/MmhGEcDd7QEX3AZ9/+c5mpMH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44351},"type":"module","_from":"file:/home/runner/work/_temp/npm-release-33482805285-1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"_resolved":"/home/runner/work/_temp/npm-release-33482805285-1.tgz","_integrity":"sha512-QgG/hlTrM/lemjYa/3qvvThYJgrgNVWm7BwEIbE+0zowFbmvsH/f5tS8jYElpnUqCrzFmvPcfVxc4g1x/gxy9w==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.17.0","description":"Pull verified UI references and manage Design Context catalogue folders","directories":{},"_nodeVersion":"24.19.0","dependencies":{"@01.works/reference-client":"0.2.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.3.3_1788248455752_0.8949667531645786","host":"s3://npm-registry-packages-npm-production"}},"0.3.4":{"name":"@01.works/reference-cli","version":"0.3.4","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"license":"SEE LICENSE IN LICENSE","_id":"@01.works/reference-cli@0.3.4","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"b178c2ddab77333b2f5b37bcb50673eaa8a182b4","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.3.4.tgz","fileCount":4,"integrity":"sha512-BZvXuuVFKyw4hUxCIpSEcPAoHji2TJwppERHxWCH4B7wA2fBwyql4Q3iaekfLHGD5gVaZ1ePIPMzV9YzlcyVEQ==","signatures":[{"sig":"MEUCIQD3YQVcbC6OTnEP75lWEVhhoS6Mnzonje37rBTHwoGhVAIgJ2459ScXIJ55oxf4lBF3LrRH2pxF8ND6LglC+PxJLWE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44619},"type":"module","_from":"file:/home/runner/work/_temp/npm-release-33515816118-1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"_resolved":"/home/runner/work/_temp/npm-release-33515816118-1.tgz","_integrity":"sha512-BZvXuuVFKyw4hUxCIpSEcPAoHji2TJwppERHxWCH4B7wA2fBwyql4Q3iaekfLHGD5gVaZ1ePIPMzV9YzlcyVEQ==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.17.0","description":"Pull verified UI references and manage Design Context catalogue folders","directories":{},"_nodeVersion":"24.19.0","dependencies":{"@01.works/reference-client":"0.2.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.3.4_1788271004403_0.29372106182041646","host":"s3://npm-registry-packages-npm-production"}},"0.3.5":{"name":"@01.works/reference-cli","version":"0.3.5","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"license":"SEE LICENSE IN LICENSE","_id":"@01.works/reference-cli@0.3.5","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"e297f33d06ee92ae5b383f119f0f36265ed8b58b","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.3.5.tgz","fileCount":4,"integrity":"sha512-+gWC6IgQNwy5mSK07RXOqazl4ankpq1L/SK/UdNW/8bjSNoK0pfON6AbTpFxEnzhjYAmZq+t4vGzC8qSPUb3bw==","signatures":[{"sig":"MEUCIQD1fRk/P4fB6FRm1+v88+En4gOPOWu9EC7ZNBvgJR5mIQIgD4c86bEg4q37jnko6rwnAqGW7IUsQEVDHH6CBRgEkVA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44619},"type":"module","_from":"file:/home/runner/work/_temp/npm-release-33957462334-1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"_resolved":"/home/runner/work/_temp/npm-release-33957462334-1.tgz","_integrity":"sha512-+gWC6IgQNwy5mSK07RXOqazl4ankpq1L/SK/UdNW/8bjSNoK0pfON6AbTpFxEnzhjYAmZq+t4vGzC8qSPUb3bw==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.19.0","description":"Pull verified UI references and manage Design Context catalogue folders","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@01.works/reference-client":"0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.3.5_1788599754267_0.9172010120890033","host":"s3://npm-registry-packages-npm-production"}},"0.3.6":{"name":"@01.works/reference-cli","version":"0.3.6","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"license":"SEE LICENSE IN LICENSE","_id":"@01.works/reference-cli@0.3.6","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"1ba7d8cf30a26d23f7ae918f33c4eba736f02608","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.3.6.tgz","fileCount":4,"integrity":"sha512-bkdVewuArF2JUE4bsFrFshCKDT5OrKQ40d8jZVjhk8v9kGDg4P+CU6RFm0VjA9uX5lTNgkG01M3k4DXyaEJpew==","signatures":[{"sig":"MEYCIQCBK7GK+jBWwWXzKdtzHkCZkyE62ZRnCQ9YEuyhBwe+wgIhAIkOqFZi/QfVGeLts2fhWx4SrKgP7/tFQ5RfxQacBiXb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44619},"type":"module","_from":"file:/home/runner/work/_temp/npm-release-33959846425-1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"_resolved":"/home/runner/work/_temp/npm-release-33959846425-1.tgz","_integrity":"sha512-bkdVewuArF2JUE4bsFrFshCKDT5OrKQ40d8jZVjhk8v9kGDg4P+CU6RFm0VjA9uX5lTNgkG01M3k4DXyaEJpew==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.19.0","description":"Pull verified UI references and manage Design Context catalogue folders","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@01.works/reference-client":"0.3.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.3.6_1788602970454_0.10723488246421331","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@01.works/reference-cli","version":"0.4.0","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"license":"SEE LICENSE IN LICENSE","_id":"@01.works/reference-cli@0.4.0","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","bugs":{"url":"https://github.com/01-office/design-context/issues"},"bin":{"design-context":"src/cli.mjs"},"dist":{"shasum":"74c30a12daf479d139d38dbb8ca994e96edf8701","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.4.0.tgz","fileCount":4,"integrity":"sha512-lCW1siZUFEq5YrhUpFlBWv/lLF9vchITGa/VZJV4Ki6EfyBvtNVmyhiBu4Cvww94C2kBlk0laKKwL3upmXiyAA==","signatures":[{"sig":"MEUCIQDUCsJxLR+KhX+d9EZ8bnnXcoxdT6ga95+97ikGjeXkYAIgXckAr+l7dmRxfGE4VnqLpOmjpzRFOcXacjqJFPgN2RA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44351},"type":"module","_from":"file:/home/runner/work/_temp/npm-release-34193741118-1.tgz","engines":{"node":">=22.12.0"},"scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"_resolved":"/home/runner/work/_temp/npm-release-34193741118-1.tgz","_integrity":"sha512-lCW1siZUFEq5YrhUpFlBWv/lLF9vchITGa/VZJV4Ki6EfyBvtNVmyhiBu4Cvww94C2kBlk0laKKwL3upmXiyAA==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.19.0","description":"Pull verified UI references and manage Design Context catalogue folders","directories":{},"_nodeVersion":"24.20.0","dependencies":{"@01.works/reference-client":"0.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"tmp":"tmp/reference-cli_0.4.0_1788848068459_0.024901690423532852","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"_id":"@01.works/reference-cli@0.4.1","bin":{"design-context":"src/cli.mjs"},"bugs":{"url":"https://github.com/01-office/design-context/issues"},"dist":{"shasum":"871e5ff198470dc9a4820713f92f2ee7558e1bc4","tarball":"https://registry.npmjs.org/@01.works/reference-cli/-/reference-cli-0.4.1.tgz","fileCount":4,"integrity":"sha512-1n9zOclOdChLh9Viz50Xa1qCJz5Z9RNIJgBtNCnZVGIciTIC7DihQTOuLIG9uylExITSlnrB7BzzrOY9p4yTSQ==","signatures":[{"sig":"MEYCIQDn6jDHQt6xlF9A2MTEDl77umC7WyBQp+3m1zxNrJ3IxQIhAMPjn5V5cL8iY5fkIr8VYgFLrbFyYHXuAyZAMGPXolCf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIASoK+dKo+wP4JNRPBXsKKAQy5UpZ8k2Pllcpy8QjZ0YAiB1blaUPOXmbkXIXiSO3DVeoSfmeUPJiRdatPfh8SZdtA=="}],"unpackedSize":44351},"name":"@01.works/reference-cli","type":"module","_from":"file:/home/runner/work/_temp/npm-release-34579927880-1.tgz","engines":{"node":">=22.12.0"},"license":"SEE LICENSE IN LICENSE","scripts":{"test":"node test/cli.test.mjs","typecheck":"node --check src/cli.mjs","lint:package":"publint","test:package":"node scripts/test-package.mjs"},"version":"0.4.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:8e0729da-8761-4fa5-a3fd-020ed513a563"}},"homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"_resolved":"/home/runner/work/_temp/npm-release-34579927880-1.tgz","_integrity":"sha512-1n9zOclOdChLh9Viz50Xa1qCJz5Z9RNIJgBtNCnZVGIciTIC7DihQTOuLIG9uylExITSlnrB7BzzrOY9p4yTSQ==","repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"_npmVersion":"11.19.0","description":"Pull verified UI references and manage Design Context catalogue folders","directories":{},"maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"_nodeVersion":"24.20.0","dependencies":{"@01.works/reference-client":"0.4.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"publint":"^0.3.23"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reference-cli_0.4.1_1789115851791_0.8398014602443618"}}},"time":{"created":"2026-08-28T09:14:40.132Z","modified":"2026-09-11T08:37:32.049Z","0.3.1":"2026-08-28T09:14:40.541Z","0.3.2":"2026-09-01T06:59:25.637Z","0.3.3":"2026-09-01T07:40:55.875Z","0.3.4":"2026-09-01T13:56:44.530Z","0.3.5":"2026-09-05T09:15:54.399Z","0.3.6":"2026-09-05T10:09:30.592Z","0.4.0":"2026-09-08T06:14:28.587Z","0.4.1":"2026-09-11T08:37:31.888Z"},"bugs":{"url":"https://github.com/01-office/design-context/issues"},"license":"SEE LICENSE IN LICENSE","homepage":"https://github.com/01-office/design-context/tree/main/packages/reference-cli#readme","keywords":["visual-review","layout","design","agent","cli","folder","catalogue"],"repository":{"url":"git+https://github.com/01-office/design-context.git","type":"git","directory":"packages/reference-cli"},"description":"Pull verified UI references and manage Design Context catalogue folders","maintainers":[{"name":"kdnhyk","email":"kdnhyk@gmail.com"}],"readme":"# `@01.works/reference-cli`\n\nDesign Context catalogue의 agent-ready 레이아웃 자료를 현재 프로젝트에 내려받는 Node.js\nCLI입니다. 구조화된 reference와 desktop/mobile screenshot, layout map, wireframe 등을\n로컬 파일로 만듭니다. CLI는 구현 요청이나 에이전트 지침을 생성하지 않습니다.\n\n`reference pull`의 범위는 **read-only visual reference bundle**입니다. 별도로 `folder`\n명령은 개인 API token으로 폴더와 URL을 읽고 저장할 수 있습니다. 리뷰어 코멘트, 화면 좌표\nannotation, 작업 결과 업로드, `submit`/`resolve` 상태 변경은 아직 제공하지 않습니다.\n\n## 요구사항과 설치\n\n- Node.js 22.12.0 이상\n- 일반 reference readiness를 통과한 Design Context layout\n- artifact를 내려받을 수 있는 네트워크 접근\n\n저장소 안에서는 workspace binary를 사용합니다. 외부 프로젝트에서는 폴더 명령을 포함한\n공개 버전을 정확히 고정합니다.\n\n```bash\npnpm --filter @01.works/reference-cli exec design-context --version\npnpm --filter @01.works/reference-cli exec design-context reference pull RUN_ID\n\n# 폴더 API와 client를 포함한 patch 릴리스\npnpm dlx @01.works/reference-cli@0.4.1 reference pull RUN_ID\n```\n\nCatalogue의 기본 프롬프트는 revision-pinned reference JSON URL을 직접 전달합니다. CLI는\n자료를 로컬 bundle로 보관하거나 여러 reference를 한 번에 내려받을 때 선택적으로 사용합니다.\n\n## 사용법\n\n```text\ndesign-context reference pull <layout-id|catalogue-url|reference-url> [<reference> ...] [options]\n```\n\n입력은 layout ID, `RUN_ID@REVISION`, 공식 Catalogue URL(`/layouts/RUN_ID`), 이전\n`?layout=RUN_ID` 공유 URL, layout 상세 URL 또는 `/reference` URL일 수 있습니다.\n완전한 URL을 넘기면 그 URL의 origin을 사용하며, ID만 넘기면 `--endpoint`를 사용합니다.\n\n| 옵션 | 기본값 | 동작 |\n| --- | --- | --- |\n| `--endpoint <url>` | `https://context.01.works` | ID 입력에 사용할 API origin |\n| `--output <dir>` | 단일 `.design-context/references/<layout-id>`, 다중 `.design-context/references` | 결과를 저장할 디렉터리 |\n| `--depth <level>` | 단일 `full`, 다중 `visual` | `metadata`, `summary`, `visual`, `full` 중 다운로드 범위 |\n| `--concurrency <1-12>` | `6` | reference와 artifact 동시 요청 수 |\n| `--json` | 꺼짐 | 파일을 전혀 쓰지 않고 원격 reference JSON을 stdout에 출력 |\n| `-h`, `--help` | — | 도움말 출력 |\n| `-v`, `--version` | — | CLI 버전 출력 |\n\n예시:\n\n```bash\ndesign-context reference pull RUN_ID --endpoint http://127.0.0.1:8787\ndesign-context reference pull 'https://context.01.works/layouts/RUN_ID' --output .references/home\ndesign-context reference pull 'RUN_ID@REVISION'\ndesign-context reference pull RUN_ID --depth metadata\ndesign-context reference pull RUN_ID --json > reference.json\ndesign-context reference pull --depth visual RUN_ID_A RUN_ID_B RUN_ID_C\n```\n\n## 폴더 API 조작\n\n개인 token을 환경 변수로 전달하면 에이전트가 폴더를 JSON CLI로 조작할 수 있습니다.\ntoken을 셸 인수로 받는 옵션은 의도적으로 제공하지 않습니다.\n\n```bash\nread -s DESIGN_CONTEXT_TOKEN\nexport DESIGN_CONTEXT_TOKEN\n\ndesign-context folder list\ndesign-context folder create \"Checkout references\" --private\ndesign-context folder add FOLDER_ID https://example.com/checkout --note \"Useful hierarchy\"\ndesign-context folder items FOLDER_ID --limit 100\ndesign-context folder update FOLDER_ID --public\ndesign-context folder remove FOLDER_ID ITEM_ID --yes\n```\n\n`DESIGN_CONTEXT_ENDPOINT`로 API origin을 바꿀 수 있습니다. 모든 성공 응답은 JSON이며,\n삭제 명령은 `--yes`가 필요합니다. token 발급과 전체 명령은\n[Folder API 문서](../../apps/api/docs/FOLDER_API.md)를 참고하세요.\n\n## 생성되는 파일\n\n기본 실행은 다음 구조를 만듭니다.\n\n```text\n.design-context/references/RUN_ID/\n├── reference.json\n├── desktop/\n│   ├── screenshot.png\n│   ├── preview.webp\n│   ├── overlay.png\n│   ├── wireframe.svg\n│   └── layout-map.json\n└── mobile/\n    └── ...\n```\n\n실제 파일은 manifest에 존재하는 artifact만 생성됩니다. CLI가 내려받는 kind는\n`screenshot`, `preview`, `overlay`, `wireframe`, `layoutMap`입니다. thumbnail,\nfavicon, ZIP package는 `reference.json`의 원격 URL에는 남지만 기본 다운로드 대상은\n아닙니다.\n\n여러 reference를 받으면 각 layout ID 하위 디렉터리에 같은 `reference.json`과 artifact\n구조를 만들고 루트에 `references.json`을 기록합니다. 이 인덱스에는 선택 순서, 처리 상태,\n요청·해석 시점, 실제로 받은 revision과 상대 reference 경로가 들어갑니다. 선택 순서는 base/supporting 같은\n역할을 뜻하지 않습니다.\n\n`summary`는 wireframe, `visual`은 preview와 wireframe, `full`은 기존 screenshot, preview,\nlayoutMap, wireframe과 overlay를 받습니다. 다중 입력은 전송량과 분석 부담을 낮추기 위해\n`visual`이 기본입니다. 검증형 greenfield 셋업은 reference JSON의\n`agentReadiness.capabilities.initialViewportAlignmentEvidence`가 ready인 항목만 사용합니다.\n이 capability가 없더라도 일반 `full` pull은 layoutMap을 직접 받으므로 차단되지 않습니다.\n\n`reference.json`은 서버의 `layout-reference` 응답에 다음 로컬 필드를 더합니다.\n\n- `pulledAt`: CLI가 다운로드를 마친 시점\n- `requestedRevision`: 입력 URL 또는 `RUN_ID@REVISION`에서 요청한 revision. bare ID면 `null`\n- `resolvedRevision`: 실제로 받은 manifest revision\n- `localArtifacts[]`: `viewport`, `kind`, reference 디렉터리 기준 상대 `path`, 검증된 `sha256`\n\n어떤 화면에 어떻게 적용할지, 어떤 콘텐츠를 사용할지 같은 구현 의도는 포함하지\n않습니다. 그 결정은 자료를 받는 사람이나 에이전트가 현재 작업 맥락에서 내립니다.\n\n## 무결성, 재실행과 실패 동작\n\n- artifact는 크기 상한을 적용해 임시 bundle로 스트리밍하면서 실제 byte 수와 SHA-256을\n  검증합니다. 오류 응답 본문도 64 KiB까지만 읽습니다.\n- 단일·다중 pull 모두 모든 reference와 artifact 검증이 끝난 뒤 완성된 임시 bundle을\n  output 경로에 한 번에 게시합니다. 하나라도 실패하면 기존 output은 그대로 유지됩니다.\n- 같은 output 디렉터리로 재실행하면 기존 bundle 전체를 새 bundle로 교체합니다. 새\n  reference에서 사라진 과거 파일은 남지 않습니다.\n- 다중 pull은 all-or-nothing입니다. 실패한 부분 결과나 `references.json`은 게시하지\n  않으므로 오류를 해결한 뒤 같은 명령을 다시 실행합니다.\n- 별도 cache나 resume index는 없습니다. 재실행 시 선택된 artifact를 다시 요청합니다.\n\n디렉터리 교체는 portable filesystem에서 `기존 output → 숨김 backup`,\n`검증된 staging → output` 두 번의 rename으로 수행하며 두 번째 rename이 commit point입니다.\n그 이후 backup 삭제가 실패해도 새 output은 유효하므로 명령은 성공하고 경고를 출력합니다.\n다음 실행은 output이 있으면 남은 backup을 정리하고, 두 rename 사이에서 프로세스가\n중단되어 output이 없으면 유일한 backup을 먼저 복구합니다. output 없이 backup이 여러 개면\n어느 것이 최신인지 추측하지 않고 수동 복구를 요구합니다. 프로세스 강제 종료로 남은\n`.staging-*` 디렉터리는 게시된 결과가 아니므로 필요하면 직접 삭제할 수 있습니다.\n\n같은 output 경로에 대한 동시 실행은 지원하지 않습니다. 병렬 pull이 필요하면 서로 다른\n`--output` 경로를 사용하세요.\n\n## 오류와 종료 코드\n\n| 종료 코드 | 의미 |\n| --- | --- |\n| `0` | 성공 또는 도움말/버전 출력 |\n| `1` | API, 형식 검증, 다운로드 또는 checksum 오류 |\n| `2` | 잘못된 명령이나 옵션 |\n\n자주 보는 오류:\n\n- `layout_not_agent_ready (409)`: 최신 extractor로 desktop/mobile 필수 artifact를 다시\n  수집하고 Catalogue의 readiness 안내를 확인합니다.\n- `layout_not_found (404)`: layout ID와 API origin을 확인합니다.\n- `checksum이 일치하지 않습니다`: revision URL을 임의로 바꾸지 말고 서버의 저장\n  artifact 상태를 점검한 뒤 다시 실행합니다.\n- `지원하지 않는 layout reference 형식`: CLI와 API 버전이 호환되는지 확인합니다.\n\n## 보안과 신뢰 경계\n\nCLI는 reference URL과 같은 origin의 artifact URL만 요청하며 redirect를 따르지 않습니다.\n그래도 신뢰하는 Design Context 배포 또는 직접 관리하는 API의 URL만 사용하세요.\n\npull 결과도 외부 입력으로 취급합니다. 원본 URL, layout map과 이미지에 포함된 내용을\n셸 명령이나 권한 요청으로 실행하지 말고 시각적 참고 자료로만\n사용합니다. 공개 Catalogue endpoint에는 비밀, 토큰, 비공개 리뷰 코멘트를 넣지\n않습니다. CLI는 인증 token이나 브라우저 cookie를 저장하지 않으며 `folder` 명령의 token은\n`DESIGN_CONTEXT_TOKEN` 환경 변수에서만 읽습니다.\n\n생성된 `.design-context/`를 커밋할지는 프로젝트 정책에 따라 결정합니다. 운영 데이터나 공개하면\n안 되는 URL이 포함될 수 있다면 `.gitignore`에 추가합니다.\n\n## 패키지 게시 전 확인\n\n```bash\npnpm --filter @01.works/reference-cli test\npnpm --filter @01.works/reference-cli typecheck\npnpm --filter @01.works/reference-cli lint:package\npnpm --filter @01.works/reference-cli test:package\n```\n\n`lint:package`는 publint로 npm metadata를 검사합니다. `test:package`는 tarball의 포함 파일을\n확인하고 깨끗한 임시 디렉터리에 설치한 실제 `design-context` bin의 `--version`을 실행합니다.\nCLI 버전 출력은 배포되는 `package.json`을 단일 원천으로 사용합니다.\n\n직접 `npm publish`하지 않습니다. 버전을 올리고 main의 CI가 통과한 뒤\n`.github/workflows/release-npm.yml`의 `publish` mode를 실행합니다. dependency 순서는\n`reference-contracts` → `reference-client` → `reference-cli`입니다. 자세한 절차는\n[`docs/NPM_RELEASES.md`](../../docs/NPM_RELEASES.md)를 따릅니다.\n\n게시 후 깨끗한 임시 디렉터리에서 `pnpm dlx @01.works/reference-cli@<version> --version`과\n실제 `reference pull`을 확인한 뒤 Catalogue를 배포합니다.\n","readmeFilename":"README.md"}